@dazhicheng/ui 1.5.266 → 1.6.1

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

@@ -1,10 +1,16 @@
-import { VxeGridPropTypes } from 'vxe-table';
-import { TtTableProps } from '../types/table';
 import { ComputedRef } from 'vue';
+import { VxeGridPropTypes } from 'vxe-table';
 import { VxePagerDefines, VxePagerEvents } from 'vxe-pc-ui';
-type PaginationProps = VxeGridPropTypes.PagerConfig;
-export declare function usePagination(refProps: ComputedRef<TtTableProps>, emit: (event: "page-change", data: any) => void): {
-    configRef: import('vue').Ref<{
+import { TtTableProps } from '../types/table';
+/** 分页配置类型 */
+type PagerConfig = VxeGridPropTypes.PagerConfig;
+/**
+ * 表格分页状态
+ * @param propsRef 表格 props
+ * @param emit 组件 emit
+ */
+export declare function usePagination(propsRef: ComputedRef<TtTableProps>, emit: (event: "page-change", data: any) => void): {
+    pagination: import('vue').Ref<{
         enabled?: boolean | undefined;
         slots?: {
             left?: string | ((params: import("vxe-pc-ui").VxePagerSlotTypes.LeftSlotParams) => import('vxe-pc-ui').VxeComponentSlotType | import('vxe-pc-ui').VxeComponentSlotType[]) | undefined;
@@ -95,9 +101,9 @@ export declare function usePagination(refProps: ComputedRef<TtTableProps>, emit:
         iconHomePage?: import("vxe-pc-ui").VxePagerPropTypes.IconHomePage | undefined;
         iconEndPage?: import("vxe-pc-ui").VxePagerPropTypes.IconEndPage | undefined;
     }>;
+    paginationInfo: ComputedRef<VxeGridPropTypes.PagerConfig | undefined>;
     getPagination: () => VxeGridPropTypes.PagerConfig | undefined;
-    getPaginationInfo: ComputedRef<VxeGridPropTypes.PagerConfig | undefined>;
-    setPagination: (info: Partial<PaginationProps>) => void;
-    handlePageChange: (data: VxePagerDefines.PageChangeEventParams | Parameters<VxePagerEvents.PageChange>[0]) => void;
+    setPagination: (info: Partial<PagerConfig>) => void;
+    onPageChange: (data: VxePagerDefines.PageChangeEventParams | Parameters<VxePagerEvents.PageChange>[0]) => void;
 };
 export {};

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

@@ -1,7 +1,9 @@
+import { GlobalConfig as f } from "../../../../hooks/useSetup.js";
 import "axios";
 import "element-plus";
 import "dayjs";
-import { ref as f, unref as e, computed as c, watch as l } from "vue";
+import { ref as c, unref as o, computed as P, watch as l } from "vue";
+import "numeral";
 import "xe-utils";
 import "dayjs/plugin/utc";
 import "dayjs/plugin/timezone";
@@ -11,45 +13,40 @@ import "../../../../node_modules/.pnpm/crypto-js@4.2.0/node_modules/crypto-js/ae
 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 { isEqual as P } from "lodash-es";
-import { GlobalConfig as h } from "../../../../hooks/useSetup.js";
-function G(i, p) {
-  var g;
-  const o = f(
-    s(e(i).pagerConfig || {}, ((g = h.table) == null ? void 0 : g.pagerConfig) || {})
-  ), n = c(() => {
-    const { showPager: t, pagerConfig: r } = e(i);
-    if (!(!t && !r))
-      return {
-        currentPage: 1,
-        pageSize: 300,
-        total: 0,
-        pageSizes: [300, 500, 1e3, 2e3],
-        layouts: ["Total", "PrevPage", "JumpNumber", "NextPage", "Sizes", "FullJump"],
-        // ...unref(refProps).pagerConfig,
-        ...e(o)
-      };
+import "lodash-es";
+const C = {
+  currentPage: 1,
+  pageSize: 300,
+  total: 0,
+  pageSizes: [300, 500, 1e3, 2e3],
+  layouts: ["Total", "PrevPage", "JumpNumber", "NextPage", "Sizes", "FullJump"]
+};
+function T(e, g) {
+  var a;
+  const r = c(
+    s(o(e).pagerConfig || {}, ((a = f.table) == null ? void 0 : a.pagerConfig) || {})
+  ), i = P(() => {
+    const { showPager: t, pagerConfig: u } = o(e);
+    if (!(!t && !u))
+      return { ...C, ...o(r) };
   });
-  function m() {
-    return e(n);
+  function p() {
+    return o(i);
   }
-  function a(t) {
-    o.value = {
-      ...e(o),
-      ...t
-    };
+  function n(t) {
+    r.value = { ...o(r), ...t };
   }
-  function u(t) {
-    p("page-change", t);
+  function m(t) {
+    g("page-change", t);
   }
   return l(
-    () => e(i).pagerConfig,
-    (t, r) => {
-      t && !P(t, r) && a(t);
+    () => o(e).pagerConfig,
+    (t) => {
+      t && n(t);
     },
     { deep: !0 }
-  ), { configRef: o, getPagination: m, getPaginationInfo: n, setPagination: a, handlePageChange: u };
+  ), { pagination: r, paginationInfo: i, getPagination: p, setPagination: n, onPageChange: m };
 }
 export {
-  G as usePagination
+  T as usePagination
 };

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

@@ -0,0 +1,41 @@
+import { ComputedRef, Ref } from 'vue';
+import { VxeGridInstance, VxeGridPropTypes } from 'vxe-table';
+import { Recordable } from '../../../../../../utils/src';
+import { FetchParams, TtTableProps } from '../types/table';
+/** 远程查询依赖的表格上下文 */
+type QueryContext = {
+    grid: Ref<undefined | VxeGridInstance<Recordable>>;
+    /** 分页状态（可写） */
+    pagination: Ref<VxeGridPropTypes.PagerConfig>;
+    /** 分页完整信息（含默认值） */
+    paginationInfo: ComputedRef<undefined | VxeGridPropTypes.PagerConfig>;
+    setPagination: (info: Partial<VxeGridPropTypes.PagerConfig>) => void;
+    setLoading: (loading: boolean) => void;
+    /** 数据重新落表后重置选中态，关闭跨页选中时等价于清空选中 */
+    resetSelectionAfterFetch: () => void;
+    /** 已落表的数据，滚动加载时用于追加 */
+    rows: Ref<Recordable[]>;
+    /** 数据落表 */
+    applyRows: (rows: Recordable[], guard?: () => boolean) => Promise<boolean>;
+};
+/** 远程查询相关事件 */
+type QueryEmit = {
+    (e: "fetch-success", data?: Recordable): void;
+    (e: "fetch-error", error?: unknown): void;
+};
+/**
+ * 表格远程数据的唯一请求入口
+ *
+ * 首次加载、分页变化、外部 reload、服务端筛选排序四类触发最终都汇聚到 query()，
+ * 由 queriedPage 快照避免请求自身回写分页导致的重复请求。
+ * @param propsRef 表格 props
+ * @param ctx 表格上下文
+ * @param emit 组件 emit
+ */
+export declare function useQuery(propsRef: ComputedRef<TtTableProps>, ctx: QueryContext, emit: QueryEmit): {
+    query: (opt: FetchParams) => Promise<void>;
+    reload: (opt?: FetchParams) => Promise<void>;
+    reloadFilter: (type?: "sort" | "filter" | "page") => Promise<void>;
+    isLoaded: import('vue').ShallowRef<boolean, boolean>;
+};
+export {};

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

@@ -0,0 +1,148 @@
+import { GlobalConfig as k } from "../../../../hooks/useSetup.js";
+import "axios";
+import "element-plus";
+import { isFunction as b, isObject as ae, isUndefined as ne, isArray as se } from "../../../../packages/utils/src/is.js";
+import { shallowRef as K, computed as oe, unref as t, watch as ce, onMounted as le, nextTick as ue, onScopeDispose as fe } 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 me, set as R, get as x } from "lodash-es";
+function Oe(s, W, p) {
+  const { grid: u, pagination: f, paginationInfo: d, setPagination: O, setLoading: q, resetSelectionAfterFetch: T, rows: X, applyRows: j } = W, P = K({ currentPage: 1 }), y = K(!1);
+  let w = !0, D = !1, S = !1, g;
+  const L = oe(() => {
+    const { showPager: e, isScrollFetch: r } = t(s);
+    return !!(e || r);
+  }), M = () => {
+    var e;
+    return !!((e = t(s).filterConfig) != null && e.remote);
+  };
+  function A(e) {
+    return { currentPage: (e == null ? void 0 : e.currentPage) || 1, pageSize: e == null ? void 0 : e.pageSize };
+  }
+  function Y(e) {
+    const r = t(s);
+    return g === e && !S && r.api === e.api && r.filterApi === e.filterApi;
+  }
+  function N(e, r) {
+    return ((e == null ? void 0 : e.currentPage) || 1) !== (r == null ? void 0 : r.currentPage) || (e == null ? void 0 : e.pageSize) !== (r == null ? void 0 : r.pageSize);
+  }
+  function Z(e) {
+    const { currentPageField: r, pageSizeField: i } = t(s), o = {};
+    return R(o, r, e.currentPage || 1), R(o, i, e.pageSize), o;
+  }
+  function _(e) {
+    return { ...t(d) || t(f), ...ae(e) ? e : {} };
+  }
+  function $(e) {
+    const r = se(e), i = r ? 0 : x(e, t(s).totalField);
+    return {
+      items: r ? e : x(e, t(s).dataField),
+      total: ne(i) ? 0 : Number(i)
+    };
+  }
+  async function ee(e, r, i) {
+    var n;
+    const { isScrollFetch: o, currentPageField: l = "" } = t(s), c = t(s).afterFetch ?? ((n = k.table) == null ? void 0 : n.afterFetch);
+    let a = e;
+    return b(c) && (a = await c(a, i) || a), o && x(r, l, 1) !== 1 && (a = [...t(X), ...a]), a;
+  }
+  async function h(e) {
+    var G, U, B;
+    const { api: r, filterApi: i, searchInfo: o, useSearchForm: l, formApi: c } = t(s);
+    if (S || !b(r)) return;
+    const a = { api: r, filterApi: i };
+    D = !0, g = a;
+    const n = () => Y(a);
+    try {
+      q(!0), t(s).immediate || (w = !1);
+      const m = _(e == null ? void 0 : e.tablePage), v = m.currentPage || 1, z = Z(m), te = c && l ? await c.getValues() : {};
+      if (!n()) return;
+      let F;
+      if (e.serverFilterParams && b(i))
+        F = await i({ ...e.serverFilterParams, ...t(L) ? z : {} });
+      else {
+        b(i) && ((G = t(u)) == null || G.clearSort(), (U = t(u)) == null || U.clearFilter());
+        let C = {
+          ...te,
+          ...o,
+          ...e.searchInfo,
+          ...t(L) ? z : {}
+        };
+        const J = t(s).beforeFetch ?? ((B = k.table) == null ? void 0 : B.beforeFetch);
+        if (b(J) && (C = await J(C) || C), !n()) return;
+        F = await r(C);
+      }
+      if (!n()) return;
+      const { items: re, total: E } = $(F), I = await ee(re || [], z, F);
+      if (!n()) return;
+      const H = E || I.length || 0, ie = Math.max(1, Math.ceil(H / m.pageSize));
+      if (v > ie) {
+        await Q({ tablePage: { currentPage: 1, pageSize: m.pageSize } });
+        return;
+      }
+      if (!await j(I, n) || !n() || (O({ total: H, currentPage: v }), P.value = A(t(d)), p("fetch-success", { items: I, total: E, rawDataSource: F }), !n()) || (T(), !n())) return;
+      y.value = !0;
+    } catch (m) {
+      if (!n() || (p("fetch-error", m), !n()) || !await j([], n) || !n() || (O({ total: 0 }), P.value = A(t(d)), T(), !n())) return;
+      y.value = !0;
+    } finally {
+      g === a && (g = void 0, q(!1));
+    }
+  }
+  async function Q(e) {
+    var i;
+    const r = { ...t(f) };
+    (i = k.table) != null && i.isReloadResetToFirstPage && (r.currentPage = 1), await h(
+      e ? {
+        tablePage: Object.hasOwn(e, "tablePage") ? e.tablePage : r,
+        searchInfo: Object.hasOwn(e, "searchInfo") ? e.searchInfo : me(e, ["tablePage", "serverFilterParams"])
+      } : { tablePage: r }
+    ), t(s).immediate || (w = !1);
+  }
+  async function V(e) {
+    var l, c;
+    if (!M()) return;
+    const r = { ...t(f) };
+    e !== "page" && (r.currentPage = 1);
+    const i = (((l = t(u)) == null ? void 0 : l.getCheckedFilters()) || []).map((a) => ({
+      fieldName: a.field,
+      checkAll: !1,
+      includeValues: a.datas[0],
+      excludeValues: []
+    })), o = (((c = t(u)) == null ? void 0 : c.getSortColumns()) || []).map((a) => ({
+      fieldName: a.field,
+      isAscending: a.order === "asc"
+    }));
+    await h({ serverFilterParams: { filterConditions: i, sortConditions: o }, tablePage: r });
+  }
+  return ce([() => t(f).currentPage, () => t(f).pageSize], ([e, r]) => {
+    var l, c;
+    const i = { ...t(f), currentPage: e, pageSize: r };
+    if (!N(i, t(P))) return;
+    if (w && !t(s).immediate) {
+      w = !1;
+      return;
+    }
+    const o = (((l = t(u)) == null ? void 0 : l.getSortColumns()) || []).length > 0 || (((c = t(u)) == null ? void 0 : c.getCheckedFilters()) || []).length > 0;
+    M() && o ? V("page") : h({ tablePage: { ...i } });
+  }), le(() => {
+    P.value = A(t(d)), ue(() => {
+      if (S || D) return;
+      const { immediate: e, pagerConfig: r } = t(s);
+      e && (!r || !N(r, t(P))) && h({ tablePage: t(d) });
+    });
+  }), fe(() => {
+    S = !0, g = void 0;
+  }), { query: h, reload: Q, reloadFilter: V, isLoaded: y };
+}
+export {
+  Oe as useQuery
+};

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

@@ -0,0 +1,22 @@
+import { ComputedRef } from 'vue';
+import { VxeTablePropTypes } from 'vxe-table';
+import { Recordable } from '../../../../../../utils/src';
+import { TtTableProps } from '../types/table';
+/** 表格支持的行主键值。 */
+type RowKey = number | string;
+/** 行主键相关的 VXE 配置。 */
+type RowConfig = VxeTablePropTypes.RowConfig<Recordable>;
+/**
+ * 表格行身份适配器。
+ *
+ * VXE 要求 keyField 指向行对象上的字段，并会在字段为空时把生成值写回该字段。
+ * 这里把 VXE key 改写到不可枚举的组件私有字段，业务 tableRowId 只用于派生稳定值，
+ * 因此新增行仍可选择、展开和拖拽，但内部 ID 不会进入 JSON payload。
+ * @param propsRef 表格配置
+ */
+export declare function useRowIdentity(propsRef: ComputedRef<TtTableProps>): {
+    getRowKey: (row: Recordable) => RowKey | undefined;
+    prepareRows: (records: Recordable | Recordable[]) => void;
+    toVxeRowConfig: (rowConfig?: RowConfig) => RowConfig;
+};
+export {};

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

@@ -0,0 +1,97 @@
+import "axios";
+import "element-plus";
+import { isObject as F, isFunction as x, isArray as _, isNumber as B, isString as E } from "../../../../packages/utils/src/is.js";
+import { getCurrentInstance as W, unref as a, toRaw as C } 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 y = "__tt_table_internal_row_key__";
+function c(o) {
+  return B(o) ? !0 : E(o) && !!o;
+}
+function Y(o) {
+  var v;
+  const P = ((v = W()) == null ? void 0 : v.uid) || 0;
+  let m = 0;
+  const K = /* @__PURE__ */ new WeakSet();
+  function w() {
+    return a(o).tableRowId || "id";
+  }
+  function p(e) {
+    const t = l(e, w());
+    return c(t) ? t : void 0;
+  }
+  function g(e) {
+    const t = Reflect.get(e, y);
+    return c(t) ? t : void 0;
+  }
+  function O() {
+    return m += 1, `tt_row_${P}_${m}`;
+  }
+  function S(e, t) {
+    const r = C(e), n = Object.getOwnPropertyDescriptor(r, y), i = n && c(n.value) ? n.value : t;
+    if (n && !n.enumerable && c(n.value)) return i;
+    try {
+      Object.defineProperty(r, y, {
+        configurable: !0,
+        enumerable: !1,
+        value: i,
+        writable: !0
+      });
+    } catch {
+      K.has(r) || K.add(r);
+    }
+    return i;
+  }
+  function f({ row: e }) {
+    var d;
+    const t = g(e);
+    if (c(t)) return t;
+    const r = (d = a(o).rowConfig) == null ? void 0 : d.createKeyMethod, n = x(r) ? r({ row: e, keyField: w() }) : void 0, i = p(e), u = c(n) ? n : c(i) ? i : O();
+    return S(e, u);
+  }
+  function j(e = {}) {
+    return e.keyField ? e : {
+      ...e,
+      keyField: y,
+      createKeyMethod: f
+    };
+  }
+  function I(e) {
+    var i;
+    const t = p(e);
+    if (c(t)) return t;
+    const r = (i = a(o).rowConfig) == null ? void 0 : i.keyField;
+    if (r) {
+      const u = l(e, r);
+      return c(u) ? u : void 0;
+    }
+    const n = g(e);
+    return c(n) ? n : f({ row: e });
+  }
+  function M(e) {
+    var u, d, R;
+    if ((u = a(o).rowConfig) != null && u.keyField) return;
+    const t = _(e) ? e : [e], r = /* @__PURE__ */ new WeakSet(), n = ((d = a(o).treeConfig) == null ? void 0 : d.childrenField) || ((R = a(o).treeConfig) == null ? void 0 : R.children) || "children";
+    function i(s) {
+      const b = C(s);
+      if (r.has(b)) return;
+      r.add(b), f({ row: s });
+      const h = l(s, n);
+      _(h) && h.forEach((k) => F(k) && i(k));
+    }
+    t.forEach((s) => F(s) && i(s));
+  }
+  return { getRowKey: I, prepareRows: M, toVxeRowConfig: j };
+}
+export {
+  Y as useRowIdentity
+};

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

@@ -1,30 +1,42 @@
 import { ComputedRef, Ref } from 'vue';
 import { VxeGridDefines, VxeGridEvents, VxeGridInstance, VxeTableExtendCellAreaDefines } from 'vxe-table';
-import { TtSelectRowKeysType, TtSelectRowsType, TtTableProps } from '../types/table';
 import { Recordable } from '../../../../../../utils/src';
-type EmitType = {
-    (e: "selection-change", data?: {
-        keys: TtSelectRowKeysType;
-        rows: TtSelectRowsType;
-        data?: Recordable;
-    }): void;
+import { TtSelectRowKeysType, TtSelectRowsType, TtTableProps, TtTableSelectionPayload } from '../types/table';
+/** 行选择相关事件 */
+type SelectionEmit = {
+    (e: "selection-change", data?: TtTableSelectionPayload): void;
     (e: "checkbox-change", data?: VxeGridDefines.CheckboxChangeEventParams): void;
     (e: "checkbox-all", data?: VxeGridDefines.CheckboxAllEventParams): void;
     (e: "checkbox-range-change", data?: VxeGridDefines.CheckboxRangeChangeEventParams): void;
     (e: "radio-change", data?: VxeGridDefines.RadioChangeEventParams): void;
+    (e: "cell-area-selection-end", data?: VxeTableExtendCellAreaDefines.CellAreaSelectionAllEndEventParams): void;
 };
-export declare function useRowSelection(propsRef: ComputedRef<TtTableProps>, emit: EmitType, xGrid: Ref<VxeGridInstance<Recordable>>): {
+/** 行选择使用的行身份适配器。 */
+type RowSelectionIdentity = {
+    /** 获取业务兼容的行主键。 */
+    getRowKey: (row: Recordable) => number | string | undefined;
+};
+/**
+ * 行选择状态（复选框、单选框、区域选择）
+ * @param propsRef 表格 props
+ * @param grid vxe-grid 实例
+ * @param emit 组件 emit
+ * @param identity 行身份适配器
+ */
+export declare function useRowSelection(propsRef: ComputedRef<TtTableProps>, grid: Ref<undefined | VxeGridInstance<Recordable>>, emit: SelectionEmit, identity: RowSelectionIdentity): {
     selectedKeys: Ref<any, any>;
     selectedRows: Ref<any, any>;
+    selectedKeyList: ComputedRef<(string | number)[]>;
+    getSelectRowKeys: () => any;
+    getSelectRows: () => TtSelectRowsType;
+    syncSelection: (data?: Recordable) => void;
     setSelectedRowKeys: (rows: TtSelectRowsType, keys?: TtSelectRowKeysType) => Promise<void>;
-    onCellAreaSelectionEndSetCheckbox: (data: VxeTableExtendCellAreaDefines.CellAreaSelectionAllEndEventParams) => Promise<void>;
     clearSelectedRowKeys: () => void;
+    resetSelectionAfterFetch: () => void;
     onCheckboxChange: VxeGridEvents.CheckboxChange<any>;
     onCheckboxAll: VxeGridEvents.CheckboxAll<any>;
-    getSelectRowKeys: () => any;
-    getSelectRows: () => TtSelectRowsType;
     onCheckboxRangeChange: VxeGridEvents.CheckboxRangeChange<any>;
     onRadioChange: (data: VxeGridDefines.RadioChangeEventParams) => void;
-    getCheckboxSelectedKeys: ComputedRef<(string | number)[]>;
+    onCellAreaSelectionEnd: VxeGridEvents.CellAreaSelectionAllEnd<any>;
 };
 export {};