@aviala-design/spiral 2.7.2 → 2.9.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 } from 'react';
+import { ReactNode, CSSProperties, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, ImgHTMLAttributes, MouseEvent, AnchorHTMLAttributes, Ref, ReactElement, 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';
@@ -101,6 +101,28 @@ type LocaleUpload = {
     title: string;
     description: string;
 };
+type LocaleVideo = {
+    play: string;
+    pause: string;
+    previous: string;
+    next: string;
+    speed: string;
+    speedAdjust: string;
+    /** Template: `${rate}` */
+    speedRate: string;
+    mute: string;
+    unmute: string;
+    volume: string;
+    settings: string;
+    fullscreen: string;
+    exitFullscreen: string;
+    settingsTitle: string;
+    aspectRatio: string;
+    aspectOriginal: string;
+    aspectStretch: string;
+    aspectFill: string;
+    volumeBalance: string;
+};
 type LocaleColorPicker = {
     placeholder: string;
     hue: string;
@@ -118,9 +140,13 @@ type Locale = {
     TimePicker: LocaleTimePicker;
     Pagination: LocalePagination;
     Upload: LocaleUpload;
+    Video: LocaleVideo;
     Modal: {
         close: string;
     };
+    Drawer: {
+        close: string;
+    };
     Feedback: {
         close: string;
     };
@@ -216,6 +242,19 @@ declare function forwardChevronSide(direction: Direction): PhysicalSide;
  */
 declare function backChevronSide(direction: Direction): PhysicalSide;
 
+type OverlayContainerProviderProps = {
+    container: HTMLElement | null;
+    children: ReactNode;
+};
+/** Nest overlays (Popover / Select / Tooltip) inside a stacking context such as Modal. */
+declare function OverlayContainerProvider({ container, children, }: OverlayContainerProviderProps): react.JSX.Element;
+/**
+ * Portal target for floating layers.
+ * Fullscreen element wins (browser only paints that subtree), then a nested
+ * overlay container (Modal), otherwise `document.body`.
+ */
+declare function useOverlayPortalContainer(): HTMLElement | undefined;
+
 /** Figma Components → Basic Input → Button */
 type ButtonMode = "primary" | "second" | "default" | "defaultCustom" | "outline" | "outlineCustom" | "noBackground" | "noBackgroundCustom" | "destructive";
 type ButtonSize = "tiny" | "small" | "regular" | "big";
@@ -1721,6 +1760,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 {
@@ -2198,7 +2306,7 @@ declare const TabItem: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes
 /** Figma Components → Information Collect → Slider (384:21585) */
 type SliderSize = "default" | "big";
 type SliderType = "default" | "range";
-type SliderRootProps = Omit<ComponentPropsWithoutRef<typeof SliderPrimitive.Root>, "orientation">;
+type SliderRootProps = ComponentPropsWithoutRef<typeof SliderPrimitive.Root>;
 declare const sliderVariants: (props?: ({
     size?: "default" | "big" | null | undefined;
     type?: "default" | "range" | null | undefined;
@@ -2206,6 +2314,8 @@ declare const sliderVariants: (props?: ({
 type SliderProps = SliderRootProps & VariantProps<typeof sliderVariants> & {
     /** Figma `Type` — single thumb vs range (two thumbs) */
     type?: SliderType;
+    /** Figma volume popover and other vertical tracks — `horizontal` (default) or `vertical`. */
+    orientation?: "horizontal" | "vertical";
     /**
      * When true, hovering a thumb (and while dragging it) shows a value
      * tooltip bound to that thumb.
@@ -2214,12 +2324,14 @@ type SliderProps = SliderRootProps & VariantProps<typeof sliderVariants> & {
     /** Format the value tooltip label. Defaults to `String(value)`. */
     formatValueTooltip?: (value: number, index: number) => ReactNode;
 };
-declare const Slider: react.ForwardRefExoticComponent<SliderRootProps & VariantProps<(props?: ({
+declare const Slider: react.ForwardRefExoticComponent<Omit<SliderPrimitive.SliderProps & react.RefAttributes<HTMLSpanElement>, "ref"> & VariantProps<(props?: ({
     size?: "default" | "big" | null | undefined;
     type?: "default" | "range" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & {
     /** Figma `Type` — single thumb vs range (two thumbs) */
     type?: SliderType;
+    /** Figma volume popover and other vertical tracks — `horizontal` (default) or `vertical`. */
+    orientation?: "horizontal" | "vertical";
     /**
      * When true, hovering a thumb (and while dragging it) shows a value
      * tooltip bound to that thumb.
@@ -2267,6 +2379,112 @@ declare const Upload: react.ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDi
     inputProps?: Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "accept" | "multiple" | "disabled" | "onChange">;
 } & react.RefAttributes<HTMLDivElement>>;
 
+/** Figma 画面比例 → CSS object-fit */
+type VideoObjectFit = "original" | "stretch" | "fill";
+declare function videoObjectFitToCss(fit: VideoObjectFit): string;
+declare function formatVideoTime(seconds: number): string;
+/** Parse `mm:ss`, `h:mm:ss`, or `current / duration` (uses the first segment). */
+declare function parseVideoTime(input: string): number | null;
+declare const DEFAULT_PLAYBACK_RATES: readonly [0.5, 1, 1.5, 2, 3];
+
+/** Figma Components → Information Display → Video (1958:1400) Style */
+type VideoAppearance = "default" | "light";
+type VideoProps = Omit<VideoHTMLAttributes<HTMLVideoElement>, "controls" | "muted" | "onVolumeChange"> & {
+    /** Figma `Style` — Default stacks the bar; Light floats a pill bar over the stage. */
+    appearance?: VideoAppearance;
+    /** Seconds to skip when Previous / Next have no playlist handlers. */
+    skipSeconds?: number;
+    /** Available playback rates in the speed popover. */
+    playbackRates?: number[];
+    muted?: boolean;
+    defaultMuted?: boolean;
+    onMutedChange?: (muted: boolean) => void;
+    playbackRate?: number;
+    defaultPlaybackRate?: number;
+    onPlaybackRateChange?: (rate: number) => void;
+    /** Figma 画面比例 — original→contain, stretch→fill, fill→cover. */
+    objectFit?: VideoObjectFit;
+    defaultObjectFit?: VideoObjectFit;
+    onObjectFitChange?: (fit: VideoObjectFit) => void;
+    /** Lightweight loudness balance via Web Audio DynamicsCompressor. */
+    volumeBalance?: boolean;
+    defaultVolumeBalance?: boolean;
+    onVolumeBalanceChange?: (enabled: boolean) => void;
+    /** Linear gain 0–1 (`HTMLMediaElement.volume`). */
+    volume?: number;
+    defaultVolume?: number;
+    onVolumeChange?: (volume: number) => void;
+    /** Override Previous (default: seek back `skipSeconds`). */
+    onPrevious?: () => void;
+    /** Override Next (default: seek forward `skipSeconds`). */
+    onNext?: () => void;
+    /**
+     * Letterbox / pillarbox fill behind the media.
+     * CSS color value — prefer a token, e.g. `var(--box-box-normal-background-blackonly)`.
+     * Defaults to Black (`--box-box-normal-background-blackonly`).
+     */
+    stageBackground?: string;
+    /**
+     * Auto-hide the control bar after idle (slide down + fade).
+     * Pointer move / press on the player reveals it again.
+     */
+    autoHideControls?: boolean;
+    /** Idle time in ms before hiding when `autoHideControls` is on. Default 2500. */
+    autoHideDelay?: number;
+    className?: string;
+    style?: CSSProperties;
+};
+type VideoHandle = {
+    video: HTMLVideoElement | null;
+    play: () => Promise<void> | undefined;
+    pause: () => void;
+};
+declare const Video: react.ForwardRefExoticComponent<Omit<VideoHTMLAttributes<HTMLVideoElement>, "onVolumeChange" | "muted" | "controls"> & {
+    /** Figma `Style` — Default stacks the bar; Light floats a pill bar over the stage. */
+    appearance?: VideoAppearance;
+    /** Seconds to skip when Previous / Next have no playlist handlers. */
+    skipSeconds?: number;
+    /** Available playback rates in the speed popover. */
+    playbackRates?: number[];
+    muted?: boolean;
+    defaultMuted?: boolean;
+    onMutedChange?: (muted: boolean) => void;
+    playbackRate?: number;
+    defaultPlaybackRate?: number;
+    onPlaybackRateChange?: (rate: number) => void;
+    /** Figma 画面比例 — original→contain, stretch→fill, fill→cover. */
+    objectFit?: VideoObjectFit;
+    defaultObjectFit?: VideoObjectFit;
+    onObjectFitChange?: (fit: VideoObjectFit) => void;
+    /** Lightweight loudness balance via Web Audio DynamicsCompressor. */
+    volumeBalance?: boolean;
+    defaultVolumeBalance?: boolean;
+    onVolumeBalanceChange?: (enabled: boolean) => void;
+    /** Linear gain 0–1 (`HTMLMediaElement.volume`). */
+    volume?: number;
+    defaultVolume?: number;
+    onVolumeChange?: (volume: number) => void;
+    /** Override Previous (default: seek back `skipSeconds`). */
+    onPrevious?: () => void;
+    /** Override Next (default: seek forward `skipSeconds`). */
+    onNext?: () => void;
+    /**
+     * Letterbox / pillarbox fill behind the media.
+     * CSS color value — prefer a token, e.g. `var(--box-box-normal-background-blackonly)`.
+     * Defaults to Black (`--box-box-normal-background-blackonly`).
+     */
+    stageBackground?: string;
+    /**
+     * Auto-hide the control bar after idle (slide down + fade).
+     * Pointer move / press on the player reveals it again.
+     */
+    autoHideControls?: boolean;
+    /** Idle time in ms before hiding when `autoHideControls` is on. Default 2500. */
+    autoHideDelay?: number;
+    className?: string;
+    style?: CSSProperties;
+} & react.RefAttributes<VideoHandle>>;
+
 type ScrollPickerProps = HTMLAttributes<HTMLDivElement>;
 declare function ScrollPicker({ className, children, ...props }: ScrollPickerProps): react.JSX.Element;
 type ScrollPickerColumnProps<T = string> = {
@@ -2576,4 +2794,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, 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, 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, alertVariants, backChevronSide, buttonVariants, cn, enUS, formatDisplayDate, formatMonthYear, formatTimeValue, forwardChevronSide, initKeyboardFocus, inputRootVariants, interpolate, loadingLevelForButtonSize, mirrorSide, mirrorSideForDirection, modalContentVariants, numberInputRootVariants, parseDateInput, parseDateRangeInput, typographyVariants, useColorPickerState, useDirection, useLocale, useLocaleMessages, useResolvedControlError, useRtl, useTheme, useThemeLayoutKey, 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, 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, drawerContentVariants, 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 };

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 } from 'react';
+import { ReactNode, CSSProperties, ButtonHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, ComponentPropsWithoutRef, HTMLAttributes, ImgHTMLAttributes, MouseEvent, AnchorHTMLAttributes, Ref, ReactElement, 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';
@@ -101,6 +101,28 @@ type LocaleUpload = {
     title: string;
     description: string;
 };
+type LocaleVideo = {
+    play: string;
+    pause: string;
+    previous: string;
+    next: string;
+    speed: string;
+    speedAdjust: string;
+    /** Template: `${rate}` */
+    speedRate: string;
+    mute: string;
+    unmute: string;
+    volume: string;
+    settings: string;
+    fullscreen: string;
+    exitFullscreen: string;
+    settingsTitle: string;
+    aspectRatio: string;
+    aspectOriginal: string;
+    aspectStretch: string;
+    aspectFill: string;
+    volumeBalance: string;
+};
 type LocaleColorPicker = {
     placeholder: string;
     hue: string;
@@ -118,9 +140,13 @@ type Locale = {
     TimePicker: LocaleTimePicker;
     Pagination: LocalePagination;
     Upload: LocaleUpload;
+    Video: LocaleVideo;
     Modal: {
         close: string;
     };
+    Drawer: {
+        close: string;
+    };
     Feedback: {
         close: string;
     };
@@ -216,6 +242,19 @@ declare function forwardChevronSide(direction: Direction): PhysicalSide;
  */
 declare function backChevronSide(direction: Direction): PhysicalSide;
 
+type OverlayContainerProviderProps = {
+    container: HTMLElement | null;
+    children: ReactNode;
+};
+/** Nest overlays (Popover / Select / Tooltip) inside a stacking context such as Modal. */
+declare function OverlayContainerProvider({ container, children, }: OverlayContainerProviderProps): react.JSX.Element;
+/**
+ * Portal target for floating layers.
+ * Fullscreen element wins (browser only paints that subtree), then a nested
+ * overlay container (Modal), otherwise `document.body`.
+ */
+declare function useOverlayPortalContainer(): HTMLElement | undefined;
+
 /** Figma Components → Basic Input → Button */
 type ButtonMode = "primary" | "second" | "default" | "defaultCustom" | "outline" | "outlineCustom" | "noBackground" | "noBackgroundCustom" | "destructive";
 type ButtonSize = "tiny" | "small" | "regular" | "big";
@@ -1721,6 +1760,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 {
@@ -2198,7 +2306,7 @@ declare const TabItem: react.ForwardRefExoticComponent<Omit<ButtonHTMLAttributes
 /** Figma Components → Information Collect → Slider (384:21585) */
 type SliderSize = "default" | "big";
 type SliderType = "default" | "range";
-type SliderRootProps = Omit<ComponentPropsWithoutRef<typeof SliderPrimitive.Root>, "orientation">;
+type SliderRootProps = ComponentPropsWithoutRef<typeof SliderPrimitive.Root>;
 declare const sliderVariants: (props?: ({
     size?: "default" | "big" | null | undefined;
     type?: "default" | "range" | null | undefined;
@@ -2206,6 +2314,8 @@ declare const sliderVariants: (props?: ({
 type SliderProps = SliderRootProps & VariantProps<typeof sliderVariants> & {
     /** Figma `Type` — single thumb vs range (two thumbs) */
     type?: SliderType;
+    /** Figma volume popover and other vertical tracks — `horizontal` (default) or `vertical`. */
+    orientation?: "horizontal" | "vertical";
     /**
      * When true, hovering a thumb (and while dragging it) shows a value
      * tooltip bound to that thumb.
@@ -2214,12 +2324,14 @@ type SliderProps = SliderRootProps & VariantProps<typeof sliderVariants> & {
     /** Format the value tooltip label. Defaults to `String(value)`. */
     formatValueTooltip?: (value: number, index: number) => ReactNode;
 };
-declare const Slider: react.ForwardRefExoticComponent<SliderRootProps & VariantProps<(props?: ({
+declare const Slider: react.ForwardRefExoticComponent<Omit<SliderPrimitive.SliderProps & react.RefAttributes<HTMLSpanElement>, "ref"> & VariantProps<(props?: ({
     size?: "default" | "big" | null | undefined;
     type?: "default" | "range" | null | undefined;
 } & class_variance_authority_types.ClassProp) | undefined) => string> & {
     /** Figma `Type` — single thumb vs range (two thumbs) */
     type?: SliderType;
+    /** Figma volume popover and other vertical tracks — `horizontal` (default) or `vertical`. */
+    orientation?: "horizontal" | "vertical";
     /**
      * When true, hovering a thumb (and while dragging it) shows a value
      * tooltip bound to that thumb.
@@ -2267,6 +2379,112 @@ declare const Upload: react.ForwardRefExoticComponent<Omit<HTMLAttributes<HTMLDi
     inputProps?: Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "accept" | "multiple" | "disabled" | "onChange">;
 } & react.RefAttributes<HTMLDivElement>>;
 
+/** Figma 画面比例 → CSS object-fit */
+type VideoObjectFit = "original" | "stretch" | "fill";
+declare function videoObjectFitToCss(fit: VideoObjectFit): string;
+declare function formatVideoTime(seconds: number): string;
+/** Parse `mm:ss`, `h:mm:ss`, or `current / duration` (uses the first segment). */
+declare function parseVideoTime(input: string): number | null;
+declare const DEFAULT_PLAYBACK_RATES: readonly [0.5, 1, 1.5, 2, 3];
+
+/** Figma Components → Information Display → Video (1958:1400) Style */
+type VideoAppearance = "default" | "light";
+type VideoProps = Omit<VideoHTMLAttributes<HTMLVideoElement>, "controls" | "muted" | "onVolumeChange"> & {
+    /** Figma `Style` — Default stacks the bar; Light floats a pill bar over the stage. */
+    appearance?: VideoAppearance;
+    /** Seconds to skip when Previous / Next have no playlist handlers. */
+    skipSeconds?: number;
+    /** Available playback rates in the speed popover. */
+    playbackRates?: number[];
+    muted?: boolean;
+    defaultMuted?: boolean;
+    onMutedChange?: (muted: boolean) => void;
+    playbackRate?: number;
+    defaultPlaybackRate?: number;
+    onPlaybackRateChange?: (rate: number) => void;
+    /** Figma 画面比例 — original→contain, stretch→fill, fill→cover. */
+    objectFit?: VideoObjectFit;
+    defaultObjectFit?: VideoObjectFit;
+    onObjectFitChange?: (fit: VideoObjectFit) => void;
+    /** Lightweight loudness balance via Web Audio DynamicsCompressor. */
+    volumeBalance?: boolean;
+    defaultVolumeBalance?: boolean;
+    onVolumeBalanceChange?: (enabled: boolean) => void;
+    /** Linear gain 0–1 (`HTMLMediaElement.volume`). */
+    volume?: number;
+    defaultVolume?: number;
+    onVolumeChange?: (volume: number) => void;
+    /** Override Previous (default: seek back `skipSeconds`). */
+    onPrevious?: () => void;
+    /** Override Next (default: seek forward `skipSeconds`). */
+    onNext?: () => void;
+    /**
+     * Letterbox / pillarbox fill behind the media.
+     * CSS color value — prefer a token, e.g. `var(--box-box-normal-background-blackonly)`.
+     * Defaults to Black (`--box-box-normal-background-blackonly`).
+     */
+    stageBackground?: string;
+    /**
+     * Auto-hide the control bar after idle (slide down + fade).
+     * Pointer move / press on the player reveals it again.
+     */
+    autoHideControls?: boolean;
+    /** Idle time in ms before hiding when `autoHideControls` is on. Default 2500. */
+    autoHideDelay?: number;
+    className?: string;
+    style?: CSSProperties;
+};
+type VideoHandle = {
+    video: HTMLVideoElement | null;
+    play: () => Promise<void> | undefined;
+    pause: () => void;
+};
+declare const Video: react.ForwardRefExoticComponent<Omit<VideoHTMLAttributes<HTMLVideoElement>, "onVolumeChange" | "muted" | "controls"> & {
+    /** Figma `Style` — Default stacks the bar; Light floats a pill bar over the stage. */
+    appearance?: VideoAppearance;
+    /** Seconds to skip when Previous / Next have no playlist handlers. */
+    skipSeconds?: number;
+    /** Available playback rates in the speed popover. */
+    playbackRates?: number[];
+    muted?: boolean;
+    defaultMuted?: boolean;
+    onMutedChange?: (muted: boolean) => void;
+    playbackRate?: number;
+    defaultPlaybackRate?: number;
+    onPlaybackRateChange?: (rate: number) => void;
+    /** Figma 画面比例 — original→contain, stretch→fill, fill→cover. */
+    objectFit?: VideoObjectFit;
+    defaultObjectFit?: VideoObjectFit;
+    onObjectFitChange?: (fit: VideoObjectFit) => void;
+    /** Lightweight loudness balance via Web Audio DynamicsCompressor. */
+    volumeBalance?: boolean;
+    defaultVolumeBalance?: boolean;
+    onVolumeBalanceChange?: (enabled: boolean) => void;
+    /** Linear gain 0–1 (`HTMLMediaElement.volume`). */
+    volume?: number;
+    defaultVolume?: number;
+    onVolumeChange?: (volume: number) => void;
+    /** Override Previous (default: seek back `skipSeconds`). */
+    onPrevious?: () => void;
+    /** Override Next (default: seek forward `skipSeconds`). */
+    onNext?: () => void;
+    /**
+     * Letterbox / pillarbox fill behind the media.
+     * CSS color value — prefer a token, e.g. `var(--box-box-normal-background-blackonly)`.
+     * Defaults to Black (`--box-box-normal-background-blackonly`).
+     */
+    stageBackground?: string;
+    /**
+     * Auto-hide the control bar after idle (slide down + fade).
+     * Pointer move / press on the player reveals it again.
+     */
+    autoHideControls?: boolean;
+    /** Idle time in ms before hiding when `autoHideControls` is on. Default 2500. */
+    autoHideDelay?: number;
+    className?: string;
+    style?: CSSProperties;
+} & react.RefAttributes<VideoHandle>>;
+
 type ScrollPickerProps = HTMLAttributes<HTMLDivElement>;
 declare function ScrollPicker({ className, children, ...props }: ScrollPickerProps): react.JSX.Element;
 type ScrollPickerColumnProps<T = string> = {
@@ -2576,4 +2794,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, 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, 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, alertVariants, backChevronSide, buttonVariants, cn, enUS, formatDisplayDate, formatMonthYear, formatTimeValue, forwardChevronSide, initKeyboardFocus, inputRootVariants, interpolate, loadingLevelForButtonSize, mirrorSide, mirrorSideForDirection, modalContentVariants, numberInputRootVariants, parseDateInput, parseDateRangeInput, typographyVariants, useColorPickerState, useDirection, useLocale, useLocaleMessages, useResolvedControlError, useRtl, useTheme, useThemeLayoutKey, 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, 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, drawerContentVariants, 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 };