@dazhicheng/ui 1.5.266 → 1.6.0

package/dist/components/tt-table/src/hooks/useTableFooter.js

@@ -0,0 +1,46 @@
+import "axios";
+import "element-plus";
+import { isFunction as s, isNumber as d } from "../../../../packages/utils/src/is.js";
+import { computed as p, unref as a } from "vue";
+import "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 { get as l } from "lodash-es";
+const c = "合计";
+function h(i, m, f) {
+  const r = f.map((t) => l(t, m.field));
+  if (s(i)) return i({ values: r, rows: f, column: m });
+  if (i === "count") return f.length;
+  const e = r.filter(d), o = e.reduce((t, n) => t + n, 0);
+  return i === "avg" ? e.length ? o / e.length : 0 : o;
+}
+function x(i) {
+  const m = p(() => {
+    const r = /* @__PURE__ */ new Map(), e = (o) => {
+      o.forEach((t) => {
+        var n;
+        t.field && t.summary && r.set(t.field, t.summary), (n = t.children) != null && n.length && e(t.children);
+      });
+    };
+    return e(a(i)), r;
+  });
+  return { footerSummaryMethod: p(() => {
+    const r = a(m);
+    if (r.size)
+      return ({ columns: e, data: o }) => [
+        e.map((t, n) => {
+          const u = t.field ? r.get(t.field) : void 0;
+          return u ? h(u, t, o) : n === 0 ? c : "";
+        })
+      ];
+  }) };
+}
+export {
+  x as useTableFooter
+};

package/dist/components/tt-table/src/hooks/useTableForm.d.ts

@@ -1,15 +1,20 @@
 import { ComputedRef } from 'vue';
 import { TtFormProps } from '../../../tt-form';
 import { VxeGridPropTypes } from 'vxe-table';
+import { Recordable } from '../../../../../../utils/src';
 import { FetchParams, TtTableProps } from '../types/table';
 import { TtTableFormProps } from '../types/tableForm';
 import { TtTableToolsProps } from '../types/tableTools';
-export declare function useTableForm(propsRef: ComputedRef<TtTableFormProps>, fetch: (opt?: FetchParams | undefined) => Promise<void>, getLoading: ComputedRef<boolean | undefined> | undefined, getPagination: () => VxeGridPropTypes.PagerConfig | undefined, emit: {
-    (e: "update:table-data", data?: Recordable): void;
-}): {
-    tableData: import('vue').Ref<Recordable<any>[], Recordable<any>[]>;
+/**
+ * TableForm 的 form / table 配置计算
+ * @param propsRef 表单+表格 props
+ * @param fetch 表格数据请求
+ * @param getLoading 表格 loading 状态
+ * @param getPagination 获取分页信息
+ */
+export declare function useTableForm(propsRef: ComputedRef<TtTableFormProps>, fetch: (opt?: FetchParams | undefined) => Promise<void>, getLoading: ComputedRef<boolean | undefined> | undefined, getPagination: () => VxeGridPropTypes.PagerConfig | undefined): {
     getFormProps: ComputedRef<TtFormProps<Record<string, any>>>;
-    handleSearchInfoChange: (info: Recordable) => Promise<void>;
+    submitSearchQuery: (info: Recordable) => Promise<void>;
     getTableProps: ComputedRef<Partial<TtTableProps>>;
     getTableToolProps: ComputedRef<TtTableToolsProps>;
 };

package/dist/components/tt-table/src/hooks/useTableForm.js

@@ -1,60 +1,67 @@
-import { omit as p, cloneDeep as y, isFunction as d, isEqual as T } from "lodash-es";
-import { ref as C, computed as f, unref as n, toValue as m, watch as D, watchEffect as E } from "vue";
-function B(o, w, g, F, I) {
-  const r = C([]), b = f(() => {
-    const { form: t } = n(o), { submitButtonOptions: e = {} } = t || {};
-    return Object.assign(e, { loading: n(g) }), {
+import "axios";
+import "element-plus";
+import { isFunction as m } from "../../../../packages/utils/src/is.js";
+import { computed as c, unref as i, toValue as u } from "vue";
+import "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 { omit as p } from "lodash-es";
+function V(n, h, l, d) {
+  const f = c(() => {
+    const { form: t } = i(n), o = {
+      ...t == null ? void 0 : t.submitButtonOptions,
+      loading: i(l)
+    };
+    return {
       ...t,
-      submitButtonOptions: e
+      submitButtonOptions: o
     };
   });
-  async function S(t) {
-    const e = F(), a = { currentPage: 1, pageSize: e == null ? void 0 : e.pageSize };
-    await w({ tablePage: a, searchInfo: t });
+  async function b(t) {
+    const o = d(), r = { currentPage: 1, pageSize: o == null ? void 0 : o.pageSize };
+    await h({ tablePage: r, searchInfo: t });
   }
-  const P = f(() => {
-    const { table: t = {}, tableRowId: e, useSearchForm: a, testId: s } = m(o), u = p(n(l), ["tableRowId"]);
-    return y({
-      useSearchForm: a || !1,
-      // TODO: getProps 使用toRaw会导致堆栈溢出问题后续优化
-      ...t,
-      ...u,
-      tableRowId: (t == null ? void 0 : t.tableRowId) || e,
-      // 继承外层的 testId，如果 table.testId 未设置则使用外层的 testId
-      testId: (t == null ? void 0 : t.testId) || s,
-      beforeFetch: async (i) => {
-        const { handleSearchInfoFn: h } = m(o);
-        let c = i;
-        return h && d(h) && (c = await h(c)), t != null && t.beforeFetch && d(t == null ? void 0 : t.beforeFetch) && (c = await (t == null ? void 0 : t.beforeFetch(c))), c;
-      }
-    });
-  }), l = f(() => {
-    const { columnsKey: t, showSetting: e, showSetColumn: a, showRefresh: s, showExport: u } = n(o).table || {}, { toolConfig: i } = n(o);
+  async function w(t) {
+    const { handleSearchInfoFn: o, table: r } = u(n);
+    let e = t;
+    return m(o) && (e = await o(e) || e), m(r == null ? void 0 : r.beforeFetch) && (e = await r.beforeFetch(e) || e), e;
+  }
+  const a = c(() => {
+    const { columnsKey: t, showSetting: o, showSetColumn: r, showRefresh: e, showExport: s } = i(n).table || {}, { toolConfig: F } = i(n);
     return {
       columnsKey: t,
-      showSetting: e,
-      showRefresh: s,
-      showSetColumn: a,
-      showExport: u,
-      ...i
+      showSetting: o,
+      showRefresh: e,
+      showSetColumn: r,
+      showExport: s,
+      ...F
+    };
+  }), g = c(() => {
+    const { table: t = {}, tableRowId: o, useSearchForm: r, testId: e } = u(n), s = p(i(a), ["tableRowId"]);
+    return {
+      useSearchForm: r || !1,
+      // 数据由 TableForm 单独绑定，不进入表格配置。
+      ...p(t, ["data"]),
+      ...s,
+      tableRowId: (t == null ? void 0 : t.tableRowId) || o,
+      // 继承外层的 testId，如果 table.testId 未设置则使用外层的 testId
+      testId: (t == null ? void 0 : t.testId) || e,
+      beforeFetch: w
     };
   });
-  return D(
-    () => r.value,
-    (t, e) => {
-      T(t, e) || I("update:table-data", t);
-    },
-    { deep: !0 }
-  ), E(() => {
-    r.value = n(o).tableData || [];
-  }), {
-    tableData: r,
-    getFormProps: b,
-    handleSearchInfoChange: S,
-    getTableProps: P,
-    getTableToolProps: l
+  return {
+    getFormProps: f,
+    submitSearchQuery: b,
+    getTableProps: g,
+    getTableToolProps: a
   };
 }
 export {
-  B as useTableForm
+  V as useTableForm
 };

package/dist/components/tt-table/src/hooks/useTableMethods.d.ts

@@ -0,0 +1,165 @@
+import { ComputedRef, Ref } from 'vue';
+import { VxeGridInstance, VxeTableDefines, VxeTablePropTypes } from 'vxe-table';
+import { Recordable } from '../../../../../../utils/src';
+import { InsertReturnData, TtTableExtendedTableApi, TtTableProps } from '../types/table';
+/**
+ * 表格数据与编辑相关的实例方法
+ *
+ * 所有会改动表格数据的方法都经过 runDataOperation：操作完成后把表格内数据抛给 v-model，
+ * 外部原样回传时由 useTableData 的事件版本跳过重复落表。
+ * @param propsRef 表格 props
+ * @param grid vxe-grid 实例
+ * @param tableApi 表格 api
+ * @param ctx 表格上下文
+ * @param ctx.clearSelectedRowKeys 清除行选择
+ * @param ctx.getTableInstance 获取带变更桥接的 VXE 公共实例
+ * @param ctx.runDataOperation 统一执行内部数据变更
+ * @param ctx.isActive 判断表格作用域是否仍然有效
+ * @param ctx.prepareRows 数据进入 VXE 前的行身份预处理
+ */
+export declare function useTableMethods(propsRef: ComputedRef<TtTableProps>, grid: Ref<undefined | VxeGridInstance<Recordable>>, tableApi: TtTableExtendedTableApi, { clearSelectedRowKeys, getTableInstance, runDataOperation, isActive, prepareRows, }: {
+    clearSelectedRowKeys: () => void;
+    getTableInstance: () => VxeGridInstance<Recordable>;
+    runDataOperation: <T>(operation: () => Promise<T> | T, source?: "full" | "visible") => Promise<T>;
+    isActive: () => boolean;
+    prepareRows: (rows: Recordable | Recordable[]) => void;
+}): {
+    /**
+     * 从第一行插入临时数据
+     * @param records 新数据
+     */
+    insert: (records: VxeTablePropTypes.Row) => Promise<InsertReturnData>;
+    /**
+     * 在指定行插入临时数据
+     * @param records 新数据
+     * @param row 指定行，-1 表示插入到底部
+     */
+    insertAt: (records: VxeTablePropTypes.Row, row: any) => Promise<InsertReturnData>;
+    /** 在指定行之后插入临时数据 */
+    insertNextAt: (records: VxeTablePropTypes.Row, row: any) => Promise<InsertReturnData>;
+    /** 在树节点下插入临时子数据 */
+    insertChild: (records: VxeTablePropTypes.Row, parentRow: any) => Promise<InsertReturnData>;
+    /** 在树节点下的指定位置插入临时子数据 */
+    insertChildAt: (records: VxeTablePropTypes.Row, parentRow: any, row: any) => Promise<InsertReturnData>;
+    /** 在树节点下的指定行之后插入临时子数据 */
+    insertChildNextAt: (records: VxeTablePropTypes.Row, parentRow: any, row: any) => Promise<InsertReturnData>;
+    /**
+     * 删除指定行
+     * @param rows 指定行
+     */
+    remove: (rows: VxeTablePropTypes.Row) => Promise<InsertReturnData>;
+    /** 删除复选框选中的行 */
+    removeCheckboxRow: () => Promise<InsertReturnData>;
+    /** 删除单选框选中的行 */
+    removeRadioRow: () => Promise<InsertReturnData>;
+    /** 删除当前行 */
+    removeCurrentRow: () => Promise<InsertReturnData>;
+    /** 删除所有新增的临时数据 */
+    removeInsertRow: () => Promise<InsertReturnData>;
+    /** 清除表格的全部数据状态。该操作不改变业务行数据，无需触发 v-model 回写。 */
+    clearAll: () => Promise<void>;
+    /**
+     * 重新加载 VXE 当前同步数据，兼容旧的 syncData 入口。
+     * @deprecated VXE 已废弃 syncData，请使用 reloadData 或 getDataSource。
+     */
+    syncData: () => Promise<void>;
+    /** 重新计算 VXE 的排序、筛选数据视图。该操作不改变业务行数据。 */
+    updateData: () => Promise<void>;
+    /** 修改指定行数据 */
+    setRow: (rows: VxeTablePropTypes.Row | VxeTablePropTypes.Row[], record: VxeTablePropTypes.Row) => Promise<void>;
+    /**
+     * 退出编辑并还原行数据
+     * @param row 指定行
+     */
+    clearEditRevertData: (row: VxeTablePropTypes.Row) => Promise<void>;
+    /**
+     * 指定行激活编辑
+     * @param row 指定行
+     * @param fieldOrColumn 指定列
+     */
+    setEditRow: (row: VxeTablePropTypes.Row, fieldOrColumn?: boolean | string | VxeTableDefines.ColumnInfo) => Promise<void>;
+    /**
+     * 指定单元格激活编辑
+     * @param row 指定行
+     * @param fieldOrColumn 指定列
+     */
+    setEditCell: (row: VxeTablePropTypes.Row, fieldOrColumn: string | VxeTableDefines.ColumnInfo) => Promise<void>;
+    /**
+     * 加载数据
+     * @param rows 数据
+     */
+    loadData: (rows: VxeTablePropTypes.Row[]) => Promise<any>;
+    /**
+     * 加载数据并恢复到初始状态
+     * @param rows 数据
+     */
+    reloadData: (rows: VxeTablePropTypes.Row[]) => Promise<void>;
+    /**
+     * 重新加载列
+     * @param columns 列配置
+     */
+    reloadColumn: (columns: (VxeTableDefines.ColumnOptions<any> | VxeTableDefines.ColumnInfo<any>)[]) => Promise<any>;
+    /**
+     * 局部加载行数据并恢复到初始状态
+     * @param rows 行
+     * @param record 新数据
+     * @param field 指定字段名
+     */
+    reloadRow: (rows: VxeTablePropTypes.Row | VxeTablePropTypes.Row[], record?: VxeTablePropTypes.Row, field?: string) => Promise<void>;
+    /** 还原 keep-source 保存的行数据 */
+    revertData: (rows?: VxeTablePropTypes.Row | VxeTablePropTypes.Row[], field?: string) => Promise<any>;
+    /** 加载树节点的子数据 */
+    loadTreeChildren: (row: VxeTablePropTypes.Row, children: VxeTablePropTypes.Row[]) => Promise<any[]>;
+    /**
+     * 清空单元格内容
+     * @param rows 指定行，为空表示整个表格
+     * @param field 指定字段名
+     */
+    clearData: (rows: VxeTablePropTypes.Row | VxeTablePropTypes.Row[], field?: string) => Promise<any>;
+    /** 移动行到指定行位置 */
+    moveRowTo: (row: any, targetRow: any, options?: Recordable) => Promise<{
+        status: boolean;
+    }>;
+    /** 撤销最近一次数据操作 */
+    undo: () => Promise<{
+        status: boolean;
+    }>;
+    /** 重做最近一次数据操作 */
+    redo: () => Promise<{
+        status: boolean;
+    }>;
+    /**
+     * 重新懒加载展开行并展开内容
+     * @param rows 指定行
+     */
+    reloadRowExpand: (rows: VxeTablePropTypes.Row) => Promise<void>;
+    /**
+     * 重新懒加载树节点并展开该节点
+     * @param rows 指定行
+     */
+    reloadTreeExpand: (rows: VxeTablePropTypes.Row) => Promise<any>;
+    /**
+     * 设置空数据提示文字
+     * @param text 提示文字
+     */
+    setEmptyText: (text: string) => void;
+    /**
+     * 校验表格编辑数据。
+     *
+     * 只是 vxe 校验能力的门面，不加组件自己的校验逻辑，也不改动校验提示的渲染。
+     * 两个分支都传 `true`（校验当前表格全部数据）：不传时 vxe 只校验临时变动过的行，
+     * 而这个方法的用途是提交前的整表校验。
+     * @param isFull `true` 走 vxe 的 fullValidate，逐行校验并收集所有错误；
+     *               缺省或 `false` 走 validate，遇到第一个不通过的记录即停止
+     * @returns 全部通过时为 `undefined`；否则为 vxe 原生形状 —— 以列字段为键，
+     *          值是该字段上每条违规的 `{ rules, row, rowIndex, column, columnIndex, field }`
+     */
+    validate: (isFull?: boolean) => Promise<undefined | VxeTableDefines.ValidatorErrorMapParams>;
+    /**
+     * 校验指定行的指定字段。
+     * @param row 行数据
+     * @param field 列字段名
+     * @returns 通过时为 `undefined`，否则为以列字段为键的错误映射
+     */
+    validateField: (row: VxeTablePropTypes.Row, field: string) => Promise<undefined | VxeTableDefines.ValidatorErrorMapParams>;
+};

package/dist/components/tt-table/src/hooks/useTableMethods.js

@@ -0,0 +1,183 @@
+import { unref as t, nextTick as c } from "vue";
+import { withTreeExpand as x } from "./useTableData.js";
+function h(r, l, w, {
+  clearSelectedRowKeys: d,
+  getTableInstance: C,
+  runDataOperation: s,
+  isActive: n,
+  prepareRows: m
+}) {
+  const v = () => {
+    var e;
+    return (e = t(r).treeConfig) == null ? void 0 : e.reserve;
+  };
+  function R(e, o) {
+    return m(e), s(o);
+  }
+  return {
+    /**
+     * 从第一行插入临时数据
+     * @param records 新数据
+     */
+    insert: (e) => s(() => t(l).insert(e)),
+    /**
+     * 在指定行插入临时数据
+     * @param records 新数据
+     * @param row 指定行，-1 表示插入到底部
+     */
+    insertAt: (e, o) => s(() => t(l).insertAt(e, o)),
+    /** 在指定行之后插入临时数据 */
+    insertNextAt: (e, o) => s(() => t(l).insertNextAt(e, o)),
+    /** 在树节点下插入临时子数据 */
+    insertChild: (e, o) => s(() => t(l).insertChild(e, o)),
+    /** 在树节点下的指定位置插入临时子数据 */
+    insertChildAt: (e, o, a) => s(() => t(l).insertChildAt(e, o, a)),
+    /** 在树节点下的指定行之后插入临时子数据 */
+    insertChildNextAt: (e, o, a) => s(() => t(l).insertChildNextAt(e, o, a)),
+    /**
+     * 删除指定行
+     * @param rows 指定行
+     */
+    remove: (e) => s(() => t(l).remove(e)),
+    /** 删除复选框选中的行 */
+    removeCheckboxRow: () => s(async () => {
+      const e = await t(l).removeCheckboxRow();
+      return d(), e;
+    }),
+    /** 删除单选框选中的行 */
+    removeRadioRow: () => s(async () => {
+      const e = await t(l).removeRadioRow();
+      return d(), e;
+    }),
+    /** 删除当前行 */
+    removeCurrentRow: () => s(() => t(l).removeCurrentRow()),
+    /** 删除所有新增的临时数据 */
+    removeInsertRow: () => s(() => t(l).removeInsertRow()),
+    /** 清除表格的全部数据状态。该操作不改变业务行数据，无需触发 v-model 回写。 */
+    clearAll: async () => {
+      const e = await t(l).clearAll();
+      return d(), e;
+    },
+    /**
+     * 重新加载 VXE 当前同步数据，兼容旧的 syncData 入口。
+     * @deprecated VXE 已废弃 syncData，请使用 reloadData 或 getDataSource。
+     */
+    syncData: () => s(() => t(l).updateData()),
+    /** 重新计算 VXE 的排序、筛选数据视图。该操作不改变业务行数据。 */
+    updateData: () => t(l).updateData(),
+    /** 修改指定行数据 */
+    setRow: (e, o) => s(() => t(l).setRow(e, o)),
+    /**
+     * 退出编辑并还原行数据
+     * @param row 指定行
+     */
+    clearEditRevertData: (e) => s(async () => {
+      var o, a;
+      await ((o = t(l)) == null ? void 0 : o.clearEdit()), await ((a = t(l)) == null ? void 0 : a.revertData(e));
+    }),
+    /**
+     * 指定行激活编辑
+     * @param row 指定行
+     * @param fieldOrColumn 指定列
+     */
+    setEditRow: async (e, o) => {
+      var a;
+      await ((a = t(l)) == null ? void 0 : a.setEditRow(e, o));
+    },
+    /**
+     * 指定单元格激活编辑
+     * @param row 指定行
+     * @param fieldOrColumn 指定列
+     */
+    setEditCell: async (e, o) => {
+      var a;
+      await ((a = t(l)) == null ? void 0 : a.setEditCell(e, o));
+    },
+    /**
+     * 加载数据
+     * @param rows 数据
+     */
+    loadData: (e) => R(
+      e,
+      () => x(t(l), v(), () => t(l).loadData(e), n)
+    ),
+    /**
+     * 加载数据并恢复到初始状态
+     * @param rows 数据
+     */
+    reloadData: (e) => R(
+      e,
+      () => x(t(l), v(), () => t(l).reloadData(e), n)
+    ),
+    /**
+     * 重新加载列
+     * @param columns 列配置
+     */
+    reloadColumn: async (e) => {
+      const o = t(l).getTreeExpandRecords();
+      w.setTableColumns(e), await c(), await c();
+      const a = t(l);
+      return a && n() && v() && o.length && await a.setTreeExpand(o, !0), w.getTableColumns();
+    },
+    /**
+     * 局部加载行数据并恢复到初始状态
+     * @param rows 行
+     * @param record 新数据
+     * @param field 指定字段名
+     */
+    reloadRow: (e, o, a) => s(() => t(l).reloadRow(e, o, a)),
+    /** 还原 keep-source 保存的行数据 */
+    revertData: (e, o) => s(() => t(l).revertData(e, o)),
+    /** 加载树节点的子数据 */
+    loadTreeChildren: (e, o) => (m(o), C().loadTreeChildren(e, o)),
+    /**
+     * 清空单元格内容
+     * @param rows 指定行，为空表示整个表格
+     * @param field 指定字段名
+     */
+    clearData: (e, o) => s(() => t(l).clearData(e, o)),
+    /** 移动行到指定行位置 */
+    moveRowTo: (e, o, a) => s(() => t(l).moveRowTo(e, o, a)),
+    /** 撤销最近一次数据操作 */
+    undo: () => s(() => t(l).undo(), "visible"),
+    /** 重做最近一次数据操作 */
+    redo: () => s(() => t(l).redo(), "visible"),
+    /**
+     * 重新懒加载展开行并展开内容
+     * @param rows 指定行
+     */
+    reloadRowExpand: (e) => t(l).reloadRowExpand(e),
+    /**
+     * 重新懒加载树节点并展开该节点
+     * @param rows 指定行
+     */
+    reloadTreeExpand: (e) => s(() => t(l).reloadTreeExpand(e)),
+    /**
+     * 设置空数据提示文字
+     * @param text 提示文字
+     */
+    setEmptyText: (e) => w.setState({ emptyText: e }),
+    /**
+     * 校验表格编辑数据。
+     *
+     * 只是 vxe 校验能力的门面，不加组件自己的校验逻辑，也不改动校验提示的渲染。
+     * 两个分支都传 `true`（校验当前表格全部数据）：不传时 vxe 只校验临时变动过的行，
+     * 而这个方法的用途是提交前的整表校验。
+     * @param isFull `true` 走 vxe 的 fullValidate，逐行校验并收集所有错误；
+     *               缺省或 `false` 走 validate，遇到第一个不通过的记录即停止
+     * @returns 全部通过时为 `undefined`；否则为 vxe 原生形状 —— 以列字段为键，
+     *          值是该字段上每条违规的 `{ rules, row, rowIndex, column, columnIndex, field }`
+     */
+    validate: (e = !1) => e ? t(l).fullValidate(!0) : t(l).validate(!0),
+    /**
+     * 校验指定行的指定字段。
+     * @param row 行数据
+     * @param field 列字段名
+     * @returns 通过时为 `undefined`，否则为以列字段为键的错误映射
+     */
+    validateField: (e, o) => t(l).validateField(e, o)
+  };
+}
+export {
+  h as useTableMethods
+};

package/dist/components/tt-table/src/hooks/useTableRender.d.ts

@@ -1,7 +1,24 @@
-import { DefineSetupFnComponent } from 'vue';
-import { TtTableExtendedTableApi, TtTableProps } from '../types/table';
+import { DefineSetupFnComponent, SlotsType } from 'vue';
+import { TtTableExtendedTableApi, TtTableProps, TtTableRenderProps, TtTableSlots } from '../types/table';
 import { TtTableExtendedTableFormApi, TtTableFormProps } from '../types/tableForm';
-export type TtUseTableFormRenderReturnType = [DefineSetupFnComponent<TtTableFormProps>, TtTableExtendedTableFormApi];
+/**
+ * useTableFormRender 的返回值
+ *
+ * `Row` 是业务行数据类型，传入后表格插槽作用域与 `tableFormApi.tableApi` 的方法签名跟着推断。
+ */
+export type TtUseTableFormRenderReturnType<Row = any> = [
+    DefineSetupFnComponent<TtTableFormProps<Row>, Record<string, any>, SlotsType<TtTableSlots<Row>>>,
+    TtTableExtendedTableFormApi<Row>
+];
+/**
+ * useTableRender 的返回值
+ *
+ * `Row` 是业务行数据类型，传入后组件的 `modelValue`、插槽作用域与 `tableApi` 的方法签名跟着推断。
+ */
+export type TtUseTableRenderReturnType<Row = any> = [
+    DefineSetupFnComponent<TtTableRenderProps<Row>, Record<string, any>, SlotsType<TtTableSlots<Row>>>,
+    TtTableExtendedTableApi<Row>
+];
 /**
  * 用于渲染表单和表格的 hooks。
  *
@@ -22,10 +39,12 @@ export type TtUseTableFormRenderReturnType = [DefineSetupFnComponent<TtTableForm
  * // 在模板中使用
  * <FormTable />
  */
-export declare function useTableFormRender(options: TtTableFormProps): TtUseTableFormRenderReturnType;
+export declare function useTableFormRender<Row = any>(options: TtTableFormProps<Row>): TtUseTableFormRenderReturnType<Row>;
 /**
  * 用于渲染表格的 hooks，返回 [TableRender 组件, 表格API]。
  *
+ * options 只接受表格配置；单向数据使用 data，双向数据绑定到返回的 TableRender 组件。
+ *
  * @param options 表格渲染配置项
  * @returns [TableRender组件, 表格API]
  *
@@ -40,54 +59,4 @@ export declare function useTableFormRender(options: TtTableFormProps): TtUseTabl
  * // 在模板中使用
  * <TableRender />
  */
-export declare function useTableRender(options: TtTableProps): readonly [DefineSetupFnComponent<TtTableProps, {}, {}, {
-    title?: string;
-    showTitle?: boolean;
-    autoHeight?: boolean;
-    offsetHeight?: number;
-    loading?: boolean;
-    loadingText?: string;
-    emptyText?: string;
-    noSearchText?: string;
-    emptyImageStyle?: import('vue').CSSProperties;
-    emptyImageStatus?: "no-data" | "no-search";
-    isHanderSubmit?: boolean;
-    modelValue?: Array<Recordable>;
-    formApi?: Partial<import('../../../tt-form').TtExtendedFormApi>;
-    columnsKey?: string | (() => string);
-    showSetting?: boolean;
-    showSetColumn?: boolean;
-    leftSlotWidth?: number;
-    rightSlotWidth?: number;
-    showLineHeight?: boolean;
-    showRefresh?: boolean;
-    useHttpCache?: boolean;
-    defaultDisplayFields?: string[];
-    getColumnsApi?: (params: {
-        permissionOnlyCode: string;
-        userId: string | number;
-    }) => Promise<{
-        data: any;
-    }>;
-    setColumnsApi?: (params: {
-        permissionOnlyCode: string;
-        json: string;
-        userId: string | number;
-    }) => Promise<any>;
-    updateColumnsApi?: (params: {
-        permissionOnlyCode: string;
-        json: string;
-        userId: string | number;
-        id: string | number;
-    }) => Promise<any>;
-    getSyncSlotComponent?: (column: any, row: any, type: "default" | "edit") => import('vue').VNode | import('vue').VNode[] | string;
-    customizeColumn?: (column: import("vxe-table").VxeTableDefines.ColumnOptions) => import("vxe-table").VxeTableDefines.ColumnOptions;
-    clearTreeExpand?: boolean;
-    isI18n?: boolean;
-    isDataCloneDeep?: boolean;
-    useSearchForm?: boolean;
-    data?: import('vue').MaybeRef<any[]>;
-    columns?: import('vue').MaybeRef<import("vxe-table").VxeTableDefines.ColumnOptions[]>;
-    testId?: string;
-    toolTipErrorPlacement?: "top" | "bottom" | "left" | "right";
-} & Omit<import('vxe-table').VxeGridProps<any>, "data" | "columns"> & import('../..').TtTablePagerProps & import('../..').TtTableColumnsProps & import('../..').TtTableFetchProps & import('../..').TtTableToolbarProps & {}, import('vue').PublicProps>, TtTableExtendedTableApi];
+export declare function useTableRender<Row = any>(options: TtTableProps<Row>): TtUseTableRenderReturnType<Row>;