@soonspacejs/plugin-tiles 2.14.28 → 2.14.30

package/dist/index.esm.js

@@ -1,47 +1,97 @@
-import c from "soonspacejs";
-import { TilesRenderer as g } from "3d-tiles-renderer";
-import { GLTFLoader as p } from "three/examples/jsm/loaders/GLTFLoader.js";
-import { MathUtils as h, MeshBasicMaterial as m } from "three";
-import { TilesFadePlugin as f, UpdateOnChangePlugin as v, QuantizedMeshPlugin as w, ImageOverlayPlugin as P, XYZTilesOverlay as T, ReorientationPlugin as C } from "3d-tiles-renderer/plugins";
-class L {
-  constructor(t) {
-    this.parser = t, this.name = "KHR_texture_basisu_patch";
-  }
-  loadTexture(t) {
-    const s = this.parser, i = s.json, r = i.textures[t].source, a = i.images[r];
-    if (!a || a.mimeType !== "image/ktx2")
+import _ from "soonspacejs";
+import { TilesRenderer as u } from "um-3d-tiles-renderer";
+import { GLTFLoader as C } from "three/examples/jsm/loaders/GLTFLoader.js";
+import { MathUtils as c, MeshBasicMaterial as R, Color as v, Box3 as I, Sphere as x, MeshStandardMaterial as N, ShaderMaterial as P } from "three";
+import { TilesFadePlugin as O, UpdateOnChangePlugin as T, QuantizedMeshPlugin as M, ImageOverlayPlugin as E, XYZTilesOverlay as b, ReorientationPlugin as w, GeoJSONOverlay as k, CesiumIonOverlay as U, TMSTilesOverlay as F, UrlTemplateTilesOverlay as A, WMSTilesOverlay as G, WMTSCapabilitiesLoader as D, WMTSTilesOverlay as W, CesiumIonAuthPlugin as L } from "um-3d-tiles-renderer/plugins";
+class Q {
+  constructor(e) {
+    this.parser = e, this.name = "KHR_texture_basisu_patch";
+  }
+  loadTexture(e) {
+    const t = this.parser, r = t.json, s = r.textures[e].source, l = r.images[s];
+    if (!l || l.mimeType !== "image/ktx2")
       return null;
-    const n = s.options.ktx2Loader;
-    if (!n)
-      throw new Error(`${c.utils.consoleSspTitle}请使用 setModelKtx2DecoderPath 设置 ktx2 解压库路径`);
-    return s.loadTextureImage(t, r, n);
+    const o = t.options.ktx2Loader;
+    if (!o)
+      throw new Error(`${_.utils.consoleSspTitle}请使用 setModelKtx2DecoderPath 设置 ktx2 解压库路径`);
+    return t.loadTextureImage(e, s, o);
   }
 }
-class M {
-  priority = -999;
-  processTileModel(t) {
-    t.traverse((s) => {
-      s.material && (s.material = new m());
+class se {
+  constructor(e) {
+    this.ssp = e;
+    const { controls: t, viewport: r } = e;
+    this._tilesCamera = r.camera, t.addEventListener("transitionstart", () => {
+      this.cameraTransitionStart = !0, r.state.useFreq = 1;
+    }), t.addEventListener("rest", () => {
+      this.cameraTransitionStart = !1, this.needsUpdate = !0, r.state.useFreq = 60;
+    }), e.signals.beforeRender.add(() => {
+      this.needsUpdate && (this.needsUpdate = !1, e.viewport.camera.updateMatrixWorld(), this.tilesMap.forEach((i) => {
+        i.group.updateMatrixWorld(), i.update();
+      }));
+    }), e.signals.cameraObjectChange.add(() => {
+      this.tilesMap.forEach((i) => {
+        i.deleteCamera(this._tilesCamera), i.setCamera(e.viewport.camera), i.setResolutionFromRenderer(e.viewport.camera, e.viewport.renderer);
+      }), this._tilesCamera = e.viewport.camera;
     });
   }
+  tilesMap = /* @__PURE__ */ new Map();
+  needsUpdate = !0;
+  cameraTransitionStart = !1;
+  _tilesCamera;
+  lruCache = null;
+  parseQueue = null;
+  downloadQueue = null;
+  async loadTiles(e) {
+    if (this.tilesMap.has(e)) {
+      _.utils.warn(`${e} already loaded`);
+      return;
+    }
+    const { ssp: t, ssp: { viewport: r } } = this, i = new u(e);
+    this.lruCache === null ? this.lruCache = i.lruCache : i.lruCache = this.lruCache, this.parseQueue === null ? this.parseQueue = i.parseQueue : i.parseQueue = this.parseQueue, this.downloadQueue === null ? this.downloadQueue = i.downloadQueue : i.downloadQueue = this.downloadQueue;
+    const s = new C(i.manager);
+    s.register((p) => new Q(p));
+    const { dracoLoader: l, ktx2Loader: o, meshoptDecoder: d } = t.manager.store.modelManager.gltfLoader;
+    l && s.setDRACOLoader(l), o && s.setKTX2Loader(o), d && s.setMeshoptDecoder(d), i.manager.addHandler(/\.gltf$/, s), this.tilesMap.set(e, i), i.setCamera(this._tilesCamera), i.setResolutionFromRenderer(this._tilesCamera, r.renderer), i.lruCache.maxSize = 600, i.lruCache.minSize = 300, i.lruCache.unloadPercent = 0.8, t.addObject(i.group);
+    const S = () => {
+      this.cameraTransitionStart || (this.needsUpdate = !0, t.render());
+    };
+    return i.addEventListener("load-model", S), new Promise((p) => {
+      i.addEventListener("load-tile-set", () => {
+        S(), p(i);
+      });
+    });
+  }
+  removeTiles(e) {
+    const t = this.tilesMap.get(e);
+    return t ? (t.dispose(), this.tilesMap.delete(e), this.ssp.removeObject(t.group), !0) : !1;
+  }
 }
-const R = "https://sooncps.xwbuilders.com/api/ugis-dataprocess/v1/terrain/NhBLlMx3/";
-class E {
-  constructor(t) {
-    this.ssp = t, this.tiles = new g(R), this.tiles.fetchData = async (s, i) => {
-      if (/layer\.json$/.test(s)) {
-        const e = await fetch(s, i).then((r) => r.json());
-        return e.metadataAvailability = -1, new Response(JSON.stringify(e));
+let j = class {
+  priority = -999;
+  processTileModel(e) {
+    e.traverse((t) => {
+      t.material && (t.material = new R());
+    });
+  }
+};
+const J = "https://sooncps.xwbuilders.com/api/ugis-dataprocess/v1/terrain/NhBLlMx3/";
+class ne {
+  constructor(e) {
+    this.ssp = e, this.tiles = new u(J), this.tiles.fetchData = async (t, r) => {
+      if (/layer\.json$/.test(t)) {
+        const i = await fetch(t, r).then((s) => s.json());
+        return i.metadataAvailability = -1, new Response(JSON.stringify(i));
       }
-      return fetch(s, i);
-    }, this.tilesFadePlugin = new f({ maximumFadeOutTiles: 200 }), this.updateOnChangePlugin = new v(), this.quantizedPlugin = new w({}), this.customMaterialPlugin = new M(), this.imageOverlayPlugin = new P({
-      renderer: t.viewport.renderer,
+      return fetch(t, r);
+    }, this.tilesFadePlugin = new O({ maximumFadeOutTiles: 200 }), this.updateOnChangePlugin = new T(), this.quantizedPlugin = new M({}), this.customMaterialPlugin = new j(), this.imageOverlayPlugin = new E({
+      renderer: e.viewport.renderer,
       overlays: [
-        new T({
+        new b({
           url: "https://server.arcgisonline.com/arcgis/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}"
         })
       ]
-    }), this.reorientationPlugin = new C({
+    }), this.reorientationPlugin = new w({
       lon: 120,
       lat: 30,
       height: 0.1
@@ -70,76 +120,1372 @@ class E {
   disable() {
     this.ssp.removeObject(this.tiles.group), this.ssp.signals.beforeRender.remove(this.beforeRenderHandler);
   }
-  invalidate(t, s, i) {
-    const e = () => {
-      const a = h.degToRad(s), n = h.degToRad(t);
+  invalidate(e, t, r) {
+    const i = () => {
+      const l = c.degToRad(t), o = c.degToRad(e);
       this.reorientationPlugin.transformLatLonHeightToOrigin(
-        a,
-        n,
-        i
-      ), this.ssp.render(), r();
-    }, r = () => {
-      this.tiles.removeEventListener("load-root-tileset", e), this.loedTilesSets.delete(e);
+        l,
+        o,
+        r
+      ), this.ssp.render(), s();
+    }, s = () => {
+      this.tiles.removeEventListener("load-root-tileset", i), this.loedTilesSets.delete(i);
     };
-    return this.tiles.addEventListener("load-root-tileset", e), this.loedTilesSets.add(e), this.tiles.root && e(), r;
+    return this.tiles.addEventListener("load-root-tileset", i), this.loedTilesSets.add(i), this.tiles.root && i(), s;
   }
   dispose() {
     this.disable(), this.loedTilesSets.forEach(
-      (t) => this.tiles.removeEventListener("load-root-tileset", t)
+      (e) => this.tiles.removeEventListener("load-root-tileset", e)
     ), this.loedTilesSets.clear(), this.tiles.removeEventListener("needs-render", this.render), this.tiles.removeEventListener("needs-update", this.render), this.tiles.dispose();
   }
 }
-class Q {
-  constructor(t) {
-    this.ssp = t;
-    const { controls: s, viewport: i } = t;
-    this._tilesCamera = i.camera, s.addEventListener("transitionstart", () => {
-      this.cameraTransitionStart = !0, i.state.useFreq = 1;
-    }), s.addEventListener("rest", () => {
-      this.cameraTransitionStart = !1, this.needsUpdate = !0, i.state.useFreq = 60;
-    }), t.signals.beforeRender.add(() => {
-      this.needsUpdate && (this.needsUpdate = !1, t.viewport.camera.updateMatrixWorld(), this.tilesMap.forEach((e) => {
-        e.group.updateMatrixWorld(), e.update();
-      }));
-    }), t.signals.cameraObjectChange.add(() => {
-      this.tilesMap.forEach((e) => {
-        e.deleteCamera(this._tilesCamera), e.setCamera(t.viewport.camera), e.setResolutionFromRenderer(t.viewport.camera, t.viewport.renderer);
-      }), this._tilesCamera = t.viewport.camera;
+class H {
+  // 使用较低的 priority 确保在 ImageOverlayPlugin 之后执行
+  // ImageOverlayPlugin 默认 priority 是 -1
+  priority = -10;
+  /** Alpha 裁剪模式 */
+  alphaClipMode = "alphaTest";
+  /**
+   * um-3d-tiles-renderer 插件接口：处理新加载的瓦片模型
+   */
+  processTileModel(e) {
+    e.traverse((t) => {
+      t.material && this._applyToMaterial(t.material);
+    });
+  }
+  /**
+   * 更新所有已加载模型的材质
+   * @param tiles TilesRenderer 实例
+   */
+  updateAllLoadedModels(e) {
+    e.forEachLoadedModel((t) => {
+      t.traverse((r) => {
+        r.material && this._applyToMaterial(r.material);
+      });
+    });
+  }
+  /**
+   * 应用配置到单个材质
+   */
+  _applyToMaterial(e) {
+    switch (e.alphaTest = 0, e.transparent = !1, e.alphaToCoverage = !1, this.alphaClipMode) {
+      case "alphaTest":
+        e.alphaTest = 0.01;
+        break;
+      case "transparent":
+        e.transparent = !0;
+        break;
+      case "alphaToCoverage":
+        e.alphaToCoverage = !0;
+        break;
+    }
+    e.needsUpdate = !0;
+  }
+}
+var a = /* @__PURE__ */ ((n) => (n.GEOJSON = "geojson", n.CESIUM_ION = "cesiumIon", n.TMS = "tms", n.XYZ = "xyz", n.WMS = "wms", n.WMTS = "wmts", n.URL_TEMPLATE = "urlTemplate", n))(a || {}), g = /* @__PURE__ */ ((n) => (n.QUANTIZED_MESH = "quantizedMesh", n.CESIUM_ION = "cesiumIon", n))(g || {});
+class B {
+  constructor(e, t) {
+    this.imageOverlayPlugin = e, this.resourceManager = t;
+  }
+  /** 存储所有 overlay 实例 */
+  _instances = /* @__PURE__ */ new Map();
+  // =============== GeoJSON ===============
+  addGeoJSON(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = {
+      url: e.url,
+      geojson: e.geojson,
+      opacity: e.opacity ?? 1,
+      fillStyle: e.fillStyle,
+      strokeStyle: e.strokeStyle,
+      strokeWidth: e.strokeWidth
+    };
+    e.color && (t.color = new v(e.color));
+    const r = new k(t);
+    return this.imageOverlayPlugin.addOverlay(r, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.GEOJSON,
+      instance: r
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.GEOJSON,
+      options: e
+    }), r;
+  }
+  updateGeoJSONColor(e, t) {
+    const r = this._instances.get(e);
+    if (!r || r.type !== a.GEOJSON) return !1;
+    const i = r.instance;
+    return i.color.set(t), i.redraw(), this.resourceManager?.updateOverlay(e, { color: t }), !0;
+  }
+  updateGeoJSONStrokeStyle(e, t) {
+    const r = this._instances.get(e);
+    if (!r || r.type !== a.GEOJSON) return !1;
+    const i = r.instance;
+    return i.strokeStyle = t, i.redraw(), this.resourceManager?.updateOverlay(e, { strokeStyle: t }), !0;
+  }
+  updateGeoJSONStrokeWidth(e, t) {
+    const r = this._instances.get(e);
+    if (!r || r.type !== a.GEOJSON) return !1;
+    const i = r.instance;
+    return i.strokeWidth = t, i.redraw(), this.resourceManager?.updateOverlay(e, { strokeWidth: t }), !0;
+  }
+  updateGeoJSONFillStyle(e, t) {
+    const r = this._instances.get(e);
+    if (!r || r.type !== a.GEOJSON) return !1;
+    const i = r.instance;
+    return i.fillStyle = t, i.redraw(), this.resourceManager?.updateOverlay(e, { fillStyle: t }), !0;
+  }
+  updateGeoJSONMode(e, t) {
+    const r = this._instances.get(e);
+    if (!r || r.type !== a.GEOJSON) return !1;
+    const i = r.instance;
+    return i.alphaInvert = !1, i.alphaMask = !1, i.fillStyle = "rgba( 255, 255, 255, 0.5 )", t === "mask" ? (i.alphaMask = !0, i.fillStyle = "white") : t === "invertMask" && (i.alphaInvert = !0, i.alphaMask = !0, i.fillStyle = "white"), i.redraw(), !0;
+  }
+  // =============== Cesium Ion ===============
+  addCesiumIon(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = new U({
+      assetId: e.assetId,
+      apiToken: e.apiToken,
+      autoRefreshToken: e.autoRefreshToken ?? !0,
+      color: typeof e.color == "number" ? e.color : 16777215,
+      opacity: e.opacity ?? 1
+    });
+    return this.imageOverlayPlugin.addOverlay(t, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.CESIUM_ION,
+      instance: t
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.CESIUM_ION,
+      options: e
+    }), t;
+  }
+  // =============== TMS ===============
+  addTMS(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = new F({
+      url: e.url,
+      color: typeof e.color == "number" ? e.color : 16777215,
+      opacity: e.opacity ?? 1
+    });
+    return this.imageOverlayPlugin.addOverlay(t, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.TMS,
+      instance: t
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.TMS,
+      options: e
+    }), t;
+  }
+  // =============== XYZ ===============
+  addXYZ(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = new b({
+      url: e.url,
+      color: typeof e.color == "number" ? e.color : 16777215,
+      opacity: e.opacity ?? 1
+    });
+    return this.imageOverlayPlugin.addOverlay(t, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.XYZ,
+      instance: t
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.XYZ,
+      options: e
+    }), t;
+  }
+  // =============== URL Template ===============
+  /**
+   * 添加 URL 模板 Overlay
+   * 
+   * 这是一个通用的瓦片加载方式，支持多种 URL 模板变量：
+   * - `{z}`, `{x}`, `{y}` - 标准 XYZ 坐标
+   * - `{s}` - 子域名轮换
+   * - `{reverseY}` - TMS 风格的 Y 坐标
+   * - 地理边界框变量等
+   * 
+   * @example
+   * // 标准 XYZ 瓦片
+   * addUrlTemplate({
+   *   id: 'osm',
+   *   url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png'
+   * })
+   * 
+   * @example
+   * // 带子域名的瓦片
+   * addUrlTemplate({
+   *   id: 'carto',
+   *   url: 'https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}.png',
+   *   subdomains: 'abcd'
+   * })
+   * 
+   * @example
+   * // ESRI 风格（y/x 顺序）
+   * addUrlTemplate({
+   *   id: 'esri',
+   *   url: 'https://server.arcgisonline.com/ArcGIS/rest/services/World_Imagery/MapServer/tile/{z}/{y}/{x}'
+   * })
+   */
+  addUrlTemplate(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = new A({
+      url: e.url,
+      subdomains: e.subdomains,
+      levels: e.levels,
+      tileDimension: e.tileDimension,
+      projection: e.projection,
+      contentBoundingBox: e.contentBoundingBox,
+      customTags: e.customTags,
+      color: typeof e.color == "number" ? e.color : 16777215,
+      opacity: e.opacity ?? 1
+    });
+    return this.imageOverlayPlugin.addOverlay(t, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.URL_TEMPLATE,
+      instance: t
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.URL_TEMPLATE,
+      options: e
+    }), t;
+  }
+  // =============== WMS ===============
+  async addWMS(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = {
+      layer: e.layer || "",
+      styles: e.styles || "",
+      crs: e.crs || "EPSG:4326",
+      format: e.format || "image/png",
+      tileDimension: e.tileDimension || 256
+    }, r = new G({
+      url: e.url,
+      layer: t.layer,
+      crs: t.crs,
+      format: t.format,
+      tileDimension: t.tileDimension,
+      styles: t.styles,
+      color: new v(typeof e.color == "number" ? e.color : 16777215),
+      opacity: e.opacity ?? 1
+    });
+    return this.imageOverlayPlugin.addOverlay(r, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.WMS,
+      instance: r
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.WMS,
+      options: e
+    }), r;
+  }
+  // =============== WMTS ===============
+  async addWMTS(e) {
+    if (!this.imageOverlayPlugin) return null;
+    if (this._instances.has(e.id))
+      return console.warn(`OverlayManager: Overlay "${e.id}" already exists`), null;
+    const t = await new D().loadAsync(e.url), r = ["EPSG:4326", "EPSG:3857"];
+    let i = e.layer || "";
+    t.layers.find((l) => l.identifier === i) || (i = t.layers.find(
+      (l) => l?.tileMatrixSets?.some((o) => r.includes(o.supportedCRS))
+    )?.identifier || t.layers[0].identifier);
+    const s = new W({
+      capabilities: t,
+      layer: i,
+      dimensions: e.dimensions || null,
+      style: e.style || void 0,
+      tileMatrixSet: e.tileMatrixSet || null,
+      planar: !1,
+      color: new v(typeof e.color == "number" ? e.color : 16777215),
+      opacity: e.opacity ?? 1
+    });
+    return this.imageOverlayPlugin.addOverlay(s, e.order), this._instances.set(e.id, {
+      id: e.id,
+      type: a.WMTS,
+      instance: s
+    }), this.resourceManager?.addOverlay({
+      id: e.id,
+      type: a.WMTS,
+      options: e
+    }), s;
+  }
+  // =============== 通用方法 ===============
+  /**
+   * 移除 overlay
+   */
+  remove(e) {
+    const t = this._instances.get(e);
+    return t ? [
+      a.XYZ,
+      a.TMS,
+      a.WMS,
+      a.WMTS,
+      a.CESIUM_ION,
+      a.URL_TEMPLATE
+    ].includes(t.type) && (this.resourceManager?.getImageryOverlayCount() ?? this._getLocalImageryCount()) <= 1 ? (console.warn("OverlayManager: Cannot remove overlay - at least one imagery overlay must remain"), !1) : (this.imageOverlayPlugin?.deleteOverlay(t.instance), this._instances.delete(e), this.resourceManager?.removeOverlay(e), !0) : (console.warn(`OverlayManager: Overlay "${e}" not found`), !1);
+  }
+  /**
+   * 获取 overlay 实例
+   */
+  get(e) {
+    return this._instances.get(e)?.instance;
+  }
+  /**
+   * 检查 overlay 是否存在
+   */
+  has(e) {
+    return this._instances.has(e);
+  }
+  /**
+   * 设置 overlay 可见性
+   */
+  setVisible(e, t) {
+    const r = this._instances.get(e);
+    return r && "opacity" in r.instance ? (r.instance.opacity = t ? 1 : 0, this.resourceManager?.updateOverlay(e, { opacity: t ? 1 : 0 }), !0) : !1;
+  }
+  /**
+   * 设置 overlay 透明度
+   */
+  setOpacity(e, t) {
+    const r = this._instances.get(e);
+    return r && "opacity" in r.instance ? (r.instance.opacity = t, this.resourceManager?.updateOverlay(e, { opacity: t }), r.instance.redraw?.(), !0) : !1;
+  }
+  /**
+   * 设置 overlay 层级
+   */
+  setOrder(e, t) {
+    if (!this.imageOverlayPlugin) return !1;
+    const r = this._instances.get(e);
+    return r ? (this.imageOverlayPlugin.setOverlayOrder(r.instance, t), this.resourceManager?.updateOverlay(e, { order: t }), !0) : !1;
+  }
+  /**
+   * 获取 overlay 层级
+   */
+  getOrder(e) {
+    if (!this.imageOverlayPlugin) return -1;
+    const t = this._instances.get(e);
+    return t ? this.imageOverlayPlugin.overlayInfo.get(t.instance)?.order ?? -1 : -1;
+  }
+  /**
+   * 将 overlay 移到最顶层
+   */
+  bringToFront(e) {
+    if (!this.imageOverlayPlugin) return !1;
+    const t = this._instances.get(e);
+    if (!t) return !1;
+    const r = this.imageOverlayPlugin.overlayInfo;
+    let i = 0;
+    return r.forEach((s) => {
+      s.order > i && (i = s.order);
+    }), this.imageOverlayPlugin.setOverlayOrder(t.instance, i + 1), this.resourceManager?.updateOverlay(e, { order: i + 1 }), !0;
+  }
+  /**
+   * 将 overlay 移到最底层
+   */
+  sendToBack(e) {
+    if (!this.imageOverlayPlugin) return !1;
+    const t = this._instances.get(e);
+    if (!t) return !1;
+    const r = this.imageOverlayPlugin.overlayInfo;
+    let i = 1 / 0;
+    return r.forEach((s) => {
+      s.order < i && (i = s.order);
+    }), this.imageOverlayPlugin.setOverlayOrder(t.instance, i - 1), this.resourceManager?.updateOverlay(e, { order: i - 1 }), !0;
+  }
+  // =============== 资源恢复 ===============
+  /**
+   * 从 ResourceManager 恢复所有资源
+   */
+  restoreFromResourceManager() {
+    if (!this.resourceManager) return;
+    const e = this.resourceManager.getAllOverlays();
+    for (const t of e)
+      this._createOverlayFromResource(t);
+  }
+  /**
+   * 根据资源配置创建 overlay（不保存到 ResourceManager）
+   */
+  _createOverlayFromResource(e) {
+    const t = this.resourceManager;
+    switch (this.resourceManager = void 0, e.type) {
+      case a.GEOJSON:
+        this.addGeoJSON(e.options);
+        break;
+      case a.CESIUM_ION:
+        this.addCesiumIon(e.options);
+        break;
+      case a.TMS:
+        this.addTMS(e.options);
+        break;
+      case a.XYZ:
+        this.addXYZ(e.options);
+        break;
+      case a.WMS:
+        this.addWMS(e.options);
+        break;
+      case a.WMTS:
+        this.addWMTS(e.options);
+        break;
+      case a.URL_TEMPLATE:
+        this.addUrlTemplate(e.options);
+        break;
+    }
+    this.resourceManager = t;
+  }
+  // =============== 生命周期 ===============
+  /**
+   * 获取所有 overlay ID
+   */
+  getIds() {
+    return Array.from(this._instances.keys());
+  }
+  /**
+   * 获取 overlay 数量
+   */
+  get count() {
+    return this._instances.size;
+  }
+  /**
+   * 获取本地影像数量（不依赖 ResourceManager）
+   */
+  _getLocalImageryCount() {
+    let e = 0;
+    return this._instances.forEach((t) => {
+      [a.XYZ, a.TMS, a.WMS, a.WMTS, a.CESIUM_ION, a.URL_TEMPLATE].includes(t.type) && e++;
+    }), e;
+  }
+  /**
+   * 只清理实例（保留 ResourceManager 中的配置）
+   */
+  disposeInstances() {
+    this._instances.forEach((e) => {
+      this.imageOverlayPlugin?.deleteOverlay(e.instance);
+    }), this._instances.clear();
+  }
+  /**
+   * 完全销毁（清理实例和配置）
+   */
+  dispose() {
+    this.disposeInstances(), this.resourceManager?.clear();
+  }
+}
+class z {
+  /** Overlay 资源配置 */
+  _overlays = /* @__PURE__ */ new Map();
+  // =============== Overlay 资源管理 ===============
+  /**
+   * 添加 Overlay 资源配置
+   */
+  addOverlay(e) {
+    this._overlays.has(e.id) && console.warn(`ResourceManager: Overlay "${e.id}" already exists, will be overwritten.`), this._overlays.set(e.id, { ...e });
+  }
+  /**
+   * 获取 Overlay 资源配置
+   */
+  getOverlay(e) {
+    return this._overlays.get(e);
+  }
+  /**
+   * 移除 Overlay 资源配置
+   */
+  removeOverlay(e) {
+    return this._overlays.delete(e);
+  }
+  /**
+   * 检查 Overlay 是否存在
+   */
+  hasOverlay(e) {
+    return this._overlays.has(e);
+  }
+  /**
+   * 获取所有 Overlay 资源配置
+   */
+  getAllOverlays() {
+    return Array.from(this._overlays.values());
+  }
+  /**
+   * 获取指定类型的 Overlay 资源配置
+   */
+  getOverlaysByType(e) {
+    return this.getAllOverlays().filter((t) => t.type === e);
+  }
+  /**
+   * 获取所有 Overlay 的 ID 列表
+   */
+  getOverlayIds() {
+    return Array.from(this._overlays.keys());
+  }
+  /**
+   * 获取 Overlay 数量
+   */
+  get overlayCount() {
+    return this._overlays.size;
+  }
+  /**
+   * 获取影像类型的 Overlay 数量
+   */
+  getImageryOverlayCount() {
+    let e = 0;
+    return this._overlays.forEach((t) => {
+      (t.type === a.XYZ || t.type === a.TMS || t.type === a.WMS || t.type === a.WMTS || t.type === a.CESIUM_ION || t.type === a.URL_TEMPLATE) && e++;
+    }), e;
+  }
+  /**
+   * 更新 Overlay 配置
+   */
+  updateOverlay(e, t) {
+    const r = this._overlays.get(e);
+    return r ? (r.options = { ...r.options, ...t }, !0) : !1;
+  }
+  // =============== 工具方法 ===============
+  /**
+   * 清空所有资源配置
+   */
+  clear() {
+    this._overlays.clear();
+  }
+  /**
+   * 导出所有资源配置（用于调试或持久化）
+   */
+  export() {
+    return {
+      overlays: this.getAllOverlays()
+    };
+  }
+  /**
+   * 导入资源配置
+   */
+  import(e) {
+    e.overlays && (this._overlays.clear(), e.overlays.forEach((t) => this._overlays.set(t.id, { ...t })));
+  }
+}
+class $ {
+  /** 地形配置映射表 */
+  _terrains = /* @__PURE__ */ new Map();
+  /** 当前激活的地形 ID */
+  _currentId = null;
+  /**
+   * 获取当前激活的地形 ID
+   */
+  get currentId() {
+    return this._currentId;
+  }
+  /**
+   * 获取已注册的地形数量
+   */
+  get count() {
+    return this._terrains.size;
+  }
+  /**
+   * 添加地形配置
+   */
+  add(e) {
+    this._terrains.has(e.id) && console.warn(`TerrainManager: Terrain "${e.id}" already exists, will be overwritten.`), this._terrains.set(e.id, { ...e });
+  }
+  /**
+   * 移除地形配置
+   */
+  remove(e) {
+    return this._terrains.has(e) ? (this._currentId === e && (this._currentId = null), this._terrains.delete(e)) : !1;
+  }
+  /**
+   * 设置当前激活的地形 ID
+   */
+  setCurrentId(e) {
+    this._currentId = e;
+  }
+  /**
+   * 检查地形是否已注册
+   */
+  has(e) {
+    return this._terrains.has(e);
+  }
+  /**
+   * 获取指定地形配置
+   */
+  get(e) {
+    return this._terrains.get(e);
+  }
+  /**
+   * 获取当前激活的地形配置
+   */
+  getCurrent() {
+    if (this._currentId)
+      return this._terrains.get(this._currentId);
+  }
+  /**
+   * 获取所有地形配置列表（用于前端列表渲染）
+   */
+  getList() {
+    return Array.from(this._terrains.values()).map((e) => ({
+      id: e.id,
+      config: e,
+      active: e.id === this._currentId
+    }));
+  }
+  /**
+   * 获取所有地形配置
+   */
+  getAll() {
+    return Array.from(this._terrains.values());
+  }
+  /**
+   * 获取所有地形 ID
+   */
+  getIds() {
+    return Array.from(this._terrains.keys());
+  }
+  /**
+   * 清空所有地形配置
+   */
+  clear() {
+    this._terrains.clear(), this._currentId = null;
+  }
+  /**
+   * 销毁管理器
+   */
+  dispose() {
+    this.clear();
+  }
+}
+const Z = "https://sooncps.xwbuilders.com/api/ugis-dataprocess/v1/terrain/NhBLlMx3/", X = "https://c.tile.openstreetmap.fr/hot/{z}/{x}/{y}.png";
+class le {
+  constructor(e, t = {}) {
+    this.ssp = e, this.options = t;
+    const r = t.baseUrl || Z;
+    if (this.resourceManager = new z(), this.terrainManager = new $(), t.imageryUrl !== !1) {
+      const i = t.imageryUrl || X;
+      this.resourceManager.addOverlay({
+        id: this.defaultImageryId,
+        type: a.XYZ,
+        options: { id: this.defaultImageryId, url: i }
+      });
+    }
+    this._alphaClipMode = t.alphaClipMode ?? "alphaTest", this._currentTerrainConfig = {
+      id: this.defaultTerrainId,
+      type: g.QUANTIZED_MESH,
+      url: r
+    }, this.terrainManager.add(this._currentTerrainConfig), this.terrainManager.setCurrentId(this._currentTerrainConfig.id), this.tiles = this._initTilesRenderer(this._currentTerrainConfig), this._initPlugins(this.tiles, this._currentTerrainConfig);
+  }
+  defaultTerrainId = "__default_terrain__";
+  defaultImageryId = "__default_imagery__";
+  tiles;
+  tilesFadePlugin;
+  updateOnChangePlugin;
+  customMaterialPlugin;
+  imageOverlayPlugin;
+  reorientationPlugin;
+  /** 资源管理器（存储配置） */
+  resourceManager;
+  /** 地形管理器（记录地形列表） */
+  terrainManager;
+  /** Overlay 管理器（管理实例） */
+  overlayManager;
+  /** 当前地形配置 */
+  _currentTerrainConfig;
+  /** Alpha 裁剪模式 */
+  _alphaClipMode = "alphaTest";
+  /** 是否已启用（添加到场景） */
+  _enabled = !1;
+  loedTilesSets = /* @__PURE__ */ new Set();
+  options;
+  /**
+   * 是否使用 Cesium Ion 地形
+   */
+  get isCesiumIon() {
+    return this._currentTerrainConfig.type === g.CESIUM_ION;
+  }
+  /**
+   * 获取当前地形配置
+   */
+  get currentTerrainConfig() {
+    return this._currentTerrainConfig;
+  }
+  /**
+   * 获取/设置最大深度（GUI 可控）
+   */
+  get maxDepth() {
+    return this.tiles.maxDepth;
+  }
+  set maxDepth(e) {
+    this.tiles.maxDepth = e, this.render();
+  }
+  /**
+   * 获取/设置误差目标（GUI 可控）
+   */
+  get errorTarget() {
+    return this.tiles.errorTarget;
+  }
+  set errorTarget(e) {
+    this.tiles.errorTarget = e, this.render();
+  }
+  /**
+   * 获取/设置地形显示状态（GUI 可控）
+   */
+  get showTerrain() {
+    return this.tiles.group.visible;
+  }
+  set showTerrain(e) {
+    this.tiles.group.visible = e, this.render();
+  }
+  /**
+   * 获取/设置 Alpha 裁剪模式（GUI 可控）
+   * - 用于支持 GeoJSON mask 功能
+   */
+  get alphaClipMode() {
+    return this._alphaClipMode;
+  }
+  set alphaClipMode(e) {
+    this._alphaClipMode = e, this.customMaterialPlugin && (this.customMaterialPlugin.alphaClipMode = e), this._updateAlphaClipMode(), this.render();
+  }
+  _initTilesRenderer(e) {
+    return e.type === g.CESIUM_ION ? new u() : (
+      // Cesium Ion 由插件设置 URL
+      new u(e.url)
+    );
+  }
+  /**
+   * 创建 TilesRenderer（统一方法，支持自定义地形和 Cesium Ion 地形）
+   * @param config 地形配置
+   */
+  _initPlugins(e, t) {
+    if (this.tilesFadePlugin = new O({ maximumFadeOutTiles: 200 }), this.updateOnChangePlugin = new T(), e.registerPlugin(this.tilesFadePlugin), e.registerPlugin(this.updateOnChangePlugin), t.type === g.CESIUM_ION ? e.registerPlugin(new L({
+      apiToken: t.apiToken,
+      assetId: t.assetId || "1",
+      autoRefreshToken: t.autoRefreshToken ?? !0,
+      assetTypeHandler: (r, i) => {
+        r === "TERRAIN" && i.getPluginByName("QUANTIZED_MESH_PLUGIN") === null && i.registerPlugin(new M({ useRecommendedSettings: !0 }));
+      }
+    })) : (e.registerPlugin(new M({ useRecommendedSettings: !0 })), e.fetchData = async (r) => {
+      const i = { method: "GET", mode: "cors" };
+      if (/layer\.json$/.test(r)) {
+        const s = await fetch(r, i).then((l) => l.json());
+        return s.metadataAvailability = -1, new Response(JSON.stringify(s));
+      }
+      return fetch(r, i);
+    }), this.options.useCustomMaterial !== !1 && (this.customMaterialPlugin = new H(), this.customMaterialPlugin.alphaClipMode = this._alphaClipMode, e.registerPlugin(this.customMaterialPlugin)), this.imageOverlayPlugin = new E({
+      renderer: this.ssp.viewport.renderer,
+      overlays: []
+    }), e.registerPlugin(this.imageOverlayPlugin), this.overlayManager = new B(this.imageOverlayPlugin, this.resourceManager), this.overlayManager.restoreFromResourceManager(), this.options.reorientation !== !1) {
+      const r = this.options.reorientation || { lon: 120, lat: 30 };
+      this.reorientationPlugin = new w({
+        lon: r.lon,
+        lat: r.lat,
+        height: r.height ?? 0.1
+      }), e.registerPlugin(this.reorientationPlugin), this.invalidate(r.lon, r.lat, r.height ?? 0.1);
+    }
+    e.maxDepth = this.options.maxDepth ?? 20, e.errorTarget = this.options.errorTarget ?? 1, e.addEventListener("needs-render", this.render), e.addEventListener("needs-update", this.render);
+  }
+  /**
+   * 销毁当前 tiles 实例
+   */
+  _disposeTilesRenderer() {
+    const e = this.tiles;
+    this._enabled && this.ssp.removeObject(e.group), e.removeEventListener("needs-render", this.render), e.removeEventListener("needs-update", this.render), this.overlayManager.disposeInstances(), e.dispose();
+  }
+  /**
+   * 更新所有已加载模型的 alpha 裁剪模式
+   */
+  _updateAlphaClipMode() {
+    this.customMaterialPlugin && this.customMaterialPlugin.updateAllLoadedModels(this.tiles);
+  }
+  // =============== 地形管理 API ===============
+  /**
+   * 设置地形
+   * 会创建新的 TilesRenderer 实例以避免状态残留问题
+   * @param config 地形配置
+   * @example
+   * // 设置量化网格地形
+   * tilesRenderer.setTerrain({
+   *   type: TerrainType.QUANTIZED_MESH,
+   *   url: 'https://terrain.example.com/'
+   * })
+   *
+   * // 设置 Cesium Ion 地形
+   * tilesRenderer.setTerrain({
+   *   type: TerrainType.CESIUM_ION,
+   *   apiToken: 'your-token',
+   *   assetId: '1'
+   * })
+   */
+  setTerrain(e, t = void 0) {
+    e.id !== this._currentTerrainConfig.id && (t && (this.options = { ...this.options, ...t }), this.terrainManager.has(e.id) || this.terrainManager.add(e), this.terrainManager.setCurrentId(e.id), this._disposeTilesRenderer(), this._currentTerrainConfig = e, this.tiles = this._initTilesRenderer(e), this._initPlugins(this.tiles, e), this._enabled && this.ssp.addObject(this.tiles.group), this.render());
+  }
+  // =============== Overlay 快捷方法 ===============
+  /**
+   * 添加 GeoJSON Overlay
+   * @example
+   * tilesRenderer.addGeoJSON({
+   *   id: 'china-boundary',
+   *   url: './data/china.geojson',
+   *   color: '#ff0000',
+   *   opacity: 0.8
+   * })
+   */
+  addGeoJSON(e) {
+    return this.overlayManager.addGeoJSON(e);
+  }
+  /**
+   * 添加 Cesium Ion Overlay
+   */
+  addCesiumIonOverlay(e) {
+    return this.overlayManager.addCesiumIon(e);
+  }
+  /**
+   * 添加 TMS Tiles Overlay
+   */
+  addTMSOverlay(e) {
+    return this.overlayManager.addTMS(e);
+  }
+  /**
+   * 添加 XYZ Tiles Overlay
+   */
+  addXYZOverlay(e) {
+    return this.overlayManager.addXYZ(e);
+  }
+  /**
+   * 添加 URL Template Overlay
+   * 
+   * 支持多种 URL 模板变量：
+   * - `{z}`, `{x}`, `{y}` - 标准 XYZ 坐标
+   * - `{s}` - 子域名轮换
+   * - `{reverseY}` - TMS 风格的 Y 坐标
+   * - `{westDegrees}`, `{southDegrees}`, `{eastDegrees}`, `{northDegrees}` - 地理边界框
+   * 
+   * @example
+   * tilesPlugin.addUrlTemplateOverlay({
+   *   id: 'osm',
+   *   url: 'https://tile.openstreetmap.org/{z}/{x}/{y}.png'
+   * })
+   * 
+   * @example
+   * tilesPlugin.addUrlTemplateOverlay({
+   *   id: 'carto',
+   *   url: 'https://{s}.basemaps.cartocdn.com/light_all/{z}/{x}/{y}.png',
+   *   subdomains: 'abcd'
+   * })
+   */
+  addUrlTemplateOverlay(e) {
+    return this.overlayManager.addUrlTemplate(e);
+  }
+  /**
+   * 添加 WMS Tiles Overlay
+   */
+  addWMSOverlay(e) {
+    return this.overlayManager.addWMS(e);
+  }
+  /**
+   * 添加 WMTS Tiles Overlay
+   */
+  addWMTSOverlay(e) {
+    return this.overlayManager.addWMTS(e);
+  }
+  /**
+   * 移除指定 overlay
+   */
+  removeOverlay(e) {
+    return this.overlayManager.remove(e);
+  }
+  /**
+   * 更新 GeoJSON 颜色
+   */
+  updateGeoJSONColor(e, t) {
+    const r = this.overlayManager.updateGeoJSONColor(e, t);
+    return r && this.render(), r;
+  }
+  /**
+   * 更新 GeoJSON 模式
+   * - overlay: 普通叠加显示
+   * - mask: 只显示 GeoJSON 区域内的地形
+   * - invertMask: 只显示 GeoJSON 区域外的地形
+   */
+  updateGeoJSONMode(e, t) {
+    const r = this.overlayManager.updateGeoJSONMode(e, t);
+    return r && this.render(), r;
+  }
+  /**
+   * 更新 GeoJSON 描边样式
+   */
+  updateGeoJSONStrokeStyle(e, t) {
+    const r = this.overlayManager.updateGeoJSONStrokeStyle(e, t);
+    return r && this.render(), r;
+  }
+  /**
+   * 更新 GeoJSON 描边宽度
+   */
+  updateGeoJSONStrokeWidth(e, t) {
+    const r = this.overlayManager.updateGeoJSONStrokeWidth(e, t);
+    return r && this.render(), r;
+  }
+  /**
+   * 更新 GeoJSON 填充样式
+   */
+  updateGeoJSONFillStyle(e, t) {
+    const r = this.overlayManager.updateGeoJSONFillStyle(e, t);
+    return r && this.render(), r;
+  }
+  // =============== Overlay 层级控制 ===============
+  /**
+   * 设置 overlay 层级顺序
+   * @param id overlay ID
+   * @param order 层级顺序，数值越大越靠上
+   * @example
+   * tilesRenderer.setOverlayOrder('china-boundary', 10)
+   */
+  setOverlayOrder(e, t) {
+    return this.overlayManager.setOrder(e, t);
+  }
+  /**
+   * 获取 overlay 当前的层级顺序
+   * @param id overlay ID
+   */
+  getOverlayOrder(e) {
+    return this.overlayManager.getOrder(e);
+  }
+  /**
+   * 将 overlay 移动到最顶层
+   */
+  bringOverlayToFront(e) {
+    return this.overlayManager.bringToFront(e);
+  }
+  /**
+   * 将 overlay 移动到最底层
+   */
+  sendOverlayToBack(e) {
+    return this.overlayManager.sendToBack(e);
+  }
+  /**
+   * 设置 overlay 可见性
+   */
+  setOverlayVisible(e, t) {
+    const r = this.overlayManager.setVisible(e, t);
+    return r && this.render(), r;
+  }
+  /**
+   * 设置 overlay 透明度
+   */
+  setOverlayOpacity(e, t) {
+    const r = this.overlayManager.setOpacity(e, t);
+    return r && this.render(), r;
+  }
+  // =============== 生命周期 ===============
+  render = () => {
+    this.ssp.render();
+  };
+  beforeRenderHandler = () => {
+    this.ssp.viewport.camera.updateMatrixWorld(), this.tiles.setCamera(this.ssp.viewport.camera), this.tiles.setResolutionFromRenderer(
+      this.ssp.viewport.camera,
+      this.ssp.viewport.renderer
+    ), this.tiles.update();
+  };
+  enable() {
+    this._enabled = !0, this.ssp.addObject(this.tiles.group), this.ssp.signals.beforeRender.add(this.beforeRenderHandler);
+  }
+  disable() {
+    this._enabled = !1, this.ssp.removeObject(this.tiles.group), this.ssp.signals.beforeRender.remove(this.beforeRenderHandler);
+  }
+  invalidate(e, t, r) {
+    if (!this.reorientationPlugin)
+      return console.warn("TilesRenderer: reorientationPlugin is not enabled, invalidate() will not work."), () => {
+      };
+    const i = this.reorientationPlugin;
+    this.options.reorientation = {
+      lon: e,
+      lat: t,
+      height: r
+    };
+    const s = () => {
+      const o = c.degToRad(t), d = c.degToRad(e);
+      i.transformLatLonHeightToOrigin(
+        o,
+        d,
+        r
+      ), this.render(), l();
+    }, l = () => {
+      this.tiles.removeEventListener("load-root-tileset", s), this.loedTilesSets.delete(s);
+    };
+    return this.tiles.addEventListener("load-root-tileset", s), this.loedTilesSets.add(s), this.tiles.root && s(), l;
+  }
+  dispose() {
+    this.disable(), this.terrainManager.dispose(), this.overlayManager.dispose(), this.loedTilesSets.forEach(
+      (e) => this.tiles.removeEventListener("load-root-tileset", e)
+    ), this.loedTilesSets.clear(), this.tiles.removeEventListener("needs-render", this.render), this.tiles.removeEventListener("needs-update", this.render), this.tiles.dispose();
+  }
+}
+const h = {
+  DEFAULT: 0,
+  GRADIENT: 1,
+  TOPOGRAPHIC_LINES: 2,
+  LIGHTING: 3
+}, Y = {
+  vertexShader: (
+    /* glsl */
+    `
+    varying vec3 wPosition;
+    void main() {
+      #include <begin_vertex>
+      #include <project_vertex>
+      wPosition = ( modelMatrix * vec4( transformed, 1.0 ) ).xyz;
+    }
+  `
+  ),
+  fragmentShader: (
+    /* glsl */
+    `
+    varying vec3 wPosition;
+    void main() {
+      float minVal = - 30.0;
+      float maxVal = 30.0;
+      float val = ( wPosition.y - minVal ) / ( maxVal - minVal );
+      vec4 color1 = vec4( 0.149, 0.196, 0.219, 1.0 ) * 0.5;
+      vec4 color2 = vec4( 1.0 );
+      gl_FragColor = mix( color1, color2, val );
+    }
+  `
+  )
+}, V = {
+  vertexShader: (
+    /* glsl */
+    `
+    varying vec3 wPosition;
+    varying vec3 vViewPosition;
+    void main() {
+      #include <begin_vertex>
+      #include <project_vertex>
+      wPosition = ( modelMatrix * vec4( transformed, 1.0 ) ).xyz;
+      vViewPosition = - mvPosition.xyz;
+    }
+  `
+  ),
+  fragmentShader: (
+    /* glsl */
+    `
+    varying vec3 wPosition;
+    varying vec3 vViewPosition;
+    void main() {
+      // lighting
+      vec3 fdx = vec3( dFdx( wPosition.x ), dFdx( wPosition.y ), dFdx( wPosition.z ) );
+      vec3 fdy = vec3( dFdy( wPosition.x ), dFdy( wPosition.y ), dFdy( wPosition.z ) );
+      vec3 worldNormal = normalize( cross( fdx, fdy ) );
+      float lighting =
+        0.4 +
+        clamp( dot( worldNormal, vec3( 1.0, 1.0, 1.0 ) ), 0.0, 1.0 ) * 0.5 +
+        clamp( dot( worldNormal, vec3( - 1.0, 1.0, - 1.0 ) ), 0.0, 1.0 ) * 0.3;
+      // thickness scale
+      float upwardness = dot( worldNormal, vec3( 0.0, 1.0, 0.0 ) );
+      float yInv = clamp( 1.0 - abs( upwardness ), 0.0, 1.0 );
+      float thicknessScale = pow( yInv, 0.4 );
+      thicknessScale *= 0.25 + 0.5 * ( vViewPosition.z + 1.0 ) / 2.0;
+      // thickness
+      float thickness = 0.01 * thicknessScale;
+      float thickness2 = thickness / 2.0;
+      float m = mod( wPosition.y, 3.0 );
+      // soften edge
+      float center = thickness2;
+      float dist = clamp( abs( m - thickness2 ) / thickness2, 0.0, 1.0 );
+      vec4 topoColor = vec4( 0.149, 0.196, 0.219, 1.0 ) * 0.5;
+      gl_FragColor = mix( topoColor * lighting, vec4( lighting ), dist );
+    }
+  `
+  )
+};
+let m = null, y = null, f = null;
+class q {
+  constructor(e, t) {
+    this.ssp = e, this.options = t, "url" in this.options ? this.tiles = new u(this.options.url) : (this.tiles = new u(), this._initCesiumIon(this.options)), this._initBasePlugins(this.options);
+  }
+  tiles;
+  tilesFadePlugin;
+  updateOnChangePlugin;
+  reorientationPlugin;
+  options;
+  // 用于模型居中
+  _box = new I();
+  _sphere = new x();
+  // 当前材质类型
+  _materialType = h.DEFAULT;
+  // 按需渲染标志
+  _needsUpdate = !0;
+  _cameraTransitionStart = !1;
+  loedTilesSets = /* @__PURE__ */ new Set();
+  /**
+   * 初始化 Cesium Ion 插件
+   */
+  _initCesiumIon(e) {
+    this.tiles.registerPlugin(
+      new L({
+        apiToken: e.apiToken,
+        assetId: e.assetId,
+        autoRefreshToken: e.autoRefreshToken ?? !0
+      })
+    );
+  }
+  /**
+   * 初始化基础插件
+   */
+  _initBasePlugins(e) {
+    if (e._managedByPlugin || (m === null ? m = this.tiles.lruCache : this.tiles.lruCache = m, y === null ? y = this.tiles.parseQueue : this.tiles.parseQueue = y, f === null ? f = this.tiles.downloadQueue : this.tiles.downloadQueue = f, this.tiles.lruCache.maxSize = 600, this.tiles.lruCache.minSize = 300, this.tiles.lruCache.unloadPercent = 0.8), this._setupGLTFLoader(), this.tilesFadePlugin = new O({ maximumFadeOutTiles: 200 }), this.updateOnChangePlugin = new T(), this.tiles.registerPlugin(this.tilesFadePlugin), this.tiles.registerPlugin(this.updateOnChangePlugin), this.tiles.maxDepth = e.maxDepth ?? 20, this.tiles.errorTarget = e.errorTarget ?? 2, this.options.reorientation) {
+      const t = this.options.reorientation || { lon: 120, lat: 30 };
+      this.reorientationPlugin = new w({
+        lon: t.lon,
+        lat: t.lat,
+        height: t.height ?? 0.1
+      }), this.tiles.registerPlugin(this.reorientationPlugin), this.invalidate(
+        t.lon,
+        t.lat,
+        t.height ?? 0.1
+      );
+    }
+    this.tiles.addEventListener("load-model", this.onLoadModel), this.tiles.addEventListener("dispose-model", this.onDisposeModel), e._managedByPlugin || (this.tiles.addEventListener("load-model", this._onNeedsRender), this.tiles.addEventListener("needs-render", this._onNeedsRender), this.tiles.addEventListener("needs-update", this._onNeedsRender), this._setupCameraTransitionEvents());
+  }
+  /**
+   * 设置 GLTF Loader
+   */
+  _setupGLTFLoader() {
+    const e = new C(this.tiles.manager), t = this.ssp.manager?.store?.modelManager;
+    if (t?.gltfLoader) {
+      const { dracoLoader: r, ktx2Loader: i, meshoptDecoder: s } = t.gltfLoader;
+      r && e.setDRACOLoader(r), i && e.setKTX2Loader(i), s && e.setMeshoptDecoder(s);
+    }
+    this.tiles.manager.addHandler(/\.gltf$/, e);
+  }
+  /**
+   * 设置相机过渡事件监听
+   */
+  _setupCameraTransitionEvents() {
+    const { controls: e, viewport: t } = this.ssp;
+    e.addEventListener("transitionstart", () => {
+      this._cameraTransitionStart = !0, t.state.useFreq = 1;
+    }), e.addEventListener("rest", () => {
+      this._cameraTransitionStart = !1, this._needsUpdate = !0, t.state.useFreq = 60;
     });
   }
+  /**
+   * 按需渲染回调
+   */
+  _onNeedsRender = () => {
+    this._cameraTransitionStart || (this._needsUpdate = !0, this.render());
+  };
+  /**
+   * 获取当前材质类型
+   */
+  get materialType() {
+    return this._materialType;
+  }
+  /**
+   * 设置材质类型
+   */
+  set materialType(e) {
+    this._materialType = e, this.tiles.forEachLoadedModel((t) => {
+      this.updateMaterial(t);
+    }), this.render();
+  }
+  /**
+   * 模型加载时保存原始材质
+   */
+  onLoadModel = ({ scene: e }) => {
+    e.traverse((t) => {
+      t.isMesh && (t.originalMaterial = t.material);
+    }), this._materialType !== h.DEFAULT && this.updateMaterial(e);
+  };
+  /**
+   * 更新场景中所有网格的材质（参考 customMaterial.js）
+   */
+  updateMaterial = (e) => {
+    const t = this._materialType;
+    e.traverse((r) => {
+      if (r.isMesh)
+        switch (r.material && r.material !== r.originalMaterial && r.material.dispose(), t) {
+          case h.DEFAULT:
+            r.material = r.originalMaterial, r.material && (r.material.side = 2), r.receiveShadow = !1, r.castShadow = !1;
+            break;
+          case h.GRADIENT:
+            r.material = new P(Y), r.material.side = 2, r.receiveShadow = !1, r.castShadow = !1;
+            break;
+          case h.TOPOGRAPHIC_LINES: {
+            const i = new P(V);
+            i.extensions = { derivatives: !0 }, i.side = 2, r.material = i, r.receiveShadow = !1, r.castShadow = !1;
+            break;
+          }
+          case h.LIGHTING:
+            r.material = new N(), r.material.side = 2, r.receiveShadow = !0, r.castShadow = !0;
+            break;
+        }
+    });
+  };
+  onDisposeModel = ({ scene: e }) => {
+    e.traverse((t) => {
+      t.isMesh && t.material.dispose();
+    });
+  };
+  /**
+   * 应用自动居中逻辑
+   */
+  applyAutoCenter() {
+    this.options.autoCenter !== !1 && (this.tiles.getBoundingBox(this._box) ? (this._box.getCenter(this.tiles.group.position), this.tiles.group.position.multiplyScalar(-1)) : this.tiles.getBoundingSphere(this._sphere) && (this.tiles.group.position.copy(this._sphere.center), this.tiles.group.position.multiplyScalar(-1)));
+  }
+  /**
+   * 每帧渲染前的处理
+   */
+  beforeRenderHandler = () => {
+    this._needsUpdate && (this._needsUpdate = !1, this.ssp.viewport.camera.updateMatrixWorld(), this.tiles.setCamera(this.ssp.viewport.camera), this.tiles.setResolutionFromRenderer(
+      this.ssp.viewport.camera,
+      this.ssp.viewport.renderer
+    ), this.applyAutoCenter(), this.tiles.group.updateMatrixWorld(), this.tiles.update());
+  };
+  render = () => {
+    this.ssp.render();
+  };
+  enable() {
+    this.ssp.addObject(this.tiles.group), this.ssp.signals.beforeRender.add(this.beforeRenderHandler);
+  }
+  disable() {
+    this.ssp.removeObject(this.tiles.group), this.ssp.signals.beforeRender.remove(this.beforeRenderHandler);
+  }
+  invalidate(e, t, r) {
+    if (!this.reorientationPlugin)
+      return console.warn(
+        "TilesRenderer: reorientationPlugin is not enabled, invalidate() will not work."
+      ), () => {
+      };
+    const i = this.reorientationPlugin;
+    this.options.reorientation = {
+      lon: e,
+      lat: t,
+      height: r
+    };
+    const s = () => {
+      const o = c.degToRad(t), d = c.degToRad(e);
+      i.transformLatLonHeightToOrigin(o, d, r), this.render(), l();
+    }, l = () => {
+      this.tiles.removeEventListener("load-root-tileset", s), this.loedTilesSets.delete(s);
+    };
+    return this.tiles.addEventListener("load-root-tileset", s), this.loedTilesSets.add(s), this.tiles.root && s(), l;
+  }
+  dispose() {
+    this.disable(), this.loedTilesSets.forEach(
+      (e) => this.tiles.removeEventListener("load-root-tileset", e)
+    ), this.loedTilesSets.clear(), this.tiles.removeEventListener("load-model", this.onLoadModel), this.tiles.removeEventListener("dispose-model", this.onDisposeModel), this.options._managedByPlugin || (this.tiles.removeEventListener("load-model", this._onNeedsRender), this.tiles.removeEventListener("needs-render", this._onNeedsRender), this.tiles.removeEventListener("needs-update", this._onNeedsRender)), this.tiles.dispose();
+  }
+}
+class oe {
+  constructor(e) {
+    this.ssp = e;
+    const { controls: t, viewport: r } = e;
+    this._tilesCamera = r.camera, t.addEventListener("transitionstart", () => {
+      this.cameraTransitionStart = !0, r.state.useFreq = 1;
+    }), t.addEventListener("rest", () => {
+      this.cameraTransitionStart = !1, this.needsUpdate = !0, r.state.useFreq = 60;
+    }), e.signals.beforeRender.add(this._beforeRenderHandler), e.signals.cameraObjectChange.add(this._onCameraObjectChange);
+  }
+  /** 存储多个 tiles 实例，key 为 url */
   tilesMap = /* @__PURE__ */ new Map();
+  /** 按需渲染标志 */
   needsUpdate = !0;
   cameraTransitionStart = !1;
   _tilesCamera;
-  lruCache = null;
-  parseQueue = null;
-  downloadQueue = null;
-  async loadTiles(t) {
-    if (this.tilesMap.has(t)) {
-      c.utils.warn(`${t} already loaded`);
-      return;
-    }
-    const { ssp: s, ssp: { viewport: i } } = this, e = new g(t);
-    this.lruCache === null ? this.lruCache = e.lruCache : e.lruCache = this.lruCache, this.parseQueue === null ? this.parseQueue = e.parseQueue : e.parseQueue = this.parseQueue, this.downloadQueue === null ? this.downloadQueue = e.downloadQueue : e.downloadQueue = this.downloadQueue;
-    const r = new p(e.manager);
-    r.register((o) => new L(o));
-    const { dracoLoader: a, ktx2Loader: n, meshoptDecoder: d } = s.manager.store.modelManager.gltfLoader;
-    a && r.setDRACOLoader(a), n && r.setKTX2Loader(n), d && r.setMeshoptDecoder(d), e.manager.addHandler(/\.gltf$/, r), this.tilesMap.set(t, e), e.setCamera(this._tilesCamera), e.setResolutionFromRenderer(this._tilesCamera, i.renderer), e.lruCache.maxSize = 600, e.lruCache.minSize = 300, e.lruCache.unloadPercent = 0.8, s.addObject(e.group);
-    const u = () => {
-      this.cameraTransitionStart || (this.needsUpdate = !0, s.render());
+  _lruCache = null;
+  _parseQueue = null;
+  _downloadQueue = null;
+  _beforeRenderHandler = () => {
+    this.needsUpdate && (this.needsUpdate = !1, this.ssp.viewport.camera.updateMatrixWorld(), this.tilesMap.forEach((e) => {
+      e.tiles.setCamera(this.ssp.viewport.camera), e.tiles.setResolutionFromRenderer(this.ssp.viewport.camera, this.ssp.viewport.renderer), e.applyAutoCenter(), e.tiles.group.updateMatrixWorld(), e.tiles.update();
+    }));
+  };
+  _onCameraObjectChange = () => {
+    this.tilesMap.forEach((e) => {
+      e.tiles.deleteCamera(this._tilesCamera), e.tiles.setCamera(this.ssp.viewport.camera), e.tiles.setResolutionFromRenderer(this.ssp.viewport.camera, this.ssp.viewport.renderer);
+    }), this._tilesCamera = this.ssp.viewport.camera;
+  };
+  /**
+   * 加载 3D Tiles
+   * @param url - tileset.json 地址
+   * @param options - 配置项
+   * @returns Promise<ThreeDTilesRenderer>
+   */
+  async loadTiles(e) {
+    const t = "url" in e ? e.url : e.assetId;
+    if (this.tilesMap.has(t))
+      return _.utils.warn(`${t} already loaded`), this.tilesMap.get(t);
+    const { ssp: r } = this, i = new q(r, {
+      ...e,
+      _managedByPlugin: !0
+    }), { tiles: s } = i;
+    this._lruCache === null ? this._lruCache = s.lruCache : s.lruCache = this._lruCache, this._parseQueue === null ? this._parseQueue = s.parseQueue : s.parseQueue = this._parseQueue, this._downloadQueue === null ? this._downloadQueue = s.downloadQueue : s.downloadQueue = this._downloadQueue, s.lruCache.maxSize = 600, s.lruCache.minSize = 300, s.lruCache.unloadPercent = 0.8, this.tilesMap.set(t, i), s.setCamera(this._tilesCamera), s.setResolutionFromRenderer(this._tilesCamera, r.viewport.renderer), r.addObject(s.group);
+    const l = () => {
+      this.cameraTransitionStart || (this.needsUpdate = !0, r.render());
     };
-    return e.addEventListener("load-model", u), new Promise((o) => {
-      e.addEventListener("load-tile-set", () => {
-        u(), o(e);
+    return s.addEventListener("load-model", l), new Promise((o) => {
+      s.addEventListener("load-tile-set", () => {
+        l(), o(i);
       });
     });
   }
-  removeTiles(t) {
-    const s = this.tilesMap.get(t);
-    return s ? (s.dispose(), this.tilesMap.delete(t), this.ssp.removeObject(s.group), !0) : !1;
+  /**
+   * 移除 3D Tiles
+   * @param url - tileset.json 地址
+   * @returns boolean
+   */
+  removeTiles(e) {
+    const t = this.tilesMap.get(e);
+    return t ? (t.tiles.dispose(), this.tilesMap.delete(e), this.ssp.removeObject(t.tiles.group), !0) : !1;
+  }
+  /**
+   * 获取指定 url 的 renderer
+   */
+  getTiles(e) {
+    return this.tilesMap.get(e);
+  }
+  /**
+   * 获取所有已加载的 renderer
+   */
+  getAllTiles() {
+    return Array.from(this.tilesMap.values());
+  }
+  /**
+   * 清除所有 tiles
+   */
+  clear() {
+    this.tilesMap.forEach((e) => {
+      e.tiles.dispose(), this.ssp.removeObject(e.tiles.group);
+    }), this.tilesMap.clear();
+  }
+  invalidate(e, t, r) {
+    this.tilesMap.forEach((i) => {
+      i.invalidate(e, t, r);
+    });
+  }
+  /**
+   * 销毁插件
+   */
+  dispose() {
+    this.clear(), this.ssp.signals.beforeRender.remove(this._beforeRenderHandler), this.ssp.signals.cameraObjectChange.remove(this._onCameraObjectChange), this._lruCache = null, this._parseQueue = null, this._downloadQueue = null;
   }
 }
 export {
-  E as ArcgisTilesRenderer,
-  Q as default
+  ne as ArcgisTilesRenderer,
+  h as MaterialType,
+  B as OverlayManager,
+  a as OverlayType,
+  le as TerrainTilesRenderer,
+  g as TerrainType,
+  H as TileCustomMaterialPlugin,
+  q as TilesRenderer,
+  oe as TilesRendererManager,
+  se as default
 };