@gnome-ui/react 1.9.0 → 1.9.1

package/dist/components/SpinButton/SpinButton.d.ts

@@ -0,0 +1,30 @@
+import { HTMLAttributes } from 'react';
+export interface SpinButtonProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Current value. */
+    value: number;
+    /** Called when the value changes. */
+    onChange: (value: number) => void;
+    /** Minimum allowed value. Defaults to `0`. */
+    min?: number;
+    /** Maximum allowed value. Defaults to `100`. */
+    max?: number;
+    /** Amount to increment/decrement per step. Defaults to `1`. */
+    step?: number;
+    /** Number of decimal places shown. Derived from `step` when omitted. */
+    decimals?: number;
+    /** Disables the control. */
+    disabled?: boolean;
+    /** Accessible label. Required when no visible `<label>` is associated. */
+    "aria-label"?: string;
+    /** Associates the control with a visible label element. */
+    "aria-labelledby"?: string;
+}
+/**
+ * Numeric input with − and + buttons following the Adwaita `GtkSpinButton` style.
+ *
+ * Supports keyboard interaction: ↑/↓ increment by one step,
+ * Page Up/Down increment by 10×, Home/End jump to min/max.
+ *
+ * @see https://developer.gnome.org/hig/patterns/controls/spin-buttons.html
+ */
+export declare function SpinButton({ value, onChange, min, max, step, decimals, disabled, className, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledBy, ...props }: SpinButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SpinButton } from './SpinButton';
+export type { SpinButtonProps } from './SpinButton';

package/dist/components/SpinRow/SpinRow.d.ts

@@ -0,0 +1,37 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface SpinRowProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** Primary label. */
+    title: string;
+    /** Secondary line below the title. */
+    subtitle?: string;
+    /** Icon or image placed at the leading edge. */
+    leading?: ReactNode;
+    /** Current value (controlled). */
+    value?: number;
+    /** Initial value when uncontrolled. Defaults to `0`. */
+    defaultValue?: number;
+    /** Called when the value changes. */
+    onValueChange?: (value: number) => void;
+    /** Minimum allowed value. Defaults to `0`. */
+    min?: number;
+    /** Maximum allowed value. Defaults to `100`. */
+    max?: number;
+    /** Amount to increment/decrement per step. Defaults to `1`. */
+    step?: number;
+    /** Number of decimal places shown. Derived from `step` when omitted. */
+    decimals?: number;
+    /** Disables the row. */
+    disabled?: boolean;
+}
+/**
+ * Settings row with an integrated spin button for numeric values.
+ *
+ * Mirrors `AdwSpinRow` — a standard row layout with − / + buttons at the
+ * trailing edge. Use inside a `BoxedList` for settings with numeric ranges
+ * (volume, timeout duration, count limits, etc.).
+ *
+ * Supports both controlled (`value`) and uncontrolled (`defaultValue`) modes.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.SpinRow.html
+ */
+export declare function SpinRow({ title, subtitle, leading, value: controlledValue, defaultValue, onValueChange, min, max, step, decimals, disabled, className, ...props }: SpinRowProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SpinRow } from './SpinRow';
+export type { SpinRowProps } from './SpinRow';

package/dist/components/Spinner/Spinner.d.ts

@@ -0,0 +1,20 @@
+import { HTMLAttributes } from 'react';
+export type SpinnerSize = "sm" | "md" | "lg";
+export interface SpinnerProps extends HTMLAttributes<HTMLSpanElement> {
+    /** Size of the spinner. Defaults to `"md"`. */
+    size?: SpinnerSize;
+    /**
+     * Accessible label announced by screen readers.
+     * Defaults to `"Loading…"`. Set to `""` to silence if a sibling label is present.
+     */
+    label?: string;
+}
+/**
+ * Indeterminate loading indicator following the Adwaita spinner style.
+ *
+ * Renders a spinning ring using a pure CSS animation that respects
+ * `prefers-reduced-motion`.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/style-classes.html
+ */
+export declare function Spinner({ size, label, className, ...props }: SpinnerProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { Spinner } from './Spinner';
+export type { SpinnerProps, SpinnerSize } from './Spinner';

package/dist/components/SplitButton/SplitButton.d.ts

@@ -0,0 +1,25 @@
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+export type SplitButtonVariant = "default" | "suggested" | "destructive";
+export interface SplitButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
+    /** Label shown in the primary button. */
+    label: string;
+    /** Visual style. Applies to both the primary and toggle halves. */
+    variant?: SplitButtonVariant;
+    /** Content rendered inside the dropdown panel when the arrow is clicked. */
+    dropdownContent: ReactNode;
+    /** Accessible label for the dropdown toggle button. Defaults to "More options". */
+    dropdownLabel?: string;
+    /** Whether both halves are disabled. */
+    disabled?: boolean;
+}
+/**
+ * Primary action button with an attached dropdown arrow.
+ *
+ * Clicking the label half fires `onClick`; clicking the arrow half opens a
+ * floating panel with `dropdownContent` (menus, options, etc.).
+ *
+ * Mirrors `AdwSplitButton` — supports `suggested` and `destructive` variants.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.SplitButton.html
+ */
+export declare function SplitButton({ label, variant, dropdownContent, dropdownLabel, disabled, onClick, className, ...props }: SplitButtonProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SplitButton } from './SplitButton';
+export type { SplitButtonProps, SplitButtonVariant } from './SplitButton';

package/dist/components/StatusPage/StatusPage.d.ts

@@ -0,0 +1,40 @@
+import { HTMLAttributes, ReactNode } from 'react';
+import { IconDefinition } from '@gnome-ui/icons';
+export interface StatusPageProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Large icon displayed above the title.
+     * Use an icon from `@gnome-ui/icons` or omit for a text-only page.
+     */
+    icon?: IconDefinition;
+    /**
+     * Custom icon node. Use when you need an image, emoji, or
+     * a rendered SVG that is not part of `@gnome-ui/icons`.
+     * Ignored when `icon` is also provided.
+     */
+    iconNode?: ReactNode;
+    /** Main heading. Keep it short — one noun phrase. */
+    title: string;
+    /** Supporting description rendered below the title. */
+    description?: string;
+    /**
+     * Optional action area — typically one or two `<Button>` elements.
+     * Rendered below the description.
+     */
+    children?: ReactNode;
+    /**
+     * Reduces padding, icon size, and title scale for use in compact
+     * contexts such as sidebars, popovers, and small panels.
+     * Mirrors the `.compact` style class.
+     */
+    compact?: boolean;
+}
+/**
+ * Empty-state / status page following the Adwaita `AdwStatusPage` pattern.
+ *
+ * Use to fill a view with no content yet, an error state, or a completion
+ * confirmation. Centred both horizontally and vertically.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.StatusPage.html
+ * @see https://developer.gnome.org/hig/patterns/feedback/empty-states.html
+ */
+export declare function StatusPage({ icon, iconNode, title, description, children, compact, className, ...props }: StatusPageProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { StatusPage } from './StatusPage';
+export type { StatusPageProps } from './StatusPage';

package/dist/components/Switch/Switch.d.ts

@@ -0,0 +1,14 @@
+import { InputHTMLAttributes } from 'react';
+export interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /** Accessible label. Required when no visible `<label>` is associated. */
+    "aria-label"?: string;
+}
+/**
+ * On/off toggle following the Adwaita switch style.
+ *
+ * Renders as `<input type="checkbox" role="switch">` so it is natively
+ * keyboard-accessible and works with standard form libraries.
+ *
+ * @see https://developer.gnome.org/hig/patterns/controls/switches.html
+ */
+export declare function Switch({ className, ...props }: SwitchProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { Switch } from './Switch';
+export type { SwitchProps } from './Switch';

package/dist/components/SwitchRow/SwitchRow.d.ts

@@ -0,0 +1,29 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface SwitchRowProps extends Omit<HTMLAttributes<HTMLButtonElement>, "onChange"> {
+    /** Primary label. */
+    title: string;
+    /** Secondary line below the title. */
+    subtitle?: string;
+    /** Icon or image placed at the leading edge. */
+    leading?: ReactNode;
+    /** Controlled checked state. */
+    checked?: boolean;
+    /** Initial checked state when uncontrolled. Defaults to `false`. */
+    defaultChecked?: boolean;
+    /** Called when the checked state changes. */
+    onCheckedChange?: (checked: boolean) => void;
+    /** Disables the row. */
+    disabled?: boolean;
+}
+/**
+ * Activatable row with an integrated switch.
+ *
+ * The entire row is a button — clicking anywhere toggles the switch.
+ * Mirrors `AdwSwitchRow`, which differs from `ActionRow + trailing Switch`
+ * because the row itself is the interactive element.
+ *
+ * Supports both controlled (`checked`) and uncontrolled (`defaultChecked`) modes.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.SwitchRow.html
+ */
+export declare function SwitchRow({ title, subtitle, leading, checked: controlledChecked, defaultChecked, onCheckedChange, disabled, className, onClick, ...props }: SwitchRowProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { SwitchRow } from './SwitchRow';
+export type { SwitchRowProps } from './SwitchRow';

package/dist/components/Tabs/TabBar.d.ts

@@ -0,0 +1,20 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface TabBarProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+    /** Accessible label for the tab list. */
+    "aria-label"?: string;
+    /**
+     * Removes the header-bar background so the tab bar blends into any surface.
+     * Use when placing the bar inside a card, content area, or custom container.
+     * Mirrors the `.inline` style class.
+     */
+    inline?: boolean;
+}
+/**
+ * Horizontal tab bar that holds `TabItem` elements.
+ *
+ * Manages roving-tabindex keyboard navigation (← → Home End).
+ *
+ * @see https://developer.gnome.org/hig/patterns/nav/tabs.html
+ */
+export declare function TabBar({ children, className, inline, "aria-label": ariaLabel, ...props }: TabBarProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Tabs/TabItem.d.ts

@@ -0,0 +1,27 @@
+import { ButtonHTMLAttributes, ReactNode } from 'react';
+import { IconDefinition } from '@gnome-ui/icons';
+export interface TabItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Tab label. */
+    label: string;
+    /** Optional icon from `@gnome-ui/icons`. */
+    icon?: IconDefinition;
+    /** Marks this tab as the currently selected one. */
+    active?: boolean;
+    /**
+     * id of the `TabPanel` this tab controls.
+     * Sets `aria-controls` automatically.
+     */
+    panelId?: string;
+    /**
+     * When provided, a close (×) button is rendered at the trailing edge.
+     * Called when the user clicks the close button.
+     */
+    onClose?: () => void;
+    /** Accessible label for the close button. Defaults to `"Close tab"`. */
+    closeLabel?: string;
+    children?: ReactNode;
+}
+/**
+ * Individual tab button inside a `TabBar`.
+ */
+export declare function TabItem({ label, icon, active, panelId, onClose, closeLabel, className, disabled, ...props }: TabItemProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Tabs/TabPanel.d.ts

@@ -0,0 +1,13 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface TabPanelProps extends HTMLAttributes<HTMLDivElement> {
+    /** Must match the `panelId` passed to the corresponding `TabItem`. */
+    id: string;
+    /** Controls whether this panel is rendered. */
+    active?: boolean;
+    children?: ReactNode;
+}
+/**
+ * Content panel associated with a `TabItem`.
+ * Hidden panels are kept in the DOM but visually hidden.
+ */
+export declare function TabPanel({ id, active, className, children, ...props }: TabPanelProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,6 @@
+export { TabBar } from './TabBar';
+export type { TabBarProps } from './TabBar';
+export { TabItem } from './TabItem';
+export type { TabItemProps } from './TabItem';
+export { TabPanel } from './TabPanel';
+export type { TabPanelProps } from './TabPanel';

package/dist/components/Text/Text.d.ts

@@ -0,0 +1,23 @@
+import { ElementType, HTMLAttributes, ReactNode } from 'react';
+export type TextVariant = "large-title" | "title-1" | "title-2" | "title-3" | "title-4" | "heading" | "body" | "document" | "caption" | "caption-heading" | "monospace" | "numeric";
+export type TextColor = "default" | "dim" | "accent" | "destructive" | "success" | "warning" | "error";
+export interface TextProps extends HTMLAttributes<HTMLElement> {
+    /** Typography style. Mirrors Adwaita / GNOME HIG text styles. */
+    variant?: TextVariant;
+    /** Semantic color. */
+    color?: TextColor;
+    /** Override the rendered HTML element. */
+    as?: ElementType;
+    children?: ReactNode;
+}
+/**
+ * Text component following GNOME Human Interface Guidelines typography styles.
+ *
+ * Variants map directly to Adwaita style classes:
+ * `large-title`, `title-1`–`title-4`, `heading`, `body`, `document`,
+ * `caption`, `caption-heading`, `monospace`, `numeric`.
+ *
+ * @see https://developer.gnome.org/hig/guidelines/typography.html
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/style-classes.html
+ */
+export declare function Text({ variant, color, as, className, children, ...props }: TextProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { Text } from './Text';
+export type { TextProps, TextVariant, TextColor } from './Text';

package/dist/components/TextField/TextField.d.ts

@@ -0,0 +1,22 @@
+import { InputHTMLAttributes } from 'react';
+export interface TextFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "id"> {
+    /** Visible label rendered above the input. */
+    label?: string;
+    /** Helper text rendered below the input. Hidden when `error` is set. */
+    helperText?: string;
+    /**
+     * Error message rendered below the input in place of `helperText`.
+     * Also applies the error visual state to the input border.
+     */
+    error?: string;
+    /** Explicit id. Auto-generated when omitted. */
+    id?: string;
+}
+/**
+ * Single-line text input with label, helper text, and error state.
+ *
+ * Follows the Adwaita `GtkEntry` / `.entry` style class.
+ *
+ * @see https://developer.gnome.org/hig/patterns/controls/text-fields.html
+ */
+export declare function TextField({ label, helperText, error, id: idProp, className, disabled, ...props }: TextFieldProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { TextField } from './TextField';
+export type { TextFieldProps } from './TextField';

package/dist/components/Toast/Toast.d.ts

@@ -0,0 +1,29 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface ToastProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** The notification message. Keep it short — one sentence. */
+    title: ReactNode;
+    /**
+     * Auto-dismiss timeout in milliseconds.
+     * - Set to `0` to disable auto-dismiss (user must click action or dismiss).
+     * - Defaults to `3000`.
+     */
+    duration?: number;
+    /** Called when the toast should be removed — after timeout or user action. */
+    onDismiss?: () => void;
+    /** Label for the optional action button. */
+    actionLabel?: string;
+    /** Called when the user clicks the action button. */
+    onAction?: () => void;
+    /** Whether to show a manual dismiss (×) button. */
+    dismissible?: boolean;
+}
+/**
+ * Non-blocking temporary notification following the Adwaita `AdwToast` pattern.
+ *
+ * - Auto-dismisses after `duration` ms (default 3 s). Set `duration={0}` to disable.
+ * - Timer pauses while the toast is hovered or focused.
+ * - Use inside `<Toaster>` for correct positioning and stacking.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.Toast.html
+ */
+export declare function Toast({ title, duration, onDismiss, actionLabel, onAction, dismissible, className, ...props }: ToastProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Toast/Toaster.d.ts

@@ -0,0 +1,30 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface ToasterProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Where to render the toast stack.
+     * - `bottom` (default) — bottom-center, following the GNOME HIG.
+     * - `top` — top-center.
+     */
+    position?: "bottom" | "top";
+    /** `<Toast>` elements to display. */
+    children?: ReactNode;
+    /**
+     * DOM node to render the portal into.
+     * Defaults to `document.body`.
+     */
+    container?: Element | DocumentFragment;
+}
+/**
+ * Fixed-position overlay that stacks `<Toast>` notifications.
+ *
+ * Renders into a portal (default: `document.body`) so it sits above all
+ * other content regardless of where you place it in the React tree.
+ *
+ * @example
+ * <Toaster>
+ *   {toasts.map(t => (
+ *     <Toast key={t.id} title={t.message} onDismiss={() => remove(t.id)} />
+ *   ))}
+ * </Toaster>
+ */
+export declare function Toaster({ position, children, container, className, ...props }: ToasterProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { Toast } from './Toast';
+export type { ToastProps } from './Toast';
+export { Toaster } from './Toaster';
+export type { ToasterProps } from './Toaster';

package/dist/components/ToggleGroup/ToggleGroup.d.ts

@@ -0,0 +1,29 @@
+import { HTMLAttributes, ReactNode } from 'react';
+interface ToggleGroupContextValue {
+    value: string;
+    onValueChange: (value: string) => void;
+}
+export declare function useToggleGroup(): ToggleGroupContextValue;
+export interface ToggleGroupProps extends HTMLAttributes<HTMLDivElement> {
+    /** Name of the currently active toggle. */
+    value: string;
+    /** Called with the new value when a toggle is selected. */
+    onValueChange: (value: string) => void;
+    /** Accessible label for the group. */
+    "aria-label"?: string;
+    children?: ReactNode;
+}
+/**
+ * Mutually-exclusive group of toggle buttons for in-place option selection.
+ *
+ * Mirrors `AdwToggleGroup` (libadwaita 1.7 / GNOME 48).
+ *
+ * Use for formatting controls, view-mode selectors, and toolbar options —
+ * wherever a `ViewSwitcher` would be too heavy or is not placed in a HeaderBar.
+ *
+ * Compose with `ToggleGroupItem`. Keyboard: ← / → cycle, Home / End jump.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.ToggleGroup.html
+ */
+export declare function ToggleGroup({ value, onValueChange, "aria-label": ariaLabel, children, className, ...props }: ToggleGroupProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/components/ToggleGroup/ToggleGroupItem.d.ts

@@ -0,0 +1,17 @@
+import { ButtonHTMLAttributes } from 'react';
+import { IconDefinition } from '@gnome-ui/icons';
+export interface ToggleGroupItemProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** String identifier — used as the group's `value` when this item is selected. */
+    name: string;
+    /** Visible label. Omit for icon-only items (provide `aria-label` instead). */
+    label?: string;
+    /** Icon from `@gnome-ui/icons`. */
+    icon?: IconDefinition;
+}
+/**
+ * Individual toggle inside a `ToggleGroup`.
+ *
+ * Can be icon-only, label-only, or icon + label. For icon-only items always
+ * provide an `aria-label` so screen readers can identify the option.
+ */
+export declare function ToggleGroupItem({ name, label, icon, disabled, className, ...props }: ToggleGroupItemProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { ToggleGroup } from './ToggleGroup';
+export type { ToggleGroupProps } from './ToggleGroup';
+export { ToggleGroupItem } from './ToggleGroupItem';
+export type { ToggleGroupItemProps } from './ToggleGroupItem';

package/dist/components/Toolbar/Spacer.d.ts

@@ -0,0 +1,19 @@
+import { HTMLAttributes } from 'react';
+export interface SpacerProps extends HTMLAttributes<HTMLDivElement> {
+}
+/**
+ * Invisible `flex: 1` filler for `Toolbar` and `HeaderBar`.
+ *
+ * Place between leading and trailing groups to push trailing items to the end.
+ * Mirrors `GtkSeparator` with the `.spacer` style class.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/style-classes.html#spacer
+ *
+ * @example
+ * <Toolbar>
+ *   <Button variant="flat">Back</Button>
+ *   <Spacer />
+ *   <Button variant="flat">Done</Button>
+ * </Toolbar>
+ */
+export declare function Spacer({ className, ...props }: SpacerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/Toolbar/Toolbar.d.ts

@@ -0,0 +1,18 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface ToolbarProps extends HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+}
+/**
+ * Horizontal action bar following the libadwaita `.toolbar` pattern.
+ *
+ * Provides 6 px padding and gap — the standard spacing for rows of flat
+ * buttons in header bars, action bars, and tool rows. Place `<Spacer />`
+ * between leading and trailing groups to push trailing items to the end.
+ *
+ * Use `<Button variant="flat">` or `<Button variant="raised">` inside:
+ * - `flat` for buttons that blend into the bar background.
+ * - `raised` for buttons that need explicit elevation within a flat context.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/1-latest/style-classes.html#toolbar-style-class
+ */
+export declare function Toolbar({ children, className, ...props }: ToolbarProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,4 @@
+export { Toolbar } from './Toolbar';
+export type { ToolbarProps } from './Toolbar';
+export { Spacer } from './Spacer';
+export type { SpacerProps } from './Spacer';

package/dist/components/ToolbarView/ToolbarView.d.ts

@@ -0,0 +1,27 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface ToolbarViewProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Bar(s) pinned to the top — typically a `HeaderBar` or `Toolbar`.
+     * Multiple bars stack vertically.
+     */
+    topBar?: ReactNode;
+    /**
+     * Bar(s) pinned to the bottom — typically a `Toolbar` or `ViewSwitcherBar`.
+     * Multiple bars stack vertically.
+     */
+    bottomBar?: ReactNode;
+    /** Scrollable content area between the bars. */
+    children?: ReactNode;
+}
+/**
+ * Layout container that attaches bars at the top and/or bottom while
+ * scrolling only the middle content.
+ *
+ * The top/bottom bars remain fixed; the inner content area gets
+ * `overflow-y: auto` so it scrolls independently.
+ *
+ * Mirrors `AdwToolbarView`.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.ToolbarView.html
+ */
+export declare function ToolbarView({ topBar, bottomBar, children, className, ...props }: ToolbarViewProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { ToolbarView } from './ToolbarView';
+export type { ToolbarViewProps } from './ToolbarView';

package/dist/components/Tooltip/Tooltip.d.ts

@@ -0,0 +1,44 @@
+import { ReactElement, HTMLAttributes } from 'react';
+export type TooltipPlacement = "top" | "bottom" | "left" | "right";
+export interface TooltipProps {
+    /**
+     * The tooltip label. Keep it short — a noun phrase or brief description.
+     * Do not duplicate information already visible on screen.
+     */
+    label: string;
+    /**
+     * Preferred placement relative to the trigger.
+     * The tooltip flips automatically if there is not enough space.
+     * Defaults to `"top"`.
+     */
+    placement?: TooltipPlacement;
+    /**
+     * Delay in milliseconds before the tooltip appears on hover.
+     * Defaults to `500`. Set to `0` for instant.
+     */
+    delay?: number;
+    /**
+     * The element that triggers the tooltip.
+     * Must be a single React element that can receive `ref` and event props.
+     */
+    children: ReactElement<HTMLAttributes<HTMLElement>>;
+}
+/**
+ * Informational tooltip following the Adwaita / GNOME HIG pattern.
+ *
+ * Wraps a single trigger element and shows a floating label on hover or
+ * keyboard focus. The tooltip is positioned automatically and flips if
+ * there is not enough space.
+ *
+ * - `aria-describedby` is wired to the trigger automatically.
+ * - The tooltip itself is `role="tooltip"` and rendered in a portal.
+ * - Does not show on touch — touch devices have no hover state.
+ *
+ * @example
+ * <Tooltip label="Save file (Ctrl+S)">
+ *   <Button aria-label="Save"><Icon icon={Save} /></Button>
+ * </Tooltip>
+ *
+ * @see https://developer.gnome.org/hig/patterns/feedback/tooltips.html
+ */
+export declare function Tooltip({ label, placement: preferredPlacement, delay, children, }: TooltipProps): import("react/jsx-runtime").JSX.Element;

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

@@ -0,0 +1,2 @@
+export { Tooltip } from './Tooltip';
+export type { TooltipProps, TooltipPlacement } from './Tooltip';

package/dist/components/ViewSwitcher/ViewSwitcher.d.ts

@@ -0,0 +1,19 @@
+import { HTMLAttributes, ReactNode } from 'react';
+export interface ViewSwitcherProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+    /** Accessible label for the group. */
+    "aria-label"?: string;
+}
+/**
+ * Segmented control for switching between major views.
+ *
+ * Mirrors the Adwaita `AdwViewSwitcher` pattern. Place in a `HeaderBar`
+ * as the `title` for the canonical GNOME layout.
+ *
+ * Compose with `ViewSwitcherItem` for each option.
+ * Keyboard: ← / → cycle through items, Home / End jump to first / last.
+ *
+ * @see https://gnome.pages.gitlab.gnome.org/libadwaita/doc/main/class.ViewSwitcher.html
+ * @see https://developer.gnome.org/hig/patterns/nav/view-switchers.html
+ */
+export declare function ViewSwitcher({ children, className, "aria-label": ariaLabel, ...props }: ViewSwitcherProps): import("react/jsx-runtime").JSX.Element;