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

package/dist/index.d.cts

@@ -1,905 +1,2088 @@
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
-import { O as OverlayContainer, a as OverlayApiHandle, B as ButtonProps, T as TagStatus, b as ButtonSize, c as BadgeProps } from './core-AeKYVPDZ.cjs';
-export { d as Badge, e as BadgeRibbonProps, f as BadgeStatus, g as Breadcrumb, h as BreadcrumbItem, i as BreadcrumbProps, j as Button, k as ButtonVariant, C as Calendar, l as CalendarProps, m as Card, n as CardAccent, o as CardProps, p as Carousel, q as CarouselProps, r as CarouselRef, s as Collapse, t as CollapseItem, u as CollapseKey, v as CollapseProps, D as Dropdown, w as DropdownButtonProps, x as DropdownMenuProps, y as DropdownOpenSource, z as DropdownPlacement, A as DropdownProps, E as DropdownTrigger, F as FILLED_ICON_NAMES, G as FilledIconName, H as FloatButton, I as FloatButtonBackTopProps, J as FloatButtonGroupProps, K as FloatButtonProps, L as FloatButtonShape, M as FloatingPlacement, N as FloatingTrigger, P as ICON_NAMES, Q as Icon, R as IconName, S as IconProps, U as IconVariant, V as Image, W as ImagePreview, X as ImagePreviewConfig, Y as ImagePreviewProps, Z as ImageProps, _ as Input, $ as InputProps, a0 as Menu, a1 as MenuClickInfo, a2 as MenuItem, a3 as MenuMode, a4 as MenuProps, a5 as MenuTheme, a6 as MessageConfig, a7 as MessageHandle, a8 as MessageKey, a9 as MessageType, aa as Modal, ab as ModalActionResult, ac as ModalOpenConfig, ad as ModalProps, ae as ModalType, af as NotificationConfig, ag as NotificationPlacement, ah as NotificationType, ai as Popconfirm, aj as PopconfirmProps, ak as Popover, al as PopoverProps, am as Progress, an as ProgressProps, ao as ProgressStatus, ap as Rate, aq as RateProps, ar as Segmented, as as SegmentedOption, at as SegmentedProps, au as SegmentedValue, av as Spin, aw as SpinProps, ax as StepItem, ay as StepStatus, az as Steps, aA as StepsProps, aB as TabItem, aC as Tabs, aD as TabsContextMenuClickInfo, aE as TabsOrientation, aF as TabsPosition, aG as TabsProps, aH as TabsType, aI as Tag, aJ as TagProps, aK as TagVariant, aL as Timeline, aM as TimelineItem, aN as TimelineProps, aO as Tooltip, aP as TooltipProps, aQ as Tour, aR as TourProps, aS as TourStep, aT as Tree, aU as TreeDropPosition, aV as TreeKey, aW as TreeNode, aX as TreeProps, aY as Typography, aZ as TypographyLinkProps, a_ as TypographyProps, a$ as TypographyTitleProps, b0 as TypographyType, b1 as Upload, b2 as UploadChangeInfo, b3 as UploadDraggerProps, b4 as UploadFile, b5 as UploadFileStatus, b6 as UploadProps, b7 as UploadRequestOptions, b8 as Watermark, b9 as WatermarkFont, ba as WatermarkProps, bb as message, bc as notification } from './core-AeKYVPDZ.cjs';
-import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-DAYZvZVu.cjs';
-export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-shDQ5uJA.cjs';
+import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, b as ModalActionResult, B as ButtonProps, T as TagStatus, c as ButtonSize, d as BadgeProps } from './core-C5OnrCi4.cjs';
+export { e as Badge, f as BadgeRibbonProps, g as BadgeStatus, h as Breadcrumb, i as BreadcrumbItem, j as BreadcrumbProps, k as Button, l as ButtonVariant, C as Calendar, m as CalendarProps, n as Card, o as CardAccent, p as CardProps, q as Carousel, r as CarouselProps, s as CarouselRef, t as Collapse, u as CollapseItem, v as CollapseKey, w as CollapseProps, D as Dropdown, x as DropdownButtonProps, y as DropdownMenuProps, z as DropdownOpenSource, A as DropdownPlacement, E as DropdownProps, F as DropdownTrigger, G as FILLED_ICON_NAMES, H as FilledIconName, I as FloatButton, J as FloatButtonBackTopProps, K as FloatButtonGroupProps, L as FloatButtonProps, N as FloatButtonShape, P as FloatingPlacement, Q as FloatingTrigger, R as ICON_NAMES, S as Icon, U as IconName, V as IconProps, W as IconVariant, X as Image, Y as ImagePreview, Z as ImagePreviewConfig, _ as ImagePreviewProps, $ as ImageProps, a0 as Input, a1 as InputProps, a2 as Menu, a3 as MenuClickInfo, a4 as MenuItem, a5 as MenuMode, a6 as MenuProps, a7 as MenuTheme, a8 as MessageConfig, a9 as MessageHandle, aa as MessageKey, ab as MessageType, ac as Modal, ad as ModalProps, ae as ModalType, af as NotificationConfig, ag as NotificationPlacement, ah as NotificationType, ai as Popconfirm, aj as PopconfirmProps, ak as Popover, al as PopoverProps, am as Progress, an as ProgressProps, ao as ProgressStatus, ap as Rate, aq as RateProps, ar as Segmented, as as SegmentedOption, at as SegmentedProps, au as SegmentedValue, av as Spin, aw as SpinProps, ax as StepItem, ay as StepStatus, az as Steps, aA as StepsProps, aB as TabItem, aC as Tabs, aD as TabsContextMenuClickInfo, aE as TabsOrientation, aF as TabsPosition, aG as TabsProps, aH as TabsType, aI as Tag, aJ as TagProps, aK as TagVariant, aL as Timeline, aM as TimelineItem, aN as TimelineProps, aO as Tooltip, aP as TooltipProps, aQ as Tour, aR as TourProps, aS as TourStep, aT as Tree, aU as TreeDropPosition, aV as TreeKey, aW as TreeNode, aX as TreeProps, aY as Typography, aZ as TypographyLinkProps, a_ as TypographyProps, a$ as TypographyTitleProps, b0 as TypographyType, b1 as Upload, b2 as UploadChangeInfo, b3 as UploadDraggerProps, b4 as UploadFile, b5 as UploadFileStatus, b6 as UploadProps, b7 as UploadRequestOptions, b8 as Watermark, b9 as WatermarkFont, ba as WatermarkProps, bb as message, bc as notification } from './core-C5OnrCi4.cjs';
+import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.cjs';
+export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-DDmYGDD4.cjs';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.cjs';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.cjs';
 import * as Monaco from 'monaco-editor';
-export { S as Select, a as SelectChangeValue, b as SelectMode, c as SelectOption, d as SelectProps, e as SelectValue } from './Select-CVvF4mcy.cjs';
+import { S as SelectOption, a as SelectChangeValue, b as SelectProps } from './Select-4hGJt3RJ.cjs';
+export { c as Select, d as SelectMode, e as SelectValue } from './Select-4hGJt3RJ.cjs';
 export { BaiduMapHostOptions, BaiduMapInstance, BaiduMapNamespace, BaiduMapPoint, BarChart, BarChartProps, BarDatum, BarSeries, CHART_VIEWBOX_HEIGHT, CHART_VIEWBOX_WIDTH, CandlestickChart, CandlestickChartProps, CandlestickDatum, CartesianChartProps, ChartAxis, ChartAxisProps, ChartComposite, ChartCompositeLayer, ChartCompositeProps, ChartCompositeRef, ChartDataClickInfo, ChartDataEditor, ChartDataEditorProps, ChartDataZoom, ChartDataZoomProps, ChartLegend, ChartLegendItem, ChartLegendProps, ChartMapOverlay, ChartMapOverlayProps, ChartMark, ChartMarkProps, ChartRoamController, ChartRoamControllerProps, ChartSeries, ChartTimeline, ChartTimelineProps, ChartToolbox, ChartToolboxFeature, ChartToolboxOptions, ChartToolboxProps, ChartTooltip, ChartTooltipProps, ChartValueAddress, ChartValueChannel, ChartValueIsland, ChartValueIslandProps, ChartValueTransferHandler, ChartVisualMap, ChartVisualMapProps, ChartWhirlingLoading, ChartWhirlingLoadingProps, ChordChart, ChordChartProps, ChordLink, ChordNode, DEFAULT_CHART_PALETTE, EventRiverChart, EventRiverChartProps, EventRiverEvent, EventRiverEvolution, EventRiverSeries, ForceChart, ForceGraphChart, FunnelChart, FunnelChartProps, FunnelDatum, FunnelSeries, GaugeChart, GaugeChartProps, GaugeDatum, GeoJsonFeature, GeoJsonFeatureCollection, GeoJsonMultiPolygonGeometry, GeoJsonPolygonGeometry, GraphChart, GraphChartProps, GraphLink, GraphNode, HeatmapChart, HeatmapChartProps, HeatmapPoint, KLineChart, LineChart, LineChartProps, LinePoint, LineSeries, LineShareChart, LineShareChartProps, MapChart, MapChartProps, MapDatum, MapMarkLine, MapMarkPoint, MapOverlayEvent, MapOverlayHost, MapOverlaySnapshot, MixedChart, MixedChartProps, MixedSeries, PieChart, PieChartProps, PieDatum, PieSeries, RadarChart, RadarChartProps, RadarIndicator, RadarPanel, RadarSeries, ScatterChart, ScatterChartProps, ScatterDatum, ScatterVisualMap, SiaChart, SiaChartProps, SiaChartRef, SvgMapPlot, SvgMapPlotProps, ThemeRiverChart, ThemeRiverChartProps, ThemeRiverSeries, TreeChart, TreeChartProps, TreeDatum, TreemapChart, TreemapChartProps, TreemapDatum, TreemapItemStyle, VennChart, VennChartProps, VennIntersection, VennSet, WordCloudChart, WordCloudChartProps, WordCloudDatum, XYChart, XYChartProps, XYSeries, chartColor, chartTicks, createBaiduMapHost, formatChartNumber, getChartMap, linearScale, niceChartDomain, paddedValueExtent, registerChartMap, saveCompositeImage, serializeChartStack, smoothSvgPath, svgArcPath, transferCompositeValue } from './chart.cjs';
 import 'vditor';
 
+/** 警告提示的状态类型。 */
 type AlertStatus = "info" | "success" | "warning" | "error";
+/** 警告提示的属性配置。 */
 interface AlertProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** 当前状态，用于选择对应的状态样式。 */
     status?: AlertStatus;
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: AlertStatus;
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 提示或错误消息文本。 */
     message?: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 警告内容旁的业务操作节点。 */
     action?: ReactNode;
+    /**
+     * 是否显示状态图标。
+     * @defaultValue false
+     */
     showIcon?: boolean;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue false
+     */
     closable?: boolean;
+    /** 自定义关闭图标。 */
     closeIcon?: ReactNode;
+    /**
+     * 是否以通栏横幅形式显示。
+     * @defaultValue false
+     */
     banner?: boolean;
+    /** 请求关闭时触发的回调。 */
     onClose?: (event: React.MouseEvent<HTMLButtonElement>) => void;
+    /** 关闭完成后调用。 */
     afterClose?: () => void;
 }
+/** 警告提示组件。 */
 declare function Alert({ status, type, title, message, description, action, showIcon, closable, closeIcon, banner, onClose, afterClose, className, ...props }: AlertProps): react.JSX.Element | null;
 
+/** 分页器默认提供的每页记录数选项。 */
 declare const DEFAULT_PAGE_SIZE_OPTIONS: readonly [10, 25, 50, 100, 200, 500, 1000, 2000, 5000];
+/** 分页的属性配置。 */
 interface PaginationProps extends Omit<HTMLAttributes<HTMLElement>, "onChange"> {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /**
+     * 数据总数
+     * @defaultValue 0
+     */
     total?: number;
+    /** 当前页实际条数；未提供时根据总数、页码和每页条数计算。 */
+    currentPageCount?: number;
+    /** 当前页码，从 1 开始；传入后由外部控制。 */
     current?: number;
+    /**
+     * 非受控模式的初始页码或步骤位置。
+     * @defaultValue 1
+     */
     defaultCurrent?: number;
+    /** 每页显示的记录数。 */
     pageSize?: number;
+    /**
+     * 非受控模式下每页默认展示的记录数。
+     * @defaultValue 25
+     */
     defaultPageSize?: number;
+    /**
+     * 每页条数候选项
+     * @defaultValue DEFAULT_PAGE_SIZE_OPTIONS
+     */
     pageSizeOptions?: readonly number[];
+    /**
+     * 是否显示每页条数切换控件。
+     * @defaultValue true
+     */
     showSizeChanger?: boolean;
+    /**
+     * 是否显示总数，或自定义总数文本的函数。
+     * @defaultValue true
+     */
     showTotal?: boolean | ((total: number, range: [number, number]) => ReactNode);
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 只有一页数据时是否隐藏分页器。
+     * @defaultValue false
+     */
     hideOnSinglePage?: boolean;
+    /** 是否正在刷新总数。 */
     refreshing?: boolean;
+    /** 请求刷新总数时调用。 */
     onRefreshTotal?: () => void | Promise<void>;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (page: number, pageSize: number) => void;
+    /** 每页条数变化时调用，参数为页码及新的每页条数。 */
     onShowSizeChange?: (current: number, pageSize: number) => void;
 }
-declare function Pagination({ size: sizeProp, total, current, defaultCurrent, pageSize, defaultPageSize, pageSizeOptions, showSizeChanger, showTotal, disabled, hideOnSinglePage, refreshing, onRefreshTotal, onChange, onShowSizeChange, className, ...props }: PaginationProps): react.JSX.Element | null;
+/** 分页组件。 */
+declare function Pagination({ size: sizeProp, total, currentPageCount, current, defaultCurrent, pageSize, defaultPageSize, pageSizeOptions, showSizeChanger, showTotal, disabled, hideOnSinglePage, refreshing, onRefreshTotal, onChange, onShowSizeChange, className, ...props }: PaginationProps): react.JSX.Element | null;
 
+/** 级联选择的值类型。 */
 type CascaderValue = string | number;
+/** 级联选择的候选项定义。 */
 interface CascaderOption {
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: CascaderValue;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 是否为叶子节点；异步加载场景可用于标识无子项节点。 */
     isLeaf?: boolean;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly CascaderOption[];
     [key: string]: unknown;
 }
+/** 级联数据中 label、value 和 children 的字段映射。 */
 interface CascaderFieldNames {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: string;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: string;
 }
+/** 级联选择的属性配置。 */
 interface CascaderProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
+    /** 级联选项树 */
     options: readonly CascaderOption[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: readonly CascaderValue[] | readonly (readonly CascaderValue[])[];
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: readonly CascaderValue[] | readonly (readonly CascaderValue[])[];
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /**
+     是否显示搜索输入框。
+     * @defaultValue false
+     */
     showSearch?: boolean;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue false
+     */
     allowClear?: boolean;
+    /**
+     * 是否在选中任意层级节点时立即提交值。
+     * @defaultValue false
+     */
     changeOnSelect?: boolean;
+    /**
+     * 子级面板的展开方式。
+     * @defaultValue "click"
+     */
     expandTrigger?: "click" | "hover";
+    /**
+     * 未填写或未选择时的提示内容。
+     * @defaultValue "请选择"
+     */
     placeholder?: ReactNode;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 数据字段名映射，用于适配业务数据结构。 */
     fieldNames?: CascaderFieldNames;
+    /** 自定义已选结果的显示内容。 */
     displayRender?: (labels: ReactNode[], selectedOptions: CascaderOption[]) => ReactNode;
+    /** 按当前节点异步加载子节点的函数。 */
     loadData?: (selectedOptions: CascaderOption[]) => void | Promise<void>;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: readonly CascaderValue[] | readonly (readonly CascaderValue[])[] | undefined, selectedOptions: CascaderOption[] | CascaderOption[][]) => void;
 }
+/** 级联选择组件。 */
 declare function Cascader({ options, value, defaultValue, size: sizeProp, multiple, showSearch, allowClear, changeOnSelect, expandTrigger, placeholder, placeholderMode, disabled, fieldNames, displayRender, loadData, onChange, className, ...props }: CascaderProps): react.JSX.Element;
 
+/** 布局间距，可使用预设等级或数值。 */
 type LayoutGap = "small" | "medium" | "large" | number | string;
+/** 弹性布局交叉轴上的对齐方式。 */
 type FlexAlign = "normal" | "start" | "center" | "end" | "stretch" | "baseline";
+/** 弹性布局主轴上的内容分布方式。 */
 type FlexJustify = "normal" | "start" | "center" | "end" | "space-between" | "space-around" | "space-evenly";
+/** 弹性布局的属性配置。 */
 interface FlexProps extends HTMLAttributes<HTMLElement> {
+    /**
+     * 是否使用垂直布局。
+     * @defaultValue false
+     */
     vertical?: boolean;
+    /** 组件的水平或垂直排列方向。 */
     orientation?: "horizontal" | "vertical";
+    /**
+     * 是否允许换行
+     * @defaultValue false
+     */
     wrap?: boolean | CSSProperties["flexWrap"];
+    /** 主轴对齐 */
     justify?: FlexJustify;
+    /** 交叉轴对齐 */
     align?: FlexAlign;
+    /** 预设或自定义间距 */
     gap?: LayoutGap;
+    /** 弹性布局的伸缩权重或 CSS flex 配置。 */
     flex?: CSSProperties["flex"];
+    /**
+     * 用作容器的元素或组件类型。
+     * @defaultValue "div"
+     */
     component?: ElementType;
 }
+/** 弹性布局组件。 */
 declare function Flex({ vertical, orientation, wrap, justify, align, gap, flex, component: Component, className, style, ...props }: FlexProps): react.JSX.Element;
+/** 间距布局的属性配置。 */
 interface SpaceProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     排列或展示方向。
+     * @defaultValue "horizontal"
+     */
     direction?: "horizontal" | "vertical";
+    /**
+     * 组件尺寸；用于调整控件高度、字号和间距。
+     * @defaultValue "medium"
+     */
     size?: LayoutGap | readonly [LayoutGap, LayoutGap];
+    /**
+     * 交叉轴对齐
+     * @defaultValue "center"
+     */
     align?: "start" | "center" | "end" | "baseline";
+    /**
+     * 是否允许换行
+     * @defaultValue false
+     */
     wrap?: boolean;
+    /** 相邻元素之间的分隔内容 */
     split?: ReactNode;
 }
+/** SpaceCompact的属性配置。 */
 interface SpaceCompactProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     排列或展示方向。
+     * @defaultValue "horizontal"
+     */
     direction?: "horizontal" | "vertical";
+    /**
+     * 宽度撑满父容器
+     * @defaultValue false
+     */
     block?: boolean;
 }
 declare function SpaceCompact({ direction, block, className, ...props }: SpaceCompactProps): react.JSX.Element;
 declare function SpaceRoot({ direction, size, align, wrap, split, className, style, children, ...props }: SpaceProps): react.JSX.Element;
+/** 间距布局组件。 */
 declare const Space: typeof SpaceRoot & {
+    /** 紧凑布局容器，将相邻控件组合为连续的按钮或输入组。 */
     Compact: typeof SpaceCompact;
 };
+/** 分隔线的属性配置。 */
 interface DividerProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
+    /**
+     组件的视觉样式。
+     * @defaultValue "solid"
+     */
     variant?: "solid" | "dashed" | "dotted";
+    /**
+     * 文字在横向分割线中的位置
+     * @defaultValue "center"
+     */
     textAlign?: "start" | "center" | "end";
+    /**
+     * 使用普通字重
+     * @defaultValue false
+     */
     plain?: boolean;
+    /** 分割线文字 */
     children?: ReactNode;
 }
+/** 分隔线组件。 */
 declare function Divider({ orientation, variant, textAlign, plain, children, className, ...props }: DividerProps): react.JSX.Element;
+/** 响应式栅格的断点名称。 */
 type GridBreakpoint = "xs" | "sm" | "md" | "lg" | "xl" | "xxl";
+/** 按照屏幕断点分别提供的配置值。 */
 type GridResponsive<T> = T | Partial<Record<GridBreakpoint, T>>;
+/** 栅格行的属性配置。 */
 interface RowProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * 栅格行列间距。
+     * @defaultValue 0
+     */
     gutter?: LayoutGap | readonly [LayoutGap, LayoutGap];
+    /** 交叉轴对齐 */
     align?: GridResponsive<"top" | "middle" | "bottom" | "stretch">;
+    /** 主轴对齐 */
     justify?: GridResponsive<"start" | "end" | "center" | "space-around" | "space-between" | "space-evenly">;
+    /**
+     * 是否允许换行
+     * @defaultValue true
+     */
     wrap?: boolean;
 }
+/** 栅格行组件。 */
 declare function Row({ gutter, align, justify, wrap, className, style, ...props }: RowProps): react.JSX.Element;
+/** 一个断点下的栅格列宽、偏移和排序配置。 */
 interface ColSize {
+    /** 占据的网格列数。 */
     span?: number;
+    /** 相对于默认位置的偏移。 */
     offset?: number;
+    /** 排序位置或排序方向。 */
     order?: number;
+    /** 推移距离或栅格偏移配置。 */
     push?: number;
+    /** 栅格列向左移动的列数。 */
     pull?: number;
 }
+/** 栅格列的属性配置。 */
 interface ColProps extends HTMLAttributes<HTMLDivElement>, ColSize {
+    /** 弹性布局的伸缩权重或 CSS flex 配置。 */
     flex?: number | string;
+    /** 超小屏断点下的布局配置。 */
     xs?: number | ColSize;
+    /** 小屏断点下的布局配置。 */
     sm?: number | ColSize;
+    /** 中屏断点下的布局配置。 */
     md?: number | ColSize;
+    /** 大屏断点下的布局配置。 */
     lg?: number | ColSize;
+    /** 超大屏断点下的布局配置。 */
     xl?: number | ColSize;
+    /** 特大屏断点下的布局配置。 */
     xxl?: number | ColSize;
 }
+/** 栅格列组件。 */
 declare function Col({ span, offset, order, push, pull, flex, xs, sm, md, lg, xl, xxl, className, style, ...props }: ColProps): react.JSX.Element;
 
+/** SplitterPanel的属性配置。 */
 interface SplitterPanelProps extends HTMLAttributes<HTMLDivElement> {
+    /** 非受控模式下的初始尺寸。 */
     defaultSize?: number;
+    /** 非受控模式的初始收起状态。 */
     defaultCollapsed?: boolean;
+    /** 允许的最小值。 */
     min?: number;
+    /** 允许的最大值。 */
     max?: number;
+    /** 允许收起内容区域 */
     collapsible?: boolean;
+    /** 面板收起后的尺寸。 */
     collapsedSize?: number;
+    /** 面板收起时显示的内容。 */
     collapsedContent?: ReactNode;
+    /** 收起状态操作按钮的无障碍名称。 */
     collapsedAriaLabel?: string;
+    /** 是否允许通过拖拽调整尺寸。 */
     resizable?: boolean;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
 }
+/** 可拖拽分割面板的属性配置。 */
 interface SplitterProps extends Omit<HTMLAttributes<HTMLDivElement>, "onResize"> {
+    /**
+     组件的水平或垂直排列方向。
+     * @defaultValue "horizontal"
+     */
     orientation?: "horizontal" | "vertical";
+    /** 拖拽调整过程中持续触发 */
     onResize?: (sizes: readonly number[]) => void;
+    /** 鼠标或键盘调整结束时触发 */
     onResizeEnd?: (sizes: readonly number[]) => void;
 }
 declare function SplitterPanel({ defaultSize: _defaultSize, defaultCollapsed: _defaultCollapsed, min: _min, max: _max, collapsible: _collapsible, collapsedSize: _collapsedSize, collapsedContent: _collapsedContent, collapsedAriaLabel: _collapsedAriaLabel, resizable: _resizable, className, ...props }: SplitterPanelProps): react.JSX.Element;
 declare function SplitterRoot({ orientation, onResize, onResizeEnd, className, children, ...props }: SplitterProps): react.JSX.Element;
+/** 可拖拽分割面板组件。 */
 declare const Splitter: typeof SplitterRoot & {
+    /** Splitter 中的可调整大小面板。 */
     Panel: typeof SplitterPanel;
 };
 
+/** 工具面板的位置类型。 */
 type ToolPanelPlacement = "left" | "right";
+/** 工具面板的项目定义。 */
 interface ToolPanelItem {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
 }
+/** 工具面板的属性配置。 */
 interface ToolPanelProps extends Omit<HTMLAttributes<HTMLDivElement>, "title" | "onResize"> {
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 多面板配置；提供后优先于 title、icon 和 children。切换保留内容状态，共享面板宽度 */
     items?: readonly ToolPanelItem[];
+    /** 当前激活项目的标识；传入后由外部控制。 */
     activeKey?: string;
+    /** 非受控模式下初始激活的项目标识。 */
     defaultActiveKey?: string;
+    /** 切换面板时触发；再次点击当前入口仅切换展开状态 */
     onActiveKeyChange?: (key: string) => void;
+    /**
+     * 工具面板位于工作区左侧或右侧
+     * @defaultValue "left"
+     */
     placement?: ToolPanelPlacement;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /**
+     * 非受控模式下的初始打开状态。
+     * @defaultValue true
+     */
     defaultOpen?: boolean;
+    /**
+     非受控模式下的初始尺寸。
+     * @defaultValue 320
+     */
     defaultSize?: number;
+    /**
+     * 允许的最小尺寸。
+     * @defaultValue 220
+     */
     minSize?: number;
+    /**
+     * 允许的最大尺寸。
+     * @defaultValue 640
+     */
     maxSize?: number;
+    /** 活动栏切换展开状态时触发 */
     onOpenChange?: (open: boolean) => void;
+    /** 拖拽调整过程中持续触发 */
     onResize?: (size: number) => void;
+    /** 鼠标或键盘调整结束时触发 */
     onResizeEnd?: (size: number) => void;
 }
+/** 工具面板组件。 */
 declare function ToolPanel({ title, icon, items, activeKey, defaultActiveKey, onActiveKeyChange, placement, open, defaultOpen, defaultSize, minSize, maxSize, onOpenChange, onResize, onResizeEnd, className, style, children, ...props }: ToolPanelProps): react.JSX.Element;
 
+/** 窗口控制操作名称。 */
 type WindowAction = "start-dragging" | "minimize" | "toggle-maximize" | "close";
+/** 窗口控制按钮可执行的操作。 */
 type WindowControlAction = Exclude<WindowAction, "start-dragging">;
+/** 执行窗口控制操作的回调函数。 */
 type WindowActionHandler = (action: WindowAction) => void | Promise<void>;
+/** 标题栏操作区域的对齐方式。 */
 type WindowTitleBarActionsAlign = "left" | "right";
+/** 窗口控制按钮的显示和无障碍文案。 */
 interface WindowControlLabels {
+    /** 最小化窗口。 */
     minimize: string;
+    /** 最大化窗口。 */
     maximize: string;
+    /** 还原窗口尺寸或还原初始状态。 */
     restore: string;
+    /** 关闭当前界面或实例。 */
     close: string;
 }
+/** 窗口框架的属性配置。 */
 interface WindowFrameProps extends HTMLAttributes<HTMLDivElement> {
+    /** 标题栏内容或配置。 */
     titleBar?: ReactNode;
 }
+/** 窗口控制按钮的属性配置。 */
 interface WindowControlsProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * 当前窗口是否已最大化。
+     * @defaultValue false
+     */
     maximized?: boolean;
+    /**
+     * 是否显示最小化按钮。
+     * @defaultValue true
+     */
     showMinimize?: boolean;
+    /**
+     * 是否显示最大化或还原按钮。
+     * @defaultValue true
+     */
     showMaximize?: boolean;
+    /**
+     * 是否显示关闭按钮。
+     * @defaultValue true
+     */
     showClose?: boolean;
+    /**
+     * 不允许执行的窗口操作集合。
+     * @defaultValue []
+     */
     disabledActions?: readonly WindowControlAction[];
+    /** 各操作入口的显示或无障碍文案。 */
     labels?: Partial<WindowControlLabels>;
+    /** 操作按钮被触发时调用。 */
     onAction?: WindowActionHandler;
 }
+/** 窗口标题栏的属性配置。 */
 interface WindowTitleBarProps extends HTMLAttributes<HTMLElement> {
+    /** 标题前的内容区域。 */
     leading?: ReactNode;
+    /** 附加的操作按钮区域。 */
     actions?: ReactNode;
+    /**
+     * 操作区域的对齐方式。
+     * @defaultValue "right"
+     */
     actionsAlign?: WindowTitleBarActionsAlign;
+    /**
+     是否显示窗口控制按钮。
+     * @defaultValue true
+     */
     controls?: boolean | ReactNode;
+    /**
+     * 当前窗口是否已最大化。
+     * @defaultValue false
+     */
     maximized?: boolean;
+    /**
+     * 是否允许拖拽。
+     * @defaultValue true
+     */
     draggable?: boolean;
+    /** 不允许执行的窗口操作集合。 */
     disabledActions?: readonly WindowControlAction[];
+    /** 窗口控制按钮的文案。 */
     controlLabels?: Partial<WindowControlLabels>;
+    /** 窗口控制操作触发时调用。 */
     onWindowAction?: WindowActionHandler;
 }
+/** 窗口框架组件。 */
 declare function WindowFrame({ titleBar, className, children, ...props }: WindowFrameProps): react.JSX.Element;
+/** 窗口控制按钮组件。 */
 declare function WindowControls({ maximized, showMinimize, showMaximize, showClose, disabledActions, labels, onAction, className, ...props }: WindowControlsProps): react.JSX.Element;
+/** 窗口标题栏组件。 */
 declare function WindowTitleBar({ leading, actions, actionsAlign, controls, maximized, draggable, disabledActions, controlLabels, onWindowAction, className, children, onMouseDown, ...props }: WindowTitleBarProps): react.JSX.Element;
 
+/** 抽屉的位置类型。 */
 type DrawerPlacement = "left" | "right" | "top" | "bottom";
+/** DrawerPush的配置。 */
 interface DrawerPushConfig {
+    /** 抽屉推开父级时的位移距离。 */
     distance?: number | string;
 }
+/** 子抽屉打开时是否推开父抽屉，以及推开距离的配置。 */
 type DrawerPush = boolean | DrawerPushConfig;
+/** 抽屉的属性配置。 */
 interface DrawerProps extends Omit<HTMLAttributes<HTMLDivElement>, "title"> {
+    /** 是否显示抽屉 */
     open: boolean;
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 主体之外的补充内容或操作区。 */
     extra?: ReactNode;
+    /** 自定义底部操作区，传 null 隐藏 */
     footer?: ReactNode;
+    /**
+     * 出现方向
+     * @defaultValue "right"
+     */
     placement?: DrawerPlacement;
+    /**
+     * 抽屉宽度或高度
+     * @defaultValue placement === "top" || placement === "bottom" ? 320 : 760
+     */
     size?: number | string;
+    /**
+     * 是否显示关闭入口。
+     * @defaultValue true
+     */
     closable?: boolean;
+    /**
+     * 点击遮罩时是否允许关闭。
+     * @defaultValue true
+     */
     maskClosable?: boolean;
+    /**
+     * 是否允许通过 Esc 等键盘操作关闭。
+     * @defaultValue true
+     */
     keyboard?: boolean;
+    /**
+     组件或浮层的堆叠层级。
+     * @defaultValue 1000
+     */
     zIndex?: number;
     /** 子抽屉打开时是否推移当前抽屉，默认开启。 */
     push?: DrawerPush;
     /** 适用于同级 Portal 渲染的多层抽屉，按层数累计推移。 */
     pushDepth?: number;
+    /** 弹层挂载目标；可提供元素或返回元素的函数，默认挂载到页面容器。 */
     getContainer?: OverlayContainer;
+    /** 请求关闭时触发的回调。 */
     onClose?: () => void;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
     /** 展开动画完成且面板已稳定后触发。 */
     afterOpen?: () => void;
     /** 关闭动画完成且面板已隐藏后触发。 */
     afterClose?: () => void;
 }
+/** DrawerOpen的配置。 */
 interface DrawerOpenConfig extends Omit<DrawerProps, "open"> {
 }
 declare function openDrawer(config: DrawerOpenConfig): OverlayApiHandle<DrawerOpenConfig>;
+/** 抽屉组件。 */
 declare const Drawer: react.ForwardRefExoticComponent<DrawerProps & react.RefAttributes<HTMLDivElement>> & {
+    /** 直接打开实例，返回可用于更新或关闭的操作句柄。 */
     open: typeof openDrawer;
+    /** 关闭由此 API 打开的所有弹层。 */
     destroyAll(): void;
 };
 
+/** 开关的视觉样式。 */
 type SwitchVariant = "standard" | "segmented";
+/** 开关的属性配置。 */
 interface SwitchProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size"> {
+    /** 标准开关高度为 16 / 22 / 28px，分段开关为 22 / 30 / 38px；默认继承 Form */
     size?: ControlSize;
+    /** 开关右侧的可见标签 */
     label?: ReactNode;
+    /**
+     组件的视觉样式。
+     * @defaultValue "standard"
+     */
     variant?: SwitchVariant;
+    /** 选中状态的文字、图标或自定义内容 */
     checkedContent?: ReactNode;
+    /** 未选中状态的文字、图标或自定义内容 */
     uncheckedContent?: ReactNode;
+    /** 状态变化时返回最新布尔值 */
     onCheckedChange?: (checked: boolean) => void;
 }
+/** 开关组件。 */
 declare const Switch: react.ForwardRefExoticComponent<SwitchProps & react.RefAttributes<HTMLInputElement>>;
+/** 表单字段路径；字符串表示顶层字段，数组表示嵌套字段。 */
 type NamePath = string | number | readonly (string | number)[];
+/** 表单字段名到当前值的映射。 */
 type FormValues = Record<string, unknown>;
+/** 字段校验规则，支持必填、长度、正则和异步自定义校验。 */
 interface FormRule {
+    /** 是否为必填字段。 */
     required?: boolean;
+    /** 是否将仅含空白字符的文本判为无效。 */
     whitespace?: boolean;
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: "string" | "number" | "boolean" | "array" | "email" | "url";
+    /** 允许的最小值。 */
     min?: number;
+    /** 允许的最大值。 */
     max?: number;
+    /** 要求的精确长度。 */
     len?: number;
+    /** 用于校验字段值的正则表达式。 */
     pattern?: RegExp;
+    /** 提示或错误消息文本。 */
     message?: ReactNode;
+    /** 校验前转换字段值的函数。 */
     transform?: (value: unknown) => unknown;
+    /** 自定义校验函数；可返回 Promise，失败时抛出错误。 */
     validator?: (rule: FormRule, value: unknown, values: FormValues) => void | Promise<void>;
 }
+/** 校验失败的字段路径及其错误文本。 */
 interface FormErrorField {
+    /** 名称或字段标识。 */
     name: readonly (string | number)[];
+    /** 字段的校验错误信息列表。 */
     errors: readonly ReactNode[];
 }
+/** 表单操作实例，提供读写字段值、校验、重置和提交方法。 */
 interface FormInstance {
+    /** 读取指定字段的当前值，支持嵌套字段路径。 */
     getFieldValue: (name: NamePath) => unknown;
+    /** 读取表单当前字段值集合。 */
     getFieldsValue: () => FormValues;
+    /** 读取指定字段的校验错误信息。 */
     getFieldError: (name: NamePath) => readonly ReactNode[];
+    /** 设置单个字段的值；name 可为嵌套字段路径。 */
     setFieldValue: (name: NamePath, value: unknown) => void;
+    /** 批量设置表单字段值。 */
     setFieldsValue: (values: FormValues) => void;
+    /** 将字段恢复到初始值，并清理相关校验状态。 */
     resetFields: (names?: readonly NamePath[]) => void;
+    /** 执行字段校验；成功返回字段值，失败抛出校验错误信息。 */
     validateFields: (names?: readonly NamePath[]) => Promise<FormValues>;
+    /** 提交表单并执行校验；校验通过触发 onFinish，失败触发 onFinishFailed。 */
     submit: () => void;
+    /** 将指定字段滚动到可见区域。 */
     scrollToField: (name: NamePath) => void;
 }
+/** 创建或复用表单实例。返回单元素元组，可使用 const [form] = useForm() 获取实例并传给 Form 或 QueryForm。 */
 declare function useForm(form?: FormInstance): readonly [FormInstance];
+/** 表单的属性配置。 */
 interface FormProps extends Omit<FormHTMLAttributes<HTMLFormElement>, "onSubmit"> {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 表单实例；可由 Form.useForm() 或 useForm() 创建。 */
     form?: FormInstance;
+    /** 表单初始值 */
     initialValues?: FormValues;
+    /**
+     * 布局方式。
+     * @defaultValue "horizontal"
+     */
     layout?: "horizontal" | "vertical" | "inline";
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 是否显示必填标识。
+     * @defaultValue true
+     */
     requiredMark?: boolean | "optional";
+    /** 提交并且校验通过时调用，参数为完整的表单字段值。 */
     onFinish?: (values: FormValues) => void;
+    /** 表单提交校验失败时调用，参数包含字段值和错误列表。 */
     onFinishFailed?: (info: {
+        /** 字段值或选中值的集合。 */
         values: FormValues;
+        /** 校验失败的字段及其错误信息。 */
         errorFields: readonly FormErrorField[];
     }) => void;
+    /** 字段通过表单控件交互更新时调用，接收本次变化字段和完整值；用于联动查询条件等业务逻辑。 */
     onValuesChange?: (changedValues: FormValues, values: FormValues) => void;
 }
 declare function FormRoot({ form, initialValues, layout, size: sizeProp, placeholderMode, disabled, requiredMark, className, onFinish, onFinishFailed, onValuesChange, children, ...props }: FormProps): react.JSX.Element;
+/** FormItem的属性配置。 */
 interface FormItemProps {
+    /** 绑定到表单值的字段名或嵌套路径，例如 ["user", "name"]。 */
     name?: NamePath;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /**
+     * 字段的校验规则，按配置执行。
+     * @defaultValue []
+     */
     rules?: readonly FormRule[];
+    /** 是否为必填字段。 */
     required?: boolean;
+    /** 主体之外的补充内容或操作区。 */
     extra?: ReactNode;
+    /** 字段下方的辅助说明或校验提示。 */
     help?: ReactNode;
+    /** 手动指定字段校验状态。 */
     validateStatus?: "success" | "warning" | "error" | "validating";
+    /**
+     * 向子控件传递值时使用的属性名，如 value 或 checked。
+     * @defaultValue "value"
+     */
     valuePropName?: string;
+    /**
+     * 触发显示的交互方式。
+     * @defaultValue "onChange"
+     */
     trigger?: string;
+    /**
+     * 触发字段校验的事件名或事件名集合。
+     * @defaultValue "onChange"
+     */
     validateTrigger?: string | readonly string[];
+    /** 从子控件的事件参数中提取需要写入表单的值。 */
     getValueFromEvent?: (...args: unknown[]) => unknown;
+    /**
+     * 只提供字段绑定与校验，不渲染 Form.Item 的布局容器。
+     * @defaultValue false
+     */
     noStyle?: boolean;
+    /** 依赖的字段路径；依赖变化时更新当前字段。 */
     dependencies?: readonly NamePath[];
+    /** 控制表单值变化后是否重新渲染此项，可传比较函数。 */
     shouldUpdate?: boolean | ((previous: FormValues, next: FormValues) => boolean);
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode | ((form: FormInstance) => ReactNode);
+    /**
+     * 附加到组件根节点的 CSS 类名。
+     * @defaultValue ""
+     */
     className?: string;
 }
 declare function FormItem({ name, label, rules, required, extra, help, validateStatus, valuePropName, trigger, validateTrigger, getValueFromEvent, noStyle, children, className, }: FormItemProps): react.JSX.Element;
+/** 动态列表中一个字段的渲染标识和索引。 */
 interface FormListField {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: number;
+    /** 该字段在表单列表中的索引。 */
     name: number;
 }
+/** 动态表单列表的新增、删除和移动操作。 */
 interface FormListOperation {
+    /** 新增列表项，可指定初始值和插入位置。 */
     add: (value?: unknown, index?: number) => void;
+    /** 删除指定索引的列表项。 */
     remove: (index: number | readonly number[]) => void;
+    /** 将列表项从源索引移动到目标索引。 */
     move: (from: number, to: number) => void;
 }
+/** FormList的属性配置。 */
 interface FormListProps {
+    /** 名称或字段标识。 */
     name: NamePath;
+    /** 列表渲染函数，接收字段描述和 add、remove、move 操作。 */
     children: (fields: readonly FormListField[], operations: FormListOperation) => ReactNode;
 }
 declare function FormList({ name, children }: FormListProps): ReactNode;
 declare function FormErrorList({ errors }: {
+    /** 要显示的字段校验错误列表。 */
     errors?: readonly ReactNode[];
 }): react.JSX.Element | null;
+/** 表单组件。 */
 declare const Form: typeof FormRoot & {
+    /** 表单字段，负责字段值绑定、校验和标签布局。 */
     Item: typeof FormItem;
+    /** 动态表单列表，提供字段索引以及新增、删除、移动操作。 */
     List: typeof FormList;
+    /** 显示表单错误文本集合。 */
     ErrorList: typeof FormErrorList;
+    /** 创建或复用表单实例，返回单元素元组 [form]。 */
     useForm: typeof useForm;
 };
 
+/** 复选框的值类型。 */
 type CheckboxValue = string | number;
+/** 复选框的属性配置。 */
 interface CheckboxProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "value" | "onChange"> {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: CheckboxValue;
+    /**
+     * 半选状态
+     * @defaultValue false
+     */
     indeterminate?: boolean;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (checked: boolean, event: ChangeEvent<HTMLInputElement>) => void;
 }
+/** 复选框的候选项定义。 */
 interface CheckboxOption {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: CheckboxValue;
+    /** 是否禁用交互。 */
     disabled?: boolean;
 }
+/** CheckboxGroup的属性配置。 */
 interface CheckboxGroupProps {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: readonly CheckboxValue[];
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue []
+     */
     defaultValue?: readonly CheckboxValue[];
+    /** 可供用户选择的候选项列表。 */
     options?: readonly (CheckboxOption | CheckboxValue)[];
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 名称或字段标识。 */
     name?: string;
+    /**
+     * 附加到组件根节点的 CSS 类名。
+     * @defaultValue ""
+     */
     className?: string;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (values: readonly CheckboxValue[]) => void;
 }
 declare function CheckboxGroup({ size: sizeProp, value, defaultValue, options, disabled, name, className, children, onChange, }: CheckboxGroupProps): react.JSX.Element;
+/** 复选框组件。 */
 declare const Checkbox: react.ForwardRefExoticComponent<CheckboxProps & react.RefAttributes<HTMLInputElement>> & {
+    /** 组合多个子项并统一管理布局或选择状态。 */
     Group: typeof CheckboxGroup;
 };
 
+/** 单选框的值类型。 */
 type RadioValue = string | number;
+/** 单选框的属性配置。 */
 interface RadioProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "value" | "onChange"> {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value: RadioValue;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (checked: boolean, event: ChangeEvent<HTMLInputElement>) => void;
 }
+/** 单选框的候选项定义。 */
 interface RadioOption {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: RadioValue;
+    /** 是否禁用交互。 */
     disabled?: boolean;
 }
+/** RadioGroup的属性配置。 */
 interface RadioGroupProps {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: RadioValue;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: RadioValue;
+    /** 可供用户选择的候选项列表。 */
     options?: readonly (RadioOption | RadioValue)[];
+    /**
+     * 普通或按钮形态
+     * @defaultValue "default"
+     */
     optionType?: "default" | "button";
+    /**
+     * 按钮选中样式
+     * @defaultValue "outline"
+     */
     buttonStyle?: "outline" | "solid";
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 名称或字段标识。 */
     name?: string;
+    /**
+     * 附加到组件根节点的 CSS 类名。
+     * @defaultValue ""
+     */
     className?: string;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: RadioValue) => void;
 }
 declare function RadioButton(props: RadioProps): react.JSX.Element;
 declare function RadioGroup({ size: sizeProp, value, defaultValue, options, optionType, buttonStyle, disabled, name, className, children, onChange, }: RadioGroupProps): react.JSX.Element;
+/** 单选框组件。 */
 declare const Radio: react.ForwardRefExoticComponent<RadioProps & {
     button?: boolean;
 } & react.RefAttributes<HTMLInputElement>> & {
+    /** 组合主操作按钮与下拉菜单的按钮组件。 */
     Button: typeof RadioButton;
+    /** 组合多个子项并统一管理布局或选择状态。 */
     Group: typeof RadioGroup;
 };
 
+/** 滑块的值类型。 */
 type SliderValue = number | readonly [number, number];
+/** 滑块上的刻度标签定义。 */
 interface SliderMark {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
 }
+/** 滑块的属性配置。 */
 interface SliderProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: SliderValue;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: SliderValue;
+    /**
+     * 允许的最小值。
+     * @defaultValue 0
+     */
     min?: number;
+    /**
+     * 允许的最大值。
+     * @defaultValue 100
+     */
     max?: number;
+    /**
+     * 每次改变的步长
+     * @defaultValue 1
+     */
     step?: number;
+    /**
+     * 是否启用范围选择，或指定选择范围。
+     * @defaultValue false
+     */
     range?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 反转节点顺序
+     * @defaultValue false
+     */
     reverse?: boolean;
+    /**
+     * 是否使用垂直布局。
+     * @defaultValue false
+     */
     vertical?: boolean;
+    /** 刻度标记 */
     marks?: Readonly<Record<number, ReactNode | SliderMark>>;
+    /** 提示内容或提示框配置。 */
     tooltip?: {
+        /** 是否打开；传入后由外部控制显示状态。 */
         open?: boolean;
+        /** 将原始值转换为展示文本的函数。 */
         formatter?: (value: number) => ReactNode;
     };
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: SliderValue) => void;
+    /** 拖动完成回调 */
     onChangeComplete?: (value: SliderValue) => void;
 }
+/** 滑块组件。 */
 declare function Slider({ value, defaultValue, min, max, step, range, disabled, reverse, vertical, marks, tooltip, className, onChange, onChangeComplete, ...props }: SliderProps): react.JSX.Element;
 
+/** 颜色选择的模式类型。 */
 type ColorPickerMode = "solid" | "gradient";
+/** 预设颜色分组定义。 */
 interface ColorPickerPreset {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 可选颜色或颜色序列。 */
     colors: readonly string[];
 }
+/** 颜色选择的属性配置。 */
 interface ColorPickerProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange"> {
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue "#1677FF"
+     */
     defaultValue?: string;
+    /** 展示或交互模式；可选值见类型定义。 */
     mode?: ColorPickerMode;
+    /**
+     * 初始化时使用的模式。
+     * @defaultValue "solid"
+     */
     defaultMode?: ColorPickerMode;
+    /**
+     允许切换的模式集合。
+     * @defaultValue DEFAULT_MODES
+     */
     modes?: readonly ColorPickerMode[];
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue false
+     */
     allowClear?: boolean;
+    /**
+     * 是否显示文字内容。
+     * @defaultValue false
+     */
     showText?: boolean | ((color: string) => ReactNode);
+    /**
+     * 是否显示透明度调节控件。
+     * @defaultValue false
+     */
     showAlpha?: boolean;
+    /** 预设候选值或快捷选项集合。 */
     presets?: readonly ColorPickerPreset[];
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (color: string) => void;
+    /** 拖动完成回调 */
     onChangeComplete?: (color: string) => void;
+    /** 模式切换后调用。 */
     onModeChange?: (mode: ColorPickerMode) => void;
+    /** 清空当前值时调用。 */
     onClear?: () => void;
 }
+/** 颜色选择组件。 */
 declare function ColorPicker({ size: sizeProp, value, defaultValue, mode, defaultMode, modes, disabled, allowClear, showText, showAlpha, presets, className, onChange, onChangeComplete, onModeChange, onClear, ...props }: ColorPickerProps): react.JSX.Element;
 
+/** 时间选择的属性配置。 */
 interface TimePickerProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "size" | "value" | "defaultValue" | "onChange"> {
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: string;
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ""
+     */
     defaultValue?: string;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue true
+     */
     allowClear?: boolean;
+    /**
+     * 是否使用 12 小时制。
+     * @defaultValue false
+     */
     use12Hours?: boolean;
+    /**
+     * 是否显示秒选择。
+     * @defaultValue false
+     */
     showSecond?: boolean;
+    /** 显示在控件末尾的图标。 */
     suffixIcon?: ReactNode;
+    /** 禁用时间判断 */
     disabledTime?: (value: string) => boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: string) => void;
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
+/** 时间区间选择的属性配置。 */
 interface TimeRangePickerProps extends Omit<TimePickerProps, "value" | "defaultValue" | "onChange" | "placeholder"> {
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: readonly [string, string];
+    /**
+     * 非受控模式的初始值，仅在初始化时使用。
+     * @defaultValue ["", ""]
+     */
     defaultValue?: readonly [string, string];
+    /**
+     * 未填写或未选择时的提示内容。
+     * @defaultValue ["开始时间", "结束时间"]
+     */
     placeholder?: readonly [string, string];
+    /**
+     * 全局分隔符，可传入图标或文字
+     * @defaultValue "→"
+     */
     separator?: ReactNode;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: readonly [string, string]) => void;
 }
 declare function TimeRangePicker({ value, defaultValue, placeholder, separator, onChange, className, style, ...props }: TimeRangePickerProps): react.JSX.Element;
+/** 时间选择组件。 */
 declare function TimePicker({ value, defaultValue, size: sizeProp, status, allowClear, use12Hours, showSecond, suffixIcon, disabledTime, disabled, readOnly, className, style, onChange, onOpenChange, placeholder, placeholderMode, min, max, step, ...props }: TimePickerProps): react.JSX.Element;
 declare namespace TimePicker {
+    /** 时间区间选择器。 */
     const RangePicker: typeof TimeRangePicker;
 }
 
+/** 树选择的值类型。 */
 type TreeSelectValue = string | number;
+/** 树选择器的节点，包含值、标签、子节点和禁用状态。 */
 interface TreeSelectNode {
+    /** 标题内容，可传入文本或 React 节点。 */
     title: ReactNode;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: TreeSelectValue;
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key?: string | number;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 是否允许选中项目。 */
     selectable?: boolean;
+    /** 是否仅禁用该节点的勾选框。 */
     disableCheckbox?: boolean;
+    /** 是否显示勾选框或允许勾选。 */
     checkable?: boolean;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly TreeSelectNode[];
 }
+/** 树选择的属性配置。 */
 interface TreeSelectProps extends Omit<HTMLAttributes<HTMLDivElement>, "defaultValue" | "onChange" | "onSelect"> {
+    /** 树形节点数据 */
     treeData: readonly TreeSelectNode[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: TreeSelectValue | readonly TreeSelectValue[] | null;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: TreeSelectValue | readonly TreeSelectValue[];
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /**
+     * 是否显示树节点复选框。
+     * @defaultValue false
+     */
     treeCheckable?: boolean;
+    /**
+     是否显示搜索输入框。
+     * @defaultValue false
+     */
     showSearch?: boolean;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue false
+     */
     allowClear?: boolean;
+    /**
+     * 默认展开全部节点
+     * @defaultValue false
+     */
     treeDefaultExpandAll?: boolean;
+    /**
+     * 未填写或未选择时的提示内容。
+     * @defaultValue "请选择"
+     */
     placeholder?: ReactNode;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /**
+     * 搜索框的占位提示文字。
+     * @defaultValue "搜索节点"
+     */
     searchPlaceholder?: string;
     /** 最多显示的标签数；空间不足时会继续折叠，并为 +N 预留宽度。 */
     maxTagCount?: number;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /** 是否打开；传入后由外部控制显示状态。 */
     open?: boolean;
+    /**
+     * 非受控模式下的初始打开状态。
+     * @defaultValue false
+     */
     defaultOpen?: boolean;
+    /** 受控的搜索文本。 */
     searchValue?: string;
+    /** 受控的树节点展开标识集合。 */
     treeExpandedKeys?: readonly TreeSelectValue[];
+    /**
+     * 初始展开的树节点标识集合。
+     * @defaultValue []
+     */
     treeDefaultExpandedKeys?: readonly TreeSelectValue[];
+    /** 树节点展开状态改变时调用。 */
     onTreeExpand?: (keys: TreeSelectValue[]) => void;
+    /** 自定义树节点的搜索匹配规则。 */
     filterTreeNode?: false | ((search: string, node: TreeSelectNode) => boolean);
     /** 默认独立勾选；关闭后父子节点联动，禁用节点作为边界。 */
     treeCheckStrictly?: boolean;
+    /**
+     * 勾选结果的展示策略，控制父子节点如何显示。
+     * @defaultValue "all"
+     */
     showCheckedStrategy?: "all" | "parent" | "child";
+    /**
+     * 是否处于加载状态。
+     * @defaultValue false
+     */
     loading?: boolean;
+    /**
+     * 选项列表的最大可视高度，单位为像素。
+     * @defaultValue 300
+     */
     listHeight?: number;
+    /**
+     * 弹出面板的附加 CSS 类名。
+     * @defaultValue ""
+     */
     popupClassName?: string;
+    /** 弹出面板的内联样式。 */
     popupStyle?: React.CSSProperties;
+    /** 下拉面板底部扩展内容。 */
     dropdownFooter?: ReactNode;
+    /** 自定义已选结果的显示内容。 */
     displayRender?: (nodes: readonly TreeSelectNode[]) => ReactNode;
+    /** 自定义触发控件的渲染函数。 */
     renderTrigger?: (state: {
+        /** 是否打开；传入后由外部控制显示状态。 */
         open: boolean;
+        /** 切换当前打开或选中状态。 */
         toggle: () => void;
+        /** 清空当前值或内容。 */
         clear: () => void;
     }) => ReactNode;
+    /** 清空当前值时调用。 */
     onClear?: () => void;
+    /** 选中项目时调用，参数包含选中项目及关联状态。 */
     onSelect?: (value: TreeSelectValue, node: TreeSelectNode) => void;
+    /** 取消选中项目时调用。 */
     onDeselect?: (value: TreeSelectValue, node: TreeSelectNode) => void;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: TreeSelectValue | readonly TreeSelectValue[] | undefined, nodes: readonly TreeSelectNode[]) => void;
+    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
     onSearch?: (value: string) => void;
+    /** 下拉面板显示状态变化时调用。 */
     onDropdownVisibleChange?: (open: boolean) => void;
 }
+/** 树选择组件。 */
 declare function TreeSelect({ treeData, value, defaultValue, multiple, treeCheckable, showSearch, allowClear, treeDefaultExpandAll, placeholder, placeholderMode, searchPlaceholder, maxTagCount, disabled, size: sizeProp, status, className, onChange, onSearch, onDropdownVisibleChange, open: controlledOpen, defaultOpen, searchValue, treeExpandedKeys, treeDefaultExpandedKeys, onTreeExpand, filterTreeNode, treeCheckStrictly, showCheckedStrategy, loading, listHeight, popupClassName, popupStyle, dropdownFooter, displayRender, renderTrigger, onClear, onSelect, onDeselect, ...props }: TreeSelectProps): react.JSX.Element;
 
+/** FlatTree的配置选项。 */
 interface FlatTreeOptions {
+    /** 扁平数据中用作节点唯一标识的字段名。 */
     idField?: string;
+    /** 扁平数据中用作父节点标识的字段名。 */
     parentIdField?: string;
+    /** 用来判断根节点的父标识值。 */
     rootParentId?: unknown;
 }
+/** 保留原始字段并补充 children 的树节点。 */
 type FlatTreeNode<T> = T & {
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children: FlatTreeNode<T>[];
 };
 /** 平级列表转树；容忍孤儿节点，并切断自引用和循环关系，防止递归溢出。 */
 declare function buildFlatTree<T extends Record<string, any>>(items: readonly T[], options?: FlatTreeOptions): FlatTreeNode<T>[];
 
+/** 多行输入的属性配置。 */
 interface TextAreaProps extends TextareaHTMLAttributes<HTMLTextAreaElement> {
+    /** 调整字号和内边距；保留 rows 和内容决定的多行高度。默认继承 Form */
     size?: ControlSize;
+    /** 字段标签 */
     label?: ReactNode;
+    /** 帮助或校验信息 */
     hint?: ReactNode;
+    /**
+     * 校验状态
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /**
+     * 显示当前字符数
+     * @defaultValue false
+     */
     showCount?: boolean;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
 }
+/** 多行输入组件。 */
 declare const TextArea: react.ForwardRefExoticComponent<TextAreaProps & react.RefAttributes<HTMLTextAreaElement>>;
 
+/** 代码编辑器支持的 SQL 方言名称。 */
 type SqlDialectLanguage = "sql-postgresql" | "sql-mysql" | "sql-sqlserver" | "sql-sqlite";
 
+/** 代码编辑器的配色主题。 */
 type EditorTheme = "light" | "dark";
+/** 代码编辑器支持的语言名称。 */
 type EditorLanguage = SqlDialectLanguage | (string & {});
+/** 编辑器中的文本范围，行号和列号从 1 开始。 */
 interface EditorRange {
+    /** 起始行号，从 1 开始。 */
     startLineNumber: number;
+    /** 起始列号，从 1 开始。 */
     startColumn: number;
+    /** 结束行号，从 1 开始。 */
     endLineNumber: number;
+    /** 结束列号，从 1 开始。 */
     endColumn: number;
 }
+/** 编辑器中的诊断标记，包含范围、严重程度和提示信息。 */
 interface EditorMarker extends EditorRange {
+    /** 提示或错误消息文本。 */
     message: string;
+    /** 提示或问题的严重级别。 */
     severity?: "error" | "warning" | "info";
+    /** 触发来源，用于区分不同入口的操作。 */
     source?: string;
 }
+/** 编辑器选区变化时的范围和选中文本。 */
 interface EditorSelectionChange {
+    /** 是否启用范围选择，或指定选择范围。 */
     range: EditorRange;
+    /** 显示文本。 */
     text: string;
+    /** 插入内容后相对于插入起点的光标偏移。 */
     cursorOffset: number;
 }
+/** 编辑器键盘事件及控制默认行为的方法。 */
 interface EditorKeyDownEvent {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 代码内容或按键代码。 */
     code: string;
+    /** 事件发生时是否按下 Ctrl 键。 */
     ctrlKey: boolean;
+    /** 事件发生时是否按下 Command 或 Windows 键。 */
     metaKey: boolean;
+    /** 事件发生时是否按下 Shift 键。 */
     shiftKey: boolean;
+    /** 事件发生时是否按下 Alt 键。 */
     altKey: boolean;
+    /** 是否为按住按键产生的重复事件。 */
     repeat: boolean;
+    /** 阻止事件的浏览器默认行为。 */
     preventDefault(): void;
+    /** 阻止事件继续传播。 */
     stopPropagation(): void;
 }
+/** 补全候选项类别，用于显示对应图标。 */
 type EditorCompletionItemKind = "text" | "keyword" | "snippet" | "database" | "schema" | "table" | "view" | "column" | "function" | "procedure" | "value";
+/** 请求补全时的文档、光标和触发字符上下文。 */
 interface EditorCompletionContext {
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: string;
+    /** 文档起始位置到光标之前的文本。 */
     textBeforeCursor: string;
+    /** 当前行内光标之前的文本。 */
     lineTextBeforeCursor: string;
+    /** 光标所在位置的单词。 */
     word: string;
+    /** 显示位置或定位配置。 */
     position: {
+        /** 行号，从 1 开始。 */
         lineNumber: number;
+        /** 光标所在的列号，从 1 开始。 */
         column: number;
+        /** 相对于默认位置的偏移。 */
         offset: number;
     };
+    /** 触发补全的字符。 */
     triggerCharacter?: string;
 }
+/** EditorCompletion的项目定义。 */
 interface EditorCompletionItem {
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: string;
+    /** 接受补全项后插入的文本。 */
     insertText?: string;
+    /** 补全项或节点的类别。 */
     kind?: EditorCompletionItemKind;
+    /** 简短的补充说明。 */
     detail?: string;
+    /** 补全项的详细说明文档。 */
     documentation?: string;
+    /** 用于补全过滤匹配的文本。 */
     filterText?: string;
+    /** 用于补全排序的文本。 */
     sortText?: string;
+    /** 是否优先选中该补全项。 */
     preselect?: boolean;
+    /** 输入后可确认此补全项的字符集合。 */
     commitCharacters?: readonly string[];
+    /** 插入文本的格式，支持普通文本或代码片段。 */
     insertTextFormat?: "plain" | "snippet";
+    /** 是否启用范围选择，或指定选择范围。 */
     range?: EditorRange;
 }
+/** 根据编辑器上下文生成补全候选项的函数。 */
 type EditorCompletionProvider = (context: EditorCompletionContext) => readonly EditorCompletionItem[] | Promise<readonly EditorCompletionItem[]>;
+/** 编辑器可执行的命令名称。 */
 type EditorCommand = "cut" | "copy" | "paste" | "selectAll";
+/** EditorContextMenu的项目定义。 */
 interface EditorContextMenuItem {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: string;
+    /** 待执行的编辑命令。 */
     command?: EditorCommand;
+    /** 显示或绑定的快捷键。 */
     shortcut?: string;
+    /** 是否禁用交互。 */
     disabled?: boolean | ((api: EditorHandle | null) => boolean);
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: (api: EditorHandle) => void;
 }
+/** 代码编辑器的操作句柄。 */
 interface EditorHandle {
+    /** 将焦点移入控件。 */
     focus(): void;
+    /** 读取当前内容。 */
     getValue(): string;
+    /** 读取当前选区范围。 */
     getSelection(): EditorRange | null;
+    /** 读取当前选区的文本。 */
     getSelectedText(): string;
+    /** 在当前选区插入块内容。 */
     insertBlock(content: string): void;
+    /** 为选中行添加或移除行前缀。 */
     prefixLines(prefix: string): void;
+    /** 替换编辑器的全部内容。 */
     replaceValue(content: string): void;
+    /** 滚动到指定行并使其可见。 */
     revealLine(line: number): void;
+    /** 设置编辑器选区。 */
     setSelection(range: EditorRange): void;
+    /** 用指定前后文本包裹当前选区。 */
     wrapSelection(prefix: string, suffix: string, placeholder?: string): void;
 }
+/** 代码编辑器的属性配置。 */
 interface EditorProps {
+    /** 编辑器内容 */
     value: string;
+    /** 内容变化回调 */
     onChange?: (value: string) => void;
+    /** 实例初始化完成时调用，提供可用的实例或操作接口。 */
     onReady?: (api: EditorHandle | null) => void;
+    /** 编辑器选区变化时调用。 */
     onSelectionChange?: (selection: EditorSelectionChange) => void;
+    /** 键盘按下时调用，可用于处理快捷键。 */
     onKeyDown?: (event: EditorKeyDownEvent) => void;
+    /**
+     * Monaco 语言标识
+     * @defaultValue "plaintext"
+     */
     language?: EditorLanguage;
+    /** 文件路径或文档标识，用于关联编辑器模型。 */
     path?: string;
+    /**
+     组件的配色主题。
+     * @defaultValue "light"
+     */
     theme?: EditorTheme;
+    /** Monaco 编辑器配置 */
     options?: Monaco.editor.IStandaloneEditorConstructionOptions;
+    /** 需要额外高亮的文档范围。 */
     highlightRange?: EditorRange | null;
+    /**
+     * 在指定文本范围显示错误、警告或信息波浪线
+     * @defaultValue []
+     */
     markers?: readonly EditorMarker[];
+    /**
+     * 右键菜单项目配置。
+     * @defaultValue []
+     */
     contextMenuItems?: readonly EditorContextMenuItem[];
+    /** 按当前文本和光标上下文异步提供智能提示 */
     completionProvider?: EditorCompletionProvider;
+    /**
+     * 主动触发智能提示的字符
+     * @defaultValue ["."]
+     */
     completionTriggerCharacters?: readonly string[];
+    /**
+     * 按空格时正常输入空格、关闭当前提示，并根据新的光标位置重新触发智能提示
+     * @defaultValue false
+     */
     refreshSuggestionOnSpace?: boolean;
+    /**
+     * 附加到组件根节点的 CSS 类名。
+     * @defaultValue ""
+     */
     className?: string;
+    /**
+     控件的无障碍名称，供屏幕阅读器识别。
+     * @defaultValue "代码编辑器"
+     */
     ariaLabel?: string;
+    /**
+     * 加载过程中的提示内容。
+     * @defaultValue "正在加载编辑器…"
+     */
     loadingText?: string;
 }
+/** 代码编辑器组件。 */
 declare function Editor({ value, onChange, onReady, onSelectionChange, onKeyDown, language, path, theme, options, highlightRange, markers, contextMenuItems, completionProvider, completionTriggerCharacters, refreshSuggestionOnSpace, className, ariaLabel, loadingText, }: EditorProps): react.JSX.Element;
 
+/** Markdown内容的属性配置。 */
 interface MarkdownProps extends Omit<HTMLAttributes<HTMLElement>, "children"> {
+    /** 需要渲染的 Markdown 源文本。 */
     content: string;
+    /**
+     * 内容为空时显示的占位内容
+     * @defaultValue "暂无 Markdown 内容"
+     */
     emptyText?: ReactNode;
+    /** 图片加载失败时异步解析真实地址 */
     resolveImageSrc?: (src: string) => string | Promise<string>;
+    /**
+     * 允许点击或键盘打开图片预览
+     * @defaultValue true
+     */
     imagePreview?: boolean;
 }
+/** Markdown内容组件。 */
 declare function Markdown({ content, emptyText, resolveImageSrc, imagePreview, className, onClick, onKeyDown, ...props }: MarkdownProps): react.JSX.Element;
 
+/** 数字输入的属性配置。 */
 interface InputNumberProps extends Omit<InputHTMLAttributes<HTMLInputElement>, "defaultValue" | "onChange" | "prefix" | "size" | "type" | "value"> {
+    /** 当前数值（受控） */
     value?: number | null;
+    /**
+     * 初始数值
+     * @defaultValue null
+     */
     defaultValue?: number | null;
+    /** 数值变化回调 */
     onChange?: (value: number | null) => void;
+    /** 允许的最小值。 */
     min?: number;
+    /** 允许的最大值。 */
     max?: number;
+    /**
+     * 每次改变的步长
+     * @defaultValue 1
+     */
     step?: number;
+    /** 固定小数位数 */
     precision?: number;
+    /** small / medium / large 高度为 22 / 30 / 38px；默认继承 Form，组件自身 size 优先 */
     size?: ControlSize;
+    /**
+     * 当前状态，用于选择对应的状态样式。
+     * @defaultValue "default"
+     */
     status?: ControlStatus;
+    /** 输入框前缀 */
     prefix?: ReactNode;
+    /** 输入框后缀 */
     suffix?: ReactNode;
+    /**
+     是否显示操作控件。
+     * @defaultValue true
+     */
     controls?: boolean;
+    /** 占位文案的显示模式 */
     placeholderMode?: InputPlaceholderMode;
 }
+/** 数字输入组件。 */
 declare const InputNumber: react.ForwardRefExoticComponent<InputNumberProps & react.RefAttributes<HTMLInputElement>>;
 
+/** 独立选择弹框的配置。 */
+interface SelectModalConfig extends Omit<ModalOpenConfig, "children" | "footer" | "onOk" | "type"> {
+    /** 可供用户选择的候选项列表。 */
+    options: readonly SelectOption[];
+    /** 弹框打开时的初始选中值；通过返回句柄 update({ value }) 可替换当前草稿。 */
+    value?: SelectChangeValue;
+    /** 展示或交互模式；可选值见类型定义。 */
+    mode?: SelectProps["mode"];
+    /** 在选项名称下方显示 value，下拉与弹框模式均支持；不影响按 value 搜索 */
+    showValue?: boolean;
+    /** 弹框选项每行列数；长文本单行省略。 */
+    columns?: number;
+    /** 允许的最大高度。 */
+    maxHeight?: number;
+    /** 搜索框的占位提示文字。 */
+    searchPlaceholder?: string;
+    /** 自定义搜索匹配函数，返回 true 时保留该选项。 */
+    filterOption?: SelectProps["filterOption"];
+    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
+    onSearch?: SelectProps["onSearch"];
+    /** 确认后接收选中的值和对应选项；单选为单值，多选为数组。支持异步处理；返回 false 或抛出异常时保留弹框，允许重试。 */
+    onConfirm?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null) => ModalActionResult;
+}
+/** 无需渲染 Select，直接打开选择弹框。取消不提交，确认支持异步处理及返回 false 阻止关闭。 */
+declare function openSelectModal(config: SelectModalConfig): OverlayApiHandle<SelectModalConfig>;
+
+/** 矩形树图节点的种类。 */
 type TreemapNodeKind = "directory" | "file";
+/** 可下钻矩形树图的节点，包含权重、子节点和业务数据。 */
 interface TreemapNode {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: string;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: number;
+    /** 补全项或节点的类别。 */
     kind?: TreemapNodeKind;
+    /** 显示颜色，可使用 CSS 颜色值。 */
     color?: string;
+    /** 附加的业务元数据。 */
     meta?: ReactNode;
+    /** 用于布局计算的权重值。 */
     layoutValue?: number;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly TreemapNode[];
+    /** 是否包含子节点。 */
     hasChildren?: boolean;
+    /** 是否禁用交互。 */
     disabled?: boolean;
 }
+/** TreemapNode的点击事件上下文。 */
 interface TreemapNodeClickInfo {
+    /** 当前操作关联的节点数据。 */
     node: TreemapNode;
+    /** 是否处于展开状态。 */
     expanded: boolean;
+    /** 触发本次操作的原生事件。 */
     nativeEvent: MouseEvent<HTMLElement>;
 }
+/** 矩形树图的属性配置。 */
 interface TreemapProps extends Omit<HTMLAttributes<HTMLDivElement>, "onChange"> {
+    /** 用于渲染的数据集合。 */
     data: readonly TreemapNode[];
+    /**
+     * 高亮节点键值
+     * @defaultValue null
+     */
     activeKey?: string | null;
+    /** 受控的展开节点标识集合。 */
     expandedKeys?: readonly string[];
+    /**
+     * 初始化时展开的节点标识集合。
+     * @defaultValue []
+     */
     defaultExpandedKeys?: readonly string[];
+    /** 当前聚焦节点的唯一标识。 */
     focusedKey?: string | null;
+    /**
+     * 初始化时聚焦的节点标识。
+     * @defaultValue null
+     */
     defaultFocusedKey?: string | null;
+    /**
+     * 预设或自定义间距
+     * @defaultValue 2
+     */
     gap?: number;
+    /**
+     * 标题区域高度。
+     * @defaultValue 28
+     */
     headerHeight?: number;
+    /**
+     * 显示标签所需的最小宽度。
+     * @defaultValue 26
+     */
     minLabelWidth?: number;
+    /**
+     * 显示标签所需的最小高度。
+     * @defaultValue 18
+     */
     minLabelHeight?: number;
+    /**
+     * 矩形块的最小宽度。
+     * @defaultValue 28
+     */
     minTileWidth?: number;
+    /**
+     * 矩形块的最小高度。
+     * @defaultValue 18
+     */
     minTileHeight?: number;
+    /**
+     * 最大可见节点数，超出后合并为其他项
+     * @defaultValue 180
+     */
     maxVisibleNodes?: number;
+    /**
+     * 没有数据时的显示内容。
+     * @defaultValue "暂无数据"
+     */
     emptyContent?: ReactNode;
+    /**
+     将数值格式化为显示文本的函数。
+     * @defaultValue defaultValueFormatter
+     */
     valueFormatter?: (value: number, node: TreemapNode) => ReactNode;
+    /** 自定义合并节点文案 */
     overflowLabel?: (count: number) => string;
+    /** 展开状态改变时调用。 */
     onExpandedChange?: (keys: string[]) => void;
+    /** 聚焦节点改变时调用。 */
     onFocusedChange?: (key: string | null) => void;
+    /** 节点点击回调 */
     onNodeClick?: (info: TreemapNodeClickInfo) => void;
 }
+/** 矩形树图组件。 */
 declare function Treemap({ data, activeKey, expandedKeys, defaultExpandedKeys, focusedKey, defaultFocusedKey, gap, headerHeight, minLabelWidth, minLabelHeight, minTileWidth, minTileHeight, maxVisibleNodes, emptyContent, valueFormatter, overflowLabel, onExpandedChange, onFocusedChange, onNodeClick, className, style, ...props }: TreemapProps): react.JSX.Element;
 
+/** 表格行或列的唯一标识类型。 */
 type TableKey = Key;
+/** 表格列的固定方向。 */
 type TableFixed = "left" | "right";
+/** 表格单元格的水平对齐方式。 */
 type TableAlign = "left" | "center" | "right";
+/** 表格行高和字号的尺寸等级。 */
 type TableSize = "small" | "medium" | "large";
+/** 经过表格插件处理的行数据及其层级和索引信息。 */
 interface TableRow<T> {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: TableKey;
+    /** 当前业务记录。 */
     record: T;
+    /** 记录在原始数据中的索引。 */
     sourceIndex: number;
+    /** 当前节点或行的嵌套深度。 */
     depth: number;
+    /** 附加的业务元数据。 */
     meta: Record<string, unknown>;
 }
+/** 单元格渲染和事件回调的上下文，包含行、列和索引。 */
 interface TableCellRenderInfo<T> {
+    /** 当前行记录。 */
     row: TableRow<T>;
+    /** 行索引，从 0 开始。 */
     rowIndex: number;
+    /** 当前单元格对应的完整列配置。 */
     column: TableColumn<T>;
 }
+/** TableMergeSticky的配置。 */
 interface TableMergeStickyConfig<T> {
+    /** 内容或选区与外边缘之间的内缩距离。 */
     inset?: number;
+    /** 组件或浮层的堆叠层级。 */
     zIndex?: number;
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
+    /** 交叉轴对齐 */
     align?: TableAlign;
+    /** 读取当前内容。 */
     getValue?: (record: T, index: number, rows: readonly T[]) => ReactNode;
 }
+/** 表格的列定义，支持取值、渲染、固定、排序和分组表头。 */
 interface TableColumn<T = Record<string, unknown>> {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 代码内容或按键代码。 */
     code?: string;
+    /** 名称或字段标识。 */
     name?: string;
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 补充说明内容。 */
     description?: ReactNode;
+    /** 读取单元格值的字段名或嵌套路径。 */
     dataIndex?: keyof T | string | readonly string[];
+    /** 列宽，单位为像素；拖拽调整后可由列设置插件持久化。 */
     width?: number;
+    /** 弹性布局的伸缩权重或 CSS flex 配置。 */
     flex?: number;
+    /** 是否根据单元格内容自动计算列宽。 */
     autoWidth?: boolean;
+    /** 允许的最小宽度。 */
     minWidth?: number;
+    /** 允许的最大宽度。 */
     maxWidth?: number;
+    /** 交叉轴对齐 */
     align?: TableAlign;
+    /** 固定列位置：left 固定在左侧，right 固定在右侧；未设置时随横向滚动。 */
     fixed?: TableFixed | boolean;
+    /** 是否隐藏此项。 */
     hidden?: boolean;
     /** 默认单行显示并省略溢出内容（含 Space 标签组）；设为 false 允许多行。 */
     ellipsis?: boolean;
+    /** 是否使用 Sia Tooltip 显示完整文本；默认 false，不生成浏览器原生 title。 */
     showTitle?: boolean;
+    /** 是否允许该列排序。 */
     sortable?: boolean;
+    /** 是否允许该列筛选。 */
     filterable?: boolean;
+    /** 纯文本编辑；text 用于受控内容，onChange 在保存时触发 */
     editable?: boolean | TableEditableCellConfig<T>;
+    /** 是否将该列包含在导出结果中。 */
     exportable?: boolean;
+    /** 将单元格值转换为导出内容的函数。 */
     exportRender?: (value: unknown, record: T, index: number, info: TableCellRenderInfo<T>) => ReactNode;
+    /** 单元格跨越的行数，或按行计算跨行数量。 */
     rowSpan?: boolean | keyof T | string | readonly string[] | ((record: T, index: number, rows: readonly T[]) => unknown);
+    /** 合并单元格是否随滚动保持粘性定位。 */
     mergeSticky?: boolean | TableMergeStickyConfig<T>;
+    /** 合计行对此列的求和方式或求和值。 */
     sum?: boolean;
+    /** 子内容；组件嵌套内容或当前节点的子项。 */
     children?: readonly TableColumn<T>[];
+    /** 自定义数据单元格内容，接收该列的值、行数据和单元格上下文。 */
     render?: (value: unknown, record: T, index: number, info: TableCellRenderInfo<T>) => ReactNode;
+    /** 自定义列头内容。 */
     renderHeader?: (column: TableColumn<T>, context: TablePluginContext<T, any>) => ReactNode;
+    /** 数据单元格的 CSS 类名，也可按单元格计算。 */
     cellClassName?: string | ((record: T, index: number) => string);
+    /** 表头单元格的附加 CSS 类名。 */
     headerClassName?: string;
+    /** 附加的业务元数据。 */
     meta?: Record<string, unknown>;
 }
+/** TableEditableCell的类型标识。 */
 type TableEditableCellType = "input" | "inputNumber" | "select" | "custom";
+/** TableEditableCell的配置。 */
 interface TableEditableCellConfig<T> {
+    /** 类型标识，用于选择对应的表现形式。 */
     type?: TableEditableCellType;
+    /** 可供用户选择的候选项列表。 */
     options?: readonly {
+        /** 展示给用户的名称，可传入文本或 React 节点。 */
         label: ReactNode;
+        /** 该项目对应的数据值，用于标识、选择或计算。 */
         value: string | number;
     }[];
+    /** 自定义单元格编辑控件。 */
     editRender?: (record: T, save: (value: unknown) => void, cancel: () => void) => ReactNode;
+    /** 判断当前单元格是否允许编辑。 */
     canEdit?: (record: T) => boolean;
 }
+/** 表格插件执行时的上下文，提供数据、列、状态和事件操作。 */
 interface TablePluginContext<T, S = unknown> {
+    /** 插件唯一标识。 */
     readonly pluginId: string;
+    /** 未经插件处理的原始数据。 */
     readonly sourceData: readonly T[];
+    /** 未经插件转换的基础列配置。 */
     readonly baseColumns: readonly TableColumn<T>[];
+    /** 默认可见行数 */
     readonly rows: readonly TableRow<T>[];
+    /** 列配置或选项布局列数，具体类型见签名。 */
     readonly columns: readonly TableColumn<T>[];
+    /** 当前状态快照。 */
     readonly state: S;
+    /** 读取记录的唯一标识。 */
     getRowKey: (record: T, index: number) => TableKey;
+    /** 读取当前状态。 */
     getState: <Value = unknown>(pluginId: string) => Value | undefined;
+    /** 更新当前状态，可传入基于旧状态的更新函数。 */
     setState: (next: S | ((previous: S) => S)) => void;
+    /** 更新指定插件的状态。 */
     setPluginState: <Value>(pluginId: string, next: Value | ((previous: Value) => Value)) => void;
+    /** 按插件标识获取该插件暴露的 API。 */
     getPluginApi: <Api = unknown>(pluginId: string) => Api | undefined;
+    /** 发出事件，通知已注册的插件监听者。 */
     emit: (event: TablePluginEvent) => void;
 }
+/** 表格插件间传递的事件，包含类型、来源和负载。 */
 interface TablePluginEvent {
+    /** 类型标识，用于选择对应的表现形式。 */
     type: string;
+    /** 触发来源，用于区分不同入口的操作。 */
     source: string;
+    /** 事件携带的数据。 */
     payload?: unknown;
 }
+/** TablePluginCell的属性配置。 */
 interface TablePluginCellProps {
+    /** 单元格跨越的行数，或按行计算跨行数量。 */
     rowSpan?: number;
+    /** 单元格跨越的列数。 */
     colSpan?: number;
+    /** 是否隐藏此项。 */
     hidden?: boolean;
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
+    /** 需要显示的内容，支持文本或 React 节点。 */
     content?: ReactNode;
 }
+/** TablePluginHeaderCell的属性配置。 */
 interface TablePluginHeaderCellProps {
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
 }
+/** 表格插件契约，提供数据转换、渲染扩展、事件监听和对外 API。 */
 interface TablePlugin<T, S = unknown, Api = unknown> {
+    /** 唯一标识，用于关联实例或插件。 */
     id: string;
+    /** 排序位置或排序方向。 */
     order?: number;
+    /** 是否禁用虚拟渲染。 */
     disableVirtual?: boolean;
+    /** 插件或功能初始化时的状态。 */
     initialState?: S | (() => S);
+    /** 转换列配置；返回值传递给后续插件和表格渲染。 */
     transformColumns?: (columns: readonly TableColumn<T>[], context: TablePluginContext<T, S>) => readonly TableColumn<T>[];
+    /** 转换行数据；返回值传递给后续插件和表格渲染。 */
     transformRows?: (rows: readonly TableRow<T>[], context: TablePluginContext<T, S>) => readonly TableRow<T>[];
+    /** 渲染表格工具栏起始区域。 */
     renderToolbarStart?: (context: TablePluginContext<T, S>) => ReactNode;
+    /** 渲染表格工具栏末尾区域。 */
     renderToolbarEnd?: (context: TablePluginContext<T, S>) => ReactNode;
+    /** 渲染表格合计区域。 */
     renderSummary?: (context: TablePluginContext<T, S>) => readonly TableSummaryRow[] | null;
+    /** 渲染底部内容。 */
     renderFooter?: (context: TablePluginContext<T, S>) => ReactNode;
+    /** 渲染覆盖层或弹出面板。 */
     renderOverlay?: (context: TablePluginContext<T, S>) => ReactNode;
+    /** 根据行信息生成 CSS 类名。 */
     getRowClassName?: (row: TableRow<T>, context: TablePluginContext<T, S>) => string;
+    /** 根据单元格上下文生成附加属性。 */
     getCellProps?: (row: TableRow<T>, column: TableColumn<T>, context: TablePluginContext<T, S>) => TablePluginCellProps | void;
+    /** 根据列信息生成表头附加属性。 */
     getHeaderCellProps?: (column: TableColumn<T>, context: TablePluginContext<T, S>) => TablePluginHeaderCellProps | void;
+    /** 点击行时调用。 */
     onRowClick?: (row: TableRow<T>, context: TablePluginContext<T, S>) => void;
+    /** 鼠标进入行时调用。 */
     onRowMouseEnter?: (row: TableRow<T>, context: TablePluginContext<T, S>) => void;
+    /** 鼠标离开行时调用。 */
     onRowMouseLeave?: (row: TableRow<T>, context: TablePluginContext<T, S>) => void;
+    /** 鼠标进入单元格时调用。 */
     onCellMouseEnter?: (row: TableRow<T>, column: TableColumn<T>, context: TablePluginContext<T, S>) => void;
+    /** 鼠标离开单元格时调用。 */
     onCellMouseLeave?: (row: TableRow<T>, column: TableColumn<T>, context: TablePluginContext<T, S>) => void;
+    /** 点击单元格时调用。 */
     onCellClick?: (row: TableRow<T>, column: TableColumn<T>, event: MouseEvent<HTMLTableCellElement>, context: TablePluginContext<T, S>) => void;
+    /** 指针在单元格按下时调用。 */
     onCellPointerDown?: (row: TableRow<T>, column: TableColumn<T>, event: PointerEvent<HTMLTableCellElement>, context: TablePluginContext<T, S>) => void;
+    /** 指针在单元格移动时调用。 */
     onCellPointerMove?: (row: TableRow<T>, column: TableColumn<T>, event: PointerEvent<HTMLTableCellElement>, context: TablePluginContext<T, S>) => void;
+    /** 指针在表头按下时调用。 */
     onHeaderPointerDown?: (column: TableColumn<T>, event: PointerEvent<HTMLTableCellElement>, context: TablePluginContext<T, S>) => void;
+    /** 指针在表头移动时调用。 */
     onHeaderPointerMove?: (column: TableColumn<T>, event: PointerEvent<HTMLTableCellElement>, context: TablePluginContext<T, S>) => void;
+    /** 插件挂载时调用；可返回清理函数，在卸载时执行。 */
     onMount?: (context: TablePluginContext<T, S>) => void | (() => void);
+    /** 接收其他插件或表格发出的事件。 */
     onEvent?: (event: TablePluginEvent, context: TablePluginContext<T, S>) => void;
+    /** 创建插件对外暴露的操作 API。 */
     getApi?: (context: TablePluginContext<T, S>) => Api;
 }
+/** 可组合到 Table.plugins 中的表格插件类型。 */
 type AnyTablePlugin<T> = TablePlugin<T, any, any>;
+/** 一条小计或总计行的标签和单元格内容。 */
 interface TableSummaryRow {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label?: ReactNode;
+    /** 字段值或选中值的集合。 */
     values: Record<string, ReactNode>;
+    /** 附加到组件根节点的 CSS 类名。 */
     className?: string;
 }
+/** 表格的属性配置。 */
 interface TableProps<T extends Record<string, unknown> = Record<string, unknown>> extends Omit<HTMLAttributes<HTMLDivElement>, "children"> {
+    /** 表格或列表的原始数据集合。 */
     dataSource?: readonly T[];
+    /** 表格列定义；支持 children 构建分组表头。 */
     columns?: readonly TableColumn<T>[];
+    /** 行唯一键字段或计算函数 */
     rowKey?: keyof T | string | ((record: T, index: number) => TableKey);
     /** 默认启用行悬停高亮；传入 createHighlightPlugin({ row: false }) 可关闭。 */
     plugins?: readonly AnyTablePlugin<T>[];
+    /** 是否处于加载状态。 */
     loading?: boolean;
+    /** 内容为空时显示的占位内容 */
     emptyText?: ReactNode;
+    /** 高度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     height?: number | string;
+    /** 表格滚动区域的高度。 */
     tableHeight?: number | string;
+    /** 表格密度 */
     size?: TableSize;
+    /** 是否显示边框。 */
     bordered?: boolean;
     /** 是否显示行分隔线（含表头和汇总行），默认 true。 */
     rowBordered?: boolean;
@@ -907,297 +2090,538 @@ interface TableProps<T extends Record<string, unknown> = Record<string, unknown>
     columnBordered?: boolean;
     /** 是否将工具栏纳入表格边框，默认 false；表格主体边框仍由 bordered 控制。 */
     toolbarBordered?: boolean;
+    /** 是否显示隔行背景。 */
     striped?: boolean;
+    /** 长列表启用窗口化渲染 */
     virtual?: boolean;
+    /** 启用虚拟滚动的选项数量 */
     virtualThreshold?: number;
+    /** 行高度，虚拟滚动用其计算行位置。 */
     rowHeight?: number;
+    /** 虚拟列表在可视区域前后额外渲染的数量。 */
     overscan?: number;
+    /** 滚动时是否固定表头。 */
     stickyHeader?: boolean;
+    /** 是否允许拖拽表头边界调整列宽；默认启用内置列宽调整插件。 */
     resizable?: boolean;
+    /** 点击行时调用。 */
     onRowClick?: (record: T, index: number) => void;
+    /** 双击行时调用。 */
     onRowDoubleClick?: (record: T, index: number) => void;
+    /** 单元格右键事件，可用于业务上下文菜单 */
     onCellContextMenu?: (record: T, column: TableColumn<T>, index: number, event: MouseEvent<HTMLTableCellElement>) => void;
+    /** 行的 CSS 类名或计算函数。 */
     rowClassName?: string | ((record: T, index: number) => string);
+    /** 表格元素的内联样式。 */
     tableStyle?: CSSProperties;
 }
+/** 表格的实例引用接口。 */
 interface TableRef<T> {
+    /** 读取插件当前处理的行数据。 */
     getRows: () => readonly T[];
+    /** 读取当前表格列配置。 */
     getColumns: () => readonly TableColumn<T>[];
+    /** 按插件标识获取该插件暴露的 API。 */
     getPluginApi: <Api = unknown>(pluginId: string) => Api | undefined;
+    /** 滚动到指定位置。 */
     scrollTo: (options: ScrollToOptions) => void;
+    /** 切换加载状态。 */
     setLoading: (loading: boolean) => void;
+    /** 读取当前分页状态。 */
     getPage: () => {
+        /** 当前页码、步骤或播放位置，具体取值见组件类型。 */
         current: number;
+        /** 每页显示的记录数。 */
         pageSize: number;
     };
+    /** 设置当前页码与分页参数。 */
     setPage: (page: Partial<{
+        /** 当前页码、步骤或播放位置，具体取值见组件类型。 */
         current: number;
+        /** 每页显示的记录数。 */
         pageSize: number;
     }>) => void;
+    /** 清空当前选择。 */
     clearSelection: () => void;
+    /** 设置选中行标识集合。 */
     setSelectedKeys: (keys: readonly TableKey[]) => void;
+    /** 读取当前选中的行数据。 */
     getSelectedRows: () => readonly T[];
+    /** 读取当前排序列及方向。 */
     getSortInfo: () => TableSortInfo | null;
+    /** 读取当前列设置。 */
     getColumnSettings: () => readonly TableColumnSettingItem[];
+    /** 打开列设置面板。 */
     openColumnSetting: () => void;
+    /** 将分页状态转换为业务请求需要的参数。 */
     generatePageParams: <Model extends Record<string, unknown>>(model: Model) => Model & TablePageParams;
+    /** 请求记录总数的函数。 */
     requestCount: (model?: unknown) => Promise<void>;
 }
+/** 当前排序列和排序方向。 */
 interface TableSortInfo {
+    /** 字段名或字段路径。 */
     field: string;
+    /** 排序位置或排序方向。 */
     order: "ascend" | "descend" | null;
+    /** 配置存储的作用域，用于隔离不同模块和业务表格。 */
     scope?: "page" | "all";
 }
+/** 传递给业务数据请求的分页参数。 */
 interface TablePageParams {
+    /** 当前页码、步骤或播放位置，具体取值见组件类型。 */
     current: number;
+    /** 当前页索引。 */
     pageIndex: number;
+    /** 每页显示的记录数。 */
     pageSize: number;
+    /** 请求数据时跳过的记录数。 */
     skipCount: number;
+    /** 请求数据时最多返回的记录数。 */
     maxResultCount: number;
 }
+/** TableColumnSetting的项目定义。 */
 interface TableColumnSettingItem {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 列固定位置，left 固定左侧，right 固定右侧。 */
     fixed?: TableFixed;
+    /** 是否可见。 */
     visible: boolean;
+    /** 排序位置或排序方向。 */
     order: number;
 }
+/** 可持久化的表格列设置和分页大小快照。 */
 interface TableSettingsSnapshot {
+    /** 列配置或选项布局列数，具体类型见签名。 */
     columns?: readonly TableColumnSettingItem[];
+    /** 每页显示的记录数。 */
     pageSize?: number;
+    /** 配置格式版本号，用于兼容历史数据。 */
     version?: number;
 }
+/** 读取与保存表格设置的适配器契约。 */
 interface TableSettingsAdapter {
+    /** 按 scope 读取表格配置；首次挂载及打开列设置时调用。无已保存配置时返回 null 或 undefined。 */
     load: (scope: {
+        /** 所属业务模块名称。 */
         moduleName: string;
+        /** 同一模块内用于区分表格配置的业务标识。 */
         businessKey: string;
     }) => Promise<TableSettingsSnapshot | null>;
+    /** 按 scope 保存完整的列设置快照。用于列设置应用、拖拽列宽结束或分页大小变化后的持久化，可返回 Promise。 */
     save: (scope: {
+        /** 所属业务模块名称。 */
         moduleName: string;
+        /** 同一模块内用于区分表格配置的业务标识。 */
         businessKey: string;
     }, settings: TableSettingsSnapshot) => Promise<void>;
 }
 
+/** 表格组件。 */
 declare const Table: <T extends Record<string, unknown> = Record<string, unknown>>(props: TableProps<T> & {
     ref?: Ref<TableRef<T>>;
 }) => ReactElement | null;
 
+/** TableColumnTransform的插件配置。 */
 interface TableColumnTransformPluginOptions<T> {
+    /** 插入在原有列之前的列配置。 */
     prepend?: readonly TableColumn<T>[];
+    /** 追加在原有列之后的列配置。 */
     append?: readonly TableColumn<T>[];
+    /** 转换表格列配置，返回用于后续处理和渲染的新列集合。 */
     transform?: (columns: readonly TableColumn<T>[]) => readonly TableColumn<T>[];
 }
+/** 创建表格列转换插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createColumnTransformPlugin<T extends Record<string, unknown>>(options: TableColumnTransformPluginOptions<T>): TablePlugin<T, undefined>;
+/** TableHighlight的值类型。 */
 type TableHighlightValue = boolean | CSSProperties;
+/** TableHighlight的插件配置。 */
 interface TableHighlightPluginOptions {
+    /** 当前行记录。 */
     row?: TableHighlightValue;
+    /** 列号或当前列配置，具体含义由所在类型决定。 */
     column?: TableHighlightValue;
+    /** 当前单元格的配置或状态。 */
     cell?: TableHighlightValue;
 }
+/** 当前高亮的行和列。 */
 interface HighlightState {
+    /** 当前高亮行的标识。 */
     rowKey?: TableKey;
+    /** 当前高亮列的标识。 */
     columnKey?: string;
 }
+/** 创建表格行和单元格高亮插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createHighlightPlugin<T extends Record<string, unknown>>(options?: TableHighlightPluginOptions): TablePlugin<T, HighlightState>;
+/** 通过行标识和列标识定位一个单元格。 */
 interface TableCellAddress {
+    /** 行唯一键字段或计算函数 */
     rowKey: TableKey;
+    /** 列的唯一标识，对应 TableColumn.key。 */
     columnKey: string;
 }
+/** 通过起止单元格定义的选区。 */
 interface TableCellRange {
+    /** 单元格选区的起始锚点。 */
     anchor: TableCellAddress;
+    /** 将焦点移入控件。 */
     focus: TableCellAddress;
 }
+/** 选区内一个单元格的值和行列上下文。 */
 interface TableSelectedCell<T> {
+    /** 行唯一键字段或计算函数 */
     rowKey: TableKey;
+    /** 列的唯一标识，对应 TableColumn.key。 */
     columnKey: string;
+    /** 当前业务记录。 */
     record: T;
+    /** 列号或当前列配置，具体含义由所在类型决定。 */
     column: TableColumn<T>;
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: unknown;
+    /** 行索引，从 0 开始。 */
     rowIndex: number;
+    /** 列索引，从 0 开始。 */
     columnIndex: number;
 }
+/** TableCellSelection的插件配置。 */
 interface TableCellSelectionPluginOptions<T> {
+    /** 初始化时的单元格选区。 */
     defaultRange?: TableCellRange | null;
+    /** 是否包含勾选、序号等工具列。 */
     includeUtilityColumns?: boolean;
+    /** 复制完整文本，可指定复制内容和成功回调 */
     copyable?: boolean;
+    /** 判断指定单元格是否允许加入选区。 */
     isCellSelectable?: (record: T, column: TableColumn<T>, rowIndex: number, columnIndex: number) => boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (range: TableCellRange | null, cells: readonly TableSelectedCell<T>[]) => void;
+    /** 复制操作触发后的回调。 */
     onCopy?: (text: string, cells: readonly TableSelectedCell<T>[]) => void;
 }
+/** 表格单元格选区状态。 */
 interface CellSelectionState {
+    /** 当前单元格选区，null 表示无选区。 */
     range: TableCellRange | null;
+    /** 复制选区时是否包含表头。 */
     includeHeaders: boolean;
+    /** 通过表头选择的列标识。 */
     selectedHeaderKey: string | null;
 }
+/** TableCellSelection的操作接口。 */
 interface TableCellSelectionApi<T> {
+    /** 读取当前单元格选区。 */
     getRange: () => TableCellRange | null;
+    /** 设置单元格选区，传入空值可清除选区。 */
     setRange: (range: TableCellRange | null) => void;
+    /** 清空当前值或内容。 */
     clear: () => void;
+    /** 读取当前选区中的单元格信息。 */
     getSelectedCells: () => readonly TableSelectedCell<T>[];
+    /** 将当前选区转换为可复制文本。 */
     getCopyText: () => string;
 }
+/** 创建表格单元格区域选择插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createCellSelectionPlugin<T extends Record<string, unknown>>(options?: TableCellSelectionPluginOptions<T>): TablePlugin<T, CellSelectionState, TableCellSelectionApi<T>>;
+/** TableRowSpan的插件配置。 */
 interface TableRowSpanPluginOptions<T> {
+    /** 列配置或选项布局列数，具体类型见签名。 */
     columns?: readonly string[];
+    /** 自定义两个值的相等性判断。 */
     equals?: (left: unknown, right: unknown, column: TableColumn<T>) => boolean;
+    /** 是否禁用虚拟渲染。 */
     disableVirtual?: boolean;
 }
+/** 创建表格跨行合并插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createRowSpanPlugin<T extends Record<string, unknown>>(options?: TableRowSpanPluginOptions<T>): TablePlugin<T, undefined>;
+/** TableSelection的模式类型。 */
 type TableSelectionMode = "single" | "multiple" | "row";
+/** TableSelection的插件配置。 */
 interface TableSelectionPluginOptions<T> {
+    /** 展示或交互模式；可选值见类型定义。 */
     mode?: TableSelectionMode;
+    /** 当前选中项目的标识集合；传入后由外部控制。 */
     selectedKeys?: readonly TableKey[];
+    /** 非受控模式下初始选中的项目标识集合。 */
     defaultSelectedKeys?: readonly TableKey[];
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (keys: readonly TableKey[], rows: readonly T[]) => void;
+    /** 按行判断其勾选框是否禁用。 */
     getCheckboxDisabled?: (record: T) => boolean;
+    /** 是否展示已选记录数。 */
     showSelectedCount?: boolean;
+    /** 切换页面或数据源时是否保留已选行标识。 */
     preserveSelectedRowKeys?: boolean;
+    /** 是否显示跨页保留勾选的开关。 */
     showPreserveSelectedRowKeys?: boolean;
+    /** 已选记录面板的列数。 */
     selectionPanelColumnCount?: number;
+    /** 已选记录面板最多展示的条数。 */
     selectionPanelMaxCount?: number;
+    /** 跨页保留勾选开关变化时调用。 */
     onPreserveSelectedRowKeysChange?: (preserve: boolean) => void;
+    /** 行数据中存放子行的字段名。 */
     childrenColumnName?: string;
 }
+/** 行勾选和已选面板状态。 */
 interface SelectionState {
+    /** 当前选中的行标识。 */
     selectedKeys: readonly TableKey[];
+    /** 是否跨页保留选中行。 */
     preserveSelectedRowKeys: boolean;
+    /** 已选记录面板是否打开。 */
     panelOpen: boolean;
 }
+/** TableSelection的操作接口。 */
 interface TableSelectionApi<T> {
+    /** 读取当前选中行的标识。 */
     getSelectedKeys: () => readonly TableKey[];
+    /** 设置选中行标识集合。 */
     setSelectedKeys: (keys: readonly TableKey[]) => void;
+    /** 清空当前值或内容。 */
     clear: () => void;
+    /** 切换指定行的选中状态。 */
     toggle: (key: TableKey, checked?: boolean) => void;
+    /** 读取当前选中的行数据。 */
     getSelectedRows: () => readonly T[];
+    /** 读取是否跨页保留选中行。 */
     getPreserveSelectedRowKeys: () => boolean;
+    /** 设置是否跨页保留选中行。 */
     setPreserveSelectedRowKeys: (preserve: boolean) => void;
 }
+/** 创建表格行勾选插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createSelectionPlugin<T extends Record<string, unknown>>(options?: TableSelectionPluginOptions<T>): TablePlugin<T, SelectionState, TableSelectionApi<T>>;
+/** TableSort的插件配置。 */
 interface TableSortPluginOptions {
+    /** 展示或交互模式；可选值见类型定义。 */
     mode?: "local" | "remote";
+    /** 配置存储的作用域，用于隔离不同模块和业务表格。 */
     scope?: "page" | "all";
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: TableSortInfo | null;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: TableSortInfo | null;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (sort: TableSortInfo) => void;
+    /** 比较两条记录的排序函数；负数表示前者排在前面。 */
     compare?: (a: unknown, b: unknown, field: string) => number;
 }
+/** 表格排序状态。 */
 interface SortState {
+    /** 当前排序配置。 */
     sort: TableSortInfo | null;
 }
+/** TableSort的操作接口。 */
 interface TableSortApi {
+    /** 读取当前排序列及方向。 */
     getSortInfo: () => TableSortInfo | null;
+    /** 设置当前排序信息。 */
     setSortInfo: (sort: TableSortInfo | null) => void;
+    /** 清空当前值或内容。 */
     clear: () => void;
 }
+/** 创建表格列排序插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createSortPlugin<T extends Record<string, unknown>>(options?: TableSortPluginOptions): TablePlugin<T, SortState, TableSortApi>;
+/** 列标识到筛选条件的映射。 */
 type TableFilterValues = Readonly<Record<string, string>>;
+/** TableFilter的插件配置。 */
 interface TableFilterPluginOptions<T> {
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value?: TableFilterValues;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: TableFilterValues;
+    /** 未填写或未选择时的提示内容。 */
     placeholder?: string | ((column: TableColumn<T>) => string);
+    /** 用于判断记录是否满足条件的函数。 */
     predicate?: (value: unknown, filterValue: string, record: T, column: TableColumn<T>) => boolean;
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (filters: TableFilterValues) => void;
 }
+/** 表格筛选条件状态。 */
 interface FilterState {
+    /** 按列保存的筛选条件。 */
     filters: Record<string, string>;
 }
+/** TableFilter的操作接口。 */
 interface TableFilterApi<T> {
+    /** 读取当前筛选条件。 */
     getFilters: () => TableFilterValues;
+    /** 设置指定列的筛选条件。 */
     setFilter: (columnKey: string, value: string) => void;
+    /** 清空当前值或内容。 */
     clear: (columnKey?: string) => void;
+    /** 读取应用筛选后的行数据。 */
     getFilteredRows: () => readonly T[];
 }
+/** 创建表格数据筛选插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createFilterPlugin<T extends Record<string, unknown>>(options?: TableFilterPluginOptions<T>): TablePlugin<T, FilterState, TableFilterApi<T>>;
+/** TablePagination的插件配置。 */
 interface TablePaginationPluginOptions {
+    /** 展示或交互模式；可选值见类型定义。 */
     mode?: "local" | "server" | "auto";
+    /** 记录总条数。 */
     totalCount?: number;
+    /** 当前页码、步骤或播放位置，具体取值见组件类型。 */
     current?: number;
+    /** 每页显示的记录数。 */
     pageSize?: number;
+    /** 非受控模式的初始页码或步骤位置。 */
     defaultCurrent?: number;
+    /** 非受控模式下每页默认展示的记录数。 */
     defaultPageSize?: number;
+    /** 每页条数候选项 */
     pageSizeOptions?: readonly number[];
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (current: number, pageSize: number, isFirstLoad?: boolean) => void;
+    /** 按分页上下文异步请求总记录数。 */
     requestTotal?: (model?: unknown) => Promise<void>;
+    /** 是否为首次加载。 */
     isFirstLoad?: boolean;
 }
+/** 表格分页和总数请求状态。 */
 interface PaginationState {
+    /** 当前页码。 */
     current: number;
+    /** 每页记录数。 */
     pageSize: number;
+    /** 是否正在请求记录总数。 */
     requestLoading: boolean;
 }
+/** TablePagination的操作接口。 */
 interface TablePaginationApi {
+    /** 读取当前分页状态。 */
     getPage: () => {
+        /** 当前页码、步骤或播放位置，具体取值见组件类型。 */
         current: number;
+        /** 每页显示的记录数。 */
         pageSize: number;
     };
+    /** 设置当前页码与分页参数。 */
     setPage: (page: Partial<{
+        /** 当前页码、步骤或播放位置，具体取值见组件类型。 */
         current: number;
+        /** 每页显示的记录数。 */
         pageSize: number;
     }>) => void;
+    /** 将分页状态转换为业务请求需要的参数。 */
     generatePageParams: <Model extends Record<string, unknown>>(model: Model) => Model & TablePageParams;
+    /** 请求记录总数的函数。 */
     requestCount: (model?: unknown) => Promise<void>;
 }
+/** 创建表格分页插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createPaginationPlugin<T extends Record<string, unknown>>(options?: TablePaginationPluginOptions): TablePlugin<T, PaginationState, TablePaginationApi>;
+/** TableIndex的插件配置。 */
 interface TableIndexPluginOptions {
+    /** 标题内容，可传入文本或 React 节点。 */
     title?: ReactNode;
+    /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
     width?: number;
+    /** 序号列的起始编号。 */
     startIndex?: number;
 }
+/** 创建表格序号列插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createIndexPlugin<T extends Record<string, unknown>>(options?: TableIndexPluginOptions): TablePlugin<T, undefined>;
+/** TableTree的插件配置。 */
 interface TableTreePluginOptions<T> {
+    /** 行数据中存放子行的字段名。 */
     childrenColumnName?: string;
+    /** 是否忽略数据内的子行字段。 */
     ignoreChildrenColumn?: boolean;
+    /** 受控的展开行标识集合。 */
     expandedRowKeys?: readonly TableKey[];
+    /** 初始化时展开的行标识集合。 */
     defaultExpandedRowKeys?: readonly TableKey[];
+    /** 是否在初始化时展开全部行。 */
     defaultExpandAllRows?: boolean;
+    /** 展开行集合变化时调用。 */
     onExpandedRowsChange?: (keys: readonly TableKey[]) => void;
+    /** 按记录判断是否允许展开该行。 */
     canExpand?: (record: T) => boolean;
 }
+/** 树形行的展开状态。 */
 interface TreeState {
+    /** 已展开的行标识集合。 */
     expandedKeys: readonly TableKey[];
 }
+/** TableTree的操作接口。 */
 interface TableTreeApi {
+    /** 读取展开行或节点的标识集合。 */
     getExpandedKeys: () => readonly TableKey[];
+    /** 设置展开行或节点的标识集合。 */
     setExpandedKeys: (keys: readonly TableKey[]) => void;
+    /** 展开全部可展开行或节点。 */
     expandAll: () => void;
+    /** 收起全部已展开行或节点。 */
     collapseAll: () => void;
 }
+/** 创建表格树形行展开插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createTreePlugin<T extends Record<string, unknown>>(options?: TableTreePluginOptions<T>): TablePlugin<T, TreeState, TableTreeApi>;
+/** TableSummary的插件配置。 */
 interface TableSummaryPluginOptions<T> {
+    /** 当前数据范围的小计配置。 */
     subTotal?: Record<string, ReactNode> | ((pageData: readonly T[]) => Record<string, ReactNode>);
+    /** 数据总数 */
     total?: Record<string, ReactNode>;
+    /** 小计行的标题文案。 */
     subTotalLabel?: ReactNode;
+    /** 总计行的标题文案。 */
     totalLabel?: ReactNode;
 }
+/** 创建表格小计与总计插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createSummaryPlugin<T extends Record<string, unknown>>(options: TableSummaryPluginOptions<T>): TablePlugin<T, undefined>;
+/** 表格当前编辑单元格的状态。 */
 interface EditableState {
+    /** 是否处于编辑状态。 */
     editing: {
+        /** 行唯一键字段或计算函数 */
         rowKey: TableKey;
+        /** 列的唯一标识，对应 TableColumn.key。 */
         columnKey: string;
     } | null;
 }
+/** TableEditable的插件配置。 */
 interface TableEditablePluginOptions<T> {
+    /** 单元格编辑值变化时调用，接收行、列及新旧值等上下文。 */
     onCellChange?: (columnKey: string, record: T, newValue: unknown) => boolean | Promise<boolean>;
+    /** 触发显示的交互方式。 */
     trigger?: "click" | "doubleClick";
 }
+/** TableEditable的操作接口。 */
 interface TableEditableApi {
+    /** 取消当前编辑或操作。 */
     cancel: () => void;
+    /** 读取当前正在编辑的单元格。 */
     getEditingCell: () => EditableState["editing"];
 }
+/** 创建表格单元格编辑插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createEditablePlugin<T extends Record<string, unknown>>(options?: TableEditablePluginOptions<T>): TablePlugin<T, EditableState, TableEditableApi>;
+/** 已调整列宽和手动布局状态。 */
 interface ResizeState {
+    /** 列标识到已调整宽度的映射。 */
     widths: Record<string, number>;
+    /** 是否已启用手动列宽布局。 */
     manualLayout?: boolean;
 }
+/** TableResize的插件配置。 */
 interface TableResizePluginOptions {
+    /** 是否启用该功能。 */
     enabled?: boolean;
+    /** 拖拽调整列宽结束时调用，接收 columnKey 和最终宽度（px）；拖动过程中不会逐帧触发。 */
     onResize?: (columnKey: string, width: number) => void;
 }
+/** TableResize的操作接口。 */
 interface TableResizeApi {
+    /** 读取已调整的列宽映射，键为列标识。 */
     getWidths: () => Readonly<Record<string, number>>;
+    /** 设置指定列的宽度，并通知列宽变更监听者。 */
     setWidth: (columnKey: string, width: number) => void;
 }
+/** 创建表格列宽拖拽调整插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createResizePlugin<T extends Record<string, unknown>>(options?: TableResizePluginOptions): TablePlugin<T, ResizeState, TableResizeApi>;
+/** TableColumnSetting的插件配置。 */
 interface TableColumnSettingPluginOptions<T> {
     /** 设置按钮的完整 Button 属性；className 合并，disabled/loading 同时禁用菜单触发。 */
     buttonProps?: ButtonProps;
@@ -1205,218 +2629,501 @@ interface TableColumnSettingPluginOptions<T> {
     menuItems?: readonly TableToolbarItem<T>[];
     /** 是否显示设置菜单中的导出操作，默认 true。 */
     showExport?: boolean;
+    /** 未读取到保存配置时默认显示的列标识。 */
     defaultVisibleKeys?: readonly string[];
+    /** 是否在工具栏显示此插件的操作按钮。 */
     showButton?: boolean;
+    /** 可见列集合变化时调用。 */
     onVisibleChange?: (columns: readonly TableColumn<T>[]) => void;
+    /** 列顺序变化时调用。 */
     onOrderChange?: (columns: readonly TableColumn<T>[]) => void;
+    /** 配置持久化适配器，提供 load 和 save 方法对接本地或云端存储。 */
     adapter?: TableSettingsAdapter;
+    /** 配置存储的作用域，用于隔离不同模块和业务表格。 */
     scope?: {
+        /** 所属业务模块名称。 */
         moduleName: string;
+        /** 同一模块内用于区分表格配置的业务标识。 */
         businessKey: string;
     };
 }
+/** 列设置插件的加载、面板和持久化状态。 */
 interface ColumnSettingState {
+    /** 列设置面板是否打开。 */
     open: boolean;
+    /** 当前列设置集合。 */
     items: readonly TableColumnSettingItem[];
+    /** 是否已完成一次配置读取。 */
     loaded: boolean;
+    /** 是否正在读取配置。 */
     loading?: boolean;
+    /** 最近一次配置读取是否失败。 */
     loadError?: boolean;
+    /** 用于忽略过期读取响应的请求标记。 */
     loadToken?: symbol;
+    /** 每页记录数。 */
     pageSize?: number;
 }
+/** TableColumnSetting的操作接口。 */
 interface TableColumnSettingApi {
+    /** 打开列设置面板，并通过已配置的适配器重新读取保存配置。 */
     open: () => void;
+    /** 关闭当前界面或实例。 */
     close: () => void;
+    /** 读取当前列设置快照。 */
     getSettings: () => readonly TableColumnSettingItem[];
+    /** 应用传入的配置；是否持久化由方法参数或插件选项控制。 */
     apply: (settings: readonly TableColumnSettingItem[]) => void;
 }
+/** 创建表格列设置和持久化插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createColumnSettingPlugin<T extends Record<string, unknown>>(options?: TableColumnSettingPluginOptions<T>): TablePlugin<T, ColumnSettingState, TableColumnSettingApi>;
+/** 创建使用 localStorage 持久化表格设置的适配器，按模块及业务标识隔离配置。 */
 declare function createLocalStorageTableSettingsAdapter(prefix?: string): TableSettingsAdapter;
+/** TableToolbar的项目定义。 */
 interface TableToolbarItem<T> {
+    /** 唯一标识；同一集合内应保持唯一且稳定，用于定位、渲染和状态关联。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 显示在内容旁的图标节点，建议使用 Icon 组件。 */
     icon?: ReactNode;
+    /** 显示位置或定位配置。 */
     position?: "start" | "end";
+    /** 是否允许该列出现在列设置面板中。 */
     inSettings?: boolean;
+    /** 危险操作样式 */
     danger?: boolean;
+    /** 是否禁用交互。 */
     disabled?: boolean | ((context: TablePluginContext<T, any>) => boolean);
+    /** 是否隐藏此项。 */
     hidden?: boolean | ((context: TablePluginContext<T, any>) => boolean);
+    /** 点击时触发，参数为当前点击事件或项目上下文。 */
     onClick?: (context: TablePluginContext<T, any>) => void | Promise<void>;
 }
+/** TableToolbar的插件配置。 */
 interface TableToolbarPluginOptions<T> {
+    /** 范围起点。 */
     start?: ReactNode;
+    /** 范围终点。 */
     end?: ReactNode;
+    /** 按展示顺序排列的项目配置。 */
     items?: readonly TableToolbarItem<T>[];
+    /** 按业务权限判断是否允许访问或展示。 */
     canAccess?: (item: TableToolbarItem<T>) => boolean;
 }
+/** 创建表格工具栏操作插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createToolbarPlugin<T extends Record<string, unknown>>(options: TableToolbarPluginOptions<T>): TablePlugin<T, undefined>;
+/** 表格导出的数据范围。 */
 type TableExportScope = "visible" | "all" | "selected";
+/** TableExport的插件配置。 */
 interface TableExportPluginOptions<T> {
+    /** 配置存储的作用域，用于隔离不同模块和业务表格。 */
     scope?: TableExportScope;
+    /** 导出文件名。 */
     fileName?: string | ((context: TablePluginContext<T, undefined>) => string);
+    /** CSV 字段分隔符。 */
     delimiter?: "," | "\t" | ";";
+    /** 是否在导出文本前添加 UTF-8 BOM，便于表格软件识别中文。 */
     includeBom?: boolean;
+    /** 是否处理可能被表格软件当作公式执行的单元格文本。 */
     sanitizeFormula?: boolean;
+    /** 操作按钮的显示文案。 */
     buttonLabel?: ReactNode;
+    /** 是否在工具栏显示此插件的操作按钮。 */
     showButton?: boolean;
+    /** 执行导出时调用。 */
     onExport?: (csv: string, rows: readonly T[]) => void | Promise<void>;
 }
+/** TableExport的操作接口。 */
 interface TableExportApi<T> {
+    /** 生成当前导出范围的 CSV 文本。 */
     getCsv: (scope?: TableExportScope) => string;
+    /** 下载当前导出结果。 */
     download: (scope?: TableExportScope) => Promise<void>;
+    /** 读取插件当前处理的行数据。 */
     getRows: (scope?: TableExportScope) => readonly T[];
 }
+/** 创建表格数据导出插件。将返回值加入 Table 的 plugins 后生效。 */
 declare function createExportPlugin<T extends Record<string, unknown>>(options?: TableExportPluginOptions<T>): TablePlugin<T, undefined, TableExportApi<T>>;
 
+/** 主题切换的属性配置。 */
 interface ThemeSwitchProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, "onChange"> {
+    /** 当前是否勾选；作为受控属性时通过回调更新。 */
     checked: boolean;
+    /** 状态变化时返回最新布尔值 */
     onCheckedChange?: (checked: boolean) => void;
+    /**
+     * 亮色主题的显示文案。
+     * @defaultValue "亮色模式"
+     */
     lightLabel?: string;
+    /**
+     * 暗色主题的显示文案。
+     * @defaultValue "暗色模式"
+     */
     darkLabel?: string;
 }
+/** 主题切换组件。 */
 declare const ThemeSwitch: react.ForwardRefExoticComponent<ThemeSwitchProps & react.RefAttributes<HTMLButtonElement>>;
 
+/** 浮动滚动条接入组件的属性配置。 */
 interface FloatingScrollbarProviderProps {
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
     /** 仅接管指定容器；不传时接管页面中的滚动容器。 */
     targetRef?: RefObject<HTMLElement | null>;
 }
+/** 浮动滚动条接入组件组件。 */
 declare function FloatingScrollbarProvider({ disabled, targetRef }: FloatingScrollbarProviderProps): null;
 
+/** SiaTheme的模式类型。 */
 type SiaThemeMode = "light" | "dark";
+/** 框架主题令牌集合。 */
 declare const SIA_THEME: {
+    /** 主色。 */
     readonly colorPrimary: "#1677ff";
+    /** 主色的悬停色。 */
     readonly colorPrimaryHover: "#4096ff";
+    /** 主色的按下色。 */
     readonly colorPrimaryActive: "#0958d9";
+    /** 主要文本颜色。 */
     readonly colorText: "#1f1f1f";
+    /** 次要文本颜色。 */
     readonly colorTextSecondary: "#666666";
+    /** 页面背景颜色。 */
     readonly colorBackground: "#f5f7fa";
+    /** 组件表面颜色。 */
     readonly colorSurface: "#ffffff";
+    /** 默认边框颜色。 */
     readonly colorBorder: "#d9d9d9";
+    /** 默认圆角半径，单位为像素。 */
     readonly borderRadius: 6;
+    /** 默认控件高度，单位为像素。 */
     readonly controlHeight: 32;
+    /** 默认布局间距，单位为像素。 */
     readonly spacing: 16;
+    /** 默认字号，单位为像素。 */
     readonly fontSize: 16;
+    /** 小号文字尺寸，单位为像素。 */
     readonly fontSizeSmall: 14;
+    /** 大号文字尺寸，单位为像素。 */
     readonly fontSizeLarge: 18;
 };
+/** 将亮色或暗色主题应用到指定元素；省略目标时应用到文档根节点。 */
 declare function applySiaTheme(mode: SiaThemeMode, target?: HTMLElement): void;
 
+/** Selection的值类型。 */
 type SelectionValue = string | number;
+/** Selection的候选项定义。 */
 interface SelectionOption {
+    /** 该项目对应的数据值，用于标识、选择或计算。 */
     value: SelectionValue;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 禁用项悬停时显示的原因说明。 */
     disabledTip?: ReactNode;
+    /** 选项所属分组名称。 */
     group?: string;
+    /** 普通或按钮形态 */
     optionType?: "divider";
 }
+/** 分组选择面板的属性配置。 */
 interface SelectionPanelProps {
+    /** 可供用户选择的候选项列表。 */
     options: readonly SelectionOption[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value: readonly SelectionValue[];
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange: (values: SelectionValue[]) => void;
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /** 单选时允许再次点击已选项以清空选择。 */
+    allowDeselect?: boolean;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 是否处于加载状态。
+     * @defaultValue false
+     */
     loading?: boolean;
+    /**
+     是否显示搜索输入框。
+     * @defaultValue true
+     */
     showSearch?: boolean;
+    /**
+     是否显示全选、反选、清空及已选数量操作行。
+     * @defaultValue true
+     */
     showActions?: boolean;
+    /**
+     * 是否将不在 options 中的已选值作为自定义选项展示。
+     * @defaultValue true
+     */
     includeUnknownValues?: boolean;
+    /** 受控的搜索文本。 */
     searchValue?: string;
+    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
     onSearch?: (value: string) => void;
+    /**
+     * 是否只显示已选中的选项。
+     * @defaultValue false
+     */
     selectedOnly?: boolean;
+    /**
+     * 在选项名称下方显示 value，下拉与弹框模式均支持；不影响按 value 搜索
+     * @defaultValue false
+     */
     showValue?: boolean;
+    /**
+     * 选项主文本显示 label 还是 value。
+     * @defaultValue "label"
+     */
     displayField?: "label" | "value";
+    /**
+     * 每行选项列数；长文本在格内单行省略。
+     * @defaultValue 1
+     */
     columns?: number;
+    /**
+     * 允许的最大高度。
+     * @defaultValue 250
+     */
     maxHeight?: number;
+    /**
+     * 面板挂载后是否自动聚焦搜索框。
+     * @defaultValue false
+     */
     autoFocusSearch?: boolean;
 }
 /** 可嵌入下拉或弹窗的分组选择面板，长列表按行虚拟化。 */
-declare function SelectionPanel({ options, value, onChange, multiple, disabled, loading, showSearch, showActions, includeUnknownValues, searchValue, onSearch, selectedOnly, showValue, displayField, columns, maxHeight, autoFocusSearch }: SelectionPanelProps): react.JSX.Element;
+declare function SelectionPanel({ options, value, onChange, multiple, allowDeselect, disabled, loading, showSearch, showActions, includeUnknownValues, searchValue, onSearch, selectedOnly, showValue, displayField, columns, maxHeight, autoFocusSearch }: SelectionPanelProps): react.JSX.Element;
 
+/** 输入选择组合控件的属性配置。 */
 interface InputSelectProps {
+    /** 可供用户选择的候选项列表。 */
     options: readonly SelectionOption[];
+    /** 当前值；作为受控属性时，需要在变更回调中同步更新。 */
     value?: SelectionValue | readonly SelectionValue[] | null;
+    /** 非受控模式的初始值，仅在初始化时使用。 */
     defaultValue?: SelectionValue | readonly SelectionValue[];
+    /** 值发生变化时调用；参数为新值及类型声明中列出的关联信息。 */
     onChange?: (value: SelectionValue | SelectionValue[] | undefined) => void;
+    /**
+     是否允许同时选择多个项目。
+     * @defaultValue false
+     */
     multiple?: boolean;
+    /**
+     * 选项主文本显示 label 还是 value。
+     * @defaultValue "label"
+     */
     displayField?: "label" | "value";
+    /**
+     * 在选项名称下方显示 value，下拉与弹框模式均支持；不影响按 value 搜索
+     * @defaultValue false
+     */
     showValue?: boolean;
+    /**
+     * 未填写或未选择时的提示内容。
+     * @defaultValue "请选择"
+     */
     placeholder?: string;
+    /** 占位提示的显示模式；floating 为浮动标签。 */
     placeholderMode?: InputPlaceholderMode;
+    /** 组件尺寸；用于调整控件高度、字号和间距。 */
     size?: ControlSize;
+    /** 当前状态，用于选择对应的状态样式。 */
     status?: ControlStatus;
+    /**
+     * 是否禁用交互。
+     * @defaultValue false
+     */
     disabled?: boolean;
+    /**
+     * 是否处于加载状态。
+     * @defaultValue false
+     */
     loading?: boolean;
+    /**
+     是否允许清空当前选择或输入值。
+     * @defaultValue true
+     */
     allowClear?: boolean;
+    /** 是否隐藏搜索输入框。 */
     hideSearch?: boolean;
+    /** 手动输入内容的最大长度 */
     inputMaxLength?: number;
+    /** 将输入文本解析为选项值的函数。 */
     parseInput?: (text: string) => SelectionValue | SelectionValue[] | undefined;
+    /** 是否显示通过弹框选择的入口。 */
     enableModal?: boolean | {
+        /** 标题内容，可传入文本或 React 节点。 */
         title?: string;
+        /** 宽度；数值按像素处理，字符串可使用 CSS 尺寸。 */
         width?: number | string;
+        /** 列配置或选项布局列数，具体类型见签名。 */
         columns?: number;
+        /** 允许的最大高度。 */
         maxHeight?: number;
     };
+    /** 输入框后缀 */
     suffix?: ReactNode;
+    /** 组件根节点的内联样式。 */
     style?: CSSProperties;
+    /**
+     * 附加到组件根节点的 CSS 类名。
+     * @defaultValue ""
+     */
     className?: string;
+    /** 唯一标识，用于关联实例或插件。 */
     id?: string;
+    /** 辅助技术读取的控件名称。 */
     "aria-label"?: string;
+    /** 向辅助技术声明该控件是否必填。 */
     "aria-required"?: boolean | "true" | "false";
+    /** 打开状态改变时触发，参数为新的打开状态。 */
     onOpenChange?: (open: boolean) => void;
 }
+/** 输入选择组合控件组件。 */
 declare const InputSelect: react.ForwardRefExoticComponent<InputSelectProps & react.RefAttributes<HTMLInputElement>>;
 
+/** 查询区中的一个字段，复用 Form.Item 绑定能力并增加布局宽度配置。 */
 interface QueryFormField extends FormItemProps {
+    /** 字段布局的稳定唯一标识；用于 React 渲染，不替代 Form.Item 的 name 字段路径。 */
     key: string;
     /** 字段占用宽度，默认由 fieldWidth 控制；组合字段可指定更大的宽度。 */
     width?: number | string;
 }
+/** 预设或已保存的快捷查询，包含名称、条件、颜色和可选数量徽标。 */
 interface QueryFormShortcut<T extends FormValues = FormValues> {
+    /** 快捷查询的稳定唯一标识，用于选中态和 onSearch 的 info.shortcutKey；建议使用后端主键，不使用可变排序索引。 */
     key: string;
+    /** 展示给用户的名称，可传入文本或 React 节点。 */
     label: ReactNode;
+    /** 该快捷查询保存的条件。点击时先恢复表单初始值，再用这些字段覆盖；支持与 Form 字段一致的嵌套数据结构。 */
     values: Partial<T>;
+    /** 是否禁用交互。 */
     disabled?: boolean;
+    /** 底部已保存快捷标签的颜色状态；未指定时使用组件分配的配色。 */
     status?: TagStatus;
     /** 顶部快捷查询按钮尺寸，优先于 quickQuerySize。 */
     size?: ButtonSize;
     /** 该快捷查询对应的数据总量，由业务接口提供。 */
     count?: number;
+    /** 顶部数量徽标的附加属性，例如 overflowCount、showZero 和颜色；徽标数量由同一快捷项的 count 提供。 */
     badgeProps?: Omit<BadgeProps, "children" | "count">;
 }
+/** 本次查询的触发来源及关联快捷查询标识。 */
 interface QueryFormSearchInfo {
+    /** 查询来源：submit 为查询按钮或表单提交，reset 为重置后查询，quick 为顶部预设，saved 为底部已保存条件。 */
     source: "submit" | "reset" | "quick" | "saved";
+    /** 触发查询的快捷项标识；普通查询或重置时可能未提供。 */
     shortcutKey?: string;
 }
+/** 查询表单的属性配置。 */
 interface QueryFormProps<T extends FormValues = FormValues> extends Omit<FormProps, "onFinish" | "children" | "onError"> {
+    /** 查询字段配置，每项包含稳定 key、可选宽度以及 Form.Item 属性；提供后优先于 children。 */
     fields?: readonly QueryFormField[];
     /** 也可直接放入 Form.Item 或 Space.Compact，每个直接子项视为一个查询字段。 */
     children?: ReactNode;
+    /** 表单校验通过后执行查询。values 是完整条件；info.source 区分 submit（查询）、reset（重置）、quick（顶部预设）和 saved（已保存条件）。返回 Promise 时自动显示加载状态并阻止重复提交。 */
     onSearch: (values: T, info: QueryFormSearchInfo) => void | Promise<void>;
+    /**
+     * 是否处于加载状态。
+     * @defaultValue false
+     */
     loading?: boolean;
+    /**
+     * 查询字段的默认宽度，数值单位为像素，可传 CSS 尺寸字符串。
+     * @defaultValue 220
+     */
     fieldWidth?: number | string;
+    /**
+     是否显示展开和收起入口；false 时始终展示全部字段。
+     * @defaultValue true
+     */
     collapsible?: boolean;
+    /** 受控收起状态，需在 onCollapsedChange 中更新。收起时保留字段挂载和值，只隐藏放不下的字段和底部快捷标签。 */
     collapsed?: boolean;
+    /**
+     * 非受控模式的初始收起状态。
+     * @defaultValue false
+     */
     defaultCollapsed?: boolean;
+    /**
+     * 收起时最多保留的字段数；实际数量会根据可用宽度减少，以保持单行。
+     * @defaultValue 3
+     */
     collapsedCount?: number;
+    /** 收起状态变化回调 */
     onCollapsedChange?: (collapsed: boolean) => void;
+    /**
+     * 顶部预设快捷查询按钮。点击后先恢复 initialValues，再覆盖该项 values，校验并自动触发 onSearch。
+     * @defaultValue []
+     */
     quickQueries?: readonly QueryFormShortcut<T>[];
+    /**
+     * 顶部快捷查询按钮的默认尺寸，单项 size 优先。
+     * @defaultValue "small"
+     */
     quickQuerySize?: ButtonSize;
+    /**
+     * 底部已保存快捷查询标签。点击回填该项条件并查询；收起时隐藏。业务方负责加载数据，并在保存或删除成功后更新此数组。
+     * @defaultValue []
+     */
     savedQueries?: readonly QueryFormShortcut<T>[];
+    /**
+     * 快捷查询正在加载或更新时设为 true，期间禁用快捷操作。
+     * @defaultValue false
+     */
     shortcutsLoading?: boolean;
+    /** 点击“另存为快捷查询”并确认名称后调用。query.name 为去除首尾空格的名称，query.values 为打开保存弹框时的条件快照。业务方负责持久化并更新 savedQueries；返回 Promise 时显示等待状态，失败保留弹框供重试。 */
     onSaveQuery?: (query: {
+        /** 用户输入的快捷查询名称，已经去除首尾空格。 */
         name: string;
+        /** 打开保存弹框时的完整查询条件快照。 */
         values: T;
     }) => void | Promise<void>;
+    /** 删除已保存快捷项时调用，query 为被删除的完整快捷项。业务方负责持久化并更新 savedQueries；失败保留该项，删除操作不会触发查询。 */
     onRemoveQuery?: (query: QueryFormShortcut<T>) => void | Promise<void>;
+    /** 查询、保存或删除失败时调用。error 为原始异常，operation 为 search、save 或 remove；组件同时显示错误提示。 */
     onError?: (error: unknown, operation: "search" | "save" | "remove") => void;
+    /**
+     * 查询按钮文案。
+     * @defaultValue "查询"
+     */
     searchText?: ReactNode;
+    /**
+     * 重置按钮文案。
+     * @defaultValue "重置"
+     */
     resetText?: ReactNode;
+    /**
+     * 保存快捷查询按钮文案。
+     * @defaultValue "另存为快捷查询"
+     */
     saveText?: ReactNode;
+    /**
+     * 点击重置后是否自动提交查询；false 时只恢复 initialValues，不调用 onSearch。
+     * @defaultValue true
+     */
     resetSearch?: boolean;
+    /** 查询按钮组旁的自定义操作内容。 */
     actionsExtra?: ReactNode;
 }
 /** 可复用的业务查询表单；快捷查询的存储和结果数据由业务方管理。 */
 declare function QueryForm<T extends FormValues = FormValues>({ fields, children, form: providedForm, onSearch, loading, fieldWidth, collapsible, collapsed: controlledCollapsed, defaultCollapsed, collapsedCount, onCollapsedChange, quickQueries, quickQuerySize, savedQueries, shortcutsLoading, onSaveQuery, onRemoveQuery, onError, searchText, resetText, saveText, resetSearch, actionsExtra, disabled, className, placeholderMode, onValuesChange, onFinishFailed, ...formProps }: QueryFormProps<T>): react.JSX.Element;
 
-export { Alert, type AlertProps, type AlertStatus, type AnyTablePlugin, BadgeProps, ButtonProps, ButtonSize, Cascader, type CascaderFieldNames, type CascaderOption, type CascaderProps, type CascaderValue, Checkbox, type CheckboxGroupProps, type CheckboxOption, type CheckboxProps, type CheckboxValue, Col, type ColProps, type ColSize, ColorPicker, type ColorPickerMode, type ColorPickerPreset, type ColorPickerProps, ControlSize, ControlStatus, DEFAULT_PAGE_SIZE_OPTIONS, Divider, type DividerProps, Drawer, type DrawerOpenConfig, type DrawerPlacement, type DrawerProps, type DrawerPush, type DrawerPushConfig, Editor, type EditorCommand, type EditorCompletionContext, type EditorCompletionItem, type EditorCompletionItemKind, type EditorCompletionProvider, type EditorContextMenuItem, type EditorHandle, type EditorKeyDownEvent, type EditorLanguage, type EditorMarker, type EditorProps, type EditorRange, type EditorSelectionChange, type EditorTheme, type FlatTreeNode, type FlatTreeOptions, Flex, type FlexProps, FloatingScrollbarProvider, type FloatingScrollbarProviderProps, Form, type FormErrorField, type FormInstance, type FormItemProps, type FormListField, type FormListOperation, type FormListProps, type FormProps, type FormRule, type FormValues, type GridBreakpoint, InputNumber, type InputNumberProps, InputPlaceholderMode, InputSelect, type InputSelectProps, type LayoutGap, Markdown, type MarkdownProps, type NamePath, OverlayApiHandle, Pagination, type PaginationProps, QueryForm, type QueryFormField, type QueryFormProps, type QueryFormSearchInfo, type QueryFormShortcut, Radio, type RadioGroupProps, type RadioOption, type RadioProps, type RadioValue, Row, type RowProps, SIA_THEME, type SelectionOption, SelectionPanel, type SelectionPanelProps, type SelectionValue, type SiaThemeMode, Slider, type SliderMark, type SliderProps, type SliderValue, Space, type SpaceCompactProps, type SpaceProps, Splitter, type SplitterPanelProps, type SplitterProps, Switch, type SwitchProps, type SwitchVariant, Table, type TableAlign, type TableCellAddress, type TableCellRange, type TableCellRenderInfo, type TableCellSelectionApi, type TableCellSelectionPluginOptions, type TableColumn, type TableColumnSettingApi, type TableColumnSettingItem, type TableColumnSettingPluginOptions, type TableColumnTransformPluginOptions, type TableEditableApi, type TableEditableCellConfig, type TableEditableCellType, type TableEditablePluginOptions, type TableExportApi, type TableExportPluginOptions, type TableExportScope, type TableFilterApi, type TableFilterPluginOptions, type TableFilterValues, type TableFixed, type TableHighlightPluginOptions, type TableHighlightValue, type TableIndexPluginOptions, type TableKey, type TableMergeStickyConfig, type TablePageParams, type TablePaginationApi, type TablePaginationPluginOptions, type TablePlugin, type TablePluginCellProps, type TablePluginContext, type TablePluginEvent, type TableProps, type TableRef, type TableResizeApi, type TableResizePluginOptions, type TableRow, type TableRowSpanPluginOptions, type TableSelectedCell, type TableSelectionApi, type TableSelectionMode, type TableSelectionPluginOptions, type TableSettingsAdapter, type TableSettingsSnapshot, type TableSize, type TableSortApi, type TableSortInfo, type TableSortPluginOptions, type TableSummaryPluginOptions, type TableSummaryRow, type TableToolbarItem, type TableToolbarPluginOptions, type TableTreeApi, type TableTreePluginOptions, TagStatus, TextArea, type TextAreaProps, ThemeSwitch, type ThemeSwitchProps, TimePicker, type TimePickerProps, type TimeRangePickerProps, ToolPanel, type ToolPanelItem, type ToolPanelPlacement, type ToolPanelProps, TreeSelect, type TreeSelectNode, type TreeSelectProps, type TreeSelectValue, Treemap, type TreemapNode, type TreemapNodeClickInfo, type TreemapNodeKind, type TreemapProps, type WindowAction, type WindowActionHandler, type WindowControlAction, type WindowControlLabels, WindowControls, type WindowControlsProps, WindowFrame, type WindowFrameProps, WindowTitleBar, type WindowTitleBarActionsAlign, type WindowTitleBarProps, applySiaTheme, buildFlatTree, createCellSelectionPlugin, createColumnSettingPlugin, createColumnTransformPlugin, createEditablePlugin, createExportPlugin, createFilterPlugin, createHighlightPlugin, createIndexPlugin, createLocalStorageTableSettingsAdapter, createPaginationPlugin, createResizePlugin, createRowSpanPlugin, createSelectionPlugin, createSortPlugin, createSummaryPlugin, createToolbarPlugin, createTreePlugin, useForm };
+export { Alert, type AlertProps, type AlertStatus, type AnyTablePlugin, BadgeProps, ButtonProps, ButtonSize, Cascader, type CascaderFieldNames, type CascaderOption, type CascaderProps, type CascaderValue, Checkbox, type CheckboxGroupProps, type CheckboxOption, type CheckboxProps, type CheckboxValue, Col, type ColProps, type ColSize, ColorPicker, type ColorPickerMode, type ColorPickerPreset, type ColorPickerProps, ControlSize, ControlStatus, DEFAULT_PAGE_SIZE_OPTIONS, Divider, type DividerProps, Drawer, type DrawerOpenConfig, type DrawerPlacement, type DrawerProps, type DrawerPush, type DrawerPushConfig, Editor, type EditorCommand, type EditorCompletionContext, type EditorCompletionItem, type EditorCompletionItemKind, type EditorCompletionProvider, type EditorContextMenuItem, type EditorHandle, type EditorKeyDownEvent, type EditorLanguage, type EditorMarker, type EditorProps, type EditorRange, type EditorSelectionChange, type EditorTheme, type FlatTreeNode, type FlatTreeOptions, Flex, type FlexProps, FloatingScrollbarProvider, type FloatingScrollbarProviderProps, Form, type FormErrorField, type FormInstance, type FormItemProps, type FormListField, type FormListOperation, type FormListProps, type FormProps, type FormRule, type FormValues, type GridBreakpoint, InputNumber, type InputNumberProps, InputPlaceholderMode, InputSelect, type InputSelectProps, type LayoutGap, Markdown, type MarkdownProps, ModalActionResult, ModalOpenConfig, type NamePath, OverlayApiHandle, Pagination, type PaginationProps, QueryForm, type QueryFormField, type QueryFormProps, type QueryFormSearchInfo, type QueryFormShortcut, Radio, type RadioGroupProps, type RadioOption, type RadioProps, type RadioValue, Row, type RowProps, SIA_THEME, SelectChangeValue, type SelectModalConfig, SelectOption, SelectProps, type SelectionOption, SelectionPanel, type SelectionPanelProps, type SelectionValue, type SiaThemeMode, Slider, type SliderMark, type SliderProps, type SliderValue, Space, type SpaceCompactProps, type SpaceProps, Splitter, type SplitterPanelProps, type SplitterProps, Switch, type SwitchProps, type SwitchVariant, Table, type TableAlign, type TableCellAddress, type TableCellRange, type TableCellRenderInfo, type TableCellSelectionApi, type TableCellSelectionPluginOptions, type TableColumn, type TableColumnSettingApi, type TableColumnSettingItem, type TableColumnSettingPluginOptions, type TableColumnTransformPluginOptions, type TableEditableApi, type TableEditableCellConfig, type TableEditableCellType, type TableEditablePluginOptions, type TableExportApi, type TableExportPluginOptions, type TableExportScope, type TableFilterApi, type TableFilterPluginOptions, type TableFilterValues, type TableFixed, type TableHighlightPluginOptions, type TableHighlightValue, type TableIndexPluginOptions, type TableKey, type TableMergeStickyConfig, type TablePageParams, type TablePaginationApi, type TablePaginationPluginOptions, type TablePlugin, type TablePluginCellProps, type TablePluginContext, type TablePluginEvent, type TableProps, type TableRef, type TableResizeApi, type TableResizePluginOptions, type TableRow, type TableRowSpanPluginOptions, type TableSelectedCell, type TableSelectionApi, type TableSelectionMode, type TableSelectionPluginOptions, type TableSettingsAdapter, type TableSettingsSnapshot, type TableSize, type TableSortApi, type TableSortInfo, type TableSortPluginOptions, type TableSummaryPluginOptions, type TableSummaryRow, type TableToolbarItem, type TableToolbarPluginOptions, type TableTreeApi, type TableTreePluginOptions, TagStatus, TextArea, type TextAreaProps, ThemeSwitch, type ThemeSwitchProps, TimePicker, type TimePickerProps, type TimeRangePickerProps, ToolPanel, type ToolPanelItem, type ToolPanelPlacement, type ToolPanelProps, TreeSelect, type TreeSelectNode, type TreeSelectProps, type TreeSelectValue, Treemap, type TreemapNode, type TreemapNodeClickInfo, type TreemapNodeKind, type TreemapProps, type WindowAction, type WindowActionHandler, type WindowControlAction, type WindowControlLabels, WindowControls, type WindowControlsProps, WindowFrame, type WindowFrameProps, WindowTitleBar, type WindowTitleBarActionsAlign, type WindowTitleBarProps, applySiaTheme, buildFlatTree, createCellSelectionPlugin, createColumnSettingPlugin, createColumnTransformPlugin, createEditablePlugin, createExportPlugin, createFilterPlugin, createHighlightPlugin, createIndexPlugin, createLocalStorageTableSettingsAdapter, createPaginationPlugin, createResizePlugin, createRowSpanPlugin, createSelectionPlugin, createSortPlugin, createSummaryPlugin, createToolbarPlugin, createTreePlugin, openSelectModal, useForm };