lingee-ui 0.0.6 → 0.0.8

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { B as ButtonProps } from './index-B4ySDWo5.js';
-export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-B4ySDWo5.js';
+import { B as ButtonProps } from './index-7pb5YOcq.js';
+export { a as Button, b as ButtonShape, c as ButtonSize, d as ButtonVariant } from './index-7pb5YOcq.js';
 export { TabItem, Tabs, TabsProps, TabsSize, TabsVariant } from './tabs/index.js';
 export { Tooltip, TooltipPlacement, TooltipProps } from './tooltip/index.js';
 import { PopoverContentProps } from './popover/index.js';
@@ -9,10 +9,12 @@ export { Input, InputProps, InputShape, InputSize } from './input/index.js';
 export { Textarea, TextareaProps } from './textarea/index.js';
 export { ToastConfig, ToastGlobalConfig, ToastType, toast } from './toast/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import React$1, { ReactNode, HTMLAttributes, MouseEvent, CSSProperties, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
+import * as React$1 from 'react';
+import React__default, { ReactNode, HTMLAttributes, MouseEvent, CSSProperties, ComponentType, Key, ReactElement, UIEventHandler, Ref } from 'react';
 import { L as LgSize } from './index-B5SLxsZP.js';
 export { a as LgShape, b as LgVariant } from './index-B5SLxsZP.js';
 import { SvgIconProps } from 'lingee-icon';
+export { Tree, TreeAllowDropOptions, TreeCheckInfo, TreeDropInfo, TreeExpandAction, TreeExpandInfo, TreeFieldNames, TreeIndentGuide, TreeNodeData, TreeNodeState, TreeProps, TreeSelectInfo, TreeSize } from './tree/index.js';
 import { FormInstance as FormInstance$1, Rule } from 'rc-field-form/es/interface';
 export { Rule } from 'rc-field-form/es/interface';
 import { ClassValue } from 'clsx';
@@ -35,6 +37,19 @@ declare const zhCN: {
         notFound: string;
         clear: string;
     };
+    Dropdown: {
+        clear: string;
+    };
+    Tabs: {
+        scrollLeft: string;
+        scrollRight: string;
+    };
+    Form: {
+        /** {label} 为表单项名称 */
+        required: string;
+        /** label 非字符串（如 ReactNode）或缺省时的兜底文案 */
+        requiredNoLabel: string;
+    };
     Tag: {
         close: string;
     };
@@ -74,6 +89,9 @@ declare const zhCN: {
     Table: {
         empty: string;
     };
+    Tree: {
+        empty: string;
+    };
     Pagination: {
         total: string;
         prevPage: string;
@@ -90,6 +108,7 @@ declare const zhCN: {
     };
     Input: {
         clear: string;
+        expand: string;
     };
     Alert: {
         close: string;
@@ -127,6 +146,17 @@ declare const enUS: {
         notFound: string;
         clear: string;
     };
+    Dropdown: {
+        clear: string;
+    };
+    Tabs: {
+        scrollLeft: string;
+        scrollRight: string;
+    };
+    Form: {
+        required: string;
+        requiredNoLabel: string;
+    };
     Tag: {
         close: string;
     };
@@ -166,6 +196,9 @@ declare const enUS: {
     Table: {
         empty: string;
     };
+    Tree: {
+        empty: string;
+    };
     Pagination: {
         total: string;
         prevPage: string;
@@ -182,6 +215,7 @@ declare const enUS: {
     };
     Input: {
         clear: string;
+        expand: string;
     };
     Alert: {
         close: string;
@@ -223,18 +257,29 @@ declare function useLocale(): Locale;
 declare function useComponentLocale<K extends keyof Omit<Locale, "locale">>(componentName: K): Locale[K];
 
 /** 预设语义色 */
-type TagPresetColor = "primary" | "info" | "success" | "warning" | "danger";
+type TagPresetColor = "primary" | "info" | "success" | "warning" | "danger" | "amber" | "yellow" | "cyan" | "purple";
+/**
+ * 视觉变体
+ * - tint：纯色浅底，通用标记场景
+ * - gradient：渐变浅底，用于提示类徽标（警告 / 建议 / 提示）
+ * - glow：渐变底 + 光斑装饰，用于等级类徽标（钻石 / 黄金 / 铂金）
+ */
+type TagVariant = "tint" | "gradient" | "glow";
 /** 标签尺寸 */
 type TagSize = LgSize;
-/** 标签圆角形状 */
+/** 标签圆角形状（仅 variant="tint" 生效，其余变体圆角由变体规范决定） */
 type TagShape = "pill" | "rounded";
 interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color"> {
     /** 色彩：预设语义色 或 任意 CSS 色值字符串，默认 "info" */
     color?: TagPresetColor | (string & {});
+    /** 视觉变体，默认 "tint" */
+    variant?: TagVariant;
     /** 尺寸，默认 "md"（sm: 20px, md: 24px, lg: 32px） */
     size?: TagSize;
     /** 圆角形状，默认 "pill"（pill: 999px, rounded: 8px） */
     shape?: TagShape;
+    /** 前缀图标（尺寸由组件统一控制，无需自行设置宽高） */
+    icon?: ReactNode;
     /** 自定义背景（覆盖默认背景，支持渐变等任意 CSS background 值） */
     background?: string;
     /** 是否可关闭（显示关闭按钮） */
@@ -247,9 +292,9 @@ interface TagProps extends Omit<HTMLAttributes<HTMLSpanElement>, "color"> {
 
 /**
  * Tag 标签组件
- * 支持预设语义色、自定义色值、自定义背景（渐变）、可关闭等能力
+ * 支持预设语义色、自定义色值、渐变 / 光斑变体、前缀图标、可关闭等能力
  */
-declare const Tag: React$1.ForwardRefExoticComponent<TagProps & React$1.RefAttributes<HTMLSpanElement>>;
+declare const Tag: React__default.ForwardRefExoticComponent<TagProps & React__default.RefAttributes<HTMLSpanElement>>;
 
 /** 透传给 OK/Cancel 按钮的属性子集（排除 children 和事件，由 Dialog 统一管理） */
 type DialogButtonProps = Omit<ButtonProps, "children" | "onClick" | "htmlType">;
@@ -288,6 +333,8 @@ interface DialogProps {
     modal?: boolean;
     /** 是否显示遮罩层，默认 true */
     mask?: boolean;
+    /** 遮罩层自定义类名（覆盖默认背景/模糊等），仅 mask=true 时生效 */
+    maskClassName?: string;
     /** 关闭后是否销毁子节点，默认 true */
     destroyOnHidden?: boolean;
     /** 自定义 z-index */
@@ -303,6 +350,11 @@ interface DialogProps {
     /** 弹窗内容 */
     children?: ReactNode;
 }
+/** confirm contentRender 回调参数 */
+interface ConfirmRenderProps {
+    /** 动态设置确认按钮的 disabled 状态 */
+    setOkDisabled: (disabled: boolean) => void;
+}
 /** Dialog.confirm 命令式参数 */
 interface DialogConfirmOptions extends Omit<DialogProps, "open" | "onOpenChange" | "children"> {
     /** 描述文案（使用默认布局时展示） */
@@ -311,13 +363,15 @@ interface DialogConfirmOptions extends Omit<DialogProps, "open" | "onOpenChange"
     icon?: ReactNode;
     /** 自定义内容，传入后 title/description/icon 不生效 */
     content?: ReactNode;
+    /** 动态内容渲染函数，接收 { setOkDisabled } 可动态控制确认按钮状态 */
+    contentRender?: (props: ConfirmRenderProps) => ReactNode;
 }
 
 /**
  * Dialog 对话框组件
  * 基于 @radix-ui/react-dialog，提供焦点陷阱、Esc 关闭、aria 属性
  */
-declare const Dialog$1: React$1.FC<DialogProps>;
+declare const Dialog$1: React__default.FC<DialogProps>;
 
 /**
  * 命令式确认弹窗
@@ -357,7 +411,7 @@ interface SelectOptionGroup<T = string> {
 interface SelectDropdownProps extends Pick<PopoverContentProps, "side" | "align" | "sideOffset" | "alignOffset" | "className" | "collisionPadding" | "container"> {
     /** 下拉面板宽度，默认与触发器同宽 */
     width?: number | "auto";
-    /** 下拉面板最大高度，默认 256 */
+    /** 下拉面板最大高度，默认 346（约 10 项） */
     maxHeight?: number;
     /**
      * 自定义下拉面板渲染
@@ -428,8 +482,8 @@ interface SelectProps<T = string> {
  * 用法：<Select<string> options={...} />
  */
 declare const Select: <T = string>(props: SelectProps<T> & {
-    ref?: React$1.Ref<HTMLDivElement>;
-}) => React$1.ReactElement | null;
+    ref?: React__default.Ref<HTMLDivElement>;
+}) => React__default.ReactElement | null;
 
 interface DropdownMenuItemData {
     type?: "item";
@@ -439,6 +493,8 @@ interface DropdownMenuItemData {
     label: ReactNode;
     /** 前置图标 */
     icon?: ReactNode;
+    /** 副标题描述文本 */
+    description?: ReactNode;
     /** 是否为危险操作 */
     danger?: boolean;
     /** 是否禁用 */
@@ -513,6 +569,15 @@ interface DropdownContentProps extends Pick<PopoverContentProps, "side" | "align
     header?: ReactNode;
     /** 固定在面板底部的内容（不随列表滚动） */
     footer?: ReactNode;
+    /** 隐藏面板默认描边，默认 false（显示描边） */
+    borderless?: boolean;
+    /**
+     * 打开面板时是否聚焦第一个菜单项
+     * 不传时按输入模态自动判断：键盘（Enter / Space / Tab / 方向键）打开则聚焦首项，
+     * 鼠标点击打开则把焦点留在菜单容器上，避免首项呈现 hover 态
+     * 仅在需要强制某一行为时显式传值
+     */
+    autoFocusFirstItem?: boolean;
 }
 interface DropdownItemProps {
     /** 菜单项内容 */
@@ -525,6 +590,8 @@ interface DropdownItemProps {
     danger?: boolean;
     /** 前置图标 */
     icon?: ReactNode;
+    /** 副标题描述文本（显示在主文本下方，12px 灰色） */
+    description?: ReactNode;
     /** 是否选中（显示勾选图标） */
     selected?: boolean;
     /** 选中回调，调用 event.preventDefault() 可阻止面板自动关闭 */
@@ -602,9 +669,15 @@ interface DropdownSubContentProps extends Pick<PopoverContentProps, "side" | "al
     /** 子菜单面板内容 */
     children: ReactNode;
 }
-interface DropdownButtonProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
+interface DropdownButtonProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, "children"> {
     /** 按钮文本内容 */
     children?: ReactNode;
+    /** 按钮变体：default(透明底) | glassy(半透明白底+描边，适用于有色背景) */
+    variant?: "default" | "glassy";
+    /** 尺寸：sm(28px) | lg(36px)，默认 sm */
+    size?: "sm" | "lg";
+    /** 选中态色系：primary(蓝色，默认) | purple(紫色) */
+    selectedVariant?: "primary" | "purple";
     /** 前置图标 */
     icon?: ReactNode;
     /** 是否已有选中内容（蓝色态） */
@@ -620,7 +693,7 @@ interface DropdownButtonProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButt
     /** 额外类名 */
     className?: string;
     /** 清除回调 */
-    onClear?: (e: React$1.MouseEvent) => void;
+    onClear?: (e: React__default.MouseEvent) => void;
 }
 
 /**
@@ -633,21 +706,21 @@ interface DropdownButtonProps extends Omit<React$1.ButtonHTMLAttributes<HTMLButt
  * 展开时箭头旋转 180°（ChevronDown → ChevronUp 效果）
  */
 
-declare const DropdownButton: React$1.ForwardRefExoticComponent<DropdownButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const DropdownButton: React__default.ForwardRefExoticComponent<DropdownButtonProps & React__default.RefAttributes<HTMLButtonElement>>;
 
 declare function Dropdown({ children, open, defaultOpen, onOpenChange, modal, disabled, items, contentProps, selectedKeys, loading, loadingContent, emptyContent, dropdownRender, header, footer, }: DropdownProps): react_jsx_runtime.JSX.Element;
 declare namespace Dropdown {
     var displayName: string;
 }
-declare const DropdownTrigger: React$1.ForwardRefExoticComponent<DropdownTriggerProps & React$1.RefAttributes<HTMLButtonElement>>;
-declare const DropdownContent: React$1.ForwardRefExoticComponent<DropdownContentProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const DropdownItem: React$1.ForwardRefExoticComponent<DropdownItemProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const DropdownCheckboxItem: React$1.ForwardRefExoticComponent<DropdownCheckboxItemProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DropdownTrigger: React__default.ForwardRefExoticComponent<DropdownTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+declare const DropdownContent: React__default.ForwardRefExoticComponent<DropdownContentProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownItem: React__default.ForwardRefExoticComponent<DropdownItemProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownCheckboxItem: React__default.ForwardRefExoticComponent<DropdownCheckboxItemProps & React__default.RefAttributes<HTMLDivElement>>;
 declare function DropdownRadioGroup({ children, value, onValueChange }: DropdownRadioGroupProps): react_jsx_runtime.JSX.Element;
 declare namespace DropdownRadioGroup {
     var displayName: string;
 }
-declare const DropdownRadioItem: React$1.ForwardRefExoticComponent<DropdownRadioItemProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DropdownRadioItem: React__default.ForwardRefExoticComponent<DropdownRadioItemProps & React__default.RefAttributes<HTMLDivElement>>;
 declare function DropdownLabel({ children, className }: DropdownLabelProps): react_jsx_runtime.JSX.Element;
 declare namespace DropdownLabel {
     var displayName: string;
@@ -664,8 +737,8 @@ declare function DropdownSub({ children, open, defaultOpen, onOpenChange }: Drop
 declare namespace DropdownSub {
     var displayName: string;
 }
-declare const DropdownSubTrigger: React$1.ForwardRefExoticComponent<DropdownSubTriggerProps & React$1.RefAttributes<HTMLDivElement>>;
-declare const DropdownSubContent: React$1.ForwardRefExoticComponent<DropdownSubContentProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DropdownSubTrigger: React__default.ForwardRefExoticComponent<DropdownSubTriggerProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const DropdownSubContent: React__default.ForwardRefExoticComponent<DropdownSubContentProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type DatePickerSize = LgSize;
 interface DatePickerProps {
@@ -713,7 +786,7 @@ interface DatePickerProps {
  * 单选日期，基于 Popover 弹层 + react-day-picker 日历面板实现。
  * 支持年/月快速切换面板、今天按钮、日期禁用。
  */
-declare const DatePicker: React$1.ForwardRefExoticComponent<DatePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const DatePicker: React__default.ForwardRefExoticComponent<DatePickerProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type RangePickerSize = LgSize;
 type DateRange = {
@@ -764,7 +837,7 @@ interface RangePickerProps {
  *
  * 双面板并排，选择起止日期。
  */
-declare const RangePicker: React$1.ForwardRefExoticComponent<RangePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const RangePicker: React__default.ForwardRefExoticComponent<RangePickerProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type TimePickerSize = LgSize;
 interface TimeValue {
@@ -809,7 +882,7 @@ interface TimePickerProps {
  * 滚动列选择时间，支持 HH:mm 和 HH:mm:ss 两种模式。
  * 触发器复用 DatePicker 样式，面板通过 Popover 弹出。
  */
-declare const TimePicker: React$1.ForwardRefExoticComponent<TimePickerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const TimePicker: React__default.ForwardRefExoticComponent<TimePickerProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type RadioSize = LgSize;
 interface RadioGroupProps {
@@ -849,12 +922,12 @@ interface RadioItemProps {
  * RadioGroup 单选组
  * 基于 radix-ui/react-radio-group，支持受控/非受控、禁用、尺寸变体
  */
-declare const RadioGroup: React$1.ForwardRefExoticComponent<RadioGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const RadioGroup: React__default.ForwardRefExoticComponent<RadioGroupProps & React__default.RefAttributes<HTMLDivElement>>;
 /**
  * RadioItem 单选项
  * 必须作为 RadioGroup 的子组件使用
  */
-declare const RadioItem: React$1.ForwardRefExoticComponent<RadioItemProps & React$1.RefAttributes<HTMLButtonElement>>;
+declare const RadioItem: React__default.ForwardRefExoticComponent<RadioItemProps & React__default.RefAttributes<HTMLButtonElement>>;
 
 type DividerVariant = "default" | "muted" | "emphasis";
 type DividerOrientation = "horizontal" | "vertical";
@@ -871,7 +944,7 @@ interface DividerProps extends HTMLAttributes<HTMLDivElement> {
  * Divider 分割线组件
  * 用于分隔内容区块，支持水平/垂直方向和多种颜色变体
  */
-declare const Divider: React$1.ForwardRefExoticComponent<DividerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Divider: React__default.ForwardRefExoticComponent<DividerProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type CheckboxSize = LgSize;
 interface CheckboxProps {
@@ -923,12 +996,12 @@ interface CheckboxGroupProps {
  * Checkbox 复选框组件
  * 支持受控/非受控、半选态、禁用、尺寸变体，可独立使用或配合 CheckboxGroup
  */
-declare const Checkbox: React$1.ForwardRefExoticComponent<CheckboxProps & React$1.RefAttributes<HTMLInputElement>>;
+declare const Checkbox: React__default.ForwardRefExoticComponent<CheckboxProps & React__default.RefAttributes<HTMLInputElement>>;
 /**
  * CheckboxGroup 复选框组
  * 管理多个 Checkbox 的选中状态
  */
-declare const CheckboxGroup: React$1.ForwardRefExoticComponent<CheckboxGroupProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const CheckboxGroup: React__default.ForwardRefExoticComponent<CheckboxGroupProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /**
  * 分页视觉变体
@@ -978,7 +1051,7 @@ interface PaginationProps {
  * Pagination 分页组件
  * 参考 antd API 设计，通过 variant 区分三种视觉：simple（简单）、bordered（有框）、borderless（无框）
  */
-declare const Pagination: React$1.ForwardRefExoticComponent<PaginationProps & React$1.RefAttributes<HTMLElement>>;
+declare const Pagination: React__default.ForwardRefExoticComponent<PaginationProps & React__default.RefAttributes<HTMLElement>>;
 
 type SpinSize = LgSize;
 interface SpinProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
@@ -1000,7 +1073,7 @@ interface SpinProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
  * Spin 加载指示器组件
  * 支持独立使用或作为容器包裹内容，加载时显示遮罩与旋转指示器
  */
-declare const Spin: React$1.ForwardRefExoticComponent<SpinProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Spin: React__default.ForwardRefExoticComponent<SpinProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /** 空状态尺寸（复用组件库统一尺寸 LgSize） */
 type EmptySize = LgSize;
@@ -1028,17 +1101,442 @@ interface EmptyProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
     /** 自定义内联样式 */
     style?: CSSProperties;
 }
+/**
+ * 卡片占位状态。
+ * - loading: 加载中，默认旋转的 LoaderCircle
+ * - empty: 加载结束无数据，默认 Inbox
+ * - error: 加载结束失败，默认 ExclamationCircle
+ */
+type EmptyCardStatus = "loading" | "empty" | "error";
+/**
+ * 布局形态。
+ * - block: 块级居中，用于区块级占位
+ * - inline: 行内小字，用于「加载更多」这类轻量提示
+ */
+type EmptyCardVariant = "block" | "inline";
+/** 上下留白档位 */
+type EmptyCardSpacing = "none" | "normal" | "loose";
+interface EmptyCardProps extends Omit<HTMLAttributes<HTMLDivElement>, "children" | "onClick"> {
+    status: EmptyCardStatus;
+    /** 描述文案。组件不内置文案，由消费方传入 */
+    description: ReactNode;
+    /** 覆盖默认图标；传 null 则不渲染图标 */
+    icon?: ReactNode | null;
+    variant?: EmptyCardVariant;
+    spacing?: EmptyCardSpacing;
+    /** 重试回调。仅 status="error" 时生效，传入后整体渲染为可点击按钮 */
+    onRetry?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}
+
+/**
+ * Empty.Card — 等高三态占位
+ *
+ * 统一「加载中 / 加载结束空 / 加载结束失败」三态：图标 + 文案横向排列，
+ * 同一 spacing 档位下三态 min-height 一致，状态切换时容器高度不变，
+ * 避免列表或卡片区域跳动。
+ *
+ * 收敛为单组件的原因：这类占位在列表与折叠区块内散落出现十余处，
+ * 各处自行拼装会导致图标尺寸、间距、灰度层层漂移。
+ */
+declare const EmptyCard: React__default.ForwardRefExoticComponent<EmptyCardProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Empty 复合组件。
+ *
+ * 用 Object.assign 而非对象字面量挂载子组件：
+ * 保留 EmptyRoot 的 forwardRef 类型，使 <Empty ref={...} /> 仍可直接使用。
+ */
+declare const Empty: React__default.ForwardRefExoticComponent<EmptyProps & React__default.RefAttributes<HTMLDivElement>> & {
+    Card: React__default.ForwardRefExoticComponent<EmptyCardProps & React__default.RefAttributes<HTMLDivElement>>;
+};
+
+interface SidebarRootProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 展开宽度（px），默认 280 */
+    width?: number;
+    /**
+     * 折叠态。
+     * - 传 boolean：启用「外层宽度归 0 + 内容层 absolute」双层结构，宽度带过渡动画
+     * - 不传：单层结构，宽度恒定（折叠由消费方外层布局自行控制）
+     */
+    collapsed?: boolean;
+    /** 顶部安全区高度（px），用于让位固定顶栏 */
+    safeAreaTop?: number;
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarTabItem {
+    key: string;
+    label: ReactNode;
+    icon?: ReactNode;
+    disabled?: boolean;
+    /** 无障碍标签，缺省时回退 label */
+    ariaLabel?: string;
+}
+interface SidebarTabBarProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    items: SidebarTabItem[];
+    activeKey: string;
+    onChange: (key: string) => void;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarNavItemProps extends Omit<HTMLAttributes<HTMLButtonElement>, "onClick"> {
+    icon?: ReactNode;
+    label: ReactNode;
+    active?: boolean;
+    disabled?: boolean;
+    /** 右侧徽章插槽（试用标识 / 数字角标等） */
+    badge?: ReactNode;
+    onClick?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarCollapsibleNavItemChild {
+    key: string;
+    label: ReactNode;
+    active?: boolean;
+    disabled?: boolean;
+    onClick?: () => void;
+}
+interface SidebarCollapsibleNavItemProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    icon?: ReactNode;
+    label: ReactNode;
+    /** 头部高亮态。内部会与子项 active 做互斥：任一子项 active 时头部不高亮 */
+    active?: boolean;
+    /** 受控展开态 */
+    open?: boolean;
+    /** 非受控初始展开态，open 传入时忽略 */
+    defaultOpen?: boolean;
+    onOpenChange?: (next: boolean) => void;
+    /**
+     * 点击标签区回调。
+     * 传入时标签区与箭头区分离命中：标签只触发本回调，箭头只切换展开；
+     * 不传时整个头部点击都切换展开。
+     */
+    onLabelClick?: () => void;
+    items: SidebarCollapsibleNavItemChild[];
+    /** 头部右侧插槽（徽标等） */
+    extra?: ReactNode;
+    disabled?: boolean;
+    /** 箭头无障碍标签，避免组件内置文案 */
+    expandLabel?: string;
+    collapseLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarGroupHeaderProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    title: ReactNode;
+    /** 可折叠，默认 false（纯标签模式） */
+    collapsible?: boolean;
+    /** 展开态，仅 collapsible 时生效 */
+    expanded?: boolean;
+    onToggle?: () => void;
+    /** 右侧操作区插槽 */
+    actions?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+/** 会话状态指示器类型 */
+type SidebarIndicatorType = "running" | "clarification" | "unread";
+interface SidebarListItemProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onSelect" | "prefix"> {
+    title: ReactNode;
+    active?: boolean;
+    /** 状态指示器小圆点；传 null / 不传则不渲染 */
+    indicator?: SidebarIndicatorType | null;
+    /** 标题前插槽（置顶图钉等） */
+    prefix?: ReactNode;
+    onSelect?: () => void;
+    /**
+     * 右侧「更多」菜单插槽，需自带触发按钮。
+     * 以插槽形式传入，使消费方可自由选择菜单实现。
+     */
+    menu?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * 箭头位置。
+ * - title: 紧跟标题之后（文件夹节点用法，标题短时箭头也靠左）
+ * - end: 恒在行尾（定时任务分组用法）
+ */
+type SidebarCaretPlacement = "title" | "end";
+interface SidebarCollapsibleListItemProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** 头部左侧图标。需随展开态切换图标时由消费方自行传入对应图标 */
+    icon?: ReactNode;
+    title: ReactNode;
+    expanded?: boolean;
+    onToggle?: () => void;
+    /** 箭头位置，默认 title（紧跟标题） */
+    caretPlacement?: SidebarCaretPlacement;
+    /** 头部悬停操作区插槽 */
+    actions?: ReactNode;
+    /** 操作区常显。菜单打开时置 true，避免指针移出后按钮消失 */
+    actionsVisible?: boolean;
+    /** 头部高亮态 */
+    active?: boolean;
+    /** 展开区内容 */
+    children?: ReactNode;
+    /** 箭头无障碍标签 */
+    expandLabel?: string;
+    collapseLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFooterProps extends HTMLAttributes<HTMLDivElement> {
+    /** 头像插槽 */
+    avatar?: ReactNode;
+    /** 名称，为空时不渲染身份区 */
+    name?: ReactNode;
+    /** 名称后插槽（套餐标签等） */
+    nameSuffix?: ReactNode;
+    /** 用户菜单展开态，驱动触发区高亮与箭头旋转 */
+    menuOpen?: boolean;
+    /** 点击触发区。回传触发元素的 DOMRect，便于消费方自行定位浮层 */
+    onTriggerClick?: (rect: DOMRect) => void;
+    /** 右侧动作区插槽 */
+    actions?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFooterMenuStaticRowProps extends HTMLAttributes<HTMLDivElement> {
+    /** 行首图标 */
+    icon?: ReactNode;
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarFooterBadgeProps extends HTMLAttributes<HTMLSpanElement> {
+    /** 是否显示未读红点 */
+    dot?: boolean;
+    /** 被包裹的按钮 */
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+/**
+ * 用量色阶。
+ * - normal: 正常
+ * - warning: 已用 85% 以上
+ * - exhausted: 已用满
+ */
+type SidebarUsageTone = "normal" | "warning" | "exhausted";
+interface SidebarUsageBarProps extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 已用量 */
+    used: number;
+    /** 总量。为 0 或负数时视为无额度，进度为 0 */
+    total: number;
+    /**
+     * 数字格式化。千分位与小数位依赖语言环境，
+     * 组件库不持有 locale，故由消费方注入
+     */
+    formatNumber?: (n: number) => string;
+    /** 总量后缀，如「(60%)」 */
+    percentSuffix?: ReactNode;
+    /** 剩余量前缀，如「剩余 」 */
+    remainingPrefix?: ReactNode;
+    /** 进度条无障碍标签 */
+    ariaLabel?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarUsagePanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** 面板标题 */
+    title?: ReactNode;
+    /** 加载态，展示骨架屏 */
+    loading?: boolean;
+    /** 各额度分区 */
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+interface SidebarUsagePanelSectionProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** 分区标题 */
+    title: ReactNode;
+    /** 标题行右侧附加信息，如到期日 */
+    extra?: ReactNode;
+    /** 分区内容，通常是一个 UsageBar */
+    children?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+
+/**
+ * Sidebar.Root — 侧边栏根容器
+ *
+ * 两种结构由 collapsed 是否传入决定：
+ * - 传入时启用双层（外层收缩宽度 + 内层 absolute 保持内容宽度），
+ *   否则内容会随宽度收缩被挤压变形
+ * - 不传时单层，宽度恒定
+ *
+ * 同时提供 lg-sidebar__scroll / lg-sidebar__sticky 两个作用域类，
+ * 供内部滚动容器与吸顶元素复用，避免消费方各自实现遮罩与吸顶补偿。
+ */
+declare const SidebarRoot: React__default.ForwardRefExoticComponent<SidebarRootProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.Header — 侧边栏顶部区域
+ *
+ * 纯插槽容器。平台相关处理（如桌面端的窗口拖拽区、系统按钮避让）
+ * 由消费方通过 children 与 style 注入，组件本身不做平台判断。
+ */
+declare const SidebarHeader: React__default.ForwardRefExoticComponent<SidebarHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.TabBar — 侧边栏顶部分段页签
+ *
+ * 滑块位置通过测量选中项相对容器的偏移得出，而非按等分计算，
+ * 因为各页签宽度随文案长度变化（且可动态增减）。
+ *
+ * 页签显隐过滤（如权限控制）由消费方在传入 items 前完成，组件不介入。
+ */
+declare const SidebarTabBar: React__default.ForwardRefExoticComponent<SidebarTabBarProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.NavItem — 单层导航项
+ *
+ * 侧边栏宽度固定且较窄，长文案会被截断，故内置溢出提示，
+ * 消费方无需为每个导航项再包一层 Tooltip。
+ */
+declare const SidebarNavItem: React__default.ForwardRefExoticComponent<SidebarNavItemProps & React__default.RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Sidebar.CollapsibleNavItem — 可折叠导航分组
+ *
+ * 交互分两种模式：
+ * - 传 onLabelClick：标签区与箭头区分离命中。分组本身可跳转时，
+ *   点标签导航、点箭头才展开，避免「想跳转却只展开了」
+ * - 不传：整个头部点击都切换展开
+ */
+declare const SidebarCollapsibleNavItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleNavItemProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.GroupHeader — 列表分组头部
+ *
+ * 两种形态：纯标签（不可折叠）与可折叠标题。
+ * 折叠箭头默认隐藏、悬停显现，避免静态时视觉噪音过多。
+ */
+declare const SidebarGroupHeader: React__default.ForwardRefExoticComponent<SidebarGroupHeaderProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.ListItem — 列表行
+ *
+ * 菜单以插槽传入而非内置菜单项数据：各业务的操作集合差异较大，
+ * 内置会让组件被业务概念污染。
+ *
+ * 结构上标题是 button、菜单是同级节点，而非菜单嵌在标题内 ——
+ * HTML 不允许 button 嵌套可交互元素。
+ */
+declare const SidebarListItem: React__default.ForwardRefExoticComponent<SidebarListItemProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.CollapsibleListItem — 可折叠列表行
+ *
+ * 与 CollapsibleNavItem 的区别：子项结构不固定，展开区完全由消费方渲染，
+ * 且操作区悬停才显现（列表项数量多，常显会过于嘈杂）。
+ *
+ * actionsVisible 用于菜单打开期间强制显示操作区 —— 指针移到浮层上后
+ * 头部已失去 hover，若不锁定会导致按钮消失、菜单悬空。
+ */
+declare const SidebarCollapsibleListItem: React__default.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.Footer — 底部用户信息条
+ *
+ * 只收敛「头像 + 名称 + 后缀徽标 + 展开箭头 + 动作区」骨架，
+ * 用户菜单与动作按钮均以插槽传入 —— 各业务的菜单项集合差异极大。
+ *
+ * onTriggerClick 回传 DOMRect：部分消费方的浮层需要手动定位，
+ * 只给事件对象不足以定位。
+ */
+declare const SidebarFooter: React__default.ForwardRefExoticComponent<SidebarFooterProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FooterMenuStaticRow — 底栏菜单中的静态信息行
+ *
+ * 与 DropdownItem 尺寸一致但不可点击，用于「当前租户」这类只读信息 ——
+ * 同一位置在可切换时渲染为二级菜单、不可切换时渲染为此行，
+ * 两种形态必须等高等距，否则菜单会在两种状态间跳动。
+ */
+declare const SidebarFooterMenuStaticRow: React__default.ForwardRefExoticComponent<SidebarFooterMenuStaticRowProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar.FooterBadge — 底栏动作按钮的未读角标
+ *
+ * 包裹按钮而非改按钮自身：角标绝对定位不占位，
+ * 否则会撑开按钮尺寸导致底栏其余元素位移。
+ */
+declare const SidebarFooterBadge: React__default.ForwardRefExoticComponent<SidebarFooterBadgeProps & React__default.RefAttributes<HTMLSpanElement>>;
+
+/**
+ * Sidebar.UsageBar — 分段式用量条
+ *
+ * 用离散色块而非连续条：额度类数据的观感需要「格子」的计量意味，
+ * 连续进度条更像任务进度。
+ *
+ * 数字格式化交由消费方通过 formatNumber 注入 —— 千分位与小数位
+ * 依赖当前语言环境，组件库不持有 locale。
+ */
+declare const SidebarUsageBar: React__default.ForwardRefExoticComponent<SidebarUsageBarProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /**
- * Empty 空状态组件
- * 支持 lg / md / sm 三种尺寸，覆盖搜索无结果、加载中、加载失败等场景
+ * Sidebar.UsagePanel — 用量面板
  *
- * icon 支持三种传法：
- * 1. 传 lingee-icon 组件（如 Search）→ 自动注入 size + fill 渐变
- * 2. 传 ReactNode → 完全自定义渲染（加载中旋转等行为随图标一起传入自行处理）
- * 3. 不传 → 使用默认图标（带渐变）
+ * 用于底栏菜单的二级浮层（如「点数用量」）。只负责骨架与加载骨架屏，
+ * 各额度分区由消费方以 UsagePanel.Section + UsageBar 组合。
+ *
+ * 作为 DropdownSubContent 的内容使用时，需消掉外层浮层自带的
+ * 边框与阴影，避免双层描边（见 README）。
+ */
+declare const SidebarUsagePanel: React__default.ForwardRefExoticComponent<SidebarUsagePanelProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Sidebar.UsagePanelSection — 用量面板中的一个额度分区
+ *
+ * 标题行左侧为分区名、右侧为附加信息（如到期日），下方放 UsageBar。
  */
-declare const Empty: React$1.ForwardRefExoticComponent<EmptyProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const SidebarUsagePanelSection: React__default.ForwardRefExoticComponent<SidebarUsagePanelSectionProps & React__default.RefAttributes<HTMLDivElement>>;
+
+/**
+ * Sidebar 侧边栏
+ *
+ * 组合示例：
+ * ```tsx
+ * <Sidebar.Root collapsed={collapsed}>
+ *   <Sidebar.Header>{logo}</Sidebar.Header>
+ *   <Sidebar.TabBar items={tabs} activeKey={tab} onChange={setTab} />
+ *   <ScrollArea className="lg-sidebar__scroll">
+ *     <Sidebar.NavItem icon={<NewChat />} label="新任务" active />
+ *     <Sidebar.CollapsibleNavItem label="分组" items={items} />
+ *     <Sidebar.GroupHeader title="置顶" collapsible expanded onToggle={fn} />
+ *     <Sidebar.ListItem title="会话" indicator="running" menu={<Dropdown />} />
+ *     <Empty.Card status="empty" description="暂无内容" />
+ *   </ScrollArea>
+ *   <Sidebar.Footer avatar={avatar} name="用户" actions={actions} />
+ * </Sidebar.Root>
+ * ```
+ */
+declare const Sidebar: {
+    Root: React$1.ForwardRefExoticComponent<SidebarRootProps & React$1.RefAttributes<HTMLDivElement>>;
+    Header: React$1.ForwardRefExoticComponent<SidebarHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+    TabBar: React$1.ForwardRefExoticComponent<SidebarTabBarProps & React$1.RefAttributes<HTMLDivElement>>;
+    NavItem: React$1.ForwardRefExoticComponent<SidebarNavItemProps & React$1.RefAttributes<HTMLButtonElement>>;
+    CollapsibleNavItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleNavItemProps & React$1.RefAttributes<HTMLDivElement>>;
+    GroupHeader: React$1.ForwardRefExoticComponent<SidebarGroupHeaderProps & React$1.RefAttributes<HTMLDivElement>>;
+    ListItem: React$1.ForwardRefExoticComponent<SidebarListItemProps & React$1.RefAttributes<HTMLDivElement>>;
+    CollapsibleListItem: React$1.ForwardRefExoticComponent<SidebarCollapsibleListItemProps & React$1.RefAttributes<HTMLDivElement>>;
+    Footer: React$1.ForwardRefExoticComponent<SidebarFooterProps & React$1.RefAttributes<HTMLDivElement>>;
+    FooterMenuStaticRow: React$1.ForwardRefExoticComponent<SidebarFooterMenuStaticRowProps & React$1.RefAttributes<HTMLDivElement>>;
+    FooterBadge: React$1.ForwardRefExoticComponent<SidebarFooterBadgeProps & React$1.RefAttributes<HTMLSpanElement>>;
+    UsageBar: React$1.ForwardRefExoticComponent<SidebarUsageBarProps & React$1.RefAttributes<HTMLDivElement>>;
+    UsagePanel: React$1.ForwardRefExoticComponent<SidebarUsagePanelProps & React$1.RefAttributes<HTMLDivElement>>;
+    UsagePanelSection: React$1.ForwardRefExoticComponent<SidebarUsagePanelSectionProps & React$1.RefAttributes<HTMLDivElement>>;
+};
 
 /** 主轴方向类型 */
 type FlexOrientation = "horizontal" | "vertical";
@@ -1067,7 +1565,7 @@ interface FlexProps extends HTMLAttributes<HTMLElement> {
  * Flex 弹性布局组件
  * 默认水平方向、主轴起点对齐；可通过属性调整方向、对齐、换行与间隙
  */
-declare const Flex: React$1.ForwardRefExoticComponent<FlexProps & React$1.RefAttributes<HTMLElement>>;
+declare const Flex: React__default.ForwardRefExoticComponent<FlexProps & React__default.RefAttributes<HTMLElement>>;
 
 /** Alert 类型 */
 type AlertType = "info" | "success" | "warning" | "error" | "default";
@@ -1096,7 +1594,7 @@ interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
  * Alert 消息提示组件
  * 用于页面中展示重要的提示信息，支持多种类型和布局变体
  */
-declare const Alert: React$1.ForwardRefExoticComponent<AlertProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Alert: React__default.ForwardRefExoticComponent<AlertProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /** 骨架屏形状预设 */
 type SkeletonVariant = "text" | "circle" | "rect";
@@ -1122,50 +1620,7 @@ interface SkeletonProps extends HTMLAttributes<HTMLDivElement> {
  * 在数据加载完成前，通过占位图形展示简单的页面布局。
  * 支持条形(text)、圆形(circle)、方形(rect)三种预设形状，以及 shimmer/pulse 两种动画。
  */
-declare const Skeleton: React$1.ForwardRefExoticComponent<SkeletonProps & React$1.RefAttributes<HTMLDivElement>>;
-
-/** 面包屑尺寸：md=常规(16px/斜杠分隔)，sm=小型(13px/尖括号分隔) */
-type BreadcrumbSize = "sm" | "md";
-/** 单个路径项 */
-interface BreadcrumbItem {
-    /** 唯一标识（用于 React key，缺省时回退到下标） */
-    key?: string | number;
-    /** 文字内容 */
-    label?: ReactNode;
-    /** 链接地址，存在时渲染为 <a> */
-    href?: string;
-    /** 点击回调（非当前页时可点击；折叠进下拉时同样触发） */
-    onClick?: (event?: MouseEvent<HTMLElement>) => void;
-    /** 前置图标（如根节点的 House 图标）；须传入 lingee-icon 组件 */
-    icon?: ReactNode;
-    /** 是否禁用（不可点击、置灰） */
-    disabled?: boolean;
-}
-interface BreadcrumbProps extends Omit<HTMLAttributes<HTMLElement>, "onClick"> {
-    /** 路径项列表 */
-    items: BreadcrumbItem[];
-    /** 尺寸，默认 "md"（常规）。md=16px+斜杠，sm=13px+尖括号 */
-    size?: BreadcrumbSize;
-    /** 自定义分隔符，默认按 size：md→"/"(SlashLg)，sm→">"(ChevronRight) */
-    separator?: ReactNode;
-    /** 超过该数量时折叠中间项为 "…" 下拉；0 表示不折叠（默认 0） */
-    maxItems?: number;
-    /** 折叠时保留的头部项数，默认 1 */
-    itemsBeforeCollapse?: number;
-    /** 折叠时保留的尾部项数，默认 1 */
-    itemsAfterCollapse?: number;
-    /** 返回操作；传入后在最前面渲染返回箭头（页面级面包屑用） */
-    onBack?: (event?: MouseEvent<HTMLElement>) => void;
-    /** 单个链接项最大宽度(px)，超出显示省略号；不传则不限制 */
-    itemMaxWidth?: number;
-}
-
-/**
- * Breadcrumb 面包屑组件
- * 展示当前页面在系统层级中的位置，支持常规/小型两种尺寸、
- * 前置返回/首页图标、中间层级折叠下拉、超长省略等
- */
-declare const Breadcrumb: React$1.ForwardRefExoticComponent<BreadcrumbProps & React$1.RefAttributes<HTMLElement>>;
+declare const Skeleton: React__default.ForwardRefExoticComponent<SkeletonProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /**
  * 表格尺寸变体
@@ -1278,8 +1733,8 @@ interface TableProps<RecordType = any> {
 }
 
 declare const Table: <RecordType = any>(props: TableProps<RecordType> & {
-    ref?: React$1.Ref<HTMLDivElement>;
-}) => React$1.ReactElement | null;
+    ref?: React__default.Ref<HTMLDivElement>;
+}) => React__default.ReactElement | null;
 
 /** 预览变换状态 */
 type TransformType = {
@@ -1302,7 +1757,7 @@ interface ImgInfo {
 /** cover 配置（图片上的 hover 蒙层） */
 interface CoverConfig {
     /** 自定义蒙层内容 */
-    coverNode?: React$1.ReactNode;
+    coverNode?: React__default.ReactNode;
     /** 蒙层位置 */
     placement?: "top" | "bottom" | "center";
 }
@@ -1315,17 +1770,17 @@ interface PreviewType {
     /** 打开/关闭回调 */
     onOpenChange?: (open: boolean) => void;
     /** 图片上的 hover 蒙层；false 禁用，ReactNode 自定义内容，CoverConfig 对象配置 */
-    cover?: false | React$1.ReactNode | CoverConfig;
+    cover?: false | React__default.ReactNode | CoverConfig;
     /** 自定义预览内容 */
-    imageRender?: (originalNode: React$1.ReactElement, info: {
+    imageRender?: (originalNode: React__default.ReactElement, info: {
         transform: TransformType;
         image: ImgInfo;
-    }) => React$1.ReactNode;
+    }) => React__default.ReactNode;
     /** 自定义工具栏渲染 */
-    actionsRender?: (originalNode: React$1.ReactElement, info: {
+    actionsRender?: (originalNode: React__default.ReactElement, info: {
         transform: TransformType;
         actions: Record<string, () => void>;
-    }) => React$1.ReactNode;
+    }) => React__default.ReactNode;
     /** 最小缩放 */
     minScale?: number;
     /** 最大缩放 */
@@ -1344,10 +1799,10 @@ interface PreviewType {
         action: TransformAction;
     }) => void;
     /** 自定义关闭图标 */
-    closeIcon?: React$1.ReactNode;
+    closeIcon?: React__default.ReactNode;
 }
 /** Image 组件 Props — 对齐 antd 6 Image API */
-interface ImageProps extends Omit<React$1.ImgHTMLAttributes<HTMLImageElement>, "placeholder" | "onClick" | "onKeyDown"> {
+interface ImageProps extends Omit<React__default.ImgHTMLAttributes<HTMLImageElement>, "placeholder" | "onClick" | "onKeyDown"> {
     /** 图片地址 */
     src?: string;
     /** 加载失败容错地址 */
@@ -1359,7 +1814,7 @@ interface ImageProps extends Omit<React$1.ImgHTMLAttributes<HTMLImageElement>, "
      * - { progress: true }：圆形不确定进度（旋转动画）
      * - { progress: { percent: number } }：圆形确定进度
      */
-    placeholder?: boolean | React$1.ReactNode | {
+    placeholder?: boolean | React__default.ReactNode | {
         progress: true | {
             percent: number;
         };
@@ -1369,11 +1824,11 @@ interface ImageProps extends Omit<React$1.ImgHTMLAttributes<HTMLImageElement>, "
     /** 自定义根类名 */
     className?: string;
     /** 自定义根样式 */
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
     /** 点击回调 */
-    onClick?: (e: React$1.MouseEvent<HTMLDivElement>) => void;
+    onClick?: (e: React__default.MouseEvent<HTMLDivElement>) => void;
     /** 加载失败回调 */
-    onError?: (e: React$1.SyntheticEvent<HTMLImageElement, Event>) => void;
+    onError?: (e: React__default.SyntheticEvent<HTMLImageElement, Event>) => void;
 }
 /** PreviewGroup 预览配置 */
 interface PreviewGroupType extends Omit<PreviewType, "cover"> {
@@ -1382,7 +1837,7 @@ interface PreviewGroupType extends Omit<PreviewType, "cover"> {
     /** 切换回调 */
     onChange?: (current: number, prevCurrent: number) => void;
     /** 计数自定义渲染 */
-    countRender?: (current: number, total: number) => React$1.ReactNode;
+    countRender?: (current: number, total: number) => React__default.ReactNode;
 }
 /** Image.PreviewGroup Props */
 interface ImagePreviewGroupProps {
@@ -1394,7 +1849,7 @@ interface ImagePreviewGroupProps {
     /** 预览配置 */
     preview?: boolean | PreviewGroupType;
     /** 子元素 */
-    children?: React$1.ReactNode;
+    children?: React__default.ReactNode;
 }
 
 /**
@@ -1410,9 +1865,9 @@ interface ImagePreviewGroupProps {
  */
 
 /** 多图预览分组 */
-declare const PreviewGroup: React$1.FC<ImagePreviewGroupProps>;
+declare const PreviewGroup: React__default.FC<ImagePreviewGroupProps>;
 /** Image 图片组件 */
-declare const Image: React$1.FC<ImageProps> & {
+declare const Image: React__default.FC<ImageProps> & {
     PreviewGroup: typeof PreviewGroup;
 };
 
@@ -1451,7 +1906,7 @@ interface ColorPickerProps {
  * 触发器参考 Input 组件外观，内容展示颜色值，右侧显示色块预览
  * 面板使用 @rc-component/color-picker 提供完整的颜色选取交互
  */
-declare const ColorPicker: React$1.ForwardRefExoticComponent<ColorPickerProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const ColorPicker: React__default.ForwardRefExoticComponent<ColorPickerProps & React__default.RefAttributes<HTMLDivElement>>;
 
 type ProgressStatus = "normal" | "success" | "error" | "active";
 type ProgressType = "line" | "circle";
@@ -1473,11 +1928,11 @@ interface ProgressProps {
     /** 是否显示百分比文字/状态图标 */
     showInfo?: boolean;
     /** 自定义格式化显示内容 */
-    format?: (percent: number) => React$1.ReactNode;
+    format?: (percent: number) => React__default.ReactNode;
     /** 自定义根类名 */
     className?: string;
     /** 自定义根样式 */
-    style?: React$1.CSSProperties;
+    style?: React__default.CSSProperties;
 }
 
 /**
@@ -1487,7 +1942,7 @@ interface ProgressProps {
  * percent 不传或为 -1 时为不确定进度（旋转/滑动动画）。
  */
 
-declare const Progress: React$1.FC<ProgressProps>;
+declare const Progress: React__default.FC<ProgressProps>;
 
 type DrawerPlacement = "left" | "right" | "top" | "bottom";
 interface DrawerProps {
@@ -1527,7 +1982,7 @@ interface DrawerProps {
  * Drawer 抽屉组件
  * 基于 @radix-ui/react-dialog，从屏幕边缘滑入的面板
  */
-declare const Drawer: React$1.FC<DrawerProps>;
+declare const Drawer: React__default.FC<DrawerProps>;
 
 type SliderSize = "sm" | "md" | "lg";
 interface SliderProps {
@@ -1565,7 +2020,7 @@ interface SliderProps {
  * Slider 滑块组件
  * 基于 @radix-ui/react-slider，支持单值/range、tooltip、键盘操作
  */
-declare const Slider: React$1.ForwardRefExoticComponent<SliderProps & React$1.RefAttributes<HTMLSpanElement>>;
+declare const Slider: React__default.ForwardRefExoticComponent<SliderProps & React__default.RefAttributes<HTMLSpanElement>>;
 
 type StepStatus = "wait" | "process" | "finish" | "error";
 type StepsSize = "default" | "small";
@@ -1607,7 +2062,7 @@ interface StepsProps {
  * Steps 步骤条组件
  * 纯自研，支持页面级/次级变体，四种状态，标题纵/横排列
  */
-declare const Steps: React$1.FC<StepsProps>;
+declare const Steps: React__default.FC<StepsProps>;
 
 type FormLayout = "horizontal" | "vertical" | "inline";
 type FormInstance = FormInstance$1;
@@ -1679,7 +2134,7 @@ interface FormItemProps {
  * Form 表单组件
  * 基于 rc-field-form，提供布局和校验能力
  */
-declare const InternalForm: React$1.FC<FormProps>;
+declare const InternalForm: React__default.FC<FormProps>;
 /** useForm — 创建表单实例 */
 declare function useForm(): [FormInstance];
 
@@ -1687,7 +2142,7 @@ declare function useForm(): [FormInstance];
  * Form.Item 表单项组件
  * 处理 label 布局、校验规则、错误信息展示
  */
-declare const FormItem: React$1.FC<FormItemProps>;
+declare const FormItem: React__default.FC<FormItemProps>;
 
 type FormType = typeof InternalForm & {
     Item: typeof FormItem;
@@ -1730,12 +2185,12 @@ interface AvatarGroupProps {
  * Avatar 头像组件
  * 支持图片、文字、图标三种展示形态
  */
-declare const Avatar: React$1.ForwardRefExoticComponent<AvatarProps & React$1.RefAttributes<HTMLSpanElement>>;
+declare const Avatar: React__default.ForwardRefExoticComponent<AvatarProps & React__default.RefAttributes<HTMLSpanElement>>;
 /**
  * Avatar.Group 头像集群
  * 最多显示 max 个头像，超出显示 +N
  */
-declare const AvatarGroup: React$1.FC<AvatarGroupProps>;
+declare const AvatarGroup: React__default.FC<AvatarGroupProps>;
 type AvatarType = typeof Avatar & {
     Group: typeof AvatarGroup;
 };
@@ -1807,8 +2262,30 @@ interface UploadProps {
     fileList?: UploadFile[];
     /** 非受控默认文件列表 */
     defaultFileList?: UploadFile[];
-    /** 自定义上传实现（必传，组件不内置上传逻辑） */
-    customRequest: (options: CustomRequestOptions) => CustomRequestReturn | void;
+    /**
+     * 自定义上传实现，组件不内置上传逻辑。传入即「选中后立即上传」。
+     *
+     * 省略则为「仅收集」模式：不发起任何请求，文件入列后直接置为 `done`，
+     * 用于随表单一次性提交的场景 —— 文件先攒在 `fileList` 里，
+     * 由消费方在提交时自行携带。
+     */
+    customRequest?: (options: CustomRequestOptions) => CustomRequestReturn | void;
+    /**
+     * 粘贴上传。开启后监听容器内的 paste 事件，
+     * 取剪贴板中的文件（如截图）走同一套校验与收集流程。
+     *
+     * 默认 false。
+     */
+    pasteable?: boolean;
+    /**
+     * 按 `accept` 校验文件类型，不通过时以 `type` 原因触发 `onReject`。
+     *
+     * 原生 input 的 accept 只约束选择器，拖拽与粘贴可绕过它，
+     * 需要拦住这两条路径时开启。
+     *
+     * 默认 false，保持原有不校验类型的行为不变。
+     */
+    validateAccept?: boolean;
     /** 文件列表变更回调 */
     onChange?: (fileList: UploadFile[]) => void;
     /** 文件校验拒绝回调 */
@@ -1831,7 +2308,7 @@ interface UploadProps {
  * Upload 上传组件
  * 支持点击选择和拖拽上传两种模式，文件校验、进度展示、文件列表管理
  */
-declare const Upload: React$1.ForwardRefExoticComponent<UploadProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const Upload: React__default.ForwardRefExoticComponent<UploadProps & React__default.RefAttributes<HTMLDivElement>>;
 
 interface ScrollAreaProps {
     /** 子内容 */
@@ -1887,13 +2364,13 @@ interface ScrollBarProps {
  * </ScrollArea>
  * ```
  */
-declare const ScrollArea: React$1.ForwardRefExoticComponent<ScrollAreaProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const ScrollArea: React__default.ForwardRefExoticComponent<ScrollAreaProps & React__default.RefAttributes<HTMLDivElement>>;
 /**
  * ScrollBar 滚动条子组件
  *
  * 通常由 ScrollArea 内部自动渲染，也可单独使用以获得更精细的控制。
  */
-declare const ScrollBar: React$1.ForwardRefExoticComponent<ScrollBarProps & React$1.RefAttributes<HTMLDivElement>>;
+declare const ScrollBar: React__default.ForwardRefExoticComponent<ScrollBarProps & React__default.RefAttributes<HTMLDivElement>>;
 
 /**
  * 合并 CSS 类名，支持条件拼接
@@ -1902,4 +2379,4 @@ declare const ScrollBar: React$1.ForwardRefExoticComponent<ScrollBarProps & Reac
  */
 declare function cn(...inputs: ClassValue[]): string;
 
-export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, type BreadcrumbSize, ButtonProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfirmOptions, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, Empty, type EmptyIconComponent, type EmptyProps, type EmptySize, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, LgSize, LingeeProvider, type LingeeProviderProps, type Locale, Pagination, type PaginationProps, type PaginationVariant, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, cn, enUS, useComponentLocale, useLocale, zhCN };
+export { Alert, type AlertProps, type AlertType, AvatarWithGroup as Avatar, AvatarGroup, type AvatarGroupProps, type AvatarProps, ButtonProps, Checkbox, CheckboxGroup, type CheckboxGroupProps, type CheckboxProps, type CheckboxSize, ColorPicker, type ColorPickerProps, type ColorPickerSize, type CoverConfig, type CustomRequestOptions, type CustomRequestReturn, DatePicker, type DatePickerProps, type DatePickerSize, type DateRange, Dialog, type DialogConfirmOptions, type DialogProps, Divider, type DividerOrientation, type DividerProps, type DividerVariant, Drawer, type DrawerPlacement, type DrawerProps, Dropdown, DropdownButton, type DropdownButtonProps, DropdownCheckboxItem, type DropdownCheckboxItemProps, DropdownContent, type DropdownContentProps, DropdownGroup, type DropdownGroupProps, DropdownItem, type DropdownItemData, type DropdownItemProps, DropdownLabel, type DropdownLabelData, type DropdownLabelProps, type DropdownMenuItemData, type DropdownProps, DropdownRadioGroup, type DropdownRadioGroupProps, DropdownRadioItem, type DropdownRadioItemProps, DropdownSeparator, type DropdownSeparatorData, type DropdownSeparatorProps, DropdownSub, DropdownSubContent, type DropdownSubContentProps, type DropdownSubProps, DropdownSubTrigger, type DropdownSubTriggerProps, DropdownTrigger, type DropdownTriggerProps, Empty, EmptyCard, type EmptyCardProps, type EmptyCardSpacing, type EmptyCardStatus, type EmptyCardVariant, type EmptyIconComponent, type EmptyProps, type EmptySize, type FileItemActions, Flex, type FlexGapSize, type FlexOrientation, type FlexProps, Form, type FormInstance, type FormItemProps, type FormLayout, type FormProps, Image, type ImagePreviewGroupProps, type ImageProps, type ImgInfo, LgSize, LingeeProvider, type LingeeProviderProps, type Locale, Pagination, type PaginationProps, type PaginationVariant, PopoverContentProps, type PreviewGroupType, type PreviewType, Progress, type ProgressProps, type ProgressStatus, type ProgressType, RadioGroup, type RadioGroupProps, RadioItem, type RadioItemProps, type RadioSize, RangePicker, type RangePickerProps, type RangePickerSize, type RejectReason, ScrollArea, type ScrollAreaProps, ScrollBar, type ScrollBarProps, Select, type SelectDropdownProps, type SelectMode, type SelectOption, type SelectOptionGroup, type SelectProps, type SelectSize, Sidebar, type SidebarCaretPlacement, SidebarCollapsibleListItem, type SidebarCollapsibleListItemProps, SidebarCollapsibleNavItem, type SidebarCollapsibleNavItemChild, type SidebarCollapsibleNavItemProps, SidebarFooter, SidebarFooterBadge, type SidebarFooterBadgeProps, SidebarFooterMenuStaticRow, type SidebarFooterMenuStaticRowProps, type SidebarFooterProps, SidebarGroupHeader, type SidebarGroupHeaderProps, SidebarHeader, type SidebarHeaderProps, type SidebarIndicatorType, SidebarListItem, type SidebarListItemProps, SidebarNavItem, type SidebarNavItemProps, SidebarRoot, type SidebarRootProps, SidebarTabBar, type SidebarTabBarProps, type SidebarTabItem, SidebarUsageBar, type SidebarUsageBarProps, SidebarUsagePanel, type SidebarUsagePanelProps, SidebarUsagePanelSection, type SidebarUsagePanelSectionProps, type SidebarUsageTone, Skeleton, type SkeletonAnimation, type SkeletonProps, type SkeletonVariant, Slider, type SliderProps, type SliderSize, Spin, type SpinProps, type SpinSize, type StepItem, type StepStatus, Steps, type StepsProps, type StepsSize, type StepsTitlePlacement, Table, type TableColumnType, type TableProps, type TableRowSelection, type TableSize, type TableSorterState, Tag, type TagPresetColor, type TagProps, type TagShape, type TagSize, TimePicker, type TimePickerProps, type TimePickerSize, type TimeValue, type TransformAction, type TransformType, Upload, type UploadFile, type UploadFileStatus, type UploadProps, cn, enUS, useComponentLocale, useLocale, zhCN };