@sia.soul/sia-react-ui 0.1.23 → 0.1.24

package/dist/index.css

@@ -4906,6 +4906,37 @@ fieldset:disabled .sia-input-number__floating-placeholder {
 .sia-table-settings__loading {
   min-height: 160px;
 }
+.sia-toolbar {
+  display: flex;
+  align-items: center;
+  position: relative;
+  width: 100%;
+  min-width: 0;
+  gap: 4px;
+  flex-wrap: nowrap;
+  overflow: hidden;
+}
+.sia-toolbar__item {
+  display: inline-flex;
+  flex: 0 0 auto;
+  width: max-content;
+  white-space: nowrap;
+}
+.sia-toolbar__item--hidden {
+  position: absolute;
+  top: 0;
+  left: 0;
+  visibility: hidden;
+  pointer-events: none;
+}
+.sia-table__toolbar > div:first-child {
+  flex: 1;
+  min-width: 0;
+}
+.sia-table__toolbar > div:last-child {
+  flex-shrink: 0;
+  flex-wrap: nowrap;
+}
 
 /* src/components-extra.css */
 .sia-flex {
@@ -9652,6 +9683,27 @@ button.sia-treemap__tile:focus-visible,
   color: var(--sia-color-text-secondary, #777);
 }
 
+/* src/title-tooltip.css */
+body > .sia-title-tooltip[data-sia-popup-layer] {
+  position: fixed;
+  z-index: 1800;
+  display: block;
+  box-sizing: border-box;
+  width: max-content;
+  max-width: min(320px, calc(100vw - 16px));
+  max-height: calc(100vh - 16px);
+  padding: 7px 10px;
+  color: var(--sia-color-text, #1f2329);
+  background: var(--sia-color-surface, #fff);
+  border: 1px solid var(--sia-color-border, #d9d9d9);
+  border-radius: var(--sia-radius, 6px);
+  box-shadow: var(--sia-shadow-popup, 0 4px 16px rgb(0 0 0 / 12%));
+  font: 400 13px/1.5 system-ui, sans-serif;
+  pointer-events: none;
+  overflow-wrap: anywhere;
+  white-space: pre-wrap;
+}
+
 /* src/breadcrumb.css */
 .sia-breadcrumb {
   color: var(--sia-color-text-secondary);

package/dist/index.d.cts

@@ -1,11 +1,11 @@
+import { T as TagStatus, B as BadgeProps } from './core-tbb9ZiBY.cjs';
+export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagVariant, aA as Timeline, aB as TimelineItem, aC as TimelineProps, aD as Toolbar, aE as ToolbarItem, aF as ToolbarProps, aG as Tooltip, aH as TooltipProps, aI as Tour, aJ as TourProps, aK as TourStep, aL as Tree, aM as TreeDropPosition, aN as TreeKey, aO as TreeNode, aP as TreeProps, aQ as Typography, aR as TypographyLinkProps, aS as TypographyProps, aT as TypographyTitleProps, aU as TypographyType, aV as Upload, aW as UploadChangeInfo, aX as UploadDraggerProps, aY as UploadFile, aZ as UploadFileStatus, a_ as UploadProps, a$ as UploadRequestOptions, b0 as Watermark, b1 as WatermarkFont, b2 as WatermarkProps, b3 as message, b4 as notification } from './core-tbb9ZiBY.cjs';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
-import { T as TagStatus, B as BadgeProps } from './core-DF0pknX6.cjs';
-export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagVariant, aA as Timeline, aB as TimelineItem, aC as TimelineProps, aD as Tooltip, aE as TooltipProps, aF as Tour, aG as TourProps, aH as TourStep, aI as Tree, aJ as TreeDropPosition, aK as TreeKey, aL as TreeNode, aM as TreeProps, aN as Typography, aO as TypographyLinkProps, aP as TypographyProps, aQ as TypographyTitleProps, aR as TypographyType, aS as Upload, aT as UploadChangeInfo, aU as UploadDraggerProps, aV as UploadFile, aW as UploadFileStatus, aX as UploadProps, aY as UploadRequestOptions, aZ as Watermark, a_ as WatermarkFont, a$ as WatermarkProps, b0 as message, b1 as notification } from './core-DF0pknX6.cjs';
 import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.cjs';
-import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-BO3VyE2n.cjs';
-export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-BO3VyE2n.cjs';
-export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-IOe6MMqu.cjs';
+import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-W_xpkpOW.cjs';
+export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-W_xpkpOW.cjs';
+export { D as DatePicker, a as DatePickerDisabledInfo, b as DatePickerPreset, c as DatePickerProps, d as DatePickerShowTime, e as DatePickerType, f as DatePickerValue, g as DateRangePickerPreset, h as DateRangePickerProps, S as SelectDateRange, i as SelectDateRangeProps, j as SelectDateRangeValue } from './select-date-range-C9w8z3G8.cjs';
 export { RichTextContent, RichTextContentFormat, RichTextContentProps, RichTextEditor, RichTextEditorProps, RichTextImagePasteHandler, RichTextToolbar } from './rich-text-editor.cjs';
 export { MarkdownEditor, MarkdownEditorMode, MarkdownEditorProps } from './markdown-editor.cjs';
 import * as Monaco from 'monaco-editor';
@@ -1674,28 +1674,38 @@ interface SelectModalConfig extends Omit<ModalOpenConfig, "children" | "footer"
     options: readonly SelectOption[];
     /** 弹框打开时的初始选中值；通过返回句柄 update({ value }) 可替换当前草稿。 */
     value?: SelectChangeValue;
-    /** 展示或交互模式；可选值见类型定义。 */
+    /** 单选或多选模式；single 确认时返回单值，multiple 返回数组。
+     * @defaultValue "single" */
     mode?: SelectProps["mode"];
-    /** 在选项名称下方显示 value，下拉与弹框模式均支持；不影响按 value 搜索 */
+    /** 在选项名称下方另起一行显示 value；关闭此项仍可按 value 搜索。
+     * @defaultValue false */
     showValue?: boolean;
-    /** 弹框选项每行列数；长文本单行省略。 */
+    /** 弹框选项每行列数；长文本单行省略。
+     * @defaultValue 3 */
     columns?: number;
-    /** 允许的最大高度。 */
+    /** 选项列表的最大可视高度，单位为像素；超出时在列表内滚动，不包含标题、搜索区和底部按钮。
+     * @defaultValue 360 */
     maxHeight?: number;
     /** 标题下方的独立首行扩展内容，位于选项范围和搜索框上方。 */
     headerExtra?: ReactNode;
-    /** 扩展控件数据，确认时作为第三个参数传出；可通过句柄 update({ extraValues }) 更新。 */
+    /** 顶部自定义控件的业务数据；框架不会自动绑定 headerExtra 内的控件，需由业务方在变更时调用句柄 update({ extraValues })。确认时将当前对象的浅拷贝作为第三个参数传出，未配置时为 {}；update 会替换整个 extraValues 对象。 */
     extraValues?: Record<string, unknown>;
-    /** 搜索框的占位提示文字。 */
+    /** 搜索框的占位提示文字。
+     * @defaultValue "搜索选项" */
     searchPlaceholder?: string;
-    /** 自定义搜索匹配函数，返回 true 时保留该选项。 */
+    /** 自定义本地搜索：接收去除首尾空白的搜索词和选项，返回 true 时保留。默认同时匹配 label 和 value（忽略大小写）；空搜索词显示全部选项。 */
     filterOption?: SelectProps["filterOption"];
-    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
+    /** 搜索输入变化时调用，参数为未裁剪的输入文本，清空时为空字符串。默认仍执行本地过滤；远程搜索结果需通过句柄 update({ options }) 回填。 */
     onSearch?: SelectProps["onSearch"];
-    /** 确认后接收选中的值和对应选项；单选为单值，多选为数组。支持异步处理；返回 false 或抛出异常时保留弹框，允许重试。 */
+    /** 点击确定时接收 value、option 和 extraValues：单选未选择时前两项为 null，多选为空时为 []；第三项为扩展数据的浅拷贝。返回 Promise 时等待完成并禁用选择操作；返回 false 或抛出异常时保留弹框供重试，否则关闭。取消不调用此回调。 */
     onConfirm?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null, extraValues: Record<string, unknown>) => ModalActionResult;
 }
-/** 无需渲染 Select，直接打开选择弹框。取消不提交，确认支持异步处理及返回 false 阻止关闭。 */
+/**
+ * 无需渲染 Select，直接打开选择弹框；默认标题为“请选择”、宽度为 900px。
+ * 选择操作只更新弹框草稿，点击确定才调用 onConfirm，取消不提交。
+ * @param config 候选项、初始选择、弹框布局与确认回调。
+ * @returns 弹框句柄。update 合并配置并保留当前草稿，显式传 value 可替换草稿；destroy 销毁弹框。
+ */
 declare function openSelectModal(config: SelectModalConfig): OverlayApiHandle<SelectModalConfig>;
 
 /** 矩形树图节点的种类。 */
@@ -2108,6 +2118,9 @@ interface TableProps<T extends Record<string, unknown> = Record<string, unknown>
     stickyHeader?: boolean;
     /** 是否允许拖拽表头边界调整列宽；默认启用内置列宽调整插件。 */
     resizable?: boolean;
+    /** 是否启用单元格选择；false 时禁用（包括显式传入的插件）。启用时显式传入的单元格选择插件优先于内置默认插件。
+     * @defaultValue true */
+    cellSelection?: boolean;
     /** 点击行时调用。 */
     onRowClick?: (record: T, index: number) => void;
     /** 双击行时调用。 */

package/dist/index.d.ts

@@ -1,11 +1,11 @@
+import { T as TagStatus, B as BadgeProps } from './core-BOzLwiXG.js';
+export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagVariant, aA as Timeline, aB as TimelineItem, aC as TimelineProps, aD as Toolbar, aE as ToolbarItem, aF as ToolbarProps, aG as Tooltip, aH as TooltipProps, aI as Tour, aJ as TourProps, aK as TourStep, aL as Tree, aM as TreeDropPosition, aN as TreeKey, aO as TreeNode, aP as TreeProps, aQ as Typography, aR as TypographyLinkProps, aS as TypographyProps, aT as TypographyTitleProps, aU as TypographyType, aV as Upload, aW as UploadChangeInfo, aX as UploadDraggerProps, aY as UploadFile, aZ as UploadFileStatus, a_ as UploadProps, a$ as UploadRequestOptions, b0 as Watermark, b1 as WatermarkFont, b2 as WatermarkProps, b3 as message, b4 as notification } from './core-BOzLwiXG.js';
 import * as react from 'react';
 import { HTMLAttributes, ReactNode, CSSProperties, ElementType, FormHTMLAttributes, InputHTMLAttributes, ChangeEvent, TextareaHTMLAttributes, MouseEvent, Key, PointerEvent, Ref, ReactElement, ButtonHTMLAttributes, RefObject } from 'react';
-import { T as TagStatus, B as BadgeProps } from './core-Cqgl6Z7h.js';
-export { a as Badge, b as BadgeRibbonProps, c as BadgeStatus, d as Breadcrumb, e as BreadcrumbItem, f as BreadcrumbProps, C as Calendar, g as CalendarProps, h as Card, i as CardAccent, j as CardProps, k as Carousel, l as CarouselProps, m as CarouselRef, n as Collapse, o as CollapseItem, p as CollapseKey, q as CollapseProps, D as Dropdown, r as DropdownButtonProps, s as DropdownMenuProps, t as DropdownOpenSource, u as DropdownPlacement, v as DropdownProps, w as DropdownTrigger, F as FILLED_ICON_NAMES, x as FilledIconName, y as FloatButton, z as FloatButtonBackTopProps, A as FloatButtonGroupProps, E as FloatButtonProps, G as FloatButtonShape, H as FloatingPlacement, I as FloatingTrigger, J as ICON_NAMES, K as Icon, L as IconName, M as IconProps, N as IconVariant, O as Image, P as ImagePreview, Q as ImagePreviewConfig, R as ImagePreviewProps, S as ImageProps, U as Input, V as InputProps, W as Menu, X as MenuClickInfo, Y as MenuItem, Z as MenuMode, _ as MenuProps, $ as MenuTheme, a0 as MessageConfig, a1 as MessageHandle, a2 as MessageKey, a3 as MessageType, a4 as NotificationConfig, a5 as NotificationPlacement, a6 as NotificationType, a7 as Popconfirm, a8 as PopconfirmProps, a9 as Popover, aa as PopoverProps, ab as Progress, ac as ProgressProps, ad as ProgressStatus, ae as Rate, af as RateProps, ag as Segmented, ah as SegmentedOption, ai as SegmentedProps, aj as SegmentedValue, ak as Spin, al as SpinProps, am as StepItem, an as StepStatus, ao as Steps, ap as StepsProps, aq as TabItem, ar as Tabs, as as TabsContextMenuClickInfo, at as TabsOrientation, au as TabsPosition, av as TabsProps, aw as TabsType, ax as Tag, ay as TagProps, az as TagVariant, aA as Timeline, aB as TimelineItem, aC as TimelineProps, aD as Tooltip, aE as TooltipProps, aF as Tour, aG as TourProps, aH as TourStep, aI as Tree, aJ as TreeDropPosition, aK as TreeKey, aL as TreeNode, aM as TreeProps, aN as Typography, aO as TypographyLinkProps, aP as TypographyProps, aQ as TypographyTitleProps, aR as TypographyType, aS as Upload, aT as UploadChangeInfo, aU as UploadDraggerProps, aV as UploadFile, aW as UploadFileStatus, aX as UploadProps, aY as UploadRequestOptions, aZ as Watermark, a_ as WatermarkFont, a$ as WatermarkProps, b0 as message, b1 as notification } from './core-Cqgl6Z7h.js';
 import { C as ControlSize, I as InputPlaceholderMode, a as ControlStatus } from './shared-Bx4B28Wh.js';
-import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-BoVx-D0D.js';
-export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-BoVx-D0D.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-a6nzK7Wu.js';
+import { O as OverlayContainer, a as OverlayApiHandle, M as ModalOpenConfig, S as SelectOption, b as SelectChangeValue, c as SelectProps, d as ModalActionResult, B as ButtonProps, e as ButtonSize } from './Select-O_yY51vc.js';
+export { f as Button, g as ButtonVariant, h as Modal, i as ModalProps, j as ModalType, k as Select, l as SelectMode, m as SelectValue } from './Select-O_yY51vc.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-BjqFUeU6.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';
@@ -1674,28 +1674,38 @@ interface SelectModalConfig extends Omit<ModalOpenConfig, "children" | "footer"
     options: readonly SelectOption[];
     /** 弹框打开时的初始选中值；通过返回句柄 update({ value }) 可替换当前草稿。 */
     value?: SelectChangeValue;
-    /** 展示或交互模式；可选值见类型定义。 */
+    /** 单选或多选模式；single 确认时返回单值，multiple 返回数组。
+     * @defaultValue "single" */
     mode?: SelectProps["mode"];
-    /** 在选项名称下方显示 value，下拉与弹框模式均支持；不影响按 value 搜索 */
+    /** 在选项名称下方另起一行显示 value；关闭此项仍可按 value 搜索。
+     * @defaultValue false */
     showValue?: boolean;
-    /** 弹框选项每行列数；长文本单行省略。 */
+    /** 弹框选项每行列数；长文本单行省略。
+     * @defaultValue 3 */
     columns?: number;
-    /** 允许的最大高度。 */
+    /** 选项列表的最大可视高度，单位为像素；超出时在列表内滚动，不包含标题、搜索区和底部按钮。
+     * @defaultValue 360 */
     maxHeight?: number;
     /** 标题下方的独立首行扩展内容，位于选项范围和搜索框上方。 */
     headerExtra?: ReactNode;
-    /** 扩展控件数据，确认时作为第三个参数传出；可通过句柄 update({ extraValues }) 更新。 */
+    /** 顶部自定义控件的业务数据；框架不会自动绑定 headerExtra 内的控件，需由业务方在变更时调用句柄 update({ extraValues })。确认时将当前对象的浅拷贝作为第三个参数传出，未配置时为 {}；update 会替换整个 extraValues 对象。 */
     extraValues?: Record<string, unknown>;
-    /** 搜索框的占位提示文字。 */
+    /** 搜索框的占位提示文字。
+     * @defaultValue "搜索选项" */
     searchPlaceholder?: string;
-    /** 自定义搜索匹配函数，返回 true 时保留该选项。 */
+    /** 自定义本地搜索：接收去除首尾空白的搜索词和选项，返回 true 时保留。默认同时匹配 label 和 value（忽略大小写）；空搜索词显示全部选项。 */
     filterOption?: SelectProps["filterOption"];
-    /** 搜索条件变化或提交搜索时调用，具体参数见签名。 */
+    /** 搜索输入变化时调用，参数为未裁剪的输入文本，清空时为空字符串。默认仍执行本地过滤；远程搜索结果需通过句柄 update({ options }) 回填。 */
     onSearch?: SelectProps["onSearch"];
-    /** 确认后接收选中的值和对应选项；单选为单值，多选为数组。支持异步处理；返回 false 或抛出异常时保留弹框，允许重试。 */
+    /** 点击确定时接收 value、option 和 extraValues：单选未选择时前两项为 null，多选为空时为 []；第三项为扩展数据的浅拷贝。返回 Promise 时等待完成并禁用选择操作；返回 false 或抛出异常时保留弹框供重试，否则关闭。取消不调用此回调。 */
     onConfirm?: (value: SelectChangeValue, option: SelectOption | SelectOption[] | null, extraValues: Record<string, unknown>) => ModalActionResult;
 }
-/** 无需渲染 Select，直接打开选择弹框。取消不提交，确认支持异步处理及返回 false 阻止关闭。 */
+/**
+ * 无需渲染 Select，直接打开选择弹框；默认标题为“请选择”、宽度为 900px。
+ * 选择操作只更新弹框草稿，点击确定才调用 onConfirm，取消不提交。
+ * @param config 候选项、初始选择、弹框布局与确认回调。
+ * @returns 弹框句柄。update 合并配置并保留当前草稿，显式传 value 可替换草稿；destroy 销毁弹框。
+ */
 declare function openSelectModal(config: SelectModalConfig): OverlayApiHandle<SelectModalConfig>;
 
 /** 矩形树图节点的种类。 */
@@ -2108,6 +2118,9 @@ interface TableProps<T extends Record<string, unknown> = Record<string, unknown>
     stickyHeader?: boolean;
     /** 是否允许拖拽表头边界调整列宽；默认启用内置列宽调整插件。 */
     resizable?: boolean;
+    /** 是否启用单元格选择；false 时禁用（包括显式传入的插件）。启用时显式传入的单元格选择插件优先于内置默认插件。
+     * @defaultValue true */
+    cellSelection?: boolean;
     /** 点击行时调用。 */
     onRowClick?: (record: T, index: number) => void;
     /** 双击行时调用。 */