@canvas-components/list-table 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,1652 @@
+import { CanvasChartSparklineOption } from '@canvas-components/chart';
+
+/**
+ * 排序状态。
+ */
+interface ListTableSortState {
+    key: string | null;
+    order: "ascend" | "descend" | null;
+}
+/**
+ * 多列排序项。
+ */
+interface ListTableSortItem {
+    key: string;
+    order: "ascend" | "descend";
+    priority: number;
+}
+/**
+ * 过滤匹配模式。
+ */
+type ListTableFilterMatchMode$1 = "fuzzy" | "exact";
+/**
+ * 过滤类型。
+ */
+type ListTableFilterType$1 = "value" | "condition";
+/**
+ * 条件关系。
+ */
+type ListTableFilterConditionRelation$1 = "and" | "or";
+/**
+ * 条件运算符。
+ */
+type ListTableFilterConditionOperator$1 = "none" | "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "notBetween" | "startsWith" | "notStartsWith" | "endsWith" | "notEndsWith" | "includes" | "notIncludes" | "blank" | "notBlank";
+/**
+ * 过滤值定义。
+ */
+interface ListTableFilterValue$1 {
+    keyword: string;
+    mode: ListTableFilterMatchMode$1;
+    selectedKeys?: string[];
+    searchExact?: boolean;
+    filterType?: ListTableFilterType$1;
+    conditionOperator?: ListTableFilterConditionOperator$1;
+    conditionValue?: string;
+    conditionSecondValue?: string;
+    conditionRelation?: ListTableFilterConditionRelation$1;
+    secondConditionOperator?: ListTableFilterConditionOperator$1;
+    secondConditionValue?: string;
+    secondConditionSecondValue?: string;
+}
+/**
+ * 过滤状态。
+ */
+type ListTableFilterState = Record<string, ListTableFilterValue$1>;
+/**
+ * 选中状态。
+ */
+interface ListTableSelectionState {
+    rowIndex: number | null;
+    columnKey: string | null;
+}
+/**
+ * 表头 action 显隐状态。
+ */
+interface HeaderActionVisibilityState {
+    hovered: boolean;
+    sorted: boolean;
+    filtered: boolean;
+    fixed: boolean;
+    visible: boolean;
+}
+/**
+ * 调试选项。
+ */
+interface ListTableDebugOptions {
+    enabled?: boolean;
+    showHeaderBounds?: boolean;
+    showBodyBounds?: boolean;
+    showFixedSplitLines?: boolean;
+    showViewportBounds?: boolean;
+    showHitTarget?: boolean;
+    showHeaderActionOverlay?: boolean;
+    logDrawCalls?: boolean;
+    logStateChanges?: boolean;
+}
+/**
+ * 查询回调扩展参数。
+ */
+interface ListTableQueryChangeExtra<RecordType> {
+    currentDataSource: RecordType[];
+    action: "sort" | "filter" | "paginate";
+    mode: "local" | "remote";
+    activeColumnKeys: string[];
+    filteredDataSource: RecordType[];
+    rawFilters: ListTableFilterState;
+    sorter: ListTableSortState;
+    sorters?: ListTableSortItem[];
+}
+
+/**
+ * 矩形。
+ */
+interface Rect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * 命中结果。
+ */
+interface DebugHitTestResult {
+    area: "header" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "sort-trigger" | "filter-trigger" | "fixed-trigger" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary" | "summary" | "empty";
+    scrollbarRole?: "thumb" | "track" | "decrease-button" | "increase-button";
+    columnKey?: string;
+    rowIndex?: number;
+    rowSpan?: number;
+    hitRowIndex?: number;
+    controlType?: "checkbox" | "radio" | "switch";
+    contentIndex?: number;
+    contentKey?: string;
+    nestedRowKey?: string | number;
+    nestedRowIndex?: number;
+    nestedColumnDataIndex?: string;
+    nestedColumnIndex?: number;
+    resizeEdge?: "left" | "right";
+    cursor?: string;
+    rect?: Rect;
+    tooltipText?: string;
+    tooltipVariant?: "default" | "error";
+}
+/**
+ * action 类型。
+ */
+type HeaderActionType = "sort" | "filter" | "fixed";
+/**
+ * 渲染矩形描述。
+ */
+interface RenderCellDescriptor {
+    kind: "header" | "body" | "body-content" | "body-control" | "expand-trigger" | "collapse-trigger" | "column-collapse-trigger" | "expanded-row" | "header-selection" | "header-action" | "resize-handle" | "horizontal-scrollbar" | "vertical-scrollbar" | "summary";
+    rect: Rect;
+    columnKey?: string;
+    rowIndex?: number;
+    rowSpan?: number;
+    controlType?: "checkbox" | "radio" | "switch";
+    contentIndex?: number;
+    contentKey?: string;
+    nestedRowKey?: string | number;
+    nestedRowIndex?: number;
+    nestedColumnDataIndex?: string;
+    nestedColumnIndex?: number;
+    resizeEdge?: "left" | "right";
+    cursor?: string;
+    tooltipText?: string;
+    tooltipVariant?: "default" | "error";
+    actionType?: HeaderActionType;
+    scrollbarRole?: "thumb" | "track" | "decrease-button" | "increase-button";
+    visibilityState?: HeaderActionVisibilityState;
+    /** 列固定方向，用于命中测试优先级。 */
+    fixed?: "left" | "right";
+    /** 是否为冻结行，用于命中测试优先级。 */
+    frozen?: boolean;
+}
+/**
+ * 调试快照。
+ */
+interface ListTableDebugSnapshot {
+    layout: {
+        fixedWidthLeft: number;
+        fixedWidthRight: number;
+        headerHeight: number;
+        totalWidth: number;
+        totalBodyHeight: number;
+    };
+    viewport: unknown;
+    scroll: unknown;
+    hover: unknown;
+    selection: unknown;
+    sort: unknown;
+    filter: unknown;
+    runtimeColumns: unknown;
+    descriptors: RenderCellDescriptor[];
+    hitTest?: DebugHitTestResult;
+}
+
+/**
+ * 单元格样式定义。
+ */
+interface ListTableCellStyle {
+    backgroundColor?: string;
+    color?: string;
+    fontSize?: number;
+    fontWeight?: string;
+    textAlign?: CanvasTextAlign;
+    verticalAlign?: "top" | "middle" | "bottom";
+    paddingInline?: number;
+    paddingBlock?: number;
+    borderColor?: string;
+    borderWidth?: number;
+}
+/**
+ * 主题定义。
+ */
+interface ListTableTheme {
+    backgroundColor: string;
+    stripedBackgroundColor: string;
+    borderColor: string;
+    textColor: string;
+    mutedTextColor: string;
+    headerBackgroundColor: string;
+    headerTextColor: string;
+    fixedShadowColor: string;
+    frozenRowBackgroundColor: string;
+    hoverBackgroundColor: string;
+    selectionBackgroundColor: string;
+    emptyBackgroundColor: string;
+    emptyTextColor: string;
+    debugStrokeColor: string;
+    debugFillColor: string;
+    fontFamily: string;
+    fontSize: number;
+    headerFontWeight: string;
+}
+
+/**
+ * 汇总类型说明：
+ * - `sum`：对当前列做求和
+ * - `count`：统计当前列中有值的记录数量
+ * - `unionCount`：统计当前列中非空值的去重数量
+ * - `rowCount`：统计可见记录总行数
+ * - `mergedRowCount`：统计合并单元格后的逻辑行数，`rowSpan > 0` 视为一条
+ * - `avg`：对当前列做平均值计算
+ * - `min`：取当前列最小值
+ * - `max`：取当前列最大值
+ */
+type ListTableSummaryType = "sum" | "avg" | "count" | "unionCount" | "rowCount" | "mergedRowCount" | "min" | "max";
+type ListTableFilterOptionValue = string | number | null;
+interface ListTableFilterOption {
+    label: string;
+    value: ListTableFilterOptionValue;
+}
+/**
+ * 汇总行聚合配置。
+ */
+interface ListTableSummaryConfig<RecordType = Record<string, unknown>> {
+    /** 聚合函数类型，默认 `sum`。 */
+    type?: ListTableSummaryType;
+    /** 自定义值提取函数。 */
+    valueGetter?: (record: RecordType) => string | number | null | undefined;
+    /** 值格式化函数。 */
+    formatter?: (value: string | number, records: RecordType[], column: ListTableColumn<RecordType>) => string;
+    /** 小数精度（四舍五入），不传则整数不保留小数、非整数保留两位。 */
+    precision?: number;
+}
+/**
+ * 路径索引定义。
+ */
+type TableColumnDataIndex = string | number | Array<string | number>;
+/**
+ * 单元格内容点击上下文。
+ */
+interface ListTableCellContentClickContext<RecordType = any> {
+    record: RecordType;
+    rowIndex: number;
+    column: ListTableColumn<RecordType>;
+    value: unknown;
+    contentIndex: number;
+    nativeEvent: MouseEvent;
+}
+/**
+ * 单元格内容片段样式。
+ */
+type ListTableImageObjectFit = "fill" | "contain" | "cover" | "none" | "scale-down";
+type ListTableTextDecoration = "none" | "underline" | "line-through" | "overline";
+type ListTableProgressShape = "line" | "circle";
+type ListTableProgressSize = "small" | "medium" | number | [number, number] | {
+    width?: number;
+    height?: number;
+};
+type ListTableSparklineSize = "small" | "medium" | number | [number, number] | {
+    width?: number;
+    height?: number;
+};
+type ListTableChartType = "sparkline" | (string & {});
+type ListTableChartSize = ListTableSparklineSize;
+type ListTableRateSize = "small" | "medium" | "large" | number;
+type ListTableSymbolType = "star" | "sun" | "moon";
+type ListTableButtonType = "primary" | "default" | "dashed" | "text" | "link";
+type ListTableButtonSize = "small" | "middle" | "medium" | "large";
+/**
+ * 金额内容格式化配置。
+ */
+interface ListTableMoneyFormatOptions {
+    /** 金额符号，例如 `¥`、`$`，默认不显示。 */
+    symbol?: string;
+    /** 是否显示千位分隔符，传入字符串时作为分隔符，默认显示 `,`。 */
+    thousandsSeparator?: boolean | string;
+    /** 小数位数，默认保留两位。 */
+    decimalPlaces?: number;
+}
+/**
+ * 危险按钮二次确认配置。
+ */
+interface ListTableButtonPopconfirmOptions {
+    title?: string;
+    description?: string;
+    okText?: string;
+    cancelText?: string;
+}
+type ListTableQrCodeLevel = "L" | "M" | "Q" | "H";
+type ListTableBarcodeFormat = "code128" | "code128b" | "code128c" | "code39" | "itf" | "ean13" | "ean8" | "upca";
+/**
+ * 单元格编辑校验规则。
+ */
+interface ListTableFormRule<RecordType = Record<string, unknown>> {
+    required?: boolean;
+    /** 必填时是否在表头展示红色星号，默认展示。 */
+    showRequiredMark?: boolean;
+    message: string;
+    validator?: (value: unknown, record: RecordType, index: number) => boolean | string | void | Promise<boolean | string | void>;
+}
+/**
+ * 单元格编辑校验规则集合。
+ */
+type ListTableFormRules<RecordType = Record<string, unknown>> = ListTableFormRule<RecordType>[] | ((text: unknown, record: RecordType, index: number) => ListTableFormRule<RecordType>[]);
+/**
+ * 单元格内容片段样式。
+ */
+interface ListTableContentStyle {
+    display?: "block" | "inline-block";
+    textAlign?: CanvasTextAlign;
+    fontSize?: number;
+    fontWeight?: string;
+    fontFamily?: string;
+    color?: string;
+    backgroundColor?: string;
+    opacity?: number;
+    textDecoration?: ListTableTextDecoration;
+    textIndent?: number;
+    width?: number;
+    height?: number;
+    objectFit?: ListTableImageObjectFit;
+}
+/**
+ * 单元格内容基础定义。
+ */
+interface ListTableBaseCellContent<RecordType = any> {
+    key?: string;
+    style?: ListTableContentStyle;
+    cursor?: string;
+    onClick?: (context: ListTableCellContentClickContext<RecordType>) => void;
+}
+/**
+ * 单元格文本片段。
+ */
+interface ListTableTextCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "text";
+    text: string;
+    color?: string;
+    fontSize?: number;
+    fontWeight?: string;
+}
+/**
+ * 单元格金额片段。
+ */
+interface ListTableMoneyCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "money";
+    value: string | number | null | undefined;
+    symbol?: string;
+    thousandsSeparator?: boolean | string;
+    decimalPlaces?: number;
+    color?: string;
+    fontSize?: number;
+    fontWeight?: string;
+}
+interface ListTableHeaderTextContent {
+    type: "text";
+    text: string;
+    color?: string;
+    fontSize?: number;
+    fontWeight?: string;
+}
+interface ListTableHeaderImageContent {
+    type: "img";
+    src: string;
+    alt?: string;
+    width?: number;
+    height?: number;
+}
+type ListTableHeaderContent = ListTableHeaderTextContent | ListTableHeaderImageContent;
+type ListTableHeaderTitle = string | ListTableHeaderContent | ListTableHeaderContent[];
+/**
+ * 单元格链接片段。
+ */
+interface ListTableLinkCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "link";
+    text: string;
+    href?: string;
+    target?: "_self" | "_blank";
+    disabled?: boolean;
+    visited?: boolean;
+    color?: string;
+    hoverColor?: string;
+    visitedColor?: string;
+    disabledColor?: string;
+    fontSize?: number;
+    fontWeight?: string;
+    underline?: boolean | "hover";
+}
+/**
+ * 单元格图片片段。
+ */
+interface ListTableImageCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "image";
+    src: string;
+    alt?: string;
+    /** 是否允许点击预览，默认开启。 */
+    preview?: boolean;
+}
+/**
+ * 单元格进度片段。
+ */
+interface ListTableProgressCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "progress";
+    value: number;
+    min?: number;
+    max?: number;
+    shape?: ListTableProgressShape;
+    size?: ListTableProgressSize;
+    showPercent?: boolean;
+    showInfo?: boolean;
+    text?: string;
+    progressColor?: string;
+    color?: string;
+    trackColor?: string;
+    successColor?: string;
+    strokeWidth?: number;
+}
+/**
+ * 通用单元格图表片段基类。
+ */
+interface ListTableBaseChartCellContent<RecordType = any, ChartType extends string = string, Option = unknown> extends ListTableBaseCellContent<RecordType> {
+    type: "chart";
+    /** 是否允许点击预览，默认开启。 */
+    preview?: boolean;
+    chartType: ChartType;
+    option: Option;
+    size?: ListTableChartSize;
+}
+/**
+ * 单元格图表片段。
+ */
+interface ListTableCustomChartCellContent<RecordType = any> extends ListTableBaseChartCellContent<RecordType, ListTableChartType, unknown> {
+}
+/**
+ * 单元格 sparkline 图表片段。
+ */
+interface ListTableSparklineChartCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "chart";
+    /** 是否允许点击预览，默认开启。 */
+    preview?: boolean;
+    chartType: "sparkline";
+    option?: CanvasChartSparklineOption;
+    values?: number[];
+    min?: number;
+    max?: number;
+    size?: ListTableSparklineSize;
+    color?: string;
+    lineWidth?: number;
+    areaColor?: string;
+    pointColor?: string;
+    pointRadius?: number;
+    padding?: number;
+    smooth?: boolean;
+}
+/**
+ * 单元格图表片段。
+ */
+type ListTableChartCellContent<RecordType = any> = ListTableSparklineChartCellContent<RecordType> | ListTableCustomChartCellContent<RecordType>;
+/**
+ * 单元格评分片段。
+ */
+interface ListTableRateCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "rate";
+    value: number;
+    count?: number;
+    allowHalf?: boolean;
+    /** 评分图形，默认星星。 */
+    shape?: ListTableSymbolType;
+    size?: ListTableRateSize;
+    color?: string;
+    backgroundColor?: string;
+    gap?: number;
+    text?: string;
+    showText?: boolean;
+}
+/**
+ * 单元格图形图标片段。
+ */
+interface ListTableIconCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "icon";
+    icon: ListTableSymbolType;
+    color?: string;
+    size?: number;
+}
+/**
+ * 单元格按钮片段。
+ */
+interface ListTableButtonCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "button";
+    text: string;
+    buttonType?: ListTableButtonType;
+    size?: ListTableButtonSize;
+    /**
+     * 是否使用危险操作模式。
+     *
+     * 开启后按钮会使用危险色，并在点击前弹出二次确认。
+     */
+    danger?: boolean;
+    /**
+     * 危险操作二次确认文案配置。
+     */
+    popconfirm?: ListTableButtonPopconfirmOptions;
+    disabled?: boolean;
+}
+/**
+ * 单元格二维码片段。
+ */
+interface ListTableQrCodeCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "qrcode";
+    value: string;
+    level?: ListTableQrCodeLevel;
+    size?: number;
+    color?: string;
+    backgroundColor?: string;
+    padding?: number;
+    /** 是否允许点击预览，默认开启。 */
+    preview?: boolean;
+}
+/**
+ * 单元格条形码片段。
+ */
+interface ListTableBarcodeCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "barcode";
+    value: string;
+    format?: ListTableBarcodeFormat;
+    padding?: number;
+    color?: string;
+    backgroundColor?: string;
+    showText?: boolean;
+    text?: string;
+    /** 是否允许点击预览，默认开启。 */
+    preview?: boolean;
+}
+/**
+ * 单元格颜色块片段。
+ */
+interface ListTableColorCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "color";
+    /** CSS 颜色值。 */
+    value: string;
+    width?: number;
+    height?: number;
+    radius?: number;
+    borderColor?: string;
+}
+/**
+ * 单元格上下箭头片段。
+ */
+interface ListTableArrowCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "arrow";
+    direction: "up" | "down";
+    /** 箭头颜色，默认上箭头绿色、下箭头红色。 */
+    color?: string;
+    size?: number;
+    lineWidth?: number;
+}
+/**
+ * 单元格标签片段。
+ */
+interface ListTableTagCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "tag";
+    text: string;
+    /**
+     * 标签颜色配置。
+     *
+     * - 传入预设值时，会套用接近 AntD 的标签前景色 / 背景色 / 边框色
+     * - 传入任意颜色字符串时，会作为实色标签背景并自动推导文字颜色
+     */
+    color?: "default" | "success" | "processing" | "error" | "warning" | "blue" | "cyan" | "geekblue" | "gold" | "green" | "lime" | "magenta" | "orange" | "purple" | "red" | "volcano" | string;
+    textColor?: string;
+    backgroundColor?: string;
+    borderColor?: string;
+    fontSize?: number;
+    fontWeight?: string;
+    bordered?: boolean;
+    radius?: number;
+    paddingInline?: number;
+    height?: number;
+}
+/**
+ * 单元格选择器片段。
+ */
+interface ListTableSelectionCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "checkbox" | "radio";
+    checked: boolean;
+    disabled?: boolean;
+    label?: string;
+}
+/**
+ * 单元格开关片段。
+ */
+interface ListTableSwitchCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "switch";
+    checked: boolean;
+    disabled?: boolean;
+    checkedChildren?: string;
+    uncheckedChildren?: string;
+}
+interface ListTableNestedTableColumn {
+    title: string;
+    dataIndex: TableColumnDataIndex;
+    width?: number;
+    align?: "left" | "center" | "right";
+}
+/**
+ * 单元格内嵌表格片段。
+ */
+interface ListTableNestedTableCellContent<RecordType = any> extends ListTableBaseCellContent<RecordType> {
+    type: "table";
+    columns: ListTableNestedTableColumn[];
+    dataSource: Record<string, unknown>[];
+    rowKey?: TableColumnDataIndex | ((record: Record<string, unknown>, index: number) => string | number);
+    width?: number;
+    rowHeight?: number;
+    headerHeight?: number;
+    bordered?: boolean;
+    size?: "small" | "middle";
+    emptyText?: string;
+    highlightRowKeys?: Array<string | number>;
+    highlightRowIndexes?: number[];
+    highlightColumnDataIndexes?: TableColumnDataIndex[];
+    highlightColumnIndexes?: number[];
+}
+/**
+ * 单元格内容定义。
+ */
+type ListTableCellContent<RecordType = any> = ListTableArrowCellContent<RecordType> | ListTableIconCellContent<RecordType> | ListTableTextCellContent<RecordType> | ListTableMoneyCellContent<RecordType> | ListTableLinkCellContent<RecordType> | ListTableImageCellContent<RecordType> | ListTableProgressCellContent<RecordType> | ListTableChartCellContent<RecordType> | ListTableRateCellContent<RecordType> | ListTableButtonCellContent<RecordType> | ListTableQrCodeCellContent<RecordType> | ListTableBarcodeCellContent<RecordType> | ListTableColorCellContent<RecordType> | ListTableTagCellContent<RecordType> | ListTableSelectionCellContent<RecordType> | ListTableSwitchCellContent<RecordType> | ListTableNestedTableCellContent<RecordType>;
+/**
+ * 单元格跨度配置。
+ *
+ * 语义与 AntD Table 保持一致：
+ * - `rowSpan` / `colSpan` 大于 `1` 时表示从当前单元格向下/向右合并。
+ * - `rowSpan` / `colSpan` 为 `0` 时表示当前单元格不单独渲染。
+ */
+interface ListTableCellSpan {
+    rowSpan?: number;
+    colSpan?: number;
+}
+/**
+ * 单元格内容渲染函数。
+ */
+type ListTableRenderResult<RecordType = any> = ListTableCellContent<RecordType> | ListTableCellContent<RecordType>[] | string | number | null | undefined;
+type ListTableCellRender<RecordType> = (value: unknown, record: RecordType, rowIndex: number, column: ListTableColumn<RecordType>) => ListTableRenderResult<RecordType>;
+/**
+ * 单元格编辑值类型。
+ *
+ * 采用可扩展枚举，便于后续继续补充原生编辑器实现。
+ */
+type ListTableEditValueType = "text" | "number" | "input-range" | "year" | "quarter" | "month" | "time" | "datetime" | "timerange" | "date" | "date-range" | "datetime-range" | "color" | "select" | "auto-complete";
+/**
+ * 下拉编辑选项。
+ */
+interface ListTableEditOption {
+    label: string;
+    value: string | number;
+}
+/**
+ * 下拉编辑选项过滤函数。
+ */
+type ListTableEditFilterOption = (input: string, option: ListTableEditOption) => boolean;
+/**
+ * AutoComplete 可选的回车扩展回调。
+ */
+type ListTableEditAutoCompleteEnter = (input: string) => ListTableEditOption[] | void | Promise<ListTableEditOption[] | void>;
+/**
+ * 表单内容格式化器。
+ */
+type ListTableFormItemFormatter<RecordType = Record<string, unknown>> = "" | ((value: unknown, record: RecordType, rowIndex: number) => string);
+/**
+ * 下拉编辑选项解析上下文。
+ */
+interface ListTableFormItemPropsConfig<RecordType = Record<string, unknown>> {
+    valueType?: ListTableEditValueType;
+    clickCount?: number;
+    placeholder?: string;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    options?: ListTableEditOption[];
+    /** 是否开启下拉选项搜索。 */
+    showSearch?: boolean;
+    /** 自定义下拉选项过滤逻辑，仅在开启搜索时生效。 */
+    filterOption?: ListTableEditFilterOption;
+    /**
+     * AutoComplete 可选的回车扩展回调。返回刷新后的 options 时才重新映射输入值。
+     */
+    onPressEnter?: ListTableEditAutoCompleteEnter;
+    dependencies?: TableColumnDataIndex[];
+    rules?: ListTableFormRules<RecordType>;
+    rangeSeparator?: string;
+    format?: ListTableFormItemFormatter<RecordType>;
+}
+/**
+ * 单元格编辑器配置。
+ */
+type ListTableFormItemProps<RecordType = Record<string, unknown>> = ListTableFormItemPropsConfig<RecordType> | ((text: unknown, record: RecordType, index: number) => ListTableFormItemPropsConfig<RecordType>);
+/**
+ * 单元格是否可编辑配置。
+ */
+type ListTableEditable<RecordType = Record<string, unknown>> = boolean | ((text: unknown, record: RecordType, index: number) => boolean);
+/**
+ * 列定义。
+ */
+interface ListTableColumn<RecordType = Record<string, unknown>> {
+    key?: string;
+    title?: ListTableHeaderTitle;
+    dataIndex: TableColumnDataIndex;
+    children?: ListTableColumn<RecordType>[];
+    width?: number;
+    minWidth?: number;
+    maxWidth?: number;
+    align?: "left" | "center" | "right";
+    fixed?: "left" | "right";
+    hidden?: boolean;
+    ellipsis?: boolean;
+    /** 是否允许进入编辑输入态。 */
+    editable?: ListTableEditable<RecordType>;
+    /** 编辑器配置，未传时默认使用文本输入。 */
+    formItemProps?: ListTableFormItemProps<RecordType>;
+    /** 是否允许拖拽改变列宽。默认取表格级配置。 */
+    resizable?: boolean;
+    /** 是否允许拖拽排序。默认取表格级配置。 */
+    draggable?: boolean;
+    allowSort?: boolean;
+    sortValueGetter?: (record: RecordType) => string | number | null | undefined;
+    defaultSortOrder?: "ascend" | "descend";
+    sortPriority?: number;
+    allowFilter?: boolean;
+    filterModes?: Array<"fuzzy" | "exact">;
+    filterValueGetter?: (record: RecordType) => unknown;
+    filterOptionValueGetter?: (record: RecordType) => unknown;
+    filterOptions?: Array<string | ListTableFilterOption>;
+    render?: ListTableCellRender<RecordType>;
+    /**
+     * 单元格配置回调。
+     *
+     * 可返回 `rowSpan` / `colSpan` 来声明当前单元格的合并范围，
+     * 用法参考 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" | "chart" | "rate" | "checkbox" | "radio" | "switch" | "tag" | "button" | "custom";
+    cellStyle?: ListTableCellStyle;
+    /** 金额单元格格式配置，仅在 `cellType: "money"` 时生效。 */
+    moneyFormat?: ListTableMoneyFormatOptions;
+    headerStyle?: ListTableCellStyle;
+    /** 汇总行配置。设为 `true` 等效于 `{ type: "sum" }`。 */
+    summary?: boolean | ListTableSummaryConfig<RecordType>;
+    /** 汇总行标题。设置后该列在汇总行中显示此标题文本（用于"合计"等标签列）。 */
+    summaryTitle?: string;
+    meta?: Record<string, unknown>;
+}
+
+/**
+ * 列表表格 UI 适配层公共类型。
+ */
+
+type ListTableFilterMatchMode = "fuzzy" | "exact";
+type ListTableFilterType = "value" | "condition";
+type ListTableFilterConditionRelation = "and" | "or";
+type ListTableFilterConditionOperator = "none" | "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "between" | "notBetween" | "startsWith" | "notStartsWith" | "endsWith" | "notEndsWith" | "includes" | "notIncludes" | "blank" | "notBlank";
+interface ListTableFilterValue {
+    keyword: string;
+    mode: ListTableFilterMatchMode;
+    searchExact?: boolean;
+    selectedKeys?: string[];
+    filterType?: ListTableFilterType;
+    conditionOperator?: ListTableFilterConditionOperator;
+    conditionValue?: string;
+    conditionSecondValue?: string;
+    conditionRelation?: ListTableFilterConditionRelation;
+    secondConditionOperator?: ListTableFilterConditionOperator;
+    secondConditionValue?: string;
+    secondConditionSecondValue?: string;
+}
+interface FilterPanelOptionItem {
+    label: string;
+    value: string;
+    count: number;
+    kind?: "all" | "blank" | "notBlank" | "value";
+}
+interface FilterPanelTexts {
+    title: string;
+    valueFilterTab: string;
+    conditionFilterTab: string;
+    searchPlaceholder: string;
+    optionsLabel: string;
+    emptyOptions: string;
+    loadingOptions: string;
+    exactToggleLabel: string;
+    allOptionLabel: string;
+    blankOptionLabel: string;
+    notBlankOptionLabel: string;
+    operatorLabel: string;
+    relationLabel: string;
+    firstConditionLabel: string;
+    secondConditionLabel: string;
+    firstValuePlaceholder: string;
+    secondValuePlaceholder: string;
+    relationAndLabel: string;
+    relationOrLabel: string;
+    resetAction: string;
+    applyAction: string;
+}
+interface FilterPanelConfig {
+    columnTitle: string;
+    anchorRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    value: ListTableFilterValue;
+    /** 点击过滤候选项后是否立即应用，并保持当前候选项列表。 */
+    filterOptionImmediateApply?: boolean;
+    modes: ListTableFilterMatchMode[];
+    options: FilterPanelOptionItem[];
+    loadOptions?: (signal: AbortSignal) => FilterPanelOptionItem[] | Promise<FilterPanelOptionItem[]>;
+    texts: FilterPanelTexts;
+    onApply: (value: ListTableFilterValue) => void;
+    onReset: () => void;
+    onClose: () => void;
+}
+interface ListTableTooltipRequest {
+    x: number;
+    y: number;
+    content: string;
+    variant?: "default" | "error";
+    /**
+     * 表格内容缩放（1 = 100%），用于 tooltip 与画布视觉同步。
+     */
+    contentZoom?: number;
+}
+interface ListTableLoadingRequest {
+    text?: string;
+}
+interface FixedPopupConfig {
+    anchorRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    currentFixed?: "left" | "right";
+    onSelect: (direction: "left" | "right" | "none") => void;
+    onClose: () => void;
+}
+interface ListTableDangerConfirmRequest {
+    anchorRect: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    title: string;
+    description?: string;
+    okText?: string;
+    cancelText?: string;
+    onConfirm: () => void;
+    onCancel: () => void;
+}
+interface HeaderContextMenuColumnItem {
+    key: string;
+    title: string;
+    checked: boolean;
+    indeterminate?: boolean;
+    disabled?: boolean;
+    children?: HeaderContextMenuColumnItem[];
+}
+type HeaderContextMenuDensity = "comfortable" | "middle" | "compact";
+interface HeaderContextMenuConfig {
+    x: number;
+    y: number;
+    columns?: HeaderContextMenuColumnItem[];
+    density?: HeaderContextMenuDensity;
+    /**
+     * 当前表格缩放比例（1 = 100%）。
+     */
+    zoom?: number;
+    onCopyCell?: () => void;
+    onCopyColumn?: () => void;
+    onCopyRowText?: () => void;
+    onCopyRowJson?: () => void;
+    onCopySelection?: () => void;
+    customSelection?: {
+        startRow: number;
+        startColumn: number;
+        endRow: number;
+        endColumn: number;
+        rowCount: number;
+        columnCount: number;
+    };
+    onCopyCustomSelection?: (range: {
+        startRow: number;
+        startColumn: number;
+        endRow: number;
+        endColumn: number;
+    }) => void;
+    onExportJson?: () => void;
+    onExportCsv?: () => void;
+    onExportTxt?: () => void;
+    onExportXlsx?: () => void;
+    downloadContentLabel?: string;
+    onDownloadContent?: () => void;
+    toggleExpandRowLabel?: string;
+    onToggleExpandRow?: () => void;
+    onExpandAllCollapsedRows?: () => void;
+    toggleColumnLabel?: string;
+    onToggleCurrentColumn?: () => void;
+    onExpandAllCollapsedColumns?: () => void;
+    onFreezeRowTop?: () => void;
+    onFreezeRowBottom?: () => void;
+    onUnfreezeRow?: () => void;
+    onResetFilter?: () => void;
+    onResetSort?: () => void;
+    onResetHeader?: () => void;
+    onChangeDensity?: (density: HeaderContextMenuDensity) => void;
+    /**
+     * 调整表格缩放。
+     */
+    onChangeZoom?: (zoom: number) => void;
+    onToggleColumn?: (columnKey: string, visible: boolean) => void;
+    summaryVisible?: boolean;
+    summaryColumnKey?: string;
+    summaryType?: ListTableSummaryType;
+    summaryPrecision?: number;
+    onToggleSummary?: () => void;
+    onChangeSummaryType?: (type: ListTableSummaryType) => void;
+    onChangeSummaryPrecision?: (precision: number | undefined) => void;
+    onClose: () => void;
+}
+interface PaginationConfig {
+    mode?: "button" | "scroll";
+    current: number;
+    total: number;
+    pageSize?: number;
+    pageSizeOptions?: number[];
+    disabled?: boolean;
+    showSizeChanger?: boolean;
+    showQuickJumper?: boolean;
+    showLessItems?: boolean;
+    simple?: boolean;
+    showTotal?: (total: number, range: [number, number]) => string;
+    onChange?: (page: number, pageSize: number) => void;
+    onPageSizeChange?: (page: number, pageSize: number) => void;
+}
+type ListTableEditorValueType = "text" | "number" | "input-range" | "year" | "quarter" | "month" | "time" | "datetime" | "timerange" | "date" | "date-range" | "datetime-range" | "color" | "select" | "auto-complete";
+interface ListTableEditorOption {
+    label: string;
+    value: string | number;
+}
+type ListTableEditorFilterOption = (input: string, option: ListTableEditorOption) => boolean;
+/**
+ * AutoComplete 可选的回车扩展回调。
+ */
+type ListTableEditorAutoCompleteEnter = (input: string) => ListTableEditorOption[] | void | Promise<ListTableEditorOption[] | void>;
+interface ListTableEditorConfig {
+    valueType?: ListTableEditorValueType;
+    format?: ListTableFormItemFormatter<any>;
+    placeholder?: string;
+    min?: number | string;
+    max?: number | string;
+    step?: number | string;
+    options?: ListTableEditorOption[];
+    showSearch?: boolean;
+    filterOption?: ListTableEditorFilterOption;
+    onPressEnter?: ListTableEditorAutoCompleteEnter;
+    rangeSeparator?: string;
+}
+interface ListTableEditorRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+interface ListTableEditorTheme {
+    fontSize: number;
+    fontFamily: string;
+    textColor: string;
+    cellColor?: string;
+    /**
+     * 单元格水平内边距（已含缩放），用于编辑表单与画布内容对齐。
+     */
+    paddingInline?: number;
+    /**
+     * 单元格垂直内边距（已含缩放），用于编辑表单与画布内容对齐。
+     */
+    paddingBlock?: number;
+    /**
+     * 表格内容缩放（1 = 100%），用于编辑浮层 / 弹出层与画布视觉同步。
+     */
+    contentZoom?: number;
+}
+interface ListTableCellEditorSession {
+    element?: HTMLElement;
+    focus(): void;
+    getValue(): unknown;
+    destroy?(): void;
+}
+/**
+ * 编辑提交选项。
+ */
+interface ListTableEditorCommitOptions {
+    /** 提交后是否把键盘焦点交还给表格。 */
+    restoreTableFocus?: boolean;
+}
+interface ListTableTooltipAdapter {
+    mount(parent?: HTMLElement): void;
+    show(x: number, y: number, content: string, variant?: ListTableTooltipRequest["variant"]): void;
+    hide(): void;
+    destroy(): void;
+}
+interface ListTableLoadingAdapter {
+    show(request?: ListTableLoadingRequest): void;
+    hide(): void;
+}
+interface ListTableFilterPanelAdapter {
+    mount(parent?: HTMLElement): void;
+    show(config: FilterPanelConfig): void;
+    hide(): void;
+    isVisible(): boolean;
+    destroy(): void;
+}
+interface ListTableFixedPopupAdapter {
+    mount(parent?: HTMLElement): void;
+    show(config: FixedPopupConfig): void;
+    hide(): void;
+    isVisible(): boolean;
+    destroy(): void;
+}
+interface ListTableHeaderContextMenuAdapter {
+    mount(parent?: HTMLElement): void;
+    show(config: HeaderContextMenuConfig): void;
+    hide(): void;
+    isVisible(): boolean;
+    updateColumns(columns: HeaderContextMenuColumnItem[]): void;
+    destroy(): void;
+}
+interface ListTablePaginationAdapter {
+    mount(parent: HTMLElement, config: PaginationConfig): void;
+    update(config: PaginationConfig): void;
+    destroy(): void;
+}
+interface CreateCellEditorSessionParams {
+    rect: ListTableEditorRect;
+    clipRect?: ListTableEditorRect;
+    hostRect?: ListTableEditorRect;
+    hostElement?: HTMLElement;
+    value: unknown;
+    config: ListTableEditorConfig;
+    theme: ListTableEditorTheme;
+    onCommit: (options?: ListTableEditorCommitOptions) => void;
+    onCancel: () => void;
+    onNavigate?: (direction: ListTableEditorNavigateDirection) => void;
+}
+type ListTableEditorNavigateDirection = "up" | "down" | "prev" | "next";
+interface ListTableEditorRequest {
+    /** 当前编辑单元格标识，用于切换单元格时重置编辑器状态。 */
+    editorKey?: string;
+    rect: ListTableEditorRect;
+    clipRect?: ListTableEditorRect;
+    hostRect?: ListTableEditorRect;
+    hostElement?: HTMLElement;
+    value: unknown;
+    config: ListTableEditorConfig;
+    theme: ListTableEditorTheme;
+    onChange: (value: unknown) => void;
+    onCommit: (options?: ListTableEditorCommitOptions) => void;
+    onCancel: () => void;
+    onNavigate?: (direction: ListTableEditorNavigateDirection) => void;
+}
+interface ListTableEditorFactory {
+    createCellEditorSession(params: CreateCellEditorSessionParams): ListTableCellEditorSession | null;
+}
+
+/**
+ * 行拖拽可放置区域。
+ */
+type ListTableRowDragZone = "body" | "summary";
+/**
+ * 行拖拽成功放置后的源数据处理模式。
+ */
+type ListTableRowDragMode = "copy" | "move";
+/**
+ * 拖出来源信息。
+ */
+interface ListTableRowDragSourceInfo {
+    tableId: string;
+    payloadType: string;
+}
+/**
+ * 跨表行拖拽载荷。
+ */
+interface ListTableRowDragPayload {
+    version: 1;
+    type: string;
+    source: ListTableRowDragSourceInfo;
+    rowKeys: Array<string | number>;
+    records: unknown[];
+    columns: Array<{
+        key: string;
+        dataIndex?: string | number | Array<string | number>;
+        title?: string;
+    }>;
+    previewDataUrl?: string;
+}
+/**
+ * 行拖拽配置。
+ *
+ * 同一张表同时设置 `enabled`、`droppable` 和 `allowSelfDrop` 后，可在
+ * `onDrop` 中根据 `insertIndex` 更新数据顺序。两张表分别同时设置
+ * `enabled` 和 `droppable`，并互相接受对方的 `payloadType`，即可双向拖放。
+ * 表格只负责交互与回调，不会直接修改业务数据。
+ */
+interface ListTableRowDragOptions<RecordType> {
+    /**
+     * 是否允许从本表发起行拖拽。
+     * 双向拖放时，两张表都需要启用该项。
+     * @default false
+     */
+    enabled?: boolean;
+    /**
+     * 是否允许本表作为行放置目标。
+     * 同表排序和双向拖放时，参与接收的表都需要启用该项。
+     * @default false
+     */
+    droppable?: boolean;
+    /**
+     * 可接受的放置区域。
+     * @default ["body"]
+     */
+    acceptZones?: ListTableRowDragZone[];
+    /**
+     * 拖出模式：`copy` 保留源行；`move` 在目标表成功执行 `onDrop` 后，
+     * 通过源表的 `onDragEndRemove` 通知业务移除源行。
+     * 该配置属于拖拽来源表，不会自动修改任何一张表的数据。
+     * @default "copy"
+     */
+    mode?: ListTableRowDragMode;
+    /**
+     * 本表发起拖拽时写入载荷的类型。
+     * 异构表双向拖放时，每张表可声明各自的类型。
+     * @default "list-table/row"
+     */
+    payloadType?: string;
+    /**
+     * 本表作为目标时接受的载荷类型列表。
+     * 异构表双向拖放时，应包含另一张表的 `payloadType`；同构表使用相同
+     * `payloadType` 时通常无需显式设置。
+     * @default [当前表的 payloadType]
+     */
+    acceptTypes?: string[];
+    /**
+     * 是否接受来源也是当前表的载荷。
+     * 该项只开放同表放置能力；数据重排仍需由 `onDrop` 根据 `insertIndex`
+     * 完成。
+     * @default false
+     */
+    allowSelfDrop?: boolean;
+    /**
+     * 启动拖拽的像素阈值。
+     * @default 5
+     */
+    dragThreshold?: number;
+    /** 判断指定行是否允许拖出。 */
+    canDragRow?: (params: {
+        record: RecordType;
+        rowIndex: number;
+    }) => boolean;
+    /**
+     * 判断本表是否接受当前载荷与插入位置。
+     * 同表拖拽时可通过 `payload.source.tableId` 与当前表 `tableId` 比较来源。
+     */
+    canDrop?: (params: {
+        payload: ListTableRowDragPayload;
+        zone: ListTableRowDragZone;
+        /** `body` 区域内相对目标展示数据的插入索引，其他区域为 `null`。 */
+        insertIndex: number | null;
+    }) => boolean;
+    /**
+     * 将来源表行数据转换为当前目标表的数据结构。
+     * 双向拖放且两侧数据结构不同时，两张表需要分别提供反方向转换。
+     */
+    transform?: (payload: ListTableRowDragPayload) => RecordType[] | Promise<RecordType[]>;
+    /**
+     * 成功放入当前目标表后的业务处理。
+     * 跨表插入和同表排序都由业务在此更新数据源；表格不会自动插入或重排。
+     */
+    onDrop?: (params: {
+        rows: RecordType[];
+        zone: ListTableRowDragZone;
+        /** `body` 区域内相对目标展示数据的插入索引，其他区域为 `null`。 */
+        insertIndex: number | null;
+        source: ListTableRowDragSourceInfo;
+        nativeEvent: MouseEvent;
+    }) => void | Promise<void>;
+    /**
+     * `move` 模式下目标表成功接受放置后，通知来源表业务移除原始行。
+     * 同表放置由 `onDrop` 直接完成重排，不会调用该回调。
+     */
+    onDragEndRemove?: (params: {
+        keys: Array<string | number>;
+        records: unknown[];
+    }) => void | Promise<void>;
+}
+
+/**
+ * 表格点击高亮模式。
+ * - `cell`: 仅高亮当前单元格
+ * - `row`: 仅高亮当前行
+ * - `column`: 仅高亮当前列
+ * - `cross`: 同时高亮当前行与列（交叉高亮）
+ */
+type ListTableHighlightMode = "cell" | "row" | "column" | "cross";
+/**
+ * 右键菜单功能项。
+ */
+type ListTableContextMenuFeature = "copy" | "export" | "downloadContent" | "rowCollapse" | "columnCollapse" | "freeze" | "reset" | "density" | "zoom" | "columnVisibility";
+/**
+ * 右键菜单配置。
+ */
+interface ListTableContextMenuOptions {
+    /**
+     * 启用的功能列表。
+     * 不传时默认启用全部功能。
+     */
+    features?: ListTableContextMenuFeature[];
+    /**
+     * 禁用的功能列表，会从默认功能或 `features` 中排除。
+     */
+    disabledFeatures?: ListTableContextMenuFeature[];
+}
+/**
+ * 画布滚动条配置。
+ */
+interface ListTableScrollbarOptions {
+    thickness?: number;
+    horizontalLeft?: number;
+    horizontalRight?: number;
+    horizontalBottom?: number;
+    verticalTop?: number;
+    verticalRight?: number;
+    verticalBottom?: number;
+    /**
+     * 滚动条可见性。
+     * - `true`: 始终显示
+     * - `false`: 始终隐藏
+     * - `undefined`: 自动模式（滚动/悬停时显示，随后自动隐藏）
+     */
+    visible?: boolean;
+}
+/**
+ * 轮播滚动配置。
+ */
+interface ListTableCarouselScrollOptions {
+    /**
+     * 轮播滚动方向。
+     *
+     * - `vertical`: 纵向轮播滚动，每次按行步进。
+     * - `horizontal`: 横向轮播滚动，每次按列步进。
+     *
+     * @default "vertical"
+     */
+    direction?: "vertical" | "horizontal";
+    /**
+     * 轮播滚动间隔，单位毫秒。
+     *
+     * @default 2000
+     */
+    interval?: number;
+    /**
+     * 单次滚动步进单位。
+     *
+     * - `row`: 每次滚动一行。
+     * - `column`: 每次滚动一列。
+     *
+     * 未传时会根据 `direction` 自动推断：
+     * - `vertical` => `row`
+     * - `horizontal` => `column`
+     */
+    step?: "row" | "column";
+    /**
+     * 到达边界后是否循环滚动。
+     *
+     * - `true`: 到达底部或最右侧后，回到起点继续轮播。
+     * - `false`: 到达底部或最右侧后，停留在边界位置并停止轮播。
+     *
+     * @default true
+     */
+    loop?: boolean;
+}
+/**
+ * 自动合并配置。
+ */
+interface ListTableAutoMergeRule {
+    /**
+     * 参与自动合并判定的字段路径。
+     *
+     * - 行合并：连续记录在这些字段上的值都相同时，视为同一分组。
+     * - 列合并：同一行中这些字段对应的相邻列值相同时，会自动向右合并。
+     */
+    keys: TableColumnDataIndex[];
+    /**
+     * 需要真正执行合并的列。
+     *
+     * - 行合并：指定哪些列要显示成合并后的单元格。
+     * - 未传时默认回退为 `keys`，兼容旧配置。
+     */
+    columns?: TableColumnDataIndex[];
+}
+/**
+ * 查询区中的合并单元格配置。
+ */
+interface ListTableMergeCellOptions {
+    /**
+     * 自动合并行配置。
+     */
+    row?: ListTableAutoMergeRule;
+    /**
+     * 自动合并列配置。
+     */
+    column?: ListTableAutoMergeRule;
+}
+/**
+ * 查询配置。
+ */
+type ListTableQueryPagination = false | {
+    current: number;
+    pageSize: number;
+    total: number;
+};
+/**
+ * AntD 风格的过滤结果。
+ */
+type ListTableQueryFilters = Record<string, string[] | null>;
+/**
+ * AntD 风格的排序结果。
+ */
+interface ListTableQuerySorter {
+    columnKey: string | null;
+    field?: TableColumnDataIndex;
+    order: ListTableSortState["order"];
+}
+/**
+ * 分页配置。
+ */
+interface ListTablePaginationOptions {
+    /**
+     * 分页模式。
+     *
+     * - `button`: 底部按钮分页，行为与 AntD Table 类似。
+     * - `scroll`: 滚动加载，滚动到底部时自动追加下一批数据，不渲染分页组件。
+     */
+    mode?: "button" | "scroll";
+    current?: number;
+    pageSize?: number;
+    total?: number;
+    pageSizeOptions?: number[];
+    disabled?: boolean;
+    showSizeChanger?: boolean;
+    showQuickJumper?: boolean;
+    showLessItems?: boolean;
+    simple?: boolean;
+    showTotal?: (total: number, range: [number, number]) => string;
+    onChange?: (page: number, pageSize: number) => void;
+    onShowSizeChange?: (page: number, pageSize: number) => void;
+}
+interface ListTableRowSelectionRecordProps {
+    disabled?: boolean;
+}
+/**
+ * 行选择变更信息。
+ */
+interface ListTableRowSelectionChangeInfo {
+    type: "single" | "all" | "invert" | "none" | "multiple";
+}
+/**
+ * 行选择配置。
+ */
+interface ListTableRowSelectionOptions<RecordType> {
+    type?: "checkbox" | "radio";
+    selectedRowKeys?: Array<string | number>;
+    defaultSelectedRowKeys?: Array<string | number>;
+    fixed?: "left" | "right";
+    columnWidth?: number;
+    align?: "left" | "center" | "right";
+    onChange?: (selectedRowKeys: Array<string | number>, selectedRows: RecordType[], info: ListTableRowSelectionChangeInfo) => void;
+    onSelect?: (record: RecordType, selected: boolean, selectedRows: RecordType[]) => void;
+    getCheckboxProps?: (record: RecordType) => ListTableRowSelectionRecordProps;
+}
+/**
+ * AntD 风格的四参数查询回调。
+ */
+type ListTableQueryChange<RecordType> = (pagination: ListTableQueryPagination, filters: ListTableQueryFilters, sorter: ListTableQuerySorter, extra: ListTableQueryChangeExtra<RecordType>) => void;
+interface ListTableQueryOptions<RecordType> {
+    enabled?: boolean;
+    mode?: "local" | "remote";
+    dataSource?: RecordType[];
+    optionThreshold?: number;
+    /**
+     * 点击过滤候选项后是否立即应用过滤，并保持过滤面板打开。
+     *
+     * @default false
+     */
+    filterOptionImmediateApply?: boolean;
+    mergeCell?: ListTableMergeCellOptions;
+    onChange?: ListTableQueryChange<RecordType>;
+}
+/**
+ * 可展开行配置。
+ */
+interface ListTableExpandableOptions<RecordType = Record<string, unknown>> {
+    childrenColumnName?: string;
+    defaultExpandedRowKeys?: Array<string | number>;
+    expandedRowKeys?: Array<string | number>;
+    onExpand?: (expanded: boolean, record: RecordType) => void;
+    onExpandedRowsChange?: (expandedRowKeys: Array<string | number>) => void;
+    rowExpandable?: (record: RecordType) => boolean;
+    expandedRowRender?: (record: RecordType, index: number) => ListTableRenderResult<RecordType> | ListTableRenderResult<RecordType>[];
+    expandedRowHeight?: number | ((record: RecordType, index: number) => number);
+    indentSize?: number;
+    showExpandIcon?: boolean;
+    showExpandColumn?: boolean;
+    columnWidth?: number;
+    fixed?: "left" | "right";
+    expandRowByClick?: boolean;
+}
+/**
+ * UI 适配层配置。
+ */
+interface ListTableUiOptions {
+    editorFactory?: ListTableEditorFactory;
+    paginationAdapter?: ListTablePaginationAdapter;
+    onEditorRequest?: (request: ListTableEditorRequest | null) => void;
+    onPaginationRender?: (config: PaginationConfig | null) => void;
+    onTooltipRequest?: (request: ListTableTooltipRequest | null) => void;
+    onLoadingRequest?: (request: ListTableLoadingRequest | null) => void;
+    onFilterPanelRequest?: (request: FilterPanelConfig | null) => void;
+    onFixedPopupRequest?: (request: FixedPopupConfig | null) => void;
+    onHeaderContextMenuRequest?: (request: HeaderContextMenuConfig | null) => void;
+    onImagePreviewRequest?: (request: ListTableImagePreviewRequest | null) => void;
+    onDangerConfirmRequest?: (request: ListTableDangerConfirmRequest | null) => void;
+}
+interface ListTableImagePreviewRequest {
+    src: string;
+    alt?: string;
+    onClose: () => void;
+}
+/**
+ * 表格配置。
+ */
+interface ListTableOptions<RecordType = Record<string, unknown>> {
+    type?: "list";
+    rowKey?: TableColumnDataIndex | ((record: RecordType, index: number) => string | number);
+    /**
+     * 表格宽度。未传时默认占满宿主容器宽度。
+     */
+    width?: number | string;
+    /**
+     * 表格高度。未传时默认占满宿主容器高度。
+     * 当表格内容高度小于可用容器高度时，宿主会自动收缩到内容高度。
+     */
+    height?: number | string;
+    columns: ListTableColumn<RecordType>[];
+    dataSource: RecordType[];
+    emptyText?: string;
+    theme?: Partial<ListTableTheme>;
+    /**
+     * 是否开启斑马条纹。
+     * @default false
+     */
+    striped?: boolean;
+    /**
+     * 点击高亮模式。
+     * - `cell`: 仅高亮当前单元格
+     * - `row`: 仅高亮当前行（默认）
+     * - `column`: 仅高亮当前列
+     * - `cross`: 同时高亮当前行与列（交叉高亮）
+     * @default "row"
+     */
+    highlightMode?: ListTableHighlightMode;
+    /**
+     * 数据行高度。
+     *
+     * - 传入数字时使用固定高度
+     * - 默认 `auto`，会按当前列宽和单元格内容自动计算
+     * - 自动计算结果最小不低于 `40px`
+     *
+     * @default "auto"
+     */
+    rowHeight?: number | "auto";
+    headerRowHeight?: number;
+    /** 汇总行高度。 */
+    summaryRowHeight?: number;
+    overscanRowCount?: number;
+    query?: ListTableQueryOptions<RecordType>;
+    rowSelection?: ListTableRowSelectionOptions<RecordType>;
+    expandable?: ListTableExpandableOptions<RecordType>;
+    pagination?: false | ListTablePaginationOptions;
+    scrollbar?: ListTableScrollbarOptions;
+    carouselScroll?: ListTableCarouselScrollOptions;
+    /**
+     * 列宽不足容器宽度时，是否自动均分剩余空间。
+     * @default true
+     */
+    stretchColumns?: boolean;
+    /**
+     * 是否允许拖拽改变列宽。
+     * @default false
+     */
+    resizable?: boolean;
+    /**
+     * 列配置持久化存储键。设置后列宽、固定、排序、过滤、缩放状态会自动保存到 IndexDB。
+     */
+    storageKey?: string;
+    draggable?: boolean;
+    /**
+     * 跨表拖拽时的表格实例标识。不传则运行时自动生成。
+     */
+    tableId?: string;
+    /**
+     * 行拖拽配置，支持同表排序、跨表拖放以及两张表互相拖放。
+     */
+    rowDrag?: ListTableRowDragOptions<RecordType>;
+    /**
+     * 右键菜单配置。
+     * - 不传：启用全部默认功能
+     * - `false`：禁用右键菜单
+     * - 对象：按功能开关裁剪菜单项
+     */
+    contextMenu?: false | ListTableContextMenuOptions;
+    debug?: ListTableDebugOptions;
+    ui?: ListTableUiOptions;
+}
+
+/**
+ * 表格实例滚动参数。
+ */
+interface ListTableScrollToOptions {
+    rowIndex?: number;
+    colIndex?: number;
+    behavior?: "auto" | "smooth";
+}
+
+/**
+ * ListTable 原生入口。
+ */
+declare class ListTable<RecordType = Record<string, unknown>> {
+    private readonly container;
+    private options;
+    private core;
+    /**
+     * 创建表格实例。
+     *
+     * @param container 宿主容器。
+     * @param options 初始化参数。
+     */
+    constructor(container: HTMLElement, options: ListTableOptions<RecordType>);
+    /**
+     * 挂载表格。
+     */
+    mount(): void;
+    /**
+     * 更新配置。
+     *
+     * @param options 新配置。
+     */
+    updateOptions(options: ListTableOptions<RecordType>): void;
+    /**
+     * 获取调试快照。
+     *
+     * @returns 调试快照。
+     */
+    getDebugSnapshot(): ListTableDebugSnapshot | null;
+    /**
+     * 手动触发表格校验。
+     *
+     * 成功时返回当前表格数据，失败时抛出校验失败结果。
+     */
+    validate(): Promise<RecordType[]>;
+    /**
+     * 异步导出全部原始数据为 XLSX。
+     */
+    exportXlsx(): void;
+    /**
+     * 滚动到指定行。
+     */
+    scrollTo(options: ListTableScrollToOptions): void;
+    /**
+     * 重置排序状态。
+     */
+    resetSorter(): void;
+    /**
+     * 重置筛选状态。
+     */
+    resetFilter(): void;
+    /**
+     * 销毁实例。
+     */
+    destroy(): void;
+}
+
+interface ListTableValidationError<RecordType> {
+    rowIndex: number;
+    rowKey: string | number;
+    columnKey: string;
+    dataIndex?: TableColumnDataIndex;
+    message: string;
+    value: unknown;
+    record: RecordType;
+}
+interface ListTableValidationErrorField<RecordType> {
+    rowIndex: number;
+    rowKey: string | number;
+    columnKey: string;
+    dataIndex?: TableColumnDataIndex;
+    name: Array<string | number>;
+    errors: string[];
+    value: unknown;
+    record: RecordType;
+}
+interface ListTableValidationFailure<RecordType> {
+    values: RecordType[];
+    errorFields: ListTableValidationErrorField<RecordType>[];
+    outOfDate: boolean;
+}
+interface ListTableValidationTarget {
+    rowIndex: number;
+    columnKey: string;
+}
+
+export { type CreateCellEditorSessionParams, type DebugHitTestResult, type FilterPanelConfig, type FilterPanelOptionItem, type FilterPanelTexts, type FixedPopupConfig, type HeaderContextMenuColumnItem, type HeaderContextMenuConfig, type HeaderContextMenuDensity, ListTable, type ListTableAutoMergeRule, type ListTableBarcodeCellContent, type ListTableBarcodeFormat, type ListTableButtonCellContent, type ListTableButtonPopconfirmOptions, type ListTableButtonSize, type ListTableButtonType, type ListTableCarouselScrollOptions, type ListTableCellContent, type ListTableCellContentClickContext, type ListTableCellEditorSession, type ListTableCellSpan, type ListTableCellStyle, type ListTableChartCellContent, type ListTableChartSize, type ListTableChartType, type ListTableColorCellContent, type ListTableColumn, type ListTableContextMenuFeature, type ListTableContextMenuOptions, type ListTableCustomChartCellContent, type ListTableDangerConfirmRequest, type ListTableDebugOptions, type ListTableDebugSnapshot, 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 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 ListTableHeaderContextMenuAdapter, type ListTableHighlightMode, type ListTableIconCellContent, type ListTableImageCellContent, type ListTableImageObjectFit, type ListTableImagePreviewRequest, type ListTableLoadingAdapter, type ListTableLoadingRequest, type ListTableMergeCellOptions, type ListTableNestedTableCellContent, type ListTableNestedTableColumn, type ListTableOptions, type ListTablePaginationAdapter, type ListTablePaginationOptions, type ListTableProgressCellContent, type ListTableProgressShape, type ListTableProgressSize, type ListTableQrCodeCellContent, type ListTableQrCodeLevel, type ListTableQueryChange, type ListTableQueryChangeExtra, type ListTableQueryFilters, type ListTableQueryOptions, type ListTableQueryPagination, type ListTableQuerySorter, type ListTableRateCellContent, type ListTableRateSize, type ListTableRowDragMode, type ListTableRowDragOptions, type ListTableRowDragPayload, type ListTableRowDragSourceInfo, type ListTableRowDragZone, type ListTableRowSelectionChangeInfo, type ListTableRowSelectionOptions, type ListTableScrollToOptions, type ListTableScrollbarOptions, type ListTableSelectionState, type ListTableSortItem, type ListTableSortState, type ListTableSparklineChartCellContent, type ListTableSparklineSize, type ListTableSymbolType, type ListTableTagCellContent, type ListTableTheme, type ListTableTooltipAdapter, type ListTableTooltipRequest, type ListTableUiOptions, type ListTableValidationError, type ListTableValidationErrorField, type ListTableValidationFailure, type ListTableValidationTarget, type PaginationConfig, type RenderCellDescriptor };