@caoguo/maplibre-pipeline 0.0.2 → 0.0.5

package/dist/topology/index.d.cts

@@ -1,16 +1,16 @@
 import { Map } from '@caoguo/maplibre';
-import { PipelineTopologyDataset, ColorByMode, PipelineType, NodeSelectEvent, PipeSelectEvent, DrillDownEvent } from '../types/index.cjs';
+import { PipelineTopologyDataset, ColorByMode, PipelineType, NodeSelectEvent, PipeSelectEvent, DrillDownEvent, PipelineNode, PipelinePipe } from '../types/index.cjs';
 
 /**
- * PipelineTopology 类 - 占位（待 M4 W3-W4 实现）
+ * PipelineTopology 类（Phase 1 管网拓扑编辑器）
  *
- * 本文件作为 Phase 1 管线拓扑编辑器的入口 stub，后续完整实现包含：
+ * 完整实现：
  *  - 拓扑渲染（管段/节点按类型着色）
- *  - 层级钻取（区域→街道→小区→楼栋）
- *  - 设备卡片（点击节点/管段弹出属性面板）
- *  - 连通性高亮（选中管线后高亮上下游）
- *  - 搜索定位（按编号/地址/区域）
- *  - 分层控制（按管径/材质/年代/状态）
+ *  - 层级钻取（区域→街道→小区→楼栋，drillDown / drillUp）
+ *  - 设备卡片（点击节点/管段触发 onNodeSelect / onPipeSelect）
+ *  - 连通性高亮（选中管线后高亮上下游，highlightConnectivity）
+ *  - 搜索定位（按编号/地址/区域，search）
+ *  - 分层控制（按管径/材质/年代/状态，setLayerFilter）
  */
 
 interface PipelineTopologyOptions {
@@ -26,16 +26,36 @@ interface PipelineTopologyOptions {
 type NodeListener = (e: NodeSelectEvent) => void;
 type PipeListener = (e: PipeSelectEvent) => void;
 type DrillListener = (e: DrillDownEvent) => void;
+/** 分层控制过滤器（按管径/材质/状态/年代） */
+interface LayerFilter {
+    /** 最小管径（mm） */
+    minDiameter?: number;
+    /** 最大管径（mm） */
+    maxDiameter?: number;
+    /** 管材 */
+    material?: string;
+    /** 状态 */
+    status?: string;
+    /** 最小使用年限 */
+    minAgeYears?: number;
+}
+/** 搜索结果 */
+interface SearchResult {
+    /** 匹配节点 */
+    nodes: PipelineNode[];
+    /** 匹配管段 */
+    pipes: PipelinePipe[];
+}
 /**
- * PipelineTopology 组件（占位 stub）
+ * PipelineTopology 组件（Phase 1 MVP 完整实现）
  *
- * Phase 1 MVP 实现进度：
+ * 实现进度：
  *  - [x] 渲染数据接入
- *  - [ ] 层级钻取（M4 W3-W4 后续完善）
- *  - [ ] 设备卡片（M4 W3-W4 后续完善）
- *  - [ ] 连通性高亮（M5 W3-W4 后续完善）
- *  - [ ] 搜索定位（M5 W3-W4 后续完善）
- *  - [ ] 分层控制（M5 W3-W4 后续完善）
+ *  - [x] 层级钻取（drillDown / drillUp）
+ *  - [x] 设备卡片（点击绑定 onNodeSelect / onPipeSelect）
+ *  - [x] 连通性高亮（highlightConnectivity）
+ *  - [x] 搜索定位（search）
+ *  - [x] 分层控制（setLayerFilter / clearLayerFilter）
  */
 declare class PipelineTopology {
     private map;
@@ -47,9 +67,20 @@ declare class PipelineTopology {
     private nodeListeners;
     private pipeListeners;
     private drillListeners;
+    /** 当前钻取区域（null = 全量） */
+    private currentRegion;
+    /** 当前分层过滤器 */
+    private layerFilter;
+    /** click 事件是否已绑定 */
+    private clickBound;
     constructor(options: PipelineTopologyOptions);
     /** 渲染管段+节点到地图 */
     render(): void;
+    /**
+     * 绑定点击事件（设备卡片：点击节点/管段触发订阅回调）。
+     * 只绑定一次（render 重建图层后事件仍指向固定 layerId）。
+     */
+    private bindClickEvents;
     /** 切换着色模式 */
     setColorBy(mode: ColorByMode): void;
     /** 清空所有图层 */
@@ -62,6 +93,25 @@ declare class PipelineTopology {
     onPipeSelect(fn: PipeListener): () => void;
     /** 订阅钻取事件 */
     onDrillDown(fn: DrillListener): () => void;
+    /** 管段是否可见（管线类型 + 区域钻取 + 分层过滤） */
+    private isPipeVisible;
+    /** 节点是否可见（管线类型 + 区域钻取） */
+    private isNodeVisible;
+    /** 计算管段使用年限（年） */
+    private ageInYears;
+    /**
+     * 搜索定位（按编号/地址/区域/类型）。
+     * 返回匹配的节点与管段，供上层 flyTo 定位。
+     */
+    search(query: string): SearchResult;
+    /** 层级钻取：下钻到指定区域（过滤渲染 + 触发事件） */
+    drillDown(region: string): void;
+    /** 层级钻取：返回上一级（清空区域过滤） */
+    drillUp(): void;
+    /** 分层控制：按管径/材质/状态/年代过滤 */
+    setLayerFilter(filter: LayerFilter): void;
+    /** 清空分层过滤器 */
+    clearLayerFilter(): void;
     /** 高亮连通路径（基于节点 ID） */
     highlightConnectivity(centerId: string): Set<string>;
 }

package/dist/topology/index.d.ts

@@ -1,16 +1,16 @@
 import { Map } from '@caoguo/maplibre';
-import { PipelineTopologyDataset, ColorByMode, PipelineType, NodeSelectEvent, PipeSelectEvent, DrillDownEvent } from '../types/index.js';
+import { PipelineTopologyDataset, ColorByMode, PipelineType, NodeSelectEvent, PipeSelectEvent, DrillDownEvent, PipelineNode, PipelinePipe } from '../types/index.js';
 
 /**
- * PipelineTopology 类 - 占位（待 M4 W3-W4 实现）
+ * PipelineTopology 类（Phase 1 管网拓扑编辑器）
  *
- * 本文件作为 Phase 1 管线拓扑编辑器的入口 stub，后续完整实现包含：
+ * 完整实现：
  *  - 拓扑渲染（管段/节点按类型着色）
- *  - 层级钻取（区域→街道→小区→楼栋）
- *  - 设备卡片（点击节点/管段弹出属性面板）
- *  - 连通性高亮（选中管线后高亮上下游）
- *  - 搜索定位（按编号/地址/区域）
- *  - 分层控制（按管径/材质/年代/状态）
+ *  - 层级钻取（区域→街道→小区→楼栋，drillDown / drillUp）
+ *  - 设备卡片（点击节点/管段触发 onNodeSelect / onPipeSelect）
+ *  - 连通性高亮（选中管线后高亮上下游，highlightConnectivity）
+ *  - 搜索定位（按编号/地址/区域，search）
+ *  - 分层控制（按管径/材质/年代/状态，setLayerFilter）
  */
 
 interface PipelineTopologyOptions {
@@ -26,16 +26,36 @@ interface PipelineTopologyOptions {
 type NodeListener = (e: NodeSelectEvent) => void;
 type PipeListener = (e: PipeSelectEvent) => void;
 type DrillListener = (e: DrillDownEvent) => void;
+/** 分层控制过滤器（按管径/材质/状态/年代） */
+interface LayerFilter {
+    /** 最小管径（mm） */
+    minDiameter?: number;
+    /** 最大管径（mm） */
+    maxDiameter?: number;
+    /** 管材 */
+    material?: string;
+    /** 状态 */
+    status?: string;
+    /** 最小使用年限 */
+    minAgeYears?: number;
+}
+/** 搜索结果 */
+interface SearchResult {
+    /** 匹配节点 */
+    nodes: PipelineNode[];
+    /** 匹配管段 */
+    pipes: PipelinePipe[];
+}
 /**
- * PipelineTopology 组件（占位 stub）
+ * PipelineTopology 组件（Phase 1 MVP 完整实现）
  *
- * Phase 1 MVP 实现进度：
+ * 实现进度：
  *  - [x] 渲染数据接入
- *  - [ ] 层级钻取（M4 W3-W4 后续完善）
- *  - [ ] 设备卡片（M4 W3-W4 后续完善）
- *  - [ ] 连通性高亮（M5 W3-W4 后续完善）
- *  - [ ] 搜索定位（M5 W3-W4 后续完善）
- *  - [ ] 分层控制（M5 W3-W4 后续完善）
+ *  - [x] 层级钻取（drillDown / drillUp）
+ *  - [x] 设备卡片（点击绑定 onNodeSelect / onPipeSelect）
+ *  - [x] 连通性高亮（highlightConnectivity）
+ *  - [x] 搜索定位（search）
+ *  - [x] 分层控制（setLayerFilter / clearLayerFilter）
  */
 declare class PipelineTopology {
     private map;
@@ -47,9 +67,20 @@ declare class PipelineTopology {
     private nodeListeners;
     private pipeListeners;
     private drillListeners;
+    /** 当前钻取区域（null = 全量） */
+    private currentRegion;
+    /** 当前分层过滤器 */
+    private layerFilter;
+    /** click 事件是否已绑定 */
+    private clickBound;
     constructor(options: PipelineTopologyOptions);
     /** 渲染管段+节点到地图 */
     render(): void;
+    /**
+     * 绑定点击事件（设备卡片：点击节点/管段触发订阅回调）。
+     * 只绑定一次（render 重建图层后事件仍指向固定 layerId）。
+     */
+    private bindClickEvents;
     /** 切换着色模式 */
     setColorBy(mode: ColorByMode): void;
     /** 清空所有图层 */
@@ -62,6 +93,25 @@ declare class PipelineTopology {
     onPipeSelect(fn: PipeListener): () => void;
     /** 订阅钻取事件 */
     onDrillDown(fn: DrillListener): () => void;
+    /** 管段是否可见（管线类型 + 区域钻取 + 分层过滤） */
+    private isPipeVisible;
+    /** 节点是否可见（管线类型 + 区域钻取） */
+    private isNodeVisible;
+    /** 计算管段使用年限（年） */
+    private ageInYears;
+    /**
+     * 搜索定位（按编号/地址/区域/类型）。
+     * 返回匹配的节点与管段，供上层 flyTo 定位。
+     */
+    search(query: string): SearchResult;
+    /** 层级钻取：下钻到指定区域（过滤渲染 + 触发事件） */
+    drillDown(region: string): void;
+    /** 层级钻取：返回上一级（清空区域过滤） */
+    drillUp(): void;
+    /** 分层控制：按管径/材质/状态/年代过滤 */
+    setLayerFilter(filter: LayerFilter): void;
+    /** 清空分层过滤器 */
+    clearLayerFilter(): void;
     /** 高亮连通路径（基于节点 ID） */
     highlightConnectivity(centerId: string): Set<string>;
 }

package/dist/topology/index.js

@@ -1,4 +1,4 @@
-export { PipelineTopology } from '../chunk-J3AEVXT4.js';
+export { PipelineTopology } from '../chunk-BWQKY35F.js';
 import '../chunk-QVY4WJLM.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/types/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA0BO,IAAM,cAAA,GAA0C;AAAA,EACrD,KAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF","file":"index.cjs","sourcesContent":["/**\n * 草果地图管网组件包 - 类型定义\n *\n * 地下管网 MVP 数据模型：\n * - 节点（Node）：管段的交汇点/设备点（阀门/泵/表/源头）\n * - 管段（Pipe/Edge）：连接两个节点的物理管线\n * - 用户（User）：连接到节点的消费方（居民/商业/工业）\n *\n * 拓扑数据结构参见 PRD phase-1-pipeline §4.1.2\n */\n\n// ============================================================\n// 一、管线类型（基础设施大类）\n// ============================================================\n/**\n * 管网大类\n * - gas：燃气\n * - water：供水\n * - drainage：排水\n * - heating：供热\n * - power：电力（管沟）\n * - telecom：通信（管沟）\n */\nexport type PipelineType = 'gas' | 'water' | 'drainage' | 'heating' | 'power' | 'telecom';\n\n/** 所有支持的管线大类（便于运行时校验） */\nexport const PIPELINE_TYPES: readonly PipelineType[] = [\n  'gas',\n  'water',\n  'drainage',\n  'heating',\n  'power',\n  'telecom',\n] as const;\n\n// ============================================================\n// 二、节点（Node）\n// ============================================================\n/**\n * 节点类型\n * - junction：普通连接点（三通/四通/弯头等）\n * - valve：阀门（可关闭以隔离故障段）\n * - pump：泵站（供水加压/供热循环）\n * - meter：计量表/用户表\n * - source：源头（制水厂/燃气门站/热源厂）\n * - tank：储水罐/储气罐\n * - junction_box：电缆/光缆接线井\n */\nexport type NodeKind =\n  | 'junction'\n  | 'valve'\n  | 'pump'\n  | 'meter'\n  | 'source'\n  | 'tank'\n  | 'junction_box';\n\n/** 阀门子类型 */\nexport type ValveType = 'gate' | 'butterfly' | 'check' | 'pressure_reduction' | 'control';\n\n/** 阀门状态（用于爆管推演隔离方案） */\nexport type ValveStatus = 'open' | 'closed' | 'partial';\n\n// ============================================================\n// 三、管段（Pipe/Edge）\n// ============================================================\n/**\n * 管段材质\n * - cast_iron：铸铁（旧管网主力）\n * - ductile_iron：球墨铸铁（当前主流）\n * - steel：钢管（高压/燃气主干）\n * - pe：聚乙烯（PE，现代供水/燃气）\n * - pvc：聚氯乙烯（PVC，排水）\n * - concrete：混凝土（排水/给水主干）\n * - hdpe：高密度聚乙烯\n * - copper：铜管（室内引入管）\n * - unknown：未知\n */\nexport type PipeMaterial =\n  | 'cast_iron'\n  | 'ductile_iron'\n  | 'steel'\n  | 'pe'\n  | 'pvc'\n  | 'concrete'\n  | 'hdpe'\n  | 'copper'\n  | 'unknown';\n\n/**\n * 管段状态\n * - normal：正常运行\n * - aging：老化（建议关注）\n * - damaged：损坏（泄漏/破裂）\n * - under_repair：维修中（部分阀门/路段暂停使用）\n * - abandoned：废弃\n * - unknown：未知\n */\nexport type PipeStatus =\n  | 'normal'\n  | 'aging'\n  | 'damaged'\n  | 'under_repair'\n  | 'abandoned'\n  | 'unknown';\n\n// ============================================================\n// 四、设备附加属性（管段 / 节点公用扩展）\n// ============================================================\nexport interface PipeProperties {\n  /** 公称直径（mm），如 DN150 = 150 */\n  diameter?: number;\n  /** 管材 */\n  material?: PipeMaterial;\n  /** 安装日期（ISO 字符串） */\n  installDate?: string;\n  /** 工作压力（MPa） */\n  pressure?: number;\n  /** 最高允许压力（MPa） */\n  ratedPressure?: number;\n  /** 当前状态 */\n  status?: PipeStatus;\n  /** 埋深（m） */\n  depth?: number;\n  /** 建设单位 */\n  owner?: string;\n  /** 自由扩展（运维记录/检测报告 URL 等） */\n  extra?: Record<string, unknown>;\n}\n\nexport interface NodeProperties {\n  /** 设备编号 */\n  code?: string;\n  /** 阀门类型（仅 valve） */\n  valveType?: ValveType;\n  /** 阀门状态（仅 valve） */\n  valveStatus?: ValveStatus;\n  /** 流量/供气能力（m³/h，仅 source/pump） */\n  capacity?: number;\n  /** 安装日期 */\n  installDate?: string;\n  /** 产权单位 */\n  owner?: string;\n  /** 海拔（m，用于地形修正） */\n  elevation?: number;\n  /** 自由扩展 */\n  extra?: Record<string, unknown>;\n}\n\n// ============================================================\n// 五、节点（Node）\n// ============================================================\n/**\n * 管网节点\n * position 为 [lng, lat]（GeoJSON 习惯），不是 [lat, lng]\n */\nexport interface PipelineNode {\n  id: string;\n  /** 节点类型 */\n  kind: NodeKind;\n  /** 经度（WGS84） */\n  lng: number;\n  /** 纬度（WGS84） */\n  lat: number;\n  /** 所属管线大类（燃气/供水等） */\n  pipelineType?: PipelineType;\n  /** 行政区/区域（用于层级钻取） */\n  region?: string;\n  /** 自定义属性 */\n  properties?: NodeProperties;\n}\n\n// ============================================================\n// 六、管段（Pipe/Edge）\n// ============================================================\n/**\n * 管网管段\n * from_node / to_node 是有向连接，但物理上双向导通。\n * 地理 LineString 用 [[lng,lat], ...] 表示。\n */\nexport interface PipelinePipe {\n  id: string;\n  /** 起点节点 id */\n  fromNode: string;\n  /** 终点节点 id */\n  toNode: string;\n  /** 管段类型，固定为 'pipe'（预留扩展如 'channel'/'duct'） */\n  type: 'pipe';\n  /** 所属管线大类 */\n  pipelineType?: PipelineType;\n  /** 区域编码（用于 LOD 按需加载） */\n  region?: string;\n  /** 几何（可选，未提供时按 from/to 拉直线） */\n  geometry?: [number, number][];\n  /** 长度（m），可选，由 geometry 计算 */\n  length?: number;\n  /** 管段属性 */\n  properties?: PipeProperties;\n}\n\n// ============================================================\n// 七、用户/建筑（爆管推演影响分析用）\n// ============================================================\n/**\n * 用户类型\n * - residential：居民\n * - commercial：商业\n * - industrial：工业\n * - important：重要用户（医院/学校/政府部门/消防）\n */\nexport type UserKind = 'residential' | 'commercial' | 'industrial' | 'important';\n\nexport interface PipelineUser {\n  id: string;\n  /** 用户名 */\n  name?: string;\n  /** 类型 */\n  kind: UserKind;\n  /** 所属节点 id（直接或间接连接） */\n  nodeId?: string;\n  /** 位置 */\n  lng: number;\n  lat: number;\n  /** 区域 */\n  region?: string;\n  /** 人口/用量（可选） */\n  scale?: number;\n  /** 备注 */\n  note?: string;\n}\n\n// ============================================================\n// 八、完整管网拓扑\n// ============================================================\n/**\n * 管网拓扑数据集（完整 MVP 输入）\n * - nodes：节点列表\n * - pipes：管段列表\n * - users：用户列表（可选，爆管推演需要）\n */\nexport interface PipelineTopologyDataset {\n  nodes: PipelineNode[];\n  pipes: PipelinePipe[];\n  users?: PipelineUser[];\n}\n\n// ============================================================\n// 九、事件载荷（包内统一事件类型）\n// ============================================================\n/** 选中节点 */\nexport interface NodeSelectEvent {\n  node: PipelineNode;\n  /** 在鼠标事件中的屏幕坐标（可选） */\n  point?: { x: number; y: number };\n}\n\n/** 选中管段 */\nexport interface PipeSelectEvent {\n  pipe: PipelinePipe;\n  point?: { x: number; y: number };\n}\n\n/** 钻取事件（区域层级下钻） */\nexport interface DrillDownEvent {\n  /** 上一级区域 */\n  from: string | null;\n  /** 目标区域 */\n  to: string;\n}\n\n// ============================================================\n// 十、可视化着色规则（caoguo-pipeline 主题）\n// ============================================================\n/**\n * 着色模式（管线渲染）\n * - type：按管线大类着色（燃气黄/供水蓝等）\n * - diameter：按管径着色（PRD §4.1.4）\n * - status：按管段状态着色\n * - material：按管材着色\n * - health：按健康度着色（PipelineHealth 集成）\n * - uniform：单一颜色\n */\nexport type ColorByMode =\n  | 'type'\n  | 'diameter'\n  | 'status'\n  | 'material'\n  | 'health'\n  | 'uniform';\n"]}
+{"version":3,"sources":["../../src/types/index.ts"],"names":[],"mappings":";;;AA0BO,IAAM,cAAA,GAA0C;AAAA,EACrD,KAAA;AAAA,EACA,OAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA,OAAA;AAAA,EACA;AACF","file":"index.cjs","sourcesContent":["/**\n * 草果地图管网组件包 - 类型定义\n *\n * 地下管网 MVP 数据模型：\n * - 节点（Node）：管段的交汇点/设备点（阀门/泵/表/源头）\n * - 管段（Pipe/Edge）：连接两个节点的物理管线\n * - 用户（User）：连接到节点的消费方（居民/商业/工业）\n *\n * 拓扑数据结构参见 PRD phase-1-pipeline §4.1.2\n */\n\n// ============================================================\n// 一、管线类型（基础设施大类）\n// ============================================================\n/**\n * 管网大类\n * - gas：燃气\n * - water：供水\n * - drainage：排水\n * - heating：供热\n * - power：电力（管沟）\n * - telecom：通信（管沟）\n */\nexport type PipelineType = 'gas' | 'water' | 'drainage' | 'heating' | 'power' | 'telecom';\n\n/** 所有支持的管线大类（便于运行时校验） */\nexport const PIPELINE_TYPES: readonly PipelineType[] = [\n  'gas',\n  'water',\n  'drainage',\n  'heating',\n  'power',\n  'telecom',\n] as const;\n\n// ============================================================\n// 二、节点（Node）\n// ============================================================\n/**\n * 节点类型\n * - junction：普通连接点（三通/四通/弯头等）\n * - valve：阀门（可关闭以隔离故障段）\n * - pump：泵站（供水加压/供热循环）\n * - meter：计量表/用户表\n * - source：源头（制水厂/燃气门站/热源厂）\n * - tank：储水罐/储气罐\n * - junction_box：电缆/光缆接线井\n */\nexport type NodeKind =\n  | 'junction'\n  | 'valve'\n  | 'pump'\n  | 'meter'\n  | 'source'\n  | 'tank'\n  | 'junction_box';\n\n/** 阀门子类型 */\nexport type ValveType = 'gate' | 'butterfly' | 'check' | 'pressure_reduction' | 'control';\n\n/** 阀门状态（用于爆管推演隔离方案） */\nexport type ValveStatus = 'open' | 'closed' | 'partial';\n\n// ============================================================\n// 三、管段（Pipe/Edge）\n// ============================================================\n/**\n * 管段材质\n * - cast_iron：铸铁（旧管网主力）\n * - ductile_iron：球墨铸铁（当前主流）\n * - steel：钢管（高压/燃气主干）\n * - pe：聚乙烯（PE，现代供水/燃气）\n * - pvc：聚氯乙烯（PVC，排水）\n * - concrete：混凝土（排水/给水主干）\n * - hdpe：高密度聚乙烯\n * - copper：铜管（室内引入管）\n * - unknown：未知\n */\nexport type PipeMaterial =\n  | 'cast_iron'\n  | 'ductile_iron'\n  | 'steel'\n  | 'pe'\n  | 'pvc'\n  | 'concrete'\n  | 'hdpe'\n  | 'copper'\n  | 'unknown';\n\n/**\n * 管段状态\n * - normal：正常运行\n * - aging：老化（建议关注）\n * - damaged：损坏（泄漏/破裂）\n * - under_repair：维修中（部分阀门/路段暂停使用）\n * - abandoned：废弃\n * - unknown：未知\n */\nexport type PipeStatus =\n  | 'normal'\n  | 'aging'\n  | 'damaged'\n  | 'under_repair'\n  | 'abandoned'\n  | 'unknown';\n\n// ============================================================\n// 四、设备附加属性（管段 / 节点公用扩展）\n// ============================================================\nexport interface PipeProperties {\n  /** 公称直径（mm），如 DN150 = 150 */\n  diameter?: number;\n  /** 管材 */\n  material?: PipeMaterial;\n  /** 安装日期（ISO 字符串） */\n  installDate?: string;\n  /** 工作压力（MPa） */\n  pressure?: number;\n  /** 最高允许压力（MPa） */\n  ratedPressure?: number;\n  /** 历史故障次数（健康评分 history 维，PRD §4.4.2） */\n  failureCount?: number;\n  /** 是否阴极保护（健康评分 protection 维，PRD §4.4.2） */\n  hasCathodicProtection?: boolean;\n  /** 当前状态 */\n  status?: PipeStatus;\n  /** 埋深（m） */\n  depth?: number;\n  /** 建设单位 */\n  owner?: string;\n  /** 自由扩展（运维记录/检测报告 URL 等） */\n  extra?: Record<string, unknown>;\n}\n\nexport interface NodeProperties {\n  /** 设备编号 */\n  code?: string;\n  /** 阀门类型（仅 valve） */\n  valveType?: ValveType;\n  /** 阀门状态（仅 valve） */\n  valveStatus?: ValveStatus;\n  /** 流量/供气能力（m³/h，仅 source/pump） */\n  capacity?: number;\n  /** 安装日期 */\n  installDate?: string;\n  /** 产权单位 */\n  owner?: string;\n  /** 海拔（m，用于地形修正） */\n  elevation?: number;\n  /** 自由扩展 */\n  extra?: Record<string, unknown>;\n}\n\n// ============================================================\n// 五、节点（Node）\n// ============================================================\n/**\n * 管网节点\n * position 为 [lng, lat]（GeoJSON 习惯），不是 [lat, lng]\n */\nexport interface PipelineNode {\n  id: string;\n  /** 节点类型 */\n  kind: NodeKind;\n  /** 经度（WGS84） */\n  lng: number;\n  /** 纬度（WGS84） */\n  lat: number;\n  /** 所属管线大类（燃气/供水等） */\n  pipelineType?: PipelineType;\n  /** 行政区/区域（用于层级钻取） */\n  region?: string;\n  /** 自定义属性 */\n  properties?: NodeProperties;\n}\n\n// ============================================================\n// 六、管段（Pipe/Edge）\n// ============================================================\n/**\n * 管网管段\n * from_node / to_node 是有向连接，但物理上双向导通。\n * 地理 LineString 用 [[lng,lat], ...] 表示。\n */\nexport interface PipelinePipe {\n  id: string;\n  /** 起点节点 id */\n  fromNode: string;\n  /** 终点节点 id */\n  toNode: string;\n  /** 管段类型，固定为 'pipe'（预留扩展如 'channel'/'duct'） */\n  type: 'pipe';\n  /** 所属管线大类 */\n  pipelineType?: PipelineType;\n  /** 区域编码（用于 LOD 按需加载） */\n  region?: string;\n  /** 几何（可选，未提供时按 from/to 拉直线） */\n  geometry?: [number, number][];\n  /** 长度（m），可选，由 geometry 计算 */\n  length?: number;\n  /** 管段属性 */\n  properties?: PipeProperties;\n}\n\n// ============================================================\n// 七、用户/建筑（爆管推演影响分析用）\n// ============================================================\n/**\n * 用户类型\n * - residential：居民\n * - commercial：商业\n * - industrial：工业\n * - important：重要用户（医院/学校/政府部门/消防）\n */\nexport type UserKind = 'residential' | 'commercial' | 'industrial' | 'important';\n\nexport interface PipelineUser {\n  id: string;\n  /** 用户名 */\n  name?: string;\n  /** 类型 */\n  kind: UserKind;\n  /** 所属节点 id（直接或间接连接） */\n  nodeId?: string;\n  /** 位置 */\n  lng: number;\n  lat: number;\n  /** 区域 */\n  region?: string;\n  /** 人口/用量（可选） */\n  scale?: number;\n  /** 备注 */\n  note?: string;\n}\n\n// ============================================================\n// 八、完整管网拓扑\n// ============================================================\n/**\n * 管网拓扑数据集（完整 MVP 输入）\n * - nodes：节点列表\n * - pipes：管段列表\n * - users：用户列表（可选，爆管推演需要）\n */\nexport interface PipelineTopologyDataset {\n  nodes: PipelineNode[];\n  pipes: PipelinePipe[];\n  users?: PipelineUser[];\n}\n\n// ============================================================\n// 九、事件载荷（包内统一事件类型）\n// ============================================================\n/** 选中节点 */\nexport interface NodeSelectEvent {\n  node: PipelineNode;\n  /** 在鼠标事件中的屏幕坐标（可选） */\n  point?: { x: number; y: number };\n}\n\n/** 选中管段 */\nexport interface PipeSelectEvent {\n  pipe: PipelinePipe;\n  point?: { x: number; y: number };\n}\n\n/** 钻取事件（区域层级下钻） */\nexport interface DrillDownEvent {\n  /** 上一级区域 */\n  from: string | null;\n  /** 目标区域 */\n  to: string;\n}\n\n// ============================================================\n// 十、可视化着色规则（caoguo-pipeline 主题）\n// ============================================================\n/**\n * 着色模式（管线渲染）\n * - type：按管线大类着色（燃气黄/供水蓝等）\n * - diameter：按管径着色（PRD §4.1.4）\n * - status：按管段状态着色\n * - material：按管材着色\n * - health：按健康度着色（PipelineHealth 集成）\n * - uniform：单一颜色\n */\nexport type ColorByMode =\n  | 'type'\n  | 'diameter'\n  | 'status'\n  | 'material'\n  | 'health'\n  | 'uniform';\n"]}

package/dist/types/index.d.cts

@@ -69,6 +69,10 @@ interface PipeProperties {
     pressure?: number;
     /** 最高允许压力（MPa） */
     ratedPressure?: number;
+    /** 历史故障次数（健康评分 history 维，PRD §4.4.2） */
+    failureCount?: number;
+    /** 是否阴极保护（健康评分 protection 维，PRD §4.4.2） */
+    hasCathodicProtection?: boolean;
     /** 当前状态 */
     status?: PipeStatus;
     /** 埋深（m） */

package/dist/types/index.d.ts

@@ -69,6 +69,10 @@ interface PipeProperties {
     pressure?: number;
     /** 最高允许压力（MPa） */
     ratedPressure?: number;
+    /** 历史故障次数（健康评分 history 维，PRD §4.4.2） */
+    failureCount?: number;
+    /** 是否阴极保护（健康评分 protection 维，PRD §4.4.2） */
+    hasCathodicProtection?: boolean;
     /** 当前状态 */
     status?: PipeStatus;
     /** 埋深（m） */

package/dist/types/index.js

@@ -1,3 +1,3 @@
-export { PIPELINE_TYPES } from '../chunk-HIRNJVCV.js';
+export { PIPELINE_TYPES } from '../chunk-E4BRNDKY.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@caoguo/maplibre-pipeline",
-  "version": "0.0.2",
+  "version": "0.0.5",
   "description": "草果地图管网组件包 - 爆管推演 / 泄漏扩散 / 健康评估 / 拓扑编辑器",
   "license": "Apache-2.0",
   "author": "caoguo <caoguo@hb.cn>",
-  "homepage": "https://github.com/caoguo/map/blob/main/packages/pipeline/README.md",
+  "homepage": "https://github.com/caoguo-map/maplibre-pipeline/blob/main/packages/pipeline/README.md",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/caoguo/map.git",
+    "url": "git+https://github.com/caoguo-map/maplibre-pipeline.git",
     "directory": "packages/pipeline"
   },
   "bugs": {
-    "url": "https://github.com/caoguo/map/issues"
+    "url": "https://github.com/caoguo-map/maplibre-pipeline/issues"
   },
   "keywords": [
     "maplibre",
@@ -86,8 +86,8 @@
     "dist"
   ],
   "dependencies": {
-    "@caoguo/maplibre": "0.0.3",
-    "@caoguo/theme": "0.0.2"
+    "@caoguo/maplibre": "0.0.5",
+    "@caoguo/theme": "0.0.4"
   },
   "publishConfig": {
     "access": "public",