@dazhicheng/ui 1.5.266 → 1.6.1

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

@@ -1,84 +1,109 @@
-import { isArray as b } from "lodash-es";
-import { ref as f, computed as I, unref as o, toValue as A } from "vue";
-function B(u, l, n) {
-  const s = f([]), h = f([]), k = I(() => {
-    const { showCheckbox: e, showRadio: c } = o(u), t = A(s);
-    return e ? t : c ? t ? [t] : [] : [];
+import { GlobalConfig as M } from "../../../../hooks/useSetup.js";
+import "axios";
+import "element-plus";
+import { isArray as m } from "../../../../packages/utils/src/is.js";
+import { ref as S, computed as P, unref as t, toValue as V, nextTick as $ } 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";
+function oe(R, r, i, d) {
+  const { getRowKey: h } = d, a = S([]), k = S([]), K = P(() => {
+    const { showCheckbox: e, showRadio: o } = t(R), c = V(a);
+    return e ? c || [] : o ? c ? [c] : [] : [];
   });
-  function i() {
-    return o(s);
+  function x() {
+    return t(a);
   }
-  function a() {
-    const { showCheckbox: e, showRadio: c } = o(u);
-    return e ? o(n).getCheckboxRecords(!0) : c ? o(n).getRadioRecord(!0) : [];
+  function v() {
+    var n, s, w;
+    const { showCheckbox: e, showRadio: o, reserveSelection: c } = t(R);
+    if (e) {
+      const C = ((n = t(r)) == null ? void 0 : n.getCheckboxRecords(!0)) || [];
+      if (!c) return C;
+      const g = ((s = t(r)) == null ? void 0 : s.getCheckboxReserveRecords(!0)) || [], f = /* @__PURE__ */ new Map();
+      return C.forEach((l) => f.set(h(l), l)), g.forEach((l) => {
+        const b = h(l);
+        f.has(b) || f.set(b, l);
+      }), [...f.values()];
+    }
+    return o ? (w = t(r)) == null ? void 0 : w.getRadioRecord(!0) : [];
+  }
+  function A() {
+    var e;
+    return ((e = t(r)) == null ? void 0 : e.getTableData().fullData) || [];
   }
-  function r(e) {
-    const { tableRowId: c } = o(u);
-    h.value = a(), s.value = o(h).map((t) => t[c || "id"]), l("selection-change", {
-      keys: i(),
-      rows: a(),
-      data: e
-    });
+  function u(e) {
+    const o = v();
+    k.value = o, a.value = m(o) ? o.map((c) => h(c)) : o ? h(o) : void 0, i("selection-change", { keys: x(), rows: o, data: e });
   }
-  const C = (e) => {
-    r(e), l("checkbox-change", e);
-  }, v = (e) => {
-    r(e), l("checkbox-all", e);
+  const B = (e) => {
+    u(e), i("checkbox-change", e);
+  }, E = (e) => {
+    u(e), i("checkbox-all", e);
   }, y = (e) => {
-    l("checkbox-range-change", e);
-    const { records: c } = e;
-    c && c.length === 1 || r(e);
-  }, d = async (e, c = []) => {
-    const { tableRowId: t, showCheckbox: w, showRadio: R } = o(u);
-    h.value = e, w && (b(c) && c.length === 0 && b(e) && e.length !== 0 && (c = e.map((g) => g[t || "id"])), s.value = c, o(n) && await o(n).setCheckboxRow(e, !0)), R && (e = e, s.value = e[t || "id"], o(n) && await o(n).setRadioRow(e)), setTimeout(() => {
-      l("selection-change", {
-        keys: i(),
-        rows: a()
-      });
-    }, 200);
-  }, S = () => {
-    const { showCheckbox: e, showRadio: c } = o(u);
-    e && (s.value = [], h.value = [], o(n) && o(n).clearCheckboxRow(), l("selection-change", {
-      keys: i(),
-      rows: a()
-    })), c && (s.value = void 0, h.value = void 0, o(n) && o(n).clearRadioRow());
+    var o;
+    i("checkbox-range-change", e), ((o = e.records) == null ? void 0 : o.length) !== 1 && u(e);
   };
-  async function x(e) {
-    const { rows: c, cols: t } = e;
-    if (c.length !== 1 && o(n) && t.some((w) => w.type === "checkbox")) {
-      const w = o(n).isCheckedByCheckboxRow(c[0]);
-      await o(n).setCheckboxRow(c, !w);
-      const { tableRowId: R } = o(u);
-      h.value = a(), s.value = o(h).map((g) => g[R || "id"]), l("selection-change", {
-        keys: i(),
-        rows: a(),
-        data: e
-      });
-    }
+  function T(e) {
+    k.value = e.row, a.value = e.row ? h(e.row) : void 0, i("radio-change", e), i("selection-change", { keys: x(), rows: v(), data: e });
+  }
+  async function D(e) {
+    const { rows: o, cols: c } = e;
+    if (o.length === 1) return;
+    const n = t(r);
+    !n || !c.some((s) => s.type === "checkbox") || (await n.setCheckboxRow(o, !n.isCheckedByCheckboxRow(o[0])), u(e));
   }
-  function K(e) {
-    var c, t;
-    h.value = e.row, s.value = (t = e.row) == null ? void 0 : t[((c = o(u)) == null ? void 0 : c.tableRowId) || "id"], l("radio-change", e), l("selection-change", {
-      keys: i(),
-      rows: a(),
-      data: e
-    });
+  const F = (e) => {
+    var n;
+    const { checkboxConfig: o, showCheckbox: c } = t(R);
+    o != null && o.range && c ? y({ records: e.rows }) : (n = M.table) != null && n.isAreaCheckboxSelection && D(e), i("cell-area-selection-end", e);
+  };
+  async function G(e, o = []) {
+    var f, l;
+    const { showCheckbox: c, showRadio: n } = t(R), s = m(e) ? e : e ? [e] : [], w = /* @__PURE__ */ new Set([
+      ...s.map((b) => h(b)),
+      ...m(o) ? o : o == null ? [] : [o]
+    ]), C = A().filter((b) => w.has(h(b))), g = C.length ? C : s;
+    c && await ((f = t(r)) == null ? void 0 : f.setCheckboxRow(g, !0)), n && await ((l = t(r)) == null ? void 0 : l.setRadioRow(g[0])), await $(), u();
+  }
+  function p() {
+    var n, s, w;
+    const { showCheckbox: e, showRadio: o, reserveSelection: c } = t(R);
+    !e && !o || (e && (a.value = [], k.value = [], (n = t(r)) == null || n.clearCheckboxRow(), c && ((s = t(r)) == null || s.clearCheckboxReserve())), o && (a.value = void 0, k.value = void 0, (w = t(r)) == null || w.clearRadioRow()), i("selection-change", { keys: x(), rows: v() }));
+  }
+  function L() {
+    const { showCheckbox: e, reserveSelection: o } = t(R);
+    if (!e || !o) {
+      p();
+      return;
+    }
+    u();
   }
   return {
-    selectedKeys: s,
-    selectedRows: h,
-    setSelectedRowKeys: d,
-    onCellAreaSelectionEndSetCheckbox: x,
-    clearSelectedRowKeys: S,
-    onCheckboxChange: C,
-    onCheckboxAll: v,
-    getSelectRowKeys: i,
-    getSelectRows: a,
+    selectedKeys: a,
+    selectedRows: k,
+    selectedKeyList: K,
+    getSelectRowKeys: x,
+    getSelectRows: v,
+    syncSelection: u,
+    setSelectedRowKeys: G,
+    clearSelectedRowKeys: p,
+    resetSelectionAfterFetch: L,
+    onCheckboxChange: B,
+    onCheckboxAll: E,
     onCheckboxRangeChange: y,
-    onRadioChange: K,
-    getCheckboxSelectedKeys: k
+    onRadioChange: T,
+    onCellAreaSelectionEnd: F
   };
 }
 export {
-  B as useRowSelection
+  oe as useRowSelection
 };

package/dist/components/tt-table/src/hooks/{useLeftRightSlot.d.ts → useSideSlot.d.ts}

@@ -1,11 +1,19 @@
+import { ComputedRef, Ref, nextTick } from 'vue';
 import { VxeGridInstance } from 'vxe-table';
-import { TtTableLeftRightRowNode, TtTableProps } from '../types/table';
 import { Recordable } from '../../../../../../utils/src';
-import { ComputedRef, Ref } from 'vue';
-export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xGridRef: Ref<VxeGridInstance<Recordable>>, tableData: Ref<Recordable[]>): {
-    handleLeftRightSlotScroll: (scrollTop?: number) => Promise<void>;
-    handleLeftRightSlotInit: (isScrollInit?: boolean) => Promise<void>;
-    leftRightSlotRows: Ref<{
+import { TtTableLeftRightRowNode, TtTableProps } from '../types/table';
+/**
+ * 表格左右两侧自定义插槽
+ *
+ * 通过读取 vxe 的 body DOM 尺寸，让两侧插槽与表格行保持同高、同步滚动。
+ * @param propsRef 表格 props
+ * @param grid vxe-grid 实例
+ * @param rows 当前表格数据
+ */
+export declare function useSideSlot(propsRef: ComputedRef<TtTableProps>, grid: Ref<undefined | VxeGridInstance<Recordable>>, rows: Ref<Recordable[]>): {
+    refresh: (resetScroll?: boolean) => Promise<void>;
+    syncScroll: (scrollTop?: number) => Promise<void>;
+    rowNodes: Ref<{
         offsetTop?: number | undefined;
         rowid?: string | undefined;
         item?: any;
@@ -20,8 +28,12 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
         index?: number | undefined;
         parent?: any;
     }[]>;
-    tableHeaderHight: import('vue').ShallowRef<number, number>;
-    leftSlotScrollbarRef: Ref<({
+    headerHeight: import('vue').ShallowRef<number, number>;
+    bodyHeight: import('vue').ShallowRef<number, number>;
+    bodyWrapperHeight: import('vue').ShallowRef<number, number>;
+    bodyOffsetTop: import('vue').ShallowRef<number, number>;
+    bodyScrollHeight: import('vue').ShallowRef<number, number>;
+    leftScrollbarRef: Ref<({
         $: import('vue').ComponentInternalInstance;
         $data: {};
         $props: {
@@ -116,7 +128,7 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
             errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
         };
         $forceUpdate: () => void;
-        $nextTick: typeof import('vue').nextTick;
+        $nextTick: typeof nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{
         tabindex: number | string;
@@ -244,7 +256,7 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
             errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
         };
         $forceUpdate: () => void;
-        $nextTick: typeof import('vue').nextTick;
+        $nextTick: typeof nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{
         tabindex: number | string;
@@ -278,7 +290,7 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
             default?: (props: {}) => any;
         };
     }) | undefined>;
-    rightSlotScrollbarRef: Ref<({
+    rightScrollbarRef: Ref<({
         $: import('vue').ComponentInternalInstance;
         $data: {};
         $props: {
@@ -373,7 +385,7 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
             errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
         };
         $forceUpdate: () => void;
-        $nextTick: typeof import('vue').nextTick;
+        $nextTick: typeof nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{
         tabindex: number | string;
@@ -501,7 +513,7 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
             errorCaptured?: ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void) | ((err: unknown, instance: import('vue').ComponentPublicInstance | null, info: string) => boolean | void)[];
         };
         $forceUpdate: () => void;
-        $nextTick: typeof import('vue').nextTick;
+        $nextTick: typeof nextTick;
         $watch<T extends string | ((...args: any) => any)>(source: T, cb: T extends (...args: any) => infer R ? (...args: [R, R, import('@vue/reactivity').OnCleanup]) => any : (...args: [any, any, import('@vue/reactivity').OnCleanup]) => any, options?: import('vue').WatchOptions): import('vue').WatchStopHandle;
     } & Readonly<{
         tabindex: number | string;
@@ -535,8 +547,4 @@ export declare function useLeftRightSlot(propsRef: ComputedRef<TtTableProps>, xG
             default?: (props: {}) => any;
         };
     }) | undefined>;
-    tableBodyHeight: import('vue').ShallowRef<number, number>;
-    tableBodyWrapHeight: import('vue').ShallowRef<number, number>;
-    tableBodyScrollTop: import('vue').ShallowRef<number, number>;
-    tableBodyScrollHeight: import('vue').ShallowRef<number, number>;
 };

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

@@ -0,0 +1,78 @@
+import "axios";
+import "element-plus";
+import { isUndefined as A, isServer as T } from "../../../../packages/utils/src/is.js";
+import { computed as E, unref as t, ref as b, shallowRef as u, watch as W, onScopeDispose as R, nextTick as k } 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";
+function V(c, s, N) {
+  const f = E(() => !!(t(c).leftSlotWidth || t(c).rightSlotWidth)), w = b(), g = b(), d = u(0), m = u(0), p = u(0), h = u(0), y = u(0), v = b([]), a = /* @__PURE__ */ new Set();
+  function q() {
+    return new Promise((r) => {
+      let e = !1, o;
+      const n = (l) => {
+        e || (e = !0, a.delete(i), r(l));
+      }, i = () => {
+        e || (e = !0, !A(o) && !T && window.cancelAnimationFrame(o), a.delete(i), r(!1));
+      };
+      a.add(i), k(() => {
+        if (!e) {
+          if (T || !window.requestAnimationFrame) {
+            n(!0);
+            return;
+          }
+          o = window.requestAnimationFrame(() => n(!0));
+        }
+      });
+    });
+  }
+  async function x(r) {
+    var o, n, i, l;
+    if (!t(f) || !await q()) return;
+    const e = (n = (o = t(s)) == null ? void 0 : o.$el) == null ? void 0 : n.querySelector(".vxe-table--body");
+    e && (m.value = e.clientHeight, y.value = Number.parseFloat(e.style.marginTop) || 0, v.value = Array.from(e.querySelectorAll(".vxe-body--row")).map((H) => {
+      var F;
+      return {
+        ...(F = t(s)) == null ? void 0 : F.getRowNode(H),
+        offsetTop: H.offsetTop
+      };
+    }), !A(r) && ((i = t(w)) == null || i.scrollTo({ top: r }), (l = t(g)) == null || l.scrollTo({ top: r })));
+  }
+  async function S(r = !0) {
+    var o, n, i, l;
+    if (!t(f) || !await q()) return;
+    const e = (o = t(s)) == null ? void 0 : o.$el;
+    d.value = ((n = e == null ? void 0 : e.querySelector(".vxe-table--body-wrapper")) == null ? void 0 : n.clientHeight) || 0, p.value = ((i = e == null ? void 0 : e.querySelector(".vxe-table--header")) == null ? void 0 : i.clientHeight) || 0, h.value = Number.parseFloat((l = e == null ? void 0 : e.querySelector(".vxe-body--y-space")) == null ? void 0 : l.style.height) || 0, x(r ? 0 : void 0);
+  }
+  return W(N, () => S()), W([() => t(c).leftSlotWidth, () => t(c).rightSlotWidth], () => {
+    if (t(f)) {
+      S();
+      return;
+    }
+    d.value = 0, m.value = 0, p.value = 0, y.value = 0, h.value = 0, v.value = [];
+  }), R(() => {
+    a.forEach((r) => r()), a.clear();
+  }), {
+    refresh: S,
+    syncScroll: x,
+    rowNodes: v,
+    headerHeight: p,
+    bodyHeight: m,
+    bodyWrapperHeight: d,
+    bodyOffsetTop: y,
+    bodyScrollHeight: h,
+    leftScrollbarRef: w,
+    rightScrollbarRef: g
+  };
+}
+export {
+  V as useSideSlot
+};

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

@@ -0,0 +1,12 @@
+import { Recordable } from '../../../../../../utils/src';
+/**
+ * 将父组件显式传入的 props 同步到内部 store。
+ *
+ * 配置项按 key 建立独立 watcher，外部变化时直接写入对应 key，不保存快照，也不做
+ * 内容快照或其他比较。这样内部 API 对 store 的改动不会被无关的父组件更新覆盖，
+ * v-model、data 与 columns 也不会被配置 watcher 深度遍历。
+ * @param props 组件 props
+ * @param setState store 写入方法
+ * @param exclude 不参与同步的 props
+ */
+export declare function useSyncProps(props: Recordable, setState: (state: Recordable) => void, exclude?: string[]): void;

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

@@ -0,0 +1,56 @@
+import { kebabToCamelCase as a } from "../../../../packages/utils/src/string.js";
+import "axios";
+import "element-plus";
+import { isObject as h, isArray as b } from "../../../../packages/utils/src/is.js";
+import { getCurrentInstance as P, watch as p, toValue as g } 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 f = ["data"], j = ["columns"];
+function D(t, m, l = []) {
+  var c;
+  const i = P();
+  function u(o) {
+    var s;
+    const r = ((s = i == null ? void 0 : i.vnode) == null ? void 0 : s.props) || {};
+    return Object.keys(r).some((d) => a(d) === o);
+  }
+  const e = Array.from(
+    new Set(
+      Object.keys(((c = i == null ? void 0 : i.vnode) == null ? void 0 : c.props) || {}).map(a).filter((o) => !o.startsWith("on") && o in t).filter((o) => !l.includes(o) && !f.includes(o))
+    )
+  ), n = {};
+  e.forEach((o) => {
+    n[o] = t[o];
+  }), Object.keys(n).length && m(n), e.forEach((o) => {
+    p(
+      () => t[o],
+      (r) => m({ [o]: r }),
+      // 逐 key 写入是「内部改动不被父组件覆盖」的必要条件，不能合并成一个 deep watcher：
+      // 合并后任意一个配置变化都会整包回写，把内部通过 setState 改过的其他 key 冲掉。
+      { deep: !j.includes(o) && (h(t[o]) || b(t[o])) }
+    );
+  }), f.forEach((o) => {
+    p(
+      [() => t[o], () => {
+        var r;
+        return (r = g(t[o])) == null ? void 0 : r.length;
+      }],
+      ([r]) => {
+        u(o) && m({ [o]: r });
+      },
+      { immediate: !0 }
+    );
+  });
+}
+export {
+  D as useSyncProps
+};

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

@@ -0,0 +1,71 @@
+import { MaybeRefOrGetter, ModelRef, Ref } from 'vue';
+import { VxeGridInstance } from 'vxe-table';
+import { Recordable } from '../../../../../../utils/src';
+import { TtTableProps } from '../types/table';
+import { RowsCommitSource } from '../table-mutation-events';
+/** 表格数据相关事件 */
+type DataEmit = {
+    (e: "load-data"): void;
+};
+/** 判断当前异步落表任务是否仍可提交。 */
+type RowsCommitGuard = () => boolean;
+/** 表格数据源的独立 store 选择器，避免无关配置变化触发数据监听。 */
+type TableDataSources = {
+    api: MaybeRefOrGetter<TtTableProps["api"] | undefined>;
+    data: MaybeRefOrGetter<TtTableProps["data"] | undefined>;
+    /** 数据进入 VXE 前的行身份预处理。 */
+    prepareRows?: (rows: Recordable | Recordable[]) => void;
+    /** 通过公开实例调用 VXE 选中方法后，重新读取选中态。 */
+    onSelectionMutated?: () => void;
+};
+/** VXE 方法调用的统一类型。 */
+type TableDataOperation<T> = () => Promise<T> | T;
+/**
+ * 读取外部传入的表格数据源的当前值。
+ *
+ * 表格内部的数据源可能来自一个 getter，也可能是 `data: ref(rows)`。
+ * 先读取外层 MaybeRefOrGetter，再显式处理 getter 返回的 Ref，避免在业务逻辑中出现
+ * 隐晦的嵌套 `toValue`。空数组是有效数据，只有外层数据源不存在时才返回 undefined。
+ * @param source 外层数据源
+ */
+export declare function getExternalRowsValue(source: MaybeRefOrGetter<TtTableProps["data"] | undefined>): undefined | Recordable[];
+/**
+ * 在操作前后保留树形展开状态
+ * @param grid vxe-grid 实例
+ * @param reserve 是否需要保留（treeConfig.reserve）
+ * @param handler 需要执行的操作
+ * @param guard 操作完成后是否仍允许恢复展开状态
+ */
+export declare function withTreeExpand<T>(grid: undefined | VxeGridInstance<Recordable>, reserve: boolean | undefined, handler: () => Promise<T> | T, guard?: () => boolean): Promise<T>;
+/**
+ * 表格数据落表的唯一出口
+ *
+ * 外部 data / v-model 只经由 loadRows 写入 vxe-grid；请求结果和表格内部操作再通过 emitRows 回写 v-model，
+ * 避免把输入和输出混在同一条链路里。
+ *
+ * 外部数据的变化监听只追踪到「行引用」这一层，不进入行对象内部做字段对比：
+ * 表格写回时附加一次内部事件版本，外部原样传回时消费版本并跳过重复落表；
+ * 换数组、增删行、整行替换都会重新落表，只改行内字段不会 ——
+ * 行对象与外部共享，改字段单元格会自己更新，无需重新落表。
+ * @param propsRef 表格 props
+ * @param grid vxe-grid 实例
+ * @param modelValue v-model 数据
+ * @param emit 组件 emit
+ * @param sources 从 store 独立选择的数据与接口来源
+ */
+export declare function useTableData(propsRef: Ref<TtTableProps>, grid: Ref<undefined | VxeGridInstance<Recordable>>, modelValue: ModelRef<Recordable[] | undefined>, emit: DataEmit, sources: TableDataSources): {
+    rows: import('vue').ShallowRef<Recordable[], Recordable[]>;
+    loadRows: (nextRows: Recordable[], guard?: RowsCommitGuard) => Promise<boolean>;
+    applyRows: (nextRows: Recordable[], guard?: RowsCommitGuard) => Promise<boolean>;
+    emitRows: (nextRows: Recordable[]) => void;
+    getDataSource: <T = Recordable>() => T[];
+    runDataOperation: <T>(operation: TableDataOperation<T>, source?: RowsCommitSource) => Promise<T>;
+    scheduleRowsCommit: (source?: RowsCommitSource) => void;
+    cancelRowsCommit: () => void;
+    onDataChange: () => void;
+    commitRows: (source?: RowsCommitSource) => boolean;
+    createTableInstanceFacade: (instance: undefined | VxeGridInstance<Recordable>) => VxeGridInstance<Recordable> | undefined;
+    /** 判断表格作用域是否仍然有效。 */
+    isActive: () => boolean;
+};
+export {};