haze-ui 1.26.0 → 1.28.0

package/dist/types/hooks/usePrevious.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 上一次渲染时的值。首次渲染返回 `undefined`。
+ *
+ * ```tsx
+ * const [count, setCount] = useState(0);
+ * const prev = usePrevious(count);
+ * // count 从 0 变 1 后：count === 1, prev === 0
+ * ```
+ *
+ * - 值比较按渲染（identity），不做深比较——对象/数组每次新引用都会
+ *   视为变化，需要浅比较时先用 `useMemo` 稳定引用。
+ * - 写入发生在 effect：与 `useEffect`/`useLayoutEffect` 内读到的前一值
+ *   一致；并发渲染下同一轮重试不会污染 prev。
+ *
+ * @param value 需要追踪前值的任意值。
+ * @returns 上一轮渲染的同一值；首轮为 `undefined`。
+ */
+export declare function usePrevious<T>(value: T): T | undefined;

package/dist/types/hooks/useSessionStorage.d.ts

@@ -0,0 +1,26 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { ControlOrValue } from 'react-use-control';
+/**
+ * sessionStorage 持久化的可控状态：与 `useLocalStorage` 共享同一内核，
+ * 仅 storage 区域不同——值随标签页会话存活，关闭标签页即清空。
+ *
+ * ```tsx
+ * // 非受控：已持久化值优先于 initial；setValue 即写回 sessionStorage
+ * const [token, setToken] = useSessionStorage<string>('api-token', undefined, '');
+ * setToken('abc'); // sessionStorage['api-token'] === '"abc"'
+ *
+ * // 受控：control 所有者持有状态，storage 只作初值来源、不回写
+ * const [token, setToken, tokenControl] = useControl(undefined, '');
+ * <TokenField token={tokenControl} onTokenChange={setToken} />
+ * ```
+ *
+ * 语义与 `useLocalStorage` 完全一致（初值解析顺序、损坏 JSON 容错、
+ * 非受控写回 + 跨标签页 `storage` 事件同步、受控不回写、SSR 安全），
+ * 见 {@link useLocalStorage}。
+ *
+ * @param key storage 键。
+ * @param control `Control<T>` 受控，或裸 `T` 作非受控初值。
+ * @param initial 兜底初始值（支持惰性函数形式）。
+ * @returns `[value, setValue]`，语义与 `useState` 一致。
+ */
+export declare function useSessionStorage<T>(key: string, control?: ControlOrValue<T>, initial?: T | (() => T)): [T, Dispatch<SetStateAction<T>>];

package/dist/types/hooks/useStorageState.d.ts

@@ -0,0 +1,12 @@
+import type { Dispatch, SetStateAction } from 'react';
+import type { ControlOrValue } from 'react-use-control';
+type StorageKind = 'local' | 'session';
+/**
+ * storage 持久化的可控状态内核（useLocalStorage / useSessionStorage 共用）。
+ *
+ * 初值解析顺序：已持久化值 > 非受控裸值 > `initial`。受控（传入 control）
+ * 且 control 已携带 state 时，useControl 直接采用上游状态，storage 不参与。
+ */
+declare function useStorageState<T>(kind: StorageKind, key: string, control: ControlOrValue<T> | undefined, initial: T | (() => T) | undefined): [T, Dispatch<SetStateAction<T>>];
+export { useStorageState };
+export type { StorageKind };

package/dist/types/index.d.ts

@@ -3,24 +3,26 @@ export { spacing } from './tokens/spacing';
 export { typography } from './tokens/typography';
 export { TOKEN_REGISTRY, COMPONENT_TOKENS } from './tokens/registry';
 export type { TokenDef } from './tokens/registry';
-export { Button, ButtonLink } from './components/Button';
+export { Button, ButtonLink, buttonVariants, buttonSizes } from './components/Button';
 export type { ButtonProps, ButtonLinkProps } from './components/Button';
 export { Input, InputCore } from './components/Input';
 export type { InputProps, InputCoreProps } from './components/Input';
-export { Select, Option, SelectCore } from './components/Select';
-export type { SelectProps, OptionProps, SelectCoreProps } from './components/Select';
+export { Select, Option, SelectCore, OptionGroup } from './components/Select';
+export type { SelectProps, OptionProps, SelectCoreProps, OptionGroupProps } from './components/Select';
 export { Checkbox, CheckboxCore } from './components/Checkbox';
 export type { CheckboxProps, CheckboxCoreProps } from './components/Checkbox';
 export { Switch, SwitchCore } from './components/Switch';
 export type { SwitchProps, SwitchCoreProps } from './components/Switch';
-export { Badge } from './components/Badge';
+export { Toggle, ToggleCore } from './components/Toggle';
+export type { ToggleProps, ToggleCoreProps } from './components/Toggle';
+export { Badge, badgeVariants, badgeSizes } from './components/Badge';
 export type { BadgeProps } from './components/Badge';
 export { Dialog } from './components/Dialog';
-export type { DialogProps } from './components/Dialog';
+export type { DialogProps, DialogHandle, DialogClassNames } from './components/Dialog';
 export { Tooltip } from './components/Tooltip';
 export type { TooltipProps } from './components/Tooltip';
 export { Popover } from './components/Popover';
-export type { PopoverProps } from './components/Popover';
+export type { PopoverProps, PopoverHandle, PopoverClassNames } from './components/Popover';
 export { Card } from './components/Card';
 export type { CardProps } from './components/Card';
 export { Radio, RadioGroup, RadioGroupCore } from './components/Radio';
@@ -30,7 +32,7 @@ export type { TextareaProps, TextareaCoreProps } from './components/Textarea';
 export { Slider, SliderCore } from './components/Slider';
 export type { SliderProps, SliderCoreProps } from './components/Slider';
 export { Tabs, TabList, Tab, TabPanel } from './components/Tabs';
-export type { TabsProps, TabListProps, TabProps, TabPanelProps, } from './components/Tabs';
+export type { TabsProps, TabsClassNames, TabListProps, TabProps, TabPanelProps, } from './components/Tabs';
 export { Accordion, AccordionItem } from './components/Accordion';
 export type { AccordionProps, AccordionItemProps, } from './components/Accordion';
 export { Alert } from './components/Alert';
@@ -44,31 +46,31 @@ export type { SkeletonProps } from './components/Skeleton';
 export { Icon } from './components/Icon';
 export type { IconProps } from './components/Icon';
 export { Image } from './components/Image';
-export type { ImageProps } from './components/Image';
+export type { ImageProps, ImagePreviewConfig } from './components/Image';
 export { Flex } from './components/Flex';
 export type { FlexProps } from './components/Flex';
 export { Breadcrumb, BreadcrumbItem } from './components/Breadcrumb';
 export type { BreadcrumbProps, BreadcrumbItemProps, } from './components/Breadcrumb';
 export { Disclosure } from './components/Disclosure';
 export type { DisclosureProps } from './components/Disclosure';
-export { Menu, MenuItem, MenuDivider } from './components/Menu';
-export type { MenuProps, MenuItemProps } from './components/Menu';
+export { Menu, MenuItem, MenuDivider, MenuSub, MenuSubTrigger, MenuSubContent } from './components/Menu';
+export type { MenuProps, MenuItemProps, MenuSubProps, MenuSubTriggerProps, MenuSubContentProps } from './components/Menu';
 export { NumberInput, NumberInputCore } from './components/NumberInput';
 export type { NumberInputProps, NumberInputCoreProps } from './components/NumberInput';
 export { FileInput } from './components/FileInput';
 export type { FileInputProps } from './components/FileInput';
 export { Toast, ToastContainer, useToast, toast } from './components/Toast';
-export type { ToastProps, ToastContainerProps, ToastOptions, ToastVariant } from './components/Toast';
+export type { ToastProps, ToastContainerProps, ToastOptions, ToastVariant, ToastClassNames } from './components/Toast';
 export { List, ListItem } from './components/List';
 export type { ListProps, ListItemProps } from './components/List';
-export { Combobox } from './components/Combobox';
-export type { ComboboxProps } from './components/Combobox';
+export { Combobox, ComboboxOption, ComboboxGroup } from './components/Combobox';
+export type { ComboboxProps, ComboboxOptionProps, ComboboxGroupProps, ComboboxOptionData, ComboboxVirtualizedConfig } from './components/Combobox';
 export { Table, TableHead, TableBody, TableRow, TableCell, } from './components/Table';
 export type { TableProps, TableHeadProps, TableBodyProps, TableRowProps, TableCellProps, } from './components/Table';
 export { Carousel, CarouselSlide } from './components/Carousel';
 export type { CarouselProps, CarouselSlideProps } from './components/Carousel';
 export { Datepicker, DatepickerCore } from './components/Datepicker';
-export type { DatepickerProps, DatepickerCoreProps } from './components/Datepicker';
+export type { DatepickerProps, DatepickerCoreProps, DatepickerPreset } from './components/Datepicker';
 export { Tree } from './components/Tree';
 export type { TreeProps, TreeNodeData } from './components/Tree';
 export { Divider } from './components/Divider';
@@ -84,19 +86,21 @@ export type { PaginationProps } from './components/Pagination';
 export { Grid, GridItem } from './components/Grid';
 export type { GridProps, GridItemProps } from './components/Grid';
 export { Drawer } from './components/Drawer';
-export type { DrawerProps } from './components/Drawer';
+export type { DrawerProps, DrawerHandle } from './components/Drawer';
 export { Stepper, Step } from './components/Stepper';
 export type { StepperProps, StepProps } from './components/Stepper';
-export { Command, CommandInput, CommandList, CommandItem } from './components/Command';
-export type { CommandProps, CommandInputProps, CommandListProps, CommandItemProps } from './components/Command';
+export { Command, CommandInput, CommandList, CommandItem, CommandGroup, CommandDialog } from './components/Command';
+export type { CommandProps, CommandInputProps, CommandListProps, CommandItemProps, CommandGroupProps, CommandDialogProps } from './components/Command';
 export { ResizableGroup, ResizablePanel, ResizableHandle } from './components/Resizable';
 export type { ResizableGroupProps, ResizablePanelProps, ResizableHandleProps } from './components/Resizable';
+export { SplitterGroup, SplitterPanel, SplitterHandle, } from './components/Resizable';
+export type { ResizableGroupProps as SplitterGroupProps, ResizablePanelProps as SplitterPanelProps, ResizableHandleProps as SplitterHandleProps, } from './components/Resizable';
 export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './components/Collapsible';
-export type { CollapsibleProps, CollapsibleTriggerProps, CollapsibleContentProps } from './components/Collapsible';
+export type { CollapsibleProps, CollapsibleTriggerProps, CollapsibleContentProps, CollapsibleClassNames } from './components/Collapsible';
 export { Transfer, TransferCore } from './components/Transfer';
 export type { TransferProps, TransferItem, TransferCoreProps } from './components/Transfer';
 export { Upload, UploadCore } from './components/Upload';
-export type { UploadProps, UploadCoreProps } from './components/Upload';
+export type { UploadProps, UploadCoreProps, UploadHandle, UploadStatus, UploadFileStatus, UploadRequest, UploadRequestOptions, UploadListItemActions, UploadListItemRender } from './components/Upload';
 export { ColorPicker, ColorPickerCore } from './components/ColorPicker';
 export type { ColorPickerProps, ColorPickerCoreProps } from './components/ColorPicker';
 export { Rating, RatingCore } from './components/Rating';
@@ -116,19 +120,21 @@ export type { ScrollAreaProps } from './components/ScrollArea';
 export { TimePicker, TimePickerCore } from './components/TimePicker';
 export type { TimePickerProps, TimePickerCoreProps } from './components/TimePicker';
 export { DateRangePicker, DateRangePickerCore } from './components/DateRangePicker';
-export type { DateRangePickerProps, DateRangePickerCoreProps } from './components/DateRangePicker';
+export type { DateRangePickerProps, DateRangePickerCoreProps, DateRangePickerPreset, DateRangePickerPresets } from './components/DateRangePicker';
 export { OTPInput, OTPInputCore } from './components/OTPInput';
 export type { OTPInputProps, OTPInputCoreProps } from './components/OTPInput';
 export { PasswordInput, PasswordInputCore } from './components/PasswordInput';
 export type { PasswordInputProps, PasswordInputCoreProps } from './components/PasswordInput';
-export { TagInput, TagInputCore } from './components/TagInput';
-export type { TagInputProps, TagInputCoreProps } from './components/TagInput';
+export { TagInput, TagInputCore, SortableTagInput, SortableTagInputCore } from './components/TagInput';
+export type { TagInputProps, TagInputCoreProps, SortableTagInputProps, SortableTagInputCoreProps } from './components/TagInput';
 export { Mentions, MentionsCore } from './components/Mentions';
 export type { MentionsProps, MentionsCoreProps, MentionsOption } from './components/Mentions';
+export { PromptInput } from './components/PromptInput';
+export type { PromptInputProps } from './components/PromptInput';
 export { InlineEdit } from './components/InlineEdit';
 export type { InlineEditProps } from './components/InlineEdit';
-export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator } from './components/DropdownMenu';
-export type { DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuSeparatorProps } from './components/DropdownMenu';
+export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubTrigger, DropdownMenuSubContent } from './components/DropdownMenu';
+export type { DropdownMenuProps, DropdownMenuTriggerProps, DropdownMenuContentProps, DropdownMenuItemProps, DropdownMenuSeparatorProps, DropdownMenuSubProps, DropdownMenuSubTriggerProps, DropdownMenuSubContentProps, DropdownMenuHandle } from './components/DropdownMenu';
 export { ContextMenu, ContextMenuTrigger, ContextMenuContent, ContextMenuItem, ContextMenuSeparator } from './components/ContextMenu';
 export type { ContextMenuProps, ContextMenuTriggerProps, ContextMenuContentProps, ContextMenuItemProps, ContextMenuSeparatorProps } from './components/ContextMenu';
 export { NavigationBar, NavLink } from './components/NavigationBar';
@@ -144,38 +150,51 @@ export type { BannerProps } from './components/Banner';
 export { ConfirmDialog } from './components/ConfirmDialog';
 export type { ConfirmDialogProps } from './components/ConfirmDialog';
 export { CodeBlock } from './components/CodeBlock';
-export type { CodeBlockProps } from './components/CodeBlock';
+export type { CodeBlockProps, Highlighter } from './components/CodeBlock';
 export { AspectRatio } from './components/AspectRatio';
 export type { AspectRatioProps } from './components/AspectRatio';
 export { VirtualList } from './components/VirtualList';
 export type { VirtualListProps, VirtualListHandle, VirtualListGroup, VirtualListAlign } from './components/VirtualList';
-export { TagGroup, TagGroupItem } from './components/TagGroup';
-export type { TagGroupProps, TagGroupItemProps } from './components/TagGroup';
+export { TagGroup, TagGroupItem, SortableTagGroup } from './components/TagGroup';
+export type { TagGroupProps, TagGroupItemProps, SortableTagGroupProps } from './components/TagGroup';
 export { BottomSheet } from './components/BottomSheet';
-export type { BottomSheetProps } from './components/BottomSheet';
+export type { BottomSheetProps, BottomSheetHandle } from './components/BottomSheet';
 export { SwipeAction } from './components/SwipeAction';
 export type { SwipeActionProps } from './components/SwipeAction';
 export { default as LocaleProvider, useStrings } from './components/LocaleProvider';
-export { defaultStrings, enUS, zhCN } from './components/LocaleProvider';
+export { defaultStrings, enUS, zhCN, jaJP, createStrings } from './components/LocaleProvider';
 export type { LocaleProviderProps, HazeStrings } from './components/LocaleProvider';
-export { DataTable } from './components/DataTable';
-export type { DataTableProps, DataTableColumnDef, DataTableColumnMeta, DataTableVirtualized, } from './components/DataTable';
+export type { DeepPartial } from './components/LocaleProvider';
+export { useDirection, getDirection, localeDirection } from './utils/direction';
+export type { Direction } from './utils/direction';
+export { DataTable, dataTableSum, dataTableAvg, dataTableCount, dataTableToCsv } from './components/DataTable';
+export type { DataTableProps, DataTableColumnDef, DataTableColumnMeta, DataTableVirtualized, DataTableSummary, DataTableSummaryCell, DataTableCellEditorProps, DataTableCsvOptions, } from './components/DataTable';
+export { Chart } from './components/Chart';
+export type { ChartProps, ChartSeries, ChartType, ChartTooltipPayload, ChartTooltipEntry } from './components/Chart';
 export { Kbd } from './components/Kbd';
 export type { KbdProps } from './components/Kbd';
 export { AvatarGroup } from './components/AvatarGroup';
 export type { AvatarGroupProps } from './components/AvatarGroup';
 export { Calendar } from './components/Calendar';
-export type { CalendarProps } from './components/Calendar';
+export type { CalendarProps, CalendarPickerMode } from './components/Calendar';
 export { HoverCard } from './components/HoverCard';
 export type { HoverCardProps } from './components/HoverCard';
-export { Toolbar, ToolbarButton, ToolbarSeparator } from './components/Toolbar';
-export type { ToolbarProps, ToolbarButtonProps, ToolbarSeparatorProps } from './components/Toolbar';
+export { Toolbar, ToolbarButton, ToolbarSeparator, ToolbarToggle } from './components/Toolbar';
+export type { ToolbarProps, ToolbarButtonProps, ToolbarSeparatorProps, ToolbarToggleProps } from './components/Toolbar';
+export { AppShell } from './components/AppShell';
+export type { AppShellProps } from './components/AppShell';
 export { Cascader } from './components/Cascader';
 export type { CascaderProps, CascaderOption } from './components/Cascader';
 export { Sidebar, SidebarGroup, SidebarItem, SidebarFooter, SidebarToggle } from './components/Sidebar';
 export type { SidebarProps, SidebarGroupProps, SidebarItemProps, SidebarFooterProps, SidebarToggleProps, } from './components/Sidebar';
 export { Tour } from './components/Tour';
 export type { TourProps, TourStep, TourCloseReason, TourPlacement } from './components/Tour';
+export { Anchor } from './components/Anchor';
+export type { AnchorProps, AnchorItem } from './components/Anchor';
+export { Watermark } from './components/Watermark';
+export type { WatermarkProps, WatermarkFont } from './components/Watermark';
+export { Fullscreen } from './components/Fullscreen';
+export type { FullscreenProps } from './components/Fullscreen';
 export { ChatMessage } from './components/ChatMessage';
 export type { ChatMessageProps, ChatMessageRole } from './components/ChatMessage';
 export { ChatContainer } from './components/ChatContainer';
@@ -206,9 +225,32 @@ export { LogViewer } from './components/LogViewer';
 export type { LogViewerProps, LogEntry, LogLevel } from './components/LogViewer';
 export { AsyncSection } from './components/AsyncSection';
 export type { AsyncSectionProps } from './components/AsyncSection';
-export { useTitle, useMediaQuery, usePrefersReducedMotion, useDebouncedValue, useDebouncedCallback, useClipboard, } from './hooks';
+export { Descriptions } from './components/Descriptions';
+export type { DescriptionsProps, DescriptionsItem } from './components/Descriptions';
+export { JsonView } from './components/JsonView';
+export type { JsonViewProps, MoreLabelFn } from './components/JsonView';
+export { Sources } from './components/Sources';
+export type { SourcesProps, SourceItem } from './components/Sources';
+export { FilePreview } from './components/FilePreview';
+export type { FilePreviewProps, FilePreviewFile, FilePreviewStatus } from './components/FilePreview';
+export { InlineCompletion } from './components/InlineCompletion';
+export type { InlineCompletionProps } from './components/InlineCompletion';
+export { FloatButton, FloatButtonGroup } from './components/FloatButton';
+export type { FloatButtonProps, FloatButtonGroupProps } from './components/FloatButton';
+export { Masonry } from './components/Masonry';
+export type { MasonryProps } from './components/Masonry';
+export { Signature } from './components/Signature';
+export type { SignatureProps } from './components/Signature';
+export { useTitle, useMediaQuery, usePrefersReducedMotion, useDebouncedValue, useDebouncedCallback, useDarkMode, useClipboard, useFullscreen, } from './hooks';
 export type { UseClipboardResult } from './hooks';
-export { FormItem } from './form';
-export type { FieldValidator, FormItemAsProps, FormItemBinding, FormItemOwnProps, FormItemProps, FormItemRawElement, FormItemRawElementBinding, FormInstance, PathValueOf, } from './form';
+export type { FullscreenTarget, UseFullscreenHandle } from './hooks';
+export type { ColorMode, UseDarkModeOptions, UseDarkModeResult } from './hooks';
+export { useHotkeys, hotkey, useInView, useLocalStorage, useSessionStorage } from './hooks';
+export type { HotkeyHandler, UseHotkeysOptions, UseInViewOptions } from './hooks';
+export { useClickOutside } from './hooks';
+export type { UseClickOutsideOptions } from './hooks';
+export { usePrevious } from './hooks';
+export { FormItem, FormList, FormProvider, useFormContext, useFieldArray, useFieldArrayItem, useWatch, trigger, setFocus, setServerErrors, setValue, getValue, getValues, reset, hasStandardProps, standardSchemaFormValidator, standardSchemaResolver, zodResolver, } from './form';
+export type { FieldValidator, FormItemAsProps, FormItemBinding, FormItemOwnProps, FormItemProps, FormItemRawElement, FormItemRawElementBinding, FormInstance, FormListProps, FormListBinding, FormListField, PathValueOf, StandardSchemaV1, } from './form';
 export { useControl } from 'react-use-control';
 export type { Control, ControlOrValue } from 'react-use-control';

package/dist/types/utils/collision.d.ts

@@ -38,14 +38,50 @@ type PlacementGap = {
  * and a missing value entirely — count as no padding.
  */
 export declare function resolvePadding(padding?: CollisionPadding): Record<CollisionSide, number>;
+/**
+ * Inline-axis mirror of each placement: what the logical name means in
+ * physical terms once the writing direction flips. Start/end alignments
+ * swap sides and the horizontal placements change sides; centers and the
+ * block axis are direction-invariant.
+ */
+declare const mirroredPlacements: {
+    readonly bottom: "bottom-end";
+    readonly 'bottom-span': "bottom-end";
+    readonly 'bottom-center': "bottom-center";
+    readonly 'bottom-end': "bottom";
+    readonly top: "top";
+    readonly left: "right";
+    readonly right: "left";
+};
+/**
+ * Resolve a placement to physical terms for a writing direction: the
+ * identity for LTR, the inline-axis mirror for RTL.
+ */
+export declare function mirrorPlacement<P extends keyof typeof mirroredPlacements>(placement: P, dir?: 'ltr' | 'rtl'): P | {
+    readonly bottom: "bottom-end";
+    readonly 'bottom-span': "bottom-end";
+    readonly 'bottom-center': "bottom-center";
+    readonly 'bottom-end': "bottom";
+    readonly top: "top";
+    readonly left: "right";
+    readonly right: "left";
+}[P];
 /**
  * Resolve a fixed-panel position from literal rects: baseline coordinates →
  * flip on the primary axis → shift on the cross axis → primary-axis clamp.
  * The baseline and flip math mirror placeFloatingPanel in floating.tsx, so
  * with zero padding and both strategies enabled the output is
  * pixel-identical to the legacy behavior.
+ *
+ * `placement` is logical, not physical: under `dir: 'rtl'` it mirrors on
+ * the inline axis first (see `mirrorPlacement`) — 'left' lands beside the
+ * trigger's physical right, and the start/end alignments of the vertical
+ * placements swap. The returned `placement` is the physical side the panel
+ * actually landed on, so collision outcomes stay comparable across
+ * directions. Omitting `dir` (or passing 'ltr') keeps the historical
+ * physical behavior.
  */
-export declare function computeFloatingPosition({ trigger: rect, panel: box, viewport, placement, gap, strategy, }: {
+export declare function computeFloatingPosition({ trigger: rect, panel: box, viewport, placement, gap, strategy, dir, }: {
     trigger: TriggerRect;
     panel: Size;
     viewport: Size;
@@ -54,6 +90,8 @@ export declare function computeFloatingPosition({ trigger: rect, panel: box, vie
     strategy: Required<Pick<CollisionStrategy, 'flip' | 'shift'>> & {
         padding: Record<CollisionSide, number>;
     };
+    /** Writing direction the placement resolves against; defaults to LTR. */
+    dir?: 'ltr' | 'rtl';
 }): {
     top: number;
     left: number;

package/dist/types/utils/direction.d.ts

@@ -0,0 +1,22 @@
+/** Writing direction of a subtree. */
+export type Direction = 'ltr' | 'rtl';
+/** Direction implied by a BCP 47 tag; `undefined` when no tag is given. */
+export declare function localeDirection(locale: string | undefined): Direction | undefined;
+/**
+ * Rendered direction of an element: the nearest ancestor carrying a
+ * `dir` attribute, `'ltr'` when none does. `dir="auto"` resolves by
+ * element content, so it defers to the computed style (and to `'ltr'`
+ * where that is unavailable, e.g. restricted environments).
+ */
+export declare function getDirection(el: Element | null): Direction;
+/**
+ * Declared direction for the current tree: the LocaleProvider chain's
+ * explicit `direction` prop or locale-derived direction, falling back to
+ * the document's rendered direction when no provider is mounted.
+ *
+ * Prefer {@link getDirection} on the concrete element whenever the value
+ * must match the painted layout — a provider's declared direction says
+ * what the app intends, the `[dir]` subtree says what CSS actually
+ * resolved.
+ */
+export declare function useDirection(): Direction;

package/dist/types/utils/floating.d.ts

@@ -22,6 +22,13 @@ export declare const floatingHidden: import("@linaria/core").LinariaClassName;
  * handover lands (a one-frame flash-back would otherwise show).
  */
 export declare const floatingAnimated: import("@linaria/core").LinariaClassName;
+/**
+ * Whether the anchored tier can use logical `position-area` keywords.
+ * Probes the exact value shape the logical classes declare (see the
+ * syntax trap above), gated on anchor positioning itself for the same
+ * reason `supportsAnchorPositioning` gates on the popover API.
+ */
+export declare function supportsLogicalPositionArea(): boolean;
 declare const anchoredPlacements: {
     readonly bottom: import("@linaria/core").LinariaClassName;
     readonly 'bottom-span': import("@linaria/core").LinariaClassName;
@@ -33,8 +40,10 @@ declare const anchoredPlacements: {
 };
 type AnchorablePlacement = keyof typeof anchoredPlacements;
 /**
- * Panel placement relative to the trigger. `point` leaves positioning
- * entirely to the consumer (e.g. ContextMenu at the pointer coordinates).
+ * Panel placement relative to the trigger, logical (inline-relative):
+ * under `dir='rtl'` the horizontal placements and the start/end
+ * alignments mirror (see the module's RTL note). `point` leaves
+ * positioning entirely to the consumer (e.g. ContextMenu at the pointer coordinates).
  */
 export type FloatingPlacement = AnchorablePlacement | 'point';
 type UseFloatingOptions = {
@@ -89,6 +98,13 @@ export type FloatingBehavior = {
     exited: boolean;
     /** Collision strategy FloatingPanel forwards to useFloatingPosition. */
     collision: CollisionStrategy | undefined;
+    /**
+     * Rendered writing direction of the trigger's subtree (`[dir]`
+     * resolution): drives the RTL mirror of the placement classes on the
+     * JS-positioned tiers. Read per render from the trigger element, so a
+     * panel that opens after mount always sees the live direction.
+     */
+    direction: 'ltr' | 'rtl';
     /** Unique CSS anchor name for this instance (anchored path). */
     anchorName: string;
     /** Inline style for the trigger: declares `anchor-name`. */
@@ -113,8 +129,20 @@ export type FloatingBehavior = {
     panelRef: RefObject<HTMLElement | null>;
 };
 export declare function useFloating({ open, setOpen, triggerRef, panelRef, animated, collision, }: UseFloatingOptions): FloatingBehavior;
-/** x-class entries placing the panel relative to the trigger, per tier. */
-export declare function floatingPlacementClasses(behavior: Pick<FloatingBehavior, 'native' | 'anchored'>, placement: FloatingPlacement): (string | false)[];
+/**
+ * x-class entries placing the panel relative to the trigger, per tier.
+ *
+ * `placement` is logical (see the module's RTL note): under `dir='rtl'`
+ * it mirrors on the inline axis. The anchored tier prefers logical
+ * `position-area` classes, which mirror themselves in CSS; engines
+ * without the logical keywords get the physical class of the mirrored
+ * placement. The JS-positioned tiers (gap margins, fallback offsets)
+ * are physical declarations, so the mirror is applied to the lookup
+ * here — the same `mirrorPlacement` `placeFloatingPanel` resolves
+ * coordinates with, keeping the gap class and the JS math on the same
+ * side.
+ */
+export declare function floatingPlacementClasses(behavior: Pick<FloatingBehavior, 'native' | 'anchored'>, placement: FloatingPlacement, dir?: 'ltr' | 'rtl'): (string | false)[];
 /**
  * Place a fixed panel from the trigger's rect (tier 2). Centers compute
  * from the panel's own rect, so this needs the panel to be laid out —

package/dist/types/utils/focus-scope.d.ts

@@ -1,7 +1,8 @@
 /**
  * 焦点域 hook（Radix FocusScope 的简化版，headless：返回 ref 回调，
  * 由消费方挂到容器元素上）。负责弹层的初始聚焦 / 焦点归还 / 可选困焦，
- * 无 CSS 依赖，不进 src/lib/index.ts barrel。
+ * 无 CSS 依赖，不进 src/lib/index.ts barrel——公共面由 haze-ui/headless
+ * 子路径策展导出。
  */
 export type FocusScopeOptions = {
     /**

package/dist/types/utils/focus.d.ts

@@ -2,7 +2,8 @@
  * 纯焦点工具：tabbable 元素查询与首个聚焦目标计算。
  *
  * 无 React、无 CSS 依赖，可在任意 DOM 环境（含 jsdom）直接复用。
- * 与 floating.tsx 一样属于内部原语，不进 src/lib/index.ts barrel。
+ * 与 floating.tsx 一样属于内部原语，不进 src/lib/index.ts barrel——
+ * 公共面由 haze-ui/headless 子路径策展导出。
  */
 /**
  * Tab 序候选元素选择器。仅做结构性筛选；disabled / hidden /

package/dist/types/utils/menuKeyboard.d.ts

@@ -14,14 +14,29 @@ type UseMenuKeyboardOptions = {
      * `[role=option]` list of a Command palette.
      */
     selector?: string;
+    /**
+     * Submenu levels only: called for the inline-start arrow (ArrowLeft in
+     * LTR, ArrowRight under `dir="rtl"` — mirrored like the horizontal
+     * orientation) so this level closes and focus returns to its trigger.
+     * Root menus leave it unset and the key stays inert.
+     */
+    onCloseToStart?: () => void;
+    /**
+     * Layout axis of the item container. Vertical (default) moves with
+     * ↑/↓; horizontal moves with ←/→, mirrored under `dir="rtl"` (←
+     * advances) so the keys follow the mirrored layout. Home/End, Escape,
+     * Tab-close and typeahead are direction-invariant either way.
+     */
+    orientation?: 'horizontal' | 'vertical';
 };
 /**
  * Keyboard behavior for a roving-tabindex item container (WAI-ARIA menu
- * button / listbox pattern): ↑/↓ move focus (wrapping, skipping disabled
- * items), Home/End jump to the ends, Escape closes (returning focus to
- * the trigger), Tab closes, and printable characters run typeahead.
+ * button / listbox pattern): the orientation's main-axis arrows move
+ * focus (wrapping, skipping disabled items), Home/End jump to the ends,
+ * Escape closes (returning focus to the trigger), Tab closes, and
+ * printable characters run typeahead.
  */
-export declare function useMenuKeyboard({ menuRef, onClose, selector, }: UseMenuKeyboardOptions): (event: ReactKeyboardEvent) => void;
+export declare function useMenuKeyboard({ menuRef, onClose, selector, onCloseToStart, orientation, }: UseMenuKeyboardOptions): (event: ReactKeyboardEvent) => void;
 type UseRovingTabindexOptions = {
     menuRef: RefObject<HTMLElement | null>;
     /**

package/dist/types/utils/refs.d.ts

@@ -0,0 +1,16 @@
+import type { Ref } from 'react';
+/**
+ * Compose several refs (object and/or callback) into one callback ref.
+ *
+ * The ref-forwarding pattern for components that need their own element
+ * handle *and* forward the consumer's ref to the same node (React 19
+ * ref-as-prop): the internal `useRef` and the forwarded `ref` prop both
+ * receive every attach/detach.
+ *
+ * The returned callback always returns `undefined` (React 19 warns on
+ * non-cleanup return values), so a consumer callback ref's own React 19
+ * cleanup-function return is not surfaced — the usual merged-refs
+ * trade-off, same as every component library.
+ */
+declare function mergeRefs<T>(...refs: (Ref<T> | undefined)[]): (node: T | null) => void;
+export { mergeRefs };

package/dist/types/utils/sortable-handle.d.ts

@@ -0,0 +1,25 @@
+import type { DraggableAttributes, DraggableSyntheticListeners } from '@dnd-kit/core';
+/**
+ * Dnd-free seam for the drag-handle contract. The @dnd-kit imports here are
+ * type-only and erased at runtime, so consumers that must stay free of the
+ * @dnd-kit runtime (TagGroupItem) import from this module; the provider
+ * side (SortableItem in utils/sortable.tsx) imports the same context from
+ * here. Split from sortable-shared.ts so the base components never reach
+ * the dnd runtime. Not part of the public barrel.
+ */
+export type SortableHandle = {
+    attributes: DraggableAttributes;
+    listeners: DraggableSyntheticListeners;
+};
+/**
+ * Handle props for the item's drag activator. SortableItem provides it so
+ * the item component (e.g. TagGroupItem) can place the interactive handle
+ * on its label span — a sibling of any close button — instead of letting
+ * dnd-kit's role=button land on an ancestor of interactive content (axe
+ * nested-interactive). Null outside a SortableItem.
+ */
+export declare const SortableHandleContext: import("react").Context<SortableHandle | null>;
+export declare function useSortableHandle(): SortableHandle | null;
+/** Drag-affordance styles for the element that carries the handle props
+ * (cursor + letting PointerSensor own touch drags instead of scrolling). */
+export declare const sortableHandle: import("@linaria/core").LinariaClassName;

package/dist/types/utils/sortable-shared.d.ts

@@ -0,0 +1,30 @@
+import type { Transform } from '@dnd-kit/utilities';
+/**
+ * Non-component drag-and-drop primitives for the Sortable* variants and
+ * the sortable wrappers in `sortable.tsx`. Split from the component file
+ * per the react-refresh sibling-file convention (Button/styles.ts,
+ * Chart/chart-elements.tsx precedents) — not part of the public barrel;
+ * consumers needing custom sortable surfaces should compose @dnd-kit
+ * directly.
+ *
+ * The @dnd-kit packages are optional peers following the Chart/recharts
+ * contract: these helpers import them statically, so under preserveModules
+ * only bundles that actually reach a Sortable* variant resolve the
+ * dependency.
+ *
+ * Base components (TagGroup, TagGroupItem, TagInputCore) must NOT import
+ * this module or utils/sortable — either would drag the @dnd-kit runtime
+ * into every consumer. Only the Sortable* variants and utils/sortable.tsx
+ * import from here.
+ */
+/** Sensors shared by every sortable surface: pointer drags with a small
+ * distance threshold (so clicks never start a drag) plus the sortable
+ * keyboard coordinate getter — Space lifts, arrows walk one item per
+ * press, Space drops, Escape cancels. */
+export declare function useSortableSensors(): import("@dnd-kit/core").SensorDescriptor<import("@dnd-kit/core").SensorOptions>[];
+/** Inline transform style for a sortable node; `transition` animates the
+ * snap-back after a cancelled or completed drag. */
+export declare function sortableItemStyle(transform: Transform | null, transition: string | null | undefined): {
+    transform: string | undefined;
+    transition: string | undefined;
+};

package/dist/types/utils/sortable.d.ts

@@ -0,0 +1,36 @@
+import type { ReactNode } from 'react';
+import type { SortingStrategy } from '@dnd-kit/sortable';
+/**
+ * Internal sortable wrapper components (the non-component primitives live
+ * in `sortable-shared.ts`). Not part of the public barrel — see the header
+ * comment there for the optional-peer contract.
+ */
+type SortableRegionProps = {
+    /** Stable sortable ids, one per item (both call sites use indices). */
+    ids: (string | number)[];
+    /** Layout strategy — rectSortingStrategy for wrapping chip rows,
+     * verticalListSortingStrategy for stacked lists. */
+    strategy: SortingStrategy;
+    /** Index move resolved from a completed drag; never called when the drop
+     * lands back on the origin item. */
+    onMove: (from: number, to: number) => void;
+    children: ReactNode;
+};
+/** DndContext + SortableContext wiring with the shared sensors and
+ * closest-center collision. Renders no DOM of its own, so it can wrap a
+ * ul or a chip row without changing layout or semantics. */
+export declare function SortableRegion({ ids, strategy, onMove, children }: SortableRegionProps): import("react").JSX.Element;
+type SortableItemProps = {
+    id: string | number;
+    className?: string;
+    children: ReactNode;
+};
+/**
+ * Non-semantic wrapper span that turns its child into a sortable item. The
+ * wrapper itself stays free of interactive semantics (axe nested-interactive
+ * stays clean even when the child contains buttons); the child picks up the
+ * drag handle via useSortableHandle. List-semantic parents (TagInput's ul)
+ * inline useSortable directly so the li keeps its listitem role.
+ */
+export declare function SortableItem({ id, className, children }: SortableItemProps): import("react").JSX.Element;
+export {};