@kengic/vue 0.6.10-beta.1 → 0.6.10-beta.2

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

@@ -6,12 +6,14 @@ export declare type IUseKgAppSelect = {
     /**
      * 监听事件: 进入某个模块.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onGotoApp(cb: IKgAppSelectGotoAppCb): IRemoveEventListenerHandler;
+    onGotoApp(cb: IKgAppSelectGotoAppCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 进入某个地址.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onGotoPath(cb: IKgAppSelectGotoPathCb): IRemoveEventListenerHandler;
+    onGotoPath(cb: IKgAppSelectGotoPathCb, once?: boolean): IRemoveEventListenerHandler;
 };
 export declare function useKgAppSelect(): IUseKgAppSelect;

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

@@ -1,5 +1,5 @@
 import { StoreDefinition } from 'pinia';
-import { KG_APP, Menu } from '../../consts';
+import { IKgEventCb, KG_APP, Menu } from '../../consts';
 /**
  * 事件类型.
  *   'gotoApp':  进入某个模块
@@ -10,12 +10,12 @@ export declare type IKgAppSelectEvent = 'gotoApp' | 'gotoPath';
 export declare type IKgAppSelectGotoAppCbParam = {
     app: string;
 };
-export declare type IKgAppSelectGotoAppCb = (param: IKgAppSelectGotoAppCbParam) => Promise<boolean>;
+export declare type IKgAppSelectGotoAppCb = ((param: IKgAppSelectGotoAppCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: gotoPath. */
 export declare type IKgAppSelectGotoPathCbParam = {
     path: string;
 };
-export declare type IKgAppSelectGotoPathCb = (param: IKgAppSelectGotoPathCbParam) => Promise<boolean>;
+export declare type IKgAppSelectGotoPathCb = ((param: IKgAppSelectGotoPathCbParam) => Promise<boolean>) & IKgEventCb;
 export declare type IKgAppSelectCb = IKgAppSelectGotoAppCb | IKgAppSelectGotoPathCb;
 export interface KgAppSelectState {
     currentApp: KG_APP | null;

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

@@ -15,28 +15,33 @@ export declare type IUseKgButton = {
     /**
      * 监听事件: 点击按钮.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onClick(cb: IKgButtonClickCb): IRemoveEventListenerHandler;
+    onClick(cb: IKgButtonClickCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 点击更新按钮之后, 执行默认逻辑之前. 如果返回 Promise.resolve(true), 则不再执行后续的默认逻辑.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onUpdateBeforeClick(cb: IKgButtonUpdateBeforeClickCb): IRemoveEventListenerHandler;
+    onUpdateBeforeClick(cb: IKgButtonUpdateBeforeClickCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 删除成功, 删除接口调用成功.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onDeleteOk(cb: IKgButtonDeleteOkCb): IRemoveEventListenerHandler;
+    onDeleteOk(cb: IKgButtonDeleteOkCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 表格内编辑时, 点击保存按钮.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onSubmitSave(cb: IKgButtonSubmitSaveCb): IRemoveEventListenerHandler;
+    onSubmitSave(cb: IKgButtonSubmitSaveCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 表格内编辑时, 点击取消按钮.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onSubmitCancel(cb: IKgButtonSubmitCancelCb): IRemoveEventListenerHandler;
+    onSubmitCancel(cb: IKgButtonSubmitCancelCb, once?: boolean): IRemoveEventListenerHandler;
 };
 /**
  * @param formID 界面标识.

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

@@ -1,6 +1,6 @@
 import { StoreDefinition } from 'pinia';
 import { VarButton } from '../../apis/WMS/models';
-import { KG_BUTTON_TYPE } from '../../consts';
+import { IKgEventCb, KG_BUTTON_TYPE } from '../../consts';
 import { IKgTableRow } from '../KgTable';
 /**
  * 事件类型.
@@ -12,19 +12,19 @@ import { IKgTableRow } from '../KgTable';
  */
 export declare type IKgButtonEvent = 'click' | 'updateBeforeClick' | 'deleteOk' | 'submitSave' | 'submitCancel';
 /** 事件监听函数: click. */
-export declare type IKgButtonClickCb = (button: VarButton) => Promise<boolean>;
+export declare type IKgButtonClickCb = ((button: VarButton) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: updateBeforeClick. */
 export declare type IKgButtonUpdateBeforeClickCbParam = {
     button?: VarButton | null;
     row?: IKgTableRow | null;
 };
-export declare type IKgButtonUpdateBeforeClickCb = (args: IKgButtonUpdateBeforeClickCbParam) => Promise<boolean>;
+export declare type IKgButtonUpdateBeforeClickCb = ((args: IKgButtonUpdateBeforeClickCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: deleteOk. */
-export declare type IKgButtonDeleteOkCb = () => Promise<boolean>;
+export declare type IKgButtonDeleteOkCb = (() => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: submitSave. */
-export declare type IKgButtonSubmitSaveCb = () => Promise<boolean>;
+export declare type IKgButtonSubmitSaveCb = (() => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: submitCancel. */
-export declare type IKgButtonSubmitCancelCb = () => Promise<boolean>;
+export declare type IKgButtonSubmitCancelCb = (() => Promise<boolean>) & IKgEventCb;
 export declare type IKgButtonCb = IKgButtonClickCb | IKgButtonUpdateBeforeClickCb | IKgButtonDeleteOkCb | IKgButtonSubmitSaveCb | IKgButtonSubmitCancelCb;
 export interface IKgButtonState {
     clickListenersMap: Map<string, Array<IKgButtonClickCb>>;

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

@@ -7,13 +7,15 @@ export declare type IUseKgForm = {
     /**
      * 监听事件: 查找弹窗点击确定之前. 如果返回 true 则查找弹窗不会触发 kgOk 事件.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onLookupBeforeOk(cb: IKgFormLookupBeforeOkCb): IRemoveEventListenerHandler;
+    onLookupBeforeOk(cb: IKgFormLookupBeforeOkCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 查找弹窗点击确定.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onLookupOk(cb: IKgFormLookupOkCb): IRemoveEventListenerHandler;
+    onLookupOk(cb: IKgFormLookupOkCb, once?: boolean): IRemoveEventListenerHandler;
 };
 /**
  * @param formID 界面标识.

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

@@ -1,4 +1,5 @@
 import { StoreDefinition } from 'pinia';
+import { IKgEventCb } from '../../consts';
 import { IKgTableRow } from '../KgTable';
 /**
  * 事件类型.
@@ -21,7 +22,7 @@ export declare type IKgFormLookupBeforeOkCbParam = {
     /** 多选时, 勾选的所有行. */
     rows?: Array<IKgTableRow> | null;
 };
-export declare type IKgFormLookupBeforeOkCb = (param: IKgFormLookupBeforeOkCbParam) => Promise<boolean>;
+export declare type IKgFormLookupBeforeOkCb = ((param: IKgFormLookupBeforeOkCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: lookupOk. */
 export declare type IKgFormLookupOkCbParam = {
     /** 变量. */
@@ -37,7 +38,7 @@ export declare type IKgFormLookupOkCbParam = {
     /** 多选时, 勾选的所有行. */
     rows?: Array<IKgTableRow> | null;
 };
-export declare type IKgFormLookupOkCb = (param: IKgFormLookupOkCbParam) => Promise<boolean>;
+export declare type IKgFormLookupOkCb = ((param: IKgFormLookupOkCbParam) => Promise<boolean>) & IKgEventCb;
 export declare type IKgFormCb = IKgFormLookupBeforeOkCb | IKgFormLookupOkCb;
 export declare type IKgFormCbParam = IKgFormLookupBeforeOkCbParam | IKgFormLookupOkCbParam;
 export interface IKgFormState {

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

@@ -9,24 +9,29 @@ export declare type IUseKgSearch = {
     isReady: ComputedRef<ReturnType<IKgSearchStore['getIsReady']>>;
     /** 表单数据对象. */
     model: ComputedRef<ReturnType<IKgSearchStore['getModel']>>;
-    /** 执行查询. */
-    search: ComputedRef<ReturnType<IKgSearchStore['getSearchFn']>>;
+    /**
+     * 执行查询.
+     * @param resetPageIndex 是否从第一页开始查询.
+     */
+    search(resetPageIndex?: boolean): void;
     /** 执行重置. */
-    reset: ComputedRef<ReturnType<IKgSearchStore['getResetFn']>>;
+    reset(): void;
     /**
      * 监听事件: search, 点击查询按钮, 并且表单验证通过.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onSearch(cb: IKgSearchSearchCb): IRemoveEventListenerHandler;
+    onSearch(cb: IKgSearchSearchCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: reset, 点击重置按钮.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onReset(cb: IKgSearchResetCb): IRemoveEventListenerHandler;
+    onReset(cb: IKgSearchResetCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: ready, 查询字段初始完成, 查询组件渲染完成.
      * @param cb 回调函数.
-     * @param once 是否只会触发一次.
+     * @param once 是否只会触发一次. 默认为 undefined.
      * */
     onReady(cb: IKgSearchReadyCb, once?: boolean): IRemoveEventListenerHandler;
 };

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

@@ -1,4 +1,5 @@
 import { StoreDefinition } from 'pinia';
+import { IKgEventCb } from '../../consts';
 /**
  * 事件类型.
  *   'search': 点击查询按钮, 并且表单验证通过
@@ -12,16 +13,11 @@ export declare type IKgSearchEventParam = {
     resetPageIndex?: boolean;
 };
 /** 事件监听函数: search. */
-export declare type IKgSearchSearchCb = (resetPageIndex?: boolean) => void;
+export declare type IKgSearchSearchCb = ((resetPageIndex?: boolean) => void) & IKgEventCb;
 /** 事件监听函数: 'reset'. */
-export declare type IKgSearchResetCb = () => void;
+export declare type IKgSearchResetCb = ((param: any) => void) & IKgEventCb;
 /** 事件监听函数: 'ready'. */
-export declare type IKgSearchReadyCb = (() => void) & {
-    /** 是否只会触发一次. */
-    once?: boolean;
-    /** 是否已经触发过一次了. */
-    invoked?: boolean;
-};
+export declare type IKgSearchReadyCb = ((param: any) => void) & IKgEventCb;
 export declare type IKgSearchCb = IKgSearchSearchCb | IKgSearchResetCb | IKgSearchReadyCb;
 /** 查询方法. */
 export declare type IKgSearchSearchFn = (resetPageIndex?: boolean) => void;
@@ -72,7 +68,7 @@ export declare type IKgSearchStoreDefinition = StoreDefinition<'KgSearch', IKgSe
      * @param formID 界面标识.
      * @param model 要修改的查询字段和值.
      */
-    patchModel(formID: string, model: Record<string, any>): void;
+    patchModel(formID: string, model: Record<string, any>): Promise<void>;
     setSearchFn(formID?: string | null, fn?: IKgSearchSearchFn | null): void;
     setResetFn(formID?: string | null, fn?: IKgSearchResetFn | null): void;
 }>;

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

@@ -13,22 +13,40 @@ export declare type IUseKgSubmit = {
     rules: Ref<Record<string, Array<RuleObject>>>;
     /** 显示方式. */
     displayType: Ref<KG_VAR_SUBMIT__DISPLAY_TYPE>;
-    /** 监听事件: 打开弹窗. */
-    onOpen(cb: IKgSubmitOpenCb): IRemoveEventListenerHandler;
-    /** 监听事件: 点击保存按钮之后, 执行默认逻辑之前. 可以在此时修改表单的值; 可以在此时对表单的值进行验证, 如果返回 true 表示表单验证失败, 不会再执行后面的代码. */
-    onBeforeOk(cb: IKgSubmitBeforeOkCb): IRemoveEventListenerHandler;
-    /** 监听事件: 点击保存按钮之后, 表单验证成功. 如果返回 true, 不会再执行后面的代码. */
-    onAfterValidate(cb: IKgSubmitAfterValidateCb): IRemoveEventListenerHandler;
-    /** 监听事件: 发起请求之前. */
-    onBeforeRequest(cb: IKgSubmitBeforeRequestCb): IRemoveEventListenerHandler;
-    /** 监听事件: 点击保存按钮之后, 执行默认逻辑之后, 调用接口成功, 即将关闭弹窗. */
-    onOk(cb: IKgSubmitOkCb): IRemoveEventListenerHandler;
-    /** 监听事件: 请求失败. 请求失败了, 或者请求返回了错误消息. */
-    onError(cb: IKgSubmitErrorCb): IRemoveEventListenerHandler;
-    /** 监听事件: 关闭弹窗. 点击取消或者点击确定并且成功之后, 都会触发. */
-    onClose(cb: IKgSubmitCloseCb): IRemoveEventListenerHandler;
-    /** 监听事件: 查找弹窗点击确定. */
-    onLookupOk(cb: IKgSubmitLookupOkCb): IRemoveEventListenerHandler;
+    /**
+     * 监听事件: 打开弹窗.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     * */
+    onOpen(cb: IKgSubmitOpenCb, once?: boolean): IRemoveEventListenerHandler;
+    /**
+     * 监听事件: 点击保存按钮之后, 执行默认逻辑之前. 可以在此时修改表单的值; 可以在此时对表单的值进行验证, 如果返回 true 表示表单验证失败, 不会再执行后面的代码.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onBeforeOk(cb: IKgSubmitBeforeOkCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 点击保存按钮之后, 表单验证成功. 如果返回 true, 不会再执行后面的代码.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onAfterValidate(cb: IKgSubmitAfterValidateCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 发起请求之前.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onBeforeRequest(cb: IKgSubmitBeforeRequestCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 点击保存按钮之后, 执行默认逻辑之后, 调用接口成功, 即将关闭弹窗.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onOk(cb: IKgSubmitOkCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 请求失败. 请求失败了, 或者请求返回了错误消息.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onError(cb: IKgSubmitErrorCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 关闭弹窗. 点击取消或者点击确定并且成功之后, 都会触发.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onClose(cb: IKgSubmitCloseCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 查找弹窗点击确定.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onLookupOk(cb: IKgSubmitLookupOkCb, once?: boolean): IRemoveEventListenerHandler;
 };
 /**
  * @param formID 界面标识.

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

@@ -2,6 +2,7 @@ import { RuleObject } from 'ant-design-vue/es/form';
 import { FormInstance } from 'ant-design-vue/lib/form/Form';
 import { StoreDefinition } from 'pinia';
 import { Ref } from 'vue';
+import { IKgEventCb } from '../../consts';
 import { IKgTableRow } from '../KgTable';
 /**
  * 事件类型.
@@ -18,55 +19,63 @@ import { IKgTableRow } from '../KgTable';
 export declare type IKgSubmitEvent = 'open' | 'beforeOk' | 'afterValidate' | 'beforeRequest' | 'ok' | 'error' | 'close' | 'lookupBeforeOk' | 'lookupOk';
 /** 事件监听函数: open. */
 export declare type IKgSubmitOpenCbParam = {
-    isCreating: boolean;
-    isUpdating: boolean;
-    isCopying: boolean;
-    isDeleting: boolean;
+    isCreating: boolean | null;
+    isUpdating: boolean | null;
+    isCopying: boolean | null;
+    isDeleting: boolean | null;
     row: IKgTableRow | null;
     model: Ref<Record<string, any>>;
 };
-export declare type IKgSubmitOpenCb = (param: IKgSubmitOpenCbParam) => Promise<boolean>;
+export declare type IKgSubmitOpenCb = ((param: IKgSubmitOpenCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: beforeOk. */
 export declare type IKgSubmitBeforeOkCbParam = {
-    isCreating: boolean;
-    isUpdating: boolean;
-    isCopying: boolean;
-    isDeleting: boolean;
+    isCreating: boolean | null;
+    isUpdating: boolean | null;
+    isCopying: boolean | null;
+    isDeleting: boolean | null;
     row: IKgTableRow | null;
     rules: Ref<Record<string, RuleObject[]>>;
     model: Ref<Record<string, any>>;
 };
-export declare type IKgSubmitBeforeOkCb = (param: IKgSubmitBeforeOkCbParam) => Promise<boolean>;
+export declare type IKgSubmitBeforeOkCb = ((param: IKgSubmitBeforeOkCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: afterValidate. */
 export declare type IKgSubmitAfterValidateCbParam = {
-    isCreating: boolean;
-    isUpdating: boolean;
-    isCopying: boolean;
-    isDeleting: boolean;
+    isCreating: boolean | null;
+    isUpdating: boolean | null;
+    isCopying: boolean | null;
+    isDeleting: boolean | null;
     row: IKgTableRow | null;
     rows: Array<IKgTableRow> | null;
     model: Ref<Record<string, any>>;
 };
-export declare type IKgSubmitAfterValidateCb = (param: IKgSubmitAfterValidateCbParam) => Promise<boolean>;
+export declare type IKgSubmitAfterValidateCb = ((param: IKgSubmitAfterValidateCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: beforeRequest. */
 export declare type IKgSubmitBeforeRequestCbParam = {
-    isCreating: boolean;
-    isUpdating: boolean;
-    isCopying: boolean;
-    isDeleting: boolean;
+    isCreating: boolean | null;
+    isUpdating: boolean | null;
+    isCopying: boolean | null;
+    isDeleting: boolean | null;
     row: IKgTableRow | null;
     rows: Array<IKgTableRow> | null;
     model: Ref<Record<string, any>>;
     params: Ref<Record<string, any>>;
     data: Ref<Record<string, any>>;
 };
-export declare type IKgSubmitBeforeRequestCb = (param: IKgSubmitBeforeRequestCbParam) => Promise<boolean>;
+export declare type IKgSubmitBeforeRequestCb = ((param: IKgSubmitBeforeRequestCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: ok. */
-export declare type IKgSubmitOkCb = (param?: any | null) => Promise<boolean>;
+export declare type IKgSubmitOkCbParam = {
+    isCreating: boolean | null;
+    isUpdating: boolean | null;
+    isCopying: boolean | null;
+    isDeleting: boolean | null;
+    row: IKgTableRow | null;
+    model: Ref<Record<string, any>>;
+};
+export declare type IKgSubmitOkCb = ((param: IKgSubmitOkCbParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: error. */
-export declare type IKgSubmitErrorCb = (param: any) => Promise<boolean>;
+export declare type IKgSubmitErrorCb = ((param: any) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: close. */
-export declare type IKgSubmitCloseCb = (param?: any | null) => Promise<boolean>;
+export declare type IKgSubmitCloseCb = ((param?: any | null) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: lookupOk. */
 export declare type IKgSubmitLookupOkCbParam = {
     /** 变量. */
@@ -76,7 +85,8 @@ export declare type IKgSubmitLookupOkCbParam = {
     /** 多选时, 勾选的所有行. */
     rows: Array<IKgTableRow> | null;
 };
-export declare type IKgSubmitLookupOkCb = (param: IKgSubmitLookupOkCbParam) => Promise<boolean>;
+export declare type IKgSubmitLookupOkCb = ((param: IKgSubmitLookupOkCbParam) => Promise<boolean>) & IKgEventCb;
+export declare type IKgSubmitCbParam = IKgSubmitOpenCbParam | IKgSubmitBeforeOkCbParam | IKgSubmitAfterValidateCbParam | IKgSubmitBeforeRequestCbParam | IKgSubmitOkCbParam | IKgSubmitLookupOkCbParam | null;
 export declare type IKgSubmitCb = IKgSubmitOpenCb | IKgSubmitBeforeOkCb | IKgSubmitAfterValidateCb | IKgSubmitBeforeRequestCb | IKgSubmitOkCb | IKgSubmitErrorCb | IKgSubmitCloseCb | IKgSubmitLookupOkCb;
 export interface IKgSubmitState {
     openListenersMap: Map<string, Array<IKgSubmitOpenCb>>;
@@ -111,7 +121,7 @@ export declare type IKgSubmitStoreDefinition = StoreDefinition<'KgSubmit', IKgSu
      * @param event 事件名称.
      * @param param 数据.
      */
-    emit(formID: string, event: IKgSubmitEvent, param?: any | null): Promise<boolean>;
+    emit(formID: string, event: IKgSubmitEvent, param: IKgSubmitCbParam): Promise<boolean>;
     setIsLoading(formID: string, value: boolean): void;
     setModel(formID: string, model: Record<string, any>): void;
 }>;

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

@@ -29,12 +29,20 @@ export declare type IUseKgTable = {
     pageSizeOption: Ref<number>;
     /** 查询条件的界面标识. */
     profileFormID: Ref<string>;
-    /** 监听事件: 双击某行. */
-    onRowDoubleClick(cb: IKgTableRowDoubleClickCb): IRemoveEventListenerHandler;
-    /** 监听事件: 即将发起查询请求. */
-    onBeforeRetrieve(cb: IKgTableBeforeRetrieveCb): IRemoveEventListenerHandler;
-    /** 监听事件: 查询数据成功. */
-    onRetrieve(cb: IKgTableRetrieveCb): IRemoveEventListenerHandler;
+    /** 监听事件: 双击某行.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onRowDoubleClick(cb: IKgTableRowDoubleClickCb, once?: boolean): IRemoveEventListenerHandler;
+    /** 监听事件: 即将发起查询请求.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onBeforeRetrieve(cb: IKgTableBeforeRetrieveCb, once?: boolean): IRemoveEventListenerHandler;
+    /**
+     * 监听事件: 查询数据成功.
+     * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
+     */
+    onRetrieve(cb: IKgTableRetrieveCb, once?: boolean): IRemoveEventListenerHandler;
 };
 /**
  * @param formID 界面标识.

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

@@ -1,6 +1,8 @@
+import { Key } from 'ant-design-vue/lib/_util/type';
 import { StoreDefinition } from 'pinia';
 import { Ref } from 'vue';
 import { IPage } from '../../apis/WMS/models';
+import { IKgEventCb } from '../../consts';
 import { IKgTableRow } from './index.vm';
 /**
  * 事件类型.
@@ -10,15 +12,11 @@ import { IKgTableRow } from './index.vm';
  */
 export declare type IKgTableEvent = 'rowDoubleClick' | 'beforeRetrieve' | 'retrieve';
 /** 事件监听函数: rowDoubleClick. */
-export declare type IKgTableRowDoubleClickCb = (record: IKgTableRow) => Promise<boolean>;
-/** 事件监听函数: retrieve. */
-export declare type IKgTableRetrieveCbParam = {
-    /** 接口返回的分页数据. */
-    page: IPage<IKgTableRow> | undefined | null;
-    /** 经过处理之后的列表数据. */
-    datas: Ref<Array<IKgTableRow>>;
+export declare type IKgTableRowDoubleClickParam = {
+    /** 双击的行. */
+    row: IKgTableRow;
 };
-export declare type IKgTableRetrieveCb = (param: IKgTableRetrieveCbParam) => Promise<boolean>;
+export declare type IKgTableRowDoubleClickCb = ((param: IKgTableRowDoubleClickParam) => Promise<boolean>) & IKgEventCb;
 /** 事件监听函数: beforeRetrieve. */
 export declare type IKgTableBeforeRetrieveCbParam = {
     /** 查询接口请求参数. */
@@ -26,9 +24,20 @@ export declare type IKgTableBeforeRetrieveCbParam = {
     /** 查询接口返回的数据, 调用者可以直接修改该数据, 从而实现手动提供表格数据. */
     response: Ref;
 };
-export declare type IKgTableBeforeRetrieveCb = (param: IKgTableBeforeRetrieveCbParam) => Promise<boolean>;
+export declare type IKgTableBeforeRetrieveCb = ((param: IKgTableBeforeRetrieveCbParam) => Promise<boolean>) & IKgEventCb;
+/** 事件监听函数: retrieve. */
+export declare type IKgTableRetrieveCbParam = {
+    /** 接口返回的分页数据. */
+    page: IPage<IKgTableRow> | undefined | null;
+    /** 经过处理之后的列表数据. */
+    datas: Ref<Array<IKgTableRow>>;
+};
+export declare type IKgTableRetrieveCb = ((param: IKgTableRetrieveCbParam) => Promise<boolean>) & IKgEventCb;
+export declare type IKgTableCbParam = IKgTableRowDoubleClickParam | IKgTableBeforeRetrieveCbParam | IKgTableRetrieveCbParam;
 export declare type IKgTableCb = IKgTableRowDoubleClickCb | IKgTableBeforeRetrieveCb | IKgTableRetrieveCb;
 export interface IKgTableState {
+    /** 勾选的行的主键. */
+    selectedRowKeysMap: Map<string, Ref<Array<Key>>>;
     /** 勾选的行. */
     selectedRowsMap: Map<string, Array<IKgTableRow>>;
     /**
@@ -47,6 +56,8 @@ export interface IKgTableState {
     retrieveListenersMap: Map<string, Array<IKgTableRetrieveCb>>;
 }
 export declare type IKgTableStoreDefinition = StoreDefinition<'KgTable', IKgTableState, {
+    /** 当前勾选的所有行的主键. */
+    getSelectedRowKeys(): (formID?: string | null) => Ref<Array<Key>> | null;
     /** 当前勾选的所有行. */
     getSelectedRows(): (formID?: string | null) => Array<IKgTableRow> | null;
     /** 当前勾选的第一行. */
@@ -60,7 +71,7 @@ export declare type IKgTableStoreDefinition = StoreDefinition<'KgTable', IKgTabl
     dispose(formID?: string | null): void;
     addEventListener(formID: string, event: IKgTableEvent, cb: IKgTableCb): void;
     removeEventListener(formID: string, event: IKgTableEvent, cb?: IKgTableCb): void;
-    emit(formID: string, event: IKgTableEvent, param?: any | null): Promise<boolean>;
+    emit(formID: string, event: IKgTableEvent, param: IKgTableCbParam): Promise<boolean>;
     setSelectedRows(formID: string, selectedRows: Array<IKgTableRow>): void;
     /**
      * 设置某行的勾选状态.
@@ -68,7 +79,7 @@ export declare type IKgTableStoreDefinition = StoreDefinition<'KgTable', IKgTabl
      * @param row 行.
      * @param selected 是否勾选.
      */
-    setSelecte(formID: string, row: IKgTableRow, selected: boolean): void;
+    setRowSelect(formID: string, row: IKgTableRow, selected: boolean): void;
     setIsRetrieved(formID: string, value: boolean): void;
     setIsRetrieving(formID: string, value: boolean): void;
     setTableWidth(formID: string, value: number): void;

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

@@ -66,8 +66,9 @@ export declare type IUseKgVar = {
     /**
      * 监听事件: retrieve, 变量配置查询完成.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onRetrieve(cb: IKgVarRetrieveCb): IRemoveEventListenerHandler;
+    onRetrieve(cb: IKgVarRetrieveCb, once?: boolean): IRemoveEventListenerHandler;
     /** 翻译变量. */
     t: (var_nam?: string | null) => ComputedRef<string>;
 };

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

@@ -1,12 +1,13 @@
 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';
+import { IKgEventCb } from '../../consts';
 /**
  * 事件类型.
  *   'retrieve': 变量配置查询完成
  */
 export declare type IKgVarEvent = 'retrieve';
 /** 事件监听函数: 'retrieve'. */
-export declare type IKgVarRetrieveCb = () => void;
+export declare type IKgVarRetrieveCb = (() => void) & IKgEventCb;
 export declare type IKgVarCb = IKgVarRetrieveCb;
 export declare type IFormID = {
     formID: string;

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

@@ -11,8 +11,9 @@ export declare type IUseKgWarehouse = {
     /**
      * 监听事件: 组件加载完成.
      * @param cb 回调函数.
+     * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onMounted(cb: IKgWarehouseMountedCb): IRemoveEventListenerHandler;
+    onMounted(cb: IKgWarehouseMountedCb, once?: boolean): IRemoveEventListenerHandler;
 };
 /**
  * 在某些地方调用时(比如在路由守卫中), pinia 尚未设置, 此时需要手动传入 pinia 实例.

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

@@ -1,12 +1,13 @@
 import { Pinia, StoreDefinition } from 'pinia';
 import { WhDTO } from '../../apis/WMS/models';
+import { IKgEventCb } from '../../consts';
 /**
  * 事件类型.
  *   'mounted': 组件加载完成
  */
 export declare type IKgWarehouseEvent = 'mounted';
 /** 事件监听函数: mounted. */
-export declare type IKgWarehouseMountedCb = () => void;
+export declare type IKgWarehouseMountedCb = (() => void) & IKgEventCb;
 export declare type IKgWarehouseCb = IKgWarehouseMountedCb;
 export interface IKgWarehouseState {
     /** 弹窗是否显示. */

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

@@ -1,10 +1,9 @@
-import { IRemoveEventListenerHandler } from '../consts';
+import { IKgEventCb, 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;
@@ -12,4 +11,4 @@ export declare function onEventFactory<S extends {
 } | {
     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;
+} = any, E = any, C extends IKgEventCb = any>(frm_id: string | null, store: S, event: E): (cb: C) => IRemoveEventListenerHandler;

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

@@ -1,5 +1,11 @@
 /** 移除事件监听函数. */
 export declare type IRemoveEventListenerHandler = () => void;
+export declare type IKgEventCb = {
+    /** 是否只会触发一次. */
+    once?: boolean;
+    /** 是否已经触发过一次了. */
+    invoked?: boolean;
+};
 /** 菜单. */
 export interface Menu {
     id: string;

package/package.json

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