@gnome-ui/react 1.28.0 → 1.29.0

package/dist/components/AboutDialog/AboutDialog.d.ts

@@ -0,0 +1,46 @@
+import { ReactNode } from 'react';
+export interface AboutDialogLink {
+    label: string;
+    url: string;
+}
+export interface AboutDialogProps {
+    /** Whether the dialog is visible. */
+    open: boolean;
+    /** Called on Escape or close button click. */
+    onClose?: () => void;
+    /** Application name. */
+    applicationName: string;
+    /** Icon rendered above the app name. */
+    applicationIcon?: ReactNode;
+    /** Version string (e.g. `"1.0.0"`). */
+    version?: string;
+    /** One-sentence description. */
+    comments?: string;
+    /** Developer or organisation name. */
+    developerName?: string;
+    /** Application website URL. */
+    website?: string;
+    /** Label for the website link. Defaults to the URL. */
+    websiteLabel?: string;
+    /** Developer names shown in the Credits tab. */
+    developers?: string[];
+    /** Designer names shown in the Credits tab. */
+    designers?: string[];
+    /** Artist names shown in the Credits tab. */
+    artists?: string[];
+    /** Copyright notice (e.g. `"© 2024 Jane Smith"`). */
+    copyright?: string;
+    /** SPDX identifier or short name (e.g. `"GPL-3.0"`). */
+    licenseType?: string;
+    /** Full license text shown in the Legal tab. */
+    licenseText?: string;
+    /** Extra links shown in the Details section. */
+    links?: AboutDialogLink[];
+}
+/**
+ * Standard app info dialog with details, credits, and legal tabs.
+ * Mirrors `AdwAboutDialog`.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.AboutDialog.html
+ */
+export declare function AboutDialog({ open, onClose, applicationName, applicationIcon, version, comments, developerName, website, websiteLabel, developers, designers, artists, copyright, licenseType, licenseText, links, }: AboutDialogProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/AboutDialog/index.d.ts

@@ -0,0 +1,2 @@
+export { AboutDialog } from './AboutDialog';
+export type { AboutDialogProps, AboutDialogLink } from './AboutDialog';

package/dist/components/Dialog/Dialog.d.ts

@@ -13,10 +13,6 @@ export interface AlertDialogResponse {
     /** Disables the button. */
     disabled?: boolean;
 }
-export interface AboutDialogLink {
-    label: string;
-    url: string;
-}
 export interface DialogButton {
     /** Button label. */
     label: string;
@@ -59,46 +55,10 @@ export interface DialogProps extends Omit<HTMLAttributes<HTMLDivElement>, "title
      * Required when `responses` is provided.
      */
     onResponse?: (id: string) => void;
-    /**
-     * Set to `"about"` to render as an application info dialog.
-     * When `variant="about"`, `title`/`buttons`/`children` are ignored in favour
-     * of the about-specific props below.
-     */
-    variant?: "about";
-    /** Application name (required when `variant="about"`). */
-    applicationName?: string;
-    /** Icon rendered above the app name. */
-    applicationIcon?: ReactNode;
-    /** Version string (e.g. `"1.0.0"`). */
-    version?: string;
-    /** One-sentence description. */
-    comments?: string;
-    /** Developer or organisation name. */
-    developerName?: string;
-    /** Application website URL. */
-    website?: string;
-    /** Label for the website link. Defaults to the URL. */
-    websiteLabel?: string;
-    /** Developer names shown in the Credits tab. */
-    developers?: string[];
-    /** Designer names shown in the Credits tab. */
-    designers?: string[];
-    /** Artist names shown in the Credits tab. */
-    artists?: string[];
-    /** Copyright notice (e.g. `"© 2024 Jane Smith"`). */
-    copyright?: string;
-    /** SPDX identifier or short name (e.g. `"GPL-3.0"`). */
-    licenseType?: string;
-    /** Full license text shown in the Legal tab. */
-    licenseText?: string;
-    /** Extra links shown in the Details section. */
-    links?: AboutDialogLink[];
 }
 /**
  * Blocking modal dialog following the Adwaita pattern.
  *
- * Three modes in one component:
- *
  * **Standard** — `title` + `children` + `buttons[]`.
  *
  * **Alert** — add `role="alertdialog"` + `responses[]` + `onResponse`.
@@ -106,14 +66,9 @@ export interface DialogProps extends Omit<HTMLAttributes<HTMLDivElement>, "title
  * Escape / backdrop fire the first non-destructive response.
  * Mirrors `AdwAlertDialog`.
  *
- * **About** — add `variant="about"` + `applicationName` + info props.
- * Renders app icon, version, details/credits/legal tabs.
- * Mirrors `AdwAboutDialog`.
- *
- * All modes share the same portal, focus-trap, and card/backdrop styles.
+ * For the app-info dialog, use `<AboutDialog />` instead.
  *
  * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.Dialog.html
  * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.AlertDialog.html
- * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.AboutDialog.html
  */
-export declare function Dialog({ open, title, children, buttons, onClose, closeOnBackdrop, role, responses, onResponse, variant, applicationName, applicationIcon, version, comments, developerName, website, websiteLabel, developers, designers, artists, copyright, licenseType, licenseText, links, className, ...props }: DialogProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function Dialog({ open, title, children, buttons, onClose, closeOnBackdrop, role, responses, onResponse, className, ...props }: DialogProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/components/Dialog/dialogUtils.d.ts

@@ -0,0 +1,10 @@
+import { CSSProperties, KeyboardEvent, RefObject } from 'react';
+export declare const FOCUSABLE = "button:not([disabled]), [href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex=\"-1\"])";
+/**
+ * Returns inline styles that anchor a `position:fixed` backdrop to the visual
+ * viewport so the dialog stays centered when the virtual keyboard is open on
+ * mobile (iOS Safari / Android Chrome shrink `visualViewport` but not the
+ * layout viewport that `position:fixed` is relative to).
+ */
+export declare function useVisualViewport(): CSSProperties;
+export declare function trapFocus(e: KeyboardEvent<HTMLDivElement>, ref: RefObject<HTMLDivElement | null>): void;

package/dist/components/Dialog/index.d.ts

@@ -1,2 +1,2 @@
 export { Dialog } from './Dialog';
-export type { DialogProps, DialogButton, AlertDialogResponse, AlertDialogResponseVariant, AboutDialogLink, } from './Dialog';
+export type { DialogProps, DialogButton, AlertDialogResponse, AlertDialogResponseVariant, } from './Dialog';

package/dist/components/ViewSwitcherSidebar/ViewSwitcherSidebar.d.ts

@@ -2,6 +2,7 @@ import { HTMLAttributes, ReactNode } from 'react';
 interface ViewSwitcherSidebarContextValue {
     value: string;
     onValueChange: (value: string) => void;
+    collapsed: boolean;
 }
 export declare function useViewSwitcherSidebar(): ViewSwitcherSidebarContextValue;
 export interface ViewSwitcherSidebarProps extends HTMLAttributes<HTMLElement> {
@@ -11,6 +12,15 @@ export interface ViewSwitcherSidebarProps extends HTMLAttributes<HTMLElement> {
     onValueChange: (value: string) => void;
     /** Accessible label for the group. Defaults to `"Views"`. */
     "aria-label"?: string;
+    /**
+     * When `true`, items render icon-only (labels hidden) and the sidebar
+     * shrinks to its compact width. Used by `AdaptiveLayout` on tablet viewports.
+     */
+    collapsed?: boolean;
+    /** Rendered above the scrollable item list (e.g. user card). */
+    header?: ReactNode;
+    /** Rendered below the scrollable item list (e.g. collapse toggle). */
+    footer?: ReactNode;
     children?: ReactNode;
 }
 /**
@@ -33,5 +43,5 @@ export interface ViewSwitcherSidebarProps extends HTMLAttributes<HTMLElement> {
  * </ViewSwitcherSidebar>
  * ```
  */
-export declare function ViewSwitcherSidebar({ value, onValueChange, "aria-label": ariaLabel, children, className, ...props }: ViewSwitcherSidebarProps): import("react/jsx-runtime").JSX.Element;
+export declare function ViewSwitcherSidebar({ value, onValueChange, "aria-label": ariaLabel, collapsed, header, footer, children, className, ...props }: ViewSwitcherSidebarProps): import("react/jsx-runtime").JSX.Element;
 export {};