@kengic/vue 0.6.7 → 0.6.9

package/dist/src/components/KgForm.Item/index.vm.d.ts

@@ -5,7 +5,6 @@ import { Dayjs } from 'dayjs';
 import { ComputedRef, ExtractPropTypes, InjectionKey, PropType } from 'vue';
 import { VarProfileDetail, VarSubmitField, VarVariableConfig } from '../../apis/WMS/models';
 import { KG_FORM_CONTEXT } from '../../consts';
-import { IKgTableRow } from '../KgTable';
 export declare type IKgFormItemValue = string | number | Array<string | number>;
 export declare const getProps: () => {
     /** 变量名称. */
@@ -66,11 +65,6 @@ export declare const getProps: () => {
         default: undefined;
     };
     kgRules: PropType<RuleObject[]>;
-    /**
-     * 查找弹窗确定之前的回调函数, 如果返回 false, 则查找弹窗不会触发 kgOk 事件.
-     * 通常用于在弹窗确定之前, 对选择的数据进行校验, 如果校验失败, 则不允许确定, 需要重新选择数据.
-     */
-    onKgLookupBeforeOk: PropType<(value: any | Array<any>, record: IKgTableRow | Array<IKgTableRow>) => boolean>;
     value: PropType<IKgFormItemValue>;
     'onUpdate:value': PropType<(value: IKgFormItemValue | null) => void>;
     onKgSubmit: PropType<() => void>;
@@ -78,8 +72,6 @@ export declare const getProps: () => {
     onKgChange: PropType<(value: any | null) => void>;
     /** 下拉列表选中某个(可能多个)数据. */
     onKgSelectChange: PropType<(value: any | null) => void>;
-    /** 查找弹窗选中某个(可能多个)数据. */
-    onKgLookupChange: PropType<(value: any | null) => void>;
     /** 下拉列表数据发生变更. */
     onKgSelectDatasChange: PropType<(datas: Array<any>) => void>;
     /** 列表数据发生变更. */
@@ -95,7 +87,5 @@ export declare type IKgFormItemSlotControlParam = {
     varProfileDetail: VarProfileDetail;
     varSubmitField: VarSubmitField;
 };
-/** 依赖注入 onKgLookupBeforeOk 参数. */
-export declare const DI_ON_KG_LOOKUP_BEFORE_OK: InjectionKey<(value: any | Array<any>, record: IKgTableRow | Array<IKgTableRow>) => boolean>;
 /** 依赖注入 kgContext 参数. */
 export declare const DI_KG_CONTEXT: InjectionKey<string>;

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

@@ -5,6 +5,14 @@ export declare type IUseKgSearch = {
     formID: string;
     /** 状态数据. */
     store: IKgSearchStore;
+    /** 是否准备就绪. 即查询条件是否已经初始化完成了. */
+    isReady: ComputedRef<ReturnType<IKgSearchStore['getIsReady']>>;
+    /** 表单数据对象. */
+    model: ComputedRef<ReturnType<IKgSearchStore['getModel']>>;
+    /** 执行查询. */
+    search: ComputedRef<ReturnType<IKgSearchStore['getSearchFn']>>;
+    /** 执行重置. */
+    reset: ComputedRef<ReturnType<IKgSearchStore['getResetFn']>>;
     /**
      * 监听事件: search, 点击查询按钮, 并且表单验证通过.
      * @param cb 回调函数.
@@ -21,14 +29,6 @@ export declare type IUseKgSearch = {
      * @param once 是否只会触发一次.
      * */
     onReady(cb: IKgSearchReadyCb, once?: boolean): IRemoveEventListenerHandler;
-    /** 是否准备就绪. 即查询条件是否已经初始化完成了. */
-    isReady: ComputedRef<ReturnType<IKgSearchStore['getIsReady']>>;
-    /** 表单数据对象. */
-    model: ComputedRef<ReturnType<IKgSearchStore['getModel']>>;
-    /** 执行查询. */
-    search: ComputedRef<ReturnType<IKgSearchStore['getSearchFn']>>;
-    /** 执行重置. */
-    reset: ComputedRef<ReturnType<IKgSearchStore['getResetFn']>>;
 };
 /**
  * @param formID 界面标识.

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

@@ -2,7 +2,7 @@ import { RuleObject } from 'ant-design-vue/es/form';
 import { FormInstance } from 'ant-design-vue/lib/form/Form';
 import { Ref } from 'vue';
 import { IRemoveEventListenerHandler, KG_VAR_SUBMIT__DISPLAY_TYPE } from '../../consts';
-import { IKgSubmitAfterValidateCb, IKgSubmitBeforeOkCb, IKgSubmitBeforeRequestCb, IKgSubmitCloseCb, IKgSubmitErrorCb, IKgSubmitOkCb, IKgSubmitOpenCb, IKgSubmitStore } from './index.store';
+import { IKgSubmitAfterValidateCb, IKgSubmitBeforeOkCb, IKgSubmitBeforeRequestCb, IKgSubmitCloseCb, IKgSubmitErrorCb, IKgSubmitLookupOkCb, IKgSubmitOkCb, IKgSubmitOpenCb, IKgSubmitStore } from './index.store';
 export declare type IUseKgSubmit = {
     formID: string;
     /** 状态数据. */
@@ -27,6 +27,8 @@ export declare type IUseKgSubmit = {
     onError(cb: IKgSubmitErrorCb): IRemoveEventListenerHandler;
     /** 监听事件: 关闭弹窗. 点击取消或者点击确定并且成功之后, 都会触发. */
     onClose(cb: IKgSubmitCloseCb): IRemoveEventListenerHandler;
+    /** 监听事件: 查找弹窗点击确定. */
+    onLookupOk(cb: IKgSubmitLookupOkCb): IRemoveEventListenerHandler;
 };
 /**
  * @param formID 界面标识.

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

@@ -5,15 +5,17 @@ import { Ref } from 'vue';
 import { IKgTableRow } from '../KgTable';
 /**
  * 事件类型.
- *   'open':          打开弹窗
- *   'beforeOk':      点击保存按钮之后, 执行默认逻辑之前
- *   'afterValidate': 表单验证成功
- *   'beforeRequest': 发起请求之前
- *   'ok':            请求成功, 即将关闭弹窗
- *   'error':         请求失败. 请求失败了, 或者请求返回了错误消息
- *   'close':         关闭弹窗
+ *   'open':           打开弹窗
+ *   'beforeOk':       点击保存按钮之后, 执行默认逻辑之前
+ *   'afterValidate':  表单验证成功
+ *   'beforeRequest':  发起请求之前
+ *   'ok':             请求成功, 即将关闭弹窗
+ *   'error':          请求失败. 请求失败了, 或者请求返回了错误消息
+ *   'close':          关闭弹窗
+ *   'lookupBeforeOk': 查找弹窗点击确定之前. 如果返回 true 则查找弹窗不会触发 kgOk 事件
+ *   'lookupOk':       查找弹窗点击确定
  */
-export declare type IKgSubmitEvent = 'open' | 'close' | 'beforeOk' | 'afterValidate' | 'beforeRequest' | 'ok' | 'error';
+export declare type IKgSubmitEvent = 'open' | 'beforeOk' | 'afterValidate' | 'beforeRequest' | 'ok' | 'error' | 'close' | 'lookupBeforeOk' | 'lookupOk';
 /** 事件监听函数: open. */
 export declare type IKgSubmitOpenCbParam = {
     isCreating: boolean;
@@ -24,8 +26,6 @@ export declare type IKgSubmitOpenCbParam = {
     model: Ref<Record<string, any>>;
 };
 export declare type IKgSubmitOpenCb = (param: IKgSubmitOpenCbParam) => Promise<boolean>;
-/** 事件监听函数: close. */
-export declare type IKgSubmitCloseCb = (param?: any | null) => Promise<boolean>;
 /** 事件监听函数: beforeOk. */
 export declare type IKgSubmitBeforeOkCbParam = {
     isCreating: boolean;
@@ -65,15 +65,28 @@ export declare type IKgSubmitBeforeRequestCb = (param: IKgSubmitBeforeRequestCbP
 export declare type IKgSubmitOkCb = (param?: any | null) => Promise<boolean>;
 /** 事件监听函数: error. */
 export declare type IKgSubmitErrorCb = (param: any) => Promise<boolean>;
-export declare type IKgSubmitCb = IKgSubmitOpenCb | IKgSubmitCloseCb | IKgSubmitBeforeOkCb | IKgSubmitAfterValidateCb | IKgSubmitBeforeRequestCb | IKgSubmitOkCb | IKgSubmitErrorCb;
+/** 事件监听函数: close. */
+export declare type IKgSubmitCloseCb = (param?: any | null) => Promise<boolean>;
+/** 事件监听函数: lookupOk. */
+export declare type IKgSubmitLookupOkCbParam = {
+    /** 变量. */
+    var_nam: string;
+    /** 单选时, 勾选的那一行. */
+    row: IKgTableRow | null;
+    /** 多选时, 勾选的所有行. */
+    rows: Array<IKgTableRow> | null;
+};
+export declare type IKgSubmitLookupOkCb = (param: IKgSubmitLookupOkCbParam) => Promise<boolean>;
+export declare type IKgSubmitCb = IKgSubmitOpenCb | IKgSubmitBeforeOkCb | IKgSubmitAfterValidateCb | IKgSubmitBeforeRequestCb | IKgSubmitOkCb | IKgSubmitErrorCb | IKgSubmitCloseCb | IKgSubmitLookupOkCb;
 export interface IKgSubmitState {
     openListenersMap: Map<string, Array<IKgSubmitOpenCb>>;
-    closeListenersMap: Map<string, Array<IKgSubmitCloseCb>>;
     beforeOkListenersMap: Map<string, Array<IKgSubmitBeforeOkCb>>;
     afterValidateListenersMap: Map<string, Array<IKgSubmitAfterValidateCb>>;
     beforeRequestListenersMap: Map<string, Array<IKgSubmitBeforeRequestCb>>;
     okListenersMap: Map<string, Array<IKgSubmitOkCb>>;
     errorListenersMap: Map<string, Array<IKgSubmitErrorCb>>;
+    closeListenersMap: Map<string, Array<IKgSubmitCloseCb>>;
+    lookupOkListenersMap: Map<string, Array<IKgSubmitLookupOkCb>>;
     isLoadingMap: Map<string, boolean>;
     /** 表单数据对象. */
     modelMap: Map<string, Record<string, any>>;

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

@@ -6,7 +6,7 @@ import { IKgTableRow } from './index.vm';
  * 事件类型.
  *   'rowDoubleClick': 双击某行
  *   'beforeRetrieve': 即将发起查询请求
- *   'retrieve':       查询数据成功
+ *   'retrieve':       表格数据查询完成
  */
 export declare type IKgTableEvent = 'rowDoubleClick' | 'beforeRetrieve' | 'retrieve';
 /** 事件监听函数: rowDoubleClick. */

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

@@ -143,4 +143,4 @@ export declare const KG_TABLE_TD_CHECK_WIDTH = 32;
 /** 序号列的宽度. */
 export declare const KG_TABLE_TD_INDEX_WIDTH = 40;
 /** 在表格内创建时, 空白行的临时主键. */
-export declare const KG_TABLE_TEMP_ID = "__KG_TABLE_TEMP_ID";
+export declare const KG_TABLE_TEMP_ID = "__KG_TABLE_TEMP_ID__";

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

@@ -1,7 +1,7 @@
 import { ComputedRef } from 'vue';
 import { VarProfileDetail } from '../../apis/WMS/models';
 import { IRemoveEventListenerHandler } from '../../consts';
-import { IKgVarReadyCb, IKgVarStore } from './index.store';
+import { IKgVarRetrieveCb, IKgVarStore } from './index.store';
 export declare type IUseKgVar = {
     /** 界面标识. */
     formID: string;
@@ -55,12 +55,21 @@ export declare type IUseKgVar = {
     systemVarGridDetails: ComputedRef<ReturnType<IKgVarStore['getSystemVarGridDetails']>>;
     /** 当前的 VarGridDetail 列表. */
     currentVarGridDetails: ComputedRef<ReturnType<IKgVarStore['getCurrentVarGridDetails']>>;
-    t: (var_nam?: string | null) => ComputedRef<string>;
+    /** 设置'正在创建'. */
+    setIsCreating(value: boolean): void;
+    /** 设置'正在更新'. */
+    setIsUpdating(value: boolean): void;
+    /** 设置'正在复制'. */
+    setIsCopying(value: boolean): void;
+    /** 设置'正在删除'. */
+    setIsDeleting(value: boolean): void;
     /**
-     * 监听事件: ready, 变量配置查询完成.
+     * 监听事件: retrieve, 变量配置查询完成.
      * @param cb 回调函数.
-     * */
-    onReady(cb: IKgVarReadyCb): IRemoveEventListenerHandler;
+     */
+    onRetrieve(cb: IKgVarRetrieveCb): IRemoveEventListenerHandler;
+    /** 翻译变量. */
+    t: (var_nam?: string | null) => ComputedRef<string>;
 };
 /**
  * 启用变量.

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

@@ -2,12 +2,12 @@ import { type StoreDefinition } from 'pinia';
 import { VarButton, VarButtonConfig, VarCatalog, VarGridConfig, VarGridDetail, VarGridDTO, VarGridMasterDTO, VarLookup, VarPossibility, VarProfileConfig, VarProfileDetail, VarProfileDTO, VarProfileMasterDTO, VarSubmitConfig, VarSubmitField, VarVariableConfig, VarVariableInput } from '../../apis/WMS/models';
 /**
  * 事件类型.
- *   'ready': 变量配置查询完成.
+ *   'retrieve': 变量配置查询完成
  */
-export declare type IKgVarEvent = 'ready';
-/** 事件监听函数: 'ready'. */
-export declare type IKgVarReadyCb = () => void;
-export declare type IKgVarCb = IKgVarReadyCb;
+export declare type IKgVarEvent = 'retrieve';
+/** 事件监听函数: 'retrieve'. */
+export declare type IKgVarRetrieveCb = () => void;
+export declare type IKgVarCb = IKgVarRetrieveCb;
 export declare type IFormID = {
     formID: string;
     /**
@@ -27,7 +27,9 @@ export interface IKgVarState {
      */
     formIDs: Array<IFormID>;
     /** 正在查询变量配置. */
-    isRetrievingVarMap: Map<string, boolean>;
+    isRetrievingMap: Map<string, boolean>;
+    /** 变量配置查询完成. */
+    isRetrievedMap: Map<string, boolean>;
     /** 正在查询 VarProfileMaster. */
     isRetrievingVarProfileMasterMap: Map<string, boolean>;
     /** 正在查询 VarGridMaster. */
@@ -71,195 +73,189 @@ export interface IKgVarState {
         /** 当前表格视图. */
         currentVarGridMasterID: string | null;
     }>;
-    /** 事件监听函数列表: ready. */
-    onReadyListenersMap: Map<string, Array<IKgVarReadyCb>>;
+    /** 事件监听函数列表: retrieve. */
+    onRetrieveListenersMap: Map<string, Array<IKgVarRetrieveCb>>;
 }
 export declare type IKgVarStoreDefinition = StoreDefinition<'KgVar', IKgVarState, {
     /** 获取最顶层的界面标识, 即 level 最大的界面, 可能包含多个. */
     getTopFormIDs(): Array<string>;
     /** 获取界面层级. */
-    getFormLevel(): (formID?: string | null) => number;
-    isRetrieving(): (formID?: string | null) => boolean | null;
-    isRetrievingVarProfileMaster(): (formID?: string | null) => boolean | null;
-    isRetrievingVarGridMaster(): (formID?: string | null) => boolean | null;
-    isCreating(): (formID?: string | null) => boolean | null;
-    isUpdating(): (formID?: string | null) => boolean | null;
-    isCopying(): (formID?: string | null) => boolean | null;
-    isDeleting(): (formID?: string | null) => boolean | null;
-    isCreatingRequesting(): (formID?: string | null) => boolean | null;
-    isUpdatingRequesting(): (formID?: string | null) => boolean | null;
-    isCopyingRequesting(): (formID?: string | null) => boolean | null;
-    isDeletingRequesting(): (formID?: string | null) => boolean | null;
-    isOtherRequesting(): (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;
-    getVarVariableConfig(): (formID?: string | null, var_nam?: string | null) => VarVariableConfig | null;
-    getVarVariableInput(): (formID?: string | null, var_nam?: string | null) => VarVariableInput | null;
-    getVarButtons(): (formID?: string | null) => Array<VarButton> | null;
-    getVarSubmitConfig(): (formID?: string | null) => VarSubmitConfig | null;
+    getFormLevel(): (frm_id?: string | null) => number;
+    isRetrieving(): (frm_id?: string | null) => boolean | null;
+    isRetrievingVarProfileMaster(): (frm_id?: string | null) => boolean | null;
+    isRetrievingVarGridMaster(): (frm_id?: string | null) => boolean | null;
+    isCreating(): (frm_id?: string | null) => boolean | null;
+    isUpdating(): (frm_id?: string | null) => boolean | null;
+    isCopying(): (frm_id?: string | null) => boolean | null;
+    isDeleting(): (frm_id?: string | null) => boolean | null;
+    isCreatingRequesting(): (frm_id?: string | null) => boolean | null;
+    isUpdatingRequesting(): (frm_id?: string | null) => boolean | null;
+    isCopyingRequesting(): (frm_id?: string | null) => boolean | null;
+    isDeletingRequesting(): (frm_id?: string | null) => boolean | null;
+    isOtherRequesting(): (frm_id?: string | null) => boolean | null;
+    getVarCatalogs(): (frm_id?: string | null) => Array<VarCatalog> | null;
+    getVarCatalog(): (frm_id?: string | null, var_nam?: string | null) => VarCatalog | null;
+    getVarLookup(): (frm_id?: string | null, var_nam?: string | null) => VarLookup | null;
+    getVarPossibility(): (frm_id?: string | null, var_nam?: string | null) => VarPossibility | null;
+    getVarVariableConfig(): (frm_id?: string | null, var_nam?: string | null) => VarVariableConfig | null;
+    getVarVariableInput(): (frm_id?: string | null, var_nam?: string | null) => VarVariableInput | null;
+    getVarButtons(): (frm_id?: string | null) => Array<VarButton> | null;
+    getVarSubmitConfig(): (frm_id?: string | null) => VarSubmitConfig | null;
     /** 获取所有提交字段. */
-    getVarSubmitFields(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFields(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取创建时的提交字段. */
-    getVarSubmitFieldsForCreate(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForCreate(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取创建时的提交字段: 关键字段. */
-    getVarSubmitFieldsForCreateKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForCreateKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取创建时的提交字段: 不是关键字段. */
-    getVarSubmitFieldsForCreateNotKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForCreateNotKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取更新时的提交字段. */
-    getVarSubmitFieldsForUpdate(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForUpdate(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取更新时的提交字段: 关键字段. */
-    getVarSubmitFieldsForUpdateKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForUpdateKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取更新时的提交字段: 不是关键字段. */
-    getVarSubmitFieldsForUpdateNotKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForUpdateNotKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取复制时的提交字段. */
-    getVarSubmitFieldsForCopy(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForCopy(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取复制时的提交字段: 关键字段. */
-    getVarSubmitFieldsForCopyKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForCopyKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取复制时的提交字段: 不是关键字段. */
-    getVarSubmitFieldsForCopyNotKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForCopyNotKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取删除时的提交字段. */
-    getVarSubmitFieldsForDelete(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForDelete(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取删除时的提交字段: 关键字段. */
-    getVarSubmitFieldsForDeleteKey(): (formID?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitFieldsForDeleteKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
     /** 获取删除时的提交字段: 不是关键字段. */
-    getVarSubmitFieldsForDeleteNotKey(): (formID?: string | null) => Array<VarSubmitField> | null;
-    getVarSubmitField(): (formID?: string | null, var_nam?: string | null) => VarSubmitField | null;
-    getVarButton(): (formID?: string | null, var_nam?: string | null) => VarButton | null;
-    getVarButtonConfig(): (formID?: string | null) => VarButtonConfig | null;
-    getVarButtonSearch(): (formID?: string | null) => VarButton | null;
-    getVarButtonCreate(): (formID?: string | null) => VarButton | null;
-    getVarButtonUpdate(): (formID?: string | null) => VarButton | null;
-    getVarButtonCopy(): (formID?: string | null) => VarButton | null;
-    getVarButtonDelete(): (formID?: string | null) => VarButton | null;
-    getVarProfileConfig(): (formID?: string | null) => VarProfileConfig | null;
-    getVarProfileMasters(): (formID?: string | null) => Array<VarProfileMasterDTO> | null;
-    getVarProfileDetail(): (formID?: string | null, var_nam?: string | null) => VarProfileDetail | null;
+    getVarSubmitFieldsForDeleteNotKey(): (frm_id?: string | null) => Array<VarSubmitField> | null;
+    getVarSubmitField(): (frm_id?: string | null, var_nam?: string | null) => VarSubmitField | null;
+    getVarButton(): (frm_id?: string | null, var_nam?: string | null) => VarButton | null;
+    getVarButtonConfig(): (frm_id?: string | null) => VarButtonConfig | null;
+    getVarButtonSearch(): (frm_id?: string | null) => VarButton | null;
+    getVarButtonCreate(): (frm_id?: string | null) => VarButton | null;
+    getVarButtonUpdate(): (frm_id?: string | null) => VarButton | null;
+    getVarButtonCopy(): (frm_id?: string | null) => VarButton | null;
+    getVarButtonDelete(): (frm_id?: string | null) => VarButton | null;
+    getVarProfileConfig(): (frm_id?: string | null) => VarProfileConfig | null;
+    getVarProfileMasters(): (frm_id?: string | null) => Array<VarProfileMasterDTO> | null;
+    getVarProfileDetail(): (frm_id?: string | null, var_nam?: string | null) => VarProfileDetail | null;
     /**
-     * 根据 formID 获取 VarProfileDetail 列表.
+     * 根据 frm_id 获取 VarProfileDetail 列表.
      */
-    getVarProfileDetails(): (formID?: string | null) => Array<VarProfileDetail> | null;
+    getVarProfileDetails(): (frm_id?: string | null) => Array<VarProfileDetail> | null;
     /**
-     * 根据 formID 获取系统的 VarProfileDetail 列表, 即 customLevel 为 0 的 VarProfileMaster 下面的所有 VarProfileDetail.
+     * 根据 frm_id 获取系统的 VarProfileDetail 列表, 即 customLevel 为 0 的 VarProfileMaster 下面的所有 VarProfileDetail.
      */
-    getSystemVarProfileDetails(): (formID?: string | null) => Array<VarProfileDetail> | null;
-    getCurrentVarProfileMaster(): (formID?: string | null) => VarProfileMasterDTO | null;
-    getCurrentVarProfileMasterID(): (formID?: string | null) => string | null;
+    getSystemVarProfileDetails(): (frm_id?: string | null) => Array<VarProfileDetail> | null;
+    getCurrentVarProfileMaster(): (frm_id?: string | null) => VarProfileMasterDTO | null;
+    getCurrentVarProfileMasterID(): (frm_id?: string | null) => string | null;
     /** 获取所有的 VarGridConfig. */
     getVarGridConfigMap(): Map<string, VarGridConfig | null>;
-    getVarGridConfig(): (formID?: string | null) => VarGridConfig | null;
-    getVarGridMasters(): (formID?: string | null) => Array<VarGridMasterDTO> | null;
-    getVarGridDetail(): (formID?: string | null, var_nam?: string | null) => VarGridDetail | null;
-    /** 根据 formID 获取当前的 VarGridMaster. */
-    getCurrentVarGridMaster(): (formID?: string | null) => VarGridMasterDTO | null;
-    getCurrentVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
+    getVarGridConfig(): (frm_id?: string | null) => VarGridConfig | null;
+    getVarGridMasters(): (frm_id?: string | null) => Array<VarGridMasterDTO> | null;
+    getVarGridDetail(): (frm_id?: string | null, var_nam?: string | null) => VarGridDetail | null;
+    /** 根据 frm_id 获取当前的 VarGridMaster. */
+    getCurrentVarGridMaster(): (frm_id?: string | null) => VarGridMasterDTO | null;
+    getCurrentVarGridDetails(): (frm_id?: string | null) => Array<VarGridDetail> | null;
     /**
-     * 根据 formID 获取系统的 VarGridDetail 列表, 即 customLevel 为 0 的 VarGridMaster 下面的所有 VarGridDetail.
+     * 根据 frm_id 获取系统的 VarGridDetail 列表, 即 customLevel 为 0 的 VarGridMaster 下面的所有 VarGridDetail.
      */
-    getSystemVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
-    getCurrentVisibleVarGridDetails(): (formID?: string | null) => Array<VarGridDetail> | null;
-    getCurrentVisibleVarGridDetailsTotalWidth(): (formID?: string | null) => number | null;
+    getSystemVarGridDetails(): (frm_id?: string | null) => Array<VarGridDetail> | null;
+    getCurrentVisibleVarGridDetails(): (frm_id?: string | null) => Array<VarGridDetail> | null;
+    getCurrentVisibleVarGridDetailsTotalWidth(): (frm_id?: string | null) => number | null;
 }, {
     /**
      * 注册事件监听.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param event 事件名称.
      * @param cb 回调函数.
      */
-    addEventListener(formID: string, event: IKgVarEvent, cb: IKgVarCb): void;
+    addEventListener(frm_id: string, event: IKgVarEvent, cb: IKgVarCb): void;
     /**
      * 退订事件监听.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param event 事件名称.
      * @param cb 回调函数.
      */
-    removeEventListener(formID: string, event: IKgVarEvent, cb?: IKgVarCb): void;
+    removeEventListener(frm_id: string, event: IKgVarEvent, cb?: IKgVarCb): void;
     /**
      * 触发事件.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param event 事件名称.
      * @param args 事件参数.
      */
-    emit(formID: string, event: IKgVarEvent, args?: any): void;
-    enter(formID: IFormID): Promise<void>;
-    leave(formID: string): void;
-    retrieve(formID?: string | null): Promise<void>;
-    setIsCreating(formID: string, value: boolean): void;
+    emit(frm_id: string, event: IKgVarEvent, args?: any): void;
+    enter(frm_id: IFormID): Promise<void>;
+    leave(frm_id: string): void;
+    retrieve(frm_id?: string | null): Promise<void>;
+    setIsCreating(frm_id: string, value: boolean): void;
     /**
      *
-     * @param formID
+     * @param frm_id
      * @param value
      * @param whenReady 是否等待变量配置数据加载完成.
      */
-    setIsUpdating(formID: string, value: boolean, whenReady?: boolean): void;
-    setIsCopying(formID: string, value: boolean): void;
-    setIsDeleting(formID: string, deleting: boolean): void;
-    setIsCreatingRequesting(formID: string, value: boolean): void;
-    setIsUpdatingRequesting(formID: string, value: boolean): void;
-    setIsCopyingRequesting(formID: string, value: boolean): void;
-    setIsDeletingRequesting(formID: string, deleting: boolean): void;
-    setIsOtherRequesting(formID: string, deleting: boolean): void;
+    setIsUpdating(frm_id: string, value: boolean, whenReady?: boolean): void;
+    setIsCopying(frm_id: string, value: boolean): void;
+    setIsDeleting(frm_id: string, deleting: boolean): void;
+    setIsCreatingRequesting(frm_id: string, value: boolean): void;
+    setIsUpdatingRequesting(frm_id: string, value: boolean): void;
+    setIsCopyingRequesting(frm_id: string, value: boolean): void;
+    setIsDeletingRequesting(frm_id: string, deleting: boolean): void;
+    setIsOtherRequesting(frm_id: string, deleting: boolean): void;
     /**
      * 设置当前选择的查询条件的 ID.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param currentVarProfileMasterID 当前选择的查询条件的 ID.
      */
-    setCurrentVarProfileMasterID(formID: string, currentVarProfileMasterID: string): Promise<void>;
+    setCurrentVarProfileMasterID(frm_id: string, currentVarProfileMasterID: string): Promise<void>;
     /**
      * 设置查询字段是否启用.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param var_nam 变量名称.
      * @param enable 是否启用.
      */
-    setVarProfileDetailEnable(formID: string, var_nam: string | null | undefined, enable: number): void;
-    /**
-     * 设置查询条件是否显示.
-     * @param formID 界面标识.
-     * @param visible 是否显示
-     */
-    setVarProfileConfigVisible(formID: string, visible: boolean): void;
+    setVarProfileDetailEnable(frm_id: string, var_nam: string | null | undefined, enable: number): void;
     /**
      * 设置当前选择的表格视图的 ID.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param currentVarGridMasterID 当前选择的表格视图的 ID.
      */
-    setCurrentVarGridMasterID(formID: string, currentVarGridMasterID: string): Promise<void>;
+    setCurrentVarGridMasterID(frm_id: string, currentVarGridMasterID: string): Promise<void>;
     /**
      * 设置列的宽度.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param var_nam 变量名称.
      * @param width 新的宽度.
      */
-    setVarGridDetailWidth(formID: string, var_nam: string | null | undefined, width: number): void;
+    setVarGridDetailWidth(frm_id: string, var_nam: string | null | undefined, width: number): void;
     /**
-     * 设置列的可见.
-     * @param formID 界面标识.
+     * 修改 VarGridDetail 的部分属性.
+     * @param frm_id 界面标识.
      * @param var_nam 变量名称.
-     * @param visible 是否可见.
+     * @param properties 要修改的属性.
      */
-    setVarGridDetailVisible(formID: string, var_nam: string | null | undefined, visible: number): void;
+    patchVarGridDetail(frm_id: string, var_nam: string | null | undefined, properties: VarGridDetail): void;
     /**
      * 设置某个 VarPossibility 配置.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param var_nam 变量名称
      * @param varPossibility 配置.
      */
-    setVarPossibility(formID: string | null | undefined, var_nam: string | null | undefined, varPossibility: VarPossibility): void;
+    setVarPossibility(frm_id: string | null | undefined, var_nam: string | null | undefined, varPossibility: VarPossibility): void;
     /**
      * 修改 VarSubmitField 的部分属性.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param var_nam 变量名称
      * @param properties 要修改的属性.
      */
-    patchVarSubmitField(formID: string | null | undefined, var_nam: string | null | undefined, properties: VarSubmitField): void;
+    patchVarSubmitField(frm_id: string | null | undefined, var_nam: string | null | undefined, properties: VarSubmitField): void;
     /**
      * 修改 VarPossibility 的接口参数 cmd_prm 的部分属性.
-     * @param formID 界面标识.
+     * @param frm_id 界面标识.
      * @param var_nam 变量名称
      * @param properties 要修改的属性.
      */
-    patchVarPossibilityCommandParameter(formID: string | null | undefined, var_nam: string | null | undefined, properties: Record<string, any>): void;
+    patchVarPossibilityCommandParameter(frm_id: string | null | undefined, var_nam: string | null | undefined, properties: Record<string, any>): void;
 }>;
 export declare type IKgVarStore = ReturnType<IKgVarStoreDefinition>;
 export declare const useKgVarStore: () => IKgVarStoreDefinition;

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

@@ -8,7 +8,10 @@ export declare type IUseKgWarehouse = {
     visible: ComputedRef<boolean>;
     /** 当前仓库. */
     warehouse: ComputedRef<WhDTO | null>;
-    /** 监听事件: 组件加载完成. */
+    /**
+     * 监听事件: 组件加载完成.
+     * @param cb 回调函数.
+     */
     onMounted(cb: IKgWarehouseMountedCb): IRemoveEventListenerHandler;
 };
 /**

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

@@ -0,0 +1,15 @@
+import { IRemoveEventListenerHandler } from '../consts';
+/**
+ * 构造事件监听.
+ * @param frm_id 界面标识.
+ * @param store 状态管理.
+ * @param event 事件名称.
+ * @param once 是否只会触发一次.
+ */
+export declare function onEventFactory<S extends {
+    addEventListener(frm_id: string, event: E, cb: C): void;
+    removeEventListener(frm_id: string, event: E, cb?: C): void;
+} | {
+    addEventListener(event: E, cb: C): void;
+    removeEventListener(event: E, cb?: C): void;
+} = any, E = any, C = any>(frm_id: string | null, store: S, event: E, once?: boolean): (cb: C) => IRemoveEventListenerHandler;

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

@@ -1,4 +1,4 @@
-/** 移除监听函数. */
+/** 移除事件监听函数. */
 export declare type IRemoveEventListenerHandler = () => void;
 /** 菜单. */
 export interface Menu {

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

@@ -1,7 +1,7 @@
 /**
  * 日志服务.
  */
-declare class Logger {
+declare class KgLogger {
     /**
      * 打印错误日志.
      *
@@ -45,4 +45,4 @@ declare class Logger {
      */
     static debug(message: string, args?: Record<string, any>, collapsed?: boolean): void;
 }
-export { Logger };
+export { KgLogger };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kengic/vue",
-    "version": "0.6.7",
+    "version": "0.6.9",
     "scripts": {
         "build": "rimraf dist && vue-tsc && vite build",
         "build:dev": "rimraf dist && vue-tsc && vite build --mode development",