iflow-engine-base 4.0.16 → 4.0.19

package/dist/chunks/index-D7NwsYhB.js

@@ -0,0 +1,2640 @@
+import { r as te, s as F, a as re, b as ie } from "./sdk-assets-DtcFvuth.js";
+import "./engine-3d-BsWcD-bl.js";
+import { u as z, R as de, a as f, bG as ge, G as O, b as y, aX as G, k as S, bH as me, S as pe, a_ as fe, a4 as H, at as J, aU as ye, aZ as Me, au as be, ai as we, bI as ve, C as Ee } from "./three-vendor-CGmeNMm5.js";
+import { W as Se, a as Ce, r as Ie } from "./sdk-runtime-DN15bwdD.js";
+class xe {
+  constructor(e) {
+    this.engine = e;
+  }
+  engine;
+  layers = /* @__PURE__ */ new Map();
+  layerSequence = 0;
+  /** 登记图层；不同对象不得复用同一个 id，避免产生无法查询的孤立图层。 */
+  registerLayer(e) {
+    if (!e?.object?.isObject3D)
+      throw new TypeError("GIS 图层必须提供有效的 Three.js Object3D。");
+    const t = e.id?.trim() || `${e.type}-${++this.layerSequence}`, r = e.name?.trim();
+    if (!r) throw new TypeError("GIS 图层名称不能为空。");
+    const i = this.layers.get(t);
+    if (i && i.object !== e.object)
+      throw new RangeError(`GIS 图层 id 已存在：${t}`);
+    const s = {
+      id: t,
+      name: r,
+      type: e.type,
+      source: e.source,
+      object: e.object,
+      remove: e.remove
+    };
+    return this.layers.set(t, s), this.toInfo(s);
+  }
+  /** 查询全部 GIS 图层，返回快照以避免外部修改内部登记信息。 */
+  getLayers() {
+    return [...this.layers.values()].map((e) => this.toInfo(e));
+  }
+  /** 按 id 查询单个 GIS 图层。 */
+  getLayer(e) {
+    const t = this.layers.get(e);
+    return t ? this.toInfo(t) : null;
+  }
+  /** 仅合并当前可见的业务模型，避免底图、地形和标注放大回家视角。 */
+  getModelBoundingBox() {
+    const e = new z(), t = /* @__PURE__ */ new Set();
+    let r = !1;
+    return this.layers.forEach((i) => {
+      if (i.type !== "tileset" && i.type !== "model" || !i.object.visible || t.has(i.object))
+        return;
+      t.add(i.object), i.object.updateWorldMatrix(!0, !0);
+      const s = new z().setFromObject(i.object);
+      s.isEmpty() || (e.union(s), r = !0);
+    }), r ? e : null;
+  }
+  /** 设置图层显隐；图层不存在时返回 false。 */
+  setLayerVisible(e, t) {
+    const r = this.layers.get(e);
+    return r ? (r.object.visible !== t && (r.object.visible = t, this.engine.requestRender()), !0) : !1;
+  }
+  /** 开启指定图层。 */
+  showLayer(e) {
+    return this.setLayerVisible(e, !0);
+  }
+  /** 关闭指定图层，但保留已加载资源。 */
+  hideLayer(e) {
+    return this.setLayerVisible(e, !1);
+  }
+  /** 切换指定图层，返回切换后的显隐状态；图层不存在时返回 null。 */
+  toggleLayer(e) {
+    const t = this.layers.get(e);
+    if (!t) return null;
+    const r = !t.object.visible;
+    return this.setLayerVisible(e, r), r;
+  }
+  /** 注销图层登记，不移除或销毁场景资源。 */
+  unregisterLayer(e) {
+    return this.layers.delete(e);
+  }
+  /** 调用资源所有者的释放回调并移除图层；无释放回调时返回 false。 */
+  removeLayer(e) {
+    const t = this.layers.get(e);
+    return !t?.remove || t.remove() === !1 ? !1 : (this.layers.delete(e), this.engine.requestRender(), !0);
+  }
+  /** 清空登记信息；实际资源仍由各自加载器负责释放。 */
+  dispose() {
+    this.layers.clear();
+  }
+  toInfo(e) {
+    return {
+      id: e.id,
+      name: e.name,
+      type: e.type,
+      source: e.source,
+      object: e.object,
+      visible: e.object.visible
+    };
+  }
+}
+class Le {
+  constructor(e, t, r) {
+    this.engine = e, this.coordinateModule = t, this.layerManager = r, this.worldToScreen = new Se(
+      e.camera,
+      e.renderer,
+      e.scene
+    ), this.manager = new Ce({
+      container: e.container,
+      className: "bim-engine-label-container bim-engine-label-container-gis",
+      projectCoordinate: (i) => this.projectCoordinate(i),
+      pickCoordinate: (i) => this.pickCoordinate(i),
+      emitEvent: (i, s) => e.events.trigger(i, s)
+    });
+  }
+  engine;
+  coordinateModule;
+  layerManager;
+  manager;
+  worldToScreen;
+  raycaster = new de();
+  /** 进入一次选点模式，结果同时包含 WGS84 和 Three.js 世界坐标。 */
+  pickPoint() {
+    return this.manager.pickPoint();
+  }
+  /** 兼容旧版回调式选点。 */
+  startPickPoint(e) {
+    return this.manager.startPickPoint(e);
+  }
+  /** 创建 GIS 标签；经纬度按 WGS84 解释。 */
+  createLabel(e) {
+    return this.manager.createLabel(e);
+  }
+  /** 更新指定 GIS 标签。 */
+  updateLabel(e, t) {
+    return this.manager.updateLabel(e, t);
+  }
+  /** 删除指定 GIS 标签。 */
+  deleteLabel(e) {
+    return this.manager.deleteLabel(e);
+  }
+  /** deleteLabel 的兼容别名。 */
+  removeLabel(e) {
+    return this.manager.removeLabel(e);
+  }
+  /** 清空全部 GIS 标签。 */
+  clearLabels() {
+    this.manager.clearLabels();
+  }
+  /** 查询单个 GIS 标签。 */
+  getLabel(e) {
+    return this.manager.getLabel(e);
+  }
+  /** 查询全部 GIS 标签。 */
+  getLabels() {
+    return this.manager.getLabels();
+  }
+  /** 监听标签点击，并返回取消监听函数。 */
+  onLabelClick(e) {
+    return this.manager.onLabelClick(e);
+  }
+  /** 取消指定标签点击监听。 */
+  offLabelClick(e) {
+    this.manager.offLabelClick(e);
+  }
+  /** 由 GIS 共享帧循环更新标签屏幕位置。 */
+  update() {
+    this.worldToScreen.updateCamera(this.engine.camera), this.manager.update();
+  }
+  /** 释放 DOM、选点监听和标签数据。 */
+  dispose() {
+    this.manager.dispose();
+  }
+  projectCoordinate(e) {
+    const t = this.resolveWorldCoordinate(e);
+    if (!t) return null;
+    const r = this.worldToScreen.worldToScreenIfVisible(t);
+    return r ? { x: r.x, y: r.y, visible: !0 } : null;
+  }
+  resolveWorldCoordinate(e) {
+    return Number.isFinite(e.longitude) && Number.isFinite(e.latitude) ? this.coordinateModule.toWorld({
+      longitude: e.longitude,
+      latitude: e.latitude,
+      height: e.height ?? 0
+    }) : [e.x, e.y, e.z].every(Number.isFinite) ? new f(e.x, e.y, e.z) : null;
+  }
+  pickCoordinate(e) {
+    const t = this.engine.renderer.domElement.getBoundingClientRect(), r = this.worldToScreen.screenToNormalized(
+      e.clientX - t.left,
+      e.clientY - t.top
+    );
+    this.raycaster.setFromCamera(r, this.engine.camera);
+    const i = this.layerManager.getLayers().filter((c) => c.visible).map((c) => c.object), s = this.raycaster.intersectObjects(this.uniqueObjects(i), !0), a = this.engine.octreeBox?.rayInterationModel?.(
+      this.raycaster,
+      !0,
+      !1
+    ), o = [...s, ...a ?? []].filter((c) => c?.point instanceof f).sort((c, m) => c.distance - m.distance)[0];
+    if (!o) return null;
+    const l = this.coordinateModule.toWgs84(o.point);
+    return {
+      x: o.point.x,
+      y: o.point.y,
+      z: o.point.z,
+      ...l
+    };
+  }
+  uniqueObjects(e) {
+    const t = new Set(e);
+    return e.filter((r) => {
+      let i = r.parent;
+      for (; i; ) {
+        if (t.has(i)) return !1;
+        i = i.parent;
+      }
+      return !0;
+    });
+  }
+}
+class Re {
+  constructor(e, t) {
+    this.cameraModule = e, this.initialView = t;
+  }
+  cameraModule;
+  initialView;
+  mainView = null;
+  /** 切换底图重建相机模块后更新引用，同时保留已经保存的主视角。 */
+  setCameraModule(e) {
+    this.cameraModule = e;
+  }
+  /** 保存用户当前实际相机姿态，而不是上一次 API 写入的缓存。 */
+  saveMainViewPort() {
+    return this.mainView = this.cameraModule.getView(), { ...this.mainView };
+  }
+  /** 设置主视角并立即应用；null 表示清除已保存视角。 */
+  setMainViewPort(e) {
+    if (!e) {
+      this.mainView = null;
+      return;
+    }
+    const t = this.cameraModule.getView();
+    this.mainView = {
+      ...t,
+      ...e
+    }, this.cameraModule.setView(this.mainView);
+  }
+  /** 平滑飞行到已保存的主视角；未保存时保持当前视图。 */
+  async goToMainPort(e) {
+    this.mainView && await this.cameraModule.flyTo(this.mainView, e);
+  }
+  /** 清除主视角并回到初始化视图。 */
+  resetMainViewPort() {
+    this.mainView = null, this.cameraModule.setView(this.initialView);
+  }
+  /** 查询已保存主视角的独立快照。 */
+  getMainViewPort() {
+    return this.mainView ? { ...this.mainView } : null;
+  }
+}
+function Pe() {
+  return se(new ge());
+}
+function se(n, e = []) {
+  const t = n;
+  return t.isClippingGroup !== !0 && Object.defineProperty(t, "isClippingGroup", {
+    value: !0,
+    enumerable: !0
+  }), t.clippingPlanes = e, t.enabled = !0, t.clipIntersection = !1, t.clipShadows = !1, t;
+}
+const U = "__isModelUrlGroup", D = "__modelDepthBias", ne = 4, Te = 5e5;
+function ae(n) {
+  return n.__modelGroupMap instanceof Map || (n.__modelGroupMap = /* @__PURE__ */ new Map()), n.__modelGroupMap;
+}
+function oe(n) {
+  return n.__modelObjectIndexMap instanceof Map || (n.__modelObjectIndexMap = /* @__PURE__ */ new Map()), n.__modelObjectIndexMap;
+}
+function N(n, e) {
+  n.url = e, n.name = e, n.userData = n.userData ?? {}, n.userData[U] = !0;
+}
+function _(n, e) {
+  return n instanceof O ? e == null ? n.userData?.[U] === !0 : n.userData?.[U] === !0 && n.url === e : !1;
+}
+function q(n, e) {
+  return n?.models?.find?.((t) => t?.url === e);
+}
+function nt(n, e, t) {
+  if (typeof t != "string" || t.length === 0)
+    return;
+  const r = q(n, e);
+  r != null && (Array.isArray(r.urls) || (r.urls = []), r.urls.includes(t) || r.urls.push(t));
+}
+function b(n, e) {
+  const t = ae(n), r = t.get(e);
+  if (r && r.parent != null)
+    return r;
+  const i = q(n, e);
+  if (i?.group instanceof O && i.group.parent != null)
+    return N(i.group, e), t.set(e, i.group), i.group;
+  const s = n?.scene?.children?.find?.((a) => a instanceof O ? _(a, e) ? !0 : a.name === e && a.url === e : !1);
+  return s != null ? (N(s, e), t.set(e, s), i != null && (i.group = s), s) : null;
+}
+function at(n, e) {
+  const t = b(n, e);
+  return t == null ? new y() : (t.updateWorldMatrix(!0, !1), t.matrixWorld.clone());
+}
+function ot(n, e) {
+  const t = typeof n.__getActiveWebGPUClippingPlanes == "function" ? n.__getActiveWebGPUClippingPlanes() : n.sectionPlane, r = b(n, e);
+  if (r != null) {
+    const o = se(r, t);
+    return o.clipShadows = !0, o;
+  }
+  const i = Pe();
+  i.clippingPlanes = Array.isArray(t) ? t : [], i.clipIntersection = !1, i.clipShadows = !0, N(i, e), n.scene.add(i), ae(n).set(e, i);
+  const a = q(n, e);
+  return a != null && (a.group = i), i;
+}
+function ke(n) {
+  const e = [], t = /* @__PURE__ */ new Set();
+  return (Array.isArray(n?.models) ? n.models : []).forEach((i) => {
+    if (i?.url == null)
+      return;
+    const s = b(n, i.url);
+    s == null || t.has(s.uuid) || (t.add(s.uuid), e.push(s));
+  }), n?.scene?.children?.forEach?.((i) => {
+    !_(i) || t.has(i.uuid) || (t.add(i.uuid), e.push(i));
+  }), e;
+}
+function le(n, e) {
+  const t = [], r = /* @__PURE__ */ new Set();
+  return ke(n).forEach((s) => {
+    s.traverse((a) => {
+      a === s || r.has(a.uuid) || e(a) && (r.add(a.uuid), t.push(a));
+    });
+  }), n?.scene?.children?.forEach?.((s) => {
+    if (s.name == "highlightModel")
+      r.add(s.uuid), t.push(s);
+    else {
+      if (r.has(s.uuid) || _(s) || s.url == null)
+        return;
+      e(s) && (r.add(s.uuid), t.push(s));
+    }
+  }), t;
+}
+function Ae(n) {
+  if (typeof n.__modelObjectIndexSeed == "number")
+    return;
+  let e = -1;
+  n?.scene?.traverse?.((t) => {
+    typeof t?.index == "number" && Number.isFinite(t.index) && (e = Math.max(e, t.index));
+  }), n.__modelObjectIndexSeed = e + 1;
+}
+function Be(n) {
+  Ae(n);
+  const e = n.__modelObjectIndexSeed;
+  return n.__modelObjectIndexSeed += 1, e;
+}
+function lt(n, e, t) {
+  const r = typeof t == "number" ? t : Be(n);
+  return e.index = r, oe(n).set(r, e), r;
+}
+function ut(n) {
+  n.updateMatrix(), n.matrixAutoUpdate = !1;
+}
+function Ge(n) {
+  return Number.isFinite(n) && n >= 3;
+}
+function ht(n, e) {
+  return e <= Te && Ge(n);
+}
+function ue(n) {
+  return Array.isArray(n) ? n : n != null ? [n] : [];
+}
+function Fe(n) {
+  return 1 + (Number.isFinite(n) ? Math.abs(Math.floor(n)) : 0) % 16 * 0.125;
+}
+function ct(n, e, t = !1) {
+  const r = typeof e == "number" ? e : n?.index, i = Fe(r), s = t ? -1 : 1;
+  ue(n?.material).forEach((a) => {
+    a.userData = a.userData ?? {};
+    const o = a.userData[D] ?? {};
+    a.userData[D] = {
+      ...o,
+      enabled: !0,
+      factor: 1,
+      units: i
+    }, a.polygonOffset = !0, a.polygonOffsetFactor = s, a.polygonOffsetUnits = s * (i + (o.edgeActive ? ne : 0)), a.needsUpdate = !0;
+  });
+}
+function dt(n, e, t = !1) {
+  const r = t ? -1 : 1;
+  ue(n?.material).forEach((i) => {
+    i.userData = i.userData ?? {};
+    const s = i.userData[D] ?? {}, a = s.enabled ? s.units : i.polygonOffsetUnits ?? 0, o = s.enabled ? s.factor : i.polygonOffsetFactor ?? 1;
+    i.userData[D] = {
+      ...s,
+      edgeActive: e
+    }, s.enabled || e ? (i.polygonOffset = !0, i.polygonOffsetFactor = r * Math.abs(o), i.polygonOffsetUnits = r * (Math.abs(a) + (e ? ne : 0))) : i.polygonOffset = !1, i.needsUpdate = !0;
+  });
+}
+function gt(n, e) {
+  if (!Number.isFinite(e))
+    return;
+  const t = oe(n), r = t.get(e);
+  if (r && r.parent != null)
+    return r;
+  r && r.parent == null && t.delete(e);
+  const i = le(n, (s) => s.index === e)[0];
+  return i != null ? (t.set(e, i), i) : n?.scene?.children?.find?.((s) => s?.index === e);
+}
+class Oe {
+  constructor(e, t) {
+    this.engine = e, this.coordinateModule = t;
+  }
+  engine;
+  coordinateModule;
+  records = /* @__PURE__ */ new Map();
+  /** 登记附加 3D Tiles；根节点就绪后再冻结加载完成矩阵作为校准基准。 */
+  registerTileset(e, t, r, i, s = !0) {
+    const a = this.createRecord(e, t, r, "3dtiles", i.group);
+    return a.tiles = i, this.records.set(e, a), s && this.captureBaseState(a), this.cloneItem(a.item);
+  }
+  /** 高度偏移和根瓦片变换完成后，记录最终加载矩阵。 */
+  markTilesetReady(e) {
+    const t = [...this.records.values()].find((r) => r.tiles === e);
+    return t ? (this.captureBaseState(t), !0) : !1;
+  }
+  /** 登记普通 BIM 模型；模型 URL 默认同时作为校准 id。 */
+  registerBimModel(e, t = {}) {
+    const r = b(this.engine, e);
+    if (!r) throw new Error(`BIM 模型尚未加载，无法登记校准：${e}`);
+    const i = t.id?.trim() || e, s = this.createRecord(i, t.name?.trim() || e, e, "bim", r);
+    return s.bimUrl = e, this.records.set(i, s), this.captureBaseState(s), this.cloneItem(s.item);
+  }
+  /** 查询全部模型校准状态快照。 */
+  getItems() {
+    return [...this.records.values()].map((e) => this.cloneItem(e.item));
+  }
+  /** 查询单个模型校准状态。 */
+  getItem(e) {
+    const t = this.records.get(e);
+    return t ? this.cloneItem(t.item) : null;
+  }
+  /**
+   * 从基准矩阵应用 ENU 偏移与旋转。
+   * 每次都从 baseMatrix 重算，避免滑块连续调整时累计产生水平漂移。
+   */
+  setTransform(e) {
+    let t = this.records.get(e.id);
+    if (!t && b(this.engine, e.id) && (this.registerBimModel(e.id), t = this.records.get(e.id)), !t) return !1;
+    if (!t.item.ready || !t.baseMatrix || !t.anchorWorld)
+      throw new Error(`模型校准基准尚未就绪：${e.id}`);
+    const r = this.resolveOffset(e.offset, t.item.offset), i = this.resolveRotation(e.rotation, t.item.rotation), s = this.buildCalibratedLocalMatrix(t, r, i);
+    return this.applyMatrix(t, s) ? (t.item.offset = r, t.item.rotation = i, this.emitChanged(t.item, "apply"), !0) : !1;
+  }
+  /** 恢复模型登记时的矩阵。 */
+  reset(e) {
+    const t = this.records.get(e);
+    return !t?.baseMatrix || !this.applyMatrix(t, t.baseMatrix) ? !1 : (t.item.offset = this.zeroOffset(), t.item.rotation = this.zeroRotation(), this.emitChanged(t.item, "reset"), !0);
+  }
+  /** 移除模型的校准记录，不改变模型当前矩阵。 */
+  unregister(e) {
+    return this.records.delete(e);
+  }
+  /** 释放内部快照，模型资源仍由各自加载器管理。 */
+  dispose() {
+    this.records.clear();
+  }
+  createRecord(e, t, r, i, s) {
+    return {
+      item: {
+        id: e,
+        name: t,
+        source: r,
+        type: i,
+        offset: this.zeroOffset(),
+        rotation: this.zeroRotation(),
+        baseMatrix: new y().toArray(),
+        ready: !1
+      },
+      object: s,
+      baseMatrix: null,
+      anchorWorld: null
+    };
+  }
+  captureBaseState(e) {
+    e.object.matrixAutoUpdate && e.object.updateMatrix(), e.object.updateWorldMatrix(!0, !0), e.baseMatrix = e.object.matrix.clone(), e.anchorWorld = this.readAnchorWorld(e), e.item.baseMatrix = e.baseMatrix.toArray(), e.item.ready = !0, e.item.offset = this.zeroOffset(), e.item.rotation = this.zeroRotation();
+  }
+  readAnchorWorld(e) {
+    if (e.tiles) {
+      const r = new G();
+      if (e.tiles.getBoundingSphere(r))
+        return r.center.applyMatrix4(e.object.matrixWorld);
+    }
+    const t = new z().setFromObject(e.object);
+    return t.isEmpty() ? e.object.getWorldPosition(new f()) : t.getCenter(new f());
+  }
+  buildCalibratedLocalMatrix(e, t, r) {
+    const i = e.anchorWorld, s = this.coordinateModule.toWgs84(i), { east: a, north: o, up: l } = this.coordinateModule.getEastNorthUpAxes(s), c = a.clone().multiplyScalar(t.east).addScaledVector(o, t.north).addScaledVector(l, t.up), m = new y().multiply(new y().makeRotationAxis(l, S.degToRad(r.heading))).multiply(new y().makeRotationAxis(a, S.degToRad(r.pitch))).multiply(new y().makeRotationAxis(o, S.degToRad(r.roll))), u = new y().makeTranslation(...c.toArray()).multiply(new y().makeTranslation(...i.toArray())).multiply(m).multiply(new y().makeTranslation(...i.clone().negate().toArray()));
+    e.object.parent?.updateWorldMatrix(!0, !1);
+    const g = e.object.parent?.matrixWorld.clone() ?? new y(), h = g.clone().multiply(e.baseMatrix);
+    return g.invert().multiply(u).multiply(h);
+  }
+  applyMatrix(e, t) {
+    return e.item.type === "bim" ? this.engine.calibration.apply({
+      url: e.bimUrl,
+      matrix: t
+    }) : (e.object.matrixAutoUpdate = !1, e.object.matrix.copy(t), e.object.matrixWorldNeedsUpdate = !0, e.object.updateMatrixWorld(!0), this.engine.requestRender(), !0);
+  }
+  resolveOffset(e, t) {
+    return {
+      east: this.numberOrCurrent(e?.east, t.east),
+      north: this.numberOrCurrent(e?.north, t.north),
+      up: this.numberOrCurrent(e?.up, t.up)
+    };
+  }
+  resolveRotation(e, t) {
+    return {
+      heading: this.numberOrCurrent(e?.heading, t.heading),
+      pitch: this.numberOrCurrent(e?.pitch, t.pitch),
+      roll: this.numberOrCurrent(e?.roll, t.roll)
+    };
+  }
+  numberOrCurrent(e, t) {
+    if (e === void 0) return t;
+    if (!Number.isFinite(e)) throw new RangeError("模型校准参数必须是有限数值。");
+    return Math.abs(e) < 1e-10 ? 0 : e;
+  }
+  emitChanged(e, t) {
+    this.engine.events.trigger("gis:calibration:changed", {
+      ...this.cloneItem(e),
+      action: t,
+      timestamp: Date.now()
+    });
+  }
+  cloneItem(e) {
+    return {
+      ...e,
+      offset: { ...e.offset },
+      rotation: { ...e.rotation },
+      baseMatrix: [...e.baseMatrix]
+    };
+  }
+  zeroOffset() {
+    return { east: 0, north: 0, up: 0 };
+  }
+  zeroRotation() {
+    return { heading: 0, pitch: 0, roll: 0 };
+  }
+}
+const I = Math.PI / 180;
+class De {
+  constructor(e, t, r, i) {
+    this.engine = e, this.tiles = t, this.layerManager = r, this.calibrationManager = i;
+  }
+  engine;
+  tiles;
+  layerManager;
+  calibrationManager;
+  records = /* @__PURE__ */ new Map();
+  inverseParentMatrix = new y();
+  /** 切换底图后更新地理参考，已有 BIM 模型的世界定位保持不变。 */
+  setTiles(e) {
+    this.tiles = e;
+  }
+  /** 定位已加载模型；模型本地 +Y 为上方，heading 从正北向东顺时针增加。 */
+  setPosition(e, t) {
+    this.assertUrl(e);
+    const r = this.resolvePosition(t), i = this.requireModelGroup(e), s = this.records.get(e), a = s?.groupUuid === i.uuid ? s.originalMatrix : i.matrix.clone(), o = this.tiles.ellipsoid.getObjectFrame(
+      r.latitude * I,
+      r.longitude * I,
+      r.height,
+      r.heading * I,
+      r.pitch * I,
+      r.roll * I,
+      new y()
+    );
+    if (this.tiles.group.updateWorldMatrix(!0, !1), o.premultiply(this.tiles.group.matrixWorld), i.parent && (i.parent.updateWorldMatrix(!0, !1), this.inverseParentMatrix.copy(i.parent.matrixWorld).invert(), o.premultiply(this.inverseParentMatrix)), !this.engine.calibration.apply({ url: e, matrix: o }))
+      throw new Error(`模型定位失败：${e}`);
+    this.records.set(e, {
+      groupUuid: i.uuid,
+      originalMatrix: a.clone(),
+      position: { ...r }
+    });
+    const l = this.getLayerId(e);
+    return this.layerManager?.unregisterLayer(l), this.layerManager?.registerLayer({
+      id: l,
+      name: e,
+      type: "model",
+      source: e,
+      object: i
+    }), this.calibrationManager?.registerBimModel(e, { name: e }), { ...r };
+  }
+  /** 模型未加载时先通过 v3 Loader 加载，再应用地理定位。 */
+  async loadAndPosition(e, t, r) {
+    return this.assertUrl(e), b(this.engine, e) || await this.engine.loaderModule.loadModels([e], r), this.setPosition(e, t);
+  }
+  /** 获取指定模型最近一次由本管理器应用的定位信息。 */
+  getPosition(e) {
+    const t = this.records.get(e), r = b(this.engine, e);
+    return !t || r?.uuid !== t.groupUuid ? null : { ...t.position };
+  }
+  /** 恢复模型定位前的根分组矩阵。 */
+  resetPosition(e) {
+    const t = this.records.get(e), r = b(this.engine, e);
+    return !t || !r || r.uuid !== t.groupUuid ? (this.records.delete(e), this.layerManager?.unregisterLayer(this.getLayerId(e)), !1) : this.engine.calibration.apply({ url: e, matrix: t.originalMatrix }) ? (this.records.delete(e), this.layerManager?.unregisterLayer(this.getLayerId(e)), this.calibrationManager?.unregister(e), !0) : !1;
+  }
+  /** 释放内部记录；模型资源由引擎统一管理。 */
+  dispose() {
+    this.records.forEach((e, t) => {
+      this.layerManager?.unregisterLayer(this.getLayerId(t)), this.calibrationManager?.unregister(t);
+    }), this.records.clear();
+  }
+  requireModelGroup(e) {
+    const t = b(this.engine, e);
+    if (!t) throw new Error(`模型尚未加载，无法定位：${e}`);
+    return t;
+  }
+  resolvePosition(e) {
+    if (!e || !Number.isFinite(e.latitude) || e.latitude < -90 || e.latitude > 90)
+      throw new RangeError("纬度必须是 -90 到 90 之间的有限数值。");
+    if (!Number.isFinite(e.longitude))
+      throw new RangeError("经度必须是有限数值。");
+    const t = e.height ?? 0, r = e.heading ?? 0, i = e.pitch ?? 0, s = e.roll ?? 0;
+    if (![t, r, i, s].every(Number.isFinite))
+      throw new RangeError("高度和模型朝向必须是有限数值。");
+    if (i < -90 || i > 90)
+      throw new RangeError("俯仰角必须是 -90 到 90 之间的有限数值。");
+    return {
+      longitude: this.normalizeAngle(e.longitude),
+      latitude: e.latitude,
+      height: t,
+      heading: this.normalizeAngle(r),
+      pitch: i,
+      roll: this.normalizeAngle(s)
+    };
+  }
+  assertUrl(e) {
+    if (typeof e != "string" || e.trim().length === 0)
+      throw new TypeError("模型 URL 不能为空。");
+  }
+  normalizeAngle(e) {
+    return ((e + 180) % 360 + 360) % 360 - 180;
+  }
+  getLayerId(e) {
+    return `model:${e}`;
+  }
+}
+const T = {
+  preset: "noon_clear",
+  params: {
+    cloudSpeed: 0,
+    cloudCoverage: 0,
+    cloudDensity: 0
+  },
+  intensity: 0.2
+}, Ve = "4";
+class je {
+  constructor(e) {
+    this.engine = e;
+  }
+  engine;
+  cubeTextureLoader = new me();
+  skyBoxTexture = null;
+  savedSceneState = null;
+  skyBoxLoadVersion = 0;
+  skyBoxType = null;
+  /** 应用天空配置；传 false 时关闭并保留资源，便于后续快速恢复。 */
+  setSky(e = !0) {
+    if (this.clearSkyBox(), e === !1) {
+      this.hide();
+      return;
+    }
+    const t = e === !0 ? {} : e, r = {
+      preset: t.preset ?? T.preset,
+      params: { ...T.params, ...t.params },
+      intensity: t.intensity ?? T.intensity
+    };
+    r.preset && this.engine.skyManager.setPreset(r.preset), r.params && this.engine.skyManager.setParams(r.params), r.intensity !== void 0 && this.setIntensity(r.intensity), this.engine.skyManager.isActive() || this.engine.skyManager.activate();
+  }
+  /** 显示天空，并可同时覆盖预设、参数和环境光强度。 */
+  show(e = {}) {
+    this.setSky(e);
+  }
+  /** 设置内置 HDR 或六面图天空盒，未传配置时使用内置晴空。 */
+  async setSkyBox(e = {}) {
+    this.validateSkyBoxOptions(e);
+    const t = ++this.skyBoxLoadVersion;
+    if (!("urls" in e)) {
+      this.releaseCubeSkyBox(), this.engine.skyManager.close(!1);
+      const o = e.id ?? Ve;
+      if (await this.engine.hdr.setHdr(o), t !== this.skyBoxLoadVersion) {
+        this.skyBoxType !== "hdr" && this.engine.hdr.getCurrentHdrId() === o && await this.engine.hdr.setHdr("0");
+        return;
+      }
+      this.engine.hdr.setIntensity(e.intensity ?? T.intensity), this.engine.hdr.setBackgroundIntensity(e.backgroundIntensity ?? 1), this.engine.hdr.setVisible(!0), this.skyBoxType = "hdr";
+      return;
+    }
+    const r = await this.cubeTextureLoader.loadAsync([...e.urls]);
+    if (t !== this.skyBoxLoadVersion) {
+      r.dispose();
+      return;
+    }
+    r.colorSpace = pe, this.skyBoxType === "hdr" && this.engine.hdr.setHdr("0"), this.engine.skyManager.close(!1), this.captureSceneState(), this.skyBoxTexture?.dispose(), this.skyBoxTexture = r, this.skyBoxType = "cube";
+    const i = this.engine.scene, s = e.intensity ?? 1, a = S.degToRad(e.rotation ?? 0);
+    i.background = r, i.environment = r, i.backgroundIntensity = s, i.environmentIntensity = s, i.backgroundBlurriness = e.blurriness ?? 0, i.backgroundRotation.set(0, a, 0), i.environmentRotation.set(0, a, 0), this.refreshScene();
+  }
+  /** 清除天空盒并恢复设置前的场景背景和环境光。 */
+  clearSkyBox() {
+    this.skyBoxLoadVersion += 1, this.skyBoxType === "hdr" && (this.engine.hdr.setHdr("0"), this.skyBoxType = null), this.releaseCubeSkyBox();
+  }
+  releaseCubeSkyBox() {
+    if (!this.savedSceneState && !this.skyBoxTexture) return;
+    const e = this.engine.scene;
+    this.savedSceneState && (e.background = this.savedSceneState.background, e.environment = this.savedSceneState.environment, e.backgroundIntensity = this.savedSceneState.backgroundIntensity, e.environmentIntensity = this.savedSceneState.environmentIntensity, e.backgroundBlurriness = this.savedSceneState.backgroundBlurriness, e.backgroundRotation.copy(this.savedSceneState.backgroundRotation), e.environmentRotation.copy(this.savedSceneState.environmentRotation)), this.savedSceneState = null, this.skyBoxTexture?.dispose(), this.skyBoxTexture = null, this.skyBoxType = null, this.refreshScene();
+  }
+  /** 返回 HDR 或六面图天空盒是否已经应用到场景。 */
+  isSkyBoxActive() {
+    return this.skyBoxType === "hdr" ? this.engine.hdr.getVisible() && this.engine.hdr.getCurrentHdrId() !== "0" : this.skyBoxTexture !== null && this.engine.scene.background === this.skyBoxTexture;
+  }
+  /** 隐藏当前天空；天空盒纹理会立即释放，物理天空可按需保留资源。 */
+  hide(e = !1) {
+    if (this.skyBoxType !== null) {
+      this.clearSkyBox();
+      return;
+    }
+    this.engine.skyManager.close(e);
+  }
+  /** 切换 v3 引擎内置天空预设。 */
+  setPreset(e) {
+    this.clearSkyBox(), this.engine.skyManager.setPreset(e), this.engine.skyManager.isActive() || this.engine.skyManager.activate();
+  }
+  /** 增量修改太阳、云层和大气参数。 */
+  setParams(e) {
+    this.clearSkyBox(), this.engine.skyManager.setParams(e), this.engine.skyManager.isActive() || this.engine.skyManager.activate();
+  }
+  /** 设置天空生成的环境光强度。 */
+  setIntensity(e) {
+    if (!Number.isFinite(e) || e < 0)
+      throw new RangeError("天空环境光强度必须是大于或等于 0 的有限数值。");
+    if (this.skyBoxType === "hdr") {
+      this.engine.hdr.setIntensity(e), this.engine.hdr.setBackgroundIntensity(e);
+      return;
+    }
+    if (this.skyBoxType === "cube") {
+      this.engine.scene.backgroundIntensity = e, this.engine.scene.environmentIntensity = e, this.refreshScene();
+      return;
+    }
+    this.engine.skyManager.setIntensity(e);
+  }
+  /** 返回当前天空是否可见。 */
+  isActive() {
+    return this.isSkyBoxActive() || this.engine.skyManager.isActive();
+  }
+  /** 释放 GIS 天空资源，v3 引擎销毁时仍会执行兜底清理。 */
+  dispose() {
+    this.clearSkyBox(), this.engine.skyManager.close(!0);
+  }
+  captureSceneState() {
+    if (this.savedSceneState) return;
+    const e = this.engine.scene;
+    this.savedSceneState = {
+      background: e.background,
+      environment: e.environment,
+      backgroundIntensity: e.backgroundIntensity,
+      environmentIntensity: e.environmentIntensity,
+      backgroundBlurriness: e.backgroundBlurriness,
+      backgroundRotation: e.backgroundRotation.clone(),
+      environmentRotation: e.environmentRotation.clone()
+    };
+  }
+  validateSkyBoxOptions(e) {
+    if ("urls" in e && (e.urls.length !== 6 || e.urls.some((t) => !t.trim())))
+      throw new TypeError("GIS 天空盒必须提供右、左、上、下、前、后共 6 张图片。");
+    if (e.intensity !== void 0 && (!Number.isFinite(e.intensity) || e.intensity < 0))
+      throw new RangeError("天空盒亮度必须是大于或等于 0 的有限数值。");
+    if ("blurriness" in e && e.blurriness !== void 0 && (!Number.isFinite(e.blurriness) || e.blurriness < 0 || e.blurriness > 1))
+      throw new RangeError("天空盒模糊度必须是 0 到 1 之间的有限数值。");
+    if ("rotation" in e && e.rotation !== void 0 && !Number.isFinite(e.rotation))
+      throw new RangeError("天空盒旋转角度必须是有限数值。");
+    if ("backgroundIntensity" in e && e.backgroundIntensity !== void 0 && (!Number.isFinite(e.backgroundIntensity) || e.backgroundIntensity < 0))
+      throw new RangeError("天空盒背景亮度必须是大于或等于 0 的有限数值。");
+  }
+  refreshScene() {
+    this.engine.composerModule?.rebuild?.(), this.engine.requestComposerRender?.();
+  }
+}
+const V = {
+  latitude: 35.6812,
+  longitude: 139.8,
+  height: 500,
+  heading: -90,
+  pitch: -10,
+  roll: 0
+}, x = Math.PI / 180;
+class Y {
+  constructor(e, t, r, i, s = V, a) {
+    this.camera = e, this.tiles = t, this.cameraFrame = r, this.requestRender = i, this.coordinateModule = a, this.camera.near = 0.1, this.camera.far = 1e7, this.camera.updateProjectionMatrix(), this.currentView = this.resolveView(s), this.applyView(this.currentView);
+  }
+  camera;
+  tiles;
+  cameraFrame;
+  requestRender;
+  coordinateModule;
+  controls = null;
+  currentView = { ...V };
+  inverseParentMatrix = new y();
+  flight = null;
+  controlsEnabledBeforeFlight = !0;
+  disposed = !1;
+  /** 绑定地球控制器，使跳转期间禁用输入并在结束后同步控制状态。 */
+  setControls(e) {
+    this.controls?.removeEventListener("change", this.handleControlsChange), this.controls = e, e.addEventListener("change", this.handleControlsChange), e.resetState();
+  }
+  /** 立即跳转到指定经纬度。 */
+  setView(e) {
+    this.cancelFlight("新的视图跳转已替代当前飞行。"), this.currentView = this.resolveView(e), this.applyView(this.currentView), this.controls?.resetState();
+  }
+  /** 平滑飞行到指定经纬度，默认动画时长为 1.5 秒。 */
+  flyTo(e, t = {}) {
+    if (this.disposed) return Promise.reject(new Error("GIS 相机模块已销毁。"));
+    if (this.cancelFlight("新的视图跳转已替代当前飞行。"), t.signal?.aborted)
+      return Promise.reject(new DOMException("GIS 相机飞行已取消。", "AbortError"));
+    this.syncViewFromCamera();
+    const r = this.resolveView(e), i = Math.max(0, Math.min(6e4, t.durationMs ?? 1500));
+    return i === 0 ? (this.setView(r), Promise.resolve()) : (this.controlsEnabledBeforeFlight = this.controls?.enabled ?? !0, this.controls && (this.controls.enabled = !1), new Promise((s, a) => {
+      const o = {
+        start: { ...this.currentView },
+        end: r,
+        startedAt: performance.now(),
+        durationMs: i,
+        resolve: s,
+        reject: a,
+        signal: t.signal
+      };
+      t.signal && (o.abortHandler = () => this.cancelFlight("GIS 相机飞行已取消。", !0), t.signal.addEventListener("abort", o.abortHandler, { once: !0 })), this.flight = o, this.requestRender();
+    }));
+  }
+  /** 返回当前已经应用到相机的 WGS84 视图。 */
+  getView() {
+    return this.syncViewFromCamera(), { ...this.currentView };
+  }
+  /** 取消当前飞行，并恢复跳转前的控制器状态。 */
+  cancelFlight(e = "GIS 相机飞行已取消。", t = !1) {
+    const r = this.flight;
+    return r ? (this.flight = null, this.cleanupFlight(r), r.reject(t ? new DOMException(e, "AbortError") : new Error(e)), !0) : !1;
+  }
+  /** 由 GIS 共享渲染循环调用，推进当前相机飞行动画。 */
+  update(e) {
+    const t = this.flight;
+    if (!t) return;
+    const r = Math.min(1, Math.max(0, (e - t.startedAt) / t.durationMs)), i = r < 0.5 ? 4 * r * r * r : 1 - Math.pow(-2 * r + 2, 3) / 2;
+    this.currentView = {
+      latitude: this.lerp(t.start.latitude, t.end.latitude, i),
+      longitude: this.lerpAngle(t.start.longitude, t.end.longitude, i),
+      height: this.lerp(t.start.height, t.end.height, i),
+      heading: this.lerpAngle(t.start.heading, t.end.heading, i),
+      pitch: this.lerp(t.start.pitch, t.end.pitch, i),
+      roll: this.lerpAngle(t.start.roll, t.end.roll, i)
+    }, this.applyView(this.currentView), r === 1 && (this.currentView = { ...t.end }, this.flight = null, this.cleanupFlight(t), this.controls?.resetState(), t.resolve());
+  }
+  /** 释放飞行任务持有的事件和控制器状态。 */
+  dispose() {
+    this.disposed || (this.disposed = !0, this.cancelFlight("GIS 相机模块已销毁。"), this.controls?.removeEventListener("change", this.handleControlsChange), this.controls = null);
+  }
+  /** 用户通过 GlobeControls 改变相机后，同步真实地理视图供保存和后续飞行使用。 */
+  handleControlsChange = () => {
+    this.flight || this.syncViewFromCamera();
+  };
+  syncViewFromCamera() {
+    !this.coordinateModule || this.flight || (this.currentView = this.coordinateModule.getCameraView(this.camera));
+  }
+  resolveView(e) {
+    if (!Number.isFinite(e.latitude) || e.latitude < -90 || e.latitude > 90)
+      throw new RangeError("纬度必须是 -90 到 90 之间的有限数值。");
+    if (!Number.isFinite(e.longitude))
+      throw new RangeError("经度必须是有限数值。");
+    const t = e.height ?? this.currentView.height, r = e.heading ?? this.currentView.heading, i = e.pitch ?? this.currentView.pitch, s = e.roll ?? this.currentView.roll;
+    if (![t, r, i, s].every(Number.isFinite))
+      throw new RangeError("高度和相机朝向必须是有限数值。");
+    return {
+      latitude: e.latitude,
+      longitude: this.normalizeAngle(e.longitude),
+      height: Math.max(1, t),
+      heading: this.normalizeAngle(r),
+      pitch: Math.max(-90, Math.min(90, i)),
+      roll: this.normalizeAngle(s)
+    };
+  }
+  applyView(e) {
+    this.tiles.ellipsoid.getObjectFrame(
+      e.latitude * x,
+      e.longitude * x,
+      e.height,
+      e.heading * x,
+      e.pitch * x,
+      e.roll * x,
+      this.camera.matrix,
+      this.cameraFrame
+    ), this.tiles.group.updateWorldMatrix(!0, !1), this.camera.matrix.premultiply(this.tiles.group.matrixWorld), this.camera.parent && (this.camera.parent.updateWorldMatrix(!0, !1), this.inverseParentMatrix.copy(this.camera.parent.matrixWorld).invert(), this.camera.matrix.premultiply(this.inverseParentMatrix)), this.camera.matrix.decompose(this.camera.position, this.camera.quaternion, this.camera.scale), this.camera.updateMatrixWorld(!0), this.requestRender();
+  }
+  cleanupFlight(e) {
+    e.signal && e.abortHandler && e.signal.removeEventListener("abort", e.abortHandler), this.controls && (this.controls.enabled = this.controlsEnabledBeforeFlight);
+  }
+  lerp(e, t, r) {
+    return e + (t - e) * r;
+  }
+  lerpAngle(e, t, r) {
+    const i = this.normalizeAngle(t - e);
+    return this.normalizeAngle(e + i * r);
+  }
+  normalizeAngle(e) {
+    return ((e + 180) % 360 + 360) % 360 - 180;
+  }
+}
+const k = Math.PI / 180, E = 180 / Math.PI;
+class ze {
+  constructor(e, t) {
+    this.tiles = e, this.cameraFrame = t;
+  }
+  tiles;
+  cameraFrame;
+  inverseTilesMatrix = new y();
+  /** 切换底图后更新坐标参考，但保持依赖此模块的业务管理器不变。 */
+  setTiles(e, t) {
+    this.tiles = e, this.cameraFrame = t;
+  }
+  /** 将 WGS84 经纬高转换为 Three.js 世界坐标。 */
+  toWorld(e, t = new f()) {
+    const r = this.normalizeCoordinate(e);
+    return this.tiles.ellipsoid.getCartographicToPosition(
+      r.latitude * k,
+      r.longitude * k,
+      r.height,
+      t
+    ), this.tiles.group.updateWorldMatrix(!0, !1), t.applyMatrix4(this.tiles.group.matrixWorld);
+  }
+  /** 将 Three.js 世界坐标反算为 WGS84 经纬高。 */
+  toWgs84(e) {
+    this.tiles.group.updateWorldMatrix(!0, !1), this.inverseTilesMatrix.copy(this.tiles.group.matrixWorld).invert();
+    const t = e instanceof f ? e.clone() : new f(e.x, e.y, e.z);
+    t.applyMatrix4(this.inverseTilesMatrix);
+    const r = this.tiles.ellipsoid.getPositionToCartographic(t, {});
+    return {
+      longitude: r.lon * E,
+      latitude: r.lat * E,
+      height: r.height
+    };
+  }
+  /** 从相机当前真实世界矩阵读取 WGS84 位置和姿态。 */
+  getCameraView(e) {
+    e.updateWorldMatrix(!0, !1), this.tiles.group.updateWorldMatrix(!0, !1);
+    const t = this.inverseTilesMatrix.copy(this.tiles.group.matrixWorld).invert().multiply(e.matrixWorld), r = this.tiles.ellipsoid.getCartographicFromObjectFrame(
+      t,
+      {},
+      this.cameraFrame
+    );
+    return {
+      longitude: this.normalizeAngle(r.lon * E),
+      latitude: r.lat * E,
+      height: r.height,
+      heading: this.normalizeAngle(r.azimuth * E),
+      pitch: r.elevation * E,
+      roll: this.normalizeAngle(r.roll * E)
+    };
+  }
+  /** 获取指定 WGS84 位置在 Three.js 世界空间中的东、北、上单位轴。 */
+  getEastNorthUpAxes(e, t = new f(), r = new f(), i = new f()) {
+    const s = this.normalizeCoordinate(e);
+    return this.tiles.ellipsoid.getEastNorthUpAxes(
+      s.latitude * k,
+      s.longitude * k,
+      t,
+      r,
+      i
+    ), this.tiles.group.updateWorldMatrix(!0, !1), t.transformDirection(this.tiles.group.matrixWorld).normalize(), r.transformDirection(this.tiles.group.matrixWorld).normalize(), i.transformDirection(this.tiles.group.matrixWorld).normalize(), { east: t, north: r, up: i };
+  }
+  normalizeCoordinate(e) {
+    if (!e || !Number.isFinite(e.latitude) || e.latitude < -90 || e.latitude > 90)
+      throw new RangeError("纬度必须是 -90 到 90 之间的有限数值。");
+    if (!Number.isFinite(e.longitude))
+      throw new RangeError("经度必须是有限数值。");
+    const t = e.height ?? 0;
+    if (!Number.isFinite(t))
+      throw new RangeError("高度必须是有限数值。");
+    return {
+      longitude: this.normalizeAngle(e.longitude),
+      latitude: e.latitude,
+      height: t
+    };
+  }
+  normalizeAngle(e) {
+    return ((e + 180) % 360 + 360) % 360 - 180;
+  }
+}
+const v = {
+  GIS: "gis",
+  Default: "default",
+  FirstPerson: "first-person",
+  ThirdPerson: "third-person"
+};
+class X {
+  constructor(e, t, r, i) {
+    this.engine = e, this.gisControls = t, this.requestRender = r, this.layerManager = i, this.ensureViewCubeTargetCompatibility(), this.removeThirdPersonPlacementResolver = this.engine.controlModule.setThirdPersonPlacementResolver?.(
+      this.resolveGISPlacement
+    ) ?? null, this.removeOrbitCenterResolver = this.engine.controlModule.setOrbitCenterResolver?.(
+      this.resolveGISPlacement
+    ) ?? null;
+  }
+  engine;
+  gisControls;
+  requestRender;
+  layerManager;
+  currentMode = null;
+  disposed = !1;
+  removeThirdPersonPlacementResolver = null;
+  removeOrbitCenterResolver = null;
+  /** 切换控制器模式，并把业务配置原样委托给 v3 控制模块。 */
+  switchController(e, t = {}) {
+    if (this.disposed) throw new Error("GIS 控制器模块已销毁。");
+    const r = this.captureCameraRange();
+    try {
+      switch (this.gisControls.enabled = !1, e) {
+        case v.GIS:
+          this.currentMode !== null && this.currentMode !== v.GIS && this.engine.controlModule.switchDefaultMode({ preserveCameraPose: !0 }), this.engine.controlModule.disActive(), this.gisControls.enabled = !0, this.gisControls.resetState(), this.engine.controls = this.gisControls, this.engine.bindControlEvents(this.gisControls);
+          break;
+        case v.Default:
+          this.engine.controlModule.switchDefaultMode({
+            preserveCameraPose: t.preserveCameraPose
+          }), this.engine.controlModule.active(this.engine.controlModule.orbitControls);
+          break;
+        case v.FirstPerson:
+          this.leavePendingThirdPersonMode(), this.engine.controlModule.switchFirstPersonMode(), this.engine.controlModule.active(this.engine.controlModule.firstPersonControls);
+          break;
+        case v.ThirdPerson:
+          this.leavePendingThirdPersonMode(), this.engine.controlModule.switchThirdPersonMode(t.thirdPersonOptions), this.engine.controlModule.active(this.engine.controlModule.orbitControls);
+          break;
+        default:
+          throw new RangeError(`不支持的 GIS 控制器模式：${String(e)}`);
+      }
+    } finally {
+      this.restoreCameraRange(r);
+    }
+    this.currentMode = e, this.requestRender();
+  }
+  /** 获取当前已请求的控制器模式。 */
+  getMode() {
+    return this.currentMode ?? v.GIS;
+  }
+  /** 切换到 3d-tiles-renderer 原生 GIS 控制器。 */
+  switchToGIS() {
+    this.switchController(v.GIS);
+  }
+  /** 切换到 v3 默认轨道控制器。 */
+  switchToDefault(e) {
+    this.switchController(v.Default, e);
+  }
+  /** 切换到 v3 第一人称控制器。 */
+  switchToFirstPerson() {
+    this.switchController(v.FirstPerson);
+  }
+  /** 进入 v3 第三人称控制器已有的落点选择流程。 */
+  switchToThirdPerson(e) {
+    this.switchController(v.ThirdPerson, { thirdPersonOptions: e });
+  }
+  /** 停止当前控制输入，具体控制器资源仍由各自所属模块释放。 */
+  dispose() {
+    this.disposed || (this.disposed = !0, this.gisControls.enabled = !1, this.removeThirdPersonPlacementResolver?.(), this.removeThirdPersonPlacementResolver = null, this.removeOrbitCenterResolver?.(), this.removeOrbitCenterResolver = null, this.engine.controlModule.disActive());
+  }
+  /** 重入或离开第三人称前，借助 v3 默认入口清理等待落点状态。 */
+  leavePendingThirdPersonMode() {
+    this.currentMode === v.ThirdPerson && this.engine.controlModule.switchDefaultMode({ preserveCameraPose: !0 });
+  }
+  /** 将 GlobeControls 的旋转支点适配为 v3 ViewCube 使用的 OrbitControls target。 */
+  ensureViewCubeTargetCompatibility() {
+    const e = this.gisControls;
+    e.target?.clone || !e.pivotPoint || Object.defineProperty(e, "target", {
+      configurable: !0,
+      get: () => e.pivotPoint,
+      set: (t) => e.pivotPoint?.copy(t)
+    });
+  }
+  /** 记录 GIS 当前近远裁剪面，避免底层控制器切换改写地图可见范围。 */
+  captureCameraRange() {
+    const e = this.engine.camera;
+    return typeof e?.near != "number" || typeof e.far != "number" ? null : { near: e.near, far: e.far };
+  }
+  /** 将切换前的裁剪范围应用到切换后的活动相机。 */
+  restoreCameraRange(e) {
+    if (!e) return;
+    const t = this.engine.camera;
+    t && (t.near === e.near && t.far === e.far || (t.near = e.near, t.far = e.far, t.updateProjectionMatrix?.()));
+  }
+  /** 从当前可见 GIS 图层中拾取地图、地形或模型表面。 */
+  resolveGISPlacement = (e) => {
+    const t = this.layerManager?.getLayers().filter((o) => o.visible && o.object.visible).map((o) => o.object) ?? [];
+    if (t.length === 0) return null;
+    const i = e.intersectObjects([...new Set(t)], !0).find((o) => o.object.isMesh === !0 && t.some((l) => this.isVisibleWithinLayer(o.object, l)));
+    if (!i) return null;
+    let s;
+    i.normal instanceof f ? s = i.normal.clone().transformDirection(i.object.matrixWorld) : i.face?.normal instanceof f ? s = i.face.normal.clone().transformDirection(i.object.matrixWorld) : s = e.ray.direction.clone().negate();
+    const a = e.ray.origin.clone().sub(i.point);
+    return s.dot(a) < 0 && s.negate(), {
+      point: i.point.clone(),
+      normal: s.normalize(),
+      distance: i.distance
+    };
+  };
+  isVisibleWithinLayer(e, t) {
+    let r = e;
+    for (; r; ) {
+      if (r.visible === !1) return !1;
+      if (r === t) return !0;
+      r = r.parent;
+    }
+    return !1;
+  }
+}
+const R = Math.PI / 180, A = 180 / Math.PI, Z = 6378245, Q = 0.006693421622965943, B = 1e-5, Ue = 1e-9, Ne = 8;
+function he(n, e) {
+  return n < 72.004 || n > 137.8347 || e < 0.8293 || e > 55.8271;
+}
+function We(n, e) {
+  let t = -100 + 2 * n + 3 * e + 0.2 * e * e + 0.1 * n * e + 0.2 * Math.sqrt(Math.abs(n));
+  return t += (20 * Math.sin(6 * n * Math.PI) + 20 * Math.sin(2 * n * Math.PI)) * 2 / 3, t += (20 * Math.sin(e * Math.PI) + 40 * Math.sin(e / 3 * Math.PI)) * 2 / 3, t += (160 * Math.sin(e / 12 * Math.PI) + 320 * Math.sin(e * Math.PI / 30)) * 2 / 3, t;
+}
+function _e(n, e) {
+  let t = 300 + n + 2 * e + 0.1 * n * n + 0.1 * n * e + 0.1 * Math.sqrt(Math.abs(n));
+  return t += (20 * Math.sin(6 * n * Math.PI) + 20 * Math.sin(2 * n * Math.PI)) * 2 / 3, t += (20 * Math.sin(n * Math.PI) + 40 * Math.sin(n / 3 * Math.PI)) * 2 / 3, t += (150 * Math.sin(n / 12 * Math.PI) + 300 * Math.sin(n / 30 * Math.PI)) * 2 / 3, t;
+}
+function ce(n, e, t = [0, 0]) {
+  if (he(n, e))
+    return t[0] = n, t[1] = e, t;
+  const r = e * R, i = Math.sin(r), s = 1 - Q * i * i, a = Math.sqrt(s), o = We(n - 105, e - 35) * 180 / (Z * (1 - Q) / (s * a) * Math.PI), l = _e(n - 105, e - 35) * 180 / (Z / a * Math.cos(r) * Math.PI);
+  return t[0] = n + l, t[1] = e + o, t;
+}
+function qe(n, e, t = [0, 0]) {
+  if (he(n, e))
+    return t[0] = n, t[1] = e, t;
+  let r = n, i = e;
+  const s = [0, 0];
+  for (let a = 0; a < Ne; a += 1) {
+    ce(r, i, s);
+    const o = s[0] - n, l = s[1] - e;
+    if (r -= o, i -= l, Math.max(Math.abs(o), Math.abs(l)) < Ue) break;
+  }
+  return t[0] = r, t[1] = i, t;
+}
+class $e {
+  constructor(e) {
+    this.base = e, this.scheme = e.scheme, this.tileCountX = e.tileCountX, this.tileCountY = e.tileCountY;
+  }
+  base;
+  scheme;
+  tileCountX;
+  tileCountY;
+  get isMercator() {
+    return this.base.isMercator;
+  }
+  get isCartographic() {
+    return this.base.isCartographic;
+  }
+  getDerivativeAtNormalizedPoint(e, t, r = [0, 0]) {
+    const i = Math.max(e - B, 0), s = Math.min(e + B, 1), a = Math.max(t - B, 0), o = Math.min(t + B, 1), l = [0, 0], c = this.fromNormalizedToCartographic(i, t, l)[0], m = this.fromNormalizedToCartographic(s, t, l)[0];
+    r[0] = Math.abs(m - c) / (s - i);
+    const u = this.fromNormalizedToCartographic(e, a, l)[1], g = this.fromNormalizedToCartographic(e, o, l)[1];
+    return r[1] = Math.abs(g - u) / (o - a), r;
+  }
+  getBounds() {
+    return this.base.getBounds();
+  }
+  fromCartographicToNormalized(e, t, r = [0, 0]) {
+    return ce(e * A, t * A, r), this.base.fromCartographicToNormalized(
+      r[0] * R,
+      r[1] * R,
+      r
+    );
+  }
+  fromCartographicToNormalizedRange(e) {
+    return this.convertRange(e, (t, r, i) => this.fromCartographicToNormalized(t, r, i));
+  }
+  fromNormalizedToCartographic(e, t, r = [0, 0]) {
+    return this.base.fromNormalizedToCartographic(e, t, r), qe(r[0] * A, r[1] * A, r), r[0] *= R, r[1] *= R, r;
+  }
+  fromNormalizedToCartographicRange(e) {
+    return this.convertRange(e, (t, r, i) => this.fromNormalizedToCartographic(t, r, i));
+  }
+  getProjectedExtents() {
+    return this.base.getProjectedExtents();
+  }
+  clampToBounds(e, t = !1) {
+    return this.base.clampToBounds(e, t);
+  }
+  convertRange(e, t) {
+    const r = [0, 0], i = [1 / 0, 1 / 0, -1 / 0, -1 / 0];
+    return [
+      [e[0], e[1]],
+      [e[0], e[3]],
+      [e[2], e[1]],
+      [e[2], e[3]]
+    ].forEach(([a, o]) => {
+      t(a, o, r), i[0] = Math.min(i[0], r[0]), i[1] = Math.min(i[1], r[1]), i[2] = Math.max(i[2], r[0]), i[3] = Math.max(i[3], r[1]);
+    }), i;
+  }
+}
+const L = Math.PI / 180, K = 2, He = 35;
+class Je {
+  name = "GIS_XYZ_WEBGPU_UV";
+  processTileModel(e) {
+    e.traverse((t) => {
+      const i = t.geometry?.attributes?.uv;
+      if (!(!i || t.userData.gisWebGpuUvCorrected)) {
+        for (let s = 0; s < i.count; s += 1)
+          i.setY(s, 1 - i.getY(s));
+        i.needsUpdate = !0, t.userData.gisWebGpuUvCorrected = !0;
+      }
+    });
+  }
+}
+class Ye {
+  constructor(e, t = {}, r = !0, i) {
+    this.engine = e, this.options = t, this.isWebGpuRenderer = r, this.layerManager = i;
+  }
+  engine;
+  options;
+  isWebGpuRenderer;
+  layerManager;
+  managedTilesets = /* @__PURE__ */ new Map();
+  lifecycle = null;
+  disposed = !1;
+  imageConfigs = [
+    {
+      id: "cesium",
+      name: "Cesium",
+      type: "cesium-ion",
+      // CesiumJS 1.145 官方评估 Token，官方声明于 2026-11-01 到期。
+      token: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJub25jZSI6ImwwendUTkl3UVk5Uk5XdEkiLCJqdGkiOiJjZGFkZDZlNC0wMDI5LTQ5OTMtYWIwMC01ZWY4ZDVlNTBhMzYiLCJpZCI6MjU5LCJzdWIiOiJDZXNpdW1KUyIsImlzcyI6Imh0dHBzOi8vYXBpLmNlc2l1bS5jb20iLCJhdWQiOiIxLjE0NSBSZWxlYXNlIC0gRGVsZXRlIG9uIE5vdmVtYmVyIDEsIDIwMjYiLCJpYXQiOjE3ODc2MzQ3NzV9.3SPieoGxEZ22pnWLETAIFZveR0xXTzvOh8G4NYTxDSo",
+      assetId: 2275207
+    },
+    {
+      id: "gd",
+      name: "高德地图",
+      type: "xyz",
+      url: "https://webrd01.is.autonavi.com/appmaptile?style=7&lang=zh_cn&size=1&scale=1&x={x}&y={y}&z={z}",
+      levels: 19,
+      coordinateSystem: "gcj02"
+    },
+    {
+      id: "gd2",
+      name: "高德卫星地图",
+      type: "xyz",
+      url: "https://webst01.is.autonavi.com/appmaptile?style=6&size=1&scl=1&x={x}&y={y}&z={z}",
+      levels: 19,
+      coordinateSystem: "gcj02"
+    }
+  ];
+  /** 注册附加 Tileset 生命周期回调，业务管理器通过此入口维护校准等状态。 */
+  setTilesetLifecycle(e) {
+    this.lifecycle = e;
+  }
+  /** 加载初始化配置指定的影像，未指定时默认使用 Cesium。 */
+  loadImage() {
+    return this.options.source ? this.load3dtiles(this.options.source) : this.loadImageById(this.options.imageId ?? "cesium");
+  }
+  /** 按内置配置标识加载影像。 */
+  loadImageById(e) {
+    const t = this.imageConfigs.find((r) => r.id === e);
+    return t ? t.type === "cesium-ion" ? this.load3dtiles({ type: "cesium-ion", assetId: t.assetId }) : this.load3dtiles({
+      type: "xyz",
+      url: t.url,
+      levels: t.levels,
+      coordinateSystem: t.coordinateSystem
+    }) : Promise.reject(new RangeError(`未知的影像配置 id: ${e}`));
+  }
+  /** 按 URL 加载自定义 3D Tiles 影像。 */
+  loadImageCustomize(e) {
+    return this.load3dtiles({ type: "url", url: e });
+  }
+  /** 当前地形由 3D Tiles 影像一并提供。 */
+  loadTerrain() {
+    return this.loadImage();
+  }
+  /** 在当前 GIS 底图上叠加通用 3D Tiles，并接入统一渲染生命周期。 */
+  async loadTileset(e, t = {}) {
+    if (this.assertUsable(), typeof e != "string" || e.trim().length === 0)
+      throw new TypeError("3D Tiles URL 不能为空。");
+    const r = t.heightOffset ?? 0;
+    if (!Number.isFinite(r))
+      throw new RangeError("3D Tiles 高度偏移必须是有限数值。");
+    const { tiles: i } = await this.load3dtiles({ type: "url", url: e.trim() });
+    if (this.disposed)
+      throw i.dispose(), new Error("GIS LoaderModule 已销毁。");
+    t.fetchData && i.registerPlugin({
+      name: `GIS_LOCAL_TILESET_${t.id ?? i.group.uuid}`,
+      fetchData: t.fetchData
+    });
+    const s = {
+      onNeedsUpdate: () => this.engine.requestRender(),
+      onLoadError: (o) => {
+        const l = o.error instanceof Error ? o.error : new Error(`3D Tiles 加载失败：${e}`);
+        this.options.onError?.(l);
+      }
+    };
+    let a;
+    try {
+      a = this.layerManager?.registerLayer({
+        id: t.id,
+        name: t.name?.trim() || e.trim(),
+        type: "tileset",
+        source: e.trim(),
+        object: i.group,
+        remove: () => this.removeTileset(i)
+      });
+    } catch (o) {
+      throw i.dispose(), o;
+    }
+    return s.layerId = a?.id, i.group.name = a?.id ?? `gisTileset:${e}`, i.setCamera(this.engine.camera), i.setResolutionFromRenderer(this.engine.camera, this.engine.renderer), i.addEventListener("needs-update", s.onNeedsUpdate), i.addEventListener("load-error", s.onLoadError), this.engine.scene.add(i.group), this.managedTilesets.set(i, s), this.lifecycle?.onTilesetAdded?.(i, {
+      id: s.layerId ?? i.group.name,
+      name: a?.name ?? (t.name?.trim() || e.trim()),
+      source: e.trim()
+    }, !1), r === 0 ? this.registerTilesetReady(i, s) : this.registerHeightOffset(i, s, r), this.engine.requestRender(), i;
+  }
+  /** 移除附加的 3D Tiles，并释放其缓存与 GPU 资源。 */
+  removeTileset(e) {
+    const t = this.managedTilesets.get(e);
+    return t ? (e.removeEventListener("needs-update", t.onNeedsUpdate), e.removeEventListener("load-error", t.onLoadError), t.onRootLoaded && e.removeEventListener("load-root-tileset", t.onRootLoaded), e.deleteCamera(this.engine.camera), this.engine.scene.remove(e.group), this.lifecycle?.onTilesetRemoved?.(e, t.layerId), e.dispose(), t.layerId && this.layerManager?.unregisterLayer(t.layerId), this.managedTilesets.delete(e), this.engine.requestRender(), !0) : !1;
+  }
+  /** 等待附加 Tileset 就绪，并把相机调整到可完整观察模型的位置。 */
+  async flyToTileset(e, t = {}) {
+    if (this.assertUsable(), !this.managedTilesets.has(e))
+      throw new Error("只能跳转到当前 LoaderModule 管理的 3D Tiles。");
+    const r = await this.waitForBoundingSphere(e, t.timeoutMs ?? 15e3), i = Math.max(1, t.padding ?? 1.25), s = this.engine.camera, a = r.center, o = this.engine.controls, l = new f(0, 1, 0);
+    o?.getUpDirection?.(a, l), l.lengthSq() < 1e-8 && l.set(0, 1, 0), l.normalize();
+    const c = s.position.clone().sub(a);
+    if (c.addScaledVector(l, -c.dot(l)), c.lengthSq() < 1e-8 && (s.getWorldDirection(c).negate(), c.addScaledVector(l, -c.dot(l))), c.lengthSq() < 1e-8) {
+      const w = Math.abs(l.y) < 0.9 ? new f(0, 1, 0) : new f(1, 0, 0);
+      c.crossVectors(l, w);
+    }
+    c.normalize();
+    const m = S.degToRad(S.clamp(
+      t.elevation ?? He,
+      5,
+      85
+    )), u = c.multiplyScalar(Math.cos(m)).addScaledVector(l, Math.sin(m)).normalize(), g = S.degToRad(s.fov), h = 2 * Math.atan(Math.tan(g / 2) * s.aspect), p = Math.max(1e-4, Math.min(g, h)), d = r.radius * i / Math.sin(p / 2);
+    s.position.copy(a).addScaledVector(u, d), s.up.copy(l), s.lookAt(a), s.updateMatrix(), s.updateMatrixWorld(!0), (o?.target ?? o?.pivotPoint)?.copy(a), o?.resetState?.(), o?.update?.(0), this.engine.requestRender();
+  }
+  /** 更新全部附加瓦片的 LOD 调度。 */
+  update() {
+    this.managedTilesets.forEach((e, t) => {
+      t.group.visible && t.update();
+    });
+  }
+  /** 同步全部附加瓦片使用的屏幕分辨率。 */
+  updateResolution() {
+    this.managedTilesets.forEach((e, t) => {
+      t.setResolutionFromRenderer(this.engine.camera, this.engine.renderer);
+    });
+  }
+  /** 释放 LoaderModule 管理的附加瓦片；主底图仍由 GIS 实例释放。 */
+  dispose() {
+    this.disposed || ([...this.managedTilesets.keys()].forEach((e) => this.removeTileset(e)), this.disposed = !0);
+  }
+  /** 创建 TilesRenderer，并注册官方示例使用的扩展插件。 */
+  async load3dtiles(e = { type: "cesium-ion" }) {
+    this.assertUsable();
+    const [t, r] = await Promise.all([
+      import("./gis-tiles-vendor-DIbUOKJM.js").then((h) => h.i),
+      import("./gis-tiles-vendor-DIbUOKJM.js").then((h) => h.a)
+    ]), i = new t.TilesRenderer(e.type === "url" ? e.url : void 0), s = this.resolveLocalOrigin();
+    if (s) {
+      const h = new r.ReorientationPlugin({
+        lat: s.latitude * L,
+        lon: s.longitude * L,
+        height: s.height,
+        recenter: !0
+      });
+      i.registerPlugin(h), h.transformLatLonHeightToOrigin(
+        s.latitude * L,
+        s.longitude * L,
+        s.height
+      );
+    }
+    if (e.type === "xyz") {
+      const h = e.levels ?? 19, p = new r.XYZTilesOverlay({
+        url: e.url,
+        levels: h,
+        tileDimension: e.tileDimension ?? 256,
+        projection: "EPSG:3857"
+      });
+      e.coordinateSystem === "gcj02" && await this.correctGcj02Overlay(p);
+      const d = r.GeneratedSurfacePlugin;
+      i.registerPlugin(new d({
+        overlay: p,
+        projection: "ellipsoid",
+        applyOverlayTexture: !0
+      })), this.isWebGpuRenderer && i.registerPlugin(new Je()), i.registerPlugin(new r.UpdateOnChangePlugin()), i.errorTarget = this.options.errorTarget ?? K, i.loadSiblings = this.options.loadSiblings ?? !0, i.loadAncestors = !1;
+      const { CAMERA_FRAME: w } = t;
+      return { tiles: i, Controls: t.GlobeControls, cameraFrame: w };
+    }
+    const [a, o, l, c] = await Promise.all([
+      import("./gis-tiles-vendor-DIbUOKJM.js").then((h) => h.b),
+      import("./three-vendor-CGmeNMm5.js").then((h) => h.cr),
+      import("./three-vendor-CGmeNMm5.js").then((h) => h.cs),
+      import("./three-vendor-CGmeNMm5.js").then((h) => h.ct)
+    ]);
+    if (e.type === "cesium-ion") {
+      const h = this.imageConfigs.find(
+        (p) => p.type === "cesium-ion"
+      );
+      i.registerPlugin(new a.CesiumIonAuthPlugin({
+        apiToken: h.token,
+        assetId: String(e.assetId ?? h.assetId),
+        autoRefreshToken: e.autoRefreshToken ?? !0
+      }));
+    }
+    const m = new o.DRACOLoader(), u = this.options.dracoDecoderPath ?? te("draco/", import.meta.url);
+    m.setDecoderPath(u), i.registerPlugin(new r.GLTFExtensionsPlugin({
+      dracoLoader: m,
+      meshoptDecoder: c.MeshoptDecoder,
+      autoDispose: !0
+    })), this.options.creasedNormals !== !1 && i.registerPlugin(new l.TileCreasedNormalsPlugin({
+      creaseAngle: (this.options.creaseAngle ?? 30) * L
+    })), this.options.fade === !0 && i.registerPlugin(new r.TilesFadePlugin()), i.registerPlugin(new r.UpdateOnChangePlugin()), i.errorTarget = this.options.errorTarget ?? K, i.loadSiblings = this.options.loadSiblings ?? !0;
+    const { CAMERA_FRAME: g } = t;
+    return { tiles: i, Controls: t.GlobeControls, cameraFrame: g };
+  }
+  resolveLocalOrigin() {
+    if (this.options.localOrigin === !1) return null;
+    const e = { ...V, ...this.options.initialView }, t = this.options.localOrigin, r = t?.latitude ?? e.latitude, i = t?.longitude ?? e.longitude;
+    if (!Number.isFinite(r) || r < -90 || r > 90)
+      throw new RangeError("GIS 局部原点纬度必须是 -90 到 90 之间的有限数值。");
+    if (!Number.isFinite(i) || i < -180 || i > 180)
+      throw new RangeError("GIS 局部原点经度必须是 -180 到 180 之间的有限数值。");
+    const s = t?.height ?? 0;
+    if (!Number.isFinite(s))
+      throw new RangeError("GIS 局部原点高度必须是有限数值。");
+    return { latitude: r, longitude: i, height: s };
+  }
+  /** 将高德瓦片的 GCJ-02 投影适配到引擎统一使用的 WGS84 地表。 */
+  async correctGcj02Overlay(e) {
+    await e.init();
+    const t = new $e(e.tiling.projection);
+    e.tiling.setProjection(t), e.tiling.setContentBounds(...t.getBounds());
+  }
+  registerHeightOffset(e, t, r) {
+    if (r === 0) return;
+    const i = () => {
+      const s = new G();
+      if (!e.getBoundingSphere(s)) return;
+      if (this.resolveLocalOrigin())
+        e.group.position.y += r;
+      else {
+        const o = e.ellipsoid.getPositionToNormal(s.center, new f());
+        e.group.updateWorldMatrix(!0, !1), o.transformDirection(e.group.matrixWorld), e.group.parent && (e.group.parent.updateWorldMatrix(!0, !1), o.transformDirection(new y().copy(e.group.parent.matrixWorld).invert())), e.group.position.addScaledVector(o, r);
+      }
+      e.group.updateMatrixWorld(!0), e.removeEventListener("load-root-tileset", i), t.onRootLoaded = void 0, this.lifecycle?.onTilesetReady?.(e), this.engine.requestRender();
+    };
+    t.onRootLoaded = i, e.addEventListener("load-root-tileset", i), e.root && i();
+  }
+  /** 根瓦片加载完成后再冻结校准基准，避免使用尚未建立的包围球锚点。 */
+  registerTilesetReady(e, t) {
+    const r = () => {
+      const i = new G();
+      e.getBoundingSphere(i) && (e.removeEventListener("load-root-tileset", r), t.onRootLoaded = void 0, this.lifecycle?.onTilesetReady?.(e));
+    };
+    t.onRootLoaded = r, e.addEventListener("load-root-tileset", r), e.root && r();
+  }
+  waitForBoundingSphere(e, t) {
+    const r = () => {
+      const s = new G();
+      return e.getBoundingSphere(s) ? (e.group.updateWorldMatrix(!0, !1), s.applyMatrix4(e.group.matrixWorld)) : null;
+    }, i = r();
+    return i ? Promise.resolve(i) : new Promise((s, a) => {
+      const o = () => {
+        clearTimeout(m), e.removeEventListener("load-root-tileset", l), e.removeEventListener("load-error", c);
+      }, l = () => {
+        const u = r();
+        u && (o(), s(u));
+      }, c = (u) => {
+        e.root || (o(), a(u.error ?? new Error("3D Tiles 根节点加载失败。")));
+      }, m = setTimeout(() => {
+        o(), a(new Error("等待 3D Tiles 根节点加载超时。"));
+      }, Math.max(1, t));
+      e.addEventListener("load-root-tileset", l), e.addEventListener("load-error", c);
+    });
+  }
+  assertUsable() {
+    if (this.disposed) throw new Error("GIS LoaderModule 已销毁。");
+  }
+}
+const ee = "gis-local.invalid";
+class Xe {
+  constructor(e, t, r, i, s) {
+    this.engine = e, this.tilesLoader = t, this.coordinateModule = r, this.layerManager = i, this.calibrationManager = s;
+  }
+  engine;
+  tilesLoader;
+  coordinateModule;
+  layerManager;
+  calibrationManager;
+  resources = /* @__PURE__ */ new Map();
+  sequence = 0;
+  disposed = !1;
+  /** 按 URL 加载 3D Tiles、glTF/GLB、GeoJSON 或 v3 BIM 模型。 */
+  async loadModel(e, t = {}) {
+    this.assertUsable();
+    const r = this.normalizeUrl(e), i = t.type ?? this.inferUrlType(r);
+    switch (i) {
+      case "3dtiles":
+        return this.loadTileset(r, t);
+      case "gltf":
+        return this.loadGltfUrl(r, t);
+      case "geojson":
+        return this.loadGeoJsonUrl(r, t);
+      case "bim":
+        return this.loadBimUrl(r, t);
+      default:
+        throw new RangeError(`不支持的 GIS 模型类型：${String(i)}`);
+    }
+  }
+  /**
+   * 加载浏览器选择的本地资源文件。
+   * 支持 3D Tiles 文件集、glTF/GLB、GeoJSON 和 v3 BIM 包，不包含 SHP。
+   */
+  async loadModelFile(e, t = {}) {
+    this.assertUsable();
+    const r = Array.from(e ?? []);
+    if (r.length === 0) throw new TypeError("本地模型文件不能为空。");
+    const i = r.find((o) => this.baseName(o).toLowerCase() === "tileset.json");
+    if (i) return [await this.loadLocalTileset(r, i, t)];
+    const s = r.find((o) => /\.(?:glb|gltf)$/i.test(o.name));
+    if (s) return [await this.loadLocalGltf(r, s, t)];
+    const a = r.find((o) => /\.(?:geojson|json)$/i.test(o.name));
+    if (a) {
+      const o = JSON.parse(await a.text());
+      if (this.isGeoJson(o))
+        return [this.createGeoJsonModel(o, a.name, t)];
+    }
+    return this.loadLocalBim(r, t);
+  }
+  /** 通过 SDK ViewToken 解析资源，再进入相同的类型分流和生命周期。 */
+  async loadModelByViewToken(e, t = {}) {
+    if (this.assertUsable(), typeof e != "string" || e.trim().length === 0)
+      throw new TypeError("ViewToken 不能为空。");
+    const r = await Ie(
+      this.engine.options,
+      e.trim(),
+      "3d"
+    ), i = r.urls?.length > 0 ? r.urls : [r.url], s = t.type ?? this.inferResolvedType(
+      r.fileFormat,
+      r.assetCategory,
+      i[0]
+    ), a = [];
+    for (let o = 0; o < i.length; o += 1)
+      a.push(await this.loadModel(i[o], {
+        ...t,
+        id: o === 0 ? t.id : void 0,
+        type: s
+      }));
+    return a;
+  }
+  /** 移除统一资源句柄对应的模型和图层。 */
+  removeModel(e) {
+    const t = typeof e == "string" ? e : e.id, r = this.resources.get(t);
+    return r ? (this.resources.delete(t), this.layerManager.unregisterLayer(t), this.calibrationManager.unregister(t), r.model.type === "bim" && this.calibrationManager.unregister(r.model.source), r.release(), this.engine.events.trigger("gis:model-removed", r.model), this.engine.requestRender(), !0) : !1;
+  }
+  /** 查询由本模块加载的全部资源句柄。 */
+  getModels() {
+    return [...this.resources.values()].map(({ model: e }) => ({ ...e }));
+  }
+  /** 释放独立资源；3D Tiles 与 BIM 分别交还各自底层加载器卸载。 */
+  dispose() {
+    this.disposed || ([...this.resources.keys()].forEach((e) => this.removeModel(e)), this.disposed = !0);
+  }
+  async loadTileset(e, t) {
+    const r = await this.tilesLoader.loadTileset(e, t);
+    t.flyTo !== !1 && await this.tilesLoader.flyToTileset(r);
+    const i = this.layerManager.getLayer(r.group.name), s = {
+      id: i?.id ?? r.group.name,
+      name: i?.name ?? t.name ?? e,
+      type: "3dtiles",
+      source: e,
+      object: r.group,
+      raw: r
+    };
+    return this.track(s, () => {
+      this.tilesLoader.removeTileset(r);
+    });
+  }
+  async loadGltfUrl(e, t) {
+    const r = await this.parseGltf(e);
+    return this.addStandaloneModel(r, e, "gltf", t);
+  }
+  async loadLocalGltf(e, t, r) {
+    const i = [], s = /* @__PURE__ */ new Map();
+    e.forEach((o) => {
+      const l = URL.createObjectURL(o);
+      i.push(l);
+      const c = this.filePath(o);
+      s.set(c, l), s.set(this.baseName(o), l);
+    });
+    const a = new fe();
+    a.setURLModifier((o) => {
+      const l = this.normalizePath(decodeURIComponent(o));
+      return s.get(l) ?? s.get(this.baseNameFromPath(l)) ?? o;
+    });
+    try {
+      const o = s.get(this.filePath(t)), l = await this.parseGltf(o, a);
+      return this.addStandaloneModel(l, t.name, "gltf", r, () => {
+        i.forEach((c) => URL.revokeObjectURL(c));
+      });
+    } catch (o) {
+      throw i.forEach((l) => URL.revokeObjectURL(l)), o;
+    }
+  }
+  async parseGltf(e, t) {
+    const [{ GLTFLoader: r }, { DRACOLoader: i }, { MeshoptDecoder: s }] = await Promise.all([
+      import("./three-vendor-CGmeNMm5.js").then((l) => l.cq),
+      import("./three-vendor-CGmeNMm5.js").then((l) => l.cr),
+      import("./three-vendor-CGmeNMm5.js").then((l) => l.ct)
+    ]), a = new i(t);
+    a.setDecoderPath(te("draco/", import.meta.url));
+    const o = new r(t);
+    o.setDRACOLoader(a), o.setMeshoptDecoder(s);
+    try {
+      return (await o.loadAsync(e)).scene;
+    } finally {
+      a.dispose();
+    }
+  }
+  async loadGeoJsonUrl(e, t) {
+    const r = await fetch(e);
+    if (!r.ok) throw new Error(`GeoJSON 加载失败（${r.status}）：${e}`);
+    const i = await r.json();
+    if (!this.isGeoJson(i)) throw new TypeError(`资源不是有效的 GeoJSON：${e}`);
+    return this.createGeoJsonModel(i, e, t);
+  }
+  createGeoJsonModel(e, t, r) {
+    const i = [], s = [], a = (u) => {
+      if (!Array.isArray(u) || u.length < 2) return;
+      const g = Number(u[0]), h = Number(u[1]), p = u.length > 2 ? Number(u[2]) : r.height ?? 0, d = this.coordinateModule.toWorld({ longitude: g, latitude: h, height: p });
+      i.push(d.x, d.y, d.z);
+    }, o = (u, g = !1) => {
+      if (!Array.isArray(u) || u.length < 2) return;
+      const h = u.map((d) => !Array.isArray(d) || d.length < 2 ? null : this.coordinateModule.toWorld({
+        longitude: Number(d[0]),
+        latitude: Number(d[1]),
+        height: d.length > 2 ? Number(d[2]) : r.height ?? 0
+      })).filter((d) => d !== null), p = g ? h.length : h.length - 1;
+      for (let d = 0; d < p; d += 1) {
+        const w = h[d], C = h[(d + 1) % h.length];
+        s.push(w.x, w.y, w.z, C.x, C.y, C.z);
+      }
+    }, l = (u) => {
+      if (!u) return;
+      const g = u.coordinates;
+      switch (u.type) {
+        case "Point":
+          a(g);
+          break;
+        case "MultiPoint":
+          g?.forEach(a);
+          break;
+        case "LineString":
+          o(g);
+          break;
+        case "MultiLineString":
+          g?.forEach((h) => o(h));
+          break;
+        case "Polygon":
+          g?.forEach((h) => o(h, !0));
+          break;
+        case "MultiPolygon":
+          g?.forEach((h) => {
+            Array.isArray(h) && h.forEach((p) => o(p, !0));
+          });
+          break;
+        case "GeometryCollection":
+          u.geometries?.forEach(l);
+          break;
+      }
+    }, c = (u) => {
+      u.type === "FeatureCollection" ? u.features?.forEach(c) : u.type === "Feature" ? l(u.geometry) : l(u);
+    };
+    c(e);
+    const m = new O();
+    if (i.length > 0) {
+      const u = new H();
+      u.setAttribute("position", new J(i, 3)), m.add(new ye(u, new Me({ color: 16763955, size: 6 })));
+    }
+    if (s.length > 0) {
+      const u = new H();
+      u.setAttribute("position", new J(s, 3)), m.add(new be(u, new we({ color: 2598888 })));
+    }
+    if (m.children.length === 0)
+      throw new TypeError(`GeoJSON 不包含可显示的点、线或多边形：${t}`);
+    return this.addStandaloneModel(m, t, "geojson", r);
+  }
+  async loadBimUrl(e, t) {
+    await this.engine.loaderModule.loadModels([e], t);
+    const r = b(this.engine, e);
+    if (!r) throw new Error(`BIM 模型加载完成后未找到根对象：${e}`);
+    return this.addBimModel(e, r, t);
+  }
+  async loadLocalBim(e, t) {
+    const r = new Set(
+      this.engine.models.map((s) => s?.url).filter((s) => typeof s == "string")
+    );
+    await this.engine.loaderModule.loadModelFile(e, t);
+    const i = this.engine.models.map((s) => s?.url).filter((s) => typeof s == "string" && !r.has(s));
+    if (i.length === 0) throw new Error("本地 BIM 已加载，但未发现新的模型根对象。");
+    return i.map((s, a) => {
+      const o = b(this.engine, s);
+      if (!o) throw new Error(`本地 BIM 缺少模型根对象：${s}`);
+      return this.addBimModel(s, o, {
+        ...t,
+        id: a === 0 ? t.id : void 0,
+        name: a === 0 ? t.name : void 0
+      });
+    });
+  }
+  addBimModel(e, t, r) {
+    const i = this.resolveId(r.id, "bim"), s = {
+      id: i,
+      name: r.name?.trim() || this.baseNameFromPath(e) || e,
+      type: "bim",
+      source: e,
+      object: t,
+      raw: t
+    }, a = this.track(s, () => this.engine.loaderModule.unloadModel(e), "model");
+    return this.calibrationManager.registerBimModel(e, { id: i, name: s.name }), a;
+  }
+  addStandaloneModel(e, t, r, i, s) {
+    const a = this.resolveId(i.id, r);
+    e.name = a, this.engine.scene.add(e);
+    const o = {
+      id: a,
+      name: i.name?.trim() || this.baseNameFromPath(t) || t,
+      type: r,
+      source: t,
+      object: e,
+      raw: e
+    };
+    return this.track(o, () => {
+      this.engine.scene.remove(e), this.disposeObject(e), s?.();
+    }, r === "geojson" ? "vector" : "model");
+  }
+  track(e, t, r = "tileset") {
+    if (this.resources.has(e.id))
+      throw t(), new RangeError(`GIS 模型 id 已存在：${e.id}`);
+    return this.layerManager.registerLayer({
+      id: e.id,
+      name: e.name,
+      type: r,
+      source: e.source,
+      object: e.object,
+      remove: () => this.removeModel(e.id)
+    }), this.resources.set(e.id, { model: e, release: t }), this.engine.events.trigger("gis:model-loaded", e), this.engine.requestRender(), e;
+  }
+  async loadLocalTileset(e, t, r) {
+    const i = `tileset-${Date.now()}-${++this.sequence}`, s = `https://${ee}/${i}/`, a = this.filePath(t), o = a.includes("/") ? a.slice(0, a.lastIndexOf("/") + 1) : "", l = /* @__PURE__ */ new Map();
+    e.forEach((p) => {
+      const d = this.filePath(p), w = o && d.startsWith(o) ? d.slice(o.length) : d;
+      l.set(this.normalizePath(w), p);
+    });
+    const c = new URL(this.baseName(t), s).toString(), m = async (p) => {
+      const d = new URL(p);
+      if (d.host !== ee) return fetch(p);
+      const w = `/${i}/`, C = this.normalizePath(decodeURIComponent(d.pathname.split(w)[1] ?? "")), P = l.get(C);
+      return P ? new Response(P, {
+        status: 200,
+        headers: P.type ? { "Content-Type": P.type } : void 0
+      }) : new Response(`本地 3D Tiles 文件不存在：${C}`, { status: 404 });
+    }, u = await this.tilesLoader.loadTileset(c, {
+      id: r.id,
+      name: r.name ?? t.name,
+      fetchData: m
+    }), g = this.layerManager.getLayer(u.group.name), h = {
+      id: g?.id ?? u.group.name,
+      name: g?.name ?? r.name ?? t.name,
+      type: "3dtiles",
+      source: t.name,
+      object: u.group,
+      raw: u
+    };
+    return this.track(h, () => {
+      this.tilesLoader.removeTileset(u);
+    });
+  }
+  disposeObject(e) {
+    e.traverse((t) => {
+      const r = t;
+      r.geometry?.dispose(), (Array.isArray(r.material) ? r.material : r.material ? [r.material] : []).forEach((s) => {
+        Object.values(s).forEach((a) => {
+          const o = a;
+          o?.isTexture && o.dispose();
+        }), s.dispose();
+      });
+    });
+  }
+  inferUrlType(e) {
+    const t = e.split(/[?#]/, 1)[0].toLowerCase();
+    return /(?:^|\/)tileset\.json$/.test(t) ? "3dtiles" : /\.geojson$/.test(t) ? "geojson" : /\.(?:glb|gltf)$/.test(t) ? "gltf" : "bim";
+  }
+  inferResolvedType(e, t, r) {
+    const i = `${e ?? ""} ${t ?? ""} ${r}`.toLowerCase();
+    return /3d.?tiles|tileset\.json/.test(i) ? "3dtiles" : /geojson/.test(i) ? "geojson" : /\bglb\b|\bgltf\b|\.(?:glb|gltf)(?:[?#]|$)/.test(i) ? "gltf" : "bim";
+  }
+  isGeoJson(e) {
+    return !!(e && [
+      "FeatureCollection",
+      "Feature",
+      "GeometryCollection",
+      "Point",
+      "MultiPoint",
+      "LineString",
+      "MultiLineString",
+      "Polygon",
+      "MultiPolygon"
+    ].includes(e.type ?? ""));
+  }
+  resolveId(e, t) {
+    const r = e?.trim() || `${t}-${++this.sequence}`;
+    if (this.resources.has(r) || this.layerManager.getLayer(r))
+      throw new RangeError(`GIS 模型 id 已存在：${r}`);
+    return r;
+  }
+  normalizeUrl(e) {
+    if (typeof e != "string" || e.trim().length === 0)
+      throw new TypeError("模型 URL 不能为空。");
+    return e.trim();
+  }
+  filePath(e) {
+    return this.normalizePath(e.webkitRelativePath || e.name);
+  }
+  baseName(e) {
+    return this.baseNameFromPath(this.filePath(e));
+  }
+  baseNameFromPath(e) {
+    return this.normalizePath(e).split("/").pop() ?? "";
+  }
+  normalizePath(e) {
+    return e.replace(/\\/g, "/").replace(/^\.\//, "").replace(/^\/+/, "");
+  }
+  assertUsable() {
+    if (this.disposed) throw new Error("GISResourceLoaderModule 已销毁。");
+  }
+}
+class Ze {
+  constructor(e, t) {
+    this.options = t, this.engine = e, this.runtimeEngine = e, this.layerManager = new xe(this.runtimeEngine), this.activeBaseSource = t.source ?? t.imageId ?? "cesium";
+  }
+  options;
+  engine;
+  tiles = null;
+  loaderModule;
+  resourceLoaderModule = null;
+  layerManager;
+  coordinateModule = null;
+  controls = null;
+  cameraModule = null;
+  controllerModule = null;
+  modelPositionManager = null;
+  modelCalibrationManager = null;
+  label = null;
+  viewCube = null;
+  skyManager = null;
+  resizeObserver = null;
+  removeFrameCallback = null;
+  previousTime = 0;
+  disposed = !1;
+  baseMapSwitchVersion = 0;
+  activeBaseSource;
+  runtimeEngine;
+  /** 按 Three.js 官方示例注册插件、定位相机并启动瓦片调度。 */
+  async initialize() {
+    this.loaderModule = new Ye(
+      this.runtimeEngine,
+      this.options,
+      this.usesWebGpuBackend(),
+      this.layerManager
+    );
+    const { tiles: e, Controls: t, cameraFrame: r } = await this.loaderModule.loadImage();
+    if (this.disposed) throw new Error("GIS 已在初始化完成前销毁。");
+    return e.setCamera(this.runtimeEngine.camera), e.setResolutionFromRenderer(this.runtimeEngine.camera, this.runtimeEngine.renderer), this.runtimeEngine.scene.add(e.group), this.tiles = e, this.layerManager.registerLayer({
+      id: "base-imagery",
+      name: "GIS 底图",
+      type: "imagery",
+      source: this.getBaseLayerSource(),
+      object: e.group
+    }), this.runtimeEngine.viewCube?.setHomeBoundingBoxProvider?.(
+      () => this.layerManager.getModelBoundingBox()
+    ), this.coordinateModule = new ze(e, r), this.modelCalibrationManager = new Oe(
+      this.runtimeEngine,
+      this.coordinateModule
+    ), this.resourceLoaderModule = new Xe(
+      this.runtimeEngine,
+      this.loaderModule,
+      this.coordinateModule,
+      this.layerManager,
+      this.modelCalibrationManager
+    ), this.loaderModule.setTilesetLifecycle({
+      onTilesetAdded: (i, s, a) => {
+        this.modelCalibrationManager?.registerTileset(
+          s.id,
+          s.name,
+          s.source,
+          i,
+          a
+        );
+      },
+      onTilesetReady: (i) => {
+        this.modelCalibrationManager?.markTilesetReady(i);
+      },
+      onTilesetRemoved: (i, s) => {
+        s && this.modelCalibrationManager?.unregister(s);
+      }
+    }), this.modelPositionManager = new De(
+      this.runtimeEngine,
+      e,
+      this.layerManager,
+      this.modelCalibrationManager
+    ), this.cameraModule = new Y(
+      this.runtimeEngine.camera,
+      e,
+      r,
+      this.requestRender,
+      this.options.initialView,
+      this.coordinateModule
+    ), this.configureControls(t), this.cameraModule.setControls(this.controls), this.controllerModule = new X(
+      this.runtimeEngine,
+      this.controls,
+      this.requestRender,
+      this.layerManager
+    ), this.controllerModule.switchToGIS(), this.viewCube = new Re(
+      this.cameraModule,
+      { ...V, ...this.options.initialView }
+    ), this.label = new Le(
+      this.runtimeEngine,
+      this.coordinateModule,
+      this.layerManager
+    ), this.options.temporalAntialiasing !== !0 && this.runtimeEngine.composerModule.isEffectEnabled?.("traa") && this.runtimeEngine.composerModule.setEffectEnabled("traa", !1), this.skyManager = new je(this.runtimeEngine), this.options.skyBox ? await this.skyManager.setSkyBox(this.options.skyBox) : this.options.sky === void 0 ? await this.skyManager.setSkyBox() : this.skyManager.setSky(this.options.sky), e.addEventListener("needs-update", this.requestRender), e.addEventListener("load-error", this.handleLoadError), this.resizeObserver = new ResizeObserver(this.updateResolution), this.resizeObserver.observe(this.runtimeEngine.container), this.runtimeEngine.setIdleFrameRateExempt("gis-3d-tiles", !0), this.removeFrameCallback = this.runtimeEngine.addFrameCallback(this.update), this;
+  }
+  /** 返回 GIS 是否已完成初始化且尚未销毁。 */
+  isInitialized() {
+    return !this.disposed && this.tiles !== null && this.cameraModule !== null;
+  }
+  /** 兼容旧版业务入口，加载 3D Tiles 并返回稳定模型句柄。 */
+  async load3DTiles(e) {
+    return await this.requireResourceLoader().loadModel(e.url, {
+      ...e,
+      type: "3dtiles"
+    });
+  }
+  /** 统一加载在线 3D Tiles、glTF/GLB、GeoJSON 或 BIM 模型。 */
+  async loadModel(e, t) {
+    return this.requireResourceLoader().loadModel(e, t);
+  }
+  /** 加载本地 3D Tiles 文件集、glTF/GLB、GeoJSON 或 BIM 文件包。 */
+  async loadModelFile(e, t) {
+    return this.requireResourceLoader().loadModelFile(e, t);
+  }
+  /** 解析 ViewToken 并通过统一 GIS 资源加载链路加载。 */
+  async loadModelByViewToken(e, t) {
+    return this.requireResourceLoader().loadModelByViewToken(e, t);
+  }
+  /** 按统一模型句柄或 id 卸载资源。 */
+  removeModel(e) {
+    return this.resourceLoaderModule?.removeModel(e) ?? !1;
+  }
+  /**
+   * 运行时切换 GIS 底图，并保留当前 WGS84 相机视角和业务图层。
+   * 新底图加载失败时不会修改当前场景。
+   */
+  async switchBaseMap(e) {
+    if (!this.tiles || !this.cameraModule || !this.coordinateModule)
+      throw new Error("GIS 尚未完成初始化。");
+    const t = ++this.baseMapSwitchVersion, r = this.cameraModule.getView(), i = this.controllerModule?.getMode(), s = typeof e == "string" ? await this.loaderModule.loadImageById(e) : await this.loaderModule.load3dtiles(e);
+    if (this.disposed || t !== this.baseMapSwitchVersion) {
+      if (s.tiles.dispose(), this.disposed) throw new Error("GIS 已销毁。");
+      return;
+    }
+    const a = this.tiles;
+    a.removeEventListener("needs-update", this.requestRender), a.removeEventListener("load-error", this.handleLoadError), a.deleteCamera(this.runtimeEngine.camera), this.runtimeEngine.scene.remove(a.group), this.layerManager.unregisterLayer("base-imagery"), this.cameraModule.dispose(), this.controllerModule?.dispose(), this.controls?.dispose(), this.tiles = s.tiles, this.activeBaseSource = e, s.tiles.setCamera(this.runtimeEngine.camera), s.tiles.setResolutionFromRenderer(this.runtimeEngine.camera, this.runtimeEngine.renderer), this.runtimeEngine.scene.add(s.tiles.group), this.layerManager.registerLayer({
+      id: "base-imagery",
+      name: "GIS 底图",
+      type: "imagery",
+      source: this.getBaseLayerSource(),
+      object: s.tiles.group
+    }), this.coordinateModule.setTiles(s.tiles, s.cameraFrame), this.modelPositionManager?.setTiles(s.tiles), this.cameraModule = new Y(
+      this.runtimeEngine.camera,
+      s.tiles,
+      s.cameraFrame,
+      this.requestRender,
+      r,
+      this.coordinateModule
+    ), this.configureControls(s.Controls), this.cameraModule.setControls(this.controls), this.controllerModule = new X(
+      this.runtimeEngine,
+      this.controls,
+      this.requestRender,
+      this.layerManager
+    ), this.controllerModule.switchController(i ?? "gis"), this.viewCube?.setCameraModule(this.cameraModule), s.tiles.addEventListener("needs-update", this.requestRender), s.tiles.addEventListener("load-error", this.handleLoadError), a.dispose(), this.runtimeEngine.events.trigger("gis:base-map-changed", {
+      source: e,
+      timestamp: Date.now()
+    }), this.runtimeEngine.requestRender();
+  }
+  /** 同时支持 3D Tiles 图层 id 和 BIM 模型 URL 的 ENU 校准。 */
+  applyCalibration(e) {
+    return this.modelCalibrationManager?.setTransform(e) ?? !1;
+  }
+  /** 返回全部 3D Tiles 与 BIM 校准状态。 */
+  getModelCalibrationItems() {
+    return this.modelCalibrationManager?.getItems() ?? [];
+  }
+  /** 恢复指定 3D Tiles 或 BIM 模型的校准基准矩阵。 */
+  resetModelCalibration(e) {
+    return this.modelCalibrationManager?.reset(e) ?? !1;
+  }
+  /** 释放控制器、瓦片缓存、事件以及 v3 引擎持有的 GPU 资源。 */
+  dispose() {
+    this.disposed || (this.disposed = !0, this.baseMapSwitchVersion += 1, this.removeFrameCallback?.(), this.removeFrameCallback = null, this.runtimeEngine.setIdleFrameRateExempt("gis-3d-tiles", !1), this.resizeObserver?.disconnect(), this.label?.dispose(), this.controllerModule?.dispose(), this.skyManager?.dispose(), this.cameraModule?.dispose(), this.modelPositionManager?.dispose(), this.controls?.dispose(), this.resourceLoaderModule?.dispose(), this.loaderModule?.dispose(), this.modelCalibrationManager?.dispose(), this.runtimeEngine.viewCube?.setHomeBoundingBoxProvider?.(null), this.tiles && (this.tiles.removeEventListener("needs-update", this.requestRender), this.tiles.removeEventListener("load-error", this.handleLoadError), this.tiles.deleteCamera(this.runtimeEngine.camera), this.runtimeEngine.scene.remove(this.tiles.group), this.tiles.dispose()), this.layerManager.dispose(), this.controls = null, this.tiles = null, this.coordinateModule = null, this.cameraModule = null, this.controllerModule = null, this.modelPositionManager = null, this.modelCalibrationManager = null, this.resourceLoaderModule = null, this.label = null, this.viewCube = null, this.skyManager = null, this.runtimeEngine.dispose());
+  }
+  configureControls(e) {
+    this.runtimeEngine.controlModule.disActive();
+    const t = new e(this.tiles.group, this.runtimeEngine.camera, this.runtimeEngine.renderer.domElement);
+    this.disableIncompatiblePivotMarker(t), t.setEllipsoid(this.tiles.ellipsoid, this.tiles.group), t.enableDamping = !0, t.cameraRadius = 0, t.minDistance = 0, t.adjustHeight = !1, t.addEventListener("change", this.requestRender), this.controls = t;
+  }
+  /** WebGPU 不编译 GlobeControls 内置的 GLSL ShaderMaterial，因此禁用该辅助圆圈。 */
+  disableIncompatiblePivotMarker(e) {
+    if (!this.usesWebGpuBackend()) return;
+    const t = e.pivotMesh;
+    if (!t?.material) return;
+    const i = (Array.isArray(t.material) ? t.material : [t.material]).filter((s) => s.isShaderMaterial === !0 && s.isNodeMaterial !== !0);
+    i.length !== 0 && (i.forEach((s) => {
+      s.visible = !1;
+    }), t.visible = !1);
+  }
+  /** WebGPURenderer 可承载 WebGPU 或 WebGL2，兼容逻辑必须按实际后端判断。 */
+  usesWebGpuBackend() {
+    return this.runtimeEngine.renderer.coordinateSystem === ve;
+  }
+  update = (e) => {
+    if (this.disposed) return;
+    const t = this.previousTime === 0 ? 0 : (e - this.previousTime) / 1e3;
+    this.previousTime = e, this.cameraModule?.update(e), this.controls?.enabled && this.controls.update(t), this.tiles?.group.visible && this.tiles.update(), this.loaderModule?.update(), this.label?.update(), this.runtimeEngine.requestRender();
+  };
+  updateResolution = () => {
+    this.tiles?.setResolutionFromRenderer(this.runtimeEngine.camera, this.runtimeEngine.renderer), this.loaderModule?.updateResolution(), this.runtimeEngine.requestRender();
+  };
+  requestRender = () => {
+    this.runtimeEngine.requestRender();
+  };
+  handleLoadError = (e) => {
+    const t = e.error instanceof Error ? e.error : new Error("3D Tiles 加载失败。");
+    this.options.onError?.(t);
+  };
+  getBaseLayerSource() {
+    const e = this.activeBaseSource;
+    return typeof e == "string" ? e : e.type === "url" || e.type === "xyz" ? e.url : `cesium-ion:${e.assetId ?? 2275207}`;
+  }
+  requireResourceLoader() {
+    if (!this.resourceLoaderModule) throw new Error("GIS 尚未完成初始化。");
+    return this.resourceLoaderModule;
+  }
+}
+async function Qe(n) {
+  n.assetFiles ? await F(n.assetFiles) : n.assetFile ? await re(n.assetFile) : n.assetBaseUrl && await F(null), n.assetBaseUrl && ie(n.assetBaseUrl);
+}
+async function mt(n, e = {}) {
+  await Qe(n);
+  const t = n.engineVersion === "v2" ? new (await import("./engine-3d-BsWcD-bl.js").then((i) => i.e)).EngineKernelV2(n) : new (await import("./EngineKernel-CZX0Omjs.js")).EngineKernelV3(n), r = new Ze(t, e);
+  try {
+    return "ready" in t && await t.ready, await r.initialize();
+  } catch (i) {
+    throw r.dispose(), i;
+  }
+}
+var W = /* @__PURE__ */ ((n) => (n.ModelLoadStart = "model-load-start", n.ModelLoadProgress = "model-load-progress", n.ModelLoaded = "model-loaded", n.ModelError = "model-error", n.SelectionChanged = "selection-changed", n.HoverChanged = "hover-changed", n.Click = "click", n.MouseMove = "mouse-move", n.ModelPlaceSelected = "model-place-selected", n.ModelCalibrationChanged = "model-calibration-changed", n.CameraChanged = "camera-changed", n.CameraIdle = "camera-idle", n.EngineFree = "engine-free", n.EngineBusy = "engine-busy", n.MeasureChanged = "measure-changed", n.MeasureClick = "measure-click", n.SectionMove = "section-move", n.LoadingCompleted = "loading_completed", n))(W || {});
+class pt {
+  options;
+  snapshots = /* @__PURE__ */ new Map();
+  isDisposed = !1;
+  eventsBound = !1;
+  handleLoadingCompleted = () => {
+    this.options.enabled && this.replaceAll();
+  };
+  engine;
+  constructor(e, t = {}, r = {}) {
+    this.engine = e;
+    const i = this.normalizeInput(t, r);
+    this.options = {
+      enabled: i.enabled ?? this.hasRules(i),
+      rules: this.normalizeRules(i)
+    };
+  }
+  /** 注册模型加载事件并立即处理当前已有模型。 */
+  init(e = {}) {
+    this.isDisposed || (Object.keys(e).length > 0 && (this.options.enabled = e.enabled ?? this.options.enabled, (e.rules != null || e.materialName != null || e.materialParams != null) && (this.options.rules = this.normalizeRules(e))), this.eventsBound || (this.engine.events?.on?.(W.LoadingCompleted, this.handleLoadingCompleted), this.eventsBound = !0), this.options.enabled && this.replaceAll());
+  }
+  isEnabled() {
+    return this.options.enabled;
+  }
+  /** 开关自动替换；关闭时恢复管理器修改过的材质。 */
+  setEnabled(e) {
+    return this.options.enabled = e, e ? this.replaceAll() : (this.restoreAll(), 0);
+  }
+  setMaterialName(e) {
+    return this.restoreAll(), this.options.rules = [{
+      materialName: e,
+      materialParams: {}
+    }], this.options.enabled ? this.replaceAll() : 0;
+  }
+  setMaterialParams(e) {
+    const t = this.options.rules[0] ?? {
+      materialName: "",
+      materialParams: {}
+    };
+    return t.materialParams = {
+      ...t.materialParams,
+      ...e
+    }, this.options.rules = [t, ...this.options.rules.slice(1)], this.options.enabled ? this.replaceAll() : 0;
+  }
+  setRules(e) {
+    return this.restoreAll(), this.options.rules = e.map((t) => ({
+      ...t,
+      materialParams: { ...t.materialParams }
+    })), this.options.enabled ? this.replaceAll() : 0;
+  }
+  addRule(e) {
+    return this.options.rules.push({ ...e, materialParams: { ...e.materialParams } }), this.options.enabled ? this.replaceAll() : 0;
+  }
+  removeRule(e) {
+    return e >= 0 && e < this.options.rules.length && this.options.rules.splice(e, 1), this.options.enabled ? this.replaceAll() : 0;
+  }
+  getRules() {
+    return this.options.rules.map((e) => ({
+      ...e,
+      materialParams: { ...e.materialParams }
+    }));
+  }
+  /** 替换所有已加载模型中匹配名称的材质，返回受影响的材质数量。 */
+  replaceAll() {
+    if (this.isDisposed || !this.options.enabled)
+      return 0;
+    const e = /* @__PURE__ */ new Set();
+    return le(this.engine, (t) => (this.collectObjectMaterials(t, e), !1)), this.applyMaterials(e);
+  }
+  /** 替换指定模型 URL 或模型对象中的材质。 */
+  replaceModel(e) {
+    if (this.isDisposed || !this.options.enabled)
+      return 0;
+    const t = typeof e == "string" ? b(this.engine, e) : e;
+    if (t == null)
+      return 0;
+    const r = /* @__PURE__ */ new Set();
+    return t.traverse((i) => this.collectObjectMaterials(i, r)), this.applyMaterials(r);
+  }
+  /** 对单个材质执行当前规则，供加载器在合批前调用。 */
+  applyMaterial(e) {
+    if (this.isDisposed || !this.options.enabled || e == null)
+      return !1;
+    const t = this.options.rules.filter((s) => this.matches(e, s));
+    if (t.length === 0)
+      return !1;
+    const r = Object.assign({}, ...t.map((s) => s.materialParams)), i = Object.keys(r);
+    if (!this.snapshots.has(e))
+      this.snapshots.set(e, this.captureSnapshot(e, i));
+    else {
+      const s = this.snapshots.get(e);
+      i.forEach((a) => {
+        s.has(a) || s.set(a, this.cloneMaterialValue(e[a]));
+      });
+    }
+    return Object.entries(r).forEach(([s, a]) => this.applyMaterialValue(e, s, a)), e.needsUpdate = !0, !0;
+  }
+  getReplacedMaterialCount() {
+    return this.snapshots.size;
+  }
+  /** 恢复管理器修改过的全部材质。 */
+  restoreAll() {
+    this.snapshots.forEach((e, t) => {
+      e.forEach((r, i) => this.applyMaterialValue(t, i, r)), t.needsUpdate = !0;
+    }), this.snapshots.clear(), this.engine.requestComposerRender?.();
+  }
+  dispose() {
+    this.isDisposed || (this.eventsBound && (this.engine.events?.off?.(W.LoadingCompleted, this.handleLoadingCompleted), this.eventsBound = !1), this.restoreAll(), this.isDisposed = !0);
+  }
+  normalizeRules(e) {
+    return Array.isArray(e.rules) ? e.rules.map((t) => ({
+      ...t,
+      materialParams: { ...t.materialParams }
+    })) : [{
+      materialName: e.materialName,
+      materialParams: { ...e.materialParams ?? {} }
+    }].filter((t) => t.materialName != null);
+  }
+  normalizeInput(e, t) {
+    return Array.isArray(e) ? { enabled: !0, rules: e } : typeof e == "string" || e instanceof RegExp || typeof e == "function" ? { enabled: !0, materialName: e, materialParams: t } : e;
+  }
+  hasRules(e) {
+    return Array.isArray(e.rules) && e.rules.length > 0 || e.materialName != null;
+  }
+  applyMaterials(e) {
+    let t = 0;
+    return e.forEach((r) => {
+      this.applyMaterial(r) && (t += 1);
+    }), t > 0 && this.engine.requestComposerRender?.(), t;
+  }
+  collectObjectMaterials(e, t) {
+    const r = e;
+    (Array.isArray(r.material) ? r.material : r.material != null ? [r.material] : []).filter(Boolean).forEach((s) => t.add(s));
+  }
+  matches(e, t) {
+    const r = t.materialName ?? t.name;
+    return typeof r == "function" ? r(e) : r instanceof RegExp ? (r.lastIndex = 0, r.test(e.name)) : typeof r == "string" && r.length > 0 && e.name.includes(r);
+  }
+  captureSnapshot(e, t) {
+    const r = /* @__PURE__ */ new Map();
+    return t.forEach((i) => r.set(i, this.cloneMaterialValue(e[i]))), r;
+  }
+  cloneMaterialValue(e) {
+    return e?.isColor === !0 && typeof e.clone == "function" ? e.clone() : e;
+  }
+  applyMaterialValue(e, t, r) {
+    const i = e[t];
+    if (t === "color" && i?.isColor === !0) {
+      r instanceof Ee ? i.copy(r) : i.set(r);
+      return;
+    }
+    r !== void 0 && (t in e || t === "envMapIntensity") && (e[t] = r);
+  }
+}
+const Ke = {
+  vxgi: {
+    // VXGI 需要体素化整套场景，默认关闭以避免影响现有项目的初始化性能。
+    enabled: !1,
+    resolution: 128,
+    coneCount: 3,
+    coneAngle: 40,
+    giIntensity: 1.5,
+    aoIntensity: 1,
+    aoMinVisibility: 0,
+    aoDistance: 1,
+    normalOffset: 1.5,
+    maxDistance: 50,
+    stepScale: 1,
+    bounces: 0,
+    directionalRadiance: !1,
+    useTemporalFiltering: !0,
+    updateOnChange: !0
+  },
+  colorGrading: {
+    /**
+     * 色温，单位 Kelvin；6500K 为中性白。
+     * 性能：偏离 6500K 时才会创建色彩分级全屏通道；单个色温乘法本身开销很小。
+     */
+    colorTemperature: 5e3,
+    /**
+     * 饱和度倍率；0 为黑白，1 为原始饱和度。
+     * 性能：只增加一次全屏颜色计算；若所有颜色分级参数均为中性，则该通道不会创建。
+     */
+    saturation: 1.05,
+    /**
+     * 对比度倍率；1 为原始对比度。
+     * 性能：只增加一次全屏颜色计算；调节数值不会增加采样次数。
+     */
+    contrast: 1.05,
+    /**
+     * RCAS 锐化强度，范围 0~1；0 关闭，1 最强。
+     * 性能：大于 0 会额外执行锐化全屏通道，并产生邻域纹理采样；通常是本组参数中
+     * 成本最高的项目，移动端建议保持 0 或使用较低值。
+     */
+    sharpen: 0.1
+  },
+  ssgi: {
+    /**
+     * 是否启用屏幕空间间接光照（SSGI），同时包含环境遮蔽贡献。
+     * 性能：启用后增加高成本的全屏光线采样和临时纹理；关闭可直接节省整组开销。
+     */
+    enabled: !0,
+    /**
+     * 每像素的采样方向数（slice）。
+     * 性能：与 `stepCount` 相乘决定主要采样量，成本近似线性增加；优先降低此值
+     * 以换取帧率，过低会出现方向性噪声。
+     */
+    sliceCount: 1,
+    /**
+     * 每个方向的光线步进数。
+     * 性能：与 `sliceCount` 相乘决定主要采样量，成本近似线性增加；提高后会明显
+     * 增加 GPU 时间，默认低步数适合实时场景。
+     */
+    stepCount: 2,
+    /**
+     * 环境遮蔽强度；0 表示不增加遮蔽，1 为常用强度。
+     * 性能：只改变结果合成，不改变采样次数，性能影响很小。
+     */
+    aoIntensity: 1,
+    /**
+     * 间接光照强度；0 表示不叠加间接光，1 为基准强度。
+     * 性能：只改变结果合成，不改变采样次数，性能影响很小。
+     */
+    giIntensity: 2,
+    /**
+     * 屏幕空间采样半径，单位为场景单位。
+     * 性能：主要影响光线覆盖范围和命中结果，不直接增加采样次数；过大可能扩大
+     * 有效搜索区域并增加纹理访问压力。
+     */
+    radius: 1.5,
+    /**
+     * 是否使用屏幕空间半径计算；关闭时使用视图空间计算。
+     * 性能：两种路径采样次数相同，差异主要来自每步坐标换算；通常不是首要调优项。
+     */
+    useScreenSpaceSampling: !0,
+    /**
+     * 遮蔽/光照衰减指数，控制远距离样本的权重。
+     * 性能：只增加少量幂运算，不改变采样数量；主要是画质参数。
+     */
+    expFactor: 1,
+    /**
+     * 深度厚度容差，用于判断样本是否与几何体相交。
+     * 性能：只影响命中判定，不改变采样数量；过大可能造成漏光或光晕。
+     */
+    thickness: 1,
+    /**
+     * 是否使用线性厚度计算，改善不同深度距离下的相交一致性。
+     * 性能：增加少量分支和坐标换算，开销远小于增加步进数。
+     */
+    useLinearThickness: !1,
+    /**
+     * 背面光照权重；0 不使用背面光照。
+     * 性能：主要影响样本合成，增加的计算很小；较高值可能放大背面漏光。
+     */
+    backfaceLighting: 0,
+    /**
+     * 是否启用 SSGI 时域滤波。
+     * 性能：需要维护历史结果并增加时域合成开销和显存占用；可降低噪声，但仅在
+     * 时域渲染条件满足（通常同时启用 TRAA）时生效。
+     */
+    useTemporalFiltering: !0
+  },
+  traa: {
+    /**
+     * 是否启用时域抗锯齿（TRAA）。
+     * 性能：增加一次全屏时域重投影、历史纹理和运动信息处理；关闭可省掉中等开销，
+     * 但 SSGI/GTAO 的时域滤波也会随条件失效。
+     */
+    enabled: !0,
+    /**
+     * 深度相似阈值，用于判断历史样本是否可复用。
+     * 性能：只影响每像素判定，不改变采样次数，性能影响很小。
+     */
+    depthThreshold: 5e-4,
+    /**
+     * 边缘深度差阈值，用于处理几何边缘的历史权重。
+     * 性能：只影响每像素判定，不改变采样次数，性能影响很小。
+     */
+    edgeDepthDiff: 1e-3,
+    /**
+     * 允许的最大速度长度，用于限制运动矢量重投影范围。
+     * 性能：只影响向量限制和历史采样位置，性能影响很小；过大可能增加拖影。
+     */
+    maxVelocityLength: 128,
+    /**
+     * 是否启用亚像素修正。
+     * 性能：增加少量边缘权重计算，开销较小；密集细杆接近单像素宽度时可减少闪烁。
+     */
+    useSubpixelCorrection: !1
+  },
+  ssr: {
+    /**
+     * 是否启用屏幕空间反射（SSR）。
+     * 性能：增加全屏光线步进、命中判定及可能的模糊通道，是最昂贵的效果之一；
+     * 关闭可直接省掉整组 GPU 和临时纹理开销。
+     */
+    enabled: !0,
+    /**
+     * 是否使用随机 GGX 反射方向；关闭时使用单一镜面反射路径。
+     * 性能：随机路径通常需要更多光线步进和去噪，GPU 成本更高；只有在需要粗糙材质
+     * 反射质量时才建议开启。
+     */
+    stochastic: !1,
+    /**
+     * 是否对环境贴图执行重要性采样，用于 SSR 未命中时的环境反射。
+     * 性能：会在环境贴图上预计算亮度分布表，增加初始化/重建时间、显存和采样开销；
+     * 没有有效环境贴图时不会生效。
+     */
+    envImportanceSampling: !1,
+    /**
+     * SSR 未命中时使用的环境节点；null 表示不补充环境反射。
+     * 性能：提供环境节点会增加环境纹理读取；保持 null 时无额外环境采样。
+     */
+    environmentNode: null,
+    /**
+     * 是否反射非金属材质；关闭时仅处理金属表面。
+     * 性能：开启后更多屏幕像素进入反射计算，通常会增加 GPU 时间；建筑场景可按需开启。
+     */
+    reflectNonMetals: !0,
+    /**
+     * 是否对命中位置进行二分细化。
+     * 性能：命中后增加二分搜索步进，成本随命中像素数增加；能改善反射边缘精度。
+     */
+    binaryRefine: !1,
+    /**
+     * SSR 渲染分辨率倍率；1 为全分辨率，0.5 的像素数约为全分辨率的四分之一。
+     * 性能：按宽高平方影响光线步进、纹理带宽和临时目标显存，是 SSR 最有效的调优项。
+     */
+    resolutionScale: 0.5,
+    /**
+     * 最大反射距离，单位为场景单位。
+     * 性能：距离越大，光线覆盖范围越广，命中和纹理访问压力通常越高；不会简单地
+     * 线性增加固定步数，但会增加长距离反射的平均成本。
+     */
+    maxDistance: 8,
+    /**
+     * 深度厚度容差，用于 SSR 命中判定。
+     * 性能：主要改变命中结果，不增加步进次数，性能影响很小。
+     */
+    thickness: 0.15,
+    /**
+     * 反射叠加强度；0 表示不叠加反射。
+     * 性能：只改变最终合成，不改变光线步进数量，性能影响很小。
+     */
+    intensity: 0.85,
+    /**
+     * 屏幕边缘反射淡出宽度，范围通常为 0~1。
+     * 性能：只增加少量边缘计算，不改变光线步进数量。
+     */
+    screenEdgeFade: 0.2,
+    /**
+     * 是否使用黑色边缘淡出路径。
+     * 性能：属于编译期分支，影响很小；修改后需要重建 SSR 节点。
+     */
+    screenEdgeFadeBlack: !1,
+    /**
+     * 反射亮度上限，用于抑制 HDR 过曝。
+     * 性能：只增加亮度限制计算，不改变采样数量。
+     */
+    maxLuminance: 10,
+    /**
+     * SSR 光线步进质量，范围 0~1；越高步进越密。
+     * 性能：直接影响每像素光线步数，成本近似线性增加；是仅次于分辨率的主要调优项。
+     */
+    quality: 0.5,
+    /**
+     * 随机 GGX 反射的镜面偏置，控制采样方向集中程度。
+     * 性能：不改变随机路径的步数，主要影响噪声和反射形状，性能影响很小。
+     */
+    mirrorBias: 0.5,
+    /**
+     * 非随机 SSR 的模糊质量，通常为 1~3。
+     * 性能：仅在 `stochastic=false` 时生效；质量越高模糊邻域采样越多，成本和显存
+     * 带宽越高，并且修改会重建模糊材质。
+     */
+    blurQuality: 2,
+    /**
+     * 光线步进在近端/远端的分布指数。
+     * 性能：通常是编译期常量，不改变总步数；主要改变采样分布和命中质量，修改会重建节点。
+     */
+    stepExponent: 2,
+    /**
+     * 环境反射强度，用于 SSR 未命中时的环境贡献。
+     * 性能：只影响环境结果合成；启用环境节点时会保留对应纹理读取。
+     */
+    environmentIntensity: Math.PI
+  },
+  bloom: {
+    /**
+     * Bloom 会创建多级降采样纹理，默认关闭以保持现有画面和显存占用不变。
+     * 业务可通过 postProcessing.bloom 显式开启。
+     */
+    enabled: !1,
+    /** 辉光叠加强度，只影响最终合成，不改变采样数量。 */
+    strength: 0.05,
+    /** 辉光扩散半径，值越大光晕越宽。 */
+    radius: 0.1,
+    /** 仅让高亮区域产生辉光，避免普通材质整体泛白。 */
+    threshold: 0.1,
+    /** 平滑亮度阈值边缘，减少阈值附近的闪烁和硬边。 */
+    smoothWidth: 0.01,
+    /** 半分辨率可显著降低多级模糊的纹理带宽和显存成本。 */
+    resolutionScale: 0.5
+  },
+  gtao: {
+    /**
+     * 是否启用 GTAO 屏幕空间环境遮蔽。
+     * 性能：增加一次全屏遮蔽采样和合成；关闭可省掉整组 GPU、临时纹理和带宽开销。
+     */
+    enabled: !0,
+    /**
+     * GTAO 渲染分辨率倍率；1 为全分辨率，0.5 的像素数约为全分辨率的四分之一。
+     * 性能：按宽高平方影响采样、带宽和显存，是 GTAO 最有效的性能调优项。
+     */
+    resolutionScale: 1,
+    /**
+     * 遮蔽半径，单位为场景单位。
+     * 性能：主要影响搜索范围和结果，不直接增加固定采样数；过大可能增加有效纹理访问。
+     */
+    radius: 0.15,
+    /**
+     * 深度厚度容差，用于遮蔽命中判断。
+     * 性能：不改变采样数量，主要影响漏光和遮蔽边界，性能影响很小。
+     */
+    thickness: 0.5,
+    /**
+     * 距离衰减指数。
+     * 性能：只影响每像素衰减计算，不增加采样数量。
+     */
+    distanceExponent: 0.5,
+    /**
+     * 距离衰减范围控制。
+     * 性能：只影响每像素衰减计算，不增加采样数量。
+     */
+    distanceFallOff: 1,
+    /**
+     * GTAO 结果缩放；0 表示不增加遮蔽，1 为基准效果。
+     * 性能：只改变结果合成，不改变采样数量。
+     */
+    scale: 0.5,
+    /**
+     * 每像素采样数。
+     * 性能：直接影响 AO 采样循环，成本近似线性增加；提高后画质更稳定，但 GPU 时间同步增加。
+     */
+    samples: 10,
+    /**
+     * 是否启用 GTAO 时域滤波。
+     * 性能：需要历史纹理和额外时域合成开销，并增加显存占用；可降低低采样数下的噪声，
+     * 仅在时域渲染条件满足时实际生效。
+     */
+    useTemporalFiltering: !0
+  }
+}, $ = ["vxgi", "ssgi", "gtao", "ssr", "traa"];
+function et() {
+  const n = {};
+  return $.forEach((e) => {
+    const { enabled: t, ...r } = Ke[e];
+    n[e] = { ...r };
+  }), n;
+}
+function M(n, e, t, r, i, s = {}) {
+  const a = et();
+  return $.forEach((o) => {
+    Object.assign(a[o], s[o] ?? {});
+  }), {
+    level: n,
+    name: e,
+    shadow: { enabled: t, mapSize: r },
+    effects: {
+      vxgi: !1,
+      ssgi: !1,
+      gtao: !1,
+      ssr: !1,
+      traa: !1,
+      ...i
+    },
+    parameters: a
+  };
+}
+const ft = [
+  M(1, "L1", !1, 512, {}),
+  M(2, "L2", !1, 512, { gtao: !0 }, { gtao: { resolutionScale: 0.5, samples: 4, scale: 0.25, useTemporalFiltering: !1 } }),
+  M(3, "L3", !0, 512, { gtao: !0 }, { gtao: { resolutionScale: 0.5, samples: 4, scale: 0.3, useTemporalFiltering: !1 } }),
+  M(4, "L4", !0, 1024, { gtao: !0 }, { gtao: { resolutionScale: 0.5, samples: 6, scale: 0.35, useTemporalFiltering: !1 } }),
+  M(5, "L5", !0, 1024, { gtao: !0, traa: !0 }, { gtao: { resolutionScale: 0.5, samples: 6, scale: 0.4 } }),
+  M(6, "L6", !0, 2048, { gtao: !0, traa: !0 }, { gtao: { resolutionScale: 0.75, samples: 8, scale: 0.45 } }),
+  M(7, "L7", !0, 2048, { gtao: !0, ssgi: !0, traa: !0 }, { gtao: { resolutionScale: 1, samples: 6, scale: 0.25 }, ssgi: { sliceCount: 1, stepCount: 2, aoIntensity: 0.45, giIntensity: 1 } }),
+  // Level 8 完整继承 defaults.ts 的参数，作为十二档画质的中间基准。
+  M(8, "L8", !0, 2048, { gtao: !0, ssgi: !0, traa: !0, ssr: !0 }),
+  M(9, "L9", !0, 2048, { gtao: !0, ssgi: !0, traa: !0, ssr: !0 }, { gtao: { resolutionScale: 1, samples: 12, scale: 0.55 }, ssgi: { sliceCount: 1, stepCount: 3, aoIntensity: 1.05, giIntensity: 2.1 }, ssr: { resolutionScale: 0.6, quality: 0.6, blurQuality: 2 } }),
+  M(10, "L10", !0, 2048, { gtao: !0, ssgi: !0, traa: !0, ssr: !0 }, { gtao: { resolutionScale: 1, samples: 12, scale: 0.6 }, ssgi: { sliceCount: 2, stepCount: 4, aoIntensity: 1.1, giIntensity: 2.2 }, ssr: { resolutionScale: 0.75, quality: 0.7, binaryRefine: !0, blurQuality: 2 } }),
+  M(11, "L11", !0, 4096, { gtao: !0, ssgi: !0, traa: !0, ssr: !0 }, { gtao: { resolutionScale: 1, samples: 16, scale: 0.7 }, ssgi: { sliceCount: 2, stepCount: 6, aoIntensity: 1.2, giIntensity: 2.4 }, ssr: { resolutionScale: 1, quality: 0.8, binaryRefine: !0, blurQuality: 3 } }),
+  M(12, "L12", !0, 4096, { vxgi: !0, gtao: !0, ssgi: !0, traa: !0, ssr: !0 }, { vxgi: { resolution: 128, coneCount: 4, bounces: 1 }, gtao: { resolutionScale: 1, samples: 20, scale: 0.8 }, ssgi: { sliceCount: 3, stepCount: 8, aoIntensity: 1.3, giIntensity: 2.6 }, ssr: { resolutionScale: 1, quality: 0.9, binaryRefine: !0, blurQuality: 3 } })
+], yt = [
+  { id: "indoor", name: "Indoor", category: "indoor", hdrId: "11", hdrIntensity: 0.45, ambientIntensity: 0.5, directionalIntensity: 2 },
+  { id: "outdoor", name: "Outdoor", category: "outdoor", hdrId: "1", hdrIntensity: 0.5, ambientIntensity: 0.2, directionalIntensity: 3 }
+];
+function Mt(n) {
+  return {
+    ...n,
+    shadow: { ...n.shadow },
+    effects: { ...n.effects },
+    parameters: Object.fromEntries(
+      $.map((e) => [e, { ...n.parameters[e] }])
+    )
+  };
+}
+async function j(n) {
+  n?.assetFiles ? await F(n.assetFiles) : n?.assetFile ? await re(n.assetFile) : n?.assetBaseUrl && await F(null), n?.assetBaseUrl && ie(n.assetBaseUrl);
+}
+async function bt(n, e) {
+  if (await j(n), (e ?? (typeof navigator < "u" && "gpu" in navigator ? "webgpu" : "webgl")) === "webgpu") {
+    const { EngineKernelV3: i } = await import("./EngineKernel-CZX0Omjs.js"), s = new i(n);
+    return await s.ready, s;
+  }
+  const { EngineKernelV2: r } = await import("./engine-3d-BsWcD-bl.js").then((i) => i.e);
+  return new r(n);
+}
+async function wt(n) {
+  await j(n);
+  const { EngineKernel2d: e } = await import("./engine-2d-CA5-uNuf.js").then((t) => t.E);
+  return new e(n);
+}
+async function vt(n) {
+  await j(n);
+  const { EngineKernel720: e } = await import("./engine-720-DiTJEtdN.js");
+  return new e(n);
+}
+async function Et(n) {
+  await j(n);
+  const { EngineKernelGaussian: e } = await import("./engine-gaussian-BHUGuaw_.js");
+  return new e(n);
+}
+export {
+  wt as A,
+  vt as B,
+  Y as C,
+  Ke as D,
+  W as E,
+  mt as F,
+  v as G,
+  Et as H,
+  pt as M,
+  gt as a,
+  ot as b,
+  lt as c,
+  ct as d,
+  nt as e,
+  ut as f,
+  at as g,
+  b as h,
+  le as i,
+  ft as j,
+  Mt as k,
+  yt as l,
+  se as m,
+  dt as n,
+  Pe as o,
+  X as p,
+  ze as q,
+  Le as r,
+  ht as s,
+  xe as t,
+  Re as u,
+  Oe as v,
+  Xe as w,
+  je as x,
+  De as y,
+  bt as z
+};