@ibiz-template/runtime 0.7.41-alpha.87 → 0.7.41-alpha.89

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

@@ -79,7 +79,7 @@ export interface IApiFileUtil {
      */
     getFileName(response: IHttpResponse): string;
     /**
-     * @description 文件下载
+     * @description 下载指定文件，支持上下文参数及权限校验
      * @param {string} url 下载地址
      * @param {string} [name] 文件名
      * @param {({
@@ -132,7 +132,7 @@ export interface IApiFileUtil {
      */
     setDownloadTicket(fileId: string, downloadTicket: IApiData): void;
     /**
-     * @description 文件上传
+     * @description 上传文件至指定地址，并返回服务端响应数据
      * @param {string} uploadUrl 上传地址
      * @param {Blob} file 文件
      * @param {IApiData} headers 请求头
@@ -141,7 +141,7 @@ export interface IApiFileUtil {
      */
     fileUpload(uploadUrl: string, file: Blob, headers: IApiData): Promise<IApiData>;
     /**
-     * @description 选择并上传文件
+     * @description 打开文件选择窗口并自动执行上传流程
      * @param {IApiContext} context 上下文参数
      * @param {IApiParams} params 视图参数
      * @param {IApiData} data 业务数据
@@ -161,7 +161,7 @@ export interface IApiFileUtil {
         extraParams?: IApiFileUpDownExtraParams;
     }): Promise<IApiData[] | undefined>;
     /**
-     * @description 选择文件
+     * @description 打开文件选择窗口，返回所选文件列表
      * @param {string} [accept] 选择文件类型
      * @param {boolean} [multiple] 是否多选，默认为false
      * @returns {*}  {Promise<FileList | undefined>}
@@ -198,7 +198,7 @@ export interface IApiFileUtil {
         };
     }, enableDownloadTicket?: boolean, enableNoAccess?: boolean): Promise<IApiData>;
     /**
-     * @description 图片压缩
+     * @description 压缩图片文件，支持控制最大宽度及质量
      * @param {File} file 原始文件
      * @param {number} maxW 最大宽度（默认 1280）
      * @param {number} quality 压缩质量 0~1（默认 0.8）
@@ -207,7 +207,7 @@ export interface IApiFileUtil {
      */
     compressImg(file: File, maxW: number, quality: number): Promise<File>;
     /**
-     * @description base64转Blob对象
+     * @description 将 Base64 编码数据转换为 Blob 对象
      * @param {string} base64 base64 字符串
      * @returns {*}  {Blob} Blob对象
      * @memberof IApiFileUtil

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

@@ -5,7 +5,7 @@
  */
 export interface IApiFullscreenUtil {
     /**
-     * @description 指定元素全屏
+     * @description 将指定元素切换为全屏显示
      * @param {HTMLDivElement} div 元素
      * @param {{ class?: string }} [data] 全屏配置，class: 全屏CSS类名
      * @memberof IApiFullscreenUtil
@@ -14,7 +14,7 @@ export interface IApiFullscreenUtil {
         class?: string;
     }): void;
     /**
-     * @description 退出全屏
+     * @description 退出当前全屏状态
      * @memberof IApiFullscreenUtil
      */
     closeElementFullscreen(): void;

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

@@ -22,13 +22,13 @@ import { IApiExcelUtil } from './i-api-excel-util';
  */
 export interface IApiGlobalUtil {
     /**
-     * @description 主题工具
+     * @description 主题工具，用于管理应用主题切换及自定义主题配置
      * @type {IApiThemeUtil}
      * @memberof IApiGlobalUtil
      */
     readonly theme: IApiThemeUtil;
     /**
-     * @description 文本工具
+     * @description 文本处理工具，提供字符串格式化、检测及转换能力
      * @type {IApiTextUtil}
      * @memberof IApiGlobalUtil
      */
@@ -46,13 +46,13 @@ export interface IApiGlobalUtil {
      */
     readonly base64: typeof Base64;
     /**
-     * @description 直接值工具
+     * @description 原始值处理工具，用于解析和转换字符串类型的基础数据
      * @type {IApiRawValueUtil}
      * @memberof IApiGlobalUtil
      */
     readonly rawValue: IApiRawValueUtil;
     /**
-     * @description 界面行为工具
+     * @description 界面行为工具，用于执行 UI 行为或逻辑操作
      * @type {IApiUIActionUtil}
      * @memberof IApiGlobalUtil
      */
@@ -70,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
      */
@@ -94,7 +94,7 @@ export interface IApiGlobalUtil {
      */
     readonly encryption: IApiEncryptionUtil;
     /**
-     * @description 水印工具类
+     * @description 水印处理工具，用于动态挂载或移除页面水印
      * @type {IApiWaterMarkUtil}
      * @memberof IApiGlobalUtil
      */
@@ -117,17 +117,17 @@ export interface IApiGlobalUtil {
      */
     getExcelUtil?: () => Promise<IApiExcelUtil>;
     /**
-     * @description 显示应用级别的加载提示
+     * @description 显示应用级全局加载提示，通常用于长时间操作开始时
      * @memberof IApiGlobalUtil
      */
     showAppLoading(): void;
     /**
-     * @description 隐藏应用级别的加载提示
+     * @description 隐藏应用级全局加载提示
      * @memberof IApiGlobalUtil
      */
     hiddenAppLoading(): void;
     /**
-     * @description 设置浏览器标题
+     * @description 设置浏览器页面标题
      * @param {string} title 浏览器标题
      * @memberof IApiGlobalUtil
      */
@@ -139,7 +139,7 @@ export interface IApiGlobalUtil {
      */
     getGlobalParam(): IApiParams;
     /**
-     * @description 获取视图路由参数变量
+     * @description 获取当前视图的路由参数集合，基于路由解析出来的，每个对象里面都有context和params属性
      * @returns {*}  {IApiParams[]}
      * @memberof IApiGlobalUtil
      */

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

@@ -137,7 +137,7 @@ export interface IApiHtml2canvasOption {
  */
 export interface IApiHtml2canvasUtil {
     /**
-     * @description 导出canvas
+     * @description 将指定 DOM 转换为 Canvas 并导出图像文件
      * @param {HTMLElement} dom 元素
      * @param {IApiHtml2canvasOption} [option] html2canvas配置
      * @returns {*}  {Promise<void>}
@@ -145,7 +145,7 @@ export interface IApiHtml2canvasUtil {
      */
     exportCanvas(dom: HTMLElement, option?: IApiHtml2canvasOption): Promise<void>;
     /**
-     * @description 获取节点转化的canvas
+     * @description 获取指定 DOM 渲染后的 Canvas 对象
      * @param {HTMLElement} dom 元素
      * @param {IApiHtml2canvasOption} [option] html2canvas配置
      * @returns {*}  {Promise<HTMLCanvasElement>}

package/out/interface/api/util/i-api-inline-ai-util.d.ts

@@ -54,7 +54,7 @@ export interface IApiInLineAIUtil {
      * @param {number} x 距离左侧距离
      * @param {number} y 距离上方距离
      * @param {IApiData[]} menus 菜单集合
-     * @param {IData} [options] 菜单配置
+     * @param {IApiData} [options] 菜单配置
      * @memberof IApiInLineAIUtil
      */
     showContextMenus(x: number, y: number, menus: IApiData[], options?: IApiData): void;

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

@@ -42,7 +42,7 @@ export interface IApiMessageParams {
  */
 export interface IApiMessageUtil {
     /**
-     * @description 弹出普通消息
+     * @description 显示普通提示消息
      * @param {string} msg 消息内容
      * @param {number} [duration] 持续时间，单位：秒，默认：1.5
      * @param {boolean} [closable] 显示关闭按钮，默认：false
@@ -50,7 +50,7 @@ export interface IApiMessageUtil {
      */
     info(msg: string, duration?: number, closable?: boolean): void;
     /**
-     * @description 弹出成功消息
+     * @description 显示成功提示消息
      * @param {string} msg 消息内容
      * @param {number} [duration] 持续时间，单位：秒，默认：1.5
      * @param {boolean} [closable] 显示关闭按钮，默认：false
@@ -58,7 +58,7 @@ export interface IApiMessageUtil {
      */
     success(msg: string, duration?: number, closable?: boolean): void;
     /**
-     * @description 弹出警告消息
+     * @description 显示警告提示消息
      * @param {string} msg 消息内容
      * @param {number} [duration] 持续时间，单位：秒，默认：1.5
      * @param {boolean} [closable] 显示关闭按钮，默认：false
@@ -66,7 +66,7 @@ export interface IApiMessageUtil {
      */
     warning(msg: string, duration?: number, closable?: boolean): void;
     /**
-     * @description 弹出错误消息
+     * @description 显示错误提示消息
      * @param {string} msg 消息内容
      * @param {number} [duration] 持续时间，单位：秒，默认：1.5
      * @param {boolean} [closable] 显示关闭按钮，默认：false
@@ -74,7 +74,7 @@ export interface IApiMessageUtil {
      */
     error(msg: string, duration?: number, closable?: boolean): void;
     /**
-     * @description 通用消息方法
+     * @description 通用消息方法，支持自定义图标、持续时间等参数
      * @param {IApiMessageParams} params 配置详细的参数，详情参见：https://element-plus.org/zh-CN/component/message.html#message-%E9%85%8D%E7%BD%AE%E9%A1%B9
      * @memberof IApiMessageUtil
      */

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

@@ -24,19 +24,19 @@ export interface IApiModalParams {
      */
     showConfirmButton?: boolean;
     /**
-     * @description 是否显示取消按钮
+     * @description 是否显示取消按钮（默认不显示）
      * @type {boolean}
      * @memberof IApiModalParams
      */
     showCancelButton?: boolean;
     /**
-     * @description 确认按钮显示文本
+     * @description 确认按钮显示文本（默认确定）
      * @type {string}
      * @memberof IApiModalParams
      */
     confirmButtonText?: string;
     /**
-     * @description 取消按钮显示文本
+     * @description 取消按钮显示文本（默认取消）
      * @type {string}
      * @memberof IApiModalParams
      */
@@ -55,41 +55,41 @@ export interface IApiModalParams {
     options?: IApiParams;
 }
 /**
- * @description 消息提示，当用户进行操作时会被触发，该对话框中断用户操作，直到用户确认知晓后才可关闭。
+ * @description 消息弹框，当用户进行操作时会被触发，该对话框中断用户操作，直到用户确认知晓后才可关闭。
  * @export
  * @interface IApiModalUtil
  */
 export interface IApiModalUtil {
     /**
-     * @description 弹出普通信息
+     * @description 显示普通信息提示对话框，通常用于展示说明性内容
      * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     info(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出成功信息
+     * @description 显示成功提示对话框，表示操作成功完成
      * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     success(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出警告信息
+     * @description 显示警告提示对话框，用于提示潜在风险或异常情况
      * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     warning(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出错误信息
+     * @description 显示错误提示对话框，用于提示操作失败或系统异常
      * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     error(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出确认操作
+     * @description 显示确认对话框，用户确认返回 true，取消返回 false
      * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiModalUtil

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

@@ -53,31 +53,31 @@ export interface IApiNotificationParams {
  */
 export interface IApiNotificationUtil {
     /**
-     * @description 弹出默认通知
+     * @description 显示默认样式通知
      * @param {IApiNotificationParams} params 通知参数
      * @memberof IApiNotificationUtil
      */
     default(params: IApiNotificationParams): void;
     /**
-     * @description 弹出普通通知
+     * @description 显示普通信息通知
      * @param {IApiNotificationParams} params 通知参数
      * @memberof IApiNotificationUtil
      */
     info(params: IApiNotificationParams): void;
     /**
-     * @description 弹出成功通知
+     * @description 显示成功通知
      * @param {IApiNotificationParams} params 通知参数
      * @memberof IApiNotificationUtil
      */
     success(params: IApiNotificationParams): void;
     /**
-     * @description 弹出警告通知
+     * @description 显示警告通知
      * @param {IApiNotificationParams} params 通知参数
      * @memberof IApiNotificationUtil
      */
     warning(params: IApiNotificationParams): void;
     /**
-     * @description 弹出失败通知
+     * @description 显示失败通知
      * @param {IApiNotificationParams} params 通知参数
      * @memberof IApiNotificationUtil
      */

package/out/interface/api/util/i-api-open-view-util.d.ts

@@ -7,14 +7,14 @@ import { IApiModalData, IApiOverlayContainerOptions, IApiPopoverOptions } from '
  */
 export interface IApiOpenViewUtil {
     /**
-     * @description 直接路径打开视图
+     * @description 根据指定路径打开视图，通常用于简单路由跳转
      * @param {string} path 视图路径
      * @returns {*}  {Promise<IApiModalData>}
      * @memberof IApiOpenViewUtil
      */
     push(path: string): Promise<IApiModalData>;
     /**
-     * @description 打开顶级视图(一般为路由打开)
+     * @description 打开顶级视图（一般为路由打开），支持控制是否替换当前路由
      * @param {string} appViewId 应用视图id
      * @param {IApiContext} context 上下文参数
      * @param {IApiParams} [params] 视图参数
@@ -28,7 +28,7 @@ export interface IApiOpenViewUtil {
         replace?: boolean;
     }): Promise<IApiModalData>;
     /**
-     * @description 打开顶级视图(模态方式打开)
+     * @description 以模态窗口方式打开顶级视图
      * @param {string} appViewId 应用视图id
      * @param {IApiContext} context 上下文参数
      * @param {IApiParams} [params] 视图参数
@@ -37,7 +37,7 @@ export interface IApiOpenViewUtil {
      */
     rootByModal(appViewId: string, context: IApiContext, params?: IApiParams): Promise<IApiModalData>;
     /**
-     * @description 打开模态视图
+     * @description 以模态对话框方式打开视图
      * @param {string} appViewId 应用视图id
      * @param {IApiContext} context 上下文参数
      * @param {IApiParams} [params] 视图参数
@@ -47,7 +47,7 @@ export interface IApiOpenViewUtil {
      */
     modal(appViewId: string, context: IApiContext, params?: IApiParams, options?: IApiOverlayContainerOptions): Promise<IApiModalData>;
     /**
-     * @description 气泡模式打开
+     * @description 以气泡（Popover）方式打开视图，依附触发事件位置
      * @param {string} appViewId 应用视图id
      * @param {MouseEvent} event 鼠标事件
      * @param {IApiContext} context 上下文参数
@@ -58,7 +58,7 @@ export interface IApiOpenViewUtil {
      */
     popover(appViewId: string, event: MouseEvent, context: IApiContext, params?: IApiParams, options?: IApiPopoverOptions & IApiOverlayContainerOptions): Promise<IApiModalData>;
     /**
-     * @description 抽屉模式打开
+     * @description 以抽屉方式打开视图
      * @param {string} appViewId 应用视图id
      * @param {IApiContext} context 上下文参数
      * @param {IApiParams} [params] 视图参数
@@ -77,7 +77,7 @@ export interface IApiOpenViewUtil {
      */
     custom(appViewId: string, context: IApiContext, params?: IApiParams): Promise<IApiModalData>;
     /**
-     * @description 独立程序打开
+     * @description 在独立应用窗口中打开指定视图
      * @param {string} appViewId 应用视图id
      * @param {IApiContext} context 上下文参数
      * @param {IApiParams} [params] 视图参数

package/out/interface/api/util/i-api-print-preview-util.d.ts

@@ -1,4 +1,4 @@
-import { IApiContext, IApiParams } from '@ibiz-template/core';
+import { IApiContext, IApiData, IApiParams } from '@ibiz-template/core';
 /**
  * @description pdf导出参数
  * @export
@@ -99,7 +99,7 @@ export interface IApiPrintPreviewUtil {
      */
     execPrint(context: IApiContext, params: IApiParams, data: Blob): Promise<boolean>;
     /**
-     * @description 打印
+     * @description 将指定内容导出为 PDF 文件并触发打印或下载。
      * @param {string} filename pdf导出文件名，必须以.pdf结尾
      * @param {string} content pdf导出内容
      * @param {IApiPdfExportOptions} [options]
@@ -108,13 +108,13 @@ export interface IApiPrintPreviewUtil {
      */
     printPdf(filename: string, content: string, options?: IApiPdfExportOptions): Promise<boolean>;
     /**
-     * @description 导出HTML文件
+     * @description 将指定内容导出为 HTML 文件。
      * @param {string} filename 导出html文件名，需以.html结尾
      * @param {string} content 导出html内容，为body标签中的html字符串
-     * @param {IData} [style] 导出html样式，会添加到style标签中
+     * @param {IApiData} [style] 导出html样式，会添加到style标签中
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiPrintPreviewUtil
      */
-    printHtml2(filename: string, content: string, style?: IData): Promise<boolean>;
+    printHtml2(filename: string, content: string, style?: IApiData): Promise<boolean>;
 }
 //# sourceMappingURL=i-api-print-preview-util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"i-api-print-preview-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-print-preview-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC;IAElC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAExC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,SAAS,CACP,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;OAOG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}
+{"version":3,"file":"i-api-print-preview-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-print-preview-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,WAAW,CAAC;IAEvC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,QAAQ,CAAC;IAElC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IAExC;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,SAAS,CACP,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,IAAI,GACT,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;OAOG;IACH,QAAQ,CACN,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;;;;;OAOG;IACH,UAAU,CACR,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,QAAQ,GACf,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}

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

@@ -1,5 +1,4 @@
 import { IApiData, IApiParams } from '@ibiz-template/core';
-import { IApiModalOptions } from '../common';
 /**
  * @description 二维码工具
  * @export
@@ -7,14 +6,14 @@ import { IApiModalOptions } from '../common';
  */
 export interface IApiQrcodeUtil {
     /**
-     * @description 扫描二维码
-     * @param {IApiModalOptions} [options] 模态配置
+     * @description 打开二维码扫描界面并返回扫描结果
+     * @param {IApiParams} [options] 模态配置
      * @returns {*}  {Promise<IApiData>}
      * @memberof IApiQrcodeUtil
      */
-    scanQrcode(options?: IApiModalOptions): Promise<IApiData>;
+    scanQrcode(options?: IApiParams): Promise<IApiData>;
     /**
-     * @description 创建二维码
+     * @description 根据指定内容生成二维码配置数据
      * @param {string} value 创建二维码需要的文本值
      * @param {IApiParams} [options] 创建二维码参数配置
      * @returns {*}  {IApiParams}

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

@@ -1 +1 @@
-{"version":3,"file":"i-api-qrcode-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-qrcode-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE1D;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/D"}
+{"version":3,"file":"i-api-qrcode-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-qrcode-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEpD;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;CAC/D"}

package/out/interface/api/util/i-api-raw-value-util.d.ts

@@ -5,14 +5,14 @@
  */
 export interface IApiRawValueUtil {
     /**
-     * @description 字符串是否完全由整数/浮点数组成
+     * @description 判断字符串是否为合法数值（支持整数及浮点数）
      * @param {string} str 字符串
      * @returns {*}  {boolean}
      * @memberof IApiRawValueUtil
      */
     isNumber(str: string): boolean;
     /**
-     * @description 转换直接值
+     * @description 根据内容自动转换为对应基础类型（如 number、boolean 等）
      * @param {(string | undefined)} val 直接值
      * @returns {*}  {(number | boolean | string | undefined)}
      * @memberof IApiRawValueUtil

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

@@ -5,7 +5,7 @@
  */
 export interface IApiTextUtil {
     /**
-     * @description 格式化文本，遵循excel格式化标准
+     * @description 按指定格式规则格式化文本（遵循 Excel 格式化规则）
      * @param {string} value 文本值
      * @param {string} format 格式
      * @returns {*}  {string}
@@ -13,35 +13,35 @@ export interface IApiTextUtil {
      */
     format(value: string, format: string): string;
     /**
-     * @description 拷贝文本到剪切板
+     * @description 将文本复制到系统剪贴板，成功返回 true
      * @param {string} value 拷贝文本值
      * @returns {*}  {boolean}
      * @memberof IApiTextUtil
      */
     copy(value: string): boolean;
     /**
-     * @description 文本是否包含中文字符
+     * @description 判断字符串中是否包含中文字符
      * @param {string} str 文本
      * @returns {*}  {boolean}
      * @memberof IApiTextUtil
      */
     isChineseCharacter(str: string): boolean;
     /**
-     * @description 文本是否包含中文和英文字符
+     * @description 判断字符串是否同时包含中文和英文字符
      * @param {string} str 文本
      * @returns {*}  {boolean}
      * @memberof IApiTextUtil
      */
     hasChineseAndEnglish(str: string): boolean;
     /**
-     * @description 文本转十六进制颜色
+     * @description 根据文本内容生成对应的十六进制颜色值
      * @param {string} text 颜色字符串
      * @returns {*}  {string}
      * @memberof IApiTextUtil
      */
     stringToHexColor(text: string): string;
     /**
-     * @description 获取文本缩写
+     * @description 生成文本缩写（通常用于头像或标识展示）
      * @param {string} text 文本
      * @returns {*}  {(string | void)}
      * @memberof IApiTextUtil

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

@@ -5,19 +5,19 @@
  */
 export interface IApiThemeUtil {
     /**
-     * @description 设置主题
+     * @description 根据主题标识切换当前应用主题
      * @param {string} tag 主题标识
      * @memberof IApiThemeUtil
      */
     setTheme(tag: string): void;
     /**
-     * @description 获取当前主题标识
+     * @description 获取当前正在使用的主题标识
      * @returns {*}  {string}
      * @memberof IApiThemeUtil
      */
     getTheme(): string;
     /**
-     * @description 打开自定义主题配置面板
+     * @description 打开自定义主题配置界面
      * @memberof IApiThemeUtil
      */
     customTheme(): void;

package/out/interface/api/util/i-api-ui-action-util.d.ts

@@ -6,7 +6,7 @@ import { IApiUIActionResult, IApiUILogicParams } from '../common';
  */
 export interface IApiUIActionUtil {
     /**
-     * @description 执行界面行为
+     * @description 根据行为标识执行指定界面行为，并返回执行结果，需自行判断 actionResult（closeView/refresh 等）时使用
      * @param {string} actionId 界面行为id
      * @param {IApiUILogicParams} params 界面行为参数
      * @param {string} appId 应用标识
@@ -15,7 +15,7 @@ export interface IApiUIActionUtil {
      */
     exec(actionId: string, params: IApiUILogicParams, appId: string): Promise<IApiUIActionResult>;
     /**
-     * @description 执行界面逻辑
+     * @description 执行指定实体的界面逻辑，不经行为路由，返回值结构不固定
      * @param {string} appDEUILogicId 界面逻辑id
      * @param {string} appDataEntityId 实体标识
      * @param {IApiUILogicParams} args 界面逻辑参数
@@ -24,7 +24,7 @@ export interface IApiUIActionUtil {
      */
     execUILogic(appDEUILogicId: string, appDataEntityId: string, args: IApiUILogicParams): Promise<unknown>;
     /**
-     * @description 执行界面行为并处理返回值
+     * @description 执行界面行为并处理返回值，自动处理 closeView/refresh，无需手动判断，无返回值
      * @param {string} actionId 界面行为id
      * @param {IApiUILogicParams} params 界面行为参数
      * @param {string} appId 应用标识

package/out/interface/api/util/i-api-water-mark-util.d.ts

@@ -7,7 +7,7 @@ import { IApiGlobalWaterMarkConfig } from '../common';
  */
 export interface IApiWaterMarkUtil {
     /**
-     * @description 挂载水印至指定元素上
+     * @description 在指定容器中挂载水印，返回卸载函数；失败时返回 null
      * @param {Partial<IApiGlobalWaterMarkConfig>} option 水印参数
      * @param {HTMLElement} [container] 指定html元素,无值则附加到body上
      * @param {IApiContext} [context] 上下文参数

package/out/model/utils/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/model/utils/util.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EAEZ,YAAY,EAEZ,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAI1B;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EAAE,EACtB,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,IAAI,CAarB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,CAQzB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IACnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB,CAyBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAsBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;CACnC,GAAG,MAAM,GAAG,SAAS,CAerB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,cAAc,EAC7B,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,IAAI,CA0BrB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,GAAG;IACxD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;CACvB,CAQA;AAkCD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,gBAAgB,EAAE,KAAK,EACvB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAkEtC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,oBAAoB,EAAE,oBAAoB,EAAE,EAC5C,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAgCjC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAyBnC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,gBAAgB,EAC/B,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,sBAAsB,EAAO,GACrC,sBAAsB,EAAE,CAa1B"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../../src/model/utils/util.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,YAAY,EAEZ,YAAY,EAEZ,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAI1B;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,YAAY,EAAE,EACtB,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,IAAI,CAarB;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ5E;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,MAAM,GACV,WAAW,GAAG,SAAS,CAQzB;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IACnE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;CAChB,CAyBA;AAED;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAsBnE;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE;IACvC,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;CACnC,GAAG,MAAM,GAAG,SAAS,CAerB;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,cAAc,EAC7B,EAAE,EAAE,MAAM,GACT,YAAY,GAAG,IAAI,CA0BrB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,QAAQ,GAAG;IACxD,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,YAAY,EAAE,OAAO,CAAC;CACvB,CAQA;AAkCD;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,gBAAgB,EAAE,KAAK,EACvB,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAkEtC;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CACvC,oBAAoB,EAAE,oBAAoB,EAAE,EAC5C,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,oBAAoB,EAAE,CAAC,CA4CjC;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,sBAAsB,EAAE,EACjC,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAyBnC;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,gBAAgB,EAC/B,OAAO,EAAE,QAAQ,EACjB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,gBAAgB,CAAC,CA2B3B;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,sBAAsB,EAAO,GACrC,sBAAsB,EAAE,CAa1B"}

package/out/model/utils/util.js

@@ -302,11 +302,15 @@ export async function calcUIActionDetails(uiactionGroupDetails, context, params)
     // 筛选需要替换的项（保留原始索引）
     const refActionDetails = [];
     uiactionGroupDetails.forEach((detail, index) => {
-        var _a, _b;
+        var _a, _b, _c, _d;
+        if ((_a = detail.capLanguageRes) === null || _a === void 0 ? void 0 : _a.lanResTag)
+            detail.caption = ibiz.i18n.t(detail.capLanguageRes.lanResTag, detail.caption);
+        if ((_b = detail.tooltipLanguageRes) === null || _b === void 0 ? void 0 : _b.lanResTag)
+            detail.tooltip = ibiz.i18n.t(detail.tooltipLanguageRes.lanResTag, detail.tooltip);
         // 过滤静态界面行为组
         if (detail.detailType === 'DEUIACTIONGROUP' &&
-            ((_a = detail.refUIActionGroup) === null || _a === void 0 ? void 0 : _a.dynamicMode) === 1 &&
-            !((_b = detail.refUIActionGroup) === null || _b === void 0 ? void 0 : _b.uiactionGroupDetails)) {
+            ((_c = detail.refUIActionGroup) === null || _c === void 0 ? void 0 : _c.dynamicMode) === 1 &&
+            !((_d = detail.refUIActionGroup) === null || _d === void 0 ? void 0 : _d.uiactionGroupDetails)) {
             refActionDetails.push({ detail, index });
         }
     });