ice-entity-designer 0.12.2 → 0.12.3

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

@@ -59,7 +59,9 @@ export declare class WaterPipe extends FlowEdge {
 }
 export default class WaterProcessDesigner extends FlowDesigner {
     constructor(ice: any);
+    dispose(): void;
     get nodes(): any[];
+    private __portOccupancyHandler;
     /**
      * 选中判据：水务的符号不是 `FlowNode` 的分支（`WaterSymbol extends ICEGroup`），
      * 所以必须在这里把它（与管线）补进"可点选"的集合 —— 否则点符号选不中，
@@ -73,6 +75,27 @@ export default class WaterProcessDesigner extends FlowDesigner {
     createSymbol(kind: WaterSymbolKind, props?: any): any;
     /** 建一段管线（要标介质；管径缺了会给 warning） */
     createPipe(props?: any): any;
+    /**
+     * 端口占用 → 位号 / 名称侧移（见 `water_shapes.ts` 的 `syncShape()`）。
+     *
+     * **边是唯一真相**：管线两端写着 `links.start/end = {id, position}`，所以这里整体重算一遍，
+     * 只把**变了**的推给符号（`setOccupiedPorts()` 自己比对，没变不重建）。
+     *
+     * 为什么不让符号自己问引擎：`syncShape()` 在**构造期**就会跑（那时还没有边），
+     * 而且符号拿不到"边变了"的通知 —— 边在设计器手里，由它推最省事也最准。
+     *
+     * 谁需要调用：增删管线与载入快照都由本类内部调了；**交互式改接**（把端点拖到另一个端口）
+     * 由构造期挂的 `mouseup` 兜住；宿主自己搬动组件树之后也可以显式调一次。
+     */
+    refreshPortOccupancy(): void;
+    /**
+     * 删除之后重算端口占用：基类的 `remove()` 会**级联删掉**挂在被删图元上的连线，
+     * 所以这里必须整体重算，而不是只盯"被删的那条边"。
+     */
+    remove(id: string): void;
+    clear(): void;
+    /** 载入快照之后重算：快照里不带端口占用（那是派生数据，不进 codec 的完整性约束）。 */
+    load(json: string): any;
     /** 阀门开 / 闭（运行工况：关阀 → 流径断开） */
     setValveState(id: string, valveState: WaterValveState): any;
     /**

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

@@ -59,7 +59,9 @@ export declare class WaterPipe extends FlowEdge {
 }
 export default class WaterProcessDesigner extends FlowDesigner {
     constructor(ice: any);
+    dispose(): void;
     get nodes(): any[];
+    private __portOccupancyHandler;
     /**
      * 选中判据：水务的符号不是 `FlowNode` 的分支（`WaterSymbol extends ICEGroup`），
      * 所以必须在这里把它（与管线）补进"可点选"的集合 —— 否则点符号选不中，
@@ -73,6 +75,27 @@ export default class WaterProcessDesigner extends FlowDesigner {
     createSymbol(kind: WaterSymbolKind, props?: any): any;
     /** 建一段管线（要标介质；管径缺了会给 warning） */
     createPipe(props?: any): any;
+    /**
+     * 端口占用 → 位号 / 名称侧移（见 `water_shapes.ts` 的 `syncShape()`）。
+     *
+     * **边是唯一真相**：管线两端写着 `links.start/end = {id, position}`，所以这里整体重算一遍，
+     * 只把**变了**的推给符号（`setOccupiedPorts()` 自己比对，没变不重建）。
+     *
+     * 为什么不让符号自己问引擎：`syncShape()` 在**构造期**就会跑（那时还没有边），
+     * 而且符号拿不到"边变了"的通知 —— 边在设计器手里，由它推最省事也最准。
+     *
+     * 谁需要调用：增删管线与载入快照都由本类内部调了；**交互式改接**（把端点拖到另一个端口）
+     * 由构造期挂的 `mouseup` 兜住；宿主自己搬动组件树之后也可以显式调一次。
+     */
+    refreshPortOccupancy(): void;
+    /**
+     * 删除之后重算端口占用：基类的 `remove()` 会**级联删掉**挂在被删图元上的连线，
+     * 所以这里必须整体重算，而不是只盯"被删的那条边"。
+     */
+    remove(id: string): void;
+    clear(): void;
+    /** 载入快照之后重算：快照里不带端口占用（那是派生数据，不进 codec 的完整性约束）。 */
+    load(json: string): any;
     /** 阀门开 / 闭（运行工况：关阀 → 流径断开） */
     setValveState(id: string, valveState: WaterValveState): any;
     /**

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

@@ -81,6 +81,23 @@ export declare const WATER_STYLE: {
     /** 明确停用/旁通时的颜色 */
     idleColor: string;
 };
+/**
+ * 标签与端口柱之间的最小间隙（世界像素）。
+ *
+ * 端口（`T` / `B`）落在形状盒的**边中点**上，而位号 / 名称也居中画在那条中轴线上 ——
+ * 于是"从上 / 下进线"的那一小段必然扫过文字（见 `syncShape()` 里的说明）。
+ * 8px 是让文字避开那条线（连同箭头）的余量，与线宽 / 箭头半宽同量级。
+ */
+export declare const WATER_LABEL_PORT_GAP = 8;
+/**
+ * 估算一段文字占多宽（世界像素，不给 ctx 也能算）。
+ *
+ * 为什么要自己估：`syncShape()` 在**构造期**就会跑，那时还没有画布上下文；
+ * 而"标签要让开端口柱"这件事只需要一个够用的宽度（宁可略宽，不要压住线）。
+ * 口径：CJK / 全角按 1 个字宽算，其余（拉丁、数字、标点）按 0.55 个字宽 ——
+ * 与引擎自己的降级估算（`label.length * fontSize`）同思路，只是更贴近实际字宽。
+ */
+export declare function estimateWaterTextWidth(text: string, fontSize: number): number;
 /** 污泥线单元（配色与校验都要用） */
 export declare const WATER_SLUDGE_KINDS: WaterSymbolKind[];
 export type WaterValveState = 'open' | 'closed';
@@ -116,7 +133,19 @@ export default class WaterSymbol extends ICEGroup {
      */
     private __originX;
     private __originY;
+    /**
+     * 本符号**被连线占用**的端口（`T` / `R` / `B` / `L` / `C`）。
+     *
+     * 只影响位号 / 名称的排版（让开端口柱，见 `syncShape()`），**不进 state** ——
+     * 它是从边推出来的派生数据，进了 state 反而要过 codec 那套完整性约束与快照往返。
+     * 由 `WaterProcessDesigner.__syncPortOccupancy()` 在增删连线 / 载入快照之后推进来。
+     */
+    private occupiedPorts;
     hasDerivedChildren(): boolean;
+    /** 设计器把"这个符号的哪几条边上有连线"推过来；变了才重建（避免无谓重绘）。 */
+    setOccupiedPorts(ports: string[]): void;
+    /** 当前被占用的端口（测试 / 属性面板用）。 */
+    getOccupiedPorts(): string[];
     getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;

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

@@ -81,6 +81,23 @@ export declare const WATER_STYLE: {
     /** 明确停用/旁通时的颜色 */
     idleColor: string;
 };
+/**
+ * 标签与端口柱之间的最小间隙（世界像素）。
+ *
+ * 端口（`T` / `B`）落在形状盒的**边中点**上，而位号 / 名称也居中画在那条中轴线上 ——
+ * 于是"从上 / 下进线"的那一小段必然扫过文字（见 `syncShape()` 里的说明）。
+ * 8px 是让文字避开那条线（连同箭头）的余量，与线宽 / 箭头半宽同量级。
+ */
+export declare const WATER_LABEL_PORT_GAP = 8;
+/**
+ * 估算一段文字占多宽（世界像素，不给 ctx 也能算）。
+ *
+ * 为什么要自己估：`syncShape()` 在**构造期**就会跑，那时还没有画布上下文；
+ * 而"标签要让开端口柱"这件事只需要一个够用的宽度（宁可略宽，不要压住线）。
+ * 口径：CJK / 全角按 1 个字宽算，其余（拉丁、数字、标点）按 0.55 个字宽 ——
+ * 与引擎自己的降级估算（`label.length * fontSize`）同思路，只是更贴近实际字宽。
+ */
+export declare function estimateWaterTextWidth(text: string, fontSize: number): number;
 /** 污泥线单元（配色与校验都要用） */
 export declare const WATER_SLUDGE_KINDS: WaterSymbolKind[];
 export type WaterValveState = 'open' | 'closed';
@@ -116,7 +133,19 @@ export default class WaterSymbol extends ICEGroup {
      */
     private __originX;
     private __originY;
+    /**
+     * 本符号**被连线占用**的端口（`T` / `R` / `B` / `L` / `C`）。
+     *
+     * 只影响位号 / 名称的排版（让开端口柱，见 `syncShape()`），**不进 state** ——
+     * 它是从边推出来的派生数据，进了 state 反而要过 codec 那套完整性约束与快照往返。
+     * 由 `WaterProcessDesigner.__syncPortOccupancy()` 在增删连线 / 载入快照之后推进来。
+     */
+    private occupiedPorts;
     hasDerivedChildren(): boolean;
+    /** 设计器把"这个符号的哪几条边上有连线"推过来；变了才重建（避免无谓重绘）。 */
+    setOccupiedPorts(ports: string[]): void;
+    /** 当前被占用的端口（测试 / 属性面板用）。 */
+    getOccupiedPorts(): string[];
     getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;

package/package.json

@@ -1,7 +1,7 @@
 {
   "author": "大漠穷秋",
   "name": "ice-entity-designer",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "description": "An entity designer based on ice-render.",
   "repository": {
     "type": "git",
@@ -37,7 +37,8 @@
   "files": [
     "dist",
     "react.js",
-    "react.d.ts"
+    "react.d.ts",
+    "CHANGELOG.md"
   ],
   "scripts": {
     "start": "rollup -c -w  --environment NODE_ENV:development",