@dazhicheng/ui 1.5.265 → 1.6.0

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,77 @@
+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 "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";
+function Q(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 {
+  Q 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,55 @@
+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 "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";
+const f = ["data"], j = ["columns"];
+function B(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 {
+  B 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 {};

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

@@ -0,0 +1,307 @@
+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 "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";
+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 _e(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 ke(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,
+  ke as useTableData,
+  _e 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>;
+};