ice-entity-designer 0.0.32 → 0.0.34

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

@@ -85,7 +85,7 @@ export default class FlowDesigner {
     protected __emitChange(): void;
     /** 订阅节点的拖拽事件：拖动是画布侧的行为，designer 需要感知才能广播与记历史 */
     protected __attachNodeListeners(node: any): void;
-    private __detachNodeListeners;
+    protected __detachNodeListeners(node: any): void;
     private __onBeforeMove;
     private __onAfterMove;
     private __endMoveSession;

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

@@ -85,7 +85,7 @@ export default class FlowDesigner {
     protected __emitChange(): void;
     /** 订阅节点的拖拽事件：拖动是画布侧的行为，designer 需要感知才能广播与记历史 */
     protected __attachNodeListeners(node: any): void;
-    private __detachNodeListeners;
+    protected __detachNodeListeners(node: any): void;
     private __onBeforeMove;
     private __onAfterMove;
     private __endMoveSession;

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

@@ -13,6 +13,15 @@ export declare type PowerIssue = {
     message: string;
     id?: string;
 };
+/**
+ * 母线接间隔的几何约定：设备**顶部引线**贴在母线中心线下方这么多像素。
+ *
+ * 方案 A（零引擎改动）：母线当容器，挂在它上面的间隔用「几何贴合 + 父容器」表达等电位，
+ * 不再需要从母线中心拉一条绕行导体。评估见 `ice-render/docs/architecture/16-link-port-evaluation.md`。
+ */
+export declare const POWER_BUS_ATTACH_GAP = 3;
+/** 判定「仍然挂在母线上」的纵向容差（拖离出这个范围就算断开，走校验提示） */
+export declare const POWER_BUS_ATTACH_TOLERANCE = 8;
 export declare type PowerTopology = {
     /** 带电的设备 id（从电源点出发，只经过处于合位的开关） */
     energized: string[];
@@ -69,5 +78,33 @@ export default class PowerDesigner extends FlowDesigner {
     topology(): PowerTopology;
     /** 语义校验（结构 + 电压等级 + 与五防相关的两条运行规则） */
     validatePower(): PowerIssue[];
+    /**
+     * 把设备挂到母线上（母线 T 接）。
+     *
+     * 落地形态（方案 A 的精化版，见 `ice-render/docs/architecture/16-link-port-evaluation.md`）：
+     * **不把设备变成母线的子节点** —— 复合组件的 `hasDerivedChildren() === true` 会让序列化器
+     * 跳过全部子节点，嵌套会让挂上去的设备在快照里直接丢失（实测 23 → 15）。
+     * 改成三件事：
+     *
+     * 1. 设备 state 里记 `attachedBusId`（普通字段，随快照往返）；
+     * 2. 位置按「顶部引线贴住母线中心线下方 POWER_BUS_ATTACH_GAP 处」摆放；
+     * 3. 拖动母线时由应用层把挂上去的设备一起平移（`__followBusMove`），
+     *    设备之间的导体本来就会跟随宿主（引擎能力），所以整条间隔会跟着走。
+     *
+     * 电气语义：拓扑把「attachedBusId 指向的母线 **且** 几何仍然贴合」当成一条隐式连接，
+     * 所以把设备拖开就自动断开，不需要额外的「断开」操作。
+     */
+    attachToBus(deviceOrId: any, busOrId: any, options?: {
+        centerX?: number;
+    }): any;
+    /** 设备挂在哪条母线上（按 `attachedBusId` 解析；不要求几何仍然贴合） */
+    attachedBusOf(device: any): any;
+    /** 设备是否**真的**还挂在母线上（记录 + 几何贴合 + 横向仍落在母线段内；拖离后为 false） */
+    isAttachedToBus(device: any): boolean;
+    /** 解除母线 T 接（设备留在原地，只是不再等电位） */
+    detachFromBus(deviceOrId: any): any;
+    /** 母线移动时，把挂在它上面的设备一起平移（应用层补上「容器」那部分行为） */
+    private __watchBusMove;
+    private __buildAdjacency;
     private __symbolById;
 }

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

@@ -13,6 +13,15 @@ export declare type PowerIssue = {
     message: string;
     id?: string;
 };
+/**
+ * 母线接间隔的几何约定：设备**顶部引线**贴在母线中心线下方这么多像素。
+ *
+ * 方案 A（零引擎改动）：母线当容器，挂在它上面的间隔用「几何贴合 + 父容器」表达等电位，
+ * 不再需要从母线中心拉一条绕行导体。评估见 `ice-render/docs/architecture/16-link-port-evaluation.md`。
+ */
+export declare const POWER_BUS_ATTACH_GAP = 3;
+/** 判定「仍然挂在母线上」的纵向容差（拖离出这个范围就算断开，走校验提示） */
+export declare const POWER_BUS_ATTACH_TOLERANCE = 8;
 export declare type PowerTopology = {
     /** 带电的设备 id（从电源点出发，只经过处于合位的开关） */
     energized: string[];
@@ -69,5 +78,33 @@ export default class PowerDesigner extends FlowDesigner {
     topology(): PowerTopology;
     /** 语义校验（结构 + 电压等级 + 与五防相关的两条运行规则） */
     validatePower(): PowerIssue[];
+    /**
+     * 把设备挂到母线上（母线 T 接）。
+     *
+     * 落地形态（方案 A 的精化版，见 `ice-render/docs/architecture/16-link-port-evaluation.md`）：
+     * **不把设备变成母线的子节点** —— 复合组件的 `hasDerivedChildren() === true` 会让序列化器
+     * 跳过全部子节点，嵌套会让挂上去的设备在快照里直接丢失（实测 23 → 15）。
+     * 改成三件事：
+     *
+     * 1. 设备 state 里记 `attachedBusId`（普通字段，随快照往返）；
+     * 2. 位置按「顶部引线贴住母线中心线下方 POWER_BUS_ATTACH_GAP 处」摆放；
+     * 3. 拖动母线时由应用层把挂上去的设备一起平移（`__followBusMove`），
+     *    设备之间的导体本来就会跟随宿主（引擎能力），所以整条间隔会跟着走。
+     *
+     * 电气语义：拓扑把「attachedBusId 指向的母线 **且** 几何仍然贴合」当成一条隐式连接，
+     * 所以把设备拖开就自动断开，不需要额外的「断开」操作。
+     */
+    attachToBus(deviceOrId: any, busOrId: any, options?: {
+        centerX?: number;
+    }): any;
+    /** 设备挂在哪条母线上（按 `attachedBusId` 解析；不要求几何仍然贴合） */
+    attachedBusOf(device: any): any;
+    /** 设备是否**真的**还挂在母线上（记录 + 几何贴合 + 横向仍落在母线段内；拖离后为 false） */
+    isAttachedToBus(device: any): boolean;
+    /** 解除母线 T 接（设备留在原地，只是不再等电位） */
+    detachFromBus(deviceOrId: any): any;
+    /** 母线移动时，把挂在它上面的设备一起平移（应用层补上「容器」那部分行为） */
+    private __watchBusMove;
+    private __buildAdjacency;
     private __symbolById;
 }

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

@@ -20,7 +20,7 @@
  * 尺寸也按同一套基准走（见 `POWER_STYLE` 与各 preset 的 width/height）。
  */
 import { ICEGroup } from '../ice-render/index.mjs';
-export declare const POWER_SYMBOL_KINDS: readonly ["busbar", "breaker", "disconnector", "loadSwitch", "earthingSwitch", "earth", "currentTransformer", "voltageTransformer", "transformer", "fuse", "arrester", "reactor", "generator", "motor", "load"];
+export declare const POWER_SYMBOL_KINDS: readonly ["busbar", "breaker", "disconnector", "loadSwitch", "earthingSwitch", "earth", "currentTransformer", "voltageTransformer", "transformer", "fuse", "arrester", "reactor", "generator", "motor", "load", "capacitor", "arcSuppressionCoil", "threeWindingTransformer", "groundingTransformer", "groundingResistor", "cable", "cableTermination", "cubicle"];
 export declare type PowerSymbolKind = (typeof POWER_SYMBOL_KINDS)[number];
 declare type PowerSymbolPreset = {
     /** 中文名（属性面板 / 图例用） */
@@ -85,6 +85,13 @@ export default class PowerSymbol extends ICEGroup {
     /** 接地符号：三条递减横线 */
     private __earth;
     private __add;
+    /**
+     * 只清「派生部件」，**不能**清 `childNodes` 全集。
+     *
+     * 母线同时扮演容器（间隔作为真实子节点挂在它上面），如果这里把 childNodes 全删掉，
+     * 每次重建记法都会连挂在母线上的间隔一起删掉（`removeChild` 内部会 `destory()`）。
+     * 派生部件在 `parts` 里有登记，按登记删即可。
+     */
     private __clearParts;
 }
 export {};

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

@@ -20,7 +20,7 @@
  * 尺寸也按同一套基准走（见 `POWER_STYLE` 与各 preset 的 width/height）。
  */
 import { ICEGroup } from '../ice-render/index';
-export declare const POWER_SYMBOL_KINDS: readonly ["busbar", "breaker", "disconnector", "loadSwitch", "earthingSwitch", "earth", "currentTransformer", "voltageTransformer", "transformer", "fuse", "arrester", "reactor", "generator", "motor", "load"];
+export declare const POWER_SYMBOL_KINDS: readonly ["busbar", "breaker", "disconnector", "loadSwitch", "earthingSwitch", "earth", "currentTransformer", "voltageTransformer", "transformer", "fuse", "arrester", "reactor", "generator", "motor", "load", "capacitor", "arcSuppressionCoil", "threeWindingTransformer", "groundingTransformer", "groundingResistor", "cable", "cableTermination", "cubicle"];
 export declare type PowerSymbolKind = (typeof POWER_SYMBOL_KINDS)[number];
 declare type PowerSymbolPreset = {
     /** 中文名（属性面板 / 图例用） */
@@ -85,6 +85,13 @@ export default class PowerSymbol extends ICEGroup {
     /** 接地符号：三条递减横线 */
     private __earth;
     private __add;
+    /**
+     * 只清「派生部件」，**不能**清 `childNodes` 全集。
+     *
+     * 母线同时扮演容器（间隔作为真实子节点挂在它上面），如果这里把 childNodes 全删掉，
+     * 每次重建记法都会连挂在母线上的间隔一起删掉（`removeChild` 内部会 `destory()`）。
+     * 派生部件在 `parts` 里有登记，按登记删即可。
+     */
     private __clearParts;
 }
 export {};

package/package.json

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