@ibiz-template/runtime 0.7.41-alpha.86 → 0.7.41-alpha.88

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

@@ -5,7 +5,7 @@
  */
 export interface IApiGlobalImgCompressConfig {
     /**
-     * @description 图片压缩范围（超过该范围进行压缩，单位kb）
+     * @description 图片压缩阈值（单位：KB）；当图片大小超过该值时触发压缩
      * @type {number}
      * @default 1024
      * @platform mob
@@ -13,7 +13,7 @@ export interface IApiGlobalImgCompressConfig {
      */
     limit: number;
     /**
-     * @description 图片压缩质量（范围0-1，为0时不压缩）
+     * @description 图片压缩质量（范围：0~1）；值越小压缩率越高，0 表示不进行压缩
      * @type {number}
      * @default 0
      * @platform mob
@@ -21,7 +21,7 @@ export interface IApiGlobalImgCompressConfig {
      */
     quality: number;
     /**
-     * @description 压缩图片最大宽度，单位px
+     * @description 压缩后图片允许的最大宽度（单位：px），超过时按比例缩放
      * @type {number}
      * @default 1280
      * @platform mob

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

@@ -5,7 +5,7 @@
  */
 export interface IApiGlobalMobConfig {
     /**
-     * @description 移动端是否显示应用标题，为false时设置浏览器标题时只设置视图标题，不添加应用标题
+     * @description 是否在移动端页面标题中显示应用名称；为 false 时浏览器标题仅显示视图标题
      * @type {boolean}
      * @default true
      * @platform mob
@@ -44,7 +44,7 @@ export interface IApiGlobalMobConfig {
      */
     mobWeChatDebug: boolean;
     /**
-     * @description 是否显示文件上传loading
+     * @description 文件上传过程中是否显示全局 loading 提示
      * @type {boolean}
      * @platform mob
      * @memberof IApiGlobalMobConfig
@@ -67,7 +67,7 @@ export interface IApiGlobalMobConfig {
      */
     mobEnableStoredQuery: boolean;
     /**
-     * @description 移动端工具栏的显示模式，可选值包含IMMEDIATE（即时渲染模式）、COLLAPSIBLE（可折叠模式）
+     * @description 工具栏显示模式：IMMEDIATE 立即展示；COLLAPSIBLE 支持折叠展开
      * @type {('IMMEDIATE' | 'COLLAPSIBLE')}
      * @default IMMEDIATE
      * @platform mob
@@ -75,7 +75,7 @@ export interface IApiGlobalMobConfig {
      */
     toolbarShowMode: 'IMMEDIATE' | 'COLLAPSIBLE';
     /**
-     * @description 移动端工具栏分组与行为组的展示模式，可选值包含DEFAULT（气泡模式，组内容以悬浮气泡形式展示）、ACTIONSHEET（行为列表模式，组内容以下拉抽屉形式展示）
+     * @description 工具栏分组展示方式：DEFAULT 气泡形式；ACTIONSHEET 抽屉列表形式
      * @type {('DEFAULT' | 'ACTIONSHEET')}
      * @default ACTIONSHEET
      * @platform mob

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/grid-column/i-api-grid-column.controller.d.ts

@@ -15,7 +15,7 @@ export interface IApiGridColumnController {
      */
     readonly model: IDEGridColumn;
     /**
-     * @description 表格控制器
+     * @description 所属表格控制器（反向引用）
      * @type {IApiGridController}
      * @memberof IApiGridColumnController
      */

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

@@ -18,7 +18,7 @@ import { IApiMDControlController } from './i-api-md-control.controller';
  */
 export interface IApiDataViewControlController<T extends IDEDataView = IDEDataView, S extends IApiDataViewControlState = IApiDataViewControlState> extends IApiMDControlController<T, S> {
     /**
-     * @description 切换折叠，其中tag表示操作指定分组标识，若不传则操作当前卡片的所有分组展开状态，expand表示是否展开，若不传则以当前分组状态为基准切换
+     * @description 切换折叠，tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
      * @param {{ tag?: string; expand?: boolean }} [params] 切换折叠参数
      * @memberof IApiDataViewControlController
      */

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,13 +71,13 @@ export interface IApiFormController<T extends IDEForm = IDEForm, S extends IApiF
      */
     getReal(): IApiData[];
     /**
-     * @description 刷新当前部件
+     * @description 刷新表单数据（通常重新加载当前数据）
      * @returns {*}  {Promise<void>}
      * @memberof IApiFormController
      */
     refresh(): Promise<void>;
     /**
-     * @description 切换折叠，其中tag表示操作指定分组标识，若不传则操作当前表单的所有分组展开状态，expand表示是否展开，若不传则以当前分组状态为基准切换
+     * @description 切换折叠，tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
      * @param {{ tag: string; expand: boolean }} [params] 切换折叠参数
      * @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/control/i-api-grid.controller.d.ts

@@ -40,7 +40,7 @@ import { IApiExportParams } from '../../common';
  */
 export interface IApiGridController<T extends IDEGrid = IDEGrid, S extends IApiGridState = IApiGridState> extends IApiMDControlController<T, S> {
     /**
-     * @description 表格列数据
+     * @description 表格列数据,key为表格列代码名称，可通过ctrl.columns['表格列codeName']，codeName 与 IApiColumnState.key 相同
      * @type {{ [key: string]: IApiGridColumnController }}
      * @memberof IApiGridController
      */
@@ -55,8 +55,8 @@ export interface IApiGridController<T extends IDEGrid = IDEGrid, S extends IApiG
      */
     save(data: IApiData): Promise<void>;
     /**
-     * @description 设置行属性的值
-     * @param {IApiGridRowState} row 行状态控制器
+     * @description 设置行属性的值，其中ignore=是否忽略脏值检查（true=不提示用户数据变更，默认false）
+     * @param {IApiGridRowState} row 行状态对象
      * @param {string} name 要设置数据的列名称
      * @param {unknown} value 要设置的值
      * @param {boolean} ignore 忽略脏值检查
@@ -66,7 +66,7 @@ export interface IApiGridController<T extends IDEGrid = IDEGrid, S extends IApiG
     setRowValue(row: IApiGridRowState, name: string, value: unknown, ignore: boolean): Promise<void>;
     /**
      * @description 校验一行数据的所有编辑项
-     * @param {IApiGridRowState} row 要校验的行数据控制器
+     * @param {IApiGridRowState} row 要校验的行数据
      * @returns {*}  {Promise<boolean>}
      * @memberof IApiGridController
      */
@@ -89,7 +89,7 @@ export interface IApiGridController<T extends IDEGrid = IDEGrid, S extends IApiG
      */
     toggleRowEdit(): void;
     /**
-     * @description 切换单行的编辑状态
+     * @description 切换单行编辑状态，editable表示行编辑目标状态，isSave=true表示关闭编辑时自动保存（默认true）
      * @param {IApiGridRowState} row 行数据控制器
      * @param {boolean} [editable] 目标编辑状态
      * @param {boolean} [isSave] 是否保存
@@ -123,7 +123,7 @@ export interface IApiGridController<T extends IDEGrid = IDEGrid, S extends IApiG
      */
     findRowState(data: IApiData): IApiGridRowState | undefined;
     /**
-     * @description 切换折叠(分组表格使用),其中tag表示操作指定表格分组行标识，若不传则操作当前表格的所有分组展开状态，expand表示是否展开，若不传则以当前分组状态为基准切换
+     * @description 切换折叠(分组表格使用),tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
      * @param {{ tag: string; expand: boolean }} [params] 切换折叠参数
      * @memberof IApiGridController
      */

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

@@ -25,7 +25,7 @@ export interface IApiListController<T extends IDEList = IDEList, S extends IApiL
      */
     getAllData(): IApiData[];
     /**
-     * @description 切换折叠，其中tag表示操作指定列表分组标识，若不传则操作当前列表的所有分组展开状态，expand表示是否展开，若不传则基于当前分组状态取反
+     * @description 切换折叠，tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
      * @param {{ tag: string; expand: boolean }} [params] 切换折叠参数
      * @memberof IApiListController
      */

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

@@ -37,7 +37,7 @@ export interface IApiMDCtrlLoadParams extends IApiDataAbilityParams {
  */
 export interface IApiMDCtrlRemoveParams extends IApiDataAbilityParams {
     /**
-     * @description 是否不需要刷新(默认为否，如果不需要刷新传true)
+     * @description 是否不需要刷新(默认为false，如果需要刷新不传即可，效果为删除后补全这一页缺少的数据)
      * @type {boolean}
      * @memberof IApiMDCtrlRemoveParams
      */

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

@@ -38,7 +38,7 @@ export interface IApiTreeController<T extends IDETree = IDETree, S extends IApiT
      */
     expandNodeByKey(expandedKeys: string[]): Promise<void>;
     /**
-     * @description 切换折叠，其中tag表示操作指定树节点标识，若不传则操作当前树的第一层节点展开状态，expand表示是否展开，若不传则基于节点展开状态取反
+     * @description 切换折叠，tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
      * @param {{ tag?: string; expand?: boolean }} [params] 切换折叠参数
      * @memberof IApiTreeController
      */

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
      */