@chellaa/react 0.2.2 → 0.3.0

package/dist/index.d.cts

@@ -1171,6 +1171,123 @@ interface TextareaProps extends Omit<React.TextareaHTMLAttributes<HTMLTextAreaEl
  */
 declare const Textarea: React.ForwardRefExoticComponent<TextareaProps & React.RefAttributes<HTMLDivElement>>;
 
+interface FieldValidationError {
+    message: string;
+    code?: string;
+}
+type FieldValidationResult = {
+    valid: true;
+} | {
+    valid: false;
+    error: FieldValidationError;
+};
+type FieldValidator<TValue = unknown> = (value: TValue) => FieldValidationResult | Promise<FieldValidationResult>;
+interface UseFormValidationOptions<TValues extends Record<string, unknown>> {
+    /**
+     * Initial values of the form fields.
+     */
+    initialValues: TValues;
+    /**
+     * Field validators dictionary.
+     */
+    validators?: Partial<{
+        [K in keyof TValues]: FieldValidator<TValues[K]>;
+    }>;
+    /**
+     * When to trigger validation.
+     * @default "blur"
+     */
+    validateOn?: "change" | "blur" | "submit";
+    /**
+     * Callback invoked when form passes validation and is submitted.
+     */
+    onSubmit?: (values: TValues) => void | Promise<void>;
+    /**
+     * Automatically focus the first invalid field upon failed submission.
+     * @default true
+     */
+    focusFirstInvalid?: boolean;
+}
+interface UseFormValidationReturn<TValues extends Record<string, unknown>> {
+    /**
+     * Current field values.
+     */
+    values: TValues;
+    /**
+     * Current error messages by field key.
+     */
+    errors: Partial<Record<keyof TValues, string>>;
+    /**
+     * Whether field has been blurred/touched.
+     */
+    touched: Partial<Record<keyof TValues, boolean>>;
+    /**
+     * Whether field value has changed from its initial value.
+     */
+    dirty: Partial<Record<keyof TValues, boolean>>;
+    /**
+     * Whether asynchronous validation is currently pending for a field.
+     */
+    isValidating: Partial<Record<keyof TValues, boolean>>;
+    /**
+     * Whether the form submission callback is currently running.
+     */
+    isSubmitting: boolean;
+    /**
+     * True if there are no errors across all fields.
+     */
+    isValid: boolean;
+    /**
+     * Sets a single field value and triggers validation according to `validateOn`.
+     */
+    setValue: <K extends keyof TValues>(field: K, value: TValues[K]) => Promise<void>;
+    /**
+     * Sets the touched state for a field.
+     */
+    setTouched: <K extends keyof TValues>(field: K, isTouched?: boolean) => void;
+    /**
+     * Manually sets an error message on a field.
+     */
+    setError: <K extends keyof TValues>(field: K, error?: string | FieldValidationError) => void;
+    /**
+     * Clears the error on a field.
+     */
+    clearError: <K extends keyof TValues>(field: K) => void;
+    /**
+     * Validates a single field immediately, returning true if valid.
+     */
+    validateField: <K extends keyof TValues>(field: K) => Promise<boolean>;
+    /**
+     * Validates all fields immediately, returning true if all are valid.
+     */
+    validateAll: () => Promise<boolean>;
+    /**
+     * Form submit handler.
+     */
+    handleSubmit: (e?: React.FormEvent) => Promise<void>;
+    /**
+     * Resets form values and clears errors, touched, and dirty state.
+     */
+    reset: (nextValues?: Partial<TValues>) => void;
+    /**
+     * Convenience prop getter for FormField container integration.
+     */
+    getFieldProps: <K extends keyof TValues>(field: K) => {
+        name: string;
+        isInvalid: boolean;
+        errorMessage?: string;
+    };
+    /**
+     * Convenience prop getter for child input elements (Input, Textarea, etc.).
+     */
+    getInputProps: <K extends keyof TValues>(field: K) => {
+        name: string;
+        value: TValues[K];
+        onChange: (e: React.ChangeEvent<HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement> | TValues[K]) => void;
+        onBlur: () => void;
+    };
+}
+
 interface FormFieldProps extends React.HTMLAttributes<HTMLDivElement> {
     id?: string | undefined;
     name?: string | undefined;
@@ -1182,6 +1299,11 @@ interface FormFieldProps extends React.HTMLAttributes<HTMLDivElement> {
     isReadOnly?: boolean | undefined;
     error?: boolean | undefined;
     isInvalid?: boolean | undefined;
+    errorMessage?: string | FieldValidationError | undefined;
+    validationResult?: FieldValidationResult | undefined;
+    isValidating?: boolean | undefined;
+    isTouched?: boolean | undefined;
+    isDirty?: boolean | undefined;
     fullWidth?: boolean | undefined;
     asChild?: boolean | undefined;
     component?: React.ElementType | undefined;
@@ -1314,6 +1436,10 @@ interface FormFieldContextValue {
     disabled?: boolean | undefined;
     readOnly?: boolean | undefined;
     error?: boolean | undefined;
+    errorMessage?: string | undefined;
+    isValidating?: boolean | undefined;
+    isTouched?: boolean | undefined;
+    isDirty?: boolean | undefined;
     labelId: string;
     helperTextId: string;
     errorMessageId: string;
@@ -1329,6 +1455,12 @@ declare const FormFieldContext: React.Context<FormFieldContextValue | undefined>
  */
 declare function useFormField(): FormFieldContextValue | undefined;
 
+/**
+ * Hook providing framework-agnostic form state management, validation lifecycle,
+ * async race-condition safety, and accessible error/focus integration.
+ */
+declare function useFormValidation<TValues extends Record<string, unknown>>(options: UseFormValidationOptions<TValues>): UseFormValidationReturn<TValues>;
+
 type CheckboxSize = "sm" | "md" | "lg";
 type CheckboxColorScheme = "primary" | "secondary" | "success" | "error" | "warning" | "info" | "default";
 interface CheckboxOwnerState {
@@ -2223,6 +2355,8 @@ interface PopoverRootProps {
     initialFocusRef?: React.RefObject<HTMLElement | null>;
     /** Ref to the element that should receive focus when closed */
     returnFocusRef?: React.RefObject<HTMLElement | null>;
+    /** Optional custom reference element for floating positioning */
+    referenceElement?: React.RefObject<HTMLElement | null> | HTMLElement | null;
 }
 interface PopoverProps extends PopoverRootProps {
 }
@@ -2285,6 +2419,8 @@ interface PopoverContextValue {
     setHasPortalParent: (hasPortal: boolean) => void;
     initialFocusRef?: React.RefObject<HTMLElement | null> | undefined;
     returnFocusRef?: React.RefObject<HTMLElement | null> | undefined;
+    /** Whether Floating UI has calculated the initial floating coordinates */
+    isPositioned: boolean;
 }
 
 interface PopoverInternalContextValue extends PopoverContextValue {
@@ -2295,13 +2431,14 @@ interface PopoverInternalContextValue extends PopoverContextValue {
     floatingStyles: React.CSSProperties;
     middlewareData: MiddlewareData;
     arrowRef: React.RefObject<HTMLDivElement | null>;
+    hasCustomReference?: boolean;
 }
 declare function usePopoverContext(): PopoverInternalContextValue;
 /**
  * Popover.Root (or <Popover>) manages the open state and floating positioning context
  * for anchored rich interactive popup overlays.
  */
-declare function PopoverRoot({ children, isOpen: controlledOpen, defaultOpen, onOpenChange, placement, offset: offsetProp, trapFocus, closeOnEsc, initialFocusRef, returnFocusRef, }: PopoverRootProps): React.JSX.Element;
+declare function PopoverRoot({ children, isOpen: controlledOpen, defaultOpen, onOpenChange, placement, offset: offsetProp, trapFocus, closeOnEsc, initialFocusRef, returnFocusRef, referenceElement, }: PopoverRootProps): React.JSX.Element;
 declare namespace PopoverRoot {
     var displayName: string;
 }
@@ -2650,7 +2787,27 @@ declare const Avatar: AvatarComponent;
 declare const AvatarRoot: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLDivElement>>;
 
 type AccordionType = "single" | "multiple";
-type AccordionVariant = "outline" | "separated" | "flush";
+/**
+ * Visual styling variant for the Accordion.
+ * - "default" / "outline": Clean bordered continuous container with subtle dividers.
+ * - "separated": Individually spaced card-like items.
+ * - "borderless" / "flush": Minimal, divider-based appearance without outer container border.
+ * - "filled": Subtle background emphasis with soft surface tint and rounded panels.
+ */
+type AccordionVariant = "default" | "outline" | "separated" | "borderless" | "flush" | "filled";
+/**
+ * Density and typography scale for the Accordion.
+ * - "sm": Compact padding, 14px title font, 14px chevron icon.
+ * - "md": Balanced standard padding, 16px title font, 18px chevron icon.
+ * - "lg": Spacious padding, 18px title font, 20px chevron icon.
+ */
+type AccordionSize = "sm" | "md" | "lg";
+/**
+ * Placement of the expand/collapse indicator chevron relative to header text.
+ * - "end": Right-aligned (default).
+ * - "start": Left-aligned before title text.
+ */
+type AccordionIndicatorPosition = "start" | "end";
 interface AccordionSingleProps {
     /** Single expansion mode */
     type?: "single" | undefined;
@@ -2676,21 +2833,30 @@ interface AccordionMultipleProps {
     collapsible?: never | undefined;
 }
 type AccordionRootProps = (AccordionSingleProps | AccordionMultipleProps) & Omit<React.HTMLAttributes<HTMLDivElement>, "defaultValue"> & {
-    /** Visual style treatment: outline, separated, or flush */
+    /** Visual style treatment: default (outline), separated, borderless (flush), or filled */
     variant?: AccordionVariant | undefined;
+    /** Scale and density sizing: sm, md, or lg. Defaults to "md" */
+    size?: AccordionSize | undefined;
+    /** Default alignment of the expand/collapse indicator icon */
+    indicatorPosition?: AccordionIndicatorPosition | undefined;
     /** Whether all accordion items are globally disabled */
     isDisabled?: boolean | undefined;
-    /** Child Accordion.Item elements */
+    /** Child Accordion elements (Accordion.Item, Accordion.Actions, etc.) */
     children: React.ReactNode;
 };
 type AccordionProps = AccordionRootProps;
 interface AccordionContextValue {
     type: AccordionType;
     variant: AccordionVariant;
+    size: AccordionSize;
+    indicatorPosition: AccordionIndicatorPosition;
     collapsible: boolean;
     isDisabled: boolean;
     expandedValues: string[];
     toggleItem: (value: string) => void;
+    expandAll: () => void;
+    collapseAll: () => void;
+    registerItem: (value: string, isDisabled: boolean) => () => void;
     rootRef: React.RefObject<HTMLDivElement | null>;
 }
 interface AccordionItemProps extends React.HTMLAttributes<HTMLDivElement> {
@@ -2714,11 +2880,27 @@ interface AccordionHeaderProps extends React.HTMLAttributes<HTMLHeadingElement>
     /** Child Accordion.Trigger element */
     children: React.ReactNode;
 }
-interface AccordionTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+interface AccordionTriggerProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "title"> {
     /** Delegate button element rendering via Slot primitive */
     asChild?: boolean | undefined;
-    /** Trigger text and optional Accordion.Icon */
-    children: React.ReactNode;
+    /** Explicit title text or element */
+    title?: React.ReactNode | undefined;
+    /** Optional secondary subtitle or description below the title */
+    description?: React.ReactNode | undefined;
+    /** Optional decorative leading icon before title text */
+    leadingIcon?: React.ReactNode | undefined;
+    /** Optional trailing badge, count, or metadata element */
+    trailingBadge?: React.ReactNode | undefined;
+    /** Custom expand/collapse indicator icon or render function */
+    indicator?: React.ReactNode | ((props: {
+        isOpen: boolean;
+    }) => React.ReactNode) | undefined;
+    /** Alignment of the expand/collapse indicator icon for this trigger */
+    indicatorPosition?: AccordionIndicatorPosition | undefined;
+    /** Whether to suppress rendering the built-in expand/collapse indicator */
+    hideIndicator?: boolean | undefined;
+    /** Trigger content when not using title prop, or custom children */
+    children?: React.ReactNode | undefined;
 }
 interface AccordionContentProps extends React.HTMLAttributes<HTMLDivElement> {
     /** Panel body elements */
@@ -2727,13 +2909,23 @@ interface AccordionContentProps extends React.HTMLAttributes<HTMLDivElement> {
 interface AccordionIconProps extends React.SVGAttributes<SVGSVGElement> {
     className?: string | undefined;
 }
+interface AccordionActionsProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Helper buttons such as Accordion.ExpandAll and Accordion.CollapseAll */
+    children?: React.ReactNode | undefined;
+}
+interface AccordionExpandAllProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    children?: React.ReactNode | undefined;
+}
+interface AccordionCollapseAllProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    children?: React.ReactNode | undefined;
+}
 
 declare const AccordionContext: React.Context<AccordionContextValue | null>;
 declare const useAccordionContext: () => AccordionContextValue;
 declare const AccordionItemContext: React.Context<AccordionItemContextValue | null>;
 declare const useAccordionItemContext: () => AccordionItemContextValue;
 /**
- * Accordion.Root provides expansion state management and keyboard navigation for accordion items.
+ * Accordion.Root provides expansion state management, variant theming, and keyboard navigation.
  */
 declare const AccordionRoot: React.ForwardRefExoticComponent<AccordionRootProps & React.RefAttributes<HTMLDivElement>>;
 /**
@@ -2744,18 +2936,31 @@ declare const AccordionItem: React.ForwardRefExoticComponent<AccordionItemProps
  * Accordion.Header renders a semantic heading wrapper (h2 - h6) around the trigger button.
  */
 declare const AccordionHeader: React.ForwardRefExoticComponent<AccordionHeaderProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * Accordion.Icon renders a chevron SVG icon that smoothly rotates 180° when expanded.
+ */
+declare const AccordionIcon: React.ForwardRefExoticComponent<AccordionIconProps & React.RefAttributes<SVGSVGElement>>;
 /**
  * Accordion.Trigger renders the interactive button that toggles expansion.
+ * Supports structured titles, descriptions, leading icons, badges, and custom indicators.
  */
 declare const AccordionTrigger: React.ForwardRefExoticComponent<AccordionTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 /**
- * Accordion.Content renders the collapsible body region with CSS grid height transition.
+ * Accordion.Content renders the collapsible body region with pure CSS grid height transitions.
  */
 declare const AccordionContent: React.ForwardRefExoticComponent<AccordionContentProps & React.RefAttributes<HTMLDivElement>>;
 /**
- * Accordion.Icon renders a 16x16 chevron SVG icon that rotates 180° when expanded.
+ * Accordion.Actions provides an optional container for bulk operations (Expand All / Collapse All).
  */
-declare const AccordionIcon: React.ForwardRefExoticComponent<AccordionIconProps & React.RefAttributes<SVGSVGElement>>;
+declare const AccordionActions: React.ForwardRefExoticComponent<AccordionActionsProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * Accordion.ExpandAll triggers expansion of all eligible items in the accordion.
+ */
+declare const AccordionExpandAll: React.ForwardRefExoticComponent<AccordionExpandAllProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Accordion.CollapseAll triggers collapse of all expanded items in the accordion.
+ */
+declare const AccordionCollapseAll: React.ForwardRefExoticComponent<AccordionCollapseAllProps & React.RefAttributes<HTMLButtonElement>>;
 interface AccordionComponent extends React.ForwardRefExoticComponent<AccordionRootProps & React.RefAttributes<HTMLDivElement>> {
     Root: typeof AccordionRoot;
     Item: typeof AccordionItem;
@@ -2763,6 +2968,9 @@ interface AccordionComponent extends React.ForwardRefExoticComponent<AccordionRo
     Trigger: typeof AccordionTrigger;
     Content: typeof AccordionContent;
     Icon: typeof AccordionIcon;
+    Actions: typeof AccordionActions;
+    ExpandAll: typeof AccordionExpandAll;
+    CollapseAll: typeof AccordionCollapseAll;
 }
 declare const Accordion: AccordionComponent;
 
@@ -3075,6 +3283,10 @@ interface ComboboxInputProps extends Omit<React.InputHTMLAttributes<HTMLInputEle
     /** When true, delegates rendering to child element via Slot */
     asChild?: boolean | undefined;
 }
+interface ComboboxActionsProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** When true, delegates rendering to child element via Slot */
+    asChild?: boolean | undefined;
+}
 interface ComboboxTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
     /** When true, delegates rendering to child element via Slot */
     asChild?: boolean | undefined;
@@ -3160,6 +3372,8 @@ interface ComboboxContextValue {
     updateItemVisibility: (id: string, isVisible: boolean) => void;
     visibleItems: RegisteredItem[];
     filteredCount: number;
+    placeholder?: string | undefined;
+    isPositioned?: boolean | undefined;
 }
 
 declare function useComboboxContext(): ComboboxContextValue;
@@ -3167,6 +3381,7 @@ declare const useCombobox: typeof useComboboxContext;
 declare const ComboboxRoot: React.ForwardRefExoticComponent<ComboboxRootProps<string | string[]> & React.RefAttributes<HTMLDivElement>>;
 declare const ComboboxControl: React.ForwardRefExoticComponent<ComboboxControlProps & React.RefAttributes<HTMLDivElement>>;
 declare const ComboboxInput: React.ForwardRefExoticComponent<ComboboxInputProps & React.RefAttributes<HTMLInputElement>>;
+declare const ComboboxActions: React.ForwardRefExoticComponent<ComboboxActionsProps & React.RefAttributes<HTMLDivElement>>;
 declare const ComboboxTrigger: React.ForwardRefExoticComponent<ComboboxTriggerProps & React.RefAttributes<HTMLButtonElement>>;
 declare const ComboboxPortal: React.FC<ComboboxPortalProps>;
 declare const ComboboxContent: React.ForwardRefExoticComponent<ComboboxContentProps & React.RefAttributes<HTMLDivElement>>;
@@ -3180,6 +3395,7 @@ interface ComboboxComponent extends React.ForwardRefExoticComponent<ComboboxProp
     Root: typeof ComboboxRoot;
     Control: typeof ComboboxControl;
     Input: typeof ComboboxInput;
+    Actions: typeof ComboboxActions;
     Trigger: typeof ComboboxTrigger;
     Portal: typeof ComboboxPortal;
     Content: typeof ComboboxContent;
@@ -3224,6 +3440,7 @@ interface SelectContextValue<TValue extends string = string> {
         setFloating: (node: HTMLElement | null) => void;
     };
     floatingStyles: React.CSSProperties;
+    isPositioned?: boolean;
 }
 interface SelectRootProps<TValue extends string = string> {
     value?: TValue | undefined;
@@ -3695,4 +3912,1950 @@ declare const Table: React.ForwardRefExoticComponent<TableRootProps & React.RefA
     Td: React.ForwardRefExoticComponent<TableCellProps & React.RefAttributes<HTMLTableCellElement>>;
 };
 
-export { Accordion, AccordionContent, type AccordionContentProps, AccordionContext, type AccordionContextValue, AccordionHeader, type AccordionHeaderProps, AccordionIcon, type AccordionIconProps, AccordionItem, AccordionItemContext, type AccordionItemContextValue, type AccordionItemProps, type AccordionMultipleProps, type AccordionProps, AccordionRoot, type AccordionRootProps, type AccordionSingleProps, AccordionTrigger, type AccordionTriggerProps, type AccordionType, type AccordionVariant, Alert, AlertAction, type AlertActionProps, AlertBody, type AlertBodyProps, AlertCloseButton, type AlertCloseButtonProps, type AlertContextValue, AlertDescription, type AlertDescriptionProps, AlertIcon, type AlertIconProps, type AlertProps, AlertRoot, type AlertRootProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarContext, type AvatarContextValue, AvatarFallback, type AvatarFallbackProps, AvatarGroup, AvatarGroupContext, type AvatarGroupContextValue, type AvatarGroupProps, AvatarImage, type AvatarImageProps, type AvatarPlacement, type AvatarProps, AvatarRoot, type AvatarShape, type AvatarSize, type AvatarStatus, Badge, type BadgeColorScheme, type BadgeProps, type BadgeSize, type BadgeVariant, Box, type BoxProps, type BreakpointKey, type Breakpoints, Button, type ButtonColorScheme, ButtonGroup, ButtonGroupContext, type ButtonGroupContextValue, type ButtonGroupOrientation, type ButtonGroupProps, type ButtonLoadingPosition, type ButtonProps, type ButtonSize, type ButtonVariant, Card, CardActions, type CardActionsProps, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardMedia, type CardMediaProps, type CardOwnerState, type CardProps, CardRoot, type CardSize, CardTitle, type CardTitleProps, type CardVariant, Checkbox, type CheckboxColorScheme, CheckboxContext, type CheckboxContextValue, CheckboxGroup, type CheckboxGroupProps, type CheckboxOwnerState, type CheckboxProps, type CheckboxSize, type ChellaaTheme, Code, type CodeColorScheme, type CodeOwnerState, type CodeProps, type ColorMode, Combobox, ComboboxClear, type ComboboxClearProps, ComboboxContent, type ComboboxContentProps, type ComboboxContextValue, ComboboxControl, type ComboboxControlProps, ComboboxEmpty, type ComboboxEmptyProps, ComboboxGroup, ComboboxGroupLabel, type ComboboxGroupLabelProps, type ComboboxGroupProps, ComboboxInput, type ComboboxInputProps, ComboboxItem, type ComboboxItemProps, type ComboboxOption, ComboboxPortal, type ComboboxPortalProps, type ComboboxProps, ComboboxRoot, type ComboboxRootProps, type ComboboxSize, ComboboxTag, type ComboboxTagProps, ComboboxTrigger, type ComboboxTriggerProps, type ComboboxVariant, type ComponentOverride, type ComponentOverrideOptions, Container, type ContainerOwnerState, type ContainerProps, type DeepPartial, Dialog, DialogBody, type DialogBodyProps, DialogClose, type DialogCloseProps, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, type DialogPortalProps, DialogRoot, type DialogRootProps, type DialogSize, DialogTitle, type DialogTitleProps, DialogTrigger, type DialogTriggerProps, Divider, type DividerLineStyle, type DividerOrientation, type DividerOwnerState, type DividerProps, type DividerTextAlign, type DividerVariant, type ExtendedThemeContextValue, Flex, type FlexOwnerState, type FlexProps, FormErrorMessage, type FormErrorMessageProps, FormField, FormFieldContext, type FormFieldContextValue, type FormFieldProps, FormHelperText, type FormHelperTextProps, FormLabel, type FormLabelProps, Grid, type GridDirection, type GridOwnerState, type GridProps, type GridSize, type GridWrap, Heading, type HeadingLevel, type HeadingProps, type ImageLoadingStatus, Input, InputAdornment, type InputAdornmentProps, InputBase, type InputOwnerState, type InputProps, type InputSize, type InputVariant, Kbd, type KbdModifier, type KbdOwnerState, type KbdProps, type KbdSize, type KbdVariant, MODIFIER_SYMBOLS, Modal, type ModalBodyProps, type ModalCloseProps, type ModalContentProps, type ModalDescriptionProps, type ModalFooterProps, type ModalHeaderProps, type ModalOverlayProps, type ModalPortalProps, type ModalRootProps, type ModalSize, type ModalTitleProps, type ModalTriggerProps, Pagination, type PaginationActionProps, PaginationContext, type PaginationContextValue, PaginationEllipsis, type PaginationEllipsisProps, PaginationFirst, PaginationItem, type PaginationItemProps, PaginationJumper, type PaginationJumperProps, PaginationLast, PaginationList, type PaginationListProps, PaginationNext, PaginationPrev, type PaginationProps, PaginationRoot, type PaginationRootProps, type PaginationSize, PaginationSizeSelect, type PaginationSizeSelectProps, type PaginationVariant, type Palette, type PaletteColor, Paper, type PaperOwnerState, type PaperProps, type PaperVariant, Paragraph, type ParagraphProps, Popover, PopoverArrow, type PopoverArrowProps, PopoverBody, type PopoverBodyProps, PopoverClose, type PopoverCloseProps, PopoverContent, type PopoverContentProps, type PopoverContextValue, PopoverFooter, type PopoverFooterProps, PopoverHeader, type PopoverHeaderProps, type PopoverPlacement, PopoverPortal, type PopoverPortalProps, type PopoverProps, PopoverRoot, type PopoverRootProps, PopoverTitle, type PopoverTitleProps, PopoverTrigger, type PopoverTriggerProps, Portal, type PortalProps, Radio, type RadioColorScheme, RadioContext, type RadioContextValue, RadioGroup, type RadioGroupProps, type RadioOwnerState, type RadioProps, type RadioSize, type RegisteredItem, type ResponsiveValue, type RippleItem, Select, SelectContent, type SelectContentProps, type SelectContextValue, SelectGroup, type SelectGroupProps, SelectIcon, type SelectIconProps, SelectItem, SelectItemIndicator, type SelectItemIndicatorProps, type SelectItemProps, SelectItemText, type SelectItemTextProps, SelectLabel, type SelectLabelProps, type SelectOption, SelectPortal, type SelectPortalProps, SelectRoot, type SelectRootProps, SelectSeparator, type SelectSeparatorProps, type SelectSize, SelectTrigger, type SelectTriggerProps, SelectValue, type SelectValueProps, type SelectVariant, Slot, type SlotProps, Snackbar, type SnackbarProps, Stack, type StackDirection, type StackOwnerState, type StackProps, type StandardCSSProperties, type StyleInterpolation, type StyledOptions, Switch, type SwitchColorScheme, type SwitchLabelPlacement, type SwitchOwnerState, type SwitchProps, type SwitchSize, type SxObject, type SxPropValue, type SxProps, type SystemCssProperties, type SystemStyleProperties, Table, TableCaption, type TableCaptionProps, type TableCellProps, TableContainer, type TableContainerProps, type TableContextValue, type TableHeaderCellProps, TableRoot, type TableRootProps, type TableRowProps, type TableSize, TableTbody, type TableTbodyProps, TableTd, TableTfoot, type TableTfootProps, TableTh, TableThead, type TableTheadProps, TableTr, type TableVariant, Tabs, type TabsActivationMode, TabsContent, type TabsContentProps, TabsContext, type TabsContextValue, TabsIndicator, type TabsIndicatorProps, TabsList, type TabsListProps, type TabsOrientation, type TabsProps, TabsRoot, type TabsRootProps, type TabsSize, TabsTrigger, type TabsTriggerProps, type TabsVariant, Text, TextField, type TextFieldProps, type TextProps, type TextSize, Textarea, type TextareaOwnerState, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, type ThemeContextValue, type ThemeMode, type ThemeOptions, ThemeProvider, type ThemeProviderProps, ThemeScript, type ThemeScriptProps, Toast, ToastContext, ToastItem, type ToastOptions, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastRecord, type ToastStatus, Tooltip, type TooltipOwnerState, type TooltipPlacement, type TooltipProps, TouchRipple, type TouchRippleProps, type TouchRippleRef, type Transitions, type TypeAction, type TypeBackground, type TypeText, Typography, type TypographyAlign, type TypographyOwnerState, type TypographyProps, type TypographyStyle, type TypographyTheme, type TypographyVariant, type UseRippleOptions, type UseRippleReturn, type UseToastReturn, type ZIndex, breakpointKeys, createBreakpoints, createPalette, createShadows, createShouldForwardProp, createSpacing, createTheme, darkPalette, defaultBreakpoints, defaultDarkTheme, defaultShadows, defaultSpacing, defaultTheme, defaultTransitions, defaultTypography, defaultZIndex, getInitials, getPaginationRange, lightPalette, parseSx, resolveComponentOverrides, resolveTypographyColor, rootShouldForwardProp, styled, useAccordionContext, useAccordionItemContext, useAlertContext, useAvatarContext, useAvatarGroupContext, useButtonGroupContext, useCheckboxGroup, useCombobox, useComboboxContext, useFormField, usePaginationContext, usePopoverContext, useRadioGroup, useRipple, useSelectContext, useTabsContext, useTheme, useToast };
+type SpinnerSize = "xs" | "sm" | "md" | "lg" | "xl";
+type SpinnerColorScheme = "primary" | "neutral" | "success" | "danger" | "warning";
+interface SpinnerProps extends React.SVGAttributes<SVGSVGElement> {
+    /**
+     * The size dimension of the spinner.
+     * @default "md"
+     */
+    size?: SpinnerSize;
+    /**
+     * The semantic color scheme of the spinner.
+     * @default "primary"
+     */
+    colorScheme?: SpinnerColorScheme;
+    /**
+     * An accessible label for screen readers.
+     * When provided, sets `role="status"`. When omitted, spinner is marked `aria-hidden="true"`.
+     * @default "Loading..."
+     */
+    label?: string;
+    /**
+     * Stroke width thickness of the spinner head in viewBox units.
+     * @default 3
+     */
+    thickness?: number;
+}
+
+/**
+ * Spinner indicates indeterminate background activity or content loading.
+ *
+ * @example
+ * ```tsx
+ * <Spinner size="md" colorScheme="primary" label="Loading content..." />
+ * ```
+ */
+declare const Spinner: React.ForwardRefExoticComponent<SpinnerProps & React.RefAttributes<SVGSVGElement>>;
+
+type SkeletonVariant = "text" | "circular" | "rectangular" | "rounded";
+type SkeletonAnimation = "pulse" | "wave" | "none";
+interface SkeletonProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Visual shape of the skeleton placeholder.
+     * @default "text"
+     */
+    variant?: SkeletonVariant;
+    /**
+     * Explicit width dimension (number in pixels or CSS length string).
+     */
+    width?: string | number;
+    /**
+     * Explicit height dimension (number in pixels or CSS length string).
+     */
+    height?: string | number;
+    /**
+     * If true, renders the wrapped children instead of the skeleton placeholder.
+     * @default false
+     */
+    isLoaded?: boolean;
+    /**
+     * Animation style applied while loading.
+     * @default "pulse"
+     */
+    animation?: SkeletonAnimation;
+    /**
+     * Children to display when `isLoaded` is true.
+     */
+    children?: React.ReactNode;
+}
+
+/**
+ * Skeleton displays a placeholder preview of content while data is loading.
+ *
+ * @example
+ * ```tsx
+ * <Skeleton variant="circular" width={40} height={40} />
+ * <Skeleton variant="rectangular" width="100%" height={200} />
+ * <Skeleton isLoaded={!isLoading}><ProfileCard /></Skeleton>
+ * ```
+ */
+declare const Skeleton: React.ForwardRefExoticComponent<SkeletonProps & React.RefAttributes<HTMLDivElement>>;
+
+type ProgressVariant = "linear" | "circular";
+type ProgressSize = "xs" | "sm" | "md" | "lg";
+type ProgressColorScheme = "primary" | "success" | "warning" | "danger";
+interface ProgressProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Current progress value.
+     * If omitted or undefined, component renders in indeterminate mode.
+     */
+    value?: number;
+    /**
+     * The minimum value of the progress bar.
+     * @default 0
+     */
+    min?: number;
+    /**
+     * The maximum value of the progress bar.
+     * @default 100
+     */
+    max?: number;
+    /**
+     * Size dimension of the progress track.
+     * @default "md"
+     */
+    size?: ProgressSize;
+    /**
+     * Visual presentation variant.
+     * @default "linear"
+     */
+    variant?: ProgressVariant;
+    /**
+     * Semantic color scheme.
+     * @default "primary"
+     */
+    colorScheme?: ProgressColorScheme;
+    /**
+     * If true, displays diagonal stripes across the linear progress track.
+     * @default false
+     */
+    hasStripe?: boolean;
+    /**
+     * If true, animates the diagonal stripes.
+     * @default false
+     */
+    isAnimated?: boolean;
+    /**
+     * If true, displays a numeric percentage label.
+     * @default false
+     */
+    showValueLabel?: boolean;
+    /**
+     * Human-readable text representation of value for screen readers.
+     */
+    valueText?: string;
+}
+
+/**
+ * Progress communicates the status of a deterministic or indeterminate background process.
+ *
+ * @example
+ * ```tsx
+ * <Progress value={45} colorScheme="primary" />
+ * <Progress variant="circular" value={75} showValueLabel />
+ * <Progress variant="linear" hasStripe isAnimated />
+ * ```
+ */
+declare const Progress: React.ForwardRefExoticComponent<ProgressProps & React.RefAttributes<HTMLDivElement>>;
+
+interface DateRange {
+    startDate?: Date | null | undefined;
+    endDate?: Date | null | undefined;
+}
+interface CalendarProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * The currently selected date in controlled mode.
+     */
+    value?: Date | null | undefined;
+    /**
+     * The initial selected date in uncontrolled mode.
+     */
+    defaultValue?: Date | null | undefined;
+    /**
+     * Callback fired when a date is selected.
+     */
+    onValueChange?: ((date: Date) => void) | undefined;
+    /**
+     * If true, enables date range selection mode.
+     * @default false
+     */
+    isRange?: boolean | undefined;
+    /**
+     * The currently selected date range in controlled mode.
+     */
+    rangeValue?: DateRange | null | undefined;
+    /**
+     * The initial selected date range in uncontrolled mode.
+     */
+    defaultRangeValue?: DateRange | null | undefined;
+    /**
+     * Callback fired when date range changes.
+     */
+    onRangeChange?: ((range: DateRange) => void) | undefined;
+    /**
+     * Earliest selectable calendar date (inclusive).
+     */
+    minDate?: Date | null | undefined;
+    /**
+     * Latest selectable calendar date (inclusive).
+     */
+    maxDate?: Date | null | undefined;
+    /**
+     * Predicate callback to evaluate whether a given calendar date is disabled.
+     */
+    isDateDisabled?: ((date: Date) => boolean) | undefined;
+    /**
+     * Starting day of the week (0 = Sunday, 1 = Monday, 6 = Saturday).
+     * @default 0
+     */
+    firstDayOfWeek?: (0 | 1 | 6) | undefined;
+    /**
+     * BCP 47 locale tag used for localized month and weekday names.
+     * @default "en-US"
+     */
+    locale?: string | undefined;
+    /**
+     * Initial focused / visible date when `value` or `defaultValue` is unset.
+     * Defaults to current local date.
+     */
+    defaultFocusedDate?: Date | undefined;
+    /**
+     * Accessible label for the calendar grid table.
+     * @default "Calendar"
+     */
+    "aria-label"?: string | undefined;
+}
+
+/**
+ * Calendar provides an accessible WAI-ARIA APG compliant grid for selecting single calendar dates.
+ *
+ * @example
+ * ```tsx
+ * <Calendar value={selectedDate} onValueChange={setSelectedDate} />
+ * ```
+ */
+declare const Calendar: React.ForwardRefExoticComponent<CalendarProps & React.RefAttributes<HTMLDivElement>>;
+
+interface DatePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * The currently selected date in controlled mode.
+     */
+    value?: Date | null | undefined;
+    /**
+     * The initial selected date in uncontrolled mode.
+     */
+    defaultValue?: Date | null | undefined;
+    /**
+     * Callback fired when the selected date changes.
+     */
+    onValueChange?: ((date: Date | null) => void) | undefined;
+    /**
+     * Display date format string (e.g. "YYYY-MM-DD", "MM/DD/YYYY", "DD/MM/YYYY").
+     * @default "YYYY-MM-DD"
+     */
+    format?: string | undefined;
+    /**
+     * Placeholder text shown when input is empty. Defaults to the format pattern.
+     */
+    placeholder?: string | undefined;
+    /**
+     * Controlled open state of the calendar dropdown popover.
+     */
+    isOpen?: boolean | undefined;
+    /**
+     * Initial open state in uncontrolled mode.
+     * @default false
+     */
+    defaultOpen?: boolean | undefined;
+    /**
+     * Callback fired when the popover open state changes.
+     */
+    onOpenChange?: ((open: boolean) => void) | undefined;
+    /**
+     * Disables user interaction.
+     * @default false
+     */
+    isDisabled?: boolean | undefined;
+    /**
+     * Sets invalid error appearance for form validation.
+     * @default false
+     */
+    isInvalid?: boolean | undefined;
+    /**
+     * Whether to display a clear button when a date is selected.
+     * @default true
+     */
+    isClearable?: boolean | undefined;
+    /**
+     * Earliest selectable date (inclusive).
+     */
+    minDate?: Date | null | undefined;
+    /**
+     * Latest selectable date (inclusive).
+     */
+    maxDate?: Date | null | undefined;
+    /**
+     * Custom predicate callback to disable specific calendar dates.
+     */
+    isDateDisabled?: ((date: Date) => boolean) | undefined;
+    /**
+     * Starting day of the week (0 = Sunday, 1 = Monday, 6 = Saturday).
+     * @default 0
+     */
+    firstDayOfWeek?: (0 | 1 | 6) | undefined;
+    /**
+     * BCP 47 locale tag for formatting and localization.
+     * @default "en-US"
+     */
+    locale?: string | undefined;
+    /**
+     * Size token for input and calendar.
+     * @default "md"
+     */
+    size?: ("sm" | "md" | "lg") | undefined;
+    /**
+     * Accessible HTML id attribute for the underlying input.
+     */
+    id?: string | undefined;
+    /**
+     * Form field name attribute for form submission.
+     */
+    name?: string | undefined;
+    /**
+     * Accessible label for screen readers.
+     */
+    "aria-label"?: string | undefined;
+}
+
+/**
+ * DatePicker combines a formatted text input with an anchored calendar popover dropdown.
+ *
+ * @example
+ * ```tsx
+ * <DatePicker value={date} onValueChange={setDate} />
+ * <DatePicker format="MM/DD/YYYY" isClearable />
+ * ```
+ */
+declare const DatePicker: React.ForwardRefExoticComponent<DatePickerProps & React.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Chellaa React — Pure Date Utilities
+ * Zero-dependency, timezone-safe date manipulation strictly operating on local calendar dates.
+ */
+interface CalendarGridDay {
+    date: Date;
+    dayNumber: number;
+    isCurrentMonth: boolean;
+    isToday: boolean;
+    isPrevMonth: boolean;
+    isNextMonth: boolean;
+}
+/**
+ * Determines whether a given year is a leap year according to Gregorian calendar rules.
+ */
+declare function isLeapYear(year: number): boolean;
+/**
+ * Returns the number of days in the specified month (0-indexed: 0 = January, 11 = December).
+ */
+declare function getDaysInMonth(year: number, monthIndex: number): number;
+/**
+ * Creates a Date instance representing the given year, 0-indexed month, and day in local time.
+ */
+declare function createLocalDate(year: number, monthIndex: number, day: number): Date;
+/**
+ * Compares two dates by calendar day (ignoring time components).
+ */
+declare function isSameDay(a?: Date | null, b?: Date | null): boolean;
+/**
+ * Compares whether two dates fall in the same calendar month and year.
+ */
+declare function isSameMonth(a?: Date | null, b?: Date | null): boolean;
+/**
+ * Returns true if calendar day `a` is strictly before calendar day `b`.
+ */
+declare function isDateBefore(a: Date, b: Date): boolean;
+/**
+ * Returns true if calendar day `a` is strictly after calendar day `b`.
+ */
+declare function isDateAfter(a: Date, b: Date): boolean;
+/**
+ * Checks whether a date falls within inclusive min and max bounds.
+ */
+declare function isDateInRange(date: Date, minDate?: Date | null, maxDate?: Date | null): boolean;
+/**
+ * Adds or subtracts days from a given date safely.
+ */
+declare function addDays(date: Date, amount: number): Date;
+/**
+ * Adds or subtracts months from a given date, clamping the day to the last valid day of target month.
+ */
+declare function addMonths(date: Date, amount: number): Date;
+/**
+ * Adds or subtracts years from a given date, handling Feb 29 leap years properly.
+ */
+declare function addYears(date: Date, amount: number): Date;
+/**
+ * Generates an authoritative 6-row × 7-day (42 cells) calendar matrix for stable UI layout.
+ */
+declare function getCalendarGrid(year: number, monthIndex: number, firstDayOfWeek?: 0 | 1 | 6): CalendarGridDay[];
+/**
+ * Returns localized weekday abbreviations and full names ordered by `firstDayOfWeek`.
+ */
+declare function getWeekdayLabels(locale?: string, firstDayOfWeek?: 0 | 1 | 6): {
+    key: number;
+    narrow: string;
+    short: string;
+    long: string;
+}[];
+/**
+ * Returns localized month name.
+ */
+declare function getMonthLabel(year: number, monthIndex: number, locale?: string, style?: "long" | "short"): string;
+/**
+ * Formats a local date without UTC shifts.
+ */
+declare function formatLocalDate(date?: Date | null, format?: string, locale?: string): string;
+/**
+ * Parses user input strings into a valid local Date or returns null.
+ */
+declare function parseLocalDate(str?: string | null): Date | null;
+
+type DropdownMenuSide = "top" | "bottom" | "left" | "right";
+type DropdownMenuAlign = "start" | "center" | "end";
+interface DropdownMenuRootProps {
+    /** Controlled open state */
+    open?: boolean;
+    /** Uncontrolled initial open state */
+    defaultOpen?: boolean;
+    /** Callback fired when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Whether the menu is modal (blocks outside pointer interaction) */
+    modal?: boolean;
+    children?: React.ReactNode;
+}
+interface DropdownMenuTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+interface DropdownMenuContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    side?: DropdownMenuSide;
+    align?: DropdownMenuAlign;
+    sideOffset?: number;
+    alignOffset?: number;
+    collisionPadding?: number;
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+interface DropdownMenuItemProps extends React.HTMLAttributes<HTMLDivElement> {
+    disabled?: boolean;
+    inset?: boolean;
+    onSelect?: () => void;
+    closeOnSelect?: boolean;
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+interface DropdownMenuCheckboxItemProps extends Omit<DropdownMenuItemProps, "onSelect"> {
+    checked?: boolean;
+    defaultChecked?: boolean;
+    onCheckedChange?: (checked: boolean) => void;
+}
+interface DropdownMenuRadioGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    children?: React.ReactNode;
+}
+interface DropdownMenuRadioItemProps extends DropdownMenuItemProps {
+    value: string;
+}
+interface DropdownMenuSeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+interface DropdownMenuLabelProps extends React.HTMLAttributes<HTMLDivElement> {
+    inset?: boolean;
+}
+
+interface MenuItemRecord {
+    id: string;
+    ref: React.RefObject<HTMLElement | null>;
+    disabled: boolean;
+    textValue: string;
+}
+interface DropdownMenuContextValue {
+    isOpen: boolean;
+    setIsOpen: (open: boolean) => void;
+    triggerRef: React.MutableRefObject<HTMLElement | null>;
+    contentRef: React.MutableRefObject<HTMLDivElement | null>;
+    registerItem: (item: MenuItemRecord) => () => void;
+    activeIndex: number;
+    setActiveIndex: React.Dispatch<React.SetStateAction<number>>;
+    focusItem: (index: number) => void;
+    items: MenuItemRecord[];
+    onOpenViaKeyboard: () => void;
+}
+declare function useDropdownMenuContext(componentName: string): DropdownMenuContextValue;
+/**
+ * DropdownMenuRoot component managing open state, keyboard navigation, and item registration.
+ */
+declare const DropdownMenuRoot: React.FC<DropdownMenuRootProps>;
+/**
+ * DropdownMenuTrigger - button that toggles the dropdown menu.
+ */
+declare const DropdownMenuTrigger: React.ForwardRefExoticComponent<DropdownMenuTriggerProps & React.RefAttributes<HTMLElement>>;
+/**
+ * DropdownMenuContent - floating panel containing menu items.
+ */
+declare const DropdownMenuContent: React.ForwardRefExoticComponent<DropdownMenuContentProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenuItem - selectable action inside menu.
+ */
+declare const DropdownMenuItem: React.ForwardRefExoticComponent<DropdownMenuItemProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenuCheckboxItem - togglable checkbox item.
+ */
+declare const DropdownMenuCheckboxItem: React.ForwardRefExoticComponent<DropdownMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenuRadioGroup - container for mutually exclusive radio items.
+ */
+declare const DropdownMenuRadioGroup: React.ForwardRefExoticComponent<DropdownMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenuRadioItem - single radio option inside a DropdownMenuRadioGroup.
+ */
+declare const DropdownMenuRadioItem: React.ForwardRefExoticComponent<DropdownMenuRadioItemProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenuSeparator - visual and semantic separator between items.
+ */
+declare const DropdownMenuSeparator: React.ForwardRefExoticComponent<DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenuLabel - non-interactive section header inside a menu.
+ */
+declare const DropdownMenuLabel: React.ForwardRefExoticComponent<DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DropdownMenu Compound Component
+ */
+declare const DropdownMenu: React.FC<DropdownMenuRootProps> & {
+    Root: React.FC<DropdownMenuRootProps>;
+    Trigger: React.ForwardRefExoticComponent<DropdownMenuTriggerProps & React.RefAttributes<HTMLElement>>;
+    Content: React.ForwardRefExoticComponent<DropdownMenuContentProps & React.RefAttributes<HTMLDivElement>>;
+    Item: React.ForwardRefExoticComponent<DropdownMenuItemProps & React.RefAttributes<HTMLDivElement>>;
+    CheckboxItem: React.ForwardRefExoticComponent<DropdownMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>>;
+    RadioGroup: React.ForwardRefExoticComponent<DropdownMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+    RadioItem: React.ForwardRefExoticComponent<DropdownMenuRadioItemProps & React.RefAttributes<HTMLDivElement>>;
+    Separator: React.ForwardRefExoticComponent<DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+    Label: React.ForwardRefExoticComponent<DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>>;
+};
+
+interface ContextMenuRootProps {
+    /** Controlled open state */
+    open?: boolean;
+    /** Uncontrolled initial open state */
+    defaultOpen?: boolean;
+    /** Callback fired when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Whether the menu is modal (blocks outside pointer interaction) */
+    modal?: boolean;
+    children?: React.ReactNode;
+}
+interface ContextMenuTriggerProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Disables opening the context menu */
+    disabled?: boolean;
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+interface ContextMenuContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    sideOffset?: number;
+    alignOffset?: number;
+    collisionPadding?: number;
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+type ContextMenuItemProps = DropdownMenuItemProps;
+type ContextMenuCheckboxItemProps = DropdownMenuCheckboxItemProps;
+type ContextMenuRadioGroupProps = DropdownMenuRadioGroupProps;
+type ContextMenuRadioItemProps = DropdownMenuRadioItemProps;
+type ContextMenuSeparatorProps = DropdownMenuSeparatorProps;
+type ContextMenuLabelProps = DropdownMenuLabelProps;
+
+/**
+ * ContextMenuRoot - manages open state, virtual pointer anchor, and roving focus.
+ */
+declare const ContextMenuRoot: React.FC<ContextMenuRootProps>;
+/**
+ * ContextMenuTrigger - region that opens menu upon right-click or Shift+F10 / ContextMenu key.
+ */
+declare const ContextMenuTrigger: React.ForwardRefExoticComponent<ContextMenuTriggerProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * ContextMenuContent - floating panel positioned at the virtual coordinates.
+ */
+declare const ContextMenuContent: React.ForwardRefExoticComponent<ContextMenuContentProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuItem: React.ForwardRefExoticComponent<DropdownMenuItemProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuCheckboxItem: React.ForwardRefExoticComponent<DropdownMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuRadioGroup: React.ForwardRefExoticComponent<DropdownMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuRadioItem: React.ForwardRefExoticComponent<DropdownMenuRadioItemProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuSeparator: React.ForwardRefExoticComponent<DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenuLabel: React.ForwardRefExoticComponent<DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>>;
+declare const ContextMenu: React.FC<ContextMenuRootProps> & {
+    Root: React.FC<ContextMenuRootProps>;
+    Trigger: React.ForwardRefExoticComponent<ContextMenuTriggerProps & React.RefAttributes<HTMLDivElement>>;
+    Content: React.ForwardRefExoticComponent<ContextMenuContentProps & React.RefAttributes<HTMLDivElement>>;
+    Item: React.ForwardRefExoticComponent<DropdownMenuItemProps & React.RefAttributes<HTMLDivElement>>;
+    CheckboxItem: React.ForwardRefExoticComponent<DropdownMenuCheckboxItemProps & React.RefAttributes<HTMLDivElement>>;
+    RadioGroup: React.ForwardRefExoticComponent<DropdownMenuRadioGroupProps & React.RefAttributes<HTMLDivElement>>;
+    RadioItem: React.ForwardRefExoticComponent<DropdownMenuRadioItemProps & React.RefAttributes<HTMLDivElement>>;
+    Separator: React.ForwardRefExoticComponent<DropdownMenuSeparatorProps & React.RefAttributes<HTMLDivElement>>;
+    Label: React.ForwardRefExoticComponent<DropdownMenuLabelProps & React.RefAttributes<HTMLDivElement>>;
+};
+
+type DrawerPlacement = "left" | "right" | "top" | "bottom";
+type DrawerSize = "xs" | "sm" | "md" | "lg" | "xl" | "full";
+interface DrawerRootProps {
+    /** Controlled open state */
+    open?: boolean;
+    /** Ergonomic alias for open */
+    isOpen?: boolean;
+    /** Uncontrolled initial open state */
+    defaultOpen?: boolean;
+    /** Callback fired when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Callback fired when drawer closes */
+    onClose?: () => void;
+    /** Direction from which the drawer slides in */
+    placement?: DrawerPlacement;
+    /** Sizing scale */
+    size?: DrawerSize;
+    /** If true, pressing Escape dismisses the drawer */
+    closeOnEsc?: boolean;
+    /** If true, clicking the backdrop overlay dismisses the drawer */
+    closeOnOverlayClick?: boolean;
+    /** Explicit element to focus when opened */
+    initialFocusRef?: React.RefObject<HTMLElement | null>;
+    /** Explicit element to focus when closed */
+    finalFocusRef?: React.RefObject<HTMLElement | null>;
+    children?: React.ReactNode;
+}
+interface DrawerTriggerProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+interface DrawerPortalProps {
+    container?: HTMLElement | null;
+    children?: React.ReactNode;
+}
+interface DrawerOverlayProps extends React.HTMLAttributes<HTMLDivElement> {
+    asChild?: boolean;
+}
+interface DrawerContentProps extends React.HTMLAttributes<HTMLDivElement> {
+    placement?: DrawerPlacement;
+    size?: DrawerSize;
+    asChild?: boolean;
+    children?: React.ReactNode;
+}
+interface DrawerHeaderProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+interface DrawerTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    asChild?: boolean;
+}
+interface DrawerDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
+    asChild?: boolean;
+}
+interface DrawerBodyProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+interface DrawerFooterProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+interface DrawerCloseProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    asChild?: boolean;
+}
+type SheetPlacement = DrawerPlacement;
+type SheetSize = DrawerSize;
+type SheetRootProps = DrawerRootProps;
+type SheetTriggerProps = DrawerTriggerProps;
+type SheetPortalProps = DrawerPortalProps;
+type SheetOverlayProps = DrawerOverlayProps;
+type SheetContentProps = DrawerContentProps;
+type SheetHeaderProps = DrawerHeaderProps;
+type SheetTitleProps = DrawerTitleProps;
+type SheetDescriptionProps = DrawerDescriptionProps;
+type SheetBodyProps = DrawerBodyProps;
+type SheetFooterProps = DrawerFooterProps;
+type SheetCloseProps = DrawerCloseProps;
+
+interface DrawerContextValue {
+    isOpen: boolean;
+    onOpen: () => void;
+    onClose: () => void;
+    closeOnEsc: boolean;
+    closeOnOverlayClick: boolean;
+    placement: DrawerPlacement;
+    size: DrawerSize;
+    titleId: string;
+    setTitleId: (id: string) => void;
+    descriptionId: string;
+    setDescriptionId: (id: string) => void;
+    initialFocusRef?: React.RefObject<HTMLElement | null> | undefined;
+    finalFocusRef?: React.RefObject<HTMLElement | null> | undefined;
+    triggerRef: React.MutableRefObject<HTMLElement | null>;
+}
+declare function useDrawerContext(componentName: string): DrawerContextValue;
+/**
+ * DrawerRoot component - manages controlled/uncontrolled visibility, placement, and focus refs.
+ */
+declare const DrawerRoot: React.FC<DrawerRootProps>;
+/**
+ * DrawerTrigger - button or custom element that opens the drawer.
+ */
+declare const DrawerTrigger: React.ForwardRefExoticComponent<DrawerTriggerProps & React.RefAttributes<HTMLElement>>;
+/**
+ * DrawerPortal - mounts drawer children into document.body or container.
+ */
+declare const DrawerPortal: React.FC<DrawerPortalProps>;
+/**
+ * DrawerOverlay - background backdrop with dismissal click handling.
+ */
+declare const DrawerOverlay: React.ForwardRefExoticComponent<DrawerOverlayProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerContent - edge-anchored sliding modal panel with focus trapping and body scroll locking.
+ */
+declare const DrawerContent: React.ForwardRefExoticComponent<DrawerContentProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerHeader - header section containing title and optional close button.
+ */
+declare const DrawerHeader: React.ForwardRefExoticComponent<DrawerHeaderProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerTitle - accessible dialog heading.
+ */
+declare const DrawerTitle: React.ForwardRefExoticComponent<DrawerTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+/**
+ * DrawerDescription - accessible dialog description paragraph.
+ */
+declare const DrawerDescription: React.ForwardRefExoticComponent<DrawerDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+/**
+ * DrawerBody - scrollable main content area.
+ */
+declare const DrawerBody: React.ForwardRefExoticComponent<DrawerBodyProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerFooter - bottom action buttons container.
+ */
+declare const DrawerFooter: React.ForwardRefExoticComponent<DrawerFooterProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * DrawerClose - button that triggers drawer dismissal.
+ */
+declare const DrawerClose: React.ForwardRefExoticComponent<DrawerCloseProps & React.RefAttributes<HTMLButtonElement>>;
+/**
+ * Drawer Compound Component
+ */
+declare const Drawer: React.FC<DrawerRootProps> & {
+    Root: React.FC<DrawerRootProps>;
+    Trigger: React.ForwardRefExoticComponent<DrawerTriggerProps & React.RefAttributes<HTMLElement>>;
+    Portal: React.FC<DrawerPortalProps>;
+    Overlay: React.ForwardRefExoticComponent<DrawerOverlayProps & React.RefAttributes<HTMLDivElement>>;
+    Content: React.ForwardRefExoticComponent<DrawerContentProps & React.RefAttributes<HTMLDivElement>>;
+    Header: React.ForwardRefExoticComponent<DrawerHeaderProps & React.RefAttributes<HTMLDivElement>>;
+    Title: React.ForwardRefExoticComponent<DrawerTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+    Description: React.ForwardRefExoticComponent<DrawerDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+    Body: React.ForwardRefExoticComponent<DrawerBodyProps & React.RefAttributes<HTMLDivElement>>;
+    Footer: React.ForwardRefExoticComponent<DrawerFooterProps & React.RefAttributes<HTMLDivElement>>;
+    Close: React.ForwardRefExoticComponent<DrawerCloseProps & React.RefAttributes<HTMLButtonElement>>;
+};
+/**
+ * Sheet alias
+ */
+declare const Sheet: React.FC<DrawerRootProps> & {
+    Root: React.FC<DrawerRootProps>;
+    Trigger: React.ForwardRefExoticComponent<DrawerTriggerProps & React.RefAttributes<HTMLElement>>;
+    Portal: React.FC<DrawerPortalProps>;
+    Overlay: React.ForwardRefExoticComponent<DrawerOverlayProps & React.RefAttributes<HTMLDivElement>>;
+    Content: React.ForwardRefExoticComponent<DrawerContentProps & React.RefAttributes<HTMLDivElement>>;
+    Header: React.ForwardRefExoticComponent<DrawerHeaderProps & React.RefAttributes<HTMLDivElement>>;
+    Title: React.ForwardRefExoticComponent<DrawerTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+    Description: React.ForwardRefExoticComponent<DrawerDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+    Body: React.ForwardRefExoticComponent<DrawerBodyProps & React.RefAttributes<HTMLDivElement>>;
+    Footer: React.ForwardRefExoticComponent<DrawerFooterProps & React.RefAttributes<HTMLDivElement>>;
+    Close: React.ForwardRefExoticComponent<DrawerCloseProps & React.RefAttributes<HTMLButtonElement>>;
+};
+declare const SheetRoot: React.FC<DrawerRootProps>;
+declare const SheetTrigger: React.ForwardRefExoticComponent<DrawerTriggerProps & React.RefAttributes<HTMLElement>>;
+declare const SheetPortal: React.FC<DrawerPortalProps>;
+declare const SheetOverlay: React.ForwardRefExoticComponent<DrawerOverlayProps & React.RefAttributes<HTMLDivElement>>;
+declare const SheetContent: React.ForwardRefExoticComponent<DrawerContentProps & React.RefAttributes<HTMLDivElement>>;
+declare const SheetHeader: React.ForwardRefExoticComponent<DrawerHeaderProps & React.RefAttributes<HTMLDivElement>>;
+declare const SheetTitle: React.ForwardRefExoticComponent<DrawerTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+declare const SheetDescription: React.ForwardRefExoticComponent<DrawerDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+declare const SheetBody: React.ForwardRefExoticComponent<DrawerBodyProps & React.RefAttributes<HTMLDivElement>>;
+declare const SheetFooter: React.ForwardRefExoticComponent<DrawerFooterProps & React.RefAttributes<HTMLDivElement>>;
+declare const SheetClose: React.ForwardRefExoticComponent<DrawerCloseProps & React.RefAttributes<HTMLButtonElement>>;
+
+type LinkUnderline = "always" | "hover" | "none";
+type LinkColorScheme = "primary" | "neutral" | "subtle";
+interface LinkProps extends React.AnchorHTMLAttributes<HTMLAnchorElement> {
+    /**
+     * Underline decoration style.
+     * - "always": permanently underlined.
+     * - "hover": underlined on pointer hover and keyboard focus.
+     * - "none": no underline decoration.
+     * @default "hover"
+     */
+    underline?: LinkUnderline;
+    /**
+     * Semantic color scheme tailored to design tokens.
+     * - "primary": brand primary accent.
+     * - "neutral": matches primary text color.
+     * - "subtle": secondary/muted text color.
+     * @default "primary"
+     */
+    colorScheme?: LinkColorScheme;
+    /**
+     * Indicates an external destination.
+     * Automatically sets target="_blank" and rel="noopener noreferrer".
+     * @default false
+     */
+    isExternal?: boolean;
+    /**
+     * Whether to render an accessible external link icon when `isExternal` is true.
+     * @default true
+     */
+    showExternalIcon?: boolean;
+    /**
+     * Visual and interaction disabled state.
+     * Sets aria-disabled="true", tabIndex={-1}, and cancels click events without breaking anchor semantics.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Delegates rendering to immediate child element using Slot composition.
+     * @default false
+     */
+    asChild?: boolean;
+    /**
+     * The underlying HTML element or component override.
+     */
+    component?: React.ElementType;
+    /**
+     * Alias for component.
+     */
+    as?: React.ElementType;
+    /**
+     * Design system sx override prop.
+     */
+    sx?: SxProps;
+    children?: React.ReactNode;
+}
+
+interface BreadcrumbsProps extends React.ComponentPropsWithoutRef<"nav"> {
+    /**
+     * Accessible landmark label announced by assistive tech.
+     * @default "Breadcrumb"
+     */
+    "aria-label"?: string;
+    /**
+     * Custom separator node displayed between breadcrumb items.
+     * @default "/"
+     */
+    separator?: React.ReactNode;
+    /**
+     * Maximum number of items to display before collapsing with an ellipsis.
+     */
+    maxItems?: number;
+    /**
+     * Number of items to keep visible at the start before the ellipsis.
+     * @default 1
+     */
+    itemsBeforeCollapse?: number;
+    /**
+     * Number of items to keep visible at the end after the ellipsis.
+     * @default 1
+     */
+    itemsAfterCollapse?: number;
+    /**
+     * The system sx style override prop.
+     */
+    sx?: SxProps;
+    children: React.ReactNode;
+}
+interface BreadcrumbListProps extends React.ComponentPropsWithoutRef<"ol"> {
+    children: React.ReactNode;
+}
+interface BreadcrumbItemProps extends React.ComponentPropsWithoutRef<"li"> {
+    children: React.ReactNode;
+}
+interface BreadcrumbLinkProps extends LinkProps {
+    asChild?: boolean;
+    children: React.ReactNode;
+}
+interface BreadcrumbPageProps extends React.ComponentPropsWithoutRef<"span"> {
+    asChild?: boolean;
+    children: React.ReactNode;
+}
+interface BreadcrumbSeparatorProps extends React.ComponentPropsWithoutRef<"li"> {
+    children?: React.ReactNode;
+}
+interface BreadcrumbEllipsisProps extends React.ComponentPropsWithoutRef<"span"> {
+    /**
+     * Accessible text for screen reader users.
+     * @default "More breadcrumb items"
+     */
+    "aria-label"?: string;
+}
+
+/**
+ * Breadcrumbs navigation landmark container.
+ *
+ * @example
+ * ```tsx
+ * <Breadcrumbs>
+ *   <BreadcrumbList>
+ *     <BreadcrumbItem>
+ *       <BreadcrumbLink href="/">Home</BreadcrumbLink>
+ *     </BreadcrumbItem>
+ *     <BreadcrumbSeparator />
+ *     <BreadcrumbItem>
+ *       <BreadcrumbPage>Settings</BreadcrumbPage>
+ *     </BreadcrumbItem>
+ *   </BreadcrumbList>
+ * </Breadcrumbs>
+ * ```
+ */
+declare const BreadcrumbsRoot: React.ForwardRefExoticComponent<BreadcrumbsProps & React.RefAttributes<HTMLElement>>;
+/**
+ * Ordered list container for breadcrumb items.
+ */
+declare const BreadcrumbList: React.ForwardRefExoticComponent<BreadcrumbListProps & React.RefAttributes<HTMLOListElement>>;
+/**
+ * Individual item wrapper inside the breadcrumb list.
+ */
+declare const BreadcrumbItem: React.ForwardRefExoticComponent<BreadcrumbItemProps & React.RefAttributes<HTMLLIElement>>;
+/**
+ * Navigable link inside a breadcrumb item.
+ */
+declare const BreadcrumbLink: React.ForwardRefExoticComponent<BreadcrumbLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+/**
+ * Terminal current page indicator inside the breadcrumb list.
+ * Automatically marks with aria-current="page" and prevents link navigation.
+ */
+declare const BreadcrumbPage: React.ForwardRefExoticComponent<BreadcrumbPageProps & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Visual separator element between breadcrumb items, hidden from assistive technology.
+ */
+declare const BreadcrumbSeparator: React.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React.RefAttributes<HTMLLIElement>>;
+/**
+ * Collapsed items indicator (ellipsis) for long breadcrumb chains.
+ */
+declare const BreadcrumbEllipsis: React.ForwardRefExoticComponent<BreadcrumbEllipsisProps & React.RefAttributes<HTMLSpanElement>>;
+/**
+ * Breadcrumbs Compound Component
+ */
+declare const Breadcrumbs: React.ForwardRefExoticComponent<BreadcrumbsProps & React.RefAttributes<HTMLElement>> & {
+    Root: React.ForwardRefExoticComponent<BreadcrumbsProps & React.RefAttributes<HTMLElement>>;
+    List: React.ForwardRefExoticComponent<BreadcrumbListProps & React.RefAttributes<HTMLOListElement>>;
+    Item: React.ForwardRefExoticComponent<BreadcrumbItemProps & React.RefAttributes<HTMLLIElement>>;
+    Link: React.ForwardRefExoticComponent<BreadcrumbLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+    Page: React.ForwardRefExoticComponent<BreadcrumbPageProps & React.RefAttributes<HTMLSpanElement>>;
+    Separator: React.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React.RefAttributes<HTMLLIElement>>;
+    Ellipsis: React.ForwardRefExoticComponent<BreadcrumbEllipsisProps & React.RefAttributes<HTMLSpanElement>>;
+};
+declare const Breadcrumb: React.ForwardRefExoticComponent<BreadcrumbsProps & React.RefAttributes<HTMLElement>> & {
+    Root: React.ForwardRefExoticComponent<BreadcrumbsProps & React.RefAttributes<HTMLElement>>;
+    List: React.ForwardRefExoticComponent<BreadcrumbListProps & React.RefAttributes<HTMLOListElement>>;
+    Item: React.ForwardRefExoticComponent<BreadcrumbItemProps & React.RefAttributes<HTMLLIElement>>;
+    Link: React.ForwardRefExoticComponent<BreadcrumbLinkProps & React.RefAttributes<HTMLAnchorElement>>;
+    Page: React.ForwardRefExoticComponent<BreadcrumbPageProps & React.RefAttributes<HTMLSpanElement>>;
+    Separator: React.ForwardRefExoticComponent<BreadcrumbSeparatorProps & React.RefAttributes<HTMLLIElement>>;
+    Ellipsis: React.ForwardRefExoticComponent<BreadcrumbEllipsisProps & React.RefAttributes<HTMLSpanElement>>;
+};
+
+/**
+ * Link component styling native anchor elements with design system tokens,
+ * underline variants, security guards for external destinations, and Slot composition.
+ *
+ * @example
+ * ```tsx
+ * <Link href="/docs">Documentation</Link>
+ * <Link href="https://github.com" isExternal>GitHub</Link>
+ * ```
+ */
+declare const Link: React.ForwardRefExoticComponent<LinkProps & React.RefAttributes<HTMLAnchorElement>>;
+
+interface DateRangePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * Controlled range selection value.
+     */
+    value?: DateRange | null | undefined;
+    /**
+     * Initial uncontrolled range selection value.
+     */
+    defaultValue?: DateRange | null | undefined;
+    /**
+     * Callback fired when the date range selection changes.
+     */
+    onValueChange?: ((range: DateRange | null) => void) | undefined;
+    /**
+     * Date formatting pattern applied to each date.
+     * @default "YYYY-MM-DD"
+     */
+    format?: string | undefined;
+    /**
+     * Text separator displayed between start date and end date in the input.
+     * @default " – "
+     */
+    rangeSeparator?: string | undefined;
+    /**
+     * Placeholder string displayed when no date range is selected.
+     */
+    placeholder?: string | undefined;
+    /**
+     * Controlled open state of the calendar popover.
+     */
+    isOpen?: boolean | undefined;
+    /**
+     * Initial uncontrolled open state of the calendar popover.
+     * @default false
+     */
+    defaultOpen?: boolean | undefined;
+    /**
+     * Callback fired when the popover open state changes.
+     */
+    onOpenChange?: ((isOpen: boolean) => void) | undefined;
+    /**
+     * Whether the control is interactive or disabled.
+     * Cascades automatically from parent <FormField> if unset.
+     * @default false
+     */
+    isDisabled?: boolean | undefined;
+    /**
+     * Whether the control is currently in an error state.
+     * Cascades automatically from parent <FormField> if unset.
+     * @default false
+     */
+    isInvalid?: boolean | undefined;
+    /**
+     * If true, displays a clear button when a date range is selected.
+     * @default true
+     */
+    isClearable?: boolean | undefined;
+    /**
+     * Earliest selectable calendar date (inclusive).
+     */
+    minDate?: Date | null | undefined;
+    /**
+     * Latest selectable calendar date (inclusive).
+     */
+    maxDate?: Date | null | undefined;
+    /**
+     * Predicate callback to evaluate whether a given calendar date is disabled.
+     */
+    isDateDisabled?: ((date: Date) => boolean) | undefined;
+    /**
+     * Starting day of the week (0 = Sunday, 1 = Monday, 6 = Saturday).
+     * @default 0
+     */
+    firstDayOfWeek?: (0 | 1 | 6) | undefined;
+    /**
+     * BCP 47 locale tag used for localized month and weekday names.
+     * @default "en-US"
+     */
+    locale?: string | undefined;
+    /**
+     * Initial focused or visible date in calendar when no date is selected.
+     */
+    defaultFocusedDate?: Date | undefined;
+    /**
+     * Size token defining padding, font-size, and control height.
+     * @default "md"
+     */
+    size?: "sm" | "md" | "lg" | undefined;
+    /**
+     * HTML name attribute used for form submission.
+     */
+    name?: string | undefined;
+    /**
+     * Accessible label for the input control.
+     */
+    "aria-label"?: string | undefined;
+}
+
+/**
+ * DateRangePicker combines formatted range input display with an anchored calendar popover dropdown
+ * supporting dual-date range selection, bounds constraints, keyboard navigation, and FormField integration.
+ *
+ * @example
+ * ```tsx
+ * <DateRangePicker
+ *   value={dateRange}
+ *   onValueChange={setDateRange}
+ *   rangeSeparator=" to "
+ * />
+ * ```
+ */
+declare const DateRangePicker: React.ForwardRefExoticComponent<DateRangePickerProps & React.RefAttributes<HTMLDivElement>>;
+
+type TimeFormat = "12h" | "24h";
+interface TimePickerProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * The currently selected time in 24-hour "HH:mm" format (e.g. "14:30").
+     */
+    value?: string | null | undefined;
+    /**
+     * The initial selected time in uncontrolled mode ("HH:mm").
+     */
+    defaultValue?: string | null | undefined;
+    /**
+     * Callback fired when selected time changes, returning "HH:mm" format.
+     */
+    onValueChange?: ((time: string) => void) | undefined;
+    /**
+     * Display format in the input and popup selector.
+     * @default "12h"
+     */
+    format?: TimeFormat | undefined;
+    /**
+     * Incremental step between selectable minutes in the dropdown.
+     * @default 5
+     */
+    minuteStep?: number | undefined;
+    /**
+     * Earliest selectable time in "HH:mm" format (inclusive).
+     */
+    minTime?: string | undefined;
+    /**
+     * Latest selectable time in "HH:mm" format (inclusive).
+     */
+    maxTime?: string | undefined;
+    /**
+     * Controlled open state of the time selector popover.
+     */
+    isOpen?: boolean | undefined;
+    /**
+     * Initial uncontrolled open state of the time selector popover.
+     * @default false
+     */
+    defaultOpen?: boolean | undefined;
+    /**
+     * Callback fired when popover open state changes.
+     */
+    onOpenChange?: ((isOpen: boolean) => void) | undefined;
+    /**
+     * Whether the control is interactive or disabled.
+     * Cascades from parent <FormField> if unset.
+     * @default false
+     */
+    isDisabled?: boolean | undefined;
+    /**
+     * Whether the control is read-only.
+     * @default false
+     */
+    isReadOnly?: boolean | undefined;
+    /**
+     * Whether the control is currently in an error state.
+     * Cascades from parent <FormField> if unset.
+     * @default false
+     */
+    isInvalid?: boolean | undefined;
+    /**
+     * If true, displays a clear button when a time is selected.
+     * @default true
+     */
+    isClearable?: boolean | undefined;
+    /**
+     * Placeholder string displayed in the input when empty.
+     */
+    placeholder?: string | undefined;
+    /**
+     * Size token defining control dimensions.
+     * @default "md"
+     */
+    size?: "sm" | "md" | "lg" | undefined;
+    /**
+     * HTML name attribute used for form submission.
+     */
+    name?: string | undefined;
+    /**
+     * Accessible label for the input control.
+     */
+    "aria-label"?: string | undefined;
+}
+
+/**
+ * TimePicker provides an accessible time selection input and anchored column popover
+ * supporting 12-hour AM/PM and 24-hour display modes, configurable minute stepping,
+ * boundary validation, keyboard stepping, and FormField integration.
+ *
+ * @example
+ * ```tsx
+ * <TimePicker value="14:30" onValueChange={setTime} />
+ * <TimePicker format="24h" minuteStep={15} />
+ * ```
+ */
+declare const TimePicker: React.ForwardRefExoticComponent<TimePickerProps & React.RefAttributes<HTMLDivElement>>;
+
+interface MultiSelectOption<TValue = string> {
+    value: TValue;
+    label: string;
+    disabled?: boolean;
+    description?: string;
+}
+type MultiSelectSize = "sm" | "md" | "lg";
+type MultiSelectVariant = "outline" | "filled";
+interface MultiSelectProps<TValue = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * Available options to select from.
+     */
+    options: MultiSelectOption<TValue>[];
+    /**
+     * Controlled array of selected option values.
+     */
+    value?: TValue[];
+    /**
+     * Initial uncontrolled array of selected option values.
+     * @default []
+     */
+    defaultValue?: TValue[];
+    /**
+     * Callback fired when selection changes.
+     */
+    onValueChange?: (values: TValue[]) => void;
+    /**
+     * Placeholder string shown when no items are selected.
+     * @default "Select options..."
+     */
+    placeholder?: string;
+    /**
+     * Placeholder string inside search filter input.
+     * @default "Search options..."
+     */
+    searchPlaceholder?: string;
+    /**
+     * Whether search input filter is enabled.
+     * @default true
+     */
+    isSearchable?: boolean;
+    /**
+     * Whether to show a clear button when selections exist.
+     * @default true
+     */
+    isClearable?: boolean;
+    /**
+     * Controlled open state of dropdown popover.
+     */
+    isOpen?: boolean;
+    /**
+     * Initial uncontrolled open state.
+     * @default false
+     */
+    defaultOpen?: boolean;
+    /**
+     * Callback fired when dropdown open state changes.
+     */
+    onOpenChange?: (isOpen: boolean) => void;
+    /**
+     * Whether the component is disabled.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Whether the component is in an invalid error state.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isInvalid?: boolean;
+    /**
+     * Loading state showing indicator in popover.
+     * @default false
+     */
+    isLoading?: boolean;
+    /**
+     * Custom message when no matching options are found.
+     * @default "No options found."
+     */
+    emptyMessage?: string;
+    /**
+     * Spatial density scale.
+     * @default "md"
+     */
+    size?: MultiSelectSize;
+    /**
+     * Visual aesthetic variant.
+     * @default "outline"
+     */
+    variant?: MultiSelectVariant;
+    /**
+     * Maximum number of visible chips before collapsing into "+N more".
+     * If omitted, all selected chips are rendered.
+     */
+    maxTagCount?: number;
+    /**
+     * Accessible name for the control.
+     */
+    "aria-label"?: string;
+}
+
+declare const MultiSelect: <TValue = string>(props: MultiSelectProps<TValue> & {
+    ref?: React.Ref<HTMLDivElement>;
+}) => React.ReactElement;
+
+type SortDirection = "asc" | "desc";
+interface DataGridSort<TKey = string> {
+    columnKey: TKey;
+    direction: SortDirection;
+}
+interface DataGridColumn<TRow, TKey extends string = string> {
+    /**
+     * Unique stable identifier for the column.
+     */
+    key: TKey;
+    /**
+     * Column header text or custom render node.
+     */
+    header: React.ReactNode;
+    /**
+     * Data accessor function or key extractor.
+     */
+    accessor?: (row: TRow, rowIndex: number) => React.ReactNode;
+    /**
+     * Custom cell renderer taking row, value, and index.
+     */
+    cell?: (props: {
+        row: TRow;
+        value: unknown;
+        rowIndex: number;
+    }) => React.ReactNode;
+    /**
+     * Whether the column can be sorted.
+     * @default false
+     */
+    isSortable?: boolean;
+    /**
+     * Custom comparator for client-side sorting.
+     */
+    comparator?: (a: TRow, b: TRow) => number;
+    /**
+     * Explicit column width.
+     */
+    width?: string | number;
+    /**
+     * Text alignment.
+     * @default "left"
+     */
+    align?: "left" | "center" | "right";
+}
+interface DataGridPaginationProps {
+    /**
+     * Current 1-based page number.
+     */
+    page: number;
+    /**
+     * Number of rows per page.
+     */
+    pageSize: number;
+    /**
+     * Total number of items (defaults to data.length if client-side).
+     */
+    total?: number;
+    /**
+     * Callback fired when page number changes.
+     */
+    onPageChange: (page: number) => void;
+    /**
+     * Callback fired when page size changes.
+     */
+    onPageSizeChange?: (pageSize: number) => void;
+    /**
+     * Page size options for selector.
+     */
+    pageSizeOptions?: number[];
+}
+interface DataGridProps<TRow, TKey extends string = string> extends Omit<React.HTMLAttributes<HTMLDivElement>, "children"> {
+    /**
+     * Column configuration.
+     */
+    columns: DataGridColumn<TRow, TKey>[];
+    /**
+     * Array of row items.
+     */
+    data: TRow[];
+    /**
+     * Unique identifier getter for each row.
+     */
+    getRowId: (row: TRow, index: number) => string | number;
+    /**
+     * Controlled sort state.
+     */
+    sort?: DataGridSort<TKey> | null;
+    /**
+     * Initial uncontrolled sort state.
+     */
+    defaultSort?: DataGridSort<TKey> | null;
+    /**
+     * Callback fired when sort changes.
+     */
+    onSortChange?: (sort: DataGridSort<TKey> | null) => void;
+    /**
+     * Whether row checkboxes are rendered for multiple row selection.
+     * @default false
+     */
+    isSelectable?: boolean;
+    /**
+     * Controlled array of selected row IDs.
+     */
+    selectedRowIds?: (string | number)[];
+    /**
+     * Initial uncontrolled array of selected row IDs.
+     * @default []
+     */
+    defaultSelectedRowIds?: (string | number)[];
+    /**
+     * Callback fired when selected row IDs change.
+     */
+    onSelectionChange?: (selectedIds: (string | number)[]) => void;
+    /**
+     * Whether clicking a row toggles its selection.
+     * @default false
+     */
+    selectOnRowClick?: boolean;
+    /**
+     * Visual aesthetic treatment.
+     * @default "simple"
+     */
+    variant?: "simple" | "striped" | "bordered";
+    /**
+     * Spatial density scale.
+     * @default "md"
+     */
+    size?: "sm" | "md" | "lg";
+    /**
+     * Whether table header is sticky while scrolling vertically.
+     * @default false
+     */
+    isStickyHeader?: boolean;
+    /**
+     * Maximum height of table body for scrolling.
+     */
+    maxHeight?: string | number;
+    /**
+     * Loading state showing spinner overlay.
+     * @default false
+     */
+    isLoading?: boolean;
+    /**
+     * Custom empty state component or text.
+     * @default "No data available."
+     */
+    emptyText?: React.ReactNode;
+    /**
+     * Optional pagination configuration.
+     */
+    pagination?: DataGridPaginationProps;
+    /**
+     * Accessible table label.
+     * @default "Data Grid"
+     */
+    "aria-label"?: string;
+}
+
+declare const DataGrid: <TRow, TKey extends string = string>(props: DataGridProps<TRow, TKey> & {
+    ref?: React.Ref<HTMLDivElement>;
+}) => React.ReactElement;
+
+interface FileItem {
+    id: string;
+    file: File;
+    name: string;
+    size: number;
+    type: string;
+}
+type FileValidationErrorCode = "file-too-large" | "file-invalid-type" | "too-many-files";
+interface FileValidationError {
+    file: File;
+    code: FileValidationErrorCode;
+    message: string;
+}
+interface FileUploadProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * Controlled array of selected files.
+     */
+    value?: File[];
+    /**
+     * Initial uncontrolled array of selected files.
+     * @default []
+     */
+    defaultValue?: File[];
+    /**
+     * Callback fired when selected files change.
+     */
+    onValueChange?: (files: File[]) => void;
+    /**
+     * Callback fired when files fail client-side validation rules.
+     */
+    onValidationErrors?: (errors: FileValidationError[]) => void;
+    /**
+     * Whether multiple files can be selected.
+     * @default false
+     */
+    isMultiple?: boolean;
+    /**
+     * Comma-separated accepted file extensions or MIME patterns (e.g. "image/*,.pdf").
+     */
+    accept?: string;
+    /**
+     * Maximum allowed file size in bytes.
+     */
+    maxSize?: number;
+    /**
+     * Maximum allowed total number of files.
+     */
+    maxFiles?: number;
+    /**
+     * Whether the component is disabled.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Whether the component is in an invalid error state.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isInvalid?: boolean;
+    /**
+     * Primary title text inside the dropzone.
+     * @default "Click or drag files here to upload"
+     */
+    dropzoneText?: string;
+    /**
+     * Secondary hint text below the primary prompt.
+     */
+    dropzoneHint?: string;
+    /**
+     * Button label for browsing files.
+     * @default "Browse Files"
+     */
+    browseText?: string;
+    /**
+     * Whether to display the selected files list within the component.
+     * @default true
+     */
+    showFileList?: boolean;
+    /**
+     * Custom file size formatter.
+     */
+    formatFileSize?: (bytes: number) => string;
+}
+
+declare const FileUpload: React.ForwardRefExoticComponent<FileUploadProps & React.RefAttributes<HTMLDivElement>>;
+
+interface SliderMark {
+    value: number;
+    label?: React.ReactNode;
+}
+type SliderSize = "sm" | "md" | "lg";
+type SliderColorScheme = "primary" | "secondary" | "success" | "warning" | "danger";
+interface SliderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * Controlled numeric value.
+     */
+    value?: number;
+    /**
+     * Initial uncontrolled numeric value.
+     * @default min
+     */
+    defaultValue?: number;
+    /**
+     * Callback fired when value changes.
+     */
+    onChange?: (value: number) => void;
+    /**
+     * Minimum permitted value.
+     * @default 0
+     */
+    min?: number;
+    /**
+     * Maximum permitted value.
+     * @default 100
+     */
+    max?: number;
+    /**
+     * Granular stepping increment.
+     * @default 1
+     */
+    step?: number;
+    /**
+     * Whether the slider is disabled.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Whether the slider is in an invalid state.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isInvalid?: boolean;
+    /**
+     * Spatial density scale.
+     * @default "md"
+     */
+    size?: SliderSize;
+    /**
+     * Semantic color scheme for the filled track and thumb.
+     * @default "primary"
+     */
+    colorScheme?: SliderColorScheme;
+    /**
+     * Array of milestone tick marks along the track.
+     */
+    marks?: SliderMark[];
+    /**
+     * Accessible name for the slider thumb.
+     * @default "Slider"
+     */
+    "aria-label"?: string;
+    /**
+     * Formatted text representation of the value (for screen readers).
+     */
+    getAriaValueText?: (value: number) => string;
+}
+interface RangeSliderProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * Controlled tuple of [minValue, maxValue].
+     */
+    value?: [number, number];
+    /**
+     * Initial uncontrolled tuple of [minValue, maxValue].
+     * @default [min, max]
+     */
+    defaultValue?: [number, number];
+    /**
+     * Callback fired when range values change.
+     */
+    onChange?: (value: [number, number]) => void;
+    /**
+     * Minimum permitted value.
+     * @default 0
+     */
+    min?: number;
+    /**
+     * Maximum permitted value.
+     * @default 100
+     */
+    max?: number;
+    /**
+     * Granular stepping increment.
+     * @default 1
+     */
+    step?: number;
+    /**
+     * Minimum distance permitted between lower and upper thumbs.
+     * @default 0
+     */
+    minDistance?: number;
+    /**
+     * Whether the range slider is disabled.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Whether the range slider is in an invalid state.
+     * Cascades from parent FormField if unset.
+     * @default false
+     */
+    isInvalid?: boolean;
+    /**
+     * Spatial density scale.
+     * @default "md"
+     */
+    size?: SliderSize;
+    /**
+     * Semantic color scheme for the active range fill.
+     * @default "primary"
+     */
+    colorScheme?: SliderColorScheme;
+    /**
+     * Milestone marks along the track.
+     */
+    marks?: SliderMark[];
+    /**
+     * Accessible name for lower thumb.
+     * @default "Minimum value"
+     */
+    minAriaLabel?: string;
+    /**
+     * Accessible name for upper thumb.
+     * @default "Maximum value"
+     */
+    maxAriaLabel?: string;
+    /**
+     * Formatter for screen-reader value announcement.
+     */
+    getAriaValueText?: (value: number, thumbIndex: 0 | 1) => string;
+}
+
+declare const Slider: React.ForwardRefExoticComponent<SliderProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const RangeSlider: React.ForwardRefExoticComponent<RangeSliderProps & React.RefAttributes<HTMLDivElement>>;
+
+interface TreeNode<TData = unknown> {
+    /**
+     * Unique stable identifier for the tree node.
+     */
+    id: string;
+    /**
+     * Node label text or React element.
+     */
+    label: React.ReactNode;
+    /**
+     * Optional child tree nodes.
+     */
+    children?: TreeNode<TData>[];
+    /**
+     * Whether the node is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Optional custom icon rendered before the label.
+     */
+    icon?: React.ReactNode;
+    /**
+     * Arbitrary payload data associated with this node.
+     */
+    data?: TData;
+}
+type TreeViewSelectionMode = "none" | "single" | "multi";
+interface TreeNodeState {
+    isExpanded: boolean;
+    isSelected: boolean;
+    isFocused: boolean;
+    isDisabled: boolean;
+    hasChildren: boolean;
+    level: number;
+}
+interface TreeViewProps<TData = unknown> extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange" | "defaultValue"> {
+    /**
+     * Hierarchical tree data nodes.
+     */
+    nodes: TreeNode<TData>[];
+    /**
+     * Controlled array of expanded node IDs.
+     */
+    expandedIds?: string[];
+    /**
+     * Initial uncontrolled array of expanded node IDs.
+     * @default []
+     */
+    defaultExpandedIds?: string[];
+    /**
+     * Callback fired when expanded node IDs change.
+     */
+    onExpandedChange?: (expandedIds: string[]) => void;
+    /**
+     * Controlled array of selected node IDs.
+     */
+    selectedIds?: string[];
+    /**
+     * Initial uncontrolled array of selected node IDs.
+     * @default []
+     */
+    defaultSelectedIds?: string[];
+    /**
+     * Callback fired when selected node IDs change.
+     */
+    onSelectionChange?: (selectedIds: string[]) => void;
+    /**
+     * Selection mode for the tree.
+     * @default "single"
+     */
+    selectionMode?: TreeViewSelectionMode;
+    /**
+     * Indentation in pixels per nesting level.
+     * @default 20
+     */
+    indentSize?: number;
+    /**
+     * Whether all nodes are initially expanded.
+     * @default false
+     */
+    defaultExpandAll?: boolean;
+    /**
+     * Custom node content renderer.
+     */
+    renderNode?: (node: TreeNode<TData>, state: TreeNodeState) => React.ReactNode;
+    /**
+     * Message or component to render when tree has no nodes.
+     * @default "No items available"
+     */
+    emptyMessage?: React.ReactNode;
+    /**
+     * Accessible label for the tree landmark.
+     * @default "Tree View"
+     */
+    ariaLabel?: string;
+}
+
+declare const TreeView: <TData = unknown>(props: TreeViewProps<TData> & {
+    ref?: React.Ref<HTMLDivElement>;
+}) => React.ReactElement;
+
+interface StepItem {
+    /**
+     * Unique identifier or index for the step.
+     */
+    id: string | number;
+    /**
+     * Primary title or label for the step.
+     */
+    label: React.ReactNode;
+    /**
+     * Optional secondary description text or content.
+     */
+    description?: React.ReactNode;
+    /**
+     * Optional custom icon rendered inside the step indicator.
+     */
+    icon?: React.ReactNode;
+    /**
+     * Whether the step is disabled and cannot be activated.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Whether the step contains validation or execution errors.
+     * @default false
+     */
+    error?: boolean;
+    /**
+     * Whether the step is explicitly marked completed.
+     */
+    completed?: boolean;
+    /**
+     * Whether the step is marked optional (displays an "Optional" badge).
+     * @default false
+     */
+    optional?: boolean;
+}
+type StepperOrientation = "horizontal" | "vertical";
+type StepperSize = "sm" | "md" | "lg";
+interface StepperProps extends Omit<React.HTMLAttributes<HTMLElement>, "onChange"> {
+    /**
+     * Array of step definitions.
+     */
+    steps: StepItem[];
+    /**
+     * Controlled active step identifier or index.
+     */
+    activeStep?: string | number;
+    /**
+     * Initial uncontrolled active step.
+     * @default 0
+     */
+    defaultActiveStep?: string | number;
+    /**
+     * Callback fired when active step changes.
+     */
+    onStepChange?: (stepId: string | number) => void;
+    /**
+     * Orientation of the stepper layout.
+     * @default "horizontal"
+     */
+    orientation?: StepperOrientation;
+    /**
+     * Size variant of step indicators and labels.
+     * @default "md"
+     */
+    size?: StepperSize;
+    /**
+     * Whether steps can be clicked to navigate.
+     * Can be a boolean or a predicate function.
+     * @default false
+     */
+    isClickable?: boolean | ((step: StepItem, index: number) => boolean);
+    /**
+     * Accessible label for the navigation landmark.
+     * @default "Progress"
+     */
+    ariaLabel?: string;
+}
+
+declare const Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<HTMLElement>>;
+
+interface CarouselSlideData {
+    id?: string | number;
+    content: React.ReactNode;
+    ariaLabel?: string;
+}
+interface CarouselProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /**
+     * Slide items to display. Alternatively pass children as slides.
+     */
+    slides?: (React.ReactNode | CarouselSlideData)[];
+    /**
+     * Direct child slide elements.
+     */
+    children?: React.ReactNode;
+    /**
+     * Controlled 0-based index of the active slide.
+     */
+    activeSlide?: number;
+    /**
+     * Initial uncontrolled 0-based index of the active slide.
+     * @default 0
+     */
+    defaultActiveSlide?: number;
+    /**
+     * Callback fired when active slide index changes.
+     */
+    onSlideChange?: (index: number) => void;
+    /**
+     * Whether navigation loops continuously from end to start.
+     * @default false
+     */
+    loop?: boolean;
+    /**
+     * Whether to display previous/next navigation arrow buttons.
+     * @default true
+     */
+    showControls?: boolean;
+    /**
+     * Whether to display pagination dot indicators.
+     * @default true
+     */
+    showPagination?: boolean;
+    /**
+     * Whether automatic slide progression is enabled.
+     * @default false
+     */
+    autoPlay?: boolean;
+    /**
+     * Duration in milliseconds between automatic slide transitions.
+     * @default 5000
+     */
+    autoPlayInterval?: number;
+    /**
+     * Whether to pause autoplay when hovered.
+     * @default true
+     */
+    pauseOnHover?: boolean;
+    /**
+     * Whether to pause autoplay when any element receives focus.
+     * @default true
+     */
+    pauseOnFocus?: boolean;
+    /**
+     * Whether the carousel is disabled.
+     * @default false
+     */
+    isDisabled?: boolean;
+    /**
+     * Accessible name for the carousel landmark region.
+     * @default "Content Carousel"
+     */
+    ariaLabel?: string;
+}
+interface CarouselSlideProps extends React.HTMLAttributes<HTMLDivElement> {
+    children?: React.ReactNode;
+}
+
+declare const Carousel: React.ForwardRefExoticComponent<CarouselProps & React.RefAttributes<HTMLDivElement>>;
+
+declare const CarouselSlide: React.ForwardRefExoticComponent<CarouselSlideProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Accordion, AccordionActions, type AccordionActionsProps, AccordionCollapseAll, type AccordionCollapseAllProps, AccordionContent, type AccordionContentProps, AccordionContext, type AccordionContextValue, AccordionExpandAll, type AccordionExpandAllProps, AccordionHeader, type AccordionHeaderProps, AccordionIcon, type AccordionIconProps, type AccordionIndicatorPosition, AccordionItem, AccordionItemContext, type AccordionItemContextValue, type AccordionItemProps, type AccordionMultipleProps, type AccordionProps, AccordionRoot, type AccordionRootProps, type AccordionSingleProps, type AccordionSize, AccordionTrigger, type AccordionTriggerProps, type AccordionType, type AccordionVariant, Alert, AlertAction, type AlertActionProps, AlertBody, type AlertBodyProps, AlertCloseButton, type AlertCloseButtonProps, type AlertContextValue, AlertDescription, type AlertDescriptionProps, AlertIcon, type AlertIconProps, type AlertProps, AlertRoot, type AlertRootProps, type AlertStatus, AlertTitle, type AlertTitleProps, type AlertVariant, Autocomplete, Avatar, AvatarBadge, type AvatarBadgeProps, AvatarContext, type AvatarContextValue, AvatarFallback, type AvatarFallbackProps, AvatarGroup, AvatarGroupContext, type AvatarGroupContextValue, type AvatarGroupProps, AvatarImage, type AvatarImageProps, type AvatarPlacement, type AvatarProps, AvatarRoot, type AvatarShape, type AvatarSize, type AvatarStatus, Badge, type BadgeColorScheme, type BadgeProps, type BadgeSize, type BadgeVariant, Box, type BoxProps, Breadcrumb, BreadcrumbEllipsis, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, BreadcrumbLink, type BreadcrumbLinkProps, BreadcrumbList, type BreadcrumbListProps, BreadcrumbPage, type BreadcrumbPageProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, Breadcrumbs, type BreadcrumbsProps, BreadcrumbsRoot, type BreakpointKey, type Breakpoints, Button, type ButtonColorScheme, ButtonGroup, ButtonGroupContext, type ButtonGroupContextValue, type ButtonGroupOrientation, type ButtonGroupProps, type ButtonLoadingPosition, type ButtonProps, type ButtonSize, type ButtonVariant, Calendar, type CalendarGridDay, type CalendarProps, Card, CardActions, type CardActionsProps, CardBody, type CardBodyProps, CardDescription, type CardDescriptionProps, CardFooter, type CardFooterProps, CardHeader, type CardHeaderProps, CardMedia, type CardMediaProps, type CardOwnerState, type CardProps, CardRoot, type CardSize, CardTitle, type CardTitleProps, type CardVariant, Carousel, type CarouselProps, CarouselSlide, type CarouselSlideData, type CarouselSlideProps, Checkbox, type CheckboxColorScheme, CheckboxContext, type CheckboxContextValue, CheckboxGroup, type CheckboxGroupProps, type CheckboxOwnerState, type CheckboxProps, type CheckboxSize, type ChellaaTheme, Code, type CodeColorScheme, type CodeOwnerState, type CodeProps, type ColorMode, Combobox, ComboboxActions, type ComboboxActionsProps, ComboboxClear, type ComboboxClearProps, ComboboxContent, type ComboboxContentProps, type ComboboxContextValue, ComboboxControl, type ComboboxControlProps, ComboboxEmpty, type ComboboxEmptyProps, ComboboxGroup, ComboboxGroupLabel, type ComboboxGroupLabelProps, type ComboboxGroupProps, ComboboxInput, type ComboboxInputProps, ComboboxItem, type ComboboxItemProps, type ComboboxOption, ComboboxPortal, type ComboboxPortalProps, type ComboboxProps, ComboboxRoot, type ComboboxRootProps, type ComboboxSize, ComboboxTag, type ComboboxTagProps, ComboboxTrigger, type ComboboxTriggerProps, type ComboboxVariant, type ComponentOverride, type ComponentOverrideOptions, Container, type ContainerOwnerState, type ContainerProps, ContextMenu, ContextMenuCheckboxItem, type ContextMenuCheckboxItemProps, ContextMenuContent, type ContextMenuContentProps, ContextMenuItem, type ContextMenuItemProps, ContextMenuLabel, type ContextMenuLabelProps, ContextMenuRadioGroup, type ContextMenuRadioGroupProps, ContextMenuRadioItem, type ContextMenuRadioItemProps, ContextMenuRoot, type ContextMenuRootProps, ContextMenuSeparator, type ContextMenuSeparatorProps, ContextMenuTrigger, type ContextMenuTriggerProps, DataGrid, type DataGridColumn, type DataGridPaginationProps, type DataGridProps, type DataGridSort, DatePicker, type DatePickerProps, type DateRange, DateRangePicker, type DateRangePickerProps, type DeepPartial, Dialog, DialogBody, type DialogBodyProps, DialogClose, type DialogCloseProps, DialogContent, type DialogContentProps, DialogDescription, type DialogDescriptionProps, DialogFooter, type DialogFooterProps, DialogHeader, type DialogHeaderProps, DialogOverlay, type DialogOverlayProps, DialogPortal, type DialogPortalProps, DialogRoot, type DialogRootProps, type DialogSize, DialogTitle, type DialogTitleProps, DialogTrigger, type DialogTriggerProps, Divider, type DividerLineStyle, type DividerOrientation, type DividerOwnerState, type DividerProps, type DividerTextAlign, type DividerVariant, Drawer, DrawerBody, type DrawerBodyProps, DrawerClose, type DrawerCloseProps, DrawerContent, type DrawerContentProps, DrawerDescription, type DrawerDescriptionProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, DrawerOverlay, type DrawerOverlayProps, type DrawerPlacement, DrawerPortal, type DrawerPortalProps, DrawerRoot, type DrawerRootProps, type DrawerSize, DrawerTitle, type DrawerTitleProps, DrawerTrigger, type DrawerTriggerProps, DropdownMenu, type DropdownMenuAlign, DropdownMenuCheckboxItem, type DropdownMenuCheckboxItemProps, DropdownMenuContent, type DropdownMenuContentProps, DropdownMenuItem, type DropdownMenuItemProps, DropdownMenuLabel, type DropdownMenuLabelProps, DropdownMenuRadioGroup, type DropdownMenuRadioGroupProps, DropdownMenuRadioItem, type DropdownMenuRadioItemProps, DropdownMenuRoot, type DropdownMenuRootProps, DropdownMenuSeparator, type DropdownMenuSeparatorProps, type DropdownMenuSide, DropdownMenuTrigger, type DropdownMenuTriggerProps, type ExtendedThemeContextValue, type FieldValidationError, type FieldValidationResult, type FieldValidator, type FileItem, FileUpload, type FileUploadProps, type FileValidationError, type FileValidationErrorCode, Flex, type FlexOwnerState, type FlexProps, FormErrorMessage, type FormErrorMessageProps, FormField, FormFieldContext, type FormFieldContextValue, type FormFieldProps, FormHelperText, type FormHelperTextProps, FormLabel, type FormLabelProps, Grid, type GridDirection, type GridOwnerState, type GridProps, type GridSize, type GridWrap, Heading, type HeadingLevel, type HeadingProps, type ImageLoadingStatus, Input, InputAdornment, type InputAdornmentProps, InputBase, type InputOwnerState, type InputProps, type InputSize, type InputVariant, Kbd, type KbdModifier, type KbdOwnerState, type KbdProps, type KbdSize, type KbdVariant, Link, type LinkColorScheme, type LinkProps, type LinkUnderline, MODIFIER_SYMBOLS, Modal, type ModalBodyProps, type ModalCloseProps, type ModalContentProps, type ModalDescriptionProps, type ModalFooterProps, type ModalHeaderProps, type ModalOverlayProps, type ModalPortalProps, type ModalRootProps, type ModalSize, type ModalTitleProps, type ModalTriggerProps, MultiSelect, type MultiSelectOption, type MultiSelectProps, type MultiSelectSize, type MultiSelectVariant, Pagination, type PaginationActionProps, PaginationContext, type PaginationContextValue, PaginationEllipsis, type PaginationEllipsisProps, PaginationFirst, PaginationItem, type PaginationItemProps, PaginationJumper, type PaginationJumperProps, PaginationLast, PaginationList, type PaginationListProps, PaginationNext, PaginationPrev, type PaginationProps, PaginationRoot, type PaginationRootProps, type PaginationSize, PaginationSizeSelect, type PaginationSizeSelectProps, type PaginationVariant, type Palette, type PaletteColor, Paper, type PaperOwnerState, type PaperProps, type PaperVariant, Paragraph, type ParagraphProps, Popover, PopoverArrow, type PopoverArrowProps, PopoverBody, type PopoverBodyProps, PopoverClose, type PopoverCloseProps, PopoverContent, type PopoverContentProps, type PopoverContextValue, PopoverFooter, type PopoverFooterProps, PopoverHeader, type PopoverHeaderProps, type PopoverPlacement, PopoverPortal, type PopoverPortalProps, type PopoverProps, PopoverRoot, type PopoverRootProps, PopoverTitle, type PopoverTitleProps, PopoverTrigger, type PopoverTriggerProps, Portal, type PortalProps, Progress, type ProgressColorScheme, type ProgressProps, type ProgressSize, type ProgressVariant, Radio, type RadioColorScheme, RadioContext, type RadioContextValue, RadioGroup, type RadioGroupProps, type RadioOwnerState, type RadioProps, type RadioSize, RangeSlider, type RangeSliderProps, type RegisteredItem, type ResponsiveValue, type RippleItem, Select, SelectContent, type SelectContentProps, type SelectContextValue, SelectGroup, type SelectGroupProps, SelectIcon, type SelectIconProps, SelectItem, SelectItemIndicator, type SelectItemIndicatorProps, type SelectItemProps, SelectItemText, type SelectItemTextProps, SelectLabel, type SelectLabelProps, type SelectOption, SelectPortal, type SelectPortalProps, SelectRoot, type SelectRootProps, SelectSeparator, type SelectSeparatorProps, type SelectSize, SelectTrigger, type SelectTriggerProps, SelectValue, type SelectValueProps, type SelectVariant, Sheet, SheetBody, type SheetBodyProps, SheetClose, type SheetCloseProps, SheetContent, type SheetContentProps, SheetDescription, type SheetDescriptionProps, SheetFooter, type SheetFooterProps, SheetHeader, type SheetHeaderProps, SheetOverlay, type SheetOverlayProps, type SheetPlacement, SheetPortal, type SheetPortalProps, SheetRoot, type SheetRootProps, type SheetSize, SheetTitle, type SheetTitleProps, SheetTrigger, type SheetTriggerProps, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderColorScheme, type SliderMark, type SliderProps, type SliderSize, Slot, type SlotProps, Snackbar, type SnackbarProps, type SortDirection, Spinner, type SpinnerColorScheme, type SpinnerProps, type SpinnerSize, Stack, type StackDirection, type StackOwnerState, type StackProps, type StandardCSSProperties, type StepItem, Stepper, type StepperOrientation, type StepperProps, type StepperSize, type StyleInterpolation, type StyledOptions, Switch, type SwitchColorScheme, type SwitchLabelPlacement, type SwitchOwnerState, type SwitchProps, type SwitchSize, type SxObject, type SxPropValue, type SxProps, type SystemCssProperties, type SystemStyleProperties, Table, TableCaption, type TableCaptionProps, type TableCellProps, TableContainer, type TableContainerProps, type TableContextValue, type TableHeaderCellProps, TableRoot, type TableRootProps, type TableRowProps, type TableSize, TableTbody, type TableTbodyProps, TableTd, TableTfoot, type TableTfootProps, TableTh, TableThead, type TableTheadProps, TableTr, type TableVariant, Tabs, type TabsActivationMode, TabsContent, type TabsContentProps, TabsContext, type TabsContextValue, TabsIndicator, type TabsIndicatorProps, TabsList, type TabsListProps, type TabsOrientation, type TabsProps, TabsRoot, type TabsRootProps, type TabsSize, TabsTrigger, type TabsTriggerProps, type TabsVariant, Text, TextField, type TextFieldProps, type TextProps, type TextSize, Textarea, type TextareaOwnerState, type TextareaProps, type TextareaResize, type TextareaSize, type TextareaVariant, type ThemeContextValue, type ThemeMode, type ThemeOptions, ThemeProvider, type ThemeProviderProps, ThemeScript, type ThemeScriptProps, type TimeFormat, TimePicker, type TimePickerProps, Toast, ToastContext, ToastItem, type ToastOptions, type ToastPosition, ToastProvider, type ToastProviderProps, type ToastRecord, type ToastStatus, Tooltip, type TooltipOwnerState, type TooltipPlacement, type TooltipProps, TouchRipple, type TouchRippleProps, type TouchRippleRef, type Transitions, type TreeNode, type TreeNodeState, TreeView, type TreeViewProps, type TreeViewSelectionMode, type TypeAction, type TypeBackground, type TypeText, Typography, type TypographyAlign, type TypographyOwnerState, type TypographyProps, type TypographyStyle, type TypographyTheme, type TypographyVariant, type UseFormValidationOptions, type UseFormValidationReturn, type UseRippleOptions, type UseRippleReturn, type UseToastReturn, type ZIndex, addDays, addMonths, addYears, breakpointKeys, createBreakpoints, createLocalDate, createPalette, createShadows, createShouldForwardProp, createSpacing, createTheme, darkPalette, defaultBreakpoints, defaultDarkTheme, defaultShadows, defaultSpacing, defaultTheme, defaultTransitions, defaultTypography, defaultZIndex, formatLocalDate, getCalendarGrid, getDaysInMonth, getInitials, getMonthLabel, getPaginationRange, getWeekdayLabels, isDateAfter, isDateBefore, isDateInRange, isLeapYear, isSameDay, isSameMonth, lightPalette, parseLocalDate, parseSx, resolveComponentOverrides, resolveTypographyColor, rootShouldForwardProp, styled, useAccordionContext, useAccordionItemContext, useAlertContext, useAvatarContext, useAvatarGroupContext, useButtonGroupContext, useCheckboxGroup, useCombobox, useComboboxContext, useDrawerContext, useDropdownMenuContext, useFormField, useFormValidation, usePaginationContext, usePopoverContext, useRadioGroup, useRipple, useSelectContext, useTabsContext, useTheme, useToast };