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

package/out/interface/api/common/global-config/i-api-global-view-config.d.ts

@@ -14,7 +14,7 @@ export interface IApiGlobalViewConfig {
      */
     enableDataInfoBar: boolean;
     /**
-     * @description 用于控制全局哪些导航部件启用缓存，全大写。TABEXPPANEL:GRIDEXPBAR: - :分隔每个导航部件的缓存开关，必须用:结尾，如：TABEXPPANEL:开启表格导航部件缓存，GRIDEXPBAR:开启分页导航部件缓存。
+     * @description 导航部件缓存控制配置；使用 : 分隔（如：TABEXPPANEL:GRIDEXPBAR:），需以 : 结尾
      * @default TABEXPPANEL:
      * @type {string}
      * @platform web
@@ -23,7 +23,7 @@ export interface IApiGlobalViewConfig {
      */
     expCacheMode: string;
     /**
-     * @description 是否禁用分页导航栏，该参数为true时首页不显示分页导航栏
+     * @description 是否禁用首页分页导航栏
      * @default false
      * @type {boolean}
      * @platform web
@@ -31,7 +31,7 @@ export interface IApiGlobalViewConfig {
      */
     disableHomeTabs: boolean;
     /**
-     * @description 移动端是否展示返回按键
+     * @description 移动端是否显示系统返回按钮
      * @default true
      * @type {boolean}
      * @platform mob
@@ -39,7 +39,7 @@ export interface IApiGlobalViewConfig {
      */
     mobShowPresetBack: boolean;
     /**
-     * @description 移动端是否显示视图头
+     * @description 移动端是否显示视图头部
      * @default true
      * @type {boolean}
      * @platform mob
@@ -73,7 +73,7 @@ export interface IApiGlobalViewConfig {
      */
     viewAccUserMode: 1 | 2 | 3 | 4;
     /**
-     * @description 视图加载时的提示文本
+     * @description 视图加载过程中的提示文本
      * @type {string}
      * @platform web
      * @platform mob

package/out/interface/api/common/global-config/i-api-global-water-mark-config.d.ts

@@ -5,7 +5,7 @@
  */
 export interface IApiGlobalWaterMarkConfig {
     /**
-     * @description 是否启用
+     * @description 是否启用水印
      * @type {boolean}
      * @platform web
      * @platform mob
@@ -14,7 +14,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     enable: boolean;
     /**
-     * @description 水印内容：字符串表示单行文本，数组表示多行文本
+     * @description 水印文本内容（支持多行）
      * @type {(string | string[])}
      * @platform web
      * @platform mob
@@ -22,7 +22,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     text: string | string[];
     /**
-     * @description 字体大小（单位：CSS 像素）
+     * @description 字体大小（px）
      * @type {number}
      * @platform web
      * @platform mob
@@ -31,7 +31,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     fontSize: number;
     /**
-     * @description 字体族（遵循 CSS 字体族语法）
+     * @description 字体族（遵循 CSS 规范）
      * @type {string}
      * @platform web
      * @platform mob
@@ -40,7 +40,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     fontFamily: string;
     /**
-     * @description 字体粗细（遵循 CSS 字体粗细语法，如 'bold'、400）
+     * @description 字体粗细（如：400 / bold）
      * @type {(string | number)}
      * @platform web
      * @platform mob
@@ -49,7 +49,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     fontWeight: string | number;
     /**
-     * @description 字体样式，仅支持 'normal'（正常）、'italic'（斜体）、'oblique'（倾斜）
+     * @description 字体样式（normal / italic / oblique）
      * @type {string}
      * @platform web
      * @platform mob
@@ -58,7 +58,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     fontStyle: string;
     /**
-     * @description 字体颜色（支持 CSS 颜色格式，如 '#fff'、'rgba(0,0,0,0.5)'）
+     * @description 字体颜色（支持 CSS 格式）
      * @type {string}
      * @platform web
      * @platform mob
@@ -67,7 +67,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     color: string;
     /**
-     * @description 水印整体透明度（范围：0 - 1，0 完全透明，1 完全不透明）
+     * @description 水印透明度（0~1）
      * @type {number}
      * @platform web
      * @platform mob
@@ -76,7 +76,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     opacity: number;
     /**
-     * @description 水印顺时针旋转角度,负数即为逆时针（单位：度数）
+     * @description 旋转角度（单位：度，支持负值）
      * @type {number}
      * @platform web
      * @platform mob
@@ -85,7 +85,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     rotate: number;
     /**
-     * @description 水印平铺时 x、y 方向的间距（单位：CSS 像素），数组第一项为 x 方向，第二项为 y 方向
+     * @description 平铺间距（x / y）
      * @type {[number, number]}
      * @platform web
      * @platform mob
@@ -94,7 +94,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     gap: [number, number];
     /**
-     * @description 水印背景的偏移量（单位：CSS 像素），数组第一项为 x 方向偏移，第二项为 y 方向偏移
+     * @description 偏移量（x / y）
      * @type {[number, number]}
      * @platform web
      * @platform mob
@@ -103,7 +103,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     offset: [number, number];
     /**
-     * @description 水印图块大小（单位：CSS 像素）：未设置时根据文本自适应；设置时按指定宽高固定图块尺寸,（0 表示自适应）
+     * @description 单个水印块尺寸（0 表示自适应）
      * @type {{ width: number; height: number }}
      * @platform web
      * @platform mob
@@ -115,7 +115,7 @@ export interface IApiGlobalWaterMarkConfig {
         height: number;
     };
     /**
-     * @description 水印层的 z-index 值（控制层级显示顺序）
+     * @description 水印层级控制
      * @type {number}
      * @platform web
      * @platform mob
@@ -142,7 +142,7 @@ export interface IApiGlobalWaterMarkConfig {
      */
     protect: boolean;
     /**
-     * @description 是否允许文本选择穿透水印层
+     * @description 是否允许鼠标穿透选择文本
      * @type {boolean}
      * @platform web
      * @platform mob

package/out/interface/api/common/i-api-data-ability-params.d.ts

@@ -6,25 +6,25 @@ import { IApiContext, IApiData, IApiParams } from '@ibiz-template/core';
  */
 export interface IApiDataAbilityParams {
     /**
-     * @description 当前这次操作附加的上下文参数
+     * @description 额外传入的上下文参数（会与当前上下文合并）
      * @type {IApiContext}
      * @memberof IApiDataAbilityParams
      */
     context?: IApiContext;
     /**
-     * @description 当前这次操作附加的视图参数
+     * @description 额外传入的视图参数（会覆盖默认视图参数）
      * @type {IApiParams}
      * @memberof IApiDataAbilityParams
      */
     viewParam?: IApiParams;
     /**
-     * @description 执行能力使用的数据集合,没有则使用数据部件自身的数据或选中数据
+     * @description 指定执行的数据集合,若不传，则默认使用控件当前数据或选中数据
      * @type {(IApiData[] | IApiData)}
      * @memberof IApiDataAbilityParams
      */
     data?: IApiData[] | IApiData;
     /**
-     * @description 是否静默执行，不出loading效果，不弹成功提示
+     * @description 是否静默执行,为true时不显示 loading，不弹出成功提示
      * @type {boolean}
      * @memberof IApiDataAbilityParams
      */

package/out/interface/api/common/i-api-modal-data.d.ts

@@ -6,7 +6,7 @@ import { IApiData, IApiParams } from '@ibiz-template/core';
  */
 export interface IApiModalData {
     /**
-     * @description 关闭视图是否操作成功
+     * @description 关闭视图成功标记,ok=true表示操作成功，信任data数据，ok=false表示操作失败，不信任data数据
      * @type {boolean}
      * @memberof IApiModalData
      */

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

@@ -12,7 +12,7 @@ export interface IApiUIActionResult {
      */
     refresh?: boolean;
     /**
-     * @description 刷新引用视图模式，0：无、 1：引用视图或树节点、 2：引用树节点父节点、 3：引用树节点根节点，默认无刷新
+     * @description 刷新引用视图模式，0：无刷新（默认）、 1：引用视图或树节点、 2：引用树节点父节点、 3：引用树节点根节点，默认无刷新
      * @type {(number | 0 | 1 | 2 | 3)}
      * @memberof IApiUIActionResult
      */

package/out/interface/api/controller/common/i-api.controller.d.ts

@@ -17,13 +17,13 @@ export interface IApiController<T extends object = object, S extends object = ob
      */
     readonly id: string;
     /**
-     * @description 状态对象，泛型
+     * @description 状态对象
      * @type {S}
      * @memberof IApiController
      */
     state: S;
     /**
-     * @description 模型对象，泛型
+     * @description 模型对象
      * @type {T}
      * @memberof IApiController
      */

package/out/interface/api/controller/control/form-detail/i-api-form-item.controller.d.ts

@@ -9,7 +9,7 @@ import { IApiFormDetailController } from './i-api-form-detail.controller';
  */
 export interface IApiFormItemController extends IApiFormDetailController {
     /**
-     * @description 表单项状态
+     * @description 表单项状态对象（响应式），包含可见性、禁用状态、校验状态等
      * @type {IApiFormItemState}
      * @memberof IApiFormItemController
      */
@@ -33,19 +33,19 @@ export interface IApiFormItemController extends IApiFormDetailController {
      */
     readonly value: unknown;
     /**
-     * @description 值项
+     * @description 值项名称（用于复杂控件绑定值）
      * @type {(string | undefined)}
      * @memberof IApiFormItemController
      */
     readonly valueItemName: string | undefined;
     /**
-     * @description 标签标题
+     * @description 表单项标签显示文本
      * @type {(string | undefined)}
      * @memberof IApiFormItemController
      */
     readonly labelCaption: string | undefined;
     /**
-     * @description 单位
+     * @description 单位名称（用于数值类字段显示）
      * @type {(string | undefined)}
      * @memberof IApiFormItemController
      */
@@ -63,7 +63,7 @@ export interface IApiFormItemController extends IApiFormDetailController {
      */
     readonly dataType: number | undefined;
     /**
-     * @description 校验(如果表单项不显示则不校验直接返回true)
+     * @description 校验当前表单项（若不可见则自动跳过校验）
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiFormItemController
      */

package/out/interface/api/controller/control/i-api-form.controller.d.ts

@@ -6,6 +6,7 @@ import { IApiFormDetailController } from './form-detail/i-api-form-detail.contro
 import { IApiFormMDCtrlController } from './form-detail/i-api-form-mdctrl.controller';
 import { IApiFormDruipartController } from './form-detail/i-api-form-druipart.controller';
 import { IApiFormDetailMapping } from '../common';
+import { IApiFormItemController } from './form-detail';
 /**
  * 表单
  * @primary
@@ -32,7 +33,7 @@ import { IApiFormDetailMapping } from '../common';
  */
 export interface IApiFormController<T extends IDEForm = IDEForm, S extends IApiFormState = IApiFormState> extends IApiControlController<T, S> {
     /**
-     * @description 所有表单项成员的控制器
+     * @description 表单成员控件集合（key 为成员 id），包括：按钮、分组、分页、关系界面等
      * @type {{ [key: string]: IApiFormDetailController }}
      * @memberof IApiFormController
      */
@@ -41,12 +42,12 @@ export interface IApiFormController<T extends IDEForm = IDEForm, S extends IApiF
     };
     /**
      * @description 表单项控制器集合
-     * @type {IApiFormDetailController[]}
+     * @type {IApiFormItemController[]}
      * @memberof IApiFormController
      */
-    formItems: IApiFormDetailController[];
+    formItems: IApiFormItemController[];
     /**
-     * @description 表单多数据部件控制器集合
+     * @description 表单关系界面控制器集合（嵌入视图）
      * @type {IApiFormMDCtrlController[]}
      * @memberof IApiFormController
      */
@@ -70,7 +71,7 @@ export interface IApiFormController<T extends IDEForm = IDEForm, S extends IApiF
      */
     getReal(): IApiData[];
     /**
-     * @description 刷新当前部件
+     * @description 刷新表单数据（通常重新加载当前数据）
      * @returns {*}  {Promise<void>}
      * @memberof IApiFormController
      */
@@ -91,7 +92,7 @@ export interface IApiFormController<T extends IDEForm = IDEForm, S extends IApiF
      */
     setActiveTab(name: string): void;
     /**
-     * @description 设置表单数据
+     * @description 设置指定表单项的数据值（name 为字段标识）
      * @param {string} name 表单项名称
      * @param {unknown} value 值
      * @param {boolean} [ignore] 是否忽略脏值检查

package/out/interface/api/controller/control/i-api-form.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"i-api-form.controller.d.ts","sourceRoot":"","sources":["../../../../../src/interface/api/controller/control/i-api-form.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,CAAC,SAAS,aAAa,GAAG,aAAa,CACvC,SAAQ,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC;IACnC;;;;OAIG;IACH,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAAA;KAAE,CAAC;IAErD;;;;OAIG;IACH,SAAS,EAAE,wBAAwB,EAAE,CAAC;IAEtC;;;;OAIG;IACH,WAAW,EAAE,wBAAwB,EAAE,CAAC;IAExC;;;;OAIG;IACH,YAAY,EAAE,0BAA0B,EAAE,CAAC;IAE3C;;;;OAIG;IACH,OAAO,IAAI,QAAQ,EAAE,CAAC;IAEtB;;;;OAIG;IACH,OAAO,IAAI,QAAQ,EAAE,CAAC;IAEtB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;OAIG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAElE;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7B;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACjD,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,MAAM,GACT,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,CAAC;CAC9B"}
+{"version":3,"file":"i-api-form.controller.d.ts","sourceRoot":"","sources":["../../../../../src/interface/api/controller/control/i-api-form.controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4CAA4C,CAAC;AACtF,OAAO,EAAE,0BAA0B,EAAE,MAAM,8CAA8C,CAAC;AAC1F,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,OAAO,GAAG,OAAO,EAC3B,CAAC,SAAS,aAAa,GAAG,aAAa,CACvC,SAAQ,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC;IACnC;;;;OAIG;IACH,OAAO,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,wBAAwB,CAAA;KAAE,CAAC;IAErD;;;;OAIG;IACH,SAAS,EAAE,sBAAsB,EAAE,CAAC;IAEpC;;;;OAIG;IACH,WAAW,EAAE,wBAAwB,EAAE,CAAC;IAExC;;;;OAIG;IACH,YAAY,EAAE,0BAA0B,EAAE,CAAC;IAE3C;;;;OAIG;IACH,OAAO,IAAI,QAAQ,EAAE,CAAC;IAEtB;;;;OAIG;IACH,OAAO,IAAI,QAAQ,EAAE,CAAC;IAEtB;;;;OAIG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB;;;;OAIG;IACH,cAAc,CAAC,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAElE;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;OAKG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD;;;;OAIG;IACH,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE7B;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;;;;;;OAOG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,qBAAqB,EACjD,IAAI,EAAE,CAAC,EACP,EAAE,EAAE,MAAM,GACT,qBAAqB,CAAC,CAAC,CAAC,CAAC;IAE5B;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,CAAC;IAE7B;;;;OAIG;IACH,kBAAkB,IAAI,MAAM,CAAC;CAC9B"}

package/out/interface/api/controller/view/i-api-view.controller.d.ts

@@ -62,7 +62,7 @@ export interface IApiViewController<T extends IAppView = IAppView, S extends IAp
      */
     parentData?: IApiData[];
     /**
-     * @description 关闭视图
+     * @description 关闭视图，modalData为返回至外层的数据
      * @param {IApiModalData} [modalData] 返回数据
      * @returns {*}  {Promise<void>}
      * @memberof IApiViewController

package/out/interface/api/i-api-runtime-ibizsys.d.ts

@@ -9,73 +9,73 @@ import { IApiOpenViewUtil } from './util/i-api-open-view-util';
  */
 export interface IApiRuntimeIbizsys {
     /**
-     * @description 应用中心服务
+     * @description 应用中心服务，用于应用级资源调度、服务注册与统一访问入口
      * @type {IApiAppHubService}
      * @memberof IApiRuntimeIbizsys
      */
     hub: IApiAppHubService;
     /**
-     * @description 全局配置
+     * @description 全局配置对象，用于获取系统级配置、运行环境参数及全局变量
      * @type {IApiGlobalConfig}
      * @memberof IApiRuntimeIbizsys
      */
     config: IApiGlobalConfig;
     /**
-     * @description 消息提示服务
+     * @description 模态框工具服务，用于弹出对话框（如信息提示、表单弹窗等）
      * @type {IApiModalUtil}
      * @memberof IApiRuntimeIbizsys
      */
     modal: IApiModalUtil;
     /**
-     * @description 确认消息服务
+     * @description 确认框服务，用于触发用户确认操作（如删除确认、操作二次确认等）
      * @type {IApiConfirmUtil}
      * @memberof IApiRuntimeIbizsys
      */
     confirm: IApiConfirmUtil;
     /**
-     * @description 顶部居中显示反馈提示服务
+     * @description 消息提示服务，用于在页面顶部居中展示轻量级反馈信息（如成功、警告、错误提示）
      * @type {IApiMessageUtil}
      * @memberof IApiRuntimeIbizsys
      */
     message: IApiMessageUtil;
     /**
-     * @description 全局通知服务
+     * @description 全局通知服务，用于展示系统级通知（支持持久化或可关闭通知）
      * @type {IApiNotificationUtil}
      * @memberof IApiRuntimeIbizsys
      */
     notification: IApiNotificationUtil;
     /**
-     * @description 打开视图服务
+     * @description 视图打开服务，用于打开或跳转至指定视图（支持路由、模态、抽屉等多种方式）
      * @type {IApiOpenViewUtil}
      * @memberof IApiRuntimeIbizsys
      */
     openView: IApiOpenViewUtil;
     /**
-     * @description 全局工具服务
+     * @description 全局工具服务，提供通用方法（如自定义主题、文本格式化等）
      * @type {IApiGlobalUtil}
      * @memberof IApiRuntimeIbizsys
      */
     util: IApiGlobalUtil;
     /**
-     * @description 全屏工具服务
+     * @description 全屏工具服务，用于控制页面或指定元素进入/退出全屏模式
      * @type {IApiFullscreenUtil}
      * @memberof IApiRuntimeIbizsys
      */
     fullscreenUtil: IApiFullscreenUtil;
     /**
-     * @description 二维码工具服务
+     * @description 二维码工具服务，用于生成或解析二维码内容
      * @type {IApiQrcodeUtil}
      * @memberof IApiRuntimeIbizsys
      */
     qrcodeUtil: IApiQrcodeUtil;
     /**
-     * @description 应用级功能服务
+     * @description 应用级工具服务，提供调整整个应用状态的功能（如登录、登出、切换主题等）
      * @type {IApiAppUtil}
      * @memberof IApiRuntimeIbizsys
      */
     appUtil: IApiAppUtil;
     /**
-     * @description 打印预览服务
+     * @description 打印预览服务，用于生成并展示打印预览内容，支持导出或打印操作
      */
     printPreview: IApiPrintPreviewUtil;
 }

package/out/interface/api/service/i-api-code-list.service.d.ts

@@ -15,7 +15,7 @@ export interface IApiCodeListService {
      */
     getCodeList(tag: string): IAppCodeList | undefined;
     /**
-     * @description 获取指定代码表所有代码表项
+     * @description 获取指定代码表所有代码表项,返回树形结构数据格式
      * @param {string} tag 代码表标识
      * @param {IApiContext} context 应用上下文
      * @param {IApiParams} [params] 视图参数

package/out/interface/api/service/i-api-de-service-util.d.ts

@@ -21,7 +21,7 @@ export interface IApiDEServiceUtil {
      */
     reset(context: IApiContext): void;
     /**
-     * @description 执行服务方法
+     * @description 执行服务方法（无需提前 getService，直传appDataEntityId一步到位；如已有服务实例则用IApiAppDEService.exec），appDataEntityId 通常是应用标识.实体标识，如：checkinweb.shift，methodName 即当前实体的行为标识，如：'create' / 'update' / 'remove' / 'get' / 'fetchDefault'
      * @param {string} appDataEntityId 实体标识，通常是应用标识.实体标识，如：checkinweb.shift
      * @param {string} methodName 方法名
      * @param {IApiContext} context 应用上下文

package/out/interface/api/state/common/i-api-button-container.state.d.ts

@@ -6,19 +6,19 @@ import { IApiContext, IApiData } from '@ibiz-template/core';
  */
 export interface IApiButtonContainerState {
     /**
-     * @description 是否显示
+     * @description 是否显示，直接修改值界面即可生效
      * @type {boolean}
      * @memberof IApiButtonContainerState
      */
     visible: boolean;
     /**
-     * @description 是否禁用
+     * @description 是否禁用，直接修改值界面即可生效
      * @type {boolean}
      * @memberof IApiButtonContainerState
      */
     disabled: boolean;
     /**
-     * @description 设置当前执行的按钮
+     * @description 设置当前执行的按钮,name为按钮标识
      * @param {string} name
      * @memberof IApiButtonContainerState
      */

package/out/interface/api/state/common/i-api-button.state.d.ts

@@ -6,19 +6,19 @@ import { IApiContext, IApiData } from '@ibiz-template/core';
  */
 export interface IApiButtonState {
     /**
-     * @description 是否禁用
+     * @description 是否禁用，直接修改值界面即可生效
      * @type {boolean}
      * @memberof IApiButtonState
      */
     disabled: boolean;
     /**
-     * @description 显示与否
+     * @description 显示与否，直接修改值界面即可生效
      * @type {boolean}
      * @memberof IApiButtonState
      */
     visible: boolean;
     /**
-     * @description 是否显示loading状态
+     * @description 是否显示loading状态，直接修改值界面即可生效
      * @type {boolean}
      * @memberof IApiButtonState
      */

package/out/interface/api/state/control/i-api-form.state.d.ts

@@ -30,14 +30,14 @@ export interface IApiFormState extends IApiControlState {
      */
     processing: boolean;
     /**
-     * @description 是否被修改过
+     * @description 表单数据是否已被修改（是否存在未保存变更）
      * @type {boolean}
      * @default false
      * @memberof IApiFormState
      */
     modified: boolean;
     /**
-     * @description 当前激活分页
+     * @description 当前激活的分页标识
      * @type {string}
      * @memberof IApiFormState
      */

package/out/interface/api/state/view/i-api-view-session.d.ts

@@ -6,7 +6,7 @@ import { IApiData } from '@ibiz-template/core';
  */
 export interface IApiViewSession {
     /**
-     * @description 当前视图作用域数据
+     * @description 当前视图作用域数据,用于单数据视图能够快速获取当前视图业务数据，如：表单视图表单数据
      * @type {(IApiData | null)}
      * @default null
      * @memberof IApiViewSession

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

@@ -75,7 +75,7 @@ export interface IApiAppUtil {
      */
     onRouteIsReady(): Promise<void>;
     /**
-     * 登录（包含调用登录逻辑，及跳转应用界面）
+     * 登录
      *
      * @author tony001
      * @date 2024-05-14 15:05:07
@@ -88,7 +88,7 @@ export interface IApiAppUtil {
      */
     login(loginName: string, password: string, remember?: boolean, headers?: IApiData, opts?: IApiData): Promise<boolean>;
     /**
-     * 登出（包含调用登录逻辑，及跳转登录页）
+     * 登出
      *
      * @author tony001
      * @date 2024-05-14 15:05:24
@@ -97,7 +97,7 @@ export interface IApiAppUtil {
      */
     logout(opts?: IApiData): Promise<boolean>;
     /**
-     * 变更密码
+     * 修改当前用户登录密码
      *
      * @author tony001
      * @date 2024-05-14 15:05:33
@@ -112,7 +112,7 @@ export interface IApiAppUtil {
         surePwd: string;
     }): Promise<IApiAuthResult>;
     /**
-     * 切换组织
+     * 切换当前登录用户所属组织
      *
      * @author tony001
      * @date 2024-05-14 15:05:51
@@ -123,7 +123,7 @@ export interface IApiAppUtil {
      */
     switchOrg(oldOrgId: string, newOrgId: string, opts?: IApiData): Promise<boolean>;
     /**
-     * 切换主题
+     * 切换应用显示主题（如：light / dark）
      *
      * @author tony001
      * @date 2024-05-14 16:05:06
@@ -134,7 +134,7 @@ export interface IApiAppUtil {
      */
     switchTheme(oldTheme: string, newTheme: string, opts?: IApiData): Promise<boolean>;
     /**
-     * 切换语言
+     * 切换应用语言环境（国际化）
      *
      * @author tony001
      * @date 2024-05-14 16:05:20
@@ -160,7 +160,7 @@ export interface IApiAppUtil {
      */
     openAiChat(params: IApiAiChatParam): Promise<IApiChatMessage[]>;
     /**
-     * @description 视图缓存中心
+     * @description 视图缓存中心，用于缓存已加载的视图控制器实例，避免重复创建
      * @type {Map<string, IApiViewController>}
      * @memberof IApiAppUtil
      */

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

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