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

package/dist/{core-CdoVqv0o.d.ts → core-C5OnrCi4.d.cts}

@@ -1,36 +1,86 @@
 import * as react from 'react';
 import { ButtonHTMLAttributes, ReactNode, HTMLAttributes, CSSProperties, MouseEvent, ReactElement, ImgHTMLAttributes, InputHTMLAttributes, MouseEventHandler, AnchorHTMLAttributes } from 'react';
-import { C as ControlSize, a as ControlStatus, I as InputPlaceholderMode } from './shared-DAYZvZVu.js';
-import './Select-Cz3hzQl_.js';
+import { C as ControlSize, a as ControlStatus, I as InputPlaceholderMode } from './shared-Bx4B28Wh.cjs';
+import './Select-4hGJt3RJ.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 CardAccent = "primary" | "success" | "warning" | "error";
+/** 卡片的属性配置。 */
 interface CardProps extends Omit<HTMLAttributes<HTMLElement>, "title"> {
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 主体之外的补充内容或操作区。 */
     extra?: ReactNode;
+    /** 强调装饰样式。 */
     accent?: CardAccent;
+    /** 强调装饰的颜色。 */
     accentColor?: string;
+    /**
+     * 允许收起内容区域
+     * @defaultValue false
+     */
     collapsible?: boolean;
+    /** 是否收起；传入后由外部控制。 */
     collapsed?: boolean;
+    /**
+     * 非受控模式的初始收起状态。
+     * @defaultValue false
+     */
     defaultCollapsed?: boolean;
+    /** 收起状态变化回调 */
     onCollapsedChange?: (collapsed: boolean) => void;
+    /** 固定内容区高度并开启内部滚动 */
     bodyHeight?: number | string;
+    /**
+     * 内容区域的 CSS 类名。
+     * @defaultValue ""
+     */
     bodyClassName?: string;
+    /** 内容区域的内联样式。 */
     bodyStyle?: CSSProperties;
 }
+/** 卡片组件。 */
 declare function Card({ title, description, extra, accent, accentColor, collapsible, collapsed, defaultCollapsed, onCollapsedChange, bodyHeight, bodyClassName, bodyStyle, className, style, children, ...props }: CardProps): react.JSX.Element;
 
 declare const iconPaths: {
@@ -245,7 +295,9 @@ declare const iconPaths: {
     code: react.JSX.Element;
     github: react.JSX.Element;
 };
+/** 可用的线框图标名称。 */
 type IconName = keyof typeof iconPaths;
+/** 可用线框图标名称集合。 */
 declare const ICON_NAMES: readonly ("warning" | "link" | "copy" | "move" | "zoom-in" | "zoom-out" | "table" | "italic" | "bold" | "underline" | "menu" | "search" | "send" | "notepad-file" | "notepad-folder" | "notepad-virtual-folder" | "step-backward" | "step-forward" | "fast-backward" | "fast-forward" | "corner-up-left" | "corner-up-right" | "swap-horizontal" | "swap-vertical" | "expand" | "shrink" | "fullscreen" | "fullscreen-exit" | "menu-fold" | "menu-unfold" | "login" | "logout" | "vertical-align-top" | "vertical-align-middle" | "vertical-align-bottom" | "square-plus" | "square-minus" | "square-check" | "square-close" | "tab-plus" | "folder-plus" | "pin" | "pin-off" | "stop" | "help-circle" | "save" | "clipboard" | "clipboard-check" | "file-plus" | "file-check" | "file-warning" | "file-spreadsheet" | "align-left" | "align-center" | "align-right" | "align-justify" | "strikethrough" | "list-ordered" | "list-unordered" | "eraser" | "highlighter" | "columns" | "rows" | "bar-chart" | "line-chart" | "pie-chart" | "area-chart" | "activity" | "trending-up" | "trending-down" | "database" | "cloud" | "cloud-download" | "cloud-upload" | "server" | "desktop" | "laptop" | "mobile" | "tablet" | "printer" | "camera" | "video" | "microphone" | "volume-up" | "volume-off" | "speaker-wave" | "speaker-muted" | "wifi" | "power" | "key" | "shield" | "shield-check" | "bug" | "bulb" | "rocket" | "target" | "trophy" | "shopping-cart" | "shopping-bag" | "shop" | "wallet" | "bank" | "calculator" | "tag" | "tags" | "message" | "comments" | "share" | "paperclip" | "location" | "compass" | "car" | "truck" | "gift" | "coffee" | "experiment" | "tool" | "appstore" | "puzzle" | "partition" | "branches" | "scan" | "qr-code" | "barcode" | "user-plus" | "user-minus" | "smile" | "meh" | "frown" | "game-cultivator" | "game-swordsman" | "game-spirit-wolf" | "game-gem" | "game-ingot" | "game-sword" | "game-robe" | "game-pants" | "game-pendant" | "game-necklace" | "game-pill" | "game-potion" | "game-elixir-jar" | "game-flame" | "game-soul-elixir" | "game-herb" | "game-meditate" | "game-backpack" | "game-qi" | "plus" | "minus" | "close" | "check" | "info" | "question" | "circle-check" | "circle-close" | "circle-plus" | "circle-minus" | "chevron-left" | "chevron-right" | "chevron-up" | "chevron-down" | "double-left" | "double-right" | "arrow-left" | "arrow-right" | "arrow-up" | "arrow-down" | "more-horizontal" | "more-vertical" | "home" | "user" | "users" | "settings" | "edit" | "trash" | "scissors" | "undo" | "redo" | "download" | "upload" | "refresh" | "loader" | "calendar" | "clock" | "mail" | "phone" | "external-link" | "eye" | "eye-off" | "lock" | "unlock" | "bell" | "star" | "heart" | "file" | "folder" | "image" | "filter" | "sort-ascending" | "sort-descending" | "play" | "pause" | "book" | "component" | "token" | "sun" | "moon" | "code" | "github")[];
 declare const filledIconPaths: {
     info: react.JSX.Element;
@@ -277,762 +329,1855 @@ declare const filledIconPaths: {
     component: react.JSX.Element;
     token: react.JSX.Element;
 };
+/** 可用的填充图标名称。 */
 type FilledIconName = keyof typeof filledIconPaths;
+/** 图标采用线框还是填充样式。 */
 type IconVariant = "outline" | "filled";
+/** 可用填充图标名称集合。 */
 declare const FILLED_ICON_NAMES: readonly ("warning" | "info" | "question" | "circle-check" | "circle-close" | "circle-plus" | "circle-minus" | "home" | "user" | "users" | "trash" | "calendar" | "clock" | "mail" | "lock" | "unlock" | "bell" | "star" | "heart" | "file" | "folder" | "image" | "filter" | "play" | "pause" | "book" | "component" | "token")[];
+/** 图标的属性配置。 */
 interface IconProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children"> {
+    /** 名称或字段标识。 */
     name: IconName;
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "1em"
+     */
     size?: number | string;
+    /**
+     * 描边或进度轨道粗细。
+     * @defaultValue 1.8
+     */
     strokeWidth?: number;
+    /**
+     * 旋转角度。
+     * @defaultValue 0
+     */
     rotate?: number;
+    /**
+     * 是否显示持续旋转动画。
+     * @defaultValue false
+     */
     spin?: boolean;
+    /**
+     * 是否显示脉冲动画。
+     * @defaultValue false
+     */
     pulse?: boolean;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
+    /**
+     组件的视觉样式。
+     * @defaultValue "outline"
+     */
     variant?: IconVariant;
 }
+/** 图标组件。 */
 declare const Icon: react.ForwardRefExoticComponent<IconProps & react.RefAttributes<HTMLSpanElement>>;
 
+/** 标签的状态类型。 */
 type TagStatus = "default" | "success" | "processing" | "warning" | "error";
+/** 标签的视觉样式。 */
 type TagVariant = "soft" | "outlined" | "filled";
+/** 标签的属性配置。 */
 interface TagProps extends HTMLAttributes<HTMLSpanElement> {
+    /**
+     * 语义状态
+     * @defaultValue "default"
+     */
     status?: TagStatus;
+    /**
+     * 紧凑尺寸
+     * @defaultValue false
+     */
     compact?: boolean;
+    /**
+     组件的视觉样式。
+     * @defaultValue "soft"
+     */
     variant?: TagVariant;
+    /** 标签前置图标 */
     icon?: ReactNode;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue false
+     */
     closable?: boolean;
     /** 悬停或键盘聚焦时展开关闭按钮。 */
     closeOnHover?: boolean;
+    /**
+     * 禁用关闭操作
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 请求关闭时触发的回调。 */
     onClose?: (event: MouseEvent<HTMLButtonElement>) => void;
 }
+/** 标签组件。 */
 declare function Tag({ status, compact, variant, icon, closable, closeOnHover, disabled, onClose, className, children, ...props }: TagProps): react.JSX.Element;
 
+/** 菜单的模式类型。 */
 type MenuMode = "vertical" | "horizontal" | "inline";
+/** 菜单的亮色或暗色主题。 */
 type MenuTheme = "light" | "dark";
+/** 菜单的项目定义。 */
 type MenuItem = {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 主体之外的补充内容或操作区。 */
     extra?: ReactNode;
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: string;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 危险操作样式 */
     danger?: boolean;
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: "item" | "group" | "divider";
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly MenuItem[];
 };
+/** 菜单的点击事件上下文。 */
 type MenuClickInfo = {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 从当前项目到祖先项目的标识路径。 */
     keyPath: string[];
+    /** 触发本次操作的 React 鼠标事件。 */
     domEvent: React.MouseEvent;
+    /** 本次操作关联的项目配置。 */
     item: MenuItem;
 };
+/** 菜单的属性配置。 */
 interface MenuProps extends Omit<HTMLAttributes<HTMLUListElement>, "onClick" | "onSelect"> {
+    /** 按展示顺序排列的项目配置。 */
     items: readonly MenuItem[];
+    /**
+     * 展示或交互模式；可选值见类型定义。
+     * @defaultValue "vertical"
+     */
     mode?: MenuMode;
+    /**
+     组件的配色主题。
+     * @defaultValue "light"
+     */
     theme?: MenuTheme;
+    /** 当前选中项目的标识集合；传入后由外部控制。 */
     selectedKeys?: readonly string[];
+    /**
+     * 非受控模式下初始选中的项目标识集合。
+     * @defaultValue []
+     */
     defaultSelectedKeys?: readonly string[];
+    /** 当前展开的子菜单标识集合。 */
     openKeys?: readonly string[];
+    /**
+     * 初始展开的子菜单标识集合。
+     * @defaultValue []
+     */
     defaultOpenKeys?: readonly string[];
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /**
+     * 是否允许选中项目。
+     * @defaultValue true
+     */
     selectable?: boolean;
+    /**
+     * 收起内嵌菜单
+     * @defaultValue false
+     */
     inlineCollapsed?: boolean;
+    /**
+     * 内嵌子菜单每增加一级时增加的缩进，单位为像素。
+     * @defaultValue 20
+     */
     inlineIndent?: number;
+    /**
+     * 打开子菜单的方式：hover 为悬停，click 为点击。
+     * @defaultValue "click"
+     */
     triggerSubMenuAction?: "hover" | "click";
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: (info: MenuClickInfo) => void;
+    /** 选中项目时调用，参数包含选中项目及关联状态。 */
     onSelect?: (info: MenuClickInfo & {
+        /** 当前选中项目的标识集合；传入后由外部控制。 */
         selectedKeys: string[];
     }) => void;
+    /** 取消选中项目时调用。 */
     onDeselect?: (info: MenuClickInfo & {
+        /** 当前选中项目的标识集合；传入后由外部控制。 */
         selectedKeys: string[];
     }) => void;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (keys: string[]) => void;
 }
+/** 菜单组件。 */
 declare function Menu({ items, mode, theme, selectedKeys, defaultSelectedKeys, openKeys, defaultOpenKeys, multiple, selectable, inlineCollapsed, inlineIndent, triggerSubMenuAction, onClick, onSelect, onDeselect, onOpenChange, className, ...rest }: MenuProps): react.JSX.Element;
+/** Step的状态类型。 */
 type StepStatus = "wait" | "process" | "finish" | "error";
+/** Step的项目定义。 */
 type StepItem = {
+    /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 主标题旁的次级标题。 */
     subTitle?: ReactNode;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 当前状态，用于选择对应的状态样式。 */
     status?: StepStatus;
+    /** 是否禁用交互。 */
     disabled?: boolean;
 };
+/** 步骤条的属性配置。 */
 interface StepsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** 按展示顺序排列的项目配置。 */
     items: readonly StepItem[];
+    /**
+     当前步骤索引，从 0 开始。
+     * @defaultValue 0
+     */
     current?: number;
+    /**
+     * 起始步骤的编号偏移。
+     * @defaultValue 0
+     */
     initial?: number;
+    /**
+     排列或展示方向。
+     * @defaultValue "horizontal"
+     */
     direction?: "horizontal" | "vertical";
+    /**
+     * 类型标识，用于选择对应的表现形式。
+     * @defaultValue "default"
+     */
     type?: "default" | "navigation" | "dot";
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "default"
+     */
     size?: "default" | "small";
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "process"
+     */
     status?: "process" | "error";
+    /**
+     * 是否以点状指示步骤，可传入自定义渲染函数。
+     * @defaultValue false
+     */
     progressDot?: boolean | ((dot: ReactNode, info: {
+        /** 项目在当前集合中的索引，从 0 开始。 */
         index: number;
+        /**
+         * 当前状态，用于选择对应的状态样式。
+         * @defaultValue "process"
+         */
         status: StepStatus;
+        /** 标题内容，可传入文本或 React 节点。 */
         title: ReactNode;
+        /** 补充说明内容。 */
         description?: ReactNode;
     }) => ReactNode);
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (current: number) => void;
 }
+/** 步骤条组件。 */
 declare function Steps({ items, current, initial, direction, type, size, status, progressDot, onChange, className, ...props }: StepsProps): react.JSX.Element;
+/** 分段选择的值类型。 */
 type SegmentedValue = string | number;
+/** 分段选择的候选项定义。 */
 type SegmentedOption = SegmentedValue | {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: SegmentedValue;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: string;
 };
+/** 分段选择的属性配置。 */
 interface SegmentedProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 可供用户选择的候选项列表。 */
     options: readonly SegmentedOption[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: SegmentedValue;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: SegmentedValue;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: "small" | "medium" | "large";
+    /**
+     * 宽度撑满父容器
+     * @defaultValue false
+     */
     block?: boolean;
+    /**
+     * 是否使用垂直布局。
+     * @defaultValue false
+     */
     vertical?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: SegmentedValue) => void;
 }
+/** 分段选择组件。 */
 declare function Segmented({ options, value, defaultValue, size: sizeProp, block, vertical, disabled, onChange, className, onKeyDown, ...props }: SegmentedProps): react.JSX.Element;
 
+/** Tab的项目定义。 */
 interface TabItem {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 是否显示关闭入口。 */
     closable?: boolean;
 }
+/** 选项卡的类型标识。 */
 type TabsType = "line" | "card" | "pill" | "capsule" | "underline" | "tech" | "tech-line";
+/** 选项卡沿水平方向或垂直方向排列。 */
 type TabsOrientation = "horizontal" | "vertical";
+/** 选项卡导航相对于内容区的位置。 */
 type TabsPosition = "top" | "right" | "bottom" | "left";
+/** TabsContextMenu的点击事件上下文。 */
 type TabsContextMenuClickInfo = MenuClickInfo & {
+    /** 关联选项卡的唯一标识。 */
     tabKey: string;
+    /** 当前选项卡配置。 */
     tab: TabItem;
 };
+/** 选项卡的属性配置。 */
 interface TabsProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** 标签项，包含 key、label、children、icon、disabled 和 closable */
     items: readonly TabItem[];
+    /** 当前激活项目的标识；传入后由外部控制。 */
     activeKey?: string;
+    /** 非受控模式下初始激活的项目标识。 */
     defaultActiveKey?: string;
+    /** 激活项变化回调 */
     onChange?: (key: string) => void;
+    /**
+     * 线型、卡片型、胶囊型、圆角胶囊、紧凑下划线或科技样式
+     * @defaultValue "line"
+     */
     type?: TabsType;
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "medium"
+     */
     size?: ControlSize;
+    /** 标签栏位于内容的上、右、下或左侧 */
     tabPosition?: TabsPosition;
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: TabsOrientation;
+    /**
+     * 弹框是否垂直居中。
+     * @defaultValue false
+     */
     centered?: boolean;
+    /** 标签栏左侧标题，科技大屏型会附带装饰线 */
     tabBarTitle?: ReactNode;
+    /** 标签栏右侧额外操作 */
     tabBarExtraContent?: ReactNode;
+    /**
+     * 是否卸载非激活面板
+     * @defaultValue true
+     */
     destroyInactiveTabPane?: boolean;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue false
+     */
     closable?: boolean;
+    /** 新增、删除或修改项目时调用。 */
     onEdit?: (key: string, action: "remove") => void;
+    /** 选项卡右键菜单配置。 */
     tabContextMenu?: readonly MenuItem[] | ((tab: TabItem) => readonly MenuItem[]);
+    /** 点击选项卡右键菜单时调用。 */
     onTabContextMenuClick?: (info: TabsContextMenuClickInfo) => void;
 }
+/** 选项卡组件。 */
 declare function Tabs({ items, activeKey, defaultActiveKey, onChange, type, size, tabPosition, orientation, centered, tabBarTitle, tabBarExtraContent, destroyInactiveTabPane, closable, onEdit, tabContextMenu, onTabContextMenuClick, className, ...props }: TabsProps): react.JSX.Element;
 
+/** 打开下拉菜单的触发方式。 */
 type DropdownTrigger = "click" | "hover" | "contextMenu";
+/** 下拉菜单的位置类型。 */
 type DropdownPlacement = "bottomLeft" | "bottomRight" | "topLeft" | "topRight";
+/** 引起下拉菜单打开状态变化的来源。 */
 type DropdownOpenSource = "trigger" | "menu";
+/** DropdownMenu的属性配置。 */
 interface DropdownMenuProps extends Pick<MenuProps, "multiple" | "selectable" | "selectedKeys" | "defaultSelectedKeys" | "onSelect" | "onDeselect"> {
+    /** 按展示顺序排列的项目配置。 */
     items: readonly MenuItem[];
+    /** 组件的配色主题。 */
     theme?: MenuTheme;
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: (info: MenuClickInfo) => void;
 }
+/** 下拉菜单的属性配置。 */
 interface DropdownProps extends Omit<HTMLAttributes<HTMLSpanElement>, "children" | "onOpenChange"> {
+    /** 菜单项、选中状态与点击回调 */
     menu: DropdownMenuProps;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children: ReactNode;
+    /**
+     * 触发显示的交互方式。
+     * @defaultValue ["hover"]
+     */
     trigger?: readonly DropdownTrigger[];
+    /**
+     * 相对于触发元素的弹出方向和对齐位置。
+     * @defaultValue "bottomLeft"
+     */
     placement?: DropdownPlacement;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /**
+     * 非受控模式下的初始打开状态。
+     * @defaultValue false
+     */
     defaultOpen?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** Automatically append a disclosure icon to a Button with text. */
+    showTriggerIcon?: boolean;
+    /**
+     * 显示箭头及是否指向触发器中心
+     * @defaultValue false
+     */
     arrow?: boolean | {
+        /** 是否让弹层箭头指向触发元素中心。 */
         pointAtCenter?: boolean;
     };
+    /**
+     * 显示后是否自动聚焦。
+     * @defaultValue false
+     */
     autoFocus?: boolean;
+    /**
+     * 触发后延迟打开的时间。
+     * @defaultValue 80
+     */
     openDelay?: number;
+    /**
+     * 移出后延迟关闭的时间。
+     * @defaultValue 120
+     */
     closeDelay?: number;
+    /**
+     * 弹出面板的附加 CSS 类名。
+     * @defaultValue ""
+     */
     popupClassName?: string;
+    /** 弹出面板的内联样式。 */
     popupStyle?: CSSProperties;
+    /** 自定义菜单浮层内容 */
     popupRender?: (menu: ReactNode) => ReactNode;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean, info: {
+        /** 触发来源，用于区分不同入口的操作。 */
         source: DropdownOpenSource;
     }) => void;
 }
-declare function DropdownRoot({ menu, children, trigger, placement, open, defaultOpen, disabled, arrow, autoFocus, openDelay, closeDelay, popupClassName, popupStyle, popupRender, onOpenChange, className, onClick, onMouseEnter, onMouseLeave, onContextMenu, onKeyDown, ...props }: DropdownProps): react.JSX.Element;
+declare function DropdownRoot({ menu, children, trigger, placement, open, defaultOpen, disabled, showTriggerIcon, arrow, autoFocus, openDelay, closeDelay, popupClassName, popupStyle, popupRender, onOpenChange, className, onClick, onMouseEnter, onMouseLeave, onContextMenu, onKeyDown, ...props }: DropdownProps): react.JSX.Element;
+/** DropdownButton的属性配置。 */
 interface DropdownButtonProps extends Omit<DropdownProps, "children" | "className"> {
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /**
+     * 附加到组件根节点的 CSS 类名。
+     * @defaultValue ""
+     */
     className?: string;
+    /** 透传给触发按钮的 Button 属性，可配置样式、尺寸和事件。 */
     buttonProps?: Omit<ButtonProps, "children" | "onClick" | "disabled">;
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: ButtonProps["onClick"];
 }
 declare function DropdownButton({ children, className, buttonProps, onClick, disabled, trigger, ...dropdownProps }: DropdownButtonProps): react.JSX.Element;
+/** 下拉菜单组件。 */
 declare const Dropdown: typeof DropdownRoot & {
+    /** 组合主操作按钮与下拉菜单的按钮组件。 */
     Button: typeof DropdownButton;
 };
 
+/** Floating的位置类型。 */
 type FloatingPlacement = "top" | "top-start" | "top-end" | "bottom" | "bottom-start" | "bottom-end" | "left" | "right";
+/** 触发浮层显示的交互方式。 */
 type FloatingTrigger = "hover" | "focus" | "click";
+/** 文字提示的属性配置。 */
 interface TooltipProps {
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children: ReactElement;
+    /** 相对于触发元素的弹出方向和对齐位置。 */
     placement?: FloatingPlacement;
+    /** 触发显示的交互方式。 */
     trigger?: FloatingTrigger | readonly FloatingTrigger[];
+    /** 元素的无障碍语义角色。 */
     role?: string;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /** 非受控模式下的初始打开状态。 */
     defaultOpen?: boolean;
+    /** 鼠标移入后延迟显示的时间。 */
     mouseEnterDelay?: number;
+    /** 鼠标移出后延迟隐藏的时间。 */
     mouseLeaveDelay?: number;
+    /** 显示箭头及是否指向触发器中心 */
     arrow?: boolean;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
+    /** 浮层容器的附加 CSS 类名。 */
     overlayClassName?: string;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
+/** 文字提示组件。 */
 declare function Tooltip(props: TooltipProps): react.JSX.Element;
+/** 气泡卡片的属性配置。 */
 interface PopoverProps extends Omit<TooltipProps, "title"> {
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 需要显示的内容，支持文本或 React 节点。 */
     content?: ReactNode;
 }
+/** 气泡卡片组件。 */
 declare function Popover({ title, content, trigger, overlayClassName, ...props }: PopoverProps): react.JSX.Element;
+/** 时间轴的项目定义。 */
 type TimelineItem = {
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: "blue" | "red" | "green" | "gray" | string;
+    /** 是否以圆点形式显示状态或徽标。 */
     dot?: ReactNode;
+    /** 显示位置或定位配置。 */
     position?: "left" | "right";
 };
+/** 时间轴的属性配置。 */
 interface TimelineProps extends HTMLAttributes<HTMLUListElement> {
+    /**
+     * 按展示顺序排列的项目配置。
+     * @defaultValue []
+     */
     items?: readonly TimelineItem[];
+    /**
+     * 展示或交互模式；可选值见类型定义。
+     * @defaultValue "left"
+     */
     mode?: "left" | "alternate" | "right";
+    /**
+     * 时间轴未完成节点的内容。
+     * @defaultValue false
+     */
     pending?: ReactNode | boolean;
+    /** 时间轴未完成节点的图标。 */
     pendingDot?: ReactNode;
+    /**
+     * 反转节点顺序
+     * @defaultValue false
+     */
     reverse?: boolean;
 }
+/** 时间轴组件。 */
 declare function Timeline({ items, mode, pending, pendingDot, reverse, className, ...props }: TimelineProps): react.JSX.Element;
+/** 树节点的唯一标识类型。 */
 type TreeKey = string | number;
+/** 拖放目标相对于节点的位置。 */
 type TreeDropPosition = "before" | "inside" | "after";
+/** 树组件的数据节点，支持子节点、勾选、禁用和异步加载。 */
 interface TreeNode {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: TreeKey;
+    /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
+    /** 输入框前缀 */
     prefix?: ReactNode;
+    /** 主体之外的补充内容或操作区。 */
     extra?: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 是否仅禁用该节点的勾选框。 */
     disableCheckbox?: boolean;
+    /** 是否允许选中项目。 */
     selectable?: boolean;
+    /** 是否显示勾选框或允许勾选。 */
     checkable?: boolean;
+    /** 是否为叶子节点；异步加载场景可用于标识无子项节点。 */
     isLeaf?: boolean;
+    /** 子节点是否已经加载完成。 */
     loaded?: boolean;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 加载过程中的提示内容。 */
     loadingText?: ReactNode;
+    /** 是否允许拖拽。 */
     draggable?: boolean;
+    /** 是否允许作为拖放目标。 */
     droppable?: boolean;
+    /** 右键菜单配置或按当前项目生成菜单的函数。 */
     contextMenu?: DropdownMenuProps;
+    /** 右键菜单弹层的 CSS 类名。 */
     contextMenuPopupClassName?: string;
+    /** 行节点的附加属性，也可按行生成属性。 */
     rowProps?: Omit<HTMLAttributes<HTMLDivElement>, "children"> & Partial<Record<`data-${string}`, string | number>>;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly TreeNode[];
     [key: string]: unknown;
 }
+/** 树的属性配置。 */
 interface TreeProps extends Omit<HTMLAttributes<HTMLDivElement>, "onSelect" | "onDrop"> {
+    /** 树形节点数据 */
     treeData: readonly TreeNode[];
+    /** 当前选中项目的标识集合；传入后由外部控制。 */
     selectedKeys?: readonly TreeKey[];
+    /**
+     * 非受控模式下初始选中的项目标识集合。
+     * @defaultValue []
+     */
     defaultSelectedKeys?: readonly TreeKey[];
+    /** 受控的展开节点标识集合。 */
     expandedKeys?: readonly TreeKey[];
+    /**
+     * 初始化时展开的节点标识集合。
+     * @defaultValue []
+     */
     defaultExpandedKeys?: readonly TreeKey[];
+    /**
+     * 是否在初始化时展开所有节点。
+     * @defaultValue false
+     */
     defaultExpandAll?: boolean;
+    /** 受控的勾选节点标识集合。 */
     checkedKeys?: readonly TreeKey[];
+    /**
+     * 非受控模式下初始勾选的节点标识。
+     * @defaultValue []
+     */
     defaultCheckedKeys?: readonly TreeKey[];
+    /**
+     * 由外部控制正在异步加载的节点
+     * @defaultValue []
+     */
     loadingKeys?: readonly TreeKey[];
+    /**
+     * 是否显示勾选框或允许勾选。
+     * @defaultValue false
+     */
     checkable?: boolean;
+    /**
+     * 父子节点勾选状态是否相互独立。
+     * @defaultValue false
+     */
     checkStrictly?: boolean;
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /**
+     * 是否允许选中项目。
+     * @defaultValue true
+     */
     selectable?: boolean;
+    /**
+     * 是否显示连接线。
+     * @defaultValue false
+     */
     showLine?: boolean;
+    /**
+     * 是否显示状态图标。
+     * @defaultValue false
+     */
     showIcon?: boolean;
+    /**
+     * 节点是否占满整行宽度。
+     * @defaultValue false
+     */
     blockNode?: boolean;
+    /**
+     * 每级节点的缩进距离，单位为像素。
+     * @defaultValue 20
+     */
     indentSize?: number;
+    /**
+     * 展开开关预留宽度，单位为像素。
+     * @defaultValue 24
+     */
     switcherWidth?: number;
+    /**
+     * 滚动时是否固定显示当前节点的祖先行。
+     * @defaultValue false
+     */
     stickyAncestors?: boolean;
+    /**
+     * 固定祖先行的高度，单位为像素。
+     * @defaultValue 34
+     */
     stickyRowHeight?: number;
+    /**
+     * 是否允许拖拽。
+     * @defaultValue false
+     */
     draggable?: boolean;
+    /** 按当前节点异步加载子节点的函数。 */
     loadData?: (node: TreeNode) => void | Promise<void>;
+    /** 选中项目时调用，参数包含选中项目及关联状态。 */
     onSelect?: (keys: TreeKey[], info: {
+        /** 是否处于选中状态。 */
         selected: boolean;
+        /** 当前操作关联的节点数据。 */
         node: TreeNode;
+        /** 触发本次操作的原生事件。 */
         nativeEvent: React.MouseEvent;
     }) => void;
+    /** 勾选状态变化时调用。 */
     onCheck?: (keys: TreeKey[], info: {
+        /** 当前是否勾选；作为受控属性时通过回调更新。 */
         checked: boolean;
+        /** 当前操作关联的节点数据。 */
         node: TreeNode;
     }) => void;
+    /** 节点展开或收起时调用。 */
     onExpand?: (keys: TreeKey[], info: {
+        /** 是否处于展开状态。 */
         expanded: boolean;
+        /** 当前操作关联的节点数据。 */
         node: TreeNode;
     }) => void;
+    /** 拖放完成时调用，提供拖拽源和目标位置。 */
     onDrop?: (info: {
+        /** 正在拖拽的源节点。 */
         dragNode: TreeNode;
+        /** 当前操作关联的节点数据。 */
         node: TreeNode;
+        /** 相对于目标节点的落点位置。 */
         dropPosition: TreeDropPosition;
     }) => void;
 }
+/** 树组件。 */
 declare function Tree({ treeData, selectedKeys, defaultSelectedKeys, expandedKeys, defaultExpandedKeys, defaultExpandAll, checkedKeys, defaultCheckedKeys, loadingKeys, checkable, checkStrictly, multiple, selectable, showLine, showIcon, blockNode, indentSize, switcherWidth, stickyAncestors, stickyRowHeight, draggable, loadData, onSelect, onCheck, onExpand, onDrop, className, ...props }: TreeProps): react.JSX.Element;
 
+/** 气泡确认的属性配置。 */
 interface PopconfirmProps {
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children: ReactElement;
+    /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /**
+     * 确定按钮文案。
+     * @defaultValue "确定"
+     */
     okText?: ReactNode;
+    /**
+     * 取消按钮文案。
+     * @defaultValue "取消"
+     */
     cancelText?: ReactNode;
+    /** 确定按钮的 Button 属性。 */
     okButtonProps?: React.ComponentProps<typeof Button>;
+    /** 取消按钮的 Button 属性。 */
     cancelButtonProps?: React.ComponentProps<typeof Button>;
+    /**
+     * 相对于触发元素的弹出方向和对齐位置。
+     * @defaultValue "top"
+     */
     placement?: FloatingPlacement;
+    /**
+     * 触发显示的交互方式。
+     * @defaultValue "click"
+     */
     trigger?: "click" | "hover" | "focus";
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /**
+     * 非受控模式下的初始打开状态。
+     * @defaultValue false
+     */
     defaultOpen?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 是否显示取消按钮。
+     * @defaultValue true
+     */
     showCancel?: boolean;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 用户确认时调用；支持异步返回值，具体签名见类型。 */
     onConfirm?: (event?: React.MouseEvent) => void | boolean | Promise<void | boolean>;
+    /** 用户取消或通过关闭入口退出时调用。 */
     onCancel?: (event?: React.MouseEvent) => void;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
+/** 气泡确认组件。 */
 declare function Popconfirm({ children, title, description, okText, cancelText, okButtonProps, cancelButtonProps, placement, trigger, open, defaultOpen, disabled, showCancel, icon, onConfirm, onCancel, onOpenChange, }: PopconfirmProps): react.JSX.Element;
+/** 进度的状态类型。 */
 type ProgressStatus = "normal" | "active" | "success" | "exception";
+/** 进度的属性配置。 */
 interface ProgressProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * 进度百分比。
+     * @defaultValue 0
+     */
     percent?: number;
+    /**
+     * 类型标识，用于选择对应的表现形式。
+     * @defaultValue "line"
+     */
     type?: "line" | "circle" | "dashboard";
+    /** 当前状态，用于选择对应的状态样式。 */
     status?: ProgressStatus;
+    /**
+     * 是否显示进度文本。
+     * @defaultValue true
+     */
     showInfo?: boolean;
+    /** 显示格式或格式化函数。 */
     format?: (percent?: number, successPercent?: number) => ReactNode;
+    /** 描边或进度条颜色。 */
     strokeColor?: string | {
+        /** 范围、渐变或转换的起始值。 */
         from: string;
+        /** 范围、渐变或转换的结束值。 */
         to: string;
     };
+    /** 未完成部分的轨道颜色。 */
     trailColor?: string;
+    /**
+     * 描边或进度轨道粗细。
+     * @defaultValue 8
+     */
     strokeWidth?: number;
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 120
+     */
     width?: number;
+    /** 步骤集合或进度分段配置。 */
     steps?: number;
+    /** 成功进度部分的配置。 */
     success?: {
+        /**
+         * 进度百分比。
+         * @defaultValue 0
+         */
         percent?: number;
+        /** 描边或进度条颜色。 */
         strokeColor?: string;
     };
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "default"
+     */
     size?: "small" | "default" | number | readonly [number, number];
 }
+/** 进度组件。 */
 declare function Progress({ percent, type, status, showInfo, format, strokeColor, trailColor, strokeWidth, width, steps, success, size, className, style, ...props }: ProgressProps): react.JSX.Element;
+/** 加载指示器的属性配置。 */
 interface SpinProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * 是否显示加载指示器。
+     * @defaultValue true
+     */
     spinning?: boolean;
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "default"
+     */
     size?: "small" | "default" | "large";
+    /** 加载说明文本 */
     tip?: ReactNode;
+    /** 自定义加载指示器。 */
     indicator?: ReactNode;
+    /**
+     * 显示加载状态前的延迟时间。
+     * @defaultValue 0
+     */
     delay?: number;
+    /**
+     是否以全屏形式展示。
+     * @defaultValue false
+     */
     fullscreen?: boolean;
 }
+/** 加载指示器组件。 */
 declare function Spin({ spinning, size, tip, indicator, delay, fullscreen, className, children, ...props }: SpinProps): react.JSX.Element | null;
+/** 水印文字的字体、颜色和对齐配置。 */
 interface WatermarkFont {
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 文字大小，单位为像素。 */
     fontSize?: number;
+    /** 文字粗细，可使用数字或 CSS 字重名称。 */
     fontWeight?: number | string;
+    /** 字体族名称。 */
     fontFamily?: string;
+    /** 字体样式，例如 normal 或 italic。 */
     fontStyle?: string;
+    /** 文本的水平对齐方式。 */
     textAlign?: CanvasTextAlign;
 }
+/** 水印的属性配置。 */
 interface WatermarkProps extends Omit<HTMLAttributes<HTMLDivElement>, "content"> {
+    /**
+     需要显示的内容，支持文本或 React 节点。
+     * @defaultValue "Sia Web UI"
+     */
     content?: string | readonly string[];
+    /** 图片资源配置。 */
     image?: string;
+    /**
+     * 宽度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 120
+     */
     width?: number;
+    /**
+     * 高度；数值按像素处理，字符串可使用 CSS 尺寸。
+     * @defaultValue 64
+     */
     height?: number;
+    /**
+     * 旋转角度。
+     * @defaultValue -22
+     */
     rotate?: number;
+    /**
+     组件或浮层的堆叠层级。
+     * @defaultValue 9
+     */
     zIndex?: number;
+    /**
+     * 预设或自定义间距
+     * @defaultValue [100, 100]
+     */
     gap?: readonly [number, number];
+    /**
+     * 相对于默认位置的偏移。
+     * @defaultValue [0, 0]
+     */
     offset?: readonly [number, number];
+    /** 颜色、字号、字重与字体 */
     font?: WatermarkFont;
 }
+/** 水印组件。 */
 declare function Watermark({ content, image, width, height, rotate, zIndex, gap, offset, font, className, children, ...props }: WatermarkProps): react.JSX.Element;
+/** Notification的类型标识。 */
 type NotificationType = "info" | "success" | "warning" | "error";
+/** Notification的位置类型。 */
 type NotificationPlacement = "topLeft" | "topRight" | "bottomLeft" | "bottomRight";
+/** Notification的配置。 */
 interface NotificationConfig {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key?: string | number;
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: NotificationType;
+    /** 提示或错误消息文本。 */
     message: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 自动关闭延迟，单位为秒；0 表示不自动关闭。 */
     duration?: number;
+    /** 相对于触发元素的弹出方向和对齐位置。 */
     placement?: NotificationPlacement;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 消息或通知的自定义操作按钮。 */
     btn?: ReactNode;
+    /** 自定义关闭图标。 */
     closeIcon?: ReactNode;
+    /** 元素的无障碍语义角色。 */
     role?: string;
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: () => void;
+    /** 请求关闭时触发的回调。 */
     onClose?: () => void;
 }
 declare function openNotification(config: NotificationConfig): {
+    /** 通知唯一标识，可传给 notification.destroy 关闭指定通知。 */
     key: string | number;
+    /** 关闭本条通知。 */
     close: () => void;
 };
+/** 全局通知 API，支持标题、说明、自定义操作和关闭管理。 */
 declare const notification: {
+    /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
     open: typeof openNotification;
+    /** 显示普通信息提示。 */
     info: (config: Omit<NotificationConfig, "type">) => {
+        /** 通知唯一标识，可传给 notification.destroy 关闭指定通知。 */
         key: string | number;
+        /** 关闭本条通知。 */
         close: () => void;
     };
+    /** 显示成功提示。 */
     success: (config: Omit<NotificationConfig, "type">) => {
+        /** 通知唯一标识，可传给 notification.destroy 关闭指定通知。 */
         key: string | number;
+        /** 关闭本条通知。 */
         close: () => void;
     };
+    /** 显示警告提示。 */
     warning: (config: Omit<NotificationConfig, "type">) => {
+        /** 通知唯一标识，可传给 notification.destroy 关闭指定通知。 */
         key: string | number;
+        /** 关闭本条通知。 */
         close: () => void;
     };
+    /** 显示错误提示。 */
     error: (config: Omit<NotificationConfig, "type">) => {
+        /** 通知唯一标识，可传给 notification.destroy 关闭指定通知。 */
         key: string | number;
+        /** 关闭本条通知。 */
         close: () => void;
     };
+    /** 关闭指定实例；未指定标识时关闭所有实例。 */
     destroy: (key?: string | number) => void;
 };
+/** 操作引导的一步，定义目标元素、说明及操作按钮。 */
 interface TourStep {
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 顶部封面内容。 */
     cover?: ReactNode;
+    /** 关联的目标元素或获取目标元素的函数。 */
     target?: HTMLElement | null | (() => HTMLElement | null);
+    /** 相对于触发元素的弹出方向和对齐位置。 */
     placement?: FloatingPlacement | "center";
+    /** 下一步按钮的属性。 */
     nextButtonProps?: React.ComponentProps<typeof Button> & {
+        /** 子内容；组件嵌套内容或当前节点的子项。 */
         children?: ReactNode;
     };
+    /** 上一步按钮的属性。 */
     prevButtonProps?: React.ComponentProps<typeof Button> & {
+        /** 子内容；组件嵌套内容或当前节点的子项。 */
         children?: ReactNode;
     };
 }
+/** 操作引导的属性配置。 */
 interface TourProps {
+    /**
+     * 是否打开；传入后由外部控制显示状态。
+     * @defaultValue false
+     */
     open?: boolean;
+    /** 步骤集合或进度分段配置。 */
     steps: readonly TourStep[];
+    /** 当前引导步骤索引，从 0 开始。 */
     current?: number;
+    /**
+     * 非受控模式的初始页码或步骤位置。
+     * @defaultValue 0
+     */
     defaultCurrent?: number;
+    /**
+     * 遮罩是否显示或自定义遮罩内容。
+     * @defaultValue true
+     */
     mask?: boolean;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue true
+     */
     closable?: boolean;
+    /**
+     * 加载期间是否阻止与内容交互。
+     * @defaultValue false
+     */
     disabledInteraction?: boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (current: number) => void;
+    /** 请求关闭时触发的回调。 */
     onClose?: (current: number) => void;
+    /** 流程完成或表单校验通过并提交时调用。 */
     onFinish?: () => void;
 }
+/** 操作引导组件。 */
 declare function Tour({ open, steps, current, defaultCurrent, mask, closable, disabledInteraction, onChange, onClose, onFinish }: TourProps): react.ReactPortal | null;
 
+/** 评分的属性配置。 */
 interface RateProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: number;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue 0
+     */
     defaultValue?: number;
+    /**
+     * 徽标展示的数量。
+     * @defaultValue 5
+     */
     count?: number;
+    /**
+     * 是否允许选择半星。
+     * @defaultValue false
+     */
     allowHalf?: boolean;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue true
+     */
     allowClear?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 自定义评分符号。 */
     character?: ReactNode | ((index: number) => ReactNode);
+    /** 各评分值对应的提示内容。 */
     tooltips?: readonly string[];
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: number) => void;
+    /** 悬停目标或悬停值变化时调用。 */
     onHoverChange?: (value: number) => void;
 }
+/** 评分组件。 */
 declare function Rate({ value, size: sizeProp, defaultValue, count, allowHalf, allowClear, disabled, character, tooltips, onChange, onHoverChange, className, ...props }: RateProps): react.JSX.Element;
+/** 徽标的状态类型。 */
 type BadgeStatus = "success" | "processing" | "default" | "error" | "warning";
+/** 徽标的属性配置。 */
 interface BadgeProps extends HTMLAttributes<HTMLSpanElement> {
+    /** 徽标展示的数量。 */
     count?: ReactNode;
+    /**
+     * 数量为 0 时是否仍显示徽标。
+     * @defaultValue false
+     */
     showZero?: boolean;
+    /**
+     * 徽标显示的最大数字，超出后显示加号。
+     * @defaultValue 99
+     */
     overflowCount?: number;
+    /**
+     * 是否以圆点形式显示状态或徽标。
+     * @defaultValue false
+     */
     dot?: boolean;
+    /** 当前状态，用于选择对应的状态样式。 */
     status?: BadgeStatus;
+    /** 显示文本。 */
     text?: ReactNode;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /**
+     * 相对于默认位置的偏移。
+     * @defaultValue [0, 0]
+     */
     offset?: readonly [number, number];
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "default"
+     */
     size?: "default" | "small";
 }
+/** BadgeRibbon的属性配置。 */
 interface BadgeRibbonProps extends HTMLAttributes<HTMLDivElement> {
+    /** 显示文本。 */
     text?: ReactNode;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /**
+     * 相对于触发元素的弹出方向和对齐位置。
+     * @defaultValue "end"
+     */
     placement?: "start" | "end";
 }
 declare function BadgeRibbon({ text, color, placement, className, children, ...props }: BadgeRibbonProps): react.JSX.Element;
+/** 徽标组件。 */
 declare function Badge({ count, showZero, overflowCount, dot, status, text, color, offset, size, className, children, style, ...props }: BadgeProps): react.JSX.Element;
 declare namespace Badge {
     var Ribbon: typeof BadgeRibbon;
 }
+/** 日历的属性配置。 */
 interface CalendarProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "onSelect"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: string;
+    /**
+     * 展示或交互模式；可选值见类型定义。
+     * @defaultValue "month"
+     */
     mode?: "month" | "year";
+    /**
+     是否以全屏形式展示。
+     * @defaultValue true
+     */
     fullscreen?: boolean;
+    /** 允许选择的日期范围。 */
     validRange?: readonly [string, string];
+    /** 判断某个日期是否不可选的函数。 */
     disabledDate?: (date: string) => boolean;
+    /** 自定义日期单元格的附加内容。 */
     dateCellRender?: (date: string) => ReactNode;
+    /** 完整替换日期单元格的渲染函数。 */
     fullCellRender?: (date: string, info: {
+        /** 组件默认生成的原始节点，可用于包装或复用。 */
         originNode: ReactNode;
+        /** 类型标识，用于选择对应的表现形式。 */
         type: "date";
     }) => ReactNode;
+    /** 自定义头部渲染。 */
     headerRender?: (config: {
+        /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
         value: string;
+        /**
+         * 展示或交互模式；可选值见类型定义。
+         * @defaultValue "month"
+         */
         mode: "month" | "year";
+        /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
         onChange: (value: string) => void;
+        /** 显示类型变化时调用。 */
         onTypeChange: (mode: "month" | "year") => void;
     }) => ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (date: string) => void;
+    /** 选中项目时调用，参数包含选中项目及关联状态。 */
     onSelect?: (date: string) => void;
+    /** 面板显示的日期或模式变化时调用。 */
     onPanelChange?: (date: string, mode: "month" | "year") => void;
 }
+/** 日历组件。 */
 declare function Calendar({ value, defaultValue, mode, fullscreen, validRange, disabledDate, dateCellRender, fullCellRender, headerRender, onChange, onSelect, onPanelChange, className, ...props }: CalendarProps): react.JSX.Element;
+/** 轮播的实例引用接口。 */
 interface CarouselRef {
+    /** 跳转到指定索引的轮播项。 */
     goTo: (slide: number) => void;
+    /** 切换到下一项。 */
     next: () => void;
+    /** 切换到上一项。 */
     prev: () => void;
 }
+/** 轮播的属性配置。 */
 interface CarouselProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * 是否自动轮播。
+     * @defaultValue false
+     */
     autoplay?: boolean | {
+        /** 轮播指示点的动画持续时间。 */
         dotDuration?: boolean;
     };
+    /**
+     * 自动轮播的切换间隔。
+     * @defaultValue 3000
+     */
     autoplaySpeed?: number;
+    /**
+     * 是否显示前后切换箭头。
+     * @defaultValue false
+     */
     arrows?: boolean;
+    /**
+     * 是否显示轮播指示点。
+     * @defaultValue true
+     */
     dots?: boolean | {
+        /**
+         * 附加到组件根节点的 CSS 类名。
+         * @defaultValue ""
+         */
         className?: string;
     };
+    /**
+     * 滚动或淡入效果
+     * @defaultValue "scroll"
+     */
     effect?: "scroll" | "fade";
+    /**
+     * 是否允许首尾循环切换。
+     * @defaultValue true
+     */
     infinite?: boolean;
+    /**
+     * 轮播初始化时显示的项索引。
+     * @defaultValue 0
+     */
     initialSlide?: number;
+    /**
+     * 鼠标悬停时是否暂停自动轮播。
+     * @defaultValue true
+     */
     pauseOnHover?: boolean;
+    /** 轮播切换前调用，接收当前项和目标项索引。 */
     beforeChange?: (current: number, next: number) => void;
+    /** 轮播切换后调用，接收当前项索引。 */
     afterChange?: (current: number) => void;
 }
+/** 轮播组件。 */
 declare function Carousel({ autoplay, autoplaySpeed, arrows, dots, effect, infinite, initialSlide, pauseOnHover, beforeChange, afterChange, className, children, ...props }: CarouselProps): react.JSX.Element;
+/** 折叠面板的唯一标识类型。 */
 type CollapseKey = string | number;
+/** 折叠面板的项目定义。 */
 type CollapseItem = {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: CollapseKey;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 主体之外的补充内容或操作区。 */
     extra?: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 允许收起内容区域 */
     collapsible?: "header" | "icon" | "disabled";
+    /** 是否显示展开箭头。 */
     showArrow?: boolean;
+    /** 未展开时是否也渲染内容。 */
     forceRender?: boolean;
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
 };
+/** 折叠面板的属性配置。 */
 interface CollapseProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** 按展示顺序排列的项目配置。 */
     items: readonly CollapseItem[];
+    /** 当前激活项目的标识；传入后由外部控制。 */
     activeKey?: CollapseKey | readonly CollapseKey[];
+    /**
+     * 非受控模式下初始激活的项目标识。
+     * @defaultValue []
+     */
     defaultActiveKey?: CollapseKey | readonly CollapseKey[];
+    /**
+     * 是否启用手风琴模式，同时只展开一个面板。
+     * @defaultValue false
+     */
     accordion?: boolean;
+    /**
+     * 是否显示边框。
+     * @defaultValue true
+     */
     bordered?: boolean;
+    /**
+     * 是否使用透明背景的幽灵样式。
+     * @defaultValue false
+     */
     ghost?: boolean;
+    /**
+     * 收起后销毁内容
+     * @defaultValue false
+     */
     destroyInactivePanel?: boolean;
+    /**
+     * 展开图标的位置。
+     * @defaultValue "start"
+     */
     expandIconPosition?: "start" | "end";
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (key: CollapseKey | CollapseKey[]) => void;
 }
+/** 折叠面板组件。 */
 declare function Collapse({ items, activeKey, defaultActiveKey, accordion, bordered, ghost, destroyInactivePanel, expandIconPosition, onChange, className, ...props }: CollapseProps): react.JSX.Element;
+/** 图片预览的属性配置。 */
 interface ImagePreviewProps {
+    /** 是否打开；传入后由外部控制显示状态。 */
     open: boolean;
+    /** 图片或资源地址。 */
     src?: string;
+    /**
+     * 图片无法显示时的替代文本。
+     * @defaultValue ""
+     */
     alt?: string;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange: (open: boolean) => void;
 }
+/** 图片预览组件。 */
 declare function ImagePreview({ open, src, alt, onOpenChange }: ImagePreviewProps): react.ReactPortal | null;
+/** 图片预览的配置。 */
 interface ImagePreviewConfig {
+    /** 图片或资源地址。 */
     src?: string;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
+    /** 遮罩是否显示或自定义遮罩内容。 */
     mask?: ReactNode;
 }
+/** 图片的属性配置。 */
 interface ImageProps extends ImgHTMLAttributes<HTMLImageElement> {
+    /** 资源加载失败时使用的替代内容或地址。 */
     fallback?: string;
+    /** 未填写或未选择时的提示内容。 */
     placeholder?: ReactNode;
+    /**
+     * 预览开关或配置
+     * @defaultValue true
+     */
     preview?: boolean | ImagePreviewConfig;
+    /**
+     * 最外层容器的附加 CSS 类名。
+     * @defaultValue ""
+     */
     rootClassName?: string;
 }
+/** 图片组件。 */
 declare function Image({ fallback, placeholder, preview, rootClassName, className, src, alt, onError, style, ...props }: ImageProps): react.JSX.Element;
 
+/** 输入框的属性配置。 */
 interface InputProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "prefix" | "size"> {
+    /** 字段标签 */
     label?: ReactNode;
+    /** 帮助或校验信息 */
     hint?: ReactNode;
+    /**
+     * 校验状态
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
+    /** 输入框前缀 */
     prefix?: ReactNode;
+    /** 输入框后缀 */
     suffix?: ReactNode;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue false
+     */
     allowClear?: boolean;
+    /** 清空当前值时调用。 */
     onClear?: () => void;
+    /**
+     * 显示当前字符数
+     * @defaultValue false
+     */
     showCount?: boolean;
+    /** 占位文案的显示模式 */
     placeholderMode?: InputPlaceholderMode;
 }
+/** 输入框组件。 */
 declare const Input: react.ForwardRefExoticComponent<InputProps & react.RefAttributes<HTMLInputElement>>;
 
 declare const LIST_IGNORE: unique symbol;
+/** UploadFile的状态类型。 */
 type UploadFileStatus = "ready" | "uploading" | "done" | "error";
+/** 上传文件的状态记录，包含唯一标识、文件名、原始文件和服务端响应。 */
 interface UploadFile {
+    /** 文件的唯一标识。 */
     uid: string;
+    /** 名称或字段标识。 */
     name: string;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: number;
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: string;
+    /** 当前状态，用于选择对应的状态样式。 */
     status?: UploadFileStatus;
+    /** 进度百分比。 */
     percent?: number;
+    /** 文件或资源的访问地址。 */
     url?: string;
+    /** 上传服务返回的响应数据。 */
     response?: unknown;
+    /** 错误信息或错误对象。 */
     error?: unknown;
+    /** 上传前的原始 File 对象。 */
     originFileObj?: File;
 }
+/** UploadRequest的配置选项。 */
 interface UploadRequestOptions {
+    /** 当前操作涉及的文件。 */
     file: File;
+    /** 文件名。 */
     filename: string;
+    /** 上传进度更新时调用。 */
     onProgress: (percent: number) => void;
+    /** 上传成功时调用，接收响应数据。 */
     onSuccess: (response?: unknown) => void;
+    /** 操作发生错误时调用，可用于显示业务错误提示。 */
     onError: (error: unknown) => void;
 }
+/** 文件上传的变更事件上下文。 */
 interface UploadChangeInfo {
+    /** 当前操作涉及的文件。 */
     file: UploadFile;
+    /** 受控的文件列表。 */
     fileList: readonly UploadFile[];
 }
+/** 文件上传的属性配置。 */
 interface UploadProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 允许的文件类型，格式同原生 input 的 accept。 */
     accept?: string;
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /**
+     * 是否允许选择文件夹。
+     * @defaultValue false
+     */
     directory?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 允许的最大文件数量。 */
     maxCount?: number;
+    /** 受控的文件列表。 */
     fileList?: readonly UploadFile[];
+    /**
+     * 非受控模式下的初始文件列表。
+     * @defaultValue []
+     */
     defaultFileList?: readonly UploadFile[];
+    /**
+     * 上传文件列表的展示形式。
+     * @defaultValue "text"
+     */
     listType?: "text" | "picture" | "picture-card";
+    /**
+     * 是否显示上传文件列表。
+     * @defaultValue true
+     */
     showUploadList?: boolean;
+    /** 上传前校验或转换文件 */
     beforeUpload?: (file: File, fileList: readonly File[]) => boolean | File | typeof LIST_IGNORE | Promise<boolean | File | typeof LIST_IGNORE>;
+    /** 自定义上传实现 */
     customRequest?: (options: UploadRequestOptions) => void | {
+        /** 取消当前上传请求。 */
         abort?: () => void;
     };
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (info: UploadChangeInfo) => void;
+    /** 请求移除文件时调用；返回值控制是否允许移除。 */
     onRemove?: (file: UploadFile) => boolean | Promise<boolean>;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
 }
+/** UploadDragger的属性配置。 */
 interface UploadDraggerProps extends UploadProps {
+    /**
+     * 帮助或校验信息
+     * @defaultValue "支持单个或批量上传"
+     */
     hint?: ReactNode;
 }
 declare function UploadRoot({ accept, multiple, directory, disabled, maxCount, fileList, defaultFileList, listType, showUploadList, beforeUpload, customRequest, onChange, onRemove, children, className, onDragOver, onDrop, ...props }: UploadProps): react.JSX.Element;
 declare function UploadDragger({ hint, children, className, ...props }: UploadDraggerProps): react.JSX.Element;
+/** 文件上传组件。 */
 declare const Upload: typeof UploadRoot & {
+    /** 支持拖入文件上传的区域组件。 */
     Dragger: typeof UploadDragger;
+    /** beforeUpload 返回此标记时忽略该文件，不加入上传列表。 */
     LIST_IGNORE: symbol;
 };
 
+/** 弹层挂载节点或返回挂载节点的函数。 */
 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;
+    /**
+     组件或浮层的堆叠层级。
+     * @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 MessageType = "info" | "success" | "warning" | "error" | "loading";
+/** 全局消息的唯一标识，用于更新或关闭已有消息。 */
 type MessageKey = string | number;
+/** 全局消息的配置。 */
 interface MessageConfig {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key?: MessageKey;
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: MessageType;
+    /** 消息正文，支持文本或 React 节点。 */
     content: ReactNode;
+    /** 自动关闭延迟，单位为秒；0 表示不自动关闭。 */
     duration?: number;
+    /** 是否显示关闭入口。 */
     closable?: boolean;
+    /** 请求关闭时触发的回调。 */
     onClose?: () => void;
 }
+/** 全局消息的操作句柄。 */
 interface MessageHandle {
+    /** 关闭当前界面或实例。 */
     close: () => void;
+    /** 局部更新当前实例配置，未传入的字段保持原值。 */
     update: (next: Partial<MessageConfig>) => void;
 }
 declare function openMessage(input: ReactNode | MessageConfig): MessageHandle;
+/** 全局消息 API，可直接显示成功、错误、警告等短提示，并通过句柄关闭。 */
 declare const message: {
+    /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
     open: typeof openMessage;
+    /** 显示普通信息提示。 */
     info: (content: ReactNode, duration?: number) => MessageHandle;
+    /** 显示成功提示。 */
     success: (content: ReactNode, duration?: number) => MessageHandle;
+    /** 显示警告提示。 */
     warning: (content: ReactNode, duration?: number) => MessageHandle;
+    /** 显示错误提示。 */
     error: (content: ReactNode, duration?: number) => MessageHandle;
+    /** 显示持续加载提示。 */
     loading: (content: ReactNode, duration?: number) => MessageHandle;
+    /** 关闭指定实例；未指定标识时关闭所有实例。 */
     destroy(key?: MessageKey): void;
+    /** 配置消息默认持续时间和最大同时显示数量。 */
     config(config: {
+        /** 默认自动关闭时间，单位为秒；0 表示不自动关闭。 */
         duration?: number;
+        /** 同时显示的最大消息数量。 */
         maxCount?: number;
     }): void;
 };
 
+/** 面包屑的项目定义。 */
 interface BreadcrumbItem {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key?: string;
+    /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 链接目标地址。 */
     href?: string;
+    /** 关联的目标元素或获取目标元素的函数。 */
     target?: string;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: MouseEventHandler<HTMLElement>;
     /** 覆盖当前项后方的分隔符，null 可隐藏分隔符。 */
     separator?: ReactNode;
+    /** 菜单项、选中状态与点击回调 */
     menu?: DropdownMenuProps;
 }
+/** 面包屑的属性配置。 */
 interface BreadcrumbProps extends HTMLAttributes<HTMLElement> {
+    /** 按层级排列的项目，最后一项表示当前页面 */
     items: readonly BreadcrumbItem[];
+    /**
+     * 全局分隔符，可传入图标或文字
+     * @defaultValue "/"
+     */
     separator?: ReactNode;
+    /** 自定义项目内容，可接入路由 Link */
     itemRender?: (item: BreadcrumbItem, index: number, items: readonly BreadcrumbItem[]) => ReactNode;
 }
+/** 面包屑组件。 */
 declare function Breadcrumb({ items, separator, itemRender, className, ...props }: BreadcrumbProps): react.JSX.Element;
 
+/** 排版的类型标识。 */
 type TypographyType = "secondary" | "success" | "warning" | "danger";
+/** 排版的属性配置。 */
 interface TypographyProps extends HTMLAttributes<HTMLElement> {
+    /** 辅助、成功、警告或危险文本 */
     type?: TypographyType;
+    /** 禁用样式及复制、编辑操作 */
     disabled?: boolean;
+    /** 是否显示为加粗文字。 */
     strong?: boolean;
+    /** 是否显示为斜体。 */
     italic?: boolean;
+    /** 是否显示下划线。 */
     underline?: boolean;
+    /** 是否显示删除线。 */
     delete?: boolean;
+    /** 是否使用标记高亮样式。 */
     mark?: boolean;
+    /** 代码内容或按键代码。 */
     code?: boolean;
+    /** 是否允许通过 Esc 等键盘操作关闭。 */
     keyboard?: boolean;
+    /** 复制完整文本，可指定复制内容和成功回调 */
     copyable?: boolean | {
+        /** 显示文本。 */
         text?: string;
+        /** 复制操作触发后的回调。 */
         onCopy?: () => void;
     };
+    /** 纯文本编辑；text 用于受控内容，onChange 在保存时触发 */
     editable?: boolean | {
+        /** 显示文本。 */
         text?: string;
+        /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
         onChange?: (text: string) => void;
+        /** 允许输入的最大字符数 */
         maxLength?: number;
     };
+    /** 是否对超出可用宽度的内容进行省略，或指定省略配置。 */
     ellipsis?: boolean | {
+        /** 默认可见行数 */
         rows?: number;
+        /** 是否允许展开更多内容。 */
         expandable?: boolean;
     };
 }
+/** TypographyTitle的属性配置。 */
 interface TypographyTitleProps extends TypographyProps {
+    /** 标题或节点的层级。 */
     level?: 1 | 2 | 3 | 4 | 5;
 }
+/** TypographyLink的属性配置。 */
 interface TypographyLinkProps extends AnchorHTMLAttributes<HTMLAnchorElement> {
+    /** 是否禁用交互。 */
     disabled?: boolean;
 }
 declare function Title({ level, ...props }: TypographyTitleProps): react.JSX.Element;
@@ -1040,44 +2185,103 @@ declare function Text(props: TypographyProps): react.JSX.Element;
 declare function Paragraph(props: TypographyProps): react.JSX.Element;
 declare function Link({ disabled, className, onClick, href, target, rel, ...props }: TypographyLinkProps): react.JSX.Element;
 declare function TypographyRoot({ className, ...props }: HTMLAttributes<HTMLDivElement>): react.JSX.Element;
+/** 排版组件。 */
 declare const Typography: typeof TypographyRoot & {
+    /** 语义化标题，支持标题级别、复制和编辑。 */
     Title: typeof Title;
+    /** 行内文本，支持强调、复制、编辑和省略。 */
     Text: typeof Text;
+    /** 段落文本，支持复制、编辑和省略。 */
     Paragraph: typeof Paragraph;
+    /** 具有排版样式的链接。 */
     Link: typeof Link;
 };
 
+/** 浮动按钮的外形。 */
 type FloatButtonShape = "circle" | "square";
+/** 浮动按钮的属性配置。 */
 interface FloatButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "type" | "content"> {
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 浮动按钮的提示内容。 */
     tooltip?: ReactNode;
+    /**
+     * 类型标识，用于选择对应的表现形式。
+     * @defaultValue "default"
+     */
     type?: "default" | "primary";
+    /**
+     * 外观形状。
+     * @defaultValue "circle"
+     */
     shape?: FloatButtonShape;
+    /** 数字、红点和溢出计数配置 */
     badge?: Pick<BadgeProps, "count" | "dot" | "overflowCount" | "showZero" | "color">;
+    /**
+     * 原生按钮类型，例如 button、submit 或 reset。
+     * @defaultValue "button"
+     */
     htmlType?: "button" | "submit" | "reset";
 }
+/** FloatButtonGroup的属性配置。 */
 interface FloatButtonGroupProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /**
+     * 外观形状。
+     * @defaultValue "circle"
+     */
     shape?: FloatButtonShape;
+    /**
+     * 类型标识，用于选择对应的表现形式。
+     * @defaultValue "default"
+     */
     type?: "default" | "primary";
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 自定义关闭图标。 */
     closeIcon?: ReactNode;
+    /** 提示内容或提示框配置。 */
     tooltip?: ReactNode;
+    /** 触发显示的交互方式。 */
     trigger?: "click" | "hover";
+    /**
+     * 相对于触发元素的弹出方向和对齐位置。
+     * @defaultValue "top"
+     */
     placement?: "top" | "bottom" | "left" | "right";
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /**
+     * 非受控模式下的初始打开状态。
+     * @defaultValue false
+     */
     defaultOpen?: boolean;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
 declare function FloatButtonGroup({ shape, type, icon, closeIcon, tooltip, trigger, placement, open, defaultOpen, onOpenChange, children, className, onMouseEnter, onMouseLeave, onKeyDown, onBlur, ...props }: FloatButtonGroupProps): react.JSX.Element;
+/** FloatButtonBackTop的属性配置。 */
 interface FloatButtonBackTopProps extends FloatButtonProps {
+    /** 关联的目标元素或获取目标元素的函数。 */
     target?: () => HTMLElement | Window | null;
+    /**
+     * 滚动距离超过此值时显示返回顶部按钮。
+     * @defaultValue 400
+     */
     visibilityHeight?: number;
+    /**
+     * 滚动行为，smooth 表示平滑滚动。
+     * @defaultValue "smooth"
+     */
     behavior?: ScrollBehavior;
 }
 declare function FloatButtonBackTop({ target, visibilityHeight, behavior, onClick, icon, tooltip, ...props }: FloatButtonBackTopProps): react.JSX.Element | null;
+/** 浮动按钮组件。 */
 declare const FloatButton: react.ForwardRefExoticComponent<FloatButtonProps & react.RefAttributes<HTMLButtonElement>> & {
+    /** 组合多个子项并统一管理布局或选择状态。 */
     Group: typeof FloatButtonGroup;
+    /** 滚动超过指定距离后显示的返回顶部按钮。 */
     BackTop: typeof FloatButtonBackTop;
 };