@kengic/vue 0.25.1-beta.0 → 0.25.1

package/dist/src/apis/WMS/models.d.ts

@@ -503,7 +503,7 @@ export declare class VarConfigLookup {
     var_nam?: string | null;
     constructor(obj?: VarConfigLookup);
 }
-/** 变量配置:下拉列表. */
+/** 变量配置:列表数据. */
 export declare class VarConfigPossibility {
     /** 接口地址(Command). */
     cmd?: string | null;
@@ -777,7 +777,7 @@ export declare class VarProfileDetail {
 export declare class VarProfileMaster {
     /** 定制级别(CustomLevel). */
     cust_lvl?: number | null;
-    /** 是否默认(DefaultFlag). */
+    /** 是否是默认的视图(DefaultFlag). */
     def_flg?: number | null;
     /** 是否启用高级查询(DynamicQueryFlag). */
     dyn_flg?: number | null;

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

@@ -60,9 +60,13 @@ export declare type IKgFormSelectBeforeSetDatasEventListenerParameter<T = any> =
     context: KG_FORM_CONTEXT;
     /** 列表数据. */
     datas: Ref<Array<T>>;
+    /** @deprecated */
     isCopying: boolean | null;
+    /** @deprecated */
     isCreating: boolean | null;
+    /** @deprecated */
     isDeleting: boolean | null;
+    /** @deprecated */
     isUpdating: boolean | null;
     /** 变量名称. */
     varName: string;
@@ -73,15 +77,22 @@ export declare type IKgFormSelectChangeEventListenerParameter = {
      * 表单控件所处环境.
      */
     context: KG_FORM_CONTEXT;
+    /** @deprecated */
     isCopying: boolean | null;
+    /** @deprecated */
     isCreating: boolean | null;
+    /** @deprecated */
     isDeleting: boolean | null;
     /** 是否多选, 否则单选. */
     isMultiple: boolean;
+    /** @deprecated */
     isUpdating: boolean | null;
-    /** @deprecated 已弃用, 请使用 {@link formModel}. */
+    /** @deprecated */
     model: Ref<Record<string, any> | null> | null;
-    /** 表单数据对象. */
+    /**
+     * 表单数据对象.
+     * @deprecated
+     */
     formModel: Ref<Record<string, any> | null> | null;
     /** 选中的数据对象组成的数组, 如果是单选则数组中只有一个数据对象. */
     rows: Array<any> | null;

package/dist/src/components/KgForm.Item/addon/KgForm.Item.Addon.DynamicQueryOperator.d.ts

@@ -1,4 +1,4 @@
-import { ExtractPropTypes } from 'vue';
+import { ExtractPropTypes, PropType } from 'vue';
 export declare const getProps: () => {
     /**
      * 表单控件类型.

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

@@ -55,24 +55,31 @@ export interface IUseKgTable {
      * @param listener 事件监听函数.
      * @param isOnce 是否只会触发一次. 默认为 undefined.
      */
+    onAfterRequest(listener: IKgTableAfterRequestEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
+    /**
+     * @deprecated 已废弃, 请使用 onAfterRequest() 方法.
+     */
     onAfterSearch(listener: IKgTableAfterRequestEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
     /**
-     * 监听事件: 即将解析请求参数.
+     * <p>监听事件: 即将解析请求参数.</p>
+     * <p>在该事件中, 可以修改解析前的参数.</p>
+     *
      * @param listener 事件监听函数.
      * @param isOnce 是否只会触发一次. 默认为 undefined.
      */
-    onBeforeParseParameter(listener: IKgTableBeforeParseParameterEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
+    onBeforeParseRequestParameter(listener: IKgTableBeforeParseParameterEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
     /**
      * 监听事件: 即将发起查询请求, 如果返回 true 表示不会发起请求.
      * @param listener 事件监听函数.
      * @param isOnce 是否只会触发一次. 默认为 undefined.
-     * @deprecated 已废弃, 请使用 onBeforeSearch() 方法.
+     */
+    onBeforeRequest(listener: IKgTableBeforeRequestEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
+    /**
+     * @deprecated 已废弃, 请使用 onBeforeRequest() 方法.
      */
     onBeforeRetrieve(listener: IKgTableBeforeRequestEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
     /**
-     * 监听事件: 即将发起查询请求, 如果返回 true 表示不会发起请求.
-     * @param listener 事件监听函数.
-     * @param isOnce 是否只会触发一次. 默认为 undefined.
+     * @deprecated 已废弃, 请使用 onBeforeRequest() 方法.
      */
     onBeforeSearch(listener: IKgTableBeforeRequestEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
     /**
@@ -88,9 +95,6 @@ export interface IUseKgTable {
      */
     onReady(listener: IKgTableReadyEventListener, isOnce?: boolean): IRemoveEventListenerHandler;
     /**
-     * 监听事件: 查询请求成功, 表格数据已经赋值, 表格状态已经更新.
-     * @param listener 事件监听函数.
-     * @param isOnce 是否只会触发一次. 默认为 undefined.
      * @deprecated 已废弃, 请使用 onAfterSearch() 方法.
      */
     onRetrieve(listener: IKgTableAfterRequestEventListener, isOnce?: boolean): IRemoveEventListenerHandler;

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

@@ -8,12 +8,12 @@ import { IKgTableRow, IKgTableRowHeight } from './index.vm';
  * 事件类型.
  *   'ready':                就绪, 配置初始完成, 组件渲染完成
  *   'rowDoubleClick':       双击某行
- *   'beforeParseParameter': 即将解析请求参数,
- *   'beforeSearch':         即将发起查询请求, 如果返回 true 表示不会发起请求
+ *   'beforeParseRequestParameter': 即将解析请求参数,
+ *   'beforeRequest':         即将发起查询请求, 如果返回 true 表示不会发起请求
  *   'beforeSetDatas':       查询请求成功, 表格数据尚未赋值. 此处可以对查询接口返回的列表数据作处理
- *   'afterSearch':          查询请求成功, 表格数据已经赋值, 表格状态已经更新
+ *   'afterRequest':          查询请求成功, 表格数据已经赋值, 表格状态已经更新
  */
-export declare type IKgTableEvent = 'ready' | 'rowDoubleClick' | 'beforeParseParameter' | 'beforeSearch' | 'beforeSetDatas' | 'afterSearch';
+export declare type IKgTableEvent = 'ready' | 'rowDoubleClick' | 'beforeParseRequestParameter' | 'beforeRequest' | 'beforeSetDatas' | 'afterRequest';
 export declare type IKgTableReadyEventListenerParameter = {};
 export declare type IKgTableReadyEventListener = ((param: IKgTableReadyEventListenerParameter) => Promise<boolean>) & IKgEventListener;
 export declare type IKgTableRowDoubleClickEventListenerParameter = {
@@ -21,13 +21,13 @@ export declare type IKgTableRowDoubleClickEventListenerParameter = {
     row: IKgTableRow;
 };
 export declare type IKgTableRowDoubleClickEventListener = ((param: IKgTableRowDoubleClickEventListenerParameter) => Promise<boolean>) & IKgEventListener;
-export declare type IKgTableBeforeParseParameterEventListenerParameter = {
+export declare type IKgTableBeforeParseRequestParameterEventListenerParameter = {
     /**
      * 查询接口请求参数, 尚未解析.
      */
     params: Record<string, any>;
 };
-export declare type IKgTableBeforeParseParameterEventListener = ((param: IKgTableBeforeParseParameterEventListenerParameter) => Promise<boolean>) & IKgEventListener;
+export declare type IKgTableBeforeParseParameterEventListener = ((param: IKgTableBeforeParseRequestParameterEventListenerParameter) => Promise<boolean>) & IKgEventListener;
 export declare type IKgTableBeforeRequestEventListenerParameter = {
     /** 查询接口请求参数. */
     params: Record<string, any>;
@@ -55,7 +55,7 @@ export declare type IKgTableAfterRequestEventListenerParameter = {
     datas: Ref<Array<IKgTableRow>>;
 };
 export declare type IKgTableAfterRequestEventListener = ((param: IKgTableAfterRequestEventListenerParameter) => Promise<boolean>) & IKgEventListener;
-export declare type IKgTableEventListenerParameter = IKgTableReadyEventListenerParameter | IKgTableRowDoubleClickEventListenerParameter | IKgTableBeforeParseParameterEventListenerParameter | IKgTableBeforeRequestEventListenerParameter | IKgTableBeforeSetDatasEventListenerParameter | IKgTableAfterRequestEventListenerParameter;
+export declare type IKgTableEventListenerParameter = IKgTableReadyEventListenerParameter | IKgTableRowDoubleClickEventListenerParameter | IKgTableBeforeParseRequestParameterEventListenerParameter | IKgTableBeforeRequestEventListenerParameter | IKgTableBeforeSetDatasEventListenerParameter | IKgTableAfterRequestEventListenerParameter;
 export declare type IKgTableEventListener = IKgTableReadyEventListener | IKgTableRowDoubleClickEventListener | IKgTableBeforeParseParameterEventListener | IKgTableBeforeRequestEventListener | IKgTableBeforeSetDatasEventListener | IKgTableAfterRequestEventListener;
 export interface IUseKgTableStoreState {
     afterRequestEventListenersMap: Map<string, Array<IKgTableAfterRequestEventListener>>;

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

@@ -1,13 +1,17 @@
-import { VarButton, VarButtonConfig, VarChildDetail, VarConfigPossibility, VarGridConfig, VarGridDetail, VarGridMasterDTO, VarProfileConfig, VarProfileDetail, VarProfileMasterDTO, VarSubmitConfig, VarSubmitDetail } from '../../apis/WMS/models';
+import { VarButton, VarButtonConfig, VarChildDetail, VarConfigControl, VarConfigInput, VarConfigLookup, VarConfigPossibility, VarConfigTip, VarGridConfig, VarGridDetail, VarGridMasterDTO, VarProfileConfig, VarProfileDetail, VarProfileMasterDTO, VarSubmitConfig, VarSubmitDetail } from '../../apis/WMS/models';
 export declare function transformVarProfileConfig(varProfileConfig: VarProfileConfig | null | undefined): VarProfileConfig | null;
 export declare function transformVarGridConfig(varGridConfig: VarGridConfig | null | undefined): VarGridConfig | null;
-export declare function transformVarGridMasterDTOs(varGridMasterDTOs?: Array<VarGridMasterDTO> | null): Array<VarGridMasterDTO>;
+export declare function transformVarGridMasters(varGridMasters?: Array<VarGridMasterDTO> | null): Array<VarGridMasterDTO>;
 export declare function transformVarChildDetails(varChildDetails: Array<VarChildDetail> | null | undefined): Array<VarChildDetail>;
-export declare function transformVarProfileMasterDTOs(varProfileMasterDTOs?: Array<VarProfileMasterDTO> | null): Array<VarProfileMasterDTO>;
+export declare function transformVarProfileMasters(varProfileMasters?: Array<VarProfileMasterDTO> | null): Array<VarProfileMasterDTO>;
 export declare function transformVarSubmitConfigs(varSubmitConfigs?: Array<VarSubmitConfig> | null): Array<VarSubmitConfig>;
 export declare function transformVarSubmitDetails(varSubmitDetails?: Array<VarSubmitDetail> | null): Array<VarSubmitDetail>;
 export declare function transformVarButtons(varButtons?: Array<VarButton> | null): Array<VarButton>;
 export declare function transformVarConfigPossibilities(varConfigPossibilities: Array<VarConfigPossibility> | null | undefined): Array<VarConfigPossibility>;
+export declare function transformVarConfigControls(varConfigControls: Array<VarConfigControl> | null | undefined): Array<VarConfigControl>;
+export declare function transformVarConfigLookups(varConfigLookups: Array<VarConfigLookup> | null | undefined): Array<VarConfigLookup>;
+export declare function transformVarConfigTips(varConfigTips: Array<VarConfigTip> | null | undefined): Array<VarConfigTip>;
+export declare function transformVarConfigInputs(varConfigInputs: Array<VarConfigInput> | null | undefined): Array<VarConfigInput>;
 export declare function transformVarButtonConfig(varButtonConfig: VarButtonConfig | null | undefined): VarButtonConfig | null;
 /**
  * 处理 VarGridDetail 数据.
@@ -15,9 +19,4 @@ export declare function transformVarButtonConfig(varButtonConfig: VarButtonConfi
  * @param varGridDetails 原始数据.
  */
 export declare function transformVarGridDetails(varGridDetails?: Array<VarGridDetail> | null): Array<VarGridDetail>;
-/**
- * 处理 VarProfileDetail 数据.
- *
- * @param varProfileDetails 原始数据.
- */
 export declare function transformVarProfileDetails(varProfileDetails?: Array<VarProfileDetail> | null): Array<VarProfileDetail>;

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

@@ -233,7 +233,7 @@ declare const _default: {
         edit: string;
         empty: string;
         emptyText: string;
-        'execute-success': string;
+        executeSuccess: string;
         export: string;
         exportSuccess: string;
         formId: string;

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

@@ -233,7 +233,7 @@ declare const _default: {
         edit: string;
         empty: string;
         emptyText: string;
-        'execute-success': string;
+        executeSuccess: string;
         export: string;
         exportSuccess: string;
         formId: string;

package/dist/src/services/http-client.d.ts

@@ -37,7 +37,9 @@ interface IRequestOptions {
     /** 是否使用模拟数据. */
     mock?: boolean;
     /**
-     * 如果该参数不为空, 表示该请求启用了高级查询, 该参数包含各个字段的高级查询操作符.
+     * <p>各个请求参数的高级查询操作符.</p>
+     * <p>如果该参数不为空, 表示该请求启用了高级查询.</p>
+     * <p>其中的 key 表示参数名, 对应的 value 表示该参数的高级查询操作符(>,=,<...).</p>
      */
     dynamicQueryOperatorModel?: Record<string, KG_DYNAMIC_QUERY_OPERATOR>;
     /**

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

@@ -12,16 +12,30 @@ export declare class KgVarUtil {
      */
     static parseRequestParamsToJSON(params: string | null | undefined): Record<string, any>;
     /**
-     * 根据控件类型, 将任意的值(可能非法)转换为合法的值.
+     * <p>根据控件类型, 将表单控件的默认值转换为合法的值.</p>
+     * <ul>
+     *     <li>
+     *         {NOW}
+     *         <p>当前时间(YYYY-MM-DD HH:mm:ss)</p>
+     *     </li>
+     *     <li>
+     *         {USER}
+     *         <p>当前登录的用户名.</p>
+     *     </li>
+     *     <li>
+     *         {ROW}
+     *         <p>当前勾选后对应的属性.</p>
+     *     </li>
+     * </ul>
      *
      * @param param.$dayjs dayjs.
      * @param param.buttonVarName 「变量配置:表单控件」所属的按钮的变量名称.
      * @param param.formID 界面标识.
      * @param param.value 原始的值.
      * @param param.varName 变量名称.
-     * @return {} 转换后的合法的值.
+     * @return {} 转换之后的值.
      */
-    static transformFormItemValue(param: {
+    static transformFormItemDefaultValue(param: {
         $dayjs: typeof dayjs;
         buttonVarName: string | null | undefined;
         formID: string;
@@ -58,7 +72,7 @@ export declare class KgVarUtil {
      * </p>
      *
      * @param param.$dayjs dayjs.
-     * @param param.dynamicQueryOperators 各个字段的高级查询操作符.
+     * @param param.dynamicQueryOperatorModel 各个字段的高级查询操作符.
      * @param param.formID 界面标识.
      * @param param.kgSearchFormID 查询条件的界面标识.
      * @param param.params 请求参数.

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

@@ -115,6 +115,13 @@ export declare class KgUtil {
     static showLoading(): void;
     /** 隐藏全局遮罩. */
     static hideLoading(): void;
+    /**
+     * <p>使用 lodash 的 snakeCase() 将字符串转换为 snake_case 的命名方式. 但是数字前面不加下划线.</p>
+     *
+     * @param value 转换前的字符串.
+     * @return 转换后的字符串.
+     */
+    static snakeCase(value: any): string;
 }
 export declare type ModalFunc = {
     destroy: () => void;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kengic/vue",
-    "version": "0.25.1-beta.0",
+    "version": "0.25.1",
     "scripts": {
         "build": "npm run switch-node-version && rimraf dist && vue-tsc && vite build",
         "build:dev": "npm run switch-node-version && rimraf dist && vue-tsc && vite build --mode development",