@dev-dga/react 0.6.0 → 0.8.0

package/dist/index.d.cts

@@ -2,8 +2,8 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as class_variance_authority_types from 'class-variance-authority/types';
 import { ReactNode } from 'react';
 import { VariantProps } from 'class-variance-authority';
-import { Checkbox as Checkbox$1, RadioGroup as RadioGroup$1, Switch as Switch$1, Select as Select$1, Avatar as Avatar$1, Tooltip as Tooltip$1, Dialog, Tabs as Tabs$1, Accordion as Accordion$1, Progress as Progress$1, DropdownMenu as DropdownMenu$1, Slider as Slider$1, Toggle as Toggle$1, ToggleGroup as ToggleGroup$1 } from 'radix-ui';
-import { Command } from 'cmdk';
+import { Checkbox as Checkbox$1, RadioGroup as RadioGroup$1, Switch as Switch$1, Select as Select$1, Avatar as Avatar$1, Tooltip as Tooltip$1, Dialog, Tabs as Tabs$1, Accordion as Accordion$1, Progress as Progress$1, DropdownMenu as DropdownMenu$1, Slider as Slider$1, Toggle as Toggle$1, ToggleGroup as ToggleGroup$1, Popover as Popover$1, ScrollArea as ScrollArea$1, Menubar as Menubar$1, Collapsible as Collapsible$1 } from 'radix-ui';
+import { Command as Command$1 } from 'cmdk';
 import { DgaTheme } from '@dev-dga/tokens';
 export { DgaTheme, PaletteName, ThemeColor } from '@dev-dga/tokens';
 import { ClassValue } from 'clsx';
@@ -13,6 +13,7 @@ declare const buttonVariants: (props?: ({
     size?: "sm" | "md" | "lg" | "icon" | "icon-sm" | null | undefined;
     fullWidth?: boolean | null | undefined;
     inverted?: boolean | null | undefined;
+    fab?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 interface ButtonProps extends React.ComponentProps<'button'>, VariantProps<typeof buttonVariants> {
     loading?: boolean;
@@ -37,7 +38,7 @@ interface ButtonProps extends React.ComponentProps<'button'>, VariantProps<typeo
      */
     asChild?: boolean;
 }
-declare function Button({ variant, size, fullWidth, inverted, loading, disabled, startIcon, endIcon, iconFlip, asChild, className, children, type, ...props }: ButtonProps): react_jsx_runtime.JSX.Element;
+declare function Button({ variant, size, fullWidth, inverted, fab, loading, disabled, startIcon, endIcon, iconFlip, asChild, className, children, type, ...props }: ButtonProps): react_jsx_runtime.JSX.Element;
 
 declare const inputVariants: (props?: ({
     size?: "sm" | "md" | "lg" | null | undefined;
@@ -520,11 +521,20 @@ interface TabsProps extends React.ComponentProps<typeof Tabs$1.Root>, VariantPro
 }
 interface TabsListProps extends React.ComponentProps<typeof Tabs$1.List>, VariantProps<typeof tabsListVariants> {
 }
-type TabsTriggerProps = React.ComponentProps<typeof Tabs$1.Trigger>;
+interface TabsTriggerProps extends React.ComponentProps<typeof Tabs$1.Trigger> {
+    /**
+     * Leading icon, rendered before the label in a decorative (`aria-hidden`)
+     * wrapper. Ignored when `asChild` is set — compose icons inside your own
+     * element in that mode.
+     */
+    startIcon?: ReactNode;
+    /** Trailing icon (e.g. a count/badge glyph). Same rules as `startIcon`. */
+    endIcon?: ReactNode;
+}
 type TabsContentProps = React.ComponentProps<typeof Tabs$1.Content>;
 declare function Tabs({ variant, size, className, ...props }: TabsProps): react_jsx_runtime.JSX.Element;
 declare function TabsList({ fullWidth, className, ...props }: TabsListProps): react_jsx_runtime.JSX.Element;
-declare function TabsTrigger({ className, ...props }: TabsTriggerProps): react_jsx_runtime.JSX.Element;
+declare function TabsTrigger({ className, startIcon, endIcon, children, asChild, ...props }: TabsTriggerProps): react_jsx_runtime.JSX.Element;
 declare function TabsContent({ className, ...props }: TabsContentProps): react_jsx_runtime.JSX.Element;
 
 declare const breadcrumbVariants: (props?: ({
@@ -704,13 +714,21 @@ type CircularProgressOwnProps = VariantProps<typeof circularProgressVariants> &
     max?: number;
     /** Stroke width in px. Defaults to 4 (sm) / 5 (md) / 6 (lg). */
     thickness?: number;
-    /** Render the percentage label inside the ring. */
+    /**
+     * Render the ring as `segments` discrete arcs (a radial stepper) instead of a
+     * continuous arc. Pass an integer `>= 2`; values below that fall back to the
+     * continuous ring. The number of filled segments is `round(pct × segments)`,
+     * so `value={3} max={5} segments={5}` fills 3. Segmented mode is determinate —
+     * a `null` value renders 0 filled (no spinner).
+     */
+    segments?: number;
+    /** Render the label inside the ring (`%`, or `filled/segments` when segmented). */
     showLabel?: boolean;
     'aria-label'?: string;
     'aria-labelledby'?: string;
 };
 type CircularProgressProps = CircularProgressOwnProps & Omit<React.ComponentProps<'div'>, keyof CircularProgressOwnProps>;
-declare function CircularProgress({ value, max, size, color, thickness, showLabel, className, ...props }: CircularProgressProps): react_jsx_runtime.JSX.Element;
+declare function CircularProgress({ value, max, size, color, thickness, segments, showLabel, className, ...props }: CircularProgressProps): react_jsx_runtime.JSX.Element;
 
 declare const dropdownMenuVariants: (props?: ({
     size?: "sm" | "md" | null | undefined;
@@ -836,7 +854,7 @@ interface ComboboxProps extends VariantProps<typeof comboboxTriggerVariants> {
     /** `<ComboboxItem>` (+ optional Group / Separator) children. */
     children: ReactNode;
 }
-interface ComboboxItemProps extends Omit<React.ComponentProps<typeof Command.Item>, 'value' | 'onSelect'> {
+interface ComboboxItemProps extends Omit<React.ComponentProps<typeof Command$1.Item>, 'value' | 'onSelect'> {
     /** Stable value for filtering + selection. */
     value: string;
     /** Extra search terms cmdk should match against the input. */
@@ -846,11 +864,11 @@ interface ComboboxItemProps extends Omit<React.ComponentProps<typeof Command.Ite
     /** Optional select handler — fires alongside the root's `onValueChange`. */
     onSelect?: (value: string) => void;
 }
-interface ComboboxGroupProps extends React.ComponentProps<typeof Command.Group> {
+interface ComboboxGroupProps extends React.ComponentProps<typeof Command$1.Group> {
     /** Group heading rendered above its items. */
     heading?: ReactNode;
 }
-type ComboboxSeparatorProps = React.ComponentProps<typeof Command.Separator>;
+type ComboboxSeparatorProps = React.ComponentProps<typeof Command$1.Separator>;
 declare function Combobox({ value: controlledValue, defaultValue, onValueChange, open: controlledOpen, defaultOpen, onOpenChange, label, helperText, errorMessage, error, required, disabled, size, placeholder, searchPlaceholder, emptyMessage, getLabel, id: externalId, className, children, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, }: ComboboxProps): react_jsx_runtime.JSX.Element;
 declare function ComboboxItem({ value, keywords, disabled, onSelect, className, children, ...props }: ComboboxItemProps): react_jsx_runtime.JSX.Element;
 declare function ComboboxGroup({ className, heading, ...props }: ComboboxGroupProps): react_jsx_runtime.JSX.Element;
@@ -1125,6 +1143,686 @@ declare function DescriptionItem({ className, ...props }: DescriptionItemProps):
 declare function DescriptionTerm({ className, ...props }: DescriptionTermProps): react_jsx_runtime.JSX.Element;
 declare function DescriptionDetails({ className, ...props }: DescriptionDetailsProps): react_jsx_runtime.JSX.Element;
 
+declare const emptyStateVariants: (props?: ({
+    variant?: "search" | "error" | "default" | "success" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface EmptyStateProps extends Omit<React.ComponentProps<'div'>, 'title'>, VariantProps<typeof emptyStateVariants> {
+    /**
+     * Leading media (icon or illustration). Pass `false` to hide the media.
+     * Defaults to a variant-appropriate icon. Ignored when `children` is set.
+     */
+    icon?: ReactNode | false;
+    /** Title. Ignored when `children` is set. */
+    title?: ReactNode;
+    /** Supporting description below the title. Ignored when `children` is set. */
+    description?: ReactNode;
+    /** Primary action, e.g. a `<Button>`. Ignored when `children` is set. */
+    action?: ReactNode;
+    /** Secondary action beside the primary one. Ignored when `children` is set. */
+    secondaryAction?: ReactNode;
+}
+type EmptyStateMediaProps = React.ComponentProps<'div'>;
+interface EmptyStateTitleProps extends React.ComponentProps<'h3'> {
+    /** Override the heading element (e.g. render an `<h2>` on full-page states). */
+    asChild?: boolean;
+}
+type EmptyStateDescriptionProps = React.ComponentProps<'p'> & {
+    asChild?: boolean;
+};
+type EmptyStateActionsProps = React.ComponentProps<'div'> & {
+    asChild?: boolean;
+};
+declare function EmptyState({ variant, size, icon, title, description, action, secondaryAction, className, children, ...props }: EmptyStateProps): react_jsx_runtime.JSX.Element;
+declare function EmptyStateMedia({ className, ...props }: EmptyStateMediaProps): react_jsx_runtime.JSX.Element;
+declare function EmptyStateTitle({ asChild, className, ...props }: EmptyStateTitleProps): react_jsx_runtime.JSX.Element;
+declare function EmptyStateDescription({ asChild, className, ...props }: EmptyStateDescriptionProps): react_jsx_runtime.JSX.Element;
+declare function EmptyStateActions({ asChild, className, ...props }: EmptyStateActionsProps): react_jsx_runtime.JSX.Element;
+
+declare const statVariants: (props?: ({
+    variant?: "flat" | "elevated" | "gradient" | "accent" | null | undefined;
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type ChangeVariant = 'text' | 'chip';
+type Trend = 'up' | 'down' | 'flat';
+type Sentiment = 'positive' | 'negative' | 'neutral';
+interface StatProps extends React.ComponentProps<'div'>, VariantProps<typeof statVariants> {
+    /** Small, muted label above the value. */
+    label?: ReactNode;
+    /** The metric, pre-formatted by the consumer (e.g. "3,204", "SAR 1.2M"). */
+    value?: ReactNode;
+    /** Change text — include the sign (e.g. "+12.5%") so AT conveys direction. */
+    change?: ReactNode;
+    /** Muted context beside the change (e.g. "vs last month"). */
+    changeLabel?: ReactNode;
+    /** Arrow direction: up → CaretUp, down → CaretDown, flat → Minus. */
+    trend?: Trend;
+    /** Change color. Omitted → derived from `trend`. Explicit always wins. */
+    sentiment?: Sentiment;
+    /**
+     * How the change renders: `'text'` (default — colored text + caret) or
+     * `'chip'` (the same, wrapped in a sentiment-tinted pill). Threaded to the
+     * inner `StatChange`.
+     */
+    changeVariant?: ChangeVariant;
+    /** Optional icon at the inline-end of the label row (decorative). */
+    icon?: ReactNode;
+}
+type StatLabelProps = React.ComponentProps<'div'>;
+type StatValueProps = React.ComponentProps<'div'>;
+type StatChartProps = React.ComponentProps<'div'>;
+interface StatChangeProps extends React.ComponentProps<'div'> {
+    trend?: Trend;
+    sentiment?: Sentiment;
+    /** `'chip'` wraps the change in a sentiment-tinted pill. Defaults to `'text'`. */
+    variant?: ChangeVariant;
+}
+declare function Stat({ variant, size, label, value, change, changeLabel, trend, sentiment, changeVariant, icon, className, children, ...props }: StatProps): react_jsx_runtime.JSX.Element;
+declare function StatLabel({ className, ...props }: StatLabelProps): react_jsx_runtime.JSX.Element;
+declare function StatValue({ className, ...props }: StatValueProps): react_jsx_runtime.JSX.Element;
+/**
+ * Styled slot for a consumer-supplied sparkline / mini-chart. The library ships
+ * no charting dependency — drop your own `<svg>`/chart in here and it gets a
+ * consistent height + spacing, stretched to the tile width.
+ */
+declare function StatChart({ className, ...props }: StatChartProps): react_jsx_runtime.JSX.Element;
+declare function StatChange({ trend, sentiment, variant, className, children, ...props }: StatChangeProps): react_jsx_runtime.JSX.Element;
+
+declare const statGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+    gap?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface StatGroupProps extends React.ComponentProps<'div'>, VariantProps<typeof statGroupVariants> {
+    /**
+     * Fixed column count for the horizontal grid (collapses to one column on
+     * narrow screens). Omit for an auto-fit responsive grid.
+     */
+    columns?: number;
+}
+declare function StatGroup({ orientation, gap, columns, className, style, ...props }: StatGroupProps): react_jsx_runtime.JSX.Element;
+
+declare const popoverContentVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type PopoverProps = React.ComponentProps<typeof Popover$1.Root>;
+type PopoverTriggerProps = React.ComponentProps<typeof Popover$1.Trigger>;
+type PopoverAnchorProps = React.ComponentProps<typeof Popover$1.Anchor>;
+interface PopoverContentProps extends Omit<React.ComponentProps<typeof Popover$1.Content>, 'asChild'>, VariantProps<typeof popoverContentVariants> {
+    /** Show a small arrow pointing at the trigger. Defaults to false. */
+    arrow?: boolean;
+}
+interface PopoverCloseProps extends React.ComponentProps<typeof Popover$1.Close> {
+    /**
+     * Localized label for the default corner-X button. Only used when no
+     * `children` (and no `asChild`) are provided. Defaults to `"Close"`.
+     */
+    closeLabel?: string;
+}
+declare function Popover(props: PopoverProps): react_jsx_runtime.JSX.Element;
+declare function PopoverTrigger({ className, ...props }: PopoverTriggerProps): react_jsx_runtime.JSX.Element;
+declare function PopoverAnchor(props: PopoverAnchorProps): react_jsx_runtime.JSX.Element;
+declare function PopoverContent({ size, arrow, sideOffset, className, children, ...props }: PopoverContentProps): react_jsx_runtime.JSX.Element;
+declare function PopoverClose({ className, children, closeLabel, asChild, ...props }: PopoverCloseProps): react_jsx_runtime.JSX.Element;
+
+interface SidebarContextValue {
+    /** Desktop collapse state, derived from `open`. */
+    state: 'expanded' | 'collapsed';
+    /** Desktop expanded (true) / collapsed-to-rail (false). */
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    /** Mobile off-canvas drawer open state. */
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    /** True below the provider's `mobileBreakpoint`. */
+    isMobile: boolean;
+    /** Toggles `openMobile` on mobile, else `open`. */
+    toggleSidebar: () => void;
+}
+declare function useSidebar(): SidebarContextValue;
+
+interface SidebarProviderProps extends React.ComponentProps<'div'> {
+    /** Uncontrolled initial desktop state. Default true (expanded). */
+    defaultOpen?: boolean;
+    /** Controlled desktop open state. */
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /** Viewport width (px) below which the mobile Drawer engages. Default 768. */
+    mobileBreakpoint?: number;
+    /** Register Cmd/Ctrl+B to toggle. Default true. */
+    keyboardShortcut?: boolean;
+}
+declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange, mobileBreakpoint, keyboardShortcut, className, style, children, ...props }: SidebarProviderProps): react_jsx_runtime.JSX.Element;
+interface SidebarProps extends React.ComponentProps<'div'> {
+    variant?: 'sidebar' | 'floating' | 'inset';
+    collapsible?: 'icon' | 'offcanvas' | 'none';
+    /** Logical side; flips with dir. Default 'start'. */
+    side?: 'start' | 'end';
+}
+declare function Sidebar({ variant, collapsible, side, className, children, 'aria-label': ariaLabel, ...props }: SidebarProps): react_jsx_runtime.JSX.Element;
+interface SidebarTriggerProps extends React.ComponentProps<'button'> {
+    asChild?: boolean;
+}
+declare function SidebarTrigger({ asChild, className, onClick, children, 'aria-label': ariaLabel, ...props }: SidebarTriggerProps): react_jsx_runtime.JSX.Element;
+declare function SidebarRail({ className, 'aria-label': ariaLabel, ...props }: React.ComponentProps<'button'>): react_jsx_runtime.JSX.Element;
+interface SidebarInsetProps extends React.ComponentProps<'main'> {
+    asChild?: boolean;
+}
+declare function SidebarInset({ asChild, className, ...props }: SidebarInsetProps): react_jsx_runtime.JSX.Element;
+type SidebarSectionProps = React.ComponentProps<'div'> & {
+    asChild?: boolean;
+};
+declare function SidebarHeader({ asChild, className, ...props }: SidebarSectionProps): react_jsx_runtime.JSX.Element;
+declare function SidebarContent({ asChild, className, ...props }: SidebarSectionProps): react_jsx_runtime.JSX.Element;
+declare function SidebarFooter({ asChild, className, ...props }: SidebarSectionProps): react_jsx_runtime.JSX.Element;
+declare function SidebarSeparator({ className, ...props }: React.ComponentProps<'hr'>): react_jsx_runtime.JSX.Element;
+
+/**
+ * True when the viewport is narrower than `breakpoint`. SSR-safe: returns
+ * `false` until the mount effect runs, so the desktop layout renders first
+ * and the mobile Drawer (a client-only overlay) only engages after hydration.
+ */
+declare function useIsMobile(breakpoint?: number): boolean;
+
+type SidebarGroupDivProps = React.ComponentProps<'div'> & {
+    asChild?: boolean;
+};
+declare function SidebarGroup({ asChild, className, ...props }: SidebarGroupDivProps): react_jsx_runtime.JSX.Element;
+declare function SidebarGroupLabel({ asChild, className, ...props }: SidebarGroupDivProps): react_jsx_runtime.JSX.Element;
+interface SidebarGroupActionProps extends React.ComponentProps<'button'> {
+    asChild?: boolean;
+}
+declare function SidebarGroupAction({ asChild, className, ...props }: SidebarGroupActionProps): react_jsx_runtime.JSX.Element;
+declare function SidebarGroupContent({ asChild, className, ...props }: SidebarGroupDivProps): react_jsx_runtime.JSX.Element;
+
+declare function SidebarMenu({ className, ...props }: React.ComponentProps<'ul'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuItem({ className, ...props }: React.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
+declare const sidebarMenuButtonVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SidebarMenuButtonProps extends React.ComponentProps<'button'>, VariantProps<typeof sidebarMenuButtonVariants> {
+    asChild?: boolean;
+    isActive?: boolean;
+    /** Tooltip content shown only when the rail is collapsed (desktop). */
+    tooltip?: React.ReactNode;
+}
+declare function SidebarMenuButton({ asChild, isActive, size, tooltip, className, ...props }: SidebarMenuButtonProps): react_jsx_runtime.JSX.Element;
+interface SidebarMenuActionProps extends React.ComponentProps<'button'> {
+    asChild?: boolean;
+    /** Reveal the action only on row hover/focus (CSS-driven). */
+    showOnHover?: boolean;
+}
+declare function SidebarMenuAction({ asChild, showOnHover, className, ...props }: SidebarMenuActionProps): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuBadge({ className, ...props }: React.ComponentProps<'span'>): react_jsx_runtime.JSX.Element;
+interface SidebarMenuSkeletonProps extends React.ComponentProps<'div'> {
+    showIcon?: boolean;
+}
+declare function SidebarMenuSkeleton({ showIcon, className, ...props }: SidebarMenuSkeletonProps): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuSub({ className, ...props }: React.ComponentProps<'ul'>): react_jsx_runtime.JSX.Element;
+declare function SidebarMenuSubItem({ className, ...props }: React.ComponentProps<'li'>): react_jsx_runtime.JSX.Element;
+declare const sidebarMenuSubButtonVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface SidebarMenuSubButtonProps extends React.ComponentProps<'a'>, VariantProps<typeof sidebarMenuSubButtonVariants> {
+    asChild?: boolean;
+    isActive?: boolean;
+}
+declare function SidebarMenuSubButton({ asChild, isActive, size, className, ...props }: SidebarMenuSubButtonProps): react_jsx_runtime.JSX.Element;
+
+declare const scrollAreaVariants: (props?: ({
+    orientation?: "both" | "horizontal" | "vertical" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type ScrollAreaOrientation = 'vertical' | 'horizontal' | 'both';
+interface ScrollAreaProps extends Omit<React.ComponentProps<typeof ScrollArea$1.Root>, 'asChild' | 'orientation'>, Omit<VariantProps<typeof scrollAreaVariants>, 'orientation'> {
+    /** Which scrollbar(s) to render. Default `'vertical'`. */
+    orientation?: ScrollAreaOrientation;
+    /** Ref to the scrollable viewport — use for programmatic scrolling. */
+    viewportRef?: React.Ref<HTMLDivElement>;
+    /**
+     * Extra props forwarded to the viewport element (use `viewportRef` for the ref).
+     * To drop the extra tab stop when the scrolled content is itself fully focusable
+     * (e.g. a list of links), pass `viewportProps={{ tabIndex: -1 }}`.
+     */
+    viewportProps?: Omit<React.ComponentProps<'div'>, 'ref'>;
+    /** Names the scroll region. Warns (dev only) if neither this nor `aria-labelledby` is set. */
+    'aria-label'?: string;
+    'aria-labelledby'?: string;
+}
+/**
+ * Cross-browser, design-system-styled scroll container (wraps Radix ScrollArea).
+ *
+ * Set the bounding size (height / max-height) on the element via `className` /
+ * `style` — without a bounded size nothing scrolls, exactly like native overflow.
+ * The viewport is keyboard-focusable (`tabIndex={0}`) so keyboard users can scroll
+ * with the arrow / Page keys; pass `aria-label` to name the region.
+ *
+ * Does not support `asChild`: it is a structural wrapper composing several Radix
+ * parts, and the meaningful node — the viewport — is exposed via `viewportRef`.
+ */
+declare function ScrollArea({ className, orientation, type, scrollHideDelay, viewportRef, viewportProps, children, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ...props }: ScrollAreaProps): react_jsx_runtime.JSX.Element;
+
+declare const menubarContentVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+declare const menubarTriggerVariants: (props?: ({
+    variant?: "outline" | "default" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type MenubarProps = React.ComponentProps<typeof Menubar$1.Root>;
+declare function Menubar({ className, ...props }: MenubarProps): react_jsx_runtime.JSX.Element;
+type MenubarMenuProps = React.ComponentProps<typeof Menubar$1.Menu>;
+declare function MenubarMenu(props: MenubarMenuProps): react_jsx_runtime.JSX.Element;
+type MenubarTriggerProps = React.ComponentProps<typeof Menubar$1.Trigger> & VariantProps<typeof menubarTriggerVariants>;
+declare function MenubarTrigger({ variant, className, ...props }: MenubarTriggerProps): react_jsx_runtime.JSX.Element;
+type MenubarContentProps = React.ComponentProps<typeof Menubar$1.Content> & VariantProps<typeof menubarContentVariants>;
+declare function MenubarContent({ size, className, sideOffset, ...props }: MenubarContentProps): react_jsx_runtime.JSX.Element;
+type MenubarItemProps = React.ComponentProps<typeof Menubar$1.Item> & {
+    /** Style as a destructive action (red text, red hover). */
+    destructive?: boolean;
+    /** Icon rendered before the label. Sized to 1em. */
+    startIcon?: ReactNode;
+    /** Trailing text shown muted, e.g. a keyboard shortcut hint ("⌘K"). */
+    shortcut?: ReactNode;
+};
+declare function MenubarItem({ className, destructive, startIcon, shortcut, children, ...props }: MenubarItemProps): react_jsx_runtime.JSX.Element;
+type MenubarCheckboxItemProps = React.ComponentProps<typeof Menubar$1.CheckboxItem>;
+declare function MenubarCheckboxItem({ className, children, onSelect, ...props }: MenubarCheckboxItemProps): react_jsx_runtime.JSX.Element;
+type MenubarRadioGroupProps = React.ComponentProps<typeof Menubar$1.RadioGroup>;
+declare function MenubarRadioGroup(props: MenubarRadioGroupProps): react_jsx_runtime.JSX.Element;
+type MenubarRadioItemProps = React.ComponentProps<typeof Menubar$1.RadioItem>;
+declare function MenubarRadioItem({ className, children, onSelect, ...props }: MenubarRadioItemProps): react_jsx_runtime.JSX.Element;
+type MenubarLabelProps = React.ComponentProps<typeof Menubar$1.Label>;
+declare function MenubarLabel({ className, ...props }: MenubarLabelProps): react_jsx_runtime.JSX.Element;
+type MenubarSeparatorProps = React.ComponentProps<typeof Menubar$1.Separator>;
+declare function MenubarSeparator({ className, ...props }: MenubarSeparatorProps): react_jsx_runtime.JSX.Element;
+type MenubarGroupProps = React.ComponentProps<typeof Menubar$1.Group>;
+declare function MenubarGroup(props: MenubarGroupProps): react_jsx_runtime.JSX.Element;
+type MenubarSubProps = React.ComponentProps<typeof Menubar$1.Sub>;
+declare function MenubarSub(props: MenubarSubProps): react_jsx_runtime.JSX.Element;
+type MenubarSubTriggerProps = React.ComponentProps<typeof Menubar$1.SubTrigger> & {
+    startIcon?: ReactNode;
+};
+declare function MenubarSubTrigger({ className, startIcon, children, ...props }: MenubarSubTriggerProps): react_jsx_runtime.JSX.Element;
+type MenubarSubContentProps = React.ComponentProps<typeof Menubar$1.SubContent> & VariantProps<typeof menubarContentVariants>;
+declare function MenubarSubContent({ size, className, ...props }: MenubarSubContentProps): react_jsx_runtime.JSX.Element;
+
+declare const timelineVariants: (props?: ({
+    size?: "sm" | "md" | null | undefined;
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type TimelineStatus = 'default' | 'success' | 'error' | 'warning' | 'info';
+declare const timelineMarkerVariants: (props?: ({
+    status?: "error" | "default" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface TimelineProps extends React.ComponentProps<'ol'>, VariantProps<typeof timelineVariants> {
+}
+type TimelineItemProps = React.ComponentProps<'li'>;
+interface TimelineMarkerProps extends React.ComponentProps<'span'>, VariantProps<typeof timelineMarkerVariants> {
+}
+type TimelineContentProps = React.ComponentProps<'div'>;
+type TimelineTitleProps = React.ComponentProps<'span'>;
+type TimelineDescriptionProps = React.ComponentProps<'span'>;
+type TimelineTimeProps = React.ComponentProps<'time'>;
+declare function Timeline({ size, orientation, className, ...props }: TimelineProps): react_jsx_runtime.JSX.Element;
+declare function TimelineItem({ className, ...props }: TimelineItemProps): react_jsx_runtime.JSX.Element;
+declare function TimelineMarker({ status, className, children, ...props }: TimelineMarkerProps): react_jsx_runtime.JSX.Element;
+declare function TimelineContent({ className, ...props }: TimelineContentProps): react_jsx_runtime.JSX.Element;
+declare function TimelineTitle({ className, ...props }: TimelineTitleProps): react_jsx_runtime.JSX.Element;
+declare function TimelineDescription({ className, ...props }: TimelineDescriptionProps): react_jsx_runtime.JSX.Element;
+declare function TimelineTime({ className, ...props }: TimelineTimeProps): react_jsx_runtime.JSX.Element;
+
+declare const commandVariants: (props?: class_variance_authority_types.ClassProp | undefined) => string;
+type CommandProps = React.ComponentProps<typeof Command$1> & VariantProps<typeof commandVariants>;
+type CommandInputProps = React.ComponentProps<typeof Command$1.Input>;
+type CommandListProps = React.ComponentProps<typeof Command$1.List>;
+type CommandEmptyProps = React.ComponentProps<typeof Command$1.Empty>;
+type CommandGroupProps = React.ComponentProps<typeof Command$1.Group>;
+type CommandSeparatorProps = React.ComponentProps<typeof Command$1.Separator>;
+interface CommandItemProps extends Omit<React.ComponentProps<typeof Command$1.Item>, 'onSelect' | 'value'> {
+    /**
+     * Stable value for filtering + the `onSelect` payload. Required: cmdk would
+     * otherwise derive it from the rendered text, so a label / translation /
+     * icon change would silently change what `onSelect` receives.
+     */
+    value: string;
+    /** Leading icon — mirrors Menubar / DropdownMenu item icons. */
+    startIcon?: React.ReactNode;
+    /** Right-aligned keyboard hint, e.g. `"⌘P"` — mirrors Menubar / DropdownMenu. */
+    shortcut?: React.ReactNode;
+    /**
+     * Fires when the item is chosen (click / Enter). Receives the item's
+     * `value` (cmdk defaults it to the text content when `value` is omitted).
+     *
+     * Action-oriented: items run a command and don't track selection. Inside
+     * `CommandDialog` the consumer closes the dialog here, e.g.
+     * `onSelect={() => { setOpen(false); run(); }}`.
+     */
+    onSelect?: (value: string) => void;
+}
+interface CommandDialogProps extends Pick<React.ComponentProps<typeof Command$1>, 'filter' | 'shouldFilter' | 'loop'> {
+    /** Controlled open state. */
+    open?: boolean;
+    /** Initial open state when uncontrolled. */
+    defaultOpen?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    /**
+     * Key for the built-in document shortcut (with Cmd on macOS / Ctrl elsewhere).
+     * Defaults to `'k'` (⌘K / Ctrl+K). Pass `false` to bind no listener and wire
+     * your own. The modifier is fixed; only the key is configurable.
+     */
+    shortcut?: string | false;
+    /** Accessible name → visually-hidden `DialogTitle`. Defaults to `"Command palette"`. */
+    label?: React.ReactNode;
+    /** Optional visually-hidden `DialogDescription`. */
+    description?: React.ReactNode;
+    className?: string;
+    /** `CommandInput` + `CommandList` + groups / items. */
+    children: React.ReactNode;
+}
+/**
+ * Inline command palette (cmdk root). Pass cmdk's `label` to give the search
+ * input + listbox their accessible name — cmdk wires it via `aria-labelledby`,
+ * which wins over any `aria-label` on `CommandInput`. `CommandDialog` sets this
+ * for you from its `label`.
+ */
+declare function Command({ className, ...props }: CommandProps): react_jsx_runtime.JSX.Element;
+declare function CommandInput({ className, placeholder, 'aria-label': ariaLabel, ...props }: CommandInputProps): react_jsx_runtime.JSX.Element;
+declare function CommandList({ className, ...props }: CommandListProps): react_jsx_runtime.JSX.Element;
+declare function CommandEmpty({ className, ...props }: CommandEmptyProps): react_jsx_runtime.JSX.Element;
+declare function CommandGroup({ className, ...props }: CommandGroupProps): react_jsx_runtime.JSX.Element;
+declare function CommandSeparator({ className, 'aria-hidden': ariaHidden, ...props }: CommandSeparatorProps): react_jsx_runtime.JSX.Element;
+declare function CommandItem({ startIcon, shortcut, className, children, keywords, ...props }: CommandItemProps): react_jsx_runtime.JSX.Element;
+declare function CommandDialog({ open: controlledOpen, defaultOpen, onOpenChange, shortcut, label, description, className, filter, shouldFilter, loop, children, }: CommandDialogProps): react_jsx_runtime.JSX.Element;
+
+declare const tableVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    striped?: boolean | null | undefined;
+    divided?: boolean | null | undefined;
+    bordered?: boolean | null | undefined;
+    stickyHeader?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type Align = 'start' | 'center' | 'end';
+interface TableProps extends React.ComponentProps<'table'>, VariantProps<typeof tableVariants> {
+    /**
+     * Accessible name for the **scroll region** wrapping the table. Strongly
+     * recommended: a wide table scrolls horizontally, and a named, focusable
+     * region lets keyboard and screen-reader users find and scroll it. When
+     * provided, the wrapper becomes `role="region"` `tabindex="0"`; when omitted,
+     * it degrades to a plain scroll container and a dev warning fires.
+     * Note: this names the region, not the `<table>` — use `<TableCaption>` for
+     * the table's own name.
+     */
+    'aria-label'?: string;
+    /** Accessible name for the scroll region, by id reference. See `aria-label`. */
+    'aria-labelledby'?: string;
+    /**
+     * Caps the scroll region's block-size (number → px) so the body scrolls
+     * vertically within it. **Required for `stickyHeader` to engage** — sticky
+     * needs a height-constrained, scrollable ancestor; without it the region
+     * grows to content height and the header has nothing to stick to.
+     */
+    maxHeight?: number | string;
+}
+interface TableRowProps extends React.ComponentProps<'tr'> {
+    /** Visually highlights the row and sets `data-state="selected"`. Selection
+     *  semantics for assistive tech come from a checkbox in the cell (see the
+     *  DataTable recipe), not from the row. */
+    selected?: boolean;
+}
+interface TableHeadProps extends Omit<React.ComponentProps<'th'>, 'align' | 'onClick'> {
+    align?: Align;
+    /** Renders the column as sortable: wraps content in a button and sets
+     *  `aria-sort`. Sort *logic* is the consumer's — wire `onClick`. */
+    sortable?: boolean;
+    /** Current sort direction, or `false` when unsorted. */
+    sortDirection?: 'asc' | 'desc' | false;
+    /** Click handler bound to the sort button (only rendered when `sortable`). */
+    onClick?: React.MouseEventHandler<HTMLButtonElement>;
+    /**
+     * Visually-hidden, **caller-localized** cue appended to the sort button's
+     * accessible name (e.g. "activate to sort ascending"). `aria-sort` already
+     * conveys state, but a focused button otherwise announces only its column
+     * label; this adds the action cue. Kept as a prop (not hard-coded text) so
+     * the design system stays language-neutral — pass Arabic in RTL. Only used
+     * when `sortable`. Typed `string` (not `ReactNode`) so interactive content
+     * can't be hidden into a keyboard-reachable, invisible trap.
+     */
+    sortLabel?: string;
+}
+interface TableCellProps extends Omit<React.ComponentProps<'td'>, 'align'> {
+    align?: Align;
+}
+declare function Table({ size, striped, divided, bordered, stickyHeader, className, maxHeight, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ...props }: TableProps): react_jsx_runtime.JSX.Element;
+declare function TableHeader({ className, ...props }: React.ComponentProps<'thead'>): react_jsx_runtime.JSX.Element;
+declare function TableBody({ className, ...props }: React.ComponentProps<'tbody'>): react_jsx_runtime.JSX.Element;
+declare function TableFooter({ className, ...props }: React.ComponentProps<'tfoot'>): react_jsx_runtime.JSX.Element;
+declare function TableRow({ className, selected, ...props }: TableRowProps): react_jsx_runtime.JSX.Element;
+declare function TableHead({ className, align, sortable, sortDirection, sortLabel, onClick, children, ...props }: TableHeadProps): react_jsx_runtime.JSX.Element;
+declare function TableCell({ className, align, ...props }: TableCellProps): react_jsx_runtime.JSX.Element;
+declare function TableCaption({ className, ...props }: React.ComponentProps<'caption'>): react_jsx_runtime.JSX.Element;
+
+declare const inputOTPVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    error?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface InputOTPProps extends Omit<React.ComponentProps<'div'>, 'onChange' | 'defaultValue' | 'children'>, VariantProps<typeof inputOTPVariants> {
+    /** Number of slots. Defaults to 6 (Saudi SMS OTP length). */
+    length?: number;
+    /** Optional visual grouping; must sum to `length`. Default: one group. */
+    groupSizes?: number[];
+    /** Controlled value (the entered characters). */
+    value?: string;
+    /** Uncontrolled initial value. */
+    defaultValue?: string;
+    onChange?: (value: string) => void;
+    /** Fires when all `length` slots are filled. */
+    onComplete?: (value: string) => void;
+    /** Full-string regex the entered value must match. Defaults to digits-only. */
+    pattern?: string;
+    /** Render dots instead of characters (PIN entry). */
+    mask?: boolean;
+    /** Override the divider rendered between groups. */
+    separator?: ReactNode;
+    disabled?: boolean;
+    autoFocus?: boolean;
+    name?: string;
+    required?: boolean;
+    /** Visible field label, auto-associated to the input via `htmlFor`/`id`. */
+    label?: ReactNode;
+    /** Hint shown below the field. Hidden while an error message is showing. */
+    helperText?: ReactNode;
+    /** Message shown below the field when invalid. */
+    errorMessage?: ReactNode;
+    /** Marks the field invalid: sets `aria-invalid` and error styling. */
+    error?: boolean;
+}
+declare function InputOTP({ id: externalId, length, groupSizes, value, defaultValue, onChange, onComplete, pattern, mask, separator, size, disabled, autoFocus, name, required, label, helperText, errorMessage, error, className, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledby, ...props }: InputOTPProps): react_jsx_runtime.JSX.Element;
+
+declare const linkVariants: (props?: ({
+    variant?: "default" | "subtle" | "standalone" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface LinkProps extends React.ComponentProps<'a'>, VariantProps<typeof linkVariants> {
+    /**
+     * External link: appends a decorative ↗ icon and sets
+     * `rel="noopener noreferrer"` (merged with any consumer `rel`). `target` is
+     * left to the consumer — forcing `_blank` is an a11y opinion best owned by
+     * the caller.
+     */
+    external?: boolean;
+    /** Leading icon (standalone-friendly). Decorative — rendered `aria-hidden`. */
+    startIcon?: ReactNode;
+    /**
+     * Trailing icon. Decorative. When both `external` and `endIcon` are set, the
+     * consumer's `endIcon` wins (the auto ↗ is suppressed).
+     */
+    endIcon?: ReactNode;
+    /**
+     * Flip start/end icons horizontally in RTL (for directional arrows/chevrons).
+     * Does NOT apply to the auto `external` icon, which is RTL-neutral by design
+     * (a symbolic "leaves the site" cue, not a directional glyph).
+     */
+    iconFlip?: boolean;
+    /**
+     * Render as the single child element instead of an `<a>`. Lets consumers
+     * compose with framework routers (`<Link asChild><RouterLink to="…">…</RouterLink></Link>`).
+     * `Slottable` marks where the child's own content lands so the icons render
+     * around it. In this mode the href dev-warning is skipped — the consumer's
+     * element owns its attributes.
+     */
+    asChild?: boolean;
+}
+declare function Link({ variant, external, startIcon, endIcon, iconFlip, asChild, className, children, rel, ...props }: LinkProps): react_jsx_runtime.JSX.Element;
+
+interface SearchBoxProps extends Omit<InputProps, 'startAdornment' | 'endAdornment' | 'type'> {
+    /** Fires on Enter with the current query string. */
+    onSearch?: (value: string) => void;
+    /** Fires when the field is cleared (clear button or Escape). */
+    onClear?: () => void;
+    /** Show the clear (×) button while the field has a value. Default `true`. */
+    clearable?: boolean;
+    /** Accessible label for the clear button. Default `'Clear search'`. */
+    clearLabel?: string;
+}
+declare function SearchBox({ value, defaultValue, onChange, onKeyDown, onSearch, onClear, clearable, clearLabel, className, ...rest }: SearchBoxProps): react_jsx_runtime.JSX.Element;
+
+declare const listVariants: (props?: ({
+    variant?: "plain" | "bulleted" | "numbered" | "lettered" | null | undefined;
+    divided?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ListProps extends Omit<React.ComponentProps<'ul'>, 'type'>, VariantProps<typeof listVariants> {
+    /** Ordered variants (`numbered` / `lettered`) only — the ordinal to start from. */
+    start?: number;
+    /** Ordered variants only — count the ordinals down instead of up. */
+    reversed?: boolean;
+}
+type ListItemProps = React.ComponentProps<'li'>;
+type ListItemIconProps = React.ComponentProps<'span'>;
+type ListItemActionProps = React.ComponentProps<'div'>;
+interface ListItemContentProps extends React.ComponentProps<'div'> {
+    /**
+     * Primary line. Ignored if `children` is provided — `children` fully
+     * replaces the primary/secondary rendering (use one or the other).
+     */
+    primary?: ReactNode;
+    /** Secondary, de-emphasized line below the primary. Ignored if `children` is set. */
+    secondary?: ReactNode;
+}
+declare function List({ variant, divided, className, start, reversed, ...props }: ListProps): react_jsx_runtime.JSX.Element;
+declare function ListItem({ className, ...props }: ListItemProps): react_jsx_runtime.JSX.Element;
+declare function ListItemIcon({ className, ...props }: ListItemIconProps): react_jsx_runtime.JSX.Element;
+declare function ListItemContent({ primary, secondary, className, children, ...props }: ListItemContentProps): react_jsx_runtime.JSX.Element;
+declare function ListItemAction({ className, ...props }: ListItemActionProps): react_jsx_runtime.JSX.Element;
+
+declare const quoteVariants: (props?: ({
+    variant?: "default" | "plain" | "pullquote" | "testimonial" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface QuoteProps extends React.HTMLAttributes<HTMLElement>, VariantProps<typeof quoteVariants> {
+    /** The quote text. Rendered inside the `<blockquote>`. */
+    children?: ReactNode;
+    /** Show a decorative opening quotation mark (RTL-flipped). Defaults to `false`. */
+    quoteMark?: boolean;
+    /**
+     * Attribution media (e.g. an `<Avatar />`), rendered at the inline-start of the
+     * caption. Only shown alongside textual attribution (`author`/`byline`/`source`)
+     * — an avatar with no name is decorative-only and would leave the
+     * `<figcaption>` empty to assistive tech, so it is dropped on its own. Most
+     * natural on `testimonial`. Quote renders whatever node you pass — it takes no
+     * Avatar dependency.
+     */
+    avatar?: ReactNode;
+    /** Attribution name (e.g. the person quoted). Rendered as plain text. */
+    author?: ReactNode;
+    /**
+     * Secondary attribution line below the author — typically a job title or
+     * affiliation (e.g. "Product Manager, DGA"). Named `byline` rather than `role`
+     * so the native ARIA `role` attribute stays available on the root element.
+     */
+    byline?: ReactNode;
+    /** Title of the work, rendered in a real `<cite>` element. */
+    source?: ReactNode;
+    /**
+     * URL of the source document — set as the `cite=` **attribute** on the
+     * `<blockquote>` (machine-readable, not visible). For a visible work title use
+     * `source`.
+     */
+    cite?: string;
+}
+type QuoteContentProps = React.ComponentProps<'div'> & {
+    asChild?: boolean;
+};
+type QuoteCaptionProps = React.ComponentProps<'figcaption'> & {
+    asChild?: boolean;
+};
+type QuoteAuthorProps = React.ComponentProps<'span'> & {
+    asChild?: boolean;
+};
+type QuoteSourceProps = React.ComponentProps<'cite'> & {
+    asChild?: boolean;
+};
+/**
+ * Visual-only quote. Renders a `<blockquote>`; when textual attribution
+ * (`author`/`byline`/`source`) is present it is wrapped in a `<figure>` with a
+ * `<figcaption>` (a `<figcaption>` must not be empty, so a bare quote stays a
+ * lone `<blockquote>`).
+ *
+ * No `asChild` on the root: the `figure`/`blockquote`/`figcaption` composite has
+ * fixed semantics (documented carve-out, mirrors `EmptyState`/`Timeline`/`List`).
+ * The exported sub-parts carry `asChild` for hand-assembled compositions.
+ */
+declare function Quote({ variant, quoteMark, avatar, author, byline, source, cite, className, children, ...props }: QuoteProps): react_jsx_runtime.JSX.Element;
+/** Body wrapper inside the `<blockquote>`. */
+declare function QuoteContent({ asChild, className, ...props }: QuoteContentProps): react_jsx_runtime.JSX.Element;
+/** Caption (attribution) below the quote. Pair with a `<figure>` root. */
+declare function QuoteCaption({ asChild, className, ...props }: QuoteCaptionProps): react_jsx_runtime.JSX.Element;
+/** Attribution name. */
+declare function QuoteAuthor({ asChild, className, ...props }: QuoteAuthorProps): react_jsx_runtime.JSX.Element;
+/** Title of the cited work — a real `<cite>` element. */
+declare function QuoteSource({ asChild, className, ...props }: QuoteSourceProps): react_jsx_runtime.JSX.Element;
+
+type CollapsibleProps = React.ComponentProps<typeof Collapsible$1.Root>;
+type CollapsibleTriggerProps = React.ComponentProps<typeof Collapsible$1.Trigger>;
+type CollapsibleContentProps = React.ComponentProps<typeof Collapsible$1.Content>;
+declare function Collapsible({ className, ...props }: CollapsibleProps): react_jsx_runtime.JSX.Element;
+declare function CollapsibleTrigger({ className, ...props }: CollapsibleTriggerProps): react_jsx_runtime.JSX.Element;
+declare function CollapsibleContent({ className, children, ...props }: CollapsibleContentProps): react_jsx_runtime.JSX.Element;
+
+declare const tagInputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    error?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type NativeInputProps = Omit<React.ComponentProps<'input'>, 'value' | 'defaultValue' | 'onChange' | 'size'>;
+interface TagInputProps extends NativeInputProps, Omit<VariantProps<typeof tagInputVariants>, 'error'> {
+    /** Controlled tag list. */
+    value?: string[];
+    /** Uncontrolled initial tag list. */
+    defaultValue?: string[];
+    /** Fires with the full accepted tag set after every add/remove. */
+    onChange?: (tags: string[]) => void;
+    /** Visible field label, associated to the text input. */
+    label?: ReactNode;
+    /** Hint shown below the field. Hidden while an error message is showing. */
+    helperText?: ReactNode;
+    /** Message shown below the field when invalid. */
+    errorMessage?: ReactNode;
+    /** Marks the field invalid: sets `aria-invalid` and error styling. */
+    error?: boolean;
+    /** Caps the number of tags. Adds beyond the cap are no-ops. */
+    max?: number;
+    /** Allow the same tag more than once. Off → duplicates are rejected. */
+    allowDuplicates?: boolean;
+    /** Make duplicate detection case-sensitive. Default: case-insensitive. */
+    caseSensitive?: boolean;
+    /** Consumer gate run on each candidate tag. Return false to reject (draft kept). */
+    validate?: (tag: string, tags: string[]) => boolean;
+    /** Characters that commit the draft and split a paste. Newline always splits a paste. */
+    delimiters?: string[];
+    /** Badge variant used for the chips. */
+    chipVariant?: BadgeProps['variant'];
+    /** Accessible name for each chip's remove button. */
+    removeLabel?: (tag: string) => string;
+    /** Live-region text announced on add/remove (screen readers). */
+    formatAnnouncement?: (tag: string, action: 'add' | 'remove') => string;
+}
+declare function TagInput({ id: externalId, value, defaultValue, onChange, label, helperText, errorMessage, error, size, disabled, placeholder, max, allowDuplicates, caseSensitive, validate, delimiters, chipVariant, removeLabel, formatAnnouncement, className, ...props }: TagInputProps): react_jsx_runtime.JSX.Element;
+
 type DgaRootElement = 'div' | 'main' | 'nav' | 'section' | 'article' | 'aside' | 'header' | 'footer';
 interface DgaProviderProps {
     dir?: 'ltr' | 'rtl';
@@ -1236,4 +1934,4 @@ declare function FieldMessage({ id, variant, children }: FieldMessageProps): rea
 
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertSectionProps, AlertTitle, type AlertTitleProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarGroup, type AvatarGroupProps, AvatarImage, type AvatarImageProps, type AvatarProps, type AvatarStatus, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, Button, type ButtonProps, Card, CardContent, CardDescription, type CardDescriptionProps, CardFooter, CardHeader, CardImage, type CardImageProps, type CardProps, type CardSectionProps, CardTitle, type CardTitleProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, Combobox, ComboboxGroup, type ComboboxGroupProps, ComboboxItem, type ComboboxItemProps, type ComboboxProps, ComboboxSeparator, type ComboboxSeparatorProps, DatePicker, type DatePickerProps, DescriptionDetails, type DescriptionDetailsProps, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListProps, DescriptionTerm, type DescriptionTermProps, DgaProvider, type DgaProviderProps, Divider, type DividerProps, Drawer, DrawerBody, DrawerClose, type DrawerCloseProps, DrawerContent, type DrawerContentProps, DrawerDescription, type DrawerDescriptionProps, DrawerFooter, DrawerHeader, type DrawerProps, type DrawerSectionProps, DrawerTitle, type DrawerTitleProps, DrawerTrigger, type DrawerTriggerProps, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, type DropdownMenuGroupProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, type DropdownMenuProps, DropdownMenuRadioGroup, type DropdownMenuRadioGroupProps, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, type DropdownMenuSubProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type DropdownMenuTriggerProps, type FieldA11y, FieldMessage, type FieldMessageProps, type FileRejection, type FileStatus, FileUpload, type FileUploadProps, Input, type InputProps, Modal, ModalClose, type ModalCloseProps, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, ModalHeader, type ModalProps, type ModalSectionProps, ModalTitle, type ModalTitleProps, ModalTrigger, type ModalTriggerProps, NumberInput, type NumberInputProps, Pagination, PaginationContent, type PaginationContentProps, PaginationEllipsis, type PaginationEllipsisProps, PaginationItem, type PaginationItemProps, PaginationLink, type PaginationLinkProps, PaginationNext, type PaginationNextProps, PaginationPrevious, type PaginationPreviousProps, type PaginationProps, Progress, type ProgressProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, Rating, type RatingProps, type RejectionCode, Select, SelectItem, type SelectItemProps, type SelectProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderValue, Spinner, type SpinnerProps, Step, StepDescription, type StepDescriptionProps, StepIndicator, type StepIndicatorProps, type StepProps, type StepState, StepTitle, type StepTitleProps, Steps, type StepsProps, Switch, type SwitchProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, Textarea, type TextareaProps, type ToastAction, type ToastData, type ToastOptions, type ToastPosition, type ToastStore, type ToastVariant, Toaster, type ToasterProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipProps, TooltipTrigger, type TooltipTriggerProps, type UploadFile, type UseFieldA11yOptions, accordionVariants, alertVariants, avatarVariants, badgeVariants, breadcrumbVariants, buttonVariants, cardVariants, checkboxVariants, circularProgressVariants, cn, comboboxTriggerVariants, comboboxVariants, createToast, createToastStore, datePickerVariants, descriptionListVariants, dividerVariants, drawerVariants, dropdownMenuVariants, inputVariants, modalContentVariants, numberInputVariants, paginationLinkVariants, paginationVariants, progressVariants, radioGroupVariants, radioVariants, ratingVariants, selectTriggerVariants, skeletonVariants, sliderVariants, spinnerVariants, stepVariants, stepsVariants, switchVariants, tabsListVariants, tabsVariants, textareaVariants, toast, toastStore, toastVariants, toastViewportVariants, toggleGroupVariants, toggleVariants, tooltipContentVariants, useDga, useDir, useFieldA11y };
+export { Accordion, AccordionContent, type AccordionContentProps, AccordionItem, type AccordionItemProps, type AccordionProps, AccordionTrigger, type AccordionTriggerProps, Alert, AlertDescription, type AlertDescriptionProps, type AlertProps, type AlertSectionProps, AlertTitle, type AlertTitleProps, Avatar, AvatarFallback, type AvatarFallbackProps, AvatarGroup, type AvatarGroupProps, AvatarImage, type AvatarImageProps, type AvatarProps, type AvatarStatus, Badge, type BadgeProps, Breadcrumb, BreadcrumbEllipsis, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, Button, type ButtonProps, Card, CardContent, CardDescription, type CardDescriptionProps, CardFooter, CardHeader, CardImage, type CardImageProps, type CardProps, type CardSectionProps, CardTitle, type CardTitleProps, Checkbox, type CheckboxProps, CircularProgress, type CircularProgressProps, Collapsible, CollapsibleContent, type CollapsibleContentProps, type CollapsibleProps, CollapsibleTrigger, type CollapsibleTriggerProps, Combobox, ComboboxGroup, type ComboboxGroupProps, ComboboxItem, type ComboboxItemProps, type ComboboxProps, ComboboxSeparator, type ComboboxSeparatorProps, Command, CommandDialog, type CommandDialogProps, CommandEmpty, type CommandEmptyProps, CommandGroup, type CommandGroupProps, CommandInput, type CommandInputProps, CommandItem, type CommandItemProps, CommandList, type CommandListProps, type CommandProps, CommandSeparator, type CommandSeparatorProps, DatePicker, type DatePickerProps, DescriptionDetails, type DescriptionDetailsProps, DescriptionItem, type DescriptionItemProps, DescriptionList, type DescriptionListProps, DescriptionTerm, type DescriptionTermProps, DgaProvider, type DgaProviderProps, Divider, type DividerProps, Drawer, DrawerBody, DrawerClose, type DrawerCloseProps, DrawerContent, type DrawerContentProps, DrawerDescription, type DrawerDescriptionProps, DrawerFooter, DrawerHeader, type DrawerProps, type DrawerSectionProps, DrawerTitle, type DrawerTitleProps, DrawerTrigger, type DrawerTriggerProps, DropdownMenu, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuGroup, type DropdownMenuGroupProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, type DropdownMenuProps, DropdownMenuRadioGroup, type DropdownMenuRadioGroupProps, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, DropdownMenuSub, DropdownMenuSubContent, type DropdownMenuSubContentProps, type DropdownMenuSubProps, DropdownMenuSubTrigger, type DropdownMenuSubTriggerProps, DropdownMenuTrigger, type DropdownMenuTriggerProps, EmptyState, EmptyStateActions, type EmptyStateActionsProps, EmptyStateDescription, type EmptyStateDescriptionProps, EmptyStateMedia, type EmptyStateMediaProps, type EmptyStateProps, EmptyStateTitle, type EmptyStateTitleProps, type FieldA11y, FieldMessage, type FieldMessageProps, type FileRejection, type FileStatus, FileUpload, type FileUploadProps, Input, InputOTP, type InputOTPProps, type InputProps, Link, type LinkProps, List, ListItem, ListItemAction, type ListItemActionProps, ListItemContent, type ListItemContentProps, ListItemIcon, type ListItemIconProps, type ListItemProps, type ListProps, Menubar, MenubarCheckboxItem, type MenubarCheckboxItemProps, MenubarContent, type MenubarContentProps, MenubarGroup, type MenubarGroupProps, MenubarItem, type MenubarItemProps, MenubarLabel, type MenubarLabelProps, MenubarMenu, type MenubarMenuProps, type MenubarProps, MenubarRadioGroup, type MenubarRadioGroupProps, MenubarRadioItem, type MenubarRadioItemProps, MenubarSeparator, type MenubarSeparatorProps, MenubarSub, MenubarSubContent, type MenubarSubContentProps, type MenubarSubProps, MenubarSubTrigger, type MenubarSubTriggerProps, MenubarTrigger, type MenubarTriggerProps, Modal, ModalClose, type ModalCloseProps, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, ModalHeader, type ModalProps, type ModalSectionProps, ModalTitle, type ModalTitleProps, ModalTrigger, type ModalTriggerProps, NumberInput, type NumberInputProps, Pagination, PaginationContent, type PaginationContentProps, PaginationEllipsis, type PaginationEllipsisProps, PaginationItem, type PaginationItemProps, PaginationLink, type PaginationLinkProps, PaginationNext, type PaginationNextProps, PaginationPrevious, type PaginationPreviousProps, type PaginationProps, Popover, PopoverAnchor, type PopoverAnchorProps, PopoverClose, type PopoverCloseProps, PopoverContent, type PopoverContentProps, type PopoverProps, PopoverTrigger, type PopoverTriggerProps, Progress, type ProgressProps, Quote, QuoteAuthor, type QuoteAuthorProps, QuoteCaption, type QuoteCaptionProps, QuoteContent, type QuoteContentProps, type QuoteProps, QuoteSource, type QuoteSourceProps, Radio, RadioGroup, type RadioGroupProps, type RadioProps, Rating, type RatingProps, type RejectionCode, ScrollArea, type ScrollAreaOrientation, type ScrollAreaProps, SearchBox, type SearchBoxProps, Select, SelectItem, type SelectItemProps, type SelectProps, Sidebar, SidebarContent, type SidebarContextValue, SidebarFooter, SidebarGroup, SidebarGroupAction, type SidebarGroupActionProps, SidebarGroupContent, type SidebarGroupDivProps, SidebarGroupLabel, SidebarHeader, SidebarInset, type SidebarInsetProps, SidebarMenu, SidebarMenuAction, type SidebarMenuActionProps, SidebarMenuBadge, SidebarMenuButton, type SidebarMenuButtonProps, SidebarMenuItem, SidebarMenuSkeleton, type SidebarMenuSkeletonProps, SidebarMenuSub, SidebarMenuSubButton, type SidebarMenuSubButtonProps, SidebarMenuSubItem, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, type SidebarSectionProps, SidebarSeparator, SidebarTrigger, type SidebarTriggerProps, Skeleton, type SkeletonProps, Slider, type SliderProps, type SliderValue, Spinner, type SpinnerProps, Stat, StatChange, type StatChangeProps, StatChart, type StatChartProps, StatGroup, type StatGroupProps, StatLabel, type StatLabelProps, type StatProps, StatValue, type StatValueProps, Step, StepDescription, type StepDescriptionProps, StepIndicator, type StepIndicatorProps, type StepProps, type StepState, StepTitle, type StepTitleProps, Steps, type StepsProps, Switch, type SwitchProps, Table, TableBody, TableCaption, TableCell, type TableCellProps, TableFooter, TableHead, type TableHeadProps, TableHeader, type TableProps, TableRow, type TableRowProps, Tabs, TabsContent, type TabsContentProps, TabsList, type TabsListProps, type TabsProps, TabsTrigger, type TabsTriggerProps, TagInput, type TagInputProps, Textarea, type TextareaProps, Timeline, TimelineContent, type TimelineContentProps, TimelineDescription, type TimelineDescriptionProps, TimelineItem, type TimelineItemProps, TimelineMarker, type TimelineMarkerProps, type TimelineProps, type TimelineStatus, TimelineTime, type TimelineTimeProps, TimelineTitle, type TimelineTitleProps, type ToastAction, type ToastData, type ToastOptions, type ToastPosition, type ToastStore, type ToastVariant, Toaster, type ToasterProps, Toggle, ToggleGroup, ToggleGroupItem, type ToggleGroupItemProps, type ToggleGroupProps, type ToggleProps, Tooltip, TooltipContent, type TooltipContentProps, type TooltipProps, TooltipTrigger, type TooltipTriggerProps, type UploadFile, type UseFieldA11yOptions, accordionVariants, alertVariants, avatarVariants, badgeVariants, breadcrumbVariants, buttonVariants, cardVariants, checkboxVariants, circularProgressVariants, cn, comboboxTriggerVariants, comboboxVariants, commandVariants, createToast, createToastStore, datePickerVariants, descriptionListVariants, dividerVariants, drawerVariants, dropdownMenuVariants, emptyStateVariants, inputOTPVariants, inputVariants, linkVariants, listVariants, menubarContentVariants, menubarTriggerVariants, modalContentVariants, numberInputVariants, paginationLinkVariants, paginationVariants, popoverContentVariants, progressVariants, quoteVariants, radioGroupVariants, radioVariants, ratingVariants, scrollAreaVariants, selectTriggerVariants, sidebarMenuButtonVariants, sidebarMenuSubButtonVariants, skeletonVariants, sliderVariants, spinnerVariants, statGroupVariants, statVariants, stepVariants, stepsVariants, switchVariants, tableVariants, tabsListVariants, tabsVariants, tagInputVariants, textareaVariants, timelineMarkerVariants, timelineVariants, toast, toastStore, toastVariants, toastViewportVariants, toggleGroupVariants, toggleVariants, tooltipContentVariants, useDga, useDir, useFieldA11y, useIsMobile, useSidebar };