ice-entity-designer 0.0.30 → 0.0.32

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';
 /**
  * 流程图文档。
  *
@@ -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';
 /**
  * 流程图文档。
  *
@@ -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/gantt/gantt_text.d.mts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ *
+ */
+export declare type GanttTextImportResult = {
+    tasks: number;
+    dependencies: number;
+    /** 解析不了 / 不支持的输入行（不阻断整体导入） */
+    warnings: string[];
+};
+/**
+ * 导出为 Mermaid gantt 文本。
+ *
+ * 只输出**排期语义**（负责人分组、日期、天数、进度、依赖），不输出像素/画布坐标 ——
+ * 要保坐标的场景用引擎快照（`designer.serialize()`）或 SVG 导出。
+ */
+export declare function toMermaidGantt(designer: any, options?: {
+    title?: string;
+}): string;
+/**
+ * 从 Mermaid gantt 文本导入（容错：不认识的行进 `warnings`，不阻断整体导入）。
+ *
+ * 会先清空目标 designer 的当前模型（与 BPMN XML / UML 文本导入同一语义）。
+ * `after X` 按引擎的依赖语义（前置结束 → 本任务开始）反推出起始日期，并建立依赖线。
+ */
+export declare function fromMermaidGantt(text: string, designer: any, options?: {
+    defaultStart?: string;
+}): GanttTextImportResult;

package/dist/types/gantt/gantt_text.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ *
+ */
+export declare type GanttTextImportResult = {
+    tasks: number;
+    dependencies: number;
+    /** 解析不了 / 不支持的输入行（不阻断整体导入） */
+    warnings: string[];
+};
+/**
+ * 导出为 Mermaid gantt 文本。
+ *
+ * 只输出**排期语义**（负责人分组、日期、天数、进度、依赖），不输出像素/画布坐标 ——
+ * 要保坐标的场景用引擎快照（`designer.serialize()`）或 SVG 导出。
+ */
+export declare function toMermaidGantt(designer: any, options?: {
+    title?: string;
+}): string;
+/**
+ * 从 Mermaid gantt 文本导入（容错：不认识的行进 `warnings`，不阻断整体导入）。
+ *
+ * 会先清空目标 designer 的当前模型（与 BPMN XML / UML 文本导入同一语义）。
+ * `after X` 按引擎的依赖语义（前置结束 → 本任务开始）反推出起始日期，并建立依赖线。
+ */
+export declare function fromMermaidGantt(text: string, designer: any, options?: {
+    defaultStart?: string;
+}): GanttTextImportResult;

package/dist/types/index.d.mts

@@ -37,6 +37,8 @@ export { default as StateNode, STATECHART_NODE_KINDS } from './statechart/StateN
 export type { StatechartNodeKind } from './statechart/StateNode.mjs';
 export { default as StateTransition } from './statechart/StateTransition.mjs';
 export { default as StatechartDesigner } from './statechart/StatechartDesigner.mjs';
+export { toPlantUmlState, fromPlantUmlState, splitTransitionLabel } from './statechart/statechart_text.mjs';
+export type { StatechartTextImportResult } from './statechart/statechart_text.mjs';
 export type { StatechartIssue } from './statechart/StatechartDesigner.mjs';
 export { default as GanttTask } from './gantt/GanttTask.mjs';
 export { default as GanttDependency } from './gantt/GanttDependency.mjs';
@@ -44,6 +46,13 @@ export { default as GanttRuler } from './gantt/GanttRuler.mjs';
 export type { GanttRulerOptions } from './gantt/GanttRuler.mjs';
 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

@@ -37,6 +37,8 @@ export { default as StateNode, STATECHART_NODE_KINDS } from './statechart/StateN
 export type { StatechartNodeKind } from './statechart/StateNode';
 export { default as StateTransition } from './statechart/StateTransition';
 export { default as StatechartDesigner } from './statechart/StatechartDesigner';
+export { toPlantUmlState, fromPlantUmlState, splitTransitionLabel } from './statechart/statechart_text';
+export type { StatechartTextImportResult } from './statechart/statechart_text';
 export type { StatechartIssue } from './statechart/StatechartDesigner';
 export { default as GanttTask } from './gantt/GanttTask';
 export { default as GanttDependency } from './gantt/GanttDependency';
@@ -44,6 +46,13 @@ export { default as GanttRuler } from './gantt/GanttRuler';
 export type { GanttRulerOptions } from './gantt/GanttRuler';
 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,73 @@
+/**
+ * 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;
+};
+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[];
+    private __symbolById;
+}

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

@@ -0,0 +1,73 @@
+/**
+ * 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;
+};
+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[];
+    private __symbolById;
+}

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

@@ -0,0 +1,90 @@
+/**
+ * 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;
+    private __clearParts;
+}
+export {};

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

@@ -0,0 +1,90 @@
+/**
+ * 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;
+    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/dist/types/statechart/statechart_text.d.mts

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ *
+ */
+export declare type StatechartTextImportResult = {
+    states: number;
+    transitions: number;
+    /** 解析不了 / 不支持的输入行（不阻断整体导入） */
+    warnings: string[];
+};
+/**
+ * `事件 [守卫] / 动作` → 三段（`StateTransition.composeLabel` 的逆运算）。
+ *
+ * 规则与拼装严格对称：只按**第一个** ` / ` 切分（动作里再出现 ` / ` 也属于动作），
+ * 守卫取事件末尾那对方括号；缺哪段就是空串，不会凭空造出括号或斜杠。
+ */
+export declare function splitTransitionLabel(label: string): {
+    event: string;
+    guard: string;
+    action: string;
+};
+/**
+ * 导出为 PlantUML 状态图文本。
+ *
+ * 只输出**记法本身**（状态、嵌套、转移），不输出坐标 —— PlantUML 自己会排版；
+ * 要保坐标的场景用引擎快照（`designer.serialize()`）或 SVG 导出。
+ */
+export declare function toPlantUmlState(designer: any, options?: {
+    title?: string;
+}): string;
+/**
+ * 从 PlantUML 状态图文本导入（容错：不认识的行进 `warnings`，不阻断整体导入）。
+ *
+ * 会先清空目标 designer 的当前模型（与 BPMN XML / UML 文本导入同一语义）。
+ * 文本里没有坐标：导入后按「根级分层、子状态装在复合状态盒子里」给一套可读的初始布局，
+ * 用户随后可以自己排版（或交给自动布局）。
+ */
+export declare function fromPlantUmlState(text: string, designer: any): StatechartTextImportResult;

package/dist/types/statechart/statechart_text.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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.
+ *
+ */
+export declare type StatechartTextImportResult = {
+    states: number;
+    transitions: number;
+    /** 解析不了 / 不支持的输入行（不阻断整体导入） */
+    warnings: string[];
+};
+/**
+ * `事件 [守卫] / 动作` → 三段（`StateTransition.composeLabel` 的逆运算）。
+ *
+ * 规则与拼装严格对称：只按**第一个** ` / ` 切分（动作里再出现 ` / ` 也属于动作），
+ * 守卫取事件末尾那对方括号；缺哪段就是空串，不会凭空造出括号或斜杠。
+ */
+export declare function splitTransitionLabel(label: string): {
+    event: string;
+    guard: string;
+    action: string;
+};
+/**
+ * 导出为 PlantUML 状态图文本。
+ *
+ * 只输出**记法本身**（状态、嵌套、转移），不输出坐标 —— PlantUML 自己会排版；
+ * 要保坐标的场景用引擎快照（`designer.serialize()`）或 SVG 导出。
+ */
+export declare function toPlantUmlState(designer: any, options?: {
+    title?: string;
+}): string;
+/**
+ * 从 PlantUML 状态图文本导入（容错：不认识的行进 `warnings`，不阻断整体导入）。
+ *
+ * 会先清空目标 designer 的当前模型（与 BPMN XML / UML 文本导入同一语义）。
+ * 文本里没有坐标：导入后按「根级分层、子状态装在复合状态盒子里」给一套可读的初始布局，
+ * 用户随后可以自己排版（或交给自动布局）。
+ */
+export declare function fromPlantUmlState(text: string, designer: any): StatechartTextImportResult;