@choice-ui/react 1.4.3 → 1.4.6

package/dist/components/menus/src/hooks/use-menu-children.d.ts

@@ -1,35 +1,35 @@
 import { default as React } from 'react';
 /**
- * 菜单子元素解析 Hook
+ * Menu children parsing Hook
  *
- * 处理菜单组件的子元素解析逻辑：
- * - 从 children 中提取 trigger 元素
- * - 从 children 中提取 content 元素
- * - 支持 Select 和 Dropdown 的不同子元素类型
- * - 错误处理和警告
+ * Handle menu component child element parsing logic:
+ * - Extract trigger element from children
+ * - Extract content element from children
+ * - Support different child element types for Select and Dropdown
+ * - Error handling and warnings
  */
 export interface MenuChildrenConfig<T extends React.ElementType = React.ElementType, C extends React.ElementType = React.ElementType, S extends React.ElementType = React.ElementType> {
-    /** Content 组件类型 */
+    /** Content component type */
     ContentComponent: C;
-    /** SubTrigger 组件类型（仅 Dropdown 使用） */
+    /** SubTrigger component type (only used for Dropdown) */
     SubTriggerComponent?: S;
-    /** Trigger 组件类型 */
+    /** Trigger component type */
     TriggerComponent: T;
-    /** 子元素 */
+    /** Children */
     children?: React.ReactNode;
-    /** 组件类型名称，用于错误提示 */
+    /** Component type name, for error提示 */
     componentName: string;
 }
 export interface MenuChildrenResult {
-    /** 内容元素 */
+    /** Content element */
     contentElement: React.ReactElement | null;
-    /** 错误信息 */
+    /** Error message */
     error?: string;
-    /** 是否有必需的元素 */
+    /** Whether there are required elements */
     hasRequiredElements: boolean;
-    /** 子触发器元素（仅 Dropdown 使用） */
+    /** Sub-trigger element (only used for Dropdown) */
     subTriggerElement?: React.ReactElement | null;
-    /** 触发器元素 */
+    /** Trigger element */
     triggerElement: React.ReactElement | null;
 }
 export declare function useMenuChildren<T extends React.ElementType = React.ElementType, C extends React.ElementType = React.ElementType, S extends React.ElementType = React.ElementType>(config: MenuChildrenConfig<T, C, S>): MenuChildrenResult;

package/dist/components/menus/src/hooks/use-menu-floating.d.ts

@@ -1,54 +1,54 @@
 import { useFloating, useInteractions, useHover, Placement, SideObject } from '@floating-ui/react';
 /**
- * 菜单 FloatingUI 配置 Hook
+ * Menu FloatingUI configuration Hook
  *
- * 为 Select 和 Dropdown 提供不同的 floating 配置：
- * - Select: 使用 inner 中间件 + 虚拟滚动
- * - Dropdown: 使用标准中间件 + 嵌套支持
+ * Provide different floating configurations for Select and Dropdown:
+ * - Select: use inner middleware + virtual scrolling
+ * - Dropdown: use standard middleware + nested support
  */
 export interface MenuFloatingConfig {
     activeIndex: number | null;
-    /** 当前选中索引（Select 专用） */
+    /** Current selected index (Select specific) */
     currentSelectedIndex?: number;
     elementsRef: React.RefObject<Array<HTMLElement | null>>;
-    /** 是否为 fallback 模式（Select 专用） */
+    /** Whether to use fallback mode (Select specific) */
     fallback?: boolean;
-    /** 状态变化回调 */
+    /** State change callback */
     handleOpenChange: (open: boolean) => void;
-    /** 内部偏移（Select 专用） */
+    /** Internal offset (Select specific) */
     innerOffset?: number;
-    /** 当前打开状态 */
+    /** Current open state */
     isControlledOpen: boolean;
-    /** 是否为嵌套模式（仅 Dropdown 使用） */
+    /** Whether to use nested mode (only used for Dropdown) */
     isNested?: boolean;
     labelsRef: React.RefObject<Array<string | null>>;
-    /** 是否匹配触发器宽度 */
+    /** Whether to match trigger width */
     matchTriggerWidth?: boolean;
-    /** 节点 ID（仅 Dropdown 使用） */
+    /** Node ID (only used for Dropdown) */
     nodeId?: string;
-    /** 偏移距离 */
+    /** Offset distance */
     offsetDistance?: number;
-    /** overflow 引用（Select 专用） */
+    /** overflow reference (Select specific) */
     overflowRef?: React.RefObject<SideObject | null>;
-    /** 位置配置 */
+    /** Position configuration */
     placement?: Placement;
     scrollRef: React.RefObject<HTMLDivElement>;
     setActiveIndex: (index: number | null) => void;
-    /** 设置 fallback（Select 专用） */
+    /** Set fallback (Select specific) */
     setFallback?: (fallback: boolean) => void;
-    /** 设置内部偏移（Select 专用） */
+    /** Set internal offset (Select specific) */
     setInnerOffset?: (offset: number) => void;
-    /** 触摸状态 */
+    /** Touch state */
     touch?: boolean;
-    /** 组件类型 */
+    /** Component type */
     type: "select" | "dropdown";
 }
 export interface MenuFloatingResult {
-    /** floating 上下文和样式 */
+    /** floating context and styles */
     floating: ReturnType<typeof useFloating>;
-    /** hover 处理器（仅 Dropdown 使用） */
+    /** hover handler (only used for Dropdown) */
     hover?: ReturnType<typeof useHover>;
-    /** 交互处理器 */
+    /** Interaction handler */
     interactions: ReturnType<typeof useInteractions>;
 }
 export declare function useMenuFloating(config: MenuFloatingConfig): MenuFloatingResult;

package/dist/components/menus/src/hooks/use-menu-refs.d.ts

@@ -1,16 +1,16 @@
 import { SideObject } from '@floating-ui/react';
 /**
- * 菜单引用管理 Hook
+ * Menu reference management Hook
  *
- * 统一管理菜单组件中所有需要的引用：
- * - 滚动容器引用
- * - 列表项引用数组
- * - 列表内容引用数组
- * - 定时器引用
- * - Select 专用引用（overflow, allowSelect 等）
+ * Unify the management of all references needed in menu components:
+ * - Scroll container reference
+ * - List item reference array
+ * - List content reference array
+ * - Timer reference
+ * - Select specific reference (overflow, allowSelect, etc.)
  */
 export interface MenuRefsConfig {
-    /** 是否为 Select 类型（需要额外的选择相关引用） */
+    /** Whether to use Select type (requires additional selection related references) */
     isSelect?: boolean;
 }
 export interface MenuRefsResult {

package/dist/components/menus/src/hooks/use-menu-refs.js

@@ -29,12 +29,12 @@ function useMenuRefs(config = {}) {
   };
   const result = useMemo(() => {
     const baseResult = {
-      // 通用引用
+      // General reference
       scrollRef,
       elementsRef,
       labelsRef,
       selectTimeoutRef,
-      // 工具函数
+      // Utility functions
       clearSelectTimeout,
       resetRefs
     };

package/dist/components/menus/src/hooks/use-menu-scroll-height.d.ts

@@ -1,23 +1,23 @@
 /**
- * 菜单滚动容器高度设置 Hook
+ * Menu scroll container height setting Hook
  *
- * 确保滚动容器正确设置高度，作为 size middleware 的补充
- * 在所有菜单组件中都有类似的逻辑，统一抽取到这里
+ * Ensure the scroll container is correctly set to the parent element height, as a complement to the size middleware
+ * Similar logic exists in all menu components, unified extraction here
  *
- * 功能：
- * - 在菜单打开且定位完成后，确保滚动容器正确继承父元素高度
- * - 使用 requestAnimationFrame 确保 DOM 已更新，避免与 size middleware 的时序冲突
+ * Features:
+ * - Ensure the scroll container is correctly inherited from the parent element height after opening and positioning
+ * - Use requestAnimationFrame to ensure the DOM is updated, avoiding timing conflicts with the size middleware
  */
 export interface MenuScrollHeightConfig {
-    /** 是否打开 */
+    /** Whether to open */
     isControlledOpen: boolean;
-    /** 是否已定位 */
+    /** Whether to be positioned */
     isPositioned: boolean;
-    /** 滚动容器引用 */
+    /** Scroll container reference */
     scrollRef: React.RefObject<HTMLDivElement>;
 }
 /**
- * 设置滚动容器高度
- * 这个 hook 会在菜单打开且定位完成后，确保滚动容器正确设置高度
+ * Set scroll container height
+ * This hook will ensure the scroll container is correctly set to the parent element height after opening and positioning
  */
 export declare function useMenuScrollHeight(config: MenuScrollHeightConfig): void;

package/dist/components/menus/src/hooks/use-menu-scroll.d.ts

@@ -1,38 +1,38 @@
 /**
- * 菜单滚动处理 Hook
+ * Menu scroll handling Hook
  *
- * 处理菜单组件的滚动相关逻辑：
- * - 滚动位置管理
- * - 箭头滚动处理
- * - 滚动事件处理
- * - 触摸相关的滚动隐藏逻辑
+ * Handle scroll related logic in menu components:
+ * - Scroll position management
+ * - Arrow scroll handling
+ * - Scroll event handling
+ * - Touch-related scroll hiding logic
  */
 export interface MenuScrollConfig {
-    /** Select 专用：fallback 模式 */
+    /** Select specific: fallback mode */
     fallback?: boolean;
-    /** 是否是 Select 类型（使用不同的滚动逻辑） */
+    /** Whether to use Select type (uses different scroll logic) */
     isSelect?: boolean;
-    /** 滚动容器引用 */
+    /** Scroll container reference */
     scrollRef: React.RefObject<HTMLDivElement>;
-    /** 滚动位置状态 */
+    /** Scroll position state */
     scrollTop: number;
-    /** 定时器引用 */
+    /** Timer reference */
     selectTimeoutRef: React.RefObject<ReturnType<typeof setTimeout> | undefined>;
-    /** Select 专用：设置内部偏移 */
+    /** Select specific: set internal offset */
     setInnerOffset?: (offset: number | ((prev: number) => number)) => void;
-    /** 设置滚动位置 */
+    /** Set scroll position */
     setScrollTop: (scrollTop: number) => void;
-    /** 触摸状态 */
+    /** Touch state */
     touch: boolean;
 }
 export interface MenuScrollResult {
-    /** 箭头隐藏处理器 */
+    /** Arrow hide handler */
     handleArrowHide: () => void;
-    /** 箭头滚动处理器 */
+    /** Arrow scroll handler */
     handleArrowScroll: (amount: number) => void;
-    /** 滚动事件处理器 */
+    /** Scroll event handler */
     handleScroll: (event: React.UIEvent) => void;
-    /** 滚动相关的属性对象（已缓存，避免每次渲染都创建新对象） */
+    /** Scroll-related property object (cached to avoid creating new objects on every render) */
     scrollProps: {
         onScroll: (event: React.UIEvent) => void;
     };

package/dist/components/menus/src/hooks/use-menu-selection.d.ts

@@ -1,49 +1,49 @@
 /**
- * 菜单选择状态管理 Hook
+ * Menu selection state management Hook
  *
- * 专用于 Select 组件的选择逻辑：
- * - 管理选中索引和值的映射
- * - 处理选择延迟和阻止机制
- * - 处理鼠标和键盘选择
- * - 支持受控和非受控值
+ * Specialized for Select component selection logic:
+ * - Manage the mapping of selected index and value
+ * - Handle selection delay and blocking mechanism
+ * - Handle mouse and keyboard selection
+ * - Support controlled and uncontrolled values
  */
 export interface MenuSelectionConfig {
-    /** 关闭菜单回调 */
+    /** Close menu callback */
     handleOpenChange: (open: boolean) => void;
-    /** 是否控制打开状态 */
+    /** Whether to control the open state */
     isControlledOpen: boolean;
-    /** 值变化回调 */
+    /** Value change callback */
     onChange?: (value: string) => void;
-    /** 选项列表 */
+    /** Option list */
     options: Array<{
         [key: string]: unknown;
         disabled?: boolean;
         divider?: boolean;
         value?: string;
     }>;
-    /** 当前值 */
+    /** Current value */
     value?: string | null;
 }
 export interface MenuSelectionResult {
-    /** 允许鼠标抬起状态 */
+    /** Allow mouse up state */
     allowMouseUp: boolean;
-    /** 允许选择状态 */
+    /** Allow select state */
     allowSelect: boolean;
-    /** 阻止选择状态 */
+    /** Block select state */
     blockSelection: boolean;
-    /** 当前选中索引（基于 value 计算） */
+    /** Current selected index (based on value calculation) */
     currentSelectedIndex: number;
-    /** 处理选择 */
+    /** Handle selection */
     handleSelect: (index: number) => void;
-    /** 当前选中索引 */
+    /** Current selected index */
     selectedIndex: number;
-    /** 设置允许鼠标抬起状态 */
+    /** Set allow mouse up state */
     setAllowMouseUp: (allow: boolean) => void;
-    /** 设置允许选择状态 */
+    /** Set allow select state */
     setAllowSelect: (allow: boolean) => void;
-    /** 设置阻止选择状态 */
+    /** Set block select state */
     setBlockSelection: (block: boolean) => void;
-    /** 设置选中索引 */
+    /** Set selected index */
     setSelectedIndex: (index: number) => void;
 }
 export declare function useMenuSelection(config: MenuSelectionConfig): MenuSelectionResult;

package/dist/components/menus/src/hooks/use-menu-state.d.ts

@@ -1,20 +1,20 @@
 /**
- * 基础菜单状态管理 Hook
+ * Basic menu state management Hook
  *
- * 处理所有菜单组件的通用状态：
- * - open/close 状态及受控逻辑
- * - activeIndex 状态
- * - touch 交互状态
- * - scrollTop 状态
- * - 唯一ID生成
- * - 状态变化回调
+ * Handle common state for all menu components:
+ * - open/close state and controlled logic
+ * - activeIndex state
+ * - touch interaction state
+ * - scrollTop state
+ * - Unique ID generation
+ * - State change callback
  */
 export interface MenuStateConfig {
-    /** 是否禁用 */
+    /** Whether to disable */
     disabled?: boolean;
-    /** 打开状态变化回调 */
+    /** Open state change callback */
     onOpenChange?: (open: boolean) => void;
-    /** 受控的打开状态 */
+    /** Controlled open state */
     open?: boolean;
 }
 export interface MenuStateResult {

package/dist/components/menus/src/hooks/use-menu-state.js

@@ -21,20 +21,20 @@ function useMenuState(config = {}) {
   });
   const result = useMemo(
     () => ({
-      // 状态
+      // State
       open,
       activeIndex,
       touch,
       scrollTop,
       isControlledOpen,
-      // 状态设置函数
+      // State setting function
       setOpen,
       setActiveIndex,
       setTouch,
       setScrollTop,
-      // 处理函数
+      // Handle function
       handleOpenChange,
-      // 唯一标识
+      // Unique identifier
       menuId,
       triggerId
     }),

package/dist/components/menus/src/hooks/use-menu-touch.d.ts

@@ -1,27 +1,27 @@
 /**
- * 菜单触摸交互 Hook
+ * Menu touch interaction Hook
  *
- * 处理菜单组件的触摸交互逻辑：
- * - 触摸状态检测
- * - 触摸开始事件处理
- * - 指针移动事件处理
- * - 触摸相关的事件处理器
+ * Handle menu component touch interaction logic:
+ * - Touch state detection
+ * - Touch start event handling
+ * - Pointer move event handling
+ * - Touch-related event handlers
  */
 export interface MenuTouchConfig {
-    /** 设置触摸状态 */
+    /** Set touch state */
     setTouch: (touch: boolean) => void;
-    /** 触摸状态 */
+    /** Touch state */
     touch: boolean;
 }
 export interface MenuTouchResult {
-    /** 获取触摸相关的引用属性 */
+    /** Get touch-related reference properties */
     getTouchProps: () => {
         onPointerMove: (event: React.PointerEvent) => void;
         onTouchStart: () => void;
     };
-    /** 指针移动事件处理器 */
+    /** Pointer move event handler */
     handlePointerMove: (event: React.PointerEvent) => void;
-    /** 触摸开始事件处理器 */
+    /** Touch start event handler */
     handleTouchStart: () => void;
 }
 export declare function useMenuTouch(config: MenuTouchConfig): MenuTouchResult;

package/dist/components/menus/src/hooks/use-menu-tree.d.ts

@@ -1,33 +1,33 @@
 import { useFloatingTree, useListItem } from '@floating-ui/react';
 /**
- * 菜单 FloatingTree 集成 Hook
+ * Menu FloatingTree integration Hook
  *
- * 专用于 Dropdown 组件的 FloatingTree 支持：
- * - 管理 nodeId 和 parentId
- * - 处理树形结构的事件通信
- * - 支持嵌套菜单的打开/关闭协调
- * - 处理父子菜单的焦点管理
+ * Specialized for FloatingTree support for Dropdown component:
+ * - Manage nodeId and parentId
+ * - Handle event communication for tree structure
+ * - Support opening/closing coordination for nested menus
+ * - Handle focus management for parent and child menus
  */
 export interface MenuTreeConfig {
-    /** 是否禁用嵌套功能 */
+    /** Whether to disable nested functionality */
     disabledNested?: boolean;
-    /** 打开状态变化处理函数 */
+    /** Open state change handling function */
     handleOpenChange: (open: boolean) => void;
-    /** 当前打开状态 */
+    /** Current open state */
     isControlledOpen: boolean;
 }
 export interface MenuTreeResult {
-    /** 清理 tree 事件监听 */
+    /** Clean up tree event listening */
     cleanupTreeEvents: () => void;
-    /** 是否为嵌套模式 */
+    /** Whether to be nested mode */
     isNested: boolean;
-    /** 列表项实例 */
+    /** List item instance */
     item: ReturnType<typeof useListItem>;
-    /** 当前节点 ID */
+    /** Current node ID */
     nodeId: string | undefined;
-    /** 父节点 ID */
+    /** Parent node ID */
     parentId: string | null;
-    /** FloatingTree 实例 */
+    /** FloatingTree instance */
     tree: ReturnType<typeof useFloatingTree>;
 }
 export declare function useMenuTree(config: MenuTreeConfig): MenuTreeResult;

package/dist/components/menus/src/index.d.ts

@@ -3,4 +3,9 @@ export { Menus } from './menus';
 export { useMenuBaseRefs, useMenuChildren, useMenuFloating, useMenuRefs, useMenuScroll, useMenuScrollHeight, useMenuSelection, useMenuState, useMenuTree, } from './hooks';
 export { MenuContext, MenuContextSubTrigger, MenuContextContent, MenuContextItem, MenuContextLabel, } from './context';
 export type { MenusProps } from './menus';
+export type { MenuItemProps } from './components/menu-item';
+export type { MenuTriggerProps } from './components/menu-trigger';
+export type { MenuScrollArrowProps } from './components/menu-scroll-arrow';
+export type { MenuLabelProps } from './components/menu-label';
+export type { MenuCheckboxProps } from './components/menu-checkbox';
 export type { MenuContextItemProps, MenuContextType } from './context';

package/dist/components/menus/src/menus.js

@@ -12,7 +12,7 @@ import { MenusTv } from "./tv.js";
 import { tcx } from "../../../shared/utils/tcx/tcx.js";
 const MenusBase = forwardRef((props, ref) => {
   const { children, className, matchTriggerWidth, variant, ...rest } = props;
-  const styles = MenusTv({ matchTriggerWidth, variant });
+  const tv = MenusTv({ matchTriggerWidth, variant });
   const processChildren = (children2) => {
     return Children.map(children2, (child) => {
       if (isValidElement(child)) {
@@ -36,7 +36,7 @@ const MenusBase = forwardRef((props, ref) => {
       ref,
       role: "menu",
       ...rest,
-      className: tcx(styles, className),
+      className: tcx(tv, className),
       "data-variant": variant,
       children: processedChildren
     }

package/dist/components/menus/src/tv.d.ts

@@ -365,6 +365,11 @@ export declare const MenuScrollArrowTv: import('tailwind-variants').TVReturnType
         true: string;
         false: string;
     };
+    variant: {
+        default: string;
+        light: string;
+        reset: {};
+    };
 }, undefined, string[], {
     dir: {
         up: string;
@@ -374,6 +379,11 @@ export declare const MenuScrollArrowTv: import('tailwind-variants').TVReturnType
         true: string;
         false: string;
     };
+    variant: {
+        default: string;
+        light: string;
+        reset: {};
+    };
 }, undefined, import('tailwind-variants').TVReturnType<{
     dir: {
         up: string;
@@ -383,6 +393,11 @@ export declare const MenuScrollArrowTv: import('tailwind-variants').TVReturnType
         true: string;
         false: string;
     };
+    variant: {
+        default: string;
+        light: string;
+        reset: {};
+    };
 }, undefined, string[], unknown, unknown, undefined>>;
 export declare const MenuCheckboxTv: import('tailwind-variants').TVReturnType<{
     active: {

package/dist/components/menus/src/tv.js

@@ -201,7 +201,7 @@ const MenuButtonTv = tcv({
 const MenuScrollArrowTv = tcv({
   base: [
     "absolute flex h-6 w-full items-center justify-center overflow-hidden",
-    "z-menu pointer-events-auto border-white/10 bg-gray-900 text-white hover:bg-gray-800"
+    "z-menu pointer-events-auto backdrop-blur-sm"
   ],
   variants: {
     dir: {
@@ -211,11 +211,17 @@ const MenuScrollArrowTv = tcv({
     visible: {
       true: "visible",
       false: "hidden"
+    },
+    variant: {
+      default: "border-white/10 bg-gray-900/50 text-white hover:bg-gray-800",
+      light: "border-gray-200 bg-white/50 text-gray-900 hover:bg-gray-100",
+      reset: {}
     }
   },
   defaultVariants: {
     visible: false,
-    dir: "down"
+    dir: "down",
+    variant: "default"
   }
 });
 const MenuCheckboxTv = tcv({

package/dist/components/modal/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { HTMLProps, ReactNode } from 'react';
+import { IconButtonProps } from '../../icon-button/src';
 import { SelectProps } from '../../select/src';
 import { MotionProps } from 'framer-motion';
 import { InputProps } from '../../input/src';
@@ -8,8 +9,9 @@ import * as react from 'react';
 declare const ModalContent: react.ForwardRefExoticComponent<Omit<HTMLProps<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
 
 interface ModalHeaderProps extends Omit<HTMLProps<HTMLDivElement>, "title"> {
-    onClose?: () => void;
     title?: ReactNode;
+    closeButtonProps?: IconButtonProps;
+    onClose?: () => void;
 }
 declare const ModalHeader: react.ForwardRefExoticComponent<Omit<ModalHeaderProps, "ref"> & react.RefAttributes<HTMLDivElement>>;