@caoguo/maplibre 0.0.6 → 0.0.7

package/dist/shaders/index.cjs

@@ -0,0 +1,215 @@
+'use strict';
+
+// src/shaders/glowGeometry.ts
+function glowPasses(passes = 4, baseWidth = 3) {
+  if (passes < 1) passes = 1;
+  const out = [];
+  for (let i = 0; i < passes; i++) {
+    const t = passes === 1 ? 1 : 1 - i / (passes - 1);
+    out.push({
+      width: baseWidth * (1 + (1 - t) * (passes - 1) * 1.8),
+      opacity: 0.1 + 0.9 * t * t
+    });
+  }
+  return out;
+}
+function projectSimple(lng, lat) {
+  const x = lng / 180;
+  const y = Math.log(Math.tan(Math.PI / 4 + lat * Math.PI / 360)) / Math.PI;
+  return [x, Math.max(-1, Math.min(1, y / Math.PI))];
+}
+function buildGlowGeometry(lines, opts = {}) {
+  const passes = glowPasses(opts.passes ?? 4, opts.baseWidth ?? 3);
+  const stride = 6;
+  const verts = [];
+  const passRanges = [];
+  const renderGroups = [];
+  const groups = [];
+  for (const line of lines) {
+    const g = line.group ?? "default";
+    if (!groups.includes(g)) groups.push(g);
+  }
+  for (let p = 0; p < passes.length; p++) {
+    passes[p];
+    const start = verts.length / stride;
+    for (const group of groups) {
+      const groupStart = verts.length / stride;
+      const groupIndex = groups.indexOf(group);
+      for (const line of lines) {
+        if ((line.group ?? "default") !== group) continue;
+        const pts = line.coordinates.map(([lng, lat]) => projectSimple(lng, lat));
+        if (pts.length < 2) continue;
+        for (let i = 0; i < pts.length - 1; i++) {
+          const a = pts[i];
+          const b = pts[i + 1];
+          const dx = b[0] - a[0];
+          const dy = b[1] - a[1];
+          const quad = [
+            [a[0], a[1], dx, dy, 1, groupIndex],
+            [a[0], a[1], dx, dy, -1, groupIndex],
+            [b[0], b[1], dx, dy, 1, groupIndex],
+            [b[0], b[1], dx, dy, -1, groupIndex]
+          ];
+          const idx = [0, 1, 2, 2, 1, 3];
+          for (const k of idx) {
+            const v = quad[k];
+            verts.push(v[0], v[1], v[2], v[3], v[4], v[5]);
+          }
+        }
+      }
+      const count2 = verts.length / stride - groupStart;
+      if (count2 > 0) renderGroups.push({ passIndex: p, group, start: groupStart, count: count2 });
+    }
+    const count = verts.length / stride - start;
+    passRanges.push({ start, count });
+  }
+  return { vertices: new Float32Array(verts), passRanges, passes, stride, groups, renderGroups };
+}
+
+// src/shaders/CustomLineLayer.ts
+var FALLBACK_COLOR = [0.6, 0.7, 0.9];
+var DEFAULT_COLORS = {
+  pipe: [0.2, 0.85, 1],
+  // 青蓝：管线
+  road: [0.6, 0.7, 0.9],
+  // 灰蓝：路网
+  water: [0.25, 0.55, 0.95]
+  // 深蓝：水系
+};
+var VERT = `
+attribute vec2 aPos;
+attribute vec2 aDir;
+attribute float aSide;
+uniform mat4 uMatrix;
+uniform float uWidth;
+uniform vec2 uResolution;
+void main() {
+  vec4 clip = uMatrix * vec4(aPos, 0.0, 1.0);
+  // \u6BB5\u65B9\u5411\u4E5F\u6295\u5F71\uFF0C\u6C42\u5C4F\u5E55\u7A7A\u95F4\u65B9\u5411
+  vec4 clipDir = uMatrix * vec4(aPos + aDir, 0.0, 1.0);
+  vec2 s0 = clip.xy / clip.w;
+  vec2 s1 = clipDir.xy / clipDir.w;
+  vec2 dir = normalize(s1 - s0 + vec2(1e-6));
+  vec2 normal = vec2(-dir.y, dir.x);
+  vec2 offset = normal * aSide * (uWidth / uResolution * 2.0);
+  gl_Position = vec4(s0 + offset * clip.w, clip.z, clip.w);
+}
+`;
+var FRAG = `
+precision mediump float;
+uniform vec3 uColor;
+uniform float uOpacity;
+void main() {
+  gl_FragColor = vec4(uColor, uOpacity);
+}
+`;
+function compile(gl, type, src) {
+  const sh = gl.createShader(type);
+  gl.shaderSource(sh, src);
+  gl.compileShader(sh);
+  if (!gl.getShaderParameter(sh, gl.COMPILE_STATUS)) {
+    console.error("[CustomLineLayer] shader \u7F16\u8BD1\u5931\u8D25:", gl.getShaderInfoLog(sh));
+  }
+  return sh;
+}
+var CustomLineLayer = class {
+  constructor(opts) {
+    this.type = "custom";
+    this.renderingMode = "2d";
+    this.id = opts.id ?? "caoguo-glow-line";
+    this.lines = opts.lines;
+    this.colors = { ...DEFAULT_COLORS, ...opts.colors };
+    this.baseWidth = opts.baseWidth ?? 3;
+    this.geometry = buildGlowGeometry(this.lines, { passes: opts.passes ?? 4, baseWidth: this.baseWidth });
+    for (const g of this.geometry.groups) {
+      if (!(g in this.colors)) this.colors[g] = FALLBACK_COLOR;
+    }
+  }
+  onAdd(map, gl) {
+    this.map = map;
+    this.gl = gl;
+    const vs = compile(gl, gl.VERTEX_SHADER, VERT);
+    const fs = compile(gl, gl.FRAGMENT_SHADER, FRAG);
+    const prog = gl.createProgram();
+    gl.attachShader(prog, vs);
+    gl.attachShader(prog, fs);
+    gl.linkProgram(prog);
+    if (!gl.getProgramParameter(prog, gl.LINK_STATUS)) {
+      console.error("[CustomLineLayer] program \u94FE\u63A5\u5931\u8D25:", gl.getProgramInfoLog(prog));
+    }
+    this.program = prog;
+    const buf = gl.createBuffer();
+    gl.bindBuffer(gl.ARRAY_BUFFER, buf);
+    gl.bufferData(gl.ARRAY_BUFFER, this.geometry.vertices, gl.STATIC_DRAW);
+    this.buffer = buf;
+  }
+  render(gl, matrix) {
+    if (!this.program || !this.buffer) return;
+    gl.useProgram(this.program);
+    gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);
+    const stride = this.geometry.stride * 4;
+    const aPos = gl.getAttribLocation(this.program, "aPos");
+    const aDir = gl.getAttribLocation(this.program, "aDir");
+    const aSide = gl.getAttribLocation(this.program, "aSide");
+    const aGroup = gl.getAttribLocation(this.program, "aGroup");
+    gl.enableVertexAttribArray(aPos);
+    gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, stride, 0);
+    gl.enableVertexAttribArray(aDir);
+    gl.vertexAttribPointer(aDir, 2, gl.FLOAT, false, stride, 8);
+    gl.enableVertexAttribArray(aSide);
+    gl.vertexAttribPointer(aSide, 1, gl.FLOAT, false, stride, 16);
+    if (aGroup >= 0) {
+      gl.enableVertexAttribArray(aGroup);
+      gl.vertexAttribPointer(aGroup, 1, gl.FLOAT, false, stride, 20);
+    }
+    const uMatrix = gl.getUniformLocation(this.program, "uMatrix");
+    gl.uniformMatrix4fv(uMatrix, false, new Float32Array(matrix));
+    const uWidth = gl.getUniformLocation(this.program, "uWidth");
+    const uColor = gl.getUniformLocation(this.program, "uColor");
+    const uOpacity = gl.getUniformLocation(this.program, "uOpacity");
+    const uRes = gl.getUniformLocation(this.program, "uResolution");
+    const canvas = this.map?.getCanvas();
+    gl.uniform2f(uRes, canvas?.width ?? 1024, canvas?.height ?? 768);
+    gl.enable(gl.BLEND);
+    gl.blendFunc(gl.SRC_ALPHA, gl.ONE);
+    for (const rg of this.geometry.renderGroups) {
+      const pass = this.geometry.passes[rg.passIndex];
+      const color = this.colors[rg.group] ?? FALLBACK_COLOR;
+      gl.uniform1f(uWidth, pass.width);
+      gl.uniform3f(uColor, color[0], color[1], color[2]);
+      gl.uniform1f(uOpacity, pass.opacity);
+      gl.drawArrays(gl.TRIANGLES, rg.start, rg.count);
+    }
+  }
+  /**
+   * 动态更新线集合（高亮选中、切换数据等无需重建图层）。
+   * 浏览器环境会刷新 GPU 缓冲；纯逻辑/测试环境仅更新几何与数据。
+   */
+  setLines(lines) {
+    this.lines = lines;
+    this.geometry = buildGlowGeometry(this.lines, {
+      passes: this.geometry.passes.length,
+      baseWidth: this.baseWidth
+    });
+    for (const g of this.geometry.groups) {
+      if (!(g in this.colors)) this.colors[g] = FALLBACK_COLOR;
+    }
+    if (this.buffer && this.gl) {
+      this.gl.bindBuffer(this.gl.ARRAY_BUFFER, this.buffer);
+      this.gl.bufferData(this.gl.ARRAY_BUFFER, this.geometry.vertices, this.gl.STATIC_DRAW);
+    }
+  }
+  onRemove(_map, gl) {
+    if (this.buffer) gl.deleteBuffer(this.buffer);
+    if (this.program) gl.deleteProgram(this.program);
+    this.buffer = void 0;
+    this.program = void 0;
+  }
+};
+
+exports.CustomLineLayer = CustomLineLayer;
+exports.buildGlowGeometry = buildGlowGeometry;
+exports.glowPasses = glowPasses;
+exports.projectSimple = projectSimple;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/shaders/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/shaders/glowGeometry.ts","../../src/shaders/CustomLineLayer.ts"],"names":["count"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * 辉光线几何构建（T6 / F-1.3 纯逻辑部分）。\n *\n * 把 GeoJSON LineString 集合转换为「多遍描边」所需的三角形带几何。\n * 渲染层（CustomLineLayer）据此在 WebGL 中以屏幕像素宽度的三角面叠加绘制，\n * 每遍一个宽度档 + 透明度档，加法混合形成管线/路网/水系的辉光效果。\n *\n * 设计：本模块**不依赖 WebGL / maplibre**，纯函数可在 Node 单测。\n * 坐标投影使用简化 Web Mercator（经度→x、纬度→y 的归一化世界坐标），\n * 真实渲染时由 CustomLayer 的 matrix 变换到屏幕；线宽在屏幕空间计算。\n */\n\nexport interface GlowLine {\n  /** 线坐标 [lng, lat][] */\n  coordinates: [number, number][];\n  /** 该线所属分组（如 'pipe' | 'road' | 'water'），用于按组分色。缺省归入 'default'。 */\n  group?: string;\n}\n\nexport interface GlowPass {\n  /** 该遍屏幕像素宽度 */\n  width: number;\n  /** 该遍不透明度（核心线高、外晕低） */\n  opacity: number;\n}\n\nexport interface GlowGeometry {\n  /**\n   * 扁平化顶点缓冲。每个顶点 6 个 float：\n   * [worldX, worldY, dirX, dirY, side, groupIndex]\n   * - worldX/worldY：该端点的归一化世界坐标\n   * - dirX/dirY：所在线段的世界空间方向（用于屏幕空间法线）\n   * - side：±1，左/右扩展符号\n   * - groupIndex：该顶点所属分组在 `groups` 中的下标（用于按组分色）\n   */\n  vertices: Float32Array;\n  /** 每遍在 vertices 中的顶点区间 [start, count]（按顶点数，非 float 数） */\n  passRanges: { start: number; count: number }[];\n  /** 每遍参数（从最外晕到核心，由宽到窄） */\n  passes: GlowPass[];\n  /** 顶点属性跨距（float 数） */\n  stride: number;\n  /** 参与渲染的去重分组名（与上层 colorMap 对应，下标即 groupIndex） */\n  groups: string[];\n  /** 逐遍、逐分组的连续顶点区间，供按组分色绘制 */\n  renderGroups: { passIndex: number; group: string; start: number; count: number }[];\n}\n\n/**\n * 生成辉光多遍档位。\n * @param passes 遍数（默认 4：3 层外晕 + 1 核心）\n * @param baseWidth 核心线像素宽度（默认 3）\n */\nexport function glowPasses(passes = 4, baseWidth = 3): GlowPass[] {\n  if (passes < 1) passes = 1;\n  const out: GlowPass[] = [];\n  // 从最外晕（宽、淡）到核心（窄、浓）排列\n  for (let i = 0; i < passes; i++) {\n    const t = passes === 1 ? 1 : 1 - i / (passes - 1); // 1(核心)..0(外晕)\n    out.push({\n      width: baseWidth * (1 + (1 - t) * (passes - 1) * 1.8),\n      opacity: 0.1 + 0.9 * t * t,\n    });\n  }\n  return out;\n}\n\n/**\n * 简化 Web Mercator 归一化（经度→x∈[-1,1]，纬度→y 经墨卡托压缩）。\n * 仅用于几何构建与单测，真实投影在渲染层用 map 的 matrix。\n */\nexport function projectSimple(lng: number, lat: number): [number, number] {\n  const x = lng / 180;\n  const y = Math.log(Math.tan(Math.PI / 4 + (lat * Math.PI) / 360)) / Math.PI;\n  // 纬度墨卡托范围约 [-π/2, π/2]，归一化到 [-1,1] 方便观察\n  return [x, Math.max(-1, Math.min(1, y / Math.PI))];\n}\n\n/**\n * 构建辉光几何：对每条线、每遍、每段生成三角面（2 三角形 = 6 顶点）。\n */\nexport function buildGlowGeometry(\n  lines: GlowLine[],\n  opts: { passes?: number; baseWidth?: number } = {}\n): GlowGeometry {\n  const passes = glowPasses(opts.passes ?? 4, opts.baseWidth ?? 3);\n  const stride = 6; // worldX, worldY, dirX, dirY, side, groupIndex\n  const verts: number[] = [];\n  const passRanges: { start: number; count: number }[] = [];\n  const renderGroups: { passIndex: number; group: string; start: number; count: number }[] = [];\n\n  // 分组名按首次出现顺序去重，下标即顶点携带的 groupIndex。\n  const groups: string[] = [];\n  for (const line of lines) {\n    const g = line.group ?? 'default';\n    if (!groups.includes(g)) groups.push(g);\n  }\n\n  for (let p = 0; p < passes.length; p++) {\n    const pass = passes[p];\n    const start = verts.length / stride;\n    // 每遍内部按分组聚集成连续区间，便于按组取色绘制。\n    for (const group of groups) {\n      const groupStart = verts.length / stride;\n      const groupIndex = groups.indexOf(group);\n      for (const line of lines) {\n        if ((line.group ?? 'default') !== group) continue;\n        const pts = line.coordinates.map(([lng, lat]) => projectSimple(lng, lat));\n        if (pts.length < 2) continue;\n        for (let i = 0; i < pts.length - 1; i++) {\n          const a = pts[i];\n          const b = pts[i + 1];\n          // 段方向（世界空间，未归一化，shader 内会归一化）\n          const dx = b[0] - a[0];\n          const dy = b[1] - a[1];\n          // 每个端点左右各一个顶点，组成 quad：aL,aR,bL,bR → (aL,aR,bL),(bL,aR,bR)\n          const quad: Array<[number, number, number, number, number, number]> = [\n            [a[0], a[1], dx, dy, 1, groupIndex],\n            [a[0], a[1], dx, dy, -1, groupIndex],\n            [b[0], b[1], dx, dy, 1, groupIndex],\n            [b[0], b[1], dx, dy, -1, groupIndex],\n          ];\n          // 两个三角形：0,1,2 与 2,1,3\n          const idx = [0, 1, 2, 2, 1, 3];\n          for (const k of idx) {\n            const v = quad[k];\n            verts.push(v[0], v[1], v[2], v[3], v[4], v[5]);\n          }\n        }\n      }\n      const count = verts.length / stride - groupStart;\n      if (count > 0) renderGroups.push({ passIndex: p, group, start: groupStart, count });\n    }\n    const count = verts.length / stride - start;\n    passRanges.push({ start, count });\n  }\n\n  return { vertices: new Float32Array(verts), passRanges, passes, stride, groups, renderGroups };\n}\n","/**\n * 辉光管线 Custom Layer（T6 / F-1.3 WebGL 渲染层）。\n *\n * 实现 MapLibre v4 `CustomLayerInterface`：在地图之上叠加绘制 GeoJSON 线，\n * 用多遍（glowPasses）三角面描边形成管线/路网/水系的辉光效果。\n *\n * 设计：几何构建（投影/三角带）在 `./glowGeometry` 纯函数中完成（可单测）；\n * 本文件仅负责 WebGL 状态机与绘制，仅在浏览器执行。\n * 线宽在屏幕空间按像素计算（标准 Mapbox line shader 思路），因此可随缩放保持视觉宽度。\n * 通过 `Map.addGlowLayer` 注入，调用方无需感知 WebGL 细节。\n *\n * 依赖 MapLibre 注入的 `matrix`（map 的 projectionMatrix * modelViewMatrix）。\n */\n\nimport { buildGlowGeometry, type GlowLine } from './glowGeometry';\n\n/** MapLibre v4 CustomLayerInterface 最小子集（避免强类型耦合） */\nexport interface CustomLayerInterface {\n  id: string;\n  type: 'custom';\n  renderingMode?: '2d' | '3d';\n  onAdd?(map: unknown, gl: WebGLRenderingContext): void;\n  render(gl: WebGLRenderingContext, matrix: number[]): void;\n  onRemove?(map: unknown, gl: WebGLRenderingContext): void;\n  prerender?(gl: WebGLRenderingContext, matrix: number[]): void;\n}\n\nexport interface GlowLayerOptions {\n  /** 图层 id */\n  id?: string;\n  /** 线分组颜色映射（group -> [r,g,b] 0..1） */\n  colors?: Record<string, [number, number, number]>;\n  /** 基础线宽（像素，核心线） */\n  baseWidth?: number;\n  /** 辉光遍数 */\n  passes?: number;\n  /** 线集合 */\n  lines: GlowLine[];\n}\n\n/** 取分组色的兜底色（灰蓝），避免未配置分组时渲染透明/黑。 */\nconst FALLBACK_COLOR: [number, number, number] = [0.6, 0.7, 0.9];\n\nconst DEFAULT_COLORS: Record<string, [number, number, number]> = {\n  pipe: [0.2, 0.85, 1.0], // 青蓝：管线\n  road: [0.6, 0.7, 0.9], // 灰蓝：路网\n  water: [0.25, 0.55, 0.95], // 深蓝：水系\n};\n\n// 顶点属性：aPos(世界xy)、aDir(段方向xy)、aSide(±1)\nconst VERT = `\nattribute vec2 aPos;\nattribute vec2 aDir;\nattribute float aSide;\nuniform mat4 uMatrix;\nuniform float uWidth;\nuniform vec2 uResolution;\nvoid main() {\n  vec4 clip = uMatrix * vec4(aPos, 0.0, 1.0);\n  // 段方向也投影，求屏幕空间方向\n  vec4 clipDir = uMatrix * vec4(aPos + aDir, 0.0, 1.0);\n  vec2 s0 = clip.xy / clip.w;\n  vec2 s1 = clipDir.xy / clipDir.w;\n  vec2 dir = normalize(s1 - s0 + vec2(1e-6));\n  vec2 normal = vec2(-dir.y, dir.x);\n  vec2 offset = normal * aSide * (uWidth / uResolution * 2.0);\n  gl_Position = vec4(s0 + offset * clip.w, clip.z, clip.w);\n}\n`;\n\nconst FRAG = `\nprecision mediump float;\nuniform vec3 uColor;\nuniform float uOpacity;\nvoid main() {\n  gl_FragColor = vec4(uColor, uOpacity);\n}\n`;\n\nfunction compile(gl: WebGLRenderingContext, type: number, src: string): WebGLShader {\n  const sh = gl.createShader(type)!;\n  gl.shaderSource(sh, src);\n  gl.compileShader(sh);\n  if (!gl.getShaderParameter(sh, gl.COMPILE_STATUS)) {\n    console.error('[CustomLineLayer] shader 编译失败:', gl.getShaderInfoLog(sh));\n  }\n  return sh;\n}\n\nexport class CustomLineLayer implements CustomLayerInterface {\n  id: string;\n  type = 'custom' as const;\n  renderingMode: '2d' = '2d';\n\n  private lines: GlowLine[];\n  private colors: Record<string, [number, number, number]>;\n  private baseWidth: number;\n\n  private program?: WebGLProgram;\n  private buffer?: WebGLBuffer;\n  private geometry: ReturnType<typeof buildGlowGeometry>;\n  private map?: { getCanvas: () => HTMLCanvasElement };\n  private gl?: WebGLRenderingContext;\n\n  constructor(opts: GlowLayerOptions) {\n    this.id = opts.id ?? 'caoguo-glow-line';\n    this.lines = opts.lines;\n    this.colors = { ...DEFAULT_COLORS, ...opts.colors };\n    this.baseWidth = opts.baseWidth ?? 3;\n    this.geometry = buildGlowGeometry(this.lines, { passes: opts.passes ?? 4, baseWidth: this.baseWidth });\n    // 为新分组补充兜底色，保证未显式配置的分组也能渲染。\n    for (const g of this.geometry.groups) {\n      if (!(g in this.colors)) this.colors[g] = FALLBACK_COLOR;\n    }\n  }\n\n  onAdd(map: unknown, gl: WebGLRenderingContext): void {\n    this.map = map as { getCanvas: () => HTMLCanvasElement };\n    this.gl = gl;\n    const vs = compile(gl, gl.VERTEX_SHADER, VERT);\n    const fs = compile(gl, gl.FRAGMENT_SHADER, FRAG);\n    const prog = gl.createProgram()!;\n    gl.attachShader(prog, vs);\n    gl.attachShader(prog, fs);\n    gl.linkProgram(prog);\n    if (!gl.getProgramParameter(prog, gl.LINK_STATUS)) {\n      console.error('[CustomLineLayer] program 链接失败:', gl.getProgramInfoLog(prog));\n    }\n    this.program = prog;\n\n    const buf = gl.createBuffer()!;\n    gl.bindBuffer(gl.ARRAY_BUFFER, buf);\n    gl.bufferData(gl.ARRAY_BUFFER, this.geometry.vertices, gl.STATIC_DRAW);\n    this.buffer = buf;\n  }\n\n  render(gl: WebGLRenderingContext, matrix: number[]): void {\n    if (!this.program || !this.buffer) return;\n    gl.useProgram(this.program);\n    gl.bindBuffer(gl.ARRAY_BUFFER, this.buffer);\n\n    const stride = this.geometry.stride * 4; // float -> byte\n    const aPos = gl.getAttribLocation(this.program, 'aPos');\n    const aDir = gl.getAttribLocation(this.program, 'aDir');\n    const aSide = gl.getAttribLocation(this.program, 'aSide');\n    const aGroup = gl.getAttribLocation(this.program, 'aGroup');\n    gl.enableVertexAttribArray(aPos);\n    gl.vertexAttribPointer(aPos, 2, gl.FLOAT, false, stride, 0);\n    gl.enableVertexAttribArray(aDir);\n    gl.vertexAttribPointer(aDir, 2, gl.FLOAT, false, stride, 8);\n    gl.enableVertexAttribArray(aSide);\n    gl.vertexAttribPointer(aSide, 1, gl.FLOAT, false, stride, 16);\n    if (aGroup >= 0) {\n      gl.enableVertexAttribArray(aGroup);\n      gl.vertexAttribPointer(aGroup, 1, gl.FLOAT, false, stride, 20);\n    }\n\n    const uMatrix = gl.getUniformLocation(this.program, 'uMatrix');\n    gl.uniformMatrix4fv(uMatrix, false, new Float32Array(matrix));\n    const uWidth = gl.getUniformLocation(this.program, 'uWidth');\n    const uColor = gl.getUniformLocation(this.program, 'uColor');\n    const uOpacity = gl.getUniformLocation(this.program, 'uOpacity');\n    const uRes = gl.getUniformLocation(this.program, 'uResolution');\n    const canvas = this.map?.getCanvas();\n    gl.uniform2f(uRes, canvas?.width ?? 1024, canvas?.height ?? 768);\n\n    gl.enable(gl.BLEND);\n    gl.blendFunc(gl.SRC_ALPHA, gl.ONE); // 加法混合形成辉光\n\n    // 逐遍、逐分组取色绘制：实现「按分组多色」，不同业务线（管/路/水）各自着色。\n    for (const rg of this.geometry.renderGroups) {\n      const pass = this.geometry.passes[rg.passIndex];\n      const color = this.colors[rg.group] ?? FALLBACK_COLOR;\n      gl.uniform1f(uWidth, pass.width);\n      gl.uniform3f(uColor, color[0], color[1], color[2]);\n      gl.uniform1f(uOpacity, pass.opacity);\n      gl.drawArrays(gl.TRIANGLES, rg.start, rg.count);\n    }\n  }\n\n  /**\n   * 动态更新线集合（高亮选中、切换数据等无需重建图层）。\n   * 浏览器环境会刷新 GPU 缓冲；纯逻辑/测试环境仅更新几何与数据。\n   */\n  setLines(lines: GlowLine[]): void {\n    this.lines = lines;\n    this.geometry = buildGlowGeometry(this.lines, {\n      passes: this.geometry.passes.length,\n      baseWidth: this.baseWidth,\n    });\n    // 为新分组补充兜底色，保证未显式配置的分组也能渲染。\n    for (const g of this.geometry.groups) {\n      if (!(g in this.colors)) this.colors[g] = FALLBACK_COLOR;\n    }\n    // 图层已挂载（this.gl 在 onAdd 时缓存）则刷新 GPU 缓冲。\n    if (this.buffer && this.gl) {\n      this.gl.bindBuffer(this.gl.ARRAY_BUFFER, this.buffer);\n      this.gl.bufferData(this.gl.ARRAY_BUFFER, this.geometry.vertices, this.gl.STATIC_DRAW);\n    }\n  }\n\n  onRemove(_map: unknown, gl: WebGLRenderingContext): void {\n    if (this.buffer) gl.deleteBuffer(this.buffer);\n    if (this.program) gl.deleteProgram(this.program);\n    this.buffer = undefined;\n    this.program = undefined;\n  }\n}\n"]}

package/dist/shaders/index.d.cts

@@ -0,0 +1,131 @@
+/**
+ * 辉光线几何构建（T6 / F-1.3 纯逻辑部分）。
+ *
+ * 把 GeoJSON LineString 集合转换为「多遍描边」所需的三角形带几何。
+ * 渲染层（CustomLineLayer）据此在 WebGL 中以屏幕像素宽度的三角面叠加绘制，
+ * 每遍一个宽度档 + 透明度档，加法混合形成管线/路网/水系的辉光效果。
+ *
+ * 设计：本模块**不依赖 WebGL / maplibre**，纯函数可在 Node 单测。
+ * 坐标投影使用简化 Web Mercator（经度→x、纬度→y 的归一化世界坐标），
+ * 真实渲染时由 CustomLayer 的 matrix 变换到屏幕；线宽在屏幕空间计算。
+ */
+interface GlowLine {
+    /** 线坐标 [lng, lat][] */
+    coordinates: [number, number][];
+    /** 该线所属分组（如 'pipe' | 'road' | 'water'），用于按组分色。缺省归入 'default'。 */
+    group?: string;
+}
+interface GlowPass {
+    /** 该遍屏幕像素宽度 */
+    width: number;
+    /** 该遍不透明度（核心线高、外晕低） */
+    opacity: number;
+}
+interface GlowGeometry {
+    /**
+     * 扁平化顶点缓冲。每个顶点 6 个 float：
+     * [worldX, worldY, dirX, dirY, side, groupIndex]
+     * - worldX/worldY：该端点的归一化世界坐标
+     * - dirX/dirY：所在线段的世界空间方向（用于屏幕空间法线）
+     * - side：±1，左/右扩展符号
+     * - groupIndex：该顶点所属分组在 `groups` 中的下标（用于按组分色）
+     */
+    vertices: Float32Array;
+    /** 每遍在 vertices 中的顶点区间 [start, count]（按顶点数，非 float 数） */
+    passRanges: {
+        start: number;
+        count: number;
+    }[];
+    /** 每遍参数（从最外晕到核心，由宽到窄） */
+    passes: GlowPass[];
+    /** 顶点属性跨距（float 数） */
+    stride: number;
+    /** 参与渲染的去重分组名（与上层 colorMap 对应，下标即 groupIndex） */
+    groups: string[];
+    /** 逐遍、逐分组的连续顶点区间，供按组分色绘制 */
+    renderGroups: {
+        passIndex: number;
+        group: string;
+        start: number;
+        count: number;
+    }[];
+}
+/**
+ * 生成辉光多遍档位。
+ * @param passes 遍数（默认 4：3 层外晕 + 1 核心）
+ * @param baseWidth 核心线像素宽度（默认 3）
+ */
+declare function glowPasses(passes?: number, baseWidth?: number): GlowPass[];
+/**
+ * 简化 Web Mercator 归一化（经度→x∈[-1,1]，纬度→y 经墨卡托压缩）。
+ * 仅用于几何构建与单测，真实投影在渲染层用 map 的 matrix。
+ */
+declare function projectSimple(lng: number, lat: number): [number, number];
+/**
+ * 构建辉光几何：对每条线、每遍、每段生成三角面（2 三角形 = 6 顶点）。
+ */
+declare function buildGlowGeometry(lines: GlowLine[], opts?: {
+    passes?: number;
+    baseWidth?: number;
+}): GlowGeometry;
+
+/**
+ * 辉光管线 Custom Layer（T6 / F-1.3 WebGL 渲染层）。
+ *
+ * 实现 MapLibre v4 `CustomLayerInterface`：在地图之上叠加绘制 GeoJSON 线，
+ * 用多遍（glowPasses）三角面描边形成管线/路网/水系的辉光效果。
+ *
+ * 设计：几何构建（投影/三角带）在 `./glowGeometry` 纯函数中完成（可单测）；
+ * 本文件仅负责 WebGL 状态机与绘制，仅在浏览器执行。
+ * 线宽在屏幕空间按像素计算（标准 Mapbox line shader 思路），因此可随缩放保持视觉宽度。
+ * 通过 `Map.addGlowLayer` 注入，调用方无需感知 WebGL 细节。
+ *
+ * 依赖 MapLibre 注入的 `matrix`（map 的 projectionMatrix * modelViewMatrix）。
+ */
+
+/** MapLibre v4 CustomLayerInterface 最小子集（避免强类型耦合） */
+interface CustomLayerInterface {
+    id: string;
+    type: 'custom';
+    renderingMode?: '2d' | '3d';
+    onAdd?(map: unknown, gl: WebGLRenderingContext): void;
+    render(gl: WebGLRenderingContext, matrix: number[]): void;
+    onRemove?(map: unknown, gl: WebGLRenderingContext): void;
+    prerender?(gl: WebGLRenderingContext, matrix: number[]): void;
+}
+interface GlowLayerOptions {
+    /** 图层 id */
+    id?: string;
+    /** 线分组颜色映射（group -> [r,g,b] 0..1） */
+    colors?: Record<string, [number, number, number]>;
+    /** 基础线宽（像素，核心线） */
+    baseWidth?: number;
+    /** 辉光遍数 */
+    passes?: number;
+    /** 线集合 */
+    lines: GlowLine[];
+}
+declare class CustomLineLayer implements CustomLayerInterface {
+    id: string;
+    type: "custom";
+    renderingMode: '2d';
+    private lines;
+    private colors;
+    private baseWidth;
+    private program?;
+    private buffer?;
+    private geometry;
+    private map?;
+    private gl?;
+    constructor(opts: GlowLayerOptions);
+    onAdd(map: unknown, gl: WebGLRenderingContext): void;
+    render(gl: WebGLRenderingContext, matrix: number[]): void;
+    /**
+     * 动态更新线集合（高亮选中、切换数据等无需重建图层）。
+     * 浏览器环境会刷新 GPU 缓冲；纯逻辑/测试环境仅更新几何与数据。
+     */
+    setLines(lines: GlowLine[]): void;
+    onRemove(_map: unknown, gl: WebGLRenderingContext): void;
+}
+
+export { type CustomLayerInterface, CustomLineLayer, type GlowGeometry, type GlowLayerOptions, type GlowLine, type GlowPass, buildGlowGeometry, glowPasses, projectSimple };

package/dist/shaders/index.d.ts

@@ -0,0 +1,131 @@
+/**
+ * 辉光线几何构建（T6 / F-1.3 纯逻辑部分）。
+ *
+ * 把 GeoJSON LineString 集合转换为「多遍描边」所需的三角形带几何。
+ * 渲染层（CustomLineLayer）据此在 WebGL 中以屏幕像素宽度的三角面叠加绘制，
+ * 每遍一个宽度档 + 透明度档，加法混合形成管线/路网/水系的辉光效果。
+ *
+ * 设计：本模块**不依赖 WebGL / maplibre**，纯函数可在 Node 单测。
+ * 坐标投影使用简化 Web Mercator（经度→x、纬度→y 的归一化世界坐标），
+ * 真实渲染时由 CustomLayer 的 matrix 变换到屏幕；线宽在屏幕空间计算。
+ */
+interface GlowLine {
+    /** 线坐标 [lng, lat][] */
+    coordinates: [number, number][];
+    /** 该线所属分组（如 'pipe' | 'road' | 'water'），用于按组分色。缺省归入 'default'。 */
+    group?: string;
+}
+interface GlowPass {
+    /** 该遍屏幕像素宽度 */
+    width: number;
+    /** 该遍不透明度（核心线高、外晕低） */
+    opacity: number;
+}
+interface GlowGeometry {
+    /**
+     * 扁平化顶点缓冲。每个顶点 6 个 float：
+     * [worldX, worldY, dirX, dirY, side, groupIndex]
+     * - worldX/worldY：该端点的归一化世界坐标
+     * - dirX/dirY：所在线段的世界空间方向（用于屏幕空间法线）
+     * - side：±1，左/右扩展符号
+     * - groupIndex：该顶点所属分组在 `groups` 中的下标（用于按组分色）
+     */
+    vertices: Float32Array;
+    /** 每遍在 vertices 中的顶点区间 [start, count]（按顶点数，非 float 数） */
+    passRanges: {
+        start: number;
+        count: number;
+    }[];
+    /** 每遍参数（从最外晕到核心，由宽到窄） */
+    passes: GlowPass[];
+    /** 顶点属性跨距（float 数） */
+    stride: number;
+    /** 参与渲染的去重分组名（与上层 colorMap 对应，下标即 groupIndex） */
+    groups: string[];
+    /** 逐遍、逐分组的连续顶点区间，供按组分色绘制 */
+    renderGroups: {
+        passIndex: number;
+        group: string;
+        start: number;
+        count: number;
+    }[];
+}
+/**
+ * 生成辉光多遍档位。
+ * @param passes 遍数（默认 4：3 层外晕 + 1 核心）
+ * @param baseWidth 核心线像素宽度（默认 3）
+ */
+declare function glowPasses(passes?: number, baseWidth?: number): GlowPass[];
+/**
+ * 简化 Web Mercator 归一化（经度→x∈[-1,1]，纬度→y 经墨卡托压缩）。
+ * 仅用于几何构建与单测，真实投影在渲染层用 map 的 matrix。
+ */
+declare function projectSimple(lng: number, lat: number): [number, number];
+/**
+ * 构建辉光几何：对每条线、每遍、每段生成三角面（2 三角形 = 6 顶点）。
+ */
+declare function buildGlowGeometry(lines: GlowLine[], opts?: {
+    passes?: number;
+    baseWidth?: number;
+}): GlowGeometry;
+
+/**
+ * 辉光管线 Custom Layer（T6 / F-1.3 WebGL 渲染层）。
+ *
+ * 实现 MapLibre v4 `CustomLayerInterface`：在地图之上叠加绘制 GeoJSON 线，
+ * 用多遍（glowPasses）三角面描边形成管线/路网/水系的辉光效果。
+ *
+ * 设计：几何构建（投影/三角带）在 `./glowGeometry` 纯函数中完成（可单测）；
+ * 本文件仅负责 WebGL 状态机与绘制，仅在浏览器执行。
+ * 线宽在屏幕空间按像素计算（标准 Mapbox line shader 思路），因此可随缩放保持视觉宽度。
+ * 通过 `Map.addGlowLayer` 注入，调用方无需感知 WebGL 细节。
+ *
+ * 依赖 MapLibre 注入的 `matrix`（map 的 projectionMatrix * modelViewMatrix）。
+ */
+
+/** MapLibre v4 CustomLayerInterface 最小子集（避免强类型耦合） */
+interface CustomLayerInterface {
+    id: string;
+    type: 'custom';
+    renderingMode?: '2d' | '3d';
+    onAdd?(map: unknown, gl: WebGLRenderingContext): void;
+    render(gl: WebGLRenderingContext, matrix: number[]): void;
+    onRemove?(map: unknown, gl: WebGLRenderingContext): void;
+    prerender?(gl: WebGLRenderingContext, matrix: number[]): void;
+}
+interface GlowLayerOptions {
+    /** 图层 id */
+    id?: string;
+    /** 线分组颜色映射（group -> [r,g,b] 0..1） */
+    colors?: Record<string, [number, number, number]>;
+    /** 基础线宽（像素，核心线） */
+    baseWidth?: number;
+    /** 辉光遍数 */
+    passes?: number;
+    /** 线集合 */
+    lines: GlowLine[];
+}
+declare class CustomLineLayer implements CustomLayerInterface {
+    id: string;
+    type: "custom";
+    renderingMode: '2d';
+    private lines;
+    private colors;
+    private baseWidth;
+    private program?;
+    private buffer?;
+    private geometry;
+    private map?;
+    private gl?;
+    constructor(opts: GlowLayerOptions);
+    onAdd(map: unknown, gl: WebGLRenderingContext): void;
+    render(gl: WebGLRenderingContext, matrix: number[]): void;
+    /**
+     * 动态更新线集合（高亮选中、切换数据等无需重建图层）。
+     * 浏览器环境会刷新 GPU 缓冲；纯逻辑/测试环境仅更新几何与数据。
+     */
+    setLines(lines: GlowLine[]): void;
+    onRemove(_map: unknown, gl: WebGLRenderingContext): void;
+}
+
+export { type CustomLayerInterface, CustomLineLayer, type GlowGeometry, type GlowLayerOptions, type GlowLine, type GlowPass, buildGlowGeometry, glowPasses, projectSimple };

package/dist/shaders/index.js

@@ -0,0 +1,3 @@
+export { CustomLineLayer, buildGlowGeometry, glowPasses, projectSimple } from '../chunk-G7VY42ZG.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/shaders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/sourceUtils.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+// src/sourceUtils.ts
+function upsertSource(mlMap, id, data) {
+  if (mlMap.getSource(id)) {
+    if (mlMap.setData) {
+      mlMap.setData(id, data);
+    } else if (mlMap.addSource) {
+      mlMap.addSource(id, data);
+    }
+  } else if (mlMap.addSource) {
+    mlMap.addSource(id, data);
+  }
+}
+function removeSourceSafe(mlMap, id) {
+  if (mlMap.getSource(id) && mlMap.removeSource) {
+    mlMap.removeSource(id);
+  }
+}
+function removeSourcesSafe(mlMap, ids) {
+  for (const id of ids) {
+    removeSourceSafe(mlMap, id);
+  }
+}
+
+exports.removeSourceSafe = removeSourceSafe;
+exports.removeSourcesSafe = removeSourcesSafe;
+exports.upsertSource = upsertSource;
+//# sourceMappingURL=sourceUtils.cjs.map
+//# sourceMappingURL=sourceUtils.cjs.map

package/dist/sourceUtils.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sourceUtils.ts"],"names":[],"mappings":";;;AA6CO,SAAS,YAAA,CACd,KAAA,EACA,EAAA,EACA,IAAA,EACM;AACN,EAAA,IAAI,KAAA,CAAM,SAAA,CAAU,EAAE,CAAA,EAAG;AACvB,IAAA,IAAI,MAAM,OAAA,EAAS;AACjB,MAAA,KAAA,CAAM,OAAA,CAAQ,IAAI,IAAI,CAAA;AAAA,IACxB,CAAA,MAAA,IAAW,MAAM,SAAA,EAAW;AAE1B,MAAA,KAAA,CAAM,SAAA,CAAU,IAAI,IAAI,CAAA;AAAA,IAC1B;AAAA,EACF,CAAA,MAAA,IAAW,MAAM,SAAA,EAAW;AAC1B,IAAA,KAAA,CAAM,SAAA,CAAU,IAAI,IAAI,CAAA;AAAA,EAC1B;AACF;AAQO,SAAS,gBAAA,CAAiB,OAAuB,EAAA,EAAkB;AACxE,EAAA,IAAI,KAAA,CAAM,SAAA,CAAU,EAAE,CAAA,IAAK,MAAM,YAAA,EAAc;AAC7C,IAAA,KAAA,CAAM,aAAa,EAAE,CAAA;AAAA,EACvB;AACF;AAQO,SAAS,iBAAA,CAAkB,OAAuB,GAAA,EAAqB;AAC5E,EAAA,KAAA,MAAW,MAAM,GAAA,EAAK;AACpB,IAAA,gBAAA,CAAiB,OAAO,EAAE,CAAA;AAAA,EAC5B;AACF","file":"sourceUtils.cjs","sourcesContent":["/**\n * 原生 MapLibre 地图 source 操作的幂等工具。\n *\n * 各业务 System（grid/water/pipeline/telecom/compute/transport）的 render()\n * 通过 `this.map.instance` 直接调用原生 MapLibre，而非经 CaoguoMap 包装类的\n * 幂等 addSource。为避免在每个 System 内重复书写 `if (!mlMap.getSource(id))`\n * 样板，并根治「层级切换重渲染崩溃」（Source already exists），统一在此提供\n * 幂等 upsert 与安全的 removeSource。\n *\n * 仅依赖原生 MapLibre 的 source 子集接口，便于各 System 直接传入 instance。\n */\n\n/**\n * 原生 MapLibre source 操作的子集接口。\n *\n * 仅 `getSource` 为必填——它是所有 helper 判断「source 是否存在」的统一探针。\n * 其余方法全部可选，因为各业务 System 对 `this.map.instance` 的局部类型断言\n * 只声明了实际用到的若干方法（如 topology 只取 getSource/removeSource，\n * traffic 只取 addSource/addLayer），强制统一必填字段会与这些子集冲突。\n * helper 内部对每个要调用的方法做存在性检查，缺失时安全跳过或回退，\n * 保证类型与运行时都安全（真实 MapLibre 实例始终具备全部方法）。\n */\nexport interface MlMapSourceApi {\n  getSource: (id: string) => unknown;\n  addSource?: (id: string, source: unknown) => void;\n  addLayer?: (layer: unknown) => void;\n  setData?: (id: string, data: unknown) => void;\n  removeSource?: (id: string) => void;\n}\n\n/**\n * 幂等地确保一个 GeoJSON source 存在并持有给定数据。\n *\n * - 若 source 已存在且具备 setData：setData 更新（避免重复 addSource 抛错）。\n * - 若 source 已存在但无 setData：回退为 addSource（MapLibre 对重复 id 会忽略/覆盖，\n *   不抛错，仍可达成渲染目标）。\n * - 若 source 不存在且具备 addSource：addSource 创建。\n *\n * 注意：若传入对象既无 setData 又无 addSource，则无法创建/更新 source。\n * 各 System 传入的 `this.map.instance` 为真实 MapLibre 实例，始终具备这些方法。\n *\n * @param mlMap 原生 MapLibre 实例（或任意满足 MlMapSourceApi 的对象）\n * @param id    source 唯一标识\n * @param data  GeoJSON 数据（或 addSource 所需的 source spec）\n */\nexport function upsertSource(\n  mlMap: MlMapSourceApi,\n  id: string,\n  data: unknown,\n): void {\n  if (mlMap.getSource(id)) {\n    if (mlMap.setData) {\n      mlMap.setData(id, data);\n    } else if (mlMap.addSource) {\n      // 无 setData 时回退为 addSource：MapLibre 对同名 source 会忽略重复创建。\n      mlMap.addSource(id, data);\n    }\n  } else if (mlMap.addSource) {\n    mlMap.addSource(id, data);\n  }\n}\n\n/**\n * 安全地移除 source：仅当存在且具备 removeSource 时才移除，避免不存在时抛错。\n *\n * @param mlMap 原生 MapLibre 实例\n * @param id    source 唯一标识\n */\nexport function removeSourceSafe(mlMap: MlMapSourceApi, id: string): void {\n  if (mlMap.getSource(id) && mlMap.removeSource) {\n    mlMap.removeSource(id);\n  }\n}\n\n/**\n * 安全地批量移除 source。\n *\n * @param mlMap 原生 MapLibre 实例\n * @param ids   source 标识数组\n */\nexport function removeSourcesSafe(mlMap: MlMapSourceApi, ids: string[]): void {\n  for (const id of ids) {\n    removeSourceSafe(mlMap, id);\n  }\n}\n"]}

package/dist/sourceUtils.d.cts

@@ -0,0 +1,60 @@
+/**
+ * 原生 MapLibre 地图 source 操作的幂等工具。
+ *
+ * 各业务 System（grid/water/pipeline/telecom/compute/transport）的 render()
+ * 通过 `this.map.instance` 直接调用原生 MapLibre，而非经 CaoguoMap 包装类的
+ * 幂等 addSource。为避免在每个 System 内重复书写 `if (!mlMap.getSource(id))`
+ * 样板，并根治「层级切换重渲染崩溃」（Source already exists），统一在此提供
+ * 幂等 upsert 与安全的 removeSource。
+ *
+ * 仅依赖原生 MapLibre 的 source 子集接口，便于各 System 直接传入 instance。
+ */
+/**
+ * 原生 MapLibre source 操作的子集接口。
+ *
+ * 仅 `getSource` 为必填——它是所有 helper 判断「source 是否存在」的统一探针。
+ * 其余方法全部可选，因为各业务 System 对 `this.map.instance` 的局部类型断言
+ * 只声明了实际用到的若干方法（如 topology 只取 getSource/removeSource，
+ * traffic 只取 addSource/addLayer），强制统一必填字段会与这些子集冲突。
+ * helper 内部对每个要调用的方法做存在性检查，缺失时安全跳过或回退，
+ * 保证类型与运行时都安全（真实 MapLibre 实例始终具备全部方法）。
+ */
+interface MlMapSourceApi {
+    getSource: (id: string) => unknown;
+    addSource?: (id: string, source: unknown) => void;
+    addLayer?: (layer: unknown) => void;
+    setData?: (id: string, data: unknown) => void;
+    removeSource?: (id: string) => void;
+}
+/**
+ * 幂等地确保一个 GeoJSON source 存在并持有给定数据。
+ *
+ * - 若 source 已存在且具备 setData：setData 更新（避免重复 addSource 抛错）。
+ * - 若 source 已存在但无 setData：回退为 addSource（MapLibre 对重复 id 会忽略/覆盖，
+ *   不抛错，仍可达成渲染目标）。
+ * - 若 source 不存在且具备 addSource：addSource 创建。
+ *
+ * 注意：若传入对象既无 setData 又无 addSource，则无法创建/更新 source。
+ * 各 System 传入的 `this.map.instance` 为真实 MapLibre 实例，始终具备这些方法。
+ *
+ * @param mlMap 原生 MapLibre 实例（或任意满足 MlMapSourceApi 的对象）
+ * @param id    source 唯一标识
+ * @param data  GeoJSON 数据（或 addSource 所需的 source spec）
+ */
+declare function upsertSource(mlMap: MlMapSourceApi, id: string, data: unknown): void;
+/**
+ * 安全地移除 source：仅当存在且具备 removeSource 时才移除，避免不存在时抛错。
+ *
+ * @param mlMap 原生 MapLibre 实例
+ * @param id    source 唯一标识
+ */
+declare function removeSourceSafe(mlMap: MlMapSourceApi, id: string): void;
+/**
+ * 安全地批量移除 source。
+ *
+ * @param mlMap 原生 MapLibre 实例
+ * @param ids   source 标识数组
+ */
+declare function removeSourcesSafe(mlMap: MlMapSourceApi, ids: string[]): void;
+
+export { type MlMapSourceApi, removeSourceSafe, removeSourcesSafe, upsertSource };