@sia.soul/sia-react-ui 0.1.18 → 0.1.21

package/dist/core-DeZknKwc.d.ts

@@ -0,0 +1,2288 @@
+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-Bx4B28Wh.js';
+import './Select-BNSE67xn.js';
+
+/** 按钮视觉样式，可选择主按钮、默认按钮、文本按钮或链接等形式。 */
+type ButtonVariant = "primary" | "default" | "dashed" | "filled" | "text" | "link";
+/** 按钮尺寸等级。 */
+type ButtonSize = ControlSize;
+/** 按钮的属性配置。 */
+interface ButtonProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     组件的视觉样式。
+     * @defaultValue "default"
+     */
+    variant?: ButtonVariant;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
+    size?: ButtonSize;
+    /**
+     * 显示加载状态并禁止重复点击
+     * @defaultValue false
+     */
+    loading?: boolean;
+    /**
+     * 宽度撑满父容器
+     * @defaultValue false
+     */
+    block?: boolean;
+    /**
+     * 危险操作样式
+     * @defaultValue false
+     */
+    danger?: boolean;
+    /** 按钮图标 */
+    icon?: ReactNode;
+    /**
+     * 图标位置
+     * @defaultValue "start"
+     */
+    iconPosition?: "start" | "end";
+}
+/** 按钮组件。 */
+declare const Button: react.ForwardRefExoticComponent<ButtonProps & react.RefAttributes<HTMLButtonElement>>;
+
+/** 卡片强调装饰的显示方式。 */
+type 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: {
+    "notepad-file": react.JSX.Element;
+    "notepad-folder": react.JSX.Element;
+    "notepad-virtual-folder": react.JSX.Element;
+    "step-backward": react.JSX.Element;
+    "step-forward": react.JSX.Element;
+    "fast-backward": react.JSX.Element;
+    "fast-forward": react.JSX.Element;
+    "corner-up-left": react.JSX.Element;
+    "corner-up-right": react.JSX.Element;
+    "swap-horizontal": react.JSX.Element;
+    "swap-vertical": react.JSX.Element;
+    expand: react.JSX.Element;
+    shrink: react.JSX.Element;
+    fullscreen: react.JSX.Element;
+    "fullscreen-exit": react.JSX.Element;
+    "menu-fold": react.JSX.Element;
+    "menu-unfold": react.JSX.Element;
+    login: react.JSX.Element;
+    logout: react.JSX.Element;
+    move: react.JSX.Element;
+    "vertical-align-top": react.JSX.Element;
+    "vertical-align-middle": react.JSX.Element;
+    "vertical-align-bottom": react.JSX.Element;
+    "square-plus": react.JSX.Element;
+    "square-minus": react.JSX.Element;
+    "square-check": react.JSX.Element;
+    "square-close": react.JSX.Element;
+    "tab-plus": react.JSX.Element;
+    "folder-plus": react.JSX.Element;
+    pin: react.JSX.Element;
+    "pin-off": react.JSX.Element;
+    stop: react.JSX.Element;
+    "help-circle": react.JSX.Element;
+    save: react.JSX.Element;
+    clipboard: react.JSX.Element;
+    "clipboard-check": react.JSX.Element;
+    "file-plus": react.JSX.Element;
+    "file-check": react.JSX.Element;
+    "file-warning": react.JSX.Element;
+    "file-spreadsheet": react.JSX.Element;
+    "align-left": react.JSX.Element;
+    "align-center": react.JSX.Element;
+    "align-right": react.JSX.Element;
+    "align-justify": react.JSX.Element;
+    bold: react.JSX.Element;
+    italic: react.JSX.Element;
+    underline: react.JSX.Element;
+    strikethrough: react.JSX.Element;
+    "list-ordered": react.JSX.Element;
+    "list-unordered": react.JSX.Element;
+    eraser: react.JSX.Element;
+    highlighter: react.JSX.Element;
+    table: react.JSX.Element;
+    columns: react.JSX.Element;
+    rows: react.JSX.Element;
+    "bar-chart": react.JSX.Element;
+    "line-chart": react.JSX.Element;
+    "pie-chart": react.JSX.Element;
+    "area-chart": react.JSX.Element;
+    activity: react.JSX.Element;
+    "trending-up": react.JSX.Element;
+    "trending-down": react.JSX.Element;
+    database: react.JSX.Element;
+    cloud: react.JSX.Element;
+    "cloud-download": react.JSX.Element;
+    "cloud-upload": react.JSX.Element;
+    server: react.JSX.Element;
+    desktop: react.JSX.Element;
+    laptop: react.JSX.Element;
+    mobile: react.JSX.Element;
+    tablet: react.JSX.Element;
+    printer: react.JSX.Element;
+    camera: react.JSX.Element;
+    video: react.JSX.Element;
+    microphone: react.JSX.Element;
+    "volume-up": react.JSX.Element;
+    "volume-off": react.JSX.Element;
+    "speaker-wave": react.JSX.Element;
+    "speaker-muted": react.JSX.Element;
+    wifi: react.JSX.Element;
+    power: react.JSX.Element;
+    key: react.JSX.Element;
+    shield: react.JSX.Element;
+    "shield-check": react.JSX.Element;
+    bug: react.JSX.Element;
+    bulb: react.JSX.Element;
+    rocket: react.JSX.Element;
+    target: react.JSX.Element;
+    trophy: react.JSX.Element;
+    "shopping-cart": react.JSX.Element;
+    "shopping-bag": react.JSX.Element;
+    shop: react.JSX.Element;
+    wallet: react.JSX.Element;
+    bank: react.JSX.Element;
+    calculator: react.JSX.Element;
+    tag: react.JSX.Element;
+    tags: react.JSX.Element;
+    message: react.JSX.Element;
+    comments: react.JSX.Element;
+    send: react.JSX.Element;
+    share: react.JSX.Element;
+    paperclip: react.JSX.Element;
+    location: react.JSX.Element;
+    compass: react.JSX.Element;
+    car: react.JSX.Element;
+    truck: react.JSX.Element;
+    gift: react.JSX.Element;
+    coffee: react.JSX.Element;
+    experiment: react.JSX.Element;
+    tool: react.JSX.Element;
+    appstore: react.JSX.Element;
+    puzzle: react.JSX.Element;
+    partition: react.JSX.Element;
+    branches: react.JSX.Element;
+    scan: react.JSX.Element;
+    "qr-code": react.JSX.Element;
+    barcode: react.JSX.Element;
+    "user-plus": react.JSX.Element;
+    "user-minus": react.JSX.Element;
+    smile: react.JSX.Element;
+    meh: react.JSX.Element;
+    frown: react.JSX.Element;
+    "game-cultivator": react.JSX.Element;
+    "game-swordsman": react.JSX.Element;
+    "game-spirit-wolf": react.JSX.Element;
+    "game-gem": react.JSX.Element;
+    "game-ingot": react.JSX.Element;
+    "game-sword": react.JSX.Element;
+    "game-robe": react.JSX.Element;
+    "game-pants": react.JSX.Element;
+    "game-pendant": react.JSX.Element;
+    "game-necklace": react.JSX.Element;
+    "game-pill": react.JSX.Element;
+    "game-potion": react.JSX.Element;
+    "game-elixir-jar": react.JSX.Element;
+    "game-flame": react.JSX.Element;
+    "game-soul-elixir": react.JSX.Element;
+    "game-herb": react.JSX.Element;
+    "game-meditate": react.JSX.Element;
+    "game-backpack": react.JSX.Element;
+    "game-qi": react.JSX.Element;
+    search: react.JSX.Element;
+    plus: react.JSX.Element;
+    minus: react.JSX.Element;
+    close: react.JSX.Element;
+    check: react.JSX.Element;
+    info: react.JSX.Element;
+    question: react.JSX.Element;
+    warning: react.JSX.Element;
+    "circle-check": react.JSX.Element;
+    "circle-close": react.JSX.Element;
+    "circle-plus": react.JSX.Element;
+    "circle-minus": react.JSX.Element;
+    "chevron-left": react.JSX.Element;
+    "chevron-right": react.JSX.Element;
+    "chevron-up": react.JSX.Element;
+    "chevron-down": react.JSX.Element;
+    "double-left": react.JSX.Element;
+    "double-right": react.JSX.Element;
+    "arrow-left": react.JSX.Element;
+    "arrow-right": react.JSX.Element;
+    "arrow-up": react.JSX.Element;
+    "arrow-down": react.JSX.Element;
+    menu: react.JSX.Element;
+    "more-horizontal": react.JSX.Element;
+    "more-vertical": react.JSX.Element;
+    home: react.JSX.Element;
+    user: react.JSX.Element;
+    users: react.JSX.Element;
+    settings: react.JSX.Element;
+    edit: react.JSX.Element;
+    copy: react.JSX.Element;
+    trash: react.JSX.Element;
+    scissors: react.JSX.Element;
+    undo: react.JSX.Element;
+    redo: react.JSX.Element;
+    "zoom-in": react.JSX.Element;
+    "zoom-out": react.JSX.Element;
+    download: react.JSX.Element;
+    upload: react.JSX.Element;
+    refresh: react.JSX.Element;
+    loader: react.JSX.Element;
+    calendar: react.JSX.Element;
+    clock: react.JSX.Element;
+    mail: react.JSX.Element;
+    phone: react.JSX.Element;
+    link: react.JSX.Element;
+    "external-link": react.JSX.Element;
+    eye: react.JSX.Element;
+    "eye-off": react.JSX.Element;
+    lock: react.JSX.Element;
+    unlock: react.JSX.Element;
+    bell: react.JSX.Element;
+    star: react.JSX.Element;
+    heart: react.JSX.Element;
+    file: react.JSX.Element;
+    folder: react.JSX.Element;
+    image: react.JSX.Element;
+    filter: react.JSX.Element;
+    "sort-ascending": react.JSX.Element;
+    "sort-descending": react.JSX.Element;
+    play: react.JSX.Element;
+    pause: react.JSX.Element;
+    book: react.JSX.Element;
+    component: react.JSX.Element;
+    token: react.JSX.Element;
+    sun: react.JSX.Element;
+    moon: react.JSX.Element;
+    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;
+    question: react.JSX.Element;
+    warning: react.JSX.Element;
+    "circle-check": react.JSX.Element;
+    "circle-close": react.JSX.Element;
+    "circle-plus": react.JSX.Element;
+    "circle-minus": react.JSX.Element;
+    home: react.JSX.Element;
+    user: react.JSX.Element;
+    users: react.JSX.Element;
+    trash: react.JSX.Element;
+    bell: react.JSX.Element;
+    star: react.JSX.Element;
+    heart: react.JSX.Element;
+    mail: react.JSX.Element;
+    lock: react.JSX.Element;
+    unlock: react.JSX.Element;
+    calendar: react.JSX.Element;
+    clock: react.JSX.Element;
+    file: react.JSX.Element;
+    folder: react.JSX.Element;
+    image: react.JSX.Element;
+    filter: react.JSX.Element;
+    play: react.JSX.Element;
+    pause: react.JSX.Element;
+    book: react.JSX.Element;
+    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, 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;
+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;
+};
+
+export { type ImageProps as $, type DropdownPlacement as A, type ButtonProps as B, Calendar as C, Dropdown as D, type DropdownProps as E, type DropdownTrigger as F, FILLED_ICON_NAMES as G, type FilledIconName as H, FloatButton as I, type FloatButtonBackTopProps as J, type FloatButtonGroupProps as K, type FloatButtonProps as L, type ModalOpenConfig as M, type FloatButtonShape as N, type OverlayContainer as O, type FloatingPlacement as P, type FloatingTrigger as Q, ICON_NAMES as R, Icon as S, type TagStatus as T, type IconName as U, type IconProps as V, type IconVariant as W, Image as X, ImagePreview as Y, type ImagePreviewConfig as Z, type ImagePreviewProps as _, type OverlayApiHandle as a, type TypographyTitleProps as a$, Input as a0, type InputProps as a1, Menu as a2, type MenuClickInfo as a3, type MenuItem as a4, type MenuMode as a5, type MenuProps as a6, type MenuTheme as a7, type MessageConfig as a8, type MessageHandle as a9, type StepsProps as aA, type TabItem as aB, Tabs as aC, type TabsContextMenuClickInfo as aD, type TabsOrientation as aE, type TabsPosition as aF, type TabsProps as aG, type TabsType as aH, Tag as aI, type TagProps as aJ, type TagVariant as aK, Timeline as aL, type TimelineItem as aM, type TimelineProps as aN, Tooltip as aO, type TooltipProps as aP, Tour as aQ, type TourProps as aR, type TourStep as aS, Tree as aT, type TreeDropPosition as aU, type TreeKey as aV, type TreeNode as aW, type TreeProps as aX, Typography as aY, type TypographyLinkProps as aZ, type TypographyProps as a_, type MessageKey as aa, type MessageType as ab, Modal as ac, type ModalProps as ad, type ModalType as ae, type NotificationConfig as af, type NotificationPlacement as ag, type NotificationType as ah, Popconfirm as ai, type PopconfirmProps as aj, Popover as ak, type PopoverProps as al, Progress as am, type ProgressProps as an, type ProgressStatus as ao, Rate as ap, type RateProps as aq, Segmented as ar, type SegmentedOption as as, type SegmentedProps as at, type SegmentedValue as au, Spin as av, type SpinProps as aw, type StepItem as ax, type StepStatus as ay, Steps as az, type ModalActionResult as b, type TypographyType as b0, Upload as b1, type UploadChangeInfo as b2, type UploadDraggerProps as b3, type UploadFile as b4, type UploadFileStatus as b5, type UploadProps as b6, type UploadRequestOptions as b7, Watermark as b8, type WatermarkFont as b9, type WatermarkProps as ba, message as bb, notification as bc, type ButtonSize as c, type BadgeProps as d, Badge as e, type BadgeRibbonProps as f, type BadgeStatus as g, Breadcrumb as h, type BreadcrumbItem as i, type BreadcrumbProps as j, Button as k, type ButtonVariant as l, type CalendarProps as m, Card as n, type CardAccent as o, type CardProps as p, Carousel as q, type CarouselProps as r, type CarouselRef as s, Collapse as t, type CollapseItem as u, type CollapseKey as v, type CollapseProps as w, type DropdownButtonProps as x, type DropdownMenuProps as y, type DropdownOpenSource as z };