@gct-paas/core-web 0.1.4-dev.1 → 0.1.4-dev.11

package/es/modules/gct-table/interface/i-table/i-table-item.d.ts

@@ -0,0 +1,98 @@
+import { VNodeChild } from 'vue';
+import { JSX } from 'vue/jsx-runtime';
+interface CustomRenderProps {
+    /**
+     * 行数据
+     * @author lingxiaoming
+     * @date 2024-07-12 05:37:58
+     * @type {IData}
+     */
+    record: IData;
+}
+/**
+ * 表格项
+ *
+ * @author zhanghanrui
+ * @date 2024-04-15 17:04:06
+ * @export
+ * @interface ITableItem
+ */
+export interface ITableItem {
+    /**
+     * 表格项标识
+     *
+     * @author zhanghanrui
+     * @date 2024-04-17 09:04:20
+     * @type {string}
+     */
+    name: string;
+    /**
+     * 数据标识（给 a-table 用）
+     *
+     * @author zhanghanrui
+     * @date 2024-04-15 17:04:14
+     * @type {string}
+     */
+    dataIndex: string;
+    /**
+     * 数据标题
+     *
+     * @author zhanghanrui
+     * @date 2024-04-15 17:04:51
+     * @type {string}
+     */
+    title: string;
+    /**
+     * 实际属性，未配置默认识别 dataIndex
+     *
+     * @description 支持单一和数组两种形式
+     * @author zhanghanrui
+     * @date 2024-04-15 17:04:07
+     * @type {(string[] | string)}
+     */
+    fields?: string[] | string;
+    /**
+     * 表格项模式，不配置默认为 default
+     *
+     * @default 'default'
+     * @author zhanghanrui
+     * @date 2024-04-15 17:04:09
+     * @type {('default' | 'edit' | 'actions' | 'link')} '默认只呈现' | '编辑项' | '操作列' | '链接'
+     */
+    type?: 'default' | 'edit' | 'actions' | 'link';
+    /**
+     * 列宽度
+     * @author lingxiaoming
+     * @date 2024-07-13 03:06:22
+     * @type {number}
+     */
+    width?: number;
+    /**
+     * 固定列位置
+     *
+     * @type {('left' | 'right')}
+     */
+    fixed?: 'left' | 'right';
+    /**
+     * 是否可调整列宽
+     *
+     * @type {boolean}
+     */
+    resizable?: boolean;
+    /**
+     * 链接模式下的点击回调
+     *
+     */
+    click?: (record: IData) => void;
+    /**
+     * 自定义绘制
+     * @author lingxiaoming
+     * @date 2024-07-12 05:36:02
+     */
+    customRender?: (props: CustomRenderProps) => VNodeChild | JSX.Element;
+    /**
+     * 是否单行省略
+     */
+    ellipsis?: boolean;
+}
+export {};

package/es/modules/gct-table/interface/i-table/i-table.d.ts

@@ -0,0 +1,76 @@
+import { ITableController } from '../i-controller';
+import { IPagination } from './i-pagination';
+import { ITableItem } from './i-table-item';
+/**
+ * 表单
+ *
+ * @author zhanghanrui
+ * @date 2024-04-15 17:04:39
+ * @export
+ * @interface ITable
+ */
+export interface ITable {
+    /**
+     * 是否为本地模式，本地模式下不进行数据加载。默认为 false
+     *
+     * @default false
+     * @author zhanghanrui
+     * @date 2024-04-17 10:04:09
+     * @type {boolean}
+     */
+    local?: boolean;
+    /**
+     * 行编辑模式
+     *
+     * @author chitanda
+     * @date 2025-07-07 09:07:49
+     * @type {('row' | 'all')} 单行(hover/active)行编辑模式 | 全表格编辑模式
+     */
+    rowEditMode?: 'row' | 'all';
+    /**
+     * 空数据时是否显示提示文本
+     *
+     * @type {boolean}
+     */
+    isEmptyText?: boolean;
+    /**
+     * 是否自动加载，非本地模式下默认自动加载，本地模式下不自动加载
+     *
+     * @author zhanghanrui
+     * @date 2024-04-17 10:04:53
+     * @type {boolean}
+     */
+    autoLoad?: boolean;
+    /**
+     * 行数据主键标识
+     *
+     * @author zhanghanrui
+     * @date 2024-04-17 10:04:36
+     * @type {string}
+     */
+    key: string;
+    /**
+     * 表格列
+     *
+     * @author zhanghanrui
+     * @date 2024-04-15 17:04:00
+     * @type {ITableItem[]}
+     */
+    columns: ITableItem[];
+    /**
+     * 分页模型
+     * @author lingxiaoming
+     * @date 2024-07-13 09:53:34
+     * @type {IPagination}
+     */
+    pagination?: IPagination;
+    /**
+     * 获取当前页面数据
+     *
+     * @author zhanghanrui
+     * @date 2024-04-16 10:04:27
+     * @param {IParams} [params]
+     * @return {*}  {Promise<IData[]>}
+     */
+    fetch?(params?: IParams, controller?: ITableController): Promise<IData[]>;
+}

package/es/modules/gct-table/interface/i-table/index.d.ts

@@ -0,0 +1,4 @@
+export type { ITableActionItem } from './i-table-action-item';
+export type { ITableEditItem } from './i-table-edit-item';
+export type { ITableItem } from './i-table-item';
+export type { ITable } from './i-table';

package/es/modules/gct-table/interface/index.d.ts

@@ -0,0 +1,5 @@
+export type * from './i-controller';
+export type * from './i-provider';
+export type * from './i-events';
+export type * from './i-state';
+export type * from './i-table';

package/es/modules/gct-table/register/index.d.ts

@@ -0,0 +1 @@
+export { TableEditorRegister } from './table-editor-register/table-editor-register';

package/es/modules/gct-table/register/table-editor-register/table-editor-register.d.ts

@@ -0,0 +1,53 @@
+import { ITableEditorProvider } from '../../interface';
+/**
+ * 编辑器实现注册器
+ *
+ * @author zhanghanrui
+ * @date 2024-03-27 10:03:59
+ * @export
+ * @class TableEditorRegister
+ */
+export declare class TableEditorRegister {
+    /**
+     * 编辑器集合
+     *
+     * @author zhanghanrui
+     * @date 2024-03-27 10:03:25
+     * @private
+     * @type {Map<string, () => ITableEditorProvider>}
+     */
+    private editors;
+    /**
+     * 已经实例化的编辑器集合
+     *
+     * @author zhanghanrui
+     * @date 2024-03-27 10:03:43
+     * @private
+     * @type {Map<string, ITableEditorProvider>}
+     */
+    private providers;
+    /**
+     * 编辑器适配器注册
+     *
+     * @param {string} tag 适配器标识
+     * @param {() => ITableEditorProvider} provider 编辑器提供者
+     */
+    register(tag: string, provider: () => ITableEditorProvider): void;
+    /**
+     * 编辑器适配器注销
+     *
+     * @author zhanghanrui
+     * @date 2024-03-27 10:03:29
+     * @param {string} tag
+     */
+    unregister(tag: string): void;
+    /**
+     * 获取编辑器适配器
+     *
+     * @author zhanghanrui
+     * @date 2024-04-17 11:04:33
+     * @param {string} tag
+     * @return {*}  {(ITableEditorProvider | null)}
+     */
+    get(tag: string): ITableEditorProvider | null;
+}

package/es/modules/gct-table/register/table-editor-register/table-editor-register.mjs

@@ -0,0 +1,61 @@
+class TableEditorRegister {
+  /**
+   * 编辑器集合
+   *
+   * @author zhanghanrui
+   * @date 2024-03-27 10:03:25
+   * @private
+   * @type {Map<string, () => ITableEditorProvider>}
+   */
+  editors = /* @__PURE__ */ new Map();
+  /**
+   * 已经实例化的编辑器集合
+   *
+   * @author zhanghanrui
+   * @date 2024-03-27 10:03:43
+   * @private
+   * @type {Map<string, ITableEditorProvider>}
+   */
+  providers = /* @__PURE__ */ new Map();
+  /**
+   * 编辑器适配器注册
+   *
+   * @param {string} tag 适配器标识
+   * @param {() => ITableEditorProvider} provider 编辑器提供者
+   */
+  register(tag, provider) {
+    this.editors.set(tag, provider);
+  }
+  /**
+   * 编辑器适配器注销
+   *
+   * @author zhanghanrui
+   * @date 2024-03-27 10:03:29
+   * @param {string} tag
+   */
+  unregister(tag) {
+    this.editors.delete(tag);
+  }
+  /**
+   * 获取编辑器适配器
+   *
+   * @author zhanghanrui
+   * @date 2024-04-17 11:04:33
+   * @param {string} tag
+   * @return {*}  {(ITableEditorProvider | null)}
+   */
+  get(tag) {
+    if (this.providers.has(tag)) {
+      return this.providers.get(tag);
+    }
+    const provider = this.editors.get(tag);
+    if (provider) {
+      const instance = provider();
+      this.providers.set(tag, instance);
+      return instance;
+    }
+    return null;
+  }
+}
+
+export { TableEditorRegister };

package/es/modules/gct-table/state/index.d.ts

@@ -0,0 +1,4 @@
+export { TableState } from './table/table.state';
+export { TableEditItemState } from './table-item/table-edit-item.state';
+export { TableITemState } from './table-item/table-item.state';
+export { TableRowState } from './table-row/table-row.state';

package/es/modules/gct-table/state/table/table.state.d.ts

@@ -0,0 +1,45 @@
+import { ITableState } from '../../interface';
+/**
+ * 表格状态
+ *
+ * @author zhanghanrui
+ * @date 2024-04-16 11:04:00
+ * @export
+ * @class TableState
+ * @implements {ITableState}
+ */
+export declare class TableState implements ITableState {
+    formData: IData;
+    /**
+     * 当前表格数据
+     *
+     * @author zhanghanrui
+     * @date 2024-04-16 20:04:23
+     * @type {IData[]}
+     */
+    items: IData[];
+    /**
+     * 当前页面
+     *
+     * @author zhanghanrui
+     * @date 2024-04-16 11:04:04
+     * @type {number}
+     */
+    page: number;
+    /**
+     * 数据总数
+     *
+     * @author zhanghanrui
+     * @date 2024-04-16 11:04:09
+     * @type {number}
+     */
+    total: number;
+    /**
+     * 分页数量
+     *
+     * @author zhanghanrui
+     * @date 2024-04-16 11:04:17
+     * @type {number}
+     */
+    size: number;
+}

package/es/modules/gct-table/state/table/table.state.mjs

@@ -0,0 +1,37 @@
+class TableState {
+  formData = {};
+  /**
+   * 当前表格数据
+   *
+   * @author zhanghanrui
+   * @date 2024-04-16 20:04:23
+   * @type {IData[]}
+   */
+  items = [];
+  /**
+   * 当前页面
+   *
+   * @author zhanghanrui
+   * @date 2024-04-16 11:04:04
+   * @type {number}
+   */
+  page = 1;
+  /**
+   * 数据总数
+   *
+   * @author zhanghanrui
+   * @date 2024-04-16 11:04:09
+   * @type {number}
+   */
+  total = 0;
+  /**
+   * 分页数量
+   *
+   * @author zhanghanrui
+   * @date 2024-04-16 11:04:17
+   * @type {number}
+   */
+  size = 20;
+}
+
+export { TableState };

package/es/modules/gct-table/state/table-item/table-edit-item.state.d.ts

@@ -0,0 +1,18 @@
+import { ITableEditItemState } from '../../interface';
+import { TableITemState } from './table-item.state';
+/**
+ * 表格编辑项状态
+ *
+ * @author zhanghanrui
+ * @date 2024-04-16 21:04:47
+ * @export
+ * @class TableEditItemState
+ * @extends {TableITemState}
+ * @implements {ITableEditItemState}
+ */
+export declare class TableEditItemState extends TableITemState implements ITableEditItemState {
+    error: boolean;
+    errMessage: string;
+    readonly: boolean;
+    disabled: boolean;
+}

package/es/modules/gct-table/state/table-item/table-edit-item.state.mjs

@@ -0,0 +1,10 @@
+import { TableITemState } from './table-item.state.mjs';
+
+class TableEditItemState extends TableITemState {
+  error = false;
+  errMessage = "";
+  readonly = false;
+  disabled = false;
+}
+
+export { TableEditItemState };

package/es/modules/gct-table/state/table-item/table-item.state.d.ts

@@ -0,0 +1,28 @@
+import { ITableItemState } from '../../interface';
+/**
+ *
+ *
+ * @author zhanghanrui
+ * @date 2024-04-16 20:04:19
+ * @export
+ * @class TableITemState
+ * @implements {ITableItemState}
+ */
+export declare class TableITemState implements ITableItemState {
+    /**
+     * 是否保活
+     *
+     * @author zhanghanrui
+     * @date 2024-04-17 13:04:32
+     * @type {boolean}
+     */
+    keepalive: boolean;
+    /**
+     * 是否显示
+     *
+     * @author zhanghanrui
+     * @date 2024-04-16 20:04:58
+     * @type {boolean}
+     */
+    visible: boolean;
+}

package/es/modules/gct-table/state/table-item/table-item.state.mjs

@@ -0,0 +1,20 @@
+class TableITemState {
+  /**
+   * 是否保活
+   *
+   * @author zhanghanrui
+   * @date 2024-04-17 13:04:32
+   * @type {boolean}
+   */
+  keepalive = true;
+  /**
+   * 是否显示
+   *
+   * @author zhanghanrui
+   * @date 2024-04-16 20:04:58
+   * @type {boolean}
+   */
+  visible = true;
+}
+
+export { TableITemState };

package/es/modules/gct-table/state/table-row/table-row.state.d.ts

@@ -0,0 +1,15 @@
+import { ITableRowState } from '../../interface';
+/**
+ * 表格行数据状态
+ *
+ * @author zhanghanrui
+ * @date 2024-04-16 21:04:41
+ * @export
+ * @class TableRowState
+ * @implements {ITableRowState}
+ */
+export declare class TableRowState implements ITableRowState {
+    hover: boolean;
+    active: boolean;
+    deleted: boolean;
+}

package/es/modules/gct-table/state/table-row/table-row.state.mjs

@@ -0,0 +1,7 @@
+class TableRowState {
+  hover = false;
+  active = false;
+  deleted = false;
+}
+
+export { TableRowState };

package/es/modules/gct-table/utils/count-latch/count-latch.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 计数插销工具类
+ *
+ * @author zhanghanrui
+ * @date 2024-04-18 09:04:53
+ * @export
+ * @class CountLatch
+ */
+export declare class CountLatch {
+    private promise;
+    private resolve;
+    /**
+     * 计数，当前等待的异步逻辑个数
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:58
+     * @private
+     * @type {number}
+     */
+    private count;
+    /**
+     * 是否处于锁止状态
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:17
+     * @readonly
+     * @type {boolean}
+     */
+    get isLock(): boolean;
+    /**
+     * 开启promise
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:06
+     * @private
+     */
+    private startPromise;
+    /**
+     * 结束promise
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:13
+     * @private
+     */
+    private endPromise;
+    /**
+     * 上锁，计数加一
+     * 第一次计数，开启异步
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:20
+     */
+    lock(): void;
+    /**
+     * 解锁，计数减一
+     * 归零时结束异步
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:27
+     */
+    unlock(): void;
+    /**
+     * 等待，计数归零异步结束
+     *
+     * @author zhanghanrui
+     * @date 2024-04-18 09:04:33
+     * @return {*}  {Promise<void>}
+     */
+    await(): Promise<void>;
+}

package/es/modules/gct-table/utils/count-latch/count-latch.mjs

@@ -0,0 +1,95 @@
+class CountLatch {
+  promise = null;
+  resolve = null;
+  /**
+   * 计数，当前等待的异步逻辑个数
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:58
+   * @private
+   * @type {number}
+   */
+  count = 0;
+  /**
+   * 是否处于锁止状态
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:17
+   * @readonly
+   * @type {boolean}
+   */
+  get isLock() {
+    return this.count > 0;
+  }
+  /**
+   * 开启promise
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:06
+   * @private
+   */
+  startPromise() {
+    this.promise = new Promise((resolve) => {
+      this.resolve = resolve;
+    });
+  }
+  /**
+   * 结束promise
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:13
+   * @private
+   */
+  endPromise() {
+    if (this.resolve) {
+      this.resolve();
+      this.resolve = null;
+      this.promise = null;
+    }
+  }
+  /**
+   * 上锁，计数加一
+   * 第一次计数，开启异步
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:20
+   */
+  lock() {
+    this.count += 1;
+    if (!this.promise) {
+      this.startPromise();
+    }
+  }
+  /**
+   * 解锁，计数减一
+   * 归零时结束异步
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:27
+   */
+  unlock() {
+    if (this.count < 1) {
+      this.count = 0;
+      console.warn("lock和unlock次数不匹配！");
+      return;
+    }
+    this.count -= 1;
+    if (this.count === 0) {
+      this.endPromise();
+    }
+  }
+  /**
+   * 等待，计数归零异步结束
+   *
+   * @author zhanghanrui
+   * @date 2024-04-18 09:04:33
+   * @return {*}  {Promise<void>}
+   */
+  async await() {
+    if (this.promise) {
+      return this.promise;
+    }
+  }
+}
+
+export { CountLatch };

package/es/modules/gct-table/utils/count-latch/result-awaiter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * 拆分处理异步结果
+ *
+ * @export
+ * @class ResultAwaiter
+ * @template T
+ */
+export declare class ResultAwaiter<T> {
+    private promise;
+    private _resolve;
+    private _reject;
+    constructor();
+    private init;
+    await(): Promise<T>;
+    resolve(result: T): void;
+    reject(reason?: IObject): void;
+}

package/es/modules/gct-table/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { CountLatch } from './count-latch/count-latch';
+export { ResultAwaiter } from './count-latch/result-awaiter';
+export { widthTableEditorInstall } from './width-install/width-install';