ice-entity-designer 0.0.38 → 0.0.39

package/dist/types/flow/FlowNode.d.mts

@@ -66,6 +66,13 @@ export default class FlowNode extends ICEGroup {
      * 不参与引擎序列化（否则往返会重复挂载，且子组件 zIndex 抖动，见 ICEComponent.hasDerivedChildren）。
      */
     hasDerivedChildren(): boolean;
+    /**
+     * FlowNode **既是复合组件、又是容器**：形状 / 标题 / BPMN 角标都是派生的（不进文档），
+     * 但池装泳道、泳道装节点、分组装子节点都是**真实子节点**，必须进文档 ——
+     * 不然 `serialize() → load()` 之后池里的泳道与节点会整套消失（实测：3 个元素只剩 1 个）。
+     * 引擎的 `getSerializableChildren()` 钩子正是为这种「复合 + 容器」组件准备的。
+     */
+    getSerializableChildren(): any[];
     constructor(props?: any);
     /** 按当前 kind / 尺寸 / 配色重建形状与标题（切换类型或改样式时调用） */
     private __buildShape;

package/dist/types/flow/FlowNode.d.ts

@@ -66,6 +66,13 @@ export default class FlowNode extends ICEGroup {
      * 不参与引擎序列化（否则往返会重复挂载，且子组件 zIndex 抖动，见 ICEComponent.hasDerivedChildren）。
      */
     hasDerivedChildren(): boolean;
+    /**
+     * FlowNode **既是复合组件、又是容器**：形状 / 标题 / BPMN 角标都是派生的（不进文档），
+     * 但池装泳道、泳道装节点、分组装子节点都是**真实子节点**，必须进文档 ——
+     * 不然 `serialize() → load()` 之后池里的泳道与节点会整套消失（实测：3 个元素只剩 1 个）。
+     * 引擎的 `getSerializableChildren()` 钩子正是为这种「复合 + 容器」组件准备的。
+     */
+    getSerializableChildren(): any[];
     constructor(props?: any);
     /** 按当前 kind / 尺寸 / 配色重建形状与标题（切换类型或改样式时调用） */
     private __buildShape;

package/dist/types/ice-render/graphic/ICEComponent.d.mts

@@ -371,6 +371,21 @@ declare abstract class ICEComponent extends ICEEventTarget {
      * 默认为 false（普通容器/叶子组件的子节点是「真数据」，必须序列化）。
      */
     hasDerivedChildren(): boolean;
+    /**
+     * 复合组件里**需要进文档的真实子节点**（可选实现）。
+     *
+     * 背景：`hasDerivedChildren() === true` 表示「子节点都是派生结果、不进文档」，
+     * 但有一类组件**既是复合组件、又是容器** —— 典型是流程图 / BPMN 的节点与池：
+     * 它自己按 state 派生形状（内框 / 角标 / 标题），同时又真的装着子节点（泳道、泳道里的节点）。
+     * 只声明 `hasDerivedChildren()` 的话，序列化会把**真实子节点也一起跳过**，
+     * 于是 `serialize() → load()` 之后池里的泳道和节点整套消失（实测：3 个元素只剩 1 个）。
+     *
+     * 实现这个方法的组件要返回「真实子节点」（通常 = `childNodes` 减去派生部件），
+     * 引擎据此只序列化这些子节点；反序列化时构造函数仍会重建派生部件，不会重复。
+     *
+     * 不实现时行为**与以前完全一致**（复合组件一个子节点都不进文档）—— 默认不变，属增量能力。
+     */
+    getSerializableChildren(): ICEComponent[];
     /**
      * 获取组件的最小包围盒，此盒子的变换矩阵与组件自身完全相同。
      * 此方法需要在 render() 之后调用，组件没有渲染时无法计算最小包围盒。

package/dist/types/ice-render/graphic/ICEComponent.d.ts

@@ -371,6 +371,21 @@ declare abstract class ICEComponent extends ICEEventTarget {
      * 默认为 false（普通容器/叶子组件的子节点是「真数据」，必须序列化）。
      */
     hasDerivedChildren(): boolean;
+    /**
+     * 复合组件里**需要进文档的真实子节点**（可选实现）。
+     *
+     * 背景：`hasDerivedChildren() === true` 表示「子节点都是派生结果、不进文档」，
+     * 但有一类组件**既是复合组件、又是容器** —— 典型是流程图 / BPMN 的节点与池：
+     * 它自己按 state 派生形状（内框 / 角标 / 标题），同时又真的装着子节点（泳道、泳道里的节点）。
+     * 只声明 `hasDerivedChildren()` 的话，序列化会把**真实子节点也一起跳过**，
+     * 于是 `serialize() → load()` 之后池里的泳道和节点整套消失（实测：3 个元素只剩 1 个）。
+     *
+     * 实现这个方法的组件要返回「真实子节点」（通常 = `childNodes` 减去派生部件），
+     * 引擎据此只序列化这些子节点；反序列化时构造函数仍会重建派生部件，不会重复。
+     *
+     * 不实现时行为**与以前完全一致**（复合组件一个子节点都不进文档）—— 默认不变，属增量能力。
+     */
+    getSerializableChildren(): ICEComponent[];
     /**
      * 获取组件的最小包围盒，此盒子的变换矩阵与组件自身完全相同。
      * 此方法需要在 render() 之后调用，组件没有渲染时无法计算最小包围盒。

package/dist/types/power/power_shapes.d.mts

@@ -73,6 +73,8 @@ export default class PowerSymbol extends ICEGroup {
         component: any;
     }>;
     hasDerivedChildren(): boolean;
+    /** 真实子节点 = childNodes 减去派生部件（`parts`）；容器化的域包组件靠它做快照往返 */
+    getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;
     private static readonly __shapeKeys;

package/dist/types/power/power_shapes.d.ts

@@ -73,6 +73,8 @@ export default class PowerSymbol extends ICEGroup {
         component: any;
     }>;
     hasDerivedChildren(): boolean;
+    /** 真实子节点 = childNodes 减去派生部件（`parts`）；容器化的域包组件靠它做快照往返 */
+    getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;
     private static readonly __shapeKeys;

package/dist/types/secondary/secondary_shapes.d.mts

@@ -47,6 +47,8 @@ export default class SecondarySymbol extends ICEGroup {
         component: any;
     }>;
     hasDerivedChildren(): boolean;
+    /** 真实子节点 = childNodes 减去派生部件（`parts`）；容器化的域包组件靠它做快照往返 */
+    getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;
     private static readonly __shapeKeys;

package/dist/types/secondary/secondary_shapes.d.ts

@@ -47,6 +47,8 @@ export default class SecondarySymbol extends ICEGroup {
         component: any;
     }>;
     hasDerivedChildren(): boolean;
+    /** 真实子节点 = childNodes 减去派生部件（`parts`）；容器化的域包组件靠它做快照往返 */
+    getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;
     private static readonly __shapeKeys;

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-entity-designer",
-  "version": "0.0.38",
+  "version": "0.0.39",
   "description": "An entity designer based on ice-render.",
   "repository": {
     "type": "git",