@needle-tools/engine 4.4.0-alpha.3 → 4.4.0-alpha.5

package/CHANGELOG.md

@@ -4,9 +4,30 @@ All notable changes to this package will be documented in this file.
 The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
-## [4.4.0-alpha.3] - 2025-03-21
+## [4.4.0-alpha.5] - 2025-03-27
 - Add: `ObjectUtils.createPrimitive()` now supports scale as array   
     e.g. `ObjectUtils.createPrimitive("Cube", { scale: [1, .25, 1] } );`
+- Add: Input `getGamepad(<index>)` function to query a connected gamepad. Example: `this.context.input.getGamepad()`
+- Add: `lookAtScreenPoint()` function which allows 3D object to look at points in 2D screen coordinates (e.g. your mouse position).    
+    **Example Component that makes the object look at the mouse**
+    ```ts
+    import { Behaviour, lookAtScreenPoint } from "@needle-tools/engine";
+
+    export class LookAtMouse extends Behaviour {
+      update() {
+        lookAtScreenPoint(this.gameObject, this.context.input.mousePosition, this.context.mainCamera);
+      }
+    }
+    ```
+- Add: SyncedTransform does now also sync scale changes
+- Add: Default environment lighting. If you don't configure any environment-image needle engine will now create a default scene to light your objects. Previously the scene was just black when the loaded model didn't contain any lighting information.
+- Add: The `contactshadows` attribute now allows you to specify a factor for controlling the darkness/lightness. E.g. `<needle-engine contactshadows="1">` will make the shadows appear darker vs. `<needle-engine contactshadows=".2">` will make the contact shadow appear lighter.
+- Fix: Implicit camera did not automatically set to skybox when using `background-image`. E.g. `<needle-engine background-image="<url>"> 
+- Fix: Tonemapping falsely set tonemappingEsposure to undefined causing a black screen
+- Fix: `background-color` attribute was not always applied. E.g. `<needle-engine background-color="#ff3333">`
+- Change: License check aborts now faster instead of retrying when connection is actively refused
+- Change: OrbitControls `autoTarget` does now automatically update the look at target after panning and not when rotating the camera (previously the target would be updated after any input but this resultet in undesireable behaviour when rotating around objects)
+- Change: When no background-color is defined by either the loaded scene or by a `background-color` attribute then the default scene background color respects the user's accessibility setting for `prefer-dark` or `prefer-light`. This means that the background color will be set to a default light or dark value.
 
 ## [4.3.2] - 2025-03-20
 #### Added

package/dist/gltf-progressive.js

@@ -1,5 +1,5 @@
-import { B as he, M as Q, T as ee, a as ze, V as z, b as be, S as Ve, c as Te, d as Ke, C as Xe } from "./three.js";
-import { D as qe, K as Ye, G as Se, M as He } from "./three-examples.js";
+import { BufferGeometry as he, Mesh as Q, Texture as ee, TextureLoader as ze, Vector3 as z, Matrix4 as be, Sphere as Ve, Box3 as Ee, MeshStandardMaterial as Xe, Clock as qe } from "./three.js";
+import { DRACOLoader as Ke, KTX2Loader as Ye, GLTFLoader as Se, MeshoptDecoder as He } from "./three-examples.js";
 const Je = "";
 globalThis.GLTF_PROGRESSIVE_VERSION = Je;
 console.debug("[gltf-progressive] version -");
@@ -25,7 +25,7 @@ function et(t) {
 const De = Symbol("dracoDecoderPath");
 let A, ge, G;
 function Be() {
-  A || (A = new qe(), A[De] = N, A.setDecoderPath(N), A.setDecoderConfig({ type: "js" }), A.preload()), G || (G = new Ye(), G.setTranscoderPath(j), G.init()), ge || (ge = He);
+  A || (A = new Ke(), A[De] = N, A.setDecoderPath(N), A.setDecoderConfig({ type: "js" }), A.preload()), G || (G = new Ye(), G.setTranscoderPath(j), G.init()), ge || (ge = He);
 }
 function Re(t) {
   return Be(), t ? G.detectSupport(t) : t !== null && console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures might fail"), { dracoLoader: A, ktx2Loader: G, meshoptDecoder: ge };
@@ -127,7 +127,7 @@ if (p) {
     }));
   });
 }
-function Ee(t, e, s) {
+function Te(t, e, s) {
   var i;
   if (!p)
     return;
@@ -259,7 +259,7 @@ const M = class {
           const o = i.index || 0;
           r = r[o];
         }
-        return t["LOD:requested level"] === e && (delete t["LOD:requested level"], r && n != r && ((r == null ? void 0 : r.isBufferGeometry) ? (t.geometry = r, p && Ee(t, "geometry", i.url)) : p && console.error("Invalid LOD geometry", r))), r;
+        return t["LOD:requested level"] === e && (delete t["LOD:requested level"], r && n != r && ((r == null ? void 0 : r.isBufferGeometry) ? (t.geometry = r, p && Te(t, "geometry", i.url)) : p && console.error("Invalid LOD geometry", r))), r;
       }).catch((r) => (console.error("Error loading mesh LOD", t, r), null));
     } else
       p && console.error("Invalid call to assignMeshLOD: Request mesh LOD but the object is not a mesh", t);
@@ -336,7 +336,7 @@ const M = class {
           }
           if (p && n && s) {
             const r = this.getAssignedLODInformation(t);
-            r ? Ee(s, n, r.url) : console.warn("No LOD info for texture", t);
+            r ? Te(s, n, r.url) : console.warn("No LOD info for texture", t);
           }
         }
         return i;
@@ -422,16 +422,16 @@ const M = class {
             const O = D.lods[e];
             O.hash && (B += "?v=" + O.hash);
           }
-          const T = await $.loadAsync(B).catch((O) => (console.error(`Error loading LOD ${e} from ${h}
+          const E = await $.loadAsync(B).catch((O) => (console.error(`Error loading LOD ${e} from ${h}
 `, O), null));
-          if (!T)
+          if (!E)
             return null;
-          const U = T.parser;
+          const U = E.parser;
           s && console.log("Loading finished " + h, D.guid);
           let v = 0;
-          if (T.parser.json.textures) {
+          if (E.parser.json.textures) {
             let O = !1;
-            for (const u of T.parser.json.textures) {
+            for (const u of E.parser.json.textures) {
               if (u != null && u.extensions) {
                 const g = u == null ? void 0 : u.extensions[W];
                 if (g != null && g.guid && g.guid === D.guid) {
@@ -445,11 +445,11 @@ const M = class {
               let u = await U.getDependency("texture", v);
               return u && M.assignLODInformation(n.url, u, i, e, void 0, void 0), s && console.log('change "' + t.name + '" → "' + u.name + '"', h, v, u, x), t instanceof ee && (u = this.copySettings(t, u)), u && (u.guid = D.guid), f(u);
             } else
-              p && console.warn("Could not find texture with guid", D.guid, T.parser.json);
+              p && console.warn("Could not find texture with guid", D.guid, E.parser.json);
           }
-          if (v = 0, T.parser.json.meshes) {
+          if (v = 0, E.parser.json.meshes) {
             let O = !1;
-            for (const u of T.parser.json.meshes) {
+            for (const u of E.parser.json.meshes) {
               if (u != null && u.extensions) {
                 const g = u == null ? void 0 : u.extensions[W];
                 if (g != null && g.guid && g.guid === D.guid) {
@@ -467,16 +467,16 @@ const M = class {
               } else {
                 const _ = new Array();
                 for (let S = 0; S < u.children.length; S++) {
-                  const E = u.children[S];
-                  if (E.isMesh === !0) {
-                    const K = E.geometry;
-                    M.assignLODInformation(n.url, K, i, e, S, g.density), _.push(K);
+                  const T = u.children[S];
+                  if (T.isMesh === !0) {
+                    const X = T.geometry;
+                    M.assignLODInformation(n.url, X, i, e, S, g.density), _.push(X);
                   }
                 }
                 return f(_);
               }
             } else
-              p && console.warn("Could not find mesh with guid", D.guid, T.parser.json);
+              p && console.warn("Could not find mesh with guid", D.guid, E.parser.json);
           }
           return f(null);
         });
@@ -547,11 +547,11 @@ var $e = (t, e, s) => {
   if (e.has(t))
     throw TypeError("Cannot add the same private member more than once");
   e instanceof WeakSet ? e.add(t) : e.set(t, s);
-}, F = (t, e, s, n) => ($e(t, e, "write to private field"), n ? n.call(t, s) : e.set(t, s), s), b, q, Oe, Z, ie, de, Y;
-const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:LODSManager"), xe = Symbol("Needle:LODState"), X = Symbol("Needle:CurrentLOD"), I = { mesh_lod: -1, texture_lod: -1 }, C = class {
+}, F = (t, e, s, n) => ($e(t, e, "write to private field"), n ? n.call(t, s) : e.set(t, s), s), b, K, Oe, Z, ie, de, Y;
+const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:LODSManager"), xe = Symbol("Needle:LODState"), q = Symbol("Needle:CurrentLOD"), I = { mesh_lod: -1, texture_lod: -1 }, C = class {
   // readonly plugins: NEEDLE_progressive_plugin[] = [];
   constructor(t, e) {
-    this.projectionScreenMatrix = new be(), this.targetTriangleDensity = 2e5, this.updateInterval = "auto", J(this, b, 1), this.pause = !1, this.manual = !1, this._lodchangedlisteners = [], J(this, q, void 0), J(this, Oe, new Xe()), J(this, Z, 0), J(this, ie, 0), J(this, de, 0), J(this, Y, 0), this._fpsBuffer = [60, 60, 60, 60, 60], this._sphere = new Ve(), this._tempBox = new Te(), this._tempBox2 = new Te(), this.tempMatrix = new be(), this._tempWorldPosition = new z(), this._tempBoxSize = new z(), this._tempBox2Size = new z(), this.renderer = t, this.context = { ...e };
+    this.projectionScreenMatrix = new be(), this.targetTriangleDensity = 2e5, this.updateInterval = "auto", J(this, b, 1), this.pause = !1, this.manual = !1, this._lodchangedlisteners = [], J(this, K, void 0), J(this, Oe, new qe()), J(this, Z, 0), J(this, ie, 0), J(this, de, 0), J(this, Y, 0), this._fpsBuffer = [60, 60, 60, 60, 60], this._sphere = new Ve(), this._tempBox = new Ee(), this._tempBox2 = new Ee(), this.tempMatrix = new be(), this._tempWorldPosition = new z(), this._tempBoxSize = new z(), this._tempBox2Size = new z(), this.renderer = t, this.context = { ...e };
   }
   /** @internal */
   static getObjectLODState(t) {
@@ -595,21 +595,21 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
    * Enable the LODsManager. This will replace the render method of the renderer with a method that updates the LODs.
    */
   enable() {
-    if (y(this, q))
+    if (y(this, K))
       return;
     console.debug("[gltf-progressive] Enabling LODsManager for renderer");
     let t = 0;
-    F(this, q, this.renderer.render);
+    F(this, K, this.renderer.render);
     const e = this;
     Re(this.renderer), this.renderer.render = function(s, n) {
       const i = e.renderer.getRenderTarget();
       (i == null || "isXRRenderTarget" in i && i.isXRRenderTarget) && (t = 0, F(e, Z, y(e, Z) + 1), F(e, ie, y(e, Oe).getDelta()), F(e, de, y(e, de) + y(e, ie)), e._fpsBuffer.shift(), e._fpsBuffer.push(1 / y(e, ie)), F(e, Y, e._fpsBuffer.reduce((o, a) => o + a) / e._fpsBuffer.length), R && y(e, Z) % 200 === 0 && console.log("FPS", Math.round(y(e, Y)), "Interval:", y(e, b)));
       const r = t++;
-      y(e, q).call(this, s, n), e.onAfterRender(s, n, r);
+      y(e, K).call(this, s, n), e.onAfterRender(s, n, r);
     };
   }
   disable() {
-    y(this, q) && (console.debug("[gltf-progressive] Disabling LODsManager for renderer"), this.renderer.render = y(this, q), F(this, q, void 0));
+    y(this, K) && (console.debug("[gltf-progressive] Disabling LODsManager for renderer"), this.renderer.render = y(this, K), F(this, K, void 0));
   }
   update(t, e) {
     this.internalUpdate(t, e);
@@ -653,7 +653,7 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       }
       if (R === "color" && l.material && !l.object.progressive_debug_color) {
         l.object.progressive_debug_color = !0;
-        const h = Math.random() * 16777215, x = new Ke({ color: h });
+        const h = Math.random() * 16777215, x = new Xe({ color: h });
         l.object.material = x;
       }
       const d = l.object;
@@ -700,9 +700,9 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       return;
     }
     let s = !1;
-    (t[X] === void 0 || e < t[X]) && (s = !0);
+    (t[q] === void 0 || e < t[q]) && (s = !0);
     const n = t["DEBUG:LOD"];
-    n != null && (s = t[X] != n, e = n), s && (t[X] = e, P.assignTextureLOD(t, e).then((i) => {
+    n != null && (s = t[q] != n, e = n), s && (t[q] = e, P.assignTextureLOD(t, e).then((i) => {
       this._lodchangedlisteners.forEach((r) => r({ type: "texture", level: e, object: t }));
     }));
   }
@@ -715,12 +715,12 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
   loadProgressiveMeshes(t, e) {
     if (!t)
       return Promise.resolve(null);
-    let s = t[X] !== e;
+    let s = t[q] !== e;
     const n = t["DEBUG:LOD"];
-    if (n != null && (s = t[X] != n, e = n), s) {
-      t[X] = e;
+    if (n != null && (s = t[q] != n, e = n), s) {
+      t[q] = e;
       const i = t.geometry;
-      return P.assignMeshLOD(t, e).then((r) => (r && t[X] == e && i != t.geometry && this._lodchangedlisteners.forEach((o) => o({ type: "mesh", level: e, object: t })), r));
+      return P.assignMeshLOD(t, e).then((r) => (r && t[q] == e && i != t.geometry && this._lodchangedlisteners.forEach((o) => o({ type: "mesh", level: e, object: t })), r));
     }
     return Promise.resolve(null);
   }
@@ -775,10 +775,10 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       }
       if (this._tempBox.applyMatrix4(this.projectionScreenMatrix), this.renderer.xr.enabled && m.isPerspectiveCamera && m.fov > 70) {
         const u = this._tempBox.min, g = this._tempBox.max;
-        let _ = u.x, S = u.y, E = g.x, K = g.y;
+        let _ = u.x, S = u.y, T = g.x, X = g.y;
         const le = 2, pe = 1.5, ce = (u.x + g.x) * 0.5, ue = (u.y + g.y) * 0.5;
-        _ = (_ - ce) * le + ce, S = (S - ue) * le + ue, E = (E - ce) * le + ce, K = (K - ue) * le + ue;
-        const Fe = _ < 0 && E > 0 ? 0 : Math.min(Math.abs(u.x), Math.abs(g.x)), We = S < 0 && K > 0 ? 0 : Math.min(Math.abs(u.y), Math.abs(g.y)), ye = Math.max(Fe, We);
+        _ = (_ - ce) * le + ce, S = (S - ue) * le + ue, T = (T - ce) * le + ce, X = (X - ue) * le + ue;
+        const Fe = _ < 0 && T > 0 ? 0 : Math.min(Math.abs(u.x), Math.abs(g.x)), We = S < 0 && X > 0 ? 0 : Math.min(Math.abs(u.y), Math.abs(g.y)), ye = Math.max(Fe, We);
         s.lastCentrality = (pe - ye) * (pe - ye) * (pe - ye);
       } else
         s.lastCentrality = 1;
@@ -786,14 +786,14 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       f.multiplyScalar(0.5), screen.availHeight > 0 && L > 0 && f.multiplyScalar(L / screen.availHeight), t.isPerspectiveCamera ? f.x *= t.aspect : t.isOrthographicCamera;
       const w = t.matrixWorldInverse, $ = this._tempBox2;
       $.copy(D), $.applyMatrix4(e.matrixWorld), $.applyMatrix4(w);
-      const B = $.getSize(this._tempBox2Size), T = Math.max(B.x, B.y);
-      if (Math.max(f.x, f.y) != 0 && T != 0 && (f.z = B.z / Math.max(B.x, B.y) * Math.max(f.x, f.y)), s.lastScreenCoverage = Math.max(f.x, f.y, f.z), s.lastScreenspaceVolume.copy(f), s.lastScreenCoverage *= s.lastCentrality, R && C.debugDrawLine) {
+      const B = $.getSize(this._tempBox2Size), E = Math.max(B.x, B.y);
+      if (Math.max(f.x, f.y) != 0 && E != 0 && (f.z = B.z / Math.max(B.x, B.y) * Math.max(f.x, f.y)), s.lastScreenCoverage = Math.max(f.x, f.y, f.z), s.lastScreenspaceVolume.copy(f), s.lastScreenCoverage *= s.lastCentrality, R && C.debugDrawLine) {
         const u = this.tempMatrix.copy(this.projectionScreenMatrix);
         u.invert();
-        const g = C.corner0, _ = C.corner1, S = C.corner2, E = C.corner3;
-        g.copy(this._tempBox.min), _.copy(this._tempBox.max), _.x = g.x, S.copy(this._tempBox.max), S.y = g.y, E.copy(this._tempBox.max);
-        const K = (g.z + E.z) * 0.5;
-        g.z = _.z = S.z = E.z = K, g.applyMatrix4(u), _.applyMatrix4(u), S.applyMatrix4(u), E.applyMatrix4(u), C.debugDrawLine(g, _, 255), C.debugDrawLine(g, S, 255), C.debugDrawLine(_, E, 255), C.debugDrawLine(S, E, 255);
+        const g = C.corner0, _ = C.corner1, S = C.corner2, T = C.corner3;
+        g.copy(this._tempBox.min), _.copy(this._tempBox.max), _.x = g.x, S.copy(this._tempBox.max), S.y = g.y, T.copy(this._tempBox.max);
+        const X = (g.z + T.z) * 0.5;
+        g.z = _.z = S.z = T.z = X, g.applyMatrix4(u), _.applyMatrix4(u), S.applyMatrix4(u), T.applyMatrix4(u), C.debugDrawLine(g, _, 255), C.debugDrawLine(g, S, 255), C.debugDrawLine(_, T, 255), C.debugDrawLine(S, T, 255);
       }
       let v = 999;
       if (l && s.lastScreenCoverage > 0) {
@@ -821,11 +821,11 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
         let w = s.lastScreenCoverage * 4;
         ((k = this.context) == null ? void 0 : k.engine) === "model-viewer" && (w *= 1.5);
         const B = L / window.devicePixelRatio * w;
-        let T = !1;
+        let E = !1;
         for (let U = h.lods.length - 1; U >= 0; U--) {
           let v = h.lods[U];
-          if (!(m && v.max_height >= 2048) && !(rt() && v.max_height > 4096) && (v.max_height > B || !T && U === 0)) {
-            if (T = !0, i.texture_lod = U, i.texture_lod < s.lastLodLevel_Texture) {
+          if (!(m && v.max_height >= 2048) && !(rt() && v.max_height > 4096) && (v.max_height > B || !E && U === 0)) {
+            if (E = !0, i.texture_lod = U, i.texture_lod < s.lastLodLevel_Texture) {
               const O = v.max_height;
               R && console.log(`Texture LOD changed: ${s.lastLodLevel_Texture} → ${i.texture_lod} = ${O}px 
 Screensize: ${B.toFixed(0)}px, Coverage: ${(100 * s.lastScreenCoverage).toFixed(2)}%, Volume ${f.toFixed(1)} 
@@ -841,7 +841,7 @@ ${e.name}`);
 };
 let V = C;
 b = /* @__PURE__ */ new WeakMap();
-q = /* @__PURE__ */ new WeakMap();
+K = /* @__PURE__ */ new WeakMap();
 Oe = /* @__PURE__ */ new WeakMap();
 Z = /* @__PURE__ */ new WeakMap();
 ie = /* @__PURE__ */ new WeakMap();
@@ -1022,12 +1022,12 @@ if (!it) {
       globalThis.Needle[e] = t[e];
 }
 export {
-  V as L,
-  P as N,
-  Ie as a,
-  Ge as b,
-  Re as c,
-  et as d,
-  ae as g,
-  je as s
+  V as LODsManager,
+  P as NEEDLE_progressive,
+  Ie as addDracoAndKTX2Loaders,
+  Ge as configureLoader,
+  Re as createLoaders,
+  ae as getRaycastMesh,
+  je as setDracoDecoderLocation,
+  et as setKTX2TranscoderLocation
 };

package/dist/gltf-progressive.light.js

@@ -1,5 +1,5 @@
-import { B as he, M as Q, T as ee, a as ze, V as z, b as be, S as Ve, c as Te, d as Ke, C as Xe } from "./three.light.js";
-import { D as qe, K as Ye, G as Se, M as He } from "./three-examples.light.js";
+import { BufferGeometry as he, Mesh as Q, Texture as ee, TextureLoader as ze, Vector3 as z, Matrix4 as be, Sphere as Ve, Box3 as Ee, MeshStandardMaterial as Xe, Clock as qe } from "./three.light.js";
+import { DRACOLoader as Ke, KTX2Loader as Ye, GLTFLoader as Se, MeshoptDecoder as He } from "./three-examples.light.js";
 const Je = "";
 globalThis.GLTF_PROGRESSIVE_VERSION = Je;
 console.debug("[gltf-progressive] version -");
@@ -25,7 +25,7 @@ function et(t) {
 const De = Symbol("dracoDecoderPath");
 let A, ge, G;
 function Be() {
-  A || (A = new qe(), A[De] = N, A.setDecoderPath(N), A.setDecoderConfig({ type: "js" }), A.preload()), G || (G = new Ye(), G.setTranscoderPath(j), G.init()), ge || (ge = He);
+  A || (A = new Ke(), A[De] = N, A.setDecoderPath(N), A.setDecoderConfig({ type: "js" }), A.preload()), G || (G = new Ye(), G.setTranscoderPath(j), G.init()), ge || (ge = He);
 }
 function Re(t) {
   return Be(), t ? G.detectSupport(t) : t !== null && console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures might fail"), { dracoLoader: A, ktx2Loader: G, meshoptDecoder: ge };
@@ -127,7 +127,7 @@ if (p) {
     }));
   });
 }
-function Ee(t, e, s) {
+function Te(t, e, s) {
   var i;
   if (!p)
     return;
@@ -259,7 +259,7 @@ const M = class {
           const o = i.index || 0;
           r = r[o];
         }
-        return t["LOD:requested level"] === e && (delete t["LOD:requested level"], r && n != r && ((r == null ? void 0 : r.isBufferGeometry) ? (t.geometry = r, p && Ee(t, "geometry", i.url)) : p && console.error("Invalid LOD geometry", r))), r;
+        return t["LOD:requested level"] === e && (delete t["LOD:requested level"], r && n != r && ((r == null ? void 0 : r.isBufferGeometry) ? (t.geometry = r, p && Te(t, "geometry", i.url)) : p && console.error("Invalid LOD geometry", r))), r;
       }).catch((r) => (console.error("Error loading mesh LOD", t, r), null));
     } else
       p && console.error("Invalid call to assignMeshLOD: Request mesh LOD but the object is not a mesh", t);
@@ -336,7 +336,7 @@ const M = class {
           }
           if (p && n && s) {
             const r = this.getAssignedLODInformation(t);
-            r ? Ee(s, n, r.url) : console.warn("No LOD info for texture", t);
+            r ? Te(s, n, r.url) : console.warn("No LOD info for texture", t);
           }
         }
         return i;
@@ -422,16 +422,16 @@ const M = class {
             const O = D.lods[e];
             O.hash && (B += "?v=" + O.hash);
           }
-          const T = await $.loadAsync(B).catch((O) => (console.error(`Error loading LOD ${e} from ${h}
+          const E = await $.loadAsync(B).catch((O) => (console.error(`Error loading LOD ${e} from ${h}
 `, O), null));
-          if (!T)
+          if (!E)
             return null;
-          const U = T.parser;
+          const U = E.parser;
           s && console.log("Loading finished " + h, D.guid);
           let v = 0;
-          if (T.parser.json.textures) {
+          if (E.parser.json.textures) {
             let O = !1;
-            for (const u of T.parser.json.textures) {
+            for (const u of E.parser.json.textures) {
               if (u != null && u.extensions) {
                 const g = u == null ? void 0 : u.extensions[W];
                 if (g != null && g.guid && g.guid === D.guid) {
@@ -445,11 +445,11 @@ const M = class {
               let u = await U.getDependency("texture", v);
               return u && M.assignLODInformation(n.url, u, i, e, void 0, void 0), s && console.log('change "' + t.name + '" → "' + u.name + '"', h, v, u, x), t instanceof ee && (u = this.copySettings(t, u)), u && (u.guid = D.guid), f(u);
             } else
-              p && console.warn("Could not find texture with guid", D.guid, T.parser.json);
+              p && console.warn("Could not find texture with guid", D.guid, E.parser.json);
           }
-          if (v = 0, T.parser.json.meshes) {
+          if (v = 0, E.parser.json.meshes) {
             let O = !1;
-            for (const u of T.parser.json.meshes) {
+            for (const u of E.parser.json.meshes) {
               if (u != null && u.extensions) {
                 const g = u == null ? void 0 : u.extensions[W];
                 if (g != null && g.guid && g.guid === D.guid) {
@@ -467,16 +467,16 @@ const M = class {
               } else {
                 const _ = new Array();
                 for (let S = 0; S < u.children.length; S++) {
-                  const E = u.children[S];
-                  if (E.isMesh === !0) {
-                    const K = E.geometry;
-                    M.assignLODInformation(n.url, K, i, e, S, g.density), _.push(K);
+                  const T = u.children[S];
+                  if (T.isMesh === !0) {
+                    const X = T.geometry;
+                    M.assignLODInformation(n.url, X, i, e, S, g.density), _.push(X);
                   }
                 }
                 return f(_);
               }
             } else
-              p && console.warn("Could not find mesh with guid", D.guid, T.parser.json);
+              p && console.warn("Could not find mesh with guid", D.guid, E.parser.json);
           }
           return f(null);
         });
@@ -547,11 +547,11 @@ var $e = (t, e, s) => {
   if (e.has(t))
     throw TypeError("Cannot add the same private member more than once");
   e instanceof WeakSet ? e.add(t) : e.set(t, s);
-}, F = (t, e, s, n) => ($e(t, e, "write to private field"), n ? n.call(t, s) : e.set(t, s), s), b, q, Oe, Z, ie, de, Y;
-const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:LODSManager"), xe = Symbol("Needle:LODState"), X = Symbol("Needle:CurrentLOD"), I = { mesh_lod: -1, texture_lod: -1 }, C = class {
+}, F = (t, e, s, n) => ($e(t, e, "write to private field"), n ? n.call(t, s) : e.set(t, s), s), b, K, Oe, Z, ie, de, Y;
+const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:LODSManager"), xe = Symbol("Needle:LODState"), q = Symbol("Needle:CurrentLOD"), I = { mesh_lod: -1, texture_lod: -1 }, C = class {
   // readonly plugins: NEEDLE_progressive_plugin[] = [];
   constructor(t, e) {
-    this.projectionScreenMatrix = new be(), this.targetTriangleDensity = 2e5, this.updateInterval = "auto", J(this, b, 1), this.pause = !1, this.manual = !1, this._lodchangedlisteners = [], J(this, q, void 0), J(this, Oe, new Xe()), J(this, Z, 0), J(this, ie, 0), J(this, de, 0), J(this, Y, 0), this._fpsBuffer = [60, 60, 60, 60, 60], this._sphere = new Ve(), this._tempBox = new Te(), this._tempBox2 = new Te(), this.tempMatrix = new be(), this._tempWorldPosition = new z(), this._tempBoxSize = new z(), this._tempBox2Size = new z(), this.renderer = t, this.context = { ...e };
+    this.projectionScreenMatrix = new be(), this.targetTriangleDensity = 2e5, this.updateInterval = "auto", J(this, b, 1), this.pause = !1, this.manual = !1, this._lodchangedlisteners = [], J(this, K, void 0), J(this, Oe, new qe()), J(this, Z, 0), J(this, ie, 0), J(this, de, 0), J(this, Y, 0), this._fpsBuffer = [60, 60, 60, 60, 60], this._sphere = new Ve(), this._tempBox = new Ee(), this._tempBox2 = new Ee(), this.tempMatrix = new be(), this._tempWorldPosition = new z(), this._tempBoxSize = new z(), this._tempBox2Size = new z(), this.renderer = t, this.context = { ...e };
   }
   /** @internal */
   static getObjectLODState(t) {
@@ -595,21 +595,21 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
    * Enable the LODsManager. This will replace the render method of the renderer with a method that updates the LODs.
    */
   enable() {
-    if (y(this, q))
+    if (y(this, K))
       return;
     console.debug("[gltf-progressive] Enabling LODsManager for renderer");
     let t = 0;
-    F(this, q, this.renderer.render);
+    F(this, K, this.renderer.render);
     const e = this;
     Re(this.renderer), this.renderer.render = function(s, n) {
       const i = e.renderer.getRenderTarget();
       (i == null || "isXRRenderTarget" in i && i.isXRRenderTarget) && (t = 0, F(e, Z, y(e, Z) + 1), F(e, ie, y(e, Oe).getDelta()), F(e, de, y(e, de) + y(e, ie)), e._fpsBuffer.shift(), e._fpsBuffer.push(1 / y(e, ie)), F(e, Y, e._fpsBuffer.reduce((o, a) => o + a) / e._fpsBuffer.length), R && y(e, Z) % 200 === 0 && console.log("FPS", Math.round(y(e, Y)), "Interval:", y(e, b)));
       const r = t++;
-      y(e, q).call(this, s, n), e.onAfterRender(s, n, r);
+      y(e, K).call(this, s, n), e.onAfterRender(s, n, r);
     };
   }
   disable() {
-    y(this, q) && (console.debug("[gltf-progressive] Disabling LODsManager for renderer"), this.renderer.render = y(this, q), F(this, q, void 0));
+    y(this, K) && (console.debug("[gltf-progressive] Disabling LODsManager for renderer"), this.renderer.render = y(this, K), F(this, K, void 0));
   }
   update(t, e) {
     this.internalUpdate(t, e);
@@ -653,7 +653,7 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       }
       if (R === "color" && l.material && !l.object.progressive_debug_color) {
         l.object.progressive_debug_color = !0;
-        const h = Math.random() * 16777215, x = new Ke({ color: h });
+        const h = Math.random() * 16777215, x = new Xe({ color: h });
         l.object.material = x;
       }
       const d = l.object;
@@ -700,9 +700,9 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       return;
     }
     let s = !1;
-    (t[X] === void 0 || e < t[X]) && (s = !0);
+    (t[q] === void 0 || e < t[q]) && (s = !0);
     const n = t["DEBUG:LOD"];
-    n != null && (s = t[X] != n, e = n), s && (t[X] = e, P.assignTextureLOD(t, e).then((i) => {
+    n != null && (s = t[q] != n, e = n), s && (t[q] = e, P.assignTextureLOD(t, e).then((i) => {
       this._lodchangedlisteners.forEach((r) => r({ type: "texture", level: e, object: t }));
     }));
   }
@@ -715,12 +715,12 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
   loadProgressiveMeshes(t, e) {
     if (!t)
       return Promise.resolve(null);
-    let s = t[X] !== e;
+    let s = t[q] !== e;
     const n = t["DEBUG:LOD"];
-    if (n != null && (s = t[X] != n, e = n), s) {
-      t[X] = e;
+    if (n != null && (s = t[q] != n, e = n), s) {
+      t[q] = e;
       const i = t.geometry;
-      return P.assignMeshLOD(t, e).then((r) => (r && t[X] == e && i != t.geometry && this._lodchangedlisteners.forEach((o) => o({ type: "mesh", level: e, object: t })), r));
+      return P.assignMeshLOD(t, e).then((r) => (r && t[q] == e && i != t.geometry && this._lodchangedlisteners.forEach((o) => o({ type: "mesh", level: e, object: t })), r));
     }
     return Promise.resolve(null);
   }
@@ -775,10 +775,10 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       }
       if (this._tempBox.applyMatrix4(this.projectionScreenMatrix), this.renderer.xr.enabled && m.isPerspectiveCamera && m.fov > 70) {
         const u = this._tempBox.min, g = this._tempBox.max;
-        let _ = u.x, S = u.y, E = g.x, K = g.y;
+        let _ = u.x, S = u.y, T = g.x, X = g.y;
         const le = 2, pe = 1.5, ce = (u.x + g.x) * 0.5, ue = (u.y + g.y) * 0.5;
-        _ = (_ - ce) * le + ce, S = (S - ue) * le + ue, E = (E - ce) * le + ce, K = (K - ue) * le + ue;
-        const Fe = _ < 0 && E > 0 ? 0 : Math.min(Math.abs(u.x), Math.abs(g.x)), We = S < 0 && K > 0 ? 0 : Math.min(Math.abs(u.y), Math.abs(g.y)), ye = Math.max(Fe, We);
+        _ = (_ - ce) * le + ce, S = (S - ue) * le + ue, T = (T - ce) * le + ce, X = (X - ue) * le + ue;
+        const Fe = _ < 0 && T > 0 ? 0 : Math.min(Math.abs(u.x), Math.abs(g.x)), We = S < 0 && X > 0 ? 0 : Math.min(Math.abs(u.y), Math.abs(g.y)), ye = Math.max(Fe, We);
         s.lastCentrality = (pe - ye) * (pe - ye) * (pe - ye);
       } else
         s.lastCentrality = 1;
@@ -786,14 +786,14 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
       f.multiplyScalar(0.5), screen.availHeight > 0 && L > 0 && f.multiplyScalar(L / screen.availHeight), t.isPerspectiveCamera ? f.x *= t.aspect : t.isOrthographicCamera;
       const w = t.matrixWorldInverse, $ = this._tempBox2;
       $.copy(D), $.applyMatrix4(e.matrixWorld), $.applyMatrix4(w);
-      const B = $.getSize(this._tempBox2Size), T = Math.max(B.x, B.y);
-      if (Math.max(f.x, f.y) != 0 && T != 0 && (f.z = B.z / Math.max(B.x, B.y) * Math.max(f.x, f.y)), s.lastScreenCoverage = Math.max(f.x, f.y, f.z), s.lastScreenspaceVolume.copy(f), s.lastScreenCoverage *= s.lastCentrality, R && C.debugDrawLine) {
+      const B = $.getSize(this._tempBox2Size), E = Math.max(B.x, B.y);
+      if (Math.max(f.x, f.y) != 0 && E != 0 && (f.z = B.z / Math.max(B.x, B.y) * Math.max(f.x, f.y)), s.lastScreenCoverage = Math.max(f.x, f.y, f.z), s.lastScreenspaceVolume.copy(f), s.lastScreenCoverage *= s.lastCentrality, R && C.debugDrawLine) {
         const u = this.tempMatrix.copy(this.projectionScreenMatrix);
         u.invert();
-        const g = C.corner0, _ = C.corner1, S = C.corner2, E = C.corner3;
-        g.copy(this._tempBox.min), _.copy(this._tempBox.max), _.x = g.x, S.copy(this._tempBox.max), S.y = g.y, E.copy(this._tempBox.max);
-        const K = (g.z + E.z) * 0.5;
-        g.z = _.z = S.z = E.z = K, g.applyMatrix4(u), _.applyMatrix4(u), S.applyMatrix4(u), E.applyMatrix4(u), C.debugDrawLine(g, _, 255), C.debugDrawLine(g, S, 255), C.debugDrawLine(_, E, 255), C.debugDrawLine(S, E, 255);
+        const g = C.corner0, _ = C.corner1, S = C.corner2, T = C.corner3;
+        g.copy(this._tempBox.min), _.copy(this._tempBox.max), _.x = g.x, S.copy(this._tempBox.max), S.y = g.y, T.copy(this._tempBox.max);
+        const X = (g.z + T.z) * 0.5;
+        g.z = _.z = S.z = T.z = X, g.applyMatrix4(u), _.applyMatrix4(u), S.applyMatrix4(u), T.applyMatrix4(u), C.debugDrawLine(g, _, 255), C.debugDrawLine(g, S, 255), C.debugDrawLine(_, T, 255), C.debugDrawLine(S, T, 255);
       }
       let v = 999;
       if (l && s.lastScreenCoverage > 0) {
@@ -821,11 +821,11 @@ const R = oe("debugprogressive"), ct = oe("noprogressive"), me = Symbol("Needle:
         let w = s.lastScreenCoverage * 4;
         ((k = this.context) == null ? void 0 : k.engine) === "model-viewer" && (w *= 1.5);
         const B = L / window.devicePixelRatio * w;
-        let T = !1;
+        let E = !1;
         for (let U = h.lods.length - 1; U >= 0; U--) {
           let v = h.lods[U];
-          if (!(m && v.max_height >= 2048) && !(rt() && v.max_height > 4096) && (v.max_height > B || !T && U === 0)) {
-            if (T = !0, i.texture_lod = U, i.texture_lod < s.lastLodLevel_Texture) {
+          if (!(m && v.max_height >= 2048) && !(rt() && v.max_height > 4096) && (v.max_height > B || !E && U === 0)) {
+            if (E = !0, i.texture_lod = U, i.texture_lod < s.lastLodLevel_Texture) {
               const O = v.max_height;
               R && console.log(`Texture LOD changed: ${s.lastLodLevel_Texture} → ${i.texture_lod} = ${O}px 
 Screensize: ${B.toFixed(0)}px, Coverage: ${(100 * s.lastScreenCoverage).toFixed(2)}%, Volume ${f.toFixed(1)} 
@@ -841,7 +841,7 @@ ${e.name}`);
 };
 let V = C;
 b = /* @__PURE__ */ new WeakMap();
-q = /* @__PURE__ */ new WeakMap();
+K = /* @__PURE__ */ new WeakMap();
 Oe = /* @__PURE__ */ new WeakMap();
 Z = /* @__PURE__ */ new WeakMap();
 ie = /* @__PURE__ */ new WeakMap();
@@ -1022,12 +1022,12 @@ if (!it) {
       globalThis.Needle[e] = t[e];
 }
 export {
-  V as L,
-  P as N,
-  Ie as a,
-  Ge as b,
-  Re as c,
-  et as d,
-  ae as g,
-  je as s
+  V as LODsManager,
+  P as NEEDLE_progressive,
+  Ie as addDracoAndKTX2Loaders,
+  Ge as configureLoader,
+  Re as createLoaders,
+  ae as getRaycastMesh,
+  je as setDracoDecoderLocation,
+  et as setKTX2TranscoderLocation
 };