@canvas-components/list-table 0.3.25 → 0.3.27

package/dist/index.d.cts

@@ -1,7 +1,8 @@
-import * as antDesignIcons from '@ant-design/icons-svg';
-import { CanvasChartPieOption, CanvasChartRadarOption, CanvasChartGaugeOption, CanvasChartSparklineOption } from '@canvas-components/chart';
+import * as _canvas_components_utils from '@canvas-components/utils';
 import { CanvasScrollbarOptions, XlsxExportOptions } from '@canvas-components/utils';
 export { CanvasScrollbarAxisOptions as ListTableScrollbarAxisOptions } from '@canvas-components/utils';
+import * as antDesignIcons from '@ant-design/icons-svg';
+import { CanvasChartPieOption, CanvasChartRadarOption, CanvasChartGaugeOption, CanvasChartSparklineOption } from '@canvas-components/chart';
 
 /**
  * 排序状态。
@@ -293,7 +294,7 @@ interface ListTableDebugSnapshot {
 }
 
 /** 可单独控制持久化的表格配置；列设置及条件格式使用各自已有开关。 */
-type ListTableCacheCategory = "sort" | "filter" | "summary" | "alignment" | "dataFormat" | "density" | "zoom";
+type ListTableCacheCategory = "sort" | "filter" | "summary" | "alignment" | "dataFormat" | "density" | "zoom" | "scrollbar";
 /** 未指定的缓存类别默认开启，持久化需要 storageKey。 */
 type ListTableCachePreferences = Partial<Record<ListTableCacheCategory, boolean>>;
 
@@ -477,6 +478,8 @@ interface ListTableTreeSelectNode {
 type ListTableSorter<RecordType> = boolean | {
     /** 多列排序优先级，数值越大越优先。 */
     multiple?: number;
+    /** 排序切换或动态数据更新后，为可视行的名次变化播放上下位移动画。默认关闭。 */
+    animation?: boolean;
     /** 自定义记录比较，优先于 sortValueGetter；大数据使用主线程可取消分片。 */
     compare?: (a: RecordType, b: RecordType) => number;
 };
@@ -1174,6 +1177,10 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
     summaryStyle?: ListTableCellStyle;
     /** 汇总行配置。设为 `true` 等效于 `{ type: "sum" }`。 */
     summary?: boolean | ListTableSummaryConfig<RecordType>;
+    /** 默认加入分组栏；order 数值越小，分组层级越靠前，同值按列顺序。 */
+    grouping?: boolean | {
+        order?: number;
+    };
     /** 汇总行标题。设置后该列在汇总行中显示此标题文本（用于"合计"等标签列）。 */
     summaryTitle?: string;
     meta?: Record<string, unknown>;
@@ -1181,6 +1188,8 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
 
 interface ListTableChartData {
     labels: string[];
+    /** 与 labels 对齐的稳定类别标识，用于排序后的图形位置过渡。 */
+    keys?: Array<string | number>;
     series: Array<{
         name: string;
         data: number[];
@@ -1307,11 +1316,8 @@ interface ListTableDangerConfirmRequest {
     onCancel: () => void;
 }
 /** 导出前确认文件名称。 */
-interface ListTableExportNameRequest {
-    fileName: string;
-    onConfirm: (fileName: string) => void;
-    onCancel: () => void;
-}
+type ListTableExportColumnChoice = _canvas_components_utils.TableExportColumnChoice;
+type ListTableExportNameRequest = _canvas_components_utils.TableExportNameRequest;
 interface HeaderContextMenuColumnItem {
     key: string;
     title: string;
@@ -1321,6 +1327,7 @@ interface HeaderContextMenuColumnItem {
     minWidth?: number;
     maxWidth?: number;
     fixed?: "left" | "right";
+    sortable?: boolean;
     order?: number;
     siblingCount?: number;
     checked: boolean;
@@ -1338,10 +1345,20 @@ interface HeaderContextMenuColumnDraft {
     minWidth?: number;
     maxWidth?: number;
     fixed?: "left" | "right";
+    sortOrder?: "ascend" | "descend" | null;
     order?: number;
 }
 type HeaderContextMenuDensity = "comfortable" | "middle" | "compact" | "ultra-compact" | "auto";
 interface HeaderContextMenuConfig {
+    /** 右键命中滚动条时仅展示滚动条相关操作。 */
+    scrollbarArea?: boolean;
+    scrollbarRowCount?: number;
+    scrollbarColumnCount?: number;
+    onScrollToPosition?: (row?: number, column?: number) => void;
+    /** 当前画布滚动条配置。 */
+    scrollbar?: ListTableScrollbarOptions;
+    onChangeScrollbar?: (value: ListTableScrollbarOptions) => void;
+    onResetScrollbar?: () => void;
     /** 根据当前选区创建图表。 */
     onCreateChart?: () => ListTableChartData | null;
     conditionalFormats?: ListTableConditionalFormatRule[];
@@ -1352,6 +1369,7 @@ interface HeaderContextMenuConfig {
     x: number;
     y: number;
     columns?: HeaderContextMenuColumnItem[];
+    sortState?: ListTableSortState;
     dataIndexOptions?: Array<{
         value: string;
         disabled: boolean;
@@ -1924,6 +1942,8 @@ interface ListTableQuerySorter {
     field?: TableColumnDataIndex;
     order: "ascend" | "descend";
     priority?: number;
+    /** 对应列是否启用排序行位移动画。 */
+    animation?: boolean;
 }
 /**
  * 分页配置。
@@ -2088,7 +2108,7 @@ interface ListTableExpandableOptions<RecordType = Record<string, unknown>> {
 /**
  * UI 适配层配置。
  */
-interface ListTableUiOptions {
+interface ListTableUiOptions<RecordType = unknown> {
     /** 导出文件名输入弹窗；未提供时使用浏览器输入框。 */
     onExportNameRequest?: (request: ListTableExportNameRequest | null) => void;
     editorFactory?: ListTableEditorFactory;
@@ -2105,6 +2125,10 @@ interface ListTableUiOptions {
     onDangerConfirmRequest?: (request: ListTableDangerConfirmRequest | null) => void;
     /** 持久化配置或内部操作改变表格密度时通知适配层。 */
     onDensityChange?: (density: 26 | 32 | 48 | 56 | "auto") => void;
+    /** 恢复持久化滚动条配置后同步到适配层。 */
+    onScrollbarChange?: (scrollbar: ListTableScrollbarOptions) => void;
+    /** 同步恢复或内部修改后的列设置到适配层。 */
+    onColumnSettingsChange?: (columns: ListTableColumn<RecordType>[]) => void;
     /** 同步列设置缓存开关。 */
     onColumnSettingsCacheChange?: (enabled: boolean) => void;
     /** 同步各类配置的缓存偏好。 */
@@ -2162,6 +2186,8 @@ interface ListTableOptions<RecordType = Record<string, unknown>> {
      */
     height?: number | string;
     columns: ListTableColumn<RecordType>[];
+    /** 隐藏列时是否在表头展示恢复折叠列的图标，默认展示。 */
+    showCollapsedColumnIcon?: boolean;
     dataSource: RecordType[];
     /**
      * 数据是否仍在加载或分批生成。
@@ -2193,6 +2219,13 @@ interface ListTableOptions<RecordType = Record<string, unknown>> {
      * @default "row"
      */
     highlightMode?: ListTableHighlightMode;
+    /** 点击空白画布或表格外部时清除单元格、行列及汇总行的高亮选区；默认均不开启。 */
+    clearSelectionOnClick?: {
+        /** 点击画布内没有单元格或控件的空白区域时清除选区。 */
+        blankCanvas?: boolean;
+        /** 点击表格容器外部时清除选区。 */
+        outside?: boolean;
+    };
     /** 键盘活动单元格的边界导航配置。 */
     keyboardNavigation?: ListTableKeyboardNavigationOptions;
     /**
@@ -2272,9 +2305,15 @@ interface ListTableOptions<RecordType = Record<string, unknown>> {
      */
     contextMenu?: false | ListTableContextMenuOptions;
     debug?: ListTableDebugOptions;
-    ui?: ListTableUiOptions;
+    ui?: ListTableUiOptions<RecordType>;
 }
 
+/** 导出弹窗的逐列汇总选择；title 表示保留原汇总标题。 */
+type ListTableExportSummaryType = _canvas_components_utils.TableExportSummaryType;
+/** 本次导出的逐列汇总展示配置。 */
+type ListTableExportSummarySettings = _canvas_components_utils.TableExportSummarySettings;
+/** 仅作用于本次文件导出的列与汇总配置。 */
+type ListTableExportSettings = _canvas_components_utils.TableExportSettings;
 /**
  * 表格实例滚动参数。
  */
@@ -2295,6 +2334,8 @@ interface ListTableExportXlsxOptions extends XlsxExportOptions {
     fileName?: string;
     /** 是否在数据末尾追加按当前列配置计算的汇总行，默认跟随表格汇总行的显示状态。 */
     includeSummary?: boolean;
+    /** 本次导出的列顺序、逐列汇总方式和汇总行开关。 */
+    settings?: ListTableExportSettings;
     /** 导出失败通知；已保存的分文件不会撤回，取消不触发此回调。 */
     onError?: (error: unknown) => void;
 }
@@ -2371,6 +2412,10 @@ declare class ListTable<RecordType = Record<string, unknown>> {
      * 重置排序状态。
      */
     resetSorter(): void;
+    /** 获取当前排序状态。 */
+    getSortState(): ListTableSortItem[];
+    /** 设置指定列的排序方式。 */
+    setSortOrder(columnKey: string, order: "ascend" | "descend" | null): void;
     /**
      * 重置筛选状态。
      */
@@ -2455,4 +2500,4 @@ interface ListTableValidationTarget {
     columnKey: string;
 }
 
-export { type CreateCellEditorSessionParams, type DebugHitTestResult, EXPAND_COLUMN, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, type HeaderContextMenuColumnDraft, type HeaderContextMenuColumnItem, type HeaderContextMenuConfig, type HeaderContextMenuDensity, ListTable, type ListTableAntdIconName, type ListTableAutoMergeRule, type ListTableBarcodeCellContent, type ListTableBarcodeFormat, type ListTableBuiltinIconName, type ListTableButtonCellContent, type ListTableButtonPopconfirmOptions, type ListTableButtonSize, type ListTableButtonType, type ListTableCSSProperties, type ListTableCacheCategory, type ListTableCachePreferences, type ListTableCarouselScrollOptions, type ListTableCellContent, type ListTableCellContentClickContext, type ListTableCellEditorSession, type ListTableCellSpan, type ListTableCellStyle, type ListTableChartCellContent, type ListTableChartData, type ListTableChartSize, type ListTableChartType, type ListTableColorCellContent, type ListTableColumn, type ListTableConditionalFormatCondition, type ListTableConditionalFormatRule, type ListTableConditionalOperator, type ListTableContextMenuFeature, type ListTableContextMenuOptions, type ListTableCustomChartCellContent, type ListTableDangerConfirmRequest, type ListTableDataFormat, type ListTableDataFormatOptions, type ListTableDataFormatType, type ListTableDebugOptions, type ListTableDebugSnapshot, type ListTableDensity, type ListTableEditAutoCompleteEnter, type ListTableEditFilterOption, type ListTableEditOption, type ListTableEditValueType, type ListTableEditable, type ListTableEditorAutoCompleteEnter, type ListTableEditorConfig, type ListTableEditorFactory, type ListTableEditorFilterOption, type ListTableEditorNavigateDirection, type ListTableEditorOption, type ListTableEditorRect, type ListTableEditorRequest, type ListTableEditorTheme, type ListTableEditorValueType, type ListTableEmojiCellContent, type ListTableExperimentalOptions, type ListTableExportNameRequest, type ListTableExportXlsxOptions, type ListTableFilterCondition$1 as ListTableFilterCondition, type ListTableFilterConditionOperator, type ListTableFilterConditionRelation, type ListTableFilterMatchMode, type ListTableFilterOption, type ListTableFilterOptionValue, type ListTableFilterPanelAdapter, type ListTableFilterState, type ListTableFilterType, type ListTableFilterValue$1 as ListTableFilterValue, type ListTableFixedPopupAdapter, type ListTableFormItemProps, type ListTableFormItemPropsConfig, type ListTableFormRule, type ListTableFormRules, type ListTableGaugeChartCellContent, type ListTableGroupingOptions, type ListTableHeaderContextMenuAdapter, type ListTableHighlightMode, type ListTableHorizontalAlign, type ListTableIconCellContent, type ListTableImageCellContent, type ListTableImageObjectFit, type ListTableImagePreviewRequest, type ListTableKeyboardNavigationOptions, type ListTableLoadingAdapter, type ListTableLoadingRequest, type ListTableMergeCellOptions, type ListTableNestedTableCellContent, type ListTableNestedTableColumn, type ListTableOffscreenCanvasStatusInfo, type ListTableOptions, type ListTablePaginationAdapter, type ListTablePaginationCSSProperties, type ListTablePaginationOptions, type ListTablePaginationStyleSlot, type ListTablePaginationStyles, type ListTablePerformanceMetric, type ListTablePieChartCellContent, type ListTableProgressCellContent, type ListTableProgressShape, type ListTableProgressSize, type ListTableQrCodeCellContent, type ListTableQrCodeLevel, type ListTableQueryChange, type ListTableQueryChangeExtra, type ListTableQueryFilters, type ListTableQueryOptions, type ListTableQueryPagination, type ListTableQuerySorter, type ListTableRadarChartCellContent, type ListTableRateCellContent, type ListTableRateSize, type ListTableRateSymbolType, type ListTableRowDragMode, type ListTableRowDragOptions, type ListTableRowDragPayload, type ListTableRowDragSourceInfo, type ListTableRowDragZone, type ListTableRowEventProps, type ListTableRowSelectionChangeInfo, type ListTableRowSelectionOptions, type ListTableRowSelectorOptions, type ListTableScrollToOptions, type ListTableScrollbarCSSProperties, type ListTableScrollbarOptions, type ListTableSearchMode, type ListTableSearchOptions, type ListTableSearchRequest, type ListTableSelectionState, type ListTableServerSummaryValues, type ListTableSortItem, type ListTableSortState, type ListTableSorter, type ListTableSparklineChartCellContent, type ListTableSparklineSize, type ListTableStyles, type ListTableSummaryConfig, type ListTableSummaryRoundingMode, type ListTableSummaryType, type ListTableSymbolType, type ListTableTagCellContent, type ListTableTheme, type ListTableTimelineCellContent, type ListTableTimelineItem, type ListTableTooltipAdapter, type ListTableTooltipRequest, type ListTableTreeSelectNode, type ListTableUiOptions, type ListTableUploadConfig, type ListTableUploadFile, type ListTableUploadRequest, type ListTableValidationError, type ListTableValidationErrorField, type ListTableValidationFailure, type ListTableValidationTarget, type PaginationConfig, ROW_SELECTION_COLUMN, type RenderCellDescriptor, SELECTION_COLUMN, getListTableStoredPageSize, listTableAntdIconNames, listTableBuiltinIconNames, listTableIconNames, resetListTableStoredColumnConfig };
+export { type CreateCellEditorSessionParams, type DebugHitTestResult, EXPAND_COLUMN, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, type HeaderContextMenuColumnDraft, type HeaderContextMenuColumnItem, type HeaderContextMenuConfig, type HeaderContextMenuDensity, ListTable, type ListTableAntdIconName, type ListTableAutoMergeRule, type ListTableBarcodeCellContent, type ListTableBarcodeFormat, type ListTableBuiltinIconName, type ListTableButtonCellContent, type ListTableButtonPopconfirmOptions, type ListTableButtonSize, type ListTableButtonType, type ListTableCSSProperties, type ListTableCacheCategory, type ListTableCachePreferences, type ListTableCarouselScrollOptions, type ListTableCellContent, type ListTableCellContentClickContext, type ListTableCellEditorSession, type ListTableCellSpan, type ListTableCellStyle, type ListTableChartCellContent, type ListTableChartData, type ListTableChartSize, type ListTableChartType, type ListTableColorCellContent, type ListTableColumn, type ListTableConditionalFormatCondition, type ListTableConditionalFormatRule, type ListTableConditionalOperator, type ListTableContextMenuFeature, type ListTableContextMenuOptions, type ListTableCustomChartCellContent, type ListTableDangerConfirmRequest, type ListTableDataFormat, type ListTableDataFormatOptions, type ListTableDataFormatType, type ListTableDebugOptions, type ListTableDebugSnapshot, type ListTableDensity, type ListTableEditAutoCompleteEnter, type ListTableEditFilterOption, type ListTableEditOption, type ListTableEditValueType, type ListTableEditable, type ListTableEditorAutoCompleteEnter, type ListTableEditorConfig, type ListTableEditorFactory, type ListTableEditorFilterOption, type ListTableEditorNavigateDirection, type ListTableEditorOption, type ListTableEditorRect, type ListTableEditorRequest, type ListTableEditorTheme, type ListTableEditorValueType, type ListTableEmojiCellContent, type ListTableExperimentalOptions, type ListTableExportColumnChoice, type ListTableExportNameRequest, type ListTableExportSettings, type ListTableExportSummarySettings, type ListTableExportSummaryType, type ListTableExportXlsxOptions, type ListTableFilterCondition$1 as ListTableFilterCondition, type ListTableFilterConditionOperator, type ListTableFilterConditionRelation, type ListTableFilterMatchMode, type ListTableFilterOption, type ListTableFilterOptionValue, type ListTableFilterPanelAdapter, type ListTableFilterState, type ListTableFilterType, type ListTableFilterValue$1 as ListTableFilterValue, type ListTableFixedPopupAdapter, type ListTableFormItemProps, type ListTableFormItemPropsConfig, type ListTableFormRule, type ListTableFormRules, type ListTableGaugeChartCellContent, type ListTableGroupingOptions, type ListTableHeaderContextMenuAdapter, type ListTableHighlightMode, type ListTableHorizontalAlign, type ListTableIconCellContent, type ListTableImageCellContent, type ListTableImageObjectFit, type ListTableImagePreviewRequest, type ListTableKeyboardNavigationOptions, type ListTableLoadingAdapter, type ListTableLoadingRequest, type ListTableMergeCellOptions, type ListTableNestedTableCellContent, type ListTableNestedTableColumn, type ListTableOffscreenCanvasStatusInfo, type ListTableOptions, type ListTablePaginationAdapter, type ListTablePaginationCSSProperties, type ListTablePaginationOptions, type ListTablePaginationStyleSlot, type ListTablePaginationStyles, type ListTablePerformanceMetric, type ListTablePieChartCellContent, type ListTableProgressCellContent, type ListTableProgressShape, type ListTableProgressSize, type ListTableQrCodeCellContent, type ListTableQrCodeLevel, type ListTableQueryChange, type ListTableQueryChangeExtra, type ListTableQueryFilters, type ListTableQueryOptions, type ListTableQueryPagination, type ListTableQuerySorter, type ListTableRadarChartCellContent, type ListTableRateCellContent, type ListTableRateSize, type ListTableRateSymbolType, type ListTableRowDragMode, type ListTableRowDragOptions, type ListTableRowDragPayload, type ListTableRowDragSourceInfo, type ListTableRowDragZone, type ListTableRowEventProps, type ListTableRowSelectionChangeInfo, type ListTableRowSelectionOptions, type ListTableRowSelectorOptions, type ListTableScrollToOptions, type ListTableScrollbarCSSProperties, type ListTableScrollbarOptions, type ListTableSearchMode, type ListTableSearchOptions, type ListTableSearchRequest, type ListTableSelectionState, type ListTableServerSummaryValues, type ListTableSortItem, type ListTableSortState, type ListTableSorter, type ListTableSparklineChartCellContent, type ListTableSparklineSize, type ListTableStyles, type ListTableSummaryConfig, type ListTableSummaryRoundingMode, type ListTableSummaryType, type ListTableSymbolType, type ListTableTagCellContent, type ListTableTheme, type ListTableTimelineCellContent, type ListTableTimelineItem, type ListTableTooltipAdapter, type ListTableTooltipRequest, type ListTableTreeSelectNode, type ListTableUiOptions, type ListTableUploadConfig, type ListTableUploadFile, type ListTableUploadRequest, type ListTableValidationError, type ListTableValidationErrorField, type ListTableValidationFailure, type ListTableValidationTarget, type PaginationConfig, ROW_SELECTION_COLUMN, type RenderCellDescriptor, SELECTION_COLUMN, getListTableStoredPageSize, listTableAntdIconNames, listTableBuiltinIconNames, listTableIconNames, resetListTableStoredColumnConfig };

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-import * as antDesignIcons from '@ant-design/icons-svg';
-import { CanvasChartPieOption, CanvasChartRadarOption, CanvasChartGaugeOption, CanvasChartSparklineOption } from '@canvas-components/chart';
+import * as _canvas_components_utils from '@canvas-components/utils';
 import { CanvasScrollbarOptions, XlsxExportOptions } from '@canvas-components/utils';
 export { CanvasScrollbarAxisOptions as ListTableScrollbarAxisOptions } from '@canvas-components/utils';
+import * as antDesignIcons from '@ant-design/icons-svg';
+import { CanvasChartPieOption, CanvasChartRadarOption, CanvasChartGaugeOption, CanvasChartSparklineOption } from '@canvas-components/chart';
 
 /**
  * 排序状态。
@@ -293,7 +294,7 @@ interface ListTableDebugSnapshot {
 }
 
 /** 可单独控制持久化的表格配置；列设置及条件格式使用各自已有开关。 */
-type ListTableCacheCategory = "sort" | "filter" | "summary" | "alignment" | "dataFormat" | "density" | "zoom";
+type ListTableCacheCategory = "sort" | "filter" | "summary" | "alignment" | "dataFormat" | "density" | "zoom" | "scrollbar";
 /** 未指定的缓存类别默认开启，持久化需要 storageKey。 */
 type ListTableCachePreferences = Partial<Record<ListTableCacheCategory, boolean>>;
 
@@ -477,6 +478,8 @@ interface ListTableTreeSelectNode {
 type ListTableSorter<RecordType> = boolean | {
     /** 多列排序优先级，数值越大越优先。 */
     multiple?: number;
+    /** 排序切换或动态数据更新后，为可视行的名次变化播放上下位移动画。默认关闭。 */
+    animation?: boolean;
     /** 自定义记录比较，优先于 sortValueGetter；大数据使用主线程可取消分片。 */
     compare?: (a: RecordType, b: RecordType) => number;
 };
@@ -1174,6 +1177,10 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
     summaryStyle?: ListTableCellStyle;
     /** 汇总行配置。设为 `true` 等效于 `{ type: "sum" }`。 */
     summary?: boolean | ListTableSummaryConfig<RecordType>;
+    /** 默认加入分组栏；order 数值越小，分组层级越靠前，同值按列顺序。 */
+    grouping?: boolean | {
+        order?: number;
+    };
     /** 汇总行标题。设置后该列在汇总行中显示此标题文本（用于"合计"等标签列）。 */
     summaryTitle?: string;
     meta?: Record<string, unknown>;
@@ -1181,6 +1188,8 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
 
 interface ListTableChartData {
     labels: string[];
+    /** 与 labels 对齐的稳定类别标识，用于排序后的图形位置过渡。 */
+    keys?: Array<string | number>;
     series: Array<{
         name: string;
         data: number[];
@@ -1307,11 +1316,8 @@ interface ListTableDangerConfirmRequest {
     onCancel: () => void;
 }
 /** 导出前确认文件名称。 */
-interface ListTableExportNameRequest {
-    fileName: string;
-    onConfirm: (fileName: string) => void;
-    onCancel: () => void;
-}
+type ListTableExportColumnChoice = _canvas_components_utils.TableExportColumnChoice;
+type ListTableExportNameRequest = _canvas_components_utils.TableExportNameRequest;
 interface HeaderContextMenuColumnItem {
     key: string;
     title: string;
@@ -1321,6 +1327,7 @@ interface HeaderContextMenuColumnItem {
     minWidth?: number;
     maxWidth?: number;
     fixed?: "left" | "right";
+    sortable?: boolean;
     order?: number;
     siblingCount?: number;
     checked: boolean;
@@ -1338,10 +1345,20 @@ interface HeaderContextMenuColumnDraft {
     minWidth?: number;
     maxWidth?: number;
     fixed?: "left" | "right";
+    sortOrder?: "ascend" | "descend" | null;
     order?: number;
 }
 type HeaderContextMenuDensity = "comfortable" | "middle" | "compact" | "ultra-compact" | "auto";
 interface HeaderContextMenuConfig {
+    /** 右键命中滚动条时仅展示滚动条相关操作。 */
+    scrollbarArea?: boolean;
+    scrollbarRowCount?: number;
+    scrollbarColumnCount?: number;
+    onScrollToPosition?: (row?: number, column?: number) => void;
+    /** 当前画布滚动条配置。 */
+    scrollbar?: ListTableScrollbarOptions;
+    onChangeScrollbar?: (value: ListTableScrollbarOptions) => void;
+    onResetScrollbar?: () => void;
     /** 根据当前选区创建图表。 */
     onCreateChart?: () => ListTableChartData | null;
     conditionalFormats?: ListTableConditionalFormatRule[];
@@ -1352,6 +1369,7 @@ interface HeaderContextMenuConfig {
     x: number;
     y: number;
     columns?: HeaderContextMenuColumnItem[];
+    sortState?: ListTableSortState;
     dataIndexOptions?: Array<{
         value: string;
         disabled: boolean;
@@ -1924,6 +1942,8 @@ interface ListTableQuerySorter {
     field?: TableColumnDataIndex;
     order: "ascend" | "descend";
     priority?: number;
+    /** 对应列是否启用排序行位移动画。 */
+    animation?: boolean;
 }
 /**
  * 分页配置。
@@ -2088,7 +2108,7 @@ interface ListTableExpandableOptions<RecordType = Record<string, unknown>> {
 /**
  * UI 适配层配置。
  */
-interface ListTableUiOptions {
+interface ListTableUiOptions<RecordType = unknown> {
     /** 导出文件名输入弹窗；未提供时使用浏览器输入框。 */
     onExportNameRequest?: (request: ListTableExportNameRequest | null) => void;
     editorFactory?: ListTableEditorFactory;
@@ -2105,6 +2125,10 @@ interface ListTableUiOptions {
     onDangerConfirmRequest?: (request: ListTableDangerConfirmRequest | null) => void;
     /** 持久化配置或内部操作改变表格密度时通知适配层。 */
     onDensityChange?: (density: 26 | 32 | 48 | 56 | "auto") => void;
+    /** 恢复持久化滚动条配置后同步到适配层。 */
+    onScrollbarChange?: (scrollbar: ListTableScrollbarOptions) => void;
+    /** 同步恢复或内部修改后的列设置到适配层。 */
+    onColumnSettingsChange?: (columns: ListTableColumn<RecordType>[]) => void;
     /** 同步列设置缓存开关。 */
     onColumnSettingsCacheChange?: (enabled: boolean) => void;
     /** 同步各类配置的缓存偏好。 */
@@ -2162,6 +2186,8 @@ interface ListTableOptions<RecordType = Record<string, unknown>> {
      */
     height?: number | string;
     columns: ListTableColumn<RecordType>[];
+    /** 隐藏列时是否在表头展示恢复折叠列的图标，默认展示。 */
+    showCollapsedColumnIcon?: boolean;
     dataSource: RecordType[];
     /**
      * 数据是否仍在加载或分批生成。
@@ -2193,6 +2219,13 @@ interface ListTableOptions<RecordType = Record<string, unknown>> {
      * @default "row"
      */
     highlightMode?: ListTableHighlightMode;
+    /** 点击空白画布或表格外部时清除单元格、行列及汇总行的高亮选区；默认均不开启。 */
+    clearSelectionOnClick?: {
+        /** 点击画布内没有单元格或控件的空白区域时清除选区。 */
+        blankCanvas?: boolean;
+        /** 点击表格容器外部时清除选区。 */
+        outside?: boolean;
+    };
     /** 键盘活动单元格的边界导航配置。 */
     keyboardNavigation?: ListTableKeyboardNavigationOptions;
     /**
@@ -2272,9 +2305,15 @@ interface ListTableOptions<RecordType = Record<string, unknown>> {
      */
     contextMenu?: false | ListTableContextMenuOptions;
     debug?: ListTableDebugOptions;
-    ui?: ListTableUiOptions;
+    ui?: ListTableUiOptions<RecordType>;
 }
 
+/** 导出弹窗的逐列汇总选择；title 表示保留原汇总标题。 */
+type ListTableExportSummaryType = _canvas_components_utils.TableExportSummaryType;
+/** 本次导出的逐列汇总展示配置。 */
+type ListTableExportSummarySettings = _canvas_components_utils.TableExportSummarySettings;
+/** 仅作用于本次文件导出的列与汇总配置。 */
+type ListTableExportSettings = _canvas_components_utils.TableExportSettings;
 /**
  * 表格实例滚动参数。
  */
@@ -2295,6 +2334,8 @@ interface ListTableExportXlsxOptions extends XlsxExportOptions {
     fileName?: string;
     /** 是否在数据末尾追加按当前列配置计算的汇总行，默认跟随表格汇总行的显示状态。 */
     includeSummary?: boolean;
+    /** 本次导出的列顺序、逐列汇总方式和汇总行开关。 */
+    settings?: ListTableExportSettings;
     /** 导出失败通知；已保存的分文件不会撤回，取消不触发此回调。 */
     onError?: (error: unknown) => void;
 }
@@ -2371,6 +2412,10 @@ declare class ListTable<RecordType = Record<string, unknown>> {
      * 重置排序状态。
      */
     resetSorter(): void;
+    /** 获取当前排序状态。 */
+    getSortState(): ListTableSortItem[];
+    /** 设置指定列的排序方式。 */
+    setSortOrder(columnKey: string, order: "ascend" | "descend" | null): void;
     /**
      * 重置筛选状态。
      */
@@ -2455,4 +2500,4 @@ interface ListTableValidationTarget {
     columnKey: string;
 }
 
-export { type CreateCellEditorSessionParams, type DebugHitTestResult, EXPAND_COLUMN, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, type HeaderContextMenuColumnDraft, type HeaderContextMenuColumnItem, type HeaderContextMenuConfig, type HeaderContextMenuDensity, ListTable, type ListTableAntdIconName, type ListTableAutoMergeRule, type ListTableBarcodeCellContent, type ListTableBarcodeFormat, type ListTableBuiltinIconName, type ListTableButtonCellContent, type ListTableButtonPopconfirmOptions, type ListTableButtonSize, type ListTableButtonType, type ListTableCSSProperties, type ListTableCacheCategory, type ListTableCachePreferences, type ListTableCarouselScrollOptions, type ListTableCellContent, type ListTableCellContentClickContext, type ListTableCellEditorSession, type ListTableCellSpan, type ListTableCellStyle, type ListTableChartCellContent, type ListTableChartData, type ListTableChartSize, type ListTableChartType, type ListTableColorCellContent, type ListTableColumn, type ListTableConditionalFormatCondition, type ListTableConditionalFormatRule, type ListTableConditionalOperator, type ListTableContextMenuFeature, type ListTableContextMenuOptions, type ListTableCustomChartCellContent, type ListTableDangerConfirmRequest, type ListTableDataFormat, type ListTableDataFormatOptions, type ListTableDataFormatType, type ListTableDebugOptions, type ListTableDebugSnapshot, type ListTableDensity, type ListTableEditAutoCompleteEnter, type ListTableEditFilterOption, type ListTableEditOption, type ListTableEditValueType, type ListTableEditable, type ListTableEditorAutoCompleteEnter, type ListTableEditorConfig, type ListTableEditorFactory, type ListTableEditorFilterOption, type ListTableEditorNavigateDirection, type ListTableEditorOption, type ListTableEditorRect, type ListTableEditorRequest, type ListTableEditorTheme, type ListTableEditorValueType, type ListTableEmojiCellContent, type ListTableExperimentalOptions, type ListTableExportNameRequest, type ListTableExportXlsxOptions, type ListTableFilterCondition$1 as ListTableFilterCondition, type ListTableFilterConditionOperator, type ListTableFilterConditionRelation, type ListTableFilterMatchMode, type ListTableFilterOption, type ListTableFilterOptionValue, type ListTableFilterPanelAdapter, type ListTableFilterState, type ListTableFilterType, type ListTableFilterValue$1 as ListTableFilterValue, type ListTableFixedPopupAdapter, type ListTableFormItemProps, type ListTableFormItemPropsConfig, type ListTableFormRule, type ListTableFormRules, type ListTableGaugeChartCellContent, type ListTableGroupingOptions, type ListTableHeaderContextMenuAdapter, type ListTableHighlightMode, type ListTableHorizontalAlign, type ListTableIconCellContent, type ListTableImageCellContent, type ListTableImageObjectFit, type ListTableImagePreviewRequest, type ListTableKeyboardNavigationOptions, type ListTableLoadingAdapter, type ListTableLoadingRequest, type ListTableMergeCellOptions, type ListTableNestedTableCellContent, type ListTableNestedTableColumn, type ListTableOffscreenCanvasStatusInfo, type ListTableOptions, type ListTablePaginationAdapter, type ListTablePaginationCSSProperties, type ListTablePaginationOptions, type ListTablePaginationStyleSlot, type ListTablePaginationStyles, type ListTablePerformanceMetric, type ListTablePieChartCellContent, type ListTableProgressCellContent, type ListTableProgressShape, type ListTableProgressSize, type ListTableQrCodeCellContent, type ListTableQrCodeLevel, type ListTableQueryChange, type ListTableQueryChangeExtra, type ListTableQueryFilters, type ListTableQueryOptions, type ListTableQueryPagination, type ListTableQuerySorter, type ListTableRadarChartCellContent, type ListTableRateCellContent, type ListTableRateSize, type ListTableRateSymbolType, type ListTableRowDragMode, type ListTableRowDragOptions, type ListTableRowDragPayload, type ListTableRowDragSourceInfo, type ListTableRowDragZone, type ListTableRowEventProps, type ListTableRowSelectionChangeInfo, type ListTableRowSelectionOptions, type ListTableRowSelectorOptions, type ListTableScrollToOptions, type ListTableScrollbarCSSProperties, type ListTableScrollbarOptions, type ListTableSearchMode, type ListTableSearchOptions, type ListTableSearchRequest, type ListTableSelectionState, type ListTableServerSummaryValues, type ListTableSortItem, type ListTableSortState, type ListTableSorter, type ListTableSparklineChartCellContent, type ListTableSparklineSize, type ListTableStyles, type ListTableSummaryConfig, type ListTableSummaryRoundingMode, type ListTableSummaryType, type ListTableSymbolType, type ListTableTagCellContent, type ListTableTheme, type ListTableTimelineCellContent, type ListTableTimelineItem, type ListTableTooltipAdapter, type ListTableTooltipRequest, type ListTableTreeSelectNode, type ListTableUiOptions, type ListTableUploadConfig, type ListTableUploadFile, type ListTableUploadRequest, type ListTableValidationError, type ListTableValidationErrorField, type ListTableValidationFailure, type ListTableValidationTarget, type PaginationConfig, ROW_SELECTION_COLUMN, type RenderCellDescriptor, SELECTION_COLUMN, getListTableStoredPageSize, listTableAntdIconNames, listTableBuiltinIconNames, listTableIconNames, resetListTableStoredColumnConfig };
+export { type CreateCellEditorSessionParams, type DebugHitTestResult, EXPAND_COLUMN, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, type HeaderContextMenuColumnDraft, type HeaderContextMenuColumnItem, type HeaderContextMenuConfig, type HeaderContextMenuDensity, ListTable, type ListTableAntdIconName, type ListTableAutoMergeRule, type ListTableBarcodeCellContent, type ListTableBarcodeFormat, type ListTableBuiltinIconName, type ListTableButtonCellContent, type ListTableButtonPopconfirmOptions, type ListTableButtonSize, type ListTableButtonType, type ListTableCSSProperties, type ListTableCacheCategory, type ListTableCachePreferences, type ListTableCarouselScrollOptions, type ListTableCellContent, type ListTableCellContentClickContext, type ListTableCellEditorSession, type ListTableCellSpan, type ListTableCellStyle, type ListTableChartCellContent, type ListTableChartData, type ListTableChartSize, type ListTableChartType, type ListTableColorCellContent, type ListTableColumn, type ListTableConditionalFormatCondition, type ListTableConditionalFormatRule, type ListTableConditionalOperator, type ListTableContextMenuFeature, type ListTableContextMenuOptions, type ListTableCustomChartCellContent, type ListTableDangerConfirmRequest, type ListTableDataFormat, type ListTableDataFormatOptions, type ListTableDataFormatType, type ListTableDebugOptions, type ListTableDebugSnapshot, type ListTableDensity, type ListTableEditAutoCompleteEnter, type ListTableEditFilterOption, type ListTableEditOption, type ListTableEditValueType, type ListTableEditable, type ListTableEditorAutoCompleteEnter, type ListTableEditorConfig, type ListTableEditorFactory, type ListTableEditorFilterOption, type ListTableEditorNavigateDirection, type ListTableEditorOption, type ListTableEditorRect, type ListTableEditorRequest, type ListTableEditorTheme, type ListTableEditorValueType, type ListTableEmojiCellContent, type ListTableExperimentalOptions, type ListTableExportColumnChoice, type ListTableExportNameRequest, type ListTableExportSettings, type ListTableExportSummarySettings, type ListTableExportSummaryType, type ListTableExportXlsxOptions, type ListTableFilterCondition$1 as ListTableFilterCondition, type ListTableFilterConditionOperator, type ListTableFilterConditionRelation, type ListTableFilterMatchMode, type ListTableFilterOption, type ListTableFilterOptionValue, type ListTableFilterPanelAdapter, type ListTableFilterState, type ListTableFilterType, type ListTableFilterValue$1 as ListTableFilterValue, type ListTableFixedPopupAdapter, type ListTableFormItemProps, type ListTableFormItemPropsConfig, type ListTableFormRule, type ListTableFormRules, type ListTableGaugeChartCellContent, type ListTableGroupingOptions, type ListTableHeaderContextMenuAdapter, type ListTableHighlightMode, type ListTableHorizontalAlign, type ListTableIconCellContent, type ListTableImageCellContent, type ListTableImageObjectFit, type ListTableImagePreviewRequest, type ListTableKeyboardNavigationOptions, type ListTableLoadingAdapter, type ListTableLoadingRequest, type ListTableMergeCellOptions, type ListTableNestedTableCellContent, type ListTableNestedTableColumn, type ListTableOffscreenCanvasStatusInfo, type ListTableOptions, type ListTablePaginationAdapter, type ListTablePaginationCSSProperties, type ListTablePaginationOptions, type ListTablePaginationStyleSlot, type ListTablePaginationStyles, type ListTablePerformanceMetric, type ListTablePieChartCellContent, type ListTableProgressCellContent, type ListTableProgressShape, type ListTableProgressSize, type ListTableQrCodeCellContent, type ListTableQrCodeLevel, type ListTableQueryChange, type ListTableQueryChangeExtra, type ListTableQueryFilters, type ListTableQueryOptions, type ListTableQueryPagination, type ListTableQuerySorter, type ListTableRadarChartCellContent, type ListTableRateCellContent, type ListTableRateSize, type ListTableRateSymbolType, type ListTableRowDragMode, type ListTableRowDragOptions, type ListTableRowDragPayload, type ListTableRowDragSourceInfo, type ListTableRowDragZone, type ListTableRowEventProps, type ListTableRowSelectionChangeInfo, type ListTableRowSelectionOptions, type ListTableRowSelectorOptions, type ListTableScrollToOptions, type ListTableScrollbarCSSProperties, type ListTableScrollbarOptions, type ListTableSearchMode, type ListTableSearchOptions, type ListTableSearchRequest, type ListTableSelectionState, type ListTableServerSummaryValues, type ListTableSortItem, type ListTableSortState, type ListTableSorter, type ListTableSparklineChartCellContent, type ListTableSparklineSize, type ListTableStyles, type ListTableSummaryConfig, type ListTableSummaryRoundingMode, type ListTableSummaryType, type ListTableSymbolType, type ListTableTagCellContent, type ListTableTheme, type ListTableTimelineCellContent, type ListTableTimelineItem, type ListTableTooltipAdapter, type ListTableTooltipRequest, type ListTableTreeSelectNode, type ListTableUiOptions, type ListTableUploadConfig, type ListTableUploadFile, type ListTableUploadRequest, type ListTableValidationError, type ListTableValidationErrorField, type ListTableValidationFailure, type ListTableValidationTarget, type PaginationConfig, ROW_SELECTION_COLUMN, type RenderCellDescriptor, SELECTION_COLUMN, getListTableStoredPageSize, listTableAntdIconNames, listTableBuiltinIconNames, listTableIconNames, resetListTableStoredColumnConfig };