@kengic/vue 0.21.5-beta.2 → 0.22.1-beta.0

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

@@ -1,57 +1,20 @@
-import { KG_BUTTON_TYPE } from '../../consts';
-import { IKgButtonClickCb, IKgButtonDeleteOkCb, IKgButtonEvent, IKgButtonImportOkCb, IKgButtonOtherOkCb, IKgButtonUpdateBeforeClickCb } from './index.store';
-/**
- * @param formID 界面标识.
- */
-export declare function useKgButton(formID?: string | null): {
+import { ComputedRef } from 'vue';
+import { VarButton } from '../../apis/WMS/models';
+import { IRemoveEventListenerHandler, KG_BUTTON_TYPE } from '../../consts';
+import { IKgButtonClickCb, IKgButtonImportOkCb, IKgButtonSubmitCancelCb, IKgButtonSubmitSaveCb, useKgButtonStore } from './index.store';
+export interface IUseKgButton {
+    /**
+     * 界面标识.
+     */
     formID: string;
-    store: import("pinia").Store<"KgButton", {
-        isCreateClickInterceptedMap: Map<string, boolean>;
-        clickListenersMap: Map<string, IKgButtonClickCb[]>;
-        deleteOkListenersMap: Map<string, IKgButtonDeleteOkCb[]>;
-        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
-        otherOkListenersMap: Map<string, IKgButtonOtherOkCb[]>;
-        submitCancelListenersMap: Map<string, import("./index.store").IKgButtonSubmitCancelCb[]>;
-        submitSaveListenersMap: Map<string, import("./index.store").IKgButtonSubmitSaveCb[]>;
-        updateBeforeClickListenersMap: Map<string, IKgButtonUpdateBeforeClickCb[]>;
-    }, {
-        getIsCreateClickIntercepted(state: {
-            isCreateClickInterceptedMap: Map<string, boolean>;
-            clickListenersMap: Map<string, IKgButtonClickCb[]>;
-            deleteOkListenersMap: Map<string, IKgButtonDeleteOkCb[]>;
-            importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
-            otherOkListenersMap: Map<string, IKgButtonOtherOkCb[]>;
-            submitCancelListenersMap: Map<string, import("./index.store").IKgButtonSubmitCancelCb[]>;
-            submitSaveListenersMap: Map<string, import("./index.store").IKgButtonSubmitSaveCb[]>;
-            updateBeforeClickListenersMap: Map<string, IKgButtonUpdateBeforeClickCb[]>;
-        } & import("pinia").PiniaCustomStateProperties<{
-            isCreateClickInterceptedMap: Map<string, boolean>;
-            clickListenersMap: Map<string, IKgButtonClickCb[]>;
-            deleteOkListenersMap: Map<string, IKgButtonDeleteOkCb[]>;
-            importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
-            otherOkListenersMap: Map<string, IKgButtonOtherOkCb[]>;
-            submitCancelListenersMap: Map<string, import("./index.store").IKgButtonSubmitCancelCb[]>;
-            submitSaveListenersMap: Map<string, import("./index.store").IKgButtonSubmitSaveCb[]>;
-            updateBeforeClickListenersMap: Map<string, IKgButtonUpdateBeforeClickCb[]>;
-        }>): (param: {
-            formID: string;
-        }) => boolean;
-    }, {
-        dispose(formID: string | null | undefined): void;
-        addEventListener(formID: string, event: IKgButtonEvent, cb: import("./index.store").IKgButtonCb): void;
-        removeEventListener(formID: string, event: IKgButtonEvent, cb?: import("./index.store").IKgButtonCb | undefined): void;
-        emit(formID: string, event: IKgButtonEvent, param: any): Promise<boolean>;
-        setIsCreateClickIntercepted(param: {
-            formID: string;
-            isIntercepted: boolean;
-        }): void;
-        click(formID: string, type: KG_BUTTON_TYPE, variableName?: string | undefined): void;
-    }>;
+    /**
+     * 状态数据.
+     */
+    store: ReturnType<typeof useKgButtonStore>;
     /**
      * <p>手动点击某个按钮.</p>
      * <p>调用此方法相当于手动触发某个按钮的点击事件.</p>
      *
-     * @param param.
      * @param param.type 按钮类型.
      * @param param.variableName 按钮变量名称.
      */
@@ -60,45 +23,155 @@ export declare function useKgButton(formID?: string | null): {
         variableName?: string;
     }): void;
     /**
-     * 事件: 点击按钮.
-     * @param cb 回调函数.
-     * @param once 是否只会触发一次. 默认为 undefined.
+     * <p>「当前按钮」.</p>
      */
-    onClick: (cb: IKgButtonClickCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
+    currentButton: ComputedRef<VarButton | null>;
     /**
-     * 事件: 点击更新按钮之后, 执行默认逻辑之前. 如果返回 true, 则不再执行后续的默认逻辑.
-     * @param cb 回调函数.
-     * @param once 是否只会触发一次. 默认为 undefined.
+     * <p>「查询按钮」.</p>
      */
-    onUpdateBeforeClick: (cb: IKgButtonUpdateBeforeClickCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
+    searchButton: ComputedRef<VarButton | null>;
     /**
-     * 事件: 删除成功, 删除接口调用成功.
-     * @param cb 回调函数.
-     * @param once 是否只会触发一次. 默认为 undefined.
+     * <p>判断「当前按钮」的 click 事件是否被拦截.</p>
      */
-    onDeleteOk: (cb: IKgButtonDeleteOkCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
+    isCurrentButtonClickIntercepted: ComputedRef<boolean>;
     /**
-     * 事件: 导入成功, 导入接口调用成功.
+     * <p>判断「当前按钮」是否正在请求后端接口.</p>
+     */
+    isCurrentButtonRequesting: ComputedRef<boolean>;
+    /**
+     * <p>设置「当前按钮」. 比如点击「创建」按钮, 则此时「创建」按钮就是「当前按钮」, 同一时间最多只会有一个按钮处于「正在执行」状态.</p>
+     *
+     * <ul>
+     *     <li>
+     *         <p>如果参数 {@link param} === null, 表示清空「当前按钮」.</p>
+     *         <p>调用方式如下: <code>setCurrentButton(null);</code></p>
+     *     </li>
+     *     <li>
+     *         <p>否则, 如果参数 {@link param.type} !== <code>undefined</code> && {@link param.type} !== {@link KG_BUTTON_TYPE.OTHER}, 则根据参数 {@link param.type} 获取按钮.</p>
+     *         <p>调用方式如下: <code>setCurrentButton({ type: KG_BUTTON_TYPE.CREATE });</code></p>
+     *     </li>
+     *     <li>
+     *         <p>否则, 如果参数 {@link param.type} === <code>undefined</code> || {@link param.type} === {@link KG_BUTTON_TYPE.OTHER}, 则参数 {@link param.varName} 必须传值, 否则报错.</p>
+     *         <p>根据参数 {@link param.varName} 获取按钮.</p>
+     *         <p>调用方式如下: <code>setCurrentButton({ varName: 'SOME-OTHER-BUTTON' });</code></p>
+     *     </li>
+     * </ul>
+     *
+     * @param param.type <p>按钮的类型, 对应的是 {@link VarButton.typ} 属性, 取值请参考 {@link KG_BUTTON_TYPE}.</p>
+     * @param param.varName <p>按钮的变量名称, 对应的是 {@link VarButton.var_nam} 属性.</p>
+     */
+    setCurrentButton(param: {
+        type?: KG_BUTTON_TYPE;
+        varName?: string | null;
+    } | null): Promise<void>;
+    /**
+     * <p>判断某个按钮是否是「当前按钮」.</p>
+     *
+     * <ul>
+     *     <li>
+     *         <p>如果参数 {@link param.type} !== <code>undefined</code> && {@link param.type} !== {@link KG_BUTTON_TYPE.OTHER}, 则根据参数 {@link param.type} 获取按钮.</p>
+     *         <p>调用方式如下: <code>isCurrentButton({ type: KG_BUTTON_TYPE.CREATE });</code></p>
+     *     </li>
+     *     <li>
+     *         <p>如果参数 {@link param.type} === <code>undefined</code> || {@link param.type} === {@link KG_BUTTON_TYPE.OTHER}, 则参数 {@link param.varName} 必须传值, 否则报错.</p>
+     *         <p>根据参数 {@link param.varName} 获取按钮.</p>
+     *         <p>调用方式如下: <code>isCurrentButton({ varName: 'SOME-OTHER-BUTTON' });</code></p>
+     *     </li>
+     * </ul>
+     *
+     * @param param.type <p>按钮的类型, 对应的是 {@link VarButton.typ} 属性, 取值请参考 {@link KG_BUTTON_TYPE}.</p>
+     * @param param.varName <p>按钮的变量名称, 对应的是 {@link VarButton.var_nam} 属性.</p>
+     */
+    isCurrentButton(param: {
+        type?: KG_BUTTON_TYPE;
+        varName?: string;
+    }): boolean;
+    /**
+     * <p>判断某个按钮的 click 事件是否被拦截.</p>
+     * <p>用户调用 <code>kgVar.kgButton().onClick(cb)</code> 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+     * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
+     *
+     * <ul>
+     *     <li>
+     *         <p>如果参数 {@link param.type} !== <code>undefined</code> && {@link param.type} !== {@link KG_BUTTON_TYPE.OTHER}, 则根据参数 {@link param.type} 获取按钮.</p>
+     *         <p>调用方式如下: <code>isClickIntercepted({ type: KG_BUTTON_TYPE.CREATE });</code></p>
+     *     </li>
+     *     <li>
+     *         <p>如果参数 {@link param.type} === <code>undefined</code> || {@link param.type} === {@link KG_BUTTON_TYPE.OTHER}, 则参数 {@link param.varName} 必须传值, 否则报错.</p>
+     *         <p>根据参数 {@link param.varName} 获取按钮.</p>
+     *         <p>调用方式如下: <code>isClickIntercepted({ varName: 'SOME-OTHER-BUTTON' });</code></p>
+     *     </li>
+     * </ul>
+     *
+     * @param param.type <p>按钮的类型, 对应的是 {@link VarButton.typ} 属性, 取值请参考 {@link KG_BUTTON_TYPE}.</p>
+     * @param param.varName <p>按钮的变量名称, 对应的是 {@link VarButton.var_nam} 属性.</p>
+     */
+    isClickIntercepted(param: {
+        type?: KG_BUTTON_TYPE;
+        varName?: string | null;
+    }): boolean;
+    /**
+     * <p>设置某个按钮的 click 事件是否被拦截.</p>
+     *
+     * <ul>
+     *     <li>
+     *         <p>如果参数 {@link param.type} !== <code>undefined</code> && {@link param.type} !== {@link KG_BUTTON_TYPE.OTHER}, 则根据参数 {@link param.type} 获取按钮.</p>
+     *         <p>调用方式如下: <code>setIsClickIntercepted({ type: KG_BUTTON_TYPE.CREATE, isIntercepted: true });</code></p>
+     *     </li>
+     *     <li>
+     *         <p>如果参数 {@link param.type} === <code>undefined</code> || {@link param.type} === {@link KG_BUTTON_TYPE.OTHER}, 则参数 {@link param.varName} 必须传值, 否则报错.</p>
+     *         <p>根据参数 {@link param.varName} 获取按钮.</p>
+     *         <p>调用方式如下: <code>setIsClickIntercepted({ varName: 'SOME-OTHER-BUTTON', isIntercepted: true });</code></p>
+     *     </li>
+     * </ul>
+     *
+     * @param param.isIntercepted 是否被拦截.
+     * @param param.type <p>按钮的类型, 对应的是 {@link VarButton.typ} 属性, 取值请参考 {@link KG_BUTTON_TYPE}.</p>
+     * @param param.varName <p>按钮的变量名称, 对应的是 {@link VarButton.var_nam} 属性.</p>
+     */
+    setIsClickIntercepted(param: {
+        isIntercepted: boolean;
+        type?: KG_BUTTON_TYPE;
+        varName?: string | null;
+    }): void;
+    /**
+     * 设置「当前按钮」是否正在请求后端接口.
+     *
+     * @param param.isRequesting 「当前按钮」是否正在请求后端接口.
+     */
+    setIsCurrentButtonRequesting(param: {
+        isRequesting: boolean;
+    }): void;
+    /**
+     * 事件: 点击按钮.
+     *
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onImportOk: (cb: IKgButtonImportOkCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
+    onClick(cb: IKgButtonClickCb, once?: boolean): IRemoveEventListenerHandler;
     /**
-     * 事件: other 类型的按钮接口调用成功.
+     * 事件: 导入成功, 导入接口调用成功.
+     *
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onOtherOk: (cb: IKgButtonOtherOkCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
+    onImportOk(cb: IKgButtonImportOkCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 表格内编辑时, 点击保存按钮.
+     *
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onSubmitSave: (cb: IKgButtonDeleteOkCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
+    onSubmitSave(cb: IKgButtonSubmitSaveCb, once?: boolean): IRemoveEventListenerHandler;
     /**
      * 事件: 表格内编辑时, 点击取消按钮.
+     *
      * @param cb 回调函数.
      * @param once 是否只会触发一次. 默认为 undefined.
      */
-    onSubmitCancel: (cb: IKgButtonDeleteOkCb, once?: boolean | undefined) => import("../../consts").IRemoveEventListenerHandler;
-};
+    onSubmitCancel(cb: IKgButtonSubmitCancelCb, once?: boolean): IRemoveEventListenerHandler;
+}
+/**
+ * @param formID 界面标识.
+ */
+export declare function useKgButton(formID?: string | null): IUseKgButton;

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

@@ -1,87 +1,206 @@
 import { VarButton } from '../../apis/WMS/models';
 import { IKgEventCb, KG_BUTTON_TYPE } from '../../consts';
-import { IKgTableRow } from '../KgTable';
 /**
  * 事件类型.
  *   'click':             点击按钮
- *   'updateBeforeClick': 点击更新按钮之后, 执行默认逻辑之前. 如果返回 Promise.resolve(false), 则不执行默认逻辑
- *   'deleteOk':          删除成功, 删除接口调用成功
  *   'importOk':          导入成功, 导入接口调用成功
- *   'otherOk':           other 类型的按钮接口调用成功
  *   'submitSave':        表格内编辑时, 点击保存按钮
  *   'submitCancel':      表格内编辑时, 点击取消按钮
  */
-export declare type IKgButtonEvent = 'click' | 'updateBeforeClick' | 'deleteOk' | 'importOk' | 'otherOk' | 'submitSave' | 'submitCancel';
+export declare type IKgButtonEvent = 'click' | 'importOk' | 'submitSave' | 'submitCancel';
 export declare type IKgButtonClickCbParam = {
+    /**
+     * 被点击的按钮.
+     */
     button: VarButton;
 };
-export declare type IKgButtonClickCb = ((button: VarButton) => Promise<boolean>) & IKgEventCb;
-export declare type IKgButtonUpdateBeforeClickCbParam = {
-    button?: VarButton | null;
-    row?: IKgTableRow | null;
-};
-export declare type IKgButtonUpdateBeforeClickCb = ((args: IKgButtonUpdateBeforeClickCbParam) => Promise<boolean>) & IKgEventCb;
-export declare type IKgButtonDeleteOkCbParam = {
-    button?: VarButton | null;
-    /** 删除的行. */
-    rows: Array<IKgTableRow> | null;
-};
-export declare type IKgButtonDeleteOkCb = ((args: IKgButtonDeleteOkCbParam) => Promise<boolean>) & IKgEventCb;
+export declare type IKgButtonClickCb = ((param: IKgButtonClickCbParam) => Promise<boolean>) & IKgEventCb;
 export declare type IKgButtonImportOkCbParam = {
     button?: VarButton | null;
 };
 export declare type IKgButtonImportOkCb = ((args: IKgButtonImportOkCbParam) => Promise<boolean>) & IKgEventCb;
-export declare type IKgButtonOtherOkCbParam = {
-    button?: VarButton | null;
-    /** 接口返回的数据. */
-    data: any;
-};
-export declare type IKgButtonOtherOkCb = ((args: IKgButtonOtherOkCbParam) => Promise<boolean>) & IKgEventCb;
 export declare type IKgButtonSubmitSaveCb = (() => Promise<boolean>) & IKgEventCb;
 export declare type IKgButtonSubmitCancelCb = (() => Promise<boolean>) & IKgEventCb;
-export declare type IKgButtonCbParam = IKgButtonClickCbParam | IKgButtonUpdateBeforeClickCbParam | IKgButtonDeleteOkCbParam | IKgButtonImportOkCbParam | IKgButtonOtherOkCbParam | any;
-export declare type IKgButtonCb = IKgButtonClickCb | IKgButtonUpdateBeforeClickCb | IKgButtonDeleteOkCb | IKgButtonImportOkCb | IKgButtonOtherOkCb | IKgButtonSubmitSaveCb | IKgButtonSubmitCancelCb;
+export declare type IKgButtonCbParam = IKgButtonClickCbParam | IKgButtonImportOkCbParam;
+export declare type IKgButtonCb = IKgButtonClickCb | IKgButtonImportOkCb | IKgButtonSubmitSaveCb | IKgButtonSubmitCancelCb;
 export declare const useKgButtonStore: import("pinia").StoreDefinition<"KgButton", {
     /**
-     * <p>创建按钮的 click 事件是否被拦截.</p>
-     * <p>用户调用 kgButton.onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被拦截了.</p>
-     * <p>被拦截之后, 创建按钮的默认逻辑不会执行(即打开提交弹窗, 并加载各种数据等等), 由用户自行处理.</p>
+     * <p>当前按钮.</p>
+     * <p>同一时间最多只会有一个按钮处于「正在执行」状态, 比如点击了创建按钮, 则当前按钮就是创建按钮.</p>
      */
-    isCreateClickInterceptedMap: Map<string, boolean>;
+    currentButtonMap: Map<string, VarButton | null>;
+    /**
+     * <p>当前按钮是否正在请求后端接口.</p>
+     * <p>比如点击了创建按钮, 打开了创建弹窗, 此时「当前按钮」指的就是创建按钮. 当点击弹窗中的保存按钮时, 表示正在请求后端接口.</p>
+     */
+    isCurrentButtonRequestingMap: Map<string, boolean>;
+    /**
+     * <p>按钮的 click 事件是否被拦截.</p>
+     * <p>用户调用 kgVar.kgButton().onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+     * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
+     */
+    isClickInterceptedMap: Map<string, boolean>;
     clickListenersMap: Map<string, IKgButtonClickCb[]>;
-    deleteOkListenersMap: Map<string, IKgButtonDeleteOkCb[]>;
     importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
-    otherOkListenersMap: Map<string, IKgButtonOtherOkCb[]>;
     submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
     submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
-    updateBeforeClickListenersMap: Map<string, IKgButtonUpdateBeforeClickCb[]>;
 }, {
-    getIsCreateClickIntercepted(state: {
-        isCreateClickInterceptedMap: Map<string, boolean>;
+    isClickIntercepted(state: {
+        currentButtonMap: Map<string, VarButton | null>;
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        isClickInterceptedMap: Map<string, boolean>;
         clickListenersMap: Map<string, IKgButtonClickCb[]>;
-        deleteOkListenersMap: Map<string, IKgButtonDeleteOkCb[]>;
         importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
-        otherOkListenersMap: Map<string, IKgButtonOtherOkCb[]>;
         submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
         submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
-        updateBeforeClickListenersMap: Map<string, IKgButtonUpdateBeforeClickCb[]>;
     } & import("pinia").PiniaCustomStateProperties<{
         /**
-         * <p>创建按钮的 click 事件是否被拦截.</p>
-         * <p>用户调用 kgButton.onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被拦截了.</p>
-         * <p>被拦截之后, 创建按钮的默认逻辑不会执行(即打开提交弹窗, 并加载各种数据等等), 由用户自行处理.</p>
+         * <p>当前按钮.</p>
+         * <p>同一时间最多只会有一个按钮处于「正在执行」状态, 比如点击了创建按钮, 则当前按钮就是创建按钮.</p>
+         */
+        currentButtonMap: Map<string, VarButton | null>;
+        /**
+         * <p>当前按钮是否正在请求后端接口.</p>
+         * <p>比如点击了创建按钮, 打开了创建弹窗, 此时「当前按钮」指的就是创建按钮. 当点击弹窗中的保存按钮时, 表示正在请求后端接口.</p>
+         */
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        /**
+         * <p>按钮的 click 事件是否被拦截.</p>
+         * <p>用户调用 kgVar.kgButton().onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+         * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
          */
-        isCreateClickInterceptedMap: Map<string, boolean>;
+        isClickInterceptedMap: Map<string, boolean>;
         clickListenersMap: Map<string, IKgButtonClickCb[]>;
-        deleteOkListenersMap: Map<string, IKgButtonDeleteOkCb[]>;
         importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
-        otherOkListenersMap: Map<string, IKgButtonOtherOkCb[]>;
         submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
         submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
-        updateBeforeClickListenersMap: Map<string, IKgButtonUpdateBeforeClickCb[]>;
-    }>): (param: {
-        formID: string;
+    }>): (formID: string | undefined | null, param: {
+        type?: KG_BUTTON_TYPE;
+        varName?: string | null;
     }) => boolean;
+    isCurrentButtonRequesting(state: {
+        currentButtonMap: Map<string, VarButton | null>;
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    } & import("pinia").PiniaCustomStateProperties<{
+        /**
+         * <p>当前按钮.</p>
+         * <p>同一时间最多只会有一个按钮处于「正在执行」状态, 比如点击了创建按钮, 则当前按钮就是创建按钮.</p>
+         */
+        currentButtonMap: Map<string, VarButton | null>;
+        /**
+         * <p>当前按钮是否正在请求后端接口.</p>
+         * <p>比如点击了创建按钮, 打开了创建弹窗, 此时「当前按钮」指的就是创建按钮. 当点击弹窗中的保存按钮时, 表示正在请求后端接口.</p>
+         */
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        /**
+         * <p>按钮的 click 事件是否被拦截.</p>
+         * <p>用户调用 kgVar.kgButton().onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+         * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
+         */
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    }>): (formID: string | undefined | null) => boolean;
+    getCurrentButton: (state: {
+        currentButtonMap: Map<string, VarButton | null>;
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    } & import("pinia").PiniaCustomStateProperties<{
+        /**
+         * <p>当前按钮.</p>
+         * <p>同一时间最多只会有一个按钮处于「正在执行」状态, 比如点击了创建按钮, 则当前按钮就是创建按钮.</p>
+         */
+        currentButtonMap: Map<string, VarButton | null>;
+        /**
+         * <p>当前按钮是否正在请求后端接口.</p>
+         * <p>比如点击了创建按钮, 打开了创建弹窗, 此时「当前按钮」指的就是创建按钮. 当点击弹窗中的保存按钮时, 表示正在请求后端接口.</p>
+         */
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        /**
+         * <p>按钮的 click 事件是否被拦截.</p>
+         * <p>用户调用 kgVar.kgButton().onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+         * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
+         */
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    }>) => (formID: string | null | undefined) => VarButton | null;
+    isCurrentButton(state: {
+        currentButtonMap: Map<string, VarButton | null>;
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    } & import("pinia").PiniaCustomStateProperties<{
+        /**
+         * <p>当前按钮.</p>
+         * <p>同一时间最多只会有一个按钮处于「正在执行」状态, 比如点击了创建按钮, 则当前按钮就是创建按钮.</p>
+         */
+        currentButtonMap: Map<string, VarButton | null>;
+        /**
+         * <p>当前按钮是否正在请求后端接口.</p>
+         * <p>比如点击了创建按钮, 打开了创建弹窗, 此时「当前按钮」指的就是创建按钮. 当点击弹窗中的保存按钮时, 表示正在请求后端接口.</p>
+         */
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        /**
+         * <p>按钮的 click 事件是否被拦截.</p>
+         * <p>用户调用 kgVar.kgButton().onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+         * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
+         */
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    }>): (formID: string, param: {
+        varName?: string;
+        type?: KG_BUTTON_TYPE;
+    }) => boolean;
+    getSearchButton(state: {
+        currentButtonMap: Map<string, VarButton | null>;
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    } & import("pinia").PiniaCustomStateProperties<{
+        /**
+         * <p>当前按钮.</p>
+         * <p>同一时间最多只会有一个按钮处于「正在执行」状态, 比如点击了创建按钮, 则当前按钮就是创建按钮.</p>
+         */
+        currentButtonMap: Map<string, VarButton | null>;
+        /**
+         * <p>当前按钮是否正在请求后端接口.</p>
+         * <p>比如点击了创建按钮, 打开了创建弹窗, 此时「当前按钮」指的就是创建按钮. 当点击弹窗中的保存按钮时, 表示正在请求后端接口.</p>
+         */
+        isCurrentButtonRequestingMap: Map<string, boolean>;
+        /**
+         * <p>按钮的 click 事件是否被拦截.</p>
+         * <p>用户调用 kgVar.kgButton().onClick(cb) 监听了 click 事件, 并且回调函数返回了 true, 表示该 click 事件被用户拦截了.</p>
+         * <p>被拦截之后, 该按钮的默认逻辑不会执行(例如打开提交弹窗, 加载各种数据等等), 后续由用户自行处理.</p>
+         */
+        isClickInterceptedMap: Map<string, boolean>;
+        clickListenersMap: Map<string, IKgButtonClickCb[]>;
+        importOkListenersMap: Map<string, IKgButtonImportOkCb[]>;
+        submitCancelListenersMap: Map<string, IKgButtonSubmitCancelCb[]>;
+        submitSaveListenersMap: Map<string, IKgButtonSubmitSaveCb[]>;
+    }>): (formID: string | null | undefined) => VarButton | null;
 }, {
     dispose(formID: string | null | undefined): void;
     /**
@@ -105,16 +224,18 @@ export declare const useKgButtonStore: import("pinia").StoreDefinition<"KgButton
      * @param param 数据.
      */
     emit(formID: string, event: IKgButtonEvent, param: IKgButtonCbParam): Promise<boolean>;
-    /**
-     *
-     * @param param
-     * @param param.formID 界面标识.
-     * @param param.isIntercepted 是否拦截.
-     */
-    setIsCreateClickIntercepted(param: {
-        formID: string;
+    setIsClickIntercepted(formID: string | undefined | null, param: {
         isIntercepted: boolean;
+        type?: KG_BUTTON_TYPE;
+        varName?: string | null;
+    }): void;
+    setIsCurrentButtonRequesting(formID: string | undefined | null, param: {
+        isRequesting: boolean;
     }): void;
+    setCurrentButton(formID: string, param: {
+        type?: KG_BUTTON_TYPE;
+        varName?: string | null;
+    } | null): Promise<void>;
     /**
      * <p>手动点击某个按钮.</p>
      * <p>调用此方法相当于手动触发某个按钮的点击事件.</p>

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

@@ -1,15 +1,13 @@
-import { ComputedRef } from 'vue';
 import { IKgFormItemProps } from './index.vm';
 export declare function _useFormRules(props: IKgFormItemProps): {
     /** 表单验证规则. */
-    formRules: ComputedRef<import("ant-design-vue/es/form").RuleObject[]>;
+    formRules: import("vue").ComputedRef<import("ant-design-vue/es/form").RuleObject[]>;
     /** 正在计算表单验证规则. */
     isFormRulesLoading: import("vue").Ref<boolean>;
 };
-export declare type IUseKgFormItem<T = Record<string, any>> = {
+export declare function useKgFormItem<T = Record<string, any>>(props?: IKgFormItemProps): {
     /** 控件类型. */
-    controlType: ComputedRef<string | null | undefined>;
+    controlType: import("vue").ComputedRef<string | null | undefined>;
     /** 控件配置参数. */
-    controlProperties: ComputedRef<T>;
+    controlProperties: import("vue").ComputedRef<T>;
 };
-export declare function useKgFormItem<T = Record<string, any>>(props?: IKgFormItemProps): IUseKgFormItem<T>;

package/dist/src/components/KgForm.Item/components/KgForm.Item.Checkbox.d.ts

@@ -3,9 +3,9 @@
  * <p>组件 Checkbox 的 checked 属性使用的是 true/false, 本组件实际传入的参数为 1/0, 因此存在数据转换.</p>
  */
 declare const _default: import("vue").DefineComponent<{
+    /** 是否勾选. */
     kgVarName: {
         type: import("vue").PropType<string>;
-        /** 是否勾选. */
         required: boolean;
     };
     kgContext: {
@@ -45,10 +45,10 @@ declare const _default: import("vue").DefineComponent<{
     onKgChange: import("vue").PropType<(value: any) => void>;
     onKgSelectChange: import("vue").PropType<(value: any) => void>;
     onKgSelectDatasChange: import("vue").PropType<(datas: any[]) => void>;
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("kgSubmit" | "kgChange" | "update:value")[], "kgSubmit" | "kgChange" | "update:value", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "kgSubmit" | "kgChange")[], "update:value" | "kgSubmit" | "kgChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+    /** 是否勾选. */
     kgVarName: {
         type: import("vue").PropType<string>;
-        /** 是否勾选. */
         required: boolean;
     };
     kgContext: {

package/dist/src/components/KgForm.Item/components/KgForm.Item.CheckboxGroup.d.ts

@@ -40,7 +40,7 @@ declare const _default: import("vue").DefineComponent<{
     onKgChange: import("vue").PropType<(value: any) => void>;
     onKgSelectChange: import("vue").PropType<(value: any) => void>;
     onKgSelectDatasChange: import("vue").PropType<(datas: any[]) => void>;
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("kgSubmit" | "kgChange" | "update:value" | "kgCheckboxGroupChange")[], "kgSubmit" | "kgChange" | "update:value" | "kgCheckboxGroupChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "kgSubmit" | "kgChange" | "kgCheckboxGroupChange")[], "update:value" | "kgSubmit" | "kgChange" | "kgCheckboxGroupChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
     kgVarName: {
         type: import("vue").PropType<string>;
         required: boolean;

package/dist/src/components/KgForm.Item/components/KgForm.Item.Date.d.ts

@@ -41,7 +41,7 @@ declare const _default: import("vue").DefineComponent<{
     onKgChange: import("vue").PropType<(value: any) => void>;
     onKgSelectChange: import("vue").PropType<(value: any) => void>;
     onKgSelectDatasChange: import("vue").PropType<(datas: any[]) => void>;
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("kgSubmit" | "kgChange" | "update:value")[], "kgSubmit" | "kgChange" | "update:value", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "kgSubmit" | "kgChange")[], "update:value" | "kgSubmit" | "kgChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
     kgVarName: {
         type: import("vue").PropType<string>;
         required: boolean;

package/dist/src/components/KgForm.Item/components/KgForm.Item.DateRange.d.ts

@@ -41,7 +41,7 @@ declare const _default: import("vue").DefineComponent<{
     onKgChange: import("vue").PropType<(value: any) => void>;
     onKgSelectChange: import("vue").PropType<(value: any) => void>;
     onKgSelectDatasChange: import("vue").PropType<(datas: any[]) => void>;
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("kgSubmit" | "kgChange" | "update:value")[], "kgSubmit" | "kgChange" | "update:value", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "kgSubmit" | "kgChange")[], "update:value" | "kgSubmit" | "kgChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
     kgVarName: {
         type: import("vue").PropType<string>;
         required: boolean;

package/dist/src/components/KgForm.Item/components/KgForm.Item.Input.d.ts

@@ -40,7 +40,7 @@ declare const _default: import("vue").DefineComponent<{
     onKgChange: import("vue").PropType<(value: any) => void>;
     onKgSelectChange: import("vue").PropType<(value: any) => void>;
     onKgSelectDatasChange: import("vue").PropType<(datas: any[]) => void>;
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("kgSubmit" | "kgChange" | "update:value")[], "kgSubmit" | "kgChange" | "update:value", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "kgSubmit" | "kgChange")[], "update:value" | "kgSubmit" | "kgChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
     kgVarName: {
         type: import("vue").PropType<string>;
         required: boolean;

package/dist/src/components/KgForm.Item/components/KgForm.Item.InputNumber.d.ts

@@ -40,7 +40,7 @@ declare const _default: import("vue").DefineComponent<{
     onKgChange: import("vue").PropType<(value: any) => void>;
     onKgSelectChange: import("vue").PropType<(value: any) => void>;
     onKgSelectDatasChange: import("vue").PropType<(datas: any[]) => void>;
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("kgSubmit" | "kgChange" | "update:value")[], "kgSubmit" | "kgChange" | "update:value", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
+}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("update:value" | "kgSubmit" | "kgChange")[], "update:value" | "kgSubmit" | "kgChange", import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{
     kgVarName: {
         type: import("vue").PropType<string>;
         required: boolean;