@ridp/threejs 1.4.1 → 1.4.3

package/dist/packages/threejs/src/utils/CacheMonitor.js

@@ -0,0 +1,125 @@
+class e {
+  constructor() {
+    this.stats = {
+      hits: 0,
+      // 缓存命中次数
+      misses: 0,
+      // 缓存未命中次数
+      totalLoadTime: 0,
+      // 总加载时间(ms)
+      cacheSaveTime: 0,
+      // 缓存保存时间(ms)
+      errors: 0
+      // 错误次数
+    }, this.loadHistory = [];
+  }
+  /**
+   * 记录缓存命中
+   * @param {number} loadTime - 加载耗时(ms)
+   */
+  recordHit(t) {
+    this.stats.hits++, this.stats.totalLoadTime += t, this._recordHistory("hit", t);
+  }
+  /**
+   * 记录缓存未命中
+   * @param {number} loadTime - 加载耗时(ms)
+   */
+  recordMiss(t) {
+    this.stats.misses++, this.stats.totalLoadTime += t, this._recordHistory("miss", t);
+  }
+  /**
+   * 记录缓存保存时间
+   * @param {number} saveTime - 保存耗时(ms)
+   */
+  recordCacheSave(t) {
+    this.stats.cacheSaveTime += t;
+  }
+  /**
+   * 记录错误
+   * @param {string} path - 模型路径
+   * @param {Error} error - 错误对象
+   */
+  recordError(t, s) {
+    this.stats.errors++, this._recordHistory("error", 0, { path: t, error: s.message });
+  }
+  /**
+   * 计算缓存命中率
+   * @returns {string} 命中率百分比字符串
+   */
+  getHitRate() {
+    const t = this.stats.hits + this.stats.misses;
+    return t > 0 ? (this.stats.hits / t * 100).toFixed(2) + "%" : "0%";
+  }
+  /**
+   * 计算平均加载时间
+   * @returns {string} 平均加载时间(含单位)
+   */
+  getAvgLoadTime() {
+    const t = this.stats.hits + this.stats.misses;
+    return t > 0 ? (this.stats.totalLoadTime / t).toFixed(2) + "ms" : "0ms";
+  }
+  /**
+   * 获取完整的统计数据
+   * @returns {Object} 统计数据对象
+   */
+  getStats() {
+    const t = this.stats.hits + this.stats.misses;
+    return {
+      命中率: this.getHitRate(),
+      平均加载时间: this.getAvgLoadTime(),
+      缓存命中数: this.stats.hits,
+      缓存未命中数: this.stats.misses,
+      总加载次数: t,
+      总加载时间: this.stats.totalLoadTime.toFixed(2) + "ms",
+      缓存保存时间: this.stats.cacheSaveTime.toFixed(2) + "ms",
+      错误次数: this.stats.errors
+    };
+  }
+  /**
+   * 获取最近N条加载历史
+   * @param {number} count - 获取条数,默认 10
+   * @returns {Array} 历史记录数组
+   */
+  getHistory(t = 10) {
+    return this.loadHistory.slice(-t);
+  }
+  /**
+   * 清空统计数据
+   */
+  reset() {
+    this.stats = {
+      hits: 0,
+      misses: 0,
+      totalLoadTime: 0,
+      cacheSaveTime: 0,
+      errors: 0
+    }, this.loadHistory = [];
+  }
+  /**
+   * 内部方法: 记录历史
+   * @private
+   */
+  _recordHistory(t, s, i = {}) {
+    this.loadHistory.push({
+      type: t,
+      duration: s,
+      timestamp: Date.now(),
+      ...i
+    }), this.loadHistory.length > 100 && this.loadHistory.shift();
+  }
+  /**
+   * 打印统计报告到控制台
+   */
+  logReport() {
+    console.group("📊 缓存性能报告");
+    const t = this.getStats();
+    Object.entries(t).forEach(([s, i]) => {
+      console.log(`${s}: ${i}`);
+    }), console.groupEnd();
+  }
+}
+const r = new e();
+export {
+  e as CacheMonitor,
+  r as cacheMonitor
+};

package/dist/packages/threejs/src/utils/ImageLoader.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const c=require("three"),d=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/EXRLoader.cjs"),u=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/RGBELoader.cjs"),i={};async function l(r,n){if(!n)return;if(i[n]){const e=i[n];r.environment=e;return}let o=t(n);return new Promise((e,a)=>{o.load(n,e,void 0,a)}).then(e=>{e.mapping=c.EquirectangularReflectionMapping,r.environment=e,i[n]=e}).catch(e=>{console.log("  =====> e:",e)})}async function s(r){let n=t(r);return new Promise((o,e)=>{n.load(r,o,void 0,e)})}function t(r){return r.split(".").pop()==="exr"?new d.EXRLoader:new u.RGBELoader}exports.ImageLoader=s;exports.initEnvImage=l;

package/dist/packages/threejs/src/utils/ImageLoader.js

@@ -0,0 +1,33 @@
+import { EquirectangularReflectionMapping as c } from "three";
+import { EXRLoader as d } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/EXRLoader.js";
+import { RGBELoader as m } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/loaders/RGBELoader.js";
+const i = {};
+async function s(o, n) {
+  if (!n) return;
+  if (i[n]) {
+    const e = i[n];
+    o.environment = e;
+    return;
+  }
+  let r = t(n);
+  return new Promise((e, a) => {
+    r.load(n, e, void 0, a);
+  }).then((e) => {
+    e.mapping = c, o.environment = e, i[n] = e;
+  }).catch((e) => {
+    console.log("  =====> e:", e);
+  });
+}
+async function g(o) {
+  let n = t(o);
+  return new Promise((r, e) => {
+    n.load(o, r, void 0, e);
+  });
+}
+function t(o) {
+  return o.split(".").pop() === "exr" ? new d() : new m();
+}
+export {
+  g as ImageLoader,
+  s as initEnvImage
+};

package/dist/packages/threejs/src/utils/PredictiveLoader.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("../hooks/useGLTFLoader.cjs");class c{constructor(e={}){this.options={maxPreloadCount:e.maxPreloadCount||5,preloadDelay:e.preloadDelay||1e3,enableLearning:e.enableLearning!==!1},this.loadHistory=new Map,this.loadSequence=[],this.associations=new Map,this.preloadQueue=new Set,this.isPreloading=!1,this.loader=null,this.getLoader=()=>(this.loader||(this.loader=d.useGLTFLoader()),this.loader)}recordLoad(e,s){const t=Date.now(),o=this.loadHistory.get(e)||{count:0,lastLoadTime:0,versions:new Set};o.count++,o.lastLoadTime=t,o.versions.add(s),this.loadHistory.set(e,o),this.loadSequence.push({path:e,timestamp:t}),this.loadSequence.length>100&&this.loadSequence.shift(),this.options.enableLearning&&this.loadSequence.length>=2&&this._learnAssociations(e),this._triggerPredictivePreload(e,s)}_learnAssociations(e){const t=this.loadSequence.length-1;for(let o=Math.max(0,t-10);o<t;o++){const{path:a}=this.loadSequence[o];if(this.loadSequence[t].timestamp-this.loadSequence[o].timestamp<5*60*1e3&&a!==e){this.associations.has(a)||this.associations.set(a,new Map);const i=this.associations.get(a),n=i.get(e)||0;i.set(e,n+1)}}}_triggerPredictivePreload(e,s){setTimeout(()=>{const t=this.predictNext(e);this.preload(t,s)},this.options.preloadDelay)}predictNext(e){const s=new Map,t=this.associations.get(e);t&&t.forEach((i,n)=>{s.set(n,(s.get(n)||0)+i*2)});const o=Array.from(this.loadHistory.values()).reduce((i,n)=>i+n.count,0)/(this.loadHistory.size||1);this.loadHistory.forEach((i,n)=>{if(n!==e){const l=i.count/o;s.set(n,(s.get(n)||0)+l)}});const a=this.loadSequence.slice(-10);return new Set(a.map(i=>i.path)).forEach(i=>{i!==e&&s.set(i,(s.get(i)||0)+.5)}),Array.from(s.entries()).sort((i,n)=>n[1]-i[1]).slice(0,this.options.maxPreloadCount).map(([i])=>i)}async preload(e,s="latest"){if(this.isPreloading)return;this.isPreloading=!0;const{asyncFetch:t}=this.getLoader(),o=e.filter(a=>!this.preloadQueue.has(a)).slice(0,this.options.maxPreloadCount).map(async a=>{this.preloadQueue.add(a);try{console.log(`[ 智能预加载 ] 开始预加载: ${a}`),await t(a,s),console.log(`[ 智能预加载 ] 完成: ${a}`)}catch(r){console.warn(`[ 智能预加载 ] 失败: ${a}`,r)}finally{this.preloadQueue.delete(a)}});await Promise.all(o),this.isPreloading=!1}addAssociation(e,s){this.associations.has(e)||this.associations.set(e,new Map);const t=this.associations.get(e);s.forEach(o=>{const a=t.get(o)||0;t.set(o,a+10)})}getStats(){const e=Array.from(this.loadHistory.entries()).sort((s,t)=>t[1].count-s[1].count).slice(0,10).map(([s,t])=>({path:s,loadCount:t.count,lastLoadTime:new Date(t.lastLoadTime).toLocaleString()}));return{totalModelsLoaded:this.loadHistory.size,totalAssociations:this.associations.size,topModels:e,preloadQueueSize:this.preloadQueue.size}}clearHistory(){this.loadHistory.clear(),this.loadSequence=[],this.associations.clear()}exportAssociations(){const e={};return this.associations.forEach((s,t)=>{e[t]=Array.from(s.entries())}),e}importAssociations(e){Object.entries(e).forEach(([s,t])=>{const o=new Map(t);this.associations.set(s,o)})}}const h=new c;exports.PredictiveLoader=c;exports.predictiveLoader=h;

package/dist/packages/threejs/src/utils/PredictiveLoader.js

@@ -0,0 +1,155 @@
+import { useGLTFLoader as l } from "../hooks/useGLTFLoader.js";
+class d {
+  constructor(e = {}) {
+    this.options = {
+      maxPreloadCount: e.maxPreloadCount || 5,
+      preloadDelay: e.preloadDelay || 1e3,
+      enableLearning: e.enableLearning !== !1
+    }, this.loadHistory = /* @__PURE__ */ new Map(), this.loadSequence = [], this.associations = /* @__PURE__ */ new Map(), this.preloadQueue = /* @__PURE__ */ new Set(), this.isPreloading = !1, this.loader = null, this.getLoader = () => (this.loader || (this.loader = l()), this.loader);
+  }
+  /**
+   * 记录模型加载
+   * @param {string} path - 模型路径
+   * @param {string} version - 模型版本
+   */
+  recordLoad(e, s) {
+    const t = Date.now(), o = this.loadHistory.get(e) || {
+      count: 0,
+      lastLoadTime: 0,
+      versions: /* @__PURE__ */ new Set()
+    };
+    o.count++, o.lastLoadTime = t, o.versions.add(s), this.loadHistory.set(e, o), this.loadSequence.push({ path: e, timestamp: t }), this.loadSequence.length > 100 && this.loadSequence.shift(), this.options.enableLearning && this.loadSequence.length >= 2 && this._learnAssociations(e), this._triggerPredictivePreload(e, s);
+  }
+  /**
+   * 学习模型关联规则
+   * @private
+   * @param {string} currentPath - 当前加载的模型
+   */
+  _learnAssociations(e) {
+    const t = this.loadSequence.length - 1;
+    for (let o = Math.max(0, t - 10); o < t; o++) {
+      const { path: a } = this.loadSequence[o];
+      if (this.loadSequence[t].timestamp - this.loadSequence[o].timestamp < 5 * 60 * 1e3 && a !== e) {
+        this.associations.has(a) || this.associations.set(a, /* @__PURE__ */ new Map());
+        const i = this.associations.get(a), n = i.get(e) || 0;
+        i.set(e, n + 1);
+      }
+    }
+  }
+  /**
+   * 触发预测性预加载
+   * @private
+   * @param {string} currentPath - 当前加载的模型
+   * @param {string} version - 模型版本
+   */
+  _triggerPredictivePreload(e, s) {
+    setTimeout(() => {
+      const t = this.predictNext(e);
+      this.preload(t, s);
+    }, this.options.preloadDelay);
+  }
+  /**
+   * 预测下一个可能加载的模型
+   * @param {string} currentPath - 当前模型路径
+   * @returns {Array<string>} 预测的模型路径列表
+   */
+  predictNext(e) {
+    const s = /* @__PURE__ */ new Map(), t = this.associations.get(e);
+    t && t.forEach((i, n) => {
+      s.set(n, (s.get(n) || 0) + i * 2);
+    });
+    const o = Array.from(this.loadHistory.values()).reduce((i, n) => i + n.count, 0) / (this.loadHistory.size || 1);
+    this.loadHistory.forEach((i, n) => {
+      if (n !== e) {
+        const c = i.count / o;
+        s.set(n, (s.get(n) || 0) + c);
+      }
+    });
+    const a = this.loadSequence.slice(-10);
+    return new Set(a.map((i) => i.path)).forEach((i) => {
+      i !== e && s.set(i, (s.get(i) || 0) + 0.5);
+    }), Array.from(s.entries()).sort((i, n) => n[1] - i[1]).slice(0, this.options.maxPreloadCount).map(([i]) => i);
+  }
+  /**
+   * 预加载模型列表
+   * @param {Array<string>} paths - 模型路径列表
+   * @param {string} version - 模型版本
+   */
+  async preload(e, s = "latest") {
+    if (this.isPreloading)
+      return;
+    this.isPreloading = !0;
+    const { asyncFetch: t } = this.getLoader(), o = e.filter((a) => !this.preloadQueue.has(a)).slice(0, this.options.maxPreloadCount).map(async (a) => {
+      this.preloadQueue.add(a);
+      try {
+        console.log(`[ 智能预加载 ] 开始预加载: ${a}`), await t(a, s), console.log(`[ 智能预加载 ] 完成: ${a}`);
+      } catch (r) {
+        console.warn(`[ 智能预加载 ] 失败: ${a}`, r);
+      } finally {
+        this.preloadQueue.delete(a);
+      }
+    });
+    await Promise.all(o), this.isPreloading = !1;
+  }
+  /**
+   * 手动添加关联规则
+   * @param {string} fromPath - 源模型路径
+   * @param {Array<string>} toPaths - 关联的模型路径列表
+   */
+  addAssociation(e, s) {
+    this.associations.has(e) || this.associations.set(e, /* @__PURE__ */ new Map());
+    const t = this.associations.get(e);
+    s.forEach((o) => {
+      const a = t.get(o) || 0;
+      t.set(o, a + 10);
+    });
+  }
+  /**
+   * 获取加载统计信息
+   * @returns {Object} 统计数据
+   */
+  getStats() {
+    const e = Array.from(this.loadHistory.entries()).sort((s, t) => t[1].count - s[1].count).slice(0, 10).map(([s, t]) => ({
+      path: s,
+      loadCount: t.count,
+      lastLoadTime: new Date(t.lastLoadTime).toLocaleString()
+    }));
+    return {
+      totalModelsLoaded: this.loadHistory.size,
+      totalAssociations: this.associations.size,
+      topModels: e,
+      preloadQueueSize: this.preloadQueue.size
+    };
+  }
+  /**
+   * 清空历史记录
+   */
+  clearHistory() {
+    this.loadHistory.clear(), this.loadSequence = [], this.associations.clear();
+  }
+  /**
+   * 导出关联规则(可持久化)
+   * @returns {Object} 关联规则数据
+   */
+  exportAssociations() {
+    const e = {};
+    return this.associations.forEach((s, t) => {
+      e[t] = Array.from(s.entries());
+    }), e;
+  }
+  /**
+   * 导入关联规则
+   * @param {Object} data - 关联规则数据
+   */
+  importAssociations(e) {
+    Object.entries(e).forEach(([s, t]) => {
+      const o = new Map(t);
+      this.associations.set(s, o);
+    });
+  }
+}
+const g = new d();
+export {
+  d as PredictiveLoader,
+  g as predictiveLoader
+};

package/dist/packages/threejs/src/utils/RetryHelper.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});class l{static async retry(t,e={}){const{maxRetries:r=3,initialDelay:s=1e3,maxDelay:m=1e4,backoffFactor:y=2,shouldRetry:E=l.defaultShouldRetry}=e;let u,i=s;for(let a=0;a<=r;a++)try{return await t()}catch(n){if(u=n,a===r||!E(n,a))throw n;console.warn(`[ RetryHelper ] 操作失败,第 ${a+1} 次尝试失败,${i}ms 后进行第 ${a+2} 次尝试...`,n),await l.delay(i),i=Math.min(i*y,m)}throw u}static defaultShouldRetry(t,e){if(t.name==="TypeError"&&t.message.includes("fetch"))return!0;if(t.message.includes("HTTP error")){const r=t.message.match(/status:\s*(\d+)/);if(r){const s=parseInt(r[1],10);return s>=500||s===429||s===408}}return!1}static delay(t){return new Promise(e=>setTimeout(e,t))}}const c={NETWORK:"NETWORK",PARSE:"PARSE",VERSION_MISMATCH:"VERSION",UNKNOWN:"UNKNOWN"};class o extends Error{constructor(t,e,r,s){super(t),this.name="ModelLoadError",this.type=e,this.path=r,this.originalError=s,this.timestamp=Date.now()}static networkError(t,e){return new o(`网络加载失败: ${t}`,c.NETWORK,t,e)}static parseError(t,e){return new o(`模型解析失败: ${t}`,c.PARSE,t,e)}static versionMismatchError(t,e,r){return new o(`版本不匹配: ${t} (期望: ${e}, 实际: ${r})`,c.VERSION_MISMATCH,t)}}exports.ErrorType=c;exports.ModelLoadError=o;exports.RetryHelper=l;

package/dist/packages/threejs/src/utils/RetryHelper.js

@@ -0,0 +1,108 @@
+class u {
+  /**
+   * 异步操作并支持重试
+   * @param {Function} operation - 要执行的异步操作
+   * @param {RetryOptions} options - 重试配置
+   * @returns {Promise} 操作结果
+   */
+  static async retry(t, e = {}) {
+    const {
+      maxRetries: r = 3,
+      initialDelay: s = 1e3,
+      maxDelay: m = 1e4,
+      backoffFactor: E = 2,
+      shouldRetry: h = u.defaultShouldRetry
+    } = e;
+    let l, i = s;
+    for (let a = 0; a <= r; a++)
+      try {
+        return await t();
+      } catch (n) {
+        if (l = n, a === r || !h(n, a))
+          throw n;
+        console.warn(
+          `[ RetryHelper ] 操作失败,第 ${a + 1} 次尝试失败,${i}ms 后进行第 ${a + 2} 次尝试...`,
+          n
+        ), await u.delay(i), i = Math.min(i * E, m);
+      }
+    throw l;
+  }
+  /**
+   * 默认的重试判断逻辑
+   * @param {Error} error - 错误对象
+   * @param {number} attempt - 当前尝试次数
+   * @returns {boolean} 是否应该重试
+   */
+  static defaultShouldRetry(t, e) {
+    if (t.name === "TypeError" && t.message.includes("fetch"))
+      return !0;
+    if (t.message.includes("HTTP error")) {
+      const r = t.message.match(/status:\s*(\d+)/);
+      if (r) {
+        const s = parseInt(r[1], 10);
+        return s >= 500 || s === 429 || s === 408;
+      }
+    }
+    return !1;
+  }
+  /**
+   * 延迟指定时间
+   * @param {number} ms - 延迟毫秒数
+   * @returns {Promise}
+   */
+  static delay(t) {
+    return new Promise((e) => setTimeout(e, t));
+  }
+}
+const c = {
+  NETWORK: "NETWORK",
+  // 网络错误
+  PARSE: "PARSE",
+  // 解析错误
+  VERSION_MISMATCH: "VERSION",
+  // 版本不匹配
+  UNKNOWN: "UNKNOWN"
+  // 未知错误
+};
+class o extends Error {
+  constructor(t, e, r, s) {
+    super(t), this.name = "ModelLoadError", this.type = e, this.path = r, this.originalError = s, this.timestamp = Date.now();
+  }
+  /**
+   * 创建网络错误
+   */
+  static networkError(t, e) {
+    return new o(
+      `网络加载失败: ${t}`,
+      c.NETWORK,
+      t,
+      e
+    );
+  }
+  /**
+   * 创建解析错误
+   */
+  static parseError(t, e) {
+    return new o(
+      `模型解析失败: ${t}`,
+      c.PARSE,
+      t,
+      e
+    );
+  }
+  /**
+   * 创建版本不匹配错误
+   */
+  static versionMismatchError(t, e, r) {
+    return new o(
+      `版本不匹配: ${t} (期望: ${e}, 实际: ${r})`,
+      c.VERSION_MISMATCH,
+      t
+    );
+  }
+}
+export {
+  c as ErrorType,
+  o as ModelLoadError,
+  u as RetryHelper
+};

package/dist/packages/threejs/src/utils/common.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=(u,i)=>{const t={};u.forEach(n=>{let e=n.parent;for(;e;)t[e.uuid]?t[e.uuid]++:t[e.uuid]=1,e=e.parent});let o=null,r=0;for(const n in t)t[n]>r&&(r=t[n],o=i.getObjectByProperty("uuid",n));return o};exports.getCommonParent=a;

package/dist/packages/threejs/src/utils/common.js

@@ -0,0 +1,15 @@
+const a = (r, i) => {
+  const t = {};
+  r.forEach((n) => {
+    let e = n.parent;
+    for (; e; )
+      t[e.uuid] ? t[e.uuid]++ : t[e.uuid] = 1, e = e.parent;
+  });
+  let u = null, o = 0;
+  for (const n in t)
+    t[n] > o && (o = t[n], u = i.getObjectByProperty("uuid", n));
+  return u;
+};
+export {
+  a as getCommonParent
+};

package/dist/packages/threejs/src/utils/css3dHelper.cjs

@@ -0,0 +1,15 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.cjs");function s(n,e=[.3,.3,.3]){const t=document.querySelector(`#${n}`);if(!t){console.log(" 获取 infoPlane 元素失败 (id) =====> :",n);return}const r=t.cloneNode(!0);r.style.display="block";const o=new l.CSS3DSprite(r);return o.visible=!1,o.scale.set(...e),o}function c(n,e){const t=a(n);t.style.display="block";const r=new l.CSS3DSprite(t);return r.visible=!1,r.scale.set(e,e,e),r}const a=n=>{const e=document.createElement("div");e.style.cssText=`
+    border-radius: 50px;
+    border: 2px solid rgba(255, 255, 255, 0.5);
+    background-color: rgba(15, 20, 22, 0.562);
+    justify-content: flex-start;
+    align-items: center;
+    padding: 20px 30px;
+    display: flex;
+    transform-origin: center 0;`;const t=document.createElement("span");return t.style.cssText=`
+      font-size: 40px;
+      line-height: 1;
+      white-space: nowrap;
+      color: #fff;
+      font-weight: 700;
+    `,t.innerText=n,e.appendChild(t),e};exports.createInfoPlane=s;exports.createTagPlane=c;

package/dist/packages/threejs/src/utils/css3dHelper.js

@@ -0,0 +1,42 @@
+import { CSS3DSprite as r } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/renderers/CSS3DRenderer.js";
+function a(n, e = [0.3, 0.3, 0.3]) {
+  const t = document.querySelector(`#${n}`);
+  if (!t) {
+    console.log(" 获取 infoPlane 元素失败 (id) =====> :", n);
+    return;
+  }
+  const o = t.cloneNode(!0);
+  o.style.display = "block";
+  const l = new r(o);
+  return l.visible = !1, l.scale.set(...e), l;
+}
+function i(n, e) {
+  const t = s(n);
+  t.style.display = "block";
+  const o = new r(t);
+  return o.visible = !1, o.scale.set(e, e, e), o;
+}
+const s = (n) => {
+  const e = document.createElement("div");
+  e.style.cssText = `
+    border-radius: 50px;
+    border: 2px solid rgba(255, 255, 255, 0.5);
+    background-color: rgba(15, 20, 22, 0.562);
+    justify-content: flex-start;
+    align-items: center;
+    padding: 20px 30px;
+    display: flex;
+    transform-origin: center 0;`;
+  const t = document.createElement("span");
+  return t.style.cssText = `
+      font-size: 40px;
+      line-height: 1;
+      white-space: nowrap;
+      color: #fff;
+      font-weight: 700;
+    `, t.innerText = n, e.appendChild(t), e;
+};
+export {
+  a as createInfoPlane,
+  i as createTagPlane
+};

package/dist/packages/threejs/src/utils/disposeObject.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const s=e=>{e.geometry&&e.geometry.dispose(),e.material&&(Array.isArray(e.material)?e.material.forEach(i=>{r(i)}):r(e.material)),e.children&&e.children.forEach(i=>s(i))};function r(e){for(const i in e)e[i]&&e[i].isTexture&&e[i].dispose();e.dispose()}exports.disposeThreeObject=s;

package/dist/packages/threejs/src/utils/disposeObject.js

@@ -0,0 +1,13 @@
+const e = (i) => {
+  i.geometry && i.geometry.dispose(), i.material && (Array.isArray(i.material) ? i.material.forEach((r) => {
+    s(r);
+  }) : s(i.material)), i.children && i.children.forEach((r) => e(r));
+};
+function s(i) {
+  for (const r in i)
+    i[r] && i[r].isTexture && i[r].dispose();
+  i.dispose();
+}
+export {
+  e as disposeThreeObject
+};

package/dist/packages/threejs/src/utils/helper.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("three"),c=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/controls/OrbitControls.cjs"),a=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/controls/MapControls.cjs"),s=require("../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.cjs");function l(e){return new t.CameraHelper(e)}function i(e=150,...r){return new t.GridHelper(e,e/10,...r)}function u(e){return new t.BoxHelper(e,16776960)}function p(e,r){return new c.OrbitControls(e,r)}function f(e,r){return new a.MapControls(e,r)}function H(){const e=new t.Raycaster,r=new t.Vector2(0,0);return{raycaster:e,pointer:r}}function w(e=10){return new t.AxesHelper(e)}function C(e=new t.Vector3(1,1,1),r=new t.Vector3(10,10,10),n=5,o=16776960){return e.normalize(),new t.ArrowHelper(e,r,n,o)}function x(){const e=new s;return e.dom.style.cssText="position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000",e}exports.createArrowHelper=C;exports.createAxesHelper=w;exports.createBox3Helper=u;exports.createCameraHelper=l;exports.createGridHelper=i;exports.createMapControls=f;exports.createOrbitControl=p;exports.createRaycaster=H;exports.createStats=x;

package/dist/packages/threejs/src/utils/helper.js

@@ -0,0 +1,47 @@
+import { Vector3 as t, CameraHelper as c, GridHelper as a, BoxHelper as f, Raycaster as i, Vector2 as p, AxesHelper as s, ArrowHelper as u } from "three";
+import { OrbitControls as l } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/controls/OrbitControls.js";
+import { MapControls as w } from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/controls/MapControls.js";
+import m from "../../../../node_modules/.pnpm/three@0.178.0/node_modules/three/examples/jsm/libs/stats.module.js";
+function A(e) {
+  return new c(e);
+}
+function b(e = 150, ...r) {
+  return new a(e, e / 10, ...r);
+}
+function d(e) {
+  return new f(e, 16776960);
+}
+function B(e, r) {
+  return new l(e, r);
+}
+function G(e, r) {
+  return new w(e, r);
+}
+function M() {
+  const e = new i(), r = new p(0, 0);
+  return {
+    raycaster: e,
+    pointer: r
+  };
+}
+function O(e = 10) {
+  return new s(e);
+}
+function R(e = new t(1, 1, 1), r = new t(10, 10, 10), n = 5, o = 16776960) {
+  return e.normalize(), new u(e, r, n, o);
+}
+function S() {
+  const e = new m();
+  return e.dom.style.cssText = "position:absolute;top:0;left:0;cursor:pointer;opacity:0.9;z-index:10000", e;
+}
+export {
+  R as createArrowHelper,
+  O as createAxesHelper,
+  d as createBox3Helper,
+  A as createCameraHelper,
+  b as createGridHelper,
+  G as createMapControls,
+  B as createOrbitControl,
+  M as createRaycaster,
+  S as createStats
+};

package/dist/packages/threejs/src/utils/modelSerialize.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const D=require("three");function d(e){const n=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(e){for(const t in e)if(t!=="default"){const a=Object.getOwnPropertyDescriptor(e,t);Object.defineProperty(n,t,a.get?a:{enumerable:!0,get:()=>e[t]})}}return n.default=e,Object.freeze(n)}const l=d(D),h={};async function A(e,n=50){const t={type:e.type,name:e.name,position:e.position.toArray(),rotation:e.rotation.toArray(),scale:e.scale.toArray(),visible:e.visible,children:[],geometry:null,material:null,userData:e.userData};e.isMesh&&(t.geometry=y(e.geometry),t.material=m(e.material));const a=[{object:e,parentData:t}];let s=0;for(;a.length>0;){const{object:r,parentData:i}=a.pop();for(const o of r.children){const c={type:o.type,name:o.name,position:o.position.toArray(),rotation:o.rotation.toArray(),scale:o.scale.toArray(),visible:o.visible,children:[],geometry:null,material:null,userData:o.userData};o.isMesh&&(c.geometry=y(o.geometry),c.material=m(o.material)),i.children.push(c),a.push({object:o,parentData:c}),s++,s%n===0&&await new Promise(p=>requestAnimationFrame(p))}}return t}function g(e){const n={type:e.type,name:e.name,position:e.position.toArray(),rotation:e.rotation.toArray(),scale:e.scale.toArray(),visible:e.visible,children:[],geometry:null,material:null,userData:e.userData};e.isMesh&&(n.geometry=y(e.geometry),n.material=m(e.material));const t=[{object:e,parentData:n}];for(;t.length>0;){const{object:a,parentData:s}=t.pop();for(const r of a.children){const i={type:r.type,name:r.name,position:r.position.toArray(),rotation:r.rotation.toArray(),scale:r.scale.toArray(),visible:r.visible,children:[],geometry:null,material:null,userData:r.userData};r.isMesh&&(i.geometry=y(r.geometry),i.material=m(r.material)),s.children.push(i),t.push({object:r,parentData:i})}}return n}async function w(e,n=50){const t=[];let a;switch(e.type){case"Mesh":const r=u(e.geometry),i=f(e.material);a=new l.Mesh(r,i);break;case"Group":a=new l.Group;break;case"Object3D":a=new l.Object3D;break;default:return console.warn(`Unsupported object type: ${e.type}`),null}a.name=e.name,a.position.fromArray(e.position),a.rotation.fromArray(e.rotation),a.scale.fromArray(e.scale),a.visible=e.visible,a.userData=e.userData,t.push({data:e,object:a});let s=0;for(;t.length>0;){const{data:r,object:i}=t.pop();for(const o of[...r.children].reverse()){let c;switch(o.type){case"Mesh":const p=u(o.geometry),b=f(o.material);c=new l.Mesh(p,b);break;case"Group":c=new l.Group;break;case"Object3D":c=new l.Object3D;break;default:console.warn(`Unsupported object type: ${o.type}`);continue}c&&(c.name=o.name,c.position.fromArray(o.position),c.rotation.fromArray(o.rotation),c.scale.fromArray(o.scale),c.visible=o.visible,c.userData=o.userData,i.add(c),t.push({data:o,object:c}),s++,s%n===0&&await new Promise(p=>requestAnimationFrame(p)))}}return a}function O(e){const n=[];let t;switch(e.type){case"Mesh":const a=u(e.geometry),s=f(e.material);t=new l.Mesh(a,s);break;case"Group":t=new l.Group;break;case"Object3D":t=new l.Object3D;break;default:return console.warn(`Unsupported object type: ${e.type}`),null}for(t.name=e.name,t.position.fromArray(e.position),t.rotation.fromArray(e.rotation),t.scale.fromArray(e.scale),t.visible=e.visible,t.userData=e.userData,n.push({data:e,object:t});n.length>0;){const{data:a,object:s}=n.pop();for(const r of[...a.children].reverse()){let i;switch(r.type){case"Mesh":const o=u(r.geometry),c=f(r.material);i=new l.Mesh(o,c);break;case"Group":i=new l.Group;break;case"Object3D":i=new l.Object3D;break;default:console.warn(`Unsupported object type: ${r.type}`);continue}i&&(i.name=r.name,i.position.fromArray(r.position),i.rotation.fromArray(r.rotation),i.scale.fromArray(r.scale),i.visible=r.visible,i.userData=r.userData,s.add(i),n.push({data:r,object:i}))}}return t}function y(e){const n={},{attributes:t,index:a,type:s}=e;t.position&&(n.position={type:"Float32Array",array:Array.from(t.position.array),itemSize:3}),t.normal&&(n.normal={type:"Float32Array",array:Array.from(t.normal.array),itemSize:3}),t.uv&&(n.uv={type:"Float32Array",array:Array.from(t.uv.array),itemSize:2});const r={type:s,attributes:n};return a&&a.array&&(r.index={type:"Uint32Array",array:Array.from(a.array),itemSize:1}),r}function u(e){const{type:n,attributes:t,index:a}=e,s=new l.BufferGeometry;for(const r in t)if(t.hasOwnProperty(r)){const{type:i,array:o,itemSize:c}=t[r];s.setAttribute(r,new l.BufferAttribute(new Float32Array(o),c))}return a&&s.setIndex(a.array),s}function m(e){return{type:e.type,color:e.color.getHex(),map:e.map?e.map.image.src:null,opacity:e.opacity,name:e.name,depthTest:e.depthTest,depthWrite:e.depthWrite,transparent:e.transparent,side:e.side,roughness:e.roughness,metalness:e.metalness,emissive:e.emissive.getHex()}}function f(e){if(h[e.name])return h[e.name];const{type:n,...t}=e,a=n||"MeshStandardMaterial",s=new l[a]({...t});if(e.map){const r=new l.TextureLoader().load(e.map);s.map=r}return s.needsUpdate=!0,h[e.name]=s,s}exports.dataToObject3D=w;exports.dataToObject3DSync=O;exports.object3DToData=A;exports.object3DToDataSync=g;