ice-entity-designer 0.2.6 → 0.2.8

package/dist/types/water/WaterProcessDesigner.d.mts

@@ -0,0 +1,82 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 给水排水工艺流程图应用层。
+ *
+ * 复用流程图应用层的选择 / 增删改 / 连线 / 历史 / 快照 / 导出 / 适应视图，
+ * 只补三件这一行特有的东西：
+ * 1. **管线带介质与管径**（污水 / 出水 / 混合液回流 / 回流污泥 / 剩余污泥 / 空气 / 药剂），
+ *    并按介质着色与定线型 —— 给排水图纸靠这个把水线、泥线、空气线分开；
+ * 2. **工艺校验** `validateWater()`：位号唯一、单元要有进出线、管线要标介质与管径、
+ *    出水路径上必须有在线监测（排污许可要求联网）、剩余污泥要有出路、AAO 要有内回流；
+ * 3. **流径分析** `traceFlow()`：从进水沿管线走到出水，阀门关断即视为断流 ——
+ *    相当于电力一次图里的「带电分析」，用来看运行工况（关掉某条超越管之后还通不通）。
+ */
+import FlowDesigner from '../flow/FlowDesigner.mjs';
+import FlowEdge from '../flow/FlowEdge.mjs';
+import type { WaterMedium, WaterSymbolKind, WaterValveState } from './water_shapes.mjs';
+export type WaterIssue = {
+    level: 'error' | 'warning';
+    code: string;
+    message: string;
+    id?: string;
+};
+export type WaterFlowTrace = {
+    /** 从进水能否走到出水 */
+    connected: boolean;
+    /** 途经符号 id（连不上时为空） */
+    path: string[];
+    /** 到达的出水符号 id */
+    outletId?: string;
+    /** 卡在哪个关断的阀门上（连不上时给出） */
+    blockedAt?: string;
+};
+/**
+ * 介质线型 → 虚线数组（点划线 = 长划 + 点）。
+ *
+ * 为什么不让引擎认 `'dashdot'`：`ICEPolyLine` 只把 `'dashed'` 映射成默认虚线，
+ * 其它取值会被当成实线 —— 那"信号线"就与水管画得一模一样了。
+ */
+export declare function dashPatternOf(lineType: 'solid' | 'dashed' | 'dashdot', lineWidth: number): number[];
+/** 管线标注：`DN400 污水` 这种「管径 + 介质」是给排水图纸的通行写法 */
+export declare function composePipeLabel(medium: WaterMedium, dn: string): string;
+/**
+ * @class WaterPipe 工艺管线（污水 / 污泥 / 空气 / 药剂…）
+ *
+ * 一条线 = 一段管线，介质与管径写在线上；线型与颜色跟介质走。
+ */
+export declare class WaterPipe extends FlowEdge {
+    static readonly typeId = "ice-entity-designer:WaterPipe";
+    /** 按当前介质刷新线型、颜色与标注 */
+    applyMediumStyle(): void;
+    /** 改介质（属性面板 / 运行工况用） */
+    setMedium(medium: WaterMedium, dn?: string): void;
+}
+export default class WaterProcessDesigner extends FlowDesigner {
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /** 建一个符号（处理单元 / 设备 / 边界） */
+    createSymbol(kind: WaterSymbolKind, props?: any): any;
+    /** 建一段管线（要标介质；管径缺了会给 warning） */
+    createPipe(props?: any): any;
+    /** 阀门开 / 闭（运行工况：关阀 → 流径断开） */
+    setValveState(id: string, valveState: WaterValveState): any;
+    /**
+     * 流径分析：从进水（`inlet`）沿管线走到出水（`outlet`），**关断的阀门不通行**。
+     * 相当于电力一次图的「带电分析」，用来回答「这个工况下还通不通」。
+     */
+    traceFlow(fromId?: string): WaterFlowTrace;
+    /**
+     * 工艺校验。规则都是"图上可判定"的，不涉及水力计算（那是专业水力软件的事）。
+     */
+    validateWater(): WaterIssue[];
+    private __linkId;
+    private __adjacency;
+    private __symbolById;
+}

package/dist/types/water/WaterProcessDesigner.d.ts

@@ -0,0 +1,82 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 给水排水工艺流程图应用层。
+ *
+ * 复用流程图应用层的选择 / 增删改 / 连线 / 历史 / 快照 / 导出 / 适应视图，
+ * 只补三件这一行特有的东西：
+ * 1. **管线带介质与管径**（污水 / 出水 / 混合液回流 / 回流污泥 / 剩余污泥 / 空气 / 药剂），
+ *    并按介质着色与定线型 —— 给排水图纸靠这个把水线、泥线、空气线分开；
+ * 2. **工艺校验** `validateWater()`：位号唯一、单元要有进出线、管线要标介质与管径、
+ *    出水路径上必须有在线监测（排污许可要求联网）、剩余污泥要有出路、AAO 要有内回流；
+ * 3. **流径分析** `traceFlow()`：从进水沿管线走到出水，阀门关断即视为断流 ——
+ *    相当于电力一次图里的「带电分析」，用来看运行工况（关掉某条超越管之后还通不通）。
+ */
+import FlowDesigner from '../flow/FlowDesigner';
+import FlowEdge from '../flow/FlowEdge';
+import type { WaterMedium, WaterSymbolKind, WaterValveState } from './water_shapes';
+export type WaterIssue = {
+    level: 'error' | 'warning';
+    code: string;
+    message: string;
+    id?: string;
+};
+export type WaterFlowTrace = {
+    /** 从进水能否走到出水 */
+    connected: boolean;
+    /** 途经符号 id（连不上时为空） */
+    path: string[];
+    /** 到达的出水符号 id */
+    outletId?: string;
+    /** 卡在哪个关断的阀门上（连不上时给出） */
+    blockedAt?: string;
+};
+/**
+ * 介质线型 → 虚线数组（点划线 = 长划 + 点）。
+ *
+ * 为什么不让引擎认 `'dashdot'`：`ICEPolyLine` 只把 `'dashed'` 映射成默认虚线，
+ * 其它取值会被当成实线 —— 那"信号线"就与水管画得一模一样了。
+ */
+export declare function dashPatternOf(lineType: 'solid' | 'dashed' | 'dashdot', lineWidth: number): number[];
+/** 管线标注：`DN400 污水` 这种「管径 + 介质」是给排水图纸的通行写法 */
+export declare function composePipeLabel(medium: WaterMedium, dn: string): string;
+/**
+ * @class WaterPipe 工艺管线（污水 / 污泥 / 空气 / 药剂…）
+ *
+ * 一条线 = 一段管线，介质与管径写在线上；线型与颜色跟介质走。
+ */
+export declare class WaterPipe extends FlowEdge {
+    static readonly typeId = "ice-entity-designer:WaterPipe";
+    /** 按当前介质刷新线型、颜色与标注 */
+    applyMediumStyle(): void;
+    /** 改介质（属性面板 / 运行工况用） */
+    setMedium(medium: WaterMedium, dn?: string): void;
+}
+export default class WaterProcessDesigner extends FlowDesigner {
+    constructor(ice: any);
+    get nodes(): any[];
+    get edges(): any[];
+    /** 建一个符号（处理单元 / 设备 / 边界） */
+    createSymbol(kind: WaterSymbolKind, props?: any): any;
+    /** 建一段管线（要标介质；管径缺了会给 warning） */
+    createPipe(props?: any): any;
+    /** 阀门开 / 闭（运行工况：关阀 → 流径断开） */
+    setValveState(id: string, valveState: WaterValveState): any;
+    /**
+     * 流径分析：从进水（`inlet`）沿管线走到出水（`outlet`），**关断的阀门不通行**。
+     * 相当于电力一次图的「带电分析」，用来回答「这个工况下还通不通」。
+     */
+    traceFlow(fromId?: string): WaterFlowTrace;
+    /**
+     * 工艺校验。规则都是"图上可判定"的，不涉及水力计算（那是专业水力软件的事）。
+     */
+    validateWater(): WaterIssue[];
+    private __linkId;
+    private __adjacency;
+    private __symbolById;
+}

package/dist/types/water/water_shapes.d.mts

@@ -0,0 +1,149 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 给水排水工艺流程图（水厂 / 污水厂）符号库。
+ *
+ * **记法依据**：
+ * - GB/T 50106《建筑给水排水制图标准》—— 管道、阀门、仪表等通用图例（第 3 章「图例」）；
+ * - 工艺单元（格栅、沉砂池、初沉池、生物池、二沉池、浓缩池、脱水机…）按工艺专业通行画法自绘，
+ *   本包只用**构成要素**表达可辨识特征（例如格栅＝矩形＋斜栅条、曝气池＝矩形＋曝气盘排列）。
+ * - 文字：给排水图纸以「设备名称 + 位号」为主，不像电力有 QF/QS 那样的强制性文字符号体系。
+ *   本包给每个 kind 一个**行业习惯代号**（P/B/V/FIT/AIT…）作默认值，可自由覆盖。
+ *
+ * **外观统一**（与其它域包同一条铁律）：全部符号共用一套描边色、线宽、字号与基准尺寸，
+ * 并且**不可变换**（只能拖动）—— 符号的比例与朝向是记法的一部分。
+ * 配色约定：**蓝色系＝水线单元，黄色系＝污泥线单元**，全图一眼能分清水与泥。
+ */
+import { ICEGroup } from 'ice-render';
+export declare const WATER_SYMBOL_KINDS: readonly ["barScreen", "gritChamber", "primaryClarifier", "anaerobicTank", "anoxicTank", "aerobicTank", "secondaryClarifier", "coagulationTank", "filterBed", "disinfectionTank", "storageTank", "deodorizer", "sludgeThickener", "dewateringMachine", "sludgeSilo", "pump", "submersiblePump", "screwPump", "blower", "vfd", "dosingUnit", "valve", "motorValve", "checkValve", "flowMeter", "levelGauge", "pressureGauge", "analyzer", "inlet", "outlet", "sludgeOut"];
+export type WaterSymbolKind = (typeof WATER_SYMBOL_KINDS)[number];
+/** 处理单元：参与工艺链、需要进出管线 */
+export declare const WATER_UNIT_KINDS: WaterSymbolKind[];
+/** 设备与仪表：只参与连接，不要求"进出各一条" */
+export declare const WATER_EQUIPMENT_KINDS: WaterSymbolKind[];
+/** 边界符号：进水 / 出水 / 污泥外运 */
+export declare const WATER_BOUNDARY_KINDS: WaterSymbolKind[];
+/** 会产出剩余污泥的单元（校验「污泥有没有出路」用） */
+export declare const WATER_SLUDGE_SOURCE_KINDS: WaterSymbolKind[];
+export type WaterMedium = 'sewage' | 'sludge' | 'returnSludge' | 'recycle' | 'air' | 'chemical' | 'effluent'
+/** 仪表信号线（点划线）：在线仪表 / 液位计 / 压力表与 PLC 的连线 */
+ | 'signal'
+/** 动力线（点划线、更粗）：变频器等电气回路 */
+ | 'power';
+/**
+ * 介质样式：**颜色与线型区分介质**，是给排水图纸的通行做法（具体色值各院略有差异，可覆盖）。
+ * - 污水 / 出水 / 回流：实线，颜色区分；
+ * - 剩余污泥 / 回流污泥：两个色阶的棕黄（一条是排泥、一条是回流，专业上是两回事）；
+ * - 空气 / 药剂：虚线（不是水流）；
+ * - 信号 / 动力：点划线（`lineType: 'dashdot'`）—— 这两条不是管道，是电气与信号回路，
+ *   画出来才能解释"仪表装在哪、变频器控的是哪台设备"。
+ */
+export declare const WATER_MEDIUM_STYLES: Record<WaterMedium, {
+    label: string;
+    color: string;
+    lineType: 'solid' | 'dashed' | 'dashdot';
+}>;
+export type WaterSymbolPreset = {
+    label: string;
+    /** 行业习惯代号（可覆盖；给排水不像电力有强制文字符号体系） */
+    tag: string;
+    width: number;
+    height: number;
+    /** 画法分组：矩形单元 / 圆形单元 / 小设备 / 边界 */
+    shape: 'tank' | 'round' | 'device' | 'boundary';
+    /** 是否串联在管线上（阀门、流量计这类） */
+    inline: boolean;
+};
+export declare const WATER_SYMBOL_PRESETS: Record<WaterSymbolKind, WaterSymbolPreset>;
+/** 全局外观基准：所有符号共用，保证「一张图上不花」 */
+export declare const WATER_STYLE: {
+    strokeStyle: string;
+    lineWidth: number;
+    /** 栅条、折流板、搅拌器这类内部线更细 */
+    detailLineWidth: number;
+    /** 水线单元的填充（浅蓝） */
+    waterFill: string;
+    /** 污泥线单元的填充（浅黄） */
+    sludgeFill: string;
+    tagFontSize: number;
+    tagColor: string;
+    nameFontSize: number;
+    nameColor: string;
+    /** 圆形单元里的罗马数字/字母（G/M 那类） */
+    letterFontSize: number;
+    /** 空心符号的填充（必须是合法色值：fillStyle=false/'none' 会退化成实色） */
+    hollowFill: string;
+    /** 明确停用/旁通时的颜色 */
+    idleColor: string;
+};
+/** 污泥线单元（配色与校验都要用） */
+export declare const WATER_SLUDGE_KINDS: WaterSymbolKind[];
+export type WaterValveState = 'open' | 'closed';
+/**
+ * **可开闭的阀门类图元**：手动阀与电动阀。
+ *
+ * 流径分析（关阀即断流）与开 / 闭操作都按这个集合判 —— 电动阀只是驱动方式不同，
+ * 在"通不通"这件事上和手动阀完全等价；漏了它就会出现"电动阀关着，流径却报通"。
+ * 图纸上要表达"能远程联锁的阀"就用 `motorValve`，不要因为它长得不一样就当成设备。
+ */
+export declare const WATER_VALVE_KINDS: WaterSymbolKind[];
+export declare function isWaterValveKind(kind: string): boolean;
+/**
+ * @class WaterSymbol 给水排水工艺流程图图元（复合组件）
+ *
+ * 与其它域包同一套做法：内部形状按 `kind` 派生（`hasDerivedChildren() === true`），
+ * 不进文档、载入时按 state 重建；`getSerializableChildren()` 声明真实子节点（本包目前没有，
+ * 但保留钩子，后续做「单元里嵌设备」时不用改序列化契约）。
+ */
+export default class WaterSymbol extends ICEGroup {
+    /** 稳定的类型标识（判型与序列化都用它，不要用类名） */
+    static readonly typeId = "ice-entity-designer:WaterSymbol";
+    /** 派生部件（形状 / 文字），测试与属性面板可以按角色取用 */
+    parts: Array<{
+        role: string;
+        component: any;
+    }>;
+    /**
+     * 本次绘制的原点（= 符号中心在组内坐标系里的位置）。
+     *
+     * 组内坐标系原点在**左上角**（`ICERect` 的 left/top 是盒子左上角），而所有形状都是围绕中心
+     * 画的，所以绘图辅助统一按「中心相对坐标」收参、在这里加一次原点偏移。
+     */
+    private __originX;
+    private __originY;
+    hasDerivedChildren(): boolean;
+    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;
+    /** 按 `kind` 重建内部形状与文字 */
+    protected syncShape(): void;
+    private __box;
+    private __circle;
+    /**
+     * 闭合图形：**先画开放折线，再单独补一条闭合边**。
+     *
+     * 不用 `closePath` / 首尾重复点：那种写法会让首帧的包围盒退化，离屏缓存拿 0 尺寸画布去
+     * `drawImage` 而报错（引擎侧已记录此坑，见 13-gap-analysis）。拆成两段开放折线后，
+     * 每条边都走 `__poly`（含轴对齐直线兜底），盒子永远不退化，渲染结果完全一致。
+     */
+    private __closedPoly;
+    private __poly;
+    /**
+     * 文本部件：**显式给文字盒（width/height）+ textAlign/textBaseline 居中**。
+     *
+     * 这是电力域包验证过的写法：不给盒、靠自己估算宽度去挪 left，实测会又偏又挤。
+     */
+    private __text;
+    private __add;
+    private __clearParts;
+}

package/dist/types/water/water_shapes.d.ts

@@ -0,0 +1,149 @@
+/**
+ * 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.
+ *
+ */
+/**
+ * 给水排水工艺流程图（水厂 / 污水厂）符号库。
+ *
+ * **记法依据**：
+ * - GB/T 50106《建筑给水排水制图标准》—— 管道、阀门、仪表等通用图例（第 3 章「图例」）；
+ * - 工艺单元（格栅、沉砂池、初沉池、生物池、二沉池、浓缩池、脱水机…）按工艺专业通行画法自绘，
+ *   本包只用**构成要素**表达可辨识特征（例如格栅＝矩形＋斜栅条、曝气池＝矩形＋曝气盘排列）。
+ * - 文字：给排水图纸以「设备名称 + 位号」为主，不像电力有 QF/QS 那样的强制性文字符号体系。
+ *   本包给每个 kind 一个**行业习惯代号**（P/B/V/FIT/AIT…）作默认值，可自由覆盖。
+ *
+ * **外观统一**（与其它域包同一条铁律）：全部符号共用一套描边色、线宽、字号与基准尺寸，
+ * 并且**不可变换**（只能拖动）—— 符号的比例与朝向是记法的一部分。
+ * 配色约定：**蓝色系＝水线单元，黄色系＝污泥线单元**，全图一眼能分清水与泥。
+ */
+import { ICEGroup } from 'ice-render';
+export declare const WATER_SYMBOL_KINDS: readonly ["barScreen", "gritChamber", "primaryClarifier", "anaerobicTank", "anoxicTank", "aerobicTank", "secondaryClarifier", "coagulationTank", "filterBed", "disinfectionTank", "storageTank", "deodorizer", "sludgeThickener", "dewateringMachine", "sludgeSilo", "pump", "submersiblePump", "screwPump", "blower", "vfd", "dosingUnit", "valve", "motorValve", "checkValve", "flowMeter", "levelGauge", "pressureGauge", "analyzer", "inlet", "outlet", "sludgeOut"];
+export type WaterSymbolKind = (typeof WATER_SYMBOL_KINDS)[number];
+/** 处理单元：参与工艺链、需要进出管线 */
+export declare const WATER_UNIT_KINDS: WaterSymbolKind[];
+/** 设备与仪表：只参与连接，不要求"进出各一条" */
+export declare const WATER_EQUIPMENT_KINDS: WaterSymbolKind[];
+/** 边界符号：进水 / 出水 / 污泥外运 */
+export declare const WATER_BOUNDARY_KINDS: WaterSymbolKind[];
+/** 会产出剩余污泥的单元（校验「污泥有没有出路」用） */
+export declare const WATER_SLUDGE_SOURCE_KINDS: WaterSymbolKind[];
+export type WaterMedium = 'sewage' | 'sludge' | 'returnSludge' | 'recycle' | 'air' | 'chemical' | 'effluent'
+/** 仪表信号线（点划线）：在线仪表 / 液位计 / 压力表与 PLC 的连线 */
+ | 'signal'
+/** 动力线（点划线、更粗）：变频器等电气回路 */
+ | 'power';
+/**
+ * 介质样式：**颜色与线型区分介质**，是给排水图纸的通行做法（具体色值各院略有差异，可覆盖）。
+ * - 污水 / 出水 / 回流：实线，颜色区分；
+ * - 剩余污泥 / 回流污泥：两个色阶的棕黄（一条是排泥、一条是回流，专业上是两回事）；
+ * - 空气 / 药剂：虚线（不是水流）；
+ * - 信号 / 动力：点划线（`lineType: 'dashdot'`）—— 这两条不是管道，是电气与信号回路，
+ *   画出来才能解释"仪表装在哪、变频器控的是哪台设备"。
+ */
+export declare const WATER_MEDIUM_STYLES: Record<WaterMedium, {
+    label: string;
+    color: string;
+    lineType: 'solid' | 'dashed' | 'dashdot';
+}>;
+export type WaterSymbolPreset = {
+    label: string;
+    /** 行业习惯代号（可覆盖；给排水不像电力有强制文字符号体系） */
+    tag: string;
+    width: number;
+    height: number;
+    /** 画法分组：矩形单元 / 圆形单元 / 小设备 / 边界 */
+    shape: 'tank' | 'round' | 'device' | 'boundary';
+    /** 是否串联在管线上（阀门、流量计这类） */
+    inline: boolean;
+};
+export declare const WATER_SYMBOL_PRESETS: Record<WaterSymbolKind, WaterSymbolPreset>;
+/** 全局外观基准：所有符号共用，保证「一张图上不花」 */
+export declare const WATER_STYLE: {
+    strokeStyle: string;
+    lineWidth: number;
+    /** 栅条、折流板、搅拌器这类内部线更细 */
+    detailLineWidth: number;
+    /** 水线单元的填充（浅蓝） */
+    waterFill: string;
+    /** 污泥线单元的填充（浅黄） */
+    sludgeFill: string;
+    tagFontSize: number;
+    tagColor: string;
+    nameFontSize: number;
+    nameColor: string;
+    /** 圆形单元里的罗马数字/字母（G/M 那类） */
+    letterFontSize: number;
+    /** 空心符号的填充（必须是合法色值：fillStyle=false/'none' 会退化成实色） */
+    hollowFill: string;
+    /** 明确停用/旁通时的颜色 */
+    idleColor: string;
+};
+/** 污泥线单元（配色与校验都要用） */
+export declare const WATER_SLUDGE_KINDS: WaterSymbolKind[];
+export type WaterValveState = 'open' | 'closed';
+/**
+ * **可开闭的阀门类图元**：手动阀与电动阀。
+ *
+ * 流径分析（关阀即断流）与开 / 闭操作都按这个集合判 —— 电动阀只是驱动方式不同，
+ * 在"通不通"这件事上和手动阀完全等价；漏了它就会出现"电动阀关着，流径却报通"。
+ * 图纸上要表达"能远程联锁的阀"就用 `motorValve`，不要因为它长得不一样就当成设备。
+ */
+export declare const WATER_VALVE_KINDS: WaterSymbolKind[];
+export declare function isWaterValveKind(kind: string): boolean;
+/**
+ * @class WaterSymbol 给水排水工艺流程图图元（复合组件）
+ *
+ * 与其它域包同一套做法：内部形状按 `kind` 派生（`hasDerivedChildren() === true`），
+ * 不进文档、载入时按 state 重建；`getSerializableChildren()` 声明真实子节点（本包目前没有，
+ * 但保留钩子，后续做「单元里嵌设备」时不用改序列化契约）。
+ */
+export default class WaterSymbol extends ICEGroup {
+    /** 稳定的类型标识（判型与序列化都用它，不要用类名） */
+    static readonly typeId = "ice-entity-designer:WaterSymbol";
+    /** 派生部件（形状 / 文字），测试与属性面板可以按角色取用 */
+    parts: Array<{
+        role: string;
+        component: any;
+    }>;
+    /**
+     * 本次绘制的原点（= 符号中心在组内坐标系里的位置）。
+     *
+     * 组内坐标系原点在**左上角**（`ICERect` 的 left/top 是盒子左上角），而所有形状都是围绕中心
+     * 画的，所以绘图辅助统一按「中心相对坐标」收参、在这里加一次原点偏移。
+     */
+    private __originX;
+    private __originY;
+    hasDerivedChildren(): boolean;
+    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;
+    /** 按 `kind` 重建内部形状与文字 */
+    protected syncShape(): void;
+    private __box;
+    private __circle;
+    /**
+     * 闭合图形：**先画开放折线，再单独补一条闭合边**。
+     *
+     * 不用 `closePath` / 首尾重复点：那种写法会让首帧的包围盒退化，离屏缓存拿 0 尺寸画布去
+     * `drawImage` 而报错（引擎侧已记录此坑，见 13-gap-analysis）。拆成两段开放折线后，
+     * 每条边都走 `__poly`（含轴对齐直线兜底），盒子永远不退化，渲染结果完全一致。
+     */
+    private __closedPoly;
+    private __poly;
+    /**
+     * 文本部件：**显式给文字盒（width/height）+ textAlign/textBaseline 居中**。
+     *
+     * 这是电力域包验证过的写法：不给盒、靠自己估算宽度去挪 left，实测会又偏又挤。
+     */
+    private __text;
+    private __add;
+    private __clearParts;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-entity-designer",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "An entity designer based on ice-render.",
   "repository": {
     "type": "git",
@@ -59,7 +59,7 @@
     "types:watch": "npm run types:check -- --watch"
   },
   "peerDependencies": {
-    "ice-render": "^2.1.0",
+    "ice-render": "^2.4.1",
     "react": "^18 || ^19",
     "react-dom": "^18 || ^19"
   },
@@ -101,7 +101,7 @@
     "eslint-plugin-react-hooks": "4.6.0",
     "http-server": "14.1.1",
     "husky": "8.0.3",
-    "ice-render": "^2.3.0",
+    "ice-render": "^2.4.1",
     "jest": "29.7.0",
     "jest-environment-jsdom": "29.7.0",
     "lint-staged": "15.5.2",