@iwsdk/core 0.4.2 → 0.5.0

package/dist/asset/cache-manager.d.ts

@@ -28,14 +28,16 @@ export declare class CacheManager {
     static getPromise<T>(url: string): Promise<T> | undefined;
     /** Store an in-flight promise for URL. */
     static setPromise<T>(url: string, promise: Promise<T>): void;
-    /** Remove in-flight promise (on resolve/reject). */
-    static deletePromise(url: string): void;
+    /** Remove an in-flight promise, optionally only when it is still current. */
+    static deletePromise(url: string, expected?: Promise<unknown>): boolean;
     /** True if an asset has been cached for URL. */
     static hasAsset(url: string): boolean;
     /** Retrieve a cached asset by URL. */
     static getAsset<T>(url: string): T | undefined;
     /** Store an asset by URL. */
     static setAsset<T>(url: string, asset: T): void;
+    /** Remove one cached asset by logical key or URL. */
+    static deleteAsset(keyOrUrl: string): boolean;
     /** Lookup asset by logical key or direct URL. */
     static getAssetByKey(key: string): any;
     /** Clear caches (useful during tests). */

package/dist/asset/cache-manager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/asset/cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAA0B;IAC9C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAmC;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,0CAA0C;IAC1C,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIlD,2CAA2C;IAC3C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI3C,mDAAmD;IACnD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,kDAAkD;IAClD,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS;IAIzD,0CAA0C;IAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D,oDAAoD;IACpD,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIvC,gDAAgD;IAChD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC,sCAAsC;IACtC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI9C,6BAA6B;IAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAI/C,iDAAiD;IACjD,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAetC,0CAA0C;IAC1C,MAAM,CAAC,KAAK,IAAI,IAAI;CAKrB"}
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../src/asset/cache-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAA0B;IAC9C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAmC;IAC9D,OAAO,CAAC,MAAM,CAAC,QAAQ,CAA6B;IAEpD,0CAA0C;IAC1C,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIlD,2CAA2C;IAC3C,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI3C,mDAAmD;IACnD,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIvC,kDAAkD;IAClD,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,SAAS;IAIzD,0CAA0C;IAC1C,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAI5D,6EAA6E;IAC7E,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;IAOvE,gDAAgD;IAChD,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIrC,sCAAsC;IACtC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAI9C,6BAA6B;IAC7B,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAI/C,qDAAqD;IACrD,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI7C,iDAAiD;IACjD,MAAM,CAAC,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAetC,0CAA0C;IAC1C,MAAM,CAAC,KAAK,IAAI,IAAI;CAKrB"}

package/dist/asset/cache-manager.js

@@ -36,9 +36,12 @@ class CacheManager {
     static setPromise(url, promise) {
         this.promiseCache.set(url, promise);
     }
-    /** Remove in-flight promise (on resolve/reject). */
-    static deletePromise(url) {
-        this.promiseCache.delete(url);
+    /** Remove an in-flight promise, optionally only when it is still current. */
+    static deletePromise(url, expected) {
+        if (expected != null && this.promiseCache.get(url) !== expected) {
+            return false;
+        }
+        return this.promiseCache.delete(url);
     }
     /** True if an asset has been cached for URL. */
     static hasAsset(url) {
@@ -52,6 +55,10 @@ class CacheManager {
     static setAsset(url, asset) {
         this.cache.set(url, asset);
     }
+    /** Remove one cached asset by logical key or URL. */
+    static deleteAsset(keyOrUrl) {
+        return this.cache.delete(this.resolveUrl(keyOrUrl));
+    }
     /** Lookup asset by logical key or direct URL. */
     static getAssetByKey(key) {
         // First check if this is a URL (direct cache access)

package/dist/asset/cache-manager.js.map

@@ -1 +1 @@
-{"version":3,"file":"cache-manager.js","sources":["../../src/asset/cache-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;AAEH;;;;;;;;;AASG;MACU,YAAY,CAAA;;AAMvB,IAAA,OAAO,WAAW,CAAC,GAAW,EAAE,GAAW,EAAA;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;IAC7B;;IAGA,OAAO,UAAU,CAAC,QAAgB,EAAA;;QAChC,OAAO,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,QAAQ;IAChD;;IAGA,OAAO,UAAU,CAAC,GAAW,EAAA;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;IACnC;;IAGA,OAAO,UAAU,CAAI,GAAW,EAAA;QAC9B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAe;IACjD;;AAGA,IAAA,OAAO,UAAU,CAAI,GAAW,EAAE,OAAmB,EAAA;QACnD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC;IACrC;;IAGA,OAAO,aAAa,CAAC,GAAW,EAAA;AAC9B,QAAA,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC;IAC/B;;IAGA,OAAO,QAAQ,CAAC,GAAW,EAAA;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5B;;IAGA,OAAO,QAAQ,CAAI,GAAW,EAAA;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAM;IACjC;;AAGA,IAAA,OAAO,QAAQ,CAAI,GAAW,EAAE,KAAQ,EAAA;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;IAC5B;;IAGA,OAAO,aAAa,CAAC,GAAW,EAAA;;QAE9B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B;;QAGA,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAClC,IAAI,GAAG,EAAE;YACP,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B;AAEA,QAAA,OAAO,SAAS;IAClB;;AAGA,IAAA,OAAO,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;AAClB,QAAA,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;AACzB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;;AAtEe,YAAA,CAAA,KAAK,GAAG,IAAI,GAAG,EAAe;AAC9B,YAAA,CAAA,YAAY,GAAG,IAAI,GAAG,EAAwB;AAC9C,YAAA,CAAA,QAAQ,GAAG,IAAI,GAAG,EAAkB;;;;"}
+{"version":3,"file":"cache-manager.js","sources":["../../src/asset/cache-manager.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;AAEH;;;;;;;;;AASG;MACU,YAAY,CAAA;;AAMvB,IAAA,OAAO,WAAW,CAAC,GAAW,EAAE,GAAW,EAAA;QACzC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC;IAC7B;;IAGA,OAAO,UAAU,CAAC,QAAgB,EAAA;;QAChC,OAAO,CAAA,EAAA,GAAA,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,QAAQ;IAChD;;IAGA,OAAO,UAAU,CAAC,GAAW,EAAA;QAC3B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;IACnC;;IAGA,OAAO,UAAU,CAAI,GAAW,EAAA;QAC9B,OAAO,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAe;IACjD;;AAGA,IAAA,OAAO,UAAU,CAAI,GAAW,EAAE,OAAmB,EAAA;QACnD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC;IACrC;;AAGA,IAAA,OAAO,aAAa,CAAC,GAAW,EAAE,QAA2B,EAAA;AAC3D,QAAA,IAAI,QAAQ,IAAI,IAAI,IAAI,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,QAAQ,EAAE;AAC/D,YAAA,OAAO,KAAK;QACd;QACA,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC;IACtC;;IAGA,OAAO,QAAQ,CAAC,GAAW,EAAA;QACzB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;IAC5B;;IAGA,OAAO,QAAQ,CAAI,GAAW,EAAA;QAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAM;IACjC;;AAGA,IAAA,OAAO,QAAQ,CAAI,GAAW,EAAE,KAAQ,EAAA;QACtC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;IAC5B;;IAGA,OAAO,WAAW,CAAC,QAAgB,EAAA;AACjC,QAAA,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IACrD;;IAGA,OAAO,aAAa,CAAC,GAAW,EAAA;;QAE9B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE;YACvB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B;;QAGA,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;QAClC,IAAI,GAAG,EAAE;YACP,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC;QAC5B;AAEA,QAAA,OAAO,SAAS;IAClB;;AAGA,IAAA,OAAO,KAAK,GAAA;AACV,QAAA,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE;AAClB,QAAA,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE;AACzB,QAAA,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;IACvB;;AA9Ee,YAAA,CAAA,KAAK,GAAG,IAAI,GAAG,EAAe;AAC9B,YAAA,CAAA,YAAY,GAAG,IAAI,GAAG,EAAwB;AAC9C,YAAA,CAAA,QAAQ,GAAG,IAAI,GAAG,EAAkB;;;;"}

package/dist/asset/loaders/audio-loader.d.ts

@@ -14,7 +14,7 @@ export declare class AudioAssetLoader {
     private static audioLoader;
     static init(loadingManager: LoadingManager): void;
     /** Load an AudioBuffer (URL or logical key), returning a cached instance when possible. */
-    static loadAudio(urlOrKey: string): Promise<AudioBuffer>;
+    static loadAudio(urlOrKey: string, timeoutMs?: number): Promise<AudioBuffer>;
     /** Get a cached AudioBuffer by logical key. */
     static getAudio(key: string): AudioBuffer | null;
 }

package/dist/asset/loaders/audio-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audio-loader.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/audio-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGrE;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAc;IAExC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAIjD,2FAA2F;WAC9E,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAoC9D,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAGjD"}
+{"version":3,"file":"audio-loader.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/audio-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAe,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAOrE;;;;GAIG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,WAAW,CAAc;IAExC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAIjD,2FAA2F;IAC3F,MAAM,CAAC,SAAS,CACd,QAAQ,EAAE,MAAM,EAChB,SAAS,SAAgC,GACxC,OAAO,CAAC,WAAW,CAAC;IAWvB,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;CAGjD"}

package/dist/asset/loaders/audio-loader.js

@@ -1,5 +1,6 @@
 import '../../runtime/three.js';
 import { CacheManager } from '../cache-manager.js';
+import { DEFAULT_ASSET_LOAD_TIMEOUT_MS, loadCachedAsset } from './cached-asset-load.js';
 import { AudioLoader } from 'three';
 
 /**
@@ -18,34 +19,15 @@ class AudioAssetLoader {
         this.audioLoader = new AudioLoader(loadingManager);
     }
     /** Load an AudioBuffer (URL or logical key), returning a cached instance when possible. */
-    static async loadAudio(urlOrKey) {
-        // Resolve URL from key if needed
+    static loadAudio(urlOrKey, timeoutMs = DEFAULT_ASSET_LOAD_TIMEOUT_MS) {
         const url = CacheManager.resolveUrl(urlOrKey);
-        // Check promise cache (prevent duplicate requests)
-        if (CacheManager.hasPromise(url)) {
-            return CacheManager.getPromise(url);
-        }
-        const loadingPromise = new Promise((resolve, reject) => {
-            // Check cache first
-            if (CacheManager.hasAsset(url)) {
-                resolve(CacheManager.getAsset(url));
-                CacheManager.deletePromise(url);
-            }
-            else {
-                // Load using Three.js AudioLoader
-                this.audioLoader.load(url, (buffer) => {
-                    CacheManager.setAsset(url, buffer);
-                    resolve(buffer);
-                    CacheManager.deletePromise(url);
-                }, undefined, // progress callback
-                (error) => {
-                    reject(error);
-                    CacheManager.deletePromise(url);
-                });
-            }
+        return loadCachedAsset({
+            load: (resolve, reject) => {
+                this.audioLoader.load(url, resolve, undefined, reject);
+            },
+            timeoutMs,
+            url,
         });
-        CacheManager.setPromise(url, loadingPromise);
-        return loadingPromise;
     }
     /** Get a cached AudioBuffer by logical key. */
     static getAudio(key) {

package/dist/asset/loaders/audio-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"audio-loader.js","sources":["../../../src/asset/loaders/audio-loader.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;;;;AAKG;AAKH;;;;AAIG;MACU,gBAAgB,CAAA;IAG3B,OAAO,IAAI,CAAC,cAA8B,EAAA;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,cAAc,CAAC;IACpD;;AAGA,IAAA,aAAa,SAAS,CAAC,QAAgB,EAAA;;QAErC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC;;AAG7C,QAAA,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChC,YAAA,OAAO,YAAY,CAAC,UAAU,CAAc,GAAG,CAAE;QACnD;QAEA,MAAM,cAAc,GAAG,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,KAAI;;AAElE,YAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBAC9B,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAc,GAAG,CAAE,CAAC;AACjD,gBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;YACjC;iBAAO;;gBAEL,IAAI,CAAC,WAAW,CAAC,IAAI,CACnB,GAAG,EACH,CAAC,MAAM,KAAI;AACT,oBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;oBAClC,OAAO,CAAC,MAAM,CAAC;AACf,oBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;gBACjC,CAAC,EACD,SAAS;gBACT,CAAC,KAAK,KAAI;oBACR,MAAM,CAAC,KAAK,CAAC;AACb,oBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;AACjC,gBAAA,CAAC,CACF;YACH;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,cAAc,CAAC;AAC5C,QAAA,OAAO,cAAc;IACvB;;IAGA,OAAO,QAAQ,CAAC,GAAW,EAAA;QACzB,OAAQ,YAAY,CAAC,aAAa,CAAC,GAAG,CAAiB,IAAI,IAAI;IACjE;AACD;;;;"}
+{"version":3,"file":"audio-loader.js","sources":["../../../src/asset/loaders/audio-loader.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAAA;;;;;AAKG;AASH;;;;AAIG;MACU,gBAAgB,CAAA;IAG3B,OAAO,IAAI,CAAC,cAA8B,EAAA;QACxC,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,cAAc,CAAC;IACpD;;AAGA,IAAA,OAAO,SAAS,CACd,QAAgB,EAChB,SAAS,GAAG,6BAA6B,EAAA;QAEzC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,CAAC;AAC7C,QAAA,OAAO,eAAe,CAAC;AACrB,YAAA,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAI;AACxB,gBAAA,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC;YACxD,CAAC;YACD,SAAS;YACT,GAAG;AACJ,SAAA,CAAC;IACJ;;IAGA,OAAO,QAAQ,CAAC,GAAW,EAAA;QACzB,OAAQ,YAAY,CAAC,aAAa,CAAC,GAAG,CAAiB,IAAI,IAAI;IACjE;AACD;;;;"}

package/dist/asset/loaders/cached-asset-load.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/** Default upper bound for one asset load. @category Assets */
+export declare const DEFAULT_ASSET_LOAD_TIMEOUT_MS = 30000;
+/** Low-level timeout raised by an individual asset loader. */
+export declare class AssetLoadTimeoutError extends Error {
+    readonly url: string;
+    readonly timeoutMs: number;
+    constructor(url: string, timeoutMs: number);
+}
+export interface CachedAssetLoadOptions<T> {
+    /** Dispose a late result that arrives after its request timed out. */
+    discard?: (asset: T) => void;
+    /** Start the underlying loader. The optional return value cancels it. */
+    load: (resolve: (asset: T) => void, reject: (error: unknown) => void) => (() => void) | void;
+    /** Replace, rather than join, an existing in-flight request. */
+    replacePending?: boolean;
+    timeoutMs?: number;
+    url: string;
+}
+/**
+ * Run one cache-backed load with request de-duplication and a finite timeout.
+ *
+ * Late callbacks are ignored after timeout and cannot publish into the cache.
+ * A loader may provide `discard` to release resources created by such a late
+ * callback. Replaced requests still settle for their original callers, but
+ * only the currently registered request may update shared cache state.
+ */
+export declare function loadCachedAsset<T>({ discard, load, replacePending, timeoutMs, url, }: CachedAssetLoadOptions<T>): Promise<T>;
+export declare function assertAssetLoadTimeout(timeoutMs: number): void;
+//# sourceMappingURL=cached-asset-load.d.ts.map

package/dist/asset/loaders/cached-asset-load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-asset-load.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/cached-asset-load.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,+DAA+D;AAC/D,eAAO,MAAM,6BAA6B,QAAS,CAAC;AAEpD,8DAA8D;AAC9D,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,SAAS,EAAE,MAAM;gBADjB,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM;CAK7B;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,sEAAsE;IACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,yEAAyE;IACzE,IAAI,EAAE,CACJ,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,EAC3B,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,KAC7B,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAC;IACzB,gEAAgE;IAChE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,EACjC,OAAO,EACP,IAAI,EACJ,cAAsB,EACtB,SAAyC,EACzC,GAAG,GACJ,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoExC;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAI9D"}

package/dist/asset/loaders/cached-asset-load.js

@@ -0,0 +1,100 @@
+import { CacheManager } from '../cache-manager.js';
+
+/**
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/** Default upper bound for one asset load. @category Assets */
+const DEFAULT_ASSET_LOAD_TIMEOUT_MS = 30000;
+/** Low-level timeout raised by an individual asset loader. */
+class AssetLoadTimeoutError extends Error {
+    constructor(url, timeoutMs) {
+        super(`Asset load timed out after ${timeoutMs} ms: ${url}`);
+        this.url = url;
+        this.timeoutMs = timeoutMs;
+        this.name = 'AssetLoadTimeoutError';
+    }
+}
+/**
+ * Run one cache-backed load with request de-duplication and a finite timeout.
+ *
+ * Late callbacks are ignored after timeout and cannot publish into the cache.
+ * A loader may provide `discard` to release resources created by such a late
+ * callback. Replaced requests still settle for their original callers, but
+ * only the currently registered request may update shared cache state.
+ */
+function loadCachedAsset({ discard, load, replacePending = false, timeoutMs = DEFAULT_ASSET_LOAD_TIMEOUT_MS, url, }) {
+    assertAssetLoadTimeout(timeoutMs);
+    if (!replacePending) {
+        const pending = CacheManager.getPromise(url);
+        if (pending != null) {
+            return pending;
+        }
+        const cached = CacheManager.getAsset(url);
+        if (cached != null) {
+            return Promise.resolve(cached);
+        }
+    }
+    let active = true;
+    let cancel;
+    let resolvePromise;
+    let rejectPromise;
+    const promise = new Promise((resolve, reject) => {
+        resolvePromise = resolve;
+        rejectPromise = reject;
+    });
+    CacheManager.setPromise(url, promise);
+    const timer = setTimeout(() => {
+        if (!active) {
+            return;
+        }
+        active = false;
+        try {
+            cancel === null || cancel === void 0 ? void 0 : cancel();
+        }
+        catch (_a) {
+            // Timeout identity wins; cancellation is best-effort cleanup only.
+        }
+        CacheManager.deletePromise(url, promise);
+        rejectPromise(new AssetLoadTimeoutError(url, timeoutMs));
+    }, timeoutMs);
+    const resolve = (asset) => {
+        if (!active) {
+            discard === null || discard === void 0 ? void 0 : discard(asset);
+            return;
+        }
+        active = false;
+        clearTimeout(timer);
+        if (CacheManager.getPromise(url) === promise) {
+            CacheManager.setAsset(url, asset);
+            CacheManager.deletePromise(url, promise);
+        }
+        resolvePromise(asset);
+    };
+    const reject = (error) => {
+        if (!active) {
+            return;
+        }
+        active = false;
+        clearTimeout(timer);
+        CacheManager.deletePromise(url, promise);
+        rejectPromise(error);
+    };
+    try {
+        cancel = load(resolve, reject);
+    }
+    catch (error) {
+        reject(error);
+    }
+    return promise;
+}
+function assertAssetLoadTimeout(timeoutMs) {
+    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
+        throw new Error('Asset load timeout must be a positive finite number');
+    }
+}
+
+export { AssetLoadTimeoutError, DEFAULT_ASSET_LOAD_TIMEOUT_MS, assertAssetLoadTimeout, loadCachedAsset };
+//# sourceMappingURL=cached-asset-load.js.map

package/dist/asset/loaders/cached-asset-load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cached-asset-load.js","sources":["../../../src/asset/loaders/cached-asset-load.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/asset/loaders/gltf-loader.d.ts

@@ -6,6 +6,22 @@
  */
 import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
 import { LoadingManager, WebGLRenderer } from '../../runtime/index.js';
+/** Default maximum combined response size for one staged model. */
+export declare const DEFAULT_MAX_MODEL_PAYLOAD_BYTES: number;
+/** Default maximum combined primary-response size for staged scene models. */
+export declare const DEFAULT_MAX_TOTAL_MODEL_PAYLOAD_BYTES: number;
+/** Exact response-byte result from a detached, non-caching glTF load. */
+export interface DetachedGLTFLoad {
+    gltf: GLTF;
+    payloadBytes: number;
+}
+/** Error raised when an actual model response exceeds its configured ceiling. */
+export declare class GLTFPayloadLimitError extends Error {
+    readonly url: string;
+    readonly actualBytes: number;
+    readonly limitBytes: number;
+    constructor(url: string, actualBytes: number, limitBytes: number);
+}
 /** Options for retrieving a cached GLTF. @category Assets */
 export interface GetGLTFOptions {
     /**
@@ -43,7 +59,16 @@ export declare class GLTFAssetLoader {
      * suitable for placing into multiple entities, call {@link GLTFAssetLoader.getGLTF}
      * (or `AssetManager.getGLTF`) by key after the load resolves.
      */
-    static loadGLTF(url: string, key?: string): Promise<GLTF>;
+    static loadGLTF(urlOrKey: string, key?: string, timeoutMs?: number): Promise<GLTF>;
+    /**
+     * Fetch and parse a glTF without touching the shared URL, promise, or key
+     * caches. The glTF/GLB response plus external glTF buffers and images are
+     * measured from their actual decoded bytes; `Content-Length` is used only as
+     * an early rejection signal.
+     */
+    static loadGLTFDetached(url: string, maxPayloadBytes?: number): Promise<DetachedGLTFLoad>;
+    /** Clone a glTF object tree while retaining its renderer resources by reference. */
+    static cloneGLTF(gltf: GLTF): GLTF;
     /**
      * Get a cached GLTF by logical key.
      *
@@ -62,4 +87,6 @@ export declare class GLTFAssetLoader {
      */
     static getGLTF(key: string, options?: GetGLTFOptions): GLTF | null;
 }
+/** Dispose every renderer resource reachable from a detached glTF scene tree. */
+export declare function disposeGLTFResources(gltf: GLTF): void;
 //# sourceMappingURL=gltf-loader.d.ts.map

package/dist/asset/loaders/gltf-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gltf-loader.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/gltf-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,IAAI,EAAc,MAAM,0CAA0C,CAAC;AAG5E,OAAO,EAEL,cAAc,EAEd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAGhC,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAa;IACtC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAc;IACxC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAa;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACxB,GACL,IAAI;IAmBP;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCzD;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI,GAAG,IAAI;CAcvE"}
+{"version":3,"file":"gltf-loader.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/gltf-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAE,IAAI,EAAc,MAAM,0CAA0C,CAAC;AAG5E,OAAO,EAEL,cAAc,EAKd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAOhC,mEAAmE;AACnE,eAAO,MAAM,+BAA+B,QAAgC,CAAC;AAE7E,8EAA8E;AAC9E,eAAO,MAAM,qCAAqC,QACb,CAAC;AAEtC,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,IAAI,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,iFAAiF;AACjF,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,GAAG,EAAE,MAAM;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM;gBAFlB,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM;CAO9B;AAED,6DAA6D;AAC7D,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAID;;;;GAIG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,UAAU,CAAa;IACtC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAc;IACxC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAa;IAEtC;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CACT,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,aAAa,EACvB,OAAO,GAAE;QACP,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACxB,GACL,IAAI;IAmBP;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CACb,QAAQ,EAAE,MAAM,EAChB,GAAG,CAAC,EAAE,MAAM,EACZ,SAAS,SAAgC,GACxC,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;;;OAKG;WACU,gBAAgB,CAC3B,GAAG,EAAE,MAAM,EACX,eAAe,SAAkC,GAChD,OAAO,CAAC,gBAAgB,CAAC;IA2D5B,oFAAoF;IACpF,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAQlC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,IAAI,GAAG,IAAI;CAUvE;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAgDrD"}