@canvas-components/list-table 0.3.21 → 0.3.23

package/dist/index.d.cts

@@ -827,6 +827,13 @@ interface ListTableIconCellContent<RecordType = any> extends ListTableBaseCellCo
     color?: string;
     size?: number;
 }
+/** 单元格 Unicode 表情片段，使用系统彩色表情字体绘制。 */
+interface ListTableEmojiCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "emoji";
+    emoji: string;
+    /** 表情字号，默认 20px；`style.fontSize` 优先。 */
+    size?: number;
+}
 /**
  * 单元格按钮片段。
  */
@@ -989,7 +996,7 @@ interface ListTableNestedTableCellContent<RecordType = any> extends ListTableBas
 /**
  * 单元格内容定义。
  */
-type ListTableCellContent<RecordType = any> = ListTableArrowCellContent<RecordType> | ListTableIconCellContent<RecordType> | ListTableTextCellContent<RecordType> | ListTableMoneyCellContent<RecordType> | ListTableLinkCellContent<RecordType> | ListTableImageCellContent<RecordType> | ListTableProgressCellContent<RecordType> | ListTableTimelineCellContent<RecordType> | ListTableChartCellContent<RecordType> | ListTableRateCellContent<RecordType> | ListTableButtonCellContent<RecordType> | ListTableQrCodeCellContent<RecordType> | ListTableBarcodeCellContent<RecordType> | ListTableColorCellContent<RecordType> | ListTableTagCellContent<RecordType> | ListTableSelectionCellContent<RecordType> | ListTableSwitchCellContent<RecordType> | ListTableNestedTableCellContent<RecordType>;
+type ListTableCellContent<RecordType = any> = ListTableArrowCellContent<RecordType> | ListTableIconCellContent<RecordType> | ListTableEmojiCellContent<RecordType> | ListTableTextCellContent<RecordType> | ListTableMoneyCellContent<RecordType> | ListTableLinkCellContent<RecordType> | ListTableImageCellContent<RecordType> | ListTableProgressCellContent<RecordType> | ListTableTimelineCellContent<RecordType> | ListTableChartCellContent<RecordType> | ListTableRateCellContent<RecordType> | ListTableButtonCellContent<RecordType> | ListTableQrCodeCellContent<RecordType> | ListTableBarcodeCellContent<RecordType> | ListTableColorCellContent<RecordType> | ListTableTagCellContent<RecordType> | ListTableSelectionCellContent<RecordType> | ListTableSwitchCellContent<RecordType> | ListTableNestedTableCellContent<RecordType>;
 /**
  * 单元格跨度配置。
  *
@@ -1113,6 +1120,10 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
     showExpandIcon?: boolean;
     /** 列设置中使用的标题，未传时使用 `title`。 */
     settingTitle?: string;
+    /** 列显示菜单中由用户添加的列；代码传入的列不会设置此标记。 */
+    userDefined?: boolean;
+    /** 用户在列显示菜单中修改的标题，用于恢复缓存时覆盖初始标题。 */
+    userTitle?: string;
     /** 首次创建表格时是否默认隐藏。显式传入 `hidden` 时以 `hidden` 为准。 */
     initialHide?: boolean;
     /** 是否不在列设置中展示该列及其子列。 */
@@ -1146,7 +1157,7 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
      * 用法参考 AntD Table 的 `onCell`。
      */
     onCell?: (value: unknown, record: RecordType, rowIndex: number, column: ListTableColumn<RecordType>) => ListTableCellSpan | null | undefined;
-    cellType?: "text" | "money" | "link" | "image" | "qrcode" | "barcode" | "color" | "progress" | "timeline" | "chart" | "rate" | "checkbox" | "radio" | "switch" | "tag" | "button" | "custom";
+    cellType?: "text" | "emoji" | "money" | "link" | "image" | "qrcode" | "barcode" | "color" | "progress" | "timeline" | "chart" | "rate" | "checkbox" | "radio" | "switch" | "tag" | "button" | "custom";
     cellStyle?: ListTableCellStyle;
     /** 金额单元格格式配置，仅在 `cellType: "money"` 时生效。 */
     moneyFormat?: ListTableMoneyFormatOptions;
@@ -1166,6 +1177,20 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
     meta?: Record<string, unknown>;
 }
 
+interface ListTableChartData {
+    labels: string[];
+    series: Array<{
+        name: string;
+        data: number[];
+    }>;
+}
+
+type ListTableSearchMode = "fuzzy" | "exact" | "wildcard" | "regex";
+interface ListTableSearchOptions {
+    mode: ListTableSearchMode;
+    caseSensitive: boolean;
+}
+
 type ListTableFilterMatchMode = "fuzzy" | "exact";
 type ListTableFilterType = "value" | "condition";
 type ListTableFilterConditionRelation = "and" | "or";
@@ -1288,13 +1313,35 @@ interface ListTableExportNameRequest {
 interface HeaderContextMenuColumnItem {
     key: string;
     title: string;
+    dataIndex?: string;
+    userDefined?: boolean;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    fixed?: "left" | "right";
+    order?: number;
+    siblingCount?: number;
     checked: boolean;
     indeterminate?: boolean;
     disabled?: boolean;
     children?: HeaderContextMenuColumnItem[];
 }
+/** 列显示菜单新增或编辑列时提交的字段。 */
+interface HeaderContextMenuColumnDraft {
+    key?: string;
+    parentKey?: string;
+    title: string;
+    dataIndex?: string;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    fixed?: "left" | "right";
+    order?: number;
+}
 type HeaderContextMenuDensity = "comfortable" | "middle" | "compact" | "ultra-compact" | "auto";
 interface HeaderContextMenuConfig {
+    /** 根据当前选区创建图表。 */
+    onCreateChart?: () => ListTableChartData | null;
     conditionalFormats?: ListTableConditionalFormatRule[];
     cacheConditionalFormats?: boolean;
     /** 是否已配置持久化存储标识。 */
@@ -1303,6 +1350,11 @@ interface HeaderContextMenuConfig {
     x: number;
     y: number;
     columns?: HeaderContextMenuColumnItem[];
+    dataIndexOptions?: Array<{
+        value: string;
+        disabled: boolean;
+        label?: string;
+    }>;
     density?: HeaderContextMenuDensity;
     /**
      * 当前表格缩放比例（1 = 100%）。
@@ -1362,6 +1414,7 @@ interface HeaderContextMenuConfig {
     onResetDataFormat?: () => void;
     onAutoFitCurrentColumn?: () => void;
     onAutoFitAllColumns?: () => void;
+    onAutoFitFillContainer?: () => void;
     groupingBarVisible?: boolean;
     onToggleGroupingBar?: () => void;
     onChangeDensity?: (density: HeaderContextMenuDensity) => void;
@@ -1370,6 +1423,9 @@ interface HeaderContextMenuConfig {
      */
     onChangeZoom?: (zoom: number) => void;
     onToggleColumn?: (columnKey: string, visible: boolean) => void;
+    /** 成功返回 null；失败返回可直接展示的错误提示。 */
+    onSaveColumn?: (draft: HeaderContextMenuColumnDraft) => string | null;
+    onDeleteColumn?: (columnKey: string) => boolean;
     cacheColumnSettings?: boolean;
     columnSettingsCacheAvailable?: boolean;
     onChangeColumnSettingsCache?: (enabled: boolean) => void;
@@ -1404,10 +1460,13 @@ interface HeaderContextMenuConfig {
 }
 interface ListTableSearchRequest {
     keyword: string;
+    mode: ListTableSearchOptions["mode"];
+    caseSensitive: boolean;
+    error: string | null;
     matchCount: number;
     currentIndex: number;
     /** 提交关键词并重新计算匹配项。 */
-    onSubmit: (keyword: string) => void;
+    onSubmit: (keyword: string, options: ListTableSearchOptions) => void;
     onNavigate: (direction: "previous" | "next") => void;
     onClose: () => void;
 }
@@ -1725,7 +1784,7 @@ type ListTableHighlightMode = "cell" | "row" | "column" | "cross";
 /**
  * 右键菜单功能项。
  */
-type ListTableContextMenuFeature = "copy" | "search" | "export" | "downloadContent" | "rowCollapse" | "columnCollapse" | "freeze" | "reset" | "sort" | "density" | "zoom" | "columnWidth" | "alignment" | "dataFormat" | "conditionalFormat" | "cache" | "grouping" | "columnVisibility";
+type ListTableContextMenuFeature = "copy" | "chart" | "search" | "export" | "downloadContent" | "rowCollapse" | "columnCollapse" | "freeze" | "reset" | "sort" | "density" | "zoom" | "columnWidth" | "alignment" | "dataFormat" | "conditionalFormat" | "cache" | "grouping" | "columnVisibility";
 /**
  * 数据分组配置。
  */
@@ -2379,4 +2438,4 @@ interface ListTableValidationTarget {
     columnKey: string;
 }
 
-export { type CreateCellEditorSessionParams, type DebugHitTestResult, EXPAND_COLUMN, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, 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 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 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 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 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 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 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

@@ -827,6 +827,13 @@ interface ListTableIconCellContent<RecordType = any> extends ListTableBaseCellCo
     color?: string;
     size?: number;
 }
+/** 单元格 Unicode 表情片段，使用系统彩色表情字体绘制。 */
+interface ListTableEmojiCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "emoji";
+    emoji: string;
+    /** 表情字号，默认 20px；`style.fontSize` 优先。 */
+    size?: number;
+}
 /**
  * 单元格按钮片段。
  */
@@ -989,7 +996,7 @@ interface ListTableNestedTableCellContent<RecordType = any> extends ListTableBas
 /**
  * 单元格内容定义。
  */
-type ListTableCellContent<RecordType = any> = ListTableArrowCellContent<RecordType> | ListTableIconCellContent<RecordType> | ListTableTextCellContent<RecordType> | ListTableMoneyCellContent<RecordType> | ListTableLinkCellContent<RecordType> | ListTableImageCellContent<RecordType> | ListTableProgressCellContent<RecordType> | ListTableTimelineCellContent<RecordType> | ListTableChartCellContent<RecordType> | ListTableRateCellContent<RecordType> | ListTableButtonCellContent<RecordType> | ListTableQrCodeCellContent<RecordType> | ListTableBarcodeCellContent<RecordType> | ListTableColorCellContent<RecordType> | ListTableTagCellContent<RecordType> | ListTableSelectionCellContent<RecordType> | ListTableSwitchCellContent<RecordType> | ListTableNestedTableCellContent<RecordType>;
+type ListTableCellContent<RecordType = any> = ListTableArrowCellContent<RecordType> | ListTableIconCellContent<RecordType> | ListTableEmojiCellContent<RecordType> | ListTableTextCellContent<RecordType> | ListTableMoneyCellContent<RecordType> | ListTableLinkCellContent<RecordType> | ListTableImageCellContent<RecordType> | ListTableProgressCellContent<RecordType> | ListTableTimelineCellContent<RecordType> | ListTableChartCellContent<RecordType> | ListTableRateCellContent<RecordType> | ListTableButtonCellContent<RecordType> | ListTableQrCodeCellContent<RecordType> | ListTableBarcodeCellContent<RecordType> | ListTableColorCellContent<RecordType> | ListTableTagCellContent<RecordType> | ListTableSelectionCellContent<RecordType> | ListTableSwitchCellContent<RecordType> | ListTableNestedTableCellContent<RecordType>;
 /**
  * 单元格跨度配置。
  *
@@ -1113,6 +1120,10 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
     showExpandIcon?: boolean;
     /** 列设置中使用的标题，未传时使用 `title`。 */
     settingTitle?: string;
+    /** 列显示菜单中由用户添加的列；代码传入的列不会设置此标记。 */
+    userDefined?: boolean;
+    /** 用户在列显示菜单中修改的标题，用于恢复缓存时覆盖初始标题。 */
+    userTitle?: string;
     /** 首次创建表格时是否默认隐藏。显式传入 `hidden` 时以 `hidden` 为准。 */
     initialHide?: boolean;
     /** 是否不在列设置中展示该列及其子列。 */
@@ -1146,7 +1157,7 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
      * 用法参考 AntD Table 的 `onCell`。
      */
     onCell?: (value: unknown, record: RecordType, rowIndex: number, column: ListTableColumn<RecordType>) => ListTableCellSpan | null | undefined;
-    cellType?: "text" | "money" | "link" | "image" | "qrcode" | "barcode" | "color" | "progress" | "timeline" | "chart" | "rate" | "checkbox" | "radio" | "switch" | "tag" | "button" | "custom";
+    cellType?: "text" | "emoji" | "money" | "link" | "image" | "qrcode" | "barcode" | "color" | "progress" | "timeline" | "chart" | "rate" | "checkbox" | "radio" | "switch" | "tag" | "button" | "custom";
     cellStyle?: ListTableCellStyle;
     /** 金额单元格格式配置，仅在 `cellType: "money"` 时生效。 */
     moneyFormat?: ListTableMoneyFormatOptions;
@@ -1166,6 +1177,20 @@ interface ListTableColumn<RecordType = Record<string, unknown>> {
     meta?: Record<string, unknown>;
 }
 
+interface ListTableChartData {
+    labels: string[];
+    series: Array<{
+        name: string;
+        data: number[];
+    }>;
+}
+
+type ListTableSearchMode = "fuzzy" | "exact" | "wildcard" | "regex";
+interface ListTableSearchOptions {
+    mode: ListTableSearchMode;
+    caseSensitive: boolean;
+}
+
 type ListTableFilterMatchMode = "fuzzy" | "exact";
 type ListTableFilterType = "value" | "condition";
 type ListTableFilterConditionRelation = "and" | "or";
@@ -1288,13 +1313,35 @@ interface ListTableExportNameRequest {
 interface HeaderContextMenuColumnItem {
     key: string;
     title: string;
+    dataIndex?: string;
+    userDefined?: boolean;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    fixed?: "left" | "right";
+    order?: number;
+    siblingCount?: number;
     checked: boolean;
     indeterminate?: boolean;
     disabled?: boolean;
     children?: HeaderContextMenuColumnItem[];
 }
+/** 列显示菜单新增或编辑列时提交的字段。 */
+interface HeaderContextMenuColumnDraft {
+    key?: string;
+    parentKey?: string;
+    title: string;
+    dataIndex?: string;
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    fixed?: "left" | "right";
+    order?: number;
+}
 type HeaderContextMenuDensity = "comfortable" | "middle" | "compact" | "ultra-compact" | "auto";
 interface HeaderContextMenuConfig {
+    /** 根据当前选区创建图表。 */
+    onCreateChart?: () => ListTableChartData | null;
     conditionalFormats?: ListTableConditionalFormatRule[];
     cacheConditionalFormats?: boolean;
     /** 是否已配置持久化存储标识。 */
@@ -1303,6 +1350,11 @@ interface HeaderContextMenuConfig {
     x: number;
     y: number;
     columns?: HeaderContextMenuColumnItem[];
+    dataIndexOptions?: Array<{
+        value: string;
+        disabled: boolean;
+        label?: string;
+    }>;
     density?: HeaderContextMenuDensity;
     /**
      * 当前表格缩放比例（1 = 100%）。
@@ -1362,6 +1414,7 @@ interface HeaderContextMenuConfig {
     onResetDataFormat?: () => void;
     onAutoFitCurrentColumn?: () => void;
     onAutoFitAllColumns?: () => void;
+    onAutoFitFillContainer?: () => void;
     groupingBarVisible?: boolean;
     onToggleGroupingBar?: () => void;
     onChangeDensity?: (density: HeaderContextMenuDensity) => void;
@@ -1370,6 +1423,9 @@ interface HeaderContextMenuConfig {
      */
     onChangeZoom?: (zoom: number) => void;
     onToggleColumn?: (columnKey: string, visible: boolean) => void;
+    /** 成功返回 null；失败返回可直接展示的错误提示。 */
+    onSaveColumn?: (draft: HeaderContextMenuColumnDraft) => string | null;
+    onDeleteColumn?: (columnKey: string) => boolean;
     cacheColumnSettings?: boolean;
     columnSettingsCacheAvailable?: boolean;
     onChangeColumnSettingsCache?: (enabled: boolean) => void;
@@ -1404,10 +1460,13 @@ interface HeaderContextMenuConfig {
 }
 interface ListTableSearchRequest {
     keyword: string;
+    mode: ListTableSearchOptions["mode"];
+    caseSensitive: boolean;
+    error: string | null;
     matchCount: number;
     currentIndex: number;
     /** 提交关键词并重新计算匹配项。 */
-    onSubmit: (keyword: string) => void;
+    onSubmit: (keyword: string, options: ListTableSearchOptions) => void;
     onNavigate: (direction: "previous" | "next") => void;
     onClose: () => void;
 }
@@ -1725,7 +1784,7 @@ type ListTableHighlightMode = "cell" | "row" | "column" | "cross";
 /**
  * 右键菜单功能项。
  */
-type ListTableContextMenuFeature = "copy" | "search" | "export" | "downloadContent" | "rowCollapse" | "columnCollapse" | "freeze" | "reset" | "sort" | "density" | "zoom" | "columnWidth" | "alignment" | "dataFormat" | "conditionalFormat" | "cache" | "grouping" | "columnVisibility";
+type ListTableContextMenuFeature = "copy" | "chart" | "search" | "export" | "downloadContent" | "rowCollapse" | "columnCollapse" | "freeze" | "reset" | "sort" | "density" | "zoom" | "columnWidth" | "alignment" | "dataFormat" | "conditionalFormat" | "cache" | "grouping" | "columnVisibility";
 /**
  * 数据分组配置。
  */
@@ -2379,4 +2438,4 @@ interface ListTableValidationTarget {
     columnKey: string;
 }
 
-export { type CreateCellEditorSessionParams, type DebugHitTestResult, EXPAND_COLUMN, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, 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 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 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 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 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 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 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 };