@sia.soul/sia-react-ui 0.1.22 → 0.1.24

package/dist/Select-O_yY51vc.d.ts

@@ -0,0 +1,307 @@
+import * as react from 'react';
+import { ButtonHTMLAttributes, ReactNode, HTMLAttributes } from 'react';
+import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.js';
+
+/** 按钮视觉样式，可选择主按钮、默认按钮、文本按钮或链接等形式。 */
+type ButtonVariant = "primary" | "default" | "dashed" | "filled" | "text" | "link";
+/** 按钮尺寸等级。 */
+type ButtonSize = ControlSize;
+/** 按钮的属性配置。 */
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     组件的视觉样式。
+     * @defaultValue "default"
+     */
+    variant?: ButtonVariant;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
+    size?: ButtonSize;
+    /**
+     * 显示加载状态并禁止重复点击
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 宽度撑满父容器
+     * @defaultValue false
+     */
+    block?: boolean;
+    /**
+     * 危险操作样式
+     * @defaultValue false
+     */
+    danger?: boolean;
+    /** 按钮图标 */
+    icon?: ReactNode;
+    /**
+     * 图标位置
+     * @defaultValue "start"
+     */
+    iconPosition?: "start" | "end";
+}
+/** 按钮组件。 */
+declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
+
+/** 弹层挂载节点或返回挂载节点的函数。 */
+type OverlayContainer = HTMLElement | (() => HTMLElement);
+
+/** 模态框的类型标识。 */
+type ModalType = "default" | "info" | "success" | "warning" | "error" | "confirm";
+/** 确认操作的返回值；false 阻止关闭，Promise 可用于等待异步操作。 */
+type ModalActionResult = void | boolean | Promise<void | boolean>;
+/** 模态框的属性配置。 */
+interface ModalProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onSubmit"> {
+    /** 是否显示对话框 */
+    open: boolean;
+    /** 标题 */
+    title?: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
+    children?: ReactNode;
+    /** 自定义底部操作区，传 null 隐藏 */
+    footer?: ReactNode | null;
+    /** 默认底部操作区左侧的扩展内容。 */
+    footerExtra?: ReactNode;
+    /**
+     * 类型标识，用于选择对应的表现形式。
+     * @defaultValue "default"
+     */
+    type?: ModalType;
+    /**
+     * 确定按钮文案。
+     * @defaultValue "确定"
+     */
+    okText?: ReactNode;
+    /**
+     * 取消按钮文案。
+     * @defaultValue "取消"
+     */
+    cancelText?: ReactNode;
+    /**
+     * 是否显示取消按钮。
+     * @defaultValue type === "default" || type === "confirm"
+     */
+    showCancel?: boolean;
+    /**
+     * 确定操作是否正在执行；为 true 时阻止重复提交和关闭。
+     * @defaultValue false
+     */
+    confirmLoading?: boolean;
+    /** 确定按钮的 Button 属性。 */
+    okButtonProps?: ButtonProps;
+    /** 取消按钮的 Button 属性。 */
+    cancelButtonProps?: ButtonProps;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue true
+     */
+    closable?: boolean;
+    /**
+     * 点击遮罩时是否允许关闭。
+     * @defaultValue true
+     */
+    maskClosable?: boolean;
+    /**
+     * 是否允许通过 Esc 等键盘操作关闭。
+     * @defaultValue true
+     */
+    keyboard?: boolean;
+    /**
+     * 弹框是否垂直居中。
+     * @defaultValue false
+     */
+    centered?: boolean;
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 520
+     */
+    width?: number | string;
+    /** 固定弹框高度，内容区独立滚动，标题和底部保持可见。 */
+    height?: number | string;
+    /**
+     组件或浮层的堆叠层级。
+     * @defaultValue 1000
+     */
+    zIndex?: number;
+    /** 弹层挂载目标；可提供元素或返回元素的函数，默认挂载到页面容器。 */
+    getContainer?: OverlayContainer;
+    /** 确认回调，支持 Promise 与返回 false 阻止关闭 */
+    onOk?: () => ModalActionResult;
+    /** 用户取消或通过关闭入口退出时调用。 */
+    onCancel?: () => void;
+    /** 打开状态变化回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 动画完成后触发，适用于聚焦内容和释放外部挂载点。 */
+    afterOpenChange?: (open: boolean) => void;
+}
+/** ModalOpen的配置。 */
+interface ModalOpenConfig extends Omit<ModalProps, "open"> {
+}
+/** OverlayApi的操作句柄。 */
+interface OverlayApiHandle<T> {
+    /** 关闭弹层并在退出动画后释放挂载点。程序化关闭不会模拟用户取消按钮点击。 */
+    destroy: () => void;
+    /** 合并更新已打开弹层的配置，未提供的属性保留原值。 */
+    update: (next: Partial<T>) => void;
+}
+declare function openModal(config: ModalOpenConfig): OverlayApiHandle<ModalOpenConfig>;
+/** 模态框组件。 */
+declare const Modal: react.ForwardRefExoticComponent<ModalProps & react.RefAttributes<HTMLDivElement>> & {
+    /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
+    open: typeof openModal;
+    /** 显示普通信息提示。 */
+    info: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 显示成功提示。 */
+    success: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 显示警告提示。 */
+    warning: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 显示错误提示。 */
+    error: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 打开确认弹框，支持异步确认；返回 false 可阻止关闭。 */
+    confirm: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 关闭由此 API 打开的所有弹层。 */
+    destroyAll(): void;
+};
+
+/** 选择器的值类型。 */
+type SelectValue = string | number;
+/** 选择器的模式类型。 */
+type SelectMode = "single" | "multiple";
+/** 选择变更后的值：单选为字符串、数字或 null，多选为值数组。 */
+type SelectChangeValue = SelectValue | SelectValue[] | null;
+/** 选择器的候选项定义。 */
+type SelectOption = {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
+    label: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
+    value: SelectValue;
+    /** 是否禁用交互。 */
+    disabled?: boolean;
+    /** 弹框模式中的分组标题。 */
+    group?: string;
+};
+/** 选择器的属性配置。 */
+interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "defaultValue" | "onChange" | "value"> {
+    /** 下拉选项 */
+    options: readonly SelectOption[];
+    /**
+     * 单选或多选模式
+     * @defaultValue "single"
+     */
+    mode?: SelectMode;
+    /** 显式指定下拉或弹框。未设置时根据 options 总数判断：超过 modalThreshold 使用弹框。显式配置优先于阈值；弹框点击确定才提交。 */
+    popupMode?: "dropdown" | "modal";
+    /**
+     * 未指定 popupMode 时，选项总数超过此值自动使用弹框，等于阈值时仍使用下拉。
+     * @defaultValue 15
+     */
+    modalThreshold?: number;
+    /** 弹框标题、布局及顶部/底部扩展内容。 */
+    modalConfig?: {
+        /** 弹框标题，未设置时使用 Select 的 placeholder。 */
+        title?: ReactNode;
+        /** 弹框宽度，默认 900px。 */
+        width?: number | string;
+        /** 每行选项列数，默认 3 列。 */
+        columns?: number;
+        /** 列表最大可视高度，默认 360px。 */
+        maxHeight?: number;
+        /** 标题下方的独立首行扩展内容，位于选项范围和搜索框上方。 */
+        headerExtra?: ReactNode;
+        /** 顶部扩展控件的业务数据，由业务方更新此属性；框架不会自动绑定 headerExtra 内的控件。确认时将当前对象的浅拷贝作为 onConfirm 第三个参数传出，未配置时为 {}。 */
+        extraValues?: Record<string, unknown>;
+        /** 点击确定时传出选中值、对应选项及扩展数据浅拷贝；单选无值为 null，多选为数组。异步完成后才提交 onChange 并关闭；返回 false 或抛出异常保留草稿和弹框，不触发 onChange。取消不调用。 */
+        onConfirm?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null, extraValues: Record<string, unknown>) => ModalActionResult;
+        /** 底部左侧扩展内容，例如维护按钮。 */
+        footerExtra?: ReactNode;
+    };
+    /** 当前值（受控） */
+    value?: SelectChangeValue;
+    /** 初始选中值 */
+    defaultValue?: SelectChangeValue;
+    /** 确认选择或清空时调用。单选返回单值及对应选项，清空返回 null；多选返回值数组及选项数组。弹框中的草稿变化不会直接触发。 */
+    onChange?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null) => void;
+    /**
+     * 未选择时的提示
+     * @defaultValue "请选择"
+     */
+    placeholder?: ReactNode;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
+    placeholderMode?: InputPlaceholderMode;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
+    size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
+    status?: ControlStatus;
+    /**
+     * 是否允许清空当前选择；单选弹框中同时允许再次点击已选项取消选择。显式设为 false 可禁用。
+     * @defaultValue true
+     */
+    allowClear?: boolean;
+    /**
+     * 显示加载状态并禁用展开
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     是否显示搜索输入框。
+     * @defaultValue false
+     */
+    showSearch?: boolean;
+    /** 在选项名称下方显示对应的 value。 */
+    showValue?: boolean;
+    /** 允许将搜索框内容作为自定义选项提交。 */
+    allowInput?: boolean;
+    /** 手动输入内容的最大长度 */
+    inputMaxLength?: number;
+    /**
+     * 搜索框的占位提示文字。
+     * @defaultValue "搜索选项"
+     */
+    searchPlaceholder?: string;
+    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
+    onSearch?: (query: string) => void;
+    /**
+     * 自定义搜索匹配函数，返回 true 时保留该选项。
+     * @defaultValue defaultFilterOption
+     */
+    filterOption?: (query: string, option: SelectOption) => boolean;
+    /**
+     * 多选时显示全选、反选；下拉操作栏固定在列表底部
+     * @defaultValue true
+     */
+    showSelectAll?: boolean;
+    /** 是否显示下拉面板底部的条数统计与操作行；默认单选隐藏、多选显示，不影响弹框模式。 */
+    showActions?: boolean;
+    /** 最多显示的标签数；空间不足时会继续折叠，并为 +N 预留宽度。 */
+    maxTagCount?: number;
+    /**
+     * 长列表启用窗口化渲染
+     * @defaultValue true
+     */
+    virtual?: boolean;
+    /**
+     * 启用虚拟滚动的选项数量
+     * @defaultValue 100
+     */
+    virtualThreshold?: number;
+    /**
+     * 选项列表的最大可视高度，单位为像素。
+     * @defaultValue 256
+     */
+    listHeight?: number;
+    /**
+     * 单个选项的高度，虚拟列表据此计算可见区域。
+     * @defaultValue showValue ? 54 : 34
+     */
+    optionHeight?: number;
+    /**
+     * 没有匹配选项时的提示内容。
+     * @defaultValue "暂无数据"
+     */
+    notFoundContent?: ReactNode;
+}
+/** 选择器组件。 */
+declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { type ButtonProps as B, type ModalOpenConfig as M, type OverlayContainer as O, type SelectOption as S, type OverlayApiHandle as a, type SelectChangeValue as b, type SelectProps as c, type ModalActionResult as d, type ButtonSize as e, Button as f, type ButtonVariant as g, Modal as h, type ModalProps as i, type ModalType as j, Select as k, type SelectMode as l, type SelectValue as m };

package/dist/Select-W_xpkpOW.d.cts

@@ -0,0 +1,307 @@
+import * as react from 'react';
+import { ButtonHTMLAttributes, ReactNode, HTMLAttributes } from 'react';
+import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.cjs';
+
+/** 按钮视觉样式，可选择主按钮、默认按钮、文本按钮或链接等形式。 */
+type ButtonVariant = "primary" | "default" | "dashed" | "filled" | "text" | "link";
+/** 按钮尺寸等级。 */
+type ButtonSize = ControlSize;
+/** 按钮的属性配置。 */
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     组件的视觉样式。
+     * @defaultValue "default"
+     */
+    variant?: ButtonVariant;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
+    size?: ButtonSize;
+    /**
+     * 显示加载状态并禁止重复点击
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 宽度撑满父容器
+     * @defaultValue false
+     */
+    block?: boolean;
+    /**
+     * 危险操作样式
+     * @defaultValue false
+     */
+    danger?: boolean;
+    /** 按钮图标 */
+    icon?: ReactNode;
+    /**
+     * 图标位置
+     * @defaultValue "start"
+     */
+    iconPosition?: "start" | "end";
+}
+/** 按钮组件。 */
+declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
+
+/** 弹层挂载节点或返回挂载节点的函数。 */
+type OverlayContainer = HTMLElement | (() => HTMLElement);
+
+/** 模态框的类型标识。 */
+type ModalType = "default" | "info" | "success" | "warning" | "error" | "confirm";
+/** 确认操作的返回值；false 阻止关闭，Promise 可用于等待异步操作。 */
+type ModalActionResult = void | boolean | Promise<void | boolean>;
+/** 模态框的属性配置。 */
+interface ModalProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onSubmit"> {
+    /** 是否显示对话框 */
+    open: boolean;
+    /** 标题 */
+    title?: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
+    children?: ReactNode;
+    /** 自定义底部操作区，传 null 隐藏 */
+    footer?: ReactNode | null;
+    /** 默认底部操作区左侧的扩展内容。 */
+    footerExtra?: ReactNode;
+    /**
+     * 类型标识，用于选择对应的表现形式。
+     * @defaultValue "default"
+     */
+    type?: ModalType;
+    /**
+     * 确定按钮文案。
+     * @defaultValue "确定"
+     */
+    okText?: ReactNode;
+    /**
+     * 取消按钮文案。
+     * @defaultValue "取消"
+     */
+    cancelText?: ReactNode;
+    /**
+     * 是否显示取消按钮。
+     * @defaultValue type === "default" || type === "confirm"
+     */
+    showCancel?: boolean;
+    /**
+     * 确定操作是否正在执行；为 true 时阻止重复提交和关闭。
+     * @defaultValue false
+     */
+    confirmLoading?: boolean;
+    /** 确定按钮的 Button 属性。 */
+    okButtonProps?: ButtonProps;
+    /** 取消按钮的 Button 属性。 */
+    cancelButtonProps?: ButtonProps;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue true
+     */
+    closable?: boolean;
+    /**
+     * 点击遮罩时是否允许关闭。
+     * @defaultValue true
+     */
+    maskClosable?: boolean;
+    /**
+     * 是否允许通过 Esc 等键盘操作关闭。
+     * @defaultValue true
+     */
+    keyboard?: boolean;
+    /**
+     * 弹框是否垂直居中。
+     * @defaultValue false
+     */
+    centered?: boolean;
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 520
+     */
+    width?: number | string;
+    /** 固定弹框高度，内容区独立滚动，标题和底部保持可见。 */
+    height?: number | string;
+    /**
+     组件或浮层的堆叠层级。
+     * @defaultValue 1000
+     */
+    zIndex?: number;
+    /** 弹层挂载目标；可提供元素或返回元素的函数，默认挂载到页面容器。 */
+    getContainer?: OverlayContainer;
+    /** 确认回调，支持 Promise 与返回 false 阻止关闭 */
+    onOk?: () => ModalActionResult;
+    /** 用户取消或通过关闭入口退出时调用。 */
+    onCancel?: () => void;
+    /** 打开状态变化回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 动画完成后触发，适用于聚焦内容和释放外部挂载点。 */
+    afterOpenChange?: (open: boolean) => void;
+}
+/** ModalOpen的配置。 */
+interface ModalOpenConfig extends Omit<ModalProps, "open"> {
+}
+/** OverlayApi的操作句柄。 */
+interface OverlayApiHandle<T> {
+    /** 关闭弹层并在退出动画后释放挂载点。程序化关闭不会模拟用户取消按钮点击。 */
+    destroy: () => void;
+    /** 合并更新已打开弹层的配置，未提供的属性保留原值。 */
+    update: (next: Partial<T>) => void;
+}
+declare function openModal(config: ModalOpenConfig): OverlayApiHandle<ModalOpenConfig>;
+/** 模态框组件。 */
+declare const Modal: react.ForwardRefExoticComponent<ModalProps & react.RefAttributes<HTMLDivElement>> & {
+    /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
+    open: typeof openModal;
+    /** 显示普通信息提示。 */
+    info: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 显示成功提示。 */
+    success: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 显示警告提示。 */
+    warning: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 显示错误提示。 */
+    error: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 打开确认弹框，支持异步确认；返回 false 可阻止关闭。 */
+    confirm: (config: ModalOpenConfig) => OverlayApiHandle<ModalOpenConfig>;
+    /** 关闭由此 API 打开的所有弹层。 */
+    destroyAll(): void;
+};
+
+/** 选择器的值类型。 */
+type SelectValue = string | number;
+/** 选择器的模式类型。 */
+type SelectMode = "single" | "multiple";
+/** 选择变更后的值：单选为字符串、数字或 null，多选为值数组。 */
+type SelectChangeValue = SelectValue | SelectValue[] | null;
+/** 选择器的候选项定义。 */
+type SelectOption = {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
+    label: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
+    value: SelectValue;
+    /** 是否禁用交互。 */
+    disabled?: boolean;
+    /** 弹框模式中的分组标题。 */
+    group?: string;
+};
+/** 选择器的属性配置。 */
+interface SelectProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "defaultValue" | "onChange" | "value"> {
+    /** 下拉选项 */
+    options: readonly SelectOption[];
+    /**
+     * 单选或多选模式
+     * @defaultValue "single"
+     */
+    mode?: SelectMode;
+    /** 显式指定下拉或弹框。未设置时根据 options 总数判断：超过 modalThreshold 使用弹框。显式配置优先于阈值；弹框点击确定才提交。 */
+    popupMode?: "dropdown" | "modal";
+    /**
+     * 未指定 popupMode 时，选项总数超过此值自动使用弹框，等于阈值时仍使用下拉。
+     * @defaultValue 15
+     */
+    modalThreshold?: number;
+    /** 弹框标题、布局及顶部/底部扩展内容。 */
+    modalConfig?: {
+        /** 弹框标题，未设置时使用 Select 的 placeholder。 */
+        title?: ReactNode;
+        /** 弹框宽度，默认 900px。 */
+        width?: number | string;
+        /** 每行选项列数，默认 3 列。 */
+        columns?: number;
+        /** 列表最大可视高度，默认 360px。 */
+        maxHeight?: number;
+        /** 标题下方的独立首行扩展内容，位于选项范围和搜索框上方。 */
+        headerExtra?: ReactNode;
+        /** 顶部扩展控件的业务数据，由业务方更新此属性；框架不会自动绑定 headerExtra 内的控件。确认时将当前对象的浅拷贝作为 onConfirm 第三个参数传出，未配置时为 {}。 */
+        extraValues?: Record<string, unknown>;
+        /** 点击确定时传出选中值、对应选项及扩展数据浅拷贝；单选无值为 null，多选为数组。异步完成后才提交 onChange 并关闭；返回 false 或抛出异常保留草稿和弹框，不触发 onChange。取消不调用。 */
+        onConfirm?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null, extraValues: Record<string, unknown>) => ModalActionResult;
+        /** 底部左侧扩展内容，例如维护按钮。 */
+        footerExtra?: ReactNode;
+    };
+    /** 当前值（受控） */
+    value?: SelectChangeValue;
+    /** 初始选中值 */
+    defaultValue?: SelectChangeValue;
+    /** 确认选择或清空时调用。单选返回单值及对应选项，清空返回 null；多选返回值数组及选项数组。弹框中的草稿变化不会直接触发。 */
+    onChange?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null) => void;
+    /**
+     * 未选择时的提示
+     * @defaultValue "请选择"
+     */
+    placeholder?: ReactNode;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
+    placeholderMode?: InputPlaceholderMode;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
+    size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
+    status?: ControlStatus;
+    /**
+     * 是否允许清空当前选择；单选弹框中同时允许再次点击已选项取消选择。显式设为 false 可禁用。
+     * @defaultValue true
+     */
+    allowClear?: boolean;
+    /**
+     * 显示加载状态并禁用展开
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     是否显示搜索输入框。
+     * @defaultValue false
+     */
+    showSearch?: boolean;
+    /** 在选项名称下方显示对应的 value。 */
+    showValue?: boolean;
+    /** 允许将搜索框内容作为自定义选项提交。 */
+    allowInput?: boolean;
+    /** 手动输入内容的最大长度 */
+    inputMaxLength?: number;
+    /**
+     * 搜索框的占位提示文字。
+     * @defaultValue "搜索选项"
+     */
+    searchPlaceholder?: string;
+    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
+    onSearch?: (query: string) => void;
+    /**
+     * 自定义搜索匹配函数，返回 true 时保留该选项。
+     * @defaultValue defaultFilterOption
+     */
+    filterOption?: (query: string, option: SelectOption) => boolean;
+    /**
+     * 多选时显示全选、反选；下拉操作栏固定在列表底部
+     * @defaultValue true
+     */
+    showSelectAll?: boolean;
+    /** 是否显示下拉面板底部的条数统计与操作行；默认单选隐藏、多选显示，不影响弹框模式。 */
+    showActions?: boolean;
+    /** 最多显示的标签数；空间不足时会继续折叠，并为 +N 预留宽度。 */
+    maxTagCount?: number;
+    /**
+     * 长列表启用窗口化渲染
+     * @defaultValue true
+     */
+    virtual?: boolean;
+    /**
+     * 启用虚拟滚动的选项数量
+     * @defaultValue 100
+     */
+    virtualThreshold?: number;
+    /**
+     * 选项列表的最大可视高度，单位为像素。
+     * @defaultValue 256
+     */
+    listHeight?: number;
+    /**
+     * 单个选项的高度，虚拟列表据此计算可见区域。
+     * @defaultValue showValue ? 54 : 34
+     */
+    optionHeight?: number;
+    /**
+     * 没有匹配选项时的提示内容。
+     * @defaultValue "暂无数据"
+     */
+    notFoundContent?: ReactNode;
+}
+/** 选择器组件。 */
+declare const Select: react.ForwardRefExoticComponent<SelectProps & react.RefAttributes<HTMLButtonElement>>;
+
+export { type ButtonProps as B, type ModalOpenConfig as M, type OverlayContainer as O, type SelectOption as S, type OverlayApiHandle as a, type SelectChangeValue as b, type SelectProps as c, type ModalActionResult as d, type ButtonSize as e, Button as f, type ButtonVariant as g, Modal as h, type ModalProps as i, type ModalType as j, Select as k, type SelectMode as l, type SelectValue as m };