@mortenbrudvik/waveui 0.4.0

package/dist/index.d.ts

@@ -0,0 +1,2438 @@
+import { ClassValue } from 'clsx';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+
+export declare const Accordion: {
+    ({ type, openItems: controlledOpenItems, defaultOpenItems, onOpenItemsChange, className, children, ref, ...rest }: AccordionProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ value, className, children, ref, ...rest }: AccordionItemProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Trigger: {
+        ({ children, ref, ...rest }: React_2.HTMLAttributes<HTMLSpanElement> & {
+            ref?: React_2.Ref<HTMLSpanElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Panel: {
+        ({ children, ref, ...rest }: React_2.HTMLAttributes<HTMLDivElement> & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the AccordionItem sub-component. */
+export declare interface AccordionItemProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Unique value identifying this accordion item. */
+    value: string;
+}
+
+/** Properties for the Accordion component. */
+export declare interface AccordionProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Whether only one or multiple items can be open at a time.
+     * @default 'single'
+     */
+    type?: 'single' | 'multiple';
+    /** Controlled array of currently open item values. */
+    openItems?: string[];
+    /** Default open items for uncontrolled usage.
+     * @default []
+     */
+    defaultOpenItems?: string[];
+    /** Callback invoked when the set of open items changes. */
+    onOpenItemsChange?: (openItems: string[]) => void;
+}
+
+/** Visual style variant controlling fill, border, and background treatment. */
+export declare type Appearance = 'primary' | 'outline' | 'subtle' | 'transparent';
+
+export declare const Avatar: {
+    ({ src, name, size, icon, image, badge, className, ref, ...props }: AvatarProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+export declare const AvatarGroup: {
+    ({ max, size, className, children, ref, ...props }: AvatarGroupProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the AvatarGroup component. */
+export declare interface AvatarGroupProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Maximum number of avatars to display before showing an overflow indicator. */
+    max?: number;
+    /** Size of the overflow indicator badge.
+     * @default 'medium'
+     */
+    size?: Size;
+}
+
+/** Properties for the Avatar component. */
+export declare interface AvatarProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** URL of the avatar image. */
+    src?: string;
+    /** Full name used to generate initials when no image is provided. */
+    name?: string;
+    /** Size of the avatar.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Custom icon to display when no image or name is provided. */
+    icon?: React_2.ReactNode;
+    /** Slot for a custom image element. */
+    image?: Slot<'img'>;
+    /** Slot for a badge element positioned at the bottom-right corner. */
+    badge?: Slot<'span'>;
+}
+
+export declare const Badge: {
+    ({ appearance, color, size, className, children, ref, ...props }: BadgeProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Visual style variant for Badge components. */
+export declare type BadgeAppearance = 'filled' | 'tint' | 'outline';
+
+/** Semantic color for Badge components. */
+export declare type BadgeColor = 'brand' | 'success' | 'warning' | 'danger' | 'important' | 'informative';
+
+/** Properties for the Badge component. */
+export declare interface BadgeProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Visual style of the badge.
+     * @default 'filled'
+     */
+    appearance?: BadgeAppearance;
+    /** Semantic color of the badge.
+     * @default 'brand'
+     */
+    color?: BadgeColor;
+    /** Size of the badge.
+     * @default 'medium'
+     */
+    size?: Size;
+}
+
+export declare const Breadcrumb: {
+    ({ children, className, ref, ...rest }: BreadcrumbProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ href, current, icon, children, className, ref, ...rest }: BreadcrumbItemProps & {
+            ref?: React_2.Ref<HTMLSpanElement | HTMLAnchorElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the BreadcrumbItem sub-component. */
+export declare interface BreadcrumbItemProps extends React_2.HTMLAttributes<HTMLElement> {
+    /** URL the breadcrumb item links to. */
+    href?: string;
+    /** Whether this item represents the current page. */
+    current?: boolean;
+    /** Slot for an icon displayed before the item text. */
+    icon?: Slot<'span'>;
+    /** Label content of the breadcrumb item. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the Breadcrumb component. */
+export declare interface BreadcrumbProps extends React_2.HTMLAttributes<HTMLElement> {
+    /** Breadcrumb items to render. */
+    children: React_2.ReactNode;
+}
+
+export declare const Button: {
+    ({ as, appearance, size, icon, disabled, className, children, ref, ...props }: ButtonProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Button component. */
+export declare interface ButtonProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Custom element type to render as.
+     * @default 'button'
+     */
+    as?: React_2.ElementType;
+    /** Visual style variant.
+     * @default 'outline'
+     */
+    appearance?: Appearance;
+    /** Size affecting padding and font size.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Icon slot rendered before the button label. */
+    icon?: Slot<'span'>;
+}
+
+export declare const Card: {
+    ({ as: Component, selected, onSelect, className, children, ref, ...props }: CardProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Header: {
+        ({ as: Component, title, subtitle, className, children, ref, ...props }: CardHeaderProps & {
+            ref?: React_2.Ref<HTMLElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Body: {
+        ({ as: Component, className, ref, ...props }: CardBodyProps & {
+            ref?: React_2.Ref<HTMLElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Footer: {
+        ({ as: Component, className, ref, ...props }: CardFooterProps & {
+            ref?: React_2.Ref<HTMLElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the CardBody sub-component. */
+export declare interface CardBodyProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+}
+
+/** Properties for the CardFooter sub-component. */
+export declare interface CardFooterProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+}
+
+/** Properties for the CardHeader sub-component. */
+export declare interface CardHeaderProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'title'> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+    /** Title content displayed in the card header. */
+    title?: React_2.ReactNode;
+    /** Subtitle content displayed below the title. */
+    subtitle?: React_2.ReactNode;
+}
+
+/** Properties for the Card component. */
+export declare interface CardProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+    /** Whether the card is in a selected state. */
+    selected?: boolean;
+    /** Callback invoked when the card is clicked for selection. */
+    onSelect?: () => void;
+}
+
+export declare const Carousel: {
+    ({ value: controlledValue, defaultValue, onValueChange, autoPlay, autoPlayInterval, loop, className, children, ref, ...rest }: CarouselProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ className, children, ref, ...rest }: CarouselItemProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the CarouselItem sub-component. */
+export declare type CarouselItemProps = React_2.HTMLAttributes<HTMLDivElement>;
+
+/** Properties for the Carousel component. */
+export declare interface CarouselProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Controlled index of the currently active slide. */
+    value?: number;
+    /** Default active slide index for uncontrolled usage.
+     * @default 0
+     */
+    defaultValue?: number;
+    /** Callback invoked when the active slide changes. */
+    onValueChange?: (index: number) => void;
+    /** Whether the carousel auto-advances slides.
+     * @default false
+     */
+    autoPlay?: boolean;
+    /** Interval in milliseconds between auto-play transitions.
+     * @default 5000
+     */
+    autoPlayInterval?: number;
+    /** Whether the carousel loops back to the first slide after the last.
+     * @default false
+     */
+    loop?: boolean;
+}
+
+export declare const Checkbox: {
+    ({ checked: controlledChecked, defaultChecked, indeterminate, onChange, disabled, label, className, ref, ...rest }: CheckboxProps & {
+        ref?: React_2.Ref<HTMLLabelElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Checkbox component. */
+export declare interface CheckboxProps extends Omit<React_2.HTMLAttributes<HTMLLabelElement>, 'onChange' | 'defaultChecked'> {
+    /** Controlled checked state. */
+    checked?: boolean;
+    /** Initial checked state for uncontrolled usage.
+     * @default false
+     */
+    defaultChecked?: boolean;
+    /** Whether the checkbox shows an indeterminate (mixed) state. */
+    indeterminate?: boolean;
+    /** Callback fired when the checked state changes. */
+    onChange?: (checked: boolean) => void;
+    /** Whether the checkbox is disabled and non-interactive. */
+    disabled?: boolean;
+    /** Text label displayed next to the checkbox. */
+    label?: string;
+}
+
+export declare function cn(...inputs: ClassValue[]): string;
+
+export declare const ColorPicker: {
+    ({ value: controlledValue, defaultValue, onChange, presets, showOpacity, className, ref, ...rest }: ColorPickerProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the ColorPicker component. */
+export declare interface ColorPickerProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled hex color value (e.g., '#0f6cbd'). */
+    value?: string;
+    /** Initial hex color for uncontrolled usage.
+     * @default '#0f6cbd'
+     */
+    defaultValue?: string;
+    /** Callback fired when the selected color changes. */
+    onChange?: (color: string) => void;
+    /** Array of preset hex colors displayed as quick-select swatches.
+     * @default ['#0f6cbd','#d13438','#107c10','#ffb900','#5c2d91','#008272','#e3008c','#242424']
+     */
+    presets?: string[];
+    /** Whether to show the opacity slider.
+     * @default false
+     */
+    showOpacity?: boolean;
+}
+
+export declare const Combobox: {
+    ({ value: controlledValue, defaultValue, onOptionSelect, placeholder, disabled, freeform, className, children, ref, ...rest }: ComboboxProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Option: {
+        ({ value, disabled, className, children, ref, ...rest }: OptionProps & {
+            ref?: React_2.Ref<HTMLLIElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    OptionGroup: {
+        ({ label, className, children, ref, ...rest }: OptionGroupProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the Combobox component. */
+export declare interface ComboboxProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled selected value. */
+    value?: string;
+    /** Initial selected value for uncontrolled usage.
+     * @default ''
+     */
+    defaultValue?: string;
+    /** Callback fired when an option is selected. */
+    onOptionSelect?: (value: string) => void;
+    /** Placeholder text shown when no value is selected. */
+    placeholder?: string;
+    /** Whether the combobox is disabled and non-interactive.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Whether to allow free-form text input that filters options.
+     * @default false
+     */
+    freeform?: boolean;
+}
+
+export declare const CompoundButton: {
+    ({ as, secondaryText, appearance, size, disabled, className, children, ref, ...props }: CompoundButtonProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the CompoundButton component. */
+export declare interface CompoundButtonProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Custom element type to render as.
+     * @default 'button'
+     */
+    as?: React_2.ElementType;
+    /** Secondary descriptive text displayed below the main label. */
+    secondaryText?: React_2.ReactNode;
+    /** Visual style variant.
+     * @default 'outline'
+     */
+    appearance?: Appearance;
+    /** Size affecting padding and font size.
+     * @default 'medium'
+     */
+    size?: Size;
+}
+
+export declare const CounterBadge: {
+    ({ count, overflowCount, appearance, className, ref, ...props }: CounterBadgeProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element | null;
+    displayName: string;
+};
+
+/** Properties for the CounterBadge component. */
+export declare interface CounterBadgeProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Numeric count to display. Hidden when count is 0 or less. */
+    count: number;
+    /** Maximum count before displaying overflow indicator (e.g. "99+").
+     * @default 99
+     */
+    overflowCount?: number;
+    /** Visual style of the counter badge.
+     * @default 'filled'
+     */
+    appearance?: 'filled' | 'outline';
+}
+
+export declare const DataGrid: {
+    ({ sortColumn: sortColumnProp, defaultSortColumn, sortDirection: sortDirectionProp, defaultSortDirection, onSortChange, selectionMode, selectedKeys: selectedKeysProp, defaultSelectedKeys, onSelectionChange, children, className, columns: _columns, ref, ...rest }: DataGridProps & {
+        ref?: React_2.Ref<HTMLTableElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Header: {
+        ({ children, className, ref, ...rest }: DataGridHeaderProps & {
+            ref?: React_2.Ref<HTMLTableSectionElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    HeaderCell: {
+        ({ columnId, sortable, children, className, ref, ...rest }: DataGridHeaderCellProps & {
+            ref?: React_2.Ref<HTMLTableCellElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Body: {
+        ({ children, className, ref, ...rest }: DataGridBodyProps & {
+            ref?: React_2.Ref<HTMLTableSectionElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Row: {
+        ({ rowId, children, className, ref, ...rest }: DataGridRowProps & {
+            ref?: React_2.Ref<HTMLTableRowElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Cell: {
+        ({ children, className, ref, ...rest }: DataGridCellProps & {
+            ref?: React_2.Ref<HTMLTableCellElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the DataGridBody sub-component. */
+export declare interface DataGridBodyProps extends React_2.HTMLAttributes<HTMLTableSectionElement> {
+    /** DataGrid row elements. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the DataGridCell sub-component. */
+export declare interface DataGridCellProps extends React_2.TdHTMLAttributes<HTMLTableCellElement> {
+    /** Cell content. */
+    children: React_2.ReactNode;
+}
+
+/** Defines a column in the DataGrid. */
+export declare interface DataGridColumn {
+    /** Unique identifier for the column. */
+    id: string;
+    /** Display label for the column header. */
+    label: string;
+    /** Whether the column supports sorting. */
+    sortable?: boolean;
+}
+
+/** Properties for the DataGridHeaderCell sub-component. */
+export declare interface DataGridHeaderCellProps extends React_2.ThHTMLAttributes<HTMLTableCellElement> {
+    /** Column ID used for sort tracking. */
+    columnId?: string;
+    /** Whether this column header supports click-to-sort.
+     * @default false
+     */
+    sortable?: boolean;
+    /** Header cell content. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the DataGridHeader sub-component. */
+export declare interface DataGridHeaderProps extends React_2.HTMLAttributes<HTMLTableSectionElement> {
+    /** Header row elements. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the DataGrid component. */
+export declare interface DataGridProps extends React_2.HTMLAttributes<HTMLTableElement> {
+    /** Column definitions for automatic header rendering. */
+    columns?: DataGridColumn[];
+    /** Controlled column ID currently being sorted. */
+    sortColumn?: string;
+    /** Default sort column for uncontrolled usage.
+     * @default ''
+     */
+    defaultSortColumn?: string;
+    /** Controlled sort direction. */
+    sortDirection?: SortDirection;
+    /** Default sort direction for uncontrolled usage.
+     * @default 'ascending'
+     */
+    defaultSortDirection?: SortDirection;
+    /** Callback invoked when the sort column or direction changes. */
+    onSortChange?: (columnId: string, direction: SortDirection) => void;
+    /** Row selection mode.
+     * @default 'none'
+     */
+    selectionMode?: 'none' | 'single' | 'multiple';
+    /** Controlled set of selected row keys. */
+    selectedKeys?: Set<string>;
+    /** Default selected keys for uncontrolled usage. */
+    defaultSelectedKeys?: Set<string>;
+    /** Callback invoked when the selected rows change. */
+    onSelectionChange?: (keys: Set<string>) => void;
+    /** DataGrid header, body, and row elements. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the DataGridRow sub-component. */
+export declare interface DataGridRowProps extends React_2.HTMLAttributes<HTMLTableRowElement> {
+    /** Unique identifier for this row, used for selection tracking. */
+    rowId?: string;
+    /** DataGrid cell elements. */
+    children: React_2.ReactNode;
+}
+
+export declare const DatePicker: {
+    ({ value: controlledValue, defaultValue, onChange, formatDate, parseDate, minDate, maxDate, disabledDates, placeholder, disabled, clearable, firstDayOfWeek, open: controlledOpen, onOpenChange, className, ref, ...rest }: DatePickerProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the DatePicker component. */
+export declare interface DatePickerProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** Controlled selected date. */
+    value?: Date | null;
+    /** Initial date for uncontrolled usage.
+     * @default null
+     */
+    defaultValue?: Date | null;
+    /** Callback fired when the selected date changes. */
+    onChange?: (date: Date | null) => void;
+    /** Custom function to format a Date into display text. */
+    formatDate?: (date: Date) => string;
+    /** Custom function to parse user input text into a Date. */
+    parseDate?: (str: string) => Date | null;
+    /** Earliest selectable date. */
+    minDate?: Date;
+    /** Latest selectable date. */
+    maxDate?: Date;
+    /** Function returning true for dates that should be disabled. */
+    disabledDates?: (date: Date) => boolean;
+    /** Placeholder text shown when no date is selected.
+     * @default 'Select a date'
+     */
+    placeholder?: string;
+    /** Whether the date picker is disabled and non-interactive.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Whether to show a clear button when a date is selected.
+     * @default false
+     */
+    clearable?: boolean;
+    /** First day of the week (0 = Sunday, 1 = Monday, etc.).
+     * @default 0
+     */
+    firstDayOfWeek?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** Controlled open state of the calendar popup. */
+    open?: boolean;
+    /** Callback fired when the calendar popup open state changes. */
+    onOpenChange?: (open: boolean) => void;
+}
+
+export declare const Dialog: typeof DialogRoot & {
+    Trigger: {
+        ({ children, ref, ...rest }: DialogTriggerProps & {
+            ref?: React_2.Ref<HTMLSpanElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Content: {
+        ({ title, size, children, className, ref, ...rest }: DialogContentProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): React_2.ReactPortal | null;
+        displayName: string;
+    };
+    Footer: {
+        ({ children, className, ref, ...rest }: DialogFooterProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the DialogContent sub-component. */
+export declare interface DialogContentProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Title displayed at the top of the dialog. */
+    title?: string;
+    /** Width size of the dialog.
+     * @default 'medium'
+     */
+    size?: 'small' | 'medium';
+    /** Content to render inside the dialog body. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the DialogFooter sub-component. */
+export declare interface DialogFooterProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Footer content, typically action buttons. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the Dialog component. */
+export declare interface DialogProps {
+    /** Controlled open state of the dialog. */
+    open?: boolean;
+    /** Default open state for uncontrolled usage.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /** Callback invoked when the dialog open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Dialog trigger, content, and footer elements. */
+    children: React_2.ReactNode;
+}
+
+declare function DialogRoot({ open, defaultOpen, onOpenChange, children }: DialogProps): JSX.Element;
+
+declare namespace DialogRoot {
+    var displayName: string;
+}
+
+/** Properties for the DialogTrigger sub-component. */
+export declare interface DialogTriggerProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Trigger element that opens the dialog on click. */
+    children: React_2.ReactNode;
+}
+
+export declare const Divider: {
+    ({ as, orientation, className, children, ref, ...props }: DividerProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Divider component. */
+export declare interface DividerProps extends React_2.HTMLAttributes<HTMLElement> {
+    /** Element type to render as. */
+    as?: React_2.ElementType;
+    /** Orientation of the divider line.
+     * @default 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical';
+}
+
+export declare const Drawer: {
+    ({ open: openProp, defaultOpen, onOpenChange, position, title, children, className, ref, ...rest }: DrawerProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): React_2.ReactPortal | null;
+    displayName: string;
+};
+
+/** Properties for the Drawer component. */
+export declare interface DrawerProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Controlled open state of the drawer. */
+    open?: boolean;
+    /** Default open state for uncontrolled usage.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /** Callback invoked when the drawer open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Side of the screen from which the drawer slides in.
+     * @default 'right'
+     */
+    position?: 'left' | 'right';
+    /** Title displayed in the drawer header. */
+    title?: string;
+    /** Content to render inside the drawer body. */
+    children: React_2.ReactNode;
+}
+
+export declare const Dropdown: {
+    ({ value: controlledValue, defaultValue, onOptionSelect, placeholder, disabled, className, children, ref, ...rest }: DropdownProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Option: {
+        ({ value, disabled, className, children, ref, ...rest }: OptionProps & {
+            ref?: React_2.Ref<HTMLLIElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    OptionGroup: {
+        ({ label, className, children, ref, ...rest }: OptionGroupProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the Dropdown component. */
+export declare interface DropdownProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled selected value. */
+    value?: string;
+    /** Initial selected value for uncontrolled usage.
+     * @default ''
+     */
+    defaultValue?: string;
+    /** Callback fired when an option is selected. */
+    onOptionSelect?: (value: string) => void;
+    /** Placeholder text shown when no value is selected.
+     * @default 'Select an option'
+     */
+    placeholder?: string;
+    /** Whether the dropdown is disabled and non-interactive.
+     * @default false
+     */
+    disabled?: boolean;
+}
+
+export declare const Field: {
+    ({ label, hint, error, required, htmlFor, className, children, ref, ...rest }: FieldProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Field component. */
+export declare interface FieldProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Label text displayed above the field. */
+    label?: string;
+    /** Hint text displayed below the field when no error is present. */
+    hint?: string;
+    /** Error message displayed below the field; sets `aria-invalid` on the child. */
+    error?: string;
+    /** Whether the field is required; shows a red asterisk next to the label. */
+    required?: boolean;
+    /** Explicit `for` attribute linking the label to a child input. */
+    htmlFor?: string;
+}
+
+export declare const Flex: {
+    ({ as: Component, direction, wrap, align, justify, gap, inline, grow, shrink, className, children, ref, ...props }: FlexProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Flex component. */
+export declare interface FlexProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+    /** Flex direction.
+     * @default 'row'
+     */
+    direction?: 'row' | 'row-reverse' | 'column' | 'column-reverse';
+    /** Flex wrap behavior. */
+    wrap?: 'nowrap' | 'wrap' | 'wrap-reverse';
+    /** Cross-axis alignment of items. */
+    align?: 'start' | 'center' | 'end' | 'stretch' | 'baseline';
+    /** Main-axis justification of items. */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+    /** Gap size between flex items. */
+    gap?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Whether to use inline-flex instead of flex. */
+    inline?: boolean;
+    /** Whether the flex container should grow to fill available space. */
+    grow?: boolean;
+    /** Whether the flex container should shrink if necessary. */
+    shrink?: boolean;
+}
+
+export declare const Grid: {
+    ({ as: Component, columns, rows, gap, columnGap, rowGap, align, justify, className, style, children, ref, ...props }: GridProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Grid component. */
+export declare interface GridProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+    /** Number of grid columns. */
+    columns?: 1 | 2 | 3 | 4 | 5 | 6 | 12;
+    /** Number of grid rows. */
+    rows?: number;
+    /** Uniform gap size between grid items. */
+    gap?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Horizontal gap size between grid columns. */
+    columnGap?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Vertical gap size between grid rows. */
+    rowGap?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Vertical alignment of items within the grid. */
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    /** Horizontal alignment of items within the grid. */
+    justify?: 'start' | 'center' | 'end' | 'stretch';
+}
+
+declare const Image_2: {
+    ({ fit, shape, shadow, block, bordered, className, alt, ref, ...rest }: ImageProps & {
+        ref?: React_2.Ref<HTMLImageElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+export { Image_2 as Image }
+
+export declare type ImageFit = 'none' | 'center' | 'contain' | 'cover' | 'default';
+
+/** Properties for the Image component. */
+export declare interface ImageProps extends React_2.ImgHTMLAttributes<HTMLImageElement> {
+    /** How the image fits within its container.
+     * @default 'default'
+     */
+    fit?: ImageFit;
+    /** Shape of the image border radius.
+     * @default 'square'
+     */
+    shape?: ImageShape;
+    /** Whether to apply a shadow to the image.
+     * @default false
+     */
+    shadow?: boolean;
+    /** Whether the image is displayed as a block element filling its container width.
+     * @default false
+     */
+    block?: boolean;
+    /** Whether to show a border around the image.
+     * @default false
+     */
+    bordered?: boolean;
+}
+
+export declare type ImageShape = 'circular' | 'rounded' | 'square';
+
+export declare const InfoLabel: {
+    ({ label, info, className, ref, ...props }: InfoLabelProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the InfoLabel component. */
+export declare interface InfoLabelProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Primary label text to display. */
+    label: string;
+    /** Informational tooltip text shown via the info icon. */
+    info: string;
+}
+
+export declare const Input: {
+    ({ error, contentBefore, contentAfter, className, ref, ...props }: InputProps & {
+        ref?: React_2.Ref<HTMLInputElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Input component. */
+export declare interface InputProps extends React_2.InputHTMLAttributes<HTMLInputElement> {
+    /** Validation error message; sets `aria-invalid` when provided. */
+    error?: string;
+    /** Slot rendered before the input text (e.g., an icon). */
+    contentBefore?: Slot<'span'>;
+    /** Slot rendered after the input text (e.g., a suffix). */
+    contentAfter?: Slot<'span'>;
+}
+
+export declare const Label: {
+    ({ required, disabled, size, weight, className, children, ref, ...rest }: LabelProps & {
+        ref?: React_2.Ref<HTMLLabelElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Label component. */
+export declare interface LabelProps extends React_2.LabelHTMLAttributes<HTMLLabelElement> {
+    /** Whether to show a required indicator asterisk.
+     * @default false
+     */
+    required?: boolean;
+    /** Whether the label is visually dimmed.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Text size of the label.
+     * @default 'medium'
+     */
+    size?: Extract<Size, 'small' | 'medium' | 'large'>;
+    /** Font weight of the label.
+     * @default 'regular'
+     */
+    weight?: 'regular' | 'semibold';
+}
+
+export declare const Link: {
+    ({ as, variant, disabled, className, children, onClick, ref, ...props }: LinkProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Link component. */
+export declare interface LinkProps extends React_2.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** Custom element type to render as.
+     * @default 'a'
+     */
+    as?: React_2.ElementType;
+    /** Visual style variant for the link.
+     * @default 'inline'
+     */
+    variant?: LinkVariant;
+    /** Whether the link is disabled and non-interactive. */
+    disabled?: boolean;
+}
+
+export declare type LinkVariant = 'inline' | 'standalone' | 'subtle';
+
+export declare const List: {
+    ({ selectable, selectionMode, selectedItems: controlledSelected, defaultSelectedItems, onSelectionChange, className, children, ref, ...rest }: ListProps & {
+        ref?: React_2.Ref<HTMLUListElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ value, action, className, children, onClick, ref, ...rest }: ListItemProps & {
+            ref?: React_2.Ref<HTMLLIElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the ListItem component. */
+export declare interface ListItemProps extends React_2.HTMLAttributes<HTMLLIElement> {
+    /** Unique value identifying this item for selection tracking. */
+    value?: string;
+    /** Action element rendered at the end of the list item. */
+    action?: React_2.ReactNode;
+}
+
+/** Properties for the List component. */
+export declare interface ListProps extends React_2.HTMLAttributes<HTMLUListElement> {
+    /** Whether list items can be selected.
+     * @default false
+     */
+    selectable?: boolean;
+    /** Selection behavior when selectable is true.
+     * @default 'single'
+     */
+    selectionMode?: 'single' | 'multi';
+    /** Controlled array of selected item values. */
+    selectedItems?: string[];
+    /** Default selected items for uncontrolled usage.
+     * @default []
+     */
+    defaultSelectedItems?: string[];
+    /** Callback invoked when the selection changes. */
+    onSelectionChange?: (selected: string[]) => void;
+}
+
+export declare const Menu: {
+    ({ children, className, ref, ...rest }: MenuProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ icon, shortcut, disabled, onClick, children, className, ref, ...rest }: MenuItemProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Divider: {
+        ({ className, ref, ...rest }: MenuDividerProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+export declare const MenuButton: {
+    ({ appearance, size, icon, menuIcon, expanded, disabled, className, children, ref, ...props }: MenuButtonProps & {
+        ref?: React_2.Ref<HTMLButtonElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the MenuButton component. */
+export declare interface MenuButtonProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Visual style variant.
+     * @default 'outline'
+     */
+    appearance?: Appearance;
+    /** Size affecting padding and font size.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Icon slot rendered before the button label. */
+    icon?: Slot<'span'>;
+    /** Custom icon slot for the menu chevron indicator. */
+    menuIcon?: Slot<'span'>;
+    /** Whether the associated menu is currently expanded. */
+    expanded?: boolean;
+}
+
+/** Properties for the MenuDivider sub-component. */
+export declare type MenuDividerProps = React_2.HTMLAttributes<HTMLDivElement>;
+
+/** Properties for the MenuItem sub-component. */
+export declare interface MenuItemProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Slot for an icon displayed before the item text. */
+    icon?: Slot<'span'>;
+    /** Keyboard shortcut text displayed on the right side. */
+    shortcut?: string;
+    /** Whether the menu item is disabled. */
+    disabled?: boolean;
+    /** Label content of the menu item. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the Menu component. */
+export declare interface MenuProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Menu items and dividers to render. */
+    children: React_2.ReactNode;
+}
+
+export declare const MessageBar: {
+    ({ status, onDismiss, icon, dismiss, children, className, ref, ...rest }: MessageBarProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the MessageBar component. */
+export declare interface MessageBarProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Status level controlling the color and icon of the message bar.
+     * @default 'info'
+     */
+    status?: Status;
+    /** Callback invoked when the dismiss button is clicked. */
+    onDismiss?: () => void;
+    /** Slot for a custom status icon. */
+    icon?: Slot<'span'>;
+    /** Slot for a custom dismiss button. */
+    dismiss?: Slot<'button'>;
+    /** Message content to display. */
+    children: React_2.ReactNode;
+}
+
+export declare const Nav: {
+    ({ selectedValue: controlledValue, defaultSelectedValue, onNavItemSelect, className, children, ref, ...rest }: NavProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Category: {
+        ({ value, icon, className, children, ref, ...rest }: NavCategoryProps & {
+            ref?: React_2.Ref<HTMLLIElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Item: {
+        ({ value, icon, href, className, children, onClick, ref, ...rest }: NavItemProps & {
+            ref?: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    SubItem: {
+        ({ value, href, className, children, onClick, ref, ...rest }: NavSubItemProps & {
+            ref?: React_2.Ref<HTMLButtonElement | HTMLAnchorElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the NavCategory sub-component. */
+export declare interface NavCategoryProps extends React_2.HTMLAttributes<HTMLLIElement> {
+    /** Unique value identifying this category. */
+    value: string;
+    /** Icon displayed before the category label. */
+    icon?: React_2.ReactNode;
+}
+
+/** Properties for the NavItem sub-component. */
+export declare interface NavItemProps extends React_2.HTMLAttributes<HTMLButtonElement> {
+    /** Unique value identifying this nav item. */
+    value: string;
+    /** Icon displayed before the item label. */
+    icon?: React_2.ReactNode;
+    /** URL to navigate to; renders as an anchor instead of a button when provided. */
+    href?: string;
+}
+
+/** Properties for the Nav component. */
+export declare interface NavProps extends React_2.HTMLAttributes<HTMLElement> {
+    /** Controlled value of the currently selected nav item. */
+    selectedValue?: string;
+    /** Default selected nav item value for uncontrolled usage.
+     * @default ''
+     */
+    defaultSelectedValue?: string;
+    /** Callback invoked when a nav item is selected. */
+    onNavItemSelect?: (value: string) => void;
+}
+
+/** Properties for the NavSubItem sub-component. */
+export declare interface NavSubItemProps extends React_2.HTMLAttributes<HTMLButtonElement> {
+    /** Unique value identifying this sub-item. */
+    value: string;
+    /** URL to navigate to; renders as an anchor instead of a button when provided. */
+    href?: string;
+}
+
+declare const Option_2: {
+    ({ value, disabled, className, children, ref, ...rest }: OptionProps & {
+        ref?: React_2.Ref<HTMLLIElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+export { Option_2 as Option }
+
+export declare const OptionGroup: {
+    ({ label, className, children, ref, ...rest }: OptionGroupProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the OptionGroup component used to group options. */
+export declare interface OptionGroupProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Heading label for the option group. */
+    label: string;
+}
+
+/** Properties for the Option component used within Combobox and Dropdown. */
+export declare interface OptionProps extends React_2.LiHTMLAttributes<HTMLLIElement> {
+    /** Value associated with this option. */
+    value: string;
+    /** Whether the option is disabled and non-selectable. */
+    disabled?: boolean;
+}
+
+export declare const Overflow: {
+    ({ overflowButton, children, className, ref, ...rest }: OverflowProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ itemId, children, className, style, ref, ...rest }: OverflowItemProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+export declare const OverflowItem: {
+    ({ itemId, children, className, style, ref, ...rest }: OverflowItemProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the OverflowItem sub-component. */
+export declare interface OverflowItemProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Unique identifier for tracking this item's overflow visibility. */
+    itemId: string;
+    /** Content of the overflow item. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the Overflow component. */
+export declare interface OverflowProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Render function for the overflow button, receiving the count of hidden items. */
+    overflowButton?: (count: number) => React_2.ReactNode;
+    /** Child elements to monitor for overflow. */
+    children: React_2.ReactNode;
+}
+
+export declare const Pagination: {
+    ({ currentPage: controlledPage, defaultCurrentPage, totalPages, onPageChange, siblingCount, boundaryCount, showPreviousNext, showFirstLast, disabled, size, className, ref, ...rest }: PaginationProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element | null;
+    displayName: string;
+};
+
+/** Properties for the Pagination component. */
+export declare interface PaginationProps extends Omit<React_2.HTMLAttributes<HTMLElement>, 'onChange'> {
+    /** Controlled current page number. */
+    currentPage?: number;
+    /** Default current page for uncontrolled usage.
+     * @default 1
+     */
+    defaultCurrentPage?: number;
+    /** Total number of pages. */
+    totalPages: number;
+    /** Callback invoked when the page changes. */
+    onPageChange?: (page: number) => void;
+    /** Number of page buttons to show on each side of the current page.
+     * @default 1
+     */
+    siblingCount?: number;
+    /** Number of page buttons to always show at the start and end.
+     * @default 1
+     */
+    boundaryCount?: number;
+    /** Whether to show previous/next navigation buttons.
+     * @default true
+     */
+    showPreviousNext?: boolean;
+    /** Whether to show first/last page navigation buttons.
+     * @default false
+     */
+    showFirstLast?: boolean;
+    /** Whether the entire pagination control is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Size of the pagination buttons.
+     * @default 'medium'
+     */
+    size?: 'small' | 'medium';
+}
+
+export declare const Persona: {
+    ({ name, secondaryText, src, size, status, avatar, badge, className, ref, ...props }: PersonaProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Persona component. */
+export declare interface PersonaProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Display name of the person. */
+    name: string;
+    /** Secondary text such as job title or email. */
+    secondaryText?: string;
+    /** URL of the person's avatar image. */
+    src?: string;
+    /** Size of the persona avatar.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Presence status shown as a badge on the avatar. */
+    status?: PresenceStatus;
+    /** Slot for a custom avatar element. */
+    avatar?: Slot<'span'>;
+    /** Slot for a custom badge element. */
+    badge?: Slot<'span'>;
+}
+
+export declare const Popover: typeof PopoverRoot & {
+    Trigger: {
+        ({ children, ref, ...rest }: PopoverTriggerProps & {
+            ref?: React_2.Ref<HTMLSpanElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Content: {
+        ({ children, className, ref, ...rest }: PopoverContentProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element | null;
+        displayName: string;
+    };
+};
+
+/** Properties for the PopoverContent sub-component. */
+export declare interface PopoverContentProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Content to render inside the popover. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the Popover component. */
+export declare interface PopoverProps {
+    /** Controlled open state of the popover. */
+    open?: boolean;
+    /** Default open state for uncontrolled usage.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /** Callback invoked when the popover open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Popover trigger and content elements. */
+    children: React_2.ReactNode;
+}
+
+declare function PopoverRoot({ open: openProp, defaultOpen, onOpenChange, children }: PopoverProps): JSX.Element;
+
+declare namespace PopoverRoot {
+    var displayName: string;
+}
+
+/** Properties for the PopoverTrigger sub-component. */
+export declare interface PopoverTriggerProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Trigger element that toggles the popover on click. */
+    children: React_2.ReactNode;
+}
+
+export declare const PresenceBadge: {
+    ({ status, size, className, ref, ...props }: PresenceBadgeProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the PresenceBadge component. */
+export declare interface PresenceBadgeProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Presence status to display. */
+    status: PresenceStatus;
+    /** Size of the presence indicator.
+     * @default 'medium'
+     */
+    size?: Size;
+}
+
+/** User presence status for Avatar and Persona components. */
+export declare type PresenceStatus = 'available' | 'busy' | 'away' | 'offline' | 'dnd' | 'oof';
+
+export declare const ProgressBar: {
+    ({ value, max, label, className, ref, ...rest }: ProgressBarProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the ProgressBar component. */
+export declare interface ProgressBarProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Current progress value. Omit for indeterminate mode. */
+    value?: number;
+    /** Maximum progress value.
+     * @default 100
+     */
+    max?: number;
+    /** Accessible label for the progress bar. */
+    label?: string;
+}
+
+export declare const RadioGroup: {
+    ({ value: controlledValue, defaultValue, onChange, orientation, children, className, "aria-label": ariaLabel, ref, ...rest }: RadioGroupProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the RadioGroup component. */
+export declare interface RadioGroupProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** Controlled selected value. */
+    value?: string;
+    /** Initial selected value for uncontrolled usage.
+     * @default ''
+     */
+    defaultValue?: string;
+    /** Callback fired when the selected value changes. */
+    onChange?: (value: string) => void;
+    /** Layout direction of radio items.
+     * @default 'vertical'
+     */
+    orientation?: 'vertical' | 'horizontal';
+}
+
+export declare function RadioItem({ value, label, disabled, className }: RadioItemProps): JSX.Element;
+
+/** Properties for the RadioItem component. */
+export declare interface RadioItemProps {
+    /** Value associated with this radio option. */
+    value: string;
+    /** Text label displayed next to the radio indicator. */
+    label?: string;
+    /** Whether the radio item is disabled and non-interactive. */
+    disabled?: boolean;
+    /** Additional CSS class name. */
+    className?: string;
+}
+
+export declare const Rating: {
+    ({ value: valueProp, defaultValue, onChange, max, size, disabled, className, ref, ...rest }: RatingProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+export declare const RatingDisplay: {
+    ({ value, max, size, className, ref, ...rest }: RatingDisplayProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the RatingDisplay (read-only) component. */
+export declare interface RatingDisplayProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Rating value to display. */
+    value: number;
+    /** Maximum number of stars.
+     * @default 5
+     */
+    max?: number;
+    /** Size of the star icons.
+     * @default 'medium'
+     */
+    size?: Size;
+}
+
+/** Properties for the Rating component. */
+export declare interface RatingProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled rating value. */
+    value?: number;
+    /** Initial rating for uncontrolled usage.
+     * @default 0
+     */
+    defaultValue?: number;
+    /** Callback fired when the rating changes. */
+    onChange?: (value: number) => void;
+    /** Maximum number of stars.
+     * @default 5
+     */
+    max?: number;
+    /** Size of the star icons.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Whether the rating is disabled and non-interactive.
+     * @default false
+     */
+    disabled?: boolean;
+}
+
+/**
+ * Renders a resolved slot as a React element. Returns `null` if the slot is not defined.
+ *
+ * @param slot           The slot value from component props.
+ * @param defaultAs      The default element type (e.g., 'span', 'div').
+ * @param baseClassName  Optional base class to merge with the slot's className.
+ * @returns A React element, or `null` if the slot is empty.
+ */
+export declare function renderSlot<T extends React_2.ElementType = 'span'>(slot: Slot<T> | undefined | null, defaultAs?: React_2.ElementType, baseClassName?: string): React_2.ReactElement | null;
+
+/** The normalized output of {@link resolveSlot}, ready for rendering. */
+declare interface ResolvedSlot {
+    /** The element type to render (e.g., 'span', 'div', or a component). */
+    Component: React_2.ElementType;
+    /** Merged props including className and any extra HTML attributes. */
+    props: Record<string, unknown>;
+    /** The content to render inside the element. */
+    children: React_2.ReactNode;
+}
+
+/**
+ * Resolves a Slot value into a Component + props + children tuple.
+ *
+ * - If the slot is `null`, `undefined`, or `false`, returns `null`.
+ * - If the slot is a ReactNode (element, string, number), wraps it in `defaultAs`.
+ * - If the slot is an object, extracts `as`, `children`, `className`, and rest props.
+ *
+ * @param slot       The slot value from component props.
+ * @param defaultAs  The default element type (e.g., 'span', 'div'). Defaults to 'span'.
+ * @param baseClassName  Optional base class to merge with the slot's className.
+ */
+export declare function resolveSlot<T extends React_2.ElementType = 'span'>(slot: Slot<T> | undefined | null, defaultAs?: T, baseClassName?: string): ResolvedSlot | null;
+
+export declare const SearchBox: {
+    ({ value: controlledValue, defaultValue, onChange, onClear, placeholder, disabled, contentBefore, contentAfter, dismiss, className, ref, ...rest }: SearchBoxProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the SearchBox component. */
+export declare interface SearchBoxProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** Controlled search text value. */
+    value?: string;
+    /** Initial search text for uncontrolled usage.
+     * @default ''
+     */
+    defaultValue?: string;
+    /** Callback fired when the search text changes. */
+    onChange?: (value: string) => void;
+    /** Callback fired when the search is cleared. */
+    onClear?: () => void;
+    /** Placeholder text shown when the input is empty.
+     * @default 'Search'
+     */
+    placeholder?: string;
+    /** Whether the search box is disabled and non-interactive. */
+    disabled?: boolean;
+    /** Slot rendered before the input (replaces the default search icon). */
+    contentBefore?: Slot<'span'>;
+    /** Slot rendered after the input text. */
+    contentAfter?: Slot<'span'>;
+    /** Slot for the dismiss/clear button (replaces the default clear icon). */
+    dismiss?: Slot<'button'>;
+}
+
+export declare const Select: {
+    ({ error, className, children, ref, ...props }: SelectProps & {
+        ref?: React_2.Ref<HTMLSelectElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Select component. */
+export declare interface SelectProps extends React_2.SelectHTMLAttributes<HTMLSelectElement> {
+    /** Validation error message; sets `aria-invalid` when provided. */
+    error?: string;
+}
+
+/** Setter that accepts either a direct value or a functional updater. */
+declare type SetValue<T> = (valueOrUpdater: T | ((prev: T) => T)) => void;
+
+/** Component size affecting padding, font size, and spacing. */
+export declare type Size = 'extra-small' | 'small' | 'medium' | 'large' | 'extra-large';
+
+export declare const Skeleton: {
+    ({ width, height, variant, className, style, ref, ...rest }: SkeletonProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Skeleton component. */
+export declare interface SkeletonProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Width of the skeleton placeholder. */
+    width?: string | number;
+    /** Height of the skeleton placeholder. */
+    height?: string | number;
+    /** Shape variant of the skeleton.
+     * @default 'text'
+     */
+    variant?: 'text' | 'circular' | 'rectangular';
+}
+
+export declare const Slider: {
+    ({ className, label, ref, ...props }: SliderProps & {
+        ref?: React_2.Ref<HTMLInputElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Slider component. */
+export declare interface SliderProps extends Omit<React_2.InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    /** Controlled slider value. */
+    value?: number;
+    /** Initial value for uncontrolled usage. */
+    defaultValue?: number;
+    /** Callback fired when the slider value changes. */
+    onChange?: React_2.ChangeEventHandler<HTMLInputElement>;
+    /** Minimum allowed value. */
+    min?: number;
+    /** Maximum allowed value. */
+    max?: number;
+    /** Step increment between values. */
+    step?: number;
+    /** Accessible label for the slider (sets `aria-label`). */
+    label?: string;
+}
+
+/**
+ * Slot definition — accepts either a ReactNode shorthand or an object with
+ * `as`, `children`, `className`, `style`, and arbitrary HTML attributes.
+ *
+ * Backward compatible: plain ReactNode is treated as the slot's children.
+ *
+ * @typeParam T - The default element type for the slot.
+ */
+export declare type Slot<T extends React_2.ElementType = 'span'> = Exclude<React_2.ReactNode, object> | React_2.ReactElement | SlotObject<T>;
+
+/**
+ * Object form of a Slot, allowing full control over the rendered element.
+ *
+ * @typeParam T - The default element type for the slot.
+ */
+export declare interface SlotObject<T extends React_2.ElementType = 'span'> {
+    /** Override the rendered element type for this slot. */
+    as?: T;
+    /** Content to render inside the slot element. */
+    children?: React_2.ReactNode;
+    /** CSS class name(s) to apply to the slot element. */
+    className?: string;
+    /** Inline styles to apply to the slot element. */
+    style?: React_2.CSSProperties;
+}
+
+export declare type SortDirection = 'ascending' | 'descending';
+
+export declare const SpinButton: {
+    ({ value: controlledValue, defaultValue, onChange, min, max, step, disabled, className, ref, ...rest }: SpinButtonProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the SpinButton component. */
+export declare interface SpinButtonProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange' | 'defaultValue'> {
+    /** Controlled numeric value. */
+    value?: number;
+    /** Initial value for uncontrolled usage.
+     * @default 0
+     */
+    defaultValue?: number;
+    /** Callback fired when the value changes. */
+    onChange?: (value: number) => void;
+    /** Minimum allowed value.
+     * @default -Infinity
+     */
+    min?: number;
+    /** Maximum allowed value.
+     * @default Infinity
+     */
+    max?: number;
+    /** Step increment for the increment/decrement buttons.
+     * @default 1
+     */
+    step?: number;
+    /** Whether the spin button is disabled and non-interactive. */
+    disabled?: boolean;
+}
+
+export declare const Spinner: {
+    ({ size, label, labelVisible, className, ref, ...rest }: SpinnerProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Spinner component. */
+export declare interface SpinnerProps extends React_2.HTMLAttributes<HTMLSpanElement> {
+    /** Size of the spinner.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Accessible label describing the loading state. */
+    label?: string;
+    /** Whether the label text is visually displayed alongside the spinner. */
+    labelVisible?: boolean;
+}
+
+export declare const SplitButton: {
+    ({ appearance, size, disabled, className, children, onClick, onMenuClick, ref, ...props }: SplitButtonProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the SplitButton component. */
+export declare interface SplitButtonProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onClick'> {
+    /** Whether the split button is disabled. */
+    disabled?: boolean;
+    /** Visual style variant.
+     * @default 'outline'
+     */
+    appearance?: Appearance;
+    /** Size affecting padding and font size.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Click handler for the primary button action. */
+    onClick?: React_2.MouseEventHandler<HTMLButtonElement>;
+    /** Click handler for the secondary menu chevron button. */
+    onMenuClick?: React_2.MouseEventHandler<HTMLButtonElement>;
+}
+
+export declare const Stack: {
+    ({ as: Component, direction, gap, align, justify, wrap, inline, className, children, ref, ...props }: StackProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Stack component. */
+export declare interface StackProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+    /** Layout direction of the stack.
+     * @default 'vertical'
+     */
+    direction?: 'vertical' | 'horizontal';
+    /** Gap size between stack items.
+     * @default 'md'
+     */
+    gap?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /** Cross-axis alignment of items. */
+    align?: 'start' | 'center' | 'end' | 'stretch';
+    /** Main-axis justification of items. */
+    justify?: 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+    /** Whether items should wrap to the next line. */
+    wrap?: boolean;
+    /** Whether to use inline-flex instead of flex. */
+    inline?: boolean;
+}
+
+/** Semantic status used for alerts, messages, and status indicators. */
+export declare type Status = 'success' | 'warning' | 'error' | 'info';
+
+export declare const Stepper: {
+    ({ activeStep: controlledStep, defaultActiveStep, onStepChange, orientation, linear, className, children, ref, ...rest }: StepperProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Step: {
+        ({ label, description, icon, disabled, completed, error, className, onClick, ref, ...rest }: StepProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the Stepper component. */
+export declare interface StepperProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Controlled index of the currently active step. */
+    activeStep?: number;
+    /** Default active step index for uncontrolled usage.
+     * @default 0
+     */
+    defaultActiveStep?: number;
+    /** Callback invoked when the active step changes. */
+    onStepChange?: (step: number) => void;
+    /** Layout orientation of the stepper.
+     * @default 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /** Whether navigation is restricted to sequential steps only.
+     * @default false
+     */
+    linear?: boolean;
+}
+
+/** Properties for the Step sub-component. */
+export declare interface StepProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Label text for the step. */
+    label: string;
+    /** Optional description text displayed below the label. */
+    description?: string;
+    /** Custom icon to display in the step indicator. */
+    icon?: React_2.ReactNode;
+    /** Whether the step is disabled and non-interactive. */
+    disabled?: boolean;
+    /** Whether the step is marked as completed. */
+    completed?: boolean;
+    /** Whether the step is in an error state. */
+    error?: boolean;
+}
+
+/** Represents a single color swatch option. */
+export declare interface SwatchItem {
+    /** Unique identifier for the swatch. */
+    value: string;
+    /** CSS color value (e.g., hex, rgb) used as the swatch background. */
+    color: string;
+    /** Accessible label for the swatch. */
+    label?: string;
+}
+
+export declare const SwatchPicker: {
+    ({ items, value: controlledValue, defaultValue, onChange, size, shape, className, ref, ...rest }: SwatchPickerProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the SwatchPicker component. */
+export declare interface SwatchPickerProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Array of swatch items to display. */
+    items: SwatchItem[];
+    /** Controlled selected swatch value. */
+    value?: string;
+    /** Initial selected value for uncontrolled usage.
+     * @default ''
+     */
+    defaultValue?: string;
+    /** Callback fired when a swatch is selected. */
+    onChange?: (value: string) => void;
+    /** Size of each swatch button.
+     * @default 'medium'
+     */
+    size?: Extract<Size, 'small' | 'medium' | 'large'>;
+    /** Shape of each swatch button.
+     * @default 'circular'
+     */
+    shape?: 'circular' | 'square' | 'rounded';
+}
+
+export declare const Switch: {
+    ({ checked: controlledChecked, defaultChecked, onChange, disabled, label, className, ref, ...rest }: SwitchProps & {
+        ref?: React_2.Ref<HTMLLabelElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Switch component. */
+export declare interface SwitchProps extends Omit<React_2.HTMLAttributes<HTMLLabelElement>, 'onChange' | 'defaultChecked'> {
+    /** Controlled checked (on/off) state. */
+    checked?: boolean;
+    /** Initial checked state for uncontrolled usage.
+     * @default false
+     */
+    defaultChecked?: boolean;
+    /** Callback fired when the switch is toggled. */
+    onChange?: (checked: boolean) => void;
+    /** Whether the switch is disabled and non-interactive. */
+    disabled?: boolean;
+    /** Text label displayed next to the switch. */
+    label?: string;
+}
+
+export declare const Table: {
+    ({ striped, children, className, ref, ...props }: TableProps & {
+        ref?: React_2.Ref<HTMLTableElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Head: {
+        ({ children, className, ref, ...rest }: TableHeadProps & {
+            ref?: React_2.Ref<HTMLTableSectionElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    HeadCell: {
+        ({ children, className, ref, ...props }: TableHeadCellProps & {
+            ref?: React_2.Ref<HTMLTableCellElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Body: {
+        ({ children, className, ref, ...rest }: TableBodyProps & {
+            ref?: React_2.Ref<HTMLTableSectionElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Row: {
+        ({ children, className, ref, ...props }: TableRowProps & {
+            ref?: React_2.Ref<HTMLTableRowElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Cell: {
+        ({ children, className, ref, ...props }: TableCellProps & {
+            ref?: React_2.Ref<HTMLTableCellElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the TableBody sub-component. */
+export declare interface TableBodyProps extends React_2.HTMLAttributes<HTMLTableSectionElement> {
+    /** Table row elements. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the TableCell sub-component. */
+export declare interface TableCellProps extends React_2.TdHTMLAttributes<HTMLTableCellElement> {
+    /** Cell content. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the TableHeadCell sub-component. */
+export declare interface TableHeadCellProps extends React_2.ThHTMLAttributes<HTMLTableCellElement> {
+    /** Header cell content. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the TableHead sub-component. */
+export declare interface TableHeadProps extends React_2.HTMLAttributes<HTMLTableSectionElement> {
+    /** Table header row elements. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the Table component. */
+export declare interface TableProps extends React_2.HTMLAttributes<HTMLTableElement> {
+    /** Whether to apply alternating row background colors.
+     * @default false
+     */
+    striped?: boolean;
+    /** Table head, body, and row elements. */
+    children: React_2.ReactNode;
+}
+
+/** Properties for the TableRow sub-component. */
+export declare interface TableRowProps extends React_2.HTMLAttributes<HTMLTableRowElement> {
+    /** Table cell elements. */
+    children: React_2.ReactNode;
+}
+
+export declare const TabList: {
+    ({ selectedValue: controlledValue, defaultSelectedValue, onTabSelect, vertical, className, children, ref, ...rest }: TabListProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Tab: {
+        ({ value, className, children, ref, ...rest }: TabProps & {
+            ref?: React_2.Ref<HTMLButtonElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+    Panel: {
+        ({ value, children, className, ref, ...rest }: TabPanelProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element | null;
+        displayName: string;
+    };
+};
+
+/** Properties for the TabList component. */
+export declare interface TabListProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Controlled value of the currently selected tab. */
+    selectedValue?: string;
+    /** Default selected tab value for uncontrolled usage.
+     * @default ''
+     */
+    defaultSelectedValue?: string;
+    /** Callback invoked when the selected tab changes. */
+    onTabSelect?: (value: string) => void;
+    /** Whether to arrange tabs vertically instead of horizontally. */
+    vertical?: boolean;
+}
+
+/** Properties for the TabPanel sub-component. */
+export declare interface TabPanelProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Value matching the corresponding Tab to display this panel's content. */
+    value: string;
+}
+
+/** Properties for the Tab sub-component. */
+export declare interface TabProps extends React_2.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Unique value identifying this tab. */
+    value: string;
+}
+
+export declare const Tag: {
+    ({ as: Component, dismissible, onDismiss, dismissIcon, className, children, ref, ...props }: TagProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+export declare const TagPicker: {
+    ({ options, value: valueProp, defaultValue, onChange, placeholder, disabled, className, ref, ...rest }: TagPickerProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Represents a single selectable tag option. */
+export declare interface TagPickerOption {
+    /** Unique identifier for the option. */
+    value: string;
+    /** Display label for the option. */
+    label: string;
+}
+
+/** Properties for the TagPicker component. */
+export declare interface TagPickerProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Available options to choose from. */
+    options: TagPickerOption[];
+    /** Controlled array of selected option values. */
+    value?: string[];
+    /** Initial selected values for uncontrolled usage.
+     * @default []
+     */
+    defaultValue?: string[];
+    /** Callback fired when the selection changes. */
+    onChange?: (value: string[]) => void;
+    /** Placeholder text shown when no tags are selected.
+     * @default 'Select...'
+     */
+    placeholder?: string;
+    /** Whether the tag picker is disabled and non-interactive.
+     * @default false
+     */
+    disabled?: boolean;
+}
+
+/** Properties for the Tag component. */
+export declare interface TagProps extends React_2.HTMLAttributes<HTMLElement> {
+    /** Element type to render as.
+     * @default 'span'
+     */
+    as?: React_2.ElementType;
+    /** Whether the tag can be dismissed by the user. */
+    dismissible?: boolean;
+    /** Callback invoked when the dismiss button is clicked. */
+    onDismiss?: () => void;
+    /** Slot for a custom dismiss icon element. */
+    dismissIcon?: Slot<'span'>;
+}
+
+export declare const TeachingPopover: {
+    ({ steps, currentStep: currentStepProp, defaultCurrentStep, onStepChange, onDismiss, open, className, ref, ...rest }: TeachingPopoverProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element | null;
+    displayName: string;
+};
+
+/** Properties for the TeachingPopover component. */
+export declare interface TeachingPopoverProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Array of steps to display in the teaching popover. */
+    steps: TeachingPopoverStep[];
+    /** Controlled index of the currently displayed step. */
+    currentStep?: number;
+    /** Default step index for uncontrolled usage.
+     * @default 0
+     */
+    defaultCurrentStep?: number;
+    /** Callback invoked when the current step changes. */
+    onStepChange?: (step: number) => void;
+    /** Callback invoked when the popover is dismissed. */
+    onDismiss?: () => void;
+    /** Whether the teaching popover is visible.
+     * @default true
+     */
+    open?: boolean;
+}
+
+/** Defines a single step in a teaching popover sequence. */
+export declare interface TeachingPopoverStep {
+    /** Title text for the step. */
+    title: string;
+    /** Body content for the step. */
+    body: React_2.ReactNode;
+}
+
+declare const Text_2: {
+    ({ variant, weight, as: Component, className, ref, ...props }: TextProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+export { Text_2 as Text }
+
+export declare const Textarea: {
+    ({ error, className, ref, ...props }: TextareaProps & {
+        ref?: React_2.Ref<HTMLTextAreaElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Textarea component. */
+export declare interface TextareaProps extends React_2.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /** Validation error message; sets `aria-invalid` when provided. */
+    error?: string;
+}
+
+/** Properties for the Text component. */
+export declare interface TextProps extends React_2.HTMLAttributes<HTMLElement> {
+    /** Typography variant controlling font size and line height.
+     * @default 'body-1'
+     */
+    variant?: TypographyVariant;
+    /** Font weight override. */
+    weight?: 400 | 600 | 700;
+    /** Element type to render as.
+     * @default 'span'
+     */
+    as?: React_2.ElementType;
+}
+
+export declare const TimePicker: {
+    ({ value: controlledValue, defaultValue, onChange, format, step, minTime, maxTime, placeholder, disabled, clearable, className, ref, ...rest }: TimePickerProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the TimePicker component. */
+export declare interface TimePickerProps extends Omit<React_2.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Controlled selected time in 'HH:mm' format. */
+    value?: string;
+    /** Initial time for uncontrolled usage.
+     * @default ''
+     */
+    defaultValue?: string;
+    /** Callback fired when the selected time changes. */
+    onChange?: (time: string) => void;
+    /** Time display format.
+     * @default '12h'
+     */
+    format?: '12h' | '24h';
+    /** Interval in minutes between available time options.
+     * @default 30
+     */
+    step?: number;
+    /** Earliest selectable time in 'HH:mm' format.
+     * @default '00:00'
+     */
+    minTime?: string;
+    /** Latest selectable time in 'HH:mm' format.
+     * @default '23:59'
+     */
+    maxTime?: string;
+    /** Placeholder text shown when no time is selected.
+     * @default 'Select a time'
+     */
+    placeholder?: string;
+    /** Whether the time picker is disabled and non-interactive.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Whether to show a clear button when a time is selected.
+     * @default false
+     */
+    clearable?: boolean;
+}
+
+export declare const Toast: {
+    ({ status, title, onDismiss, className, children, ref, ...rest }: ToastProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+export declare const Toaster: {
+    ({ position, className, children, ref, ...rest }: ToasterProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+declare interface ToasterContextValue {
+    dispatchToast: (options: ToastOptions) => void;
+    dismissToast: (id: string) => void;
+}
+
+/** Properties for the Toaster container component. */
+export declare interface ToasterProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Screen corner position for the toast container.
+     * @default 'bottom-right'
+     */
+    position?: 'top-right' | 'top-left' | 'bottom-right' | 'bottom-left';
+}
+
+/** Options for dispatching a toast notification. */
+export declare interface ToastOptions {
+    /** Status level controlling the toast color and icon.
+     * @default 'info'
+     */
+    status?: Status;
+    /** Title text of the toast. */
+    title: string;
+    /** Optional body text displayed below the title. */
+    body?: string;
+    /** Auto-dismiss timeout in milliseconds. Set to 0 to disable auto-dismiss.
+     * @default 5000
+     */
+    timeout?: number;
+}
+
+/** Properties for the Toast component. */
+export declare interface ToastProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Status level controlling the toast appearance.
+     * @default 'info'
+     */
+    status?: Status;
+    /** Title text displayed in the toast. */
+    title?: string;
+    /** Callback invoked when the dismiss button is clicked. */
+    onDismiss?: () => void;
+}
+
+export declare const ToggleButton: {
+    ({ pressed, defaultPressed, onPressedChange, appearance, size, icon, disabled, className, children, onClick, ref, ...props }: ToggleButtonProps & {
+        ref?: React_2.Ref<HTMLButtonElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the ToggleButton component. */
+export declare interface ToggleButtonProps extends Omit<React_2.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+    /** Controlled pressed state. */
+    pressed?: boolean;
+    /** Initial pressed state for uncontrolled usage.
+     * @default false
+     */
+    defaultPressed?: boolean;
+    /** Callback fired when the pressed state changes. */
+    onPressedChange?: (pressed: boolean) => void;
+    /** Visual style variant.
+     * @default 'outline'
+     */
+    appearance?: Appearance;
+    /** Size affecting padding and font size.
+     * @default 'medium'
+     */
+    size?: Size;
+    /** Icon slot rendered before the button label. */
+    icon?: Slot<'span'>;
+}
+
+export declare const Toolbar: {
+    ({ as, className, children, ref, ...props }: ToolbarProps & {
+        ref?: React_2.Ref<HTMLElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Properties for the Toolbar component. An `aria-label` is required for accessibility
+ * to describe the toolbar's purpose (e.g., "Formatting options").
+ */
+export declare interface ToolbarProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Custom element type to render as.
+     * @default 'div'
+     */
+    as?: React_2.ElementType;
+}
+
+export declare const Tooltip: {
+    ({ content, variant, delay, children, className, ref, ...rest }: TooltipProps & {
+        ref?: React_2.Ref<HTMLSpanElement>;
+    }): JSX.Element | null;
+    displayName: string;
+};
+
+/** Properties for the Tooltip component. */
+export declare interface TooltipProps extends Omit<React_2.HTMLAttributes<HTMLSpanElement>, 'content'> {
+    /** Content to display inside the tooltip. */
+    content: React_2.ReactNode;
+    /** Visual variant of the tooltip.
+     * @default 'dark'
+     */
+    variant?: 'dark' | 'light';
+    /** Delay in milliseconds before the tooltip appears.
+     * @default 200
+     */
+    delay?: number;
+    /** Target element that triggers the tooltip on hover/focus. */
+    children: React_2.ReactElement;
+}
+
+export declare const Tree: {
+    ({ defaultExpandedItems, className, children, ref, ...rest }: TreeProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+} & {
+    Item: {
+        ({ value, icon, leaf, className, children, ref, ...rest }: TreeItemProps & {
+            ref?: React_2.Ref<HTMLDivElement>;
+        }): JSX.Element;
+        displayName: string;
+    };
+};
+
+/** Properties for the TreeItem sub-component. */
+export declare interface TreeItemProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Unique value identifying this tree item. */
+    value: string;
+    /** Icon displayed before the item label. */
+    icon?: React_2.ReactNode;
+    /** Whether this item is a leaf node with no expandable children.
+     * @default false
+     */
+    leaf?: boolean;
+}
+
+/** Properties for the Tree component. */
+export declare interface TreeProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /** Array of item values that are expanded by default.
+     * @default []
+     */
+    defaultExpandedItems?: string[];
+}
+
+/** Typography scale variant mapping to Fluent UI type ramp tokens. */
+export declare type TypographyVariant = 'caption-2' | 'caption-1' | 'body-1' | 'body-2' | 'subtitle-2' | 'subtitle-1' | 'title-3' | 'title-2' | 'title-1' | 'large-title' | 'display';
+
+/**
+ * Hook for components that can be either controlled or uncontrolled.
+ * If `controlledValue` is provided, the component is controlled; otherwise it uses internal state.
+ * Warns in development if a component switches between controlled and uncontrolled modes.
+ *
+ * @typeParam T - The type of the state value.
+ * @param controlledValue - The externally controlled value, or `undefined` for uncontrolled mode.
+ * @param defaultValue - The initial value used when the component is uncontrolled.
+ * @param onChange - Optional callback invoked when the value changes (in both modes).
+ * @returns A `[value, setValue]` tuple matching the React useState signature.
+ */
+export declare function useControllable<T>(controlledValue: T | undefined, defaultValue: T, onChange?: (value: T) => void): [T, SetValue<T>];
+
+/**
+ * Returns a stable callback reference that always invokes the latest version
+ * of the provided function. Useful for event handlers passed to child
+ * components to avoid unnecessary re-renders.
+ *
+ * The returned function has a stable identity across renders.
+ *
+ * @typeParam T - The callback function signature.
+ * @param fn - The callback to wrap. May be `undefined`, in which case calls are no-ops.
+ * @returns A memoized function with a stable identity that delegates to the latest `fn`.
+ */
+export declare function useEventCallback<T extends (...args: any[]) => any>(fn: T | undefined): T;
+
+/**
+ * Generate a stable unique ID, optionally with a prefix.
+ * Wraps React's useId for consistent usage across components.
+ *
+ * @param prefix - Optional string prepended to the generated ID (e.g., `'button'` produces `'button-:r0:'`).
+ * @returns A unique, SSR-safe identifier string.
+ */
+export declare function useId(prefix?: string): string;
+
+/**
+ * Hook that returns whether the overflow container is currently overflowing.
+ */
+export declare function useIsOverflowing(ref: React_2.RefObject<HTMLElement | null>): boolean;
+
+/**
+ * Implements the WAI-ARIA roving tabindex pattern for composite widgets.
+ *
+ * Items must render `data-roving-value` attributes matching their value strings
+ * so the hook can locate and focus them in the DOM.
+ *
+ * @param containerRef - Ref to the container element holding the focusable items.
+ * @param options - Configuration for orientation, looping, and active value.
+ * @returns An object with `handleKeyDown` (attach to the container) and `getTabIndex` (call per item).
+ */
+export declare function useRovingTabIndex(containerRef: React_2.RefObject<HTMLElement | null>, options: UseRovingTabIndexOptions): {
+    handleKeyDown: (e: React_2.KeyboardEvent) => void;
+    getTabIndex: (value: string) => 0 | -1;
+};
+
+/**
+ * Hook that implements the WAI-ARIA roving tabindex pattern for composite
+ * widgets like RadioGroup, TabList, and Toolbar.
+ *
+ * Only one item in the group has `tabIndex={0}` (the active item); all
+ * others have `tabIndex={-1}`. Arrow keys move focus between items.
+ * Tab enters/leaves the group as a single stop.
+ *
+ * @param containerRef  Ref to the container element holding the items
+ * @param options       Configuration for the roving behavior
+ * @returns getTabIndex – call with an item's value to get its tabIndex
+ */
+/** Configuration options for the {@link useRovingTabIndex} hook. */
+export declare interface UseRovingTabIndexOptions {
+    /** Currently active (selected) value. */
+    activeValue: string;
+    /** All item values in DOM order. */
+    items: string[];
+    /**
+     * Arrow key axis: `'horizontal'` uses Left/Right, `'vertical'` uses Up/Down, `'both'` uses all four.
+     * @default 'horizontal'
+     */
+    orientation?: 'horizontal' | 'vertical' | 'both';
+    /**
+     * Whether arrow keys should wrap around at the ends.
+     * @default true
+     */
+    loop?: boolean;
+    /** Callback fired when focus moves to a new value. */
+    onFocusMove?: (value: string) => void;
+}
+
+export declare function useToastController(): ToasterContextValue;
+
+/**
+ * Hook to read the current Wave theme and direction from context.
+ *
+ * @returns The current {@link WaveTheme} and {@link WaveDir} from the nearest {@link WaveProvider}.
+ */
+export declare function useWaveTheme(): WaveContextValue;
+
+/** Internal context value shape for theme and direction. */
+declare interface WaveContextValue {
+    /** The active theme. */
+    theme: WaveTheme;
+    /** The active text direction. */
+    dir: WaveDir;
+}
+
+/** Text direction for bidirectional layout support. */
+export declare type WaveDir = 'ltr' | 'rtl';
+
+/**
+ * WaveProvider wraps an application (or subtree) to apply Wave UI theming.
+ *
+ * - Sets the appropriate CSS class (`dark`, `high-contrast`, or none for light)
+ *   on a wrapper `<div>` so that CSS custom properties from `tokens.css` take effect.
+ * - Provides theme and dir values via React context for components that need them.
+ */
+export declare const WaveProvider: {
+    ({ theme, dir, children, className, ref, ...rest }: WaveProviderProps & {
+        ref?: React_2.Ref<HTMLDivElement>;
+    }): JSX.Element;
+    displayName: string;
+};
+
+/** Props accepted by {@link WaveProvider}. */
+export declare interface WaveProviderProps extends React_2.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Visual theme applied to the subtree.
+     * @default 'light'
+     */
+    theme?: WaveTheme;
+    /**
+     * Text direction for the subtree.
+     * @default 'ltr'
+     */
+    dir?: WaveDir;
+    /** Content rendered inside the themed container. */
+    children: React_2.ReactNode;
+}
+
+/** Supported visual themes for the Wave design system. */
+export declare type WaveTheme = 'light' | 'dark' | 'high-contrast';
+
+export { }