ice-entity-designer 0.2.6 → 0.2.7

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

@@ -0,0 +1,134 @@
+/**
+ * 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", "sludgeThickener", "dewateringMachine", "pump", "blower", "dosingUnit", "valve", "flowMeter", "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';
+/**
+ * 介质样式：**颜色与线型区分介质**，是给排水图纸的通行做法（具体色值各院略有差异，可覆盖）。
+ * - 污水 / 出水 / 回流：实线，颜色区分；
+ * - 剩余污泥 / 回流污泥：两个色阶的棕黄（一条是排泥、一条是回流，专业上是两回事）；
+ * - 空气 / 药剂：虚线（不是水流）。
+ */
+export declare const WATER_MEDIUM_STYLES: Record<WaterMedium, {
+    label: string;
+    color: string;
+    lineType: 'solid' | 'dashed';
+}>;
+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';
+/**
+ * @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,134 @@
+/**
+ * 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", "sludgeThickener", "dewateringMachine", "pump", "blower", "dosingUnit", "valve", "flowMeter", "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';
+/**
+ * 介质样式：**颜色与线型区分介质**，是给排水图纸的通行做法（具体色值各院略有差异，可覆盖）。
+ * - 污水 / 出水 / 回流：实线，颜色区分；
+ * - 剩余污泥 / 回流污泥：两个色阶的棕黄（一条是排泥、一条是回流，专业上是两回事）；
+ * - 空气 / 药剂：虚线（不是水流）。
+ */
+export declare const WATER_MEDIUM_STYLES: Record<WaterMedium, {
+    label: string;
+    color: string;
+    lineType: 'solid' | 'dashed';
+}>;
+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';
+/**
+ * @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.7",
   "description": "An entity designer based on ice-render.",
   "repository": {
     "type": "git",
@@ -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.3.2",
     "jest": "29.7.0",
     "jest-environment-jsdom": "29.7.0",
     "lint-staged": "15.5.2",