@dazhicheng/ui 1.5.265 → 1.6.0

package/dist/components/tt-table/src/utils/action-tab-index.d.ts

@@ -0,0 +1,2 @@
+/** 在下一帧统一整理所有表格操作列的焦点顺序。 */
+export declare function scheduleNormalizeActionTabIndex(): void;

package/dist/components/tt-table/src/utils/action-tab-index.js

@@ -0,0 +1,50 @@
+import "axios";
+import "element-plus";
+import { isUndefined as d, isServer as f } from "../../../../packages/utils/src/is.js";
+import "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";
+let a;
+function p() {
+  const u = Array.from(document.querySelectorAll('[class*="table-action"]')), r = /* @__PURE__ */ new Map();
+  u.forEach((n) => {
+    const o = n.closest(".vxe-table");
+    if (!o) return;
+    const s = n.getBoundingClientRect(), t = Math.round(s.top), e = r.get(o) || /* @__PURE__ */ new Map(), i = e.get(t) || [];
+    i.push(n), e.set(t, i), r.set(o, e);
+  }), r.forEach((n) => {
+    n.forEach((o) => {
+      const s = o.sort((t, e) => {
+        const i = t.closest(".vxe-table"), c = e.closest(".vxe-table"), l = i != null && i.classList.contains("is--fixed-right") ? 1 : 0, m = c != null && c.classList.contains("is--fixed-right") ? 1 : 0;
+        return l !== m ? m - l : e.getBoundingClientRect().left - t.getBoundingClientRect().left;
+      })[0];
+      o.forEach((t) => {
+        t.querySelectorAll("[data-table-action-button]").forEach((e) => {
+          e.tabIndex = t === s ? 0 : -1;
+        });
+      });
+    });
+  });
+}
+function B() {
+  if (d(a)) {
+    if (f || !window.requestAnimationFrame) {
+      p();
+      return;
+    }
+    a = window.requestAnimationFrame(() => {
+      a = void 0, p();
+    });
+  }
+}
+export {
+  B as scheduleNormalizeActionTabIndex
+};

package/dist/components/tt-table/src/utils/context.js

@@ -1,17 +1,30 @@
-import { inject as r, provide as c } from "vue";
-function s(t, u) {
-  const i = `${t}Context`, e = Symbol(i);
-  return [(n) => {
-    const o = r(e, n);
-    if (o || o === null) return o;
+import { inject as s, provide as c } from "vue";
+import "axios";
+import "element-plus";
+import { isString as m, isArray as p } from "../../../../packages/utils/src/is.js";
+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 f(t, r) {
+  const e = m(t) && !r ? `${t}Context` : r, n = Symbol(e);
+  return [(o) => {
+    const i = s(n, o);
+    if (i || i === null) return i;
     throw new Error(
-      `Injection \`${e.toString()}\` not found. Component must be used within ${Array.isArray(t) ? `one of the following components: ${t.join(", ")}` : `\`${t}\``}`
+      `Injection \`${n.toString()}\` not found. Component must be used within ${p(t) ? `one of the following components: ${t.join(", ")}` : `\`${t}\``}`
     );
-  }, (n) => (c(e, n), n)];
+  }, (o) => (c(n, o), o)];
 }
-const [d, l] = s("FormActionTestIds");
+const [T, D] = f("FormActionTestIds");
 export {
-  s as createContext,
-  d as injectFormActionTestIds,
-  l as provideFormActionTestIds
+  f as createContext,
+  T as injectFormActionTestIds,
+  D as provideFormActionTestIds
 };

package/dist/components/tt-table/src/utils/table-api.d.ts

@@ -1,52 +1,63 @@
-import { VxeGridInstance, VxeGridPropTypes, VxeTableDefines, VxeTablePropTypes } from 'vxe-table';
+import { MaybeRefOrGetter } from 'vue';
+import { VxeGridInstance, VxeGridPropTypes, VxeTableDefines } from 'vxe-table';
+import { Recordable } from '../../../../../../utils/src';
 import { FetchParams, TtSelectRowKeysType, TtSelectRowsType, TtTableMethods, TtTableProps } from '../types/table';
 import { Store } from '@tanstack/vue-store';
-type ProxyStateType = {
-    loading?: boolean;
-    selectedKeys?: TtSelectRowKeysType;
-    isTableEvent?: boolean;
-    selectedRows?: TtSelectRowsType;
+/** 组件内交给 api 的响应式状态源 */
+type StateSources = {
+    loading: MaybeRefOrGetter<boolean | undefined>;
+    selectedKeys: MaybeRefOrGetter<TtSelectRowKeysType>;
+    selectedRows: MaybeRefOrGetter<TtSelectRowsType>;
 };
+/**
+ * hook 方式（`useTableRender()` / `useTableFormRender()`）的表格默认配置。
+ *
+ * 共用部分取自 `createSharedTableDefaults()`（`src/table-defaults.ts`），这里只补 hook 方式独有的字段。
+ * 导出名保留不变，`table-form-api.ts` 在引用。
+ * @returns 每次调用都是新对象
+ */
 export declare function getDefaultState(): TtTableProps;
 /**
  * TableApi 表格组件的 API 封装类
  *
  * 用于统一管理表格的实例、状态、方法，便于外部操作。
+ * `Row` 是业务行数据类型，由 `useTableRender<Row>()` 传入后 `getDataSource()`、
+ * `insert()`、`setRow()` 这些方法的签名会跟着推断；不传时退化为 `any`。
  *
  * @example
  * const api = new TableApi({ ...配置 })
  * api.reload()
  * api.setProps({ ... })
  */
-declare class TableApi {
+declare class TableApi<Row = any> {
     /** vxe-grid 表格实例 */
     grid: VxeGridInstance;
     /** 表格操作方法集合（TtTableMethods） */
-    methods: TtTableMethods;
+    methods: TtTableMethods<Row>;
     /** 当前表格的 props 状态 */
-    state: null | TtTableProps;
+    state: null | TtTableProps<Row>;
     /** 响应式 store，存储表格的状态 */
-    store: Store<TtTableProps>;
-    /** 响应式代理状态（loading、selectedKeys） */
-    private proxyState;
+    store: Store<TtTableProps<Row>>;
+    /** 组件内的响应式状态源（loading、行选择），挂载时由组件交进来 */
+    private stateSources;
     private isMounted;
     private stateHandler;
     /**
      * 构造函数，初始化 store、状态等
      * @param options 表格配置项
      */
-    constructor(options?: TtTableProps);
+    constructor(options?: TtTableProps<Row>);
     /**
      * 组件挂载时调用，注入表格实例和方法
      * @param instance vxe-grid 实例
      * @param methods 表格操作方法
      */
-    mount(instance: undefined | VxeGridInstance, methods: TtTableMethods): void;
+    mount(instance: undefined | VxeGridInstance, methods: TtTableMethods<Row>): void;
     /**
      * 更新表格的状态
      * @param stateOrFn 新状态或返回新状态的函数
      */
-    setState(stateOrFn: ((prev: TtTableProps) => Partial<TtTableProps>) | Partial<TtTableProps>): void;
+    setState(stateOrFn: ((prev: TtTableProps<Row>) => Partial<TtTableProps<Row>>) | Partial<TtTableProps<Row>>): void;
     /**
      * 组件卸载时调用，重置挂载状态
      */
@@ -61,7 +72,7 @@ declare class TableApi {
      * @description: 设置表格props
      * @param {Partial<TtTableProps>} props 表格props
      */
-    setProps(props: Partial<TtTableProps>): void;
+    setProps(props: Partial<TtTableProps<Row>>): void;
     /**
      * @description: 重新计算高度
      * @return {*}
@@ -72,17 +83,17 @@ declare class TableApi {
      * @param {VxeGridPropTypes.Columns<DT>} columns columns
      * @return {*}
      */
-    setTableColumns(columns: VxeGridPropTypes.Columns<VxeTablePropTypes.Row>): void;
+    setTableColumns(columns: VxeGridPropTypes.Columns<Row>): void;
     /**
      * @description: 获取表格columns
      * @return {VxeGridPropTypes.Columns<DT> | undefined}
      */
-    getTableColumns(): VxeGridPropTypes.Columns<VxeTablePropTypes.Row> | undefined;
+    getTableColumns(): VxeGridPropTypes.Columns<Row> | undefined;
     /**
      * @description: 获取表格数据
      * @return {DT[]}
      */
-    getDataSource(): VxeTablePropTypes.Row[];
+    getDataSource(): Row[];
     /**
      * @description: 设置表格loading
      * @param {boolean} loading
@@ -97,7 +108,7 @@ declare class TableApi {
      * @description: 设置表格pagination
      * @param {Partial<VxeGridPropTypes.PagerConfig>} props 表格pagination
      */
-    setPagination(props: VxeGridPropTypes.PagerConfig): void;
+    setPagination(props: Partial<VxeGridPropTypes.PagerConfig>): void;
     /**
      * @description: 获取选中数据的keys集合
      * @return {Array<string>}
@@ -122,9 +133,9 @@ declare class TableApi {
      * 往表格插入临时数据，从第一行新增一行或多行新数据
      * @param records 新数据
      */
-    insert(records: VxeTablePropTypes.Row): Promise<{
-        row: VxeTablePropTypes.Row;
-        rows: VxeTablePropTypes.Row[];
+    insert(records: Row): Promise<{
+        row: Row;
+        rows: Row[];
     }>;
     /**
      * 往表格指定行中插入临时数据
@@ -134,65 +145,103 @@ declare class TableApi {
      * @param {Object/Array} records 新的数据
      * @param {Row} row 指定行
      */
-    insertAt(records: VxeTablePropTypes.Row, row: VxeTablePropTypes.Row | -1 | null): Promise<{
-        row: VxeTablePropTypes.Row;
-        rows: VxeTablePropTypes.Row[];
+    insertAt(records: Row, row: Row | -1 | null): Promise<{
+        row: Row;
+        rows: Row[];
+    }>;
+    /** 在指定行之后插入临时数据 */
+    insertNextAt(records: Row, row: Row | -1 | null): Promise<{
+        row: Row;
+        rows: Row[];
+    }>;
+    /** 在树节点下插入临时子数据 */
+    insertChild(records: Row, parentRow: Row): Promise<{
+        row: Row;
+        rows: Row[];
+    }>;
+    /** 在树节点下的指定位置插入临时子数据 */
+    insertChildAt(records: Row, parentRow: Row, row: Row | -1 | null): Promise<{
+        row: Row;
+        rows: Row[];
+    }>;
+    /** 在树节点下的指定行之后插入临时子数据 */
+    insertChildNextAt(records: Row, parentRow: Row, row: Row | -1 | null): Promise<{
+        row: Row;
+        rows: Row[];
     }>;
     /**
      * 删除指定行数据，指定 row 或 [row, ...] 删除多条数据，如果为空则删除所有数据
      * @param rows 指定行
      */
-    remove(rows: VxeTablePropTypes.Row | VxeTablePropTypes.Row[]): Promise<{
-        row: VxeTablePropTypes.Row;
-        rows: VxeTablePropTypes.Row[];
+    remove(rows: Row | Row[]): Promise<{
+        row: Row;
+        rows: Row[];
     }>;
     /**
      * 删除复选框选中的行数据
      */
     removeCheckboxRow(): Promise<{
-        row: VxeTablePropTypes.Row;
-        rows: VxeTablePropTypes.Row[];
+        row: Row;
+        rows: Row[];
     }>;
     /**
      * 删除单选框选中的行数据
      */
     removeRadioRow(): Promise<{
-        row: VxeTablePropTypes.Row;
-        rows: VxeTablePropTypes.Row[];
+        row: Row;
+        rows: Row[];
     }>;
     /**
      * 删除当前行选中的行数据
      */
     removeCurrentRow(): Promise<{
-        row: VxeTablePropTypes.Row;
-        rows: VxeTablePropTypes.Row[];
+        row: Row;
+        rows: Row[];
     }>;
+    /**
+     * 删除所有新增的临时数据
+     */
+    removeInsertRow(): Promise<{
+        row: Row;
+        rows: Row[];
+    }>;
+    /** 清除表格的全部数据状态 */
+    clearAll(): Promise<void>;
+    /**
+     * 重新加载 VXE 当前同步数据。
+     * @deprecated VXE 已废弃 syncData，请使用 reloadData 或 getDataSource。
+     */
+    syncData(): Promise<void>;
+    /** 重新计算 VXE 的数据视图 */
+    updateData(): Promise<void>;
+    /** 修改指定行数据 */
+    setRow(rows: Row | Row[], record: Row): Promise<void>;
     /**
      * 清除编辑状态并重置数据
      */
-    clearEditRevertData(records: VxeTablePropTypes.Row): void;
+    clearEditRevertData(records: Row): void;
     /**
      * 指定行激活编辑
-     * @param {VxeTablePropTypes.Row} row 行数据
+     * @param {Row} row 行数据
      * @param {string | VxeTableDefines.ColumnInfo} fieldOrColumn 列配置可以时field
      */
-    setEditRow(row: VxeTablePropTypes.Row, fieldOrColumn?: boolean | string | VxeTableDefines.ColumnInfo): void;
+    setEditRow(row: Row, fieldOrColumn?: boolean | string | VxeTableDefines.ColumnInfo): void;
     /**
      * 指定单元格激活编辑
-     * @param {VxeTablePropTypes.Row} row 当前行数据
+     * @param {Row} row 当前行数据
      * @param {string | VxeTableDefines.ColumnInfo} fieldOrColumn 列配置可以时field
      */
-    setEditCell(row: VxeTablePropTypes.Row, fieldOrColumn: string | VxeTableDefines.ColumnInfo): void;
+    setEditCell(row: Row, fieldOrColumn: string | VxeTableDefines.ColumnInfo): void;
     /**
      * 加载数据
      * @param data 数据
      */
-    loadData(data: VxeTablePropTypes.Row[]): Promise<any>;
+    loadData(data: Row[]): Promise<any>;
     /**
      * 加载数据并恢复到初始状态
      * @param data 数据
      */
-    reloadData(data: VxeTablePropTypes.Row[]): Promise<void>;
+    reloadData(data: Row[]): Promise<void>;
     /**
      * 重新加载列
      * @param columns 列对象
@@ -204,47 +253,76 @@ declare class TableApi {
      * @param record 新数据
      * @param field 指定字段名
      */
-    reloadRow(rows: VxeTablePropTypes.Row | VxeTablePropTypes.Row[], record?: VxeTablePropTypes.Row, field?: string): Promise<void>;
+    reloadRow(rows: Row | Row[], record?: Row, field?: string): Promise<void>;
+    /** 还原 keep-source 保存的行数据 */
+    revertData(rows?: Row | Row[], field?: string): Promise<any>;
+    /** 加载树节点的子数据 */
+    loadTreeChildren(row: Row, children: Row[]): Promise<any[]>;
     /**
      * 手动清空单元格内容，如果不传参数，则清空整个表格内容，如果传了行则清空指定行内容，如果传了指定字段，则清空该字段内容
      * @param data 指定行
      * @param field 字段名
      */
-    clearData(data?: VxeTablePropTypes.Row | VxeTablePropTypes.Row[], field?: string): Promise<any>;
+    clearData(data?: Row | Row[], field?: string): Promise<any>;
+    /** 移动行到指定行位置 */
+    moveRowTo(row: Row | string | number, targetRow: Row | string | number, options?: Recordable): Promise<{
+        status: boolean;
+    }>;
+    /** 撤销最近一次数据操作 */
+    undo(): Promise<{
+        status: boolean;
+    }>;
+    /** 重做最近一次数据操作 */
+    redo(): Promise<{
+        status: boolean;
+    }>;
     /**
      * 重新懒加载展开行，并展开内容
      * @param row 指定行
      */
-    reloadRowExpand(row: VxeTablePropTypes.Row): void;
+    reloadRowExpand(row: Row): Promise<void>;
     /**
      * 重新懒加载树节点，并展开该节点
      * @param row 指定行
      */
-    reloadTreeExpand(row: VxeTablePropTypes.Row): void;
+    reloadTreeExpand(row: Row): Promise<any>;
     /** 获取表格实例 */
     getTableInstance(): VxeGridInstance;
     /**
-     * 设置代理状态（loading、selectedKeys）
-     * @param state 代理状态对象
+     * 校验表格编辑数据
+     * @param isFull true 时校验全部行并收集所有错误，缺省或 false 时遇到第一个错误即停止
+     * @returns 全部通过时为 undefined，否则为 vxe 原生形状的错误映射（以列字段为键）
      */
-    setProxyState(state: ProxyStateType): void;
+    validate(isFull?: boolean): Promise<VxeTableDefines.ValidatorErrorMapParams<any> | undefined>;
     /**
-     * @description: 获取表格选中数据
-     * @return {DT[]}
+     * 校验指定行的指定字段
+     * @param row 行数据
+     * @param field 列字段名
+     */
+    validateField(row: Row, field: string): Promise<VxeTableDefines.ValidatorErrorMapParams<any> | undefined>;
+    /**
+     * 设置空数据提示文字
+     * @param text 提示文字
+     */
+    setEmptyText(text: string): void;
+    /**
+     * 绑定组件内的响应式状态源
+     *
+     * 直接持有组件的 ref，读取时才取值，避免用 watch 把状态同步到 api 上。
+     * @param sources 状态源
+     */
+    bindState(sources: StateSources): void;
+    /**
+     * @description: 获取表格选中数据的keys（响应式）
      */
     selectedKeys: import('vue').ComputedRef<any>;
     /**
-     * @description: 获取表格选中数据
-     * @return {DT[]}
+     * @description: 获取表格选中数据（响应式）
      */
     selectedRows: import('vue').ComputedRef<any>;
     /**
      * 获取表格 loading 状态（响应式）
      */
-    getLoading: import('vue').ComputedRef<boolean | undefined>;
-    /**
-     * 是否使用表格的event
-     */
-    getIsTableEvent: import('vue').ComputedRef<boolean | undefined>;
+    getLoading: import('vue').ComputedRef<boolean>;
 }
 export { TableApi };