@ibiz-template/runtime 0.7.41-alpha.104 → 0.7.41-alpha.106

package/src/interface/api/controller/control/i-api-gantt.controller.ts

@@ -0,0 +1,68 @@
+import { IDEGantt } from '@ibiz/model-core';
+import { IApiData } from '@ibiz-template/core';
+import { IApiGanttNodeData, IApiGanttState, IApiGanttStyle } from '../../state';
+import { IApiTreeGridEXController } from './i-api-tree-grid-ex.controller';
+
+/**
+ * 甘特图
+ * @description 基础的项目管理控件，通过横向时间轴展示任务的开始与结束时间、进度、依赖关系及资源分配，直观呈现项目整体计划与执行状态。
+ * @primary
+ * @ctrlparams {name:sliderdraggable,title:启用滑块拖拽,parameterType:boolean,defaultvalue:true,description:设置是否启用滑块拖拽，即是否允许拖拽任务项事件}
+ * @ctrlparams {"name":"mustshowcolumns","title":"必须显示的列","parameterType":"string[]","defaultvalue":"[\"sn\",\"name\"]","description":"该参数指定的列在表格列选择弹框中将不能配置为隐藏列"}
+ * @ctrlparams {name:limitsize,title:最大限制数,parameterType:string,defaultvalue:'0',description:在列选择弹框中，用于计算除了`mustshowcolumns`参数配置的列之外，最多可显示的列数。其默认值为 '0'，代表不限制显示列数}
+ * @ctrlparams {name:enablecustomized,title:允许设置,parameterType:boolean,defaultvalue:false,description:是否允许在甘特图左侧表格中绘制列选择按钮，通过点击该按钮打开表格列选择弹框}
+ * @ctrlparams {name:unit,title:时间单位,parameterType:'month' | 'week' | 'day' | 'hour',defaultvalue:'day',description:甘特图将根据该时间单位呈现右侧甘特页面样式}
+ * @ctrlparams {"name":"mdctrlrefreshmode","title":"刷新模式","defaultvalue":"'cache'","parameterType":"'nocache' | 'cache'","description":"多数据部件刷新模式，当值为 'cache'，部件刷新时保留选中数据；当值为 'nocache'，部件刷新时清空选中数据","effectPlatform":"web"}
+ * @ctrlparams {"name":"linkdatasourcetype","title":"链接数据获取模式","parameterType":"'DEDATASET' | 'NODEDATA'","defaultvalue":"'NODEDATA'","description":"该参数值为'NODEDATA'，链接数据在节点项上获取。该参数值为'DEDATASET'，将请求服务获取链接数据"}
+ * @ctrlparams {"name":"linkappdataentityname","title":"链接数据集应用实体名称","parameterType":"string","description":"当`linkdatasourcetype`参数值为'DEDATASET'，指定链接数据集应用实体名称"}
+ * @ctrlparams {"name":"linkappdedatasetname","title":"链接应用实体结果集名称","parameterType":"string","description":"当`linkdatasourcetype`参数值为'DEDATASET'，指定链接应用实体结果集名称"}
+ * @ctrlparams {"name":"linknodedataname","title":"链接节点数据属性名称","parameterType":"string","description":"当`linkdatasourcetype`参数值为'NODEDATA'，指定链接节点数据属性名称"}
+ * @ctrlparams {"name":"fromdataitemname","title":"链接起始数据项属性名称","parameterType":"string","description":"该参数为链接起始数据项属性名称，用于指定链接线起始点"}
+ * @ctrlparams {"name":"todataitemname","title":"链接结束数据项属性名称","parameterType":"string","description":"该参数为链接结束数据项属性名称，用于指定链接线结束点"}
+ * @export
+ * @interface IApiGanttController
+ * @extends {IApiGridController<T, S>}
+ * @template T
+ * @template S
+ */
+export interface IApiGanttController<
+  T extends IDEGantt = IDEGantt,
+  S extends IApiGanttState = IApiGanttState,
+> extends IApiTreeGridEXController<T, S> {
+  /**
+   * @description 保存数据
+   * @param {IApiGanttNodeData} data 甘特图节点数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGanttController
+   */
+  save(data: IApiGanttNodeData): Promise<void>;
+  /**
+   * @description 设置甘特图样式
+   * @param {IApiGanttStyle} style 甘特图样式
+   * @memberof IApiGanttController
+   */
+  setGanttStyle(style: IApiGanttStyle): void;
+  /**
+   * @description  刷新指定树节点的子节点数据
+   * @param {(IApiGanttNodeData | IApiData)} nodeData 节点数据
+   * @param {boolean} [refreshParent] 是否刷新父数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGanttController
+   */
+  refreshNodeChildren(
+    nodeData: IApiGanttNodeData | IApiData,
+    refreshParent?: boolean,
+  ): Promise<void>;
+
+  /**
+   * @description 修改节点时间
+   * @param {IApiGanttNodeData} nodeData 节点数据
+   * @param {{ begin?: string; end?: string }} { begin, end } 开始时间，结束时间
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGanttController
+   */
+  modifyNodeTime(
+    nodeData: IApiGanttNodeData,
+    { begin, end }: { begin?: string; end?: string },
+  ): Promise<void>;
+}

package/src/interface/api/controller/control/i-api-grid.controller.ts

@@ -0,0 +1,164 @@
+/* eslint-disable prettier/prettier */
+import { IApiData } from '@ibiz-template/core';
+import { IDEGrid } from '@ibiz/model-core';
+import { IApiGridRowState, IApiGridState } from '../../state';
+import { IApiMDControlController } from './i-api-md-control.controller';
+import { IApiGridColumnController } from './grid-column';
+import { IApiGridColumnMapping } from '../common';
+import { IApiExportParams } from '../../common';
+
+/**
+ * 表格
+ * @description 采用可交互的动态数据表格组件，支持多维度排序、灵活筛选、批量操作及可视化对比，具备响应式布局与性能优化功能，实现高效的结构化数据展示与管理。
+ * @primary
+ * @export
+ * @interface IApiGridController
+ * @extends {IApiMDControlController<T, S>}
+ * @ctrlparams {"name":"overflowmode","title":"超出呈现模式","parameterType":"'wrap' | 'ellipsis'","defaultvalue":"'wrap'","description":"单元格内容超出单元格宽度时的呈现模式，包含超出省略 'ellipsis'，换行 'wrap' 两种模式"}
+ * @ctrlparams {name:emptyhiddenunit,title:无值隐藏,parameterType:boolean,defaultvalue:true,description:单元格无值时，其对应的值单位（如'天'、'%'等）是否隐藏}
+ * @ctrlparams {"name":"editshowmode","title":"行编辑显示模式","parameterType":"'row' | 'cell' | 'all'","defaultvalue":"'row'","description":"表格进行行编辑时的呈现模式，包含单行编辑模式 'row'，单元格编辑 'cell' 模式，整个表格编辑模式 'all' 三种模式"}
+ * @ctrlparams {"name":"editsavemode","title":"行编辑保存模式","parameterType":"'cell-blur' | 'auto' | 'manual'","defaultvalue":"'cell-blur'","description":"处理表格进行行编辑时的保存模式，包含单元格失焦 'cell-blur' 时保存，自动保存 'auto'，手动确认 'manual' 三种模式"}
+ * @ctrlparams {"name":"saveerrorhandlemode","title":"行编辑保存错误处理模式","parameterType":"'default' | 'reset'","defaultvalue":"'default'","description":"表格保存错误时的处理模式，包含提示错误信息 'default' 和重置表格行数据 'reset' 两种模式"}
+ * @ctrlparams {name:enablejsonschema,title:是否允许使用jsonschema模式,parameterType:boolean,defaultvalue:false,description:是否启用自定义添加表格列功能，当参数为true且后台返回 jsonschema 格式的表格列相关数据时执行添加操作}
+ * @ctrlparams {"name":"jsonschemaparams","title":"jsonschema参数数据","parameterType":"string","defaultvalue":"'{}'","description":"当`enablejsonschema`值为true时生效。支持配置 JSON 字符串并将其转化为导航参数，该参数将被附加到获取实体的 jsonschema 数据的请求参数中，获取的数据解析后用于自定义添加表格列功能，示例格式：\\{\"test\":\"%test%\"\\}"}
+ * @ctrlparams {name:percentkeys,title:是否显示百分比,parameterType:string[],defaultvalue:[],description:表示表格哪些列的单元格要显示百分比}
+ * @ctrlparams {"name":"showmode","title":"表格显示模式","parameterType":"'DEFAULT' | 'ONLYDATA' | 'MIXIN'","defaultvalue":"'DEFAULT'","description":"'DEFAULT' 显示分页栏、表格头部、无数据提示的文字及图片；'ONLYDATA' 仅显示数据区域，不显示分页栏与表格头部，在无值时不显示无数据提示图片；'MIXIN' 无数据时仅显示数据区域，不显示分页栏、表格头部、无数据提示图片"}
+ * @ctrlparams {name:rowspankeys,title:合并行的key集合,parameterType:string[],defaultvalue:[],description:用于指定表格中需要合并单元格的行，取值为表格列的 prop值（表格列模型代码标识）数组}
+ * @ctrlparams {name:colspankeys,title:合并列的key集合,parameterType:string[],defaultvalue:[],description:用于指定表格中需要合并单元格的列，取值为表格列的 prop值（表格列模型代码标识）数组}
+ * @ctrlparams {name:defaultexpandall,title:默认全部展开,parameterType:boolean,defaultvalue:false,description:树形表格时是否默认全部展开}
+ * @ctrlparams {"name":"triggermode","title":"编辑器值变更模式","parameterType":"'blur' | 'input'","defaultvalue":"'blur'","description":"该配置项用于指定编辑器触发 `emit` 事件的模式。若值为 'input'，则在输入框值变更时触发 change 事件；若值为 'blur'，则在输入框失去焦点时触发 change 事件"}
+ * @ctrlparams {"name":"mdctrlrefreshmode","title":"刷新模式","defaultvalue":"'cache'","parameterType":"'nocache' | 'cache'","description":"多数据部件刷新模式，当值为 'cache'，部件刷新时保留选中数据；当值为 'nocache'，部件刷新时清空选中数据","effectPlatform":"web"}
+ * @ctrlparams {"name":"grouprowmode","title":"分组行模式","defaultvalue":"'DEFAULT'","parameterType":"'DEFAULT'|'NEWROW'","description":"表格分组行模式，当值为 DEFAULT 时，表示分组行由业务数据第一行出，NEWROW 表示分组行独出一行","effectPlatform":"web"}
+ * @ctrlparams {"name":"paginationmode","title":"分页显示模式","defaultvalue":"'default'","parameterType":"'default'|'simple'","description":"表格分页显示模式，当值为 default 时，显示完整的分页组件，值为 simple 时，显示简略版的分页组件，仅包含总条数，当前页，上一页和下一页","effectPlatform":"web"}
+ * @ctrlparams {"name":"unionkeys","title":"表格联合主键","parameterType":"string","description":"表格联合主键，参数以|分割，用于解决同一条数据关联多个版本呈现问题","effectPlatform":"web"}
+ * @ctrlparams {"name":"batchtoolbarmode","title":"批操作工具栏显示模式","parameterType":"'default' | 'multiple'","defaultvalue":"'default'","description":"批操作工具栏显示模式，值为 'default' 时表示存在选择数据就显示批操作工具栏，值为 'multiple' 时表示选择至少2条数据才显示批操作工具栏","effectPlatform":"web"}
+ * @childrenparams {"name":"DEFGRIDCOLUMN","title":"表格属性列","interface":"IApiGridFieldColumnController"}
+ * @childrenparams {"name":"DEFGRIDCOLUMN_EDIT","title":"表格编辑列","interface":"IApiGridFieldEditColumnController"}
+ * @childrenparams {"name":"GROUPGRIDCOLUMN","title":"表格分组列","interface":"IApiGridGroupColumnController"}
+ * @childrenparams {"name":"UAGRIDCOLUMN","title":"表格操作列","interface":"IApiGridUAColumnController"}
+ * @template T
+ * @template T
+ * @template S
+ */
+export interface IApiGridController<
+  T extends IDEGrid = IDEGrid,
+  S extends IApiGridState = IApiGridState,
+> extends IApiMDControlController<T, S> {
+  /**
+   * @description 表格列数据,key 为列 codeName，可通过ctrl.columns['表格列codeName']，codeName 与 IApiColumnState.key 相同
+   * @type {{ [key: string]: IApiGridColumnController }}
+   * @memberof IApiGridController
+   */
+  columns: { [key: string]: IApiGridColumnController };
+
+  /**
+   * @description 保存单条数据
+   * @param {IApiData} data 数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGridController
+   */
+  save(data: IApiData): Promise<void>;
+
+  /**
+   * @description 设置行属性的值，其中ignore=是否忽略脏值检查（true=不提示用户数据变更，默认false）
+   * @param {IApiGridRowState} row 行状态对象
+   * @param {string} name 要设置数据的列名称
+   * @param {unknown} value 要设置的值
+   * @param {boolean} ignore 忽略脏值检查
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGridController
+   */
+  setRowValue(
+    row: IApiGridRowState,
+    name: string,
+    value: unknown,
+    ignore: boolean,
+  ): Promise<void>;
+
+  /**
+   * @description 校验一行数据的所有编辑项
+   * @param {IApiGridRowState} row 要校验的行数据
+   * @returns {*}  {Promise<boolean>}
+   * @memberof IApiGridController
+   */
+  validate(row: IApiGridRowState): Promise<boolean>;
+
+  /**
+   * @description 校验所有行数据
+   * @returns {*}  {Promise<boolean>}
+   * @memberof IApiGridController
+   */
+  validateAll(): Promise<boolean>;
+
+  /**
+   * @description 保存表格所有数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGridController
+   */
+  saveAll(): Promise<void>;
+
+  /**
+   * @description 切换表格的行编辑开启关闭状态
+   * @memberof IApiGridController
+   */
+  toggleRowEdit(): void;
+
+  /**
+   * @description 切换单行编辑状态，editable表示行编辑目标状态，isSave=true表示关闭编辑时自动保存（默认true）
+   * @param {IApiGridRowState} row 行数据控制器
+   * @param {boolean} [editable] 目标编辑状态
+   * @param {boolean} [isSave] 是否保存
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGridController
+   */
+  switchRowEdit(
+    row: IApiGridRowState,
+    editable?: boolean,
+    isSave?: boolean,
+  ): Promise<void>;
+
+  /**
+   * @description 表格编辑项更新
+   * @param {IApiGridRowState} row 行数据控制器
+   * @param {string} updateId 更新项标识
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGridController
+   */
+  updateGridEditItem(row: IApiGridRowState, updateId: string): Promise<void>;
+
+  /**
+   * @description 导出数据，导出成Excel文件
+   * @param {{  event?: MouseEvent; params: IApiExportParams }} args 导出参数
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiGridController
+   */
+  exportData(args: {event?: MouseEvent; params: IApiExportParams;}): Promise<void>;
+
+  /**
+   * @description 基于数据获取行数据控制器
+   * @param {IApiData} data 数据
+   * @returns {*}  {(IApiGridRowState | undefined)}
+   * @memberof IApiGridController
+   */
+  findRowState(data: IApiData): IApiGridRowState | undefined;
+
+  /**
+   * @description 切换折叠(分组表格使用),tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
+   * @param {{ tag: string; expand: boolean }} [params] 切换折叠参数
+   * @memberof IApiGridController
+   */
+  changeCollapse(params?: { tag?: string; expand?: boolean }): void;
+
+  /**
+   * @description 获取表格列
+   * @template K
+   * @param {K} type 表格列类型
+   * @param {string} id 表格列标识
+   * @returns {*}  {IApiGridColumnMapping[K]}
+   * @memberof IApiGridController
+   */
+  getGridColumn<K extends keyof IApiGridColumnMapping>(
+    type: K,
+    id: string,
+  ): IApiGridColumnMapping[K];
+}

package/src/interface/api/controller/control/i-api-kanban.controller.ts

@@ -0,0 +1,24 @@
+import { IDEKanban } from '@ibiz/model-core';
+import { IApiKanbanState } from '../../state';
+import { IApiDataViewControlController } from './i-api-data-view-control.controller';
+
+/**
+ * 看板
+ * @description 采用可视化看板（Kanban）模式，通过可拖拽卡片和折叠卡片分组实现业务数据的多维度管理与状态流转，支持实时数据反馈和响应式布局。
+ * @primary
+ * @export
+ * @interface IApiKanbanController
+ * @extends {IApiDataViewControlController<T, S>}
+ * @ctrlparams {"name":"draggablemode","title":"拖拽模式","defaultvalue": "3","parameterType":"0 | 1 | 2 | 3","description":"该参数控制看板的拖拽能力，可选值为：0：无拖拽， 1：仅同分组，2：仅同泳道，3：全部","effectPlatform":"web"}
+ * @ctrlparams {"name":"lanedescription","title":"泳道描述","defaultvalue": "","parameterType":"string","description":"该参数用于显示泳道的描述信息，默认为实体逻辑名称","effectPlatform":"web"}
+ * @ctrlparams {"name":"mdctrlrefreshmode","title":"刷新模式","defaultvalue":"'cache'","parameterType":"'nocache' | 'cache'","description":"多数据部件刷新模式，当值为 'cache'，部件刷新时保留选中数据；当值为 'nocache'，部件刷新时清空选中数据","effectPlatform":"web"}
+ * @ctrlparams {"name":"enablefullscreen","title":"是否启用全屏功能","defaultvalue": "true","parameterType":"boolean","description":"该参数用于设置看板是否启用全屏功能","effectPlatform":"web"}
+ * @ctrlparams {"name":"enablegrouphidden","title":"是否启用隐藏分组功能","defaultvalue": "false","parameterType":"boolean","description":"该参数用于设置看板是否启用隐藏分组功能","effectPlatform":"web"}
+ * @ctrlparams {"name":"paginationmode","title":"分页显示模式","defaultvalue":"'default'","parameterType":"'default'|'simple'","description":"表格分页显示模式，当值为 default 时，显示完整的分页组件，值为 simple 时，显示简略版的分页组件，仅包含总条数，当前页，上一页和下一页","effectPlatform":"web"}
+ * @template T
+ * @template S
+ */
+export interface IApiKanbanController<
+  T extends IDEKanban = IDEKanban,
+  S extends IApiKanbanState = IApiKanbanState,
+> extends IApiDataViewControlController<T, S> {}

package/src/interface/api/controller/control/i-api-list.controller.ts

@@ -0,0 +1,44 @@
+import { IDEList } from '@ibiz/model-core';
+import { IApiData } from '@ibiz-template/core';
+import { IApiListState } from '../../state';
+import { IApiMDControlController } from './i-api-md-control.controller';
+
+/**
+ * 列表
+ * @description 以列表形式展示内容，列表项整合图文、操作按钮等元素，呈现清晰的信息层级与视觉分隔。
+ * @primary
+ * @export
+ * @interface IApiListController
+ * @extends {IApiMDControlController<T, S>}
+ * @ctrlparams {"name":"showmode","title":"显示模式","defaultvalue":"'DEFAULT'","parameterType":"'DEFAULT' | 'ONLYDATA' | 'MIXIN'","description":"'DEFAULT' 显示分页栏和无数据提示的文字及图片；'ONLYDATA' 仅显示数据区域，分页栏不显示，在无值时不显示无数据提示图片；'MIXIN' 无值时仅显示数据区域，不显示分页栏和无数据提示图片"}
+ * @ctrlparams {name:defaultexpandall,title:默认展开所有,parameterType:boolean,defaultvalue:false,description:列表默认是否将所有分组展开显示}
+ * @ctrlparams {"name":"mdctrlrefreshmode","title":"刷新模式","defaultvalue":"'cache'","parameterType":"'nocache' | 'cache'","description":"多数据部件刷新模式，当值为 'cache'，部件刷新时保留选中数据；当值为 'nocache'，部件刷新时清空选中数据","effectPlatform":"web"}
+ * @ctrlparams {"name":"batchtoolbarmode","title":"批操作工具栏显示模式","parameterType":"'default' | 'multiple'","defaultvalue":"'default'","description":"批操作工具栏显示模式，值为 'default' 时表示存在选择数据就显示批操作工具栏，值为 'multiple' 时表示选择至少2条数据才显示批操作工具栏","effectPlatform":"web"}
+ * @ctrlparams {"name":"paginationmode","title":"分页显示模式","defaultvalue":"'default'","parameterType":"'default'|'simple'","description":"表格分页显示模式，当值为 default 时，显示完整的分页组件，值为 simple 时，显示简略版的分页组件，仅包含总条数，当前页，上一页和下一页","effectPlatform":"web"}
+ * @template T
+ * @template S
+ */
+export interface IApiListController<
+  T extends IDEList = IDEList,
+  S extends IApiListState = IApiListState,
+> extends IApiMDControlController<T, S> {
+  /**
+   * @description 获取列表全部数据
+   * @returns {*}  {IApiData[]}
+   * @memberof IApiListController
+   */
+  getAllData(): IApiData[];
+
+  /**
+   * @description 切换折叠，tag=指定分组标识(不传则全部)，expand=目标状态(不传则反转)
+   * @param {{ tag: string; expand: boolean }} [params] 切换折叠参数
+   * @memberof IApiListController
+   */
+  changeCollapse(params?: { tag?: string; expand?: boolean }): void;
+
+  /**
+   * @description 滚动到顶部
+   * @memberof IApiListController
+   */
+  scrollToTop(): void;
+}

package/src/interface/api/controller/control/i-api-map.controller.ts

@@ -0,0 +1,52 @@
+import { ISysMap } from '@ibiz/model-core';
+import { EChartsOption, EChartsType } from 'echarts';
+import { IApiMapState } from '../../state';
+import { IApiMDControlController } from './i-api-md-control.controller';
+
+/**
+ * 地图
+ * @description 采用交互式地图组件实现地理数据可视化，支持区域渲染、动态标注与多级缩放，提供空间数据分析能力。
+ * @primary
+ * @export
+ * @interface IMapController
+ * @extends {IApiMDControlController<T, S>}
+ * @ctrlparams { name:defaultareacode,title:默认地区编码,parameterType:string | number,defaultvalue:100000,description:若设置该值，地图初始化时将根据此编码显示指定地图区域，未设置时默认显示全国}
+ * @ctrlparams { name:strareacode,title:区域编码是否是字符串,parameterType:boolean,defaultvalue:false,description:该值为true时，将默认地区编码 `defaultareacode` 值转为字符串类型，默认转为数值类型}
+ * @ctrlparams { name:jsonbaseurl,title:地图json数据基础路径,parameterType:string,defaultvalue:'./assets/json/map',description:获取地图地理数据的请求路径}
+ * @ctrlparams { name:enableddrilldown,title:是否允许下钻,parameterType:boolean,defaultvalue:true,description:自定义样式下，是否启用地图下钻功能，默认开启}
+ * @ctrlparams { name:enabledfullscreen,title:是否允许全屏,parameterType:boolean,defaultvalue:false,description:自定义样式下，是否启用地图全屏功能，默认关闭}
+ * @ctrlparams { name:defaultopts,title:地图默认参数,parameterType:string,description:自定义样式下，配置该参数可调整地图呈现模式，参数为IAPiMapOptions}
+ * @template T
+ * @template S
+ */
+export interface IApiMapController<
+  T extends ISysMap = ISysMap,
+  S extends IApiMapState = IApiMapState,
+> extends IApiMDControlController<T, S> {
+  /**
+   * @description echarts 实例，使用前需判断是否存在（图表未初始化时为 undefined）
+   * @type {EChartsType}
+   * @memberof IApiMapController
+   */
+  chart?: EChartsType;
+
+  /**
+   * @description 地图配置对象，使用前需判断是否存在
+   * @type {EChartsOption}
+   * @memberof IApiMapController
+   */
+  options?: EChartsOption;
+
+  /**
+   * @description 下钻
+   * @param {(string | number)} areaCode 区域编码
+   * @memberof IApiMapController
+   */
+  drillDown(areaCode: string | number): void;
+
+  /**
+   * @description 返回
+   * @memberof IApiMapController
+   */
+  back(): void;
+}

package/src/interface/api/controller/control/i-api-md-control.controller.ts

@@ -0,0 +1,224 @@
+import { IMDControl } from '@ibiz/model-core';
+import { IApiData, IApiParams } from '@ibiz-template/core';
+import { IApiDataAbilityParams } from '../../common';
+import { IApiMDControlState } from '../../state';
+import { IApiControlController } from './i-api-control.controller';
+/**
+ * @description 多数据部件控制器加载参数
+ * @export
+ * @interface IApiMDCtrlLoadParams
+ * @extends {IApiDataAbilityParams}
+ */
+export interface IApiMDCtrlLoadParams extends IApiDataAbilityParams {
+  /**
+   * @description 是否是初始加载（默认为false，设置为true时，会将当前分页重置为第一页）
+   * @type {boolean}
+   * @memberof IApiMDCtrlLoadParams
+   */
+  isInitialLoad?: boolean;
+
+  /**
+   * @description 是否加载更多
+   * @type {boolean}
+   * @memberof IApiMDCtrlLoadParams
+   */
+  isLoadMore?: boolean;
+
+  /**
+   * @description 触发源
+   * @type {('DEFAULT' | 'REFRESH' | string)}
+   * @memberof IApiMDCtrlLoadParams
+   */
+  triggerSource?: 'DEFAULT' | 'REFRESH' | string;
+}
+
+/**
+ * @description 多数据部件控制器删除参数
+ * @export
+ * @interface IApiMDCtrlRemoveParams
+ * @extends {IApiDataAbilityParams}
+ */
+export interface IApiMDCtrlRemoveParams extends IApiDataAbilityParams {
+  /**
+   * @description 是否不需要刷新(默认为false，如果需要刷新不传即可，效果为删除后补全这一页缺少的数据)
+   * @type {boolean}
+   * @memberof IApiMDCtrlRemoveParams
+   */
+  notRefresh?: boolean;
+}
+
+/**
+ * @description 多数据部件分组参数
+ * @export
+ * @interface IApiCustomGroupParams
+ */
+export interface IApiMDGroupParams {
+  /**
+   * @description 分组属性标识
+   * @type {string}
+   * @memberof IApiMDGroupParams
+   */
+  groupFieldId: string;
+
+  /**
+   * @description 分组代码表标识
+   * @type {string}
+   * @memberof IApiMDGroupParams
+   */
+  groupCodeListId?: string;
+
+  /**
+   * @description 日期分组格式
+   * @type {(('year' | 'quarter' | 'month' | 'week' | 'day')[])} (年 | 季度 | 月 | 周 | 天)
+   * @memberof IApiMDGroupParams
+   */
+  dateFormat?: ('year' | 'quarter' | 'month' | 'week' | 'day')[];
+
+  /**
+   * @description 是否为自定义扩展属性
+   * @type {boolean}
+   * @memberof IApiMDGroupParams
+   */
+  extend?: boolean;
+}
+
+/**
+ * 移动端多数据部件
+ * @description 多数据部件控制器
+ * @primary
+ * @export
+ * @interface IApiMDControlController
+ * @extends {IApiControlController<T, S>}
+ * @template T
+ * @template S
+ */
+export interface IApiMDControlController<
+  T extends IMDControl = IMDControl,
+  S extends IApiMDControlState = IApiMDControlState,
+> extends IApiControlController<T, S> {
+  /**
+   * @description 设置排序
+   * @param {string} [key] 排序字段
+   * @param {('asc' | 'desc')} [order] 排序顺序
+   * @memberof IApiMDControlController
+   */
+  setSort(key?: string, order?: 'asc' | 'desc'): void;
+  /**
+   * @description 加载更多
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  loadMore(): Promise<void>;
+  /**
+   * @description 加载数据
+   * @param {IApiMDCtrlLoadParams} [args] 加载参数
+   * @returns {*}  {Promise<IApiData[]>}
+   * @memberof IApiMDControlController
+   */
+  load(args?: IApiMDCtrlLoadParams): Promise<IApiData[]>;
+
+  /**
+   * @description 删除数据
+   * @param {IApiMDCtrlRemoveParams} [args] 删除参数
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  remove(args?: IApiMDCtrlRemoveParams): Promise<void>;
+
+  /**
+   * @description 刷新数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  refresh(): Promise<void>;
+
+  /**
+   * @description 导入数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  importData(): Promise<void>;
+
+  /**
+   * @description 获取选中数据
+   * @returns {*}  {IApiData[]}
+   * @memberof IApiMDControlController
+   */
+  getData(): IApiData[];
+
+  /**
+   * @description 设置选中数据,设置的数据和已经选中的不一样时会触发onSelectionChange事件，其中isEmit参数true=触发 onSelectionChange 事件（默认true），false=静默选中不触发
+   * @param {IApiData[]} selection 数据集合
+   * @param {boolean} isEmit 是否触发onSelectionChange事件
+   * @memberof IApiMDControlController
+   */
+  setSelection(selection: IApiData[], isEmit?: boolean): void;
+
+  /**
+   * @description 设置激活数据
+   * @param {IApiData} data 数据
+   * @param {(MouseEvent | undefined)} [event] 鼠标事件
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  setActive(data: IApiData, event?: MouseEvent | undefined): Promise<void>;
+
+  /**
+   * @description 跳转第一页
+   * @returns {*}  {Promise<IApiData[]>}
+   * @memberof IApiMDControlController
+   */
+  goToFirstPage(): Promise<IApiData[]>;
+
+  /**
+   * @description 跳转上一页
+   * @returns {*}  {Promise<IApiData[]>}
+   * @memberof IApiMDControlController
+   */
+  goToPreviousPage(): Promise<IApiData[]>;
+
+  /**
+   * @description 跳转下一页
+   * @returns {*}  {Promise<IApiData[]>}
+   * @memberof IApiMDControlController
+   */
+  goToNextPage(): Promise<IApiData[]>;
+
+  /**
+   * @description 跳转最后一页
+   * @returns {*}  {Promise<IApiData[]>}
+   * @memberof IApiMDControlController
+   */
+  goToLastPage(): Promise<IApiData[]>;
+
+  /**
+   * @description 选中全部数据（传入参数为true表示全选，false表示取消全选，不传参数则根据当前是否有选中数据自动判断是全选还是取消全选）
+   * @param {boolean} [state] 是否全选，若传递参数则以传递的参数控制是否全选，否则自动计算是否全选
+   * @memberof IApiMDControlController
+   */
+  selectAll(state?: boolean): void;
+
+  /**
+   * @description 执行多数据分组
+   * @param {IApiMDGroupParams[]} [arg] 分组参数集合（多层分组暂未支持）
+   * @param {IApiParams} [params] 额外参数
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  execGroup(arg: IApiMDGroupParams[], params?: IApiParams): Promise<void>;
+
+  /**
+   * @description 设置选中数据
+   * @param {IApiData[]} items 数据集合
+   * @memberof IApiMDControlController
+   */
+  setSelectedData(items: IApiData[]): void;
+
+  /**
+   * @description 新建行
+   * @param {IApiMDCtrlLoadParams} [args] 加载参数
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMDControlController
+   */
+  newRow(args?: IApiMDCtrlLoadParams): Promise<void>;
+}

package/src/interface/api/controller/control/i-api-medit-view-panel.controller.ts

@@ -0,0 +1,48 @@
+import { IDEMultiEditViewPanel } from '@ibiz/model-core';
+import { IApiMEditViewPanelState, IApiPanelUiItem } from '../../state';
+import { IApiMDControlController } from './i-api-md-control.controller';
+import { IApiViewController } from '../view';
+
+/**
+ * 多编辑视图面板
+ * @description 支持多个编辑视图同时存在并可执行新建、编辑、删除等操作。
+ * @primary
+ * @export
+ * @interface IApiMEditViewPanelController
+ * @extends {IApiMDControlController<T, S>}
+ * @template T
+ * @template S
+ */
+export interface IApiMEditViewPanelController<
+  T extends IDEMultiEditViewPanel = IDEMultiEditViewPanel,
+  S extends IApiMEditViewPanelState = IApiMEditViewPanelState,
+> extends IApiMDControlController<T, S> {
+  /**
+   * @description 嵌入视图集合,key为IApiPanelUiItem项id，value为对应的视图控制器
+   * @type {Map<string, IApiViewController>}
+   * @memberof IApiMEditViewPanelController
+   */
+  embedViews: Map<string, IApiViewController>;
+
+  /**
+   * @description 添加项
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMEditViewPanelController
+   */
+  handleAdd(): Promise<void>;
+
+  /**
+   * @description 删除项
+   * @param {IApiPanelUiItem} item 项数据
+   * @returns {*}  {Promise<void>}
+   * @memberof IApiMEditViewPanelController
+   */
+  handleDelete(item: IApiPanelUiItem): Promise<void>;
+
+  /**
+   * @description 获取激活视图
+   * @returns {*}  {(IApiViewController | undefined)}
+   * @memberof IApiMEditViewPanelController
+   */
+  getActiveView(): IApiViewController | undefined;
+}