@tonybfox/threejs-tools 1.0.4 → 1.0.6

package/dist/asset-loader/index.cjs

@@ -1,87 +1,10 @@
-"use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// packages/asset-loader/src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  AssetLoader: () => AssetLoader
-});
-module.exports = __toCommonJS(src_exports);
-
-// packages/asset-loader/src/AssetLoader.ts
-var THREE = __toESM(require("three"));
-var import_GLTFLoader = require("three/examples/jsm/loaders/GLTFLoader.js");
-var import_FBXLoader = require("three/examples/jsm/loaders/FBXLoader.js");
-var import_OBJLoader = require("three/examples/jsm/loaders/OBJLoader.js");
-var import_USDLoader = require("three/examples/jsm/loaders/USDLoader.js");
-var AssetLoader = class extends THREE.EventDispatcher {
-  constructor() {
-    super();
-    this.cache = /* @__PURE__ */ new Map();
-    this.placeholder = null;
-    this.loadedAsset = null;
-    this.lowResAsset = null;
-    this.errorColor = 16729156;
-    this.errorOpacity = 0.5;
-    this.gltfLoader = new import_GLTFLoader.GLTFLoader();
-    this.fbxLoader = new import_FBXLoader.FBXLoader();
-    this.objLoader = new import_OBJLoader.OBJLoader();
-    this.usdLoader = new import_USDLoader.USDLoader();
-  }
-  /**
-   * Create a placeholder cube with shader effect
-   */
-  createPlaceholder(size, color = 5227511, opacity = 0.3) {
-    const [width, height, depth] = size;
-    const geometry = new THREE.BoxGeometry(width, height, depth);
-    const material = new THREE.ShaderMaterial({
-      side: THREE.DoubleSide,
-      depthWrite: false,
-      blending: THREE.AdditiveBlending,
-      transparent: true,
-      uniforms: {
-        color: { value: new THREE.Color(color) },
-        opacity: { value: opacity },
-        fillProgress: { value: 0 },
-        time: { value: 0 },
-        isError: { value: 0 },
-        yMin: { value: -height / 2 },
-        yMax: { value: height / 2 }
-      },
-      vertexShader: `
+"use strict";var H=Object.create;var u=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var P=Object.getPrototypeOf,x=Object.prototype.hasOwnProperty;var D=(n,c)=>{for(var e in c)u(n,e,{get:c[e],enumerable:!0})},b=(n,c,e,t)=>{if(c&&typeof c=="object"||typeof c=="function")for(let a of O(c))!x.call(n,a)&&a!==e&&u(n,a,{get:()=>c[a],enumerable:!(t=M(c,a))||t.enumerable});return n};var B=(n,c,e)=>(e=n!=null?H(P(n)):{},b(c||!n||!n.__esModule?u(e,"default",{value:n,enumerable:!0}):e,n)),z=n=>b(u({},"__esModule",{value:!0}),n);var j={};D(j,{AssetLoader:()=>E});module.exports=z(j);var o=B(require("three")),y=require("three/examples/jsm/loaders/GLTFLoader.js"),v=require("three/examples/jsm/loaders/FBXLoader.js"),R=require("three/examples/jsm/loaders/OBJLoader.js"),L=require("three/examples/jsm/loaders/USDLoader.js"),T=require("three/examples/jsm/loaders/ColladaLoader.js"),g=require("three/examples/jsm/loaders/STLLoader.js"),C=require("three/examples/jsm/loaders/PLYLoader.js"),w=require("three/examples/jsm/loaders/3MFLoader.js"),E=class extends o.EventDispatcher{constructor(){super();this.cache=new Map;this.placeholder=null;this.loadedAsset=null;this.lowResAsset=null;this.errorColor=16729156;this.errorOpacity=.5;this.gltfLoader=new y.GLTFLoader,this.fbxLoader=new v.FBXLoader,this.objLoader=new R.OBJLoader,this.usdLoader=new L.USDLoader,this.colladaLoader=new T.ColladaLoader,this.stlLoader=new g.STLLoader,this.plyLoader=new C.PLYLoader,this.threeMFLoader=new w.ThreeMFLoader}createPlaceholder(e,t=5227511,a=.3){let[s,p,l]=e,h=new o.BoxGeometry(s,p,l),r=new o.ShaderMaterial({side:o.DoubleSide,depthWrite:!1,blending:o.AdditiveBlending,transparent:!0,uniforms:{color:{value:new o.Color(t)},opacity:{value:a},fillProgress:{value:0},time:{value:0},isError:{value:0},yMin:{value:-p/2},yMax:{value:p/2}},vertexShader:`
         varying vec3 vPosition;
         void main() {
           vPosition = position;
           gl_Position = projectionMatrix * modelViewMatrix * vec4(position, 1.0);
         }
-      `,
-      fragmentShader: `
+      `,fragmentShader:`
         uniform vec3 color;
         uniform float opacity;
         uniform float fillProgress;
@@ -118,279 +41,4 @@ var AssetLoader = class extends THREE.EventDispatcher {
           vec3 finalColor = color + edgeIntensity * 0.5;
           gl_FragColor = vec4(finalColor, alpha);
         }
-      `
-    });
-    const mesh = new THREE.Mesh(geometry, material);
-    this.positionAssetAtBottomCenter(mesh);
-    return mesh;
-  }
-  /**
-   * Update placeholder fill progress based on loading progress
-   */
-  updatePlaceholder(progress) {
-    if (this.placeholder && this.placeholder instanceof THREE.Mesh) {
-      const material = this.placeholder.material;
-      if (material.uniforms && material.uniforms.fillProgress) {
-        material.uniforms.fillProgress.value = progress;
-      }
-    }
-  }
-  /**
-   * Set placeholder to error state with configurable color and opacity
-   */
-  setPlaceholderError() {
-    if (this.placeholder && this.placeholder instanceof THREE.Mesh) {
-      const material = this.placeholder.material;
-      if (material.uniforms) {
-        if (material.uniforms.color) {
-          material.uniforms.color.value = new THREE.Color(this.errorColor);
-        }
-        if (material.uniforms.opacity) {
-          material.uniforms.opacity.value = this.errorOpacity;
-        }
-        if (material.uniforms.fillProgress) {
-          material.uniforms.fillProgress.value = 0;
-        }
-        if (material.uniforms.isError) {
-          material.uniforms.isError.value = 1;
-        }
-      }
-    }
-  }
-  /**
-   * Update placeholder animation time (call this in your render loop)
-   */
-  updatePlaceholderAnimation(deltaTime) {
-    if (this.placeholder && this.placeholder instanceof THREE.Mesh) {
-      const material = this.placeholder.material;
-      if (material.uniforms && material.uniforms.time) {
-        material.uniforms.time.value += deltaTime;
-      }
-    }
-  }
-  /**
-   * Reposition an asset so that its bottom-center sits at the local origin.
-   */
-  positionAssetAtBottomCenter(object) {
-    object.updateMatrixWorld(true);
-    const boundingBox = new THREE.Box3().setFromObject(object);
-    if (boundingBox.isEmpty()) {
-      return;
-    }
-    const center = boundingBox.getCenter(new THREE.Vector3());
-    const bottomCenter = new THREE.Vector3(
-      center.x,
-      boundingBox.min.y + 0.01,
-      center.z
-    );
-    if (!Number.isFinite(bottomCenter.x) || !Number.isFinite(bottomCenter.y) || !Number.isFinite(bottomCenter.z)) {
-      return;
-    }
-    object.position.sub(bottomCenter);
-    object.userData.bottomCenterOffset = bottomCenter;
-    object.updateMatrixWorld(true);
-  }
-  ensureBottomCenterOffset(object) {
-    const offset = object.userData.bottomCenterOffset;
-    if (offset instanceof THREE.Vector3) {
-      return offset;
-    }
-    if (offset && typeof offset === "object") {
-      const {
-        x = 0,
-        y = 0,
-        z = 0
-      } = offset;
-      const normalized = new THREE.Vector3(x ?? 0, y ?? 0, z ?? 0);
-      object.userData.bottomCenterOffset = normalized;
-      return normalized;
-    }
-    return null;
-  }
-  normalizeBottomCenterData(object) {
-    const hasOffset = this.ensureBottomCenterOffset(object) !== null;
-    object.children.forEach((child) => this.normalizeBottomCenterData(child));
-    return hasOffset;
-  }
-  /**
-   * Load an asset with the specified options
-   */
-  async load(options) {
-    const {
-      type,
-      url,
-      size,
-      lowResUrl,
-      enableCaching = true,
-      placeholderColor = 5227511,
-      placeholderOpacity = 0.4,
-      errorColor = 16729156,
-      errorOpacity = 0.5
-    } = options;
-    if (enableCaching && this.cache.has(url)) {
-      const cachedClone = this.cache.get(url).clone(true);
-      const hasOffset = this.normalizeBottomCenterData(cachedClone);
-      if (!hasOffset) {
-        this.positionAssetAtBottomCenter(cachedClone);
-      } else {
-        cachedClone.updateMatrixWorld(true);
-      }
-      this.loadedAsset = cachedClone;
-      this.dispatchEvent({ type: "loaded", asset: cachedClone });
-      return cachedClone;
-    }
-    this.errorColor = errorColor;
-    this.errorOpacity = errorOpacity;
-    if (size) {
-      this.placeholder = this.createPlaceholder(
-        size,
-        placeholderColor,
-        placeholderOpacity
-      );
-      this.dispatchEvent({
-        type: "placeholderCreated",
-        placeholder: this.placeholder
-      });
-    }
-    try {
-      if (lowResUrl) {
-        const lowRes = await this.loadModel(type, lowResUrl, true);
-        this.lowResAsset = lowRes;
-        this.dispatchEvent({ type: "lowResLoaded", lowRes });
-      }
-      const asset = await this.loadModel(type, url, false);
-      this.loadedAsset = asset;
-      if (enableCaching) {
-        const cacheEntry = asset.clone(true);
-        const hasOffset = this.normalizeBottomCenterData(cacheEntry);
-        if (!hasOffset) {
-          this.positionAssetAtBottomCenter(cacheEntry);
-        } else {
-          cacheEntry.updateMatrixWorld(true);
-        }
-        this.cache.set(url, cacheEntry);
-      }
-      this.dispatchEvent({ type: "loaded", asset });
-      return asset;
-    } catch (error) {
-      this.setPlaceholderError();
-      this.dispatchEvent({ type: "error", error });
-      throw error;
-    }
-  }
-  /**
-   * Load a model based on type
-   */
-  loadModel(type, url, isLowRes) {
-    return new Promise((resolve, reject) => {
-      const onProgress = (event) => {
-        let percentage = -1;
-        if (event.lengthComputable && event.total > 0 && event.loaded <= event.total) {
-          percentage = event.loaded / event.total * 100;
-        }
-        this.dispatchEvent({
-          type: "progress",
-          loaded: event.loaded,
-          total: event.total,
-          percentage
-        });
-        if (!isLowRes && percentage >= 0) {
-          this.updatePlaceholder(percentage / 100);
-        }
-      };
-      const onError = (error) => {
-        reject(error);
-      };
-      switch (type) {
-        case "gltf":
-          this.gltfLoader.load(
-            url,
-            (gltf) => {
-              const scene = gltf.scene;
-              this.positionAssetAtBottomCenter(scene);
-              resolve(scene);
-            },
-            onProgress,
-            onError
-          );
-          break;
-        case "fbx":
-          this.fbxLoader.load(
-            url,
-            (fbx) => {
-              this.positionAssetAtBottomCenter(fbx);
-              resolve(fbx);
-            },
-            onProgress,
-            onError
-          );
-          break;
-        case "obj":
-          this.objLoader.load(
-            url,
-            (obj) => {
-              this.positionAssetAtBottomCenter(obj);
-              resolve(obj);
-            },
-            onProgress,
-            onError
-          );
-          break;
-        case "usd":
-        case "usdz":
-          this.usdLoader.load(
-            url,
-            (usd) => {
-              this.positionAssetAtBottomCenter(usd);
-              resolve(usd);
-            },
-            onProgress,
-            onError
-          );
-          break;
-        default:
-          reject(new Error(`Unsupported asset type: ${type}`));
-      }
-    });
-  }
-  /**
-   * Get the placeholder object
-   */
-  getPlaceholder() {
-    return this.placeholder;
-  }
-  /**
-   * Get the loaded asset
-   */
-  getAsset() {
-    return this.loadedAsset;
-  }
-  /**
-   * Get the low-res asset
-   */
-  getLowResAsset() {
-    return this.lowResAsset;
-  }
-  /**
-   * Clear the cache
-   */
-  clearCache() {
-    this.cache.clear();
-  }
-  /**
-   * Remove an item from cache
-   */
-  removeFromCache(url) {
-    this.cache.delete(url);
-  }
-  /**
-   * Get cache size
-   */
-  getCacheSize() {
-    return this.cache.size;
-  }
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  AssetLoader
-});
+      `}),i=new o.Mesh(h,r);return this.positionAssetAtBottomCenter(i),i}updatePlaceholder(e){if(this.placeholder&&this.placeholder instanceof o.Mesh){let t=this.placeholder.material;t.uniforms&&t.uniforms.fillProgress&&(t.uniforms.fillProgress.value=e)}}setPlaceholderError(){if(this.placeholder&&this.placeholder instanceof o.Mesh){let e=this.placeholder.material;e.uniforms&&(e.uniforms.color&&(e.uniforms.color.value=new o.Color(this.errorColor)),e.uniforms.opacity&&(e.uniforms.opacity.value=this.errorOpacity),e.uniforms.fillProgress&&(e.uniforms.fillProgress.value=0),e.uniforms.isError&&(e.uniforms.isError.value=1))}}updatePlaceholderAnimation(e){if(this.placeholder&&this.placeholder instanceof o.Mesh){let t=this.placeholder.material;t.uniforms&&t.uniforms.time&&(t.uniforms.time.value+=e)}}positionAssetAtBottomCenter(e){e.updateMatrixWorld(!0);let t=new o.Box3().setFromObject(e);if(t.isEmpty())return;let a=t.getCenter(new o.Vector3),s=new o.Vector3(a.x,t.min.y-.01,a.z);!Number.isFinite(s.x)||!Number.isFinite(s.y)||!Number.isFinite(s.z)||(e.position.sub(s),e.userData.bottomCenterOffset=s,e.updateMatrixWorld(!0))}ensureBottomCenterOffset(e){let t=e.userData.bottomCenterOffset;if(t instanceof o.Vector3)return t;if(t&&typeof t=="object"){let{x:a=0,y:s=0,z:p=0}=t,l=new o.Vector3(a??0,s??0,p??0);return e.userData.bottomCenterOffset=l,l}return null}normalizeBottomCenterData(e){let t=this.ensureBottomCenterOffset(e)!==null;return e.children.forEach(a=>this.normalizeBottomCenterData(a)),t}async load(e){let{type:t,url:a,size:s,lowResUrl:p,enableCaching:l=!0,disablePlaceholder:h=!1,placeholderColor:r=5227511,placeholderOpacity:i=.4,errorColor:m=16729156,errorOpacity:A=.5}=e;if(l&&this.cache.has(a)){let d=this.cache.get(a).clone(!0);return this.normalizeBottomCenterData(d)?d.updateMatrixWorld(!0):this.positionAssetAtBottomCenter(d),this.loadedAsset=d,this.dispatchEvent({type:"loaded",asset:d}),d}this.errorColor=m,this.errorOpacity=A,s&&!h&&(this.placeholder=this.createPlaceholder(s,r,i),this.dispatchEvent({type:"placeholderCreated",placeholder:this.placeholder}));try{if(p){let f=await this.loadModel(t,p,!0);this.lowResAsset=f,this.dispatchEvent({type:"lowResLoaded",lowRes:f})}let d=await this.loadModel(t,a,!1);if(this.loadedAsset=d,l){let f=d.clone(!0);this.normalizeBottomCenterData(f)?f.updateMatrixWorld(!0):this.positionAssetAtBottomCenter(f),this.cache.set(a,f)}return this.dispatchEvent({type:"loaded",asset:d}),d}catch(d){throw this.setPlaceholderError(),this.dispatchEvent({type:"error",error:d}),d}}loadModel(e,t,a){return new Promise((s,p)=>{let l=r=>{let i=-1;r.lengthComputable&&r.total>0&&r.loaded<=r.total&&(i=r.loaded/r.total*100),this.dispatchEvent({type:"progress",loaded:r.loaded,total:r.total,percentage:i}),!a&&i>=0&&this.updatePlaceholder(i/100)},h=r=>{p(r)};switch(e){case"gltf":this.gltfLoader.load(t,r=>{let i=r.scene;this.positionAssetAtBottomCenter(i),s(i)},l,h);break;case"fbx":this.fbxLoader.load(t,r=>{this.positionAssetAtBottomCenter(r),s(r)},l,h);break;case"obj":this.objLoader.load(t,r=>{this.positionAssetAtBottomCenter(r),s(r)},l,h);break;case"usd":case"usdz":this.usdLoader.load(t,r=>{this.positionAssetAtBottomCenter(r),s(r)},l,h);break;case"dae":this.colladaLoader.load(t,r=>{let i=r.scene;this.positionAssetAtBottomCenter(i),s(i)},l,h);break;case"stl":this.stlLoader.load(t,r=>{let i=new o.MeshStandardMaterial({color:8947848}),m=new o.Mesh(r,i);this.positionAssetAtBottomCenter(m),s(m)},l,h);break;case"ply":this.plyLoader.load(t,r=>{let i=new o.MeshStandardMaterial({vertexColors:!0}),m=new o.Mesh(r,i);this.positionAssetAtBottomCenter(m),s(m)},l,h);break;case"3mf":this.threeMFLoader.load(t,r=>{this.positionAssetAtBottomCenter(r),s(r)},l,h);break;default:p(new Error(`Unsupported asset type: ${e}`))}})}getPlaceholder(){return this.placeholder}getAsset(){return this.loadedAsset}getLowResAsset(){return this.lowResAsset}clearCache(){this.cache.clear()}removeFromCache(e){this.cache.delete(e)}getCacheSize(){return this.cache.size}};0&&(module.exports={AssetLoader});

package/dist/asset-loader/index.d.mts

@@ -19,13 +19,14 @@ interface AssetLoaderEventMap {
         lowRes: THREE.Object3D;
     };
 }
-type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz';
+type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz' | 'dae' | 'stl' | 'ply' | '3mf';
 interface AssetLoaderOptions {
     type: AssetType;
     url: string;
     size?: [number, number, number];
     lowResUrl?: string;
     enableCaching?: boolean;
+    disablePlaceholder?: boolean;
     placeholderColor?: number;
     placeholderOpacity?: number;
     errorColor?: number;
@@ -37,6 +38,10 @@ declare class AssetLoader extends THREE.EventDispatcher<AssetLoaderEventMap> {
     private fbxLoader;
     private objLoader;
     private usdLoader;
+    private colladaLoader;
+    private stlLoader;
+    private plyLoader;
+    private threeMFLoader;
     private placeholder;
     private loadedAsset;
     private lowResAsset;

package/dist/asset-loader/index.d.ts

@@ -19,13 +19,14 @@ interface AssetLoaderEventMap {
         lowRes: THREE.Object3D;
     };
 }
-type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz';
+type AssetType = 'gltf' | 'fbx' | 'obj' | 'usd' | 'usdz' | 'dae' | 'stl' | 'ply' | '3mf';
 interface AssetLoaderOptions {
     type: AssetType;
     url: string;
     size?: [number, number, number];
     lowResUrl?: string;
     enableCaching?: boolean;
+    disablePlaceholder?: boolean;
     placeholderColor?: number;
     placeholderOpacity?: number;
     errorColor?: number;
@@ -37,6 +38,10 @@ declare class AssetLoader extends THREE.EventDispatcher<AssetLoaderEventMap> {
     private fbxLoader;
     private objLoader;
     private usdLoader;
+    private colladaLoader;
+    private stlLoader;
+    private plyLoader;
+    private threeMFLoader;
     private placeholder;
     private loadedAsset;
     private lowResAsset;

package/dist/asset-loader/index.mjs

@@ -1,6 +1 @@
-import {
-  AssetLoader
-} from "../chunk-27WUVRGX.mjs";
-export {
-  AssetLoader
-};
+import{a}from"../chunk-B75TYEOO.mjs";export{a as AssetLoader};