@ridp/threejs 1.3.3 → 1.4.1

package/dist/threejs.js

@@ -1,74 +1,119 @@
-var R = Object.defineProperty;
-var g = (a, e, s) => e in a ? R(a, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : a[e] = s;
-var t = (a, e, s) => g(a, typeof e != "symbol" ? e + "" : e, s);
-import { I as M, i as q, o as F, c as I, b as k, a as H, u as W } from "./useGLTFLoader-MhUFIZp1.js";
-import { d as x, C as v, j as b } from "./ImageLoader-xzOH4Owt.js";
-import { I as V, h as _, g as G, b as N, c as J, a as U, e as Y, f as K, i as Q, k as X } from "./ImageLoader-xzOH4Owt.js";
-import { c as $, a as ee, d as te, e as se, g as ie, o as ne, b as re } from "./modelSerialize-DWUt6OcZ.js";
-import { MathUtils as m, Scene as L, PerspectiveCamera as O, WebGLRenderer as y, Box3 as S, Vector3 as c } from "three";
-const z = "1.3.2", T = {
+var H = Object.defineProperty;
+var A = (p, e, t) => e in p ? H(p, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[e] = t;
+var o = (p, e, t) => A(p, typeof e != "symbol" ? e + "" : e, t);
+import { i as se, o as oe, c as ie, b as ne, a as re, u as ae } from "./useBatchGLTFLoader-B5EUagWI.js";
+import { d as P, S as j, s as V, j as q } from "./PredictiveLoader-CZfMSjv-.js";
+import { C as ce, E as he, I as de, M as me, P as ue, q as fe, R as pe, n as xe, h as ge, g as Fe, b as Re, c as Me, a as Ee, e as Te, f as be, i as ze, l as we, m as Le, o as ve, k as Oe, p as Ce, r as ye, u as Se } from "./PredictiveLoader-CZfMSjv-.js";
+import { I as Ie, c as He, a as Ae, g as Pe, i as je } from "./ImageLoader-Br_nvMOg.js";
+import { ModelOptimizer as qe, modelOptimizer as Xe } from "./modelOptimizer-BRPnM2RH.js";
+import { MathUtils as g, Scene as X, PerspectiveCamera as Y, WebGLRenderer as B, Box3 as Z, Vector3 as d, Box3Helper as _ } from "three";
+const G = "1.4.1", N = 50, W = 20, k = 20, C = {
+  TOP: "top",
+  // 俯视（从上往下）
+  RIGHT: "right",
+  // 侧视（从右往左）
+  LEFT: "left",
+  // 左侧视
+  ISO: "iso"
+  // 正斜视（等轴测视角）
+}, U = {
   enableDamping: !0,
   dampingFactor: 0.25,
   screenSpacePanning: !1,
   minDistance: 0.1,
   maxDistance: 1e3,
-  maxPolarAngle: m.degToRad(60)
+  maxPolarAngle: g.degToRad(60)
 };
-class l {
-  constructor(e, s) {
-    t(this, "isReady", !1);
-    t(this, "scene", null);
-    t(this, "camera", null);
-    t(this, "renderer", null);
-    t(this, "control", null);
-    t(this, "css3dRenderer", null);
-    t(this, "el", null);
-    t(this, "renderRequested", !1);
-    t(this, "selector", null);
-    t(this, "eventsListener", {});
-    t(this, "stats", null);
-    t(this, "isDispose", !1);
-    t(this, "version", "0.0.0");
-    t(this, "initOpt", {
+class $ {
+  /**
+   * 构造函数
+   * @param {string} selector - DOM 容器选择器
+   * @param {Object} option - 配置选项
+   * @param {boolean} [option.css3d=false] - 是否启用 CSS3D 渲染器
+   * @param {boolean} [option.stats=false] - 是否显示性能统计
+   * @param {string} [option.renderType='change'] - 渲染类型: 'loop' 或 'change'
+   * @param {boolean} [option.initListener=true] - 是否初始化事件监听器
+   * @param {number} [option.initialFov=50] - 初始相机 FOV 值
+   * @param {Object} [option.control] - 控制器配置
+   * @param {boolean} [option.control.init=true] - 是否初始化控制器
+   * @param {Object} [option.control.options={}] - 控制器选项
+   */
+  constructor(e, t) {
+    o(this, "isReady", !1);
+    o(this, "scene", null);
+    o(this, "camera", null);
+    o(this, "renderer", null);
+    o(this, "control", null);
+    o(this, "css3dRenderer", null);
+    o(this, "el", null);
+    o(this, "renderRequested", !1);
+    o(this, "selector", null);
+    o(this, "eventsListener", {});
+    o(this, "stats", null);
+    o(this, "isDispose", !1);
+    o(this, "version", "0.0.0");
+    o(this, "boxHelper", null);
+    o(this, "initOpt", {
       css3d: !1,
       stats: !1,
       renderType: "change",
-      initListener: "True",
+      initListener: !0,
+      // 使用布尔值代替字符串
+      initialFov: 50,
+      // 初始 FOV 值，用于避免全屏切换时的累积误差
       control: {
         init: !0,
         options: {}
       }
     });
-    t(this, "setup", (e) => {
-      this.isDispose = !1, this.selector = e, this.el = document.querySelector(e);
-      const s = Math.tan(Math.PI / 180 * this.camera.fov / 2), [i, r] = this.getTargetSize();
-      if (this.camera.aspect = i / r, this.camera.position.set(47, 39, 100), this.camera.fov = 360 / Math.PI * Math.atan(s * (r / i)), this.camera.lookAt(0, 0, 0), this.camera.updateProjectionMatrix(), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(i, r), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
-        this.control = x(this.camera, this.renderer.domElement);
-        const d = Object.assign(
-          T,
+    /**
+     * 初始化场景
+     * @param {string} selector - DOM 容器选择器
+     */
+    o(this, "setup", (e) => {
+      if (this.isDispose = !1, this.selector = e, this.el = document.querySelector(e), !this.el) {
+        console.error(`ThreeIns: 找不到元素 ${e}`);
+        return;
+      }
+      const [t, l] = this.getTargetSize();
+      if (this.updateCameraFOV(t, l), this.camera.position.set(0, 0, 0), this.camera.lookAt(0, 0, 0), this.camera.updateProjectionMatrix(), this.renderer.setPixelRatio(window.devicePixelRatio), this.renderer.setSize(t, l), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
+        this.control = P(this.camera, this.renderer.domElement);
+        const s = Object.assign(
+          U,
           this.initOpt.control.options || {}
         );
-        Object.keys(d).forEach((n) => {
-          this.control[n] = d[n];
+        Object.keys(s).forEach((x) => {
+          this.control[x] = s[x];
         });
       }
       setTimeout(() => {
         this.isReady = !0;
-      }, 20), this.initOpt.stats && this.initStats(), this.initOpt.css3d && this.initCss3dRenderer(), this.initOpt.renderType === "loop" ? requestAnimationFrame(this.animate) : this.initOpt.renderType === "change" && this.control && this.control.addEventListener(
+      }, W), this.initOpt.stats && this.initStats(), this.initOpt.css3d && this.initCss3dRenderer(), this.initOpt.renderType === "loop" ? this.animate() : this.initOpt.renderType === "change" && this.control && this.control.addEventListener(
         "change",
         this.requestRenderIfNotRequested
       ), this.initListener();
     });
-    t(this, "onContextLost", (e) => {
-      e.preventDefault(), cancelAnimationFrame(this.animate);
+    /**
+     * WebGL 上下文丢失处理
+     * @param {Event} e - 事件对象
+     */
+    o(this, "onContextLost", (e) => {
+      e.preventDefault(), this.animationFrameId && cancelAnimationFrame(this.animationFrameId);
     });
-    t(this, "onContextRestored", (e) => {
+    /**
+     * WebGL 上下文恢复处理
+     * @param {Event} e - 事件对象
+     */
+    o(this, "onContextRestored", (e) => {
       e.preventDefault(), this.dispose(), setTimeout(() => {
         this.setup(this.selector);
-      }, 20);
+      }, k);
     });
-    t(this, "initListener", () => {
-      this.initOpt.initListener == "True" && window && window.addEventListener("resize", () => this.onResize(), !1), this.renderer.domElement.addEventListener(
+    /**
+     * 初始化事件监听器
+     */
+    o(this, "initListener", () => {
+      this.initOpt.initListener && window && window.addEventListener("resize", this.onResize, !1), this.renderer.domElement.addEventListener(
         "webglcontextlost",
         this.onContextLost,
         !1
@@ -78,113 +123,284 @@ class l {
         !1
       );
     });
-    t(this, "removeListener", () => {
-      window && window.removeEventListener("resize", this.onResize, !1), this.renderer.domElement.removeEventListener(
+    /**
+     * 移除事件监听器
+     */
+    o(this, "removeListener", () => {
+      window && window.removeEventListener("resize", this.onResize, !1), this.renderer && this.renderer.domElement && (this.renderer.domElement.removeEventListener(
         "webglcontextlost",
-        this.onContextLost.bind(l),
+        this.onContextLost,
         !1
       ), this.renderer.domElement.removeEventListener(
         "webglcontextrestored",
-        this.onContextRestored.bind(l),
+        this.onContextRestored,
         !1
-      );
+      ));
     });
-    t(this, "animate", () => {
-      this.initOpt.renderType === "loop" && this.onRender(), requestAnimationFrame(this.animate);
+    /**
+     * 渲染循环（loop 模式）
+     */
+    o(this, "animate", () => {
+      this.isDispose || (this.initOpt.renderType === "loop" && this.onRender(), this.animationFrameId = requestAnimationFrame(this.animate));
     });
-    t(this, "onRender", () => {
+    /**
+     * 执行渲染
+     */
+    o(this, "onRender", () => {
       this.isDispose || (this.renderRequested = !1, this.stats && this.stats.update(), this.control && this.control.update(), this.renderer.render(this.scene, this.camera), this.css3dRenderer && this.css3dRenderer.render(this.scene, this.camera), this.eventsListener.onRender && this.eventsListener.onRender.length && this.eventsListener.onRender.forEach((e) => e()));
     });
-    t(this, "requestRenderIfNotRequested", () => {
+    /**
+     * 请求渲染（如果尚未请求）
+     */
+    o(this, "requestRenderIfNotRequested", () => {
       this.renderRequested || (this.renderRequested = !0, requestAnimationFrame(() => {
         this.onRender();
       }));
     });
-    t(this, "onResize", () => {
-      setTimeout(() => {
-        const e = Math.tan(Math.PI / 180 * this.camera.fov / 2), [s, i] = this.getTargetSize();
-        this.camera.aspect = s / i, this.camera.fov = 360 / Math.PI * Math.atan(e * (i / s)), this.camera.updateProjectionMatrix(), this.camera.lookAt(this.scene.position), this.renderer.setSize(s, i), this.css3dRenderer && this.css3dRenderer.setSize(s, i), this.onRender();
-      }, 0);
+    /**
+     * 处理窗口大小变化（带防抖）
+     */
+    o(this, "onResize", () => {
+      this.resizeTimer && clearTimeout(this.resizeTimer), this.resizeTimer = setTimeout(() => {
+        const [e, t] = this.getTargetSize();
+        this.updateCameraFOV(e, t), this.camera.lookAt(this.scene.position), this.renderer.setSize(e, t), this.css3dRenderer && this.css3dRenderer.setSize(e, t), this.onRender();
+      }, N);
     });
-    /**物体视窗自动适应
+    /**
+     * @deprecated 此方法已弃用，请使用 setView() 方法代替
+     *
+     * frameArea 仅为兼容旧版本保留，功能已被 setView() 完全覆盖
      *
-     * @param {Object3D} model
-     * @param {Number} scale
-     * @param {Vector3} offset
+     * 旧用法:
+     *   threeIns.frameArea(model, 1.0)
+     *
+     * 推荐用法:
+     *   threeIns.setView(model, ViewType.ISO, { scale: 1.0 })
+     *
+     * @param {Object3D} model - 要调整视角的 3D 模型对象
+     * @param {number} [scale=0.8] - 缩放比例，1=占满画布，0.5=50%，2.0=200%
+     * @returns {Object} 返回 setView 的结果
      */
-    t(this, "frameArea", (e, s, i) => {
-      const r = new S().setFromObject(e), d = r.getSize(new c()).length(), n = r.getCenter(new c());
-      i && n.add(i);
-      const p = d * s * 0.5, u = m.degToRad(this.camera.fov * 0.5), f = p / Math.tan(u), h = new c().subVectors(this.camera.position, n).multiply(new c(1, 1, 1)).normalize().multiplyScalar(f).add(n), o = {
-        x: h.x,
-        y: h.y,
-        z: h.z,
-        lookAt_x: n.x,
-        lookAt_y: n.y,
-        lookAt_z: n.z
+    o(this, "frameArea", (e, t) => (console.warn(
+      `[ThreeIns] frameArea() 已弃用，建议使用 setView() 方法。
+旧用法: threeIns.frameArea(model, scale)
+新用法: threeIns.setView(model, ViewType.ISO, { scale })`
+    ), this.setView(e, C.ISO, { scale: t, animate: !1, showBox: !1 })));
+    /**
+     * 切换到指定视角
+     * 根据视角类型自动调整相机位置和朝向，支持缩放比例控制
+     *
+     * @param {Object3D} model - 3D 物体对象
+     * @param {string} viewType - 视角类型，使用 ViewType 枚举
+     *                          - 'top': 俯视（从上往下看 Y 轴正方向）
+     *                          - 'right': 侧视（从右往左看 X 轴正方向）
+     *                          - 'left': 左侧视（从左往右看 X 轴负方向）
+     *                          - 'iso': 正斜视（等轴测视角，45°角）
+     * @param {Object} [options] - 可选配置
+     * @param {number} [options.scale=1] - 缩放比例，控制模型在画布中的占比
+     * @param {Vector3} [options.offset] - 偏移量，调整观察中心点
+     * @param {boolean} [options.showBox=false] - 是否显示包围盒辅助线
+     * @param {number} [options.boxColor=0xffff00] - 包围盒颜色
+     * @param {boolean} [options.animate=true] - 是否使用动画过渡
+     * @param {number} [options.duration=1000] - 动画持续时间（毫秒）
+     * @returns {Object} 返回相机位置和模型信息
+     * @returns {Vector3} return.position - 相机位置
+     * @returns {Vector3} return.target - 相机观察目标点
+     * @returns {number} return.distance - 相机到模型的距离
+     *
+     * @example
+     * // 导入 ViewType 枚举
+     * import { ThreeIns, ViewType } from 'threejs';
+     *
+     * // 切换到俯视，模型占满画布
+     * threeIns.setView(model, ViewType.TOP);
+     *
+     * // 切换到等轴测，模型占画布的 80%
+     * threeIns.setView(model, ViewType.ISO, { scale: 0.8 });
+     *
+     * // 切换到斜视，显示包围盒，无动画
+     * threeIns.setView(model, ViewType.ISO, {
+     *   showBox: true,
+     *   animate: false
+     * });
+     *
+     * // 切换到侧视，自定义观察点
+     * threeIns.setView(model, ViewType.RIGHT, {
+     *   offset: new THREE.Vector3(0, 10, 0),
+     *   scale: 0.8
+     * });
+     *
+     * // 或者使用类静态属性（向后兼容）
+     * threeIns.setView(model, ThreeIns.ViewType.TOP);
+     */
+    o(this, "setView", (e, t, l = {}) => {
+      let s = l.scale || 0.8, x = l.offset || null, R = l.showBox || !1, y = l.boxColor || 16776960, T = l.animate !== void 0 ? l.animate : !0, b = l.duration || 1e3;
+      const F = new Z().setFromObject(e);
+      let c = F.getCenter(new d());
+      x && c.add(x);
+      const z = {
+        top: new d(0, 1, 0),
+        // 从上往下：Y 轴正方向
+        right: new d(2, 1, 1).normalize(),
+        // 从右往左：X 轴正方向
+        left: new d(-2, 1, 1).normalize(),
+        // 从左往右：X 轴负方向
+        iso: new d(0, 1, 1).normalize()
+        // 等轴测：从对角线上方俯视
+      }, M = z[t] || z.iso, i = F.getSize(new d()), w = this.camera.aspect, n = g.degToRad(this.camera.fov * 0.5), S = g.degToRad(80), h = Math.min(Math.atan(Math.tan(n) * w), S);
+      let m;
+      if (t === "top") {
+        const r = i.x * 0.5 / (Math.tan(h) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+        m = Math.max(r, a);
+      } else if (t === "right" || t === "left") {
+        const r = i.y * 0.5 / (Math.tan(n) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+        m = Math.max(r, a);
+      } else {
+        const r = i.x * 0.5 / (Math.tan(h) * s), a = i.y * 0.5 / (Math.tan(n) * s), f = i.z * 0.5 / (Math.tan(n) * s);
+        m = Math.max(r, a, f);
+      }
+      const u = M.clone().multiplyScalar(m).add(c);
+      if (R && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", M), console.log("  - 距离:", m.toFixed(2)), console.log("  - 包围盒中心:", c), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", u), console.log("  - 实际相机与中心的距离:", u.clone().sub(c).length().toFixed(2))), R ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new _(F, y), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), T) {
+        const r = this.camera.position.clone(), a = this.control ? this.control.target.clone() : new d(0, 0, 0), f = c, D = Date.now(), L = () => {
+          const I = Date.now() - D, v = Math.min(I / b, 1), O = 1 - Math.pow(1 - v, 3);
+          if (this.camera.position.lerpVectors(r, u, O), this.control) {
+            const E = new d();
+            E.lerpVectors(a, f, O), this.control.target.copy(E), this.camera.lookAt(E);
+          } else
+            this.camera.lookAt(c);
+          this.camera.updateProjectionMatrix(), v < 1 ? requestAnimationFrame(L) : (this.camera.position.copy(u), this.camera.lookAt(c), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(c), this.control.update()), this.onRender());
+        };
+        L();
+      } else
+        this.camera.position.copy(u), this.camera.lookAt(c), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(c), this.control.update()), this.onRender();
+      if (R) {
+        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", t), console.log("  - 相机位置:", u), console.log("  - 观察目标:", c), console.log("  - 方向向量:", M), console.log("  - 包围盒尺寸:", i), console.log("  - 包围盒中心:", F.getCenter(new d())), console.log("  - 水平 FOV:", g.radToDeg(h * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", g.radToDeg(n * 2).toFixed(2) + "°"), console.log("  - 宽高比:", w.toFixed(4)), console.log("  - 模型宽度:", i.x.toFixed(2)), console.log("  - 模型高度:", i.y.toFixed(2)), console.log("  - 模型深度:", i.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), t === "top") {
+          const r = i.x * 0.5 / (Math.tan(h) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", i.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", i.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(h).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(n).toFixed(4)), console.log("  - X方向距离计算: (", (i.x * 0.5).toFixed(2), ") / (", Math.tan(h).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (i.z * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
+        } else if (t === "right" || t === "left") {
+          const r = i.y * 0.5 / (Math.tan(n) * s), a = i.z * 0.5 / (Math.tan(n) * s);
+          console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
+        } else {
+          const r = i.x * 0.5 / (Math.tan(h) * s), a = i.y * 0.5 / (Math.tan(n) * s), f = i.z * 0.5 / (Math.tan(n) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", i.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", i.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", i.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(h).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(n).toFixed(4)), console.log("  - X方向距离计算: (", (i.x * 0.5).toFixed(2), ") / (", Math.tan(h).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Y方向距离计算: (", (i.y * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - Z方向距离计算: (", (i.z * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", f.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", a.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", f.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(r, a, f).toFixed(2));
+        }
+        console.log("  - 最终距离:", m.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", T ? "是 (" + b + "ms)" : "否");
+      }
+      return {
+        position: u,
+        target: c,
+        distance: m,
+        viewType: t
       };
-      return this.camera.position.set(o.x, o.y, o.z), this.camera.lookAt(
-        o.lookAt_x,
-        o.lookAt_y,
-        o.lookAt_z
-      ), this.camera.updateProjectionMatrix(), this.control.target.copy(n), this.control.update(), d;
     });
-    t(this, "on", (e, s) => {
-      !e || !s || (this.eventsListener[e] || (this.eventsListener[e] = []), this.eventsListener[e].push(s));
-    });
-    this.isReady = !1, this.scene = new L({}), this.camera = new O(50, 1, 0.1, 2e3), this.renderer = new y({
+    /**
+     * 注册事件监听器
+     * @param {string} event - 事件名称
+     * @param {Function} callback - 回调函数
+     * @returns {Function} 返回取消监听的函数
+     */
+    o(this, "on", (e, t) => !e || !t || typeof t != "function" ? (console.warn("ThreeIns.on: 无效的参数"), () => {
+    }) : (this.eventsListener[e] || (this.eventsListener[e] = []), this.eventsListener[e].push(t), () => this.off(e, t)));
+    this.isReady = !1, this.scene = new X({}), this.camera = new Y(50, 1, 0.1, 2e3), this.renderer = new B({
       antialias: !0,
       alpha: !0,
       precision: "mediump",
       logarithmicDepthBuffer: !0
-    }), this.version = z, s && (this.initOpt = Object.assign(this.initOpt, s)), e && this.setup(e);
+    }), this.version = G, this.onContextLost = this.onContextLost.bind(this), this.onContextRestored = this.onContextRestored.bind(this), this.onResize = this.onResize.bind(this), this.animate = this.animate.bind(this), this.resizeTimer = null, this.animationFrameId = null, t && (this.initOpt = Object.assign(this.initOpt, t)), e && this.setup(e);
+  }
+  /**
+   * 更新相机 FOV 以适应容器尺寸
+   * @private
+   * @param {number} domW - 容器宽度
+   * @param {number} domH - 容器高度
+   */
+  updateCameraFOV(e, t) {
+    const l = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * l / 2);
+    this.camera.aspect = e / t, this.camera.fov = 360 / Math.PI * Math.atan(s * (t / e)), this.camera.updateProjectionMatrix();
   }
+  /**
+   * 初始化性能统计
+   */
   initStats() {
-    const e = new Stats();
-    e.dom.style.cssText = "position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000", this.el.appendChild(e.dom);
+    this.stats = new j(), this.stats.dom.style.cssText = "position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000", this.el.appendChild(this.stats.dom);
   }
+  /**
+   * 初始化 CSS3D 渲染器
+   */
   initCss3dRenderer() {
-    this.css3dRenderer = new v();
-    const [e, s] = this.getTargetSize();
-    this.css3dRenderer.setSize(e, s), this.css3dRenderer.domElement.style.position = "absolute", this.css3dRenderer.domElement.style.pointerEvents = "none", this.css3dRenderer.domElement.style.top = 0, this.css3dRenderer.domElement.style.left = 0, this.el.appendChild(this.css3dRenderer.domElement);
+    this.css3dRenderer = new V();
+    const [e, t] = this.getTargetSize();
+    this.css3dRenderer.setSize(e, t), this.css3dRenderer.domElement.style.position = "absolute", this.css3dRenderer.domElement.style.pointerEvents = "none", this.css3dRenderer.domElement.style.top = 0, this.css3dRenderer.domElement.style.left = 0, this.el.appendChild(this.css3dRenderer.domElement);
   }
+  /**
+   * 获取目标容器尺寸
+   * 使用智能缓存策略：全屏时使用窗口尺寸，非全屏时使用元素尺寸
+   * @returns {[number, number]} [width, height]
+   */
   getTargetSize() {
-    const e = document.querySelector(this.selector);
-    return e ? [e.clientWidth, e.clientHeight] : [0, 0];
+    return document.fullscreenElement || document.webkitFullscreenElement || document.mozFullScreenElement || document.msFullscreenElement ? [window.innerWidth, window.innerHeight] : this.el ? !document.body.contains(this.el) && (console.warn(`ThreeIns: 缓存的元素已失效，重新查询 ${this.selector}`), this.el = document.querySelector(this.selector), !this.el) ? [0, 0] : [this.el.clientWidth, this.el.clientHeight] : [0, 0];
   }
-  off(e) {
-    e || (this.eventsListener = {}), this.eventsListener[e] && (this.eventsListener[e] = []);
+  /**
+   * 移除事件监听器
+   * @param {string} event - 事件名称
+   * @param {Function} [callback] - 可选的回调函数，如果不提供则移除该事件的所有监听器
+   */
+  off(e, t) {
+    if (!e) {
+      this.eventsListener = {};
+      return;
+    }
+    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((l) => l !== t) : this.eventsListener[e] = []);
   }
+  /**
+   * 清理所有资源
+   */
   dispose() {
-    this.isDispose = !0, this.removeListener(), b(this.scene), this.renderer.dispose(), this.renderer.domElement.remove(), this.el = null, this.renderer = null, this.camera = null, this.scene = null, this.control = null, this.css3dRenderer = null;
+    this.isDispose || (this.isDispose = !0, this.animationFrameId && (cancelAnimationFrame(this.animationFrameId), this.animationFrameId = null), this.resizeTimer && (clearTimeout(this.resizeTimer), this.resizeTimer = null), this.removeListener(), this.eventsListener = {}, this.stats && this.stats.dom && (this.stats.dom.remove(), this.stats = null), this.css3dRenderer && (this.css3dRenderer.domElement.remove(), this.css3dRenderer = null), this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.scene && (q(this.scene), this.scene = null), this.renderer && (this.renderer.dispose(), this.renderer.domElement && this.renderer.domElement.remove(), this.renderer = null), this.control && (this.control.dispose(), this.control = null), this.camera = null, this.el = null, this.selector = null, console.log("ThreeIns: 资源已清理完成"));
   }
 }
+// 存储包围盒辅助器
+// 视角类型枚举（作为类静态属性引用，保持向后兼容）
+o($, "ViewType", C);
 export {
-  M as IDBCache,
-  V as ImageLoader,
-  l as ThreeIns,
-  _ as createArrowHelper,
-  G as createAxesHelper,
-  N as createBox3Helper,
-  J as createCameraHelper,
-  U as createGridHelper,
-  $ as createInfoPlane,
-  Y as createMapControls,
-  x as createOrbitControl,
-  K as createRaycaster,
-  Q as createStats,
-  ee as createTagPlane,
-  te as dataToObject3D,
-  se as dataToObject3DSync,
-  b as disposeThreeObject,
-  ie as getCommonParent,
-  X as initEnvImage,
-  q as intersectColor,
-  F as obbObjects,
-  ne as object3DToData,
-  re as object3DToDataSync,
-  I as useGLTFLoader,
-  k as useObb,
-  H as useRaycaster,
-  W as useThreeJs
+  ce as CacheMonitor,
+  he as ErrorType,
+  de as IDBCache,
+  Ie as ImageLoader,
+  me as ModelLoadError,
+  qe as ModelOptimizer,
+  ue as PredictiveLoader,
+  fe as ProgressiveSceneBuilder,
+  pe as RetryHelper,
+  $ as ThreeIns,
+  C as ViewType,
+  xe as cacheMonitor,
+  ge as createArrowHelper,
+  Fe as createAxesHelper,
+  Re as createBox3Helper,
+  Me as createCameraHelper,
+  Ee as createGridHelper,
+  He as createInfoPlane,
+  Te as createMapControls,
+  P as createOrbitControl,
+  be as createRaycaster,
+  ze as createStats,
+  Ae as createTagPlane,
+  we as dataToObject3D,
+  Le as dataToObject3DSync,
+  q as disposeThreeObject,
+  Pe as getCommonParent,
+  je as initEnvImage,
+  se as intersectColor,
+  Xe as modelOptimizer,
+  oe as obbObjects,
+  ve as object3DToData,
+  Oe as object3DToDataSync,
+  Ce as predictiveLoader,
+  ye as rebuildScene,
+  ie as useBatchGLTFLoader,
+  Se as useGLTFLoader,
+  ne as useObb,
+  re as useRaycaster,
+  ae as useThreeJs
 };