@ridp/threejs 1.4.2 → 1.4.3

package/{readme.md → README.md}

@@ -352,9 +352,13 @@ threeJsIns.setView(model, ViewType.ISO, { scale: 1.0, animate: true });
 
 ### useGLTFLoader()
 
-GLTF 模型加载器,支持 IndexedDB 缓存。
+GLTF 模型加载器,支持 IndexedDB 缓存、内存缓存、重试机制和调试模式。
 
 ```javascript
+const loader = useGLTFLoader({
+  debug: false  // 是否开启调试日志(默认: false)
+});
+
 const {
   // 核心加载方法
   load,              // 基础加载方法
@@ -366,30 +370,61 @@ const {
   loadBatch,         // 批量加载模型
   loadBatchSequential, // 顺序批量加载
 
-  // 缓存管理
-  clearCache,        // 清空缓存
+  // IndexedDB 缓存管理
+  clearCache,        // 清空 IndexedDB 缓存
   invalidateCache,   // 使缓存失效
   getCacheStats,     // 获取缓存统计
   logCacheReport,    // 输出缓存性能报告
+  getCache,          // 获取 IDBCache 实例
+  resetCacheStats,   // 重置缓存统计
+
+  // 内存缓存管理 (v1.4.2+)
+  clearMemoryCache,      // 清空内存缓存
+  getMemoryCacheInfo,    // 获取内存缓存统计
+  deleteMemoryCache,     // 删除指定模型的内存缓存
 
   // 性能监控
   cacheMonitor       // 缓存监控器实例
-} = useGLTFLoader();
+} = loader;
+```
+
+**新增功能 (v1.4.2):**
+
+1. **内存缓存机制**: 自动缓存已解析的 3D 模型对象，避免重复解析
+2. **调试模式控制**: 通过初始化参数统一控制所有日志输出
+
+#### 初始化配置
+
+```javascript
+// 生产环境 - 默认静默
+const loader = useGLTFLoader();
+
+// 开发环境 - 开启调试日志
+const loader = useGLTFLoader({
+  debug: true
+});
+
+// 所有操作都会输出详细日志
+const model = await loader.asyncFetch('/models/car.glb', '1.0.0');
+// 输出: [ asyncFetch ] ====> 缓存未命中
+//       [ fetchArrayBuffer ] 加载模型耗时: 150ms
+//       [ 解析模型耗时 ]: 80ms
+//       [ 内存缓存 ] 存储模型 /models/car.glb (version: 1.0.0)
 ```
 
 **常用方法:**
 
 ##### asyncFetch()
 
-推荐的模型加载方法,集成缓存、重试、性能监控和模型优化。
+推荐的模型加载方法,集成 IndexedDB 缓存、内存缓存、重试机制、性能监控和模型优化。
 
 ```javascript
-const [err, model] = await asyncFetch(
+const model = await asyncFetch(
   url: string,        // 模型 URL
   version?: string,   // 模型版本(用于缓存失效)
+  onProgress?: (percent: number) => void,  // 进度回调
   options?: {
-    // 进度和重试
-    onProgress?: (progress: ProgressEvent) => void,
+    // 重试配置
     maxRetries?: number,      // 最大重试次数(默认: 3)
 
     // 模型优化选项
@@ -399,35 +434,40 @@ const [err, model] = await asyncFetch(
     simplifyOptions?: {
       minFaceCount?: number,      // 最小面数阈值,低于此值不简化(默认: 100)
       preserveUVs?: boolean      // 是否保留UV坐标(默认: true)
-    }
+    },
+
+    // 缓存控制
+    useMemoryCache?: boolean  // 是否使用内存缓存(默认: true, v1.4.2+)
   }
-): Promise<[Error | null, THREE.Object3D | null]>
+): Promise<THREE.Object3D | null>
 ```
 
+**缓存层级 (v1.4.2+):**
+
+1. **内存缓存** (最快) - 已解析的 3D 对象，仅需克隆（~2ms）
+2. **IndexedDB 缓存** (快) - ArrayBuffer 数据，需要解析（~200ms）
+3. **网络加载** (慢) - 完整下载 + 解析（~2s）
+
 **示例:**
 ```javascript
 // 基础用法
-const [err, model] = await asyncFetch('/models/car.glb', '1.0.0');
+const model = await asyncFetch('/models/car.glb', '1.0.0');
 if (model) {
   scene.add(model);
 }
 
 // 带进度回调
-const [err, model] = await asyncFetch('/models/car.glb', '1.0.0', {
-  onProgress: (progress) => {
-    const percent = (progress.loaded / progress.total * 100).toFixed(2);
-    console.log(`加载进度: ${percent}%`);
-  },
-  maxRetries: 5
+const model = await asyncFetch('/models/car.glb', '1.0.0', (percent) => {
+  console.log(`加载进度: ${percent}%`);
 });
 
 // 启用材质优化
-const [err, model] = await asyncFetch('/models/car.glb', '1.0.0', {
+const model = await asyncFetch('/models/car.glb', '1.0.0', null, {
   optimizeMaterials: true  // 自动合并相同材质
 });
 
 // 启用几何体简化(适合大型模型)
-const [err, model] = await asyncFetch('/models/large-scene.glb', '1.0.0', {
+const model = await asyncFetch('/models/large-scene.glb', '1.0.0', null, {
   simplifyGeometry: true,      // 启用简化
   simplifyRatio: 0.5,          // 保留 50% 的面
   simplifyOptions: {
@@ -436,18 +476,43 @@ const [err, model] = await asyncFetch('/models/large-scene.glb', '1.0.0', {
   }
 });
 
+// 禁用内存缓存
+const model = await asyncFetch('/models/car.glb', '1.0.0', null, {
+  useMemoryCache: false  // 跳过内存缓存
+});
+
 // 综合优化
-const [err, model] = await asyncFetch('/models/complex.glb', '1.0.0', {
-  optimizeMaterials: true,     // 优化材质
-  simplifyGeometry: true,      // 简化几何体
-  simplifyRatio: 0.7,          // 保留 70% 的面
-  onProgress: (p) => console.log(`加载: ${(p.loaded/p.total*100).toFixed(1)}%`)
+const model = await asyncFetch('/models/complex.glb', '1.0.0', (p) => {
+  console.log(`加载: ${p.toFixed(1)}%`);
+}, {
+  maxRetries: 5,             // 增加重试次数
+  optimizeMaterials: true,   // 优化材质
+  simplifyGeometry: true,    // 简化几何体
+  simplifyRatio: 0.7,        // 保留 70% 的面
+  useMemoryCache: true       // 使用内存缓存(默认)
 });
 ```
 
+**性能对比:**
+
+```javascript
+// 首次加载
+await asyncFetch('/models/car.glb', '1.0.0');
+// 耗时: ~2s (网络 + 解析 + 优化)
+
+// 二次加载 (内存缓存命中)
+await asyncFetch('/models/car.glb', '1.0.0');
+// 耗时: ~2ms (仅克隆对象)
+
+// 二次加载 (仅 IndexedDB 命中,内存缓存被清空)
+loader.clearMemoryCache();
+await asyncFetch('/models/car.glb', '1.0.0');
+// 耗时: ~200ms (从 IndexedDB 读取 + 解析)
+```
+
 ##### logCacheReport()
 
-输出缓存性能报告到控制台。
+输出 IndexedDB 缓存性能报告到控制台。
 
 ```javascript
 logCacheReport(): void
@@ -465,6 +530,89 @@ logCacheReport(): void
   - 缓存节省时间: ~1.5s
 ```
 
+##### 内存缓存管理 API (v1.4.2+)
+
+**getMemoryCacheInfo()**
+
+获取内存缓存统计信息。
+
+```javascript
+const info = loader.getMemoryCacheInfo();
+
+// 返回值:
+{
+  totalPaths: 2,      // 缓存的不同模型路径数量
+  totalModels: 3,     // 缓存的总模型数量
+  details: [
+    {
+      path: '/models/car.glb',
+      versions: ['1.0.0', '1.1.0'],
+      count: 2
+    },
+    {
+      path: '/models/truck.glb',
+      versions: ['1.0.0'],
+      count: 1
+    }
+  ]
+}
+```
+
+**clearMemoryCache()**
+
+清空所有内存缓存，释放已缓存的 3D 模型对象内存。
+
+```javascript
+const count = loader.clearMemoryCache();
+console.log(`释放了 ${count} 个模型`);
+
+// 使用场景: 内存不足时主动释放
+if (info.totalModels > 100) {
+  loader.clearMemoryCache();
+}
+```
+
+**deleteMemoryCache(path, version?)**
+
+删除指定模型的内存缓存。
+
+```javascript
+// 删除特定版本
+loader.deleteMemoryCache('/models/car.glb', '1.0.0');
+
+// 删除所有版本
+loader.deleteMemoryCache('/models/car.glb');
+```
+
+**使用示例:**
+
+```javascript
+import { useGLTFLoader } from '@ridp/threejs/hooks';
+
+const loader = useGLTFLoader({ debug: true });
+
+// 首次加载 - 从网络加载并缓存
+const model1 = await loader.asyncFetch('/models/car.glb', '1.0.0');
+// [ asyncFetch ] ====> 缓存未命中
+// [ 内存缓存 ] 存储模型 /models/car.glb (version: 1.0.0)
+
+// 二次加载 - 从内存缓存获取（极快）
+const model2 = await loader.asyncFetch('/models/car.glb', '1.0.0');
+// [ 内存缓存命中 ] /models/car.glb (version: 1.0.0)
+// [ 内存缓存克隆耗时 ]: 2ms
+
+// 查看内存缓存信息
+const info = loader.getMemoryCacheInfo();
+console.log(`缓存了 ${info.totalModels} 个模型`);
+
+// 清空内存缓存
+loader.clearMemoryCache();
+
+// 再次加载 - 从 IndexedDB 缓存获取
+const model3 = await loader.asyncFetch('/models/car.glb', '1.0.0');
+// [ asyncFetch ] ====> IndexedDB 缓存命中
+```
+
 ### useRaycaster()
 
 射线拾取工具,用于鼠标交互和物体选择。
@@ -1152,7 +1300,61 @@ function captureScreenshot() {
 
 ## 更新日志
 
-### v1.3.3 (2025-01-06)
+### v1.4.2 (2026-01-07)
+
+**🎉 重大更新:**
+
+- ✨ **新增内存缓存机制**: 自动缓存已解析的 3D 模型对象，避免重复解析
+  - 首次加载后，二次加载仅需 ~2ms（对象克隆）
+  - 相比完整加载流程，速度提升可达 **100倍以上**
+  - 新增 `clearMemoryCache()` - 清空内存缓存
+  - 新增 `getMemoryCacheInfo()` - 获取内存缓存统计
+  - 新增 `deleteMemoryCache(path, version?)` - 删除指定缓存
+  - 支持 `useMemoryCache` 选项控制是否使用内存缓存
+
+- ✨ **新增调试模式控制**:
+  - `useGLTFLoader` 现在支持初始化配置 `{ debug: boolean }`
+  - 统一控制所有内部函数的日志输出
+  - 生产环境默认静默，开发环境可开启详细日志
+  - 错误日志始终输出，不受 debug 配置影响
+
+- 🐛 **修复 Web Worker 在 npm 包中无法加载的问题**:
+  - 使用 `?worker` 语法正确导入 Worker
+  - 配置 `base: './'` 使用相对路径解析
+  - Worker 文件正确打包到 `dist/assets/` 目录
+  - 修复了之前 404 错误和 MIME 类型错误的问题
+
+**API 变更:**
+
+```javascript
+// 旧 API (v1.4.1 及之前)
+const loader = useGLTFLoader();
+const model = await loader.asyncFetch(url, version, null, { debug: true });
+
+// 新 API (v1.4.2+)
+const loader = useGLTFLoader({ debug: true });
+const model = await loader.asyncFetch(url, version);
+
+// 新增内存缓存管理
+const info = loader.getMemoryCacheInfo();
+loader.clearMemoryCache();
+loader.deleteMemoryCache(url, version);
+```
+
+**性能提升:**
+
+```
+加载场景 (v1.4.1):
+- 首次: ~2s (网络 + 解析)
+- 二次: ~200ms (IndexedDB 读取 + 解析)
+
+加载场景 (v1.4.2+):
+- 首次: ~2s (网络 + 解析)
+- 二次: ~2ms (内存缓存克隆)
+- 提升: 100倍
+```
+
+### v1.4.1 (2025-XX-XX)
 
 - 🎯 优化 `setView` 方法的 scale 参数计算逻辑
 - 🔧 修复水平 FOV 超过 180° 导致的负数距离问题

package/dist/packages/threejs/package.json.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="1.4.2";exports.version=e;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="1.4.3";exports.version=e;

package/dist/packages/threejs/package.json.js

@@ -1,4 +1,4 @@
-const o = "1.4.2";
+const o = "1.4.3";
 export {
   o as version
 };

package/dist/packages/threejs/src/instance/threeIns.cjs

@@ -1,3 +1,3 @@
-"use strict";var I=Object.defineProperty;var q=(x,e,t)=>e in x?I(x,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):x[e]=t;var i=(x,e,t)=>q(x,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("three"),A=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.cjs"),H=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.cjs"),P=require("../utils/helper.cjs"),X=require("../utils/disposeObject.cjs");require("../utils/PredictiveLoader.cjs");const Y=require("../../package.json.cjs"),j=50,Z=20,_=20,E={TOP:"top",RIGHT:"right",LEFT:"left",ISO:"iso"},B={enableDamping:!0,dampingFactor:.25,screenSpacePanning:!1,minDistance:.1,maxDistance:1e3,maxPolarAngle:n.MathUtils.degToRad(60)};class C{constructor(e,t){i(this,"isReady",!1);i(this,"scene",null);i(this,"camera",null);i(this,"renderer",null);i(this,"control",null);i(this,"css3dRenderer",null);i(this,"el",null);i(this,"renderRequested",!1);i(this,"selector",null);i(this,"eventsListener",{});i(this,"stats",null);i(this,"isDispose",!1);i(this,"version","0.0.0");i(this,"boxHelper",null);i(this,"initOpt",{css3d:!1,stats:!1,renderType:"change",initListener:!0,initialFov:50,control:{init:!0,options:{}}});i(this,"setup",e=>{if(this.isDispose=!1,this.selector=e,this.el=document.querySelector(e),!this.el){console.error(`ThreeIns: 找不到元素 ${e}`);return}const[t,h]=this.getTargetSize();if(this.updateCameraFOV(t,h),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,h),this.el.appendChild(this.renderer.domElement),this.initOpt.control&&this.initOpt.control.init){this.control=P.createOrbitControl(this.camera,this.renderer.domElement);const s=Object.assign(B,this.initOpt.control.options||{});Object.keys(s).forEach(p=>{this.control[p]=s[p]})}setTimeout(()=>{this.isReady=!0},Z),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()});i(this,"onContextLost",e=>{e.preventDefault(),this.animationFrameId&&cancelAnimationFrame(this.animationFrameId)});i(this,"onContextRestored",e=>{e.preventDefault(),this.dispose(),setTimeout(()=>{this.setup(this.selector)},_)});i(this,"initListener",()=>{this.initOpt.initListener&&window&&window.addEventListener("resize",this.onResize,!1),this.renderer.domElement.addEventListener("webglcontextlost",this.onContextLost,!1),this.renderer.domElement.addEventListener("webglcontextrestored",this.onContextRestored,!1)});i(this,"removeListener",()=>{window&&window.removeEventListener("resize",this.onResize,!1),this.renderer&&this.renderer.domElement&&(this.renderer.domElement.removeEventListener("webglcontextlost",this.onContextLost,!1),this.renderer.domElement.removeEventListener("webglcontextrestored",this.onContextRestored,!1))});i(this,"animate",()=>{this.isDispose||(this.initOpt.renderType==="loop"&&this.onRender(),this.animationFrameId=requestAnimationFrame(this.animate))});i(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()))});i(this,"requestRenderIfNotRequested",()=>{this.renderRequested||(this.renderRequested=!0,requestAnimationFrame(()=>{this.onRender()}))});i(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()},j)});i(this,"frameArea",(e,t)=>(console.warn(`[ThreeIns] frameArea() 已弃用，建议使用 setView() 方法。
+"use strict";var q=Object.defineProperty;var A=(x,e,t)=>e in x?q(x,e,{enumerable:!0,configurable:!0,writable:!0,value:t}):x[e]=t;var i=(x,e,t)=>A(x,typeof e!="symbol"?e+"":e,t);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("three"),H=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.cjs"),P=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.cjs"),X=require("../utils/helper.cjs"),Y=require("../utils/disposeObject.cjs");require("../utils/PredictiveLoader.cjs");const j=require("../../package.json.cjs"),Z=50,_=20,B=20,M={TOP:"top",RIGHT:"right",LEFT:"left",ISO:"iso"},U={enableDamping:!0,dampingFactor:.25,screenSpacePanning:!1,minDistance:.1,maxDistance:1e3,maxPolarAngle:r.MathUtils.degToRad(60)};class y{constructor(e,t){i(this,"isReady",!1);i(this,"scene",null);i(this,"camera",null);i(this,"renderer",null);i(this,"control",null);i(this,"css3dRenderer",null);i(this,"el",null);i(this,"renderRequested",!1);i(this,"selector",null);i(this,"eventsListener",{});i(this,"stats",null);i(this,"isDispose",!1);i(this,"version","0.0.0");i(this,"boxHelper",null);i(this,"initOpt",{css3d:!1,stats:!1,renderType:"change",initListener:!0,initialFov:50,control:{init:!0,options:{}}});i(this,"setup",e=>{if(this.isDispose=!1,this.selector=e,this.el=document.querySelector(e),!this.el){console.error(`ThreeIns: 找不到元素 ${e}`);return}const[t,h]=this.getTargetSize();if(this.updateCameraFOV(t,h),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,h),this.el.appendChild(this.renderer.domElement),this.initOpt.control&&this.initOpt.control.init){this.control=X.createOrbitControl(this.camera,this.renderer.domElement);const s=Object.assign(U,this.initOpt.control.options||{});Object.keys(s).forEach(p=>{this.control[p]=s[p]})}setTimeout(()=>{this.isReady=!0},_),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()});i(this,"onContextLost",e=>{e.preventDefault(),this.animationFrameId&&cancelAnimationFrame(this.animationFrameId)});i(this,"onContextRestored",e=>{e.preventDefault(),this.dispose(),setTimeout(()=>{this.setup(this.selector)},B)});i(this,"initListener",()=>{this.initOpt.initListener&&window&&window.addEventListener("resize",this.onResize,!1),this.renderer.domElement.addEventListener("webglcontextlost",this.onContextLost,!1),this.renderer.domElement.addEventListener("webglcontextrestored",this.onContextRestored,!1)});i(this,"removeListener",()=>{window&&window.removeEventListener("resize",this.onResize,!1),this.renderer&&this.renderer.domElement&&(this.renderer.domElement.removeEventListener("webglcontextlost",this.onContextLost,!1),this.renderer.domElement.removeEventListener("webglcontextrestored",this.onContextRestored,!1))});i(this,"animate",()=>{this.isDispose||(this.initOpt.renderType==="loop"&&this.onRender(),this.animationFrameId=requestAnimationFrame(this.animate))});i(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()))});i(this,"requestRenderIfNotRequested",()=>{this.renderRequested||(this.renderRequested=!0,requestAnimationFrame(()=>{this.onRender()}))});i(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()},Z)});i(this,"frameArea",(e,t)=>(console.warn(`[ThreeIns] frameArea() 已弃用，建议使用 setView() 方法。
 旧用法: threeIns.frameArea(model, scale)
-新用法: threeIns.setView(model, ViewType.ISO, { scale })`),this.setView(e,E.ISO,{scale:t,animate:!1,showBox:!1})));i(this,"setView",(e,t,h={})=>{let s=h.scale||.8,p=h.offset||null,F=h.showBox||!1,y=h.boxColor||16776960,w=h.animate!==void 0?h.animate:!0,z=h.duration||1e3;const g=new n.Box3().setFromObject(e);let c=g.getCenter(new n.Vector3);p&&c.add(p);const T={top:new n.Vector3(0,1,0),right:new n.Vector3(2,1,1).normalize(),left:new n.Vector3(-2,1,1).normalize(),iso:new n.Vector3(0,1,1).normalize()},R=T[t]||T.iso,o=g.getSize(new n.Vector3),b=this.camera.aspect,r=n.MathUtils.degToRad(this.camera.fov*.5),S=n.MathUtils.degToRad(80),d=Math.min(Math.atan(Math.tan(r)*b),S);let m;if(t==="top"){const a=o.x*.5/(Math.tan(d)*s),l=o.z*.5/(Math.tan(r)*s);m=Math.max(a,l)}else if(t==="right"||t==="left"){const a=o.y*.5/(Math.tan(r)*s),l=o.z*.5/(Math.tan(r)*s);m=Math.max(a,l)}else{const a=o.x*.5/(Math.tan(d)*s),l=o.y*.5/(Math.tan(r)*s),f=o.z*.5/(Math.tan(r)*s);m=Math.max(a,l,f)}const u=R.clone().multiplyScalar(m).add(c);if(F&&(console.log("📍 相机位置验证:"),console.log("  - 方向向量:",R),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))),F?(this.boxHelper&&(this.scene.remove(this.boxHelper),this.boxHelper=null),this.boxHelper=new n.Box3Helper(g,y),this.scene.add(this.boxHelper)):this.boxHelper&&(this.scene.remove(this.boxHelper),this.boxHelper=null),w){const a=this.camera.position.clone(),l=this.control?this.control.target.clone():new n.Vector3(0,0,0),f=c,V=Date.now(),v=()=>{const D=Date.now()-V,L=Math.min(D/z,1),O=1-Math.pow(1-L,3);if(this.camera.position.lerpVectors(a,u,O),this.control){const M=new n.Vector3;M.lerpVectors(l,f,O),this.control.target.copy(M),this.camera.lookAt(M)}else this.camera.lookAt(c);this.camera.updateProjectionMatrix(),L<1?requestAnimationFrame(v):(this.camera.position.copy(u),this.camera.lookAt(c),this.camera.updateProjectionMatrix(),this.control&&(this.control.target.copy(c),this.control.update()),this.onRender())};v()}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(F){if(console.log("🎥 视角切换信息:"),console.log("  - 视角类型:",t),console.log("  - 相机位置:",u),console.log("  - 观察目标:",c),console.log("  - 方向向量:",R),console.log("  - 包围盒尺寸:",o),console.log("  - 包围盒中心:",g.getCenter(new n.Vector3)),console.log("  - 水平 FOV:",n.MathUtils.radToDeg(d*2).toFixed(2)+"°"),console.log("  - 垂直 FOV:",n.MathUtils.radToDeg(r*2).toFixed(2)+"°"),console.log("  - 宽高比:",b.toFixed(4)),console.log("  - 模型宽度:",o.x.toFixed(2)),console.log("  - 模型高度:",o.y.toFixed(2)),console.log("  - 模型深度:",o.z.toFixed(2)),console.log("  - 传入的 scale 参数:",s),t==="top"){const a=o.x*.5/(Math.tan(d)*s),l=o.z*.5/(Math.tan(r)*s);console.log("  - 模型 X 尺寸 (宽度):",o.x.toFixed(2)),console.log("  - 模型 Z 尺寸 (深度):",o.z.toFixed(2)),console.log("  - tan(halfFovX):",Math.tan(d).toFixed(4)),console.log("  - tan(halfFovY):",Math.tan(r).toFixed(4)),console.log("  - X方向距离计算: (",(o.x*.5).toFixed(2),") / (",Math.tan(d).toFixed(4)," *",s,") =",a.toFixed(2)),console.log("  - Z方向距离计算: (",(o.z*.5).toFixed(2),") / (",Math.tan(r).toFixed(4)," *",s,") =",l.toFixed(2)),console.log("  - X方向距离 (scale="+s+"):",a.toFixed(2)),console.log("  - Z方向距离 (scale="+s+"):",l.toFixed(2))}else if(t==="right"||t==="left"){const a=o.y*.5/(Math.tan(r)*s),l=o.z*.5/(Math.tan(r)*s);console.log("  - Y方向距离 (scale="+s+"):",a.toFixed(2)),console.log("  - Z方向距离 (scale="+s+"):",l.toFixed(2))}else{const a=o.x*.5/(Math.tan(d)*s),l=o.y*.5/(Math.tan(r)*s),f=o.z*.5/(Math.tan(r)*s);console.log("  - 模型 X 尺寸 (宽度):",o.x.toFixed(2)),console.log("  - 模型 Y 尺寸 (高度):",o.y.toFixed(2)),console.log("  - 模型 Z 尺寸 (深度):",o.z.toFixed(2)),console.log("  - tan(halfFovX):",Math.tan(d).toFixed(4)),console.log("  - tan(halfFovY):",Math.tan(r).toFixed(4)),console.log("  - X方向距离计算: (",(o.x*.5).toFixed(2),") / (",Math.tan(d).toFixed(4)," *",s,") =",a.toFixed(2)),console.log("  - Y方向距离计算: (",(o.y*.5).toFixed(2),") / (",Math.tan(r).toFixed(4)," *",s,") =",l.toFixed(2)),console.log("  - Z方向距离计算: (",(o.z*.5).toFixed(2),") / (",Math.tan(r).toFixed(4)," *",s,") =",f.toFixed(2)),console.log("  - X方向距离 (scale="+s+"):",a.toFixed(2)),console.log("  - Y方向距离 (scale="+s+"):",l.toFixed(2)),console.log("  - Z方向距离 (scale="+s+"):",f.toFixed(2)),console.log("  - 最大距离 (Max):",Math.max(a,l,f).toFixed(2))}console.log("  - 最终距离:",m.toFixed(2)),console.log("  - 缩放比例:",s),console.log("  - 动画:",w?"是 ("+z+"ms)":"否")}return{position:u,target:c,distance:m,viewType:t}});i(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 n.Scene({}),this.camera=new n.PerspectiveCamera(50,1,.1,2e3),this.renderer=new n.WebGLRenderer({antialias:!0,alpha:!0,precision:"mediump",logarithmicDepthBuffer:!0}),this.version=Y.version,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)}updateCameraFOV(e,t){const h=this.initOpt.initialFov||50,s=Math.tan(Math.PI/180*h/2);this.camera.aspect=e/t,this.camera.fov=360/Math.PI*Math.atan(s*(t/e)),this.camera.updateProjectionMatrix()}initStats(){this.stats=new H,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)}initCss3dRenderer(){this.css3dRenderer=new A.CSS3DRenderer;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)}getTargetSize(){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,t){if(!e){this.eventsListener={};return}this.eventsListener[e]&&(t?this.eventsListener[e]=this.eventsListener[e].filter(h=>h!==t):this.eventsListener[e]=[])}dispose(){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&&(X.disposeThreeObject(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: 资源已清理完成"))}}i(C,"ViewType",E);exports.ThreeIns=C;exports.ViewType=E;
+新用法: threeIns.setView(model, ViewType.ISO, { scale })`),this.setView(e,M.ISO,{scale:t,animate:!1,showBox:!1})));i(this,"setView",(e,t,h={})=>{let s=h.scale||.8,p=h.offset||null,F=h.position||"center",R=h.showBox||!1,C=h.boxColor||16776960,E=h.animate!==void 0?h.animate:!0,b=h.duration||1e3;const g=new r.Box3().setFromObject(e);let c=g.getCenter(new r.Vector3);if(typeof F=="string"){const o=g.getSize(new r.Vector3),l={center:new r.Vector3(0,0,0),"top-left":new r.Vector3(-o.x*.3,o.y*.3,o.z*.3),"top-right":new r.Vector3(o.x*.3,o.y*.3,o.z*.3),"bottom-left":new r.Vector3(-o.x*.3,-o.y*.3,o.z*.3),"bottom-right":new r.Vector3(o.x*.3,-o.y*.3,o.z*.3)},d=l[F]||l.center;t==="top"?c.add(new r.Vector3(d.x,0,d.z)):t==="right"||t==="left"?c.add(new r.Vector3(0,d.y,d.z)):c.add(d)}else F instanceof r.Vector3&&c.add(F);p&&c.add(p);const T={top:new r.Vector3(0,1,0),right:new r.Vector3(2,1,1).normalize(),left:new r.Vector3(-2,1,1).normalize(),iso:new r.Vector3(0,1,1).normalize()},z=T[t]||T.iso,n=g.getSize(new r.Vector3),O=this.camera.aspect,a=r.MathUtils.degToRad(this.camera.fov*.5),S=r.MathUtils.degToRad(80),m=Math.min(Math.atan(Math.tan(a)*O),S);let f;if(t==="top"){const o=n.x*.5/(Math.tan(m)*s),l=n.z*.5/(Math.tan(a)*s);f=Math.max(o,l)}else if(t==="right"||t==="left"){const o=n.y*.5/(Math.tan(a)*s),l=n.z*.5/(Math.tan(a)*s);f=Math.max(o,l)}else{const o=n.x*.5/(Math.tan(m)*s),l=n.y*.5/(Math.tan(a)*s),d=n.z*.5/(Math.tan(a)*s);f=Math.max(o,l,d)}const u=z.clone().multiplyScalar(f).add(c);if(R&&(console.log("📍 相机位置验证:"),console.log("  - 方向向量:",z),console.log("  - 距离:",f.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 r.Box3Helper(g,C),this.scene.add(this.boxHelper)):this.boxHelper&&(this.scene.remove(this.boxHelper),this.boxHelper=null),E){const o=this.camera.position.clone(),l=this.control?this.control.target.clone():new r.Vector3(0,0,0),d=c,D=Date.now(),L=()=>{const I=Date.now()-D,V=Math.min(I/b,1),v=1-Math.pow(1-V,3);if(this.camera.position.lerpVectors(o,u,v),this.control){const w=new r.Vector3;w.lerpVectors(l,d,v),this.control.target.copy(w),this.camera.lookAt(w)}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("  - 方向向量:",z),console.log("  - 包围盒尺寸:",n),console.log("  - 包围盒中心:",g.getCenter(new r.Vector3)),console.log("  - 水平 FOV:",r.MathUtils.radToDeg(m*2).toFixed(2)+"°"),console.log("  - 垂直 FOV:",r.MathUtils.radToDeg(a*2).toFixed(2)+"°"),console.log("  - 宽高比:",O.toFixed(4)),console.log("  - 模型宽度:",n.x.toFixed(2)),console.log("  - 模型高度:",n.y.toFixed(2)),console.log("  - 模型深度:",n.z.toFixed(2)),console.log("  - 传入的 scale 参数:",s),t==="top"){const o=n.x*.5/(Math.tan(m)*s),l=n.z*.5/(Math.tan(a)*s);console.log("  - 模型 X 尺寸 (宽度):",n.x.toFixed(2)),console.log("  - 模型 Z 尺寸 (深度):",n.z.toFixed(2)),console.log("  - tan(halfFovX):",Math.tan(m).toFixed(4)),console.log("  - tan(halfFovY):",Math.tan(a).toFixed(4)),console.log("  - X方向距离计算: (",(n.x*.5).toFixed(2),") / (",Math.tan(m).toFixed(4)," *",s,") =",o.toFixed(2)),console.log("  - Z方向距离计算: (",(n.z*.5).toFixed(2),") / (",Math.tan(a).toFixed(4)," *",s,") =",l.toFixed(2)),console.log("  - X方向距离 (scale="+s+"):",o.toFixed(2)),console.log("  - Z方向距离 (scale="+s+"):",l.toFixed(2))}else if(t==="right"||t==="left"){const o=n.y*.5/(Math.tan(a)*s),l=n.z*.5/(Math.tan(a)*s);console.log("  - Y方向距离 (scale="+s+"):",o.toFixed(2)),console.log("  - Z方向距离 (scale="+s+"):",l.toFixed(2))}else{const o=n.x*.5/(Math.tan(m)*s),l=n.y*.5/(Math.tan(a)*s),d=n.z*.5/(Math.tan(a)*s);console.log("  - 模型 X 尺寸 (宽度):",n.x.toFixed(2)),console.log("  - 模型 Y 尺寸 (高度):",n.y.toFixed(2)),console.log("  - 模型 Z 尺寸 (深度):",n.z.toFixed(2)),console.log("  - tan(halfFovX):",Math.tan(m).toFixed(4)),console.log("  - tan(halfFovY):",Math.tan(a).toFixed(4)),console.log("  - X方向距离计算: (",(n.x*.5).toFixed(2),") / (",Math.tan(m).toFixed(4)," *",s,") =",o.toFixed(2)),console.log("  - Y方向距离计算: (",(n.y*.5).toFixed(2),") / (",Math.tan(a).toFixed(4)," *",s,") =",l.toFixed(2)),console.log("  - Z方向距离计算: (",(n.z*.5).toFixed(2),") / (",Math.tan(a).toFixed(4)," *",s,") =",d.toFixed(2)),console.log("  - X方向距离 (scale="+s+"):",o.toFixed(2)),console.log("  - Y方向距离 (scale="+s+"):",l.toFixed(2)),console.log("  - Z方向距离 (scale="+s+"):",d.toFixed(2)),console.log("  - 最大距离 (Max):",Math.max(o,l,d).toFixed(2))}console.log("  - 最终距离:",f.toFixed(2)),console.log("  - 缩放比例:",s),console.log("  - 动画:",E?"是 ("+b+"ms)":"否")}return{position:u,target:c,distance:f,viewType:t}});i(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 r.Scene({}),this.camera=new r.PerspectiveCamera(50,1,.1,2e3),this.renderer=new r.WebGLRenderer({antialias:!0,alpha:!0,precision:"mediump",logarithmicDepthBuffer:!0}),this.version=j.version,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)}updateCameraFOV(e,t){const h=this.initOpt.initialFov||50,s=Math.tan(Math.PI/180*h/2);this.camera.aspect=e/t,this.camera.fov=360/Math.PI*Math.atan(s*(t/e)),this.camera.updateProjectionMatrix()}initStats(){this.stats=new P,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)}initCss3dRenderer(){this.css3dRenderer=new H.CSS3DRenderer;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)}getTargetSize(){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,t){if(!e){this.eventsListener={};return}this.eventsListener[e]&&(t?this.eventsListener[e]=this.eventsListener[e].filter(h=>h!==t):this.eventsListener[e]=[])}dispose(){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&&(Y.disposeThreeObject(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: 资源已清理完成"))}}i(y,"ViewType",M);exports.ThreeIns=y;exports.ViewType=M;

package/dist/packages/threejs/src/instance/threeIns.js

@@ -1,14 +1,14 @@
-var A = Object.defineProperty;
-var H = (p, e, t) => e in p ? A(p, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : p[e] = t;
-var i = (p, e, t) => H(p, typeof e != "symbol" ? e + "" : e, t);
-import { MathUtils as g, Scene as V, PerspectiveCamera as P, WebGLRenderer as q, Box3 as X, Vector3 as d, Box3Helper as Y } from "three";
-import { CSS3DRenderer as Z } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.js";
-import j from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.js";
-import { createOrbitControl as B } from "../utils/helper.js";
-import { disposeThreeObject as _ } from "../utils/disposeObject.js";
+var H = Object.defineProperty;
+var V = (x, e, t) => e in x ? H(x, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : x[e] = t;
+var o = (x, e, t) => V(x, typeof e != "symbol" ? e + "" : e, t);
+import { MathUtils as F, Scene as P, PerspectiveCamera as q, WebGLRenderer as X, Box3 as Y, Vector3 as a, Box3Helper as Z } from "three";
+import { CSS3DRenderer as j } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.js";
+import B from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.js";
+import { createOrbitControl as _ } from "../utils/helper.js";
+import { disposeThreeObject as N } from "../utils/disposeObject.js";
 import "../utils/PredictiveLoader.js";
-import { version as N } from "../../package.json.js";
-const W = 50, k = 20, G = 20, C = {
+import { version as W } from "../../package.json.js";
+const k = 50, G = 20, U = 20, y = {
   TOP: "top",
   // 俯视（从上往下）
   RIGHT: "right",
@@ -17,15 +17,15 @@ const W = 50, k = 20, G = 20, C = {
   // 左侧视
   ISO: "iso"
   // 正斜视（等轴测视角）
-}, U = {
+}, $ = {
   enableDamping: !0,
   dampingFactor: 0.25,
   screenSpacePanning: !1,
   minDistance: 0.1,
   maxDistance: 1e3,
-  maxPolarAngle: g.degToRad(60)
+  maxPolarAngle: F.degToRad(60)
 };
-class $ {
+class J {
   /**
    * 构造函数
    * @param {string} selector - DOM 容器选择器
@@ -40,21 +40,21 @@ class $ {
    * @param {Object} [option.control.options={}] - 控制器选项
    */
   constructor(e, t) {
-    i(this, "isReady", !1);
-    i(this, "scene", null);
-    i(this, "camera", null);
-    i(this, "renderer", null);
-    i(this, "control", null);
-    i(this, "css3dRenderer", null);
-    i(this, "el", null);
-    i(this, "renderRequested", !1);
-    i(this, "selector", null);
-    i(this, "eventsListener", {});
-    i(this, "stats", null);
-    i(this, "isDispose", !1);
-    i(this, "version", "0.0.0");
-    i(this, "boxHelper", null);
-    i(this, "initOpt", {
+    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",
@@ -71,25 +71,25 @@ class $ {
      * 初始化场景
      * @param {string} selector - DOM 容器选择器
      */
-    i(this, "setup", (e) => {
+    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 = B(this.camera, this.renderer.domElement);
+      const [t, c] = this.getTargetSize();
+      if (this.updateCameraFOV(t, c), 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, c), this.el.appendChild(this.renderer.domElement), this.initOpt.control && this.initOpt.control.init) {
+        this.control = _(this.camera, this.renderer.domElement);
         const s = Object.assign(
-          U,
+          $,
           this.initOpt.control.options || {}
         );
-        Object.keys(s).forEach((x) => {
-          this.control[x] = s[x];
+        Object.keys(s).forEach((p) => {
+          this.control[p] = s[p];
         });
       }
       setTimeout(() => {
         this.isReady = !0;
-      }, k), 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(
+      }, G), 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();
@@ -98,22 +98,22 @@ class $ {
      * WebGL 上下文丢失处理
      * @param {Event} e - 事件对象
      */
-    i(this, "onContextLost", (e) => {
+    o(this, "onContextLost", (e) => {
       e.preventDefault(), this.animationFrameId && cancelAnimationFrame(this.animationFrameId);
     });
     /**
      * WebGL 上下文恢复处理
      * @param {Event} e - 事件对象
      */
-    i(this, "onContextRestored", (e) => {
+    o(this, "onContextRestored", (e) => {
       e.preventDefault(), this.dispose(), setTimeout(() => {
         this.setup(this.selector);
-      }, G);
+      }, U);
     });
     /**
      * 初始化事件监听器
      */
-    i(this, "initListener", () => {
+    o(this, "initListener", () => {
       this.initOpt.initListener && window && window.addEventListener("resize", this.onResize, !1), this.renderer.domElement.addEventListener(
         "webglcontextlost",
         this.onContextLost,
@@ -127,7 +127,7 @@ class $ {
     /**
      * 移除事件监听器
      */
-    i(this, "removeListener", () => {
+    o(this, "removeListener", () => {
       window && window.removeEventListener("resize", this.onResize, !1), this.renderer && this.renderer.domElement && (this.renderer.domElement.removeEventListener(
         "webglcontextlost",
         this.onContextLost,
@@ -141,19 +141,19 @@ class $ {
     /**
      * 渲染循环（loop 模式）
      */
-    i(this, "animate", () => {
+    o(this, "animate", () => {
       this.isDispose || (this.initOpt.renderType === "loop" && this.onRender(), this.animationFrameId = requestAnimationFrame(this.animate));
     });
     /**
      * 执行渲染
      */
-    i(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()));
     });
     /**
      * 请求渲染（如果尚未请求）
      */
-    i(this, "requestRenderIfNotRequested", () => {
+    o(this, "requestRenderIfNotRequested", () => {
       this.renderRequested || (this.renderRequested = !0, requestAnimationFrame(() => {
         this.onRender();
       }));
@@ -161,11 +161,11 @@ class $ {
     /**
      * 处理窗口大小变化（带防抖）
      */
-    i(this, "onResize", () => {
+    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();
-      }, W);
+      }, k);
     });
     /**
      * @deprecated 此方法已弃用，请使用 setView() 方法代替
@@ -182,11 +182,11 @@ class $ {
      * @param {number} [scale=0.8] - 缩放比例，1=占满画布，0.5=50%，2.0=200%
      * @returns {Object} 返回 setView 的结果
      */
-    i(this, "frameArea", (e, t) => (console.warn(
+    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 })));
+    ), this.setView(e, y.ISO, { scale: t, animate: !1, showBox: !1 })));
     /**
      * 切换到指定视角
      * 根据视角类型自动调整相机位置和朝向，支持缩放比例控制
@@ -199,7 +199,10 @@ class $ {
      *                          - 'iso': 正斜视（等轴测视角，45°角）
      * @param {Object} [options] - 可选配置
      * @param {number} [options.scale=1] - 缩放比例，控制模型在画布中的占比
-     * @param {Vector3} [options.offset] - 偏移量，调整观察中心点
+     * @param {string|Vector3} [options.position='center'] - 模型在画布中的位置
+     *   - 字符串选项：'center'（中心）, 'top-left'（左上）, 'top-right'（右上）, 'bottom-left'（左下）, 'bottom-right'（右下）
+     *   - Vector3：自定义偏移向量
+     * @param {Vector3} [options.offset] - 额外的手动偏移量，在 position 基础上再次调整
      * @param {boolean} [options.showBox=false] - 是否显示包围盒辅助线
      * @param {number} [options.boxColor=0xffff00] - 包围盒颜色
      * @param {boolean} [options.animate=true] - 是否使用动画过渡
@@ -213,84 +216,105 @@ class $ {
      * // 导入 ViewType 枚举
      * import { ThreeIns, ViewType } from 'threejs';
      *
-     * // 切换到俯视，模型占满画布
+     * // 切换到俯视，模型占满画布，居中显示
      * threeIns.setView(model, ViewType.TOP);
      *
-     * // 切换到等轴测，模型占画布的 80%
-     * threeIns.setView(model, ViewType.ISO, { scale: 0.8 });
+     * // 切换到等轴测，模型占画布的 80%，左上角显示
+     * threeIns.setView(model, ViewType.ISO, {
+     *   scale: 0.8,
+     *   position: 'top-left'
+     * });
      *
-     * // 切换到斜视，显示包围盒，无动画
+     * // 切换到斜视，显示包围盒，右上角显示
      * threeIns.setView(model, ViewType.ISO, {
+     *   position: 'top-right',
      *   showBox: true,
      *   animate: false
      * });
      *
      * // 切换到侧视，自定义观察点
      * threeIns.setView(model, ViewType.RIGHT, {
-     *   offset: new THREE.Vector3(0, 10, 0),
+     *   position: new THREE.Vector3(100, 0, 0),
+     *   scale: 0.8
+     * });
+     *
+     * // 组合使用 position 和 offset
+     * threeIns.setView(model, ViewType.TOP, {
+     *   position: 'top-left',  // 先自动定位到左上
+     *   offset: new THREE.Vector3(50, 0, 0),  // 再额外向右偏移 50
      *   scale: 0.8
      * });
      *
      * // 或者使用类静态属性（向后兼容）
      * threeIns.setView(model, ThreeIns.ViewType.TOP);
      */
-    i(this, "setView", (e, t, l = {}) => {
-      let s = l.scale || 0.8, x = l.offset || null, R = l.showBox || !1, y = l.boxColor || 16776960, z = l.animate !== void 0 ? l.animate : !0, M = l.duration || 1e3;
-      const F = new X().setFromObject(e);
-      let h = F.getCenter(new d());
-      x && h.add(x);
-      const T = {
-        top: new d(0, 1, 0),
+    o(this, "setView", (e, t, c = {}) => {
+      let s = c.scale || 0.8, p = c.offset || null, R = c.position || "center", z = c.showBox || !1, S = c.boxColor || 16776960, M = c.animate !== void 0 ? c.animate : !0, b = c.duration || 1e3;
+      const g = new Y().setFromObject(e);
+      let h = g.getCenter(new a());
+      if (typeof R == "string") {
+        const i = g.getSize(new a()), r = {
+          center: new a(0, 0, 0),
+          "top-left": new a(-i.x * 0.3, i.y * 0.3, i.z * 0.3),
+          "top-right": new a(i.x * 0.3, i.y * 0.3, i.z * 0.3),
+          "bottom-left": new a(-i.x * 0.3, -i.y * 0.3, i.z * 0.3),
+          "bottom-right": new a(i.x * 0.3, -i.y * 0.3, i.z * 0.3)
+        }, d = r[R] || r.center;
+        t === "top" ? h.add(new a(d.x, 0, d.z)) : t === "right" || t === "left" ? h.add(new a(0, d.y, d.z)) : h.add(d);
+      } else R instanceof a && h.add(R);
+      p && h.add(p);
+      const L = {
+        top: new a(0, 1, 0),
         // 从上往下：Y 轴正方向
-        right: new d(2, 1, 1).normalize(),
+        right: new a(2, 1, 1).normalize(),
         // 从右往左：X 轴正方向
-        left: new d(-2, 1, 1).normalize(),
+        left: new a(-2, 1, 1).normalize(),
         // 从左往右：X 轴负方向
-        iso: new d(0, 1, 1).normalize()
+        iso: new a(0, 1, 1).normalize()
         // 等轴测：从对角线上方俯视
-      }, E = T[t] || T.iso, o = F.getSize(new d()), L = this.camera.aspect, n = g.degToRad(this.camera.fov * 0.5), S = g.degToRad(80), c = Math.min(Math.atan(Math.tan(n) * L), S);
-      let m;
+      }, w = L[t] || L.iso, n = g.getSize(new a()), O = this.camera.aspect, l = F.degToRad(this.camera.fov * 0.5), D = F.degToRad(80), m = Math.min(Math.atan(Math.tan(l) * O), D);
+      let f;
       if (t === "top") {
-        const r = o.x * 0.5 / (Math.tan(c) * s), a = o.z * 0.5 / (Math.tan(n) * s);
-        m = Math.max(r, a);
+        const i = n.x * 0.5 / (Math.tan(m) * s), r = n.z * 0.5 / (Math.tan(l) * s);
+        f = Math.max(i, r);
       } else if (t === "right" || t === "left") {
-        const r = o.y * 0.5 / (Math.tan(n) * s), a = o.z * 0.5 / (Math.tan(n) * s);
-        m = Math.max(r, a);
+        const i = n.y * 0.5 / (Math.tan(l) * s), r = n.z * 0.5 / (Math.tan(l) * s);
+        f = Math.max(i, r);
       } else {
-        const r = o.x * 0.5 / (Math.tan(c) * s), a = o.y * 0.5 / (Math.tan(n) * s), u = o.z * 0.5 / (Math.tan(n) * s);
-        m = Math.max(r, a, u);
+        const i = n.x * 0.5 / (Math.tan(m) * s), r = n.y * 0.5 / (Math.tan(l) * s), d = n.z * 0.5 / (Math.tan(l) * s);
+        f = Math.max(i, r, d);
       }
-      const f = E.clone().multiplyScalar(m).add(h);
-      if (R && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", E), console.log("  - 距离:", m.toFixed(2)), console.log("  - 包围盒中心:", h), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", f), console.log("  - 实际相机与中心的距离:", f.clone().sub(h).length().toFixed(2))), R ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new Y(F, y), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), z) {
-        const r = this.camera.position.clone(), a = this.control ? this.control.target.clone() : new d(0, 0, 0), u = h, D = Date.now(), v = () => {
-          const I = Date.now() - D, b = Math.min(I / M, 1), O = 1 - Math.pow(1 - b, 3);
-          if (this.camera.position.lerpVectors(r, f, O), this.control) {
-            const w = new d();
-            w.lerpVectors(a, u, O), this.control.target.copy(w), this.camera.lookAt(w);
+      const u = w.clone().multiplyScalar(f).add(h);
+      if (z && (console.log("📍 相机位置验证:"), console.log("  - 方向向量:", w), console.log("  - 距离:", f.toFixed(2)), console.log("  - 包围盒中心:", h), console.log("  - 计算公式: direction * distance + boxCenter"), console.log("  - 目标位置:", u), console.log("  - 实际相机与中心的距离:", u.clone().sub(h).length().toFixed(2))), z ? (this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), this.boxHelper = new Z(g, S), this.scene.add(this.boxHelper)) : this.boxHelper && (this.scene.remove(this.boxHelper), this.boxHelper = null), M) {
+        const i = this.camera.position.clone(), r = this.control ? this.control.target.clone() : new a(0, 0, 0), d = h, I = Date.now(), T = () => {
+          const A = Date.now() - I, v = Math.min(A / b, 1), C = 1 - Math.pow(1 - v, 3);
+          if (this.camera.position.lerpVectors(i, u, C), this.control) {
+            const E = new a();
+            E.lerpVectors(r, d, C), this.control.target.copy(E), this.camera.lookAt(E);
           } else
             this.camera.lookAt(h);
-          this.camera.updateProjectionMatrix(), b < 1 ? requestAnimationFrame(v) : (this.camera.position.copy(f), this.camera.lookAt(h), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(h), this.control.update()), this.onRender());
+          this.camera.updateProjectionMatrix(), v < 1 ? requestAnimationFrame(T) : (this.camera.position.copy(u), this.camera.lookAt(h), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(h), this.control.update()), this.onRender());
         };
-        v();
+        T();
       } else
-        this.camera.position.copy(f), this.camera.lookAt(h), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(h), this.control.update()), this.onRender();
-      if (R) {
-        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", t), console.log("  - 相机位置:", f), console.log("  - 观察目标:", h), console.log("  - 方向向量:", E), console.log("  - 包围盒尺寸:", o), console.log("  - 包围盒中心:", F.getCenter(new d())), console.log("  - 水平 FOV:", g.radToDeg(c * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", g.radToDeg(n * 2).toFixed(2) + "°"), console.log("  - 宽高比:", L.toFixed(4)), console.log("  - 模型宽度:", o.x.toFixed(2)), console.log("  - 模型高度:", o.y.toFixed(2)), console.log("  - 模型深度:", o.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), t === "top") {
-          const r = o.x * 0.5 / (Math.tan(c) * s), a = o.z * 0.5 / (Math.tan(n) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", o.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", o.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(c).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(n).toFixed(4)), console.log("  - X方向距离计算: (", (o.x * 0.5).toFixed(2), ") / (", Math.tan(c).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (o.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));
+        this.camera.position.copy(u), this.camera.lookAt(h), this.camera.updateProjectionMatrix(), this.control && (this.control.target.copy(h), this.control.update()), this.onRender();
+      if (z) {
+        if (console.log("🎥 视角切换信息:"), console.log("  - 视角类型:", t), console.log("  - 相机位置:", u), console.log("  - 观察目标:", h), console.log("  - 方向向量:", w), console.log("  - 包围盒尺寸:", n), console.log("  - 包围盒中心:", g.getCenter(new a())), console.log("  - 水平 FOV:", F.radToDeg(m * 2).toFixed(2) + "°"), console.log("  - 垂直 FOV:", F.radToDeg(l * 2).toFixed(2) + "°"), console.log("  - 宽高比:", O.toFixed(4)), console.log("  - 模型宽度:", n.x.toFixed(2)), console.log("  - 模型高度:", n.y.toFixed(2)), console.log("  - 模型深度:", n.z.toFixed(2)), console.log("  - 传入的 scale 参数:", s), t === "top") {
+          const i = n.x * 0.5 / (Math.tan(m) * s), r = n.z * 0.5 / (Math.tan(l) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", n.x.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", n.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(l).toFixed(4)), console.log("  - X方向距离计算: (", (n.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Z方向距离计算: (", (n.z * 0.5).toFixed(2), ") / (", Math.tan(l).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", r.toFixed(2));
         } else if (t === "right" || t === "left") {
-          const r = o.y * 0.5 / (Math.tan(n) * s), a = o.z * 0.5 / (Math.tan(n) * s);
-          console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", a.toFixed(2));
+          const i = n.y * 0.5 / (Math.tan(l) * s), r = n.z * 0.5 / (Math.tan(l) * s);
+          console.log("  - Y方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", r.toFixed(2));
         } else {
-          const r = o.x * 0.5 / (Math.tan(c) * s), a = o.y * 0.5 / (Math.tan(n) * s), u = o.z * 0.5 / (Math.tan(n) * s);
-          console.log("  - 模型 X 尺寸 (宽度):", o.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", o.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", o.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(c).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(n).toFixed(4)), console.log("  - X方向距离计算: (", (o.x * 0.5).toFixed(2), ") / (", Math.tan(c).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Y方向距离计算: (", (o.y * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", a.toFixed(2)), console.log("  - Z方向距离计算: (", (o.z * 0.5).toFixed(2), ") / (", Math.tan(n).toFixed(4), " *", s, ") =", u.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", a.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", u.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(r, a, u).toFixed(2));
+          const i = n.x * 0.5 / (Math.tan(m) * s), r = n.y * 0.5 / (Math.tan(l) * s), d = n.z * 0.5 / (Math.tan(l) * s);
+          console.log("  - 模型 X 尺寸 (宽度):", n.x.toFixed(2)), console.log("  - 模型 Y 尺寸 (高度):", n.y.toFixed(2)), console.log("  - 模型 Z 尺寸 (深度):", n.z.toFixed(2)), console.log("  - tan(halfFovX):", Math.tan(m).toFixed(4)), console.log("  - tan(halfFovY):", Math.tan(l).toFixed(4)), console.log("  - X方向距离计算: (", (n.x * 0.5).toFixed(2), ") / (", Math.tan(m).toFixed(4), " *", s, ") =", i.toFixed(2)), console.log("  - Y方向距离计算: (", (n.y * 0.5).toFixed(2), ") / (", Math.tan(l).toFixed(4), " *", s, ") =", r.toFixed(2)), console.log("  - Z方向距离计算: (", (n.z * 0.5).toFixed(2), ") / (", Math.tan(l).toFixed(4), " *", s, ") =", d.toFixed(2)), console.log("  - X方向距离 (scale=" + s + "):", i.toFixed(2)), console.log("  - Y方向距离 (scale=" + s + "):", r.toFixed(2)), console.log("  - Z方向距离 (scale=" + s + "):", d.toFixed(2)), console.log("  - 最大距离 (Max):", Math.max(i, r, d).toFixed(2));
         }
-        console.log("  - 最终距离:", m.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", z ? "是 (" + M + "ms)" : "否");
+        console.log("  - 最终距离:", f.toFixed(2)), console.log("  - 缩放比例:", s), console.log("  - 动画:", M ? "是 (" + b + "ms)" : "否");
       }
       return {
-        position: f,
+        position: u,
         target: h,
-        distance: m,
+        distance: f,
         viewType: t
       };
     });
@@ -300,14 +324,14 @@ class $ {
      * @param {Function} callback - 回调函数
      * @returns {Function} 返回取消监听的函数
      */
-    i(this, "on", (e, t) => !e || !t || typeof t != "function" ? (console.warn("ThreeIns.on: 无效的参数"), () => {
+    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 V({}), this.camera = new P(50, 1, 0.1, 2e3), this.renderer = new q({
+    this.isReady = !1, this.scene = new P({}), this.camera = new q(50, 1, 0.1, 2e3), this.renderer = new X({
       antialias: !0,
       alpha: !0,
       precision: "mediump",
       logarithmicDepthBuffer: !0
-    }), this.version = N, 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);
+    }), this.version = W, 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 以适应容器尺寸
@@ -316,20 +340,20 @@ class $ {
    * @param {number} domH - 容器高度
    */
   updateCameraFOV(e, t) {
-    const l = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * l / 2);
+    const c = this.initOpt.initialFov || 50, s = Math.tan(Math.PI / 180 * c / 2);
     this.camera.aspect = e / t, this.camera.fov = 360 / Math.PI * Math.atan(s * (t / e)), this.camera.updateProjectionMatrix();
   }
   /**
    * 初始化性能统计
    */
   initStats() {
-    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);
+    this.stats = new B(), 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 Z();
+    this.css3dRenderer = new j();
     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);
   }
@@ -351,19 +375,19 @@ class $ {
       this.eventsListener = {};
       return;
     }
-    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((l) => l !== t) : this.eventsListener[e] = []);
+    this.eventsListener[e] && (t ? this.eventsListener[e] = this.eventsListener[e].filter((c) => c !== t) : this.eventsListener[e] = []);
   }
   /**
    * 清理所有资源
    */
   dispose() {
-    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 && (_(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: 资源已清理完成"));
+    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 && (N(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: 资源已清理完成"));
   }
 }
 // 存储包围盒辅助器
 // 视角类型枚举（作为类静态属性引用，保持向后兼容）
-i($, "ViewType", C);
+o(J, "ViewType", y);
 export {
-  $ as ThreeIns,
-  C as ViewType
+  J as ThreeIns,
+  y as ViewType
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ridp/threejs",
   "private": false,
-  "version": "1.4.2",
+  "version": "1.4.3",
   "type": "module",
   "main": "dist/threejs.js",
   "exports": {