@caoguo/maplibre-pipeline 0.0.2 → 0.0.4

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caoguo/maplibre-pipeline",
-  "version": "0.0.2",
+  "version": "0.0.4",
   "description": "草果地图管网组件包 - 爆管推演 / 泄漏扩散 / 健康评估 / 拓扑编辑器",
   "license": "Apache-2.0",
   "author": "caoguo <caoguo@hb.cn>",
@@ -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",