@ridp/threejs 1.4.0 → 1.4.2

package/dist/hooks.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./useBatchGLTFLoader-CDNvTMtt.cjs"),r=require("./PredictiveLoader-CpRi-ULa.cjs");exports.intersectColor=e.intersectColor;exports.obbObjects=e.obbObjects;exports.useBatchGLTFLoader=e.useBatchGLTFLoader;exports.useObb=e.useObb;exports.useRaycaster=e.useRaycaster;exports.useThreeJs=e.useThreeJs;exports.useGLTFLoader=r.useGLTFLoader;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=require("./packages/threejs/src/hooks/useThreeJs.cjs"),r=require("./packages/threejs/src/hooks/useRaycaster.cjs"),e=require("./packages/threejs/src/hooks/useObb.cjs"),t=require("./packages/threejs/src/hooks/useGLTFLoader.cjs"),u=require("./packages/threejs/src/hooks/useBatchGLTFLoader.cjs");exports.useThreeJs=s.useThreeJs;exports.useRaycaster=r.useRaycaster;exports.intersectColor=e.intersectColor;exports.obbObjects=e.obbObjects;exports.useObb=e.useObb;exports.useGLTFLoader=t.useGLTFLoader;exports.useBatchGLTFLoader=u.useBatchGLTFLoader;

package/dist/hooks.js

@@ -1,11 +1,14 @@
-import { i as a, o, c as r, b as t, a as u, u as b } from "./useBatchGLTFLoader-Dg-xau9i.js";
-import { u as L } from "./PredictiveLoader--_3bEnce.js";
+import { useThreeJs as o } from "./packages/threejs/src/hooks/useThreeJs.js";
+import { useRaycaster as s } from "./packages/threejs/src/hooks/useRaycaster.js";
+import { intersectColor as b, obbObjects as f, useObb as m } from "./packages/threejs/src/hooks/useObb.js";
+import { useGLTFLoader as u } from "./packages/threejs/src/hooks/useGLTFLoader.js";
+import { useBatchGLTFLoader as c } from "./packages/threejs/src/hooks/useBatchGLTFLoader.js";
 export {
-  a as intersectColor,
-  o as obbObjects,
-  r as useBatchGLTFLoader,
-  L as useGLTFLoader,
-  t as useObb,
-  u as useRaycaster,
-  b as useThreeJs
+  b as intersectColor,
+  f as obbObjects,
+  c as useBatchGLTFLoader,
+  u as useGLTFLoader,
+  m as useObb,
+  s as useRaycaster,
+  o as useThreeJs
 };

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

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

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

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

package/dist/packages/threejs/src/hooks/useBatchGLTFLoader.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const C=require("./useGLTFLoader.cjs");function P(){const{asyncFetch:d}=C.useGLTFLoader();async function i(e,t={}){const{maxConcurrent:r=3,maxRetries:c=3,onProgress:s,onModelLoad:o,onModelError:a}=t,u=new Map,g=new Map,y=[...e];let h=0,f=0;return new Promise((F,R)=>{const G=async w=>{const{path:l,version:T}=w;f++;try{const n=await d(l,T,b=>{const x=h/e.length*100+b/e.length;s==null||s(Math.round(x))},{maxRetries:c});if(n)u.set(l,n),o==null||o(l,n);else throw new Error(`模型加载返回空结果: ${l}`)}catch(n){console.error(`[ 批量加载 ] 加载失败: ${l}`,n),g.set(l,n),a==null||a(l,n)}finally{f--,h++;const n=h/e.length*100;s==null||s(Math.round(n)),L()}},L=()=>{if(h>=e.length){g.size>0&&console.warn(`[ 批量加载 ] 完成,但有 ${g.size} 个模型加载失败`),F(u);return}for(;y.length>0&&f<r;){const w=y.shift();G(w)}};L()})}async function $(e,t={}){console.log(`[ 批量预加载 ] 开始预加载 ${e.length} 个模型`);const r=await i(e,{...t,maxConcurrent:t.maxConcurrent||2});return console.log(`[ 批量预加载 ] 完成,成功加载 ${r.size} 个模型`),r}async function M(e,t={}){const r=new Map;for(let c=0;c<e.length;c++)console.log(`[ 分组批量加载 ] 加载第 ${c+1}/${e.length} 组`),(await i(e[c],{...t,onProgress:o=>{var u;const a=c/e.length*100+o/e.length;(u=t.onProgress)==null||u.call(t,Math.round(a))}})).forEach((o,a)=>{r.set(a,o)});return r}return{batchLoad:i,preload:$,batchLoadGroups:M}}exports.useBatchGLTFLoader=P;

package/dist/packages/threejs/src/hooks/useBatchGLTFLoader.js

@@ -0,0 +1,83 @@
+import { useGLTFLoader as z } from "./useGLTFLoader.js";
+function P() {
+  const { asyncFetch: x } = z();
+  async function i(t, e = {}) {
+    const {
+      maxConcurrent: r = 3,
+      maxRetries: c = 3,
+      onProgress: s,
+      onModelLoad: o,
+      onModelError: a
+    } = e, u = /* @__PURE__ */ new Map(), g = /* @__PURE__ */ new Map(), y = [...t];
+    let h = 0, f = 0;
+    return new Promise((m, F) => {
+      const C = async (w) => {
+        const { path: l, version: R } = w;
+        f++;
+        try {
+          const n = await x(
+            l,
+            R,
+            (d) => {
+              const p = h / t.length * 100 + d / t.length;
+              s == null || s(Math.round(p));
+            },
+            { maxRetries: c }
+          );
+          if (n)
+            u.set(l, n), o == null || o(l, n);
+          else
+            throw new Error(`模型加载返回空结果: ${l}`);
+        } catch (n) {
+          console.error(`[ 批量加载 ] 加载失败: ${l}`, n), g.set(l, n), a == null || a(l, n);
+        } finally {
+          f--, h++;
+          const n = h / t.length * 100;
+          s == null || s(Math.round(n)), $();
+        }
+      }, $ = () => {
+        if (h >= t.length) {
+          g.size > 0 && console.warn(`[ 批量加载 ] 完成,但有 ${g.size} 个模型加载失败`), m(u);
+          return;
+        }
+        for (; y.length > 0 && f < r; ) {
+          const w = y.shift();
+          C(w);
+        }
+      };
+      $();
+    });
+  }
+  async function L(t, e = {}) {
+    console.log(`[ 批量预加载 ] 开始预加载 ${t.length} 个模型`);
+    const r = await i(t, {
+      ...e,
+      maxConcurrent: e.maxConcurrent || 2
+      // 预加载使用较低的并发数
+    });
+    return console.log(`[ 批量预加载 ] 完成,成功加载 ${r.size} 个模型`), r;
+  }
+  async function M(t, e = {}) {
+    const r = /* @__PURE__ */ new Map();
+    for (let c = 0; c < t.length; c++)
+      console.log(`[ 分组批量加载 ] 加载第 ${c + 1}/${t.length} 组`), (await i(t[c], {
+        ...e,
+        onProgress: (o) => {
+          var u;
+          const a = c / t.length * 100 + o / t.length;
+          (u = e.onProgress) == null || u.call(e, Math.round(a));
+        }
+      })).forEach((o, a) => {
+        r.set(a, o);
+      });
+    return r;
+  }
+  return {
+    batchLoad: i,
+    preload: L,
+    batchLoadGroups: M
+  };
+}
+export {
+  P as useBatchGLTFLoader
+};

package/dist/packages/threejs/src/hooks/useGLTFLoader.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const x=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/GLTFLoader.cjs"),U=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/DRACOLoader.cjs"),R=require("../instance/IDBCache.cjs");require("three");const V=require("../utils/modelSerialize.cjs"),u=require("../utils/CacheMonitor.cjs"),b=require("../utils/RetryHelper.cjs"),J=require("../utils/sceneRebuilder.cjs"),K=require("../workers/gltfParser.worker.cjs"),N=require("../workers/gltfParserOptimized.worker.cjs");let k;const O="/draco/";let y,g,$=0;const m=new Map,d=new Map,Q=(D={})=>{const{debug:T=!1}=D,C=new x.GLTFLoader,z=new U.DRACOLoader;z.setDecoderPath(O),C.setDRACOLoader(z);const n={info:(...e)=>T&&console.log(...e),warn:(...e)=>T&&console.warn(...e),error:(...e)=>console.error(...e),time:e=>T&&console.time(e),timeEnd:e=>T&&console.timeEnd(e)};function G(e,r,t,s){return C.load(e,r,t,s)}function S(e,r){return new Promise((t,s)=>{C.load(e,t,r,s)})}async function E(e,r,t,s={}){const o=performance.now();let i=!1;const{maxRetries:a=3,optimizeMaterials:h=!1,simplifyGeometry:p=!1,simplifyRatio:M=.5,simplifyOptions:L={},useMemoryCache:W=!0}=s;if(W){const c=d.get(e);if(c&&c.has(r)){const l=c.get(r);n.info(`[ 内存缓存命中 ] ${e} (version: ${r})`),n.time("[ 内存缓存克隆耗时 ]");const w=l.clone(!0);return n.timeEnd("[ 内存缓存克隆耗时 ]"),u.cacheMonitor.recordHit(performance.now()-o),w}}try{let c=await v(e,r);if(c)n.info(`[ asyncFetch ] ====> IndexedDB 缓存命中: ${e}`),i=!0;else{n.info(`[ asyncFetch ] ====> 缓存未命中: ${e}`),n.time("[ fetchArrayBuffer ] 加载模型耗时"),c=await b.RetryHelper.retry(()=>q(e,t),{maxRetries:a,shouldRetry:F=>!!(F.name==="TypeError"||F.message.includes("HTTP error! status: 5"))}),n.timeEnd("[ fetchArrayBuffer ] 加载模型耗时");const f=performance.now();await k.saveModel(e,r,c);const P=performance.now()-f;u.cacheMonitor.recordCacheSave(P),i=!1}n.time("[ 解析模型耗时 ]");let l=await A(c);if(n.timeEnd("[ 解析模型耗时 ]"),n.time("[ 模型优化耗时 ]"),h){n.info("🔧 [ 材质优化 ] 开始合并相同材质...");const{modelOptimizer:f}=await Promise.resolve().then(()=>require("../utils/modelOptimizer.cjs"));l=f.optimizeMaterials(l)}if(p){n.info(`🔧 [ 几何体简化 ] 开始简化模型 (比例: ${M})...`);const{modelOptimizer:f}=await Promise.resolve().then(()=>require("../utils/modelOptimizer.cjs")),P={minFaceCount:100,preserveUVs:!0,...L};l=f.simplifyModel(l,M,P)}if(n.timeEnd("[ 模型优化耗时 ]"),W){d.has(e)||d.set(e,new Map);const f=d.get(e);f.has(r)||(n.info(`[ 内存缓存 ] 存储模型 ${e} (version: ${r})`),f.set(r,l.clone(!0)))}const w=performance.now()-o;return i?u.cacheMonitor.recordHit(w):u.cacheMonitor.recordMiss(w),l}catch(c){throw n.error(`加载模型 ${e} 失败:`,c),u.cacheMonitor.recordError(e,c),c.name==="TypeError"&&c.message.includes("fetch")?b.ModelLoadError.networkError(e,c):c}}async function q(e,r){return new Promise((t,s)=>{fetch(e).then(o=>{if(!o.ok)throw new Error(`HTTP error! status: ${o.status}`);return o}).then(o=>{const i=o.headers.get("content-length"),a=i?parseInt(i,10):0;if(r&&a>0){const h=o.body.getReader();let p=0;const M=[],L=()=>{h.read().then(({done:W,value:c})=>{if(W){const l=new Uint8Array(p);let w=0;for(const f of M)l.set(f,w),w+=f.length;t(l.buffer);return}M.push(c),p+=c.length,r(Math.round(p/a*100)),L()}).catch(s)};L()}else return o.arrayBuffer()}).then(o=>t(o)).catch(o=>{s(o)})})}async function v(e,r){return k||(k=new R.IDBCache),k.getModel(e,r)}async function A(e,r={}){if(!e)return null;const{useOptimizedParser:t=!0,useProgressive:s=!1}=r;if(t){const a=B();if(a)try{n.time("[ 优化解析 ] 使用 Transferable Objects 解析");const h=await H(a,e,s);return n.timeEnd("[ 优化解析 ] 使用 Transferable Objects 解析"),J.rebuildScene(h)}catch(h){n.warn("[ 优化解析 ] 失败,回退到标准解析",h)}}const o=I();if(o)try{const a=await j(o,e);return V.dataToObject3D(a)}catch(a){n.warn("[ GLTF Worker ] ====> 解析失败，回退到主线程解析",a)}return(await _(e)).scene}const I=()=>{if(typeof window>"u"||typeof Worker>"u")return null;if(!y)try{n.info("[GLTF Worker] 使用 ?worker 工厂函数创建 Worker..."),y=K(),n.info("[GLTF Worker] Worker 创建成功:",y),y.onmessage=e=>{const{id:r,data:t,error:s}=e.data||{};if(!r||!m.has(r))return;const{resolve:o,reject:i}=m.get(r);m.delete(r),s?i(new Error(s)):o(t)},y.onmessageerror=e=>{console.error("[ GLTF Worker ] ====> 消息解析失败",e)},y.onerror=e=>{console.error("[ GLTF Worker ] ====> 运行错误",e)}}catch(e){console.error("[GLTF Worker] 创建 Worker 失败:",e),console.error("[GLTF Worker] 错误堆栈:",e.stack)}return y},B=()=>{if(typeof window>"u"||typeof Worker>"u")return null;if(!g)try{n.info("[Optimized Worker] 使用 ?worker 工厂函数创建 Worker..."),g=N(),n.info("[Optimized Worker] Worker 创建成功:",g),g.onmessage=e=>{const{id:r,data:t,error:s,type:o}=e.data||{};if(!r||!m.has(r)||o==="progress")return;const{resolve:i,reject:a}=m.get(r);m.delete(r),s?a(new Error(s)):i(t)},g.onmessageerror=e=>{console.error("[ 优化 Worker ] ====> 消息解析失败",e)},g.onerror=e=>{console.error("[ 优化 Worker ] ====> 运行错误",e)}}catch(e){return n.warn("[ 优化 Worker ] ====> 创建失败,可能不支持模块化 Worker",e),null}return g},H=(e,r,t=!1)=>new Promise((s,o)=>{const i=++$;m.set(i,{resolve:s,reject:o});const a={id:i,arrayBuffer:r,dracoPath:O,mode:t?"progressive":"standard"};e.postMessage(a,[r])}),j=(e,r)=>new Promise((t,s)=>{const o=++$;m.set(o,{resolve:t,reject:s}),e.postMessage({id:o,arrayBuffer:r,dracoPath:O})}),_=e=>new Promise((r,t)=>{C.parse(e,"",r,t)});return{load:G,asyncLoad:S,asyncCacheLoad:E,asyncFetch:E,getCacheStats:()=>u.cacheMonitor.getStats(),getCache:()=>k||(k=new R.IDBCache),logCacheReport:()=>u.cacheMonitor.logReport(),resetCacheStats:()=>u.cacheMonitor.reset(),clearMemoryCache:()=>{let e=0;for(const[r,t]of d.entries())e+=t.size,t.clear();return d.clear(),n.info(`[ 内存缓存 ] 已清空，释放了 ${e} 个模型`),e},getMemoryCacheInfo:()=>{const e=[];let r=0;for(const[t,s]of d.entries()){const o=Array.from(s.keys());r+=o.length,e.push({path:t,versions:o,count:o.length})}return{totalPaths:d.size,totalModels:r,details:e}},deleteMemoryCache:(e,r)=>{const t=d.get(e);if(!t)return!1;if(r){const s=t.delete(r);return t.size===0&&d.delete(e),n.info(`[ 内存缓存 ] 删除模型 ${e} (version: ${r})`),s}else{const s=t.size;return d.delete(e),n.info(`[ 内存缓存 ] 删除模型 ${e} 及其所有版本 (共 ${s} 个)`),s>0}}}};exports.useGLTFLoader=Q;

package/dist/packages/threejs/src/hooks/useGLTFLoader.js

@@ -0,0 +1,292 @@
+import { GLTFLoader as U } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/GLTFLoader.js";
+import { DRACOLoader as _ } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/DRACOLoader.js";
+import { IDBCache as $ } from "../instance/IDBCache.js";
+import "three";
+import { dataToObject3D as V } from "../utils/modelSerialize.js";
+import { cacheMonitor as m } from "../utils/CacheMonitor.js";
+import { RetryHelper as q, ModelLoadError as J } from "../utils/RetryHelper.js";
+import { rebuildScene as K } from "../utils/sceneRebuilder.js";
+import N from "../workers/gltfParser.worker.js";
+import Q from "../workers/gltfParserOptimized.worker.js";
+let y;
+const O = "/draco/";
+let w, k, R = 0;
+const u = /* @__PURE__ */ new Map(), d = /* @__PURE__ */ new Map(), ce = (b = {}) => {
+  const { debug: T = !1 } = b, M = new U(), P = new _();
+  P.setDecoderPath(O), M.setDRACOLoader(P);
+  const n = {
+    info: (...e) => T && console.log(...e),
+    warn: (...e) => T && console.warn(...e),
+    error: (...e) => console.error(...e),
+    // 错误总是输出
+    time: (e) => T && console.time(e),
+    timeEnd: (e) => T && console.timeEnd(e)
+  };
+  function A(e, r, o, s) {
+    return M.load(e, r, o, s);
+  }
+  function G(e, r) {
+    return new Promise((o, s) => {
+      M.load(e, o, r, s);
+    });
+  }
+  async function z(e, r, o, s = {}) {
+    const t = performance.now();
+    let i = !1;
+    const {
+      maxRetries: c = 3,
+      optimizeMaterials: h = !1,
+      simplifyGeometry: g = !1,
+      simplifyRatio: W = 0.5,
+      simplifyOptions: C = {},
+      useMemoryCache: L = !0
+      // 是否使用内存缓存（默认 true）
+    } = s;
+    if (L) {
+      const a = d.get(e);
+      if (a && a.has(r)) {
+        const f = a.get(r);
+        n.info(`[ 内存缓存命中 ] ${e} (version: ${r})`), n.time("[ 内存缓存克隆耗时 ]");
+        const p = f.clone(!0);
+        return n.timeEnd("[ 内存缓存克隆耗时 ]"), m.recordHit(performance.now() - t), p;
+      }
+    }
+    try {
+      let a = await S(e, r);
+      if (a)
+        n.info(`[ asyncFetch ] ====> IndexedDB 缓存命中: ${e}`), i = !0;
+      else {
+        n.info(`[ asyncFetch ] ====> 缓存未命中: ${e}`), n.time("[ fetchArrayBuffer ] 加载模型耗时"), a = await q.retry(
+          () => D(e, o),
+          {
+            maxRetries: c,
+            shouldRetry: (F) => !!(F.name === "TypeError" || F.message.includes("HTTP error! status: 5"))
+          }
+        ), n.timeEnd("[ fetchArrayBuffer ] 加载模型耗时");
+        const l = performance.now();
+        await y.saveModel(e, r, a);
+        const E = performance.now() - l;
+        m.recordCacheSave(E), i = !1;
+      }
+      n.time("[ 解析模型耗时 ]");
+      let f = await v(a);
+      if (n.timeEnd("[ 解析模型耗时 ]"), n.time("[ 模型优化耗时 ]"), h) {
+        n.info("🔧 [ 材质优化 ] 开始合并相同材质...");
+        const { modelOptimizer: l } = await import("../utils/modelOptimizer.js");
+        f = l.optimizeMaterials(f);
+      }
+      if (g) {
+        n.info(`🔧 [ 几何体简化 ] 开始简化模型 (比例: ${W})...`);
+        const { modelOptimizer: l } = await import("../utils/modelOptimizer.js"), E = {
+          minFaceCount: 100,
+          preserveUVs: !0,
+          ...C
+        };
+        f = l.simplifyModel(f, W, E);
+      }
+      if (n.timeEnd("[ 模型优化耗时 ]"), L) {
+        d.has(e) || d.set(e, /* @__PURE__ */ new Map());
+        const l = d.get(e);
+        l.has(r) || (n.info(`[ 内存缓存 ] 存储模型 ${e} (version: ${r})`), l.set(r, f.clone(!0)));
+      }
+      const p = performance.now() - t;
+      return i ? m.recordHit(p) : m.recordMiss(p), f;
+    } catch (a) {
+      throw n.error(`加载模型 ${e} 失败:`, a), m.recordError(e, a), a.name === "TypeError" && a.message.includes("fetch") ? J.networkError(e, a) : a;
+    }
+  }
+  async function D(e, r) {
+    return new Promise((o, s) => {
+      fetch(e).then((t) => {
+        if (!t.ok)
+          throw new Error(`HTTP error! status: ${t.status}`);
+        return t;
+      }).then((t) => {
+        const i = t.headers.get("content-length"), c = i ? parseInt(i, 10) : 0;
+        if (r && c > 0) {
+          const h = t.body.getReader();
+          let g = 0;
+          const W = [], C = () => {
+            h.read().then(({ done: L, value: a }) => {
+              if (L) {
+                const f = new Uint8Array(g);
+                let p = 0;
+                for (const l of W)
+                  f.set(l, p), p += l.length;
+                o(f.buffer);
+                return;
+              }
+              W.push(a), g += a.length, r(Math.round(g / c * 100)), C();
+            }).catch(s);
+          };
+          C();
+        } else
+          return t.arrayBuffer();
+      }).then((t) => o(t)).catch((t) => {
+        s(t);
+      });
+    });
+  }
+  async function S(e, r) {
+    return y || (y = new $()), y.getModel(e, r);
+  }
+  async function v(e, r = {}) {
+    if (!e) return null;
+    const { useOptimizedParser: o = !0, useProgressive: s = !1 } = r;
+    if (o) {
+      const c = B();
+      if (c)
+        try {
+          n.time("[ 优化解析 ] 使用 Transferable Objects 解析");
+          const h = await H(c, e, s);
+          return n.timeEnd("[ 优化解析 ] 使用 Transferable Objects 解析"), K(h);
+        } catch (h) {
+          n.warn("[ 优化解析 ] 失败,回退到标准解析", h);
+        }
+    }
+    const t = I();
+    if (t)
+      try {
+        const c = await j(t, e);
+        return V(c);
+      } catch (c) {
+        n.warn("[ GLTF Worker ] ====> 解析失败，回退到主线程解析", c);
+      }
+    return (await x(e)).scene;
+  }
+  const I = () => {
+    if (typeof window > "u" || typeof Worker > "u")
+      return null;
+    if (!w)
+      try {
+        n.info("[GLTF Worker] 使用 ?worker 工厂函数创建 Worker..."), w = N(), n.info("[GLTF Worker] Worker 创建成功:", w), w.onmessage = (e) => {
+          const { id: r, data: o, error: s } = e.data || {};
+          if (!r || !u.has(r)) return;
+          const { resolve: t, reject: i } = u.get(r);
+          u.delete(r), s ? i(new Error(s)) : t(o);
+        }, w.onmessageerror = (e) => {
+          console.error("[ GLTF Worker ] ====> 消息解析失败", e);
+        }, w.onerror = (e) => {
+          console.error("[ GLTF Worker ] ====> 运行错误", e);
+        };
+      } catch (e) {
+        console.error("[GLTF Worker] 创建 Worker 失败:", e), console.error("[GLTF Worker] 错误堆栈:", e.stack);
+      }
+    return w;
+  }, B = () => {
+    if (typeof window > "u" || typeof Worker > "u")
+      return null;
+    if (!k)
+      try {
+        n.info("[Optimized Worker] 使用 ?worker 工厂函数创建 Worker..."), k = Q(), n.info("[Optimized Worker] Worker 创建成功:", k), k.onmessage = (e) => {
+          const { id: r, data: o, error: s, type: t } = e.data || {};
+          if (!r || !u.has(r) || t === "progress")
+            return;
+          const { resolve: i, reject: c } = u.get(r);
+          u.delete(r), s ? c(new Error(s)) : i(o);
+        }, k.onmessageerror = (e) => {
+          console.error("[ 优化 Worker ] ====> 消息解析失败", e);
+        }, k.onerror = (e) => {
+          console.error("[ 优化 Worker ] ====> 运行错误", e);
+        };
+      } catch (e) {
+        return n.warn("[ 优化 Worker ] ====> 创建失败,可能不支持模块化 Worker", e), null;
+      }
+    return k;
+  }, H = (e, r, o = !1) => new Promise((s, t) => {
+    const i = ++R;
+    u.set(i, { resolve: s, reject: t });
+    const c = {
+      id: i,
+      arrayBuffer: r,
+      dracoPath: O,
+      mode: o ? "progressive" : "standard"
+    };
+    e.postMessage(c, [r]);
+  }), j = (e, r) => new Promise((o, s) => {
+    const t = ++R;
+    u.set(t, { resolve: o, reject: s }), e.postMessage({ id: t, arrayBuffer: r, dracoPath: O });
+  }), x = (e) => new Promise((r, o) => {
+    M.parse(e, "", r, o);
+  });
+  return {
+    load: A,
+    asyncLoad: G,
+    asyncCacheLoad: z,
+    asyncFetch: z,
+    /**
+     * 获取缓存统计信息
+     * @returns {Object} 统计数据
+     */
+    getCacheStats: () => m.getStats(),
+    /**
+     * 获取缓存实例
+     * @returns {IDBCache} 缓存实例
+     */
+    getCache: () => y || (y = new $()),
+    /**
+     * 打印缓存性能报告
+     */
+    logCacheReport: () => m.logReport(),
+    /**
+     * 重置缓存统计
+     */
+    resetCacheStats: () => m.reset(),
+    /**
+     * 清空内存缓存
+     * 释放已缓存的 3D 模型对象内存
+     * @returns {number} 释放的模型数量
+     */
+    clearMemoryCache: () => {
+      let e = 0;
+      for (const [r, o] of d.entries())
+        e += o.size, o.clear();
+      return d.clear(), n.info(`[ 内存缓存 ] 已清空，释放了 ${e} 个模型`), e;
+    },
+    /**
+     * 获取内存缓存信息
+     * @returns {Object} 内存缓存统计
+     * @returns {number} returns.totalPaths - 缓存的不同模型路径数量
+     * @returns {number} returns.totalModels - 缓存的总模型数量
+     * @returns {Array} returns.details - 每个路径的详细信息
+     */
+    getMemoryCacheInfo: () => {
+      const e = [];
+      let r = 0;
+      for (const [o, s] of d.entries()) {
+        const t = Array.from(s.keys());
+        r += t.length, e.push({
+          path: o,
+          versions: t,
+          count: t.length
+        });
+      }
+      return {
+        totalPaths: d.size,
+        totalModels: r,
+        details: e
+      };
+    },
+    /**
+     * 删除指定模型的内存缓存
+     * @param {string} path - 模型路径
+     * @param {string} [version] - 可选的版本号，如果不指定则删除该路径的所有版本
+     * @returns {boolean} 是否删除成功
+     */
+    deleteMemoryCache: (e, r) => {
+      const o = d.get(e);
+      if (!o)
+        return !1;
+      if (r) {
+        const s = o.delete(r);
+        return o.size === 0 && d.delete(e), n.info(`[ 内存缓存 ] 删除模型 ${e} (version: ${r})`), s;
+      } else {
+        const s = o.size;
+        return d.delete(e), n.info(`[ 内存缓存 ] 删除模型 ${e} 及其所有版本 (共 ${s} 个)`), s > 0;
+      }
+    }
+  };
+};
+export {
+  ce as useGLTFLoader
+};

package/dist/packages/threejs/src/hooks/useObb.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const o=require("three"),n=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/math/OBB.cjs"),b=[],u=new o.Color(16711680),O=()=>{const s=()=>{b.splice(0)},a=(t,e)=>{e.traverse(r=>{r&&i(t,r)})},i=(t,e)=>{if(e.userData.needCheck&&(e.autoUpdateMatrix=!1,e.updateMatrix(),e.updateMatrixWorld(),e.isMesh)){const r=new o.Box3(new o.Vector3).setFromObject(e);e.geometry.userData.obb=new n.OBB,e.geometry.userData.obb.halfSize.copy(r.getSize(new o.Vector3)).multiplyScalar(.5).multiplyScalar(.88),e.userData.obb=new n.OBB,e.userData.originColor=e.material.color.clone(),e.userData.parentUid=t,b.push({object:e,parentUid:t})}};return{resetObbs:s,initObb:a,getObbObjectByParentUid:t=>b.filter(e=>e.parentUid===t),addObbFromArray:(t,e)=>{for(let r=0,c=e.length;r<c;r++)i(t,e[r])},removeObbFromArray:t=>{const e=b.filter(r=>!t.includes(r.object));b.splice(0,b.length,...e)},removeUidObb:t=>{for(let e=b.length-1;e>=0;e--)b[e].parentUid===t&&b.splice(e,1)}}};exports.intersectColor=u;exports.obbObjects=b;exports.useObb=O;

package/dist/packages/threejs/src/hooks/useObb.js

@@ -0,0 +1,41 @@
+import { Color as O, Box3 as l, Vector3 as a } from "three";
+import { OBB as i } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/math/OBB.js";
+const o = [], m = new O(16711680), x = () => {
+  const n = () => {
+    o.splice(0);
+  }, s = (e, t) => {
+    t.traverse((r) => {
+      r && b(e, r);
+    });
+  }, b = (e, t) => {
+    if (t.userData.needCheck && (t.autoUpdateMatrix = !1, t.updateMatrix(), t.updateMatrixWorld(), t.isMesh)) {
+      const r = new l(new a()).setFromObject(t);
+      t.geometry.userData.obb = new i(), t.geometry.userData.obb.halfSize.copy(r.getSize(new a())).multiplyScalar(0.5).multiplyScalar(0.88), t.userData.obb = new i(), t.userData.originColor = t.material.color.clone(), t.userData.parentUid = e, o.push({
+        object: t,
+        parentUid: e
+      });
+    }
+  };
+  return {
+    resetObbs: n,
+    initObb: s,
+    getObbObjectByParentUid: (e) => o.filter((t) => t.parentUid === e),
+    addObbFromArray: (e, t) => {
+      for (let r = 0, c = t.length; r < c; r++)
+        b(e, t[r]);
+    },
+    removeObbFromArray: (e) => {
+      const t = o.filter((r) => !e.includes(r.object));
+      o.splice(0, o.length, ...t);
+    },
+    removeUidObb: (e) => {
+      for (let t = o.length - 1; t >= 0; t--)
+        o[t].parentUid === e && o.splice(t, 1);
+    }
+  };
+};
+export {
+  m as intersectColor,
+  o as obbObjects,
+  x as useObb
+};

package/dist/packages/threejs/src/hooks/useRaycaster.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const p=require("three"),x=(f="app")=>{const a=new p.Raycaster;a.params.Line.threshold=8;const i=new p.Vector2,y=document.getElementById(f);function l(t,e){const{scaleX:s,scaleY:o}=u(y),{clientWidth:c,clientHeight:r}=e,n=e.getBoundingClientRect(),m=c*s,d=r*o,h=t.clientX-n.left,w=t.clientY-n.top;return i.x=(t.clientX-n.left)/m*2-1,i.y=-((t.clientY-n.top)/d)*2+1,{pointer:i,x:h,y:w}}function g(t,e,s,o){const{pointer:c,x:r,y:n}=l(t,e);return a.setFromCamera(c,s),{intersects:a.intersectObjects(o),pointer:c,x:r,y:n}}function u(t){const e=window.getComputedStyle(t),s=e.transform||e.webkitTransform||e.mozTransform;if(s&&s!=="none"){const o=s.match(/^matrix\((.+)\)$/);if(o){const c=o[1].split(", "),r=parseFloat(c[0]),n=parseFloat(c[3]);return{scaleX:r,scaleY:n}}}return{scaleX:1,scaleY:1}}return{raycaster:a,pointer:i,getPointer:l,getScale:u,getIntersects:g}};exports.useRaycaster=x;

package/dist/packages/threejs/src/hooks/useRaycaster.js

@@ -0,0 +1,35 @@
+import { Raycaster as x, Vector2 as w } from "three";
+const Y = (u = "app") => {
+  const a = new x();
+  a.params.Line.threshold = 8;
+  const i = new w(), f = document.getElementById(u);
+  function l(t, e) {
+    const { scaleX: s, scaleY: o } = m(f), { clientWidth: c, clientHeight: r } = e, n = e.getBoundingClientRect(), p = c * s, y = r * o, d = t.clientX - n.left, h = t.clientY - n.top;
+    return i.x = (t.clientX - n.left) / p * 2 - 1, i.y = -((t.clientY - n.top) / y) * 2 + 1, { pointer: i, x: d, y: h };
+  }
+  function g(t, e, s, o) {
+    const { pointer: c, x: r, y: n } = l(t, e);
+    return a.setFromCamera(c, s), { intersects: a.intersectObjects(o), pointer: c, x: r, y: n };
+  }
+  function m(t) {
+    const e = window.getComputedStyle(t), s = e.transform || e.webkitTransform || e.mozTransform;
+    if (s && s !== "none") {
+      const o = s.match(/^matrix\((.+)\)$/);
+      if (o) {
+        const c = o[1].split(", "), r = parseFloat(c[0]), n = parseFloat(c[3]);
+        return { scaleX: r, scaleY: n };
+      }
+    }
+    return { scaleX: 1, scaleY: 1 };
+  }
+  return {
+    raycaster: a,
+    pointer: i,
+    getPointer: l,
+    getScale: m,
+    getIntersects: g
+  };
+};
+export {
+  Y as useRaycaster
+};

package/dist/packages/threejs/src/hooks/useThreeJs.cjs

@@ -0,0 +1,5 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const i=require("three"),u=require("vue"),W=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.cjs"),B=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.cjs"),G=require("../utils/helper.cjs"),N=require("../utils/disposeObject.cjs");require("../utils/PredictiveLoader.cjs");const Y={enableDamping:!0,dampingFactor:.25,screenSpacePanning:!1,minDistance:.1,maxDistance:1e3,maxPolarAngle:i.MathUtils.degToRad(60)};function K(k,F){typeof console<"u"&&console.warn&&console.warn(`[ThreeIns] useThreeJs() Hook 已弃用，建议使用 ThreeIns 类代替。
+旧用法: const { scene, camera } = useThreeJs(selector, options)
+新用法: const threeIns = new ThreeIns(selector, options)
+
+ThreeIns 类提供更完整的 API 和更好的性能。`);const a=Object.assign({css3d:!1,stats:!1,renderType:"change",control:{init:!0,options:{}}},F||{});let d,v,n,y=[];const T=u.ref(!1),p=u.shallowRef(),s=u.ref(0),r=u.ref(0),o=new i.WebGLRenderer({antialias:!0,alpha:!0,precision:"mediump",logarithmicDepthBuffer:!0}),h=new i.Scene({}),e=new i.PerspectiveCamera(50,1,.1,2e3),w=Math.tan(Math.PI/180*e.fov/2);let b=!1;o.setPixelRatio(window.devicePixelRatio);function S(){T.value=!1;const t=q();s.value=t[0],r.value=t[1],e.aspect=s.value/r.value,e.position.set(47,39,100),e.fov=360/Math.PI*Math.atan(w*(r.value/s.value)),e.lookAt(0,0,0),e.updateProjectionMatrix(),o.setSize(s.value,r.value),d.appendChild(o.domElement),a.stats&&L(),a.css3d&&_();let l;if(a.control&&a.control.init){l=G.createOrbitControl(e,o.domElement);const c=Object.assign(Y,a.control.options||{});Object.keys(c).forEach(x=>{l[x]=c[x]})}return u.nextTick(()=>T.value=!0),l}function A(t){t.preventDefault(),cancelAnimationFrame(g)}function R(t){t.preventDefault(),S(),g()}function j(t){y.push(t)}function g(t){y&&y.length&&y.forEach(l=>{typeof l=="function"&&l()}),a.renderType==="loop"&&E(),requestAnimationFrame(g)}function E(){b=!1,v&&v.update(),p.value&&p.value.update(),o.render(h,e),n&&n.render(h,e)}function I(){b||(b=!0,requestAnimationFrame(E))}function O(){u.nextTick(()=>{const t=q();s.value=t[0],r.value=t[1],e.aspect=s.value/r.value,e.fov=360/Math.PI*Math.atan(w*(r.value/s.value)),e.updateProjectionMatrix(),e.lookAt(h.position),o.setSize(s.value,r.value),n&&n.setSize(s.value,r.value),E()})}function q(){return d=document.querySelector(k),d?[d.clientWidth,d.clientHeight]:[0,0]}function L(){v=new W,v.dom.style.cssText="position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000",d.appendChild(v.dom)}function D(t,l,c,x,C){const M=new i.Box3().setFromObject(t),P=M.getSize(new i.Vector3).length(),m=M.getCenter(new i.Vector3);C&&m.add(C);const H=P*l*.5,J=i.MathUtils.degToRad(c.fov*.5),U=H/Math.tan(J),z=new i.Vector3().subVectors(c.position,m).multiply(new i.Vector3(1,1,1)).normalize().multiplyScalar(U).add(m),f={x:z.x,y:z.y,z:z.z,lookAt_x:m.x,lookAt_y:m.y,lookAt_z:m.z};return c.position.set(f.x,f.y,f.z),c.lookAt(f.lookAt_x,f.lookAt_y,f.lookAt_z),c.updateProjectionMatrix(),x.target.copy(m),x.update(),P}function _(){n=new B.CSS3DRenderer,n.setSize(s.value,r.value),n.domElement.style.position="absolute",n.domElement.style.top=0,n.domElement.style.left=0,n.domElement.style.pointerEvents="none",d.appendChild(n.domElement)}function V(){N.disposeThreeObject(h)}return u.onMounted(()=>{p.value=S(),window.addEventListener("resize",O,!1),o.domElement.addEventListener("webglcontextlost",A,!1),o.domElement.addEventListener("webglcontextrestored",R,!1),a.renderType==="loop"?requestAnimationFrame(g):a.renderType==="change"&&p.value&&p.value.addEventListener("change",I)}),u.onUnmounted(()=>{cancelAnimationFrame(g),o.domElement.removeEventListener("resize",O,!1),o.domElement.removeEventListener("webglcontextlost",A,!1),o.domElement.removeEventListener("webglcontextrestored",R,!1),V()}),{addAnimate:j,frameArea:D,onRender:E,css3dRenderer:n,scene:h,camera:e,control:p,renderer:o,domWidth:s,domHeight:r,isReady:T}}exports.useThreeJs=K;