@ibiz-template/runtime 0.7.41-alpha.10 → 0.7.41-alpha.100

package/out/interface/api/util/i-api-change-tracker.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @description 历史项
+ * @export
+ * @interface IApiChangeHistoryItem
+ * @template T
+ */
+export interface IApiChangeHistoryItem<T> {
+    /**
+     * @description 状态
+     * @type {T}
+     * @memberof IApiChangeHistoryItem
+     */
+    state: T;
+    /**
+     * @description 时间戳
+     * @type {number}
+     * @memberof IApiChangeHistoryItem
+     */
+    timestamp: number;
+}
+/**
+ * @description 变更追踪器接口
+ * @export
+ * @interface IApiChangeTracker
+ */
+export interface IApiChangeTracker<T> {
+    /**
+     * @description 添加状态
+     * @param {T} state 新状态
+     * @memberof IApiChangeTracker
+     */
+    add(state: T): void;
+    /**
+     * @description 清空历史状态并重置状态
+     * @param {T} state 新状态
+     * @memberof IApiChangeTracker
+     */
+    reset(state: T): void;
+    /**
+     * @description 撤销上一步操作
+     * @returns {*}  {(T | null)} 撤销后的状态或null（如果没有可撤销的操作）
+     * @memberof IApiChangeTracker
+     */
+    undo(): T | null;
+    /**
+     * @description 重做下一步操作
+     * @returns {*}  {(T | null)} 重做后的状态或null（如果没有可重做的操作）
+     * @memberof IApiChangeTracker
+     */
+    redo(): T | null;
+    /**
+     * @description 获取当前状态
+     * @returns {*}  {(T | null)} 当前状态或null（如果未初始化）
+     * @memberof IApiChangeTracker
+     */
+    getState(): T | null;
+    /**
+     * @description 是否可以撤销
+     * @returns {*}  {boolean}
+     * @memberof IApiChangeTracker
+     */
+    canUndo(): boolean;
+    /**
+     * @description 是否可以重做
+     * @returns {*}  {boolean}
+     * @memberof IApiChangeTracker
+     */
+    canRedo(): boolean;
+    /**
+     * @description 清空历史记录（保留当前状态）
+     * @memberof IApiChangeTracker
+     */
+    clearHistory(): void;
+    /**
+     * @description 获取历史记录长度信息
+     * @returns {*}  {{ past: number; future: number }}
+     * @memberof IApiChangeTracker
+     */
+    getHistorySize(): {
+        past: number;
+        future: number;
+    };
+}
+//# sourceMappingURL=i-api-change-tracker.d.ts.map

package/out/interface/api/util/i-api-change-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-api-change-tracker.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-change-tracker.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC;;;;OAIG;IACH,KAAK,EAAE,CAAC,CAAC;IACT;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAEpB;;;;OAIG;IACH,KAAK,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAEtB;;;;OAIG;IACH,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC;IAEjB;;;;OAIG;IACH,IAAI,IAAI,CAAC,GAAG,IAAI,CAAC;IAEjB;;;;OAIG;IACH,QAAQ,IAAI,CAAC,GAAG,IAAI,CAAC;IAErB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC;IAEnB;;;OAGG;IACH,YAAY,IAAI,IAAI,CAAC;IAErB;;;;OAIG;IACH,cAAc,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD"}

package/out/interface/api/util/i-api-change-tracker.js

@@ -0,0 +1 @@
+export {};

package/out/interface/api/util/i-api-confirm-util.d.ts

@@ -31,29 +31,29 @@ export interface IApiConfirmParams {
  */
 export interface IApiConfirmUtil {
     /**
-     * @description 弹出普通信息
-     * @param {IApiConfirmParams} params
+     * @description 显示普通信息确认框，用户确认返回 true
+     * @param {IApiConfirmParams} params 确认框参数
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiConfirmUtil
      */
     info(params: IApiConfirmParams): Promise<boolean>;
     /**
-     * @description 弹出成功信息
-     * @param {IApiConfirmParams} params
+     * @description 显示成功类型确认框，常用于用户确认提示
+     * @param {IApiConfirmParams} params 确认框参数
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiConfirmUtil
      */
     success(params: IApiConfirmParams): Promise<boolean>;
     /**
-     * @description 弹出警告信息
-     * @param {IApiConfirmParams} params
+     * @description 显示警告类型确认框，常用于风险提示
+     * @param {IApiConfirmParams} params 确认框参数
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiConfirmUtil
      */
     warning(params: IApiConfirmParams): Promise<boolean>;
     /**
-     * @description 弹出错误信息
-     * @param {IApiConfirmParams} params
+     * @description 显示错误类型确认框，常用于确认错误信息
+     * @param {IApiConfirmParams} params 确认框参数
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiConfirmUtil
      */

package/out/interface/api/util/i-api-encryption-util.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @description 加密工具类
+ * @export
+ * @interface IApiEncryptionUtil
+ */
+export interface IApiEncryptionUtil {
+    /**
+     * @description RSA加密
+     * @param {string} plainText 待加密文本
+     * @returns {*}  {Promise<string>}
+     * @memberof IApiEncryptionUtil
+     */
+    encryptByRSA(plainText: string): Promise<string>;
+}
+//# sourceMappingURL=i-api-encryption-util.d.ts.map

package/out/interface/api/util/i-api-encryption-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-api-encryption-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-encryption-util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAClD"}

package/out/interface/api/util/i-api-encryption-util.js

@@ -0,0 +1 @@
+export {};

package/out/interface/api/util/i-api-error-handle-center.d.ts

@@ -0,0 +1,21 @@
+import { IApiErrorHandler } from '../common';
+/**
+ * @description 错误处理工具类
+ * @export
+ * @interface IApiErrorHandlerCenter
+ */
+export interface IApiErrorHandlerCenter {
+    /**
+     * @description 注册处理器（后注册的优先级更高）
+     * @param {IApiErrorHandler} handler 错误处理器
+     * @memberof IApiErrorHandlerCenter
+     */
+    register(handler: IApiErrorHandler): void;
+    /**
+     * @description 按顺序检测处理器，最先满足条件的处理该异常
+     * @param {unknown} error
+     * @memberof IApiErrorHandlerCenter
+     */
+    handle(error: unknown): void;
+}
+//# sourceMappingURL=i-api-error-handle-center.d.ts.map

package/out/interface/api/util/i-api-error-handle-center.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-api-error-handle-center.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-error-handle-center.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAE1C;;;;OAIG;IACH,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B"}

package/out/interface/api/util/i-api-error-handle-center.js

@@ -0,0 +1 @@
+export {};

package/out/interface/api/util/i-api-excel-util.d.ts

@@ -0,0 +1,25 @@
+import { IApiData } from '@ibiz-template/core';
+/**
+ * @description Excel工具类
+ * @export
+ * @interface IApiExcelUtil
+ */
+export interface IApiExcelUtil {
+    /**
+     * @description 导出成Excel文件
+     * @param {{
+     *     header: string[]; // 表头内容
+     *     data: IApiData[]; // 数据内容
+     *     filename: string; // 文件名称
+     *     autoWidth: boolean; // 单元格是否自适应
+     *   }} args 导出配置
+     * @memberof IApiExcelUtil
+     */
+    exportJsonToExcel(args: {
+        header: string[];
+        data: IApiData[];
+        filename: string;
+        autoWidth: boolean;
+    }): void;
+}
+//# sourceMappingURL=i-api-excel-util.d.ts.map

package/out/interface/api/util/i-api-excel-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i-api-excel-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-excel-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,iBAAiB,CAAC,IAAI,EAAE;QACtB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,IAAI,EAAE,QAAQ,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;KACpB,GAAG,IAAI,CAAC;CACV"}

package/out/interface/api/util/i-api-excel-util.js

@@ -0,0 +1 @@
+export {};

package/out/interface/api/util/i-api-file-util.d.ts

@@ -1,4 +1,42 @@
-import { IApiContext, IApiData, IApiParams } from '@ibiz-template/core';
+import { IApiContext, IApiData, IApiParams, IHttpResponse } from '@ibiz-template/core';
+import { IApiDownloadTicket } from '../common';
+/**
+ * @description 扩展参数接口，用于计算附件的上传和下载路径
+ * @export
+ * @interface IApiFileUpDownExtraParams
+ */
+export interface IApiFileUpDownExtraParams {
+    /**
+     * @description 上传附件参数，用于计算上传路径
+     * @type {IApiData}
+     * @memberof IApiFileUpDownExtraParams
+     */
+    uploadParams?: IApiData;
+    /**
+     * @description 下载附件参数，用于计算下载路径
+     * @type {IApiData}
+     * @memberof IApiFileUpDownExtraParams
+     */
+    exportParams?: IApiData;
+    /**
+     * @description 用于计算上传和下载路径的OSS参数
+     * @type {string}
+     * @memberof IApiFileUpDownExtraParams
+     */
+    osscat?: string;
+    /**
+     * @description 启用无权限模式。启用后，上传文件夹需拼接'$'字符，也不需要计算下载凭证
+     * @type {boolean}
+     * @memberof IApiFileUpDownExtraParams
+     */
+    enableNoAccess?: boolean;
+    /**
+     * @description 是否启用全局下载文件前缀
+     * @type {boolean}
+     * @memberof IApiFileUpDownExtraParams
+     */
+    globalDownloadPrifix?: boolean;
+}
 /**
  * @description 文件工具类
  * @export
@@ -7,7 +45,7 @@ import { IApiContext, IApiData, IApiParams } from '@ibiz-template/core';
 export interface IApiFileUtil {
     /**
      * @description 设置文件上传请求头数据
-     * @param {Record<string, string>} args
+     * @param {Record<string, string>} args 请求头数据
      * @memberof IApiFileUtil
      */
     setUploadHeaders(args: Record<string, string>): void;
@@ -22,22 +60,14 @@ export interface IApiFileUtil {
      * @param {IApiContext} context 应用上下文对象
      * @param {IApiParams} params 视图参数对象
      * @param {IApiData} [data] 业务数据对象，默认给{}
-     * @param {{
-     *       uploadParams?: IApiData;
-     *       exportParams?: IApiData;
-     *       osscat?: string;
-     *     }} [extraParams] 上传附件参数;下载附加参数；自定义oss分类名称
+     * @param {IApiFileUpDownExtraParams} [extraParams] 扩展参数（包含上传附件参数、下载附加参数、自定义oss分类名称、启用无权限模式）
      * @returns {*}  {{
      *     uploadUrl: string;
      *     downloadUrl: string;
      *   }}
      * @memberof IApiFileUtil
      */
-    calcFileUpDownUrl(context: IApiContext, params: IApiParams, data?: IApiData, extraParams?: {
-        uploadParams?: IApiData;
-        exportParams?: IApiData;
-        osscat?: string;
-    }): {
+    calcFileUpDownUrl(context: IApiContext, params: IApiParams, data?: IApiData, extraParams?: IApiFileUpDownExtraParams): {
         uploadUrl: string;
         downloadUrl: string;
     };
@@ -47,39 +77,80 @@ export interface IApiFileUtil {
      * @returns {*}  {string}
      * @memberof IApiFileUtil
      */
-    getFileName(response: IApiData): string;
+    getFileName(response: IHttpResponse): string;
     /**
-     * @description 文件下载
-     * @param {string} url
-     * @param {string} [name]
+     * @description 下载指定文件，支持上下文参数及权限校验
+     * @param {string} url 下载地址
+     * @param {string} [name] 文件名
+     * @param {({
+     *       context: IApiContext;
+     *       params: IApiParams;
+     *       data: IApiData;
+     *       file: { fileId: string } & IApiData;
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *       downloadTicketParams?: { appEntityTag?: string; dataFieldTag?: string };
+     *     })} [downloadParams] {应用上下文；视图参数；数据；文件信息；扩展参数（包含上传附件参数、下载附加参数、自定义oss分类名称、启用无权限模式）;下载凭证参数}
+     * @param {boolean} [enableDownloadTicket] 启用下载凭证
+     * @param {boolean} [enableNoAccess] 启用无权限模式
      * @returns {*}  {Promise<void>}
      * @memberof IApiFileUtil
      */
-    fileDownload(url: string, name?: string): Promise<void>;
+    fileDownload(url: string, name?: string, downloadParams?: {
+        context: IApiContext;
+        params: IApiParams;
+        data: IApiData;
+        file: {
+            fileId: string;
+        } & IApiData;
+        extraParams?: IApiFileUpDownExtraParams;
+        downloadTicketParams?: {
+            appEntityTag?: string;
+            dataFieldTag?: string;
+        };
+    }, enableDownloadTicket?: boolean, enableNoAccess?: boolean): Promise<void>;
     /**
-     * @description 文件上传
-     * @param {string} uploadUrl
-     * @param {Blob} file
-     * @param {IApiData} headers
+     * @description 获取下载凭证
+     * @param {IApiContext} context 上下文参数
+     * @param {IApiParams} params 视图参数
+     * @param {IApiData} data 业务数据
+     * @param {({ fileId: string } & IApiData)} file 文件信息
+     * @param {{ appEntityTag?: string; dataFieldTag?: string }} [downloadTicketParams] 存在appEntityTag，则调用appEntityTag映射的实体服务创建下载凭证能力，否则调用当前界面域主实体的实体服务；存在dataFieldTag，则按照业务数据（data）、上下文（context）、视图参数（params）顺序找对应的属性值作为创建下载凭证数据主键，没有则使用上下文中找对应的数据主键
+     * @returns {*}  {(Promise<IApiDownloadTicket | undefined>)}
+     * @memberof IApiFileUtil
+     */
+    getDownloadTicket(context: IApiContext, params: IApiParams, data: IApiData, file: {
+        fileId: string;
+    } & IApiData, downloadTicketParams?: {
+        appEntityTag?: string;
+        dataFieldTag?: string;
+    }): Promise<IApiDownloadTicket | undefined>;
+    /**
+     * @description 设置下载票据
+     * @param {string} fileId 文件标识
+     * @param {IApiData} downloadTicket 下载凭证数据
+     * @memberof IApiFileUtil
+     */
+    setDownloadTicket(fileId: string, downloadTicket: IApiData): void;
+    /**
+     * @description 上传文件至指定地址，并返回服务端响应数据
+     * @param {string} uploadUrl 上传地址
+     * @param {Blob} file 文件
+     * @param {IApiData} headers 请求头
      * @returns {*}  {Promise<IApiData>}
      * @memberof IApiFileUtil
      */
     fileUpload(uploadUrl: string, file: Blob, headers: IApiData): Promise<IApiData>;
     /**
-     * @description 选择并上传文件
-     * @param {IApiContext} context
-     * @param {IApiParams} params
-     * @param {IApiData} data
+     * @description 打开文件选择窗口并自动执行上传流程
+     * @param {IApiContext} context 上下文参数
+     * @param {IApiParams} params 视图参数
+     * @param {IApiData} data 业务数据
      * @param {{
      *       accept: string;
      *       multiple?: boolean;
      *       showUploadManager?: boolean;
-     *       extraParams?: {
-     *         uploadParams?: IApiData;
-     *         exportParams?: IApiData;
-     *         osscat?: string;
-     *       };
-     *     }} [option] {上传文件类型,是否多选，是否展示文件管理器，扩展参数（包含上传附件参数、下载附加参数、自定义oss分类名称）}
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *     }} [option] {上传文件类型；是否多选；是否展示文件管理器；扩展参数（包含上传附件参数、下载附加参数、自定义oss分类名称、启用无权限模式）}
      * @returns {*}  {Promise<IApiData[]>}
      * @memberof IApiFileUtil
      */
@@ -87,19 +158,60 @@ export interface IApiFileUtil {
         accept: string;
         multiple?: boolean;
         showUploadManager?: boolean;
-        extraParams?: {
-            uploadParams?: IApiData;
-            exportParams?: IApiData;
-            osscat?: string;
-        };
-    }): Promise<IApiData[]>;
+        extraParams?: IApiFileUpDownExtraParams;
+    }): Promise<IApiData[] | undefined>;
     /**
-     * @description 选择文件
+     * @description 打开文件选择窗口，返回所选文件列表
      * @param {string} [accept] 选择文件类型
      * @param {boolean} [multiple] 是否多选，默认为false
-     * @returns {*}  {Promise<FileList>}
+     * @returns {*}  {Promise<FileList | undefined>}
+     * @memberof IApiFileUtil
+     */
+    chooseFile(accept: string, multiple?: boolean): Promise<FileList | undefined>;
+    /**
+     * @description 通用请求文件方法，可自定义 responseType（默认获取Blob类型的文件流，responseType 的配置决定了请求服务时返回的文件数据格式）
+     * @param {string} url 请求地址
+     * @param {({
+     *       context: IApiContext;
+     *       params: IApiParams;
+     *       data: IApiData;
+     *       file: { fileId: string } & IApiData;
+     *       extraParams?: IApiFileUpDownExtraParams;
+     *       downloadTicketParams?: { appEntityTag?: string; dataFieldTag?: string };
+     *     })} [downloadParams] {应用上下文；视图参数；数据；文件信息；扩展参数（包含上传附件参数、下载附加参数、自定义oss分类名称、启用无权限模式）;下载凭证参数}
+     * @param {boolean} [enableDownloadTicket] 启用下载凭证
+     * @param {boolean} [enableNoAccess] 启用无权限模式
+     * @returns {*}  {Promise<IApiData>}
+     * @memberof FileUtil
+     */
+    requestFile(url: string, responseType?: XMLHttpRequestResponseType, downloadParams?: {
+        context: IApiContext;
+        params: IApiParams;
+        data: IApiData;
+        file: {
+            fileId: string;
+        } & IApiData;
+        extraParams?: IApiFileUpDownExtraParams;
+        downloadTicketParams?: {
+            appEntityTag?: string;
+            dataFieldTag?: string;
+        };
+    }, enableDownloadTicket?: boolean, enableNoAccess?: boolean): Promise<IApiData>;
+    /**
+     * @description 压缩图片文件，支持控制最大宽度及质量
+     * @param {File} file 原始文件
+     * @param {number} maxW 最大宽度（默认 1280）
+     * @param {number} quality 压缩质量 0~1（默认 0.8）
+     * @returns {*}  {Promise<File>} 压缩后的新文件
+     * @memberof IApiFileUtil
+     */
+    compressImg(file: File, maxW: number, quality: number): Promise<File>;
+    /**
+     * @description 将 Base64 编码数据转换为 Blob 对象
+     * @param {string} base64 base64 字符串
+     * @returns {*}  {Blob} Blob对象
      * @memberof IApiFileUtil
      */
-    chooseFile(accept: string, multiple?: boolean): Promise<FileList>;
+    base64ToBlob(base64: string): Blob;
 }
 //# sourceMappingURL=i-api-file-util.d.ts.map

package/out/interface/api/util/i-api-file-util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i-api-file-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-file-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAErD;;;;OAIG;IACH,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3C;;;;;;;;;;;;;;;OAeG;IACH,iBAAiB,CACf,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,IAAI,CAAC,EAAE,QAAQ,EACf,WAAW,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,QAAQ,CAAC;QACxB,YAAY,CAAC,EAAE,QAAQ,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GACA;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IAEF;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC;IAExC;;;;;;OAMG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExD;;;;;;;OAOG;IACH,UAAU,CACR,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,QAAQ,GAChB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAErB;;;;;;;;;;;;;;;;;OAiBG;IACH,mBAAmB,CACjB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,QAAQ,EACd,MAAM,CAAC,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,WAAW,CAAC,EAAE;YACZ,YAAY,CAAC,EAAE,QAAQ,CAAC;YACxB,YAAY,CAAC,EAAE,QAAQ,CAAC;YACxB,MAAM,CAAC,EAAE,MAAM,CAAC;SACjB,CAAC;KACH,GACA,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEvB;;;;;;OAMG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CACnE"}
+{"version":3,"file":"i-api-file-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-file-util.ts"],"names":[],"mappings":"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"}

package/out/interface/api/util/i-api-fullscreen-util.d.ts

@@ -1,4 +1,3 @@
-import { IApiData } from '@ibiz-template/core';
 /**
  * @description 全屏工具类
  * @export
@@ -6,14 +5,16 @@ import { IApiData } from '@ibiz-template/core';
  */
 export interface IApiFullscreenUtil {
     /**
-     * @description 指定元素全屏
-     * @param {HTMLDivElement} div
-     * @param {IApiData} [data]
+     * @description 将指定元素切换为全屏显示
+     * @param {HTMLDivElement} div 元素
+     * @param {{ class?: string }} [data] 全屏配置，class: 全屏CSS类名
      * @memberof IApiFullscreenUtil
      */
-    openElementFullscreen(div: HTMLDivElement, data?: IApiData): void;
+    openElementFullscreen(div: HTMLDivElement, data?: {
+        class?: string;
+    }): void;
     /**
-     * @description 退出全屏
+     * @description 退出当前全屏状态
      * @memberof IApiFullscreenUtil
      */
     closeElementFullscreen(): void;

package/out/interface/api/util/i-api-fullscreen-util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i-api-fullscreen-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-fullscreen-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC;IAElE;;;OAGG;IACH,sBAAsB,IAAI,IAAI,CAAC;CAChC"}
+{"version":3,"file":"i-api-fullscreen-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-fullscreen-util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;OAKG;IACH,qBAAqB,CAAC,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAE5E;;;OAGG;IACH,sBAAsB,IAAI,IAAI,CAAC;CAChC"}

package/out/interface/api/util/i-api-global-util.d.ts

@@ -1,3 +1,4 @@
+import { IApiParams } from '@ibiz-template/core';
 import { Base64 } from 'js-base64';
 import { IApiHandlebarsUtil } from './i-api-handlebars-util';
 import { IApiTextUtil } from './i-api-text-util';
@@ -7,6 +8,13 @@ import { IApiShortCutUtil } from './i-api-short-cut-util';
 import { IApiFileUtil } from './i-api-file-util';
 import { IApiHtml2canvasUtil } from './i-api-html2canvas-util';
 import { IApiVoiceUtil } from './i-api-voice-util';
+import { IApiWaterMarkUtil } from './i-api-water-mark-util';
+import { IApiWeChatUtil } from './i-api-wechat-util';
+import { IApiJsonUtil } from './i-api-json-util';
+import { IApiUIActionUtil } from './i-api-ui-action-util';
+import { IApiErrorHandlerCenter } from './i-api-error-handle-center';
+import { IApiEncryptionUtil } from './i-api-encryption-util';
+import { IApiExcelUtil } from './i-api-excel-util';
 /**
  * @description 全局工具接口
  * @export
@@ -14,13 +22,13 @@ import { IApiVoiceUtil } from './i-api-voice-util';
  */
 export interface IApiGlobalUtil {
     /**
-     * @description 主题工具
+     * @description 主题工具，用于管理应用主题切换及自定义主题配置
      * @type {IApiThemeUtil}
      * @memberof IApiGlobalUtil
      */
     readonly theme: IApiThemeUtil;
     /**
-     * @description 文本工具
+     * @description 文本处理工具，提供字符串格式化、检测及转换能力
      * @type {IApiTextUtil}
      * @memberof IApiGlobalUtil
      */
@@ -38,11 +46,23 @@ export interface IApiGlobalUtil {
      */
     readonly base64: typeof Base64;
     /**
-     * @description 直接值工具
+     * @description 原始值处理工具，用于解析和转换字符串类型的基础数据
      * @type {IApiRawValueUtil}
      * @memberof IApiGlobalUtil
      */
     readonly rawValue: IApiRawValueUtil;
+    /**
+     * @description 界面行为工具，用于执行 UI 行为或逻辑操作
+     * @type {IApiUIActionUtil}
+     * @memberof IApiGlobalUtil
+     */
+    readonly action: IApiUIActionUtil;
+    /**
+     * @description 错误处理工具
+     * @type {IApiErrorHandlerCenter}
+     * @memberof IApiGlobalUtil
+     */
+    readonly error: IApiErrorHandlerCenter;
     /**
      * @description 最小化工具类
      * @type {IApiShortCutUtil}
@@ -50,13 +70,13 @@ export interface IApiGlobalUtil {
      */
     readonly shortCut: IApiShortCutUtil;
     /**
-     * @description 文件工具类
+     * @description 文件处理工具，提供文件上传、下载及选择等能力
      * @type {IApiFileUtil}
      * @memberof IApiGlobalUtil
      */
     readonly file: IApiFileUtil;
     /**
-     * @description Html2Canvas工具类
+     * @description DOM 转 Canvas 工具，用于页面截图或导出图像
      * @type {IApiHtml2canvasUtil}
      * @memberof IApiGlobalUtil
      */
@@ -68,10 +88,68 @@ export interface IApiGlobalUtil {
      */
     readonly voice: IApiVoiceUtil;
     /**
-     * @description 设置浏览器标题
-     * @param {string} title
+     * @description 加密工具类
+     * @type {IApiEncryptionUtil}
+     * @memberof IApiGlobalUtil
+     */
+    readonly encryption: IApiEncryptionUtil;
+    /**
+     * @description 水印处理工具，用于动态挂载或移除页面水印
+     * @type {IApiWaterMarkUtil}
+     * @memberof IApiGlobalUtil
+     */
+    readonly watermark: IApiWaterMarkUtil;
+    /**
+     * @description 微信工具类
+     * @type {IApiWeChatUtil}
+     * @memberof IApiGlobalUtil
+     */
+    readonly weChat: IApiWeChatUtil;
+    /**
+     * @description json工具类
+     * @type {IApiJsonUtil}
+     * @memberof IApiGlobalUtil
+     */
+    readonly jsonUtil: IApiJsonUtil;
+    /**
+     * @description 获取Excel工具类
+     * @memberof IApiGlobalUtil
+     */
+    getExcelUtil?: () => Promise<IApiExcelUtil>;
+    /**
+     * @description 显示应用级全局加载提示，通常用于长时间操作开始时
+     * @memberof IApiGlobalUtil
+     */
+    showAppLoading(): void;
+    /**
+     * @description 隐藏应用级全局加载提示
+     * @memberof IApiGlobalUtil
+     */
+    hiddenAppLoading(): void;
+    /**
+     * @description 设置浏览器页面标题
+     * @param {string} title 浏览器标题
      * @memberof IApiGlobalUtil
      */
     setBrowserTitle(title: string): void;
+    /**
+     * @description 获取应用全局变量
+     * @returns {*}  {IApiParams}
+     * @memberof IApiGlobalUtil
+     */
+    getGlobalParam(): IApiParams;
+    /**
+     * @description 获取当前视图的路由参数集合，基于路由解析出来的，每个对象里面都有context和params属性
+     * @returns {*}  {IApiParams[]}
+     * @memberof IApiGlobalUtil
+     */
+    getRouterParams(): IApiParams[];
+    /**
+     * @description 注册全局功能类扩展，用于替换预置能力
+     * @param {keyof IApiGlobalUtil} key 全局功能名称
+     * @param {*} value 全局功能实现
+     * @memberof IApiGlobalUtil
+     */
+    registerExtension(key: keyof IApiGlobalUtil, value: any): void;
 }
 //# sourceMappingURL=i-api-global-util.d.ts.map