@choice-ui/react 1.3.10

package/dist/core/app/components/menus/dist/index.d.ts

@@ -0,0 +1,512 @@
+import { default as react__default, HTMLProps, ReactNode } from 'react';
+import { ButtonProps } from '@choice-ui/button';
+import { KbdKey } from '@choice-ui/kbd';
+import { SearchInputProps } from '@choice-ui/search-input';
+import { InputProps } from '@choice-ui/input';
+import { SideObject, Placement, useFloating, useHover, useInteractions, useListItem, useFloatingTree } from '@floating-ui/react';
+import * as react from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare const MenuButton: react.MemoExoticComponent<react.ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & react.RefAttributes<HTMLButtonElement>>>;
+
+interface MenuCheckboxProps extends HTMLProps<HTMLDivElement> {
+    active?: boolean;
+    disabled?: boolean;
+    indeterminate?: boolean;
+    selected?: boolean;
+}
+declare const MenuCheckbox: react.NamedExoticComponent<MenuCheckboxProps>;
+
+declare const MenuDivider: react.ForwardRefExoticComponent<Omit<HTMLProps<HTMLDivElement>, "ref"> & react.RefAttributes<HTMLDivElement>>;
+
+interface MenuItemProps extends React.HTMLAttributes<HTMLButtonElement> {
+    active?: boolean;
+    children?: ReactNode;
+    classNames?: {
+        icon?: string;
+        root?: string;
+        shortcut?: string;
+    };
+    disabled?: boolean;
+    prefixElement?: ReactNode;
+    selected?: boolean;
+    shortcut?: {
+        keys?: ReactNode;
+        modifier?: KbdKey | KbdKey[] | undefined;
+    };
+    size?: "default" | "large";
+    suffixElement?: ReactNode;
+    variant?: "default" | "highlight" | "danger" | "reset";
+}
+declare const MenuItem: react.MemoExoticComponent<react.ForwardRefExoticComponent<MenuItemProps & react.RefAttributes<HTMLButtonElement>>>;
+
+interface MenuLabelProps {
+    children?: ReactNode;
+    className?: string;
+    selection?: boolean;
+}
+declare const MenuLabel: react.NamedExoticComponent<MenuLabelProps & Omit<react.HTMLProps<HTMLDivElement>, "label">>;
+
+interface MenuScrollArrowProps {
+    className?: string;
+    dir: "up" | "down";
+    innerOffset: number;
+    isPositioned: boolean;
+    onHide?: () => void;
+    onScroll: (amount: number) => void;
+    scrollRef: React.MutableRefObject<HTMLDivElement | null>;
+    scrollTop: number;
+}
+declare const MenuScrollArrow: (props: MenuScrollArrowProps) => react_jsx_runtime.JSX.Element;
+
+declare const MenuSearch: react.ForwardRefExoticComponent<Omit<SearchInputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
+interface MenuSearchEmptyProps extends React.HTMLAttributes<HTMLDivElement> {
+    children?: React.ReactNode;
+    defaultText?: {
+        searchEmpty: string;
+        searchEmptyButton: string;
+    };
+    onClear?: () => void;
+}
+declare const MenuSearchEmpty: react.NamedExoticComponent<MenuSearchEmptyProps>;
+
+interface MenuTriggerProps extends Omit<ButtonProps, "children"> {
+    asChild?: boolean;
+    children?: ReactNode | ((active: boolean) => ReactNode);
+    empty?: boolean;
+    enterForwardedProps?: boolean;
+    prefixClassName?: string;
+    prefixElement?: ReactNode;
+    suffixElement?: ReactNode;
+}
+declare const MenuTrigger: react.MemoExoticComponent<react.ForwardRefExoticComponent<Omit<MenuTriggerProps, "ref"> & react.RefAttributes<HTMLButtonElement>>>;
+
+declare const MenuInput: react.ForwardRefExoticComponent<Omit<InputProps, "ref"> & react.RefAttributes<HTMLInputElement>>;
+
+interface MenuValueProps extends HTMLProps<HTMLSpanElement> {
+    children: ReactNode;
+}
+declare const MenuValue: react.MemoExoticComponent<({ children, ...rest }: MenuValueProps) => react_jsx_runtime.JSX.Element>;
+
+interface MenusProps extends HTMLProps<HTMLDivElement> {
+    children: react__default.ReactNode;
+    matchTriggerWidth?: boolean;
+    variant?: "default" | "light" | "reset";
+}
+interface MenusComponentProps extends react__default.ForwardRefExoticComponent<MenusProps & react__default.RefAttributes<HTMLDivElement>> {
+    Button: typeof MenuButton;
+    Checkbox: typeof MenuCheckbox;
+    Divider: typeof MenuDivider;
+    Input: typeof MenuInput;
+    Item: typeof MenuItem;
+    Label: typeof MenuLabel;
+    Search: typeof MenuSearch;
+    SearchEmpty: typeof MenuSearchEmpty;
+    Value: typeof MenuValue;
+}
+declare const MenusBase: react__default.ForwardRefExoticComponent<Omit<MenusProps, "ref"> & react__default.RefAttributes<HTMLDivElement>>;
+declare const Menus: MenusComponentProps;
+
+/**
+ * 基础菜单状态管理 Hook
+ *
+ * 处理所有菜单组件的通用状态：
+ * - open/close 状态及受控逻辑
+ * - activeIndex 状态
+ * - touch 交互状态
+ * - scrollTop 状态
+ * - 唯一ID生成
+ * - 状态变化回调
+ */
+interface MenuStateConfig {
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 打开状态变化回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 受控的打开状态 */
+    open?: boolean;
+}
+interface MenuStateResult {
+    activeIndex: number | null;
+    handleOpenChange: (newOpen: boolean) => void;
+    isControlledOpen: boolean;
+    menuId: string;
+    open: boolean;
+    scrollTop: number;
+    setActiveIndex: (index: number | null) => void;
+    setOpen: (open: boolean) => void;
+    setScrollTop: (scrollTop: number) => void;
+    setTouch: (touch: boolean) => void;
+    touch: boolean;
+    triggerId: string;
+}
+declare function useMenuState(config?: MenuStateConfig): MenuStateResult;
+
+/**
+ * 菜单引用管理 Hook
+ *
+ * 统一管理菜单组件中所有需要的引用：
+ * - 滚动容器引用
+ * - 列表项引用数组
+ * - 列表内容引用数组
+ * - 定时器引用
+ * - Select 专用引用（overflow, allowSelect 等）
+ */
+interface MenuRefsConfig {
+    /** 是否为 Select 类型（需要额外的选择相关引用） */
+    isSelect?: boolean;
+}
+interface MenuRefsResult {
+    allowMouseUpRef?: React.MutableRefObject<boolean>;
+    allowSelectRef?: React.MutableRefObject<boolean>;
+    clearSelectTimeout: () => void;
+    elementsRef: React.MutableRefObject<Array<HTMLElement | null>>;
+    labelsRef: React.MutableRefObject<Array<string | null>>;
+    overflowRef?: React.MutableRefObject<SideObject | null>;
+    resetRefs: () => void;
+    scrollRef: React.MutableRefObject<HTMLDivElement | null>;
+    selectTimeoutRef: React.MutableRefObject<ReturnType<typeof setTimeout> | undefined>;
+}
+declare function useMenuRefs(config?: MenuRefsConfig): MenuRefsResult;
+
+/**
+ * 菜单触摸交互 Hook
+ *
+ * 处理菜单组件的触摸交互逻辑：
+ * - 触摸状态检测
+ * - 触摸开始事件处理
+ * - 指针移动事件处理
+ * - 触摸相关的事件处理器
+ */
+interface MenuTouchConfig {
+    /** 设置触摸状态 */
+    setTouch: (touch: boolean) => void;
+    /** 触摸状态 */
+    touch: boolean;
+}
+interface MenuTouchResult {
+    /** 获取触摸相关的引用属性 */
+    getTouchProps: () => {
+        onPointerMove: (event: React.PointerEvent) => void;
+        onTouchStart: () => void;
+    };
+    /** 指针移动事件处理器 */
+    handlePointerMove: (event: React.PointerEvent) => void;
+    /** 触摸开始事件处理器 */
+    handleTouchStart: () => void;
+}
+declare function useMenuTouch(config: MenuTouchConfig): MenuTouchResult;
+
+/**
+ * 菜单滚动处理 Hook
+ *
+ * 处理菜单组件的滚动相关逻辑：
+ * - 滚动位置管理
+ * - 箭头滚动处理
+ * - 滚动事件处理
+ * - 触摸相关的滚动隐藏逻辑
+ */
+interface MenuScrollConfig {
+    /** Select 专用：fallback 模式 */
+    fallback?: boolean;
+    /** 是否是 Select 类型（使用不同的滚动逻辑） */
+    isSelect?: boolean;
+    /** 滚动容器引用 */
+    scrollRef: React.RefObject<HTMLDivElement>;
+    /** 滚动位置状态 */
+    scrollTop: number;
+    /** 定时器引用 */
+    selectTimeoutRef: React.RefObject<ReturnType<typeof setTimeout> | undefined>;
+    /** Select 专用：设置内部偏移 */
+    setInnerOffset?: (offset: number | ((prev: number) => number)) => void;
+    /** 设置滚动位置 */
+    setScrollTop: (scrollTop: number) => void;
+    /** 触摸状态 */
+    touch: boolean;
+}
+interface MenuScrollResult {
+    /** 箭头隐藏处理器 */
+    handleArrowHide: () => void;
+    /** 箭头滚动处理器 */
+    handleArrowScroll: (amount: number) => void;
+    /** 滚动事件处理器 */
+    handleScroll: (event: React.UIEvent) => void;
+    /** 滚动相关的属性对象（已缓存，避免每次渲染都创建新对象） */
+    scrollProps: {
+        onScroll: (event: React.UIEvent) => void;
+    };
+}
+declare function useMenuScroll(config: MenuScrollConfig): MenuScrollResult;
+
+/**
+ * 菜单子元素解析 Hook
+ *
+ * 处理菜单组件的子元素解析逻辑：
+ * - 从 children 中提取 trigger 元素
+ * - 从 children 中提取 content 元素
+ * - 支持 Select 和 Dropdown 的不同子元素类型
+ * - 错误处理和警告
+ */
+interface MenuChildrenConfig<T extends react__default.ElementType = react__default.ElementType, C extends react__default.ElementType = react__default.ElementType, S extends react__default.ElementType = react__default.ElementType> {
+    /** Content 组件类型 */
+    ContentComponent: C;
+    /** SubTrigger 组件类型（仅 Dropdown 使用） */
+    SubTriggerComponent?: S;
+    /** Trigger 组件类型 */
+    TriggerComponent: T;
+    /** 子元素 */
+    children?: react__default.ReactNode;
+    /** 组件类型名称，用于错误提示 */
+    componentName: string;
+}
+interface MenuChildrenResult {
+    /** 内容元素 */
+    contentElement: react__default.ReactElement | null;
+    /** 错误信息 */
+    error?: string;
+    /** 是否有必需的元素 */
+    hasRequiredElements: boolean;
+    /** 子触发器元素（仅 Dropdown 使用） */
+    subTriggerElement?: react__default.ReactElement | null;
+    /** 触发器元素 */
+    triggerElement: react__default.ReactElement | null;
+}
+declare function useMenuChildren<T extends react__default.ElementType = react__default.ElementType, C extends react__default.ElementType = react__default.ElementType, S extends react__default.ElementType = react__default.ElementType>(config: MenuChildrenConfig<T, C, S>): MenuChildrenResult;
+
+/**
+ * 菜单 FloatingUI 配置 Hook
+ *
+ * 为 Select 和 Dropdown 提供不同的 floating 配置：
+ * - Select: 使用 inner 中间件 + 虚拟滚动
+ * - Dropdown: 使用标准中间件 + 嵌套支持
+ */
+interface MenuFloatingConfig {
+    activeIndex: number | null;
+    /** 当前选中索引（Select 专用） */
+    currentSelectedIndex?: number;
+    elementsRef: React.RefObject<Array<HTMLElement | null>>;
+    /** 是否为 fallback 模式（Select 专用） */
+    fallback?: boolean;
+    /** 状态变化回调 */
+    handleOpenChange: (open: boolean) => void;
+    /** 内部偏移（Select 专用） */
+    innerOffset?: number;
+    /** 当前打开状态 */
+    isControlledOpen: boolean;
+    /** 是否为嵌套模式（仅 Dropdown 使用） */
+    isNested?: boolean;
+    labelsRef: React.RefObject<Array<string | null>>;
+    /** 是否匹配触发器宽度 */
+    matchTriggerWidth?: boolean;
+    /** 节点 ID（仅 Dropdown 使用） */
+    nodeId?: string;
+    /** 偏移距离 */
+    offsetDistance?: number;
+    /** overflow 引用（Select 专用） */
+    overflowRef?: React.RefObject<SideObject | null>;
+    /** 位置配置 */
+    placement?: Placement;
+    scrollRef: React.RefObject<HTMLDivElement>;
+    setActiveIndex: (index: number | null) => void;
+    /** 设置 fallback（Select 专用） */
+    setFallback?: (fallback: boolean) => void;
+    /** 设置内部偏移（Select 专用） */
+    setInnerOffset?: (offset: number) => void;
+    /** 触摸状态 */
+    touch?: boolean;
+    /** 组件类型 */
+    type: "select" | "dropdown";
+}
+interface MenuFloatingResult {
+    /** floating 上下文和样式 */
+    floating: ReturnType<typeof useFloating>;
+    /** hover 处理器（仅 Dropdown 使用） */
+    hover?: ReturnType<typeof useHover>;
+    /** 交互处理器 */
+    interactions: ReturnType<typeof useInteractions>;
+}
+declare function useMenuFloating(config: MenuFloatingConfig): MenuFloatingResult;
+
+/**
+ * 菜单 FloatingTree 集成 Hook
+ *
+ * 专用于 Dropdown 组件的 FloatingTree 支持：
+ * - 管理 nodeId 和 parentId
+ * - 处理树形结构的事件通信
+ * - 支持嵌套菜单的打开/关闭协调
+ * - 处理父子菜单的焦点管理
+ */
+interface MenuTreeConfig {
+    /** 是否禁用嵌套功能 */
+    disabledNested?: boolean;
+    /** 打开状态变化处理函数 */
+    handleOpenChange: (open: boolean) => void;
+    /** 当前打开状态 */
+    isControlledOpen: boolean;
+}
+interface MenuTreeResult {
+    /** 清理 tree 事件监听 */
+    cleanupTreeEvents: () => void;
+    /** 是否为嵌套模式 */
+    isNested: boolean;
+    /** 列表项实例 */
+    item: ReturnType<typeof useListItem>;
+    /** 当前节点 ID */
+    nodeId: string | undefined;
+    /** 父节点 ID */
+    parentId: string | null;
+    /** FloatingTree 实例 */
+    tree: ReturnType<typeof useFloatingTree>;
+}
+declare function useMenuTree(config: MenuTreeConfig): MenuTreeResult;
+
+/**
+ * 菜单滚动容器高度设置 Hook
+ *
+ * 确保滚动容器正确设置高度，作为 size middleware 的补充
+ * 在所有菜单组件中都有类似的逻辑，统一抽取到这里
+ *
+ * 功能：
+ * - 在菜单打开且定位完成后，确保滚动容器正确继承父元素高度
+ * - 使用 requestAnimationFrame 确保 DOM 已更新，避免与 size middleware 的时序冲突
+ */
+interface MenuScrollHeightConfig {
+    /** 是否打开 */
+    isControlledOpen: boolean;
+    /** 是否已定位 */
+    isPositioned: boolean;
+    /** 滚动容器引用 */
+    scrollRef: React.RefObject<HTMLDivElement>;
+}
+/**
+ * 设置滚动容器高度
+ * 这个 hook 会在菜单打开且定位完成后，确保滚动容器正确设置高度
+ */
+declare function useMenuScrollHeight(config: MenuScrollHeightConfig): void;
+
+/**
+ * 菜单基础引用管理 Hook
+ *
+ * 统一管理所有菜单组件需要的基础 refs：
+ * - scrollRef: 滚动容器引用
+ * - elementsRef: 菜单项元素引用数组
+ * - labelsRef: 菜单项标签引用数组（用于 typeahead）
+ * - selectTimeoutRef: 选择延迟定时器引用
+ *
+ * 这些 refs 在多个组件中都有使用，统一管理可以保持一致性
+ */
+interface MenuBaseRefsResult {
+    /** 菜单项元素引用数组 */
+    elementsRef: React.MutableRefObject<Array<HTMLElement | null>>;
+    /** 菜单项标签引用数组（用于 typeahead） */
+    labelsRef: React.MutableRefObject<Array<string | null>>;
+    /** 滚动容器引用 */
+    scrollRef: React.RefObject<HTMLDivElement>;
+    /** 选择延迟定时器引用 */
+    selectTimeoutRef: React.MutableRefObject<ReturnType<typeof setTimeout> | undefined>;
+}
+/**
+ * 创建菜单基础引用
+ */
+declare function useMenuBaseRefs(): MenuBaseRefsResult;
+
+/**
+ * 菜单选择状态管理 Hook
+ *
+ * 专用于 Select 组件的选择逻辑：
+ * - 管理选中索引和值的映射
+ * - 处理选择延迟和阻止机制
+ * - 处理鼠标和键盘选择
+ * - 支持受控和非受控值
+ */
+interface MenuSelectionConfig {
+    /** 关闭菜单回调 */
+    handleOpenChange: (open: boolean) => void;
+    /** 是否控制打开状态 */
+    isControlledOpen: boolean;
+    /** 值变化回调 */
+    onChange?: (value: string) => void;
+    /** 选项列表 */
+    options: Array<{
+        [key: string]: unknown;
+        disabled?: boolean;
+        divider?: boolean;
+        value?: string;
+    }>;
+    /** 当前值 */
+    value?: string | null;
+}
+interface MenuSelectionResult {
+    /** 允许鼠标抬起状态 */
+    allowMouseUp: boolean;
+    /** 允许选择状态 */
+    allowSelect: boolean;
+    /** 阻止选择状态 */
+    blockSelection: boolean;
+    /** 当前选中索引（基于 value 计算） */
+    currentSelectedIndex: number;
+    /** 处理选择 */
+    handleSelect: (index: number) => void;
+    /** 当前选中索引 */
+    selectedIndex: number;
+    /** 设置允许鼠标抬起状态 */
+    setAllowMouseUp: (allow: boolean) => void;
+    /** 设置允许选择状态 */
+    setAllowSelect: (allow: boolean) => void;
+    /** 设置阻止选择状态 */
+    setBlockSelection: (block: boolean) => void;
+    /** 设置选中索引 */
+    setSelectedIndex: (index: number) => void;
+}
+declare function useMenuSelection(config: MenuSelectionConfig): MenuSelectionResult;
+
+/**
+ * 通用菜单上下文接口
+ *
+ * 用于 Select 和 Dropdown 组件的统一上下文
+ */
+interface MenuContextType {
+    activeIndex: number | null;
+    close: () => void;
+    getItemProps: <T extends React.HTMLProps<HTMLElement>>(userProps?: T) => Record<string, unknown>;
+    isOpen: boolean;
+    readOnly?: boolean;
+    selection: boolean;
+    setActiveIndex: (index: number | null) => void;
+    setHasFocusInside: (value: boolean) => void;
+    variant?: "default" | "light" | "reset";
+}
+declare const MenuContext: react.Context<MenuContextType | null>;
+declare const useMenu: () => MenuContextType;
+
+interface MenuContextItemProps extends MenuItemProps {
+    customActive?: boolean;
+    exclusiveIndex?: number;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onKeyDown?: (e: React.KeyboardEvent<HTMLButtonElement>) => void;
+    onMouseUp?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onTouchStart?: (e: React.TouchEvent<HTMLButtonElement>) => void;
+    value?: string;
+}
+/**
+ * 通用菜单项组件
+ *
+ * 供 Select 和 Dropdown 共用，统一所有交互逻辑：
+ * - touch 事件处理
+ * - 选择逻辑
+ * - 键盘导航
+ * - 视觉状态管理
+ */
+declare const MenuContextItem: react.MemoExoticComponent<react.ForwardRefExoticComponent<MenuContextItemProps & react.RefAttributes<HTMLButtonElement>>>;
+
+interface MenuContextContentProps extends HTMLProps<HTMLDivElement> {
+    children: React.ReactNode;
+    matchTriggerWidth?: boolean;
+}
+declare const MenuContextContent: react.ForwardRefExoticComponent<Omit<MenuContextContentProps, "ref"> & react.RefAttributes<HTMLDivElement>>;
+
+declare const MenuContextLabel: react.NamedExoticComponent<MenuLabelProps>;
+
+declare const MenuContextSubTrigger: react.MemoExoticComponent<react.ForwardRefExoticComponent<MenuItemProps & react.RefAttributes<HTMLButtonElement>>>;
+
+export { type MenuBaseRefsResult, MenuButton, MenuCheckbox, type MenuChildrenConfig, type MenuChildrenResult, MenuContext, MenuContextContent, MenuContextItem, type MenuContextItemProps, MenuContextLabel, MenuContextSubTrigger, type MenuContextType, MenuDivider, type MenuFloatingConfig, type MenuFloatingResult, MenuInput, MenuItem, type MenuItemProps, MenuLabel, type MenuLabelProps, type MenuRefsConfig, type MenuRefsResult, MenuScrollArrow, type MenuScrollConfig, type MenuScrollHeightConfig, type MenuScrollResult, MenuSearch, MenuSearchEmpty, type MenuSelectionConfig, type MenuSelectionResult, type MenuStateConfig, type MenuStateResult, type MenuTouchConfig, type MenuTouchResult, type MenuTreeConfig, type MenuTreeResult, MenuTrigger, type MenuTriggerProps, MenuValue, type MenuValueProps, Menus, MenusBase, useMenu, useMenuBaseRefs, useMenuChildren, useMenuFloating, useMenuRefs, useMenuScroll, useMenuScrollHeight, useMenuSelection, useMenuState, useMenuTouch, useMenuTree };

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

@@ -0,0 +1,10 @@
+export * from "./menu-button";
+export * from "./menu-checkbox";
+export * from "./menu-divider";
+export * from "./menu-item";
+export * from "./menu-label";
+export * from "./menu-scroll-arrow";
+export * from "./menu-search";
+export * from "./menu-trigger";
+export * from "./menu-input";
+export * from "./menu-value";

package/dist/core/app/components/menus/src/components/menu-button.d.ts

@@ -0,0 +1,2 @@
+import { type ButtonProps } from "@choice-ui/button";
+export declare const MenuButton: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Omit<ButtonProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>>;

package/dist/core/app/components/menus/src/components/menu-checkbox.d.ts

@@ -0,0 +1,9 @@
+import { HTMLProps } from "react";
+interface MenuCheckboxProps extends HTMLProps<HTMLDivElement> {
+    active?: boolean;
+    disabled?: boolean;
+    indeterminate?: boolean;
+    selected?: boolean;
+}
+export declare const MenuCheckbox: import("react").NamedExoticComponent<MenuCheckboxProps>;
+export {};

package/dist/core/app/components/menus/src/components/menu-divider.d.ts

@@ -0,0 +1,2 @@
+import { HTMLProps } from "react";
+export declare const MenuDivider: import("react").ForwardRefExoticComponent<Omit<HTMLProps<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;

package/dist/core/app/components/menus/src/components/menu-input.d.ts

@@ -0,0 +1,2 @@
+import { type InputProps } from "@choice-ui/input";
+export declare const MenuInput: import("react").ForwardRefExoticComponent<Omit<InputProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;

package/dist/core/app/components/menus/src/components/menu-item.d.ts

@@ -0,0 +1,22 @@
+import { type KbdKey } from "@choice-ui/kbd";
+import { ReactNode } from "react";
+export interface MenuItemProps extends React.HTMLAttributes<HTMLButtonElement> {
+    active?: boolean;
+    children?: ReactNode;
+    classNames?: {
+        icon?: string;
+        root?: string;
+        shortcut?: string;
+    };
+    disabled?: boolean;
+    prefixElement?: ReactNode;
+    selected?: boolean;
+    shortcut?: {
+        keys?: ReactNode;
+        modifier?: KbdKey | KbdKey[] | undefined;
+    };
+    size?: "default" | "large";
+    suffixElement?: ReactNode;
+    variant?: "default" | "highlight" | "danger" | "reset";
+}
+export declare const MenuItem: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<MenuItemProps & import("react").RefAttributes<HTMLButtonElement>>>;

package/dist/core/app/components/menus/src/components/menu-label.d.ts

@@ -0,0 +1,7 @@
+import { ReactNode } from "react";
+export interface MenuLabelProps {
+    children?: ReactNode;
+    className?: string;
+    selection?: boolean;
+}
+export declare const MenuLabel: import("react").NamedExoticComponent<MenuLabelProps & Omit<import("react").HTMLProps<HTMLDivElement>, "label">>;

package/dist/core/app/components/menus/src/components/menu-scroll-arrow.d.ts

@@ -0,0 +1,12 @@
+interface MenuScrollArrowProps {
+    className?: string;
+    dir: "up" | "down";
+    innerOffset: number;
+    isPositioned: boolean;
+    onHide?: () => void;
+    onScroll: (amount: number) => void;
+    scrollRef: React.MutableRefObject<HTMLDivElement | null>;
+    scrollTop: number;
+}
+export declare const MenuScrollArrow: (props: MenuScrollArrowProps) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/core/app/components/menus/src/components/menu-search.d.ts

@@ -0,0 +1,12 @@
+import { type SearchInputProps } from "@choice-ui/search-input";
+export declare const MenuSearch: import("react").ForwardRefExoticComponent<Omit<SearchInputProps, "ref"> & import("react").RefAttributes<HTMLInputElement>>;
+interface MenuSearchEmptyProps extends React.HTMLAttributes<HTMLDivElement> {
+    children?: React.ReactNode;
+    defaultText?: {
+        searchEmpty: string;
+        searchEmptyButton: string;
+    };
+    onClear?: () => void;
+}
+export declare const MenuSearchEmpty: import("react").NamedExoticComponent<MenuSearchEmptyProps>;
+export {};

package/dist/core/app/components/menus/src/components/menu-trigger.d.ts

@@ -0,0 +1,12 @@
+import { type ButtonProps } from "@choice-ui/button";
+import { ReactNode } from "react";
+export interface MenuTriggerProps extends Omit<ButtonProps, "children"> {
+    asChild?: boolean;
+    children?: ReactNode | ((active: boolean) => ReactNode);
+    empty?: boolean;
+    enterForwardedProps?: boolean;
+    prefixClassName?: string;
+    prefixElement?: ReactNode;
+    suffixElement?: ReactNode;
+}
+export declare const MenuTrigger: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<Omit<MenuTriggerProps, "ref"> & import("react").RefAttributes<HTMLButtonElement>>>;

package/dist/core/app/components/menus/src/components/menu-value.d.ts

@@ -0,0 +1,5 @@
+import { HTMLProps, ReactNode } from "react";
+export interface MenuValueProps extends HTMLProps<HTMLSpanElement> {
+    children: ReactNode;
+}
+export declare const MenuValue: import("react").MemoExoticComponent<({ children, ...rest }: MenuValueProps) => import("react/jsx-runtime").JSX.Element>;

package/dist/core/app/components/menus/src/context/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./menu-context";
+export * from "./menu-context-item";
+export * from "./menu-context-content";
+export * from "./menu-context-label";
+export * from "./menu-context-sub-trigger";

package/dist/core/app/components/menus/src/context/menu-context-content.d.ts

@@ -0,0 +1,7 @@
+import { HTMLProps } from "react";
+interface MenuContextContentProps extends HTMLProps<HTMLDivElement> {
+    children: React.ReactNode;
+    matchTriggerWidth?: boolean;
+}
+export declare const MenuContextContent: import("react").ForwardRefExoticComponent<Omit<MenuContextContentProps, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export {};

package/dist/core/app/components/menus/src/context/menu-context-item.d.ts

@@ -0,0 +1,20 @@
+import { type MenuItemProps } from "../components/menu-item";
+export interface MenuContextItemProps extends MenuItemProps {
+    customActive?: boolean;
+    exclusiveIndex?: number;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onKeyDown?: (e: React.KeyboardEvent<HTMLButtonElement>) => void;
+    onMouseUp?: (e: React.MouseEvent<HTMLButtonElement>) => void;
+    onTouchStart?: (e: React.TouchEvent<HTMLButtonElement>) => void;
+    value?: string;
+}
+/**
+ * 通用菜单项组件
+ *
+ * 供 Select 和 Dropdown 共用，统一所有交互逻辑：
+ * - touch 事件处理
+ * - 选择逻辑
+ * - 键盘导航
+ * - 视觉状态管理
+ */
+export declare const MenuContextItem: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<MenuContextItemProps & import("react").RefAttributes<HTMLButtonElement>>>;

package/dist/core/app/components/menus/src/context/menu-context-label.d.ts

@@ -0,0 +1,2 @@
+import { MenuLabelProps } from "../components/menu-label";
+export declare const MenuContextLabel: import("react").NamedExoticComponent<MenuLabelProps>;

package/dist/core/app/components/menus/src/context/menu-context-sub-trigger.d.ts

@@ -0,0 +1,2 @@
+import { MenuItemProps } from "../components/menu-item";
+export declare const MenuContextSubTrigger: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<MenuItemProps & import("react").RefAttributes<HTMLButtonElement>>>;