ice-entity-designer 0.0.37 → 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/index.d.mts

@@ -53,6 +53,10 @@ 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 { default as SecondaryDesigner, SecondaryWire } from './secondary/SecondaryDesigner.mjs';
+export type { SecondaryIssue } from './secondary/SecondaryDesigner.mjs';
+export { default as SecondarySymbol, TerminalStrip, SECONDARY_SYMBOL_KINDS, SECONDARY_SYMBOL_PRESETS, SECONDARY_STYLE, } from './secondary/secondary_shapes.mjs';
+export type { SecondarySymbolKind } from './secondary/secondary_shapes.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

@@ -53,6 +53,10 @@ 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 { default as SecondaryDesigner, SecondaryWire } from './secondary/SecondaryDesigner';
+export type { SecondaryIssue } from './secondary/SecondaryDesigner';
+export { default as SecondarySymbol, TerminalStrip, SECONDARY_SYMBOL_KINDS, SECONDARY_SYMBOL_PRESETS, SECONDARY_STYLE, } from './secondary/secondary_shapes';
+export type { SecondarySymbolKind } from './secondary/secondary_shapes';
 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/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/SecondaryDesigner.d.mts

@@ -0,0 +1,64 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 二次回路（保护 / 电流电压回路 / 端子排）应用层 —— 简化版第一刀。
+ *
+ * 与一次侧的差别不在实现，而在**图种**：二次图是回路图（一条线 = 一个具体回路），
+ * 所以导线带**回路编号**（A411/B411/C411/N411）、端子带**端子号**（201…）、
+ * 电缆带**电缆编号**（1D1…）。这些在本包里都是数据字段 + 标注，判型仍走 typeId。
+ *
+ * 记法与范围见 `docs/power-secondary-spec.md`。
+ */
+import FlowDesigner from '../flow/FlowDesigner.mjs';
+import FlowEdge from '../flow/FlowEdge.mjs';
+import type { SecondarySymbolKind } from './secondary_shapes.mjs';
+export declare type SecondaryIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/** 二次回路的导线：复用引擎折线（插槽吸附 / 正交路由 / 标签），额外带回路编号与电缆编号 */
+export declare class SecondaryWire extends FlowEdge {
+    static readonly typeId = "SecondaryWire";
+    constructor(props?: any);
+}
+/**
+ * @class SecondaryDesigner 二次回路设计器
+ *
+ * 薄薄一层：建二次元件 / 端子排 / 带回路编号的导线，其余（选择、增删改、撤销重做、快照、
+ * 适应视图、订阅）全部继承 `FlowDesigner`。
+ */
+export default class SecondaryDesigner extends FlowDesigner {
+    constructor(ice: any);
+    get nodes(): any[];
+    /** 只看元件（含端子排里的端子），不含端子排容器本身 */
+    get symbols(): any[];
+    get terminals(): any[];
+    get edges(): any[];
+    /** 建一个二次元件（接点 / 按钮 / 切换开关 / 压板 / 信号灯 / 装置 / 绕组 / 端子 / 接地） */
+    createSymbol(kind: SecondarySymbolKind, props?: any): any;
+    /** 建一条二次导线：`circuitNo` 是回路编号（写在线上），`cableNo` 是电缆编号（数据字段） */
+    createWire(props?: any): any;
+    /**
+     * 建一个端子排（容器）：端子是它的**真实子节点**，拖动端子排端子跟着走，端子各自还能接线。
+     *
+     * 注意：端子排刻意**不声明** `hasDerivedChildren()` —— 复合组件声明后序列化会跳过全部子节点，
+     * 端子会在快照往返时整套丢掉（BPMN 池/泳道目前就踩了这个坑）。
+     */
+    createTerminalStrip(props?: any): any;
+    /**
+     * 二次回路语义校验（简化版四条）：
+     * 1. 每条导线必须有回路编号；
+     * 2. 电流回路三相编号成组（同一数字段上 A/B/C 都要有）；
+     * 3. 端子号在同一张图上唯一；
+     * 4. 二次回路必须有接地（warning）。
+     */
+    validateSecondary(): SecondaryIssue[];
+    /** 元件的文字符号预设（属性面板 / 文档用） */
+    presetOf(kind: SecondarySymbolKind): any;
+}

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

@@ -0,0 +1,64 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 二次回路（保护 / 电流电压回路 / 端子排）应用层 —— 简化版第一刀。
+ *
+ * 与一次侧的差别不在实现，而在**图种**：二次图是回路图（一条线 = 一个具体回路），
+ * 所以导线带**回路编号**（A411/B411/C411/N411）、端子带**端子号**（201…）、
+ * 电缆带**电缆编号**（1D1…）。这些在本包里都是数据字段 + 标注，判型仍走 typeId。
+ *
+ * 记法与范围见 `docs/power-secondary-spec.md`。
+ */
+import FlowDesigner from '../flow/FlowDesigner';
+import FlowEdge from '../flow/FlowEdge';
+import type { SecondarySymbolKind } from './secondary_shapes';
+export declare type SecondaryIssue = {
+    level: 'error' | 'warning';
+    message: string;
+    id?: string;
+};
+/** 二次回路的导线：复用引擎折线（插槽吸附 / 正交路由 / 标签），额外带回路编号与电缆编号 */
+export declare class SecondaryWire extends FlowEdge {
+    static readonly typeId = "SecondaryWire";
+    constructor(props?: any);
+}
+/**
+ * @class SecondaryDesigner 二次回路设计器
+ *
+ * 薄薄一层：建二次元件 / 端子排 / 带回路编号的导线，其余（选择、增删改、撤销重做、快照、
+ * 适应视图、订阅）全部继承 `FlowDesigner`。
+ */
+export default class SecondaryDesigner extends FlowDesigner {
+    constructor(ice: any);
+    get nodes(): any[];
+    /** 只看元件（含端子排里的端子），不含端子排容器本身 */
+    get symbols(): any[];
+    get terminals(): any[];
+    get edges(): any[];
+    /** 建一个二次元件（接点 / 按钮 / 切换开关 / 压板 / 信号灯 / 装置 / 绕组 / 端子 / 接地） */
+    createSymbol(kind: SecondarySymbolKind, props?: any): any;
+    /** 建一条二次导线：`circuitNo` 是回路编号（写在线上），`cableNo` 是电缆编号（数据字段） */
+    createWire(props?: any): any;
+    /**
+     * 建一个端子排（容器）：端子是它的**真实子节点**，拖动端子排端子跟着走，端子各自还能接线。
+     *
+     * 注意：端子排刻意**不声明** `hasDerivedChildren()` —— 复合组件声明后序列化会跳过全部子节点，
+     * 端子会在快照往返时整套丢掉（BPMN 池/泳道目前就踩了这个坑）。
+     */
+    createTerminalStrip(props?: any): any;
+    /**
+     * 二次回路语义校验（简化版四条）：
+     * 1. 每条导线必须有回路编号；
+     * 2. 电流回路三相编号成组（同一数字段上 A/B/C 都要有）；
+     * 3. 端子号在同一张图上唯一；
+     * 4. 二次回路必须有接地（warning）。
+     */
+    validateSecondary(): SecondaryIssue[];
+    /** 元件的文字符号预设（属性面板 / 文档用） */
+    presetOf(kind: SecondarySymbolKind): any;
+}

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

@@ -0,0 +1,75 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 电力**二次回路**元件库（简化版第一刀：保护电流回路 + 端子排）。
+ *
+ * 记法依据见 `docs/power-secondary-spec.md`：
+ * - 元件的通用图形符号按 GB/T 4728.7（等同 IEC 60617-7，开关 / 控制 / 保护器件）；
+ * - 文字符号用二次侧主流的 **IEEE C37.2 功能编号**（52 断路器、43 切换开关、88 辅助继电器、
+ *   49 过流继电器、33 位置开关、63 压力…），与一次侧的 QF/QS 体系分开；
+ * - 回路编号（A411/B411/C411/N411）、端子号（201…）、电缆编号（1D1…）是数据字段，画成标注。
+ */
+import { ICEGroup } from '../ice-render/index.mjs';
+export declare const SECONDARY_SYMBOL_KINDS: readonly ["contactNO", "contactNC", "pushButton", "switchRemoteLocal", "linkPlate", "indicatorLamp", "relayDevice", "ctWinding", "terminal", "earth"];
+export declare type SecondarySymbolKind = (typeof SECONDARY_SYMBOL_KINDS)[number];
+/** 二次侧文字符号（IEEE C37.2 功能编号），与一次侧的 QF/QS 体系分开 */
+export declare const SECONDARY_SYMBOL_PRESETS: Record<SecondarySymbolKind, {
+    label: string;
+    tag: string;
+    width: number;
+    height: number;
+}>;
+/** 二次回路的外观基准：统一线宽与描边色（与一次侧同一套视觉语言） */
+export declare const SECONDARY_STYLE: {
+    strokeStyle: string;
+    lineWidth: number;
+    heavyLineWidth: number;
+    labelFontSize: number;
+    labelColor: string;
+    tagFontSize: number;
+    tagColor: string;
+};
+/**
+ * @class SecondarySymbol 二次回路元件（复合组件）
+ *
+ * 与其它域包同一套做法：内部形状按 `kind` 派生（`hasDerivedChildren() === true` 不进文档），
+ * 每个派生部件带稳定 `role`，测试按 role 认记法。
+ */
+export default class SecondarySymbol extends ICEGroup {
+    static readonly typeId = "SecondarySymbol";
+    parts: Array<{
+        role: string;
+        component: any;
+    }>;
+    hasDerivedChildren(): boolean;
+    /** 真实子节点 = childNodes 减去派生部件（`parts`）；容器化的域包组件靠它做快照往返 */
+    getSerializableChildren(): any[];
+    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;
+    protected syncShape(): void;
+    private __add;
+    /** 只清派生部件，不动真实子节点（端子排那种容器不受影响） */
+    private __clearParts;
+}
+/**
+ * @class TerminalStrip 端子排（容器）
+ *
+ * 端子排本质是**一列端子**（真实图纸里还会分「现场侧 / 屏柜侧」两列）。这里做成引擎的普通容器：
+ * 端子是它的**真实子节点** —— 拖动端子排时端子跟着走（容器语义），每个端子又有自己的上下插槽可以接线。
+ *
+ * 注意：**不要**给它加 `hasDerivedChildren()`。复合组件声明「子节点都是派生的」会让序列化
+ * 跳过全部子节点，端子排的端子在快照往返时会整套丢掉（BPMN 池/泳道目前就踩了这个坑）。
+ */
+export declare class TerminalStrip extends ICEGroup {
+    static readonly typeId = "TerminalStrip";
+    constructor(props?: any);
+}

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

@@ -0,0 +1,75 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 电力**二次回路**元件库（简化版第一刀：保护电流回路 + 端子排）。
+ *
+ * 记法依据见 `docs/power-secondary-spec.md`：
+ * - 元件的通用图形符号按 GB/T 4728.7（等同 IEC 60617-7，开关 / 控制 / 保护器件）；
+ * - 文字符号用二次侧主流的 **IEEE C37.2 功能编号**（52 断路器、43 切换开关、88 辅助继电器、
+ *   49 过流继电器、33 位置开关、63 压力…），与一次侧的 QF/QS 体系分开；
+ * - 回路编号（A411/B411/C411/N411）、端子号（201…）、电缆编号（1D1…）是数据字段，画成标注。
+ */
+import { ICEGroup } from '../ice-render/index';
+export declare const SECONDARY_SYMBOL_KINDS: readonly ["contactNO", "contactNC", "pushButton", "switchRemoteLocal", "linkPlate", "indicatorLamp", "relayDevice", "ctWinding", "terminal", "earth"];
+export declare type SecondarySymbolKind = (typeof SECONDARY_SYMBOL_KINDS)[number];
+/** 二次侧文字符号（IEEE C37.2 功能编号），与一次侧的 QF/QS 体系分开 */
+export declare const SECONDARY_SYMBOL_PRESETS: Record<SecondarySymbolKind, {
+    label: string;
+    tag: string;
+    width: number;
+    height: number;
+}>;
+/** 二次回路的外观基准：统一线宽与描边色（与一次侧同一套视觉语言） */
+export declare const SECONDARY_STYLE: {
+    strokeStyle: string;
+    lineWidth: number;
+    heavyLineWidth: number;
+    labelFontSize: number;
+    labelColor: string;
+    tagFontSize: number;
+    tagColor: string;
+};
+/**
+ * @class SecondarySymbol 二次回路元件（复合组件）
+ *
+ * 与其它域包同一套做法：内部形状按 `kind` 派生（`hasDerivedChildren() === true` 不进文档），
+ * 每个派生部件带稳定 `role`，测试按 role 认记法。
+ */
+export default class SecondarySymbol extends ICEGroup {
+    static readonly typeId = "SecondarySymbol";
+    parts: Array<{
+        role: string;
+        component: any;
+    }>;
+    hasDerivedChildren(): boolean;
+    /** 真实子节点 = childNodes 减去派生部件（`parts`）；容器化的域包组件靠它做快照往返 */
+    getSerializableChildren(): any[];
+    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;
+    protected syncShape(): void;
+    private __add;
+    /** 只清派生部件，不动真实子节点（端子排那种容器不受影响） */
+    private __clearParts;
+}
+/**
+ * @class TerminalStrip 端子排（容器）
+ *
+ * 端子排本质是**一列端子**（真实图纸里还会分「现场侧 / 屏柜侧」两列）。这里做成引擎的普通容器：
+ * 端子是它的**真实子节点** —— 拖动端子排时端子跟着走（容器语义），每个端子又有自己的上下插槽可以接线。
+ *
+ * 注意：**不要**给它加 `hasDerivedChildren()`。复合组件声明「子节点都是派生的」会让序列化
+ * 跳过全部子节点，端子排的端子在快照往返时会整套丢掉（BPMN 池/泳道目前就踩了这个坑）。
+ */
+export declare class TerminalStrip extends ICEGroup {
+    static readonly typeId = "TerminalStrip";
+    constructor(props?: any);
+}

package/package.json

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