@tac-ui/web 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,1503 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+import React__default from 'react';
+import { ThemeMode, UseTacThemeReturn } from '@tac-ui/shared';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+import { ClassValue } from 'clsx';
+
+interface TacProviderProps {
+    children: React__default.ReactNode;
+    defaultTheme?: ThemeMode;
+    storageKey?: string;
+}
+declare function TacProvider({ children, defaultTheme, storageKey }: TacProviderProps): react_jsx_runtime.JSX.Element;
+declare function useTacTheme(): UseTacThemeReturn;
+
+declare const buttonVariants: (props?: ({
+    variant?: "primary" | "secondary" | "outline" | "ghost" | "point" | "destructive" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    iconOnly?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Visual style variant of the button. */
+type ButtonVariant = 'primary' | 'secondary' | 'outline' | 'ghost' | 'point' | 'destructive';
+/** Size variant of the button. */
+type ButtonSize = 'sm' | 'md' | 'lg';
+/**
+ * Props for the Button component.
+ * Extends native button attributes and CVA variant props.
+ */
+interface ButtonProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    /** Icon rendered to the left of the button label. */
+    leftIcon?: React__default.ReactNode;
+    /** Icon rendered to the right of the button label. */
+    rightIcon?: React__default.ReactNode;
+}
+declare const Button: React__default.ForwardRefExoticComponent<ButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/** Props for the Input component, a styled text input with optional label, icons, and error state. */
+interface InputProps extends React__default.InputHTMLAttributes<HTMLInputElement> {
+    /** Label text displayed above the input. */
+    label?: string;
+    /** Helper text displayed below the input when there is no error. */
+    helperText?: string;
+    /** When true, applies error styling to the input. */
+    error?: boolean;
+    /** Error message displayed below the input when `error` is true. */
+    errorMessage?: string;
+    /** Icon rendered inside the left side of the input. */
+    leftIcon?: React__default.ReactNode;
+    /** Icon rendered inside the right side of the input. */
+    rightIcon?: React__default.ReactNode;
+    /** Button element rendered flush to the right side of the input. */
+    rightButton?: React__default.ReactNode;
+}
+declare const Input: React__default.ForwardRefExoticComponent<InputProps & React__default.RefAttributes<HTMLInputElement>>;
+
+/** Props for the Textarea component, a styled multi-line text input with optional label and error state. */
+interface TextareaProps extends React__default.TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /** Label text displayed above the textarea. */
+    label?: string;
+    /** Helper text displayed below the textarea when there is no error. */
+    helperText?: string;
+    /** When true, applies error styling to the textarea. */
+    error?: boolean;
+    /** Error message displayed below the textarea when `error` is true. */
+    errorMessage?: string;
+}
+declare const Textarea: React__default.ForwardRefExoticComponent<TextareaProps & React__default.RefAttributes<HTMLTextAreaElement>>;
+
+/** Size variant of the Select component. */
+type SelectSize = 'sm' | 'md' | 'lg';
+/** Represents a single option in the Select dropdown. */
+interface SelectOption {
+    /** The value submitted when this option is selected. */
+    value: string;
+    /** The human-readable label displayed for this option. */
+    label: string;
+    /** When true, this option cannot be selected. */
+    disabled?: boolean;
+}
+/** Props for the Select component, a styled native select with optional label and error state. */
+interface SelectProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Label text displayed above the select. */
+    label?: string;
+    /** Helper text displayed below the select when there is no error. */
+    helperText?: string;
+    /** When true, applies error styling to the select. */
+    error?: boolean;
+    /** Error message displayed below the select when `error` is true. */
+    errorMessage?: string;
+    /** Array of options to render in the dropdown. */
+    options: SelectOption[];
+    /** Placeholder option shown when no value is selected. */
+    placeholder?: string;
+    /** Controls the height and font size of the select element. */
+    selectSize?: SelectSize;
+    /** Currently selected value. */
+    value?: string;
+    /** Called when an option is selected. */
+    onChange?: (value: string) => void;
+    /** When true, the select is disabled. */
+    disabled?: boolean;
+    /** ID attribute for the trigger button. */
+    id?: string;
+}
+declare const Select: React__default.ForwardRefExoticComponent<SelectProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** A single selectable option in the Combobox dropdown. */
+interface ComboboxOption {
+    /** The value submitted when this option is selected. */
+    value: string;
+    /** The human-readable label displayed for this option. */
+    label: string;
+    /** When true, this option cannot be selected. */
+    disabled?: boolean;
+}
+/** Props for the Combobox component, a searchable select input with a filterable dropdown. */
+interface ComboboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value'> {
+    /** Available options to filter and select from. */
+    options: ComboboxOption[];
+    /** Currently selected value. */
+    value?: string;
+    /** Called when an option is selected. */
+    onChange?: (value: string) => void;
+    /** Placeholder text for the search input. */
+    placeholder?: string;
+    /** Text shown when no options match the filter. @default 'No results found' */
+    emptyText?: string;
+}
+/**
+ * Combobox is a searchable select input that filters a list of options as the user types.
+ * Supports keyboard navigation (Arrow keys, Enter, Escape) and outside-click to close.
+ *
+ * @example
+ * <Combobox
+ *   options={[{ value: 'a', label: 'Apple' }, { value: 'b', label: 'Banana' }]}
+ *   value={selected}
+ *   onChange={setSelected}
+ *   placeholder="Search fruit..."
+ * />
+ */
+declare const Combobox: React__default.ForwardRefExoticComponent<ComboboxProps & React__default.RefAttributes<HTMLInputElement>>;
+
+declare const cardVariants: (props?: ({
+    variant?: "flat" | "default" | "accent" | "glass" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Visual style of the Card. */
+type CardVariant = 'default' | 'accent' | 'glass' | 'flat';
+/** Props for the Card container component, which groups related content with a bordered surface. */
+interface CardProps extends React__default.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
+    /** Visual style of the card. @default 'default' */
+    variant?: CardVariant;
+    /** When true, enables hover/active/focus spring interactions. @default false */
+    interactive?: boolean;
+}
+declare const Card: React__default.ForwardRefExoticComponent<CardProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const CardHeader: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+declare const CardTitle: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLHeadingElement> & React__default.RefAttributes<HTMLHeadingElement>>;
+declare const CardDescription: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLParagraphElement> & React__default.RefAttributes<HTMLParagraphElement>>;
+declare const CardContent: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+declare const CardFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Props for the MorphingCard component, which smoothly morphs between a compact preview and an expanded detail view. */
+interface MorphingCardProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Unique ID for layout morphing synchronization. */
+    layoutId: string;
+    /** Whether the card is in expanded state. */
+    expanded?: boolean;
+    /** Callback when expansion state changes. */
+    onExpandedChange?: (expanded: boolean) => void;
+    /** Content shown in compact (collapsed) state. */
+    preview?: React__default.ReactNode;
+    /** Content shown in expanded state. */
+    detail?: React__default.ReactNode;
+}
+declare const MorphingCard: React__default.ForwardRefExoticComponent<MorphingCardProps & React__default.RefAttributes<HTMLDivElement>>;
+
+declare const badgeVariants: (props?: ({
+    variant?: "secondary" | "outline" | "destructive" | "default" | "error" | "glass" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Visual style of the Badge. */
+type BadgeVariant = 'default' | 'secondary' | 'destructive' | 'outline' | 'success' | 'error' | 'warning' | 'info' | 'glass';
+/** Props for the Badge component, which displays a short status label or count. */
+interface BadgeProps extends React__default.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+    /** Visual style of the badge. @example variant="success" */
+    variant?: BadgeVariant;
+    /** When true, applies subtle spring hover/tap interactions. Automatically enabled when onClick is provided. @default false */
+    interactive?: boolean;
+    /** Numeric count value. When provided, changes animate with an exit transition. */
+    count?: number;
+}
+declare const Badge: React__default.ForwardRefExoticComponent<BadgeProps & React__default.RefAttributes<HTMLSpanElement>>;
+
+/** Props for the Checkbox component, a styled checkbox input with optional label and indeterminate state. */
+interface CheckboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    /** Label text displayed next to the checkbox. */
+    label?: string;
+    /** When true, renders the checkbox in an indeterminate (partially checked) state. */
+    indeterminate?: boolean;
+    /** When false, removes the background tint from the label container. @default true */
+    filled?: boolean;
+}
+declare const Checkbox: React__default.ForwardRefExoticComponent<CheckboxProps & React__default.RefAttributes<HTMLInputElement>>;
+
+/** Props for the RadioGroup component, a container that manages selection state for Radio children. */
+interface RadioGroupProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The controlled selected value. */
+    value?: string;
+    /** The initially selected value for uncontrolled usage. */
+    defaultValue?: string;
+    /** Callback fired when the selected radio changes. */
+    onValueChange?: (value: string) => void;
+}
+declare const RadioGroup: React__default.ForwardRefExoticComponent<RadioGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+/** Props for the Radio component, a single radio button that works within a RadioGroup. */
+interface RadioProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange'> {
+    /** Label text displayed next to the radio button. */
+    label?: string;
+    /** The value this radio represents; compared against the RadioGroup's selected value. */
+    radioValue: string;
+}
+declare const Radio: React__default.ForwardRefExoticComponent<RadioProps & React__default.RefAttributes<HTMLInputElement>>;
+
+/** Props for the Switch component, a toggle control that supports controlled and uncontrolled usage. */
+interface SwitchProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+    /** The controlled checked state. */
+    checked?: boolean;
+    /** The initial checked state for uncontrolled usage. */
+    defaultChecked?: boolean;
+    /** Callback fired when the switch is toggled, receives the new checked value. */
+    onChange?: (checked: boolean) => void;
+    /** Label text displayed next to the switch. */
+    label?: string;
+}
+declare const Switch: React__default.ForwardRefExoticComponent<SwitchProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/** Props for the AnimatedToggle component, a button that swaps icons with a rotation animation on toggle. */
+interface AnimatedToggleProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'> {
+    /** The controlled checked state. */
+    checked?: boolean;
+    /** Callback fired when the toggle is clicked, receives the new checked value. */
+    onChange?: (checked: boolean) => void;
+    /** Icon rendered when `checked` is true. */
+    iconOn?: React__default.ReactNode;
+    /** Icon rendered when `checked` is false. */
+    iconOff?: React__default.ReactNode;
+}
+declare const AnimatedToggle: React__default.ForwardRefExoticComponent<AnimatedToggleProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/** Visual style variant for the Tabs component. */
+type TabVariant = 'underline' | 'pill' | 'outline' | 'icon';
+/**
+ * Root tabs container that manages active tab state.
+ * @example <Tabs defaultValue="tab1" variant="underline">...</Tabs>
+ */
+interface TabsProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The controlled active tab value. */
+    value?: string;
+    /** The tab value open by default in uncontrolled mode. */
+    defaultValue?: string;
+    /** Called when the active tab changes. */
+    onValueChange?: (value: string) => void;
+    /** Visual style of the tab list. @default 'underline' */
+    variant?: TabVariant;
+}
+declare const Tabs: React__default.ForwardRefExoticComponent<TabsProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const TabsList: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/** Props for an individual tab trigger button. */
+interface TabTriggerProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** The value this trigger activates; must match a TabContent value. */
+    value: string;
+    /** Icon element to display (only used with icon variant). */
+    icon?: React__default.ReactNode;
+}
+declare const TabTrigger: React__default.ForwardRefExoticComponent<TabTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+/** Props for a tab panel that renders when its value is active. */
+interface TabContentProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The value that activates this content panel; must match a TabTrigger value. */
+    value: string;
+}
+declare const TabContent: React__default.ForwardRefExoticComponent<TabContentProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** HTML event handlers that conflict with Framer Motion's prop types. */
+type MotionConflictingHandlers = 'onDrag' | 'onDragEnd' | 'onDragStart' | 'onDragOver' | 'onDragEnter' | 'onDragLeave' | 'onAnimationStart' | 'onAnimationEnd';
+
+/**
+ * Modal dialog with a fixed-width layout, backdrop, and keyboard (Escape) dismissal.
+ * Traps focus within the dialog while open and restores focus on close.
+ * @example <Dialog open={open} onClose={() => setOpen(false)}>...</Dialog>
+ */
+interface DialogProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, MotionConflictingHandlers> {
+    /** Whether the dialog is visible. */
+    open: boolean;
+    /** Callback fired when the dialog should close (backdrop click or Escape key). */
+    onClose: () => void;
+    /** Optional layoutId for shared layout morphing via Framer Motion. */
+    layoutId?: string;
+    /** When false, the dark backdrop overlay is hidden. @default true */
+    backdrop?: boolean;
+}
+declare const Dialog: React__default.ForwardRefExoticComponent<DialogProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DialogTitle: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLHeadingElement> & React__default.RefAttributes<HTMLHeadingElement>>;
+declare const DialogDescription: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLParagraphElement> & React__default.RefAttributes<HTMLParagraphElement>>;
+declare const DialogHeader: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+declare const DialogFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Controls the maximum width of the Modal panel. */
+type ModalSize = 'sm' | 'md' | 'lg' | 'xl';
+/**
+ * Responsive modal dialog with configurable size, backdrop, and keyboard (Escape) dismissal.
+ * Traps focus within the modal while open and restores focus on close.
+ * @example <Modal open={open} onClose={() => setOpen(false)} size="lg">...</Modal>
+ */
+interface ModalProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, MotionConflictingHandlers> {
+    /** Whether the modal is visible. */
+    open: boolean;
+    /** Callback fired when the modal should close (backdrop click or Escape key). */
+    onClose: () => void;
+    /** Maximum width preset of the modal panel. @default 'md' */
+    size?: ModalSize;
+    /** Optional layoutId for shared layout morphing via Framer Motion. */
+    layoutId?: string;
+    /** When false, the dark backdrop overlay is hidden. @default true */
+    backdrop?: boolean;
+}
+declare const Modal: React__default.ForwardRefExoticComponent<ModalProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const ModalHeader: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+declare const ModalIcon: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+declare const ModalTitle: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLHeadingElement> & React__default.RefAttributes<HTMLHeadingElement>>;
+declare const ModalDescription: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLParagraphElement> & React__default.RefAttributes<HTMLParagraphElement>>;
+declare const ModalFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+declare const alertVariants: (props?: ({
+    variant?: "default" | "error" | "glass" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Color and semantic variant for the Alert component. */
+type AlertVariant = 'default' | 'success' | 'error' | 'warning' | 'info' | 'glass';
+/**
+ * Inline alert banner for displaying status messages with optional icon and dismiss button.
+ * Features a left accent stripe for visual emphasis.
+ * @example <Alert variant="success" icon={<CheckIcon />}>Saved successfully.</Alert>
+ */
+interface AlertProps extends React__default.HTMLAttributes<HTMLDivElement>, VariantProps<typeof alertVariants> {
+    /** Optional icon displayed to the left of the alert content. */
+    icon?: React__default.ReactNode;
+    /** When true, shows a close button to dismiss the alert. */
+    dismissible?: boolean;
+    /** Called when the dismiss button is clicked. */
+    onDismiss?: () => void;
+}
+declare const Alert: React__default.ForwardRefExoticComponent<AlertProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const AlertTitle: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLHeadingElement> & React__default.RefAttributes<HTMLHeadingElement>>;
+declare const AlertDescription: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLParagraphElement> & React__default.RefAttributes<HTMLParagraphElement>>;
+
+/** Controls whether one or multiple accordion items can be open simultaneously. */
+type AccordionType = 'single' | 'multiple';
+/**
+ * Collapsible accordion container that manages open/close state for its items.
+ * @example <Accordion type="single" defaultValue="item-1">...</Accordion>
+ */
+interface AccordionProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Whether only one item can be open at a time or multiple. */
+    type?: AccordionType;
+    /** The value(s) of the item(s) open by default. */
+    defaultValue?: string | string[];
+    /** Applies glassmorphism styling to each accordion item. */
+    glass?: boolean;
+    /** When true, shows borders around each accordion item. @default true */
+    outline?: boolean;
+}
+declare const Accordion: React__default.ForwardRefExoticComponent<AccordionProps & React__default.RefAttributes<HTMLDivElement>>;
+/** Props for a single accordion section wrapper. */
+interface AccordionItemProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Unique identifier for this accordion item; used to control open state. */
+    value: string;
+}
+declare const AccordionItem: React__default.ForwardRefExoticComponent<AccordionItemProps & React__default.RefAttributes<HTMLDivElement>>;
+/** Props for the button that toggles an accordion item open or closed. */
+interface AccordionTriggerProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** The accordion item value this trigger controls. */
+    value: string;
+}
+declare const AccordionTrigger: React__default.ForwardRefExoticComponent<AccordionTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+/** Props for the collapsible content panel of an accordion item. */
+interface AccordionContentProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The accordion item value that controls visibility of this content. */
+    value: string;
+}
+declare const AccordionContent: React__default.ForwardRefExoticComponent<AccordionContentProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Props for the Breadcrumb root nav element. */
+type BreadcrumbProps = React__default.HTMLAttributes<HTMLElement>;
+declare const Breadcrumb: React__default.ForwardRefExoticComponent<BreadcrumbProps & React__default.RefAttributes<HTMLElement>>;
+declare const BreadcrumbList: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLOListElement> & React__default.RefAttributes<HTMLOListElement>>;
+/** Props for an individual breadcrumb list item. */
+interface BreadcrumbItemProps extends React__default.LiHTMLAttributes<HTMLLIElement> {
+    /** Marks this item as the current page, applying active styles and aria-current="page". */
+    current?: boolean;
+}
+declare const BreadcrumbItem: React__default.ForwardRefExoticComponent<BreadcrumbItemProps & React__default.RefAttributes<HTMLLIElement>>;
+/** Props for a breadcrumb anchor link. */
+type BreadcrumbLinkProps = React__default.AnchorHTMLAttributes<HTMLAnchorElement>;
+declare const BreadcrumbLink: React__default.ForwardRefExoticComponent<BreadcrumbLinkProps & React__default.RefAttributes<HTMLAnchorElement>>;
+declare const BreadcrumbSeparator: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLSpanElement> & React__default.RefAttributes<HTMLSpanElement>>;
+declare const BreadcrumbEllipsis: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLSpanElement> & React__default.RefAttributes<HTMLSpanElement>>;
+
+/** Horizontal alignment of the dropdown menu relative to its trigger. */
+type DropdownAlign = 'start' | 'center' | 'end';
+/**
+ * Dropdown menu that displays a floating list of actions on trigger click.
+ * Supports keyboard navigation (Arrow keys, Home, End, Enter, Escape).
+ * @example <Dropdown trigger={<Button>Open</Button>} align="end">...</Dropdown>
+ */
+interface DropdownProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The element that toggles the dropdown open/closed when clicked. */
+    trigger: React__default.ReactNode;
+    /** Controlled open state; omit to use uncontrolled mode. */
+    open?: boolean;
+    /** Called when the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Horizontal alignment of the menu relative to the trigger. @default 'start' */
+    align?: DropdownAlign;
+}
+declare const Dropdown: React__default.ForwardRefExoticComponent<DropdownProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownTitle: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownDivider: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/** Props for a single clickable item inside a Dropdown menu. */
+interface DropdownItemProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Renders the item in destructive (error) colors to signal a dangerous action. */
+    destructive?: boolean;
+}
+declare const DropdownItem: React__default.ForwardRefExoticComponent<DropdownItemProps & React__default.RefAttributes<HTMLButtonElement>>;
+/** Props for a search input rendered at the top of a Dropdown menu. */
+type DropdownSearchProps = React__default.InputHTMLAttributes<HTMLInputElement>;
+declare const DropdownSearch: React__default.ForwardRefExoticComponent<DropdownSearchProps & React__default.RefAttributes<HTMLInputElement>>;
+
+/** Props for the Pagination root nav element. */
+interface PaginationProps extends React__default.HTMLAttributes<HTMLElement> {
+    /** Accessible label for the pagination nav element. @default 'Pagination' */
+    label?: string;
+}
+declare const Pagination: React__default.ForwardRefExoticComponent<PaginationProps & React__default.RefAttributes<HTMLElement>>;
+/** Props for the Pagination content list. */
+interface PaginationContentProps extends React__default.HTMLAttributes<HTMLUListElement> {
+    /** Applies glassmorphism styling to the pagination container. */
+    glass?: boolean;
+}
+declare const PaginationContent: React__default.ForwardRefExoticComponent<PaginationContentProps & React__default.RefAttributes<HTMLUListElement>>;
+/** Props for an individual page number button in the pagination list. */
+interface PaginationItemProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Highlights this item as the currently active page. */
+    active?: boolean;
+}
+declare const PaginationItem: React__default.ForwardRefExoticComponent<PaginationItemProps & React__default.RefAttributes<HTMLButtonElement>>;
+declare const PaginationEllipsis: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLSpanElement> & React__default.RefAttributes<HTMLSpanElement>>;
+/** Props for the Previous and Next navigation buttons in a pagination component. */
+type PaginationPrevNextProps = React__default.ButtonHTMLAttributes<HTMLButtonElement>;
+declare const PaginationPrevious: React__default.ForwardRefExoticComponent<PaginationPrevNextProps & React__default.RefAttributes<HTMLButtonElement>>;
+declare const PaginationNext: React__default.ForwardRefExoticComponent<PaginationPrevNextProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/** Responsive table wrapper with horizontal scroll overflow. */
+declare const Table: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLTableElement> & React__default.RefAttributes<HTMLTableElement>>;
+/** Renders the `<thead>` section with subtle glass background and bottom border on rows. */
+declare const TableHeader: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLTableSectionElement> & React__default.RefAttributes<HTMLTableSectionElement>>;
+/** Renders the `<tbody>` section, removing the border from the last row. */
+declare const TableBody: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLTableSectionElement> & React__default.RefAttributes<HTMLTableSectionElement>>;
+/** Renders the `<tfoot>` section with a top border and secondary background. */
+declare const TableFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLTableSectionElement> & React__default.RefAttributes<HTMLTableSectionElement>>;
+/** Renders a `<tr>` with glass hover highlight and selected state styling. */
+declare const TableRow: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLTableRowElement> & React__default.RefAttributes<HTMLTableRowElement>>;
+/** Renders a `<th>` header cell with muted foreground text and medium font weight. */
+declare const TableHead: React__default.ForwardRefExoticComponent<React__default.ThHTMLAttributes<HTMLTableCellElement> & React__default.RefAttributes<HTMLTableCellElement>>;
+/** Renders a `<td>` data cell with standard padding and middle alignment. */
+declare const TableCell: React__default.ForwardRefExoticComponent<React__default.TdHTMLAttributes<HTMLTableCellElement> & React__default.RefAttributes<HTMLTableCellElement>>;
+/** Renders a `<caption>` with muted foreground text positioned below the table. */
+declare const TableCaption: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLTableCaptionElement> & React__default.RefAttributes<HTMLTableCaptionElement>>;
+
+declare const snackbarVariants: (props?: ({
+    variant?: "default" | "error" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Color and semantic variant for the Snackbar component. */
+type SnackbarVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
+/**
+ * Fixed-position toast notification that auto-dismisses after a configurable duration.
+ * @example <Snackbar open={open} onClose={handleClose} variant="success">Item saved.</Snackbar>
+ */
+interface SnackbarProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, MotionConflictingHandlers>, VariantProps<typeof snackbarVariants> {
+    /** Whether the snackbar is visible. */
+    open: boolean;
+    /** Callback fired when the snackbar closes (auto-hide or close button). */
+    onClose?: () => void;
+    /** Milliseconds before the snackbar auto-closes; set to 0 to disable. @default 5000 */
+    autoHideDuration?: number;
+    /** Optional icon shown on the left (only visible in the default variant). */
+    icon?: React__default.ReactNode;
+    /** Optional action button rendered to the right of the message. */
+    action?: React__default.ReactNode;
+    /** Accessible label for the close button. @default 'Close' */
+    closeLabel?: string;
+    /** Callback fired when the action button is clicked. */
+    onAction?: () => void;
+}
+declare const Snackbar: React__default.ForwardRefExoticComponent<SnackbarProps & React__default.RefAttributes<HTMLDivElement>>;
+
+declare const avatarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Size of the Avatar. */
+type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
+/** Props for the Avatar component, which displays a user image, initials, or icon in a circular frame. */
+interface AvatarProps extends React__default.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof avatarVariants> {
+    /** Size of the avatar. @example size="lg" */
+    size?: AvatarSize;
+    /** URL of the image to display. Falls back to `initials` or `icon` on error. */
+    src?: string;
+    /** Accessible alt text for the image. */
+    alt?: string;
+    /** Text initials shown when no image is available. @example initials="JD" */
+    initials?: string;
+    /** Icon node shown when no image or initials are available. */
+    icon?: React__default.ReactNode;
+    /** When true, renders a green online status dot in the bottom-right corner. */
+    showStatus?: boolean;
+    /** Custom content inside status badge (icon or image). */
+    statusContent?: React__default.ReactNode;
+    /** Custom background color for status badge. @default 'var(--success)' */
+    statusColor?: string;
+    /** When true, enables hover animation. @default true */
+    animated?: boolean;
+}
+declare const Avatar: React__default.ForwardRefExoticComponent<AvatarProps & React__default.RefAttributes<HTMLSpanElement>>;
+
+declare const chipVariants: (props?: ({
+    variant?: "filter" | "input" | "glass" | "assist" | "suggestion" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Visual/behavioral style of the Chip. */
+type ChipVariant = 'filter' | 'assist' | 'suggestion' | 'input' | 'glass';
+/** Props for the Chip component, which represents a compact interactive element such as a filter tag or suggestion. */
+interface ChipProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof chipVariants> {
+    /** Visual style of the chip. @example variant="filter" */
+    variant?: ChipVariant;
+    /** Icon rendered to the left of the chip label. */
+    leftIcon?: React__default.ReactNode;
+    /** Callback fired when the delete (×) button is clicked. Renders the delete button when provided. */
+    onDelete?: () => void;
+}
+declare const Chip: React__default.ForwardRefExoticComponent<ChipProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/** Props for the Slider component, a styled range input with optional label and current value display. */
+interface SliderProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'type'> {
+    /** Label text displayed above the slider. */
+    label?: string;
+    /** When true, displays the current value next to the label. */
+    showValue?: boolean;
+    /** When true, the track is filled up to the current value. @default true */
+    filled?: boolean;
+}
+declare const Slider: React__default.ForwardRefExoticComponent<SliderProps & React__default.RefAttributes<HTMLInputElement>>;
+
+/** Display style of the Progress indicator. */
+type ProgressVariant = 'linear' | 'circular';
+/** Size of the linear progress bar. */
+type ProgressBarSize = 'sm' | 'md' | 'lg';
+/** Props for the Progress component, which visualizes a determinate completion value. */
+interface ProgressProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Current progress value. Defaults to 0. @example value={42} */
+    value?: number;
+    /** Maximum value used to calculate the percentage. Defaults to 100. */
+    max?: number;
+    /** Display style — horizontal bar or circular ring. @example variant="circular" */
+    variant?: ProgressVariant;
+    /** Diameter in pixels for the circular variant. Defaults to 64. */
+    size?: number;
+    /** Size of the linear progress bar. Defaults to 'md'. @example barSize="lg" */
+    barSize?: ProgressBarSize;
+    /** When true, renders a percentage label alongside the progress indicator. */
+    showLabel?: boolean;
+}
+declare const Progress: React__default.ForwardRefExoticComponent<ProgressProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Position of the tooltip relative to its trigger element. */
+type TooltipPlacement = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Floating tooltip that appears on hover or focus after an optional delay.
+ * @example <Tooltip content="Save file" placement="bottom"><Button>Save</Button></Tooltip>
+ */
+interface TooltipProps {
+    /** The trigger element that the tooltip is anchored to. */
+    children: React__default.ReactElement;
+    /** Primary tooltip text or node content. */
+    content: React__default.ReactNode;
+    /** Optional secondary description shown below the title in rich tooltip mode. */
+    description?: string;
+    /** Position of the tooltip relative to the trigger. @default 'top' */
+    placement?: TooltipPlacement;
+    /** Delay in milliseconds before the tooltip appears. @default 200 */
+    delay?: number;
+}
+declare const Tooltip: React__default.ForwardRefExoticComponent<TooltipProps & React__default.RefAttributes<HTMLDivElement>>;
+
+declare const dividerVariants: (props?: ({
+    variant?: "inset" | "thick" | "full" | "withLabel" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/** Visual style of the divider. */
+type DividerVariant = 'full' | 'inset' | 'thick' | 'withLabel';
+/**
+ * Horizontal rule component that separates content sections.
+ * Supports full-width, inset, thick, labeled, and gradient variants.
+ */
+interface DividerProps extends React__default.HTMLAttributes<HTMLDivElement>, VariantProps<typeof dividerVariants> {
+    /** Visual style variant of the divider. @example variant="gradient" */
+    variant?: DividerVariant;
+    /** Text label rendered in the center of the divider (implies withLabel style). @example label="OR" */
+    label?: string;
+}
+declare const Divider: React__default.ForwardRefExoticComponent<DividerProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Displays a syntax-highlighted code block with a copy-to-clipboard button.
+ */
+interface CodeBlockProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The source code string to display. @example code="const x = 1;" */
+    code: string;
+    /** Language label shown in the header bar. @example language="typescript" */
+    language?: string;
+    /** When true, applies glassmorphism styling with backdrop blur. @default false */
+    glass?: boolean;
+}
+declare const CodeBlock: React__default.ForwardRefExoticComponent<CodeBlockProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Shape style of the Skeleton placeholder. */
+type SkeletonVariant = 'rectangular' | 'circular' | 'text';
+/** Animation style of the Skeleton placeholder. */
+type SkeletonAnimation = 'shimmer' | 'pulse';
+/** Props for the Skeleton component, which shows a loading placeholder in place of content. */
+interface SkeletonProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Width of the skeleton. Accepts CSS string or pixel number. @example width="80%" */
+    width?: string | number;
+    /** Height of the skeleton. Accepts CSS string or pixel number. @example height={20} */
+    height?: string | number;
+    /** Shape of the skeleton. `'text'` renders multiple stacked lines. @example variant="circular" */
+    variant?: SkeletonVariant;
+    /** Animation style. `'shimmer'` sweeps a highlight across, `'pulse'` fades opacity. @default 'shimmer' */
+    animation?: SkeletonAnimation;
+    /** Number of lines rendered when `variant` is `'text'`. Defaults to 3. */
+    lines?: number;
+}
+declare const Skeleton: React__default.ForwardRefExoticComponent<SkeletonProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Display style of the Indicator. */
+type IndicatorVariant = 'linear' | 'circular';
+/** Props for the Indicator component, which shows an indeterminate loading animation. */
+interface IndicatorProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Display style — horizontal bar or spinning circle. @example variant="circular" */
+    variant?: IndicatorVariant;
+    /** Diameter in pixels used for the circular variant. Defaults to 32. */
+    size?: number;
+    /** CSS color value for the animated portion. Defaults to `var(--primary)`. */
+    color?: string;
+}
+declare const Indicator: React__default.ForwardRefExoticComponent<IndicatorProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Gap size between stack children. */
+type Spacing = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+/** Cross-axis alignment of stack children. */
+type StackAlign = 'start' | 'center' | 'end' | 'stretch' | 'baseline';
+/** Main-axis justification of stack children. */
+type StackJustify = 'start' | 'center' | 'end' | 'between' | 'around' | 'evenly';
+/**
+ * Shared props for VStack and HStack flex container components.
+ */
+interface StackProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Gap between children using the design-token spacing scale. @example gap="md" */
+    gap?: Spacing;
+    /** Cross-axis alignment of children. @example align="center" */
+    align?: StackAlign;
+    /** Main-axis justification of children. @example justify="between" */
+    justify?: StackJustify;
+    /** Whether children should wrap onto multiple lines. @example wrap */
+    wrap?: boolean;
+}
+declare const VStack: React__default.ForwardRefExoticComponent<StackProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const HStack: React__default.ForwardRefExoticComponent<StackProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Returns the current sidebar collapsed state. Use inside Sidebar children. */
+declare const useSidebarContext: () => {
+    collapsed: boolean;
+};
+declare const containerVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | "full" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const mainVariants: (props?: ({
+    maxWidth?: "sm" | "md" | "lg" | "xl" | "full" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const headerVariants: (props?: ({
+    sticky?: boolean | null | undefined;
+    bordered?: boolean | null | undefined;
+    blur?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const sidebarVariants: (props?: ({
+    position?: "left" | "right" | null | undefined;
+    fillHeight?: boolean | null | undefined;
+    rounded?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const footerVariants: (props?: ({
+    bordered?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * Centered content wrapper with responsive horizontal padding and configurable max-width.
+ * @prop size - Maximum width of the container. @example size="lg"
+ */
+interface ContainerProps extends React__default.HTMLAttributes<HTMLDivElement>, VariantProps<typeof containerVariants> {
+}
+declare const Container: React__default.ForwardRefExoticComponent<ContainerProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Top-level page header bar with optional sticky positioning, bottom border, backdrop blur, and auto-hide on scroll.
+ * @prop sticky - Whether the header sticks to the top of the viewport on scroll.
+ * @prop bordered - Whether to render a bottom border.
+ * @prop blur - Whether to apply a backdrop blur effect with semi-transparent background.
+ * @prop autoHide - Whether the header hides when scrolling down and reappears when scrolling up. Works best with sticky.
+ */
+interface HeaderProps extends React__default.HTMLAttributes<HTMLElement>, VariantProps<typeof headerVariants> {
+    /** Whether the header auto-hides on scroll down and reappears on scroll up. Works best with sticky. @default false */
+    autoHide?: boolean;
+}
+declare const Header: React__default.ForwardRefExoticComponent<HeaderProps & React__default.RefAttributes<HTMLElement>>;
+/**
+ * Collapsible side panel that can be positioned on the left or right of the layout.
+ */
+interface SidebarProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Width of the sidebar in pixels when expanded. @example width={280} */
+    width?: number;
+    /** Label displayed in the sidebar header. @example label="Navigation" */
+    label?: React__default.ReactNode;
+    /** Icon displayed before the label in the sidebar header. @example icon={<Menu size={18} />} */
+    icon?: React__default.ReactNode;
+    /** Whether a toggle button is rendered to collapse/expand the sidebar. @example collapsible */
+    collapsible?: boolean;
+    /** Controlled collapsed state of the sidebar. @example collapsed={true} */
+    collapsed?: boolean;
+    /** Callback fired when the collapse toggle is clicked. @example onCollapse={(v) => setCollapsed(v)} */
+    onCollapse?: (collapsed: boolean) => void;
+    /** Which side of the layout the sidebar appears on. @example position="right" */
+    position?: 'left' | 'right';
+    /** Whether the sidebar fills the remaining vertical space. @default true */
+    fillHeight?: boolean;
+    /** Whether the sidebar has rounded corners with a floating card style. @default false */
+    rounded?: boolean;
+    /** When true, the icon is hidden when expanded and the label is hidden when collapsed, swapping between them. @default false */
+    swapOnCollapse?: boolean;
+    /** Content rendered in a fixed footer area at the bottom of the sidebar. */
+    footer?: React__default.ReactNode;
+}
+declare const Sidebar: React__default.ForwardRefExoticComponent<SidebarProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar group with an optional label. Label is hidden when the sidebar is collapsed.
+ */
+interface SidebarGroupProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Group label displayed above items. Hidden when collapsed. */
+    label?: string;
+    /** Icon displayed before the label. Shown alone when collapsed. */
+    icon?: React__default.ReactNode;
+    /** Whether a child item in this group is currently active/selected. */
+    active?: boolean;
+    /** What to show when the sidebar is collapsed. "group" shows the group icon only, "children" shows child items only. @default "children" */
+    collapseDisplay?: 'group' | 'children';
+    /** Whether the group can be expanded/collapsed by clicking the header. @default false */
+    collapsible?: boolean;
+    /** Whether the group is open by default when collapsible. @default true */
+    defaultOpen?: boolean;
+}
+declare const SidebarGroup: React__default.ForwardRefExoticComponent<SidebarGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar navigation item with an optional icon.
+ * When collapsed, only the icon is shown. If no icon, the item is hidden.
+ */
+/** Active style variant for sidebar items. */
+type SidebarItemVariant = 'filled' | 'foreground';
+interface SidebarItemProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Icon rendered before the label. Shown alone when sidebar is collapsed. */
+    icon?: React__default.ReactNode;
+    /** Whether this item is currently active/selected. */
+    active?: boolean;
+    /** Active style variant. @default "filled" */
+    variant?: SidebarItemVariant;
+}
+declare const SidebarItem: React__default.ForwardRefExoticComponent<SidebarItemProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Arbitrary sidebar content. Fully hidden when the sidebar is collapsed.
+ */
+declare const SidebarContent: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Footer area pinned to the bottom of the sidebar. Content is hidden when collapsed.
+ */
+declare const SidebarFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Primary content area that grows to fill available space with optional max-width constraint.
+ * @prop maxWidth - Maximum width of the main content area. @example maxWidth="xl"
+ */
+interface MainProps extends React__default.HTMLAttributes<HTMLElement>, VariantProps<typeof mainVariants> {
+}
+declare const Main: React__default.ForwardRefExoticComponent<MainProps & React__default.RefAttributes<HTMLElement>>;
+/**
+ * Page footer bar with optional top border.
+ * @prop bordered - Whether to render a top border separating the footer from the content.
+ */
+interface FooterProps extends React__default.HTMLAttributes<HTMLElement>, VariantProps<typeof footerVariants> {
+}
+declare const Footer: React__default.ForwardRefExoticComponent<FooterProps & React__default.RefAttributes<HTMLElement>>;
+/** Position of the floating menu bar on screen (3x3 grid). */
+type FloatingMenuBarPosition = 'top-left' | 'top-center' | 'top-right' | 'middle-left' | 'middle-center' | 'middle-right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+/**
+ * A floating navigation bar that hovers over page content with a pill-shaped appearance.
+ * Commonly used as a bottom tab bar in mobile/app-like layouts.
+ * @prop position - Where the bar is anchored (9 positions). @default 'bottom-center'
+ * @prop bordered - Whether to render a border. @default true
+ * @prop blur - Whether to apply a backdrop blur effect. @default true
+ */
+interface FloatingMenuBarProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Where the bar is anchored on the screen (3x3 grid). @default 'bottom-center' */
+    position?: FloatingMenuBarPosition;
+    /** Whether to render a border. @default true */
+    bordered?: boolean;
+    /** Whether to apply a backdrop blur effect. @default true */
+    blur?: boolean;
+}
+declare const FloatingMenuBar: React__default.ForwardRefExoticComponent<FloatingMenuBarProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * An individual item inside a FloatingMenuBar.
+ * Renders an icon with an optional label underneath.
+ * @prop icon - The icon to display.
+ * @prop label - Optional text label below the icon.
+ * @prop active - Whether this item is the currently active route.
+ */
+interface FloatingMenuItemProps extends React__default.ButtonHTMLAttributes<HTMLButtonElement> {
+    /** The icon to display. */
+    icon: React__default.ReactNode;
+    /** Optional text label below the icon. */
+    label?: string;
+    /** Whether this item is the currently active route. @default false */
+    active?: boolean;
+}
+declare const FloatingMenuItem: React__default.ForwardRefExoticComponent<FloatingMenuItemProps & React__default.RefAttributes<HTMLButtonElement>>;
+/**
+ * Full-page layout shell combining a header, optional sidebar, main content area, and footer.
+ */
+interface PageLayoutProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Whether to render a sidebar alongside the main content. @example sidebar */
+    sidebar?: boolean;
+    /** Which side the sidebar appears on. @example sidebarPosition="right" */
+    sidebarPosition?: 'left' | 'right';
+    /** Content rendered in the sticky header slot. @example header={<Header />} */
+    header?: React__default.ReactNode;
+    /** Content rendered in the footer slot. @example footer={<Footer />} */
+    footer?: React__default.ReactNode;
+}
+declare const PageLayout: React__default.ForwardRefExoticComponent<PageLayoutProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Maximum content width for single-column layouts. */
+type MaxWidth = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+/** Side the sidebar is placed on. */
+type SidebarPosition = 'left' | 'right';
+/** Number of grid columns for GridPage. */
+type GridColumns = 2 | 3 | 4;
+/** Width ratio between the primary and secondary panes in AsymmetricPage. */
+type AsymmetricRatio = '2:1' | '3:1' | '1:2' | '1:3';
+interface BaseLayoutProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Content rendered in the top header slot. */
+    header?: React__default.ReactNode;
+    /** Content rendered in the bottom footer slot. */
+    footer?: React__default.ReactNode;
+}
+/**
+ * Single centered content column with configurable max-width and optional header/footer.
+ */
+interface SingleColumnPageProps extends BaseLayoutProps {
+    /** Maximum width of the content column. @example maxWidth="lg" */
+    maxWidth?: MaxWidth;
+}
+declare const SingleColumnPage: React__default.ForwardRefExoticComponent<SingleColumnPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Page layout with a fixed-width sidebar and a scrollable main content area.
+ */
+interface SidebarPageProps extends BaseLayoutProps {
+    /** Content rendered inside the sidebar panel. */
+    sidebar: React__default.ReactNode;
+    /** Width of the sidebar in pixels. @example sidebarWidth={280} */
+    sidebarWidth?: number;
+    /** Side the sidebar is placed on. @example sidebarPosition="right" */
+    sidebarPosition?: SidebarPosition;
+    /** Whether the sidebar can be collapsed. */
+    collapsible?: boolean;
+    /** Initial collapsed state when uncontrolled. */
+    defaultCollapsed?: boolean;
+    /** Label displayed in the sidebar header. */
+    sidebarLabel?: React__default.ReactNode;
+    /** Icon displayed before the label in the sidebar header. */
+    sidebarIcon?: React__default.ReactNode;
+    /** Whether the sidebar fills the remaining vertical space. @default true */
+    sidebarFillHeight?: boolean;
+    /** Whether the sidebar has rounded corners with a floating card style. @default false */
+    sidebarRounded?: boolean;
+}
+declare const SidebarPage: React__default.ForwardRefExoticComponent<SidebarPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Page layout that arranges children in a responsive CSS grid with a configurable column count.
+ */
+interface GridPageProps extends BaseLayoutProps {
+    /** Number of grid columns at the widest breakpoint. @example columns={4} */
+    columns?: GridColumns;
+}
+declare const GridPage: React__default.ForwardRefExoticComponent<GridPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Dashboard layout with a left-anchored navigation sidebar and a main content area.
+ */
+interface DashboardPageProps extends BaseLayoutProps {
+    /** Content rendered inside the left sidebar panel. */
+    sidebar: React__default.ReactNode;
+    /** Width of the sidebar in pixels. @example sidebarWidth={260} */
+    sidebarWidth?: number;
+    /** Whether the sidebar can be collapsed. */
+    collapsible?: boolean;
+    /** Initial collapsed state when uncontrolled. */
+    defaultCollapsed?: boolean;
+    /** Label displayed in the sidebar header. */
+    sidebarLabel?: React__default.ReactNode;
+    /** Icon displayed before the label in the sidebar header. */
+    sidebarIcon?: React__default.ReactNode;
+    /** Whether the sidebar fills the remaining vertical space. @default true */
+    sidebarFillHeight?: boolean;
+    /** Whether the sidebar has rounded corners with a floating card style. @default false */
+    sidebarRounded?: boolean;
+}
+declare const DashboardPage: React__default.ForwardRefExoticComponent<DashboardPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Two-pane layout with equal-width left and right panels separated by a border.
+ */
+interface SplitPageProps extends BaseLayoutProps {
+    /** Content rendered in the left panel. */
+    left: React__default.ReactNode;
+    /** Content rendered in the right panel. */
+    right: React__default.ReactNode;
+}
+declare const SplitPage: React__default.ForwardRefExoticComponent<SplitPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Vertically stacked page layout where children fill the main column in document order.
+ */
+type StackedPageProps = BaseLayoutProps;
+declare const StackedPage: React__default.ForwardRefExoticComponent<BaseLayoutProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Three-column layout with independent left and right sidebars flanking the main content.
+ */
+interface DualSidebarPageProps extends BaseLayoutProps {
+    /** Content rendered in the left sidebar panel. */
+    leftSidebar: React__default.ReactNode;
+    /** Content rendered in the right sidebar panel. */
+    rightSidebar: React__default.ReactNode;
+    /** Width of the left sidebar in pixels. @example leftWidth={240} */
+    leftWidth?: number;
+    /** Width of the right sidebar in pixels. @example rightWidth={240} */
+    rightWidth?: number;
+    /** Whether the left sidebar can be collapsed. */
+    leftCollapsible?: boolean;
+    /** Whether the right sidebar can be collapsed. */
+    rightCollapsible?: boolean;
+    /** Initial collapsed state for the left sidebar. */
+    defaultLeftCollapsed?: boolean;
+    /** Initial collapsed state for the right sidebar. */
+    defaultRightCollapsed?: boolean;
+    /** Label displayed in the left sidebar header. */
+    leftLabel?: React__default.ReactNode;
+    /** Icon displayed before the label in the left sidebar header. */
+    leftIcon?: React__default.ReactNode;
+    /** Label displayed in the right sidebar header. */
+    rightLabel?: React__default.ReactNode;
+    /** Icon displayed before the label in the right sidebar header. */
+    rightIcon?: React__default.ReactNode;
+    /** Whether the left sidebar fills the remaining vertical space. @default true */
+    leftFillHeight?: boolean;
+    /** Whether the right sidebar fills the remaining vertical space. @default true */
+    rightFillHeight?: boolean;
+    /** Whether the left sidebar has rounded corners with a floating card style. @default false */
+    leftRounded?: boolean;
+    /** Whether the right sidebar has rounded corners with a floating card style. @default false */
+    rightRounded?: boolean;
+}
+declare const DualSidebarPage: React__default.ForwardRefExoticComponent<DualSidebarPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Classic holy-grail layout: full-width header/footer with a three-column body (nav, main, aside).
+ */
+interface HolyGrailPageProps extends BaseLayoutProps {
+    /** Content rendered in the left navigation sidebar. */
+    leftSidebar: React__default.ReactNode;
+    /** Content rendered in the right aside sidebar. */
+    rightSidebar: React__default.ReactNode;
+    /** Width of the left sidebar in pixels. @example leftWidth={220} */
+    leftWidth?: number;
+    /** Width of the right sidebar in pixels. @example rightWidth={220} */
+    rightWidth?: number;
+    /** Whether the left sidebar can be collapsed. */
+    leftCollapsible?: boolean;
+    /** Whether the right sidebar can be collapsed. */
+    rightCollapsible?: boolean;
+    /** Initial collapsed state for the left sidebar. */
+    defaultLeftCollapsed?: boolean;
+    /** Initial collapsed state for the right sidebar. */
+    defaultRightCollapsed?: boolean;
+    /** Label displayed in the left sidebar header. */
+    leftLabel?: React__default.ReactNode;
+    /** Icon displayed before the label in the left sidebar header. */
+    leftIcon?: React__default.ReactNode;
+    /** Label displayed in the right sidebar header. */
+    rightLabel?: React__default.ReactNode;
+    /** Icon displayed before the label in the right sidebar header. */
+    rightIcon?: React__default.ReactNode;
+    /** Whether the left sidebar fills the remaining vertical space. @default true */
+    leftFillHeight?: boolean;
+    /** Whether the right sidebar fills the remaining vertical space. @default true */
+    rightFillHeight?: boolean;
+    /** Whether the left sidebar has rounded corners with a floating card style. @default false */
+    leftRounded?: boolean;
+    /** Whether the right sidebar has rounded corners with a floating card style. @default false */
+    rightRounded?: boolean;
+}
+declare const HolyGrailPage: React__default.ForwardRefExoticComponent<HolyGrailPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Two-pane layout with a configurable flex ratio between the primary and secondary panels.
+ */
+interface AsymmetricPageProps extends BaseLayoutProps {
+    /** Content rendered in the primary (wider by default) panel. */
+    primary: React__default.ReactNode;
+    /** Content rendered in the secondary panel. */
+    secondary: React__default.ReactNode;
+    /** Flex width ratio between primary and secondary panels. @example ratio="3:1" */
+    ratio?: AsymmetricRatio;
+}
+declare const AsymmetricPage: React__default.ForwardRefExoticComponent<AsymmetricPageProps & React__default.RefAttributes<HTMLDivElement>>;
+/** Maximum content width for mobile/app-like layouts. */
+type AppPageWidth = 'xs' | 'sm' | 'md' | 'lg';
+/**
+ * Mobile and webview-optimized page layout with a narrow, fixed-width content area.
+ * Full-width on small screens, centered with an optional card-like appearance on larger screens.
+ * Supports safe-area insets for native webview embedding.
+ */
+interface AppPageProps extends BaseLayoutProps {
+    /** Maximum width of the content area.
+     * - `'xs'`: 360px (small phones)
+     * - `'sm'`: 390px (standard phones)
+     * - `'md'`: 430px (large phones)
+     * - `'lg'`: 520px (phablets / small tablets)
+     * @default 'sm'
+     */
+    maxWidth?: AppPageWidth;
+    /** Whether to apply safe-area inset padding for mobile webview environments. @default true */
+    safeArea?: boolean;
+    /** Whether the content area appears as an elevated card on wider screens. @default false */
+    elevated?: boolean;
+    /** Whether the header is sticky. @default true */
+    stickyHeader?: boolean;
+    /** Whether the footer is sticky. @default false */
+    stickyFooter?: boolean;
+}
+declare const AppPage: React__default.ForwardRefExoticComponent<AppPageProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Color and semantic variant for the Toast component. */
+type ToastVariant = 'default' | 'success' | 'error' | 'warning' | 'info';
+/** Screen position where the toast stack is anchored. */
+type ToastPosition = 'top-right' | 'top-center' | 'bottom-right' | 'bottom-center';
+/** Options passed to the toast() trigger function. */
+interface ToastOptions {
+    /** Visual variant. @default 'default' */
+    variant?: ToastVariant;
+    /** Auto-dismiss delay in milliseconds; 0 disables auto-dismiss. @default 5000 */
+    duration?: number;
+    /** Optional action element rendered to the right of the message. */
+    action?: React__default.ReactNode;
+    /** Optional icon rendered on the left (visible in default variant). */
+    icon?: React__default.ReactNode;
+    /** Callback fired when the action button is clicked. */
+    onAction?: () => void;
+}
+/** Internal toast entry stored in context state. */
+interface ToastEntry extends Required<Omit<ToastOptions, 'action' | 'icon' | 'onAction'>> {
+    id: string;
+    message: string;
+    action?: React__default.ReactNode;
+    icon?: React__default.ReactNode;
+    onAction?: () => void;
+}
+/** Props for the ToastProvider. */
+interface ToastProviderProps {
+    children: React__default.ReactNode;
+    /** Where toasts are anchored on screen. @default 'bottom-right' */
+    position?: ToastPosition;
+    /** Maximum number of toasts visible at once. @default 5 */
+    maxToasts?: number;
+}
+
+declare const toastVariants: (props?: ({
+    variant?: "default" | "error" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+/**
+ * Wraps the application and provides the toast notification system.
+ * Must be rendered once near the root of the component tree.
+ * @example
+ * <ToastProvider position="bottom-right">
+ *   <App />
+ * </ToastProvider>
+ */
+declare function ToastProvider({ children, position, maxToasts }: ToastProviderProps): react_jsx_runtime.JSX.Element;
+/**
+ * Returns toast control functions. Must be used within a ToastProvider.
+ * @example
+ * const { toast, dismiss, dismissAll } = useToast();
+ * toast('Saved!', { variant: 'success' });
+ */
+declare function useToast(): {
+    toast: (message: string, options?: ToastOptions) => string;
+    dismiss: (id: string) => void;
+    dismissAll: () => void;
+};
+/** Props for a single rendered toast item. */
+interface ToastItemProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, MotionConflictingHandlers>, VariantProps<typeof toastVariants> {
+    /** Toast entry data. */
+    entry: ToastEntry;
+    /** Callback to dismiss this toast. */
+    onDismiss: (id: string) => void;
+}
+/**
+ * Renders a single toast notification card.
+ * Auto-dismisses after entry.duration ms when duration > 0.
+ */
+declare const ToastItem: React__default.ForwardRefExoticComponent<ToastItemProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Renders the stacked list of active toasts. Automatically included inside
+ * ToastProvider; you do not need to render this yourself.
+ */
+declare const ToastContainer: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Controls which edge the Drawer slides in from. */
+type DrawerSide = 'left' | 'right' | 'top' | 'bottom';
+/**
+ * Side-panel overlay (Sheet/Drawer) that slides in from a specified edge.
+ * Traps focus within the panel while open and restores focus on close.
+ * Closes on Escape key press or backdrop click.
+ * @example <Drawer open={open} onClose={() => setOpen(false)} side="right">...</Drawer>
+ */
+interface DrawerProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, MotionConflictingHandlers> {
+    /** Whether the drawer is visible. */
+    open: boolean;
+    /** Callback fired when the drawer should close (backdrop click or Escape key). */
+    onClose: () => void;
+    /** Which edge the drawer slides in from. @default 'right' */
+    side?: DrawerSide;
+    /** When false, the dark backdrop overlay is hidden. @default true */
+    backdrop?: boolean;
+}
+/**
+ * Side-panel overlay (Sheet/Drawer) component.
+ * Renders a sliding panel from the specified edge with a translucent backdrop.
+ */
+declare const Drawer: React__default.ForwardRefExoticComponent<DrawerProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Header area of a Drawer, providing vertical spacing for title and description.
+ */
+declare const DrawerHeader: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Title text within a DrawerHeader.
+ */
+declare const DrawerTitle: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLHeadingElement> & React__default.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Descriptive text within a DrawerHeader, rendered in muted color.
+ */
+declare const DrawerDescription: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLParagraphElement> & React__default.RefAttributes<HTMLParagraphElement>>;
+/**
+ * Footer area of a Drawer with a top border, used for action buttons.
+ */
+declare const DrawerFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Scrollable body area of a Drawer, grows to fill available space.
+ */
+declare const DrawerBody: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Horizontal or vertical alignment of the popover panel relative to its trigger. */
+type PopoverAlign = 'start' | 'center' | 'end';
+/** Side on which the popover panel appears relative to its trigger. */
+type PopoverSide = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Generic popover primitive for richer floating content than Tooltip but lighter than Modal.
+ * Supports controlled and uncontrolled open state, positioning via `side` and `align` props,
+ * outside-click dismissal, and Escape key dismissal.
+ * @example
+ * <Popover trigger={<Button>Open</Button>} side="bottom" align="start">
+ *   <PopoverHeader>Title</PopoverHeader>
+ *   <PopoverBody>Content here</PopoverBody>
+ *   <PopoverFooter><Button>Close</Button></PopoverFooter>
+ * </Popover>
+ */
+interface PopoverProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** The element that toggles the popover open/closed when clicked. */
+    trigger: React__default.ReactNode;
+    /** Controlled open state; omit to use uncontrolled mode. */
+    open?: boolean;
+    /** Called when the open state changes. */
+    onOpenChange?: (open: boolean) => void;
+    /** Side on which the panel appears relative to the trigger. @default 'bottom' */
+    side?: PopoverSide;
+    /** Alignment of the panel along the perpendicular axis. @default 'center' */
+    align?: PopoverAlign;
+}
+/**
+ * Popover component. Click the trigger to open/close a floating panel.
+ * Closes on outside click or Escape key.
+ */
+declare const Popover: React__default.ForwardRefExoticComponent<PopoverProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Header section of a Popover panel with bottom border.
+ * Intended for titles or primary action labels.
+ */
+declare const PopoverHeader: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Body section of a Popover panel.
+ * Intended for the main content of the popover.
+ */
+declare const PopoverBody: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Footer section of a Popover panel with top border.
+ * Intended for actions such as confirm or cancel buttons.
+ */
+declare const PopoverFooter: React__default.ForwardRefExoticComponent<React__default.HTMLAttributes<HTMLDivElement> & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Props for the EmptyState component, a standardized "no data" screen. */
+interface EmptyStateProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Optional icon or illustration displayed above the title. */
+    icon?: React__default.ReactNode;
+    /** Primary heading text. */
+    title: string;
+    /** Optional descriptive text below the title. */
+    description?: string;
+    /** Optional action button(s) rendered below the description. */
+    action?: React__default.ReactNode;
+    /** When false, the component animates out using fadeVariants. @default true */
+    visible?: boolean;
+}
+/** A centered "no data" placeholder with an optional icon, title, description, and action. */
+declare const EmptyState: React__default.ForwardRefExoticComponent<EmptyStateProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Orientation of the Stepper layout. */
+type StepperOrientation = 'horizontal' | 'vertical';
+/** Label alignment strategy for horizontal stepper. */
+type StepperAlignLabels = 'edge' | 'center';
+/**
+ * Multi-step wizard/workflow indicator container.
+ * Manages active step state and passes it to child Step components.
+ * @example
+ * <Stepper activeStep={1}>
+ *   <Step title="Account" />
+ *   <Step title="Profile" />
+ *   <Step title="Review" />
+ * </Stepper>
+ */
+interface StepperProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Zero-based index of the currently active step. */
+    activeStep: number;
+    /** Layout orientation. @default 'horizontal' */
+    orientation?: StepperOrientation;
+    /** Label alignment for horizontal layout. 'edge' aligns first left, last right; 'center' centers all. @default 'edge' */
+    alignLabels?: StepperAlignLabels;
+}
+declare const Stepper: React__default.ForwardRefExoticComponent<StepperProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Individual step within a Stepper. Auto-detects its index and state from context.
+ * @example
+ * <Step title="Account" description="Set up your account" />
+ */
+interface StepProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    /** Step title text. */
+    title: string;
+    /** Optional description below the title. */
+    description?: string;
+    /** Override the step's visual state. */
+    status?: 'completed' | 'active' | 'pending';
+    /** Icon to display instead of step number. */
+    icon?: React__default.ReactNode;
+}
+declare const Step: React__default.ForwardRefExoticComponent<StepProps & React__default.RefAttributes<HTMLDivElement>>;
+
+type PieChartVariant = 'pie' | 'donut';
+interface ChartDataPoint {
+    label: string;
+    value: number;
+}
+interface PieChartDataPoint {
+    label: string;
+    value: number;
+    color?: string;
+}
+interface BarChartProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    data: ChartDataPoint[];
+    height?: number;
+    showGrid?: boolean;
+    showLabels?: boolean;
+    showValues?: boolean;
+    color?: string;
+    colors?: string[];
+}
+declare const BarChart: React__default.ForwardRefExoticComponent<BarChartProps & React__default.RefAttributes<HTMLDivElement>>;
+interface LineChartProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    data: ChartDataPoint[];
+    height?: number;
+    showGrid?: boolean;
+    showLabels?: boolean;
+    showDots?: boolean;
+    showArea?: boolean;
+    color?: string;
+    strokeWidth?: number;
+}
+declare const LineChart: React__default.ForwardRefExoticComponent<LineChartProps & React__default.RefAttributes<HTMLDivElement>>;
+interface PieChartProps extends React__default.HTMLAttributes<HTMLDivElement> {
+    data: PieChartDataPoint[];
+    size?: number;
+    variant?: PieChartVariant;
+    strokeWidth?: number;
+    showLabels?: boolean;
+    showValues?: boolean;
+}
+declare const PieChart: React__default.ForwardRefExoticComponent<PieChartProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DonutChart: React__default.ForwardRefExoticComponent<PieChartProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Size variant of the SegmentController. */
+type SegmentControllerSize = 'sm' | 'md' | 'lg';
+/** Selection mode of the SegmentController. */
+type SegmentControllerMode = 'single' | 'multi';
+/** A single segment option. */
+interface SegmentOption {
+    /** Unique value for this segment. */
+    value: string;
+    /** Display label for this segment. */
+    label: string;
+    /** Icon rendered before the label. */
+    icon?: React__default.ReactNode;
+    /** When true, this segment cannot be selected. */
+    disabled?: boolean;
+}
+/** Shared props for both modes. */
+interface SegmentControllerBaseProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Array of segment options to render. */
+    options: SegmentOption[];
+    /** Size variant affecting height and font size. @default 'md' */
+    size?: SegmentControllerSize;
+    /** When true, segments expand to fill available width. @default false */
+    fullWidth?: boolean;
+    /** When true, the entire control is disabled. */
+    disabled?: boolean;
+    /** When true, only the selected option is visible; expands on hover to reveal all options. @default false */
+    collapsible?: boolean;
+}
+/** Props for single-select mode (default). */
+interface SegmentControllerSingleProps extends SegmentControllerBaseProps {
+    /** Selection mode. @default 'single' */
+    mode?: 'single';
+    /** The controlled selected value. */
+    value?: string;
+    /** The initial value for uncontrolled usage. */
+    defaultValue?: string;
+    /** Called when the selected segment changes. */
+    onChange?: (value: string) => void;
+}
+/** Props for multi-select mode. */
+interface SegmentControllerMultiProps extends SegmentControllerBaseProps {
+    /** Selection mode. */
+    mode: 'multi';
+    /** The controlled selected values. */
+    value?: string[];
+    /** The initial values for uncontrolled usage. */
+    defaultValue?: string[];
+    /** Called when the selected segments change. */
+    onChange?: (value: string[]) => void;
+}
+/** Props for the SegmentController component, a pill-shaped segmented control with animated indicator. */
+type SegmentControllerProps = SegmentControllerSingleProps | SegmentControllerMultiProps;
+declare const SegmentController: React__default.ForwardRefExoticComponent<SegmentControllerProps & React__default.RefAttributes<HTMLDivElement>>;
+/** @deprecated Use `SegmentOption` instead. */
+type SlidingSelectOption = SegmentOption;
+/** @deprecated Use `SegmentControllerSize` instead. */
+type SlidingSelectSize = SegmentControllerSize;
+/** @deprecated Use `SegmentControllerProps` instead. */
+type SlidingSelectProps = SegmentControllerSingleProps;
+/** @deprecated Use `SegmentController` instead. */
+declare const SlidingSelect: React__default.ForwardRefExoticComponent<SegmentControllerProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/** Picker mode: date-only, date+time, or month-only. */
+type DatePickerMode = 'date' | 'datetime' | 'month';
+/** Props for the DatePicker component, a calendar-based date selector with dropdown panel. */
+interface DatePickerProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** The controlled selected date. */
+    value?: Date | null;
+    /** Called when a date is selected. */
+    onChange?: (date: Date | null) => void;
+    /** Label text displayed above the input. */
+    label?: string;
+    /** Helper text displayed below the input. */
+    helperText?: string;
+    /** Placeholder text when no date is selected. @default 'Select date' */
+    placeholder?: string;
+    /** When true, applies error styling. */
+    error?: boolean;
+    /** Error message displayed below the input when `error` is true. */
+    errorMessage?: string;
+    /** Earliest selectable date. */
+    minDate?: Date;
+    /** Latest selectable date. */
+    maxDate?: Date;
+    /** When true, the date picker is disabled. */
+    disabled?: boolean;
+    /** Date format display function. Defaults to mode-aware format string. */
+    formatDate?: (date: Date) => string;
+    /** ID attribute for the trigger button. */
+    id?: string;
+    /** Picker mode. @default 'date' */
+    mode?: DatePickerMode;
+    /** When true, uses 24-hour format for time. @default true */
+    use24Hour?: boolean;
+    /** Minute step interval for time picker. @default 1 */
+    minuteStep?: number;
+}
+declare const DatePicker: React__default.ForwardRefExoticComponent<DatePickerProps & React__default.RefAttributes<HTMLDivElement>>;
+
+declare global {
+    interface EyeDropper {
+        open(options?: {
+            signal?: AbortSignal;
+        }): Promise<{
+            sRGBHex: string;
+        }>;
+    }
+    var EyeDropper: {
+        new (): EyeDropper;
+    } | undefined;
+}
+/** Props for the ColorPicker component, a color selector with spectrum picker, swatch grid, and channel inputs. */
+interface ColorPickerProps extends Omit<React__default.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** The controlled selected color as a hex string (e.g. '#FF0000'). */
+    value?: string;
+    /** Called when a color is selected (after confirming). */
+    onChange?: (color: string) => void;
+    /** Label text displayed above the picker trigger. */
+    label?: string;
+    /** Helper text displayed below the trigger. */
+    helperText?: string;
+    /** When true, applies error styling. */
+    error?: boolean;
+    /** Error message displayed below the trigger when `error` is true. */
+    errorMessage?: string;
+    /** Custom array of hex color strings for the swatch grid. */
+    colors?: string[];
+    /** When true, the picker is disabled. */
+    disabled?: boolean;
+    /** Placeholder text when no color is selected. @default 'Select color' */
+    placeholder?: string;
+    /** ID attribute for the trigger button. */
+    id?: string;
+    /** When true, shows a text input for manual hex entry. @default true */
+    showInput?: boolean;
+    /** When true, shows the spectrum gradient picker for detailed color selection. @default true */
+    showSpectrum?: boolean;
+    /** When true, shows the eyedropper button (only works in supported browsers). @default true */
+    showEyeDropper?: boolean;
+    /** When true, shows RGB/HSB channel inputs for precise values. @default true */
+    showChannels?: boolean;
+}
+declare const ColorPicker: React__default.ForwardRefExoticComponent<ColorPickerProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Traps keyboard focus within a container element while active.
+ * Tab and Shift+Tab cycle through focusable elements without escaping.
+ */
+declare function useFocusTrap(containerRef: React.RefObject<HTMLElement | null>, active: boolean): void;
+/**
+ * Saves the previously focused element on open and restores focus on close.
+ */
+declare function useFocusRestore(active: boolean): void;
+/**
+ * Provides arrow-key navigation for a list of items within a container.
+ * Returns a callback ref to attach to the container element.
+ */
+declare function useRovingIndex(containerRef: React.RefObject<HTMLElement | null>, active: boolean, opts?: {
+    onSelect?: (index: number) => void;
+    itemSelector?: string;
+}): void;
+
+declare function useSpotlight(): {
+    ref: React$1.RefObject<HTMLDivElement | null>;
+    spotlightStyle: React$1.CSSProperties;
+    onMouseMove: (e: React.MouseEvent<HTMLDivElement>) => void;
+    onMouseEnter: () => void;
+    onMouseLeave: () => void;
+    isHovered: boolean;
+};
+
+declare function cn(...inputs: ClassValue[]): string;
+
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, type AccordionType, Alert, AlertDescription, type AlertProps, AlertTitle, type AlertVariant, AnimatedToggle, type AnimatedToggleProps, AppPage, type AppPageProps, type AppPageWidth, AsymmetricPage, type AsymmetricPageProps, type AsymmetricRatio, Avatar, type AvatarProps, type AvatarSize, Badge, type BadgeProps, type BadgeVariant, BarChart, type BarChartProps, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbProps, BreadcrumbSeparator, Button, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, type CardVariant, type ChartDataPoint, Checkbox, type CheckboxProps, Chip, type ChipProps, type ChipVariant, CodeBlock, type CodeBlockProps, ColorPicker, type ColorPickerProps, Combobox, type ComboboxOption, type ComboboxProps, Container, type ContainerProps, DashboardPage, type DashboardPageProps, DatePicker, type DatePickerMode, type DatePickerProps, Dialog, DialogDescription, DialogFooter, DialogHeader, type DialogProps, DialogTitle, Divider, type DividerProps, type DividerVariant, DonutChart, Drawer, DrawerBody, DrawerDescription, DrawerFooter, DrawerHeader, type DrawerProps, type DrawerSide, DrawerTitle, Dropdown, type DropdownAlign, DropdownDivider, DropdownItem, type DropdownItemProps, type DropdownProps, DropdownSearch, type DropdownSearchProps, DropdownTitle, DualSidebarPage, type DualSidebarPageProps, EmptyState, type EmptyStateProps, FloatingMenuBar, type FloatingMenuBarPosition, type FloatingMenuBarProps, FloatingMenuItem, type FloatingMenuItemProps, Footer, type FooterProps, type GridColumns, GridPage, type GridPageProps, HStack, Header, type HeaderProps, HolyGrailPage, type HolyGrailPageProps, Indicator, type IndicatorProps, type IndicatorVariant, Input, type InputProps, LineChart, type LineChartProps, Main, type MainProps, type MaxWidth, Modal, ModalDescription, ModalFooter, ModalHeader, ModalIcon, type ModalProps, type ModalSize, ModalTitle, MorphingCard, type MorphingCardProps, PageLayout, type PageLayoutProps, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, type PaginationItemProps, PaginationNext, type PaginationPrevNextProps, PaginationPrevious, type PaginationProps, PieChart, type PieChartDataPoint, type PieChartProps, type PieChartVariant, Popover, type PopoverAlign, PopoverBody, PopoverFooter, PopoverHeader, type PopoverProps, type PopoverSide, Progress, type ProgressBarSize, type ProgressProps, type ProgressVariant, Radio, RadioGroup, type RadioGroupProps, type RadioProps, SegmentController, type SegmentControllerMode, type SegmentControllerProps, type SegmentControllerSize, type SegmentOption, Select, type SelectOption, type SelectProps, type SelectSize, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, type SidebarGroupProps, SidebarItem, type SidebarItemProps, type SidebarItemVariant, SidebarPage, type SidebarPageProps, type SidebarPosition, type SidebarProps, SingleColumnPage, type SingleColumnPageProps, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, SlidingSelect, type SlidingSelectOption, type SlidingSelectProps, type SlidingSelectSize, Snackbar, type SnackbarProps, type SnackbarVariant, type Spacing, SplitPage, type SplitPageProps, type StackAlign, type StackJustify, type StackProps, StackedPage, type StackedPageProps, Step, type StepProps, Stepper, type StepperAlignLabels, type StepperOrientation, type StepperProps, Switch, type SwitchProps, TabContent, type TabContentProps, TabTrigger, type TabTriggerProps, type TabVariant, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsList, type TabsProps, TacProvider, type TacProviderProps, Textarea, type TextareaProps, ToastContainer, ToastItem, type ToastItemProps, type ToastOptions, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastVariant, Tooltip, type TooltipPlacement, type TooltipProps, VStack, alertVariants, avatarVariants, badgeVariants, buttonVariants, cardVariants, chipVariants, cn, containerVariants, dividerVariants, footerVariants, headerVariants, mainVariants, sidebarVariants, snackbarVariants, toastVariants, useFocusRestore, useFocusTrap, useRovingIndex, useSidebarContext, useSpotlight, useTacTheme, useToast };