@iwsdk/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Meta Platforms, Inc. and affiliates.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -0,0 +1,72 @@
+/**
+ * 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.
+ */
+import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import type { World } from '../ecs/index.js';
+import { LoadingManager, Texture, WebGLRenderer } from '../runtime/index.js';
+/**
+ * Asset types supported by the {@link AssetManager}.
+ * @category Assets
+ */
+export declare enum AssetType {
+    GLTF = "gltf",// 3D models (cached)
+    Audio = "audio",// Audio buffers (cached)
+    Texture = "texture",// 3D textures (cached)
+    HDRTexture = "hdr-texture"
+}
+/**
+ * Declarative manifest for preloading assets.
+ * @category Assets
+ */
+export interface AssetManifest {
+    [key: string]: {
+        url: string;
+        type: AssetType;
+        priority?: 'critical' | 'background';
+    };
+}
+/** Loader-level options for GLTF/HDR loaders. @category Assets */
+export interface AssetManagerOptions {
+    dracoDecoderPath: string;
+    ktx2TranscoderPath: string;
+}
+/**
+ * Centralized asset loader with caching and priority‑based preloading.
+ *
+ * @remarks
+ * - Initializes loader instances against a shared `LoadingManager`.
+ * - `preloadAssets` loads critical assets first (blocking), then starts background ones.
+ * - Use `getGLTF`/`getTexture`/`getAudio` to retrieve cached results by key.
+ * @category Assets
+ */
+export declare class AssetManager {
+    static loadingManager: LoadingManager;
+    static world: World;
+    /**
+     * Initialize loaders and bind to the current world/renderer.
+     */
+    static init(renderer: WebGLRenderer, world: World, options?: Partial<AssetManagerOptions>): void;
+    /** Preload assets with critical/background prioritization. */
+    static preloadAssets(manifest: AssetManifest): Promise<void>;
+    private static loadAssetByType;
+    /** Load a GLTF by URL; optionally register a logical key. */
+    static loadGLTF(url: string, key?: string): Promise<GLTF>;
+    /** Fetch any cached asset by logical key. */
+    static getAsset(key: string): any;
+    /** Load an AudioBuffer by URL; optionally register a logical key. */
+    static loadAudio(url: string, key?: string): Promise<AudioBuffer>;
+    /** Get a cached AudioBuffer by logical key. */
+    static getAudio(key: string): AudioBuffer | null;
+    /** Load a Texture by URL; optionally register a logical key. */
+    static loadTexture(url: string, key?: string): Promise<Texture>;
+    /** Get a cached Texture by logical key. */
+    static getTexture(key: string): Texture | null;
+    /** Load an HDR equirectangular texture; optionally register a logical key. */
+    static loadHDRTexture(url: string, key?: string): Promise<Texture>;
+    /** Get a cached GLTF by logical key. */
+    static getGLTF(key: string): GLTF | null;
+}
+//# sourceMappingURL=asset-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"asset-manager.d.ts","sourceRoot":"","sources":["../../src/asset/asset-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,0CAA0C,CAAC;AAChE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAO7E;;;GAGG;AACH,oBAAY,SAAS;IACnB,IAAI,SAAS,CAAE,qBAAqB;IACpC,KAAK,UAAU,CAAE,yBAAyB;IAC1C,OAAO,YAAY,CAAE,uBAAuB;IAC5C,UAAU,gBAAgB;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,SAAS,CAAC;QAChB,QAAQ,CAAC,EAAE,UAAU,GAAG,YAAY,CAAC;KACtC,CAAC;CACH;AAED,kEAAkE;AAClE,MAAM,WAAW,mBAAmB;IAClC,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,MAAM,CAAC,cAAc,EAAE,cAAc,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC;IAEpB;;OAEG;IACH,MAAM,CAAC,IAAI,CACT,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,OAAO,CAAC,mBAAmB,CAAM;IAY5C,8DAA8D;WACjD,aAAa,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;mBA0B7C,eAAe;IAmBpC,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzD,6CAA6C;IAC7C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG;IAKjC,qEAAqE;WACxD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IASvE,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAIhD,gEAAgE;WACnD,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASrE,2CAA2C;IAC3C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;IAI9C,8EAA8E;WACjE,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASxE,wCAAwC;IACxC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;CAGzC"}

package/dist/asset/asset-manager.js

@@ -0,0 +1,138 @@
+import '../runtime/three.js';
+import { CacheManager } from './cache-manager.js';
+import { AudioAssetLoader } from './loaders/audio-loader.js';
+import { GLTFAssetLoader } from './loaders/gltf-loader.js';
+import { HDRTextureAssetLoader } from './loaders/hdr-texture-loader.js';
+import { TextureAssetLoader } from './loaders/texture-loader.js';
+import { LoadingManager } from 'three';
+
+/**
+ * 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.
+ */
+/**
+ * Asset types supported by the {@link AssetManager}.
+ * @category Assets
+ */
+var AssetType;
+(function (AssetType) {
+    AssetType["GLTF"] = "gltf";
+    AssetType["Audio"] = "audio";
+    AssetType["Texture"] = "texture";
+    AssetType["HDRTexture"] = "hdr-texture";
+})(AssetType || (AssetType = {}));
+/**
+ * Centralized asset loader with caching and priority‑based preloading.
+ *
+ * @remarks
+ * - Initializes loader instances against a shared `LoadingManager`.
+ * - `preloadAssets` loads critical assets first (blocking), then starts background ones.
+ * - Use `getGLTF`/`getTexture`/`getAudio` to retrieve cached results by key.
+ * @category Assets
+ */
+class AssetManager {
+    /**
+     * Initialize loaders and bind to the current world/renderer.
+     */
+    static init(renderer, world, options = {}) {
+        this.world = world;
+        this.loadingManager = new LoadingManager();
+        // Initialize all specialized loaders
+        AudioAssetLoader.init(this.loadingManager);
+        GLTFAssetLoader.init(this.loadingManager, renderer, options);
+        TextureAssetLoader.init(this.loadingManager);
+        HDRTextureAssetLoader.init(this.loadingManager);
+    }
+    /** Preload assets with critical/background prioritization. */
+    static async preloadAssets(manifest) {
+        // Separate by priority
+        const criticalAssets = Object.entries(manifest).filter(([_, config]) => {
+            return config.priority !== 'background';
+        });
+        const backgroundAssets = Object.entries(manifest).filter(([_, config]) => {
+            return config.priority === 'background';
+        });
+        // Phase 1: Load critical assets (blocking)
+        const criticalPromises = criticalAssets.map(([key, config]) => {
+            CacheManager.setKeyToUrl(key, config.url);
+            return this.loadAssetByType(config.url, config.type, key);
+        });
+        await Promise.all(criticalPromises);
+        // Phase 2: Start background loading (non-blocking)
+        backgroundAssets.forEach(([key, config]) => {
+            CacheManager.setKeyToUrl(key, config.url);
+            this.loadAssetByType(config.url, config.type, key).catch((err) => console.warn(`Background asset failed: ${key}`, err));
+        });
+    }
+    static async loadAssetByType(url, type, key) {
+        switch (type) {
+            case AssetType.GLTF:
+                return GLTFAssetLoader.loadGLTF(url, key);
+            case AssetType.Audio:
+                return AudioAssetLoader.loadAudio(url);
+            case AssetType.Texture:
+                return TextureAssetLoader.loadTexture(url);
+            case AssetType.HDRTexture:
+                return HDRTextureAssetLoader.loadHDRTexture(url);
+            default:
+                throw new Error(`Unsupported asset type: ${type}`);
+        }
+    }
+    /** Load a GLTF by URL; optionally register a logical key. */
+    static loadGLTF(url, key) {
+        return GLTFAssetLoader.loadGLTF(url, key);
+    }
+    // GLXF has been removed from the asset pipeline. Use World.loadLevel(url).
+    /** Fetch any cached asset by logical key. */
+    static getAsset(key) {
+        return CacheManager.getAssetByKey(key);
+    }
+    // Public API Methods - delegate to specialized loaders
+    /** Load an AudioBuffer by URL; optionally register a logical key. */
+    static async loadAudio(url, key) {
+        if (key) {
+            CacheManager.setKeyToUrl(key, url);
+        }
+        else {
+            CacheManager.setKeyToUrl(url, url);
+        }
+        return AudioAssetLoader.loadAudio(url);
+    }
+    /** Get a cached AudioBuffer by logical key. */
+    static getAudio(key) {
+        return AudioAssetLoader.getAudio(key);
+    }
+    /** Load a Texture by URL; optionally register a logical key. */
+    static async loadTexture(url, key) {
+        if (key) {
+            CacheManager.setKeyToUrl(key, url);
+        }
+        else {
+            CacheManager.setKeyToUrl(url, url);
+        }
+        return TextureAssetLoader.loadTexture(url);
+    }
+    /** Get a cached Texture by logical key. */
+    static getTexture(key) {
+        return TextureAssetLoader.getTexture(key);
+    }
+    /** Load an HDR equirectangular texture; optionally register a logical key. */
+    static async loadHDRTexture(url, key) {
+        if (key) {
+            CacheManager.setKeyToUrl(key, url);
+        }
+        else {
+            CacheManager.setKeyToUrl(url, url);
+        }
+        return HDRTextureAssetLoader.loadHDRTexture(url);
+    }
+    /** Get a cached GLTF by logical key. */
+    static getGLTF(key) {
+        return GLTFAssetLoader.getGLTF(key);
+    }
+}
+
+export { AssetManager, AssetType };
+//# sourceMappingURL=asset-manager.js.map

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * 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.
+ */
+/**
+ * Central cache for assets and in-flight loads used by {@link AssetManager}.
+ *
+ * @remarks
+ * - Tracks a key→URL registry so callers may refer to assets by logical keys.
+ * - De-duplicates concurrent requests via a promise cache.
+ * - Stores resolved assets for fast reuse.
+ *
+ * @category Assets
+ */
+export declare class CacheManager {
+    private static cache;
+    private static promiseCache;
+    private static keyToUrl;
+    /** Record a logical key → URL mapping. */
+    static setKeyToUrl(key: string, url: string): void;
+    /** Resolve a key or pass-through a URL. */
+    static resolveUrl(urlOrKey: string): string;
+    /** True if an in-flight promise exists for URL. */
+    static hasPromise(url: string): boolean;
+    /** Get the in-flight promise for URL (if any). */
+    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;
+    /** 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;
+    /** Lookup asset by logical key or direct URL. */
+    static getAssetByKey(key: string): any;
+    /** Clear caches (useful during tests). */
+    static clear(): void;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

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

@@ -0,0 +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"}

package/dist/asset/cache-manager.js

@@ -0,0 +1,80 @@
+/**
+ * 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.
+ */
+/**
+ * Central cache for assets and in-flight loads used by {@link AssetManager}.
+ *
+ * @remarks
+ * - Tracks a key→URL registry so callers may refer to assets by logical keys.
+ * - De-duplicates concurrent requests via a promise cache.
+ * - Stores resolved assets for fast reuse.
+ *
+ * @category Assets
+ */
+class CacheManager {
+    /** Record a logical key → URL mapping. */
+    static setKeyToUrl(key, url) {
+        this.keyToUrl.set(key, url);
+    }
+    /** Resolve a key or pass-through a URL. */
+    static resolveUrl(urlOrKey) {
+        var _a;
+        return (_a = this.keyToUrl.get(urlOrKey)) !== null && _a !== void 0 ? _a : urlOrKey;
+    }
+    /** True if an in-flight promise exists for URL. */
+    static hasPromise(url) {
+        return this.promiseCache.has(url);
+    }
+    /** Get the in-flight promise for URL (if any). */
+    static getPromise(url) {
+        return this.promiseCache.get(url);
+    }
+    /** Store an in-flight promise for URL. */
+    static setPromise(url, promise) {
+        this.promiseCache.set(url, promise);
+    }
+    /** Remove in-flight promise (on resolve/reject). */
+    static deletePromise(url) {
+        this.promiseCache.delete(url);
+    }
+    /** True if an asset has been cached for URL. */
+    static hasAsset(url) {
+        return this.cache.has(url);
+    }
+    /** Retrieve a cached asset by URL. */
+    static getAsset(url) {
+        return this.cache.get(url);
+    }
+    /** Store an asset by URL. */
+    static setAsset(url, asset) {
+        this.cache.set(url, asset);
+    }
+    /** Lookup asset by logical key or direct URL. */
+    static getAssetByKey(key) {
+        // First check if this is a URL (direct cache access)
+        if (this.cache.has(key)) {
+            return this.cache.get(key);
+        }
+        // Otherwise, look up the URL from the key registry
+        const url = this.keyToUrl.get(key);
+        if (url) {
+            return this.cache.get(url);
+        }
+        return undefined;
+    }
+    /** Clear caches (useful during tests). */
+    static clear() {
+        this.cache.clear();
+        this.promiseCache.clear();
+        this.keyToUrl.clear();
+    }
+}
+CacheManager.cache = new Map();
+CacheManager.promiseCache = new Map();
+CacheManager.keyToUrl = new Map();
+
+export { CacheManager };
+//# sourceMappingURL=cache-manager.js.map

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

@@ -0,0 +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;;;;"}

package/dist/asset/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 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.
+ */
+export * from './asset-manager.js';
+export * from './cache-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/asset/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/asset/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC"}

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

@@ -0,0 +1,21 @@
+/**
+ * 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.
+ */
+import { LoadingManager } from '../../runtime/index.js';
+/**
+ * Audio buffer loader with de-duplication and caching.
+ *
+ * @category Assets
+ */
+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>;
+    /** Get a cached AudioBuffer by logical key. */
+    static getAudio(key: string): AudioBuffer | null;
+}
+//# sourceMappingURL=audio-loader.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,57 @@
+import '../../runtime/three.js';
+import { CacheManager } from '../cache-manager.js';
+import { AudioLoader } from 'three';
+
+/**
+ * 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.
+ */
+/**
+ * Audio buffer loader with de-duplication and caching.
+ *
+ * @category Assets
+ */
+class AudioAssetLoader {
+    static init(loadingManager) {
+        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
+        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);
+                });
+            }
+        });
+        CacheManager.setPromise(url, loadingPromise);
+        return loadingPromise;
+    }
+    /** Get a cached AudioBuffer by logical key. */
+    static getAudio(key) {
+        return CacheManager.getAssetByKey(key) || null;
+    }
+}
+
+export { AudioAssetLoader };
+//# sourceMappingURL=audio-loader.js.map

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

@@ -0,0 +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;;;;"}

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

@@ -0,0 +1,33 @@
+/**
+ * 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.
+ */
+import { GLTF } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { LoadingManager, WebGLRenderer } from '../../runtime/index.js';
+/**
+ * GLTF loader with DRACO/KTX2 support, de-duplication, and caching.
+ *
+ * @category Assets
+ */
+export declare class GLTFAssetLoader {
+    private static gltfLoader;
+    private static dracoLoader;
+    private static ktx2Loader;
+    /**
+     * Initialize loader instances and configure decoders/transcoders.
+     * @param loadingManager Shared Three.js `LoadingManager`.
+     * @param renderer Renderer used to detect KTX2 support.
+     * @param options Optional decoder/transcoder paths (fall back to CDN paths matching Three r{REVISION}).
+     */
+    static init(loadingManager: LoadingManager, renderer: WebGLRenderer, options?: {
+        dracoDecoderPath?: string;
+        ktx2TranscoderPath?: string;
+    }): void;
+    /** Load a GLTF by URL, caching the result; optionally register a logical key. */
+    static loadGLTF(url: string, key?: string): Promise<GLTF>;
+    /** Get a cached GLTF by logical key. */
+    static getGLTF(key: string): GLTF | null;
+}
+//# sourceMappingURL=gltf-loader.d.ts.map

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

@@ -0,0 +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;AAE5E,OAAO,EACL,cAAc,EAEd,aAAa,EACd,MAAM,wBAAwB,CAAC;AAKhC;;;;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,iFAAiF;IACjF,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoCzD,wCAAwC;IACxC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;CAGzC"}

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

@@ -0,0 +1,79 @@
+import { DRACOLoader } from 'three/examples/jsm/loaders/DRACOLoader.js';
+import { GLTFLoader } from 'three/examples/jsm/loaders/GLTFLoader.js';
+import { KTX2Loader } from 'three/examples/jsm/loaders/KTX2Loader.js';
+import '../../runtime/three.js';
+import { CacheManager } from '../cache-manager.js';
+import { REVISION } from 'three';
+
+/**
+ * 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.
+ */
+const THREE_PATH = `https://unpkg.com/three@0.${REVISION}.0`;
+/**
+ * GLTF loader with DRACO/KTX2 support, de-duplication, and caching.
+ *
+ * @category Assets
+ */
+class GLTFAssetLoader {
+    /**
+     * Initialize loader instances and configure decoders/transcoders.
+     * @param loadingManager Shared Three.js `LoadingManager`.
+     * @param renderer Renderer used to detect KTX2 support.
+     * @param options Optional decoder/transcoder paths (fall back to CDN paths matching Three r{REVISION}).
+     */
+    static init(loadingManager, renderer, options = {}) {
+        var _a, _b;
+        // Initialize DRACO loader
+        this.dracoLoader = new DRACOLoader(loadingManager).setDecoderPath((_a = options.dracoDecoderPath) !== null && _a !== void 0 ? _a : `${THREE_PATH}/examples/jsm/libs/draco/gltf/`);
+        // Initialize KTX2 loader
+        this.ktx2Loader = new KTX2Loader(loadingManager)
+            .setTranscoderPath((_b = options.ktx2TranscoderPath) !== null && _b !== void 0 ? _b : `${THREE_PATH}/examples/jsm/libs/basis/`)
+            .detectSupport(renderer);
+        // Initialize GLTF loader with compression support
+        this.gltfLoader = new GLTFLoader(loadingManager)
+            .setDRACOLoader(this.dracoLoader)
+            .setKTX2Loader(this.ktx2Loader);
+    }
+    /** Load a GLTF by URL, caching the result; optionally register a logical key. */
+    static loadGLTF(url, key) {
+        // Always use URL as cache key for consistent caching
+        if (CacheManager.hasPromise(url)) {
+            return CacheManager.getPromise(url);
+        }
+        else {
+            // If a key is provided, store the key->URL mapping
+            if (key) {
+                CacheManager.setKeyToUrl(key, url);
+            }
+            const loadingPromise = new Promise((resolve, reject) => {
+                if (CacheManager.hasAsset(url)) {
+                    resolve(CacheManager.getAsset(url));
+                    CacheManager.deletePromise(url);
+                }
+                else {
+                    this.gltfLoader.load(url, (gltf) => {
+                        CacheManager.setAsset(url, gltf);
+                        resolve(gltf);
+                        CacheManager.deletePromise(url);
+                    }, () => { }, // progress callback
+                    (error) => {
+                        reject(error);
+                        CacheManager.deletePromise(url);
+                    });
+                }
+            });
+            CacheManager.setPromise(url, loadingPromise);
+            return loadingPromise;
+        }
+    }
+    /** Get a cached GLTF by logical key. */
+    static getGLTF(key) {
+        return CacheManager.getAssetByKey(key) || null;
+    }
+}
+
+export { GLTFAssetLoader };
+//# sourceMappingURL=gltf-loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-loader.js","sources":["../../../src/asset/loaders/gltf-loader.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAAA;;;;;AAKG;AAYH,MAAM,UAAU,GAAG,CAAA,0BAAA,EAA6B,QAAQ,IAAI;AAE5D;;;;AAIG;MACU,eAAe,CAAA;AAK1B;;;;;AAKG;IACH,OAAO,IAAI,CACT,cAA8B,EAC9B,QAAuB,EACvB,UAGI,EAAE,EAAA;;;QAGN,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,cAAc,CAAC,CAAC,cAAc,CAC/D,CAAA,EAAA,GAAA,OAAO,CAAC,gBAAgB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,GAAG,UAAU,CAAA,8BAAA,CAAgC,CAC1E;;AAGD,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,cAAc;aAC5C,iBAAiB,CAChB,MAAA,OAAO,CAAC,kBAAkB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,CAAA,EAAG,UAAU,CAAA,yBAAA,CAA2B;aAEvE,aAAa,CAAC,QAAQ,CAAC;;AAG1B,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,cAAc;AAC5C,aAAA,cAAc,CAAC,IAAI,CAAC,WAAW;AAC/B,aAAA,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC;IACnC;;AAGA,IAAA,OAAO,QAAQ,CAAC,GAAW,EAAE,GAAY,EAAA;;AAEvC,QAAA,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChC,YAAA,OAAO,YAAY,CAAC,UAAU,CAAO,GAAG,CAAE;QAC5C;aAAO;;YAEL,IAAI,GAAG,EAAE;AACP,gBAAA,YAAY,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC;YACpC;YAEA,MAAM,cAAc,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,KAAI;AAC3D,gBAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;oBAC9B,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAO,GAAG,CAAE,CAAC;AAC1C,oBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;gBACjC;qBAAO;oBACL,IAAI,CAAC,UAAU,CAAC,IAAI,CAClB,GAAG,EACH,CAAC,IAAI,KAAI;AACP,wBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;wBAChC,OAAO,CAAC,IAAI,CAAC;AACb,wBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;AACjC,oBAAA,CAAC,EACD,MAAK,EAAE,CAAC;oBACR,CAAC,KAAK,KAAI;wBACR,MAAM,CAAC,KAAK,CAAC;AACb,wBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;AACjC,oBAAA,CAAC,CACF;gBACH;AACF,YAAA,CAAC,CAAC;AAEF,YAAA,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,cAAc,CAAC;AAC5C,YAAA,OAAO,cAAc;QACvB;IACF;;IAGA,OAAO,OAAO,CAAC,GAAW,EAAA;QACxB,OAAQ,YAAY,CAAC,aAAa,CAAC,GAAG,CAAU,IAAI,IAAI;IAC1D;AACD;;;;"}

package/dist/asset/loaders/hdr-texture-loader.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+import { LoadingManager, Texture } from '../../runtime/index.js';
+/** HDR equirectangular texture loader with de-duplication and caching.
+ * @category Assets
+ */
+export declare class HDRTextureAssetLoader {
+    private static rgbeLoader;
+    private static exrLoader;
+    static init(loadingManager: LoadingManager): void;
+    /** Load an HDR `.hdr`/`.exr` texture by URL, returning a cached instance when possible. */
+    static loadHDRTexture(url: string): Promise<Texture>;
+}
+//# sourceMappingURL=hdr-texture-loader.d.ts.map

package/dist/asset/loaders/hdr-texture-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdr-texture-loader.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/hdr-texture-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAEL,cAAc,EACd,OAAO,EACR,MAAM,wBAAwB,CAAC;AAGhC;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAa;IACtC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAY;IAEpC,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAKjD,2FAA2F;WAC9E,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAgD3D"}