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

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

@@ -0,0 +1,97 @@
+import { IApiData } from '@ibiz-template/core';
+export interface IApiJsonRepairOption {
+    /**
+     * @description 是否返回对象
+     * @type {boolean}
+     * @memberof IApiJsonRepairOption
+     */
+    returnObjects?: boolean;
+    /**
+     * @description 是否跳过JSON.parse检查
+     * @type {boolean}
+     * @memberof IApiJsonRepairOption
+     */
+    skipJsonParse?: boolean;
+    /**
+     * @description 是否返回修复日志
+     * @type {boolean}
+     * @memberof IApiJsonRepairOption
+     */
+    logging?: boolean;
+    /**
+     * @description 是否保留Unicode字符
+     * @type {boolean}
+     * @memberof IApiJsonRepairOption
+     */
+    ensureAscii?: boolean;
+}
+export interface IApiJsonRepairResult {
+    /**
+     * @description 是否解析成功
+     * @type {boolean}
+     * @memberof IApiJsonRepairResult
+     */
+    success: boolean;
+    /**
+     * @description json数据
+     * @type {(IApiData | IApiData[] | undefined)}
+     * @memberof IApiJsonRepairResult
+     */
+    data: IApiData | IApiData[] | undefined;
+    /**
+     * @description 数据类型
+     * @type {('jsonobject' | 'jsonarray' | 'unknown')}
+     * @memberof IApiJsonRepairResult
+     */
+    data_type: 'jsonobject' | 'jsonarray' | 'unknown';
+    /**
+     * @description 解析信息
+     * @type {string}
+     * @memberof IApiJsonRepairResult
+     */
+    message: string;
+}
+/**
+ * @description JSON工具类
+ */
+export interface IApiJsonUtil {
+    /**
+     * @description json修复，用于提取大语言模型中的json数据
+     * @param {string} value json字符串
+     * @param {IApiJsonRepairOption} [options] 修复配置
+     * @returns {*}  {(IApiData | IApiData[] | string)}
+     * @memberof IApiJsonUtil
+     */
+    repairJson(value: string, options?: IApiJsonRepairOption): IApiData | IApiData[] | string;
+    /**
+     * @description 加载字符串中的JSON数据，直接返回json数据对象
+     * @param {string} value json字符串
+     * @param {IApiJsonRepairOption} [options] 修复配置
+     * @returns {*}  {IApiData | IApiData[]}
+     * @memberof IApiJsonUtil
+     */
+    loads(value: string, options?: IApiJsonRepairOption): IApiData | IApiData[];
+    /**
+     * @description 判断是否为json对象
+     * @param {*} value 待判断值
+     * @returns {boolean}
+     * @memberof IApiJsonUtil
+     */
+    isJsonObject(value: unknown): boolean;
+    /**
+     * @description 检测是否为json数组
+     * @param {*} value 待检测值
+     * @returns {boolean}
+     * @memberof IApiJsonUtil
+     */
+    isJsonArray(value: unknown): boolean;
+    /**
+     * @description 解析字符串中的json数据，用于获取大语言模型中的json数据
+     * @param {string} value json字符串
+     * @param {IApiJsonRepairOption} [options] 修复配置
+     * @returns {*}  {IApiJsonRepairResult}
+     * @memberof IApiJsonUtil
+     */
+    parseJson(value: string, options?: IApiJsonRepairOption): IApiJsonRepairResult;
+}
+//# sourceMappingURL=i-api-json-util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i-api-json-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-json-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,IAAI,EAAE,QAAQ,GAAG,QAAQ,EAAE,GAAG,SAAS,CAAC;IAExC;;;;OAIG;IACH,SAAS,EAAE,YAAY,GAAG,WAAW,GAAG,SAAS,CAAC;IAElD;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;OAMG;IACH,UAAU,CACR,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,QAAQ,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC;IAElC;;;;;;OAMG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,EAAE,CAAC;IAE5E;;;;;OAKG;IACH,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAEtC;;;;;OAKG;IACH,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC;IAErC;;;;;;OAMG;IACH,SAAS,CACP,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,oBAAoB,GAC7B,oBAAoB,CAAC;CACzB"}

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

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

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

@@ -1,4 +1,3 @@
-import { IApiData } from '@ibiz-template/core';
 /**
  * @description 消息提示参数接口
  * @export
@@ -43,7 +42,7 @@ export interface IApiMessageParams {
  */
 export interface IApiMessageUtil {
     /**
-     * @description 弹出普通消息
+     * @description 显示普通提示消息
      * @param {string} msg 消息内容
      * @param {number} [duration] 持续时间，单位：秒，默认：1.5
      * @param {boolean} [closable] 显示关闭按钮，默认：false
@@ -51,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
@@ -59,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
@@ -67,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
@@ -75,10 +74,10 @@ export interface IApiMessageUtil {
      */
     error(msg: string, duration?: number, closable?: boolean): void;
     /**
-     * @description 通用消息方法
-     * @param {IApiData} params 配置详细的参数，详情参见：https://element-plus.org/zh-CN/component/message.html#message-%E9%85%8D%E7%BD%AE%E9%A1%B9
+     * @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
      */
-    notice(params: IApiData): void;
+    notice(params: IApiMessageParams): void;
 }
 //# sourceMappingURL=i-api-message-util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"i-api-message-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-message-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/D;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAElE;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;CAChC"}
+{"version":3,"file":"i-api-message-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-message-util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAChD;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE/D;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAElE;;;;;;OAMG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAClE;;;;;;OAMG;IACH,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAChE;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACzC"}

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,45 +55,52 @@ export interface IApiModalParams {
     options?: IApiParams;
 }
 /**
- * @description 消息提示，当用户进行操作时会被触发，该对话框中断用户操作，直到用户确认知晓后才可关闭。
+ * @description 消息弹框，当用户进行操作时会被触发，该对话框中断用户操作，直到用户确认知晓后才可关闭。
  * @export
  * @interface IApiModalUtil
  */
 export interface IApiModalUtil {
     /**
-     * @description 弹出普通信息
-     * @param {IApiModalParams} params
+     * @description 显示普通信息提示对话框，通常用于展示说明性内容
+     * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     info(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出成功信息
-     * @param {IApiModalParams} params
+     * @description 显示成功提示对话框，表示操作成功完成
+     * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     success(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出警告信息
-     * @param {IApiModalParams} params
+     * @description 显示警告提示对话框，用于提示潜在风险或异常情况
+     * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     warning(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出错误信息
-     * @param {IApiModalParams} params
+     * @description 显示错误提示对话框，用于提示操作失败或系统异常
+     * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<void>}
      * @memberof IApiModalUtil
      */
     error(params: IApiModalParams): Promise<void>;
     /**
-     * @description 弹出确认操作
-     * @param {IApiModalParams} params
+     * @description 显示确认对话框，用户确认返回 true，取消返回 false
+     * @param {IApiModalParams} params 确认框参数
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiModalUtil
      */
     confirm(params: IApiModalParams): Promise<boolean>;
+    /**
+     * @description 弹出确认操作，返回确认结果（yes | no | cancel）
+     * @param {IApiModalParams} params 确认框参数
+     * @returns {*}  {(Promise<'yes' | 'no' | 'cancel'>)}
+     * @memberof IApiModalUtil
+     */
+    extendConfirm(params: IApiModalParams): Promise<'yes' | 'no' | 'cancel'>;
 }
 //# sourceMappingURL=i-api-modal-util.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"i-api-modal-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-modal-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAEhD;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACpD"}
+{"version":3,"file":"i-api-modal-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-modal-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;IAEhD;;;;OAIG;IACH,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,IAAI,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnD;;;;;OAKG;IACH,aAAa,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,GAAG,QAAQ,CAAC,CAAC;CAC1E"}

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

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

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"i-api-open-view-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-open-view-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3C;;;;;;;;OAQG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,YAAY,CAAC,EAAE,QAAQ,GACtB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;OAOG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;;OASG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAAG,2BAA2B,GACzD,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;OAQG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;OAOG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;OAOG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}
+{"version":3,"file":"i-api-open-view-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-open-view-util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EACL,aAAa,EACb,2BAA2B,EAC3B,kBAAkB,EACnB,MAAM,WAAW,CAAC;AAEnB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAE3C;;;;;;;;;;OAUG;IACH,IAAI,CACF,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,YAAY,CAAC,EAAE;QACb,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GACA,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;OAOG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;OAQG;IACH,KAAK,CACH,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;;OASG;IACH,OAAO,CACL,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,kBAAkB,GAAG,2BAA2B,GACzD,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;OAQG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,EACnB,OAAO,CAAC,EAAE,2BAA2B,GACpC,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;OAOG;IACH,MAAM,CACJ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;OAOG;IACH,QAAQ,CACN,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}

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

@@ -0,0 +1,120 @@
+import { IApiContext, IApiData, IApiParams } from '@ibiz-template/core';
+/**
+ * @description pdf导出参数
+ * @export
+ * @interface IApiPdfExportOptions
+ */
+export interface IApiPdfExportOptions {
+    /**
+     * @description 目标
+     * @type {('portrait' | 'landscape')}
+     * @default portrait
+     * @memberof IApiPdfExportOptions
+     */
+    orientation?: 'portrait' | 'landscape';
+    /**
+     * @description 页面大小
+     * @type {('a4' | 'a3' | 'letter')}
+     * @default a4
+     * @memberof IApiPdfExportOptions
+     */
+    pageSize?: 'a4' | 'a3' | 'letter';
+    /**
+     * @description 字体大小
+     * @type {number}
+     * @default 12
+     * @memberof IApiPdfExportOptions
+     */
+    fontSize?: number;
+    /**
+     * @description 外边距
+     * @type {{
+     *     top: number;
+     *     right: number;
+     *     bottom: number;
+     *     left: number;
+     *   }}
+     * @default {top: 20,right: 20,bottom: 20,left: 20}
+     * @memberof IApiPdfExportOptions
+     */
+    margins?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    /**
+     * @description 字体行高
+     * @type {number}
+     * @default 1.6
+     * @memberof IApiPdfExportOptions
+     */
+    lineHeight?: number;
+    /**
+     * @description 字体对齐
+     * @type {('left' | 'center' | 'right')}
+     * @default left
+     * @memberof IApiPdfExportOptions
+     */
+    textAlign?: 'left' | 'center' | 'right';
+    /**
+     * @description 字体颜色
+     * @type {string}
+     * @default #000000
+     * @memberof IApiPdfExportOptions
+     */
+    textColor?: string;
+    /**
+     * @description 背景色
+     * @type {string}
+     * @default #FFFFFF
+     * @memberof IApiPdfExportOptions
+     */
+    backgroundColor?: string;
+    /**
+     * @description 内容是否为html字符串
+     * @type {boolean}
+     * @default false
+     * @memberof IApiPdfExportOptions
+     */
+    isHtml?: boolean;
+    /**
+     * @description 片段高度（pdf内容过大超出浏览器限制时，将内容分成多个片段后导出）
+     * @type {number}
+     * @default 8000
+     * @memberof IApiPdfExportOptions
+     */
+    segmentHeight?: number;
+}
+/**
+ * 打印预览功能类接口
+ */
+export interface IApiPrintPreviewUtil {
+    /**
+     * 执行打印
+     * @param context
+     * @param params
+     * @param data
+     * @returns 是否执行成功
+     */
+    execPrint(context: IApiContext, params: IApiParams, data: Blob): Promise<boolean>;
+    /**
+     * @description 将指定内容导出为 PDF 文件并触发打印或下载。
+     * @param {string} filename pdf导出文件名，必须以.pdf结尾
+     * @param {string} content pdf导出内容
+     * @param {IApiPdfExportOptions} [options]
+     * @returns {*}  {Promise<boolean>}
+     * @memberof IApiPrintPreviewUtil
+     */
+    printPdf(filename: string, content: string, options?: IApiPdfExportOptions): Promise<boolean>;
+    /**
+     * @description 将指定内容导出为 HTML 文件。
+     * @param {string} filename 导出html文件名，需以.html结尾
+     * @param {string} content 导出html内容，为body标签中的html字符串
+     * @param {IApiData} [style] 导出html样式，会添加到style标签中
+     * @returns {*}  {Promise<boolean>}
+     * @memberof IApiPrintPreviewUtil
+     */
+    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

@@ -0,0 +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,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-print-preview-util.js

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

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

@@ -6,19 +6,19 @@ import { IApiData, IApiParams } from '@ibiz-template/core';
  */
 export interface IApiQrcodeUtil {
     /**
-     * @description 扫描二维码
-     * @param {(IApiParams | undefined)} [options] 创建二维码参数配置
+     * @description 打开二维码扫描界面并返回扫描结果
+     * @param {IApiParams} [options] 模态配置
      * @returns {*}  {Promise<IApiData>}
      * @memberof IApiQrcodeUtil
      */
-    scanQrcode(options?: IApiParams | undefined): Promise<IApiData>;
+    scanQrcode(options?: IApiParams): Promise<IApiData>;
     /**
-     * @description 创建二维码
+     * @description 根据指定内容生成二维码配置数据
      * @param {string} value 创建二维码需要的文本值
-     * @param {(IApiParams | undefined)} [options] 创建二维码参数配置
+     * @param {IApiParams} [options] 创建二维码参数配置
      * @returns {*}  {IApiParams}
      * @memberof IApiQrcodeUtil
      */
-    createQrcode(value: string, options?: IApiParams | undefined): IApiParams;
+    createQrcode(value: string, options?: IApiParams): IApiParams;
 }
 //# sourceMappingURL=i-api-qrcode-util.d.ts.map

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;AAE3D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAEhE;;;;;;OAMG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;CAC3E"}
+{"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,15 +5,15 @@
  */
 export interface IApiRawValueUtil {
     /**
-     * @description 字符串是否完全由整数/浮点数组成
-     * @param {string} str
+     * @description 判断字符串是否为合法数值（支持整数及浮点数）
+     * @param {string} str 字符串
      * @returns {*}  {boolean}
      * @memberof IApiRawValueUtil
      */
     isNumber(str: string): boolean;
     /**
-     * @description 转换直接值
-     * @param {(string | undefined)} val
+     * @description 根据内容自动转换为对应基础类型（如 number、boolean 等）
+     * @param {(string | undefined)} val 直接值
      * @returns {*}  {(number | boolean | string | undefined)}
      * @memberof IApiRawValueUtil
      */

package/out/interface/api/util/i-api-screen-shot-util.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @description 屏幕截图工具类
+ * @export
+ * @interface IApiScreenShotUtil
+ */
+export interface IApiScreenShotUtil {
+    /**
+     * @description 元素截图
+     * @param {HTMLElement} element 需要截图的元素
+     * @param {{ container?: HTMLElement; itemClassName?: string }} opts 如果需针对dom内部滚动容器截图，则需配置：滚动容器，滚动容器项类名，用以排除非可视区元素
+     * @returns {*}  {(Promise<string | undefined>)} 图片(png格式) base64 字符串
+     * @memberof IApiScreenShotUtil
+     */
+    onScreenShot(element: HTMLElement, opts: {
+        container?: HTMLElement;
+        itemClassName?: string;
+    }): Promise<string | undefined>;
+}
+//# sourceMappingURL=i-api-screen-shot-util.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"i-api-screen-shot-util.d.ts","sourceRoot":"","sources":["../../../../src/interface/api/util/i-api-screen-shot-util.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,YAAY,CACV,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE;QAAE,SAAS,CAAC,EAAE,WAAW,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACxD,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;CAChC"}

package/out/interface/api/util/i-api-screen-shot-util.js

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