ice-entity-designer 0.12.2 → 0.12.4

package/dist/types/utils/segment-box.d.mts

@@ -0,0 +1,19 @@
+/**
+ * 线段 × 轴对齐矩形（纯几何）。
+ *
+ * 用途：给排水符号的"**过路折线压字**"判定 —— 别人的管线从我的位号 / 名称文字带经过。
+ * 用 Liang–Barsky 的裁剪判据：把线段参数化后用四个半平面依次夹逼，夹完还有交集就算相交。
+ * 不分配对象、不做开方，几十万次调用也不心疼（设计器只在增删管线 / 载入 / 松手时跑）。
+ */
+export interface SegmentPoint {
+    x: number;
+    y: number;
+}
+export interface SegmentBox {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/** 线段 `a→b` 与矩形 `box` 是否相交（含"贴边""端点落在矩形内"）。 */
+export declare function segmentHitsBox(a: SegmentPoint, b: SegmentPoint, box: SegmentBox): boolean;

package/dist/types/utils/segment-box.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 线段 × 轴对齐矩形（纯几何）。
+ *
+ * 用途：给排水符号的"**过路折线压字**"判定 —— 别人的管线从我的位号 / 名称文字带经过。
+ * 用 Liang–Barsky 的裁剪判据：把线段参数化后用四个半平面依次夹逼，夹完还有交集就算相交。
+ * 不分配对象、不做开方，几十万次调用也不心疼（设计器只在增删管线 / 载入 / 松手时跑）。
+ */
+export interface SegmentPoint {
+    x: number;
+    y: number;
+}
+export interface SegmentBox {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/** 线段 `a→b` 与矩形 `box` 是否相交（含"贴边""端点落在矩形内"）。 */
+export declare function segmentHitsBox(a: SegmentPoint, b: SegmentPoint, box: SegmentBox): boolean;

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,42 @@ 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` 兜住；宿主自己搬动组件树之后也可以显式调一次。
+     */
+    /**
+     * 重算**标签排版**：① 端口占用（自己的线上来压字）；② **过路折线**穿过文字带
+     * （别人的管线从我的位号 / 名称上方经过 —— 那根线跟我没有连接关系）。
+     *
+     * 两类都由设计器算，因为**边是唯一真相**、而且折线也在它手里（`edge.state.points`）。
+     * 判据是纯几何：逐条折线与符号的两个文字带做**线段 × 矩形**相交。
+     *
+     * 代价量级：78 符号 × 100 管线 × 几段 ≈ 十万次整数级判定，只在增删管线 / 载入 / 松手时跑，
+     * 可忽略。别把它挂到逐帧路径上。
+     */
+    refreshLabelPlacement(): void;
+    /** 一条边的折线顶点（**世界坐标**：局部点 + 边的 left/top）。 */
+    private __edgeWorldPoints;
+    /** @deprecated 用 `refreshLabelPlacement()` —— 标签让位的判据已经从"端口被占"扩到"过路折线压字"。 */
+    refreshPortOccupancy(): void;
+    private __refreshPortOccupancy;
+    /**
+     * 删除之后重算端口占用：基类的 `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,42 @@ 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` 兜住；宿主自己搬动组件树之后也可以显式调一次。
+     */
+    /**
+     * 重算**标签排版**：① 端口占用（自己的线上来压字）；② **过路折线**穿过文字带
+     * （别人的管线从我的位号 / 名称上方经过 —— 那根线跟我没有连接关系）。
+     *
+     * 两类都由设计器算，因为**边是唯一真相**、而且折线也在它手里（`edge.state.points`）。
+     * 判据是纯几何：逐条折线与符号的两个文字带做**线段 × 矩形**相交。
+     *
+     * 代价量级：78 符号 × 100 管线 × 几段 ≈ 十万次整数级判定，只在增删管线 / 载入 / 松手时跑，
+     * 可忽略。别把它挂到逐帧路径上。
+     */
+    refreshLabelPlacement(): void;
+    /** 一条边的折线顶点（**世界坐标**：局部点 + 边的 left/top）。 */
+    private __edgeWorldPoints;
+    /** @deprecated 用 `refreshLabelPlacement()` —— 标签让位的判据已经从"端口被占"扩到"过路折线压字"。 */
+    refreshPortOccupancy(): void;
+    private __refreshPortOccupancy;
+    /**
+     * 删除之后重算端口占用：基类的 `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,36 @@ export declare const WATER_STYLE: {
     /** 明确停用/旁通时的颜色 */
     idleColor: string;
 };
+/**
+ * 标签与端口柱之间的最小间隙（世界像素）。
+ *
+ * 端口（`T` / `B`）落在形状盒的**边中点**上，而位号 / 名称也居中画在那条中轴线上 ——
+ * 于是"从上 / 下进线"的那一小段必然扫过文字（见 `syncShape()` 里的说明）。
+ * 8px 是让文字避开那条线（连同箭头）的余量，与线宽 / 箭头半宽同量级。
+ */
+export declare const WATER_LABEL_PORT_GAP = 8;
+/** 位号文字带：符号顶边**外侧**居中，top = 形状盒顶边 - 18，高度按字号行高算。 */
+export declare const TAG_TOP_OFFSET = 18;
+export declare const TAG_BOX_HEIGHT: number;
+/** 名称文字带：形状盒底边外侧，top = 底边 + 14。 */
+export declare const NAME_TOP_PAD = 14;
+export declare const NAME_BOX_HEIGHT: number;
+/** 一段文字带的世界矩形（`WaterSymbol.labelBands()` 用）。 */
+export interface LabelBand {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/**
+ * 估算一段文字占多宽（世界像素，不给 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 +146,54 @@ export default class WaterSymbol extends ICEGroup {
      */
     private __originX;
     private __originY;
+    /**
+     * 本符号**被连线占用**的端口（`T` / `R` / `B` / `L` / `C`）。
+     *
+     * 只影响位号 / 名称的排版（让开端口柱，见 `syncShape()`），**不进 state** ——
+     * 它是从边推出来的派生数据，进了 state 反而要过 codec 那套完整性约束与快照往返。
+     * 由 `WaterProcessDesigner.__syncPortOccupancy()` 在增删连线 / 载入快照之后推进来。
+     */
+    private occupiedPorts;
+    /**
+     * 位号 / 名称的**文字带被别的折线穿过**（不是"自己的端口被占"，见 `setLabelBlocked`）。
+     *
+     * 与 `occupiedPorts` 同性质：派生数据、不进 state，由设计器推过来。
+     */
+    private labelBlocked;
     hasDerivedChildren(): boolean;
+    /** 设计器把"这个符号的哪几条边上有连线"推过来；变了才重建（避免无谓重绘）。 */
+    setOccupiedPorts(ports: string[]): void;
+    /** 当前被占用的端口（测试 / 属性面板用）。 */
+    getOccupiedPorts(): string[];
+    /**
+     * 设计器把"有没有**过路折线**穿过我的位号 / 名称文字带"推过来。
+     *
+     * 为什么需要它（与端口占用分开）：端口占用管的是"**我自己**的线上来压我的字"，
+     * 而图纸里还有另一类 —— **别人的管线从我的标签上方 / 下方经过**（那根线跟我没有连接关系）。
+     * 实测下游（ice-agent-console）线上残留 4 处就属于这一类，且放大图元间距无效
+     * （折线与符号的相对位置是尺度无关的）。判据是纯几何，由设计器算（它手里有全部折线）。
+     */
+    setLabelBlocked(blocked: {
+        tag?: boolean;
+        name?: boolean;
+    }): void;
+    /** 当前的两个标签带判定（测试 / 诊断用）。 */
+    getLabelBlocked(): {
+        tag: boolean;
+        name: boolean;
+    };
+    /**
+     * 位号 / 名称**文字带的世界矩形**（没有那行文字时为 null）。
+     *
+     * 用途：设计器拿它跟折线做"过路管线压字"的几何判定（见 `setLabelBlocked`）。
+     * 口径与 `syncShape()` 的排版**同源**（同一批常量），别在别处再抄一份。
+     * 为什么从 `getMinBoundingBox(true)` 取形状盒：它是**世界坐标**且**不含子节点**
+     * （位号 / 名称就在子节点里），正好是文字带的对齐基准。
+     */
+    labelBands(): {
+        tag: LabelBand | null;
+        name: LabelBand | null;
+    };
     getSerializableChildren(): any[];
     constructor(props?: any);
     protected static arrangeParam(props?: any): any;

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

@@ -81,6 +81,36 @@ export declare const WATER_STYLE: {
     /** 明确停用/旁通时的颜色 */
     idleColor: string;
 };
+/**
+ * 标签与端口柱之间的最小间隙（世界像素）。
+ *
+ * 端口（`T` / `B`）落在形状盒的**边中点**上，而位号 / 名称也居中画在那条中轴线上 ——
+ * 于是"从上 / 下进线"的那一小段必然扫过文字（见 `syncShape()` 里的说明）。
+ * 8px 是让文字避开那条线（连同箭头）的余量，与线宽 / 箭头半宽同量级。
+ */
+export declare const WATER_LABEL_PORT_GAP = 8;
+/** 位号文字带：符号顶边**外侧**居中，top = 形状盒顶边 - 18，高度按字号行高算。 */
+export declare const TAG_TOP_OFFSET = 18;
+export declare const TAG_BOX_HEIGHT: number;
+/** 名称文字带：形状盒底边外侧，top = 底边 + 14。 */
+export declare const NAME_TOP_PAD = 14;
+export declare const NAME_BOX_HEIGHT: number;
+/** 一段文字带的世界矩形（`WaterSymbol.labelBands()` 用）。 */
+export interface LabelBand {
+    minX: number;
+    minY: number;
+    maxX: number;
+    maxY: number;
+}
+/**
+ * 估算一段文字占多宽（世界像素，不给 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 +146,54 @@ export default class WaterSymbol extends ICEGroup {
      */
     private __originX;
     private __originY;
+    /**
+     * 本符号**被连线占用**的端口（`T` / `R` / `B` / `L` / `C`）。
+     *
+     * 只影响位号 / 名称的排版（让开端口柱，见 `syncShape()`），**不进 state** ——
+     * 它是从边推出来的派生数据，进了 state 反而要过 codec 那套完整性约束与快照往返。
+     * 由 `WaterProcessDesigner.__syncPortOccupancy()` 在增删连线 / 载入快照之后推进来。
+     */
+    private occupiedPorts;
+    /**
+     * 位号 / 名称的**文字带被别的折线穿过**（不是"自己的端口被占"，见 `setLabelBlocked`）。
+     *
+     * 与 `occupiedPorts` 同性质：派生数据、不进 state，由设计器推过来。
+     */
+    private labelBlocked;
     hasDerivedChildren(): boolean;
+    /** 设计器把"这个符号的哪几条边上有连线"推过来；变了才重建（避免无谓重绘）。 */
+    setOccupiedPorts(ports: string[]): void;
+    /** 当前被占用的端口（测试 / 属性面板用）。 */
+    getOccupiedPorts(): string[];
+    /**
+     * 设计器把"有没有**过路折线**穿过我的位号 / 名称文字带"推过来。
+     *
+     * 为什么需要它（与端口占用分开）：端口占用管的是"**我自己**的线上来压我的字"，
+     * 而图纸里还有另一类 —— **别人的管线从我的标签上方 / 下方经过**（那根线跟我没有连接关系）。
+     * 实测下游（ice-agent-console）线上残留 4 处就属于这一类，且放大图元间距无效
+     * （折线与符号的相对位置是尺度无关的）。判据是纯几何，由设计器算（它手里有全部折线）。
+     */
+    setLabelBlocked(blocked: {
+        tag?: boolean;
+        name?: boolean;
+    }): void;
+    /** 当前的两个标签带判定（测试 / 诊断用）。 */
+    getLabelBlocked(): {
+        tag: boolean;
+        name: boolean;
+    };
+    /**
+     * 位号 / 名称**文字带的世界矩形**（没有那行文字时为 null）。
+     *
+     * 用途：设计器拿它跟折线做"过路管线压字"的几何判定（见 `setLabelBlocked`）。
+     * 口径与 `syncShape()` 的排版**同源**（同一批常量），别在别处再抄一份。
+     * 为什么从 `getMinBoundingBox(true)` 取形状盒：它是**世界坐标**且**不含子节点**
+     * （位号 / 名称就在子节点里），正好是文字带的对齐基准。
+     */
+    labelBands(): {
+        tag: LabelBand | null;
+        name: LabelBand | null;
+    };
     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.4",
   "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",