zzz-pc-view 0.0.40 → 0.0.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zzz-pc-view",
-  "version": "0.0.40",
+  "version": "0.0.41",
   "main": "src/index.umd.js",
   "module": "src/index.es.js",
   "types": "src/index.d.ts",
@@ -23,6 +23,8 @@
     "echarts": "^5.5.1",
     "element-plus": "^2.9.1",
     "color-hash": "^2.0.2",
+    "@types/sortablejs": "^1.15.8",
+    "sortablejs": "^1.15.6",
     "animate.css": "^4.1.1",
     "mitt": "^3.0.1",
     "@types/mockjs": "^1.0.10",

package/src/api/own

@@ -3678,7 +3678,7 @@
       "id": "148",
       "parentId": "101",
       "type": 2,
-      "name": "MenuManage",
+      "name": "SystemNav",
       "path": "/system/menu",
       "permission": null,
       "title": "菜单管理",

package/src/decorators/CurdKey/CurdApi.d.ts

@@ -9,7 +9,7 @@ import { Reactive } from 'vue';
 export declare enum EditTypeEnum {
     CREATE = 1,
     DETAIL = 2,
-    UPDATE = 6
+    UPDATE = 3
 }
 /**
  * 定义编辑类型映射的常量对象。
@@ -48,7 +48,7 @@ export declare const editTypeMap: {
      * @property {string} label - 操作的标签，为'修改'。
      * @property {string} method - 操作的HTTP方法，为'PUT'。
      */
-    readonly 6: {
+    readonly 3: {
         readonly id: EditTypeEnum.UPDATE;
         readonly label: "修改";
         readonly method: "PUT";

package/src/decorators/CurdKey/index.d.ts

@@ -5,7 +5,7 @@ import { EditTypeEnum, CurdApi, EditType, PaginationResponse } from './CurdApi';
 import { Config as PrimaryKeyConfig } from './../PrimaryKey';
 import { Config as NameKeyConfig } from './../NameKey';
 import { RequestUtilResponse } from '../useRequestUtil';
-import { ZUtils } from '../../index-decorators';
+import { ZNavButton } from '../../webUtils';
 export * from './CurdApi';
 export * from './useCurdMock';
 /**
@@ -123,20 +123,32 @@ interface FormParam extends ComponentParam {
     steps?: FormStep[];
 }
 /**
- * 定义一个接口，用于描述 CURD 操作的参数。
- * 该接口包含一个标签、一个 CURD API 实例、一个可选的分页请求和一个子键。
- * 它还可以包含一个可选的组件创建器函数，用于创建表格和表单的参数。
- * @template T - 对象类型，默认为 object。
- * @interface CurdHandlerParam
- * @property {string} label - CURD 操作的标签。
- * @property {CurdApi<T>} api - CURD API 实例。
- * @property {PaginationRequest} [pagination] - 可选的分页请求。
- * @property {(this: CurdHandler<T>) => { tableParam?: ComponentParam; formParam?: FormParam }} [componentCreator] - 可选的组件创建器函数，用于创建表格和表单的参数。
+ * 定义一个泛型接口 CurdHandlerParam，用于配置 CURD 处理程序的参数。
+ * @template T - 数据对象的类型，默认为 object。
+ * @template P - 分页响应的类型，默认为 PaginationResponse<T>。
  */
 export interface CurdHandlerParam<T extends object = object, P extends PaginationResponse<T> = PaginationResponse<T>> {
+    /**
+     * 用于显示的标签，通常用于标题或描述。
+     */
     label: string;
+    /**
+     * 权限配置，记录了每个操作对应的导航按钮。
+     */
+    permission: Record<string, ZNavButton>;
+    /**
+     * 用于 CURD 操作的 API 实例，包含了与服务器交互的方法。
+     */
     api: CurdApi<T, P>;
+    /**
+     * 可选的分页请求配置，包含当前页码和每页显示的记录数。
+     */
     pagination?: PaginationRequest;
+    /**
+     * 可选的组件创建函数，用于动态创建表格和表单的参数。
+     * @param {CurdHandler<T, P>} this - 上下文对象，指向当前的 CurdHandler 实例。
+     * @returns {{ tableParam?: TableParam; formParam?: FormParam }} - 返回一个包含表格和表单参数的对象。
+     */
     componentCreator?(this: CurdHandler<T, P>): {
         tableParam?: TableParam;
         formParam?: FormParam;
@@ -209,6 +221,13 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      * @description 它会在组件初始化时被设置，并且在组件的整个生命周期中保持不变。
      */
     readonly label: string;
+    /**
+     * 定义一个只读属性，用于存储权限配置。
+     * 该属性是一个记录类型，键为字符串，值为 ZNavButton 类型。
+     * 它用于存储每个操作对应的导航按钮，以实现权限控制。
+     * 这个属性在组件初始化时被设置，并且在组件的整个生命周期中保持不变。
+     */
+    readonly permission: Record<string, ZNavButton>;
     /**
      * 创建一个浅引用，用于存储 CURD 操作的配置。
      * 这个引用将用于在组件中存储和更新 CURD 配置。
@@ -288,7 +307,9 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
         label?: string;
         desc?: string;
         index: number;
-        formItems: FormItemParam[];
+        formItemsGroup: (FormItemParam & {
+            propertyKey: KeyMatch<T, unknown>;
+        })[][];
     }[]>;
     /**
      * 获取显示的表单项的分组配置。
@@ -299,7 +320,9 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
         label?: string;
         desc?: string;
         index: number;
-        formItems: FormItemParam[];
+        formItemsGroup: (FormItemParam & {
+            propertyKey: KeyMatch<T, unknown>;
+        })[][];
     }[];
     /**
      * 定义一个只读属性，用于存储 CURD 操作的 API 实例。
@@ -382,7 +405,7 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      * @param {T} data - 包含名称的对象。
      * @returns {string} - 数据的名称，如果没有配置名称键，则返回一个空字符串。
      */
-    getDataName(data: T): "" | T[KeyMatch<T, ZUtils.KeyValType>];
+    getDataName(data: T): "" | T[KeyMatch<T, import('../../utils').KeyValType>];
     /**
      * 获取名称键配置。
      * 这个方法返回 nameKeyConfig 属性的值，它包含了名称键的配置信息。
@@ -577,6 +600,16 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      * @description 它会确保 formStepIndex 的值在 0 和 displayStepFormItemsGroup.length - 1 之间，以防止越界。
      */
     set formStepIndex(formStepIndex: number);
+    /**
+     * 更改表单步骤索引。
+     * 根据传入的方向参数（1 或 -1），决定是向前还是向后移动表单步骤。
+     * 如果方向为 1（向前），则先验证编辑器数据，验证通过后将步骤索引加 1。
+     * 如果方向为 -1（向后），则直接将步骤索引减 1。
+     *
+     * @param { -1 | 1 } direction - 方向参数，1 表示向前，-1 表示向后。
+     * @returns { void }
+     */
+    changeFormStepIndex(direction: -1 | 1): void;
     /**
      * 创建一个浅引用，用于存储编辑类型。
      * 这个引用将用于在组件中存储和更新编辑类型。
@@ -636,13 +669,13 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      */
     get editorDataLoadStatus(): boolean;
     /**
-     * 创建一个浅引用，用于存储编辑器数据。
-     * 这个引用将用于在组件中存储和更新编辑器数据。
-     * @type {shallowRef<T>}
-     * @description 这个引用是浅的，意味着它不会递归地观察嵌套对象的变化。
+     * 创建一个响应式引用，用于存储编辑器的数据。
+     * 这个引用将用于在组件中存储和更新编辑器的数据。
+     * @type {Ref<T | undefined>}
+     * @description 这个引用是响应式的，意味着它会在数据发生变化时自动更新。
      * @description 这对于性能优化很重要，因为它避免了不必要的更新。
      */
-    protected readonly editorDataRef: import('vue').ShallowRef<T | undefined, T | undefined>;
+    protected readonly editorDataRef: import('vue').Ref<T | undefined, T | undefined>;
     /**
      * 获取编辑器数据。
      * 这个方法返回 editorDataRef 引用的值，它包含了编辑器当前的数据。
@@ -681,6 +714,12 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      */
     closeEditor(): void;
     protected saveEditorDataRequestUtil: RequestUtilResponse;
+    /**
+     * 获取保存编辑器数据请求的加载状态。
+     * 该方法返回 `saveEditorDataRequestUtil` 的 `loadStatus` 属性值，用于判断保存编辑器数据的请求是否正在加载。
+     * @returns {boolean} - 保存编辑器数据请求的加载状态，true 表示正在加载，false 表示加载完成。
+     */
+    get saveEditorDataLoadStatus(): boolean;
     /**
      * 抽象方法，用于验证编辑器数据的有效性。
      * 这个方法会在打开编辑器之前被调用，用于执行一些验证逻辑。
@@ -688,7 +727,7 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      * @description 它会返回一个 Promise，如果验证通过，则继续打开编辑器；否则，抛出错误。
      * @returns {Promise<any>} - 返回一个 Promise，表示验证的结果。
      */
-    protected abstract validEditorData(): Promise<any>;
+    abstract validEditorData(): Promise<any>;
     /**
      * 定义一个抽象方法，用于在保存编辑器数据成功后执行的操作。
      * 这个方法会在编辑器数据成功保存到服务器后被调用，用于执行一些后续操作，例如提示用户保存成功、更新UI等。
@@ -707,9 +746,10 @@ export declare abstract class CurdHandler<T extends object = object, P extends P
      */
     saveEditorData(callback?: (data: T) => void): void;
     /**
-     * 保存编辑器数据并继续创建。
-     * 这个方法会将当前步骤索引重置为0，然后调用saveEditorData方法保存编辑器数据。
-     * 在保存成功后，它会创建一个新的编辑器数据实例，并将其设置为编辑器的数据。
+     * 保存编辑器数据并继续创建新数据。
+     * 此方法会调用 `saveEditorData` 方法保存当前编辑器中的数据，
+     * 当保存成功后，将表单步骤索引重置为 0，并使用新创建的实例重置编辑器数据，以便用户继续创建新数据。
+     *
      * @returns {void}
      */
     editorDataSaveAndContinue(): void;

package/src/decorators/DeclareType.d.ts

@@ -28,7 +28,7 @@ export type ComponentProps = Record<PropertyKey, unknown>;
  * 定义一个类型别名，用于描述事件处理函数映射。
  * 该类型别名是一个记录类型，键为字符串，值为函数类型，函数接受任意数量的未知类型参数，并且不返回任何值。
  */
-export type EventHandlerMap = Record<string, (...args: unknown[]) => void>;
+export type EventHandlerMap = Record<string, (...args: any[]) => void>;
 /**
  * 导出一个空对象，用于确保该模块有一个默认导出。
  */

package/src/decorators/FilterKey/index.d.ts

@@ -210,12 +210,12 @@ export declare abstract class FilterHandler<Q extends object> extends ConfigsCre
      */
     protected validateQuery(): Promise<void>;
     /**
-     * 定义一个受保护的方法 `search`，用于执行搜索操作。
-     * 该方法首先调用 `validateQuery` 方法来验证查询。
-     * 如果验证成功，则调用 `onValidateQuerySuccess` 方法。
-     * 如果验证失败，则调用 `onValidateQueryFail` 方法，并传递错误对象。
+     * 执行搜索操作，该方法会先验证查询的有效性，然后根据验证结果执行相应的回调函数。
+     * 此方法是过滤器处理程序的核心逻辑之一，用于确保在进行搜索操作之前，查询数据是有效的。
+     *
+     * @returns {void}
      */
-    protected search(): void;
+    search(): void;
     /**
      * 获取查询加载状态存储对象。
      * 该方法返回全局的加载状态存储对象 `loadStore`。