lingee-ui 0.0.2 → 0.0.4

package/dist/index.d.ts

@@ -1,12 +1,20 @@
-export { Button, ButtonProps, ButtonVariant } from './button/index.js';
+import { ButtonProps } from './button/index.js';
+export { Button, ButtonShape, ButtonVariant } from './button/index.js';
 export { TabItem, Tabs, TabsProps, TabsSize, TabsVariant } from './tabs/index.js';
 export { Tooltip, TooltipPlacement, TooltipProps } from './tooltip/index.js';
+import { PopoverContentProps } from './popover/index.js';
+export { Popover, PopoverAnchor, PopoverAnchorProps, PopoverArrow, PopoverArrowProps, PopoverClose, PopoverCloseProps, PopoverContent, PopoverPlacement, PopoverProps, PopoverTrigger, PopoverTriggerProps } from './popover/index.js';
 export { Switch, SwitchProps, SwitchSize } from './switch/index.js';
 export { Input, InputProps, InputShape, InputSize } from './input/index.js';
 export { Textarea, TextareaProps } from './textarea/index.js';
 export { ToastConfig, ToastGlobalConfig, ToastType, toast } from './toast/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { ReactNode } from 'react';
+import React$1, { ReactNode, HTMLAttributes, MouseEvent, CSSProperties, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
+import { L as LgSize } from './index-B5SLxsZP.js';
+export { a as LgShape, b as LgVariant } from './index-B5SLxsZP.js';
+import { SvgIconProps } from 'lingee-icon';
+import { FormInstance as FormInstance$1, Rule } from 'rc-field-form/es/interface';
+export { Rule } from 'rc-field-form/es/interface';
 import { ClassValue } from 'clsx';
 import 'class-variance-authority/types';
 
@@ -17,6 +25,81 @@ import 'class-variance-authority/types';
 declare const zhCN: {
     locale: string;
     Button: {};
+    Breadcrumb: {
+        more: string;
+        back: string;
+    };
+    Select: {
+        loading: string;
+        loadError: string;
+        notFound: string;
+        clear: string;
+    };
+    Tag: {
+        close: string;
+    };
+    Upload: {
+        retry: string;
+        remove: string;
+        removeShort: string;
+        dragText: string;
+        clickUpload: string;
+    };
+    ColorPicker: {
+        placeholder: string;
+    };
+    DatePicker: {
+        placeholder: string;
+        today: string;
+        prevYear: string;
+        nextYear: string;
+        prevMonth: string;
+        nextMonth: string;
+        prevDecade: string;
+        nextDecade: string;
+        months: string[];
+        yearFormat: string;
+        monthFormat: string;
+    };
+    RangePicker: {
+        startPlaceholder: string;
+        endPlaceholder: string;
+    };
+    TimePicker: {
+        now: string;
+        confirm: string;
+        placeholder: string;
+        placeholderFull: string;
+    };
+    Table: {
+        empty: string;
+    };
+    Pagination: {
+        total: string;
+        prevPage: string;
+        nextPage: string;
+        itemsPerPage: string;
+        jumpTo: string;
+        page: string;
+    };
+    Dialog: {
+        close: string;
+    };
+    Drawer: {
+        close: string;
+    };
+    Input: {
+        clear: string;
+    };
+    Alert: {
+        close: string;
+    };
+    Toast: {
+        close: string;
+    };
+    Spin: {
+        loading: string;
+    };
 };
 
 /** 语言包类型，由 zh-CN 推导结构 */
@@ -34,6 +117,81 @@ interface LingeeProviderProps {
 declare const enUS: {
     locale: string;
     Button: {};
+    Breadcrumb: {
+        more: string;
+        back: string;
+    };
+    Select: {
+        loading: string;
+        loadError: string;
+        notFound: string;
+        clear: string;
+    };
+    Tag: {
+        close: string;
+    };
+    Upload: {
+        retry: string;
+        remove: string;
+        removeShort: string;
+        dragText: string;
+        clickUpload: string;
+    };
+    ColorPicker: {
+        placeholder: string;
+    };
+    DatePicker: {
+        placeholder: string;
+        today: string;
+        prevYear: string;
+        nextYear: string;
+        prevMonth: string;
+        nextMonth: string;
+        prevDecade: string;
+        nextDecade: string;
+        months: string[];
+        yearFormat: string;
+        monthFormat: string;
+    };
+    RangePicker: {
+        startPlaceholder: string;
+        endPlaceholder: string;
+    };
+    TimePicker: {
+        now: string;
+        confirm: string;
+        placeholder: string;
+        placeholderFull: string;
+    };
+    Table: {
+        empty: string;
+    };
+    Pagination: {
+        total: string;
+        prevPage: string;
+        nextPage: string;
+        itemsPerPage: string;
+        jumpTo: string;
+        page: string;
+    };
+    Dialog: {
+        close: string;
+    };
+    Drawer: {
+        close: string;
+    };
+    Input: {
+        clear: string;
+    };
+    Alert: {
+        close: string;
+    };
+    Toast: {
+        close: string;
+    };
+    Spin: {
+        loading: string;
+    };
 };
 
 /**
@@ -64,6 +222,1645 @@ declare function useLocale(): Locale;
  */
 declare function useComponentLocale<K extends keyof Omit<Locale, "locale">>(componentName: K): Locale[K];
 
+/** 预设语义色 */
+type TagPresetColor = "primary" | "info" | "success" | "warning" | "danger";
+/** 标签尺寸 */
+type TagSize = LgSize;
+/** 标签圆角形状 */
+type TagShape = "pill" | "rounded";
+interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color"> {
+    /** 色彩：预设语义色 或 任意 CSS 色值字符串，默认 "info" */
+    color?: TagPresetColor | (string & {});
+    /** 尺寸，默认 "md"（sm: 20px, md: 24px, lg: 32px） */
+    size?: TagSize;
+    /** 圆角形状，默认 "pill"（pill: 999px, rounded: 8px） */
+    shape?: TagShape;
+    /** 自定义背景（覆盖默认背景，支持渐变等任意 CSS background 值） */
+    background?: string;
+    /** 是否可关闭（显示关闭按钮） */
+    closable?: boolean;
+    /** 关闭回调 */
+    onClose?: (e: MouseEvent<HTMLSpanElement>) => void;
+    /** 子内容（文字、图标自由组合） */
+    children?: ReactNode;
+}
+
+/**
+ * Tag 标签组件
+ * 支持预设语义色、自定义色值、自定义背景（渐变）、可关闭等能力
+ */
+declare const Tag: React$1.ForwardRefExoticComponent<TagProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+/** 透传给 OK/Cancel 按钮的属性子集（排除 children 和事件，由 Dialog 统一管理） */
+type DialogButtonProps = Omit<ButtonProps, "children" | "onClick" | "htmlType">;
+interface DialogProps {
+    /** 是否打开 */
+    open: boolean;
+    /** 状态变化回调（关闭时 nextOpen=false） */
+    onOpenChange: (open: boolean) => void;
+    /** 弹窗宽度，默认 460 */
+    width?: number | string;
+    /** 弹窗高度，默认自适应内容 */
+    height?: number | string;
+    /** 标题（支持 ReactNode） */
+    title?: ReactNode;
+    /** 标题栏右侧额外内容 */
+    extra?: ReactNode;
+    /** 是否显示关闭按钮，默认 true */
+    closable?: boolean;
+    /** 底部操作区，传 ReactNode 完全自定义；传 null 隐藏 */
+    footer?: ReactNode;
+    /** 确认按钮文字（传入后自动渲染 footer，与 footer 互斥） */
+    okText?: string;
+    /** 取消按钮文字 */
+    cancelText?: string;
+    /** 确认回调（支持异步，返回 Promise 时按钮显示 loading） */
+    onOk?: () => void | Promise<void>;
+    /** 取消回调 */
+    onCancel?: () => void;
+    /** 确认按钮是否为危险样式 */
+    okDanger?: boolean;
+    /** 确认按钮额外属性（disabled、loading、size 等） */
+    okProps?: DialogButtonProps;
+    /** 取消按钮额外属性 */
+    cancelProps?: DialogButtonProps;
+    /** 是否为模态（true 时点击遮罩不关闭），默认 false */
+    modal?: boolean;
+    /** 是否显示遮罩层，默认 true */
+    mask?: boolean;
+    /** 关闭后是否销毁子节点，默认 true */
+    destroyOnHidden?: boolean;
+    /** 自定义 z-index */
+    zIndex?: number;
+    /** 内容区最大高度，默认 640px */
+    maxHeight?: number | string;
+    /** 开启后 body 高度跟随内容自适应，弹窗整体高度由 maxHeight 兜底上限，默认 false */
+    autoHeight?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 弹窗内容 */
+    children?: ReactNode;
+}
+/** Dialog.confirm 命令式参数 */
+interface DialogConfirmOptions extends Omit<DialogProps, "open" | "onOpenChange" | "children"> {
+    /** 描述文案（使用默认布局时展示） */
+    description?: ReactNode;
+    /** 标题前的图标（使用默认布局时展示） */
+    icon?: ReactNode;
+    /** 自定义内容，传入后 title/description/icon 不生效 */
+    content?: ReactNode;
+}
+
+/**
+ * Dialog 对话框组件
+ * 基于 @radix-ui/react-dialog，提供焦点陷阱、Esc 关闭、aria 属性
+ */
+declare const Dialog$1: React$1.FC<DialogProps>;
+
+/**
+ * 命令式确认弹窗
+ * @returns Promise<boolean> — 确认返回 true，取消返回 false
+ */
+declare function confirm(options: DialogConfirmOptions): Promise<boolean>;
+/** 命令式关闭当前 confirm 弹窗（不 resolve，用于外部强制关闭兜底） */
+declare function closeConfirm(): void;
+
+type DialogType = typeof Dialog$1 & {
+    confirm: typeof confirm;
+    closeConfirm: typeof closeConfirm;
+};
+declare const Dialog: DialogType;
+
+type SelectSize = LgSize;
+type SelectMode = "single" | "multiple";
+/** 选项数据结构 */
+interface SelectOption<T = string> {
+    /** 选项值 */
+    value: T;
+    /** 显示文本（支持 ReactNode 用于下拉面板富渲染） */
+    label: ReactNode;
+    /** 纯文本标签（用于搜索输入框 placeholder 等场景；未提供时尝试从 label 取字符串） */
+    textLabel?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+}
+/** 分组选项 */
+interface SelectOptionGroup<T = string> {
+    /** 分组标题 */
+    label: string;
+    /** 分组下的选项 */
+    options: SelectOption<T>[];
+}
+/** 下拉面板配置 — 继承 Popover 浮层定位能力 */
+interface SelectDropdownProps extends Pick<PopoverContentProps, "side" | "align" | "sideOffset" | "alignOffset" | "className" | "collisionPadding" | "container"> {
+    /** 下拉面板宽度，默认与触发器同宽 */
+    width?: number | "auto";
+    /** 下拉面板最大高度，默认 256 */
+    maxHeight?: number;
+    /**
+     * 自定义下拉面板渲染
+     * - 参数 menu 为默认的选项列表 ReactNode
+     * - 传入时可在默认选项列表基础上包装额外内容
+     */
+    render?: (menu: ReactNode) => ReactNode;
+    /** 无匹配时展示内容 */
+    notFoundContent?: ReactNode;
+    /** 下拉面板滚动回调（用于滚动加载） */
+    onScroll?: (e: React.UIEvent<HTMLDivElement>) => void;
+}
+interface SelectProps<T = string> {
+    /** 选择模式，默认 "single" */
+    mode?: SelectMode;
+    /** 受控值：单选为 T，多选为 T[] */
+    value?: T | T[];
+    /** 非受控默认值 */
+    defaultValue?: T | T[];
+    /** 值变化回调 */
+    onChange?: (value: T | T[], option: SelectOption<T> | SelectOption<T>[]) => void;
+    /** 选项列表 */
+    options?: SelectOption<T>[];
+    /** 是否支持搜索，默认 false */
+    showSearch?: boolean;
+    /**
+     * 前端过滤函数
+     * - 默认按 label 文本做 includes 匹配
+     * - 设为 false 时关闭前端过滤（配合 onSearch 远程搜索）
+     */
+    filterOption?: false | ((inputValue: string, option: SelectOption<T>) => boolean);
+    /** 搜索关键词变化回调（用于远程搜索场景） */
+    onSearch?: (keyword: string) => void;
+    /** 加载中状态（远程搜索时展示 loading） */
+    loading?: boolean;
+    /** 加载失败状态（下拉面板展示「加载失败，请重试」缺省） */
+    loadError?: boolean;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 错误态 */
+    error?: boolean;
+    /** 尺寸，默认 "md" */
+    size?: SelectSize;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 是否显示清空按钮，默认 false */
+    allowClear?: boolean;
+    /** 自定义后缀图标（覆盖默认箭头） */
+    suffixIcon?: ReactNode;
+    /** 多选模式下最多展示的 Tag 数量，超出显示 +N */
+    maxTagCount?: number;
+    /** 下拉面板配置 */
+    dropdown?: SelectDropdownProps;
+    /** 下拉展开/收起回调 */
+    onDropdownVisibleChange?: (open: boolean) => void;
+    /**
+     * 自定义选中值在触发器中的渲染（Tag 文本 / 单选显示值）
+     * - 不传时默认渲染 option.label
+     * - 用于下拉面板展示丰富内容（如头像+名字+工号），但触发器只显示简短文本（如名字）
+     */
+    labelRender?: (value: T, option: SelectOption<T> | undefined) => ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+
+/**
+ * 支持泛型的 forwardRef
+ * 用法：<Select<string> options={...} />
+ */
+declare const Select: <T = string>(props: SelectProps<T> & {
+    ref?: React$1.Ref<HTMLDivElement>;
+}) => React$1.ReactElement | null;
+
+interface DropdownMenuItemData {
+    type?: "item";
+    /** 唯一标识 */
+    key: string;
+    /** 菜单项文字 */
+    label: ReactNode;
+    /** 前置图标 */
+    icon?: ReactNode;
+    /** 是否为危险操作 */
+    danger?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 选中回调 */
+    onSelect?: (event: Event) => void;
+}
+interface DropdownSeparatorData {
+    type: "separator";
+}
+interface DropdownLabelData {
+    type: "label";
+    label: ReactNode;
+}
+/** items 快捷模式的数据项类型 */
+type DropdownItemData = DropdownMenuItemData | DropdownSeparatorData | DropdownLabelData;
+interface DropdownProps {
+    /** 子元素（Trigger + Content），或仅 Trigger 元素（配合 items 快捷模式） */
+    children: ReactNode;
+    /** 受控开关 */
+    open?: boolean;
+    /** 非受控默认打开状态 */
+    defaultOpen?: boolean;
+    /** 开关变化回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 是否为 modal 模式（锁定背景交互），默认 true */
+    modal?: boolean;
+    /**
+     * 快捷模式：传入菜单项数组，自动渲染 DropdownContent
+     * 与 Compound Component 互斥，传 items 时 children 作为触发器
+     */
+    items?: DropdownItemData[];
+    /** items 快捷模式下面板的定位配置 */
+    contentProps?: Omit<DropdownContentProps, "children">;
+    /** 当前选中的 item key 列表，匹配的项会显示勾选图标 */
+    selectedKeys?: string[];
+    /** 加载中状态，为 true 时显示 loadingContent 或默认 loading */
+    loading?: boolean;
+    /** 自定义加载中渲染内容 */
+    loadingContent?: ReactNode;
+    /** 自定义空态渲染内容（items 为空数组且非 loading 时显示） */
+    emptyContent?: ReactNode;
+    /**
+     * 自定义面板渲染，参数 menu 为默认渲染的菜单项列表
+     * 可在 menu 前后包裹额外内容
+     */
+    dropdownRender?: (menu: ReactNode) => ReactNode;
+    /** 固定在面板顶部的内容（不随列表滚动） */
+    header?: ReactNode;
+    /** 固定在面板底部的内容（不随列表滚动） */
+    footer?: ReactNode;
+}
+interface DropdownTriggerProps {
+    /** 触发器子元素 */
+    children: ReactNode;
+    /** 合并到子元素而非额外包裹 DOM，默认 true */
+    asChild?: boolean;
+}
+interface DropdownContentProps extends Pick<PopoverContentProps, "side" | "align" | "sideOffset" | "alignOffset" | "className" | "collisionPadding" | "container" | "onEscapeKeyDown" | "onPointerDownOutside" | "onInteractOutside" | "onCloseAutoFocus"> {
+    /** 面板子内容 */
+    children: ReactNode;
+    /**
+     * 面板自定义样式
+     * - minWidth: 面板最小宽度（默认 128px）
+     * - maxHeight: 设置后菜单列表超出时内置 ScrollArea 滚动
+     * - width / maxWidth 等其它 CSS 属性均可使用
+     */
+    style?: CSSProperties;
+    /** 固定在面板顶部的内容（不随列表滚动） */
+    header?: ReactNode;
+    /** 固定在面板底部的内容（不随列表滚动） */
+    footer?: ReactNode;
+}
+interface DropdownItemProps {
+    /** 菜单项内容 */
+    children: ReactNode;
+    /** 额外类名 */
+    className?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 危险操作（红色样式） */
+    danger?: boolean;
+    /** 前置图标 */
+    icon?: ReactNode;
+    /** 是否选中（显示勾选图标） */
+    selected?: boolean;
+    /** 选中回调，调用 event.preventDefault() 可阻止面板自动关闭 */
+    onSelect?: (event: Event) => void;
+}
+interface DropdownCheckboxItemProps {
+    /** 菜单项内容 */
+    children: ReactNode;
+    /** 额外类名 */
+    className?: string;
+    /** 是否选中 */
+    checked?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 前置图标 */
+    icon?: ReactNode;
+    /** 选中状态变化回调 */
+    onCheckedChange?: (checked: boolean) => void;
+}
+interface DropdownRadioGroupProps {
+    /** 子元素（DropdownRadioItem） */
+    children: ReactNode;
+    /** 当前选中值 */
+    value?: string;
+    /** 值变化回调 */
+    onValueChange?: (value: string) => void;
+}
+interface DropdownRadioItemProps {
+    /** 菜单项内容 */
+    children: ReactNode;
+    /** 额外类名 */
+    className?: string;
+    /** 选项值 */
+    value: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 前置图标 */
+    icon?: ReactNode;
+}
+interface DropdownLabelProps {
+    /** 标题内容 */
+    children: ReactNode;
+    /** 额外类名 */
+    className?: string;
+}
+interface DropdownSeparatorProps {
+    /** 额外类名 */
+    className?: string;
+}
+interface DropdownGroupProps {
+    /** 分组内容 */
+    children: ReactNode;
+}
+interface DropdownSubProps {
+    /** 子元素（SubTrigger + SubContent） */
+    children: ReactNode;
+    /** 受控开关 */
+    open?: boolean;
+    /** 非受控默认打开状态 */
+    defaultOpen?: boolean;
+    /** 开关变化回调 */
+    onOpenChange?: (open: boolean) => void;
+}
+interface DropdownSubTriggerProps {
+    /** 子菜单触发项内容 */
+    children: ReactNode;
+    /** 额外类名 */
+    className?: string;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 前置图标 */
+    icon?: ReactNode;
+}
+interface DropdownSubContentProps extends Pick<PopoverContentProps, "side" | "align" | "sideOffset" | "alignOffset" | "className" | "collisionPadding" | "container"> {
+    /** 子菜单面板内容 */
+    children: ReactNode;
+}
+
+declare function Dropdown({ children, open, defaultOpen, onOpenChange, modal, items, contentProps, selectedKeys, loading, loadingContent, emptyContent, dropdownRender, header, footer, }: DropdownProps): react_jsx_runtime.JSX.Element;
+declare namespace Dropdown {
+    var displayName: string;
+}
+declare const DropdownTrigger: React$1.ForwardRefExoticComponent<DropdownTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const DropdownContent: React$1.ForwardRefExoticComponent<DropdownContentProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DropdownItem: React$1.ForwardRefExoticComponent<DropdownItemProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DropdownCheckboxItem: React$1.ForwardRefExoticComponent<DropdownCheckboxItemProps & React$1.RefAttributes<HTMLDivElement>>;
+declare function DropdownRadioGroup({ children, value, onValueChange }: DropdownRadioGroupProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownRadioGroup {
+    var displayName: string;
+}
+declare const DropdownRadioItem: React$1.ForwardRefExoticComponent<DropdownRadioItemProps & React$1.RefAttributes<HTMLDivElement>>;
+declare function DropdownLabel({ children, className }: DropdownLabelProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownLabel {
+    var displayName: string;
+}
+declare function DropdownSeparator({ className }: DropdownSeparatorProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownSeparator {
+    var displayName: string;
+}
+declare function DropdownGroup({ children }: DropdownGroupProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownGroup {
+    var displayName: string;
+}
+declare function DropdownSub({ children, open, defaultOpen, onOpenChange }: DropdownSubProps): react_jsx_runtime.JSX.Element;
+declare namespace DropdownSub {
+    var displayName: string;
+}
+declare const DropdownSubTrigger: React$1.ForwardRefExoticComponent<DropdownSubTriggerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DropdownSubContent: React$1.ForwardRefExoticComponent<DropdownSubContentProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type DatePickerSize = LgSize;
+interface DatePickerProps {
+    /** 受控值 */
+    value?: Date | null;
+    /** 非受控默认值 */
+    defaultValue?: Date | null;
+    /** 值变化回调 */
+    onChange?: (value: Date | null) => void;
+    /** 禁用日期判断函数 */
+    disabledDate?: (date: Date) => boolean;
+    /** 可选范围最小日期 */
+    minDate?: Date;
+    /** 可选范围最大日期 */
+    maxDate?: Date;
+    /** 日期格式化，默认 "yyyy/MM/dd" */
+    format?: string;
+    /** 一周起始日，默认 1（周一） */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** 是否显示今天按钮，默认 true */
+    showToday?: boolean;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 错误态 */
+    error?: boolean;
+    /** 错误提示文案 */
+    errorMessage?: string;
+    /** 尺寸，默认 "md" */
+    size?: DatePickerSize;
+    /** 占位文本，默认 "年/月/日" */
+    placeholder?: string;
+    /** 是否显示清空按钮，默认 true */
+    allowClear?: boolean;
+    /** 浮层挂载容器 */
+    getPopupContainer?: () => HTMLElement;
+    /** 面板展开/收起回调 */
+    onOpenChange?: (open: boolean) => void;
+    className?: string;
+    style?: CSSProperties;
+}
+
+/**
+ * DatePicker 日期选择器
+ *
+ * 单选日期，基于 Popover 弹层 + react-day-picker 日历面板实现。
+ * 支持年/月快速切换面板、今天按钮、日期禁用。
+ */
+declare const DatePicker: React$1.ForwardRefExoticComponent<DatePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type RangePickerSize = LgSize;
+type DateRange = {
+    from: Date | null;
+    to: Date | null;
+};
+interface RangePickerProps {
+    /** 受控值 */
+    value?: DateRange | null;
+    /** 非受控默认值 */
+    defaultValue?: DateRange | null;
+    /** 值变化回调 */
+    onChange?: (value: DateRange | null) => void;
+    /** 禁用日期判断函数 */
+    disabledDate?: (date: Date) => boolean;
+    /** 可选范围最小日期 */
+    minDate?: Date;
+    /** 可选范围最大日期 */
+    maxDate?: Date;
+    /** 日期格式化，默认 "yyyy/MM/dd" */
+    format?: string;
+    /** 一周起始日，默认 1（周一） */
+    weekStartsOn?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+    /** 分隔符，默认 "～" */
+    separator?: string;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 错误态 */
+    error?: boolean;
+    /** 错误提示文案 */
+    errorMessage?: string;
+    /** 尺寸，默认 "md" */
+    size?: RangePickerSize;
+    /** 起始占位文本，默认 "年/月/日" */
+    placeholder?: [string, string];
+    /** 是否显示清空按钮，默认 true */
+    allowClear?: boolean;
+    /** 浮层挂载容器 */
+    getPopupContainer?: () => HTMLElement;
+    /** 面板展开/收起回调 */
+    onOpenChange?: (open: boolean) => void;
+    className?: string;
+    style?: CSSProperties;
+}
+
+/**
+ * RangePicker 日期范围选择器
+ *
+ * 双面板并排，选择起止日期。
+ */
+declare const RangePicker: React$1.ForwardRefExoticComponent<RangePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type TimePickerSize = LgSize;
+interface TimeValue {
+    hour: number;
+    minute: number;
+    second?: number;
+}
+interface TimePickerProps {
+    /** 受控值 */
+    value?: TimeValue | null;
+    /** 非受控默认值 */
+    defaultValue?: TimeValue | null;
+    /** 值变化回调 */
+    onChange?: (value: TimeValue | null) => void;
+    /** 是否显示秒列，默认 false（HH:mm 模式） */
+    showSeconds?: boolean;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 错误态 */
+    error?: boolean;
+    /** 错误提示文案 */
+    errorMessage?: string;
+    /** 尺寸，默认 "md" */
+    size?: TimePickerSize;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 是否显示清空按钮，默认 true */
+    allowClear?: boolean;
+    /** 浮层挂载容器 */
+    getPopupContainer?: () => HTMLElement;
+    /** 面板展开/收起回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 样式类名 */
+    className?: string;
+    /** 行内样式 */
+    style?: CSSProperties;
+}
+
+/**
+ * TimePicker 时间选择器
+ *
+ * 滚动列选择时间，支持 HH:mm 和 HH:mm:ss 两种模式。
+ * 触发器复用 DatePicker 样式，面板通过 Popover 弹出。
+ */
+declare const TimePicker: React$1.ForwardRefExoticComponent<TimePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type RadioSize = LgSize;
+interface RadioGroupProps {
+    /** 当前选中值（受控） */
+    value?: string;
+    /** 默认选中值（非受控） */
+    defaultValue?: string;
+    /** 选中值变更回调 */
+    onChange?: (value: string) => void;
+    /** 尺寸，默认 "md" */
+    size?: RadioSize;
+    /** 禁用整组 */
+    disabled?: boolean;
+    /** Radio 排列方向，默认 "vertical" */
+    orientation?: "horizontal" | "vertical";
+    /** 额外 className */
+    className?: string;
+    /** 组名（用于原生 form） */
+    name?: string;
+    /** 子元素 */
+    children?: React.ReactNode;
+    /** style */
+    style?: React.CSSProperties;
+}
+interface RadioItemProps {
+    /** 选项值 */
+    value: string;
+    /** 禁用当前项 */
+    disabled?: boolean;
+    /** 额外 className */
+    className?: string;
+    /** 子元素（label 内容） */
+    children?: React.ReactNode;
+}
+
+/**
+ * RadioGroup 单选组
+ * 基于 radix-ui/react-radio-group，支持受控/非受控、禁用、尺寸变体
+ */
+declare const RadioGroup: React$1.ForwardRefExoticComponent<RadioGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * RadioItem 单选项
+ * 必须作为 RadioGroup 的子组件使用
+ */
+declare const RadioItem: React$1.ForwardRefExoticComponent<RadioItemProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+type DividerVariant = "default" | "muted" | "emphasis";
+type DividerOrientation = "horizontal" | "vertical";
+interface DividerProps extends HTMLAttributes<HTMLDivElement> {
+    /** 分割线颜色变体，默认 "default" */
+    variant?: DividerVariant;
+    /** 分割线方向，默认 "horizontal" */
+    orientation?: DividerOrientation;
+    /** 外间距（上下或左右），单位 px */
+    spacing?: number;
+}
+
+/**
+ * Divider 分割线组件
+ * 用于分隔内容区块，支持水平/垂直方向和多种颜色变体
+ */
+declare const Divider: React$1.ForwardRefExoticComponent<DividerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type CheckboxSize = LgSize;
+interface CheckboxProps {
+    /** 选中状态（受控） */
+    checked?: boolean;
+    /** 默认选中状态（非受控） */
+    defaultChecked?: boolean;
+    /** 半选（不确定）状态 */
+    indeterminate?: boolean;
+    /** 选中变更回调 */
+    onChange?: (checked: boolean) => void;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 尺寸，默认 "md" */
+    size?: CheckboxSize;
+    /** 额外 className */
+    className?: string;
+    /** 自定义行内样式 */
+    style?: CSSProperties;
+    /** 子元素（label 内容） */
+    children?: React.ReactNode;
+    /** 原生 name 属性 */
+    name?: string;
+    /** 原生 value 属性 */
+    value?: string;
+}
+interface CheckboxGroupProps {
+    /** 当前选中值数组（受控） */
+    value?: string[];
+    /** 默认选中值数组（非受控） */
+    defaultValue?: string[];
+    /** 选中值变更回调 */
+    onChange?: (value: string[]) => void;
+    /** 禁用整组 */
+    disabled?: boolean;
+    /** 尺寸，默认 "md" */
+    size?: CheckboxSize;
+    /** 排列方向，默认 "vertical" */
+    orientation?: "horizontal" | "vertical";
+    /** 额外 className */
+    className?: string;
+    /** 自定义行内样式 */
+    style?: CSSProperties;
+    /** 子元素 */
+    children?: React.ReactNode;
+}
+
+/**
+ * Checkbox 复选框组件
+ * 支持受控/非受控、半选态、禁用、尺寸变体，可独立使用或配合 CheckboxGroup
+ */
+declare const Checkbox: React$1.ForwardRefExoticComponent<CheckboxProps & React$1.RefAttributes<HTMLInputElement>>;
+/**
+ * CheckboxGroup 复选框组
+ * 管理多个 Checkbox 的选中状态
+ */
+declare const CheckboxGroup: React$1.ForwardRefExoticComponent<CheckboxGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/**
+ * 分页视觉变体
+ * - simple: 简单模式，仅「上一页 当前页/总页数 下一页」
+ * - bordered: 有框（默认），选中页码带边框 + 阴影
+ * - borderless: 无框，选中页码用品牌色文字
+ */
+type PaginationVariant = "simple" | "bordered" | "borderless";
+interface PaginationProps {
+    /** 对齐方式，默认 "end" */
+    align?: "start" | "center" | "end";
+    /** 当前页（受控） */
+    current?: number;
+    /** 默认当前页（非受控），默认 1 */
+    defaultCurrent?: number;
+    /** 每页条数（受控） */
+    pageSize?: number;
+    /** 默认每页条数（非受控），默认 20 */
+    defaultPageSize?: number;
+    /** 数据总数 */
+    total: number;
+    /** 禁用 */
+    disabled?: boolean;
+    /** 只有一页时隐藏，默认 false */
+    hideOnSinglePage?: boolean;
+    /** 每页条数选项，默认 [10, 20, 50, 100] */
+    pageSizeOptions?: number[];
+    /** 是否显示快速跳转，默认 false */
+    showQuickJumper?: boolean;
+    /** 是否显示 pageSize 切换器，默认 false */
+    showSizeChanger?: boolean;
+    /** 是否显示总数，或自定义渲染 */
+    showTotal?: boolean | ((total: number, range: [number, number]) => ReactNode);
+    /** 视觉变体，默认 "bordered" */
+    variant?: PaginationVariant;
+    /** 页码或 pageSize 变化回调 */
+    onChange?: (page: number, pageSize: number) => void;
+    /** pageSize 变化回调 */
+    onPageSizeChange?: (current: number, size: number) => void;
+    /** 额外 className */
+    className?: string;
+    /** 自定义行内样式 */
+    style?: CSSProperties;
+}
+
+/**
+ * Pagination 分页组件
+ * 参考 antd API 设计，通过 variant 区分三种视觉：simple（简单）、bordered（有框）、borderless（无框）
+ */
+declare const Pagination: React$1.ForwardRefExoticComponent<PaginationProps & React$1.RefAttributes<HTMLElement>>;
+
+type SpinSize = LgSize;
+interface SpinProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 加载指示器尺寸 */
+    size?: SpinSize;
+    /** 是否旋转中，为 false 时暂停动画 */
+    spinning?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义行内样式 */
+    style?: CSSProperties;
+    /** 包裹内容，存在时作为容器模式使用 */
+    children?: ReactNode;
+    /** 容器模式下的加载提示文本 */
+    tip?: string;
+}
+
+/**
+ * Spin 加载指示器组件
+ * 支持独立使用或作为容器包裹内容，加载时显示遮罩与旋转指示器
+ */
+declare const Spin: React$1.ForwardRefExoticComponent<SpinProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/** 空状态尺寸（复用组件库统一尺寸 LgSize） */
+type EmptySize = LgSize;
+/** lingee-icon 组件类型 */
+type EmptyIconComponent = ComponentType<SvgIconProps>;
+interface EmptyProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /**
+     * 尺寸，默认 "md"
+     * - lg: 页面级缺省，图标 56px + 文字 16px，垂直居中
+     * - md: 局部缺省，图标 24px + 文字 14px，垂直居中
+     * - sm: mini 缺省，图标 16px + 文字 12px，水平结构，无 padding
+     */
+    size?: EmptySize;
+    /**
+     * 图标：
+     * - 传 lingee-icon 组件（如 Search）→ 自动注入 size
+     * - 传 ReactNode → 完全自定义（加载中旋转等行为随图标一起传入自行处理）
+     * - 不传 → 使用默认图标
+     */
+    icon?: EmptyIconComponent | ReactNode;
+    /** 描述文字 */
+    description: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义内联样式 */
+    style?: CSSProperties;
+}
+
+/**
+ * Empty 空状态组件
+ * 支持 lg / md / sm 三种尺寸，覆盖搜索无结果、加载中、加载失败等场景
+ *
+ * icon 支持三种传法：
+ * 1. 传 lingee-icon 组件（如 Search）→ 自动注入 size + fill 渐变
+ * 2. 传 ReactNode → 完全自定义渲染（加载中旋转等行为随图标一起传入自行处理）
+ * 3. 不传 → 使用默认图标（带渐变）
+ */
+declare const Empty: React$1.ForwardRefExoticComponent<EmptyProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/** 主轴方向类型 */
+type FlexOrientation = "horizontal" | "vertical";
+/** gap 预设尺寸 */
+type FlexGapSize = "small" | "medium" | "large";
+interface FlexProps extends HTMLAttributes<HTMLElement> {
+    /** flex 主轴的方向是否垂直（等价 flex-direction: column），默认 false */
+    vertical?: boolean;
+    /** 主轴方向类型，默认 "horizontal"；与 vertical 同时存在时以 vertical 优先 */
+    orientation?: FlexOrientation;
+    /** 设置元素单行显示还是多行显示，默认 nowrap */
+    wrap?: CSSProperties["flexWrap"] | boolean;
+    /** 设置元素在主轴方向上的对齐方式 */
+    justify?: CSSProperties["justifyContent"];
+    /** 设置元素在交叉轴方向上的对齐方式 */
+    align?: CSSProperties["alignItems"];
+    /** flex CSS 简写属性 */
+    flex?: CSSProperties["flex"];
+    /** 设置网格之间的间隙，支持预设尺寸或自定义数值/字符串 */
+    gap?: FlexGapSize | string | number;
+    /** 自定义元素类型，默认 "div" */
+    component?: React.ElementType;
+}
+
+/**
+ * Flex 弹性布局组件
+ * 默认水平方向、主轴起点对齐；可通过属性调整方向、对齐、换行与间隙
+ */
+declare const Flex: React$1.ForwardRefExoticComponent<FlexProps & React$1.RefAttributes<HTMLElement>>;
+
+/** Alert 类型 */
+type AlertType = "info" | "success" | "warning" | "error" | "default";
+interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** 提示类型，默认 "info" */
+    type?: AlertType;
+    /** 标题内容 */
+    title?: ReactNode;
+    /** 描述/正文内容（与 children 互斥，优先使用 children） */
+    description?: ReactNode;
+    /** 多行列表描述（传入数组时渲染带圆点的列表） */
+    items?: ReactNode[];
+    /** 是否显示关闭按钮，默认 true */
+    closable?: boolean;
+    /** 关闭回调 */
+    onClose?: (e: MouseEvent<HTMLButtonElement>) => void;
+    /** 前缀图标，false 隐藏图标；传入 ReactNode 自定义图标 */
+    icon?: ReactNode | false;
+    /** 操作区（右侧按钮/链接） */
+    action?: ReactNode;
+    /** 子内容（替代 description 使用） */
+    children?: ReactNode;
+}
+
+/**
+ * Alert 消息提示组件
+ * 用于页面中展示重要的提示信息，支持多种类型和布局变体
+ */
+declare const Alert: React$1.ForwardRefExoticComponent<AlertProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/** 骨架屏形状预设 */
+type SkeletonVariant = "text" | "circle" | "rect";
+/** 动画类型 */
+type SkeletonAnimation = "shimmer" | "pulse" | false;
+interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
+    /** 形状预设，默认 "text"（条形） */
+    variant?: SkeletonVariant;
+    /** 动画类型，默认 "shimmer"（扫光）；"pulse" 为呼吸闪烁；false 关闭动画 */
+    animation?: SkeletonAnimation;
+    /** 宽度，支持数字(px)或字符串(百分比等) */
+    width?: number | string;
+    /** 高度，支持数字(px)或字符串；text 默认 15px，rect 默认 40px */
+    height?: number | string;
+    /** 圆角，覆盖 variant 的默认圆角 */
+    borderRadius?: number | string;
+    /** circle/rect 的快捷尺寸（同时设置宽高） */
+    size?: number | string;
+}
+
+/**
+ * Skeleton 骨架屏组件
+ * 在数据加载完成前，通过占位图形展示简单的页面布局。
+ * 支持条形(text)、圆形(circle)、方形(rect)三种预设形状，以及 shimmer/pulse 两种动画。
+ */
+declare const Skeleton: React$1.ForwardRefExoticComponent<SkeletonProps & React$1.RefAttributes<HTMLDivElement>>;
+
+/** 面包屑尺寸：md=常规(16px/斜杠分隔)，sm=小型(13px/尖括号分隔) */
+type BreadcrumbSize = "sm" | "md";
+/** 单个路径项 */
+interface BreadcrumbItem {
+    /** 唯一标识（用于 React key，缺省时回退到下标） */
+    key?: string | number;
+    /** 文字内容 */
+    label?: ReactNode;
+    /** 链接地址，存在时渲染为 <a> */
+    href?: string;
+    /** 点击回调（非当前页时可点击；折叠进下拉时同样触发） */
+    onClick?: (event?: MouseEvent<HTMLElement>) => void;
+    /** 前置图标（如根节点的 House 图标）；须传入 lingee-icon 组件 */
+    icon?: ReactNode;
+    /** 是否禁用（不可点击、置灰） */
+    disabled?: boolean;
+}
+interface BreadcrumbProps extends Omit<HTMLAttributes<HTMLElement>, "onClick"> {
+    /** 路径项列表 */
+    items: BreadcrumbItem[];
+    /** 尺寸，默认 "md"（常规）。md=16px+斜杠，sm=13px+尖括号 */
+    size?: BreadcrumbSize;
+    /** 自定义分隔符，默认按 size：md→"/"(SlashLg)，sm→">"(ChevronRight) */
+    separator?: ReactNode;
+    /** 超过该数量时折叠中间项为 "…" 下拉；0 表示不折叠（默认 0） */
+    maxItems?: number;
+    /** 折叠时保留的头部项数，默认 1 */
+    itemsBeforeCollapse?: number;
+    /** 折叠时保留的尾部项数，默认 1 */
+    itemsAfterCollapse?: number;
+    /** 返回操作；传入后在最前面渲染返回箭头（页面级面包屑用） */
+    onBack?: (event?: MouseEvent<HTMLElement>) => void;
+    /** 单个链接项最大宽度(px)，超出显示省略号；不传则不限制 */
+    itemMaxWidth?: number;
+}
+
+/**
+ * Breadcrumb 面包屑组件
+ * 展示当前页面在系统层级中的位置，支持常规/小型两种尺寸、
+ * 前置返回/首页图标、中间层级折叠下拉、超长省略等
+ */
+declare const Breadcrumb: React$1.ForwardRefExoticComponent<BreadcrumbProps & React$1.RefAttributes<HTMLElement>>;
+
+/**
+ * 表格尺寸变体
+ * - default: 单行模式，行高 52px
+ * - large: 多行模式，行高 64px
+ */
+type TableSize = "default" | "large";
+/**
+ * 列定义
+ */
+interface TableColumnType<RecordType = any> {
+    /** 列唯一标识 */
+    key?: Key;
+    /** 列标题 */
+    title?: ReactNode;
+    /** 数据字段名 */
+    dataIndex?: string | string[];
+    /** 列宽 */
+    width?: number | string;
+    /** 最小列宽 */
+    minWidth?: number;
+    /** 列对齐方式 */
+    align?: "left" | "center" | "right";
+    /** 固定列 */
+    fixed?: "left" | "right" | boolean;
+    /** 自定义渲染 */
+    render?: (value: any, record: RecordType, index: number) => ReactNode;
+    /** 单元格省略 */
+    ellipsis?: boolean;
+    /** 表头帮助提示 */
+    tooltip?: string;
+    /** 是否可排序 */
+    sorter?: boolean | ((a: RecordType, b: RecordType) => number);
+    /** 排序方向 */
+    sortOrder?: "ascend" | "descend" | null;
+    /** 自定义表头单元格属性 */
+    onHeaderCell?: (column: TableColumnType<RecordType>) => Record<string, any>;
+    /** 自定义单元格属性 */
+    onCell?: (record: RecordType, index: number) => Record<string, any>;
+    /** 子列（表头分组） */
+    children?: TableColumnType<RecordType>[];
+    /** 额外 className */
+    className?: string;
+}
+/**
+ * 行选择配置
+ */
+interface TableRowSelection<RecordType = any> {
+    /** 选中的行 key 列表（受控） */
+    selectedRowKeys?: Key[];
+    /** 选中变化回调 */
+    onChange?: (selectedRowKeys: Key[], selectedRows: RecordType[]) => void;
+    /** 行是否可选 */
+    getCheckboxProps?: (record: RecordType) => {
+        disabled?: boolean;
+    };
+    /** 选择类型 */
+    type?: "checkbox" | "radio";
+}
+/**
+ * 排序信息
+ */
+interface TableSorterState {
+    columnKey: Key;
+    order: "ascend" | "descend" | null;
+}
+/**
+ * Table 组件 Props
+ */
+interface TableProps<RecordType = any> {
+    /** 列定义 */
+    columns?: TableColumnType<RecordType>[];
+    /** 数据源 */
+    dataSource?: RecordType[];
+    /** 行 key 取值字段或函数 */
+    rowKey?: string | ((record: RecordType, index: number) => Key);
+    /** 尺寸变体 */
+    size?: TableSize;
+    /** 是否显示边框 */
+    bordered?: boolean;
+    /** 加载状态 */
+    loading?: boolean;
+    /** 横向滚动宽度 */
+    scroll?: {
+        x?: number | string;
+        y?: number | string;
+    };
+    /** 行选择配置 */
+    rowSelection?: TableRowSelection<RecordType>;
+    /** 排序变化回调 */
+    onSortChange?: (sorter: TableSorterState) => void;
+    /** 行点击 */
+    onRow?: (record: RecordType, index: number) => Record<string, any>;
+    /** 空数据展示 */
+    empty?: ReactNode;
+    /** 表格标题 */
+    title?: ReactNode | (() => ReactNode);
+    /** 表格底部 */
+    footer?: ReactNode | (() => ReactNode);
+    /** 是否显示表头 */
+    showHeader?: boolean;
+    /** 额外 className */
+    className?: string;
+    /** 自定义行内样式 */
+    style?: CSSProperties;
+    /** 斑马纹 */
+    striped?: boolean;
+    /** 行 hover 高亮 */
+    hoverable?: boolean;
+}
+
+declare const Table: <RecordType = any>(props: TableProps<RecordType> & {
+    ref?: React$1.Ref<HTMLDivElement>;
+}) => React$1.ReactElement | null;
+
+/** 预览变换状态 */
+type TransformType = {
+    x: number;
+    y: number;
+    rotate: number;
+    scale: number;
+    flipX: boolean;
+    flipY: boolean;
+};
+/** 预览变换动作 */
+type TransformAction = "flipY" | "flipX" | "rotateLeft" | "rotateRight" | "zoomIn" | "zoomOut" | "close" | "prev" | "next" | "wheel" | "doubleClick" | "move" | "dragRebound" | "touchZoom" | "reset";
+/** 预览图信息 */
+interface ImgInfo {
+    url: string;
+    alt: string;
+    width: string | number;
+    height: string | number;
+}
+/** cover 配置（图片上的 hover 蒙层） */
+interface CoverConfig {
+    /** 自定义蒙层内容 */
+    coverNode?: React$1.ReactNode;
+    /** 蒙层位置 */
+    placement?: "top" | "bottom" | "center";
+}
+/** 预览配置 */
+interface PreviewType {
+    /** 预览图片地址（默认使用 Image src） */
+    src?: string;
+    /** 是否打开预览（受控） */
+    open?: boolean;
+    /** 打开/关闭回调 */
+    onOpenChange?: (open: boolean) => void;
+    /** 图片上的 hover 蒙层；false 禁用，ReactNode 自定义内容，CoverConfig 对象配置 */
+    cover?: false | React$1.ReactNode | CoverConfig;
+    /** 自定义预览内容 */
+    imageRender?: (originalNode: React$1.ReactElement, info: {
+        transform: TransformType;
+        image: ImgInfo;
+    }) => React$1.ReactNode;
+    /** 自定义工具栏渲染 */
+    actionsRender?: (originalNode: React$1.ReactElement, info: {
+        transform: TransformType;
+        actions: Record<string, () => void>;
+    }) => React$1.ReactNode;
+    /** 最小缩放 */
+    minScale?: number;
+    /** 最大缩放 */
+    maxScale?: number;
+    /** 缩放步长（1 + scaleStep 为每步倍数） */
+    scaleStep?: number;
+    /** 是否可拖拽 */
+    movable?: boolean;
+    /** 预览挂载容器 */
+    getContainer?: string | HTMLElement | (() => HTMLElement) | false;
+    /** 预览层 z-index */
+    zIndex?: number;
+    /** 变换回调 */
+    onTransform?: (info: {
+        transform: TransformType;
+        action: TransformAction;
+    }) => void;
+    /** 自定义关闭图标 */
+    closeIcon?: React$1.ReactNode;
+}
+/** Image 组件 Props — 对齐 antd 6 Image API */
+interface ImageProps extends Omit<React$1.ImgHTMLAttributes<HTMLImageElement>, "placeholder" | "onClick" | "onKeyDown"> {
+    /** 图片地址 */
+    src?: string;
+    /** 加载失败容错地址 */
+    fallback?: string;
+    /**
+     * 加载占位：
+     * - true：默认灰底占位
+     * - ReactNode：自定义占位内容
+     * - { progress: true }：圆形不确定进度（旋转动画）
+     * - { progress: { percent: number } }：圆形确定进度
+     */
+    placeholder?: boolean | React$1.ReactNode | {
+        progress: true | {
+            percent: number;
+        };
+    };
+    /** 预览配置（false 禁用，true 启用默认，对象自定义） */
+    preview?: boolean | PreviewType;
+    /** 自定义根类名 */
+    className?: string;
+    /** 自定义根样式 */
+    style?: React$1.CSSProperties;
+    /** 点击回调 */
+    onClick?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
+    /** 加载失败回调 */
+    onError?: (e: React$1.SyntheticEvent<HTMLImageElement, Event>) => void;
+}
+/** PreviewGroup 预览配置 */
+interface PreviewGroupType extends Omit<PreviewType, "cover"> {
+    /** 当前预览索引 */
+    current?: number;
+    /** 切换回调 */
+    onChange?: (current: number, prevCurrent: number) => void;
+    /** 计数自定义渲染 */
+    countRender?: (current: number, total: number) => React$1.ReactNode;
+}
+/** Image.PreviewGroup Props */
+interface ImagePreviewGroupProps {
+    /** 预览图片列表 */
+    items?: (string | {
+        src: string;
+        alt?: string;
+    })[];
+    /** 预览配置 */
+    preview?: boolean | PreviewGroupType;
+    /** 子元素 */
+    children?: React$1.ReactNode;
+}
+
+/**
+ * Image 图片组件 — 基于 @rc-component/image 封装
+ *
+ * API 对齐 antd 6 Image：
+ * - 默认不显示图片上的 hover 蒙层（cover: false）
+ * - 加载失败时显示默认图像占位图标（可通过 fallback 指定替代 URL）
+ * - 支持 preview.src 设置不同的预览图
+ * - 支持 placeholder 渐进加载（模糊图/自定义节点）
+ *
+ * 工具栏图标使用 lingee-icon，样式使用 lg-image 前缀。
+ */
+
+/** 多图预览分组 */
+declare const PreviewGroup: React$1.FC<ImagePreviewGroupProps>;
+/** Image 图片组件 */
+declare const Image: React$1.FC<ImageProps> & {
+    PreviewGroup: typeof PreviewGroup;
+};
+
+type ColorPickerSize = LgSize;
+interface ColorPickerProps {
+    /** 当前颜色值（受控），支持 hex 字符串如 "#ff0000" */
+    value?: string;
+    /** 默认颜色值（非受控） */
+    defaultValue?: string;
+    /** 颜色变化回调 */
+    onChange?: (color: string) => void;
+    /** 拖拽结束回调 */
+    onChangeComplete?: (color: string) => void;
+    /** 输入框尺寸，默认 "md" */
+    size?: ColorPickerSize;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否隐藏透明度滑块 */
+    disabledAlpha?: boolean;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 错误状态 */
+    error?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 弹出面板额外内容（如预设色板） */
+    panelExtra?: ReactNode;
+    /** Popover 弹出方向 */
+    placement?: "top" | "bottom" | "left" | "right";
+}
+
+/**
+ * ColorPicker 颜色选择器
+ * 触发器参考 Input 组件外观，内容展示颜色值，右侧显示色块预览
+ * 面板使用 @rc-component/color-picker 提供完整的颜色选取交互
+ */
+declare const ColorPicker: React$1.ForwardRefExoticComponent<ColorPickerProps & React$1.RefAttributes<HTMLDivElement>>;
+
+type ProgressStatus = "normal" | "success" | "error" | "active";
+type ProgressType = "line" | "circle";
+interface ProgressProps {
+    /** 进度类型 */
+    type?: ProgressType;
+    /** 百分比 0-100；不传或 -1 表示不确定进度（旋转动画） */
+    percent?: number;
+    /** 状态 */
+    status?: ProgressStatus;
+    /** 尺寸：line 为高度(px)，circle 为直径(px) */
+    size?: number;
+    /** 进度条/弧颜色 */
+    strokeColor?: string;
+    /** 轨道颜色 */
+    trailColor?: string;
+    /** 线条宽度（circle 模式下为环宽度，line 模式为条高度） */
+    strokeWidth?: number;
+    /** 是否显示百分比文字/状态图标 */
+    showInfo?: boolean;
+    /** 自定义格式化显示内容 */
+    format?: (percent: number) => React$1.ReactNode;
+    /** 自定义根类名 */
+    className?: string;
+    /** 自定义根样式 */
+    style?: React$1.CSSProperties;
+}
+
+/**
+ * Progress 进度条组件
+ *
+ * 支持线性（line）和圆形（circle）两种模式。
+ * percent 不传或为 -1 时为不确定进度（旋转/滑动动画）。
+ */
+
+declare const Progress: React$1.FC<ProgressProps>;
+
+type DrawerPlacement = "left" | "right" | "top" | "bottom";
+interface DrawerProps {
+    /** 是否打开 */
+    open: boolean;
+    /** 状态变化回调（关闭时 nextOpen=false） */
+    onOpenChange: (open: boolean) => void;
+    /** 抽屉滑出方向，默认 right */
+    placement?: DrawerPlacement;
+    /** 抽屉宽度（left/right 方向时生效），默认 380 */
+    size?: number | string;
+    /** 标题（支持 ReactNode） */
+    title?: ReactNode;
+    /** 标题栏右侧额外内容 */
+    extra?: ReactNode;
+    /** 是否显示关闭按钮，默认 true */
+    closable?: boolean;
+    /** 底部操作区，传 ReactNode 完全自定义；传 null 隐藏 */
+    footer?: ReactNode;
+    /** 是否为模态（true 时点击遮罩不关闭），默认 false */
+    modal?: boolean;
+    /** 是否显示遮罩层，默认 true */
+    mask?: boolean;
+    /** 关闭后是否销毁子节点，默认 true */
+    destroyOnHidden?: boolean;
+    /** 自定义 z-index */
+    zIndex?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 抽屉内容 */
+    children?: ReactNode;
+}
+
+/**
+ * Drawer 抽屉组件
+ * 基于 @radix-ui/react-dialog，从屏幕边缘滑入的面板
+ */
+declare const Drawer: React$1.FC<DrawerProps>;
+
+type SliderSize = "sm" | "md" | "lg";
+interface SliderProps {
+    /** 受控值（单值传 [50]，range 传 [20, 80]） */
+    value?: number[];
+    /** 非受控默认值 */
+    defaultValue?: number[];
+    /** 值变化回调 */
+    onChange?: (value: number[]) => void;
+    /** 拖拽结束时回调 */
+    onValueCommit?: (value: number[]) => void;
+    /** 最小值，默认 0 */
+    min?: number;
+    /** 最大值，默认 100 */
+    max?: number;
+    /** 步长，默认 1 */
+    step?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 方向，默认 horizontal */
+    orientation?: "horizontal" | "vertical";
+    /** 尺寸，默认 md */
+    size?: SliderSize;
+    /** 是否显示 tooltip，默认 true */
+    tooltip?: boolean;
+    /** 自定义 tooltip 内容格式化 */
+    tipFormatter?: (value: number) => string;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+
+/**
+ * Slider 滑块组件
+ * 基于 @radix-ui/react-slider，支持单值/range、tooltip、键盘操作
+ */
+declare const Slider: React$1.ForwardRefExoticComponent<SliderProps & React$1.RefAttributes<HTMLSpanElement>>;
+
+type StepStatus = "wait" | "process" | "finish" | "error";
+type StepsSize = "default" | "small";
+type StepsTitlePlacement = "horizontal" | "vertical";
+interface StepItem {
+    /** 标题 */
+    title: ReactNode;
+    /** 描述（辅助信息） */
+    description?: ReactNode;
+    /** 自定义图标（覆盖默认数字/状态图标） */
+    icon?: ReactNode;
+    /** 手动指定状态，不传则根据 current 自动推断 */
+    status?: StepStatus;
+    /** 禁用点击 */
+    disabled?: boolean;
+}
+interface StepsProps {
+    /** 步骤数据 */
+    items: StepItem[];
+    /** 当前步骤索引（0-based），默认 0 */
+    current?: number;
+    /** 当前步骤的状态，默认 process */
+    status?: StepStatus;
+    /** 层级变体：default 为页面级，small 为次级 */
+    size?: StepsSize;
+    /** 标题放置位置：vertical 标题在图标下方，horizontal 标题在图标右侧 */
+    titlePlacement?: StepsTitlePlacement;
+    /** 起始序号，默认 0 */
+    initial?: number;
+    /** 点击步骤回调，不传则不可点击 */
+    onChange?: (current: number) => void;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+
+/**
+ * Steps 步骤条组件
+ * 纯自研，支持页面级/次级变体，四种状态，标题纵/横排列
+ */
+declare const Steps: React$1.FC<StepsProps>;
+
+type FormLayout = "horizontal" | "vertical" | "inline";
+type FormInstance = FormInstance$1;
+
+interface FormProps {
+    /** 表单实例（由 Form.useForm() 创建） */
+    form?: FormInstance;
+    /** 表单布局，默认 "vertical" */
+    layout?: FormLayout;
+    /** horizontal 布局时 label 宽度，默认 120 */
+    labelWidth?: number | string;
+    /** 表单初始值 */
+    initialValues?: Record<string, unknown>;
+    /** 校验通过后的提交回调 */
+    onFinish?: (values: Record<string, unknown>) => void;
+    /** 校验失败回调 */
+    onFinishFailed?: (errorInfo: {
+        values: Record<string, unknown>;
+        errorFields: {
+            name: (string | number)[];
+            errors: string[];
+        }[];
+    }) => void;
+    /** 字段值变化回调 */
+    onValuesChange?: (changedValues: Record<string, unknown>, allValues: Record<string, unknown>) => void;
+    /** 是否在 required 项显示 * 号，默认 true */
+    requiredMark?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 子元素 */
+    children?: ReactNode;
+}
+interface FormItemProps {
+    /** 字段名（支持数组路径如 ["user", "name"]） */
+    name?: string | (string | number)[];
+    /** 标签 */
+    label?: ReactNode;
+    /** 校验规则 */
+    rules?: Rule[];
+    /** 是否必填（语法糖，自动添加 required 规则） */
+    required?: boolean;
+    /** 必填提示信息（配合 required 使用） */
+    requiredMessage?: string;
+    /** 标签后的提示信息 */
+    tooltip?: ReactNode;
+    /** 绑定值的 prop 名，默认 "value" */
+    valuePropName?: string;
+    /** 触发 onChange 的 prop 名，默认 "onChange" */
+    trigger?: string;
+    /** 从事件中提取值的方法 */
+    getValueFromEvent?: (...args: unknown[]) => unknown;
+    /** 是否在校验错误时将 error={true} 注入子控件，默认 true */
+    injectError?: boolean;
+    /** 额外说明信息（显示在控件下方） */
+    extra?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 子元素（表单控件） */
+    children?: ReactElement | ((control: Record<string, unknown>, meta: {
+        errors: string[];
+    }) => ReactNode);
+}
+
+/**
+ * Form 表单组件
+ * 基于 rc-field-form，提供布局和校验能力
+ */
+declare const InternalForm: React$1.FC<FormProps>;
+/** useForm — 创建表单实例 */
+declare function useForm(): [FormInstance];
+
+/**
+ * Form.Item 表单项组件
+ * 处理 label 布局、校验规则、错误信息展示
+ */
+declare const FormItem: React$1.FC<FormItemProps>;
+
+type FormType = typeof InternalForm & {
+    Item: typeof FormItem;
+    useForm: typeof useForm;
+};
+declare const Form: FormType;
+
+interface AvatarProps {
+    /** 头像图片地址 */
+    src?: string;
+    /** 图片加载失败时的替代文字（如姓氏、英文缩写） */
+    alt?: string;
+    /** 头像尺寸（px），默认 32 */
+    size?: number;
+    /** 自定义圆角，默认圆形（50%） */
+    shape?: "circle" | "square";
+    /** 自定义图标（覆盖默认人形图标） */
+    icon?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 图片加载失败回调 */
+    onError?: () => void;
+}
+interface AvatarGroupProps {
+    /** 最多显示数量，超出显示 +N，默认 5 */
+    max?: number;
+    /** 头像尺寸（px），默认 32 */
+    size?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 子元素（Avatar 列表） */
+    children?: ReactNode;
+}
+
+/**
+ * Avatar 头像组件
+ * 支持图片、文字、图标三种展示形态
+ */
+declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLSpanElement>>;
+/**
+ * Avatar.Group 头像集群
+ * 最多显示 max 个头像，超出显示 +N
+ */
+declare const AvatarGroup: React$1.FC<AvatarGroupProps>;
+type AvatarType = typeof Avatar & {
+    Group: typeof AvatarGroup;
+};
+declare const AvatarWithGroup: AvatarType;
+
+/** 文件上传状态 */
+type UploadFileStatus = "ready" | "uploading" | "done" | "error";
+/** 上传文件对象 */
+interface UploadFile {
+    /** 唯一标识（内部自动生成） */
+    uid: string;
+    /** 文件名 */
+    name: string;
+    /** 文件大小（bytes） */
+    size?: number;
+    /** MIME 类型 */
+    type?: string;
+    /** 当前状态 */
+    status: UploadFileStatus;
+    /** 上传进度 0-100 */
+    percent?: number;
+    /** 上传成功后的 URL */
+    url?: string;
+    /** 服务端响应数据 */
+    response?: unknown;
+    /** 错误信息 */
+    error?: Error;
+    /** 原始 File 对象（本地选择后可用） */
+    originFile?: File;
+}
+/** customRequest 入参 */
+interface CustomRequestOptions {
+    /** 待上传的文件 */
+    file: File;
+    /** 更新进度（0-100） */
+    onProgress: (percent: number) => void;
+    /** 上传成功 */
+    onSuccess: (response?: unknown) => void;
+    /** 上传失败 */
+    onError: (error: Error) => void;
+}
+/** customRequest 返回值，提供中止能力 */
+interface CustomRequestReturn {
+    abort: () => void;
+}
+/** 文件校验拒绝原因 */
+type RejectReason = "size" | "type" | "count";
+/** 文件列表项操作 */
+interface FileItemActions {
+    /** 移除文件 */
+    remove: () => void;
+    /** 重新上传 */
+    retry: () => void;
+}
+interface UploadProps {
+    /** 接受的文件 MIME 类型，如 "image/*,.pdf" */
+    accept?: string;
+    /** 单文件大小限制（bytes） */
+    maxSize?: number;
+    /** 最大文件数量 */
+    maxCount?: number;
+    /** 是否允许多选 */
+    multiple?: boolean;
+    /** 是否渲染拖拽上传区域 */
+    drag?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 受控文件列表 */
+    fileList?: UploadFile[];
+    /** 非受控默认文件列表 */
+    defaultFileList?: UploadFile[];
+    /** 自定义上传实现（必传，组件不内置上传逻辑） */
+    customRequest: (options: CustomRequestOptions) => CustomRequestReturn | void;
+    /** 文件列表变更回调 */
+    onChange?: (fileList: UploadFile[]) => void;
+    /** 文件校验拒绝回调 */
+    onReject?: (files: File[], reason: RejectReason) => void;
+    /** 移除文件前的拦截，返回 false 或 reject 阻止移除 */
+    onRemove?: (file: UploadFile) => void | boolean | Promise<boolean>;
+    /** 触发区域自定义内容（非 drag 模式） */
+    children?: ReactNode;
+    /** 自定义文件列表项渲染 */
+    renderItem?: (file: UploadFile, actions: FileItemActions) => ReactNode;
+    /** 是否显示文件列表，默认 true */
+    showFileList?: boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+
+/**
+ * Upload 上传组件
+ * 支持点击选择和拖拽上传两种模式，文件校验、进度展示、文件列表管理
+ */
+declare const Upload: React$1.ForwardRefExoticComponent<UploadProps & React$1.RefAttributes<HTMLDivElement>>;
+
+interface ScrollAreaProps {
+    /** 子内容 */
+    children: ReactNode;
+    /** 自定义类名（应用于 Root） */
+    className?: string;
+    /** 自定义样式（应用于 Root） */
+    style?: CSSProperties;
+    /**
+     * 滚动条显示策略
+     * - scroll: 滚动时显示，停止后隐藏（默认）
+     * - hover: 鼠标悬浮时显示
+     * - auto: 内容溢出时显示
+     * - always: 始终显示
+     */
+    type?: "scroll" | "hover" | "auto" | "always";
+    /** 停止滚动/移出后滚动条隐藏延迟（ms），仅 type="scroll"|"hover" 时生效 */
+    scrollHideDelay?: number;
+    /**
+     * 滚动条方向
+     * - vertical: 仅垂直（默认）
+     * - horizontal: 仅水平
+     * - both: 双向
+     */
+    scrollbars?: "vertical" | "horizontal" | "both";
+    /** 滚动条默认尺寸（px） */
+    scrollbarSize?: number;
+    /** 滚动条悬浮时尺寸（px） */
+    scrollbarHoverSize?: number;
+    /** Viewport 滚动事件回调（用于触底加载等场景） */
+    onScroll?: UIEventHandler<HTMLDivElement>;
+    /** Viewport（实际滚动元素）的 ref，用于外部控制滚动位置 */
+    viewportRef?: Ref<HTMLDivElement>;
+}
+interface ScrollBarProps {
+    /** 滚动条方向 */
+    orientation?: "vertical" | "horizontal";
+    /** 自定义类名 */
+    className?: string;
+}
+
+/**
+ * ScrollArea 滚动区域组件
+ *
+ * 增强原生滚动功能，提供自定义跨浏览器滚动条样式：
+ * - 滚动条悬浮在内容上方，不占用布局空间
+ * - 保留原生滚动行为，键盘/触摸不受影响
+ * - 支持多种显示策略：scroll / hover / auto / always
+ *
+ * ```tsx
+ * <ScrollArea style={{ height: 300 }}>
+ *   <LongList />
+ * </ScrollArea>
+ * ```
+ */
+declare const ScrollArea: React$1.ForwardRefExoticComponent<ScrollAreaProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * ScrollBar 滚动条子组件
+ *
+ * 通常由 ScrollArea 内部自动渲染，也可单独使用以获得更精细的控制。
+ */
+declare const ScrollBar: React$1.ForwardRefExoticComponent<ScrollBarProps & React$1.RefAttributes<HTMLDivElement>>;
+
 /**
  * 合并 CSS 类名，支持条件拼接
  * @param inputs - 任意数量的 ClassValue 参数
@@ -71,11 +1868,4 @@ declare function useComponentLocale<K extends keyof Omit<Locale, "locale">>(comp
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-/** 组件尺寸类型 */
-type LgSize = "xs" | "sm" | "md" | "lg";
-/** 组件变体类型 */
-type LgVariant = "primary" | "secondary" | "ghost" | "outline" | "text" | "link";
-/** 组件形状类型 */
-type LgShape = "default" | "circle" | "round";
-
-export { type LgShape, type LgSize, type LgVariant, LingeeProvider, type LingeeProviderProps, type Locale, cn, enUS, useComponentLocale, useLocale, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfirmOptions, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, Empty, type EmptyIconComponent, type EmptyProps, type EmptySize, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, LgSize, LingeeProvider, type LingeeProviderProps, type Locale, Pagination, type PaginationProps, type PaginationVariant, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, cn, enUS, useComponentLocale, useLocale, zhCN };