@doscientos/ui 0.1.30 → 0.1.32

package/dist/index.d.cts

@@ -3,9 +3,24 @@ import { RefCallback, ReactNode, ComponentPropsWithRef } from 'react';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { ClassValue } from 'clsx';
 import * as react_aria_components from 'react-aria-components';
-import { DisclosureGroupProps, DisclosurePanelProps, DisclosureProps, ButtonProps as ButtonProps$1, LinkProps, Text, Heading, Dialog as Dialog$1, ModalOverlayProps, Breadcrumb as Breadcrumb$1, Link, Breadcrumbs as Breadcrumbs$1, Separator as Separator$1, CheckboxProps as CheckboxProps$1, ComboBoxProps, Key, Popover as Popover$1, InputProps as InputProps$1, ListBoxItemProps, ListBoxProps, Input as Input$1, ListBox, Menu as Menu$1, MenuTrigger as MenuTrigger$1, MenuSectionProps, MenuItemProps, Header, SubmenuTrigger, TextAreaProps, MenuProps, PopoverProps as PopoverProps$1, DialogTriggerProps as DialogTriggerProps$1, DialogTrigger as DialogTrigger$1, NumberFieldProps, SelectProps, SelectValue as SelectValue$1, Modal, SwitchProps as SwitchProps$1, TabPanelProps as TabPanelProps$1, TabProps as TabProps$1, TabsProps as TabsProps$1, TabListProps, TabPanelsProps, Tooltip as Tooltip$1, TooltipTrigger as TooltipTrigger$1 } from 'react-aria-components';
-export { ComboBoxProps, ComboBoxValue as ComboboxValue, DialogTriggerProps as PopoverTriggerProps, SelectProps, DialogProps as SheetPrimitiveProps, DialogTriggerProps as SheetTriggerPrimitiveProps } from 'react-aria-components';
+import { DisclosureGroupProps, DisclosurePanelProps, DisclosureProps, ButtonProps as ButtonProps$1, LinkProps, Text, Heading, Dialog as Dialog$1, ModalOverlayProps, Breadcrumb as Breadcrumb$1, Link, Breadcrumbs as Breadcrumbs$1, Separator as Separator$1, CheckboxProps as CheckboxProps$1, ComboBoxProps, Key, InputProps as InputProps$1, Popover as Popover$1, ListBoxItemProps, ListBoxProps, Input as Input$1, ListBox, Modal, DialogProps as DialogProps$1, DialogTriggerProps as DialogTriggerProps$1, Menu as Menu$1, MenuTrigger as MenuTrigger$1, MenuSectionProps, MenuItemProps, Header, SubmenuTrigger, TextAreaProps, MenuProps, PopoverProps as PopoverProps$1, DialogTrigger as DialogTrigger$1, NumberFieldProps, SelectProps, SelectValue as SelectValue$1, SwitchProps as SwitchProps$1, TabPanelProps as TabPanelProps$1, TabProps as TabProps$1, TabsProps as TabsProps$1, TabListProps, TabPanelsProps, Tooltip as Tooltip$1, TooltipTrigger as TooltipTrigger$1 } from 'react-aria-components';
+export { ComboBoxProps, ComboBoxValue as ComboboxValue, DialogProps as DrawerPrimitiveProps, DialogTriggerProps as DrawerTriggerPrimitiveProps, DialogTriggerProps as PopoverTriggerProps, SelectProps } from 'react-aria-components';
 import { VariantProps } from 'class-variance-authority';
+import { AlertCircle } from 'lucide-react';
+
+type AsyncActionStatus = 'idle' | 'pending' | 'success' | 'error';
+/**
+ * Runs one async action at a time and exposes its lifecycle to UI components.
+ * `run` resolves to `null` if another call is pending or the action fails; inspect `error` for failures.
+ */
+declare function useAsyncAction<Args extends unknown[], Result>(action: (...args: Args) => Promise<Result>): {
+    data: Result | null;
+    error: Error | null;
+    isPending: boolean;
+    reset: () => void;
+    run: (...args: Args) => Promise<Result | null>;
+    status: AsyncActionStatus;
+};
 
 type AutosaveStatus = 'idle' | 'saving' | 'saved' | 'error';
 type UseAutosaveOptions<T> = {
@@ -22,6 +37,20 @@ declare function useAutosave<T>({ data, onSave, debounceMs, enabled, serialize,
     saveNow: () => Promise<void>;
 };
 
+type ClipboardStatus = 'idle' | 'copied' | 'error';
+/**
+ * Copies text and exposes success/error feedback without imposing a toast or analytics provider.
+ * Use `onError` to delegate product-specific feedback.
+ */
+declare function useClipboard({ resetMs, onError, }?: {
+    resetMs?: number;
+    onError?: (error: Error) => void;
+}): {
+    copy: (value: string) => Promise<boolean>;
+    error: Error | null;
+    status: ClipboardStatus;
+};
+
 /** Returns a value only after it has been stable for the supplied delay. */
 declare function useDebouncedValue<T>(value: T, delay?: number): T;
 
@@ -43,6 +72,25 @@ declare const actionRipple: (props?: class_variance_authority_types.ClassProp |
 /** Merges conditional class names, resolving conflicting Tailwind utilities. */
 declare function cn(...inputs: ClassValue[]): string;
 
+type SearchParamPrimitive = string | number | boolean;
+type SearchParamValue = SearchParamPrimitive | readonly SearchParamPrimitive[] | null | undefined;
+type SearchParamUpdates = Record<string, SearchParamValue>;
+type SearchParamsRecord = Record<string, string | readonly string[] | undefined>;
+type SearchParamsInput = string | URLSearchParams | SearchParamsRecord | {
+    toString(): string;
+};
+/** Normalizes framework-specific query values into a mutable URLSearchParams instance. */
+declare function toSearchParams(input?: SearchParamsInput): URLSearchParams;
+/** Applies filter updates without dropping unrelated query params. Empty values remove their key. */
+declare function updateSearchParams(current: SearchParamsInput, updates: SearchParamUpdates): URLSearchParams;
+declare function readSearchParam(params: SearchParamsInput, key: string, fallback?: string): string;
+declare function readSearchParamArray(params: SearchParamsInput, key: string): string[];
+declare function readSearchParamInt(params: SearchParamsInput, key: string, fallback?: number, options?: {
+    min?: number;
+    max?: number;
+}): number;
+declare function readSearchParamEnum<Value extends string>(params: SearchParamsInput, key: string, values: readonly Value[], fallback: Value): Value;
+
 type TextMatchPart = {
     text: string;
     match: boolean;
@@ -172,18 +220,21 @@ type AlertDialogProps = {
 };
 /** Controlled, composable confirmation dialog for domain-specific destructive actions. */
 declare function AlertDialog({ children, open, onOpenChange }: AlertDialogProps): React$1.JSX.Element;
+/** @deprecated AlertDialogContent already provides the required portal. */
 declare function AlertDialogPortal({ children }: {
     children?: React$1.ReactNode;
 }): React$1.JSX.Element;
 declare function AlertDialogTrigger({ children, ...props }: Omit<React$1.ComponentProps<typeof Button>, 'onPress'>): React$1.JSX.Element;
+/** @deprecated AlertDialogContent already provides the required overlay. */
 declare function AlertDialogOverlay({ className, ...props }: Omit<ModalOverlayProps, 'children' | 'className' | 'isOpen' | 'onOpenChange'> & {
     className?: string;
 }): React$1.JSX.Element;
-declare function AlertDialogContent({ className, size, children, }: {
+type AlertDialogContentProps = {
     children?: React$1.ReactNode;
     className?: string;
     size?: 'default' | 'sm';
-}): React$1.JSX.Element;
+};
+declare function AlertDialogContent({ className, size, children, }: AlertDialogContentProps): React$1.JSX.Element;
 declare function AlertDialogHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
 declare function AlertDialogFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
 declare function AlertDialogTitle({ className, ...props }: React$1.ComponentProps<typeof DialogTitle>): React$1.JSX.Element;
@@ -192,7 +243,7 @@ declare function AlertDialogAction({ className, ...props }: React$1.ComponentPro
 declare function AlertDialogCancel({ children, onClick, ...props }: Omit<React$1.ComponentProps<typeof Button>, 'onPress'>): React$1.JSX.Element;
 
 declare const alertVariants: (props?: ({
-    variant?: "default" | "destructive" | "info" | "success" | "warning" | null | undefined;
+    variant?: "success" | "default" | "destructive" | "info" | "warning" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 
 type AlertProps = React$1.ComponentProps<'div'> & VariantProps<typeof alertVariants> & {
@@ -239,7 +290,7 @@ declare function AvatarGroup({ className, ...props }: React.ComponentProps<'div'
 declare function AvatarGroupCount({ className, ...props }: React.ComponentProps<'span'>): React$1.JSX.Element;
 
 declare const badgeVariants: (props?: ({
-    variant?: "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | "info" | "success" | "warning" | "neutral" | "danger" | null | undefined;
+    variant?: "success" | "link" | "default" | "outline" | "secondary" | "ghost" | "destructive" | "info" | "warning" | "neutral" | "danger" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 
 type BadgeProps = React$1.ComponentProps<'span'> & VariantProps<typeof badgeVariants> & {
@@ -330,7 +381,7 @@ declare function HighlightMatch({ text, query, className, }: {
     query: string;
     className?: string;
 }): React$1.JSX.Element;
-type AutocompleteComboboxProps<T extends object> = Omit<ComboBoxProps<T>, 'children' | 'items' | 'inputValue' | 'onInputChange' | 'selectedKey' | 'onSelectionChange' | 'defaultFilter'> & {
+type AutocompleteComboboxProps<T extends object> = Omit<ComboBoxProps<T>, 'children' | 'items' | 'inputValue' | 'onInputChange' | 'selectedKey' | 'onSelectionChange' | 'defaultFilter' | 'onKeyDown'> & {
     items: readonly T[];
     getItemKey: (item: T) => Key;
     getItemLabel: (item: T) => string;
@@ -345,9 +396,11 @@ type AutocompleteComboboxProps<T extends object> = Omit<ComboBoxProps<T>, 'child
     emptyState?: ReactNode;
     suggestion?: boolean;
     placeholder?: string;
+    /** Keyboard handler for the underlying text input. */
+    onKeyDown?: InputProps$1['onKeyDown'];
 };
 /** A safe, keyboard-first autocomplete for users, contracts and other entities. */
-declare function AutocompleteCombobox<T extends object>({ items, getItemKey, getItemLabel, renderItem, inputValue: controlledInputValue, onInputChange, selectedKey, onSelectionChange, label, description, errorMessage, emptyState, suggestion, placeholder, className, onKeyDown: _onKeyDown, ...props }: AutocompleteComboboxProps<T>): React$1.JSX.Element;
+declare function AutocompleteCombobox<T extends object>({ items, getItemKey, getItemLabel, renderItem, inputValue: controlledInputValue, onInputChange, selectedKey, onSelectionChange, label, description, errorMessage, emptyState, suggestion, placeholder, className, onKeyDown, ...props }: AutocompleteComboboxProps<T>): React$1.JSX.Element;
 
 /** Searchable command palette built from an accessible combobox and option list. */
 declare function Command<T extends object>({ className, ...props }: ComboBoxProps<T>): React$1.JSX.Element;
@@ -356,6 +409,87 @@ declare function CommandContent({ className, ...props }: React.ComponentProps<ty
 declare function CommandList<T extends object>({ className, ...props }: React.ComponentProps<typeof ListBox<T>>): React$1.JSX.Element;
 declare function CommandItem<T extends object>({ className, ...props }: ListBoxItemProps<T>): React$1.JSX.Element;
 
+declare function DrawerTrigger({ ...props }: DialogTriggerProps$1): React$1.JSX.Element;
+declare function DrawerClose({ className, variant, size, ...props }: ButtonProps): React$1.JSX.Element;
+/** Props for a controlled drawer panel. */
+type DrawerContentProps = Omit<ModalOverlayProps, 'className' | 'children'> & Pick<React$1.ComponentProps<typeof Modal>, 'isDismissable'> & {
+    className?: string;
+    /** Props applied to the accessible dialog inside the drawer panel. */
+    dialogProps?: Omit<DialogProps$1, 'children' | 'className'>;
+    children: React$1.ReactNode;
+    side?: 'top' | 'right' | 'bottom' | 'left';
+    showCloseButton?: boolean;
+};
+/** Dismissable, controlled modal panel that slides in from a screen edge. */
+declare function DrawerContent({ className, children, dialogProps, side, showCloseButton, ...props }: DrawerContentProps): React$1.JSX.Element;
+type TriggerDrawerProps = DrawerContentProps & Pick<DialogTriggerProps$1, 'defaultOpen' | 'isOpen' | 'onOpenChange'> & {
+    /** Text for a default button, or an interactive element that opens the drawer. */
+    trigger: string | React$1.ReactElement;
+    /** Props for the default button rendered when {@link trigger} is text. */
+    triggerProps?: Omit<ButtonProps, 'children'>;
+};
+/** Props for a controlled drawer or a drawer with a simple trigger. */
+type DrawerProps = DrawerContentProps | TriggerDrawerProps;
+/**
+ * A dismissable modal panel. Pass `trigger` for a simple trigger API, or control it with `isOpen`.
+ * Use {@link DrawerTrigger} plus {@link DrawerContent} for advanced composition.
+ */
+declare function Drawer(props: DrawerProps): React$1.JSX.Element;
+declare function DrawerHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function DrawerFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function DrawerTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, 'slot'>): React$1.JSX.Element;
+declare function DrawerDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, 'slot'>): React$1.JSX.Element;
+/** @deprecated Use {@link DrawerContent}. */
+declare const Sheet: typeof DrawerContent;
+/** @deprecated Use {@link DrawerPrimitiveProps}. */
+type SheetPrimitiveProps = DialogProps$1;
+/** @deprecated Use {@link DrawerClose}. */
+declare const SheetClose: typeof DrawerClose;
+/** @deprecated Use {@link DrawerContent}. */
+declare const SheetContent: typeof DrawerContent;
+/** @deprecated Use {@link DrawerDescription}. */
+declare const SheetDescription: typeof DrawerDescription;
+/** @deprecated Use {@link DrawerFooter}. */
+declare const SheetFooter: typeof DrawerFooter;
+/** @deprecated Use {@link DrawerHeader}. */
+declare const SheetHeader: typeof DrawerHeader;
+/** @deprecated Use {@link DrawerTitle}. */
+declare const SheetTitle: typeof DrawerTitle;
+/** @deprecated Use {@link DrawerTrigger}. */
+declare const SheetTrigger: typeof DrawerTrigger;
+/** @deprecated Use {@link DrawerTriggerPrimitiveProps}. */
+type SheetTriggerPrimitiveProps = DialogTriggerProps$1;
+
+/** Flexible toolbar container for filter controls and active-filter chips. */
+declare function FilterBar({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function FilterGroup({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+/** Labels a group of currently active filters for assistive technology. */
+declare function ActiveFilters({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+/** An active filter button. `onRemove` must update the application-owned filter state. */
+declare function FilterChip({ children, onRemove, ...props }: Omit<React$1.ComponentProps<typeof Button>, 'children' | 'onPress'> & {
+    children: React$1.ReactNode;
+    onRemove: () => void;
+}): React$1.JSX.Element;
+/** Announces the selected item count and displays application-owned bulk actions. */
+declare function SelectionToolbar({ count, className, children, ...props }: React$1.ComponentProps<'div'> & {
+    count: number;
+}): React$1.JSX.Element;
+/** Responsive semantic list for read-only record details. */
+declare function DescriptionList({ className, ...props }: React$1.ComponentProps<'dl'>): React$1.JSX.Element;
+declare function DescriptionItem({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function DescriptionTerm({ className, ...props }: React$1.ComponentProps<'dt'>): React$1.JSX.Element;
+declare function DescriptionDetails({ className, ...props }: React$1.ComponentProps<'dd'>): React$1.JSX.Element;
+/** Composable empty, loading, or recoverable state for a data view. */
+declare function DataViewState({ className, ...props }: React$1.ComponentProps<'section'>): React$1.JSX.Element;
+declare function DataViewStateTitle({ children, className, ...props }: React$1.ComponentProps<'h2'>): React$1.JSX.Element;
+declare function DataViewStateDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
+declare function DataViewStateActions({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+/** Responsive layout container for MetricCard items. */
+declare function MetricGrid({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+/** Drawer content frame for record details; compose it inside an open Drawer. */
+declare function DetailDrawer({ children, ...props }: React$1.ComponentProps<typeof DrawerContent>): React$1.JSX.Element;
+declare function DetailDrawerBody({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+
 type ConfirmDialogProps = {
     open: boolean;
     onOpenChange: (open: boolean) => void;
@@ -370,6 +504,17 @@ type ConfirmDialogProps = {
 /** Controlled confirmation dialog for irreversible actions. */
 declare function ConfirmDialog({ open, onOpenChange, title, description, confirmLabel, cancelLabel, destructive, pending, onConfirm, }: ConfirmDialogProps): React$1.JSX.Element;
 
+type CopyButtonProps = Omit<ButtonProps, 'children' | 'onPress'> & {
+    value: string;
+    children?: React$1.ReactNode;
+    copiedLabel?: string;
+    resetMs?: number;
+    onCopied?: (value: string) => void;
+    onCopyError?: (error: Error) => void;
+};
+/** Copies a value with accessible success feedback and no dependency on a toast provider. */
+declare function CopyButton({ value, children, copiedLabel, resetMs, onCopied, onCopyError, ...props }: CopyButtonProps): React$1.JSX.Element;
+
 type DangerZoneProps = {
     children: React$1.ReactNode;
     className?: string;
@@ -440,6 +585,30 @@ declare function EmptyStateTitle({ className, children, ...props }: React$1.Comp
 declare function EmptyStateDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
 declare function EmptyStateContent({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
 
+type ErrorFallbackProps = {
+    error: Error;
+    reset: () => void;
+};
+type ErrorBoundaryProps = {
+    children: React$1.ReactNode;
+    fallback?: React$1.ReactNode | ((props: ErrorFallbackProps) => React$1.ReactNode);
+    onError?: (error: Error, info: React$1.ErrorInfo) => void;
+    resetKeys?: readonly unknown[];
+};
+/** Catches rendering errors and renders a supplied or recoverable default fallback. */
+declare function ErrorBoundary(props: ErrorBoundaryProps): React$1.JSX.Element;
+/** Adds a Suspense fallback to ErrorBoundary without coupling loading to a data client. */
+declare function AsyncBoundary({ pending, ...props }: ErrorBoundaryProps & {
+    pending?: React$1.ReactNode;
+}): React$1.JSX.Element;
+
+/** Presentational, accessible error state that applications can pair with a retry action. */
+declare function ErrorState({ className, ...props }: React$1.ComponentProps<'section'>): React$1.JSX.Element;
+declare function ErrorStateIcon({ className, ...props }: Omit<React$1.ComponentProps<typeof AlertCircle>, 'children'>): React$1.JSX.Element;
+declare function ErrorStateTitle({ className, ...props }: React$1.ComponentProps<'h2'>): React$1.JSX.Element;
+declare function ErrorStateDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
+declare function ErrorStateActions({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+
 /** Accessible label associated with a React Aria form control. */
 declare const Label: React$1.ForwardRefExoticComponent<Omit<react_aria_components.LabelProps & React$1.RefAttributes<HTMLLabelElement>, "ref"> & React$1.RefAttributes<HTMLLabelElement>>;
 type LabelProps = ComponentPropsWithRef<typeof Label>;
@@ -629,9 +798,17 @@ type MetricCardProps = Omit<React$1.ComponentProps<typeof Card>, 'children'> & {
     icon?: React$1.ReactNode;
     /** Semantic emphasis without coupling the card to a product status. */
     tone?: 'default' | 'success' | 'warning' | 'danger' | 'info';
+    /** Direction of an optional comparison value. */
+    trend?: 'up' | 'down' | 'neutral';
+    /** Optional comparison with a previous period. */
+    delta?: React$1.ReactNode;
+    /** Replaces the value with an accessible loading placeholder. */
+    loading?: boolean;
+    /** Accessible loading label when the metric label is not plain text. */
+    loadingLabel?: string;
 };
 /** Compact, accessible summary of a labelled metric. */
-declare function MetricCard({ className, label, value, description, icon, tone, ...props }: MetricCardProps): React$1.JSX.Element;
+declare function MetricCard({ className, label, value, description, icon, tone, trend, delta, loading, loadingLabel, ...props }: MetricCardProps): React$1.JSX.Element;
 
 type CompatibleRef<T> = ((instance: T | null) => unknown) | {
     readonly current: T | null;
@@ -657,6 +834,12 @@ declare function PageHeaderHeading({ className, ...props }: React$1.ComponentPro
 declare function PageHeaderTitle({ className, children, ...props }: React$1.ComponentProps<'h1'>): React$1.JSX.Element;
 declare function PageHeaderDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
 declare function PageHeaderActions({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+/** Section-level heading layout for panels and cards. */
+declare function SectionHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function SectionHeaderHeading({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function SectionHeaderTitle({ className, ...props }: React$1.ComponentProps<'h2'>): React$1.JSX.Element;
+declare function SectionHeaderDescription({ className, ...props }: React$1.ComponentProps<'p'>): React$1.JSX.Element;
+declare function SectionHeaderActions({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
 
 type PaginationProps = {
     /** Currently selected page, starting at one. */
@@ -722,53 +905,13 @@ declare function SelectList<T extends object>({ className, ...props }: ListBoxPr
 /** Selectable option within a {@link SelectList}. */
 declare function SelectItem<T extends object>({ className, children, ...props }: ListBoxItemProps<T>): React$1.JSX.Element;
 
-declare function SheetTrigger({ ...props }: DialogTriggerProps$1): React$1.JSX.Element;
-declare function SheetClose({ className, variant, size, ...props }: ButtonProps): React$1.JSX.Element;
-/** Dismissable modal panel that slides in from a screen edge. */
-declare function Sheet({ className, children, side, showCloseButton, ...props }: Omit<ModalOverlayProps, 'className' | 'children'> & Pick<React$1.ComponentProps<typeof Modal>, 'isDismissable'> & {
-    className?: string;
-    children: React$1.ReactNode;
-    side?: 'top' | 'right' | 'bottom' | 'left';
-    showCloseButton?: boolean;
-}): React$1.JSX.Element;
-declare function SheetContent({ className, children, side, showCloseButton, ...props }: React$1.ComponentProps<typeof Sheet> & {
-    side?: 'top' | 'right' | 'bottom' | 'left';
-    showCloseButton?: boolean;
-}): React$1.JSX.Element;
-/** Props for the simple {@link Drawer} API. */
-type DrawerProps = React$1.ComponentProps<typeof SheetContent> & Pick<DialogTriggerProps$1, 'defaultOpen' | 'isOpen' | 'onOpenChange'> & {
-    /** Text for a default button, or an interactive element that opens the drawer. */
-    trigger: string | React$1.ReactElement;
-    /** Props for the default button rendered when {@link trigger} is text. */
-    triggerProps?: Omit<ButtonProps, 'children'>;
-};
-/**
- * A dismissable modal panel with a simple trigger API.
- * Use {@link DrawerTrigger} plus {@link DrawerContent} for advanced composition.
- */
-declare function Drawer({ children, trigger, triggerProps, defaultOpen, isOpen, onOpenChange, ...contentProps }: DrawerProps): React$1.JSX.Element;
-declare function SheetHeader({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
-declare function SheetFooter({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
-declare function SheetTitle({ className, ...props }: Omit<React$1.ComponentProps<typeof Heading>, 'slot'>): React$1.JSX.Element;
-declare function SheetDescription({ className, ...props }: Omit<React$1.ComponentProps<typeof Text>, 'slot'>): React$1.JSX.Element;
-/** Explicit advanced-composition name for {@link SheetTrigger}. */
-declare const DrawerTrigger: typeof SheetTrigger;
-/** Explicit advanced-composition name for {@link Sheet}. */
-declare const DrawerContent: typeof SheetContent;
-/** Explicit advanced-composition name for {@link SheetClose}. */
-declare const DrawerClose: typeof SheetClose;
-/** Explicit advanced-composition name for {@link SheetHeader}. */
-declare const DrawerHeader: typeof SheetHeader;
-/** Explicit advanced-composition name for {@link SheetFooter}. */
-declare const DrawerFooter: typeof SheetFooter;
-/** Explicit advanced-composition name for {@link SheetTitle}. */
-declare const DrawerTitle: typeof SheetTitle;
-/** Explicit advanced-composition name for {@link SheetDescription}. */
-declare const DrawerDescription: typeof SheetDescription;
-
 /** Provides the expanded or collapsed state required by sidebar components. */
-declare function SidebarProvider({ defaultCollapsed, children, }: {
+declare function SidebarProvider({ defaultCollapsed, collapsed: controlledCollapsed, onCollapsedChange, children, }: {
     defaultCollapsed?: boolean;
+    /** Controlled collapsed state for persistence or external navigation. */
+    collapsed?: boolean;
+    /** Notifies when a user toggles the sidebar. */
+    onCollapsedChange?: (collapsed: boolean) => void;
     children: ReactNode;
 }): React$1.JSX.Element;
 /** Primary application navigation; render it within a {@link SidebarProvider}. */
@@ -863,6 +1006,17 @@ declare function TableHead({ className, ...props }: React$1.ComponentProps<'th'>
 declare function TableCell({ className, ...props }: React$1.ComponentProps<'td'>): React$1.JSX.Element;
 declare function TableCaption({ className, ...props }: React$1.ComponentProps<'caption'>): React$1.JSX.Element;
 declare function TableFooter({ className, ...props }: React$1.ComponentProps<'tfoot'>): React$1.JSX.Element;
+declare function TableToolbar({ className, ...props }: React$1.ComponentProps<'div'>): React$1.JSX.Element;
+declare function TableEmpty({ colSpan, className, children, }: {
+    colSpan?: number;
+    className?: string;
+    children?: React$1.ReactNode;
+}): React$1.JSX.Element;
+declare function TableLoading({ colSpan, className, children, }: {
+    colSpan?: number;
+    className?: string;
+    children?: React$1.ReactNode;
+}): React$1.JSX.Element;
 
 type TabsProps = TabsProps$1;
 type TabProps = TabProps$1;
@@ -967,4 +1121,4 @@ declare function TooltipContent({ className, placement, offset, crossOffset, chi
     children?: React$1.ReactNode;
 }): React$1.JSX.Element;
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogProps, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppShell, type AppShellBreakpoint, AppShellContent, type AppShellContentProps, AppShellHeader, AppShellMain, AppShellMobileHeader, type AppShellProps, AppShellSidebar, AutocompleteCombobox, type AutocompleteComboboxProps, type AutosaveStatus, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, type AvatarProps, Badge, BadgeLink, type BadgeLinkProps, type BadgeProps, Breadcrumb, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, Breadcrumbs, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, Collapsible, CollapsibleContent, type CollapsibleContentProps, type CollapsibleProps, CollapsibleTrigger, type CollapsibleTriggerProps, Combobox, ComboboxContent, ComboboxInput, ComboboxItem, ComboboxList, Command, CommandContent, CommandInput, CommandItem, CommandList, ConfirmDialog, type ConfirmDialogProps, DangerZone, type DangerZoneProps, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogProps, DialogRoot, type DialogRootProps, DialogTitle, DialogTrigger, type DialogTriggerProps, DocPreview, type DocPreviewProps, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, type DrawerProps, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, type DropdownMenuProps, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle, Field, FieldContent, FieldDescription, FieldError, type FieldErrorProps, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FormFeedback, type FormFeedbackProps, type FormFeedbackState, FormRow, type FormRowProps, HighlightMatch, IconButton, type IconButtonProps, Input, InputGroup, InputGroupAddon, InputGroupButton, type InputGroupButtonProps, InputGroupInput, InputGroupText, InputGroupTextarea, type InputProps, KanbanColumn, KanbanColumnBody, KanbanColumnHeader, type KanbanColumnSize, KanbanColumnTitle, KanbanEmpty, KanbanViewport, Kbd, KbdGroup, Label, type LabelProps, LinkButton, type LinkButtonProps, LoadingOverlay, Menu, MenuContent, MenuItem, MenuTrigger, MetricCard, type MetricCardProps, OtpInput, type OtpInputProps, PageHeader, PageHeaderActions, PageHeaderDescription, PageHeaderHeading, PageHeaderTitle, Pagination, type PaginationProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, QuantityInput, type QuantityInputProps, Select, SelectContent, SelectItem, SelectList, SelectTrigger, SelectValue, Separator, type SeparatorProps, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarContext, type SidebarContextValue, SidebarFooter, SidebarGroup, SidebarHeader, SidebarItem, type SidebarItemProps, SidebarMore, SidebarProvider, SidebarRail, SidebarSearch, SidebarSeparator, SidebarTrigger, Skeleton, SubmitButton, type SubmitButtonProps, Switch, type SwitchProps, type TabPanelProps, type TabProps, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsPanels, type TabsProps, TabsTrigger, type TextMatchPart, Textarea, type TextareaProps, Toast, type ToastAction, type ToastData, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, ToastViewport, Toaster, Toolbar, ToolbarGroup, ToolbarSpacer, Tooltip, TooltipContent, type TooltipProps, TooltipTrigger, type UseAutosaveOptions, type UseFormDirtyResult, actionRipple, alertVariants, badgeVariants, buttonGroupVariants, buttonVariants, cn, emptyStateMediaVariants, fieldVariants, formSnapshot, getTextMatchParts, inputGroupAddonVariants, toast, useAutosave, useDebouncedValue, useFormDirty, useFormFeedback, useSidebar, useToast };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, ActiveFilters, Alert, AlertAction, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, type AlertDialogContentProps, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, type AlertDialogProps, AlertDialogTitle, AlertDialogTrigger, type AlertProps, AlertTitle, AppShell, type AppShellBreakpoint, AppShellContent, type AppShellContentProps, AppShellHeader, AppShellMain, AppShellMobileHeader, type AppShellProps, AppShellSidebar, type AsyncActionStatus, AsyncBoundary, AutocompleteCombobox, type AutocompleteComboboxProps, type AutosaveStatus, Avatar, AvatarBadge, AvatarFallback, AvatarGroup, AvatarGroupCount, AvatarImage, type AvatarProps, Badge, BadgeLink, type BadgeLinkProps, type BadgeProps, Breadcrumb, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, Breadcrumbs, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, type ButtonProps, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, type CardProps, CardTitle, Checkbox, type CheckboxProps, type ClipboardStatus, Collapsible, CollapsibleContent, type CollapsibleContentProps, type CollapsibleProps, CollapsibleTrigger, type CollapsibleTriggerProps, Combobox, ComboboxContent, ComboboxInput, ComboboxItem, ComboboxList, Command, CommandContent, CommandInput, CommandItem, CommandList, ConfirmDialog, type ConfirmDialogProps, CopyButton, type CopyButtonProps, DangerZone, type DangerZoneProps, DataViewState, DataViewStateActions, DataViewStateDescription, DataViewStateTitle, DescriptionDetails, DescriptionItem, DescriptionList, DescriptionTerm, DetailDrawer, DetailDrawerBody, DrawerFooter as DetailDrawerFooter, DrawerHeader as DetailDrawerHeader, Dialog, DialogClose, DialogContent, type DialogContentProps, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, type DialogProps, DialogRoot, type DialogRootProps, DialogTitle, DialogTrigger, type DialogTriggerProps, DocPreview, type DocPreviewProps, Drawer, DrawerClose, DrawerContent, type DrawerContentProps, DrawerDescription, DrawerFooter, DrawerHeader, type DrawerProps, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, type DropdownMenuProps, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, EmptyState, EmptyStateContent, EmptyStateDescription, EmptyStateHeader, EmptyStateMedia, EmptyStateTitle, ErrorBoundary, type ErrorBoundaryProps, type ErrorFallbackProps, ErrorState, ErrorStateActions, ErrorStateDescription, ErrorStateIcon, ErrorStateTitle, Field, FieldContent, FieldDescription, FieldError, type FieldErrorProps, FieldGroup, FieldLabel, FieldLegend, type FieldProps, FieldSeparator, FieldSet, FieldTitle, FilterBar, FilterChip, FilterGroup, FormFeedback, type FormFeedbackProps, type FormFeedbackState, FormRow, type FormRowProps, HighlightMatch, IconButton, type IconButtonProps, Input, InputGroup, InputGroupAddon, InputGroupButton, type InputGroupButtonProps, InputGroupInput, InputGroupText, InputGroupTextarea, type InputProps, KanbanColumn, KanbanColumnBody, KanbanColumnHeader, type KanbanColumnSize, KanbanColumnTitle, KanbanEmpty, KanbanViewport, Kbd, KbdGroup, Label, type LabelProps, LinkButton, type LinkButtonProps, LoadingOverlay, Menu, MenuContent, MenuItem, MenuTrigger, MetricCard, type MetricCardProps, MetricGrid, OtpInput, type OtpInputProps, PageHeader, PageHeaderActions, PageHeaderDescription, PageHeaderHeading, PageHeaderTitle, Pagination, type PaginationProps, Popover, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, QuantityInput, type QuantityInputProps, type SearchParamPrimitive, type SearchParamUpdates, type SearchParamValue, type SearchParamsInput, type SearchParamsRecord, SectionHeader, SectionHeaderActions, SectionHeaderDescription, SectionHeaderHeading, SectionHeaderTitle, Select, SelectContent, SelectItem, SelectList, SelectTrigger, SelectValue, SelectionToolbar, Separator, type SeparatorProps, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, type SheetPrimitiveProps, SheetTitle, SheetTrigger, type SheetTriggerPrimitiveProps, Sidebar, SidebarContent, SidebarContext, type SidebarContextValue, SidebarFooter, SidebarGroup, SidebarHeader, SidebarItem, type SidebarItemProps, SidebarMore, SidebarProvider, SidebarRail, SidebarSearch, SidebarSeparator, SidebarTrigger, Skeleton, SubmitButton, type SubmitButtonProps, Switch, type SwitchProps, type TabPanelProps, type TabProps, Table, TableBody, TableCaption, TableCell, TableEmpty, TableFooter, TableHead, TableHeader, TableLoading, TableRow, TableToolbar, Tabs, TabsContent, TabsList, TabsPanels, type TabsProps, TabsTrigger, type TextMatchPart, Textarea, type TextareaProps, Toast, type ToastAction, type ToastData, type ToastOptions, type ToastPosition, ToastProvider, type ToastVariant, ToastViewport, Toaster, Toolbar, ToolbarGroup, ToolbarSpacer, Tooltip, TooltipContent, type TooltipProps, TooltipTrigger, type UseAutosaveOptions, type UseFormDirtyResult, actionRipple, alertVariants, badgeVariants, buttonGroupVariants, buttonVariants, cn, emptyStateMediaVariants, fieldVariants, formSnapshot, getTextMatchParts, inputGroupAddonVariants, readSearchParam, readSearchParamArray, readSearchParamEnum, readSearchParamInt, toSearchParams, toast, updateSearchParams, useAsyncAction, useAutosave, useClipboard, useDebouncedValue, useFormDirty, useFormFeedback, useSidebar, useToast };