ice-entity-designer 0.0.31 → 0.0.33

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

@@ -1,5 +1,6 @@
 import type { ICE, SvgExportOptions } from '../ice-render/index.mjs';
 import type { FlowNodeKind } from './FlowNode.mjs';
+import type { FlowPort } from './FlowEdge.mjs';
 /**
  * 流程图文档。
  *
@@ -84,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;
@@ -96,7 +97,8 @@ export default class FlowDesigner {
     };
     createNode(kind: FlowNodeKind, props?: any): any;
     /** 由节点的插槽位置算出连线端点（引擎按插槽吸附，端点需要给出初始坐标） */
-    private __slotPoint;
+    /** 取插槽点：`protected` 供域包（如电力一次图）建自己的连线类型时复用 */
+    protected __slotPoint(component: any, position: FlowPort): number[];
     createEdge(props?: any): any;
     updateNode(id: string, patch: Record<string, any>): any;
     updateEdge(id: string, patch: Record<string, any>): any;

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

@@ -1,5 +1,6 @@
 import type { ICE, SvgExportOptions } from '../ice-render/index';
 import type { FlowNodeKind } from './FlowNode';
+import type { FlowPort } from './FlowEdge';
 /**
  * 流程图文档。
  *
@@ -84,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;
@@ -96,7 +97,8 @@ export default class FlowDesigner {
     };
     createNode(kind: FlowNodeKind, props?: any): any;
     /** 由节点的插槽位置算出连线端点（引擎按插槽吸附，端点需要给出初始坐标） */
-    private __slotPoint;
+    /** 取插槽点：`protected` 供域包（如电力一次图）建自己的连线类型时复用 */
+    protected __slotPoint(component: any, position: FlowPort): number[];
     createEdge(props?: any): any;
     updateNode(id: string, patch: Record<string, any>): any;
     updateEdge(id: string, patch: Record<string, any>): any;

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

@@ -15,7 +15,8 @@ export declare type FlowPort = 'T' | 'R' | 'B' | 'L' | 'C';
  * 两端节点的插槽上 —— 节点被拖动时连线自动跟随重新布线。
  */
 export default class FlowEdge extends ICEVisioLink {
-    static readonly typeId = "FlowEdge";
+    /** 稳定类型标识。声明为 `string`（而不是字面量类型）：域包可以派生自己的导体类型（如 PowerLine） */
+    static readonly typeId: string;
     /** 连线没有子组件；声明派生可保证将来即使加了内部装饰也不会被重复序列化 */
     hasDerivedChildren(): boolean;
     constructor(props?: any);

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

@@ -15,7 +15,8 @@ export declare type FlowPort = 'T' | 'R' | 'B' | 'L' | 'C';
  * 两端节点的插槽上 —— 节点被拖动时连线自动跟随重新布线。
  */
 export default class FlowEdge extends ICEVisioLink {
-    static readonly typeId = "FlowEdge";
+    /** 稳定类型标识。声明为 `string`（而不是字面量类型）：域包可以派生自己的导体类型（如 PowerLine） */
+    static readonly typeId: string;
     /** 连线没有子组件；声明派生可保证将来即使加了内部装饰也不会被重复序列化 */
     hasDerivedChildren(): boolean;
     constructor(props?: any);

package/dist/types/index.d.mts

@@ -48,6 +48,11 @@ export { default as GanttDesigner } from './gantt/GanttDesigner.mjs';
 export type { GanttIssue, GanttTaskInput } from './gantt/GanttDesigner.mjs';
 export { toMermaidGantt, fromMermaidGantt } from './gantt/gantt_text.mjs';
 export type { GanttTextImportResult } from './gantt/gantt_text.mjs';
+export { default as PowerSymbol, POWER_SYMBOL_KINDS, POWER_SYMBOL_PRESETS, POWER_STYLE } from './power/power_shapes.mjs';
+export type { PowerSymbolKind } from './power/power_shapes.mjs';
+export { default as PowerDesigner, PowerLine } from './power/PowerDesigner.mjs';
+export type { PowerIssue, PowerTopology } from './power/PowerDesigner.mjs';
+export { POWER_VOLTAGE_LEVELS, voltageColorOf, defaultVoltageColors } from './power/power_voltage.mjs';
 export { parseDate, formatDate, addDays, diffDays, eachDay, tickLabel } from './gantt/gantt_date.mjs';
 export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text.mjs';
 export type { UmlTextImportResult } from './uml/uml_text.mjs';

package/dist/types/index.d.ts

@@ -48,6 +48,11 @@ export { default as GanttDesigner } from './gantt/GanttDesigner';
 export type { GanttIssue, GanttTaskInput } from './gantt/GanttDesigner';
 export { toMermaidGantt, fromMermaidGantt } from './gantt/gantt_text';
 export type { GanttTextImportResult } from './gantt/gantt_text';
+export { default as PowerSymbol, POWER_SYMBOL_KINDS, POWER_SYMBOL_PRESETS, POWER_STYLE } from './power/power_shapes';
+export type { PowerSymbolKind } from './power/power_shapes';
+export { default as PowerDesigner, PowerLine } from './power/PowerDesigner';
+export type { PowerIssue, PowerTopology } from './power/PowerDesigner';
+export { POWER_VOLTAGE_LEVELS, voltageColorOf, defaultVoltageColors } from './power/power_voltage';
 export { parseDate, formatDate, addDays, diffDays, eachDay, tickLabel } from './gantt/gantt_date';
 export { toPlantUml, fromPlantUml, arrowOf, detectUmlDialect } from './uml/uml_text';
 export type { UmlTextImportResult } from './uml/uml_text';

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

@@ -0,0 +1,110 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import FlowDesigner from '../flow/FlowDesigner.mjs';
+import FlowEdge from '../flow/FlowEdge.mjs';
+import type { PowerSymbolKind, PowerSwitchState } from './power_shapes.mjs';
+export declare type PowerIssue = {
+    level: 'error' | 'warning';
+    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[];
+    /**
+     * 电气连通域（**忽略开关分合**：按「开关全合」算），用于结构检查
+     * （比如「这条母线所在连通域里有没有电源」）。
+     */
+    islands: string[][];
+};
+/** 一次系统图的导线（导体）—— 复用引擎折线，颜色跟电压等级走 */
+export declare class PowerLine extends FlowEdge {
+    static readonly typeId = "PowerLine";
+    constructor(props?: any);
+    /** 电压等级 → 线色（不标等级时用中性色） */
+    applyVoltageColor(table?: Record<string, string>): void;
+}
+/**
+ * @class PowerDesigner 电力一次系统图（单线图）设计器
+ *
+ * 域包的应用层，只做四件事，其余（选择 / 增删改 / 连线 / 撤销重做 / 快照 / 适应视图 / 订阅）
+ * 全部继承 `FlowDesigner`：
+ *
+ * 1. 建电力图元（`PowerSymbol`）与导体（`PowerLine`）；
+ * 2. **运行态**：开关分合、带电状态写回（供色标与状态标签用）；
+ * 3. **拓扑**：导电岛 / 带电范围（从电源点出发，只经过合位开关）；
+ * 4. **语义校验**：设备名唯一、电压等级一致（变压器两侧例外）、母线要有进线、
+ *    断路器两侧应有隔离开关，以及两条与「五防」直接相关的规则
+ *    （**带电合接地刀闸**、**带接地线合闸送电**）。
+ */
+export default class PowerDesigner extends FlowDesigner {
+    /** 色标表（可被公司规范覆盖） */
+    voltageColors: Record<string, string>;
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /** 覆盖电压等级色标（各电网公司规范不同） */
+    setVoltageColors(table: Record<string, string>): void;
+    /** 建一个电力设备（母线/断路器/隔离开关/互感器/变压器…） */
+    createSymbol(kind: PowerSymbolKind, props?: any): any;
+    /** 建一段导体（一次图里的导线） */
+    createLine(props?: any): any;
+    /** 开关分 / 合（运行态操作） */
+    setSwitchState(id: string, switchState: PowerSwitchState): any;
+    /** 标记 / 取消电源点（发电机、进线、主变电源侧…） */
+    setEnergizedSource(id: string, enabled: boolean): any;
+    /**
+     * 算拓扑并把带电状态写回节点（`energized`）—— 色标与状态标签据此着色。
+     *
+     * 规则：从电源点出发做 BFS；**只有合位的开关**才允许电流继续往外走
+     * （开关自身在分位时仍然算带电，因为它的一端接着电源）。
+     */
+    applyTopology(): PowerTopology;
+    /** 拓扑分析（不改模型，只算） */
+    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

@@ -0,0 +1,110 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import FlowDesigner from '../flow/FlowDesigner';
+import FlowEdge from '../flow/FlowEdge';
+import type { PowerSymbolKind, PowerSwitchState } from './power_shapes';
+export declare type PowerIssue = {
+    level: 'error' | 'warning';
+    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[];
+    /**
+     * 电气连通域（**忽略开关分合**：按「开关全合」算），用于结构检查
+     * （比如「这条母线所在连通域里有没有电源」）。
+     */
+    islands: string[][];
+};
+/** 一次系统图的导线（导体）—— 复用引擎折线，颜色跟电压等级走 */
+export declare class PowerLine extends FlowEdge {
+    static readonly typeId = "PowerLine";
+    constructor(props?: any);
+    /** 电压等级 → 线色（不标等级时用中性色） */
+    applyVoltageColor(table?: Record<string, string>): void;
+}
+/**
+ * @class PowerDesigner 电力一次系统图（单线图）设计器
+ *
+ * 域包的应用层，只做四件事，其余（选择 / 增删改 / 连线 / 撤销重做 / 快照 / 适应视图 / 订阅）
+ * 全部继承 `FlowDesigner`：
+ *
+ * 1. 建电力图元（`PowerSymbol`）与导体（`PowerLine`）；
+ * 2. **运行态**：开关分合、带电状态写回（供色标与状态标签用）；
+ * 3. **拓扑**：导电岛 / 带电范围（从电源点出发，只经过合位开关）；
+ * 4. **语义校验**：设备名唯一、电压等级一致（变压器两侧例外）、母线要有进线、
+ *    断路器两侧应有隔离开关，以及两条与「五防」直接相关的规则
+ *    （**带电合接地刀闸**、**带接地线合闸送电**）。
+ */
+export default class PowerDesigner extends FlowDesigner {
+    /** 色标表（可被公司规范覆盖） */
+    voltageColors: Record<string, string>;
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /** 覆盖电压等级色标（各电网公司规范不同） */
+    setVoltageColors(table: Record<string, string>): void;
+    /** 建一个电力设备（母线/断路器/隔离开关/互感器/变压器…） */
+    createSymbol(kind: PowerSymbolKind, props?: any): any;
+    /** 建一段导体（一次图里的导线） */
+    createLine(props?: any): any;
+    /** 开关分 / 合（运行态操作） */
+    setSwitchState(id: string, switchState: PowerSwitchState): any;
+    /** 标记 / 取消电源点（发电机、进线、主变电源侧…） */
+    setEnergizedSource(id: string, enabled: boolean): any;
+    /**
+     * 算拓扑并把带电状态写回节点（`energized`）—— 色标与状态标签据此着色。
+     *
+     * 规则：从电源点出发做 BFS；**只有合位的开关**才允许电流继续往外走
+     * （开关自身在分位时仍然算带电，因为它的一端接着电源）。
+     */
+    applyTopology(): PowerTopology;
+    /** 拓扑分析（不改模型，只算） */
+    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

@@ -0,0 +1,97 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * 电力一次系统图（单线图）符号库。
+ *
+ * **记法来源**（不凭印象画，逐个符号对着标准图例核过）：
+ * - JB/T 5872-1991《高压开关设备电气图形及文字符号》—— 3kV 及以上高压开关设备的图形符号与文字符号，
+ *   本文件里的 QF / QS / QL / QE / TA / TV / TM / FU / F / L / E 等记法都出自它；
+ * - GB/T 4728 系列《电气简图用图形符号》（等同采用 IEC 60617）—— 通用图形符号体系，第 7 部分为
+ *   开关、控制和保护器件；其中一条通用规则是：**开关电器的可动部分按「无激励、无外力」的正常状态绘制**。
+ * - 调度编号（设备命名，《电力系统部分设备统一编号准则》SD 240-87、母线 #1M 之类）是**另一层**，
+ *   属于设备命名而不是图形记法，本包用 `tag`（图形符号旁的文字符号）与之并存。
+ *
+ * **外观统一**：所有符号共用同一套描边色 / 线宽 / 文字符号字号与位置、统一端子在上下（T/B），
+ * 尺寸也按同一套基准走（见 `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 type PowerSymbolKind = (typeof POWER_SYMBOL_KINDS)[number];
+declare type PowerSymbolPreset = {
+    /** 中文名（属性面板 / 图例用） */
+    label: string;
+    /** 图形符号旁的文字符号（JB/T 5872 / GB/T 7159 口径） */
+    tag: string;
+    width: number;
+    height: number;
+    /** 是否串联在导线上（母线/接地这类不串联的例外） */
+    inline: boolean;
+};
+/** 文字符号取自 JB/T 5872-1991 的「图形符号 + 文字符号」对照表 */
+export declare const POWER_SYMBOL_PRESETS: Record<PowerSymbolKind, PowerSymbolPreset>;
+/** 全局外观基准：所有符号共用，保证「一张图上不花」 */
+export declare const POWER_STYLE: {
+    /** 符号描边色（近黑的石板色，不用纯黑，缩放/打印都不刺眼） */
+    strokeStyle: string;
+    /** 引线（导线）与符号本体同一线宽 */
+    lineWidth: number;
+    /** 接地/母线这类「加粗」元素用更粗的线 */
+    heavyLineWidth: number;
+    /** 文字符号（QF/QS…）的字号与颜色 */
+    tagFontSize: number;
+    tagColor: string;
+    /** 圆内字母（G / M）的字号 */
+    letterFontSize: number;
+    /** 明确不带电时的颜色（只有算过拓扑 `energized: false` 才会用到） */
+    deEnergizedColor: string;
+    /** 设备名 / 编号标注的字号与颜色 */
+    nameFontSize: number;
+    nameColor: string;
+    /** 开关状态标签（合 / 分）的字号 */
+    stateFontSize: number;
+};
+/** 有分 / 合状态的开关电器（其余是静止设备） */
+export declare const POWER_SWITCH_KINDS: PowerSymbolKind[];
+export declare type PowerSwitchState = 'open' | 'closed';
+/**
+ * @class PowerSymbol 电力一次系统图的图元（复合组件）
+ *
+ * 与其它域包同一套做法：内部形状按 `kind` 派生（`hasDerivedChildren() === true`），不进文档、载入时重建。
+ * 每个派生部件都带一个稳定的 `role`（`blade` / `arcMark` / `earth` …），测试与属性面板按 role 认部件，
+ * **不用位置去猜**。
+ */
+export default class PowerSymbol extends ICEGroup {
+    static readonly typeId = "PowerSymbol";
+    /** 派生部件：`{ role, component }` 列表（按添加顺序） */
+    parts: Array<{
+        role: string;
+        component: any;
+    }>;
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props?: any): any;
+    private static readonly __shapeKeys;
+    setState(patch: any): void;
+    applyPatch(patch?: any): void;
+    /** 取某个角色的派生部件（测试/属性面板用） */
+    part(role: string): any;
+    /** 按 `kind` 重建内部形状与文字符号 */
+    protected syncShape(): void;
+    /** 接地符号：三条递减横线 */
+    private __earth;
+    private __add;
+    /**
+     * 只清「派生部件」，**不能**清 `childNodes` 全集。
+     *
+     * 母线同时扮演容器（间隔作为真实子节点挂在它上面），如果这里把 childNodes 全删掉，
+     * 每次重建记法都会连挂在母线上的间隔一起删掉（`removeChild` 内部会 `destory()`）。
+     * 派生部件在 `parts` 里有登记，按登记删即可。
+     */
+    private __clearParts;
+}
+export {};

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

@@ -0,0 +1,97 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * 电力一次系统图（单线图）符号库。
+ *
+ * **记法来源**（不凭印象画，逐个符号对着标准图例核过）：
+ * - JB/T 5872-1991《高压开关设备电气图形及文字符号》—— 3kV 及以上高压开关设备的图形符号与文字符号，
+ *   本文件里的 QF / QS / QL / QE / TA / TV / TM / FU / F / L / E 等记法都出自它；
+ * - GB/T 4728 系列《电气简图用图形符号》（等同采用 IEC 60617）—— 通用图形符号体系，第 7 部分为
+ *   开关、控制和保护器件；其中一条通用规则是：**开关电器的可动部分按「无激励、无外力」的正常状态绘制**。
+ * - 调度编号（设备命名，《电力系统部分设备统一编号准则》SD 240-87、母线 #1M 之类）是**另一层**，
+ *   属于设备命名而不是图形记法，本包用 `tag`（图形符号旁的文字符号）与之并存。
+ *
+ * **外观统一**：所有符号共用同一套描边色 / 线宽 / 文字符号字号与位置、统一端子在上下（T/B），
+ * 尺寸也按同一套基准走（见 `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 type PowerSymbolKind = (typeof POWER_SYMBOL_KINDS)[number];
+declare type PowerSymbolPreset = {
+    /** 中文名（属性面板 / 图例用） */
+    label: string;
+    /** 图形符号旁的文字符号（JB/T 5872 / GB/T 7159 口径） */
+    tag: string;
+    width: number;
+    height: number;
+    /** 是否串联在导线上（母线/接地这类不串联的例外） */
+    inline: boolean;
+};
+/** 文字符号取自 JB/T 5872-1991 的「图形符号 + 文字符号」对照表 */
+export declare const POWER_SYMBOL_PRESETS: Record<PowerSymbolKind, PowerSymbolPreset>;
+/** 全局外观基准：所有符号共用，保证「一张图上不花」 */
+export declare const POWER_STYLE: {
+    /** 符号描边色（近黑的石板色，不用纯黑，缩放/打印都不刺眼） */
+    strokeStyle: string;
+    /** 引线（导线）与符号本体同一线宽 */
+    lineWidth: number;
+    /** 接地/母线这类「加粗」元素用更粗的线 */
+    heavyLineWidth: number;
+    /** 文字符号（QF/QS…）的字号与颜色 */
+    tagFontSize: number;
+    tagColor: string;
+    /** 圆内字母（G / M）的字号 */
+    letterFontSize: number;
+    /** 明确不带电时的颜色（只有算过拓扑 `energized: false` 才会用到） */
+    deEnergizedColor: string;
+    /** 设备名 / 编号标注的字号与颜色 */
+    nameFontSize: number;
+    nameColor: string;
+    /** 开关状态标签（合 / 分）的字号 */
+    stateFontSize: number;
+};
+/** 有分 / 合状态的开关电器（其余是静止设备） */
+export declare const POWER_SWITCH_KINDS: PowerSymbolKind[];
+export declare type PowerSwitchState = 'open' | 'closed';
+/**
+ * @class PowerSymbol 电力一次系统图的图元（复合组件）
+ *
+ * 与其它域包同一套做法：内部形状按 `kind` 派生（`hasDerivedChildren() === true`），不进文档、载入时重建。
+ * 每个派生部件都带一个稳定的 `role`（`blade` / `arcMark` / `earth` …），测试与属性面板按 role 认部件，
+ * **不用位置去猜**。
+ */
+export default class PowerSymbol extends ICEGroup {
+    static readonly typeId = "PowerSymbol";
+    /** 派生部件：`{ role, component }` 列表（按添加顺序） */
+    parts: Array<{
+        role: string;
+        component: any;
+    }>;
+    hasDerivedChildren(): boolean;
+    constructor(props?: any);
+    protected static arrangeParam(props?: any): any;
+    private static readonly __shapeKeys;
+    setState(patch: any): void;
+    applyPatch(patch?: any): void;
+    /** 取某个角色的派生部件（测试/属性面板用） */
+    part(role: string): any;
+    /** 按 `kind` 重建内部形状与文字符号 */
+    protected syncShape(): void;
+    /** 接地符号：三条递减横线 */
+    private __earth;
+    private __add;
+    /**
+     * 只清「派生部件」，**不能**清 `childNodes` 全集。
+     *
+     * 母线同时扮演容器（间隔作为真实子节点挂在它上面），如果这里把 childNodes 全删掉，
+     * 每次重建记法都会连挂在母线上的间隔一起删掉（`removeChild` 内部会 `destory()`）。
+     * 派生部件在 `parts` 里有登记，按登记删即可。
+     */
+    private __clearParts;
+}
+export {};

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

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * 电压等级与色标。
+ *
+ * 电力行业习惯用颜色区分电压等级，但**各电网公司/各设计院的规范并不统一**，
+ * 所以这里给的是**可覆盖的默认值**（按公开资料里流传较广的一套命名：
+ * 500kV 淡黄、220kV 紫、110kV 朱红、35kV 鲜黄、10kV 绛红、6kV 深蓝），
+ * 颜色名对应的是行业称呼，hex 是近似值 —— 需要贴合某家公司规范时，
+ * 用 `PowerDesigner.setVoltageColors({ '110kV': '#xxxxxx' })` 覆盖即可。
+ */
+export declare type PowerVoltageLevel = {
+    /** 等级标识：'500kV' / '220kV' / '110kV' / '35kV' / '10kV' / '6kV' */
+    level: string;
+    /** 行业里的颜色称呼 */
+    colorName: string;
+    /** 近似的 hex 值（可被覆盖） */
+    color: string;
+    /** 标称电压（kV），用于排序与展示 */
+    kv: number;
+};
+export declare const POWER_VOLTAGE_LEVELS: PowerVoltageLevel[];
+/** 未标注电压等级时用的中性色（不参与色标语义） */
+export declare const POWER_NEUTRAL_COLOR = "#1f2937";
+/** 默认色标表（level → color） */
+export declare function defaultVoltageColors(): Record<string, string>;
+/** 按等级取颜色；没标等级或等级不认识时回落到中性色 */
+export declare function voltageColorOf(level: string, table?: Record<string, string>): string;

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

@@ -0,0 +1,33 @@
+/**
+ * Copyright (c) 2022 大漠穷秋.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+/**
+ * 电压等级与色标。
+ *
+ * 电力行业习惯用颜色区分电压等级，但**各电网公司/各设计院的规范并不统一**，
+ * 所以这里给的是**可覆盖的默认值**（按公开资料里流传较广的一套命名：
+ * 500kV 淡黄、220kV 紫、110kV 朱红、35kV 鲜黄、10kV 绛红、6kV 深蓝），
+ * 颜色名对应的是行业称呼，hex 是近似值 —— 需要贴合某家公司规范时，
+ * 用 `PowerDesigner.setVoltageColors({ '110kV': '#xxxxxx' })` 覆盖即可。
+ */
+export declare type PowerVoltageLevel = {
+    /** 等级标识：'500kV' / '220kV' / '110kV' / '35kV' / '10kV' / '6kV' */
+    level: string;
+    /** 行业里的颜色称呼 */
+    colorName: string;
+    /** 近似的 hex 值（可被覆盖） */
+    color: string;
+    /** 标称电压（kV），用于排序与展示 */
+    kv: number;
+};
+export declare const POWER_VOLTAGE_LEVELS: PowerVoltageLevel[];
+/** 未标注电压等级时用的中性色（不参与色标语义） */
+export declare const POWER_NEUTRAL_COLOR = "#1f2937";
+/** 默认色标表（level → color） */
+export declare function defaultVoltageColors(): Record<string, string>;
+/** 按等级取颜色；没标等级或等级不认识时回落到中性色 */
+export declare function voltageColorOf(level: string, table?: Record<string, string>): string;

package/package.json

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