@needle-tools/gltf-progressive 4.0.0-alpha.4 → 4.0.0-alpha.6

package/lib/loaders.js

@@ -29,7 +29,8 @@ if (typeof window !== "undefined") {
         }
     })
         .finally(() => {
-        prepareLoaders();
+        if (preloadLoaders)
+            prepareLoaders();
     });
 }
 // #region Loader Configuration
@@ -79,15 +80,25 @@ export function setKTX2TranscoderLocation(location) {
  * @returns The loaders/decoders.
  */
 export function createLoaders(renderer) {
-    prepareLoaders();
+    preloadLoaders = true;
+    const loaders = prepareLoaders();
     if (renderer) {
-        ktx2Loader.detectSupport(renderer);
+        loaders.ktx2Loader.detectSupport(renderer);
     }
     else if (renderer !== null)
         console.warn("No renderer provided to detect ktx2 support - loading KTX2 textures might fail");
-    return { dracoLoader, ktx2Loader, meshoptDecoder };
+    return loaders;
+}
+/** Release the shared Draco and KTX2 workers when no engine context uses them. */
+export function disposeLoaders() {
+    preloadLoaders = false;
+    dracoLoader?.dispose();
+    ktx2Loader?.dispose();
+    dracoLoader = undefined;
+    ktx2Loader = undefined;
 }
 export function addDracoAndKTX2Loaders(loader) {
+    const { dracoLoader, ktx2Loader, meshoptDecoder } = prepareLoaders();
     if (!loader.dracoLoader)
         loader.setDRACOLoader(dracoLoader);
     if (!loader.ktx2Loader)
@@ -97,6 +108,7 @@ export function addDracoAndKTX2Loaders(loader) {
 }
 // #region internal
 const $dracoDecoderPath = Symbol("dracoDecoderPath");
+let preloadLoaders = true;
 let dracoLoader;
 let meshoptDecoder;
 let ktx2Loader;
@@ -119,6 +131,7 @@ function prepareLoaders() {
     if (!meshoptDecoder) {
         meshoptDecoder = MeshoptDecoder;
     }
+    return { dracoLoader, ktx2Loader, meshoptDecoder };
 }
 const gltfLoaderConfigurations = new WeakMap();
 export function configureLoader(loader, opts) {

package/lib/utils.internal.js

@@ -106,14 +106,9 @@ export class PromiseQueue {
     constructor(maxConcurrent, opts = {}) {
         this.maxConcurrent = maxConcurrent;
         this.debug = opts.debug ?? false;
-        // Dedicated workers can have requestAnimationFrame when they are owned by a window.
-        // Other worker-like scopes do not, so keep the frame-based tick when available and fall back to timers otherwise.
-        if (typeof globalThis.requestAnimationFrame === "function") {
-            globalThis.requestAnimationFrame(this.tick);
-        }
-        else {
-            setTimeout(this.tick, 0);
-        }
+        // Start with a timer, not requestAnimationFrame: window rAF does not fire while an immersive WebXR session
+        // is presenting (e.g. a page reloaded straight into VR via sessiongranted), so the queue would never tick.
+        setTimeout(this.tick, 0);
     }
     tick = () => {
         this.internalUpdate();

package/lib/version.js

@@ -1,4 +1,4 @@
 // replaced at build time
-export const version = "4.0.0-alpha.4";
+export const version = "4.0.0-alpha.6";
 globalThis["GLTF_PROGRESSIVE_VERSION"] = version;
 console.debug(`[gltf-progressive] version ${version || "-"}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@needle-tools/gltf-progressive",
-  "version": "4.0.0-alpha.4",
+  "version": "4.0.0-alpha.6",
   "description": "three.js support for loading glTF or GLB files that contain progressive loading data",
   "homepage": "https://needle.tools",
   "author": {