@caoguo/maplibre 0.0.6 → 0.0.7

package/dist/sourceUtils.d.ts

@@ -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 };

package/dist/sourceUtils.js

@@ -0,0 +1,3 @@
+export { removeSourceSafe, removeSourcesSafe, upsertSource } from './chunk-OUEPE6JT.js';
+//# sourceMappingURL=sourceUtils.js.map
+//# sourceMappingURL=sourceUtils.js.map

package/dist/sourceUtils.js.map

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

package/dist/styles.cjs

@@ -8,20 +8,18 @@ var WUHAN_ZOOM = 11;
 function caoguoStyle(theme$1 = "caoguo-dark") {
   return theme.buildStyle(theme$1);
 }
-function osmRasterStyle() {
+function geoqRasterStyle() {
   return {
     version: 8,
     glyphs: "https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf",
     sources: {
-      "osm-raster": {
+      "geoq-raster": {
         type: "raster",
         tiles: [
-          "https://a.tile.openstreetmap.org/{z}/{x}/{y}.png",
-          "https://b.tile.openstreetmap.org/{z}/{x}/{y}.png",
-          "https://c.tile.openstreetmap.org/{z}/{x}/{y}.png"
+          "https://map.geoq.cn/arcgis/rest/services/ChinaOnlineStreetPurplishBlue/MapServer/tile/{z}/{y}/{x}"
         ],
         tileSize: 256,
-        attribution: "\xA9 OpenStreetMap contributors"
+        attribution: "\xA9 GeoQ \u667A\u56FE"
       }
     },
     layers: [
@@ -31,23 +29,60 @@ function osmRasterStyle() {
         paint: { "background-color": "#0a0f1e" }
       },
       {
-        id: "osm-raster",
+        id: "geoq-raster",
         type: "raster",
-        source: "osm-raster",
+        source: "geoq-raster",
         paint: {
-          "raster-opacity": 0.85,
-          "raster-saturation": -0.6,
-          "raster-brightness-max": 0.7,
-          "raster-contrast": 0.1
+          "raster-opacity": 0.9,
+          "raster-saturation": -0.2,
+          "raster-contrast": 0.05
         }
       }
     ]
   };
 }
+var osmRasterStyle = geoqRasterStyle;
+function buildGraticule(step = 10) {
+  const features = [];
+  for (let lon = -180; lon <= 180; lon += step) {
+    features.push({
+      type: "Feature",
+      properties: { kind: "meridian" },
+      geometry: { type: "LineString", coordinates: [[lon, -85], [lon, 85]] }
+    });
+  }
+  for (let lat = -80; lat <= 80; lat += step) {
+    features.push({
+      type: "Feature",
+      properties: { kind: "parallel" },
+      geometry: { type: "LineString", coordinates: [[-180, lat], [180, lat]] }
+    });
+  }
+  return { type: "FeatureCollection", features };
+}
+function localBasemapStyle() {
+  return {
+    version: 8,
+    sources: {
+      graticule: { type: "geojson", data: buildGraticule() }
+    },
+    layers: [
+      { id: "bg", type: "background", paint: { "background-color": "#0a0f1e" } },
+      {
+        id: "graticule",
+        type: "line",
+        source: "graticule",
+        paint: { "line-color": "#1e293b", "line-width": 0.6, "line-opacity": 0.6 }
+      }
+    ]
+  };
+}
 
 exports.WUHAN_CENTER = WUHAN_CENTER;
 exports.WUHAN_ZOOM = WUHAN_ZOOM;
 exports.caoguoStyle = caoguoStyle;
+exports.geoqRasterStyle = geoqRasterStyle;
+exports.localBasemapStyle = localBasemapStyle;
 exports.osmRasterStyle = osmRasterStyle;
 //# sourceMappingURL=styles.cjs.map
 //# sourceMappingURL=styles.cjs.map

package/dist/styles.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/styles.ts"],"names":["theme","buildStyle"],"mappings":";;;;;AAWO,IAAM,YAAA,GAAiC,CAAC,QAAA,EAAU,OAAO;AACzD,IAAM,UAAA,GAAa;AAGnB,SAAS,WAAA,CAAYA,UAAmB,aAAA,EAAmC;AAChF,EAAA,OAAOC,iBAAWD,OAAK,CAAA;AACzB;AAGO,SAAS,cAAA,GAAqC;AACnD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,6DAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,YAAA,EAAc;AAAA,QACZ,IAAA,EAAM,QAAA;AAAA,QACN,KAAA,EAAO;AAAA,UACL,kDAAA;AAAA,UACA,kDAAA;AAAA,UACA;AAAA,SACF;AAAA,QACA,QAAA,EAAU,GAAA;AAAA,QACV,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,EAAA,EAAI,YAAA;AAAA,QACJ,IAAA,EAAM,YAAA;AAAA,QACN,KAAA,EAAO,EAAE,kBAAA,EAAoB,SAAA;AAAU,OACzC;AAAA,MACA;AAAA,QACE,EAAA,EAAI,YAAA;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,MAAA,EAAQ,YAAA;AAAA,QACR,KAAA,EAAO;AAAA,UACL,gBAAA,EAAkB,IAAA;AAAA,UAClB,mBAAA,EAAqB,IAAA;AAAA,UACrB,uBAAA,EAAyB,GAAA;AAAA,UACzB,iBAAA,EAAmB;AAAA;AACrB;AACF;AACF,GACF;AACF","file":"styles.cjs","sourcesContent":["/**\n * 草果地图内置样式。\n *\n * - `caoguoStyle()`：官方矢量主题（caoguo-dark / caoguo-light），\n *   由 @caoguo/theme 生成，底层使用 MapLibre 免费 demo 矢量瓦片，无需 token。\n * - `osmRasterStyle()`：OSM 栅格兜底样式，矢量主题加载失败时使用。\n */\n\nimport type { StyleSpecification } from 'maplibre-gl';\nimport { buildStyle, type ThemeName } from '@caoguo/theme';\n\nexport const WUHAN_CENTER: [number, number] = [114.3055, 30.5928];\nexport const WUHAN_ZOOM = 11;\n\n/** 草果官方矢量主题（默认暗色）。 */\nexport function caoguoStyle(theme: ThemeName = 'caoguo-dark'): StyleSpecification {\n  return buildStyle(theme);\n}\n\n/** 暗色 OSM 栅格兜底底图（无需 key）。 */\nexport function osmRasterStyle(): StyleSpecification {\n  return {\n    version: 8,\n    glyphs: 'https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf',\n    sources: {\n      'osm-raster': {\n        type: 'raster',\n        tiles: [\n          'https://a.tile.openstreetmap.org/{z}/{x}/{y}.png',\n          'https://b.tile.openstreetmap.org/{z}/{x}/{y}.png',\n          'https://c.tile.openstreetmap.org/{z}/{x}/{y}.png',\n        ],\n        tileSize: 256,\n        attribution: '© OpenStreetMap contributors',\n      },\n    },\n    layers: [\n      {\n        id: 'background',\n        type: 'background',\n        paint: { 'background-color': '#0a0f1e' },\n      },\n      {\n        id: 'osm-raster',\n        type: 'raster',\n        source: 'osm-raster',\n        paint: {\n          'raster-opacity': 0.85,\n          'raster-saturation': -0.6,\n          'raster-brightness-max': 0.7,\n          'raster-contrast': 0.1,\n        },\n      },\n    ],\n  };\n}\n"]}
+{"version":3,"sources":["../src/styles.ts"],"names":["theme","buildStyle"],"mappings":";;;;;AAYO,IAAM,YAAA,GAAiC,CAAC,QAAA,EAAU,OAAO;AACzD,IAAM,UAAA,GAAa;AAGnB,SAAS,WAAA,CAAYA,UAAmB,aAAA,EAAmC;AAChF,EAAA,OAAOC,iBAAWD,OAAK,CAAA;AACzB;AAQO,SAAS,eAAA,GAAsC;AACpD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,6DAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,aAAA,EAAe;AAAA,QACb,IAAA,EAAM,QAAA;AAAA,QACN,KAAA,EAAO;AAAA,UACL;AAAA,SACF;AAAA,QACA,QAAA,EAAU,GAAA;AAAA,QACV,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,EAAA,EAAI,YAAA;AAAA,QACJ,IAAA,EAAM,YAAA;AAAA,QACN,KAAA,EAAO,EAAE,kBAAA,EAAoB,SAAA;AAAU,OACzC;AAAA,MACA;AAAA,QACE,EAAA,EAAI,aAAA;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,MAAA,EAAQ,aAAA;AAAA,QACR,KAAA,EAAO;AAAA,UACL,gBAAA,EAAkB,GAAA;AAAA,UAClB,mBAAA,EAAqB,IAAA;AAAA,UACrB,iBAAA,EAAmB;AAAA;AACrB;AACF;AACF,GACF;AACF;AAGO,IAAM,cAAA,GAAiB;AAQ9B,SAAS,cAAA,CAAe,OAAO,EAAA,EAA+B;AAC5D,EAAA,MAAM,WAA8B,EAAC;AACrC,EAAA,KAAA,IAAS,GAAA,GAAM,IAAA,EAAM,GAAA,IAAO,GAAA,EAAK,OAAO,IAAA,EAAM;AAC5C,IAAA,QAAA,CAAS,IAAA,CAAK;AAAA,MACZ,IAAA,EAAM,SAAA;AAAA,MACN,UAAA,EAAY,EAAE,IAAA,EAAM,UAAA,EAAW;AAAA,MAC/B,QAAA,EAAU,EAAE,IAAA,EAAM,YAAA,EAAc,aAAa,CAAC,CAAC,GAAA,EAAK,GAAG,CAAA,EAAG,CAAC,GAAA,EAAK,EAAE,CAAC,CAAA;AAAE,KACtE,CAAA;AAAA,EACH;AACA,EAAA,KAAA,IAAS,GAAA,GAAM,GAAA,EAAK,GAAA,IAAO,EAAA,EAAI,OAAO,IAAA,EAAM;AAC1C,IAAA,QAAA,CAAS,IAAA,CAAK;AAAA,MACZ,IAAA,EAAM,SAAA;AAAA,MACN,UAAA,EAAY,EAAE,IAAA,EAAM,UAAA,EAAW;AAAA,MAC/B,QAAA,EAAU,EAAE,IAAA,EAAM,YAAA,EAAc,aAAa,CAAC,CAAC,IAAA,EAAM,GAAG,CAAA,EAAG,CAAC,GAAA,EAAK,GAAG,CAAC,CAAA;AAAE,KACxE,CAAA;AAAA,EACH;AACA,EAAA,OAAO,EAAE,IAAA,EAAM,mBAAA,EAAqB,QAAA,EAAS;AAC/C;AAEO,SAAS,iBAAA,GAAwC;AACtD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,OAAA,EAAS;AAAA,MACP,WAAW,EAAE,IAAA,EAAM,SAAA,EAAW,IAAA,EAAM,gBAAe;AAAE,KACvD;AAAA,IACA,MAAA,EAAQ;AAAA,MACN,EAAE,IAAI,IAAA,EAAM,IAAA,EAAM,cAAc,KAAA,EAAO,EAAE,kBAAA,EAAoB,SAAA,EAAU,EAAE;AAAA,MACzE;AAAA,QACE,EAAA,EAAI,WAAA;AAAA,QACJ,IAAA,EAAM,MAAA;AAAA,QACN,MAAA,EAAQ,WAAA;AAAA,QACR,OAAO,EAAE,YAAA,EAAc,WAAW,YAAA,EAAc,GAAA,EAAK,gBAAgB,GAAA;AAAI;AAC3E;AACF,GACF;AACF","file":"styles.cjs","sourcesContent":["/**\n * 草果地图内置样式。\n *\n * - `caoguoStyle()`：官方矢量主题（caoguo-dark / caoguo-light），\n *   由 @caoguo/theme 生成，底层使用 MapLibre 免费 demo 矢量瓦片，无需 token。\n * - `geoqRasterStyle()` / `osmRasterStyle()`：国内可达的栅格兜底底图\n *   （智图 GeoQ 公共服务，免 key，适配国内网络）。`osmRasterStyle` 保留为别名。\n */\n\nimport type { StyleSpecification } from 'maplibre-gl';\nimport { buildStyle, type ThemeName } from '@caoguo/theme';\n\nexport const WUHAN_CENTER: [number, number] = [114.3055, 30.5928];\nexport const WUHAN_ZOOM = 11;\n\n/** 草果官方矢量主题（默认暗色）。 */\nexport function caoguoStyle(theme: ThemeName = 'caoguo-dark'): StyleSpecification {\n  return buildStyle(theme);\n}\n\n/**\n * 国内可达的栅格兜底底图（智图 GeoQ 公共服务，免 key）。\n * 使用 ChinaOnlineStreetPurplishBlue（蓝紫街道，贴合暗色演示主题）。\n * 替代原 OSM 兜底：OSM 在国内网络普遍不可达，导致部署在国内访问的\n * 演示中心底图空白。GeoQ 为 Esri 中国公共服务，长期稳定免 key。\n */\nexport function geoqRasterStyle(): StyleSpecification {\n  return {\n    version: 8,\n    glyphs: 'https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf',\n    sources: {\n      'geoq-raster': {\n        type: 'raster',\n        tiles: [\n          'https://map.geoq.cn/arcgis/rest/services/ChinaOnlineStreetPurplishBlue/MapServer/tile/{z}/{y}/{x}',\n        ],\n        tileSize: 256,\n        attribution: '© GeoQ 智图',\n      },\n    },\n    layers: [\n      {\n        id: 'background',\n        type: 'background',\n        paint: { 'background-color': '#0a0f1e' },\n      },\n      {\n        id: 'geoq-raster',\n        type: 'raster',\n        source: 'geoq-raster',\n        paint: {\n          'raster-opacity': 0.9,\n          'raster-saturation': -0.2,\n          'raster-contrast': 0.05,\n        },\n      },\n    ],\n  };\n}\n\n/** 兼容别名：国内可达栅格兜底底图。 */\nexport const osmRasterStyle = geoqRasterStyle;\n\n/**\n * 纯本地底图（零外部依赖，完全离线）。\n * 暗色背景 + 全球经纬网，无需任何在线瓦片 / 字体服务。\n * 用于：国内网络无法访问 OSM / GeoQ 等境外或受限瓦片源时，\n * 保证演示中心地图永远可渲染（业务图层为自有 GeoJSON，叠加其上即可见）。\n */\nfunction buildGraticule(step = 10): GeoJSON.FeatureCollection {\n  const features: GeoJSON.Feature[] = [];\n  for (let lon = -180; lon <= 180; lon += step) {\n    features.push({\n      type: 'Feature',\n      properties: { kind: 'meridian' },\n      geometry: { type: 'LineString', coordinates: [[lon, -85], [lon, 85]] },\n    });\n  }\n  for (let lat = -80; lat <= 80; lat += step) {\n    features.push({\n      type: 'Feature',\n      properties: { kind: 'parallel' },\n      geometry: { type: 'LineString', coordinates: [[-180, lat], [180, lat]] },\n    });\n  }\n  return { type: 'FeatureCollection', features };\n}\n\nexport function localBasemapStyle(): StyleSpecification {\n  return {\n    version: 8,\n    sources: {\n      graticule: { type: 'geojson', data: buildGraticule() },\n    },\n    layers: [\n      { id: 'bg', type: 'background', paint: { 'background-color': '#0a0f1e' } },\n      {\n        id: 'graticule',\n        type: 'line',\n        source: 'graticule',\n        paint: { 'line-color': '#1e293b', 'line-width': 0.6, 'line-opacity': 0.6 },\n      },\n    ],\n  };\n}\n\n\n"]}

package/dist/styles.d.cts

@@ -6,14 +6,23 @@ import { ThemeName } from '@caoguo/theme';
  *
  * - `caoguoStyle()`：官方矢量主题（caoguo-dark / caoguo-light），
  *   由 @caoguo/theme 生成，底层使用 MapLibre 免费 demo 矢量瓦片，无需 token。
- * - `osmRasterStyle()`：OSM 栅格兜底样式，矢量主题加载失败时使用。
+ * - `geoqRasterStyle()` / `osmRasterStyle()`：国内可达的栅格兜底底图
+ *   （智图 GeoQ 公共服务，免 key，适配国内网络）。`osmRasterStyle` 保留为别名。
  */
 
 declare const WUHAN_CENTER: [number, number];
 declare const WUHAN_ZOOM = 11;
 /** 草果官方矢量主题（默认暗色）。 */
 declare function caoguoStyle(theme?: ThemeName): StyleSpecification;
-/** 暗色 OSM 栅格兜底底图（无需 key）。 */
-declare function osmRasterStyle(): StyleSpecification;
+/**
+ * 国内可达的栅格兜底底图（智图 GeoQ 公共服务，免 key）。
+ * 使用 ChinaOnlineStreetPurplishBlue（蓝紫街道，贴合暗色演示主题）。
+ * 替代原 OSM 兜底：OSM 在国内网络普遍不可达，导致部署在国内访问的
+ * 演示中心底图空白。GeoQ 为 Esri 中国公共服务，长期稳定免 key。
+ */
+declare function geoqRasterStyle(): StyleSpecification;
+/** 兼容别名：国内可达栅格兜底底图。 */
+declare const osmRasterStyle: typeof geoqRasterStyle;
+declare function localBasemapStyle(): StyleSpecification;
 
-export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, osmRasterStyle };
+export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, geoqRasterStyle, localBasemapStyle, osmRasterStyle };

package/dist/styles.d.ts

@@ -6,14 +6,23 @@ import { ThemeName } from '@caoguo/theme';
  *
  * - `caoguoStyle()`：官方矢量主题（caoguo-dark / caoguo-light），
  *   由 @caoguo/theme 生成，底层使用 MapLibre 免费 demo 矢量瓦片，无需 token。
- * - `osmRasterStyle()`：OSM 栅格兜底样式，矢量主题加载失败时使用。
+ * - `geoqRasterStyle()` / `osmRasterStyle()`：国内可达的栅格兜底底图
+ *   （智图 GeoQ 公共服务，免 key，适配国内网络）。`osmRasterStyle` 保留为别名。
  */
 
 declare const WUHAN_CENTER: [number, number];
 declare const WUHAN_ZOOM = 11;
 /** 草果官方矢量主题（默认暗色）。 */
 declare function caoguoStyle(theme?: ThemeName): StyleSpecification;
-/** 暗色 OSM 栅格兜底底图（无需 key）。 */
-declare function osmRasterStyle(): StyleSpecification;
+/**
+ * 国内可达的栅格兜底底图（智图 GeoQ 公共服务，免 key）。
+ * 使用 ChinaOnlineStreetPurplishBlue（蓝紫街道，贴合暗色演示主题）。
+ * 替代原 OSM 兜底：OSM 在国内网络普遍不可达，导致部署在国内访问的
+ * 演示中心底图空白。GeoQ 为 Esri 中国公共服务，长期稳定免 key。
+ */
+declare function geoqRasterStyle(): StyleSpecification;
+/** 兼容别名：国内可达栅格兜底底图。 */
+declare const osmRasterStyle: typeof geoqRasterStyle;
+declare function localBasemapStyle(): StyleSpecification;
 
-export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, osmRasterStyle };
+export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, geoqRasterStyle, localBasemapStyle, osmRasterStyle };

package/dist/styles.js

@@ -1,3 +1,3 @@
-export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, osmRasterStyle } from './chunk-DNEF4DHG.js';
+export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, geoqRasterStyle, localBasemapStyle, osmRasterStyle } from './chunk-DENQSIV2.js';
 //# sourceMappingURL=styles.js.map
 //# sourceMappingURL=styles.js.map

package/dist/terrain.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+// src/terrain.ts
+var DEFAULT_TERRAIN_TILES = [
+  "https://elevation-tiles-prod.s3.amazonaws.com/terrarium/{z}/{x}/{y}.png"
+];
+function applyTerrain(mlMap, opts = {}) {
+  const sourceId = opts.sourceId ?? "cg-dem";
+  if (!mlMap.getSource(sourceId)) {
+    mlMap.addSource(sourceId, {
+      type: "raster-dem",
+      tiles: opts.tiles ?? DEFAULT_TERRAIN_TILES,
+      encoding: opts.encoding ?? "terrarium",
+      tileSize: 256,
+      maxzoom: opts.maxzoom ?? 15
+    });
+  }
+  mlMap.setTerrain({ source: sourceId, exaggeration: opts.exaggeration ?? 1.5 });
+}
+function removeTerrain(mlMap, sourceId = "cg-dem") {
+  mlMap.setTerrain(null);
+  if (mlMap.getSource(sourceId)) {
+    mlMap.removeSource(sourceId);
+  }
+}
+
+exports.DEFAULT_TERRAIN_TILES = DEFAULT_TERRAIN_TILES;
+exports.applyTerrain = applyTerrain;
+exports.removeTerrain = removeTerrain;
+//# sourceMappingURL=terrain.cjs.map
+//# sourceMappingURL=terrain.cjs.map

package/dist/terrain.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/terrain.ts"],"names":[],"mappings":";;;AAsBO,IAAM,qBAAA,GAAwB;AAAA,EACnC;AACF;AAGO,SAAS,YAAA,CAAa,KAAA,EAAc,IAAA,GAAuB,EAAC,EAAS;AAC1E,EAAA,MAAM,QAAA,GAAW,KAAK,QAAA,IAAY,QAAA;AAClC,EAAA,IAAI,CAAC,KAAA,CAAM,SAAA,CAAU,QAAQ,CAAA,EAAG;AAC9B,IAAA,KAAA,CAAM,UAAU,QAAA,EAAU;AAAA,MACxB,IAAA,EAAM,YAAA;AAAA,MACN,KAAA,EAAO,KAAK,KAAA,IAAS,qBAAA;AAAA,MACrB,QAAA,EAAU,KAAK,QAAA,IAAY,WAAA;AAAA,MAC3B,QAAA,EAAU,GAAA;AAAA,MACV,OAAA,EAAS,KAAK,OAAA,IAAW;AAAA,KACjB,CAAA;AAAA,EACZ;AACA,EAAA,KAAA,CAAM,UAAA,CAAW,EAAE,MAAA,EAAQ,QAAA,EAAU,cAAc,IAAA,CAAK,YAAA,IAAgB,KAAc,CAAA;AACxF;AAGO,SAAS,aAAA,CAAc,KAAA,EAAc,QAAA,GAAW,QAAA,EAAgB;AACrE,EAAA,KAAA,CAAM,WAAW,IAAI,CAAA;AACrB,EAAA,IAAI,KAAA,CAAM,SAAA,CAAU,QAAQ,CAAA,EAAG;AAC7B,IAAA,KAAA,CAAM,aAAa,QAAQ,CAAA;AAAA,EAC7B;AACF","file":"terrain.cjs","sourcesContent":["/**\n * 3D 地形渲染（F-1.5）\n *\n * 注入 raster-dem 高程源并调用 maplibre-gl 原生 `setTerrain`，使地图呈现地形起伏。\n * DEM 瓦片默认使用公共 Terrarium 源（elevation-tiles-prod，Terrain-RGB 编码，支持 CORS），\n * 可在 opts.tiles 覆盖为私有瓦片服务（如 MinIO / 本地 MBTiles 服务）。\n */\n\nimport type { Map as MlMap } from 'maplibre-gl';\n\nexport interface TerrainOptions {\n  /** DEM source id（默认 cg-dem） */\n  sourceId?: string;\n  /** DEM 瓦片模板，{z}/{x}/{y} 占位 */\n  tiles?: string[];\n  encoding?: 'terrarium' | 'mapbox';\n  /** 地形夸张系数（默认 1.5） */\n  exaggeration?: number;\n  maxzoom?: number;\n}\n\n/** 默认 DEM 瓦片源（Mapzen Terrarium，Terrain-RGB，支持 CORS，无需鉴权） */\nexport const DEFAULT_TERRAIN_TILES = [\n  'https://elevation-tiles-prod.s3.amazonaws.com/terrarium/{z}/{x}/{y}.png',\n];\n\n/** 在原生 MapLibre 实例上启用地形（纯函数，便于单测） */\nexport function applyTerrain(mlMap: MlMap, opts: TerrainOptions = {}): void {\n  const sourceId = opts.sourceId ?? 'cg-dem';\n  if (!mlMap.getSource(sourceId)) {\n    mlMap.addSource(sourceId, {\n      type: 'raster-dem',\n      tiles: opts.tiles ?? DEFAULT_TERRAIN_TILES,\n      encoding: opts.encoding ?? 'terrarium',\n      tileSize: 256,\n      maxzoom: opts.maxzoom ?? 15,\n    } as never);\n  }\n  mlMap.setTerrain({ source: sourceId, exaggeration: opts.exaggeration ?? 1.5 } as never);\n}\n\n/** 关闭地形（纯函数），移除 DEM 源 */\nexport function removeTerrain(mlMap: MlMap, sourceId = 'cg-dem'): void {\n  mlMap.setTerrain(null);\n  if (mlMap.getSource(sourceId)) {\n    mlMap.removeSource(sourceId);\n  }\n}\n"]}

package/dist/terrain.d.cts

@@ -0,0 +1,28 @@
+import { Map } from 'maplibre-gl';
+
+/**
+ * 3D 地形渲染（F-1.5）
+ *
+ * 注入 raster-dem 高程源并调用 maplibre-gl 原生 `setTerrain`，使地图呈现地形起伏。
+ * DEM 瓦片默认使用公共 Terrarium 源（elevation-tiles-prod，Terrain-RGB 编码，支持 CORS），
+ * 可在 opts.tiles 覆盖为私有瓦片服务（如 MinIO / 本地 MBTiles 服务）。
+ */
+
+interface TerrainOptions {
+    /** DEM source id（默认 cg-dem） */
+    sourceId?: string;
+    /** DEM 瓦片模板，{z}/{x}/{y} 占位 */
+    tiles?: string[];
+    encoding?: 'terrarium' | 'mapbox';
+    /** 地形夸张系数（默认 1.5） */
+    exaggeration?: number;
+    maxzoom?: number;
+}
+/** 默认 DEM 瓦片源（Mapzen Terrarium，Terrain-RGB，支持 CORS，无需鉴权） */
+declare const DEFAULT_TERRAIN_TILES: string[];
+/** 在原生 MapLibre 实例上启用地形（纯函数，便于单测） */
+declare function applyTerrain(mlMap: Map, opts?: TerrainOptions): void;
+/** 关闭地形（纯函数），移除 DEM 源 */
+declare function removeTerrain(mlMap: Map, sourceId?: string): void;
+
+export { DEFAULT_TERRAIN_TILES, type TerrainOptions, applyTerrain, removeTerrain };

package/dist/terrain.d.ts

@@ -0,0 +1,28 @@
+import { Map } from 'maplibre-gl';
+
+/**
+ * 3D 地形渲染（F-1.5）
+ *
+ * 注入 raster-dem 高程源并调用 maplibre-gl 原生 `setTerrain`，使地图呈现地形起伏。
+ * DEM 瓦片默认使用公共 Terrarium 源（elevation-tiles-prod，Terrain-RGB 编码，支持 CORS），
+ * 可在 opts.tiles 覆盖为私有瓦片服务（如 MinIO / 本地 MBTiles 服务）。
+ */
+
+interface TerrainOptions {
+    /** DEM source id（默认 cg-dem） */
+    sourceId?: string;
+    /** DEM 瓦片模板，{z}/{x}/{y} 占位 */
+    tiles?: string[];
+    encoding?: 'terrarium' | 'mapbox';
+    /** 地形夸张系数（默认 1.5） */
+    exaggeration?: number;
+    maxzoom?: number;
+}
+/** 默认 DEM 瓦片源（Mapzen Terrarium，Terrain-RGB，支持 CORS，无需鉴权） */
+declare const DEFAULT_TERRAIN_TILES: string[];
+/** 在原生 MapLibre 实例上启用地形（纯函数，便于单测） */
+declare function applyTerrain(mlMap: Map, opts?: TerrainOptions): void;
+/** 关闭地形（纯函数），移除 DEM 源 */
+declare function removeTerrain(mlMap: Map, sourceId?: string): void;
+
+export { DEFAULT_TERRAIN_TILES, type TerrainOptions, applyTerrain, removeTerrain };

package/dist/terrain.js

@@ -0,0 +1,3 @@
+export { DEFAULT_TERRAIN_TILES, applyTerrain, removeTerrain } from './chunk-OLS4DD3F.js';
+//# sourceMappingURL=terrain.js.map
+//# sourceMappingURL=terrain.js.map

package/dist/terrain.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@caoguo/maplibre",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "草果地图引擎核心 — 基于 MapLibre GL 的国内坐标系/离线瓦片/辉光/LOD 一体化封装",
   "license": "Apache-2.0",
   "author": "caoguo <caoguo@hb.cn>",
@@ -56,6 +56,36 @@
       "types": "./dist/offline/index.d.ts",
       "import": "./dist/offline/index.js",
       "require": "./dist/offline/index.cjs"
+    },
+    "./controls": {
+      "types": "./dist/controls/index.d.ts",
+      "import": "./dist/controls/index.js",
+      "require": "./dist/controls/index.cjs"
+    },
+    "./crs": {
+      "types": "./dist/crs/index.d.ts",
+      "import": "./dist/crs/index.js",
+      "require": "./dist/crs/index.cjs"
+    },
+    "./lod": {
+      "types": "./dist/lod/index.d.ts",
+      "import": "./dist/lod/index.js",
+      "require": "./dist/lod/index.cjs"
+    },
+    "./shaders": {
+      "types": "./dist/shaders/index.d.ts",
+      "import": "./dist/shaders/index.js",
+      "require": "./dist/shaders/index.cjs"
+    },
+    "./terrain": {
+      "types": "./dist/terrain.d.ts",
+      "import": "./dist/terrain.js",
+      "require": "./dist/terrain.cjs"
+    },
+    "./sourceUtils": {
+      "types": "./dist/sourceUtils.d.ts",
+      "import": "./dist/sourceUtils.js",
+      "require": "./dist/sourceUtils.cjs"
     }
   },
   "files": [

package/dist/chunk-DNEF4DHG.js

@@ -1,48 +0,0 @@
-import { buildStyle } from '@caoguo/theme';
-
-// src/styles.ts
-var WUHAN_CENTER = [114.3055, 30.5928];
-var WUHAN_ZOOM = 11;
-function caoguoStyle(theme = "caoguo-dark") {
-  return buildStyle(theme);
-}
-function osmRasterStyle() {
-  return {
-    version: 8,
-    glyphs: "https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf",
-    sources: {
-      "osm-raster": {
-        type: "raster",
-        tiles: [
-          "https://a.tile.openstreetmap.org/{z}/{x}/{y}.png",
-          "https://b.tile.openstreetmap.org/{z}/{x}/{y}.png",
-          "https://c.tile.openstreetmap.org/{z}/{x}/{y}.png"
-        ],
-        tileSize: 256,
-        attribution: "\xA9 OpenStreetMap contributors"
-      }
-    },
-    layers: [
-      {
-        id: "background",
-        type: "background",
-        paint: { "background-color": "#0a0f1e" }
-      },
-      {
-        id: "osm-raster",
-        type: "raster",
-        source: "osm-raster",
-        paint: {
-          "raster-opacity": 0.85,
-          "raster-saturation": -0.6,
-          "raster-brightness-max": 0.7,
-          "raster-contrast": 0.1
-        }
-      }
-    ]
-  };
-}
-
-export { WUHAN_CENTER, WUHAN_ZOOM, caoguoStyle, osmRasterStyle };
-//# sourceMappingURL=chunk-DNEF4DHG.js.map
-//# sourceMappingURL=chunk-DNEF4DHG.js.map

package/dist/chunk-DNEF4DHG.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/styles.ts"],"names":[],"mappings":";;;AAWO,IAAM,YAAA,GAAiC,CAAC,QAAA,EAAU,OAAO;AACzD,IAAM,UAAA,GAAa;AAGnB,SAAS,WAAA,CAAY,QAAmB,aAAA,EAAmC;AAChF,EAAA,OAAO,WAAW,KAAK,CAAA;AACzB;AAGO,SAAS,cAAA,GAAqC;AACnD,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,CAAA;AAAA,IACT,MAAA,EAAQ,6DAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,YAAA,EAAc;AAAA,QACZ,IAAA,EAAM,QAAA;AAAA,QACN,KAAA,EAAO;AAAA,UACL,kDAAA;AAAA,UACA,kDAAA;AAAA,UACA;AAAA,SACF;AAAA,QACA,QAAA,EAAU,GAAA;AAAA,QACV,WAAA,EAAa;AAAA;AACf,KACF;AAAA,IACA,MAAA,EAAQ;AAAA,MACN;AAAA,QACE,EAAA,EAAI,YAAA;AAAA,QACJ,IAAA,EAAM,YAAA;AAAA,QACN,KAAA,EAAO,EAAE,kBAAA,EAAoB,SAAA;AAAU,OACzC;AAAA,MACA;AAAA,QACE,EAAA,EAAI,YAAA;AAAA,QACJ,IAAA,EAAM,QAAA;AAAA,QACN,MAAA,EAAQ,YAAA;AAAA,QACR,KAAA,EAAO;AAAA,UACL,gBAAA,EAAkB,IAAA;AAAA,UAClB,mBAAA,EAAqB,IAAA;AAAA,UACrB,uBAAA,EAAyB,GAAA;AAAA,UACzB,iBAAA,EAAmB;AAAA;AACrB;AACF;AACF,GACF;AACF","file":"chunk-DNEF4DHG.js","sourcesContent":["/**\n * 草果地图内置样式。\n *\n * - `caoguoStyle()`：官方矢量主题（caoguo-dark / caoguo-light），\n *   由 @caoguo/theme 生成，底层使用 MapLibre 免费 demo 矢量瓦片，无需 token。\n * - `osmRasterStyle()`：OSM 栅格兜底样式，矢量主题加载失败时使用。\n */\n\nimport type { StyleSpecification } from 'maplibre-gl';\nimport { buildStyle, type ThemeName } from '@caoguo/theme';\n\nexport const WUHAN_CENTER: [number, number] = [114.3055, 30.5928];\nexport const WUHAN_ZOOM = 11;\n\n/** 草果官方矢量主题（默认暗色）。 */\nexport function caoguoStyle(theme: ThemeName = 'caoguo-dark'): StyleSpecification {\n  return buildStyle(theme);\n}\n\n/** 暗色 OSM 栅格兜底底图（无需 key）。 */\nexport function osmRasterStyle(): StyleSpecification {\n  return {\n    version: 8,\n    glyphs: 'https://demotiles.maplibre.org/font/{fontstack}/{range}.pbf',\n    sources: {\n      'osm-raster': {\n        type: 'raster',\n        tiles: [\n          'https://a.tile.openstreetmap.org/{z}/{x}/{y}.png',\n          'https://b.tile.openstreetmap.org/{z}/{x}/{y}.png',\n          'https://c.tile.openstreetmap.org/{z}/{x}/{y}.png',\n        ],\n        tileSize: 256,\n        attribution: '© OpenStreetMap contributors',\n      },\n    },\n    layers: [\n      {\n        id: 'background',\n        type: 'background',\n        paint: { 'background-color': '#0a0f1e' },\n      },\n      {\n        id: 'osm-raster',\n        type: 'raster',\n        source: 'osm-raster',\n        paint: {\n          'raster-opacity': 0.85,\n          'raster-saturation': -0.6,\n          'raster-brightness-max': 0.7,\n          'raster-contrast': 0.1,\n        },\n      },\n    ],\n  };\n}\n"]}