@aviala-design/spiral 2.8.1 → 3.0.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, ImgHTMLAttributes, MouseEvent, AnchorHTMLAttributes, Ref, ReactElement, VideoHTMLAttributes } from 'react';
+import { ReactNode, CSSProperties, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, ImgHTMLAttributes, MouseEvent, AnchorHTMLAttributes, VideoHTMLAttributes } from 'react';
 import { ThemeMode, PaletteConfig, BaseNumbersDensity, ThemePreset } from '@aviala-design/tokens';
 export { BaseNumbersDensity, DEFAULT_PALETTE_CONFIG, HueFamily, PALETTE_HUE_FAMILIES, PaletteConfig } from '@aviala-design/tokens';
 import * as class_variance_authority_types from 'class-variance-authority/types';
@@ -9,8 +9,7 @@ import * as LabelPrimitive from '@radix-ui/react-label';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as SwitchPrimitive from '@radix-ui/react-switch';
-import * as react_hook_form from 'react-hook-form';
-import { FieldValues, FieldPath, UseControllerProps, Control, ControllerRenderProps, ControllerFieldState, UseFormStateReturn } from 'react-hook-form';
+export { u as useResolvedControlError } from './form-field-context-XYh-G1KL.cjs';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
@@ -144,6 +143,9 @@ type Locale = {
     Modal: {
         close: string;
     };
+    Drawer: {
+        close: string;
+    };
     Feedback: {
         close: string;
     };
@@ -188,7 +190,7 @@ type LocaleProviderProps = {
     /** Locale pack. Defaults to `zhCN`. */
     locale?: Locale;
 };
-declare function LocaleProvider({ children, locale }: LocaleProviderProps): react.JSX.Element;
+declare function LocaleProvider({ children, locale, }: LocaleProviderProps): react.JSX.Element;
 
 /** Current locale pack (falls back to zh-CN when no Provider). */
 declare function useLocale(): Locale;
@@ -437,12 +439,7 @@ declare namespace SelectSubMenu {
     var displayName: string;
 }
 type SelectProps = ComponentPropsWithoutRef<typeof SelectPrimitive.Root>;
-/**
- * Radix Select closes on `window` blur (e.g. focusing DevTools). Suppress only
- * blur-initiated closes; pointer-down (outside click, item select, trigger toggle)
- * and Escape must still dismiss on the first interaction.
- */
-declare function Select({ open: openProp, defaultOpen, onOpenChange, ...props }: SelectProps): react.JSX.Element;
+declare function Select({ open: openProp, defaultOpen, onOpenChange, disabled, ...props }: SelectProps): react.JSX.Element;
 declare const SelectValue: react.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & react.RefAttributes<HTMLSpanElement>>;
 declare const SelectGroup: react.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & react.RefAttributes<HTMLDivElement>>;
 type SelectTriggerProps = ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger> & {
@@ -745,7 +742,6 @@ type LoadingLevel = "display" | "headline1" | "headline2" | "title" | "subtitle"
 type LoadingMode = "theme" | "themeText" | "black" | "white" | "inherit";
 declare const loadingVariants: (props?: ({
     level?: "display" | "headline1" | "headline2" | "title" | "subtitle" | "text" | "caption" | null | undefined;
-    mode?: "theme" | "themeText" | "black" | "white" | "inherit" | null | undefined;
     lineHeightFix?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const BUTTON_SIZE_TO_LOADING_LEVEL: {
@@ -757,14 +753,17 @@ declare const BUTTON_SIZE_TO_LOADING_LEVEL: {
 type LoadingButtonSize = keyof typeof BUTTON_SIZE_TO_LOADING_LEVEL;
 declare function loadingLevelForButtonSize(size: LoadingButtonSize): LoadingLevel;
 type LoadingProps = HTMLAttributes<HTMLSpanElement> & VariantProps<typeof loadingVariants> & {
+    /** Ring color source; applied through the inline conic gradient, not a class. */
+    mode?: LoadingMode;
     /** Accessible name; omit when decorative (`aria-hidden`). */
     label?: string;
 };
 declare const Loading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & VariantProps<(props?: ({
     level?: "display" | "headline1" | "headline2" | "title" | "subtitle" | "text" | "caption" | null | undefined;
-    mode?: "theme" | "themeText" | "black" | "white" | "inherit" | null | undefined;
     lineHeightFix?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & {
+    /** Ring color source; applied through the inline conic gradient, not a class. */
+    mode?: LoadingMode;
     /** Accessible name; omit when decorative (`aria-hidden`). */
     label?: string;
 } & react.RefAttributes<HTMLSpanElement>>;
@@ -932,89 +931,6 @@ declare const SegmentatorItem: react.ForwardRefExoticComponent<Omit<ButtonHTMLAt
     iconOnly?: boolean;
 } & react.RefAttributes<HTMLButtonElement>>;
 
-/** Figma Components → System Composition → Form (527:57461 / 527:57641) */
-type FormFieldDirection = "vertical" | "horizontal";
-/**
- * Resolve a control `error` prop against the surrounding FormField.
- * Explicit `error={true|false}` wins; otherwise inherits FormField tip invalidity.
- */
-declare function useResolvedControlError(errorProp?: boolean): boolean;
-/** Layout mode — the original props-driven wrapper */
-type FormFieldLayoutProps = HTMLAttributes<HTMLDivElement> & {
-    label?: ReactNode;
-    htmlFor?: string;
-    description?: ReactNode;
-    error?: ReactNode;
-    info?: ReactNode;
-    /** Optional Alert / Feedback under the control */
-    alert?: ReactNode;
-    required?: boolean;
-    /** Figma `Direction` — vertical stacks label above control; horizontal places label beside */
-    direction?: FormFieldDirection;
-    children?: ReactNode;
-};
-/** Render arguments passed to `render` in react-hook-form mode */
-type FormFieldRenderProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = {
-    field: ControllerRenderProps<TFieldValues, TName>;
-    fieldState: ControllerFieldState;
-    formState: UseFormStateReturn<TFieldValues>;
-    /**
-     * Auto-generated control id. The field label is already wired to it via
-     * `htmlFor` — pass it to the underlying input (`<Input id={id} />`).
-     */
-    id: string;
-};
-/**
- * react-hook-form mode — bind the field to a form via `name` (+ optional
- * `control`; falls back to the surrounding `<Form>` context). Validation
- * errors from the resolver (zod etc.) are rendered automatically unless the
- * `error` prop overrides them. Nested controls inherit the invalid state via
- * context unless they set an explicit `error` prop.
- */
-type FormFieldControlledProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = Omit<FormFieldLayoutProps, "children" | "htmlFor"> & Pick<UseControllerProps<TFieldValues, TName>, "rules" | "defaultValue" | "shouldUnregister" | "disabled"> & {
-    name: TName;
-    control?: Control<TFieldValues>;
-    render: (props: FormFieldRenderProps<TFieldValues, TName>) => ReactNode;
-    /** Overrides the validation error message shown under the control */
-    error?: ReactNode;
-};
-type FormFieldProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = FormFieldLayoutProps | FormFieldControlledProps<TFieldValues, TName>;
-/**
- * FormField — layout wrapper around a form control, or a react-hook-form
- * bound field when given `name` + `render` (shadcn-style).
- *
- * When an error tip is shown, nested Spiral controls that support `error`
- * (Input, Textarea, SelectTrigger, …) inherit the invalid state unless they
- * set an explicit `error` prop.
- *
- * @example Layout mode
- * <FormField label="Email" htmlFor="email" error="Required">
- *   <Input id="email" />
- * </FormField>
- *
- * @example react-hook-form + zod mode
- * <Form {...form}>
- *   <form onSubmit={form.handleSubmit(onSubmit)}>
- *     <FormField
- *       control={form.control}
- *       name="email"
- *       label="Email"
- *       render={({ field, id }) => (
- *         <Input id={id} {...field} />
- *       )}
- *     />
- *   </form>
- * </Form>
- */
-declare const FormField: {
-    <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>(props: FormFieldProps<TFieldValues, TName> & {
-        ref?: Ref<HTMLDivElement>;
-    }): ReactElement | null;
-    displayName?: string;
-};
-/** Alias of react-hook-form's FormProvider — wrap your form with it (shadcn-style `<Form {...form}>`) */
-declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
-
 /** Figma Components → System Composition → Typography (128:85) */
 type TypographyLevel = "display" | "headline1" | "headline2" | "title" | "subtitle" | "text" | "caption";
 type TypographyContent = "text" | "number";
@@ -1372,9 +1288,11 @@ type CascaderItemProps = {
 declare const CascaderItem: react.ForwardRefExoticComponent<CascaderItemProps & react.RefAttributes<HTMLButtonElement>>;
 type CascaderOptionsMenuProps = {
     className?: string;
+    /** Optional group header above each column's options — omitted by default */
+    groupTitle?: ReactNode;
 };
 /** Renders cascade columns from `Cascader` `options` prop. */
-declare function CascaderOptionsMenu({ className }: CascaderOptionsMenuProps): react.JSX.Element;
+declare function CascaderOptionsMenu({ className, groupTitle, }: CascaderOptionsMenuProps): react.JSX.Element;
 type CascaderFieldProps = Omit<CascaderProps, "children"> & Omit<CascaderTriggerProps, "displayValue"> & {
     contentClassName?: string;
     menuClassName?: string;
@@ -1578,7 +1496,7 @@ type TimePickerWheelsProps = {
     onChange: (value: TimePickerWheelsValue) => void;
     className?: string;
 };
-declare function TimePickerWheels({ value, onChange, className }: TimePickerWheelsProps): react.JSX.Element;
+declare function TimePickerWheels({ value, onChange, className, }: TimePickerWheelsProps): react.JSX.Element;
 
 type PopoverProps = ComponentPropsWithoutRef<typeof PopoverPrimitive.Root>;
 /**
@@ -1757,6 +1675,75 @@ declare const ModalBody: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivE
 type ModalFooterProps = HTMLAttributes<HTMLDivElement>;
 declare const ModalFooter: react.ForwardRefExoticComponent<ModalFooterProps & react.RefAttributes<HTMLDivElement>>;
 
+/** Figma Components → Drawer (2051:26823) */
+type DrawerPosition = "left" | "right" | "top" | "bottom";
+declare const drawerContentVariants: (props?: ({
+    position?: "left" | "right" | "bottom" | "top" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type DrawerProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
+declare const Drawer: react.FC<DialogPrimitive.DialogProps>;
+declare const DrawerTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+declare const DrawerPortal: react.FC<DialogPrimitive.DialogPortalProps>;
+declare const DrawerClose: react.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
+type DrawerOverlayProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
+declare const DrawerOverlay: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+type DrawerContentProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & VariantProps<typeof drawerContentVariants> & {
+    /** Render without Portal — use inside nested overlays. */
+    portalled?: boolean;
+    /** Show the default overlay scrim. */
+    showOverlay?: boolean;
+};
+declare const DrawerContent: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & VariantProps<(props?: ({
+    position?: "left" | "right" | "bottom" | "top" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+    /** Render without Portal — use inside nested overlays. */
+    portalled?: boolean;
+    /** Show the default overlay scrim. */
+    showOverlay?: boolean;
+} & react.RefAttributes<HTMLDivElement>>;
+type DrawerHeaderProps = HTMLAttributes<HTMLDivElement> & {
+    /** Optional leading status icon */
+    icon?: ReactNode;
+    /** Show the leading icon slot */
+    showIcon?: boolean;
+    /** Show the header close control */
+    showClose?: boolean;
+    closeLabel?: string;
+};
+declare const DrawerHeader: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /** Optional leading status icon */
+    icon?: ReactNode;
+    /** Show the leading icon slot */
+    showIcon?: boolean;
+    /** Show the header close control */
+    showClose?: boolean;
+    closeLabel?: string;
+} & react.RefAttributes<HTMLDivElement>>;
+type DrawerTitleProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
+declare const DrawerTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & react.RefAttributes<HTMLHeadingElement>, "ref"> & react.RefAttributes<HTMLHeadingElement>>;
+type DrawerDescriptionProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
+declare const DrawerDescription: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
+/** Convenience wrapper — Figma header Typeface (text + caption). */
+type DrawerHeaderTextProps = Omit<DrawerHeaderProps, "children"> & {
+    title: ReactNode;
+    description?: ReactNode;
+};
+declare function DrawerHeaderText({ title, description, ...props }: DrawerHeaderTextProps): react.JSX.Element;
+type DrawerBodyProps = HTMLAttributes<HTMLDivElement> & {
+    /** Figma `Content=Text` — title + body copy preset */
+    layout?: "default" | "text";
+    title?: ReactNode;
+    description?: ReactNode;
+};
+declare const DrawerBody: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /** Figma `Content=Text` — title + body copy preset */
+    layout?: "default" | "text";
+    title?: ReactNode;
+    description?: ReactNode;
+} & react.RefAttributes<HTMLDivElement>>;
+type DrawerFooterProps = HTMLAttributes<HTMLDivElement>;
+declare const DrawerFooter: react.ForwardRefExoticComponent<DrawerFooterProps & react.RefAttributes<HTMLDivElement>>;
+
 /** Default show delay — 300ms per ALD / Radix convention. */
 declare const TOOLTIP_DELAY_DURATION = 300;
 interface TooltipProviderProps {
@@ -2002,7 +1989,7 @@ type ListItemGroupProps = {
     className?: string;
 };
 /** Convenience wrapper — titled list section (Figma List title + card) */
-declare function ListItemGroup({ label, children, className }: ListItemGroupProps): react.JSX.Element;
+declare function ListItemGroup({ label, children, className, }: ListItemGroupProps): react.JSX.Element;
 type ListDividerProps = HTMLAttributes<HTMLSpanElement>;
 /** Vertical divider between trailing actions (Figma `last` separator) */
 declare const ListDivider: react.ForwardRefExoticComponent<ListDividerProps & react.RefAttributes<HTMLSpanElement>>;
@@ -2722,4 +2709,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function initKeyboardFocus(): void;
 
-export { Alert, type AlertAppearance, type AlertProps, type AlertSize, type AlertType, Anchor, type AnchorIndentLevel, AnchorItem, type AnchorItemProps, type AnchorProps, Avatar, type AvatarContent, type AvatarLevel, type AvatarProps, Badge, type BadgeLevel, type BadgeLineHeightFix, type BadgeProps, type BadgeStyle, Breadcrumb, BreadcrumbEllipsis, BreadcrumbEllipsisItem, type BreadcrumbEllipsisItemProps, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, type BreadcrumbSize, Button, type ButtonMode, type ButtonProps, type ButtonSize, Card, CardBody, type CardBodyProps, CardBottom, type CardBottomProps, CardHead, type CardHeadProps, type CardProps, type CardSlotType, Cascader, CascaderColumn, type CascaderColumnProps, CascaderContent, type CascaderContentProps, CascaderField, type CascaderFieldProps, CascaderItem, type CascaderItemFunction, CascaderItemGroup, type CascaderItemGroupProps, type CascaderItemLayout, type CascaderItemProps, CascaderMenu, type CascaderMenuProps, type CascaderOption, CascaderOptionsMenu, type CascaderOptionsMenuProps, type CascaderProps, type CascaderSize, CascaderTrigger, type CascaderTriggerProps, Checkbox, CheckboxGroup, type CheckboxGroupDirection, type CheckboxGroupProps, CheckboxInput, type CheckboxInputProps, type CheckboxProps, type CheckboxSize, type ColorFormat, ColorPickButton, type ColorPickButtonProps, ColorPicker, ColorPickerArea, type ColorPickerAreaProps, ColorPickerContent, type ColorPickerContentProps, ColorPickerInputs, type ColorPickerInputsProps, ColorPickerPanel, type ColorPickerPanelProps, ColorPickerPresets, type ColorPickerPresetsProps, type ColorPickerProps, ColorPickerSlider, type ColorPickerSliderProps, ColorPickerTrigger, type ColorPickerTriggerProps, ConfigProvider, type ConfigProviderProps, DEFAULT_COLOR, DEFAULT_PLAYBACK_RATES, DatePicker, DatePickerCalendar, type DatePickerCalendarProps, DatePickerContent, type DatePickerContentProps, DatePickerField, type DatePickerFieldProps, type DatePickerMode, type DatePickerPanel, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DatePickerSize, type DatePickerTimeValue, DatePickerTrigger, type DatePickerTriggerProps, type DateRange, type Direction, Feedback, type FeedbackMode, type FeedbackProps, type FeedbackSize, type FeedbackType, Fieldset, type FieldsetProps, Form, FormField, type FormFieldControlledProps, type FormFieldDirection, type FormFieldLayoutProps, type FormFieldProps, type FormFieldRenderProps, type HSVA, HoverPopover, type HoverPopoverProps, Input, InputGroup, InputGroupAddon, type InputGroupProps, type InputProps, type InputSize, Label, Link, type LinkLevel, type LinkMode, type LinkProps, List, ListDivider, type ListDividerProps, ListGroup, type ListGroupProps, ListItem, ListItemGroup, type ListItemGroupProps, type ListItemLeading, type ListItemProps, type ListItemType, type ListProps, ListSeparator, type ListSeparatorProps, ListTitle, type ListTitleProps, Loading, type LoadingButtonSize, type LoadingLevel, type LoadingMode, type LoadingProps, type Locale, type LocaleComponentName, LocaleProvider, type LocaleProviderProps, Modal, ModalBody, type ModalBodyProps, ModalClose, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalHeaderText, type ModalHeaderTextProps, ModalOverlay, type ModalOverlayProps, ModalPortal, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, ModalTrigger, Navigation, NavigationActions, type NavigationActionsProps, NavigationActionsSlot, type NavigationActionsSlotProps, type NavigationBackground, NavigationBrand, type NavigationBrandProps, NavigationBrandTitle, type NavigationBrandTitleProps, type NavigationDirection, NavigationGroup, type NavigationGroupProps, NavigationItem, NavigationItemGroup, type NavigationItemGroupProps, NavigationItemMenu, NavigationItemMenuContent, type NavigationItemMenuContentProps, NavigationItemMenuItem, type NavigationItemMenuItemProps, type NavigationItemMenuProps, NavigationItemMenuTrigger, type NavigationItemMenuTriggerProps, type NavigationItemProps, type NavigationItemType, type NavigationProps, NavigationSection, type NavigationSectionProps, NumberInput, type NumberInputProps, type NumberInputStyle, OverlayContainerProvider, type OverlayContainerProviderProps, Pagehead, type PageheadProps, Pagination, type PaginationProps, type PhysicalSide, Popover, PopoverAnchor, type PopoverAppearance, PopoverContent, type PopoverContentLevel, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type ProgressProps, type ProgressShape, type ProgressSize, type ProgressType, RESPONSIVE_TOOLTIP_LONG_PRESS_MS, RadioGroup, type RadioGroupDirection, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RadioInput, type RadioInputProps, type RadioInputVariant, ResponsiveTooltip, type ResponsiveTooltipProps, Scroll, type ScrollOrientation, ScrollPicker, ScrollPickerColumn, type ScrollPickerColumnProps, ScrollPickerItem, type ScrollPickerItemProps, type ScrollPickerProps, type ScrollProps, type ScrollSize, type SegmentatorDirection, SegmentatorGroup, type SegmentatorGroupProps, SegmentatorItem, type SegmentatorItemProps, type SegmentatorMode, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, type SelectItemFunction, SelectItemGroup, type SelectItemGroupProps, type SelectItemLayout, SelectItemPeople, type SelectItemPeopleProps, type SelectItemProps, SelectLabel, type SelectLabelProps, SelectSeparator, type SelectSeparatorProps, type SelectSize, SelectSubItem, SelectSubItemPeople, type SelectSubItemPeopleProps, type SelectSubItemProps, SelectSubMenu, type SelectSubMenuProps, SelectTrigger, type SelectTriggerProps, SelectValue, Slider, type SliderProps, type SliderSize, type SliderType, Stack, type StackProps, Steps, type StepsDirection, StepsIcon, type StepsIconProps, StepsItem, type StepsItemProps, type StepsProps, type StepsState, Switch, type SwitchProps, type SwitchSize, TOOLTIP_DELAY_DURATION, Tab, type TabBackground, TabItem, type TabItemProps, type TabProps, type TabStyle, Table, TableCell, type TableCellContent, type TableCellProps, TableHead, type TableHeadProps, type TableProps, TableRow, type TableRowProps, Tag, TagClose, type TagCloseProps, type TagContent, type TagLevel, type TagLineHeightFix, type TagProps, Textarea, type TextareaProps, type TextareaSize, ThemeProvider, type ThemeProviderProps, ThemeScript, TimePicker, TimePickerContent, type TimePickerContentProps, TimePickerField, type TimePickerFieldProps, TimePickerPanel, type TimePickerPanelProps, type TimePickerProps, type TimePickerSize, TimePickerTrigger, type TimePickerTriggerProps, type TimePickerValue, TimePickerWheels, type TimePickerWheelsValue, Tooltip, TooltipContent, type TooltipContentLevel, type TooltipContentProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, Typeface, type TypefaceContent, TypefacePair, type TypefacePairProps, type TypefaceProps, Typography, type TypographyContent, type TypographyLevel, type TypographyProps, type TypographyTone, Upload, type UploadProps, type UploadStyle, type UseColorPickerStateOptions, Video, type VideoAppearance, type VideoHandle, type VideoObjectFit, type VideoProps, alertVariants, backChevronSide, buttonVariants, cn, enUS, formatDisplayDate, formatMonthYear, formatTimeValue, formatVideoTime, forwardChevronSide, initKeyboardFocus, inputRootVariants, interpolate, loadingLevelForButtonSize, mirrorSide, mirrorSideForDirection, modalContentVariants, numberInputRootVariants, parseDateInput, parseDateRangeInput, parseVideoTime, typographyVariants, useColorPickerState, useDirection, useLocale, useLocaleMessages, useOverlayPortalContainer, useResolvedControlError, useRtl, useTheme, useThemeLayoutKey, videoObjectFitToCss, zhCN };
+export { Alert, type AlertAppearance, type AlertProps, type AlertSize, type AlertType, Anchor, type AnchorIndentLevel, AnchorItem, type AnchorItemProps, type AnchorProps, Avatar, type AvatarContent, type AvatarLevel, type AvatarProps, Badge, type BadgeLevel, type BadgeLineHeightFix, type BadgeProps, type BadgeStyle, Breadcrumb, BreadcrumbEllipsis, BreadcrumbEllipsisItem, type BreadcrumbEllipsisItemProps, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, type BreadcrumbSize, Button, type ButtonMode, type ButtonProps, type ButtonSize, Card, CardBody, type CardBodyProps, CardBottom, type CardBottomProps, CardHead, type CardHeadProps, type CardProps, type CardSlotType, Cascader, CascaderColumn, type CascaderColumnProps, CascaderContent, type CascaderContentProps, CascaderField, type CascaderFieldProps, CascaderItem, type CascaderItemFunction, CascaderItemGroup, type CascaderItemGroupProps, type CascaderItemLayout, type CascaderItemProps, CascaderMenu, type CascaderMenuProps, type CascaderOption, CascaderOptionsMenu, type CascaderOptionsMenuProps, type CascaderProps, type CascaderSize, CascaderTrigger, type CascaderTriggerProps, Checkbox, CheckboxGroup, type CheckboxGroupDirection, type CheckboxGroupProps, CheckboxInput, type CheckboxInputProps, type CheckboxProps, type CheckboxSize, type ColorFormat, ColorPickButton, type ColorPickButtonProps, ColorPicker, ColorPickerArea, type ColorPickerAreaProps, ColorPickerContent, type ColorPickerContentProps, ColorPickerInputs, type ColorPickerInputsProps, ColorPickerPanel, type ColorPickerPanelProps, ColorPickerPresets, type ColorPickerPresetsProps, type ColorPickerProps, ColorPickerSlider, type ColorPickerSliderProps, ColorPickerTrigger, type ColorPickerTriggerProps, ConfigProvider, type ConfigProviderProps, DEFAULT_COLOR, DEFAULT_PLAYBACK_RATES, DatePicker, DatePickerCalendar, type DatePickerCalendarProps, DatePickerContent, type DatePickerContentProps, DatePickerField, type DatePickerFieldProps, type DatePickerMode, type DatePickerPanel, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DatePickerSize, type DatePickerTimeValue, DatePickerTrigger, type DatePickerTriggerProps, type DateRange, type Direction, Drawer, DrawerBody, type DrawerBodyProps, DrawerClose, DrawerContent, type DrawerContentProps, DrawerDescription, type DrawerDescriptionProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, DrawerHeaderText, type DrawerHeaderTextProps, DrawerOverlay, type DrawerOverlayProps, DrawerPortal, type DrawerPosition, type DrawerProps, DrawerTitle, type DrawerTitleProps, DrawerTrigger, Feedback, type FeedbackMode, type FeedbackProps, type FeedbackSize, type FeedbackType, Fieldset, type FieldsetProps, type HSVA, HoverPopover, type HoverPopoverProps, Input, InputGroup, InputGroupAddon, type InputGroupProps, type InputProps, type InputSize, Label, Link, type LinkLevel, type LinkMode, type LinkProps, List, ListDivider, type ListDividerProps, ListGroup, type ListGroupProps, ListItem, ListItemGroup, type ListItemGroupProps, type ListItemLeading, type ListItemProps, type ListItemType, type ListProps, ListSeparator, type ListSeparatorProps, ListTitle, type ListTitleProps, Loading, type LoadingButtonSize, type LoadingLevel, type LoadingMode, type LoadingProps, type Locale, type LocaleComponentName, LocaleProvider, type LocaleProviderProps, Modal, ModalBody, type ModalBodyProps, ModalClose, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalHeaderText, type ModalHeaderTextProps, ModalOverlay, type ModalOverlayProps, ModalPortal, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, ModalTrigger, Navigation, NavigationActions, type NavigationActionsProps, NavigationActionsSlot, type NavigationActionsSlotProps, type NavigationBackground, NavigationBrand, type NavigationBrandProps, NavigationBrandTitle, type NavigationBrandTitleProps, type NavigationDirection, NavigationGroup, type NavigationGroupProps, NavigationItem, NavigationItemGroup, type NavigationItemGroupProps, NavigationItemMenu, NavigationItemMenuContent, type NavigationItemMenuContentProps, NavigationItemMenuItem, type NavigationItemMenuItemProps, type NavigationItemMenuProps, NavigationItemMenuTrigger, type NavigationItemMenuTriggerProps, type NavigationItemProps, type NavigationItemType, type NavigationProps, NavigationSection, type NavigationSectionProps, NumberInput, type NumberInputProps, type NumberInputStyle, OverlayContainerProvider, type OverlayContainerProviderProps, Pagehead, type PageheadProps, Pagination, type PaginationProps, type PhysicalSide, Popover, PopoverAnchor, type PopoverAppearance, PopoverContent, type PopoverContentLevel, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type ProgressProps, type ProgressShape, type ProgressSize, type ProgressType, RESPONSIVE_TOOLTIP_LONG_PRESS_MS, RadioGroup, type RadioGroupDirection, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RadioInput, type RadioInputProps, type RadioInputVariant, ResponsiveTooltip, type ResponsiveTooltipProps, Scroll, type ScrollOrientation, ScrollPicker, ScrollPickerColumn, type ScrollPickerColumnProps, ScrollPickerItem, type ScrollPickerItemProps, type ScrollPickerProps, type ScrollProps, type ScrollSize, type SegmentatorDirection, SegmentatorGroup, type SegmentatorGroupProps, SegmentatorItem, type SegmentatorItemProps, type SegmentatorMode, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, type SelectItemFunction, SelectItemGroup, type SelectItemGroupProps, type SelectItemLayout, SelectItemPeople, type SelectItemPeopleProps, type SelectItemProps, SelectLabel, type SelectLabelProps, SelectSeparator, type SelectSeparatorProps, type SelectSize, SelectSubItem, SelectSubItemPeople, type SelectSubItemPeopleProps, type SelectSubItemProps, SelectSubMenu, type SelectSubMenuProps, SelectTrigger, type SelectTriggerProps, SelectValue, Slider, type SliderProps, type SliderSize, type SliderType, Stack, type StackProps, Steps, type StepsDirection, StepsIcon, type StepsIconProps, StepsItem, type StepsItemProps, type StepsProps, type StepsState, Switch, type SwitchProps, type SwitchSize, TOOLTIP_DELAY_DURATION, Tab, type TabBackground, TabItem, type TabItemProps, type TabProps, type TabStyle, Table, TableCell, type TableCellContent, type TableCellProps, TableHead, type TableHeadProps, type TableProps, TableRow, type TableRowProps, Tag, TagClose, type TagCloseProps, type TagContent, type TagLevel, type TagLineHeightFix, type TagProps, Textarea, type TextareaProps, type TextareaSize, ThemeProvider, type ThemeProviderProps, ThemeScript, TimePicker, TimePickerContent, type TimePickerContentProps, TimePickerField, type TimePickerFieldProps, TimePickerPanel, type TimePickerPanelProps, type TimePickerProps, type TimePickerSize, TimePickerTrigger, type TimePickerTriggerProps, type TimePickerValue, TimePickerWheels, type TimePickerWheelsValue, Tooltip, TooltipContent, type TooltipContentLevel, type TooltipContentProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, Typeface, type TypefaceContent, TypefacePair, type TypefacePairProps, type TypefaceProps, Typography, type TypographyContent, type TypographyLevel, type TypographyProps, type TypographyTone, Upload, type UploadProps, type UploadStyle, type UseColorPickerStateOptions, Video, type VideoAppearance, type VideoHandle, type VideoObjectFit, type VideoProps, alertVariants, backChevronSide, buttonVariants, cn, drawerContentVariants, enUS, formatDisplayDate, formatMonthYear, formatTimeValue, formatVideoTime, forwardChevronSide, initKeyboardFocus, inputRootVariants, interpolate, loadingLevelForButtonSize, mirrorSide, mirrorSideForDirection, modalContentVariants, numberInputRootVariants, parseDateInput, parseDateRangeInput, parseVideoTime, typographyVariants, useColorPickerState, useDirection, useLocale, useLocaleMessages, useOverlayPortalContainer, useRtl, useTheme, useThemeLayoutKey, videoObjectFitToCss, zhCN };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, ImgHTMLAttributes, MouseEvent, AnchorHTMLAttributes, Ref, ReactElement, VideoHTMLAttributes } from 'react';
+import { ReactNode, CSSProperties, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, ImgHTMLAttributes, MouseEvent, AnchorHTMLAttributes, VideoHTMLAttributes } from 'react';
 import { ThemeMode, PaletteConfig, BaseNumbersDensity, ThemePreset } from '@aviala-design/tokens';
 export { BaseNumbersDensity, DEFAULT_PALETTE_CONFIG, HueFamily, PALETTE_HUE_FAMILIES, PaletteConfig } from '@aviala-design/tokens';
 import * as class_variance_authority_types from 'class-variance-authority/types';
@@ -9,8 +9,7 @@ import * as LabelPrimitive from '@radix-ui/react-label';
 import * as CheckboxPrimitive from '@radix-ui/react-checkbox';
 import * as RadioGroupPrimitive from '@radix-ui/react-radio-group';
 import * as SwitchPrimitive from '@radix-ui/react-switch';
-import * as react_hook_form from 'react-hook-form';
-import { FieldValues, FieldPath, UseControllerProps, Control, ControllerRenderProps, ControllerFieldState, UseFormStateReturn } from 'react-hook-form';
+export { u as useResolvedControlError } from './form-field-context-XYh-G1KL.js';
 import * as PopoverPrimitive from '@radix-ui/react-popover';
 import * as DialogPrimitive from '@radix-ui/react-dialog';
 import * as TooltipPrimitive from '@radix-ui/react-tooltip';
@@ -144,6 +143,9 @@ type Locale = {
     Modal: {
         close: string;
     };
+    Drawer: {
+        close: string;
+    };
     Feedback: {
         close: string;
     };
@@ -188,7 +190,7 @@ type LocaleProviderProps = {
     /** Locale pack. Defaults to `zhCN`. */
     locale?: Locale;
 };
-declare function LocaleProvider({ children, locale }: LocaleProviderProps): react.JSX.Element;
+declare function LocaleProvider({ children, locale, }: LocaleProviderProps): react.JSX.Element;
 
 /** Current locale pack (falls back to zh-CN when no Provider). */
 declare function useLocale(): Locale;
@@ -437,12 +439,7 @@ declare namespace SelectSubMenu {
     var displayName: string;
 }
 type SelectProps = ComponentPropsWithoutRef<typeof SelectPrimitive.Root>;
-/**
- * Radix Select closes on `window` blur (e.g. focusing DevTools). Suppress only
- * blur-initiated closes; pointer-down (outside click, item select, trigger toggle)
- * and Escape must still dismiss on the first interaction.
- */
-declare function Select({ open: openProp, defaultOpen, onOpenChange, ...props }: SelectProps): react.JSX.Element;
+declare function Select({ open: openProp, defaultOpen, onOpenChange, disabled, ...props }: SelectProps): react.JSX.Element;
 declare const SelectValue: react.ForwardRefExoticComponent<SelectPrimitive.SelectValueProps & react.RefAttributes<HTMLSpanElement>>;
 declare const SelectGroup: react.ForwardRefExoticComponent<SelectPrimitive.SelectGroupProps & react.RefAttributes<HTMLDivElement>>;
 type SelectTriggerProps = ComponentPropsWithoutRef<typeof SelectPrimitive.Trigger> & {
@@ -745,7 +742,6 @@ type LoadingLevel = "display" | "headline1" | "headline2" | "title" | "subtitle"
 type LoadingMode = "theme" | "themeText" | "black" | "white" | "inherit";
 declare const loadingVariants: (props?: ({
     level?: "display" | "headline1" | "headline2" | "title" | "subtitle" | "text" | "caption" | null | undefined;
-    mode?: "theme" | "themeText" | "black" | "white" | "inherit" | null | undefined;
     lineHeightFix?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string;
 declare const BUTTON_SIZE_TO_LOADING_LEVEL: {
@@ -757,14 +753,17 @@ declare const BUTTON_SIZE_TO_LOADING_LEVEL: {
 type LoadingButtonSize = keyof typeof BUTTON_SIZE_TO_LOADING_LEVEL;
 declare function loadingLevelForButtonSize(size: LoadingButtonSize): LoadingLevel;
 type LoadingProps = HTMLAttributes<HTMLSpanElement> & VariantProps<typeof loadingVariants> & {
+    /** Ring color source; applied through the inline conic gradient, not a class. */
+    mode?: LoadingMode;
     /** Accessible name; omit when decorative (`aria-hidden`). */
     label?: string;
 };
 declare const Loading: react.ForwardRefExoticComponent<HTMLAttributes<HTMLSpanElement> & VariantProps<(props?: ({
     level?: "display" | "headline1" | "headline2" | "title" | "subtitle" | "text" | "caption" | null | undefined;
-    mode?: "theme" | "themeText" | "black" | "white" | "inherit" | null | undefined;
     lineHeightFix?: boolean | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & {
+    /** Ring color source; applied through the inline conic gradient, not a class. */
+    mode?: LoadingMode;
     /** Accessible name; omit when decorative (`aria-hidden`). */
     label?: string;
 } & react.RefAttributes<HTMLSpanElement>>;
@@ -932,89 +931,6 @@ declare const SegmentatorItem: react.ForwardRefExoticComponent<Omit<ButtonHTMLAt
     iconOnly?: boolean;
 } & react.RefAttributes<HTMLButtonElement>>;
 
-/** Figma Components → System Composition → Form (527:57461 / 527:57641) */
-type FormFieldDirection = "vertical" | "horizontal";
-/**
- * Resolve a control `error` prop against the surrounding FormField.
- * Explicit `error={true|false}` wins; otherwise inherits FormField tip invalidity.
- */
-declare function useResolvedControlError(errorProp?: boolean): boolean;
-/** Layout mode — the original props-driven wrapper */
-type FormFieldLayoutProps = HTMLAttributes<HTMLDivElement> & {
-    label?: ReactNode;
-    htmlFor?: string;
-    description?: ReactNode;
-    error?: ReactNode;
-    info?: ReactNode;
-    /** Optional Alert / Feedback under the control */
-    alert?: ReactNode;
-    required?: boolean;
-    /** Figma `Direction` — vertical stacks label above control; horizontal places label beside */
-    direction?: FormFieldDirection;
-    children?: ReactNode;
-};
-/** Render arguments passed to `render` in react-hook-form mode */
-type FormFieldRenderProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = {
-    field: ControllerRenderProps<TFieldValues, TName>;
-    fieldState: ControllerFieldState;
-    formState: UseFormStateReturn<TFieldValues>;
-    /**
-     * Auto-generated control id. The field label is already wired to it via
-     * `htmlFor` — pass it to the underlying input (`<Input id={id} />`).
-     */
-    id: string;
-};
-/**
- * react-hook-form mode — bind the field to a form via `name` (+ optional
- * `control`; falls back to the surrounding `<Form>` context). Validation
- * errors from the resolver (zod etc.) are rendered automatically unless the
- * `error` prop overrides them. Nested controls inherit the invalid state via
- * context unless they set an explicit `error` prop.
- */
-type FormFieldControlledProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = Omit<FormFieldLayoutProps, "children" | "htmlFor"> & Pick<UseControllerProps<TFieldValues, TName>, "rules" | "defaultValue" | "shouldUnregister" | "disabled"> & {
-    name: TName;
-    control?: Control<TFieldValues>;
-    render: (props: FormFieldRenderProps<TFieldValues, TName>) => ReactNode;
-    /** Overrides the validation error message shown under the control */
-    error?: ReactNode;
-};
-type FormFieldProps<TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>> = FormFieldLayoutProps | FormFieldControlledProps<TFieldValues, TName>;
-/**
- * FormField — layout wrapper around a form control, or a react-hook-form
- * bound field when given `name` + `render` (shadcn-style).
- *
- * When an error tip is shown, nested Spiral controls that support `error`
- * (Input, Textarea, SelectTrigger, …) inherit the invalid state unless they
- * set an explicit `error` prop.
- *
- * @example Layout mode
- * <FormField label="Email" htmlFor="email" error="Required">
- *   <Input id="email" />
- * </FormField>
- *
- * @example react-hook-form + zod mode
- * <Form {...form}>
- *   <form onSubmit={form.handleSubmit(onSubmit)}>
- *     <FormField
- *       control={form.control}
- *       name="email"
- *       label="Email"
- *       render={({ field, id }) => (
- *         <Input id={id} {...field} />
- *       )}
- *     />
- *   </form>
- * </Form>
- */
-declare const FormField: {
-    <TFieldValues extends FieldValues = FieldValues, TName extends FieldPath<TFieldValues> = FieldPath<TFieldValues>>(props: FormFieldProps<TFieldValues, TName> & {
-        ref?: Ref<HTMLDivElement>;
-    }): ReactElement | null;
-    displayName?: string;
-};
-/** Alias of react-hook-form's FormProvider — wrap your form with it (shadcn-style `<Form {...form}>`) */
-declare const Form: <TFieldValues extends FieldValues, TContext = any, TTransformedValues = TFieldValues>({ children, watch, getValues, getFieldState, setError, clearErrors, setValue, setValues, trigger, formState, resetField, reset, resetDefaultValues, handleSubmit, unregister, control, register, setFocus, subscribe, }: react_hook_form.FormProviderProps<TFieldValues, TContext, TTransformedValues>) => React.JSX.Element;
-
 /** Figma Components → System Composition → Typography (128:85) */
 type TypographyLevel = "display" | "headline1" | "headline2" | "title" | "subtitle" | "text" | "caption";
 type TypographyContent = "text" | "number";
@@ -1372,9 +1288,11 @@ type CascaderItemProps = {
 declare const CascaderItem: react.ForwardRefExoticComponent<CascaderItemProps & react.RefAttributes<HTMLButtonElement>>;
 type CascaderOptionsMenuProps = {
     className?: string;
+    /** Optional group header above each column's options — omitted by default */
+    groupTitle?: ReactNode;
 };
 /** Renders cascade columns from `Cascader` `options` prop. */
-declare function CascaderOptionsMenu({ className }: CascaderOptionsMenuProps): react.JSX.Element;
+declare function CascaderOptionsMenu({ className, groupTitle, }: CascaderOptionsMenuProps): react.JSX.Element;
 type CascaderFieldProps = Omit<CascaderProps, "children"> & Omit<CascaderTriggerProps, "displayValue"> & {
     contentClassName?: string;
     menuClassName?: string;
@@ -1578,7 +1496,7 @@ type TimePickerWheelsProps = {
     onChange: (value: TimePickerWheelsValue) => void;
     className?: string;
 };
-declare function TimePickerWheels({ value, onChange, className }: TimePickerWheelsProps): react.JSX.Element;
+declare function TimePickerWheels({ value, onChange, className, }: TimePickerWheelsProps): react.JSX.Element;
 
 type PopoverProps = ComponentPropsWithoutRef<typeof PopoverPrimitive.Root>;
 /**
@@ -1757,6 +1675,75 @@ declare const ModalBody: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivE
 type ModalFooterProps = HTMLAttributes<HTMLDivElement>;
 declare const ModalFooter: react.ForwardRefExoticComponent<ModalFooterProps & react.RefAttributes<HTMLDivElement>>;
 
+/** Figma Components → Drawer (2051:26823) */
+type DrawerPosition = "left" | "right" | "top" | "bottom";
+declare const drawerContentVariants: (props?: ({
+    position?: "left" | "right" | "bottom" | "top" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+type DrawerProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Root>;
+declare const Drawer: react.FC<DialogPrimitive.DialogProps>;
+declare const DrawerTrigger: react.ForwardRefExoticComponent<DialogPrimitive.DialogTriggerProps & react.RefAttributes<HTMLButtonElement>>;
+declare const DrawerPortal: react.FC<DialogPrimitive.DialogPortalProps>;
+declare const DrawerClose: react.ForwardRefExoticComponent<DialogPrimitive.DialogCloseProps & react.RefAttributes<HTMLButtonElement>>;
+type DrawerOverlayProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Overlay>;
+declare const DrawerOverlay: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogOverlayProps & react.RefAttributes<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+type DrawerContentProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Content> & VariantProps<typeof drawerContentVariants> & {
+    /** Render without Portal — use inside nested overlays. */
+    portalled?: boolean;
+    /** Show the default overlay scrim. */
+    showOverlay?: boolean;
+};
+declare const DrawerContent: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogContentProps & react.RefAttributes<HTMLDivElement>, "ref"> & VariantProps<(props?: ({
+    position?: "left" | "right" | "bottom" | "top" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string> & {
+    /** Render without Portal — use inside nested overlays. */
+    portalled?: boolean;
+    /** Show the default overlay scrim. */
+    showOverlay?: boolean;
+} & react.RefAttributes<HTMLDivElement>>;
+type DrawerHeaderProps = HTMLAttributes<HTMLDivElement> & {
+    /** Optional leading status icon */
+    icon?: ReactNode;
+    /** Show the leading icon slot */
+    showIcon?: boolean;
+    /** Show the header close control */
+    showClose?: boolean;
+    closeLabel?: string;
+};
+declare const DrawerHeader: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /** Optional leading status icon */
+    icon?: ReactNode;
+    /** Show the leading icon slot */
+    showIcon?: boolean;
+    /** Show the header close control */
+    showClose?: boolean;
+    closeLabel?: string;
+} & react.RefAttributes<HTMLDivElement>>;
+type DrawerTitleProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Title>;
+declare const DrawerTitle: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogTitleProps & react.RefAttributes<HTMLHeadingElement>, "ref"> & react.RefAttributes<HTMLHeadingElement>>;
+type DrawerDescriptionProps = ComponentPropsWithoutRef<typeof DialogPrimitive.Description>;
+declare const DrawerDescription: react.ForwardRefExoticComponent<Omit<DialogPrimitive.DialogDescriptionProps & react.RefAttributes<HTMLParagraphElement>, "ref"> & react.RefAttributes<HTMLParagraphElement>>;
+/** Convenience wrapper — Figma header Typeface (text + caption). */
+type DrawerHeaderTextProps = Omit<DrawerHeaderProps, "children"> & {
+    title: ReactNode;
+    description?: ReactNode;
+};
+declare function DrawerHeaderText({ title, description, ...props }: DrawerHeaderTextProps): react.JSX.Element;
+type DrawerBodyProps = HTMLAttributes<HTMLDivElement> & {
+    /** Figma `Content=Text` — title + body copy preset */
+    layout?: "default" | "text";
+    title?: ReactNode;
+    description?: ReactNode;
+};
+declare const DrawerBody: react.ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & {
+    /** Figma `Content=Text` — title + body copy preset */
+    layout?: "default" | "text";
+    title?: ReactNode;
+    description?: ReactNode;
+} & react.RefAttributes<HTMLDivElement>>;
+type DrawerFooterProps = HTMLAttributes<HTMLDivElement>;
+declare const DrawerFooter: react.ForwardRefExoticComponent<DrawerFooterProps & react.RefAttributes<HTMLDivElement>>;
+
 /** Default show delay — 300ms per ALD / Radix convention. */
 declare const TOOLTIP_DELAY_DURATION = 300;
 interface TooltipProviderProps {
@@ -2002,7 +1989,7 @@ type ListItemGroupProps = {
     className?: string;
 };
 /** Convenience wrapper — titled list section (Figma List title + card) */
-declare function ListItemGroup({ label, children, className }: ListItemGroupProps): react.JSX.Element;
+declare function ListItemGroup({ label, children, className, }: ListItemGroupProps): react.JSX.Element;
 type ListDividerProps = HTMLAttributes<HTMLSpanElement>;
 /** Vertical divider between trailing actions (Figma `last` separator) */
 declare const ListDivider: react.ForwardRefExoticComponent<ListDividerProps & react.RefAttributes<HTMLSpanElement>>;
@@ -2722,4 +2709,4 @@ declare function cn(...inputs: ClassValue[]): string;
  */
 declare function initKeyboardFocus(): void;
 
-export { Alert, type AlertAppearance, type AlertProps, type AlertSize, type AlertType, Anchor, type AnchorIndentLevel, AnchorItem, type AnchorItemProps, type AnchorProps, Avatar, type AvatarContent, type AvatarLevel, type AvatarProps, Badge, type BadgeLevel, type BadgeLineHeightFix, type BadgeProps, type BadgeStyle, Breadcrumb, BreadcrumbEllipsis, BreadcrumbEllipsisItem, type BreadcrumbEllipsisItemProps, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, type BreadcrumbSize, Button, type ButtonMode, type ButtonProps, type ButtonSize, Card, CardBody, type CardBodyProps, CardBottom, type CardBottomProps, CardHead, type CardHeadProps, type CardProps, type CardSlotType, Cascader, CascaderColumn, type CascaderColumnProps, CascaderContent, type CascaderContentProps, CascaderField, type CascaderFieldProps, CascaderItem, type CascaderItemFunction, CascaderItemGroup, type CascaderItemGroupProps, type CascaderItemLayout, type CascaderItemProps, CascaderMenu, type CascaderMenuProps, type CascaderOption, CascaderOptionsMenu, type CascaderOptionsMenuProps, type CascaderProps, type CascaderSize, CascaderTrigger, type CascaderTriggerProps, Checkbox, CheckboxGroup, type CheckboxGroupDirection, type CheckboxGroupProps, CheckboxInput, type CheckboxInputProps, type CheckboxProps, type CheckboxSize, type ColorFormat, ColorPickButton, type ColorPickButtonProps, ColorPicker, ColorPickerArea, type ColorPickerAreaProps, ColorPickerContent, type ColorPickerContentProps, ColorPickerInputs, type ColorPickerInputsProps, ColorPickerPanel, type ColorPickerPanelProps, ColorPickerPresets, type ColorPickerPresetsProps, type ColorPickerProps, ColorPickerSlider, type ColorPickerSliderProps, ColorPickerTrigger, type ColorPickerTriggerProps, ConfigProvider, type ConfigProviderProps, DEFAULT_COLOR, DEFAULT_PLAYBACK_RATES, DatePicker, DatePickerCalendar, type DatePickerCalendarProps, DatePickerContent, type DatePickerContentProps, DatePickerField, type DatePickerFieldProps, type DatePickerMode, type DatePickerPanel, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DatePickerSize, type DatePickerTimeValue, DatePickerTrigger, type DatePickerTriggerProps, type DateRange, type Direction, Feedback, type FeedbackMode, type FeedbackProps, type FeedbackSize, type FeedbackType, Fieldset, type FieldsetProps, Form, FormField, type FormFieldControlledProps, type FormFieldDirection, type FormFieldLayoutProps, type FormFieldProps, type FormFieldRenderProps, type HSVA, HoverPopover, type HoverPopoverProps, Input, InputGroup, InputGroupAddon, type InputGroupProps, type InputProps, type InputSize, Label, Link, type LinkLevel, type LinkMode, type LinkProps, List, ListDivider, type ListDividerProps, ListGroup, type ListGroupProps, ListItem, ListItemGroup, type ListItemGroupProps, type ListItemLeading, type ListItemProps, type ListItemType, type ListProps, ListSeparator, type ListSeparatorProps, ListTitle, type ListTitleProps, Loading, type LoadingButtonSize, type LoadingLevel, type LoadingMode, type LoadingProps, type Locale, type LocaleComponentName, LocaleProvider, type LocaleProviderProps, Modal, ModalBody, type ModalBodyProps, ModalClose, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalHeaderText, type ModalHeaderTextProps, ModalOverlay, type ModalOverlayProps, ModalPortal, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, ModalTrigger, Navigation, NavigationActions, type NavigationActionsProps, NavigationActionsSlot, type NavigationActionsSlotProps, type NavigationBackground, NavigationBrand, type NavigationBrandProps, NavigationBrandTitle, type NavigationBrandTitleProps, type NavigationDirection, NavigationGroup, type NavigationGroupProps, NavigationItem, NavigationItemGroup, type NavigationItemGroupProps, NavigationItemMenu, NavigationItemMenuContent, type NavigationItemMenuContentProps, NavigationItemMenuItem, type NavigationItemMenuItemProps, type NavigationItemMenuProps, NavigationItemMenuTrigger, type NavigationItemMenuTriggerProps, type NavigationItemProps, type NavigationItemType, type NavigationProps, NavigationSection, type NavigationSectionProps, NumberInput, type NumberInputProps, type NumberInputStyle, OverlayContainerProvider, type OverlayContainerProviderProps, Pagehead, type PageheadProps, Pagination, type PaginationProps, type PhysicalSide, Popover, PopoverAnchor, type PopoverAppearance, PopoverContent, type PopoverContentLevel, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type ProgressProps, type ProgressShape, type ProgressSize, type ProgressType, RESPONSIVE_TOOLTIP_LONG_PRESS_MS, RadioGroup, type RadioGroupDirection, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RadioInput, type RadioInputProps, type RadioInputVariant, ResponsiveTooltip, type ResponsiveTooltipProps, Scroll, type ScrollOrientation, ScrollPicker, ScrollPickerColumn, type ScrollPickerColumnProps, ScrollPickerItem, type ScrollPickerItemProps, type ScrollPickerProps, type ScrollProps, type ScrollSize, type SegmentatorDirection, SegmentatorGroup, type SegmentatorGroupProps, SegmentatorItem, type SegmentatorItemProps, type SegmentatorMode, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, type SelectItemFunction, SelectItemGroup, type SelectItemGroupProps, type SelectItemLayout, SelectItemPeople, type SelectItemPeopleProps, type SelectItemProps, SelectLabel, type SelectLabelProps, SelectSeparator, type SelectSeparatorProps, type SelectSize, SelectSubItem, SelectSubItemPeople, type SelectSubItemPeopleProps, type SelectSubItemProps, SelectSubMenu, type SelectSubMenuProps, SelectTrigger, type SelectTriggerProps, SelectValue, Slider, type SliderProps, type SliderSize, type SliderType, Stack, type StackProps, Steps, type StepsDirection, StepsIcon, type StepsIconProps, StepsItem, type StepsItemProps, type StepsProps, type StepsState, Switch, type SwitchProps, type SwitchSize, TOOLTIP_DELAY_DURATION, Tab, type TabBackground, TabItem, type TabItemProps, type TabProps, type TabStyle, Table, TableCell, type TableCellContent, type TableCellProps, TableHead, type TableHeadProps, type TableProps, TableRow, type TableRowProps, Tag, TagClose, type TagCloseProps, type TagContent, type TagLevel, type TagLineHeightFix, type TagProps, Textarea, type TextareaProps, type TextareaSize, ThemeProvider, type ThemeProviderProps, ThemeScript, TimePicker, TimePickerContent, type TimePickerContentProps, TimePickerField, type TimePickerFieldProps, TimePickerPanel, type TimePickerPanelProps, type TimePickerProps, type TimePickerSize, TimePickerTrigger, type TimePickerTriggerProps, type TimePickerValue, TimePickerWheels, type TimePickerWheelsValue, Tooltip, TooltipContent, type TooltipContentLevel, type TooltipContentProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, Typeface, type TypefaceContent, TypefacePair, type TypefacePairProps, type TypefaceProps, Typography, type TypographyContent, type TypographyLevel, type TypographyProps, type TypographyTone, Upload, type UploadProps, type UploadStyle, type UseColorPickerStateOptions, Video, type VideoAppearance, type VideoHandle, type VideoObjectFit, type VideoProps, alertVariants, backChevronSide, buttonVariants, cn, enUS, formatDisplayDate, formatMonthYear, formatTimeValue, formatVideoTime, forwardChevronSide, initKeyboardFocus, inputRootVariants, interpolate, loadingLevelForButtonSize, mirrorSide, mirrorSideForDirection, modalContentVariants, numberInputRootVariants, parseDateInput, parseDateRangeInput, parseVideoTime, typographyVariants, useColorPickerState, useDirection, useLocale, useLocaleMessages, useOverlayPortalContainer, useResolvedControlError, useRtl, useTheme, useThemeLayoutKey, videoObjectFitToCss, zhCN };
+export { Alert, type AlertAppearance, type AlertProps, type AlertSize, type AlertType, Anchor, type AnchorIndentLevel, AnchorItem, type AnchorItemProps, type AnchorProps, Avatar, type AvatarContent, type AvatarLevel, type AvatarProps, Badge, type BadgeLevel, type BadgeLineHeightFix, type BadgeProps, type BadgeStyle, Breadcrumb, BreadcrumbEllipsis, BreadcrumbEllipsisItem, type BreadcrumbEllipsisItemProps, type BreadcrumbEllipsisProps, BreadcrumbItem, type BreadcrumbItemProps, type BreadcrumbProps, BreadcrumbSeparator, type BreadcrumbSeparatorProps, type BreadcrumbSize, Button, type ButtonMode, type ButtonProps, type ButtonSize, Card, CardBody, type CardBodyProps, CardBottom, type CardBottomProps, CardHead, type CardHeadProps, type CardProps, type CardSlotType, Cascader, CascaderColumn, type CascaderColumnProps, CascaderContent, type CascaderContentProps, CascaderField, type CascaderFieldProps, CascaderItem, type CascaderItemFunction, CascaderItemGroup, type CascaderItemGroupProps, type CascaderItemLayout, type CascaderItemProps, CascaderMenu, type CascaderMenuProps, type CascaderOption, CascaderOptionsMenu, type CascaderOptionsMenuProps, type CascaderProps, type CascaderSize, CascaderTrigger, type CascaderTriggerProps, Checkbox, CheckboxGroup, type CheckboxGroupDirection, type CheckboxGroupProps, CheckboxInput, type CheckboxInputProps, type CheckboxProps, type CheckboxSize, type ColorFormat, ColorPickButton, type ColorPickButtonProps, ColorPicker, ColorPickerArea, type ColorPickerAreaProps, ColorPickerContent, type ColorPickerContentProps, ColorPickerInputs, type ColorPickerInputsProps, ColorPickerPanel, type ColorPickerPanelProps, ColorPickerPresets, type ColorPickerPresetsProps, type ColorPickerProps, ColorPickerSlider, type ColorPickerSliderProps, ColorPickerTrigger, type ColorPickerTriggerProps, ConfigProvider, type ConfigProviderProps, DEFAULT_COLOR, DEFAULT_PLAYBACK_RATES, DatePicker, DatePickerCalendar, type DatePickerCalendarProps, DatePickerContent, type DatePickerContentProps, DatePickerField, type DatePickerFieldProps, type DatePickerMode, type DatePickerPanel, type DatePickerProps, type DatePickerRangeProps, type DatePickerSingleProps, type DatePickerSize, type DatePickerTimeValue, DatePickerTrigger, type DatePickerTriggerProps, type DateRange, type Direction, Drawer, DrawerBody, type DrawerBodyProps, DrawerClose, DrawerContent, type DrawerContentProps, DrawerDescription, type DrawerDescriptionProps, DrawerFooter, type DrawerFooterProps, DrawerHeader, type DrawerHeaderProps, DrawerHeaderText, type DrawerHeaderTextProps, DrawerOverlay, type DrawerOverlayProps, DrawerPortal, type DrawerPosition, type DrawerProps, DrawerTitle, type DrawerTitleProps, DrawerTrigger, Feedback, type FeedbackMode, type FeedbackProps, type FeedbackSize, type FeedbackType, Fieldset, type FieldsetProps, type HSVA, HoverPopover, type HoverPopoverProps, Input, InputGroup, InputGroupAddon, type InputGroupProps, type InputProps, type InputSize, Label, Link, type LinkLevel, type LinkMode, type LinkProps, List, ListDivider, type ListDividerProps, ListGroup, type ListGroupProps, ListItem, ListItemGroup, type ListItemGroupProps, type ListItemLeading, type ListItemProps, type ListItemType, type ListProps, ListSeparator, type ListSeparatorProps, ListTitle, type ListTitleProps, Loading, type LoadingButtonSize, type LoadingLevel, type LoadingMode, type LoadingProps, type Locale, type LocaleComponentName, LocaleProvider, type LocaleProviderProps, Modal, ModalBody, type ModalBodyProps, ModalClose, ModalContent, type ModalContentProps, ModalDescription, type ModalDescriptionProps, ModalFooter, type ModalFooterProps, ModalHeader, type ModalHeaderProps, ModalHeaderText, type ModalHeaderTextProps, ModalOverlay, type ModalOverlayProps, ModalPortal, type ModalProps, type ModalSize, ModalTitle, type ModalTitleProps, ModalTrigger, Navigation, NavigationActions, type NavigationActionsProps, NavigationActionsSlot, type NavigationActionsSlotProps, type NavigationBackground, NavigationBrand, type NavigationBrandProps, NavigationBrandTitle, type NavigationBrandTitleProps, type NavigationDirection, NavigationGroup, type NavigationGroupProps, NavigationItem, NavigationItemGroup, type NavigationItemGroupProps, NavigationItemMenu, NavigationItemMenuContent, type NavigationItemMenuContentProps, NavigationItemMenuItem, type NavigationItemMenuItemProps, type NavigationItemMenuProps, NavigationItemMenuTrigger, type NavigationItemMenuTriggerProps, type NavigationItemProps, type NavigationItemType, type NavigationProps, NavigationSection, type NavigationSectionProps, NumberInput, type NumberInputProps, type NumberInputStyle, OverlayContainerProvider, type OverlayContainerProviderProps, Pagehead, type PageheadProps, Pagination, type PaginationProps, type PhysicalSide, Popover, PopoverAnchor, type PopoverAppearance, PopoverContent, type PopoverContentLevel, type PopoverContentProps, type PopoverProps, PopoverTrigger, Progress, type ProgressProps, type ProgressShape, type ProgressSize, type ProgressType, RESPONSIVE_TOOLTIP_LONG_PRESS_MS, RadioGroup, type RadioGroupDirection, RadioGroupItem, type RadioGroupItemProps, type RadioGroupProps, RadioInput, type RadioInputProps, type RadioInputVariant, ResponsiveTooltip, type ResponsiveTooltipProps, Scroll, type ScrollOrientation, ScrollPicker, ScrollPickerColumn, type ScrollPickerColumnProps, ScrollPickerItem, type ScrollPickerItemProps, type ScrollPickerProps, type ScrollProps, type ScrollSize, type SegmentatorDirection, SegmentatorGroup, type SegmentatorGroupProps, SegmentatorItem, type SegmentatorItemProps, type SegmentatorMode, Select, SelectContent, type SelectContentProps, SelectGroup, SelectItem, type SelectItemFunction, SelectItemGroup, type SelectItemGroupProps, type SelectItemLayout, SelectItemPeople, type SelectItemPeopleProps, type SelectItemProps, SelectLabel, type SelectLabelProps, SelectSeparator, type SelectSeparatorProps, type SelectSize, SelectSubItem, SelectSubItemPeople, type SelectSubItemPeopleProps, type SelectSubItemProps, SelectSubMenu, type SelectSubMenuProps, SelectTrigger, type SelectTriggerProps, SelectValue, Slider, type SliderProps, type SliderSize, type SliderType, Stack, type StackProps, Steps, type StepsDirection, StepsIcon, type StepsIconProps, StepsItem, type StepsItemProps, type StepsProps, type StepsState, Switch, type SwitchProps, type SwitchSize, TOOLTIP_DELAY_DURATION, Tab, type TabBackground, TabItem, type TabItemProps, type TabProps, type TabStyle, Table, TableCell, type TableCellContent, type TableCellProps, TableHead, type TableHeadProps, type TableProps, TableRow, type TableRowProps, Tag, TagClose, type TagCloseProps, type TagContent, type TagLevel, type TagLineHeightFix, type TagProps, Textarea, type TextareaProps, type TextareaSize, ThemeProvider, type ThemeProviderProps, ThemeScript, TimePicker, TimePickerContent, type TimePickerContentProps, TimePickerField, type TimePickerFieldProps, TimePickerPanel, type TimePickerPanelProps, type TimePickerProps, type TimePickerSize, TimePickerTrigger, type TimePickerTriggerProps, type TimePickerValue, TimePickerWheels, type TimePickerWheelsValue, Tooltip, TooltipContent, type TooltipContentLevel, type TooltipContentProps, TooltipProvider, type TooltipProviderProps, TooltipTrigger, Typeface, type TypefaceContent, TypefacePair, type TypefacePairProps, type TypefaceProps, Typography, type TypographyContent, type TypographyLevel, type TypographyProps, type TypographyTone, Upload, type UploadProps, type UploadStyle, type UseColorPickerStateOptions, Video, type VideoAppearance, type VideoHandle, type VideoObjectFit, type VideoProps, alertVariants, backChevronSide, buttonVariants, cn, drawerContentVariants, enUS, formatDisplayDate, formatMonthYear, formatTimeValue, formatVideoTime, forwardChevronSide, initKeyboardFocus, inputRootVariants, interpolate, loadingLevelForButtonSize, mirrorSide, mirrorSideForDirection, modalContentVariants, numberInputRootVariants, parseDateInput, parseDateRangeInput, parseVideoTime, typographyVariants, useColorPickerState, useDirection, useLocale, useLocaleMessages, useOverlayPortalContainer, useRtl, useTheme, useThemeLayoutKey, videoObjectFitToCss, zhCN };