@dazhicheng/ui 1.5.265 → 1.6.0

package/dist/components/tt-table/src/table-mutation-events.d.ts

@@ -0,0 +1,43 @@
+import { Recordable } from '../../../../../utils/src';
+import { TtSelectRowsType } from './types/table';
+/** 行数据回写时读取的数据来源：完整数据或历史操作后的可见数据。 */
+export type RowsCommitSource = "full" | "visible";
+/**
+ * VXE 事件转发表：键是 camelCase 事件名（`v-on` 对象语法的键），值是转发函数。
+ *
+ * 不用 `VxeGridEventProps`：那份声明的键带 `on` 前缀（`onSortChange`），
+ * 而这里的键是 `v-on="gridEvents"` 需要的 `sortChange`，由 Vue 在绑定时补 `on`。
+ */
+export type ForwardedEventMap = Record<string, (...args: Recordable[]) => void>;
+/**
+ * VXE 事件名到转发表键名（camelCase）的映射，模块级计算一次，所有表格实例共用。
+ *
+ * `camelCase` 的结果与实例无关，改动前 `Table.vue` 与 `TableForm.vue` 各自在 setup 里
+ * 对 117 个事件名跑一遍，一个页面 3 张表就是 702 次重复计算。
+ * 转发闭包本身仍然每实例一份（闭包里绑定的是当前实例的 `emit`）。
+ */
+export declare const forwardedEventEntries: ReadonlyArray<readonly [vxeEventName: string, forwardedKey: string]>;
+/**
+ * 判断某个 VXE 事件是否改动了业务行数据，需要回写 v-model。
+ *
+ * 三类来源合成一个判定：固定的变更事件表、`edit-activated` 的插入行判定、
+ * `toolbar-button-click` 的 remove 确认框判定，与改动前 `Table.vue` 里的三段 if 逐条等价。
+ * @param eventName VXE 事件名
+ * @param args 事件参数
+ * @param getSelectedRows 读取事件发生前组件记录的选中行
+ */
+export declare function isRowDataMutationEvent(eventName: string, args: Recordable[], getSelectedRows: () => TtSelectRowsType): boolean;
+/**
+ * 判断某个 VXE 事件是否只改变展示结果（排序 / 筛选）。
+ *
+ * 排序与筛选是视图状态，不进入数据回写路径，命中时要取消本轮待提交的回写。
+ * @param eventName VXE 事件名
+ */
+export declare function isDisplayOnlyEvent(eventName: string): boolean;
+/**
+ * 取某个变更事件回写时应该读取的数据来源。
+ *
+ * 撤销/重做需要按操作后的可见数据回写，其余读完整数据。
+ * @param eventName VXE 事件名
+ */
+export declare function getMutationCommitSource(eventName: string): RowsCommitSource;

package/dist/components/tt-table/src/table-mutation-events.js

@@ -0,0 +1,70 @@
+import "axios";
+import "element-plus";
+import { isString as s, isArray as c } from "../../../packages/utils/src/is.js";
+import "vue";
+import u from "xe-utils";
+import "dayjs";
+import "dayjs/plugin/utc";
+import "dayjs/plugin/timezone";
+import "../../../node_modules/.pnpm/decimal.js@10.6.0/node_modules/decimal.js/decimal.js";
+import "../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/aes.js";
+import "../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/enc-utf8.js";
+import "../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/mode-ecb.js";
+import "../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/pad-pkcs7.js";
+import "lodash-es";
+import { basicTableEmits as d } from "./emits.js";
+const p = /* @__PURE__ */ new Set([
+  "update:data",
+  "cell-delete-value",
+  "cell-backspace-value",
+  "row-dragend",
+  "row-remove-dragend",
+  "row-insert-dragend",
+  "enter-append-row",
+  "tab-append-row",
+  "paste",
+  "cut",
+  "undo",
+  "redo",
+  "fnr-replace",
+  "fnr-replace-all",
+  "cell-area-cut",
+  "cell-area-paste",
+  "cell-area-extension-fill",
+  "cell-area-fill-copy"
+]), f = /* @__PURE__ */ new Set([
+  "sort-change",
+  "clear-sort",
+  "clear-all-sort",
+  "filter-change",
+  "clear-filter",
+  "clear-all-filter"
+]), m = /* @__PURE__ */ new Set(["insert", "insert_edit", "insert_actived", "remove"]), w = /* @__PURE__ */ new Set(["undo", "redo"]), _ = d.map((t) => [t, u.camelCase(t)]);
+function b(t) {
+  var r, o;
+  const e = t[0];
+  return !!(e != null && e.row) && !!((o = (r = e == null ? void 0 : e.$table) == null ? void 0 : r.isInsertByRow) != null && o.call(r, e.row));
+}
+function g(t, e) {
+  var i, n, l;
+  const r = t[0], o = r == null ? void 0 : r.code;
+  if (!s(o) || !m.has(o)) return !1;
+  if (o !== "remove") return !0;
+  const a = e();
+  return (c(a) ? !a.length : !a) ? !1 : !((l = (n = (i = r == null ? void 0 : r.$grid) == null ? void 0 : i.getCheckboxRecords) == null ? void 0 : n.call(i)) != null && l.length);
+}
+function $(t, e, r) {
+  return p.has(t) ? !0 : t === "edit-activated" ? b(e) : t === "toolbar-button-click" ? g(e, r) : !1;
+}
+function B(t) {
+  return f.has(t);
+}
+function U(t) {
+  return w.has(t) ? "visible" : "full";
+}
+export {
+  _ as forwardedEventEntries,
+  U as getMutationCommitSource,
+  B as isDisplayOnlyEvent,
+  $ as isRowDataMutationEvent
+};

package/dist/components/tt-table/src/types/table.d.ts

@@ -1,12 +1,10 @@
-import { ComputedRef, CSSProperties, MaybeRef, Ref, VNode } from 'vue';
+import { ComputedRef, CSSProperties, MaybeRef, Ref } from 'vue';
 import { VxeGridMethods, VxeGridProps, VxeGridPropTypes, VxeTableDefines, VxeTablePropTypes } from 'vxe-table';
 import { TableApi } from '../utils/table-api';
 import { TtExtendedFormApi } from '../../../tt-form';
 export type TtTablePagerProps = {
     /** 是否显示分页 */
     showPager?: boolean;
-    /** 数据总数 */
-    total?: number;
     /** 当前页数 field */
     currentPageField?: string;
     /** 当前页的大小 field */
@@ -16,9 +14,18 @@ export type TtTablePagerProps = {
     /** 数据的 field */
     dataField?: string;
 };
-export type TtTableColumnsProps = {
+export type TtTableColumnsProps<Row = any> = {
     /** 是否显示复选框 */
     showCheckbox?: boolean;
+    /**
+     * 是否跨页保持复选框选中状态。
+     *
+     * 开启后组件会把 vxe 的 `checkboxConfig.reserve` 置为 `true`（调用方显式配置优先），
+     * 并让 `getSelectRows()` 合并当前页记录与跨页保留记录 —— vxe 的 `getCheckboxRecords()`
+     * 只返回当前页，跨页那部分要另外从 `getCheckboxReserveRecords()` 取。
+     * @default false
+     */
+    reserveSelection?: boolean;
     /** 是否显示展开列 */
     showExpand?: boolean;
     /** 是否显示单选框 */
@@ -29,65 +36,42 @@ export type TtTableColumnsProps = {
     showAction?: boolean;
     /** 是否显示导出按钮 */
     showExport?: boolean;
-    /** 是否显示导入按钮 */
-    showImport?: boolean;
     /** 操作列宽度 */
     actionWidth?: number;
     /** 操作列列名 */
     actionTitle?: string;
     /** 是否需要列宽拖拽 */
     isCellResize?: boolean;
-    /**
-     * 是否拖动列
-     * @deprecated 请使用 column-config drag 配合column-drag-config配置 支持的版本看官方文档，后续不在维护列拖拽 如需用官方的设置为false
-     * @default true
-     */
-    isColumnsDrag?: boolean;
     /** 是否列排序 */
     isCellSort?: boolean;
-    /**
-     * 是否checkbox区域选择 选中数据
-     * @deprecated
-     */
-    isAreaCheckData?: boolean;
     /** 操作列Props */
-    actionProps?: VxeTableDefines.ColumnOptions;
+    actionProps?: TtColumnOptions<Row>;
     /** 序号列Props */
-    indexColumnProps?: VxeTableDefines.ColumnOptions;
+    indexColumnProps?: TtColumnOptions<Row>;
     /** 复选框列Props */
-    checkboxColumnProps?: VxeTableDefines.ColumnOptions;
+    checkboxColumnProps?: TtColumnOptions<Row>;
     /** 展开行props */
-    expandColumnProps?: VxeTableDefines.ColumnOptions;
+    expandColumnProps?: TtColumnOptions<Row>;
     /** 单选框列Props */
-    radioColumnProps?: VxeTableDefines.ColumnOptions;
+    radioColumnProps?: TtColumnOptions<Row>;
     /** 表格行id */
     tableRowId?: string;
-    /**
-     * 是否需要行拖拽-树形表格
-     * @deprecated 请使用 row-config drag 配合row-drag-config配置 支持的版本看官方文档，后续不在维护行拖拽
-     * @default false
-     */
-    treeNode?: boolean;
 };
-export type TtTableFetchProps = {
+export type TtTableFetchProps<Row = any> = {
     /** api请求方法 */
-    api?: (...arg: any[]) => Promise<Recordable>;
+    api?: (...arg: any[]) => Promise<Recordable | Recordable[]>;
     /** filter api请求方法 */
-    filterApi?: (...arg: any[]) => Promise<Recordable>;
-    /** filter option api请求方法 */
-    filterOptionApi?: (...arg: any[]) => Promise<Recordable>;
+    filterApi?: (...arg: any[]) => Promise<Recordable | Recordable[]>;
     /** 表格额外参数 */
     searchInfo?: Recordable;
     /** 是否初始化加载数据 */
     immediate?: boolean;
-    /** 请求的状态码 @deprecated */
-    resultCode?: string | number;
     /**
      * 请求后的回调
      * @param data 表格数据
      * @param res 原始结果数据
      */
-    afterFetch?: (data: VxeTablePropTypes.Row[], res: Recordable) => Promise<VxeTablePropTypes.Row[]>;
+    afterFetch?: (data: Row[], res: Recordable | Recordable[]) => Promise<Row[]>;
     /**
      * 请求前的回调
      * @param params 请求参数
@@ -95,11 +79,6 @@ export type TtTableFetchProps = {
     beforeFetch?: (params: Recordable) => Promise<Recordable>;
     /** 是否滚动加载 */
     isScrollFetch?: boolean;
-    /**
-     * 滚动加载是否加载动画
-     * @default true
-     */
-    showScrollFetchLoading?: boolean;
 };
 export type TtTableToolbarProps = {
     /** 是否显示toolbar */
@@ -114,31 +93,46 @@ export type TtTableToolbarProps = {
     showSetting?: boolean;
     /** 是否显示自定义列 */
     showSetColumn?: boolean;
-    /** 是否显示自定义行距 */
-    showLineHeight?: boolean;
     /** 不可自定义列数组 field数组 */
     notSetColumnField?: string[];
-    /** 需要对不显示的字段进行过滤 主要针对于自定义  field数组 */
-    filterNoVisibleField?: string[];
     /** 是否显示表格上方 alert */
     showTableAlert?: boolean;
 };
-type UseTableProps = TtTablePagerProps & TtTableColumnsProps & TtTableFetchProps & TtTableToolbarProps;
-export type TtTableProps = {
-    /** 标题内容 */
-    title?: string;
-    /** 是否显示标题 */
-    showTitle?: boolean;
+type UseTableProps<Row = any> = TtTablePagerProps & TtTableColumnsProps<Row> & TtTableFetchProps<Row> & TtTableToolbarProps;
+/**
+ * 列的表尾合计方式。
+ *
+ * 三种预设按列字段取值计算：`sum` 求和、`avg` 求平均、`count` 计数；
+ * 函数形式接收该列的全部单元格值与参与合计的行数据，返回直接显示在表尾的内容。
+ */
+export type TtColumnSummary<Row = any> = "sum" | "avg" | "count" | ((params: {
+    values: unknown[];
+    rows: Row[];
+    column: VxeTableDefines.ColumnOptions<Row>;
+}) => string | number);
+/**
+ * tt-table 的列配置：vxe 原生列配置加上组件自己的字段。
+ *
+ * 只扩展不覆盖，任何 vxe 列配置都可以原样传入。传入行类型后，vxe 原生字段
+ * （`editRender` / `formatter` / `slots` 等）的回调参数也会跟着推断出行类型。
+ */
+export type TtColumnOptions<Row = any> = VxeTableDefines.ColumnOptions<Row> & {
+    /** 表尾合计方式，声明后组件自动生成 vxe 的 footerMethod 并按运行时列顺序对齐 */
+    summary?: TtColumnSummary<Row>;
+    /** 子列 */
+    children?: TtColumnOptions<Row>[];
+};
+/**
+ * 表格配置。
+ *
+ * `Row` 是业务行数据类型，`useTableRender<User>()` / `useTableFormRender<User>()` 传入后，
+ * 列配置、`data` / `modelValue`、`afterFetch`、插槽作用域与 `tableApi` 的方法签名都会跟着推断。
+ * 不传时退化为 `any`，与改动前完全一致。
+ */
+export type TtTableProps<Row = any> = {
     /** 是否自适应高度 */
     autoHeight?: boolean;
-    /**
-     * 额外减去的高度
-     * @deprecated
-     */
-    offsetHeight?: number;
     loading?: boolean;
-    /** loading text */
-    loadingText?: string;
     /** 空数据的提示文字 */
     emptyText?: string;
     /** 未查询时文字 */
@@ -150,9 +144,21 @@ export type TtTableProps = {
      * @default 'no-data'
      */
     emptyImageStatus?: "no-data" | "no-search";
-    /** 是否手动触发查询事件 */
-    isHanderSubmit?: boolean;
-    modelValue?: Array<Recordable>;
+    /**
+     * 表头标题是否显示 tooltip。
+     *
+     * 开启后由 vxe 负责溢出检测与弹层，只在标题真的被裁剪时才弹；可用原生 `headerTooltipConfig` 调样式。
+     * @default false
+     */
+    showHeaderTooltip?: boolean;
+    /**
+     * 单元格内容是否显示 tooltip。
+     *
+     * 开启后翻译成 vxe 的 `showOverflow: "tooltip"`，由它做溢出检测，只在内容真的被裁剪时才弹；
+     * 可用原生 `tooltipConfig` 调样式。关闭时沿用 `showOverflow` 的原有取值。
+     * @default false
+     */
+    showCellTooltip?: boolean;
     /** form-methods */
     formApi?: Partial<TtExtendedFormApi>;
     /** 储存的列key值，支持函数动态获取 */
@@ -171,11 +177,6 @@ export type TtTableProps = {
     leftSlotWidth?: number;
     /** 右侧插槽的宽度 */
     rightSlotWidth?: number;
-    /**
-     * 是否显示行高设置icon
-     * @default true
-     */
-    showLineHeight?: boolean;
     /**
      * 是否显示刷新icon
      * @default true
@@ -205,26 +206,16 @@ export type TtTableProps = {
         userId: string | number;
         id: string | number;
     }) => Promise<any>;
-    /** 外部插槽 */
-    getSyncSlotComponent?: (column: any, row: any, type: "default" | "edit") => VNode | VNode[] | string;
     /** 自定义Column */
-    customizeColumn?: (column: VxeTableDefines.ColumnOptions) => VxeTableDefines.ColumnOptions;
+    customizeColumn?: (column: TtColumnOptions<Row>) => TtColumnOptions<Row>;
     /** 是否清空树形展开的状态 */
     clearTreeExpand?: boolean;
-    /** 是否进行国际化 */
-    isI18n?: boolean;
-    /**
-     * 外部数据是否拷贝一份
-     * 设置为 false 时，会有性能问题
-     * @default true
-     */
-    isDataCloneDeep?: boolean;
     /** 是否使用搜索表单 */
     useSearchForm?: boolean;
     /** 数据源 */
-    data?: MaybeRef<any[]>;
-    /**  */
-    columns?: MaybeRef<VxeTableDefines.ColumnOptions[]>;
+    data?: MaybeRef<Row[]>;
+    /** 列配置 */
+    columns?: MaybeRef<TtColumnOptions<Row>[]>;
     /**
      * 表格 testId，用于生成测试标识
      * 如果不指定，将从 api 路径自动提取
@@ -239,7 +230,16 @@ export type TtTableProps = {
      * @default 'right'
      */
     toolTipErrorPlacement?: "top" | "bottom" | "left" | "right";
-} & Omit<VxeGridProps, "data" | "columns"> & UseTableProps;
+} & Omit<VxeGridProps<Row>, "data" | "columns"> & UseTableProps<Row>;
+/** 表格组件的 v-model 属性 */
+export type TtTableModelProps<Row = any> = {
+    /** 双向绑定的表格数据 */
+    modelValue?: Row[];
+    /** 表格数据更新回调 */
+    "onUpdate:modelValue"?: (rows: Row[]) => void;
+};
+/** useTableRender 返回组件支持的属性 */
+export type TtTableRenderProps<Row = any> = TtTableProps<Row> & TtTableModelProps<Row>;
 export type VxeTableMethods<DT> = {
     /**
      * 往表格插入临时数据，从第一行新增一行或多行新数据
@@ -261,6 +261,26 @@ export type VxeTableMethods<DT> = {
         row: DT;
         rows: DT[];
     }>;
+    /** 在指定行之后插入临时数据 */
+    insertNextAt: (records: any, row: any | -1 | null) => Promise<{
+        row: DT;
+        rows: DT[];
+    }>;
+    /** 在树节点下插入临时子数据 */
+    insertChild: (records: any, parentRow: any) => Promise<{
+        row: DT;
+        rows: DT[];
+    }>;
+    /** 在树节点下的指定位置插入临时子数据 */
+    insertChildAt: (records: any, parentRow: any, row: any | -1 | null) => Promise<{
+        row: DT;
+        rows: DT[];
+    }>;
+    /** 在树节点下的指定行之后插入临时子数据 */
+    insertChildNextAt: (records: any, parentRow: any, row: any | -1 | null) => Promise<{
+        row: DT;
+        rows: DT[];
+    }>;
     /**
      * 删除指定行数据，指定 row 或 [row, ...] 删除多条数据，如果为空则删除所有数据
      * @param rows 指定行
@@ -290,6 +310,29 @@ export type VxeTableMethods<DT> = {
         row: DT;
         rows: DT[];
     }>;
+    /**
+     * 删除所有新增的临时数据
+     */
+    removeInsertRow: () => Promise<{
+        row: DT;
+        rows: DT[];
+    }>;
+    /** 清除表格的全部数据状态 */
+    clearAll: () => Promise<void>;
+    /**
+     * 重新加载 VXE 当前同步数据。
+     * @deprecated VXE 已废弃 syncData，请使用 reloadData 或 getDataSource。
+     */
+    syncData: () => Promise<void>;
+    /** 重新计算 VXE 的数据视图 */
+    updateData: () => Promise<void>;
+    /** 修改指定行数据 */
+    setRow: (rows: any | any[], record: any) => Promise<void>;
+    /**
+     * 设置空数据提示文字
+     * @param text 提示文字
+     */
+    setEmptyText: (text: string) => void;
     /**
      * 清除编辑状态并重置数据
      */
@@ -324,12 +367,28 @@ export type VxeTableMethods<DT> = {
      * @param field 指定字段名
      */
     reloadRow: (rows: any | any[], record?: any, field?: string) => Promise<void>;
+    /** 还原 keep-source 保存的行数据 */
+    revertData: (rows?: any | any[], field?: string) => Promise<any>;
+    /** 加载树节点的子数据 */
+    loadTreeChildren: (row: any, children: any[]) => Promise<any[]>;
     /**
      * 手动清空单元格内容，如果不传参数，则清空整个表格内容，如果传了行则清空指定行内容，如果传了指定字段，则清空该字段内容
      * @param rows 指定行
      * @param field 字段名
      */
     clearData: (rows?: any | any[], field?: string) => Promise<any>;
+    /** 移动行到指定行位置 */
+    moveRowTo: (row: any, targetRow: any, options?: Recordable) => Promise<{
+        status: boolean;
+    }>;
+    /** 撤销最近一次数据操作 */
+    undo: () => Promise<{
+        status: boolean;
+    }>;
+    /** 重做最近一次数据操作 */
+    redo: () => Promise<{
+        status: boolean;
+    }>;
     /**
      * 重新懒加载展开行，并展开内容
      * @param row 指定行
@@ -340,9 +399,74 @@ export type VxeTableMethods<DT> = {
      * @param rows 指定行
      */
     reloadTreeExpand: (row: any) => Promise<any>;
+    /**
+     * 校验表格编辑数据
+     * @param isFull true 时校验全部行并收集所有错误，缺省或 false 时遇到第一个错误即停止
+     */
+    validate: (isFull?: boolean) => Promise<undefined | VxeTableDefines.ValidatorErrorMapParams>;
+    /**
+     * 校验指定行的指定字段
+     * @param row 行数据
+     * @param field 列字段名
+     */
+    validateField: (row: DT, field: string) => Promise<undefined | VxeTableDefines.ValidatorErrorMapParams>;
 };
 export type TtSelectRowKeysType = Array<string | number> | string | number | undefined | any;
 export type TtSelectRowsType = VxeTablePropTypes.Row | Array<VxeTablePropTypes.Row> | any;
+/**
+ * `useTableRender` 返回组件的插槽类型。
+ *
+ * 列插槽（列上写 `slots: { default: 'xxx' }`）的名字是运行时字符串，类型系统看不到，
+ * 所以用索引签名统一给出行作用域参数 —— 插槽名拼错不会报错，但 `row` 能推断出行类型。
+ */
+export type TtTableSlots<Row = any> = {
+    /** 操作列 */
+    action: (props: {
+        row: Row;
+        rowIndex: number;
+        $rowIndex: number;
+        column: TtColumnOptions<Row>;
+    }) => any;
+    /** 展开行内容 */
+    "expand-content": (props: {
+        row: Row;
+        rowIndex: number;
+    }) => any;
+    /** 空状态，不传时渲染组件默认内容 */
+    empty: (props: {
+        isLoaded: boolean;
+        loading?: boolean;
+        emptyTip?: string;
+    }) => any;
+    /** 工具栏左侧按钮 */
+    toolbar_buttons: () => any;
+    /** 工具栏右侧工具 */
+    toolbar_tools: () => any;
+    /** 表格上方 alert 内的追加内容 */
+    top_title: () => any;
+    /** 分页器左侧 */
+    pager_left: (props: {
+        selectedKeys: TtSelectRowKeysType;
+    }) => any;
+    /** 分页器左侧（追加在 pager_left 之后） */
+    buttom_left: () => any;
+    /** 表格左侧按行渲染的内容 */
+    tableLeft: (props: {
+        rowNodes: TtTableLeftRightRowNode[];
+        height: number;
+    }) => any;
+    /** 表格右侧按行渲染的内容 */
+    tableRight: (props: {
+        rowNodes: TtTableLeftRightRowNode[];
+        height: number;
+    }) => any;
+    /** 完全接管表格左侧区域 */
+    left: () => any;
+    /** 完全接管表格右侧区域 */
+    right: () => any;
+    /** 列插槽等运行时名字的插槽 */
+    [slotName: string]: (props: any) => any;
+};
 export type TtTableMethods<DT = VxeTablePropTypes.Row> = {
     /**
      * @description: 表格重载数据, 默认重置为第一页，可全局配置 isReloadResetToFirstPage:false 不重置为第一页
@@ -376,11 +500,6 @@ export type TtTableMethods<DT = VxeTablePropTypes.Row> = {
      * @return {*}
      */
     setTableColumns: (columns: VxeGridPropTypes.Columns<DT>) => void;
-    /**
-     * @description: 获取表格columns
-     * @return {VxeGridPropTypes.Columns<DT> | undefined}
-     */
-    emitLoading?: (loading: boolean, uid: number) => void;
     /**
      * @description: 获取表格数据
      * @return {DT[]}
@@ -484,8 +603,8 @@ export type TtTableLeftRightRowNode = {
     index?: number;
     parent?: any;
 };
-export type TtTableExtendedTableApi = TableApi & {
-    useStore: <T = NoInfer<TtTableProps>>(selector?: (state: NoInfer<TtTableProps>) => T) => Readonly<Ref<T>>;
+export type TtTableExtendedTableApi<Row = any> = TableApi<Row> & {
+    useStore: <T = NoInfer<TtTableProps<Row>>>(selector?: (state: NoInfer<TtTableProps<Row>>) => T) => Readonly<Ref<T>>;
 };
 export type RowSelectionHandlers = {
     clearSelectedRowKeys?: () => void;

package/dist/components/tt-table/src/types/tableAction.d.ts

@@ -1,26 +1,49 @@
 import { TipConfig } from '../../../../directives/disabled-tip';
 import { ButtonProps } from 'element-plus';
+/** 工具栏支持的内置按钮组件名称 */
 export type TtActionComponentType = "TtAddButton" | "TtDelButton" | "TtUploadButton" | "TtEnableButton" | "TtDisabledButton";
+/** 操作列和工具栏按钮的通用配置 */
 export type TtActionItem = {
+    /** 点击回调；操作列和工具栏按钮都使用该字段 */
     onClick?: Fn;
+    /** 历史遗留字段，当前渲染器不会调用，请使用 onClick */
     handler?: Fn;
+    /** 按钮文本 */
     label?: string;
+    /** 历史图标字段，当前渲染器不会读取，请使用 iconFont */
     icon?: string;
+    /** 历史图标尺寸字段，当前渲染器不会读取 */
     iconSize?: number;
+    /** 按钮类型 */
     type?: "" | "default" | "success" | "warning" | "info" | "text" | "primary" | "danger";
+    /** 历史 class 字段，普通按钮请通过 props.class 传入 */
     class?: string;
+    /** iconfont 图标名称 */
     iconFont?: string;
+    /** 预留的分割线配置，当前按钮组件不会读取 */
     divider?: boolean;
+    /** 按钮 loading 状态 */
     loading?: boolean;
+    /** 权限编码；当前组件不会自动执行权限判断 */
     auth?: string[];
+    /** 业务条件控制是否显示 */
     ifShow?: boolean | ((action: TtActionItem) => boolean);
+    /** 是否禁用按钮 */
     disabled?: boolean;
+    /** 禁用时显示的提示 */
     disabledTip?: Array<TipConfig> | TipConfig;
+    /** 按钮文字颜色 */
     color?: string;
+    /** 工具栏使用的已注册按钮组件名称 */
     component?: TtActionComponentType;
+    /** 工具栏下拉按钮的子项 */
     children?: TtActionItem[];
+    /** 使用同名插槽替代默认按钮 */
     slot?: string;
+    /** 工具栏按钮尺寸 */
     size?: "" | "default" | "small" | "large";
+    /** 操作列中隐藏文本但保留按钮占位 */
     isTextHide?: boolean;
+    /** 透传给工具栏 TtButton 的其它属性 */
     props?: Partial<ButtonProps>;
 };

package/dist/components/tt-table/src/types/tableForm.d.ts

@@ -1,16 +1,19 @@
 import { MaybeRef, Ref } from 'vue';
-import { VxeGridMethods } from 'vxe-table';
 import { TtSelectRowKeysType, TtTableMethods, TtTableProps } from '../types/table';
 import { TableFormApi } from '../utils/table-form-api';
 import { TtTableToolsProps } from './tableTools';
 import { TtExtendedFormApi, TtFormProps } from '../../../tt-form';
 export type TtTableFormRenderFormProps = Partial<TtFormProps>;
 export type TtTableRenderFormInstance = TtExtendedFormApi;
-export type TtTableFormProps = {
-    /** 双向绑定的表格数据 */
-    tableData?: Array<Recordable>;
+/**
+ * 表单 + 表格的组合配置。
+ *
+ * `Row` 是业务行数据类型，由 `useTableFormRender<Row>()` 传入后 `table` 里的列配置、
+ * 数据与 `tableApi` 的方法签名都会跟着推断；不传时退化为 `any`。
+ */
+export type TtTableFormProps<Row = any> = {
     /** 表格配置 */
-    table?: Partial<TtTableProps>;
+    table?: Partial<TtTableProps<Row>>;
     /** form 配置 */
     form?: TtTableFormRenderFormProps;
     /** 是否开启form表单 */
@@ -30,35 +33,21 @@ export type TtTableFormProps = {
      */
     testId?: string;
 };
-export type TtTableFormInstance = {
-    /** 获取TtTableV2实例 */
-    tableInstance: () => Promise<TtTableMethods>;
-    /** 获取TtForm实例 */
-    formInstance: () => Promise<TtTableRenderFormInstance>;
-    /** 获取VxeGrid实例 */
-    vxeGridInstance: () => Promise<VxeGridMethods>;
-};
-export type TtTableFormActionType = {
-    setTableProps: (props: Partial<TtTableProps>) => void;
+export type TtTableFormActionType<Row = any> = {
+    setTableProps: (props: Partial<TtTableProps<Row>>) => void;
     setFormProps: (props: TtTableFormRenderFormProps) => void;
-    tableMethods: TtTableMethods;
+    tableMethods: TtTableMethods<Row>;
     formMethods: TtTableRenderFormInstance;
     /** 设置props */
-    setProps: (props: Partial<TtTableFormProps>) => void;
+    setProps: (props: Partial<TtTableFormProps<Row>>) => void;
     /** reload */
-    reload: TtTableMethods["reload"];
+    reload: TtTableMethods<Row>["reload"];
     /**
      * @description: 获取表格选中数据
      * @return {TtSelectRowKeysType[]}
      */
     selectedKeys: MaybeRef<TtSelectRowKeysType>;
 };
-export type TtTableFormMethod = TtTableFormInstance & Omit<TtTableFormActionType, "tableMethods" | "formMethods"> & {
-    tableMethods?: TtTableMethods;
-    formMethods?: TtTableRenderFormInstance;
-};
-export type TableFormRegisterFn = (instance: TtTableFormActionType, uuid: string) => void;
-export type UseTtTableFormReturnType = [TableFormRegisterFn, TtTableFormMethod];
-export type TtTableExtendedTableFormApi = TableFormApi & {
-    useStore: <T = NoInfer<TtTableFormProps>>(selector?: (state: NoInfer<TtTableFormProps>) => T) => Readonly<Ref<T>>;
+export type TtTableExtendedTableFormApi<Row = any> = TableFormApi<Row> & {
+    useStore: <T = NoInfer<TtTableFormProps<Row>>>(selector?: (state: NoInfer<TtTableFormProps<Row>>) => T) => Readonly<Ref<T>>;
 };