@dazhicheng/ui 1.5.266 → 1.6.1

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

@@ -0,0 +1,308 @@
+import "axios";
+import "element-plus";
+import { isString as L, isFunction as N, isObject as Re } from "../../../../packages/utils/src/is.js";
+import { getCurrentInstance as he, shallowRef as J, watch as Q, unref as d, onBeforeUpdate as ve, getCurrentScope as Ce, onScopeDispose as Me, toValue as S, nextTick as P, isRef as be } from "vue";
+import "dayjs";
+import "numeral";
+import "xe-utils";
+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";
+const De = /* @__PURE__ */ new Set([
+  "syncData",
+  "loadData",
+  "reloadData",
+  "setRow",
+  "revertData",
+  "reloadRow",
+  "loadTreeChildren",
+  "clearData",
+  "removeInsertRow",
+  "moveRowTo",
+  "reloadTreeExpand",
+  "undo",
+  "redo",
+  "pasteCellArea",
+  "importData",
+  "importByFile",
+  "insert",
+  "insertAt",
+  "insertNextAt",
+  "insertChild",
+  "insertChildAt",
+  "insertChildNextAt",
+  "remove",
+  "removeCheckboxRow",
+  "removeRadioRow",
+  "removeCurrentRow",
+  "commitProxy"
+]), Te = /* @__PURE__ */ new Set(["insert", "insert_edit", "insert_actived", "remove"]), xe = /* @__PURE__ */ new Set([
+  "setCheckboxRow",
+  "toggleCheckboxRow",
+  "setAllCheckboxRow",
+  "toggleAllCheckboxRow",
+  "clearCheckboxRow",
+  "clearCheckboxReserve",
+  "setRadioRow",
+  "clearRadioRow",
+  "clearRadioReserve"
+]), ye = /* @__PURE__ */ new Set(["loadData", "reloadData"]);
+function X(l) {
+  const f = S(l);
+  if (f)
+    return be(f) ? f.value ?? [] : f;
+}
+function x(l) {
+  return !l || l();
+}
+async function ke(l, f, C, g = () => !0) {
+  const i = (l == null ? void 0 : l.getTreeExpandRecords()) || [], R = await C();
+  return f && i.length && g() && await (l == null ? void 0 : l.setTreeExpand(i, !0)), R;
+}
+function je(l, f, C, g, i) {
+  const R = he(), b = J([]), D = J();
+  let A = !1, s = !1, M = 0, h;
+  const q = Symbol("tt-table-emitted-rows-event");
+  let Y = 0, m, v = !1, T = 0, U = Promise.resolve();
+  function p() {
+    var t;
+    const e = ((t = R == null ? void 0 : R.vnode) == null ? void 0 : t.props) || {};
+    return "modelValue" in e || "model-value" in e;
+  }
+  function Z() {
+    var t;
+    const e = ((t = R == null ? void 0 : R.vnode) == null ? void 0 : t.props) || {};
+    return p() && ("onUpdate:modelValue" in e || "onUpdate:model-value" in e);
+  }
+  function _() {
+    const e = p() ? d(C) : void 0;
+    if (e != null && e.length) return "model";
+    const t = X(i.data);
+    return t != null && t.length ? "data" : p() ? "model" : "data";
+  }
+  function y(e) {
+    const t = U.then(e);
+    return U = t.then(
+      () => {
+      },
+      () => {
+      }
+    ), t;
+  }
+  function ee(e, t) {
+    return new Proxy(e, {
+      get(o, a, r) {
+        return a === q ? t : Reflect.get(o, a, r);
+      },
+      set(o, a, r) {
+        const u = Reflect.set(o, a, r);
+        return u && t === m && (v = !0), u;
+      },
+      deleteProperty(o, a) {
+        const r = Reflect.deleteProperty(o, a);
+        return r && t === m && (v = !0), r;
+      },
+      defineProperty(o, a, r) {
+        const u = Reflect.defineProperty(o, a, r);
+        return u && t === m && (v = !0), u;
+      }
+    });
+  }
+  function te(e) {
+    const t = e == null ? void 0 : e[q], n = m;
+    if (n === void 0 || t !== n) return !1;
+    const o = v;
+    return m = void 0, v = !1, !o;
+  }
+  function ne(e) {
+    P(() => {
+      m === e && (m = void 0, v = !1);
+    });
+  }
+  function V(e) {
+    const t = S(i.api), n = p(), o = Z(), a = o && !t;
+    o && (D.value = "model");
+    const r = a ? ++Y : void 0, u = r ? ee(e, r) : e;
+    m = r, v = !1, b.value = u, (o || !n) && (C.value = u, r && ne(r));
+  }
+  function k(e) {
+    var n;
+    const t = (n = d(f)) == null ? void 0 : n.getTableData();
+    return (e === "visible" ? t == null ? void 0 : t.visibleData : t == null ? void 0 : t.fullData) || [];
+  }
+  function O(e = "full") {
+    return s || !d(f) ? !1 : (h = void 0, V(k(e)), !0);
+  }
+  function j(e = "full") {
+    if (s || M || !d(b).length && !k(e).length) return;
+    if (h) {
+      e === "visible" && (h.source = e);
+      return;
+    }
+    const t = { inputVersion: T, source: e };
+    h = t, P().then(() => {
+      h === t && (h = void 0, !(s || M || t.inputVersion !== T) && O(t.source));
+    });
+  }
+  function z() {
+    h = void 0;
+  }
+  function oe() {
+    j();
+  }
+  async function F(e, t = "full") {
+    const n = T;
+    return y(async () => {
+      if (!s) {
+        M += 1;
+        try {
+          const o = await e();
+          return await P(), !s && n === T && O(t), o;
+        } finally {
+          M -= 1;
+        }
+      }
+    });
+  }
+  const K = /* @__PURE__ */ new WeakMap();
+  function re(e) {
+    const t = Reflect.get(e, "getRefMaps");
+    if (!N(t)) return;
+    const n = Reflect.apply(t, e, []);
+    return S(n.refTable);
+  }
+  function ie(e) {
+    if (L(e)) return e;
+    if (Re(e) && L(e.code)) return e.code;
+  }
+  function ae(e) {
+    return e.updateData();
+  }
+  function le(e, t) {
+    var n, o;
+    ye.has(e) && t[0] && ((n = i.prepareRows) == null || n.call(i, t[0])), e === "loadTreeChildren" && t[1] && ((o = i.prepareRows) == null || o.call(i, t[1]));
+  }
+  function se(e) {
+    if (!e) return;
+    const t = K.get(e);
+    if (t) return t;
+    const n = /* @__PURE__ */ new Map(), o = new Proxy(e, {
+      get(a, r, u) {
+        let c = Reflect.get(a, r, u);
+        if (!L(r)) return c;
+        const W = xe.has(r);
+        if (!W && !De.has(r)) return c;
+        let E = a;
+        if (!N(c)) {
+          const w = re(a);
+          w && (E = w, c = Reflect.get(w, r));
+        }
+        if (!N(c)) return c;
+        const $ = n.get(r);
+        if ($) return $;
+        const me = r === "undo" || r === "redo" ? "visible" : "full", G = (...w) => {
+          if (W) {
+            const B = Reflect.apply(c, E, w);
+            return Promise.resolve(B).then((we) => {
+              var H;
+              return (H = i.onSelectionMutated) == null || H.call(i), we;
+            });
+          }
+          if (le(r, w), r === "syncData") return F(() => ae(a));
+          if (r === "commitProxy") {
+            const B = ie(w[0]);
+            if (!Te.has(B || ""))
+              return Reflect.apply(c, E, w);
+          }
+          return F(() => Reflect.apply(c, E, w), me);
+        };
+        return n.set(r, G), G;
+      }
+    });
+    return K.set(e, o), o;
+  }
+  async function I(e, t) {
+    var c;
+    if (s || !x(t)) return !1;
+    const n = d(f);
+    if (!n) return !1;
+    const { treeConfig: o, clearTreeExpand: a, mergeCells: r } = d(l), u = n.getTreeExpandRecords();
+    M += 1;
+    try {
+      return (c = i.prepareRows) == null || c.call(i, e), await n.loadData(e), s || !x(t) || r && (await n.setMergeCells(r), s || !x(t)) || (a ? await n.clearTreeExpand() : u.length && (o != null && o.reserve) && await n.setTreeExpand(u, !0), s || !x(t)) ? !1 : (b.value = e, g("load-data"), !0);
+    } finally {
+      M -= 1;
+    }
+  }
+  function ue(e, t) {
+    return y(() => I(e, t));
+  }
+  function fe(e, t) {
+    return y(async () => !await I(e, t) || s || !x(t) ? !1 : (V(e), !0));
+  }
+  function ce(e, t) {
+    return y(async () => {
+      var o;
+      if (await P(), s || !t()) return !1;
+      const n = ((o = d(f)) == null ? void 0 : o.getTableData().fullData) || [];
+      return !e.length && !d(b).length && !n.length ? !1 : I(e, t);
+    });
+  }
+  function de() {
+    var e;
+    return ((e = d(f)) == null ? void 0 : e.getTableData().visibleData) || [];
+  }
+  function pe() {
+    const { api: e, data: t } = i;
+    if (S(e)) return;
+    if (D.value === "model" && p()) return d(C) || [];
+    const n = X(t);
+    return n !== void 0 ? n : p() ? d(C) || [] : void 0;
+  }
+  return D.value = _(), A = p(), Q(
+    () => p() ? d(C) : void 0,
+    () => {
+      p() && (D.value = "model");
+    },
+    { deep: 1, flush: "post" }
+  ), Q(
+    pe,
+    (e, t, n) => {
+      let o = !0;
+      n(() => {
+        o = !1;
+      }), !te(e) && (T += 1, z(), e && ce(e, () => o).catch((a) => {
+      }));
+    },
+    { immediate: !0, deep: 1, flush: "post" }
+  ), ve(() => {
+    const e = p();
+    e !== A && (A = e, D.value = _());
+  }), Ce() && Me(() => {
+    s = !0, h = void 0, m = void 0, v = !1;
+  }), {
+    rows: b,
+    loadRows: ue,
+    applyRows: fe,
+    emitRows: V,
+    getDataSource: de,
+    runDataOperation: F,
+    scheduleRowsCommit: j,
+    cancelRowsCommit: z,
+    onDataChange: oe,
+    commitRows: O,
+    createTableInstanceFacade: se,
+    /** 判断表格作用域是否仍然有效。 */
+    isActive: () => !s
+  };
+}
+export {
+  X as getExternalRowsValue,
+  je as useTableData,
+  ke as withTreeExpand
+};

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

@@ -0,0 +1,15 @@
+import { ComputedRef } from 'vue';
+import { VxeTablePropTypes } from 'vxe-table';
+import { TtColumnOptions } from '../types/table';
+/**
+ * 由列上的 `summary` 声明生成 vxe 的 `footerMethod`。
+ *
+ * vxe 要求 `footerMethod` 返回二维数组并按可见列顺序逐格对齐，而列顺序会被列设置与列拖拽改变，
+ * 所以对齐必须在 vxe 每次调用时按它传入的运行时可见列算，不能让调用方按下标写死。
+ * vxe 传入的 `data` 是 `afterFullData`（筛选排序后的完整数据），与 `getDataSource()` 口径一致，
+ * 与虚拟滚动的可视区无关。
+ * @param columnsRef 当前最终列配置
+ */
+export declare function useTableFooter(columnsRef: ComputedRef<TtColumnOptions[]>): {
+    footerSummaryMethod: ComputedRef<VxeTablePropTypes.FooterMethod<any> | undefined>;
+};

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

@@ -0,0 +1,47 @@
+import "axios";
+import "element-plus";
+import { isFunction as s, isNumber as d } from "../../../../packages/utils/src/is.js";
+import { computed as u, unref as a } from "vue";
+import "dayjs";
+import "numeral";
+import "xe-utils";
+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 z(i) {
+  const m = u(() => {
+    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: u(() => {
+    const r = a(m);
+    if (r.size)
+      return ({ columns: e, data: o }) => [
+        e.map((t, n) => {
+          const p = t.field ? r.get(t.field) : void 0;
+          return p ? h(p, t, o) : n === 0 ? c : "";
+        })
+      ];
+  }) };
+}
+export {
+  z 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,68 @@
-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 "dayjs";
+import "numeral";
+import "xe-utils";
+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 j(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
+  j 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>;
+};