@needle-tools/gltf-progressive 3.3.2 → 3.3.3-next.90044cd

package/CHANGELOG.md

@@ -4,6 +4,9 @@ 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).
 
+## [3.3.3] - 2025-09-08
+- Update documentation and add an initial extension definition
+
 ## [3.3.2] - 2025-08-20
 - Update KTX2 transcoder
 

package/NEEDLE_progressive/README.md

@@ -0,0 +1,106 @@
+# NEEDLE Progressive Extensions Schema
+
+This document describes the NEEDLE progressive mesh and texture extensions.
+
+## Base Types
+
+### NEEDLE_progressive_model_LOD
+
+Represents a single Level of Detail (LOD) file reference.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `path` | `string` | Yes | Relative path to the LOD file |
+| `hash` | `string` | No | Optional hash for file verification |
+
+### NEEDLE_progressive_ext
+
+Base extension format for progressive assets.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `guid` | `string` | Yes | Unique identifier of the object (texture, mesh) the LODs belong to |
+| `lods` | `Array<NEEDLE_progressive_model_LOD>` | Yes | Array of available LOD levels |
+
+## Extension Types
+
+### NEEDLE_ext_progressive_texture
+
+Texture extension for progressive texture loading, inheriting from `NEEDLE_progressive_ext`.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `guid` | `string` | Yes | Inherited from base type |
+| `lods` | `Array<TextureLOD>` | Yes | Array of texture LOD levels with dimensions |
+
+**TextureLOD Properties:**
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `path` | `string` | Yes | Relative path to the texture LOD file |
+| `hash` | `string` | No | Optional hash for file verification |
+| `width` | `number` | Yes | Texture width in pixels |
+| `height` | `number` | Yes | Texture height in pixels |
+
+### NEEDLE_ext_progressive_mesh
+
+Mesh extension for progressive mesh loading, inheriting from `NEEDLE_progressive_ext`.
+
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `guid` | `string` | Yes | Inherited from base type |
+| `lods` | `Array<MeshLOD>` | Yes | Array of mesh LOD levels with geometry data |
+
+**MeshLOD Properties:**
+| Property | Type | Required | Description |
+|----------|------|----------|-------------|
+| `path` | `string` | Yes | Relative path to the mesh LOD file |
+| `hash` | `string` | No | Optional hash for file verification |
+| `densities` | `number[]` | Yes | Density values per primitive |
+| `indexCount` | `number` | No | Number of indices in LOD0 |
+| `vertexCount` | `number` | No | Number of vertices in LOD0 |
+
+## Usage Examples
+
+### Texture Extension Example
+
+```json
+{
+  "guid": "texture-asset-123",
+  "lods": [
+    {
+      "path": "./textures/image_diffuse_1024.glb",
+      "hash": "abc123",
+      "width": 1024,
+      "height": 1024
+    },
+    {
+      "path": "./textures/image_diffuse_512.glb",
+      "width": 512,
+      "height": 512
+    }
+  ]
+}
+```
+
+### Mesh Extension Example
+
+```json
+{
+  "guid": "mesh-asset-456",
+  "lods": [
+    {
+      "path": "./meshes/mesh_0_high_detail.glb",
+      "hash": "def456",
+      "indexCount": 15000,
+      "vertexCount": 8000,
+      "densities": [100000, 50000]
+    },
+    {
+      "path": "./meshes/mesh_1_low_detail.glb",
+      "indexCount": 3000,
+      "vertexCount": 1500,
+      "densities": [100000, 50000]
+    }
+  ]
+}
+```

package/README.md

@@ -40,12 +40,12 @@ Examples are in the `/examples` directory. Live versions can be found in the lin
 - [Codesandbox](https://codesandbox.io/dashboard/sandboxes/gltf-progressive)
 
 
-## Videos
+<!-- ## Videos
 <a href="https://youtu.be/7EjL0BRfIp8" target="_blank">![Progressive glTF — comparison with traditional three.js optimization
 ](https://engine.needle.tools/demos/gltf-progressive/video-comparison-throttled-thumbnail-1.webp)</a>  
 *Progressive glTF — comparison with traditional three.js optimization* 
   
-<br/>
+<br/> -->
 
 # Usage
 
@@ -132,6 +132,10 @@ Full model-viewer example at: `examples/modelviewer.html`
 [Needle Engine](https://needle.tools) natively supports progressive loading of these glTF files! See [docs.needle.tools](https://docs.needle.tools) for more information. 
 
 
+# How can I generate assets for progressive loading
+Use [Needle Cloud](https://cloud.needle.tools) to generate LODs for your assets (includes hosting, global CDN, password protection, versioning, CLI support...) or use one of the [Needle integrations for Unity or Blender](https://engine.needle.tools/docs/getting-started/#choose-your-workflow).
+
+
 # Advanced
 
 ### Add a LOD Manager plugin to receive callbacks per object
@@ -158,8 +162,9 @@ Simply call `useRaycastMeshes(true)` to enable faster raycasting when using the
 Call `getRaycastMesh(<your_mesh_object>)`
 
 
-# How can I generate assets for progressive loading
-Use [Needle Cloud](https://cloud.needle.tools) to generate LODs for your assets (includes hosting, global CDN, password protection, versioning, CLI support...) or use one of the Needle integrations for Unity or Blender.
+# Extension
+Read more about the [NEEDLE_progressive extension](./NEEDLE_progressive/README.md)
+
 
 # Contact ✒️
 <b>[🌵 needle — tools for creators](https://needle.tools)</b> • 

package/gltf-progressive.js

@@ -1,13 +1,13 @@
-import { BufferGeometry as Q, Mesh as q, Box3 as he, Vector3 as A, Sphere as De, CompressedTexture as $e, Texture as E, Matrix3 as Ge, InterleavedBuffer as Fe, InterleavedBufferAttribute as Ue, BufferAttribute as We, TextureLoader as ze, Matrix4 as _e, Clock as Ee, MeshStandardMaterial as Ne } from "three";
+import { BufferGeometry as J, Mesh as q, Box3 as he, Vector3 as A, Sphere as De, CompressedTexture as $e, Texture as E, Matrix3 as Ge, InterleavedBuffer as Fe, InterleavedBufferAttribute as We, BufferAttribute as Ue, TextureLoader as ze, Matrix4 as _e, Clock as Ee, MeshStandardMaterial as Ne } from "three";
 import { GLTFLoader as ye } from "three/examples/jsm/loaders/GLTFLoader.js";
 import { MeshoptDecoder as qe } from "three/examples/jsm/libs/meshopt_decoder.module.js";
 import { DRACOLoader as Ve } from "three/examples/jsm/loaders/DRACOLoader.js";
 import { KTX2Loader as Xe } from "three/examples/jsm/loaders/KTX2Loader.js";
-const Ke = "";
-globalThis.GLTF_PROGRESSIVE_VERSION = Ke;
+const je = "";
+globalThis.GLTF_PROGRESSIVE_VERSION = je;
 console.debug("[gltf-progressive] version -");
-let k = "https://www.gstatic.com/draco/versioned/decoders/1.5.7/", V = "https://cdn.needle.tools/static/three/0.179.1/basis2/";
-const je = k, Ye = V, Oe = new URL(k + "draco_decoder.js");
+let C = "https://www.gstatic.com/draco/versioned/decoders/1.5.7/", V = "https://cdn.needle.tools/static/three/0.179.1/basis2/";
+const Ke = C, Ye = V, Oe = new URL(C + "draco_decoder.js");
 Oe.searchParams.append("range", "true");
 fetch(Oe, {
   method: "GET",
@@ -15,16 +15,16 @@ fetch(Oe, {
     Range: "bytes=0-1"
   }
 }).catch((i) => {
-  console.debug(`Failed to fetch remote Draco decoder from ${k} (offline: ${typeof navigator < "u" ? navigator.onLine : "unknown"})`), k === je && Qe("./include/draco/"), V === Ye && Je("./include/ktx2/");
+  console.debug(`Failed to fetch remote Draco decoder from ${C} (offline: ${typeof navigator < "u" ? navigator.onLine : "unknown"})`), C === Ke && Qe("./include/draco/"), V === Ye && Je("./include/ktx2/");
 }).finally(() => {
   Pe();
 });
 const He = () => ({
-  dracoDecoderPath: k,
+  dracoDecoderPath: C,
   ktx2TranscoderPath: V
 });
 function Qe(i) {
-  k = i, T && T[ge] != k ? (console.debug("Updating Draco decoder path to " + i), T[ge] = k, T.setDecoderPath(k), T.preload()) : console.debug("Setting Draco decoder path to " + i);
+  C = i, T && T[ge] != C ? (console.debug("Updating Draco decoder path to " + i), T[ge] = C, T.setDecoderPath(C), T.preload()) : console.debug("Setting Draco decoder path to " + i);
 }
 function Je(i) {
   V = i, R && R.transcoderPath != V ? (console.debug("Updating KTX2 transcoder path to " + i), R.setTranscoderPath(V), R.init()) : console.debug("Setting KTX2 transcoder path to " + i);
@@ -38,7 +38,7 @@ function Se(i) {
 const ge = Symbol("dracoDecoderPath");
 let T, ne, R;
 function Pe() {
-  T || (T = new Ve(), T[ge] = k, T.setDecoderPath(k), T.setDecoderConfig({ type: "js" }), T.preload()), R || (R = new Xe(), R.setTranscoderPath(V), R.init()), ne || (ne = qe);
+  T || (T = new Ve(), T[ge] = C, T.setDecoderPath(C), T.setDecoderConfig({ type: "js" }), T.preload()), R || (R = new Xe(), R.setTranscoderPath(V), R.init()), ne || (ne = qe);
 }
 const pe = /* @__PURE__ */ new WeakMap();
 function Te(i, t) {
@@ -64,7 +64,7 @@ function X(i) {
   return e == null || e === "0" || e === "false" ? !1 : e === "" ? !0 : e;
 }
 function tt(i, t) {
-  if (t === void 0 || t.startsWith("./") || t.startsWith("http") || i === void 0)
+  if (t === void 0 || i === void 0 || t.startsWith("./") || t.startsWith("http") || t.startsWith("data:") || t.startsWith("blob:"))
     return t;
   const e = i.lastIndexOf("/");
   if (e >= 0) {
@@ -74,10 +74,10 @@ function tt(i, t) {
   }
   return t;
 }
-let j;
 function Ae() {
-  return j !== void 0 || (j = /iPhone|iPad|iPod|Android|IEMobile/i.test(navigator.userAgent), X("debugprogressive") && console.log("[glTF Progressive]: isMobileDevice", j)), j;
+  return K !== void 0 || (K = /iPhone|iPad|iPod|Android|IEMobile/i.test(navigator.userAgent), X("debugprogressive") && console.log("[glTF Progressive]: isMobileDevice", K)), K;
 }
+let K;
 function Le() {
   if (typeof window > "u") return !1;
   const i = new URL(window.location.href), t = i.hostname === "localhost" || /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(i.hostname);
@@ -118,11 +118,11 @@ class st {
   }
 }
 const rt = typeof window > "u" && typeof document > "u", me = Symbol("needle:raycast-mesh");
-function J(i) {
-  return i?.[me] instanceof Q ? i[me] : null;
+function Z(i) {
+  return i?.[me] instanceof J ? i[me] : null;
 }
 function nt(i, t) {
-  if ((i.type === "Mesh" || i.type === "SkinnedMesh") && !J(i)) {
+  if ((i.type === "Mesh" || i.type === "SkinnedMesh") && !Z(i)) {
     const s = it(t);
     s.userData = { isRaycastMesh: !0 }, i[me] = s;
   }
@@ -132,7 +132,7 @@ function ot(i = !0) {
     if (Y) return;
     const t = Y = q.prototype.raycast;
     q.prototype.raycast = function(e, s) {
-      const n = this, r = J(n);
+      const n = this, r = Z(n);
       let o;
       r && n.isMesh && (o = n.geometry, n.geometry = r), t.call(this, e, s), o && (n.geometry = o);
     };
@@ -143,29 +143,29 @@ function ot(i = !0) {
 }
 let Y = null;
 function it(i) {
-  const t = new Q();
+  const t = new J();
   for (const e in i.attributes)
     t.setAttribute(e, i.getAttribute(e));
   return t.setIndex(i.getIndex()), t;
 }
-const W = new Array(), g = X("debugprogressive");
-let re, N = -1;
+const U = new Array(), g = X("debugprogressive");
+let Q, N = -1;
 if (g) {
   let i = function() {
     N += 1, N >= t && (N = -1), console.log(`Toggle LOD level [${N}]`);
   }, t = 6;
   window.addEventListener("keyup", (e) => {
-    e.key === "p" && i(), e.key === "w" && (re = !re, console.log(`Toggle wireframe [${re}]`));
+    e.key === "p" && i(), e.key === "w" && (Q = !Q, console.log(`Toggle wireframe [${Q}]`));
     const s = parseInt(e.key);
     !isNaN(s) && s >= 0 && (N = s, console.log(`Set LOD level to [${N}]`));
   });
 }
 function Ie(i) {
-  if (g)
+  if (g && Q !== void 0)
     if (Array.isArray(i))
       for (const t of i)
         Ie(t);
-    else i && "wireframe" in i && (i.wireframe = re === !0);
+    else i && "wireframe" in i && (i.wireframe = Q === !0);
 }
 const H = new Array();
 let at = 0;
@@ -238,7 +238,7 @@ class we {
 }
 function dt(i) {
   for (const t of i.geometries) {
-    const e = t.geometry, s = new Q();
+    const e = t.geometry, s = new J();
     if (s.name = e.name || "", e.index) {
       const n = e.index;
       s.setIndex(ae(n));
@@ -316,8 +316,8 @@ function ae(i) {
   let t = i;
   if ("isInterleavedBufferAttribute" in i && i.isInterleavedBufferAttribute) {
     const e = i.data, s = e.array, n = new Fe(s, e.stride);
-    t = new Ue(n, i.itemSize, s.byteOffset, i.normalized), t.offset = i.offset;
-  } else "isBufferAttribute" in i && i.isBufferAttribute && (t = new We(i.array, i.itemSize, i.normalized), t.usage = i.usage, t.gpuType = i.gpuType, t.updateRanges = i.updateRanges);
+    t = new We(n, i.itemSize, s.byteOffset, i.normalized), t.offset = i.offset;
+  } else "isBufferAttribute" in i && i.isBufferAttribute && (t = new Ue(i.array, i.itemSize, i.normalized), t.usage = i.usage, t.gpuType = i.gpuType, t.updateRanges = i.updateRanges);
   return t;
 }
 const ct = X("gltf-progressive-worker"), ft = X("gltf-progressive-reduce-mipmaps"), le = Symbol("needle-progressive-texture"), F = "NEEDLE_progressive";
@@ -326,6 +326,7 @@ class y {
   get name() {
     return F;
   }
+  // #region PUBLIC API
   static getMeshLODExtension(t) {
     const e = this.getAssignedLODInformation(t);
     return e?.key ? this.lodInfos.get(e.key) : null;
@@ -426,7 +427,7 @@ class y {
       const s = t.geometry, n = this.getAssignedLODInformation(s);
       if (!n)
         return Promise.resolve(null);
-      for (const r of W)
+      for (const r of U)
         r.onBeforeGetLODMesh?.(t, e);
       return t["LOD:requested level"] = e, y.getOrLoadLOD(s, e).then((r) => {
         if (Array.isArray(r)) {
@@ -491,6 +492,7 @@ class y {
     }
     return Promise.resolve(null);
   }
+  // #region INTERNAL
   static assignTextureLODForSlot(t, e, s, n) {
     return t?.isTexture !== !0 ? Promise.resolve(null) : n === "glyphMap" ? Promise.resolve(t) : y.getOrLoadLOD(t, e).then((r) => {
       if (Array.isArray(r))
@@ -575,12 +577,12 @@ class y {
    */
   static registerTexture = (t, e, s, n, r) => {
     if (!e) {
-      g && console.error("gltf-progressive: Called register texture without texture");
+      g && console.error("!! gltf-progressive: Called register texture without texture");
       return;
     }
     if (g) {
       const l = e.image?.width || e.source?.data?.width || 0, a = e.image?.height || e.source?.data?.height || 0;
-      console.log(`> Progressive: register texture[${n}] "${e.name || e.uuid}", Current: ${l}x${a}, Max: ${r.lods[0]?.width}x${r.lods[0]?.height}, uuid: ${e.uuid}`, r, e);
+      console.log(`> gltf-progressive: register texture[${n}] "${e.name || e.uuid}", Current: ${l}x${a}, Max: ${r.lods[0]?.width}x${r.lods[0]?.height}, uuid: ${e.uuid}`, r, e);
     }
     e.source && (e.source[le] = r);
     const o = r.guid;
@@ -597,8 +599,8 @@ class y {
     }
     l.userData || (l.userData = {}), g && console.log("> Progressive: register mesh " + s.name, { index: r, uuid: s.uuid }, o, s), y.assignLODInformation(t, l, e, n, r), y.lodInfos.set(e, o);
     let a = y.lowresCache.get(e);
-    a ? a.push(s.geometry) : a = [s.geometry], y.lowresCache.set(e, a), n > 0 && !J(s) && nt(s, l);
-    for (const u of W)
+    a ? a.push(s.geometry) : a = [s.geometry], y.lowresCache.set(e, a), n > 0 && !Z(s) && nt(s, l);
+    for (const u of U)
       u.onRegisteredNewMesh?.(s, o);
   };
   /** A map of key = asset uuid and value = LOD information */
@@ -619,7 +621,9 @@ class y {
       const a = t;
       a.source && a.source[le] && (o = a.source[le]);
     }
-    if (o || (o = y.lodInfos.get(r)), o) {
+    if (o || (o = y.lodInfos.get(r)), !o)
+      g && console.warn(`Can not load LOD ${e}: no LOD info found for "${r}" ${t.name}`, t.type, y.lodInfos);
+    else {
       if (e > 0) {
         let c = !1;
         const p = Array.isArray(o.lods);
@@ -638,7 +642,7 @@ class y {
           s && console.log(`LOD ${e} was already loading/loaded: ${c}`);
           let d = await _.catch((O) => (console.error(`Error loading LOD ${e} from ${u}
 `, O), null)), x = !1;
-          if (d == null || (d instanceof E && t instanceof E ? d.image?.data || d.source?.data ? d = this.copySettings(t, d) : (x = !0, this.previouslyLoaded.delete(c)) : d instanceof Q && t instanceof Q && (d.attributes.position?.array || (x = !0, this.previouslyLoaded.delete(c)))), !x)
+          if (d == null || (d instanceof E && t instanceof E ? d.image?.data || d.source?.data ? d = this.copySettings(t, d) : (x = !0, this.previouslyLoaded.delete(c)) : d instanceof J && t instanceof J && (d.attributes.position?.array || (x = !0, this.previouslyLoaded.delete(c)))), !x)
             return d;
         }
         if (!p.use)
@@ -730,8 +734,7 @@ class y {
         const p = await new ze().loadAsync(u);
         return p ? (p.guid = o.guid, p.flipY = !1, p.needsUpdate = !0, p.colorSpace = t.colorSpace, s && console.log(o, p)) : g && console.warn("failed loading", u), p;
       }
-    } else
-      g && console.warn(`Can not load LOD ${e}: no LOD info found for "${r}" ${t.name}`, t.type);
+    }
     return null;
   }
   static maxConcurrent = 50;
@@ -839,7 +842,7 @@ class ue {
     });
   }
 }
-const C = X("debugprogressive"), gt = X("noprogressive"), de = Symbol("Needle:LODSManager"), ce = Symbol("Needle:LODState"), U = Symbol("Needle:CurrentLOD"), P = { mesh_lod: -1, texture_lod: -1 };
+const k = X("debugprogressive"), gt = X("noprogressive"), de = Symbol("Needle:LODSManager"), ce = Symbol("Needle:LODState"), W = Symbol("Needle:CurrentLOD"), P = { mesh_lod: -1, texture_lod: -1 };
 class L {
   /** 
    * Assign a function to draw debug lines for the LODs. This function will be called with the start and end position of the line and the color of the line when the `debugprogressive` query parameter is set.
@@ -850,11 +853,11 @@ class L {
     return t[ce];
   }
   static addPlugin(t) {
-    W.push(t);
+    U.push(t);
   }
   static removePlugin(t) {
-    const e = W.indexOf(t);
-    e >= 0 && W.splice(e, 1);
+    const e = U.indexOf(t);
+    e >= 0 && U.splice(e, 1);
   }
   /**
    * Gets the LODsManager for the given renderer. If the LODsManager does not exist yet, it will be created.  
@@ -875,7 +878,7 @@ class L {
   projectionScreenMatrix = new _e();
   /** @deprecated use static `LODsManager.addPlugin()` method. This getter will be removed in later versions */
   get plugins() {
-    return W;
+    return U;
   }
   /**
    * Force override the LOD level for all objects (meshes + textures) rendered in the scene
@@ -964,7 +967,7 @@ class L {
     const e = this;
     xe(this.renderer), this.renderer.render = function(s, n) {
       const r = e.renderer.getRenderTarget();
-      (r == null || "isXRRenderTarget" in r && r.isXRRenderTarget) && (t = 0, e.#r += 1, e.#n = e.#o.getDelta(), e.#i += e.#n, e._fpsBuffer.shift(), e._fpsBuffer.push(1 / e.#n), e.#s = e._fpsBuffer.reduce((l, a) => l + a) / e._fpsBuffer.length, C && e.#r % 200 === 0 && console.log("FPS", Math.round(e.#s), "Interval:", e.#e));
+      (r == null || "isXRRenderTarget" in r && r.isXRRenderTarget) && (t = 0, e.#r += 1, e.#n = e.#o.getDelta(), e.#i += e.#n, e._fpsBuffer.shift(), e._fpsBuffer.push(1 / e.#n), e.#s = e._fpsBuffer.reduce((l, a) => l + a) / e._fpsBuffer.length, k && e.#r % 200 === 0 && console.log("FPS", Math.round(e.#s), "Interval:", e.#e));
       const o = t++;
       e.#t.call(this, s, n), e.onAfterRender(s, n, o);
     };
@@ -984,7 +987,7 @@ class L {
       (l.name === "EffectMaterial" || l.name === "CopyShader") && (o = !1);
     }
     if ((e.parent && e.parent.type === "CubeCamera" || s >= 1 && e.type === "OrthographicCamera") && (o = !1), o) {
-      if (gt || (this.updateInterval === "auto" ? this.#s < 40 && this.#e < 10 ? (this.#e += 1, C && console.warn("↓ Reducing LOD updates", this.#e, this.#s.toFixed(0))) : this.#s >= 60 && this.#e > 1 && (this.#e -= 1, C && console.warn("↑ Increasing LOD updates", this.#e, this.#s.toFixed(0))) : this.#e = this.updateInterval, this.#e > 0 && this.#r % this.#e != 0))
+      if (gt || (this.updateInterval === "auto" ? this.#s < 40 && this.#e < 10 ? (this.#e += 1, k && console.warn("↓ Reducing LOD updates", this.#e, this.#s.toFixed(0))) : this.#s >= 60 && this.#e > 1 && (this.#e -= 1, k && console.warn("↑ Increasing LOD updates", this.#e, this.#s.toFixed(0))) : this.#e = this.updateInterval, this.#e > 0 && this.#r % this.#e != 0))
         return;
       this.internalUpdate(t, e), this._postprocessPromiseGroups();
     }
@@ -998,7 +1001,7 @@ class L {
     const r = this.targetTriangleDensity;
     for (const a of n) {
       if (a.material && (a.geometry?.type === "BoxGeometry" || a.geometry?.type === "BufferGeometry") && (a.material.name === "SphericalGaussianBlur" || a.material.name == "BackgroundCubeMaterial" || a.material.name === "CubemapFromEquirect" || a.material.name === "EquirectangularToCubeUV")) {
-        C && (a.material["NEEDLE_PROGRESSIVE:IGNORE-WARNING"] || (a.material["NEEDLE_PROGRESSIVE:IGNORE-WARNING"] = !0, console.warn("Ignoring skybox or BLIT object", a, a.material.name, a.material.type)));
+        k && (a.material["NEEDLE_PROGRESSIVE:IGNORE-WARNING"] || (a.material["NEEDLE_PROGRESSIVE:IGNORE-WARNING"] = !0, console.warn("Ignoring skybox or BLIT object", a, a.material.name, a.material.type)));
         continue;
       }
       switch (a.material.type) {
@@ -1010,7 +1013,7 @@ class L {
         case "MeshDepthMaterial":
           continue;
       }
-      if (C === "color" && a.material && !a.object.progressive_debug_color) {
+      if (k === "color" && a.material && !a.object.progressive_debug_color) {
         a.object.progressive_debug_color = !0;
         const c = Math.random() * 16777215, p = new Ne({ color: c });
         a.object.material = p;
@@ -1035,11 +1038,11 @@ class L {
     let r = s[ce];
     if (r || (r = new pt(), s[ce] = r), r.frames++ < 2)
       return;
-    for (const l of W)
+    for (const l of U)
       l.onBeforeUpdateLOD?.(this.renderer, t, e, s);
     const o = this.overrideLodLevel !== void 0 ? this.overrideLodLevel : N;
     o >= 0 ? (P.mesh_lod = o, P.texture_lod = o) : (this.calculateLodLevel(e, s, r, n, P), P.mesh_lod = Math.round(P.mesh_lod), P.texture_lod = Math.round(P.texture_lod)), P.mesh_lod >= 0 && this.loadProgressiveMeshes(s, P.mesh_lod), s.material && P.texture_lod >= 0 && this.loadProgressiveTextures(s.material, P.texture_lod, o), g && s.material && !s.isGizmo && Ie(s.material);
-    for (const l of W)
+    for (const l of U)
       l.onAfterUpdatedLOD?.(this.renderer, t, e, s, P);
     r.lastLodLevel_Mesh = P.mesh_lod, r.lastLodLevel_Texture = P.texture_lod;
   }
@@ -1056,8 +1059,8 @@ class L {
       return;
     }
     let n = !1;
-    if ((t[U] === void 0 || e < t[U]) && (n = !0), s !== void 0 && s >= 0 && (n = t[U] != s, e = s), n) {
-      t[U] = e;
+    if ((t[W] === void 0 || e < t[W]) && (n = !0), s !== void 0 && s >= 0 && (n = t[W] != s, e = s), n) {
+      t[W] = e;
       const r = y.assignTextureLOD(t, e).then((o) => {
         this._lodchangedlisteners.forEach((l) => l({ type: "texture", level: e, object: t }));
       });
@@ -1072,11 +1075,11 @@ class L {
    */
   loadProgressiveMeshes(t, e) {
     if (!t) return Promise.resolve(null);
-    let s = t[U] !== e;
+    let s = t[W] !== e;
     const n = t["DEBUG:LOD"];
-    if (n != null && (s = t[U] != n, e = n), s) {
-      t[U] = e;
-      const r = t.geometry, o = y.assignMeshLOD(t, e).then((l) => (l && t[U] == e && r != t.geometry && this._lodchangedlisteners.forEach((a) => a({ type: "mesh", level: e, object: t })), l));
+    if (n != null && (s = t[W] != n, e = n), s) {
+      t[W] = e;
+      const r = t.geometry, o = y.assignMeshLOD(t, e).then((l) => (l && t[W] == e && r != t.geometry && this._lodchangedlisteners.forEach((a) => a({ type: "mesh", level: e, object: t })), l));
       return ue.addPromise("mesh", t, o, this._newPromiseGroups), o;
     }
     return Promise.resolve(null);
@@ -1111,7 +1114,7 @@ class L {
       return;
     }
     let l = 10 + 1, a = !1;
-    if (C && e["DEBUG:LOD"] != null)
+    if (k && e["DEBUG:LOD"] != null)
       return e["DEBUG:LOD"];
     const u = y.getMeshLODExtension(e.geometry)?.lods, c = y.getPrimitiveIndex(e.geometry), p = u && u.length > 0, _ = y.getMaterialMinMaxLODsCount(e.material), v = _.min_count !== 1 / 0 && _.min_count >= 0 && _.max_count >= 0;
     if (!p && !v) {
@@ -1132,7 +1135,7 @@ class L {
         }
         const x = d[L.$skinnedMeshBoundsOffset];
         if ((s.frames + x) % this.skinnedMeshAutoUpdateBoundsInterval === 0) {
-          const O = J(d), B = d.geometry;
+          const O = Z(d), B = d.geometry;
           O && (d.geometry = O), d.computeBoundingBox(), d.geometry = B;
         }
       }
@@ -1154,10 +1157,10 @@ class L {
       }
       if (this._tempBox.applyMatrix4(this.projectionScreenMatrix), this.renderer.xr.enabled && d.isPerspectiveCamera && d.fov > 70) {
         const f = this._tempBox.min, h = this._tempBox.max;
-        let M = f.x, D = f.y, $ = h.x, K = h.y;
-        const Z = 2, oe = 1.5, ee = (f.x + h.x) * 0.5, te = (f.y + h.y) * 0.5;
-        M = (M - ee) * Z + ee, D = (D - te) * Z + te, $ = ($ - ee) * Z + ee, K = (K - te) * Z + te;
-        const Re = M < 0 && $ > 0 ? 0 : Math.min(Math.abs(f.x), Math.abs(h.x)), Be = D < 0 && K > 0 ? 0 : Math.min(Math.abs(f.y), Math.abs(h.y)), ie = Math.max(Re, Be);
+        let M = f.x, D = f.y, $ = h.x, j = h.y;
+        const ee = 2, oe = 1.5, te = (f.x + h.x) * 0.5, se = (f.y + h.y) * 0.5;
+        M = (M - te) * ee + te, D = (D - se) * ee + se, $ = ($ - te) * ee + te, j = (j - se) * ee + se;
+        const Re = M < 0 && $ > 0 ? 0 : Math.min(Math.abs(f.x), Math.abs(h.x)), Be = D < 0 && j > 0 ? 0 : Math.min(Math.abs(f.y), Math.abs(h.y)), ie = Math.max(Re, Be);
         s.lastCentrality = (oe - ie) * (oe - ie) * (oe - ie);
       } else
         s.lastCentrality = 1;
@@ -1166,13 +1169,13 @@ class L {
       const O = t.matrixWorldInverse, B = this._tempBox2;
       B.copy(G), B.applyMatrix4(e.matrixWorld), B.applyMatrix4(O);
       const b = B.getSize(this._tempBox2Size), z = Math.max(b.x, b.y);
-      if (Math.max(x.x, x.y) != 0 && z != 0 && (x.z = b.z / Math.max(b.x, b.y) * Math.max(x.x, x.y)), s.lastScreenCoverage = Math.max(x.x, x.y, x.z), s.lastScreenspaceVolume.copy(x), s.lastScreenCoverage *= s.lastCentrality, C && L.debugDrawLine) {
+      if (Math.max(x.x, x.y) != 0 && z != 0 && (x.z = b.z / Math.max(b.x, b.y) * Math.max(x.x, x.y)), s.lastScreenCoverage = Math.max(x.x, x.y, x.z), s.lastScreenspaceVolume.copy(x), s.lastScreenCoverage *= s.lastCentrality, k && L.debugDrawLine) {
         const f = this.tempMatrix.copy(this.projectionScreenMatrix);
         f.invert();
         const h = L.corner0, M = L.corner1, D = L.corner2, $ = L.corner3;
         h.copy(this._tempBox.min), M.copy(this._tempBox.max), M.x = h.x, D.copy(this._tempBox.max), D.y = h.y, $.copy(this._tempBox.max);
-        const K = (h.z + $.z) * 0.5;
-        h.z = M.z = D.z = $.z = K, h.applyMatrix4(f), M.applyMatrix4(f), D.applyMatrix4(f), $.applyMatrix4(f), L.debugDrawLine(h, M, 255), L.debugDrawLine(h, D, 255), L.debugDrawLine(M, $, 255), L.debugDrawLine(D, $, 255);
+        const j = (h.z + $.z) * 0.5;
+        h.z = M.z = D.z = $.z = j, h.applyMatrix4(f), M.applyMatrix4(f), D.applyMatrix4(f), $.applyMatrix4(f), L.debugDrawLine(h, M, 255), L.debugDrawLine(h, D, 255), L.debugDrawLine(M, $, 255), L.debugDrawLine(D, $, 255);
       }
       let w = 999;
       if (u && s.lastScreenCoverage > 0)
@@ -1185,16 +1188,16 @@ class L {
         }
       w < l && (l = w, a = !0);
     }
-    if (a ? r.mesh_lod = l : r.mesh_lod = s.lastLodLevel_Mesh, C && r.mesh_lod != s.lastLodLevel_Mesh) {
+    if (a ? r.mesh_lod = l : r.mesh_lod = s.lastLodLevel_Mesh, k && r.mesh_lod != s.lastLodLevel_Mesh) {
       const x = u?.[r.mesh_lod];
       x && console.debug(`Mesh LOD changed: ${s.lastLodLevel_Mesh} → ${r.mesh_lod} (density: ${x.densities?.[c].toFixed(0)}) | ${e.name}`);
     }
     if (v) {
       const d = "saveData" in globalThis.navigator && globalThis.navigator.saveData === !0;
       if (s.lastLodLevel_Texture < 0) {
-        if (r.texture_lod = _.max_count - 1, C) {
+        if (r.texture_lod = _.max_count - 1, k) {
           const x = _.lods[_.max_count - 1];
-          C && console.log(`First Texture LOD ${r.texture_lod} (${x.max_height}px) - ${e.name}`);
+          k && console.log(`First Texture LOD ${r.texture_lod} (${x.max_height}px) - ${e.name}`);
         }
       } else {
         const x = s.lastScreenspaceVolume.x + s.lastScreenspaceVolume.y + s.lastScreenspaceVolume.z;
@@ -1205,7 +1208,7 @@ class L {
         for (let S = _.lods.length - 1; S >= 0; S--) {
           const w = _.lods[S];
           if (!(d && w.max_height >= 2048) && !(Ae() && w.max_height > 4096) && (w.max_height > b || !z && S === 0)) {
-            if (z = !0, r.texture_lod = S, C && r.texture_lod < s.lastLodLevel_Texture) {
+            if (z = !0, r.texture_lod = S, k && r.texture_lod < s.lastLodLevel_Texture) {
               const m = w.max_height;
               console.log(`Texture LOD changed: ${s.lastLodLevel_Texture} → ${r.texture_lod} = ${m}px 
 Screensize: ${b.toFixed(0)}px, Coverage: ${(100 * s.lastScreenCoverage).toFixed(2)}%, Volume ${x.toFixed(1)} 
@@ -1227,16 +1230,16 @@ class pt {
   lastScreenspaceVolume = new A();
   lastCentrality = 0;
 }
-const ve = Symbol("NEEDLE_mesh_lod"), se = Symbol("NEEDLE_texture_lod");
+const ve = Symbol("NEEDLE_mesh_lod"), re = Symbol("NEEDLE_texture_lod");
 let fe = null;
-function Ce() {
+function ke() {
   const i = mt();
   i && (i.mapURLs(function(t) {
     return be(), t;
   }), be(), fe?.disconnect(), fe = new MutationObserver((t) => {
     t.forEach((e) => {
       e.addedNodes.forEach((s) => {
-        s instanceof HTMLElement && s.tagName.toLowerCase() === "model-viewer" && ke(s);
+        s instanceof HTMLElement && s.tagName.toLowerCase() === "model-viewer" && Ce(s);
       });
     });
   }), fe.observe(document, { childList: !0, subtree: !0 }));
@@ -1245,18 +1248,18 @@ function mt() {
   if (typeof customElements > "u") return null;
   const i = customElements.get("model-viewer");
   return i || (customElements.whenDefined("model-viewer").then(() => {
-    console.debug("[gltf-progressive] model-viewer defined"), Ce();
+    console.debug("[gltf-progressive] model-viewer defined"), ke();
   }), null);
 }
 function be() {
   if (typeof document > "u") return;
   document.querySelectorAll("model-viewer").forEach((t) => {
-    ke(t);
+    Ce(t);
   });
 }
 const Me = /* @__PURE__ */ new WeakSet();
 let yt = 0;
-function ke(i) {
+function Ce(i) {
   if (!i || Me.has(i))
     return null;
   Me.add(i), console.debug("[gltf-progressive] found new model-viewer..." + ++yt + `
@@ -1310,13 +1313,13 @@ class xt {
     return t.element;
   }
   tryParseTextureLOD(t, e) {
-    if (e[se] == !0) return;
-    e[se] = !0;
+    if (e[re] == !0) return;
+    e[re] = !0;
     const s = this.tryGetCurrentGLTF(t), n = this.tryGetCurrentModelViewer(t), r = this.getUrl(n);
     if (r && s && e.material) {
       let o = function(a) {
-        if (a[se] == !0) return;
-        a[se] = !0, a.userData && (a.userData.LOD = -1);
+        if (a[re] == !0) return;
+        a[re] = !0, a.userData && (a.userData.LOD = -1);
         const u = Object.keys(a);
         for (let c = 0; c < u.length; c++) {
           const p = u[c], _ = a[p];
@@ -1375,14 +1378,14 @@ function wt(...i) {
   const r = L.get(e);
   return n?.enableLODsManager !== !1 && r.enable(), r;
 }
-Ce();
+ke();
 if (!rt) {
   const i = {
     gltfProgressive: {
       useNeedleProgressive: wt,
       LODsManager: L,
       configureLoader: Te,
-      getRaycastMesh: J,
+      getRaycastMesh: Z,
       useRaycastMeshes: ot
     }
   };
@@ -1396,12 +1399,12 @@ export {
   F as EXTENSION_NAME,
   L as LODsManager,
   y as NEEDLE_progressive,
-  Ke as VERSION,
+  je as VERSION,
   Se as addDracoAndKTX2Loaders,
   Te as configureLoader,
   xe as createLoaders,
-  J as getRaycastMesh,
-  Ce as patchModelViewer,
+  Z as getRaycastMesh,
+  ke as patchModelViewer,
   nt as registerRaycastMesh,
   Qe as setDracoDecoderLocation,
   Je as setKTX2TranscoderLocation,