@kengic/vue 0.2.2-beta.8 → 0.3.0

package/dist/src/components/KgSearch/index.store.d.ts

@@ -13,12 +13,10 @@ export declare type IKgSearchResetFn = () => void;
 export interface KgSearchState {
     /** 是否准备就绪. 即查询条件是否已经初始化完成了. */
     isReadyMap: Map<string, boolean>;
-    /** 表单数据. */
+    /** 表单数据对象. */
     modelMap: Map<string, Record<string, any>>;
     /** 表单组件. */
     formMap: Map<string, ReturnType<typeof Form.useForm>>;
-    /** 表单区的高度. */
-    heightMap: Map<string, number>;
     /** '查询'事件监听函数列表. */
     onSearchListenersMap: Map<string, Array<IKgSearchSearchCb>>;
     /** '重置'事件监听函数列表. */
@@ -32,13 +30,11 @@ export declare type KgSearchStoreDefinition = StoreDefinition<'KgSearch', KgSear
     getIsReady(): (formID?: string | null) => boolean;
     getModel(): (formID?: string | null) => Record<string, any> | null;
     getForm(): (formID?: string | null) => ReturnType<typeof Form.useForm> | null;
-    getHeight(): (formID?: string | null) => number | null;
     getSearchFn(): (formID?: string | null) => IKgSearchSearchFn | null;
     getResetFn(): (formID?: string | null) => IKgSearchResetFn | null;
 }, {
     setIsReady: (formID?: string | null, ready?: boolean) => void;
     setModel: (formID: string, model: Record<string, any>) => void;
-    setHeight: (formID: string, height: number) => void;
     addEventListener: (formID: string, event: IKgSearchEvent, cb: IKgSearchSearchCb) => void;
     removeEventListener: (formID: string, event: IKgSearchEvent, cb?: IKgSearchSearchCb | IKgSearchResetCb) => void;
     setSearchFn: (formID?: string | null, fn?: IKgSearchSearchFn | null) => void;

package/dist/src/components/KgTable/KgTable.data.d.ts

@@ -2,7 +2,9 @@ import { ComputedRef, Ref, UnwrapRef } from 'vue';
 import { ColumnsType } from 'ant-design-vue/es/table';
 import { IKgTableRecord } from './index.vm';
 export declare type IUseColumns = {
+    /** 表格的列. */
     columns: ComputedRef<ColumnsType<IKgTableRecord>>;
+    /** 横向滚动宽度. */
     scrollX: ComputedRef<string>;
 };
 export declare function _useColumns(): IUseColumns;

package/dist/src/components/KgTable/index.hooks.d.ts

@@ -1,15 +1,17 @@
 import { ComputedRef } from 'vue';
-import { IKgTableRowDoubleClickCb, KgTableStore } from './index.store';
+import { IKgTableRetrieveCb, IKgTableRowDoubleClickCb, KgTableStore } from './index.store';
 export declare type IUseKgTable = {
     formID: string;
     /** 状态数据. */
-    kgTableStore: KgTableStore;
+    store: KgTableStore;
     /** 当前勾选的行. */
     selectedRows: ComputedRef<ReturnType<KgTableStore['getSelectedRows']>>;
     /** 是否正在查询. */
     isRetrieving: ComputedRef<ReturnType<KgTableStore['getIsRetrieving']>>;
-    /** 监听双击事件. */
+    /** 监听事件: 双击某行. */
     onRowDoubleClick(cb: IKgTableRowDoubleClickCb): void;
+    /** 监听事件: 查询数据成功. */
+    onRetrieve(cb: IKgTableRetrieveCb): void;
 };
 /**
  * @param formID 界面标识.

package/dist/src/components/KgTable/index.store.d.ts

@@ -1,9 +1,16 @@
 import { StoreDefinition } from 'pinia';
 import { IKgTableRecord } from './index.vm';
-/** 事件类型. */
-export declare type IKgTableEvent = 'rowDoubleClick';
-/** '双击某行'事件监听函数. */
+import { IPage } from '../../apis/WMS/models';
+/**
+ * 事件类型.
+ *   'rowDoubleClick': 双击某行
+ *   'retrieve':       查询数据成功
+ */
+export declare type IKgTableEvent = 'rowDoubleClick' | 'retrieve';
+/** 事件监听函数: 双击某行. */
 export declare type IKgTableRowDoubleClickCb = (record: IKgTableRecord) => void;
+/** 事件监听函数: 查询数据成功. */
+export declare type IKgTableRetrieveCb = (page: IPage<IKgTableRecord> | undefined | null) => void;
 export interface KgTableState {
     /** 勾选的行. */
     selectedRowsMap: Map<string, Array<IKgTableRecord>>;
@@ -18,7 +25,8 @@ export interface KgTableState {
     /** 表格宽度. */
     tableWidthMap: Map<string, number>;
     /** '双击某行'事件监听函数列表. */
-    onRowDoubleClickListenersMap: Map<string, Array<IKgTableRowDoubleClickCb>>;
+    rowDoubleClickListenersMap: Map<string, Array<IKgTableRowDoubleClickCb>>;
+    retrieveListenersMap: Map<string, Array<IKgTableRetrieveCb>>;
 }
 export declare type KgTableStoreDefinition = StoreDefinition<'KgTable', KgTableState, {
     getSelectedRows(): (formID?: string | null) => Array<IKgTableRecord> | null;
@@ -27,8 +35,8 @@ export declare type KgTableStoreDefinition = StoreDefinition<'KgTable', KgTableS
     getTableWidth(): (formID?: string | null) => number | null;
 }, {
     dispose: (formID?: string | null) => void;
-    addEventListener: (formID: string, event: IKgTableEvent, cb: IKgTableRowDoubleClickCb) => void;
-    removeEventListener: (formID: string, event: IKgTableEvent, cb?: IKgTableRowDoubleClickCb) => void;
+    addEventListener: (formID: string, event: IKgTableEvent, cb: IKgTableRowDoubleClickCb | IKgTableRetrieveCb) => void;
+    removeEventListener: (formID: string, event: IKgTableEvent, cb?: IKgTableRowDoubleClickCb | IKgTableRetrieveCb) => void;
     emit: (formID: string, event: IKgTableEvent, record?: any | null) => void;
     setSelectedRows(formID: string, selectedRows: Array<IKgTableRecord>): void;
     setIsRetrieved(formID: string, value: boolean): void;

package/dist/src/components/KgVar/index.hooks.d.ts

@@ -2,8 +2,14 @@ import { ComputedRef } from 'vue';
 import { IKgVarStore } from './index.store';
 import { VarProfileDetail } from '../../apis/WMS/models';
 export declare type IUseKgVar = {
+    /** 界面标识. */
     formID: string;
-    kgVarStore: IKgVarStore;
+    /** 状态数据. */
+    store: IKgVarStore;
+    isRetrieving: ComputedRef<ReturnType<IKgVarStore['isRetrieving']>>;
+    isCreating: ComputedRef<ReturnType<IKgVarStore['isCreating']>>;
+    isUpdating: ComputedRef<ReturnType<IKgVarStore['isUpdating']>>;
+    isCopying: ComputedRef<ReturnType<IKgVarStore['isCopying']>>;
     /** 所有按钮. */
     varButtons: ComputedRef<ReturnType<IKgVarStore['getVarButtons']>>;
     /** 表格配置. */
@@ -18,14 +24,14 @@ export declare type IUseKgVar = {
     varProfileDetails: ComputedRef<Array<VarProfileDetail> | null>;
     /** 所有要显示的查询字段. */
     visibleVarProfileDetails: ComputedRef<Array<VarProfileDetail> | null>;
-    t1: (var_nam?: string | null) => ComputedRef<string>;
-    t2: (var_nam?: string | null) => string;
+    t: (var_nam?: string | null) => ComputedRef<string>;
 };
 /**
  * 启用变量.
- *     1. 在子组件中调用时, 可以不传该参数, 此时会通过依赖注入获取.
- *     2. 在寄生页面中想访问宿主页面的变量配置时, 需要传宿主页面的界面标识.
- *     3. 在组件外调用时, 必须传界面标识.
+ *     1. 在下级组件中调用时, 可以不传该参数, 此时会通过依赖注入获取.
+ *     2. 在任意页面中, 想要访问其他界面标识对应的页面的数据, 需要传入该'界面标识'.
+ *     3. 在组件外(setup 外面)调用时, 必须传入'界面标识'.
  * @param formID 界面标识.
+ * @param init 是否要初始化界面. 在'宿主页面'第一次调用时, 需要传 true, 对该页面做初始化.
  */
-export declare function useKgVar(formID?: string | null): IUseKgVar;
+export declare function useKgVar(formID?: string | null, init?: boolean): IUseKgVar;

package/dist/src/components/KgVar/index.store.d.ts

@@ -1,5 +1,5 @@
 import { type StoreDefinition } from 'pinia';
-import { VarButton, VarCatalog, VarConfig, VarGridConfig, VarGridDetail, VarGridDTO, VarGridMasterDTO, VarLookup, VarPossibility, VarProfileDetail, VarProfileDTO, VarProfileMasterDTO } from '../../apis/WMS/models';
+import { VarButton, VarCatalog, VarConfig, VarGridConfig, VarGridDetail, VarGridDTO, VarGridMasterDTO, VarLookup, VarPossibility, VarProfileDetail, VarProfileDTO, VarProfileMasterDTO, VarSubmitField } from '../../apis/WMS/models';
 export interface KgVarState {
     /**
      * 当前可能打开了多个界面, 需要按照先后顺序记录下来, 当打开变量配置弹窗时, 打开的是最近那个页面的变量配置.
@@ -7,60 +7,85 @@ export interface KgVarState {
     formIDs: Array<string>;
     /** 正在查询变量配置. */
     isRetrievingMap: Map<string, boolean>;
-    /** 变量别名. */
+    /** 正在创建. */
+    isCreatingMap: Map<string, boolean>;
+    /** 正在更新. */
+    isUpdatingMap: Map<string, boolean>;
+    /** 正在复制. */
+    isCopyingMap: Map<string, boolean>;
     varCatalogsMap: Map<string, Array<VarCatalog>>;
-    /** 变量查找. */
     varLookupsMap: Map<string, Array<VarLookup>>;
-    /** 变量下拉列表配置. */
     varPossibilitiesMap: Map<string, Array<VarPossibility>>;
-    /** 变量控件配置. */
     varConfigsMap: Map<string, Array<VarConfig>>;
-    /** 按钮. */
     varButtonsMap: Map<string, Array<VarButton>>;
-    /** 查询条件. */
+    varSubmitFieldsMap: Map<string, Array<VarSubmitField>>;
     varProfileMap: Map<string, {
         varProfile: VarProfileDTO | null;
-        /** 当前查询条件. */
+        /** 当前选中的 VarProfileMaster ID. */
         currentVarProfileMasterID: string | null;
     }>;
-    /** 表格配置. */
-    varGridConfigMap: Map<string, VarGridConfig | null>;
-    /** 表格. */
     varGridMap: Map<string, {
         varGrid: VarGridDTO | null;
         /** 当前表格视图. */
         currentVarGridMasterID: string | null;
     }>;
+    varGridConfigMap: Map<string, VarGridConfig | null>;
 }
 export declare type IKgVarStoreDefinition = StoreDefinition<'KgVar', KgVarState, {
     getTopFormID(): string | null;
     isRetrieving(): (formID?: string | null) => boolean | null;
+    isCreating(): (formID?: string | null) => boolean | null;
+    isUpdating(): (formID?: string | null) => boolean | null;
+    isCopying(): (formID?: string | null) => boolean | null;
     getVarCatalogs(): (formID?: string | null) => Array<VarCatalog> | null;
     getVarCatalog(): (formID?: string | null, var_nam?: string | null) => VarCatalog | null;
     getVarLookup(): (formID?: string | null, var_nam?: string | null) => VarLookup | null;
     getVarPossibility(): (formID?: string | null, var_nam?: string | null) => VarPossibility | null;
     getVarConfig(): (formID?: string | null, var_nam?: string | null) => VarConfig | null;
     getVarButtons(): (formID?: string | null) => Array<VarButton> | null;
+    getVarSubmitFields(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitField(): (formID?: string | null, var_nam?: string | null) => VarSubmitField | null;
     getVarButtonSearch(): (formID?: string | null) => VarButton | null;
     getVarButton(): (formID?: string | null, var_nam?: string | null) => VarButton | null;
     getVarProfileMasters(): (formID?: string | null) => Array<VarProfileMasterDTO> | null;
     getVarProfileDetails(): (formID?: string | null) => Array<VarProfileDetail> | null;
+    getVarProfileDetail(): (formID?: string | null, var_nam?: string | null) => VarProfileDetail | null;
     getCurrentVarProfileMaster(): (formID?: string | null) => VarProfileMasterDTO | null;
     getCurrentVarProfileMasterID(): (formID?: string | null) => string | null;
     getVarGridConfig(): (formID?: string | null) => VarGridConfig | null;
     getVarGridMasters(): (formID?: string | null) => Array<VarGridMasterDTO> | null;
     getVarGridMaster(): (formID?: string | null) => VarGridMasterDTO | null;
-    getVisibleVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
-    getVisibleVarGridDetailsTotalWidth(): (formID?: string | null) => number | null;
     getVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
     getVarGridDetail(): (formID?: string | null, var_nam?: string | null) => VarGridDetail | null;
+    /**
+     * 根据 formID 获取系统的 VarGridDetail 列表, 即 customLevel 为 0 的 VarGridMaster 下面的所有 VarGridDetail.
+     */
+    getSystemVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
+    getVisibleVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
+    getVisibleVarGridDetailsTotalWidth(): (formID?: string | null) => number | null;
 }, {
     enter(formID: string): Promise<void>;
     leave(formID: string): void;
     retrieve(formID?: string | null): Promise<void>;
     setIsRetrieving(formID: string, value: boolean): void;
+    setIsCreating(formID: string, value: boolean): void;
+    setIsUpdating(formID: string, value: boolean): void;
+    setIsCopying(formID: string, value: boolean): void;
     setCurrentVarProfileMasterID(formID: string, currentVarProfileMasterID: string): void;
+    /**
+     * 设置列的宽度.
+     * @param formID 界面标识.
+     * @param var_nam 变量名称.
+     * @param width 新的宽度.
+     */
     setVarGridDetailWidth(formID: string, var_nam: string | null | undefined, width: number): void;
+    /**
+     * 设置列的可见.
+     * @param formID 界面标识.
+     * @param var_nam 变量名称.
+     * @param visible 是否科技.
+     */
+    setVarGridDetailVisible(formID: string, var_nam: string | null | undefined, visible: number): void;
     /**
      * 设置某个变量下拉列表配置.
      * @param formID 界面标识.

package/dist/src/components/index.d.ts

@@ -2,6 +2,7 @@ export * from './KgButton';
 export * from './KgControl';
 export * from './KgModal';
 export * from './KgProgressA';
+export * from './KgResizable';
 export * from './KgSearch';
 export * from './KgTable';
 export * from './KgVar';

package/dist/src/consts/i18n/en.d.ts

@@ -4,6 +4,7 @@ declare const _default: {
             title: string;
         };
         KgTable: {
+            column: string;
             emptyText: string;
             totalText: string;
         };

package/dist/src/consts/i18n/index.d.ts

@@ -5,6 +5,7 @@ export declare const KG_I18N: {
                 title: string;
             };
             KgTable: {
+                column: string;
                 emptyText: string;
                 totalText: string;
             };
@@ -48,6 +49,7 @@ export declare const KG_I18N: {
                 title: string;
             };
             KgTable: {
+                column: string;
                 emptyText: string;
                 totalText: string;
             };

package/dist/src/consts/i18n/zh_CN.d.ts

@@ -4,6 +4,7 @@ declare const _default: {
             title: string;
         };
         KgTable: {
+            column: string;
             emptyText: string;
             totalText: string;
         };

package/dist/src/consts/index.d.ts

@@ -40,6 +40,13 @@ export declare const enum KG_CONTROL_TYPE {
     /** 文件上传按钮. */
     BTN_UPLOAD = "BTN_UPLOAD"
 }
+/** 表单控件所处环境. */
+export declare const enum KG_CONTROL_CONTEXT {
+    /** 查询条件. */
+    PROFILE = "PROFILE",
+    /** 表单(创建/更新/复制/...). */
+    SUBMIT = "SUBMIT"
+}
 /** 表格单元格子显示类型. */
 export declare const enum KG_TD_DISPLAY_TYPE {
     /** 布尔数据, 使用 KgYesOrNo 组件显示. */

package/dist/src/utils/kg.util.d.ts

@@ -1,4 +1,5 @@
 import { ModalFuncProps } from 'ant-design-vue/lib/modal/Modal';
+import { Dayjs } from 'dayjs';
 /**
  * 通用工具.
  */
@@ -53,4 +54,13 @@ export declare class KgUtil {
      * 是否是表单验证错误.
      */
     static isFormValidateError(e: any): boolean;
+    /**
+     * 将值转换为 Dayjs 对象.
+     * @param value 值.
+     */
+    static toDayjs(value: any): Dayjs | undefined;
+    /** 显示全局遮罩. */
+    static showLoading(): void;
+    /** 隐藏全局遮罩. */
+    static hideLoading(): void;
 }

package/dist/src/utils/var.util.d.ts

@@ -7,5 +7,5 @@ export declare class KgVarUtil {
      * @param params JSON 字符串形式的参数.
      * @return 参数对象.
      */
-    static parseActionParameter(params?: string | null): Record<string, any>;
+    static parseCommandParameter(params?: string | null): Record<string, any>;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kengic/vue",
-    "version": "0.2.2-beta.8",
+    "version": "0.3.0",
     "scripts": {
         "build": "rimraf dist && vue-tsc && vite build",
         "build:dev": "rimraf dist && vue-tsc && vite build --mode development",
@@ -42,7 +42,7 @@
         "pinia": "2.0.12"
     },
     "devDependencies": {
-        "@kengic/pont": "1.2.10-beta.23",
+        "@kengic/pont": "1.2.10-beta.32",
         "@types/lodash-es": "~4.17.7",
         "@types/node": "~18.14.6",
         "@types/semver": "~7.3.13",