@kengic/vue 0.5.38 → 0.6.1-beta.0

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

@@ -1,5 +1,7 @@
+import { RuleObject } from 'ant-design-vue/es/form';
+import { FormInstance } from 'ant-design-vue/lib/form/Form';
 import { Ref } from 'vue';
-import { IRemoveEventListenerHandler } from '../../consts';
+import { IRemoveEventListenerHandler, KG_VAR_SUBMIT__DISPLAY_TYPE } from '../../consts';
 import { IKgSubmitAfterValidateCb, IKgSubmitBeforeOkCb, IKgSubmitBeforeRequestCb, IKgSubmitCloseCb, IKgSubmitOkCb, IKgSubmitOpenCb, IKgSubmitStore } from './index.store';
 export declare type IUseKgSubmit = {
     formID: string;
@@ -7,10 +9,12 @@ export declare type IUseKgSubmit = {
     store: IKgSubmitStore;
     /** 表单数据对象. */
     model: Ref<Record<string, any>>;
+    formRef: Ref<FormInstance | null>;
+    rules: Ref<Record<string, Array<RuleObject>>>;
+    /** 显示方式. */
+    displayType: Ref<KG_VAR_SUBMIT__DISPLAY_TYPE>;
     /** 监听事件: 打开抽屉. */
     onOpen(cb: IKgSubmitOpenCb): IRemoveEventListenerHandler;
-    /** 监听事件: 关闭抽屉. 点击取消或者点击确定并且成功之后, 都会触发 */
-    onClose(cb: IKgSubmitCloseCb): IRemoveEventListenerHandler;
     /** 监听事件: 点击保存按钮之后, 执行默认逻辑之前. 可以在此时修改表单的值; 可以在此时对表单的值进行验证, 如果返回 true 表示表单验证失败, 不会再执行后面的代码. */
     onBeforeOk(cb: IKgSubmitBeforeOkCb): IRemoveEventListenerHandler;
     /** 监听事件: 点击保存按钮之后, 表单验证成功. 如果返回 true, 不会再执行后面的代码. */
@@ -19,6 +23,8 @@ export declare type IUseKgSubmit = {
     onBeforeRequest(cb: IKgSubmitBeforeRequestCb): IRemoveEventListenerHandler;
     /** 监听事件: 点击保存按钮之后, 执行默认逻辑之后, 调用接口成功, 即将关闭抽屉. */
     onOk(cb: IKgSubmitOkCb): IRemoveEventListenerHandler;
+    /** 监听事件: 关闭抽屉. 点击取消或者点击确定并且成功之后, 都会触发 */
+    onClose(cb: IKgSubmitCloseCb): IRemoveEventListenerHandler;
 };
 /**
  * @param formID 界面标识.

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

@@ -1,4 +1,5 @@
 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 { IKgTableRow } from '../KgTable';
@@ -72,11 +73,17 @@ export interface IKgSubmitState {
     isLoadingMap: Map<string, boolean>;
     /** 表单数据对象. */
     modelMap: Map<string, Record<string, any>>;
+    /** 表单对象. */
+    formRefMap: Map<string, Ref<FormInstance | null>>;
+    /** 表单验证规则. 在 beforeOk 事件中会将该对象传给调用者, 调用者可以修改该对象, 从而添加自定义的验证规则. */
+    rulesMap: Map<string, Ref<Record<string, Array<RuleObject>>>>;
 }
 export declare type IKgSubmitStoreDefinition = StoreDefinition<'KgSubmit', IKgSubmitState, {
     /** 是否处于加载状态. */
     isLoading(): (formID?: string | null) => boolean;
     getModel(): (formID?: string | null) => Record<string, any> | null;
+    getFormRef(): (formID?: string | null) => Ref<FormInstance | null>;
+    getRules(): (formID?: string | null) => Ref<Record<string, Array<RuleObject>>>;
 }, {
     dispose(formID?: string | null): void;
     addEventListener(formID: string, event: IKgSubmitEvent, cb: IKgSubmitCb): void;

package/dist/src/components/KgTable/components/setting/KgTable.Setting.d.ts

@@ -1,6 +1,3 @@
 import './KgTable.Setting.less';
-export declare const getProps: () => any;
-declare const _default: import("vue").DefineComponent<any, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<any>, {} | {
-    [x: string]: any;
-}>;
+declare const _default: import("vue").DefineComponent<{}, () => JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<import("vue").ExtractPropTypes<{}>>, {}>;
 export default _default;

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

@@ -1,4 +1,4 @@
-import { ComputedRef } from 'vue';
+import { ComputedRef, Ref } from 'vue';
 import { IRemoveEventListenerHandler } from '../../consts';
 import { IKgTableRetrieveCb, IKgTableRowDoubleClickCb, IKgTableStore } from './index.store';
 export declare type IUseKgTable = {
@@ -11,6 +11,22 @@ export declare type IUseKgTable = {
     selectedRow: ComputedRef<ReturnType<IKgTableStore['getSelectedRow']>>;
     /** 当前勾选的所有行. */
     selectedRows: ComputedRef<ReturnType<IKgTableStore['getSelectedRows']>>;
+    /** 是否支持多选. */
+    isMultiSelect: Ref<boolean>;
+    /** 是否自动查询. */
+    isReadAutomatically: Ref<boolean>;
+    /** 是否显示底部左侧. */
+    isShowBottomLeft: Ref<boolean>;
+    /** 是否显示底部右侧. */
+    isShowBottomRight: Ref<boolean>;
+    /** 主键字段. */
+    id: Ref<string>;
+    /** 所有分页选项. */
+    pageSizeOptions: Ref<Array<number>>;
+    /** 当前分页选项. */
+    pageSizeOption: Ref<number>;
+    /** 查询条件的界面标识. */
+    profileFormID: Ref<string>;
     /** 监听事件: 双击某行. */
     onRowDoubleClick(cb: IKgTableRowDoubleClickCb): IRemoveEventListenerHandler;
     /** 监听事件: 查询数据成功. */

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

@@ -26,12 +26,17 @@ export interface IKgTableCellDisplayTypeProperties {
          * 显示为'是'的值.
          * @default 1
          */
-        yValue: any;
+        yValue?: any;
         /**
          * 显示为'否'的值.
          * @default 0
          */
-        nValue: any;
+        nValue?: any;
+        /**
+         * 是否将 null/undefined 当成 false.
+         * @default false
+         */
+        nilAsFalse?: boolean;
     };
     ENUM: Array<{
         /** 变量名称. */
@@ -88,3 +93,5 @@ export declare const KG_TABLE_TD_MAX_WIDTH = 1920;
 export declare const KG_TABLE_TD_CHECK_WIDTH = 32;
 /** 序号列的宽度. */
 export declare const KG_TABLE_TD_INDEX_WIDTH = 40;
+/** 在表格内创建时, 空白行的临时主键. */
+export declare const ID_CREATE = "_ID_CREATE";

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

@@ -25,6 +25,11 @@ export declare type IUseKgVar = {
     isOtherRequesting: ComputedRef<ReturnType<IKgVarStore['isOtherRequesting']>>;
     /** 所有的 VarButton 列表. */
     varButtons: ComputedRef<ReturnType<IKgVarStore['getVarButtons']>>;
+    varButtonSearch: ComputedRef<ReturnType<IKgVarStore['getVarButtonSearch']>>;
+    varButtonCreate: ComputedRef<ReturnType<IKgVarStore['getVarButtonCreate']>>;
+    varButtonUpdate: ComputedRef<ReturnType<IKgVarStore['getVarButtonUpdate']>>;
+    varButtonCopy: ComputedRef<ReturnType<IKgVarStore['getVarButtonCopy']>>;
+    varButtonDelete: ComputedRef<ReturnType<IKgVarStore['getVarButtonDelete']>>;
     /** 所有的 VarProfileMaster 列表. */
     varProfileMasters: ComputedRef<ReturnType<IKgVarStore['getVarProfileMasters']>>;
     /** 当前的 VarProfileMaster. */

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

@@ -3,9 +3,17 @@ import './KgYesOrNo.less';
 export declare const getProps: () => {
     /**
      * 布尔数据.
-     * @default false
+     * @default undefined
      */
     kgValue: {
+        type: PropType<boolean>;
+        default: undefined;
+    };
+    /**
+     * 是否将 null/undefined 当成 false.
+     * @default false
+     */
+    kgNilAsFalse: {
         type: PropType<boolean>;
         default: boolean;
     };
@@ -14,22 +22,39 @@ export declare type IKgYesOrNoProps = Partial<ExtractPropTypes<ReturnType<typeof
 declare const _default: import("vue").DefineComponent<{
     /**
      * 布尔数据.
-     * @default false
+     * @default undefined
      */
     kgValue: {
+        type: PropType<boolean>;
+        default: undefined;
+    };
+    /**
+     * 是否将 null/undefined 当成 false.
+     * @default false
+     */
+    kgNilAsFalse: {
         type: PropType<boolean>;
         default: boolean;
     };
-}, () => JSX.Element, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<ExtractPropTypes<{
+}, () => JSX.Element | null, unknown, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps, Readonly<ExtractPropTypes<{
     /**
      * 布尔数据.
-     * @default false
+     * @default undefined
      */
     kgValue: {
+        type: PropType<boolean>;
+        default: undefined;
+    };
+    /**
+     * 是否将 null/undefined 当成 false.
+     * @default false
+     */
+    kgNilAsFalse: {
         type: PropType<boolean>;
         default: boolean;
     };
 }>>, {
     kgValue: boolean;
+    kgNilAsFalse: boolean;
 }>;
 export default _default;

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

@@ -1,3 +1,4 @@
+export * from './KgAppSelect';
 export * from './KgModal';
 export * from './KgProgressA';
 export * from './KgResizable';

package/dist/src/config/index.store.d.ts

@@ -1,8 +1,19 @@
 import { Pinia, StoreDefinition } from 'pinia';
 import { ComputedRef } from 'vue';
 import { Router } from 'vue-router';
-import { IKgLocale } from '../consts';
+import { IKgLocale, KG_APP } from '../consts';
 export declare type IKgStateOption = {
+    /** 模块首页. */
+    appIndex?: {
+        /** 默认为 '/wms/data-manager/index'. */
+        [KG_APP.WMS_DATA_MANAGER]?: string;
+        /** 默认为 '/wms/business-manager/index'. */
+        [KG_APP.WMS_BUSINESS_MANAGER]?: string;
+        /** 默认为 '/wcs/index'. */
+        [KG_APP.WCS]?: string;
+        /** 默认为 '/sys/index'. */
+        [KG_APP.SYS]?: string;
+    };
     /** 仓库选择. */
     KgWarehouse?: {
         /** 是否启用. */

package/dist/src/config/setup.d.ts

@@ -15,14 +15,14 @@ export declare function pinia(): Pinia | null;
 export declare type IKgOptions = {
     app: App;
     pinia: Pinia;
-    /** 语言. */
+    /** 当前语言. */
     locale: ComputedRef<IKgLocale>;
     /**
      * import { createI18n } from 'vue-i18n';
      * ReturnType<typeof createI18n>
      */
     i18n: any;
-    /** 检查权限的方法. */
+    /** 权限方法, 用来判断是否具有某个(某些)权限. */
     pFunction: P;
     router: Router;
     /** 配置参数. */

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

@@ -1,5 +1,11 @@
 declare const _default: {
     kg: {
+        KgAppSelect: {
+            businessManager: string;
+            dataManager: string;
+            sys: string;
+            tooltip: string;
+        };
         KgFormItem: {
             mustGT: string;
             mustGTE: string;

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

@@ -1,5 +1,11 @@
 declare const _default: {
     kg: {
+        KgAppSelect: {
+            businessManager: string;
+            dataManager: string;
+            sys: string;
+            tooltip: string;
+        };
         KgFormItem: {
             mustGT: string;
             mustGTE: string;

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

@@ -3,16 +3,18 @@ export * from './index.vm';
 export * from './injection-keys.const';
 /** 模块. */
 export declare const enum KG_APP {
-    DATA_MANAGER = "data-manager",
-    BUSINESS_MANAGER = "business-manager",
+    WMS_DATA_MANAGER = "data-manager",
+    WMS_BUSINESS_MANAGER = "business-manager",
+    WCS = "wcs",
     SYS = "sys"
 }
 /** 所有模块. */
 export declare const KG_APPS: Array<KG_APP>;
 /** 模块路径前缀. */
 export declare const enum KG_APP_PREFIX {
-    DATA_MANAGER = "/wms/data-manager",
-    BUSINESS_MANAGER = "/wms/business-manager",
+    WMS_DATA_MANAGER = "/wms/data-manager",
+    WMS_BUSINESS_MANAGER = "/wms/business-manager",
+    WCS = "/wcs",
     SYS = "/sys"
 }
 /** 所有模块路径前缀. */
@@ -55,8 +57,10 @@ export declare const enum KG_FORM_ITEM_TYPE {
 export declare const enum KG_FORM_CONTEXT {
     /** 位于查询条件. */
     SEARCH = "SEARCH",
-    /** 位于表单(创建/更新/复制/...). */
-    SUBMIT = "SUBMIT"
+    /** 位于表单. */
+    SUBMIT = "SUBMIT",
+    /** 位于表格. */
+    TABLE = "TABLE"
 }
 /**
  * 表格单元格的显示类型.
@@ -74,7 +78,7 @@ export declare const enum KG_TABLE_CELL_DISPLAY_TYPE {
     FILE_SIZE = "FILE_SIZE",
     /** 显示为超链接, 点击打开更新弹窗. */
     UPDATE_LINK = "UPDATE_LINK",
-    /** 显示为超链接, 点击跳转到其他页面. */
+    /** 显示为超链接, 点击跳转到其他路由. */
     ROUTE_LINK = "ROUTE_LINK"
 }
 /** 按钮类型. */
@@ -119,7 +123,9 @@ export declare const enum KG_VAR_SUBMIT__DISPLAY_TYPE {
     /** 弹窗. */
     MODAL = "MODAL",
     /** 抽屉. */
-    DRAWER = "DRAWER"
+    DRAWER = "DRAWER",
+    /** 在表格内. */
+    TABLE = "TABLE"
 }
 /** 表单布局方式. */
 export declare const enum KG_VAR_SUBMIT__LAYOUT {

package/dist/src/helpers/ant-design-vue.d.ts

@@ -9,11 +9,11 @@ export declare const formProps: () => {
     layout: PropType<"horizontal" | "inline" | "vertical">;
     labelCol: {
         type: PropType<Partial<ExtractPropTypes<{
-            span: (StringConstructor | NumberConstructor)[];
-            order: (StringConstructor | NumberConstructor)[];
-            offset: (StringConstructor | NumberConstructor)[];
-            push: (StringConstructor | NumberConstructor)[];
-            pull: (StringConstructor | NumberConstructor)[];
+            span: (NumberConstructor | StringConstructor)[];
+            order: (NumberConstructor | StringConstructor)[];
+            offset: (NumberConstructor | StringConstructor)[];
+            push: (NumberConstructor | StringConstructor)[];
+            pull: (NumberConstructor | StringConstructor)[];
             xs: {
                 type: PropType<string | number | import("ant-design-vue/lib/grid").ColSize>;
                 default: string | number | import("ant-design-vue/lib/grid").ColSize;
@@ -43,16 +43,16 @@ export declare const formProps: () => {
                 default: string | number | import("ant-design-vue/lib/grid").ColSize;
             };
             prefixCls: StringConstructor;
-            flex: (StringConstructor | NumberConstructor)[];
+            flex: (NumberConstructor | StringConstructor)[];
         }>> & HTMLAttributes>;
     };
     wrapperCol: {
         type: PropType<Partial<ExtractPropTypes<{
-            span: (StringConstructor | NumberConstructor)[];
-            order: (StringConstructor | NumberConstructor)[];
-            offset: (StringConstructor | NumberConstructor)[];
-            push: (StringConstructor | NumberConstructor)[];
-            pull: (StringConstructor | NumberConstructor)[];
+            span: (NumberConstructor | StringConstructor)[];
+            order: (NumberConstructor | StringConstructor)[];
+            offset: (NumberConstructor | StringConstructor)[];
+            push: (NumberConstructor | StringConstructor)[];
+            pull: (NumberConstructor | StringConstructor)[];
             xs: {
                 type: PropType<string | number | import("ant-design-vue/lib/grid").ColSize>;
                 default: string | number | import("ant-design-vue/lib/grid").ColSize;
@@ -82,7 +82,7 @@ export declare const formProps: () => {
                 default: string | number | import("ant-design-vue/lib/grid").ColSize;
             };
             prefixCls: StringConstructor;
-            flex: (StringConstructor | NumberConstructor)[];
+            flex: (NumberConstructor | StringConstructor)[];
         }>> & HTMLAttributes>;
     };
     colon: {
@@ -166,7 +166,7 @@ export declare const modalProps: () => {
         type: BooleanConstructor;
         default: undefined;
     };
-    width: (StringConstructor | NumberConstructor)[];
+    width: (NumberConstructor | StringConstructor)[];
     footer: PropType<any>;
     okText: PropType<any>;
     okType: PropType<LegacyButtonType>;

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

@@ -1,7 +1,7 @@
 /**
  * DOM 工具.
  */
-export declare class DomUtil {
+export declare class KgDomUtil {
     /**
      * 判断元素是否不能响应点击事件.
      * 如果不想让某个元素响应点击事件, 则可以给它的父元素加上 kg-not-clickable 样式类.

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

@@ -1,5 +1,5 @@
-export * from './app.util';
 export * from './dom.util';
 export * from './kg.util';
 export * from './logger.util';
 export * from './route.util';
+export * from './var.util';

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

@@ -24,7 +24,7 @@ export declare class KgUtil {
      */
     static downloadFile(data: string | BlobPart, fileName: string, contentType?: string): void;
     /**
-     * 解析请求参数.
+     * 处理请求参数.
      *     1. 填充通用参数的值
      *         a. 仓库: '{WAREHOUSE}'
      * @param params 请求参数.
@@ -33,12 +33,12 @@ export declare class KgUtil {
      */
     static parseParams(params?: Record<string, any> | null, formID?: string, $dayjs?: typeof dayjs): any;
     /**
-     * 解析请求参数: 解析字符串类型的参数值.
+     * 处理请求参数: 解析字符串类型的参数值.
      * @param value 参数的原始值.
      */
     private static parseParamFromString;
     /**
-     * 解析请求参数: 解析 DayJS 类型的参数值.
+     * 处理请求参数: 解析 DayJS 类型的参数值.
      * @param key 属性名.
      * @param value 参数的原始值.
      * @param formID 界面标识.

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

@@ -1,4 +1,4 @@
-import { Menu } from '../consts';
+import { KG_APP, Menu } from '../consts';
 export declare class KgRouteUtil {
     /**
      * 给所有模块都添加在线表单的路由.
@@ -18,4 +18,20 @@ export declare class KgRouteUtil {
      * @param titleKey 标题的属性名, 即要将哪个属性作为菜单的标题.
      */
     static translateMenus(menus?: Array<Menu> | null, titleKey?: string): Array<Menu>;
+    /**
+     * 判断某个路径是否属于某个模块.
+     * @param path 路径.
+     * @param app 模块.
+     */
+    static isPathInApp(path: string | undefined | null, app: KG_APP | null): boolean;
+    /**
+     * 根据地址获取模块.
+     * @param path 地址.
+     */
+    static getAppByPath(path: string): KG_APP;
+    /**
+     * 根据模块获取该模块的首页地址.
+     * @param app 模块.
+     */
+    static getAppIndexPath(app: KG_APP): string;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@kengic/vue",
-    "version": "0.5.38",
+    "version": "0.6.1-beta.0",
     "scripts": {
         "build": "rimraf dist && vue-tsc && vite build",
         "build:dev": "rimraf dist && vue-tsc && vite build --mode development",
@@ -46,7 +46,7 @@
         "vue-router": "4.1.6"
     },
     "devDependencies": {
-        "@kengic/pont": "1.2.10-beta.37",
+        "@kengic/pont": "1.2.10-beta.42",
         "@types/lodash-es": "~4.17.7",
         "@types/node": "~18.14.6",
         "@types/semver": "~7.3.13",

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

@@ -1,17 +0,0 @@
-import { KG_APP } from '../consts';
-/**
- * 判断某个路径是否属于某个模块.
- * @param path 路径.
- * @param app 模块.
- */
-export declare function isPathInApp(path: string | undefined | null, app: KG_APP): boolean;
-/**
- * 根据地址获取模块.
- * @param path 地址.
- */
-export declare function getAppByPath(path: string): KG_APP;
-/**
- * 根据模块获取首页地址.
- * @param app 模块.
- */
-export declare function getAppIndexPath(app: KG_APP): string;