zzz-pc-view 0.0.24 → 0.0.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zzz-pc-view",
-  "version": "0.0.24",
+  "version": "0.0.26",
   "main": "src/index.umd.js",
   "module": "src/index.es.js",
   "types": "src/index.d.ts",

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

@@ -1,5 +1,5 @@
 import { AxiosResponse } from 'axios';
-import { httpRequest, CombineInstanceType, KeyMatch } from '../../utils';
+import { httpRequest, KeyMatch } from '../../utils';
 import { TypeWithPrototype, TypeWithPrototypeWithoutNew } from '../DeclareType';
 import { Reactive } from 'vue';
 /**
@@ -78,15 +78,15 @@ export interface PaginationResponse<T> {
  * 定义分页响应构造函数的接口。
  * @template T - 响应中列表项的类型。
  */
-export interface PaginationResponseConstructor<T> extends TypeWithPrototypeWithoutNew {
-    new (data: unknown): PaginationResponse<T>;
+export interface PaginationResponseConstructor<T, P extends PaginationResponse<T> = PaginationResponse<T>> extends TypeWithPrototypeWithoutNew {
+    new (data: any): P;
 }
 /**
  * 定义 CURD（创建、读取、更新、删除）操作的 API 类。
  * @template T - 表示操作的数据类型，默认为 `object`。
  * @template P - 表示分页响应的构造函数类型，默认为 `PaginationResponseConstructor<T>`。
  */
-export declare class CurdApi<T extends object = object, P extends PaginationResponseConstructor<T> = PaginationResponseConstructor<T>> {
+export declare class CurdApi<T extends object = object, P extends PaginationResponse<T> = PaginationResponse<T>> {
     /**
      * 目标类的构造函数。
      * @protected
@@ -122,7 +122,7 @@ export declare class CurdApi<T extends object = object, P extends PaginationResp
      * @protected
      * @type {P}
      */
-    protected readonly PaginationResponseClass?: P;
+    protected readonly PaginationResponseClass?: PaginationResponseConstructor<T, P>;
     get hasServerPagination(): boolean;
     /**
      * 是否使用文件上传保存数据。
@@ -144,9 +144,9 @@ export declare class CurdApi<T extends object = object, P extends PaginationResp
      * 分页获取列表数据。
      * @param {object} pagination - 分页参数。
      * @param {T | Reactive<T>} [query] - 查询参数。
-     * @returns {Promise<CombineInstanceType<P>>} - 返回一个包含分页数据的 Promise。
+     * @returns {Promise<P>} - 返回一个包含分页数据的 Promise。
      */
-    getListByPage(pagination: object, query?: T | Reactive<T>): httpRequest.HttpRequestPromise<Awaited<CombineInstanceType<P>>>;
+    getListByPage(pagination: object, query?: T | Reactive<T>): httpRequest.HttpRequestPromise<Awaited<P>>;
     /**
      * 获取指定数据的详细信息。
      * 这个方法会根据传入的数据对象的ID，从API获取该数据的详细信息，并将其绑定到目标类。
@@ -208,7 +208,7 @@ export declare class CurdApi<T extends object = object, P extends PaginationResp
         TargetPrototye: T;
         basePath: string;
         treeKey?: CurdApi<T, P>['treeKey'];
-        PaginationResponseClass?: P;
+        PaginationResponseClass?: PaginationResponseConstructor<T, P>;
         saveWithUploadFile?: boolean;
     });
     /**

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

@@ -1,10 +1,11 @@
-import { httpRequest, CombineClass, CombineInstanceType, KeyMatch, WithoutFirst } from '../../utils';
+import { CombineClass, CombineInstanceType, KeyMatch, WithoutFirst } from '../../utils';
 import { BasePropertyConfig, ComponentProps, EventHandlerMap, TypeWithPrototype } from '../DeclareType';
 import { FilterHandler } from '../FilterKey';
-import { EditTypeEnum, CurdApi, EditType, PaginationResponseConstructor } from './CurdApi';
+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';
 export * from './CurdApi';
 /**
  * 基础参数接口，用于定义通用的参数属性。
@@ -131,11 +132,11 @@ interface FormParam extends ComponentParam {
  * @property {PaginationRequest} [pagination] - 可选的分页请求。
  * @property {(this: CurdHandler<T>) => { tableParam?: ComponentParam; formParam?: FormParam }} [componentCreator] - 可选的组件创建器函数，用于创建表格和表单的参数。
  */
-export interface CurdHandlerParam<T extends object = object> {
+export interface CurdHandlerParam<T extends object = object, P extends PaginationResponse<T> = PaginationResponse<T>> {
     label: string;
-    api: CurdApi<T>;
+    api: CurdApi<T, P>;
     pagination?: PaginationRequest;
-    componentCreator?(this: CurdHandler<T>): {
+    componentCreator?(this: CurdHandler<T, P>): {
         tableParam?: TableParam;
         formParam?: FormParam;
     };
@@ -185,11 +186,11 @@ export declare enum CreateTypeEnum {
  * @property {new (createType: CreateTypeEnum, ...args: any[]): T} - 一个新的构造函数，接受一个 CreateTypeEnum 类型的参数和任意数量的参数，并返回一个 T 类型的实例。
  * @property {CurdHandler<T>} [classCurdKey] - 一个可选的属性，用于存储 CurdHandler 实例。
  */
-export interface CurdModelConstructor<T extends object = object> extends TypeWithPrototype, CombineClass {
+export interface CurdModelConstructor<T extends object = object, P extends PaginationResponse<T> = PaginationResponse<T>> extends TypeWithPrototype, CombineClass {
     new (createType: CreateTypeEnum, ...args: any[]): T;
-    [classCurdKey]?: CurdHandler<T>;
+    [classCurdKey]?: CurdHandler<T, P>;
 }
-export declare abstract class CurdHandler<T extends object = object> extends FilterHandler<T> {
+export declare abstract class CurdHandler<T extends object = object, P extends PaginationResponse<T> = PaginationResponse<T>> extends FilterHandler<T> {
     readonly curdTargetPrototype: T;
     /**
      * 定义一个只读属性，用于存储 CURD 操作的目标模型构造函数。
@@ -198,7 +199,7 @@ export declare abstract class CurdHandler<T extends object = object> extends Fil
      * @description 这个属性是只读的，意味着它不能被直接修改。
      * @description 它会在组件初始化时被设置，并且在组件的整个生命周期中保持不变。
      */
-    protected readonly CurdTarget: CurdModelConstructor<T>;
+    protected readonly CurdTarget: CurdModelConstructor<T, P>;
     /**
      * 定义一个只读属性，用于存储表单项的标签。
      * 这个属性将用于在组件中显示表单项的标签。
@@ -306,7 +307,7 @@ export declare abstract class CurdHandler<T extends object = object> extends Fil
      * @description 这个属性是只读的，意味着它不能被直接修改。
      * @description 它会在组件初始化时被设置，并且在组件的整个生命周期中保持不变。
      */
-    protected readonly api: CurdApi<T, PaginationResponseConstructor<T>>;
+    protected readonly api: CurdApi<T, P>;
     /**
      * 定义一个可选的只读属性，用于存储分页配置。
      * 这个属性将用于在组件中控制分页行为。
@@ -380,7 +381,7 @@ export declare abstract class CurdHandler<T extends object = object> extends Fil
      * @param {T} data - 包含名称的对象。
      * @returns {string} - 数据的名称，如果没有配置名称键，则返回一个空字符串。
      */
-    getDataName(data: T): "" | T[KeyMatch<T, import('../../utils').KeyValType>];
+    getDataName(data: T): "" | T[KeyMatch<T, ZUtils.KeyValType>];
     /**
      * 获取名称键配置。
      * 这个方法返回 nameKeyConfig 属性的值，它包含了名称键的配置信息。
@@ -533,11 +534,19 @@ export declare abstract class CurdHandler<T extends object = object> extends Fil
      */
     delete(data: T): void;
     /**
-     * 导出数据。
-     * 这个方法调用API的导出方法，并传递当前的查询参数。
-     * @returns {Promise<any>} - 返回一个Promise，表示导出操作的结果。
+     * 定义一个受保护的只读属性，用于存储导出数据请求工具的响应。
+     * 这个属性将用于在组件中处理导出数据请求的加载状态和取消请求。
+     * @type {RequestUtilResponse}
+     * @description 这个属性是受保护的，意味着它只能在当前类或其子类中访问。
+     * @description 它会在组件初始化时被设置，并且在组件的整个生命周期中保持不变。
+     */
+    protected exportRequestUtil: RequestUtilResponse;
+    /**
+     * 执行数据导出操作。
+     * 该方法会设置导出请求的加载状态，发起导出请求，处理请求结果，并在请求结束后重置加载状态。
+     * @returns {Promise<any>} - 返回一个Promise，表示导出请求的结果。
      */
-    export(): httpRequest.HttpRequestPromise<void>;
+    export(): Promise<void>;
     /**
      * 创建一个浅引用，用于存储当前步骤的索引。
      * 这个引用将用于在组件中存储和更新当前步骤的索引。
@@ -725,7 +734,7 @@ export declare abstract class CurdHandler<T extends object = object> extends Fil
      * @param {CurdHandlerParam<T>} param - 包含API和分页配置的参数对象。
      * @param {...WithoutFirst<ConstructorParameters<typeof FilterHandler<T>>>} args - 传递给父类构造函数的参数。
      */
-    constructor(curdTargetPrototype: T, param: CurdHandlerParam<T>, ...args: WithoutFirst<ConstructorParameters<typeof FilterHandler<T>>>);
+    constructor(curdTargetPrototype: T, param: CurdHandlerParam<T, P>, ...args: WithoutFirst<ConstructorParameters<typeof FilterHandler<T>>>);
     /**
      * 根据目标对象的原型获取对应的 CURD 实例。
      * 这个静态方法会通过目标对象的构造函数来获取其原型上的 CURD 实例。
@@ -733,7 +742,7 @@ export declare abstract class CurdHandler<T extends object = object> extends Fil
      * @returns {CurdHandler<T> | undefined} - 返回 CURD 实例，如果不存在则返回 undefined。
      * @template T - 目标对象的类型。
      */
-    static getCurdInstance<T extends object>(curdTargetPrototype: T): CurdHandler<T> | undefined;
+    static getCurdInstance<T extends object>(curdTargetPrototype: T): CurdHandler<T, PaginationResponse<T>> | undefined;
 }
 /**
  * 定义一个装饰器，用于设置对象原型的配置。