@needle-tools/gltf-progressive 3.4.0-rc → 3.5.0-canary.4d42385

package/gltf-progressive.js

@@ -1,69 +1,69 @@
-import { BufferGeometry as E, Mesh as V, Box3 as he, Vector3 as C, Sphere as De, CompressedTexture as Be, Texture as F, Matrix3 as Ge, InterleavedBuffer as Fe, InterleavedBufferAttribute as We, BufferAttribute as Ue, TextureLoader as ze, Matrix4 as Le, Clock as Ne, MeshStandardMaterial as qe } from "three";
-import { GLTFLoader as ye } from "three/examples/jsm/loaders/GLTFLoader.js";
+import { BufferGeometry as E, Mesh as X, Box3 as ge, Vector3 as A, Sphere as Se, CompressedTexture as Ge, Texture as F, Matrix3 as Fe, InterleavedBuffer as We, InterleavedBufferAttribute as Ue, BufferAttribute as ze, TextureLoader as qe, Matrix4 as ve, Clock as Ne, MeshStandardMaterial as Ve } from "three";
+import { GLTFLoader as xe } from "three/examples/jsm/loaders/GLTFLoader.js";
 import { MeshoptDecoder as Ee } 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 je = "";
-globalThis.GLTF_PROGRESSIVE_VERSION = je;
+import { DRACOLoader as Xe } from "three/examples/jsm/loaders/DRACOLoader.js";
+import { KTX2Loader as je } from "three/examples/jsm/loaders/KTX2Loader.js";
+const Ke = "";
+globalThis.GLTF_PROGRESSIVE_VERSION = Ke;
 console.debug("[gltf-progressive] version -");
-let R = "https://www.gstatic.com/draco/versioned/decoders/1.5.7/", X = "https://cdn.needle.tools/static/three/0.179.1/basis2/";
-const Ye = R, Ke = X, Oe = new URL(R + "draco_decoder.js");
-Oe.searchParams.append("range", "true");
-fetch(Oe, {
+let I = "https://www.gstatic.com/draco/versioned/decoders/1.5.7/", j = "https://cdn.needle.tools/static/three/0.179.1/basis2/";
+const Ye = I, He = j, Pe = new URL(I + "draco_decoder.js");
+Pe.searchParams.append("range", "true");
+fetch(Pe, {
   method: "GET",
   headers: {
     Range: "bytes=0-1"
   }
 }).catch((n) => {
-  console.debug(`Failed to fetch remote Draco decoder from ${R} (offline: ${typeof navigator < "u" ? navigator.onLine : "unknown"})`), R === Ye && Qe("./include/draco/"), X === Ke && Je("./include/ktx2/");
+  console.debug(`Failed to fetch remote Draco decoder from ${I} (offline: ${typeof navigator < "u" ? navigator.onLine : "unknown"})`), I === Ye && Je("./include/draco/"), j === He && Ze("./include/ktx2/");
 }).finally(() => {
-  Pe();
+  Ce();
 });
-const He = () => ({
-  dracoDecoderPath: R,
-  ktx2TranscoderPath: X
+const Qe = () => ({
+  dracoDecoderPath: I,
+  ktx2TranscoderPath: j
 });
-function Qe(n) {
-  R = n, A && A[ge] != R ? (console.debug("Updating Draco decoder path to " + n), A[ge] = R, A.setDecoderPath(R), A.preload()) : console.debug("Setting Draco decoder path to " + n);
-}
 function Je(n) {
-  X = n, $ && $.transcoderPath != X ? (console.debug("Updating KTX2 transcoder path to " + n), $.setTranscoderPath(X), $.init()) : console.debug("Setting KTX2 transcoder path to " + n);
+  I = n, C && C[pe] != I ? (console.debug("Updating Draco decoder path to " + n), C[pe] = I, C.setDecoderPath(I), C.preload()) : console.debug("Setting Draco decoder path to " + n);
+}
+function Ze(n) {
+  j = n, $ && $.transcoderPath != j ? (console.debug("Updating KTX2 transcoder path to " + n), $.setTranscoderPath(j), $.init()) : console.debug("Setting KTX2 transcoder path to " + n);
 }
-function xe(n) {
-  return Pe(), n ? $.detectSupport(n) : n !== null && console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures might fail"), { dracoLoader: A, ktx2Loader: $, meshoptDecoder: oe };
+function we(n) {
+  return Ce(), n ? $.detectSupport(n) : n !== null && console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures might fail"), { dracoLoader: C, ktx2Loader: $, meshoptDecoder: oe };
 }
-function Se(n) {
-  n.dracoLoader || n.setDRACOLoader(A), n.ktx2Loader || n.setKTX2Loader($), n.meshoptDecoder || n.setMeshoptDecoder(oe);
+function Te(n) {
+  n.dracoLoader || n.setDRACOLoader(C), n.ktx2Loader || n.setKTX2Loader($), n.meshoptDecoder || n.setMeshoptDecoder(oe);
 }
-const ge = /* @__PURE__ */ Symbol("dracoDecoderPath");
-let A, oe, $;
-function Pe() {
-  A || (A = new Ve(), A[ge] = R, A.setDecoderPath(R), A.setDecoderConfig({ type: "js" }), A.preload()), $ || ($ = new Xe(), $.setTranscoderPath(X), $.init()), oe || (oe = Ee);
+const pe = /* @__PURE__ */ Symbol("dracoDecoderPath");
+let C, oe, $;
+function Ce() {
+  C || (C = new Xe(), C[pe] = I, C.setDecoderPath(I), C.setDecoderConfig({ type: "js" }), C.preload()), $ || ($ = new je(), $.setTranscoderPath(j), $.init()), oe || (oe = Ee);
 }
-const pe = /* @__PURE__ */ new WeakMap();
-function Te(n, t) {
-  let e = pe.get(n);
-  e ? e = Object.assign(e, t) : e = t, pe.set(n, e);
+const me = /* @__PURE__ */ new WeakMap();
+function Ae(n, t) {
+  let e = me.get(n);
+  e ? e = Object.assign(e, t) : e = t, me.set(n, e);
 }
-const Ze = ye.prototype.load;
-function et(...n) {
-  const t = pe.get(this);
+const et = xe.prototype.load;
+function tt(...n) {
+  const t = me.get(this);
   let e = n[0];
   const s = new URL(e, window.location.href);
   if (s.hostname.endsWith("needle.tools")) {
-    const r = t?.progressive !== void 0 ? t.progressive : !0, i = t?.usecase ? t.usecase : "default";
-    r ? this.requestHeader.Accept = `*/*;progressive=allowed;usecase=${i}` : this.requestHeader.Accept = `*/*;usecase=${i}`, e = s.toString();
+    const i = t?.progressive !== void 0 ? t.progressive : !0, o = t?.usecase ? t.usecase : "default";
+    i ? this.requestHeader.Accept = `*/*;progressive=allowed;usecase=${o}` : this.requestHeader.Accept = `*/*;usecase=${o}`, e = s.toString();
   }
-  return n[0] = e, Ze?.call(this, ...n);
+  return n[0] = e, et?.call(this, ...n);
 }
-ye.prototype.load = et;
-j("debugprogressive");
-function j(n) {
+xe.prototype.load = tt;
+q("debugprogressive");
+function q(n) {
   if (typeof window > "u") return !1;
   const e = new URL(window.location.href).searchParams.get(n);
   return e == null || e === "0" || e === "false" ? !1 : e === "" ? !0 : e;
 }
-function tt(n, t) {
+function st(n, t) {
   if (t === void 0 || n === void 0 || t.startsWith("./") || t.startsWith("http") || t.startsWith("data:") || t.startsWith("blob:"))
     return t;
   const e = n.lastIndexOf("/");
@@ -74,18 +74,18 @@ function tt(n, t) {
   }
   return t;
 }
-function Ae() {
-  return K !== void 0 || (K = /iPhone|iPad|iPod|Android|IEMobile/i.test(navigator.userAgent), j("debugprogressive") && console.log("[glTF Progressive]: isMobileDevice", K)), K;
-}
-let K;
 function _e() {
+  return H !== void 0 || (H = /iPhone|iPad|iPod|Android|IEMobile/i.test(navigator.userAgent), q("debugprogressive") && console.log("[glTF Progressive]: isMobileDevice", H)), H;
+}
+let H;
+function be() {
   if (typeof window > "u") return !1;
   const n = new URL(window.location.href), t = n.hostname === "localhost" || /^\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}$/.test(n.hostname);
   return n.hostname === "127.0.0.1" || t;
 }
-class st {
-  constructor(t = 100, e = {}) {
-    this.maxConcurrent = t, this.debug = e.debug ?? !1, window.requestAnimationFrame(this.tick);
+class rt {
+  constructor(t, e = {}) {
+    this.maxConcurrent = t, this.debug = e.debug ?? !1, typeof window < "u" && window.requestAnimationFrame(this.tick);
   }
   _running = /* @__PURE__ */ new Map();
   _queue = [];
@@ -110,87 +110,99 @@ class st {
     const t = this.maxConcurrent - this._running.size;
     for (let e = 0; e < t && this._queue.length > 0; e++) {
       this.debug && console.debug(`[PromiseQueue]: Running ${this._running.size} promises, waiting for ${this._queue.length} more.`);
-      const { key: s, resolve: o } = this._queue.shift();
-      o({
-        use: (r) => this.add(s, r)
+      const { key: s, resolve: r } = this._queue.shift();
+      r({
+        use: (i) => this.add(s, i)
       });
     }
   }
 }
-const rt = typeof window > "u" && typeof document > "u", me = /* @__PURE__ */ Symbol("needle:raycast-mesh");
-function Z(n) {
-  return n?.[me] instanceof E ? n[me] : null;
+function it(n) {
+  const t = n.image?.width ?? 0, e = n.image?.height ?? 0, s = n.image?.depth ?? 1, r = Math.floor(Math.log2(Math.max(t, e, s))) + 1, i = ot(n);
+  return t * e * s * i * (1 - Math.pow(0.25, r)) / (1 - 0.25);
+}
+function ot(n) {
+  let t = 4;
+  const e = n.format;
+  e === 1024 || e === 1025 ? t = 1 : e === 1026 || e === 1027 ? t = 2 : e === 1022 || e === 1029 ? t = 3 : (e === 1023 || e === 1033) && (t = 4);
+  let s = 1;
+  const r = n.type;
+  return r === 1009 || r === 1010 ? s = 1 : r === 1011 || r === 1012 ? s = 2 : r === 1013 || r === 1014 || r === 1015 ? s = 4 : r === 1016 && (s = 2), t * s;
 }
-function ot(n, t) {
-  if ((n.type === "Mesh" || n.type === "SkinnedMesh") && !Z(n)) {
-    const s = nt(t);
-    s.userData = { isRaycastMesh: !0 }, n[me] = s;
+const nt = typeof window > "u" && typeof document > "u", ye = /* @__PURE__ */ Symbol("needle:raycast-mesh");
+function ee(n) {
+  return n?.[ye] instanceof E ? n[ye] : null;
+}
+function at(n, t) {
+  if ((n.type === "Mesh" || n.type === "SkinnedMesh") && !ee(n)) {
+    const s = ut(t);
+    s.userData = { isRaycastMesh: !0 }, n[ye] = s;
   }
 }
-function it(n = !0) {
+function lt(n = !0) {
   if (n) {
-    if (H) return;
-    const t = H = V.prototype.raycast;
-    V.prototype.raycast = function(e, s) {
-      const o = this, r = Z(o);
-      let i;
-      r && o.isMesh && (i = o.geometry, o.geometry = r), t.call(this, e, s), i && (o.geometry = i);
+    if (Q) return;
+    const t = Q = X.prototype.raycast;
+    X.prototype.raycast = function(e, s) {
+      const r = this, i = ee(r);
+      let o;
+      i && r.isMesh && (o = r.geometry, r.geometry = i), t.call(this, e, s), o && (r.geometry = o);
     };
   } else {
-    if (!H) return;
-    V.prototype.raycast = H, H = null;
+    if (!Q) return;
+    X.prototype.raycast = Q, Q = null;
   }
 }
-let H = null;
-function nt(n) {
+let Q = null;
+function ut(n) {
   const t = new E();
   for (const e in n.attributes)
     t.setAttribute(e, n.getAttribute(e));
   return t.setIndex(n.getIndex()), t;
 }
-const z = new Array(), g = j("debugprogressive");
-let J, q = -1;
-if (g) {
+const z = new Array(), f = q("debugprogressive");
+let Z, V = -1;
+if (f) {
   let n = function() {
-    q += 1, q >= t && (q = -1), console.log(`Toggle LOD level [${q}]`);
+    V += 1, V >= t && (V = -1), console.log(`Toggle LOD level [${V}]`);
   }, t = 6;
   window.addEventListener("keyup", (e) => {
-    e.key === "p" && n(), e.key === "w" && (J = !J, console.log(`Toggle wireframe [${J}]`));
+    e.key === "p" && n(), e.key === "w" && (Z = !Z, console.log(`Toggle wireframe [${Z}]`));
     const s = parseInt(e.key);
-    !isNaN(s) && s >= 0 && (q = s, console.log(`Set LOD level to [${q}]`));
+    !isNaN(s) && s >= 0 && (V = s, console.log(`Set LOD level to [${V}]`));
   });
 }
-function Ce(n) {
-  if (g && J !== void 0)
+function ke(n) {
+  if (f && Z !== void 0)
     if (Array.isArray(n))
       for (const t of n)
-        Ce(t);
-    else n && "wireframe" in n && (n.wireframe = J === !0);
+        ke(t);
+    else n && "wireframe" in n && (n.wireframe = Z === !0);
 }
-const Q = new Array();
-let at = 0;
-const lt = Ae() ? 2 : 10;
-function dt(n) {
-  if (Q.length < lt) {
-    const s = Q.length;
-    g && console.warn(`[Worker] Creating new worker #${s}`);
-    const o = we.createWorker(n || {});
-    return Q.push(o), o;
-  }
-  const t = at++ % Q.length;
-  return Q[t];
+const J = new Array();
+let ct = 0;
+const dt = _e() ? 2 : 10;
+function ft(n) {
+  if (J.length < dt) {
+    const s = J.length;
+    f && console.warn(`[Worker] Creating new worker #${s}`);
+    const r = Le.createWorker(n || {});
+    return J.push(r), r;
+  }
+  const t = ct++ % J.length;
+  return J[t];
 }
-class we {
+class Le {
   constructor(t, e) {
     this.worker = t, this._debug = e.debug ?? !1, t.onmessage = (s) => {
-      const o = s.data;
-      switch (this._debug && console.log("[Worker] EVENT", o), o.type) {
+      const r = s.data;
+      switch (this._debug && console.log("[Worker] EVENT", r), r.type) {
         case "loaded-gltf":
-          for (const r of this._running)
-            if (r.url === o.result.url) {
-              ut(o.result), r.resolve(o.result);
-              const i = r.url;
-              i.startsWith("blob:") && URL.revokeObjectURL(i);
+          for (const i of this._running)
+            if (i.url === r.result.url) {
+              ht(r.result), i.resolve(r.result);
+              const o = i.url;
+              o.startsWith("blob:") && URL.revokeObjectURL(o);
             }
       }
     }, t.onerror = (s) => {
@@ -202,23 +214,23 @@ class we {
   static async createWorker(t) {
     const e = new Worker(new URL(
       /* @vite-ignore */
-      "/assets/loader.worker-CCrD-Ycm.js",
+      "/assets/gltf-progressive.worker-CCrD-Ycm.js",
       import.meta.url
     ), {
       type: "module"
     });
-    return new we(e, t);
+    return new Le(e, t);
   }
   _running = [];
   _webglRenderer = null;
   async load(t, e) {
-    const s = He();
-    let o = e?.renderer;
-    o || (this._webglRenderer ??= (async () => {
-      const { WebGLRenderer: d } = await import("three");
-      return new d();
-    })(), o = await this._webglRenderer);
-    const l = xe(o).ktx2Loader.workerConfig;
+    const s = Qe();
+    let r = e?.renderer;
+    r || (this._webglRenderer ??= (async () => {
+      const { WebGLRenderer: u } = await import("three");
+      return new u();
+    })(), r = await this._webglRenderer);
+    const l = we(r).ktx2Loader.workerConfig;
     t instanceof URL ? t = t.toString() : t.startsWith("file:") ? t = URL.createObjectURL(new Blob([t])) : !t.startsWith("blob:") && !t.startsWith("http:") && !t.startsWith("https:") && (t = new URL(t, window.location.href).toString());
     const a = {
       type: "load",
@@ -227,60 +239,60 @@ class we {
       ktx2TranscoderPath: s.ktx2TranscoderPath,
       ktx2LoaderConfig: l
     };
-    return this._debug && console.debug("[Worker] Sending load request", a), this.worker.postMessage(a), new Promise((d) => {
+    return this._debug && console.debug("[Worker] Sending load request", a), this.worker.postMessage(a), new Promise((u) => {
       this._running.push({
         url: t.toString(),
-        resolve: d
+        resolve: u
       });
     });
   }
   _debug = !1;
 }
-function ut(n) {
+function ht(n) {
   for (const t of n.geometries) {
     const e = t.geometry, s = new E();
     if (s.name = e.name || "", e.index) {
-      const o = e.index;
-      s.setIndex(ae(o));
+      const r = e.index;
+      s.setIndex(le(r));
     }
-    for (const o in e.attributes) {
-      const r = e.attributes[o], i = ae(r);
-      s.setAttribute(o, i);
+    for (const r in e.attributes) {
+      const i = e.attributes[r], o = le(i);
+      s.setAttribute(r, o);
     }
     if (e.morphAttributes)
-      for (const o in e.morphAttributes) {
-        const i = e.morphAttributes[o].map((l) => ae(l));
-        s.morphAttributes[o] = i;
+      for (const r in e.morphAttributes) {
+        const o = e.morphAttributes[r].map((l) => le(l));
+        s.morphAttributes[r] = o;
       }
-    if (s.morphTargetsRelative = e.morphTargetsRelative ?? !1, s.boundingBox = new he(), s.boundingBox.min = new C(
+    if (s.morphTargetsRelative = e.morphTargetsRelative ?? !1, s.boundingBox = new ge(), s.boundingBox.min = new A(
       e.boundingBox?.min.x,
       e.boundingBox?.min.y,
       e.boundingBox?.min.z
-    ), s.boundingBox.max = new C(
+    ), s.boundingBox.max = new A(
       e.boundingBox?.max.x,
       e.boundingBox?.max.y,
       e.boundingBox?.max.z
-    ), s.boundingSphere = new De(
-      new C(
+    ), s.boundingSphere = new Se(
+      new A(
         e.boundingSphere?.center.x,
         e.boundingSphere?.center.y,
         e.boundingSphere?.center.z
       ),
       e.boundingSphere?.radius
     ), e.groups)
-      for (const o of e.groups)
-        s.addGroup(o.start, o.count, o.materialIndex);
+      for (const r of e.groups)
+        s.addGroup(r.start, r.count, r.materialIndex);
     e.userData && (s.userData = e.userData), t.geometry = s;
   }
   for (const t of n.textures) {
     const e = t.texture;
     let s = null;
     if (e.isCompressedTexture) {
-      const o = e.mipmaps, r = e.image?.width || e.source?.data?.width || -1, i = e.image?.height || e.source?.data?.height || -1;
-      s = new Be(
-        o,
+      const r = e.mipmaps, i = e.image?.width || e.source?.data?.width || -1, o = e.image?.height || e.source?.data?.height || -1;
+      s = new Ge(
         r,
         i,
+        o,
         e.format,
         e.type,
         e.mapping,
@@ -303,7 +315,7 @@ function ut(n) {
         e.type,
         e.anisotropy,
         e.colorSpace
-      ), s.mipmaps = e.mipmaps, s.channel = e.channel, s.source.data = e.source.data, s.flipY = e.flipY, s.premultiplyAlpha = e.premultiplyAlpha, s.unpackAlignment = e.unpackAlignment, s.matrix = new Ge(...e.matrix.elements);
+      ), s.mipmaps = e.mipmaps, s.channel = e.channel, s.source.data = e.source.data, s.flipY = e.flipY, s.premultiplyAlpha = e.premultiplyAlpha, s.unpackAlignment = e.unpackAlignment, s.matrix = new Fe(...e.matrix.elements);
     if (!s) {
       console.error("[Worker] Failed to create new texture from received data. Texture is not a CompressedTexture or Texture.");
       continue;
@@ -312,32 +324,57 @@ function ut(n) {
   }
   return n;
 }
-function ae(n) {
+function le(n) {
   let t = n;
   if ("isInterleavedBufferAttribute" in n && n.isInterleavedBufferAttribute) {
-    const e = n.data, s = e.array, o = new Fe(s, e.stride);
-    t = new We(o, n.itemSize, s.byteOffset, n.normalized), t.offset = n.offset;
-  } else "isBufferAttribute" in n && n.isBufferAttribute && (t = new Ue(n.array, n.itemSize, n.normalized), t.usage = n.usage, t.gpuType = n.gpuType, t.updateRanges = n.updateRanges);
+    const e = n.data, s = e.array, r = new We(s, e.stride);
+    t = new Ue(r, n.itemSize, s.byteOffset, n.normalized), t.offset = n.offset;
+  } else "isBufferAttribute" in n && n.isBufferAttribute && (t = new ze(n.array, n.itemSize, n.normalized), t.usage = n.usage, t.gpuType = n.gpuType, t.updateRanges = n.updateRanges);
   return t;
 }
-const ct = j("gltf-progressive-worker"), ft = j("gltf-progressive-reduce-mipmaps"), le = /* @__PURE__ */ Symbol("needle-progressive-texture"), W = "NEEDLE_progressive";
+const gt = q("gltf-progressive-worker");
+q("gltf-progressive-reduce-mipmaps");
+const K = q("gltf-progressive-gc"), ue = /* @__PURE__ */ Symbol("needle-progressive-texture"), W = "NEEDLE_progressive";
 class m {
   /** The name of the extension */
   get name() {
     return W;
   }
   // #region PUBLIC API
+  /**
+   * Get the progressive mesh LOD extension data associated with a geometry.
+   * Returns the extension metadata (available LOD levels, vertex/index counts, densities) if the geometry was registered with progressive LODs, or `null` otherwise.
+   *
+   * @param geo - The buffer geometry to look up.
+   * @returns The mesh LOD extension data, or `null` if no progressive LODs are registered for this geometry.
+   */
   static getMeshLODExtension(t) {
     const e = this.getAssignedLODInformation(t);
     return e?.key ? this.lodInfos.get(e.key) : null;
   }
+  /**
+   * Get the glTF primitive index for a geometry within its parent mesh.
+   * A single glTF mesh node can contain multiple primitives (sub-geometries). This returns which primitive the geometry corresponds to.
+   *
+   * @param geo - The buffer geometry to look up.
+   * @returns The zero-based primitive index, or `-1` if no LOD information is assigned to this geometry.
+   */
   static getPrimitiveIndex(t) {
     const e = this.getAssignedLODInformation(t)?.index;
     return e ?? -1;
   }
+  /**
+   * Compute the minimum and maximum number of texture LOD levels across all textures of a material (or array of materials).
+   * Iterates over all texture slots on the material and collects LOD count ranges and per-level resolution bounds.
+   * Results are cached on the material so subsequent calls are free.
+   *
+   * @param material - A single material or an array of materials to inspect.
+   * @param minmax - Optional accumulator to merge results into (used internally for recursive calls with material arrays).
+   * @returns An object with `min_count` / `max_count` (the range of LOD levels across all textures) and a per-level `lods` array with `min_height` / `max_height`.
+   */
   static getMaterialMinMaxLODsCount(t, e) {
-    const s = this, o = "LODS:minmax", r = t[o];
-    if (r != null) return r;
+    const s = this, r = "LODS:minmax", i = t[r];
+    if (i != null) return i;
     if (e || (e = {
       min_count: 1 / 0,
       max_count: 0,
@@ -345,30 +382,30 @@ class m {
     }), Array.isArray(t)) {
       for (const l of t)
         this.getMaterialMinMaxLODsCount(l, e);
-      return t[o] = e, e;
+      return t[r] = e, e;
     }
-    if (g === "verbose" && console.log("getMaterialMinMaxLODsCount", t), t.type === "ShaderMaterial" || t.type === "RawShaderMaterial") {
+    if (f === "verbose" && console.log("getMaterialMinMaxLODsCount", t), t.type === "ShaderMaterial" || t.type === "RawShaderMaterial") {
       const l = t;
       for (const a of Object.keys(l.uniforms)) {
-        const d = l.uniforms[a].value;
-        d?.isTexture === !0 && i(d, e);
+        const u = l.uniforms[a].value;
+        u?.isTexture === !0 && o(u, e);
       }
     } else if (t.isMaterial)
       for (const l of Object.keys(t)) {
         const a = t[l];
-        a?.isTexture === !0 && i(a, e);
+        a?.isTexture === !0 && o(a, e);
       }
     else
-      g && console.warn(`[getMaterialMinMaxLODsCount] Unsupported material type: ${t.type}`);
-    return t[o] = e, e;
-    function i(l, a) {
-      const d = s.getAssignedLODInformation(l);
-      if (d) {
-        const u = s.lodInfos.get(d.key);
-        if (u && u.lods) {
-          a.min_count = Math.min(a.min_count, u.lods.length), a.max_count = Math.max(a.max_count, u.lods.length);
-          for (let y = 0; y < u.lods.length; y++) {
-            const w = u.lods[y];
+      f && console.warn(`[getMaterialMinMaxLODsCount] Unsupported material type: ${t.type}`);
+    return t[r] = e, e;
+    function o(l, a) {
+      const u = s.getAssignedLODInformation(l);
+      if (u) {
+        const c = s.lodInfos.get(u.key);
+        if (c && c.lods) {
+          a.min_count = Math.min(a.min_count, c.lods.length), a.max_count = Math.max(a.max_count, c.lods.length);
+          for (let y = 0; y < c.lods.length; y++) {
+            const w = c.lods[y];
             w.width && (a.lods[y] = a.lods[y] || { min_height: 1 / 0, max_height: 0 }, a.lods[y].min_height = Math.min(a.lods[y].min_height, w.height), a.lods[y].max_height = Math.max(a.lods[y].max_height, w.height));
           }
         }
@@ -382,28 +419,28 @@ class m {
    */
   static hasLODLevelAvailable(t, e) {
     if (Array.isArray(t)) {
-      for (const r of t)
-        if (this.hasLODLevelAvailable(r, e)) return !0;
+      for (const i of t)
+        if (this.hasLODLevelAvailable(i, e)) return !0;
       return !1;
     }
     if (t.isMaterial === !0) {
-      for (const r of Object.keys(t)) {
-        const i = t[r];
-        if (i && i.isTexture && this.hasLODLevelAvailable(i, e))
+      for (const i of Object.keys(t)) {
+        const o = t[i];
+        if (o && o.isTexture && this.hasLODLevelAvailable(o, e))
           return !0;
       }
       return !1;
     } else if (t.isGroup === !0) {
-      for (const r of t.children)
-        if (r.isMesh === !0 && this.hasLODLevelAvailable(r, e))
+      for (const i of t.children)
+        if (i.isMesh === !0 && this.hasLODLevelAvailable(i, e))
           return !0;
     }
-    let s, o;
+    let s, r;
     if (t.isMesh ? s = t.geometry : (t.isBufferGeometry || t.isTexture) && (s = t), s && s?.userData?.LODS) {
-      const r = s.userData.LODS;
-      if (o = this.lodInfos.get(r.key), e === void 0) return o != null;
-      if (o)
-        return Array.isArray(o.lods) ? e < o.lods.length : e === 0;
+      const i = s.userData.LODS;
+      if (r = this.lodInfos.get(i.key), e === void 0) return r != null;
+      if (r)
+        return Array.isArray(r.lods) ? e < r.lods.length : e === 0;
     }
     return !1;
   }
@@ -423,20 +460,20 @@ class m {
    */
   static assignMeshLOD(t, e) {
     if (!t) return Promise.resolve(null);
-    if (t instanceof V || t.isMesh === !0) {
-      const s = t.geometry, o = this.getAssignedLODInformation(s);
-      if (!o)
+    if (t instanceof X || t.isMesh === !0) {
+      const s = t.geometry, r = this.getAssignedLODInformation(s);
+      if (!r)
         return Promise.resolve(null);
-      for (const r of z)
-        r.onBeforeGetLODMesh?.(t, e);
-      return t["LOD:requested level"] = e, m.getOrLoadLOD(s, e).then((r) => {
-        if (Array.isArray(r)) {
-          const i = o.index || 0;
-          r = r[i];
+      for (const i of z)
+        i.onBeforeGetLODMesh?.(t, e);
+      return t["LOD:requested level"] = e, m.getOrLoadLOD(s, e).then((i) => {
+        if (Array.isArray(i)) {
+          const o = r.index || 0;
+          i = i[o];
         }
-        return t["LOD:requested level"] === e && (delete t["LOD:requested level"], r && s != r && (r?.isBufferGeometry ? t.geometry = r : g && console.error("Invalid LOD geometry", r))), r;
-      }).catch((r) => (console.error("Error loading mesh LOD", t, r), null));
-    } else g && console.error("Invalid call to assignMeshLOD: Request mesh LOD but the object is not a mesh", t);
+        return t["LOD:requested level"] === e && (delete t["LOD:requested level"], i && s != i && (i?.isBufferGeometry ? t.geometry = i : f && console.error("Invalid LOD geometry", i))), i;
+      }).catch((i) => (console.error("Error loading mesh LOD", t, i), null));
+    } else f && console.error("Invalid call to assignMeshLOD: Request mesh LOD but the object is not a mesh", t);
     return Promise.resolve(null);
   }
   static assignTextureLOD(t, e = 0) {
@@ -444,44 +481,44 @@ class m {
     if (t.isMesh === !0) {
       const s = t;
       if (Array.isArray(s.material)) {
-        const o = new Array();
-        for (const r of s.material) {
-          const i = this.assignTextureLOD(r, e);
-          o.push(i);
+        const r = new Array();
+        for (const i of s.material) {
+          const o = this.assignTextureLOD(i, e);
+          r.push(o);
         }
-        return Promise.all(o).then((r) => {
-          const i = new Array();
-          for (const l of r)
-            Array.isArray(l) && i.push(...l);
-          return i;
+        return Promise.all(r).then((i) => {
+          const o = new Array();
+          for (const l of i)
+            Array.isArray(l) && o.push(...l);
+          return o;
         });
       } else
         return this.assignTextureLOD(s.material, e);
     }
     if (t.isMaterial === !0) {
-      const s = t, o = [], r = new Array();
+      const s = t, r = [], i = new Array();
       if (s.uniforms && (s.isRawShaderMaterial || s.isShaderMaterial === !0)) {
-        const i = s;
-        for (const l of Object.keys(i.uniforms)) {
-          const a = i.uniforms[l].value;
+        const o = s;
+        for (const l of Object.keys(o.uniforms)) {
+          const a = o.uniforms[l].value;
           if (a?.isTexture === !0) {
-            const d = this.assignTextureLODForSlot(a, e, s, l).then((u) => (u && i.uniforms[l].value != u && (i.uniforms[l].value = u, i.uniformsNeedUpdate = !0), u));
-            o.push(d), r.push(l);
+            const u = this.assignTextureLODForSlot(a, e, s, l).then((c) => (c && o.uniforms[l].value != c && (o.uniforms[l].value = c, o.uniformsNeedUpdate = !0), c));
+            r.push(u), i.push(l);
           }
         }
       } else
-        for (const i of Object.keys(s)) {
-          const l = s[i];
+        for (const o of Object.keys(s)) {
+          const l = s[o];
           if (l?.isTexture === !0) {
-            const a = this.assignTextureLODForSlot(l, e, s, i);
-            o.push(a), r.push(i);
+            const a = this.assignTextureLODForSlot(l, e, s, o);
+            r.push(a), i.push(o);
           }
         }
-      return Promise.all(o).then((i) => {
+      return Promise.all(r).then((o) => {
         const l = new Array();
-        for (let a = 0; a < i.length; a++) {
-          const d = i[a], u = r[a];
-          d && d.isTexture === !0 ? l.push({ material: s, slot: u, texture: d, level: e }) : l.push({ material: s, slot: u, texture: null, level: e });
+        for (let a = 0; a < o.length; a++) {
+          const u = o[a], c = i[a];
+          u && u.isTexture === !0 ? l.push({ material: s, slot: c, texture: u, level: e }) : l.push({ material: s, slot: c, texture: null, level: e });
         }
         return l;
       });
@@ -492,35 +529,45 @@ class m {
     }
     return Promise.resolve(null);
   }
+  /**
+   * Set the maximum number of concurrent loading tasks for LOD resources. This limits how many LOD resources (meshes or textures) can be loaded at the same time to prevent overloading the network or GPU. If the limit is reached, additional loading requests will be queued and processed as previous ones finish.
+   * @default 50 on desktop, 20 on mobile devices
+   */
+  static set maxConcurrentLoadingTasks(t) {
+    m.queue.maxConcurrent = t;
+  }
+  static get maxConcurrentLoadingTasks() {
+    return m.queue.maxConcurrent;
+  }
   // #region INTERNAL
-  static assignTextureLODForSlot(t, e, s, o) {
-    return t?.isTexture !== !0 ? Promise.resolve(null) : o === "glyphMap" ? Promise.resolve(t) : m.getOrLoadLOD(t, e).then((r) => {
-      if (Array.isArray(r))
+  static assignTextureLODForSlot(t, e, s, r) {
+    return t?.isTexture !== !0 ? Promise.resolve(null) : r === "glyphMap" ? Promise.resolve(t) : m.getOrLoadLOD(t, e).then((i) => {
+      if (Array.isArray(i))
         return console.warn("Progressive: Got an array of textures for a texture slot, this should not happen..."), null;
-      if (r?.isTexture === !0) {
-        if (r != t && s && o) {
-          const i = s[o];
-          if (i && !g) {
-            const l = this.getAssignedLODInformation(i);
+      if (i?.isTexture === !0) {
+        if (i != t && s && r) {
+          const o = s[r];
+          if (o && !f) {
+            const l = this.getAssignedLODInformation(o);
             if (l && l?.level < e)
-              return g === "verbose" && console.warn("Assigned texture level is already higher: ", l.level, e, s, i, r), null;
+              return f === "verbose" && console.warn("Assigned texture level is already higher: ", l.level, e, s, o, i), i && i !== o && ((f || K) && console.log(`[gltf-progressive] Disposing rejected lower-quality texture LOD ${e} (assigned is ${l.level})`, i.uuid), i.dispose()), null;
           }
-          if (ft && r.mipmaps) {
-            const l = r.mipmaps.length;
-            r.mipmaps.length = Math.min(r.mipmaps.length, 3), l !== r.mipmaps.length && g && console.debug(`Reduced mipmap count from ${l} to ${r.mipmaps.length} for ${r.uuid}: ${r.image?.width}x${r.image?.height}.`);
+          if (this.trackTextureUsage(i), o && o !== i && this.untrackTextureUsage(o) && (f || K)) {
+            const a = this.getAssignedLODInformation(o);
+            console.log(`[gltf-progressive] Disposed old texture LOD ${a?.level ?? "?"} → ${e} for ${s.name || s.type}.${r}`, o.uuid);
           }
-          s[o] = r;
+          s[r] = i;
         }
-        return r;
-      } else g == "verbose" && console.warn("No LOD found for", t, e);
+        return i;
+      } else f == "verbose" && console.warn("No LOD found for", t, e);
       return null;
-    }).catch((r) => (console.error("Error loading LOD", t, r), null));
+    }).catch((i) => (console.error("Error loading LOD", t, i), null));
   }
   parser;
   url;
   constructor(t) {
     const e = t.options.path;
-    g && console.log("Progressive extension registered for", e), this.parser = t, this.url = e;
+    f && console.log("Progressive extension registered for", e), this.parser = t, this.url = e;
   }
   _isLoadingMesh;
   loadMesh = (t) => {
@@ -543,70 +590,89 @@ class m {
   //     });
   // }
   afterRoot(t) {
-    return g && console.log("AFTER", this.url, t), this.parser.json.textures?.forEach((e, s) => {
+    return f && console.log("AFTER", this.url, t), this.parser.json.textures?.forEach((e, s) => {
       if (e?.extensions) {
-        const o = e?.extensions[W];
-        if (o) {
-          if (!o.lods) {
-            g && console.warn("Texture has no LODs", o);
+        const r = e?.extensions[W];
+        if (r) {
+          if (!r.lods) {
+            f && console.warn("Texture has no LODs", r);
             return;
           }
-          let r = !1;
-          for (const i of this.parser.associations.keys())
-            i.isTexture === !0 && this.parser.associations.get(i)?.textures === s && (r = !0, m.registerTexture(this.url, i, o.lods?.length, s, o));
-          r || this.parser.getDependency("texture", s).then((i) => {
-            i && m.registerTexture(this.url, i, o.lods?.length, s, o);
+          let i = !1;
+          for (const o of this.parser.associations.keys())
+            o.isTexture === !0 && this.parser.associations.get(o)?.textures === s && (i = !0, m.registerTexture(this.url, o, r.lods?.length, s, r));
+          i || this.parser.getDependency("texture", s).then((o) => {
+            o && m.registerTexture(this.url, o, r.lods?.length, s, r);
           });
         }
       }
     }), this.parser.json.meshes?.forEach((e, s) => {
       if (e?.extensions) {
-        const o = e?.extensions[W];
-        if (o && o.lods) {
-          for (const r of this.parser.associations.keys())
-            if (r.isMesh) {
-              const i = this.parser.associations.get(r);
-              i?.meshes === s && m.registerMesh(this.url, o.guid, r, o.lods.length, i.primitives, o);
+        const r = e?.extensions[W];
+        if (r && r.lods) {
+          for (const i of this.parser.associations.keys())
+            if (i.isMesh) {
+              const o = this.parser.associations.get(i);
+              o?.meshes === s && m.registerMesh(this.url, r.guid, i, r.lods.length, o.primitives, r);
             }
         }
       }
     }), null;
   }
   /**
-   * Register a texture with LOD information
+   * Register a texture with progressive LOD information. This associates the texture with its LOD extension data
+   * so the LODs manager can later swap it for higher or lower resolution versions based on screen coverage.
+   * Typically called during glTF loading when the progressive extension is parsed.
+   *
+   * @param url - The source URL of the glTF file this texture was loaded from.
+   * @param tex - The three.js Texture instance to register.
+   * @param level - The LOD level this texture represents (0 = highest resolution).
+   * @param index - The texture index within the glTF file.
+   * @param ext - The parsed progressive texture extension data containing all available LOD levels and their dimensions.
    */
-  static registerTexture = (t, e, s, o, r) => {
+  static registerTexture = (t, e, s, r, i) => {
     if (!e) {
-      g && console.error("!! gltf-progressive: Called register texture without texture");
+      f && console.error("!! gltf-progressive: Called register texture without texture");
       return;
     }
-    if (g) {
+    if (f) {
       const l = e.image?.width || e.source?.data?.width || 0, a = e.image?.height || e.source?.data?.height || 0;
-      console.log(`> gltf-progressive: register texture[${o}] "${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[${r}] "${e.name || e.uuid}", Current: ${l}x${a}, Max: ${i.lods[0]?.width}x${i.lods[0]?.height}, uuid: ${e.uuid}`, i, e);
     }
-    e.source && (e.source[le] = r);
-    const i = r.guid;
-    m.assignLODInformation(t, e, i, s, o), m.lodInfos.set(i, r), m.lowresCache.set(i, new WeakRef(e));
+    e.source && (e.source[ue] = i);
+    const o = i.guid;
+    m.assignLODInformation(t, e, o, s, r), m.lodInfos.set(o, i), m.lowresCache.set(o, new WeakRef(e));
   };
   /**
-   * Register a mesh with LOD information
+   * Register a mesh with progressive LOD information. This associates the mesh geometry with its LOD extension data
+   * so the LODs manager can later swap it for higher or lower density versions based on screen coverage.
+   * Typically called during glTF loading when the progressive extension is parsed.
+   * If the mesh is registered at a level > 0 (i.e. not full resolution), a raycast mesh is automatically preserved for accurate picking.
+   *
+   * @param url - The source URL of the glTF file this mesh was loaded from.
+   * @param key - A unique key identifying this mesh's LOD group (typically derived from the extension GUID).
+   * @param mesh - The three.js Mesh instance to register.
+   * @param level - The LOD level this mesh represents (0 = highest resolution / full density).
+   * @param index - The primitive index within the glTF mesh node.
+   * @param ext - The parsed progressive mesh extension data containing all available LOD levels with vertex/index counts and densities.
    */
-  static registerMesh = (t, e, s, o, r, i) => {
+  static registerMesh = (t, e, s, r, i, o) => {
     const l = s.geometry;
     if (!l) {
-      g && console.warn("gltf-progressive: Register mesh without geometry");
+      f && console.warn("gltf-progressive: Register mesh without geometry");
       return;
     }
-    l.userData || (l.userData = {}), g && console.log("> Progressive: register mesh " + s.name, { index: r, uuid: s.uuid }, i, s), m.assignLODInformation(t, l, e, o, r), m.lodInfos.set(e, i);
-    let d = m.lowresCache.get(e)?.deref();
-    d ? d.push(s.geometry) : d = [s.geometry], m.lowresCache.set(e, new WeakRef(d)), o > 0 && !Z(s) && ot(s, l);
-    for (const u of z)
-      u.onRegisteredNewMesh?.(s, i);
+    l.userData || (l.userData = {}), f && console.log("> Progressive: register mesh " + s.name, { index: i, uuid: s.uuid }, o, s), m.assignLODInformation(t, l, e, r, i), m.lodInfos.set(e, o);
+    let u = m.lowresCache.get(e)?.deref();
+    u ? u.push(s.geometry) : u = [s.geometry], m.lowresCache.set(e, new WeakRef(u)), r > 0 && !ee(s) && at(s, l);
+    for (const c of z)
+      c.onRegisteredNewMesh?.(s, o);
   };
   /**
    * Dispose cached resources to free memory.
    * Call this when a model is removed from the scene to allow garbage collection of its LOD resources.
    * Calls three.js `.dispose()` on cached Textures and BufferGeometries to free GPU memory.
+   * Also clears reference counts for disposed textures.
    * @param guid Optional GUID to dispose resources for a specific model. If omitted, all cached resources are cleared.
    */
   static dispose(t) {
@@ -616,236 +682,275 @@ class m {
       if (e) {
         const s = e.deref();
         if (s) {
-          if (s.isTexture)
-            s.dispose();
-          else if (Array.isArray(s))
-            for (const o of s) o.dispose();
+          if (s.isTexture) {
+            const r = s;
+            this.textureRefCounts.delete(r.uuid), r.dispose();
+          } else if (Array.isArray(s))
+            for (const r of s) r.dispose();
         }
         this.lowresCache.delete(t);
       }
-      for (const [s, o] of this.previouslyLoaded)
-        s.includes(t) && (this._disposeCacheEntry(o), this.previouslyLoaded.delete(s));
+      for (const [s, r] of this.cache)
+        s.includes(t) && (this._disposeCacheEntry(r), this.cache.delete(s));
     } else {
       this.lodInfos.clear();
       for (const [, e] of this.lowresCache) {
         const s = e.deref();
         if (s) {
-          if (s.isTexture)
-            s.dispose();
-          else if (Array.isArray(s))
-            for (const o of s) o.dispose();
+          if (s.isTexture) {
+            const r = s;
+            this.textureRefCounts.delete(r.uuid), r.dispose();
+          } else if (Array.isArray(s))
+            for (const r of s) r.dispose();
         }
       }
       this.lowresCache.clear();
-      for (const [, e] of this.previouslyLoaded)
+      for (const [, e] of this.cache)
         this._disposeCacheEntry(e);
-      this.previouslyLoaded.clear();
+      this.cache.clear(), this.textureRefCounts.clear();
     }
   }
   /** Dispose a single cache entry's three.js resource(s) to free GPU memory. */
   static _disposeCacheEntry(t) {
-    t instanceof WeakRef ? t.deref()?.dispose() : t.then((e) => {
-      if (e)
-        if (Array.isArray(e))
-          for (const s of e) s.dispose();
-        else
-          e.dispose();
-    }).catch(() => {
-    });
+    if (t instanceof WeakRef) {
+      const e = t.deref();
+      e && (e.isTexture && this.textureRefCounts.delete(e.uuid), e.dispose());
+    } else
+      t.then((e) => {
+        if (e)
+          if (Array.isArray(e))
+            for (const s of e) s.dispose();
+          else
+            e.isTexture && this.textureRefCounts.delete(e.uuid), e.dispose();
+      }).catch(() => {
+      });
   }
   /** A map of key = asset uuid and value = LOD information */
   static lodInfos = /* @__PURE__ */ new Map();
   /** cache of already loaded mesh lods. Uses WeakRef for single resources to allow garbage collection when unused. */
-  static previouslyLoaded = /* @__PURE__ */ new Map();
+  static cache = /* @__PURE__ */ new Map();
   /** this contains the geometry/textures that were originally loaded. Uses WeakRef to allow garbage collection when unused. */
   static lowresCache = /* @__PURE__ */ new Map();
+  /** Reference counting for textures to track usage across multiple materials/objects */
+  static textureRefCounts = /* @__PURE__ */ new Map();
   /**
    * FinalizationRegistry to automatically clean up `previouslyLoaded` cache entries
    * when their associated three.js resources are garbage collected by the browser.
    * The held value is the cache key string used in `previouslyLoaded`.
    */
   static _resourceRegistry = new FinalizationRegistry((t) => {
-    const e = m.previouslyLoaded.get(t);
-    console.debug(`[gltf-progressive] FinalizationRegistry cleanup: Resource GC'd for ${t}.`), e instanceof WeakRef && (e.deref() || (m.previouslyLoaded.delete(t), g && console.log(`[gltf-progressive] Cache entry auto-cleaned (GC'd): ${t}`)));
+    const e = m.cache.get(t);
+    (f || K) && console.debug(`[gltf-progressive] Memory: Resource GC'd
+${t}`), e instanceof WeakRef && (e.deref() || (m.cache.delete(t), (f || K) && console.log("[gltf-progressive] ↪ Cache entry deleted (GC)")));
   });
+  /**
+   * Track texture usage by incrementing reference count
+   */
+  static trackTextureUsage(t) {
+    const e = t.uuid, s = this.textureRefCounts.get(e) || 0;
+    this.textureRefCounts.set(e, s + 1), f === "verbose" && console.log(`[gltf-progressive] Track texture ${e}, refCount: ${s} → ${s + 1}`);
+  }
+  /**
+   * Untrack texture usage by decrementing reference count.
+   * Automatically disposes the texture when reference count reaches zero.
+   * @returns true if the texture was disposed, false otherwise
+   */
+  static untrackTextureUsage(t) {
+    const e = t.uuid, s = this.textureRefCounts.get(e);
+    if (!s)
+      return (f === "verbose" || K) && i("[gltf-progressive] Memory: Untrack untracked texture (dispose immediately)", 0), t.dispose(), !0;
+    const r = s - 1;
+    if (r <= 0)
+      return this.textureRefCounts.delete(e), (f || K) && i("[gltf-progressive] Memory: Dispose texture", r), t.dispose(), !0;
+    return this.textureRefCounts.set(e, r), f === "verbose" && i("[gltf-progressive] Memory: Untrack texture", r), !1;
+    function i(o, l) {
+      let a = t.image?.width || t.source?.data?.width || 0, u = t.image?.height || t.source?.data?.height || 0;
+      const c = a && u ? `${a}x${u}` : "N/A";
+      let y = "N/A";
+      a && u && (y = `~${(it(t) / (1024 * 1024)).toFixed(2)} MB`), console.log(`${o} — ${t.name} ${c} (${y}), refCount: ${s} → ${l}
+${e}`);
+    }
+  }
   static workers = [];
   static _workersIndex = 0;
   static async getOrLoadLOD(t, e) {
-    const s = g == "verbose", o = this.getAssignedLODInformation(t);
-    if (!o)
-      return g && console.warn(`[gltf-progressive] No LOD information found: ${t.name}, uuid: ${t.uuid}, type: ${t.type}`, t), null;
-    const r = o?.key;
-    let i;
+    const s = f == "verbose", r = this.getAssignedLODInformation(t);
+    if (!r)
+      return f && console.warn(`[gltf-progressive] No LOD information found: ${t.name}, uuid: ${t.uuid}, type: ${t.type}`, t), null;
+    const i = r?.key;
+    let o;
     if (t.isTexture === !0) {
       const a = t;
-      a.source && a.source[le] && (i = a.source[le]);
+      a.source && a.source[ue] && (o = a.source[ue]);
     }
-    if (i || (i = m.lodInfos.get(r)), !i)
-      g && console.warn(`Can not load LOD ${e}: no LOD info found for "${r}" ${t.name}`, t.type, m.lodInfos);
+    if (o || (o = m.lodInfos.get(i)), !o)
+      f && console.warn(`Can not load LOD ${e}: no LOD info found for "${i}" ${t.name}`, t.type, m.lodInfos);
     else {
       if (e > 0) {
-        let u = !1;
-        const y = Array.isArray(i.lods);
-        if (y && e >= i.lods.length ? u = !0 : y || (u = !0), u) {
-          const w = this.lowresCache.get(r);
+        let c = !1;
+        const y = Array.isArray(o.lods);
+        if (y && e >= o.lods.length ? c = !0 : y || (c = !0), c) {
+          const w = this.lowresCache.get(i);
           if (w) {
-            const L = w.deref();
-            if (L) return L;
-            this.lowresCache.delete(r), g && console.log(`[gltf-progressive] Lowres cache entry was GC'd: ${r}`);
+            const _ = w.deref();
+            if (_) return _;
+            this.lowresCache.delete(i), f && console.log(`[gltf-progressive] Lowres cache entry was GC'd: ${i}`);
           }
           return null;
         }
       }
-      const a = Array.isArray(i.lods) ? i.lods[e]?.path : i.lods;
+      const a = Array.isArray(o.lods) ? o.lods[e]?.path : o.lods;
       if (!a)
-        return g && !i["missing:uri"] && (i["missing:uri"] = !0, console.warn("Missing uri for progressive asset for LOD " + e, i)), null;
-      const d = tt(o.url, a);
-      if (d.endsWith(".glb") || d.endsWith(".gltf")) {
-        if (!i.guid)
-          return console.warn("missing pointer for glb/gltf texture", i), null;
-        const u = d + "_" + i.guid, y = await this.queue.slot(d), w = this.previouslyLoaded.get(u);
+        return f && !o["missing:uri"] && (o["missing:uri"] = !0, console.warn("Missing uri for progressive asset for LOD " + e, o)), null;
+      const u = st(r.url, a);
+      if (u.endsWith(".glb") || u.endsWith(".gltf")) {
+        if (!o.guid)
+          return console.warn("missing pointer for glb/gltf texture", o), null;
+        const c = u + "_" + o.guid, y = await this.queue.slot(u), w = this.cache.get(c);
         if (w !== void 0)
-          if (s && console.log(`LOD ${e} was already loading/loaded: ${u}`), w instanceof WeakRef) {
-            const c = w.deref();
-            if (c) {
-              let h = c, b = !1;
-              if (h instanceof F && t instanceof F ? h.image?.data || h.source?.data ? h = this.copySettings(t, h) : b = !0 : h instanceof E && t instanceof E && (h.attributes.position?.array || (b = !0)), !b)
-                return h;
+          if (s && console.log(`LOD ${e} was already loading/loaded: ${c}`), w instanceof WeakRef) {
+            const d = w.deref();
+            if (d) {
+              let g = d, b = !1;
+              if (g instanceof F && t instanceof F ? g.image?.data || g.source?.data ? g = this.copySettings(t, g) : b = !0 : g instanceof E && t instanceof E && (g.attributes.position?.array || (b = !0)), !b)
+                return g;
             }
-            this.previouslyLoaded.delete(u), g && console.log(`[gltf-progressive] Re-loading GC'd/disposed resource: ${u}`);
+            this.cache.delete(c), f && console.log(`[gltf-progressive] Re-loading GC'd/disposed resource: ${c}`);
           } else {
-            let c = await w.catch((b) => (console.error(`Error loading LOD ${e} from ${d}
-`, b), null)), h = !1;
-            if (c == null || (c instanceof F && t instanceof F ? c.image?.data || c.source?.data ? c = this.copySettings(t, c) : (h = !0, this.previouslyLoaded.delete(u)) : c instanceof E && t instanceof E && (c.attributes.position?.array || (h = !0, this.previouslyLoaded.delete(u)))), !h)
-              return c;
+            let d = await w.catch((b) => (console.error(`Error loading LOD ${e} from ${u}
+`, b), null)), g = !1;
+            if (d == null || (d instanceof F && t instanceof F ? d.image?.data || d.source?.data ? d = this.copySettings(t, d) : (g = !0, this.cache.delete(c)) : d instanceof E && t instanceof E && (d.attributes.position?.array || (g = !0, this.cache.delete(c)))), !g)
+              return d;
           }
         if (!y.use)
-          return g && console.log(`LOD ${e} was aborted: ${d}`), null;
-        const L = i, I = new Promise(async (c, h) => {
-          if (ct) {
-            const x = await (await dt({})).load(d);
+          return f && console.log(`LOD ${e} was aborted: ${u}`), null;
+        const _ = o, k = new Promise(async (d, g) => {
+          if (gt) {
+            const x = await (await ft({})).load(u);
             if (x.textures.length > 0)
-              for (const f of x.textures) {
-                let p = f.texture;
-                return m.assignLODInformation(o.url, p, r, e, void 0), t instanceof F && (p = this.copySettings(t, p)), p && (p.guid = L.guid), c(p);
+              for (const h of x.textures) {
+                let p = h.texture;
+                return m.assignLODInformation(r.url, p, i, e, void 0), t instanceof F && (p = this.copySettings(t, p)), p && (p.guid = _.guid), d(p);
               }
             if (x.geometries.length > 0) {
-              const f = new Array();
+              const h = new Array();
               for (const p of x.geometries) {
-                const D = p.geometry;
-                m.assignLODInformation(o.url, D, r, e, p.primitiveIndex), f.push(D);
+                const O = p.geometry;
+                m.assignLODInformation(r.url, O, i, e, p.primitiveIndex), h.push(O);
               }
-              return c(f);
+              return d(h);
             }
-            return c(null);
+            return d(null);
           }
-          const b = new ye();
-          Se(b), g && (await new Promise((_) => setTimeout(_, 1e3)), s && console.warn("Start loading (delayed) " + d, L.guid));
-          let B = d;
-          if (L && Array.isArray(L.lods)) {
-            const _ = L.lods[e];
-            _.hash && (B += "?v=" + _.hash);
+          const b = new xe();
+          Te(b), f && (await new Promise((L) => setTimeout(L, 1e3)), s && console.warn("Start loading (delayed) " + u, _.guid));
+          let B = u;
+          if (_ && Array.isArray(_.lods)) {
+            const L = _.lods[e];
+            L.hash && (B += "?v=" + L.hash);
           }
-          const M = await b.loadAsync(B).catch((_) => (console.error(`Error loading LOD ${e} from ${d}
-`, _), c(null)));
-          if (!M)
-            return c(null);
-          const N = M.parser;
-          s && console.log("Loading finished " + d, L.guid);
+          const D = await b.loadAsync(B).catch((L) => (console.error(`Error loading LOD ${e} from ${u}
+`, L), d(null)));
+          if (!D)
+            return d(null);
+          const N = D.parser;
+          s && console.log("Loading finished " + u, _.guid);
           let P = 0;
-          if (M.parser.json.textures) {
-            let _ = !1;
-            for (const x of M.parser.json.textures) {
+          if (D.parser.json.textures) {
+            let L = !1;
+            for (const x of D.parser.json.textures) {
               if (x?.extensions) {
-                const f = x?.extensions[W];
-                if (f?.guid && f.guid === L.guid) {
-                  _ = !0;
+                const h = x?.extensions[W];
+                if (h?.guid && h.guid === _.guid) {
+                  L = !0;
                   break;
                 }
               }
               P++;
             }
-            if (_) {
+            if (L) {
               let x = await N.getDependency("texture", P);
-              return x && m.assignLODInformation(o.url, x, r, e, void 0), s && console.log('change "' + t.name + '" → "' + x.name + '"', d, P, x, u), t instanceof F && (x = this.copySettings(t, x)), x && (x.guid = L.guid), c(x);
-            } else g && console.warn("Could not find texture with guid", L.guid, M.parser.json);
+              return x && m.assignLODInformation(r.url, x, i, e, void 0), s && console.log('change "' + t.name + '" → "' + x.name + '"', u, P, x, c), t instanceof F && (x = this.copySettings(t, x)), x && (x.guid = _.guid), d(x);
+            } else f && console.warn("Could not find texture with guid", _.guid, D.parser.json);
           }
-          if (P = 0, M.parser.json.meshes) {
-            let _ = !1;
-            for (const x of M.parser.json.meshes) {
+          if (P = 0, D.parser.json.meshes) {
+            let L = !1;
+            for (const x of D.parser.json.meshes) {
               if (x?.extensions) {
-                const f = x?.extensions[W];
-                if (f?.guid && f.guid === L.guid) {
-                  _ = !0;
+                const h = x?.extensions[W];
+                if (h?.guid && h.guid === _.guid) {
+                  L = !0;
                   break;
                 }
               }
               P++;
             }
-            if (_) {
+            if (L) {
               const x = await N.getDependency("mesh", P);
-              if (s && console.log(`Loaded Mesh "${x.name}"`, d, P, x, u), x.isMesh === !0) {
-                const f = x.geometry;
-                return m.assignLODInformation(o.url, f, r, e, 0), c(f);
+              if (s && console.log(`Loaded Mesh "${x.name}"`, u, P, x, c), x.isMesh === !0) {
+                const h = x.geometry;
+                return m.assignLODInformation(r.url, h, i, e, 0), d(h);
               } else {
-                const f = new Array();
+                const h = new Array();
                 for (let p = 0; p < x.children.length; p++) {
-                  const D = x.children[p];
-                  if (D.isMesh === !0) {
-                    const S = D.geometry;
-                    m.assignLODInformation(o.url, S, r, e, p), f.push(S);
+                  const O = x.children[p];
+                  if (O.isMesh === !0) {
+                    const S = O.geometry;
+                    m.assignLODInformation(r.url, S, i, e, p), h.push(S);
                   }
                 }
-                return c(f);
+                return d(h);
               }
-            } else g && console.warn("Could not find mesh with guid", L.guid, M.parser.json);
+            } else f && console.warn("Could not find mesh with guid", _.guid, D.parser.json);
           }
-          return c(null);
+          return d(null);
         });
-        this.previouslyLoaded.set(u, I), y.use(I);
-        const O = await I;
-        return O != null ? Array.isArray(O) ? this.previouslyLoaded.set(u, Promise.resolve(O)) : (this.previouslyLoaded.set(u, new WeakRef(O)), m._resourceRegistry.register(O, u)) : this.previouslyLoaded.set(u, Promise.resolve(null)), O;
+        this.cache.set(c, k), y.use(k);
+        const M = await k;
+        return M != null ? M instanceof F ? (this.cache.set(c, new WeakRef(M)), m._resourceRegistry.register(M, c)) : Array.isArray(M) ? this.cache.set(c, Promise.resolve(M)) : this.cache.set(c, Promise.resolve(M)) : this.cache.set(c, Promise.resolve(null)), M;
       } else if (t instanceof F) {
-        s && console.log("Load texture from uri: " + d);
-        const y = await new ze().loadAsync(d);
-        return y ? (y.guid = i.guid, y.flipY = !1, y.needsUpdate = !0, y.colorSpace = t.colorSpace, s && console.log(i, y)) : g && console.warn("failed loading", d), y;
+        s && console.log("Load texture from uri: " + u);
+        const y = await new qe().loadAsync(u);
+        return y ? (y.guid = o.guid, y.flipY = !1, y.needsUpdate = !0, y.colorSpace = t.colorSpace, s && console.log(o, y)) : f && console.warn("failed loading", u), y;
       }
     }
     return null;
   }
-  static maxConcurrent = 50;
-  static queue = new st(m.maxConcurrent, { debug: g != !1 });
-  static assignLODInformation(t, e, s, o, r) {
+  static _queue;
+  static get queue() {
+    return this._queue ??= new rt(_e() ? 20 : 50, { debug: f != !1 });
+  }
+  static assignLODInformation(t, e, s, r, i) {
     if (!e) return;
     e.userData || (e.userData = {});
-    const i = new ht(t, s, o, r);
-    e.userData.LODS = i, "source" in e && typeof e.source == "object" && (e.source.LODS = i);
+    const o = new pt(t, s, r, i);
+    e.userData.LODS = o, "source" in e && typeof e.source == "object" && (e.source.LODS = o);
   }
   static getAssignedLODInformation(t) {
     return t ? t.userData?.LODS ? t.userData.LODS : "source" in t && t.source?.LODS ? t.source.LODS : null : null;
   }
   // private static readonly _copiedTextures: WeakMap<Texture, Texture> = new Map();
   static copySettings(t, e) {
-    return e ? (g === "verbose" && console.debug(`Copy texture settings
+    return e ? (f === "verbose" && console.debug(`Copy texture settings
 `, t.uuid, `
 `, e.uuid), e = e.clone(), e.offset = t.offset, e.repeat = t.repeat, e.colorSpace = t.colorSpace, e.magFilter = t.magFilter, e.minFilter = t.minFilter, e.wrapS = t.wrapS, e.wrapT = t.wrapT, e.flipY = t.flipY, e.anisotropy = t.anisotropy, e.mipmaps || (e.generateMipmaps = t.generateMipmaps), e) : t;
   }
 }
-class ht {
+class pt {
   url;
   /** the key to lookup the LOD information */
   key;
   level;
   /** For multi objects (e.g. a group of meshes) this is the index of the object */
   index;
-  constructor(t, e, s, o) {
-    this.url = t, this.key = e, this.level = s, o != null && (this.index = o);
+  constructor(t, e, s, r) {
+    this.url = t, this.key = e, this.level = s, r != null && (this.index = r);
   }
 }
-class de {
-  static addPromise = (t, e, s, o) => {
-    o.forEach((r) => {
-      r.add(t, e, s);
+class ce {
+  static addPromise = (t, e, s, r) => {
+    r.forEach((i) => {
+      i.add(t, e, s);
     });
   };
   ready;
@@ -875,9 +980,9 @@ class de {
   _awaiting = [];
   _maxPromisesPerObject = 1;
   constructor(t, e) {
-    const o = Math.max(e.frames ?? 2, 2);
-    this._frame_start = e.waitForFirstCapture ? void 0 : t, this._frames_to_capture = o, this.ready = new Promise((r) => {
-      this._resolve = r;
+    const r = Math.max(e.frames ?? 2, 2);
+    this._frame_start = e.waitForFirstCapture ? void 0 : t, this._frames_to_capture = r, this.ready = new Promise((i) => {
+      this._resolve = i;
     }), this.ready.finally(() => {
       this._resolved = !0, this._awaiting.length = 0;
     }), this._signal = e.signal, this._signal?.addEventListener("abort", () => {
@@ -891,18 +996,18 @@ class de {
   _seen = /* @__PURE__ */ new WeakMap();
   add(t, e, s) {
     if (this._resolved) {
-      g && console.warn("PromiseGroup: Trying to add a promise to a resolved group, ignoring.");
+      f && console.warn("PromiseGroup: Trying to add a promise to a resolved group, ignoring.");
       return;
     }
     if (!(this._frame_start !== void 0 && this._currentFrame > this._frame_start + this._frames_to_capture)) {
       if (this._maxPromisesPerObject >= 1)
         if (this._seen.has(e)) {
-          let o = this._seen.get(e);
-          if (o >= this._maxPromisesPerObject) {
-            g && console.warn("PromiseGroup: Already awaiting object ignoring new promise for it.");
+          let r = this._seen.get(e);
+          if (r >= this._maxPromisesPerObject) {
+            f && console.warn("PromiseGroup: Already awaiting object ignoring new promise for it.");
             return;
           }
-          this._seen.set(e, o + 1);
+          this._seen.set(e, r + 1);
         } else
           this._seen.set(e, 1);
       this._awaiting.push(s), this._addedCount++, s.finally(() => {
@@ -918,7 +1023,7 @@ class de {
     });
   }
 }
-const k = j("debugprogressive"), gt = j("noprogressive"), ue = /* @__PURE__ */ Symbol("Needle:LODSManager"), ce = /* @__PURE__ */ Symbol("Needle:LODState"), U = /* @__PURE__ */ Symbol("Needle:CurrentLOD"), T = { mesh_lod: -1, texture_lod: -1 };
+const R = q("debugprogressive"), mt = q("noprogressive"), de = /* @__PURE__ */ Symbol("Needle:LODSManager"), fe = /* @__PURE__ */ Symbol("Needle:LODState"), U = /* @__PURE__ */ Symbol("Needle:CurrentLOD"), T = { mesh_lod: -1, texture_lod: -1 };
 class v {
   /** 
    * 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.
@@ -926,7 +1031,7 @@ class v {
   static debugDrawLine;
   /** @internal */
   static getObjectLODState(t) {
-    return t[ce];
+    return t[fe];
   }
   static addPlugin(t) {
     z.push(t);
@@ -941,17 +1046,17 @@ class v {
    * @returns The LODsManager instance.
    */
   static get(t, e) {
-    if (t[ue])
-      return console.debug("[gltf-progressive] LODsManager already exists for this renderer"), t[ue];
+    if (t[de])
+      return console.debug("[gltf-progressive] LODsManager already exists for this renderer"), t[de];
     const s = new v(t, {
       engine: "unknown",
       ...e
     });
-    return t[ue] = s, s;
+    return t[de] = s, s;
   }
   renderer;
   context;
-  projectionScreenMatrix = new Le();
+  projectionScreenMatrix = new ve();
   /** @deprecated use static `LODsManager.addPlugin()` method. This getter will be removed in later versions */
   get plugins() {
     return z;
@@ -992,16 +1097,40 @@ class v {
   _newPromiseGroups = [];
   _promiseGroupIds = 0;
   /**
-   * Call to await LODs loading during the next render cycle.
+   * Returns a promise that resolves once all LOD requests initiated during the next render cycles have finished loading.
+   * This is useful for hiding low-resolution placeholders (e.g. with a loading overlay or CSS blur) until high-quality assets are ready.
+   *
+   * By default, the returned promise captures LOD loading requests for 2 frames and resolves when all of them complete.
+   * Use `waitForFirstCapture` if no LOD requests may happen immediately (e.g. after a scene switch).
+   *
+   * @param opts - Optional configuration for how long to capture and what to wait for. See {@link PromiseGroupOptions}.
+   * @returns A promise that resolves with `{ cancelled, awaited_count, resolved_count }` once all captured LOD loads complete (or the signal aborts).
+   *
+   * @example
+   * ```ts
+   * // Wait for initial LODs to finish loading, then remove a blur overlay
+   * const result = await lodsManager.awaitLoading({
+   *     frames: 5,
+   *     signal: AbortSignal.timeout(10_000),
+   * });
+   * console.log(`Loaded ${result.resolved_count} of ${result.awaited_count} LODs`);
+   * document.querySelector('.blur-overlay')?.remove();
+   * ```
+   *
+   * @example
+   * ```ts
+   * // Wait until at least one LOD starts loading before resolving
+   * await lodsManager.awaitLoading({ waitForFirstCapture: true });
+   * ```
    */
   awaitLoading(t) {
-    const e = this._promiseGroupIds++, s = new de(this.#r, { ...t });
+    const e = this._promiseGroupIds++, s = new ce(this.#r, { ...t });
     this._newPromiseGroups.push(s);
-    const o = performance.now();
+    const r = performance.now();
     return s.ready.finally(() => {
-      const r = this._newPromiseGroups.indexOf(s);
-      r >= 0 && (this._newPromiseGroups.splice(r, 1), _e() && performance.measure("LODsManager:awaitLoading", {
-        start: o,
+      const i = this._newPromiseGroups.indexOf(s);
+      i >= 0 && (this._newPromiseGroups.splice(i, 1), be() && performance.measure("LODsManager:awaitLoading", {
+        start: r,
         detail: { id: e, name: t?.name, awaited: s.awaitedCount, resolved: s.resolvedCount }
       }));
     }), s.ready;
@@ -1012,23 +1141,49 @@ class v {
         this._newPromiseGroups[t].update(this.#r);
   }
   _lodchangedlisteners = [];
+  /**
+   * Register a listener that is called whenever a mesh or texture LOD level has finished loading and has been applied.
+   * The listener receives the type of asset (`"mesh"` or `"texture"`), the new LOD level, and the affected object.
+   *
+   * @param evt - The event type. Currently only `"changed"` is supported.
+   * @param listener - Callback invoked after a LOD swap completes.
+   * @return A function to unregister the listener.
+   *
+   * @example
+   * ```ts
+   * lodsManager.addEventListener("changed", ({ type, level, object }) => {
+   *     console.log(`${type} LOD changed to level ${level}`, object);
+   * });
+   * ```
+   */
   addEventListener(t, e) {
-    t === "changed" && this._lodchangedlisteners.push(e);
+    return t === "changed" ? (this._lodchangedlisteners.push(e), () => {
+      this.removeEventListener(t, e);
+    }) : () => {
+    };
   }
+  /**
+   * Remove a previously registered `"changed"` event listener.
+   * @param evt - The event type (`"changed"`).
+   * @param listener - The listener to remove.
+   * @return `true` if the listener was found and removed, `false` otherwise.
+   */
   removeEventListener(t, e) {
+    let s = !1;
     if (t === "changed") {
-      const s = this._lodchangedlisteners.indexOf(e);
-      s >= 0 && this._lodchangedlisteners.splice(s, 1);
+      const r = this._lodchangedlisteners.indexOf(e);
+      r >= 0 && (this._lodchangedlisteners.splice(r, 1), s = !0);
     }
+    return s;
   }
   // readonly plugins: NEEDLE_progressive_plugin[] = [];
   constructor(t, e) {
     this.renderer = t, this.context = { ...e };
   }
   #t;
-  #i = new Ne();
+  #o = new Ne();
   #r = 0;
-  #o = 0;
+  #i = 0;
   #n = 0;
   #s = 0;
   _fpsBuffer = [60, 60, 60, 60, 60];
@@ -1041,29 +1196,44 @@ class v {
     let t = 0;
     this.#t = this.renderer.render;
     const e = this;
-    xe(this.renderer), this.renderer.render = function(s, o) {
-      const r = e.renderer.getRenderTarget();
-      (r == null || "isXRRenderTarget" in r && r.isXRRenderTarget) && (t = 0, e.#r += 1, e.#o = e.#i.getDelta(), e.#n += e.#o, e._fpsBuffer.shift(), e._fpsBuffer.push(1 / e.#o), 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 i = t++;
-      e.#t.call(this, s, o), e.onAfterRender(s, o, i);
+    we(this.renderer), this.renderer.render = function(s, r) {
+      const i = e.renderer.getRenderTarget();
+      (i == null || "isXRRenderTarget" in i && i.isXRRenderTarget) && (t = 0, e.#r += 1, e.#i = e.#o.getDelta(), e.#n += e.#i, e._fpsBuffer.shift(), e._fpsBuffer.push(1 / e.#i), e.#s = e._fpsBuffer.reduce((l, a) => l + a) / e._fpsBuffer.length, R && e.#r % 200 === 0 && console.log("FPS", Math.round(e.#s), "Interval:", e.#e));
+      const o = t++;
+      e.#t.call(this, s, r), e.onAfterRender(s, r, o);
     };
   }
   disable() {
     this.#t && (console.debug("[gltf-progressive] Disabling LODsManager for renderer"), this.renderer.render = this.#t, this.#t = void 0);
   }
+  /**
+   * Manually trigger a LOD update for a scene and camera.
+   * Only needed when {@link manual} is set to `true` — otherwise LOD updates happen automatically on each render call.
+   *
+   * @param scene - The scene containing objects with progressive LODs.
+   * @param camera - The camera used to determine screen coverage and LOD levels.
+   *
+   * @example
+   * ```ts
+   * const lodsManager = LODsManager.get(renderer);
+   * lodsManager.manual = true;
+   * // ... later, trigger an update at a specific point:
+   * lodsManager.update(scene, camera);
+   * ```
+   */
   update(t, e) {
     this.internalUpdate(t, e);
   }
   onAfterRender(t, e, s) {
     if (this.pause) return;
-    const r = this.renderer.renderLists.get(t, 0).opaque;
-    let i = !0;
-    if (r.length === 1) {
-      const l = r[0].material;
-      (l.name === "EffectMaterial" || l.name === "CopyShader") && (i = !1);
+    const i = this.renderer.renderLists.get(t, 0).opaque;
+    let o = !0;
+    if (i.length === 1) {
+      const l = i[0].material;
+      (l.name === "EffectMaterial" || l.name === "CopyShader") && (o = !1);
     }
-    if ((e.parent && e.parent.type === "CubeCamera" || s >= 1 && e.type === "OrthographicCamera") && (i = !1), i) {
-      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))
+    if ((e.parent && e.parent.type === "CubeCamera" || s >= 1 && e.type === "OrthographicCamera") && (o = !1), o) {
+      if (mt || (this.updateInterval === "auto" ? this.#s < 40 && this.#e < 10 ? (this.#e += 1, R && console.warn("↓ Reducing LOD updates", this.#e, this.#s.toFixed(0))) : this.#s >= 60 && this.#e > 1 && (this.#e -= 1, R && 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();
     }
@@ -1072,12 +1242,12 @@ class v {
    * Update LODs in a scene
    */
   internalUpdate(t, e) {
-    const s = this.renderer.renderLists.get(t, 0), o = s.opaque;
+    const s = this.renderer.renderLists.get(t, 0), r = s.opaque;
     this.projectionScreenMatrix.multiplyMatrices(e.projectionMatrix, e.matrixWorldInverse);
-    const r = this.targetTriangleDensity;
-    for (const a of o) {
+    const i = this.targetTriangleDensity;
+    for (const a of r) {
       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")) {
-        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)));
+        R && (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) {
@@ -1089,38 +1259,38 @@ class v {
         case "MeshDepthMaterial":
           continue;
       }
-      if (k === "color" && a.material && !a.object.progressive_debug_color) {
+      if (R === "color" && a.material && !a.object.progressive_debug_color) {
         a.object.progressive_debug_color = !0;
-        const u = Math.random() * 16777215, y = new qe({ color: u });
+        const c = Math.random() * 16777215, y = new Ve({ color: c });
         a.object.material = y;
       }
-      const d = a.object;
-      (d instanceof V || d.isMesh) && this.updateLODs(t, e, d, r);
+      const u = a.object;
+      (u instanceof X || u.isMesh) && this.updateLODs(t, e, u, i);
     }
-    const i = s.transparent;
-    for (const a of i) {
-      const d = a.object;
-      (d instanceof V || d.isMesh) && this.updateLODs(t, e, d, r);
+    const o = s.transparent;
+    for (const a of o) {
+      const u = a.object;
+      (u instanceof X || u.isMesh) && this.updateLODs(t, e, u, i);
     }
     const l = s.transmissive;
     for (const a of l) {
-      const d = a.object;
-      (d instanceof V || d.isMesh) && this.updateLODs(t, e, d, r);
+      const u = a.object;
+      (u instanceof X || u.isMesh) && this.updateLODs(t, e, u, i);
     }
   }
   /** Update the LOD levels for the renderer. */
-  updateLODs(t, e, s, o) {
+  updateLODs(t, e, s, r) {
     s.userData || (s.userData = {});
-    let r = s[ce];
-    if (r || (r = new pt(), s[ce] = r), r.frames++ < 2)
+    let i = s[fe];
+    if (i || (i = new yt(), s[fe] = i), i.frames++ < 2)
       return;
     for (const l of z)
       l.onBeforeUpdateLOD?.(this.renderer, t, e, s);
-    const i = this.overrideLodLevel !== void 0 ? this.overrideLodLevel : q;
-    i >= 0 ? (T.mesh_lod = i, T.texture_lod = i) : (this.calculateLodLevel(e, s, r, o, T), T.mesh_lod = Math.round(T.mesh_lod), T.texture_lod = Math.round(T.texture_lod)), T.mesh_lod >= 0 && this.loadProgressiveMeshes(s, T.mesh_lod), s.material && T.texture_lod >= 0 && this.loadProgressiveTextures(s.material, T.texture_lod, i), g && s.material && !s.isGizmo && Ce(s.material);
+    const o = this.overrideLodLevel !== void 0 ? this.overrideLodLevel : V;
+    o >= 0 ? (T.mesh_lod = o, T.texture_lod = o) : (this.calculateLodLevel(e, s, i, r, T), T.mesh_lod = Math.round(T.mesh_lod), T.texture_lod = Math.round(T.texture_lod)), T.mesh_lod >= 0 && this.loadProgressiveMeshes(s, T.mesh_lod), s.material && T.texture_lod >= 0 && this.loadProgressiveTextures(s.material, T.texture_lod, o), f && s.material && !s.isGizmo && ke(s.material);
     for (const l of z)
       l.onAfterUpdatedLOD?.(this.renderer, t, e, s, T);
-    r.lastLodLevel_Mesh = T.mesh_lod, r.lastLodLevel_Texture = T.texture_lod;
+    i.lastLodLevel_Mesh = T.mesh_lod, i.lastLodLevel_Texture = T.texture_lod;
   }
   /** Load progressive textures for the given material
    * @param material the material to load the textures for
@@ -1130,17 +1300,17 @@ class v {
   loadProgressiveTextures(t, e, s) {
     if (!t) return;
     if (Array.isArray(t)) {
-      for (const r of t)
-        this.loadProgressiveTextures(r, e);
+      for (const i of t)
+        this.loadProgressiveTextures(i, e);
       return;
     }
-    let o = !1;
-    if ((t[U] === void 0 || e < t[U]) && (o = !0), s !== void 0 && s >= 0 && (o = t[U] != s, e = s), o) {
+    let r = !1;
+    if ((t[U] === void 0 || e < t[U]) && (r = !0), s !== void 0 && s >= 0 && (r = t[U] != s, e = s), r) {
       t[U] = e;
-      const r = m.assignTextureLOD(t, e).then((i) => {
+      const i = m.assignTextureLOD(t, e).then((o) => {
         this._lodchangedlisteners.forEach((l) => l({ type: "texture", level: e, object: t }));
       });
-      de.addPromise("texture", t, r, this._newPromiseGroups);
+      ce.addPromise("texture", t, i, this._newPromiseGroups);
     }
   }
   /** Load progressive meshes for the given mesh
@@ -1152,142 +1322,142 @@ class v {
   loadProgressiveMeshes(t, e) {
     if (!t) return Promise.resolve(null);
     let s = t[U] !== e;
-    const o = t["DEBUG:LOD"];
-    if (o != null && (s = t[U] != o, e = o), s) {
+    const r = t["DEBUG:LOD"];
+    if (r != null && (s = t[U] != r, e = r), s) {
       t[U] = e;
-      const r = t.geometry, i = m.assignMeshLOD(t, e).then((l) => (l && t[U] == e && r != t.geometry && this._lodchangedlisteners.forEach((a) => a({ type: "mesh", level: e, object: t })), l));
-      return de.addPromise("mesh", t, i, this._newPromiseGroups), i;
+      const i = t.geometry, o = m.assignMeshLOD(t, e).then((l) => (l && t[U] == e && i != t.geometry && this._lodchangedlisteners.forEach((a) => a({ type: "mesh", level: e, object: t })), l));
+      return ce.addPromise("mesh", t, o, this._newPromiseGroups), o;
     }
     return Promise.resolve(null);
   }
   // private testIfLODLevelsAreAvailable() {
-  _sphere = new De();
-  _tempBox = new he();
-  _tempBox2 = new he();
-  tempMatrix = new Le();
-  _tempWorldPosition = new C();
-  _tempBoxSize = new C();
-  _tempBox2Size = new C();
-  static corner0 = new C();
-  static corner1 = new C();
-  static corner2 = new C();
-  static corner3 = new C();
-  static _tempPtInside = new C();
+  _sphere = new Se();
+  _tempBox = new ge();
+  _tempBox2 = new ge();
+  tempMatrix = new ve();
+  _tempWorldPosition = new A();
+  _tempBoxSize = new A();
+  _tempBox2Size = new A();
+  static corner0 = new A();
+  static corner1 = new A();
+  static corner2 = new A();
+  static corner3 = new A();
+  static _tempPtInside = new A();
   static isInside(t, e) {
-    const s = t.min, o = t.max, r = (s.x + o.x) * 0.5, i = (s.y + o.y) * 0.5;
-    return this._tempPtInside.set(r, i, s.z).applyMatrix4(e).z < 0;
+    const s = t.min, r = t.max, i = (s.x + r.x) * 0.5, o = (s.y + r.y) * 0.5;
+    return this._tempPtInside.set(i, o, s.z).applyMatrix4(e).z < 0;
   }
   static skinnedMeshBoundsFrameOffsetCounter = 0;
   static $skinnedMeshBoundsOffset = /* @__PURE__ */ Symbol("gltf-progressive-skinnedMeshBoundsOffset");
   // #region calculateLodLevel
-  calculateLodLevel(t, e, s, o, r) {
+  calculateLodLevel(t, e, s, r, i) {
     if (!e) {
-      r.mesh_lod = -1, r.texture_lod = -1;
+      i.mesh_lod = -1, i.texture_lod = -1;
       return;
     }
     if (!t) {
-      r.mesh_lod = -1, r.texture_lod = -1;
+      i.mesh_lod = -1, i.texture_lod = -1;
       return;
     }
     let l = 10 + 1, a = !1;
-    if (k && e["DEBUG:LOD"] != null)
+    if (R && e["DEBUG:LOD"] != null)
       return e["DEBUG:LOD"];
-    const d = m.getMeshLODExtension(e.geometry)?.lods, u = m.getPrimitiveIndex(e.geometry), y = d && d.length > 0, w = m.getMaterialMinMaxLODsCount(e.material), L = w.min_count !== 1 / 0 && w.min_count >= 0 && w.max_count >= 0;
-    if (!y && !L) {
-      r.mesh_lod = 0, r.texture_lod = 0;
+    const u = m.getMeshLODExtension(e.geometry)?.lods, c = m.getPrimitiveIndex(e.geometry), y = u && u.length > 0, w = m.getMaterialMinMaxLODsCount(e.material), _ = w.min_count !== 1 / 0 && w.min_count >= 0 && w.max_count >= 0;
+    if (!y && !_) {
+      i.mesh_lod = 0, i.texture_lod = 0;
       return;
     }
     y || (a = !0, l = 0);
-    const I = this.renderer.domElement.clientHeight || this.renderer.domElement.height;
-    let O = e.geometry.boundingBox;
+    const k = this.renderer.domElement.clientHeight || this.renderer.domElement.height;
+    let M = e.geometry.boundingBox;
     if (e.type === "SkinnedMesh") {
-      const c = e;
-      if (!c.boundingBox)
-        c.computeBoundingBox();
+      const d = e;
+      if (!d.boundingBox)
+        d.computeBoundingBox();
       else if (this.skinnedMeshAutoUpdateBoundsInterval > 0) {
-        if (!c[v.$skinnedMeshBoundsOffset]) {
+        if (!d[v.$skinnedMeshBoundsOffset]) {
           const b = v.skinnedMeshBoundsFrameOffsetCounter++;
-          c[v.$skinnedMeshBoundsOffset] = b;
+          d[v.$skinnedMeshBoundsOffset] = b;
         }
-        const h = c[v.$skinnedMeshBoundsOffset];
-        if ((s.frames + h) % this.skinnedMeshAutoUpdateBoundsInterval === 0) {
-          const b = Z(c), B = c.geometry;
-          b && (c.geometry = b), c.computeBoundingBox(), c.geometry = B;
+        const g = d[v.$skinnedMeshBoundsOffset];
+        if ((s.frames + g) % this.skinnedMeshAutoUpdateBoundsInterval === 0) {
+          const b = ee(d), B = d.geometry;
+          b && (d.geometry = b), d.computeBoundingBox(), d.geometry = B;
         }
       }
-      O = c.boundingBox;
+      M = d.boundingBox;
     }
-    if (O) {
-      const c = t;
+    if (M) {
+      const d = t;
       if (e.geometry.attributes.color && e.geometry.attributes.color.count < 100 && e.geometry.boundingSphere) {
         this._sphere.copy(e.geometry.boundingSphere), this._sphere.applyMatrix4(e.matrixWorld);
-        const f = t.getWorldPosition(this._tempWorldPosition);
-        if (this._sphere.containsPoint(f)) {
-          r.mesh_lod = 0, r.texture_lod = 0;
+        const h = t.getWorldPosition(this._tempWorldPosition);
+        if (this._sphere.containsPoint(h)) {
+          i.mesh_lod = 0, i.texture_lod = 0;
           return;
         }
       }
-      if (this._tempBox.copy(O), this._tempBox.applyMatrix4(e.matrixWorld), c.isPerspectiveCamera && v.isInside(this._tempBox, this.projectionScreenMatrix)) {
-        r.mesh_lod = 0, r.texture_lod = 0;
+      if (this._tempBox.copy(M), this._tempBox.applyMatrix4(e.matrixWorld), d.isPerspectiveCamera && v.isInside(this._tempBox, this.projectionScreenMatrix)) {
+        i.mesh_lod = 0, i.texture_lod = 0;
         return;
       }
-      if (this._tempBox.applyMatrix4(this.projectionScreenMatrix), this.renderer.xr.enabled && c.isPerspectiveCamera && c.fov > 70) {
-        const f = this._tempBox.min, p = this._tempBox.max;
-        let D = f.x, S = f.y, G = p.x, Y = p.y;
-        const ee = 2, ie = 1.5, te = (f.x + p.x) * 0.5, se = (f.y + p.y) * 0.5;
-        D = (D - te) * ee + te, S = (S - se) * ee + se, G = (G - te) * ee + te, Y = (Y - se) * ee + se;
-        const Re = D < 0 && G > 0 ? 0 : Math.min(Math.abs(f.x), Math.abs(p.x)), $e = S < 0 && Y > 0 ? 0 : Math.min(Math.abs(f.y), Math.abs(p.y)), ne = Math.max(Re, $e);
-        s.lastCentrality = (ie - ne) * (ie - ne) * (ie - ne);
+      if (this._tempBox.applyMatrix4(this.projectionScreenMatrix), this.renderer.xr.enabled && d.isPerspectiveCamera && d.fov > 70) {
+        const h = this._tempBox.min, p = this._tempBox.max;
+        let O = h.x, S = h.y, G = p.x, Y = p.y;
+        const te = 2, ne = 1.5, se = (h.x + p.x) * 0.5, re = (h.y + p.y) * 0.5;
+        O = (O - se) * te + se, S = (S - re) * te + re, G = (G - se) * te + se, Y = (Y - re) * te + re;
+        const $e = O < 0 && G > 0 ? 0 : Math.min(Math.abs(h.x), Math.abs(p.x)), Be = S < 0 && Y > 0 ? 0 : Math.min(Math.abs(h.y), Math.abs(p.y)), ae = Math.max($e, Be);
+        s.lastCentrality = (ne - ae) * (ne - ae) * (ne - ae);
       } else
         s.lastCentrality = 1;
-      const h = this._tempBox.getSize(this._tempBoxSize);
-      h.multiplyScalar(0.5), screen.availHeight > 0 && I > 0 && h.multiplyScalar(I / screen.availHeight), t.isPerspectiveCamera ? h.x *= t.aspect : t.isOrthographicCamera;
+      const g = this._tempBox.getSize(this._tempBoxSize);
+      g.multiplyScalar(0.5), screen.availHeight > 0 && k > 0 && g.multiplyScalar(k / screen.availHeight), t.isPerspectiveCamera ? g.x *= t.aspect : t.isOrthographicCamera;
       const b = t.matrixWorldInverse, B = this._tempBox2;
-      B.copy(O), B.applyMatrix4(e.matrixWorld), B.applyMatrix4(b);
-      const M = B.getSize(this._tempBox2Size), N = Math.max(M.x, M.y);
-      if (Math.max(h.x, h.y) != 0 && N != 0 && (h.z = M.z / Math.max(M.x, M.y) * Math.max(h.x, h.y)), s.lastScreenCoverage = Math.max(h.x, h.y, h.z), s.lastScreenspaceVolume.copy(h), s.lastScreenCoverage *= s.lastCentrality, k && v.debugDrawLine) {
-        const f = this.tempMatrix.copy(this.projectionScreenMatrix);
-        f.invert();
-        const p = v.corner0, D = v.corner1, S = v.corner2, G = v.corner3;
-        p.copy(this._tempBox.min), D.copy(this._tempBox.max), D.x = p.x, S.copy(this._tempBox.max), S.y = p.y, G.copy(this._tempBox.max);
+      B.copy(M), B.applyMatrix4(e.matrixWorld), B.applyMatrix4(b);
+      const D = B.getSize(this._tempBox2Size), N = Math.max(D.x, D.y);
+      if (Math.max(g.x, g.y) != 0 && N != 0 && (g.z = D.z / Math.max(D.x, D.y) * Math.max(g.x, g.y)), s.lastScreenCoverage = Math.max(g.x, g.y, g.z), s.lastScreenspaceVolume.copy(g), s.lastScreenCoverage *= s.lastCentrality, R && v.debugDrawLine) {
+        const h = this.tempMatrix.copy(this.projectionScreenMatrix);
+        h.invert();
+        const p = v.corner0, O = v.corner1, S = v.corner2, G = v.corner3;
+        p.copy(this._tempBox.min), O.copy(this._tempBox.max), O.x = p.x, S.copy(this._tempBox.max), S.y = p.y, G.copy(this._tempBox.max);
         const Y = (p.z + G.z) * 0.5;
-        p.z = D.z = S.z = G.z = Y, p.applyMatrix4(f), D.applyMatrix4(f), S.applyMatrix4(f), G.applyMatrix4(f), v.debugDrawLine(p, D, 255), v.debugDrawLine(p, S, 255), v.debugDrawLine(D, G, 255), v.debugDrawLine(S, G, 255);
+        p.z = O.z = S.z = G.z = Y, p.applyMatrix4(h), O.applyMatrix4(h), S.applyMatrix4(h), G.applyMatrix4(h), v.debugDrawLine(p, O, 255), v.debugDrawLine(p, S, 255), v.debugDrawLine(O, G, 255), v.debugDrawLine(S, G, 255);
       }
-      let _ = 999;
-      if (d && s.lastScreenCoverage > 0)
-        for (let f = 0; f < d.length; f++) {
-          const p = d[f], S = (p.densities?.[u] || p.density || 1e-5) / s.lastScreenCoverage;
-          if (u > 0 && _e() && !p.densities && !globalThis["NEEDLE:MISSING_LOD_PRIMITIVE_DENSITIES"] && (window["NEEDLE:MISSING_LOD_PRIMITIVE_DENSITIES"] = !0, console.warn("[Needle Progressive] Detected usage of mesh without primitive densities. This might cause incorrect LOD level selection: Consider re-optimizing your model by updating your Needle Integration, Needle glTF Pipeline or running optimization again on Needle Cloud.")), S < o) {
-            _ = f;
+      let L = 999;
+      if (u && s.lastScreenCoverage > 0)
+        for (let h = 0; h < u.length; h++) {
+          const p = u[h], S = (p.densities?.[c] || p.density || 1e-5) / s.lastScreenCoverage;
+          if (c > 0 && be() && !p.densities && !globalThis["NEEDLE:MISSING_LOD_PRIMITIVE_DENSITIES"] && (window["NEEDLE:MISSING_LOD_PRIMITIVE_DENSITIES"] = !0, console.warn("[Needle Progressive] Detected usage of mesh without primitive densities. This might cause incorrect LOD level selection: Consider re-optimizing your model by updating your Needle Integration, Needle glTF Pipeline or running optimization again on Needle Cloud.")), S < r) {
+            L = h;
             break;
           }
         }
-      _ < l && (l = _, a = !0);
+      L < l && (l = L, a = !0);
     }
-    if (a ? r.mesh_lod = l : r.mesh_lod = s.lastLodLevel_Mesh, k && r.mesh_lod != s.lastLodLevel_Mesh) {
-      const h = d?.[r.mesh_lod];
-      h && console.log(`Mesh LOD changed: ${s.lastLodLevel_Mesh} → ${r.mesh_lod} (density: ${h.densities?.[u].toFixed(0)}) | ${e.name}`);
+    if (a ? i.mesh_lod = l : i.mesh_lod = s.lastLodLevel_Mesh, R && i.mesh_lod != s.lastLodLevel_Mesh) {
+      const g = u?.[i.mesh_lod];
+      g && console.log(`Mesh LOD changed: ${s.lastLodLevel_Mesh} → ${i.mesh_lod} (density: ${g.densities?.[c].toFixed(0)}) | ${e.name}`);
     }
-    if (L) {
-      const c = "saveData" in globalThis.navigator && globalThis.navigator.saveData === !0;
+    if (_) {
+      const d = "saveData" in globalThis.navigator && globalThis.navigator.saveData === !0;
       if (s.lastLodLevel_Texture < 0) {
-        if (r.texture_lod = w.max_count - 1, k) {
-          const h = w.lods[w.max_count - 1];
-          k && console.log(`First Texture LOD ${r.texture_lod} (${h.max_height}px) - ${e.name}`);
+        if (i.texture_lod = w.max_count - 1, R) {
+          const g = w.lods[w.max_count - 1];
+          R && console.log(`First Texture LOD ${i.texture_lod} (${g.max_height}px) - ${e.name}`);
         }
       } else {
-        const h = s.lastScreenspaceVolume.x + s.lastScreenspaceVolume.y + s.lastScreenspaceVolume.z;
+        const g = s.lastScreenspaceVolume.x + s.lastScreenspaceVolume.y + s.lastScreenspaceVolume.z;
         let b = s.lastScreenCoverage * 4;
         this.context?.engine === "model-viewer" && (b *= 1.5);
-        const M = I / window.devicePixelRatio * b;
+        const D = k / window.devicePixelRatio * b;
         let N = !1;
         for (let P = w.lods.length - 1; P >= 0; P--) {
-          const _ = w.lods[P];
-          if (!(c && _.max_height >= 2048) && !(Ae() && _.max_height > 4096) && (_.max_height > M || !N && P === 0)) {
-            if (N = !0, r.texture_lod = P, k && r.texture_lod < s.lastLodLevel_Texture) {
-              const x = _.max_height;
-              console.log(`Texture LOD changed: ${s.lastLodLevel_Texture} → ${r.texture_lod} = ${x}px 
-Screensize: ${M.toFixed(0)}px, Coverage: ${(100 * s.lastScreenCoverage).toFixed(2)}%, Volume ${h.toFixed(1)} 
+          const L = w.lods[P];
+          if (!(d && L.max_height >= 2048) && !(_e() && L.max_height > 4096) && (L.max_height > D || !N && P === 0)) {
+            if (N = !0, i.texture_lod = P, R && i.texture_lod < s.lastLodLevel_Texture) {
+              const x = L.max_height;
+              console.log(`Texture LOD changed: ${s.lastLodLevel_Texture} → ${i.texture_lod} = ${x}px 
+Screensize: ${D.toFixed(0)}px, Coverage: ${(100 * s.lastScreenCoverage).toFixed(2)}%, Volume ${g.toFixed(1)} 
 ${e.name}`);
             }
             break;
@@ -1295,61 +1465,61 @@ ${e.name}`);
         }
       }
     } else
-      r.texture_lod = 0;
+      i.texture_lod = 0;
   }
 }
-class pt {
+class yt {
   frames = 0;
   lastLodLevel_Mesh = -1;
   lastLodLevel_Texture = -1;
   lastScreenCoverage = 0;
-  lastScreenspaceVolume = new C();
+  lastScreenspaceVolume = new A();
   lastCentrality = 0;
 }
-const ve = /* @__PURE__ */ Symbol("NEEDLE_mesh_lod"), re = /* @__PURE__ */ Symbol("NEEDLE_texture_lod");
-let fe = null;
-function Ie() {
-  const n = mt();
+const Me = /* @__PURE__ */ Symbol("NEEDLE_mesh_lod"), ie = /* @__PURE__ */ Symbol("NEEDLE_texture_lod");
+let he = null;
+function Re() {
+  const n = xt();
   n && (n.mapURLs(function(t) {
-    return be(), t;
-  }), be(), fe?.disconnect(), fe = new MutationObserver((t) => {
+    return De(), t;
+  }), De(), he?.disconnect(), he = 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" && Ie(s);
       });
     });
-  }), fe.observe(document, { childList: !0, subtree: !0 }));
+  }), he.observe(document, { childList: !0, subtree: !0 }));
 }
-function mt() {
+function xt() {
   if (typeof customElements > "u") return null;
   const n = customElements.get("model-viewer");
   return n || (customElements.whenDefined("model-viewer").then(() => {
-    console.debug("[gltf-progressive] model-viewer defined"), Ie();
+    console.debug("[gltf-progressive] model-viewer defined"), Re();
   }), null);
 }
-function be() {
+function De() {
   if (typeof document > "u") return;
   document.querySelectorAll("model-viewer").forEach((t) => {
-    ke(t);
+    Ie(t);
   });
 }
-const Me = /* @__PURE__ */ new WeakSet();
-let yt = 0;
-function ke(n) {
-  if (!n || Me.has(n))
+const Oe = /* @__PURE__ */ new WeakSet();
+let wt = 0;
+function Ie(n) {
+  if (!n || Oe.has(n))
     return null;
-  Me.add(n), console.debug("[gltf-progressive] found new model-viewer..." + ++yt + `
+  Oe.add(n), console.debug("[gltf-progressive] found new model-viewer..." + ++wt + `
 `, n.getAttribute("src"));
   let t = null, e = null, s = null;
-  for (let o = n; o != null; o = Object.getPrototypeOf(o)) {
-    const r = Object.getOwnPropertySymbols(o), i = r.find((d) => d.toString() == "Symbol(renderer)"), l = r.find((d) => d.toString() == "Symbol(scene)"), a = r.find((d) => d.toString() == "Symbol(needsRender)");
-    !t && i != null && (t = n[i].threeRenderer), !e && l != null && (e = n[l]), !s && a != null && (s = n[a]);
+  for (let r = n; r != null; r = Object.getPrototypeOf(r)) {
+    const i = Object.getOwnPropertySymbols(r), o = i.find((u) => u.toString() == "Symbol(renderer)"), l = i.find((u) => u.toString() == "Symbol(scene)"), a = i.find((u) => u.toString() == "Symbol(needsRender)");
+    !t && o != null && (t = n[o].threeRenderer), !e && l != null && (e = n[l]), !s && a != null && (s = n[a]);
   }
   if (t && e) {
-    let o = function() {
+    let r = function() {
       if (s) {
-        let i = 0, l = setInterval(() => {
-          if (i++ > 5) {
+        let o = 0, l = setInterval(() => {
+          if (o++ > 5) {
             clearInterval(l);
             return;
           }
@@ -1358,23 +1528,23 @@ function ke(n) {
       }
     };
     console.debug("[gltf-progressive] setup model-viewer");
-    const r = v.get(t, { engine: "model-viewer" });
-    return v.addPlugin(new xt()), r.enable(), r.addEventListener("changed", () => {
+    const i = v.get(t, { engine: "model-viewer" });
+    return v.addPlugin(new _t()), i.enable(), i.addEventListener("changed", () => {
       s?.call(n);
-    }), n.addEventListener("model-visibility", (i) => {
-      i.detail.visible && s?.call(n);
+    }), n.addEventListener("model-visibility", (o) => {
+      o.detail.visible && s?.call(n);
     }), n.addEventListener("load", () => {
-      o();
+      r();
     }), () => {
-      r.disable();
+      i.disable();
     };
   }
   return null;
 }
-class xt {
+class _t {
   _didWarnAboutMissingUrl = !1;
-  onBeforeUpdateLOD(t, e, s, o) {
-    this.tryParseMeshLOD(e, o), this.tryParseTextureLOD(e, o);
+  onBeforeUpdateLOD(t, e, s, r) {
+    this.tryParseMeshLOD(e, r), this.tryParseTextureLOD(e, r);
   }
   getUrl(t) {
     if (!t)
@@ -1389,80 +1559,80 @@ class xt {
     return t.element;
   }
   tryParseTextureLOD(t, e) {
-    if (e[re] == !0) return;
-    e[re] = !0;
-    const s = this.tryGetCurrentGLTF(t), o = this.tryGetCurrentModelViewer(t), r = this.getUrl(o);
-    if (r && s && e.material) {
-      let i = function(a) {
-        if (a[re] == !0) return;
-        a[re] = !0, a.userData && (a.userData.LOD = -1);
-        const d = Object.keys(a);
-        for (let u = 0; u < d.length; u++) {
-          const y = d[u], w = a[y];
+    if (e[ie] == !0) return;
+    e[ie] = !0;
+    const s = this.tryGetCurrentGLTF(t), r = this.tryGetCurrentModelViewer(t), i = this.getUrl(r);
+    if (i && s && e.material) {
+      let o = function(a) {
+        if (a[ie] == !0) return;
+        a[ie] = !0, a.userData && (a.userData.LOD = -1);
+        const u = Object.keys(a);
+        for (let c = 0; c < u.length; c++) {
+          const y = u[c], w = a[y];
           if (w?.isTexture === !0) {
-            const L = w.userData?.associations?.textures;
-            if (L == null) continue;
-            const I = s.parser.json.textures[L];
-            if (!I) {
-              console.warn("Texture data not found for texture index " + L);
+            const _ = w.userData?.associations?.textures;
+            if (_ == null) continue;
+            const k = s.parser.json.textures[_];
+            if (!k) {
+              console.warn("Texture data not found for texture index " + _);
               continue;
             }
-            if (I?.extensions?.[W]) {
-              const O = I.extensions[W];
-              O && r && m.registerTexture(r, w, O.lods.length, L, O);
+            if (k?.extensions?.[W]) {
+              const M = k.extensions[W];
+              M && i && m.registerTexture(i, w, M.lods.length, _, M);
             }
           }
         }
       };
       const l = e.material;
-      if (Array.isArray(l)) for (const a of l) i(a);
-      else i(l);
+      if (Array.isArray(l)) for (const a of l) o(a);
+      else o(l);
     }
   }
   tryParseMeshLOD(t, e) {
-    if (e[ve] == !0) return;
-    e[ve] = !0;
-    const s = this.tryGetCurrentModelViewer(t), o = this.getUrl(s);
-    if (!o)
+    if (e[Me] == !0) return;
+    e[Me] = !0;
+    const s = this.tryGetCurrentModelViewer(t), r = this.getUrl(s);
+    if (!r)
       return;
-    const r = e.userData?.gltfExtensions?.[W];
-    if (r && o) {
-      const i = e.uuid;
-      m.registerMesh(o, i, e, 0, r.lods.length, r);
+    const i = e.userData?.gltfExtensions?.[W];
+    if (i && r) {
+      const o = e.uuid;
+      m.registerMesh(r, o, e, 0, i.lods.length, i);
     }
   }
 }
-function wt(...n) {
-  let t, e, s, o;
+function Lt(...n) {
+  let t, e, s, r;
   switch (n.length) {
     case 2:
-      [s, e] = n, o = {};
+      [s, e] = n, r = {};
       break;
     case 3:
-      [s, e, o] = n;
+      [s, e, r] = n;
       break;
     case 4:
-      [t, e, s, o] = n;
+      [t, e, s, r] = n;
       break;
     default:
       throw new Error("Invalid arguments");
   }
-  xe(e), Se(s), Te(s, {
+  we(e), Te(s), Ae(s, {
     progressive: !0,
-    ...o?.hints
-  }), s.register((i) => new m(i));
-  const r = v.get(e);
-  return o?.enableLODsManager !== !1 && r.enable(), r;
+    ...r?.hints
+  }), s.register((o) => new m(o));
+  const i = v.get(e);
+  return r?.enableLODsManager !== !1 && i.enable(), i;
 }
-Ie();
-if (!rt) {
+Re();
+if (!nt) {
   const n = {
     gltfProgressive: {
-      useNeedleProgressive: wt,
+      useNeedleProgressive: Lt,
       LODsManager: v,
-      configureLoader: Te,
-      getRaycastMesh: Z,
-      useRaycastMeshes: it
+      configureLoader: Ae,
+      getRaycastMesh: ee,
+      useRaycastMeshes: lt
     }
   };
   if (!globalThis.Needle)
@@ -1475,15 +1645,15 @@ export {
   W as EXTENSION_NAME,
   v as LODsManager,
   m as NEEDLE_progressive,
-  je as VERSION,
-  Se as addDracoAndKTX2Loaders,
-  Te as configureLoader,
-  xe as createLoaders,
-  Z as getRaycastMesh,
-  Ie as patchModelViewer,
-  ot as registerRaycastMesh,
-  Qe as setDracoDecoderLocation,
-  Je as setKTX2TranscoderLocation,
-  wt as useNeedleProgressive,
-  it as useRaycastMeshes
+  Ke as VERSION,
+  Te as addDracoAndKTX2Loaders,
+  Ae as configureLoader,
+  we as createLoaders,
+  ee as getRaycastMesh,
+  Re as patchModelViewer,
+  at as registerRaycastMesh,
+  Je as setDracoDecoderLocation,
+  Ze as setKTX2TranscoderLocation,
+  Lt as useNeedleProgressive,
+  lt as useRaycastMeshes
 };