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

package/dist/index.d.ts

@@ -1,921 +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, M as ModalOpenConfig, b as ModalActionResult, B as ButtonProps, T as TagStatus, c as ButtonSize, d as BadgeProps } from './core-CdoVqv0o.js';
-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-CdoVqv0o.js';
-import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-DAYZvZVu.js';
-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-D-ynrB5k.js';
+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-DeZknKwc.js';
+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-DeZknKwc.js';
+import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.js';
+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-CGRb3-W8.js';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.js';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.js';
 import * as Monaco from 'monaco-editor';
-import { S as SelectOption, a as SelectChangeValue, b as SelectProps } from './Select-Cz3hzQl_.js';
-export { c as Select, d as SelectMode, e as SelectValue } from './Select-Cz3hzQl_.js';
+import { S as SelectOption, a as SelectChangeValue, b as SelectProps } from './Select-BNSE67xn.js';
+export { c as Select, d as SelectMode, e as SelectValue } from './Select-BNSE67xn.js';
 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.js';
 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;
@@ -923,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;
@@ -1221,217 +2629,498 @@ 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, 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;
 }
 /** 可复用的业务查询表单；快捷查询的存储和结果数据由业务方管理。 */