@iwsdk/core 0.1.0

package/dist/asset/loaders/hdr-texture-loader.js

@@ -0,0 +1,65 @@
+import { EXRLoader } from '../../node_modules/.pnpm/super-three@0.177.0/node_modules/super-three/examples/jsm/loaders/EXRLoader.js';
+import { RGBELoader } from '../../node_modules/.pnpm/super-three@0.177.0/node_modules/super-three/examples/jsm/loaders/RGBELoader.js';
+import '../../runtime/three.js';
+import { CacheManager } from '../cache-manager.js';
+import { EquirectangularReflectionMapping } 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.
+ */
+/** HDR equirectangular texture loader with de-duplication and caching.
+ * @category Assets
+ */
+class HDRTextureAssetLoader {
+    static init(loadingManager) {
+        this.rgbeLoader = new RGBELoader(loadingManager);
+        this.exrLoader = new EXRLoader(loadingManager);
+    }
+    /** Load an HDR `.hdr`/`.exr` texture by URL, returning a cached instance when possible. */
+    static async loadHDRTexture(url) {
+        // Normalize extension
+        const u = url.toLowerCase();
+        const isEXR = u.endsWith('.exr');
+        const isHDR = u.endsWith('.hdr');
+        if (!isEXR && !isHDR) {
+            // Fall back to standard texture loader if the extension is not HDR/EXR
+            // but keep API compatibility for callers that route through here.
+            return Promise.reject(new Error(`Unsupported HDR texture extension in url: ${url}`));
+        }
+        if (CacheManager.hasPromise(url)) {
+            return CacheManager.getPromise(url);
+        }
+        const loadingPromise = new Promise((resolve, reject) => {
+            if (CacheManager.hasAsset(url)) {
+                resolve(CacheManager.getAsset(url));
+                CacheManager.deletePromise(url);
+                return;
+            }
+            const onLoad = (texture) => {
+                // Ensure world-locked mapping for equirectangular HDR/EXR
+                texture.mapping = EquirectangularReflectionMapping;
+                CacheManager.setAsset(url, texture);
+                resolve(texture);
+                CacheManager.deletePromise(url);
+            };
+            const onError = (error) => {
+                reject(error);
+                CacheManager.deletePromise(url);
+            };
+            if (isEXR) {
+                this.exrLoader.load(url, onLoad, undefined, onError);
+            }
+            else {
+                this.rgbeLoader.load(url, onLoad, undefined, onError);
+            }
+        });
+        CacheManager.setPromise(url, loadingPromise);
+        return loadingPromise;
+    }
+}
+
+export { HDRTextureAssetLoader };
+//# sourceMappingURL=hdr-texture-loader.js.map

package/dist/asset/loaders/hdr-texture-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdr-texture-loader.js","sources":["../../../src/asset/loaders/hdr-texture-loader.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;AAAA;;;;;AAKG;AAWH;;AAEG;MACU,qBAAqB,CAAA;IAIhC,OAAO,IAAI,CAAC,cAA8B,EAAA;QACxC,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,cAAc,CAAC;QAChD,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,CAAC,cAAc,CAAC;IAChD;;AAGA,IAAA,aAAa,cAAc,CAAC,GAAW,EAAA;;AAErC,QAAA,MAAM,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE;QAC3B,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChC,MAAM,KAAK,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC;AAEhC,QAAA,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,EAAE;;;AAGpB,YAAA,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,KAAK,CAAC,CAAA,0CAAA,EAA6C,GAAG,CAAA,CAAE,CAAC,CAC9D;QACH;AAEA,QAAA,IAAI,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE;AAChC,YAAA,OAAO,YAAY,CAAC,UAAU,CAAU,GAAG,CAAE;QAC/C;QAEA,MAAM,cAAc,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,KAAI;AAC9D,YAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBAC9B,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAU,GAAG,CAAE,CAAC;AAC7C,gBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;gBAC/B;YACF;AAEA,YAAA,MAAM,MAAM,GAAG,CAAC,OAAgB,KAAI;;AAElC,gBAAA,OAAO,CAAC,OAAO,GAAG,gCAAgC;AAClD,gBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;gBACnC,OAAO,CAAC,OAAO,CAAC;AAChB,gBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;AACjC,YAAA,CAAC;AAED,YAAA,MAAM,OAAO,GAAG,CAAC,KAAc,KAAI;gBACjC,MAAM,CAAC,KAAc,CAAC;AACtB,gBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;AACjC,YAAA,CAAC;YAED,IAAI,KAAK,EAAE;AACT,gBAAA,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;YACtD;iBAAO;AACL,gBAAA,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC;YACvD;AACF,QAAA,CAAC,CAAC;AAEF,QAAA,YAAY,CAAC,UAAU,CAAC,GAAG,EAAE,cAAc,CAAC;AAC5C,QAAA,OAAO,cAAc;IACvB;AACD;;;;"}

package/dist/asset/loaders/texture-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, Texture } from '../../runtime/index.js';
+/**
+ * Texture loader with de-duplication and caching.
+ *
+ * @category Assets
+ */
+export declare class TextureAssetLoader {
+    private static textureLoader;
+    static init(loadingManager: LoadingManager): void;
+    /** Load a texture (URL or logical key), returning a cached instance when possible. */
+    static loadTexture(urlOrKey: string): Promise<Texture>;
+    /** Get a cached texture by logical key. */
+    static getTexture(key: string): Texture | null;
+}
+//# sourceMappingURL=texture-loader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"texture-loader.d.ts","sourceRoot":"","sources":["../../../src/asset/loaders/texture-loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAiB,MAAM,wBAAwB,CAAC;AAGhF;;;;GAIG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,aAAa,CAAgB;IAE5C,MAAM,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI;IAIjD,sFAAsF;WACzE,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAoC5D,2CAA2C;IAC3C,MAAM,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI;CAG/C"}

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

@@ -0,0 +1,57 @@
+import '../../runtime/three.js';
+import { CacheManager } from '../cache-manager.js';
+import { TextureLoader } 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.
+ */
+/**
+ * Texture loader with de-duplication and caching.
+ *
+ * @category Assets
+ */
+class TextureAssetLoader {
+    static init(loadingManager) {
+        this.textureLoader = new TextureLoader(loadingManager);
+    }
+    /** Load a texture (URL or logical key), returning a cached instance when possible. */
+    static async loadTexture(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 TextureLoader
+                this.textureLoader.load(url, (texture) => {
+                    CacheManager.setAsset(url, texture);
+                    resolve(texture);
+                    CacheManager.deletePromise(url);
+                }, undefined, // progress callback
+                (error) => {
+                    reject(error);
+                    CacheManager.deletePromise(url);
+                });
+            }
+        });
+        CacheManager.setPromise(url, loadingPromise);
+        return loadingPromise;
+    }
+    /** Get a cached texture by logical key. */
+    static getTexture(key) {
+        return CacheManager.getAssetByKey(key) || null;
+    }
+}
+
+export { TextureAssetLoader };
+//# sourceMappingURL=texture-loader.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"texture-loader.js","sources":["../../../src/asset/loaders/texture-loader.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;;;;;AAKG;AAKH;;;;AAIG;MACU,kBAAkB,CAAA;IAG7B,OAAO,IAAI,CAAC,cAA8B,EAAA;QACxC,IAAI,CAAC,aAAa,GAAG,IAAI,aAAa,CAAC,cAAc,CAAC;IACxD;;AAGA,IAAA,aAAa,WAAW,CAAC,QAAgB,EAAA;;QAEvC,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,CAAU,GAAG,CAAE;QAC/C;QAEA,MAAM,cAAc,GAAG,IAAI,OAAO,CAAU,CAAC,OAAO,EAAE,MAAM,KAAI;;AAE9D,YAAA,IAAI,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE;gBAC9B,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAU,GAAG,CAAE,CAAC;AAC7C,gBAAA,YAAY,CAAC,aAAa,CAAC,GAAG,CAAC;YACjC;iBAAO;;gBAEL,IAAI,CAAC,aAAa,CAAC,IAAI,CACrB,GAAG,EACH,CAAC,OAAO,KAAI;AACV,oBAAA,YAAY,CAAC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;oBACnC,OAAO,CAAC,OAAO,CAAC;AAChB,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,UAAU,CAAC,GAAW,EAAA;QAC3B,OAAQ,YAAY,CAAC,aAAa,CAAC,GAAG,CAAa,IAAI,IAAI;IAC7D;AACD;;;;"}

package/dist/audio/audio-pool.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 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 { Audio as AmbientAudio, AudioListener, Object3D, PositionalAudio } from '../runtime/index.js';
+/**
+ * Runtime bookkeeping for a playing audio instance used by {@link AudioSystem}.
+ * @category Audio
+ */
+export interface AudioInstance<T extends AmbientAudio | PositionalAudio> {
+    audio: T;
+    startTime: number;
+    fadeStartTime?: number;
+    fadeStartVolume?: number;
+    fadeDuration?: number;
+    isFadingOut?: boolean;
+    isFadingIn?: boolean;
+    pausedBySessionEnd?: boolean;
+}
+/**
+ * Fixed-size pool of Three.js `Audio`/`PositionalAudio` objects.
+ *
+ * @remarks
+ * - Pre-allocates a number of audio nodes under a hidden `Group` attached to the parent.
+ * - Minimizes GC churn by reusing nodes across playbacks.
+ * - Used internally by {@link AudioSystem}, but exposed for advanced scenarios.
+ *
+ * @category Audio
+ */
+export declare class AudioPool<T extends AmbientAudio | PositionalAudio> {
+    private container;
+    private available;
+    private allInstances;
+    /**
+     * Create a pool.
+     * @param listener AudioListener to attach to each instance.
+     * @param size Number of instances to pre‑allocate.
+     * @param positional When true, creates `PositionalAudio`; otherwise ambient `Audio`.
+     * @param parent Group/Object3D to attach internal container to.
+     */
+    constructor(listener: AudioListener, size: number, positional: boolean, parent: Object3D);
+    /** Acquire an available audio node or `null` if exhausted. */
+    acquire(): T | null;
+    /** Stop, reset volume, and return an audio node to the pool. */
+    release(audio: T): void;
+    /** Stop and return all nodes to the available pool. */
+    releaseAll(): void;
+    /** Disconnect and dispose all nodes and the container. */
+    dispose(): void;
+    /** Number of nodes currently checked out. */
+    getActiveCount(): number;
+    /** Total nodes in the pool. */
+    getTotalCount(): number;
+    /** Return all nodes (checked out and available). */
+    getAllInstances(): T[];
+}
+//# sourceMappingURL=audio-pool.d.ts.map

package/dist/audio/audio-pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-pool.d.ts","sourceRoot":"","sources":["../../src/audio/audio-pool.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,KAAK,IAAI,YAAY,EACrB,aAAa,EAEb,QAAQ,EACR,eAAe,EAChB,MAAM,qBAAqB,CAAC;AAE7B;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,SAAS,YAAY,GAAG,eAAe;IACrE,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;;;;;;;;GASG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,YAAY,GAAG,eAAe;IAC7D,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,SAAS,CAAW;IAC5B,OAAO,CAAC,YAAY,CAAW;IAE/B;;;;;;OAMG;gBAED,QAAQ,EAAE,aAAa,EACvB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,OAAO,EACnB,MAAM,EAAE,QAAQ;IAiBlB,8DAA8D;IAC9D,OAAO,IAAI,CAAC,GAAG,IAAI;IASnB,gEAAgE;IAChE,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI;IAevB,uDAAuD;IACvD,UAAU,IAAI,IAAI;IAYlB,0DAA0D;IAC1D,OAAO,IAAI,IAAI;IAiBf,6CAA6C;IAC7C,cAAc,IAAI,MAAM;IAIxB,+BAA+B;IAC/B,aAAa,IAAI,MAAM;IAIvB,oDAAoD;IACpD,eAAe,IAAI,CAAC,EAAE;CAGvB"}

package/dist/audio/audio-pool.js

@@ -0,0 +1,105 @@
+import '../runtime/three.js';
+import { Group, PositionalAudio, Audio } 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.
+ */
+/**
+ * Fixed-size pool of Three.js `Audio`/`PositionalAudio` objects.
+ *
+ * @remarks
+ * - Pre-allocates a number of audio nodes under a hidden `Group` attached to the parent.
+ * - Minimizes GC churn by reusing nodes across playbacks.
+ * - Used internally by {@link AudioSystem}, but exposed for advanced scenarios.
+ *
+ * @category Audio
+ */
+class AudioPool {
+    /**
+     * Create a pool.
+     * @param listener AudioListener to attach to each instance.
+     * @param size Number of instances to pre‑allocate.
+     * @param positional When true, creates `PositionalAudio`; otherwise ambient `Audio`.
+     * @param parent Group/Object3D to attach internal container to.
+     */
+    constructor(listener, size, positional, parent) {
+        this.available = [];
+        this.allInstances = [];
+        this.container = new Group();
+        parent.add(this.container);
+        // Pre-create audio instances
+        for (let i = 0; i < size; i++) {
+            const audio = positional
+                ? new PositionalAudio(listener)
+                : new Audio(listener);
+            this.container.add(audio);
+            this.available.push(audio);
+            this.allInstances.push(audio);
+        }
+    }
+    /** Acquire an available audio node or `null` if exhausted. */
+    acquire() {
+        if (this.available.length === 0) {
+            return null;
+        }
+        const audio = this.available.pop();
+        return audio;
+    }
+    /** Stop, reset volume, and return an audio node to the pool. */
+    release(audio) {
+        // Stop the audio if it's still playing
+        if (audio.isPlaying) {
+            audio.stop();
+        }
+        // Reset audio state
+        audio.setVolume(1.0);
+        // Return to available pool
+        if (!this.available.includes(audio)) {
+            this.available.push(audio);
+        }
+    }
+    /** Stop and return all nodes to the available pool. */
+    releaseAll() {
+        // Stop all instances and return them to the pool
+        for (const audio of this.allInstances) {
+            if (audio.isPlaying) {
+                audio.stop();
+            }
+            audio.setVolume(1.0);
+        }
+        this.available = [...this.allInstances];
+    }
+    /** Disconnect and dispose all nodes and the container. */
+    dispose() {
+        // Clean up all audio instances
+        for (const audio of this.allInstances) {
+            if (audio.isPlaying) {
+                audio.stop();
+            }
+            audio.disconnect();
+        }
+        // Remove from parent
+        this.container.removeFromParent();
+        this.container.clear();
+        this.available = [];
+        this.allInstances = [];
+    }
+    /** Number of nodes currently checked out. */
+    getActiveCount() {
+        return this.allInstances.length - this.available.length;
+    }
+    /** Total nodes in the pool. */
+    getTotalCount() {
+        return this.allInstances.length;
+    }
+    /** Return all nodes (checked out and available). */
+    getAllInstances() {
+        return this.allInstances;
+    }
+}
+
+export { AudioPool };
+//# sourceMappingURL=audio-pool.js.map

package/dist/audio/audio-pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-pool.js","sources":["../../src/audio/audio-pool.ts"],"sourcesContent":[null],"names":["AmbientAudio"],"mappings":";;;AAAA;;;;;AAKG;AAyBH;;;;;;;;;AASG;MACU,SAAS,CAAA;AAKpB;;;;;;AAMG;AACH,IAAA,WAAA,CACE,QAAuB,EACvB,IAAY,EACZ,UAAmB,EACnB,MAAgB,EAAA;QAdV,IAAA,CAAA,SAAS,GAAQ,EAAE;QACnB,IAAA,CAAA,YAAY,GAAQ,EAAE;AAe5B,QAAA,IAAI,CAAC,SAAS,GAAG,IAAI,KAAK,EAAE;AAC5B,QAAA,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC;;AAG1B,QAAA,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG;AACZ,kBAAE,IAAI,eAAe,CAAC,QAAQ;AAC9B,kBAAE,IAAIA,KAAY,CAAC,QAAQ,CAAC;AAE9B,YAAA,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;AACzB,YAAA,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAU,CAAC;AAC/B,YAAA,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,KAAU,CAAC;QACpC;IACF;;IAGA,OAAO,GAAA;QACL,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE;AAC/B,YAAA,OAAO,IAAI;QACb;QAEA,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAG;AACnC,QAAA,OAAO,KAAK;IACd;;AAGA,IAAA,OAAO,CAAC,KAAQ,EAAA;;AAEd,QAAA,IAAI,KAAK,CAAC,SAAS,EAAE;YACnB,KAAK,CAAC,IAAI,EAAE;QACd;;AAGA,QAAA,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;;QAGpB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;AACnC,YAAA,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAC5B;IACF;;IAGA,UAAU,GAAA;;AAER,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE;AACrC,YAAA,IAAI,KAAK,CAAC,SAAS,EAAE;gBACnB,KAAK,CAAC,IAAI,EAAE;YACd;AACA,YAAA,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC;QACtB;QAEA,IAAI,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC;IACzC;;IAGA,OAAO,GAAA;;AAEL,QAAA,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,YAAY,EAAE;AACrC,YAAA,IAAI,KAAK,CAAC,SAAS,EAAE;gBACnB,KAAK,CAAC,IAAI,EAAE;YACd;YACA,KAAK,CAAC,UAAU,EAAE;QACpB;;AAGA,QAAA,IAAI,CAAC,SAAS,CAAC,gBAAgB,EAAE;AACjC,QAAA,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE;AAEtB,QAAA,IAAI,CAAC,SAAS,GAAG,EAAE;AACnB,QAAA,IAAI,CAAC,YAAY,GAAG,EAAE;IACxB;;IAGA,cAAc,GAAA;QACZ,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM;IACzD;;IAGA,aAAa,GAAA;AACX,QAAA,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM;IACjC;;IAGA,eAAe,GAAA;QACb,OAAO,IAAI,CAAC,YAAY;IAC1B;AACD;;;;"}

package/dist/audio/audio-system.d.ts

@@ -0,0 +1,326 @@
+/**
+ * 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 { Types } from '../ecs/index.js';
+declare const AudioSystem_base: import("elics").SystemConstructor<{
+    /** Enable distance-based culling for positional audio instances. */
+    enableDistanceCulling: {
+        type: Types.Boolean;
+        default: true;
+    };
+    /** Multiplier applied to `maxDistance` for culling threshold. */
+    cullingDistanceMultiplier: {
+        type: Types.Float32;
+        default: number;
+    };
+}, {
+    audioEntities: {
+        required: import("elics").Component<{
+            src: {
+                type: Types.String;
+                default: string;
+            };
+            volume: {
+                type: Types.Float32;
+                default: number;
+            };
+            loop: {
+                type: Types.Boolean;
+                default: false;
+            };
+            autoplay: {
+                type: Types.Boolean;
+                default: false;
+            };
+            positional: {
+                type: Types.Boolean;
+                default: true;
+            };
+            refDistance: {
+                type: Types.Float32;
+                default: number;
+            };
+            rolloffFactor: {
+                type: Types.Float32;
+                default: number;
+            };
+            maxDistance: {
+                type: Types.Float32;
+                default: number;
+            };
+            distanceModel: {
+                type: Types.Enum;
+                enum: {
+                    readonly Linear: "linear";
+                    readonly Inverse: "inverse";
+                    readonly Exponential: "exponential";
+                };
+                default: "inverse";
+            };
+            coneInnerAngle: {
+                type: Types.Float32;
+                default: number;
+            };
+            coneOuterAngle: {
+                type: Types.Float32;
+                default: number;
+            };
+            coneOuterGain: {
+                type: Types.Float32;
+                default: number;
+            };
+            playbackMode: {
+                type: Types.Enum;
+                enum: {
+                    readonly Restart: "restart";
+                    readonly Overlap: "overlap";
+                    readonly Ignore: "ignore";
+                    readonly FadeRestart: "fade-restart";
+                };
+                default: "restart";
+            };
+            maxInstances: {
+                type: Types.Int8;
+                default: number;
+            };
+            crossfadeDuration: {
+                type: Types.Float32;
+                default: number;
+            };
+            instanceStealPolicy: {
+                type: Types.Enum;
+                enum: {
+                    readonly Oldest: "oldest";
+                    readonly Quietest: "quietest";
+                    readonly Furthest: "furthest";
+                };
+                default: "oldest";
+            };
+            _playRequested: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _pauseRequested: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _stopRequested: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _fadeIn: {
+                type: Types.Float32;
+                default: number;
+            };
+            _fadeOut: {
+                type: Types.Float32;
+                default: number;
+            };
+            _pool: {
+                type: Types.Object;
+                default: undefined;
+            };
+            _instances: {
+                type: Types.Object;
+                default: undefined;
+            };
+            _isPlaying: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _buffer: {
+                type: Types.Object;
+                default: undefined;
+            };
+            _loaded: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _loading: {
+                type: Types.Boolean;
+                default: false;
+            };
+        }>[];
+    };
+}, import("../ecs/world.js").World, import("../ecs/system.js").System<{
+    /** Enable distance-based culling for positional audio instances. */
+    enableDistanceCulling: {
+        type: Types.Boolean;
+        default: true;
+    };
+    /** Multiplier applied to `maxDistance` for culling threshold. */
+    cullingDistanceMultiplier: {
+        type: Types.Float32;
+        default: number;
+    };
+}, {
+    audioEntities: {
+        required: import("elics").Component<{
+            src: {
+                type: Types.String;
+                default: string;
+            };
+            volume: {
+                type: Types.Float32;
+                default: number;
+            };
+            loop: {
+                type: Types.Boolean;
+                default: false;
+            };
+            autoplay: {
+                type: Types.Boolean;
+                default: false;
+            };
+            positional: {
+                type: Types.Boolean;
+                default: true;
+            };
+            refDistance: {
+                type: Types.Float32;
+                default: number;
+            };
+            rolloffFactor: {
+                type: Types.Float32;
+                default: number;
+            };
+            maxDistance: {
+                type: Types.Float32;
+                default: number;
+            };
+            distanceModel: {
+                type: Types.Enum;
+                enum: {
+                    readonly Linear: "linear";
+                    readonly Inverse: "inverse";
+                    readonly Exponential: "exponential";
+                };
+                default: "inverse";
+            };
+            coneInnerAngle: {
+                type: Types.Float32;
+                default: number;
+            };
+            coneOuterAngle: {
+                type: Types.Float32;
+                default: number;
+            };
+            coneOuterGain: {
+                type: Types.Float32;
+                default: number;
+            };
+            playbackMode: {
+                type: Types.Enum;
+                enum: {
+                    readonly Restart: "restart";
+                    readonly Overlap: "overlap";
+                    readonly Ignore: "ignore";
+                    readonly FadeRestart: "fade-restart";
+                };
+                default: "restart";
+            };
+            maxInstances: {
+                type: Types.Int8;
+                default: number;
+            };
+            crossfadeDuration: {
+                type: Types.Float32;
+                default: number;
+            };
+            instanceStealPolicy: {
+                type: Types.Enum;
+                enum: {
+                    readonly Oldest: "oldest";
+                    readonly Quietest: "quietest";
+                    readonly Furthest: "furthest";
+                };
+                default: "oldest";
+            };
+            _playRequested: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _pauseRequested: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _stopRequested: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _fadeIn: {
+                type: Types.Float32;
+                default: number;
+            };
+            _fadeOut: {
+                type: Types.Float32;
+                default: number;
+            };
+            _pool: {
+                type: Types.Object;
+                default: undefined;
+            };
+            _instances: {
+                type: Types.Object;
+                default: undefined;
+            };
+            _isPlaying: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _buffer: {
+                type: Types.Object;
+                default: undefined;
+            };
+            _loaded: {
+                type: Types.Boolean;
+                default: false;
+            };
+            _loading: {
+                type: Types.Boolean;
+                default: false;
+            };
+        }>[];
+    };
+}>>;
+/**
+ * Runtime audio manager that loads sources, pools players, and applies XR-aware behavior.
+ *
+ * @remarks
+ * - Creates an `AudioListener` on the player head and resumes/suspends the
+ *   audio context when XR sessions start/end.
+ * - Pools `Audio`/`PositionalAudio` instances per entity to minimize allocations
+ *   and implements play/overlap/fade-restart behaviors.
+ * - Optionally culls distant positional audio by a distance multiplier.
+ *
+ * @category Audio
+ */
+export declare class AudioSystem extends AudioSystem_base {
+    private listener;
+    private activeInstances;
+    init(): void;
+    private onXRSessionStart;
+    private onXRSessionEnd;
+    update(_delta: number, _time: number): void;
+    private loadAudio;
+    private createPool;
+    private handlePlaybackRequests;
+    private playRestart;
+    private playOverlap;
+    private playIgnore;
+    private playFadeRestart;
+    private createAndPlayInstance;
+    private updateActiveInstances;
+    private onInstanceEnded;
+    private releaseInstance;
+    private stopAllInstances;
+    private pauseAllInstances;
+    private stealInstance;
+    private cleanupEntity;
+    destroy(): void;
+}
+export {};
+//# sourceMappingURL=audio-system.d.ts.map

package/dist/audio/audio-system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio-system.d.ts","sourceRoot":"","sources":["../../src/audio/audio-system.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,KAAK,EAAwB,MAAM,iBAAiB,CAAC;;IAqB1D,oEAAoE;;;;;IAEpE,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAFjE,oEAAoE;;;;;IAEpE,iEAAiE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAnBrE;;;;;;;;;;;GAWG;AACH,qBAAa,WAAY,SAAQ,gBAUhC;IACC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,eAAe,CAGT;IAEd,IAAI,IAAI,IAAI;IAeZ,OAAO,CAAC,gBAAgB,CAgBtB;IAEF,OAAO,CAAC,cAAc,CAgBpB;IAEF,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;YAqD7B,SAAS;IAwBvB,OAAO,CAAC,UAAU;IAqClB,OAAO,CAAC,sBAAsB;IA+C9B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,WAAW;IAenB,OAAO,CAAC,UAAU;IASlB,OAAO,CAAC,eAAe;IAiBvB,OAAO,CAAC,qBAAqB;IAmE7B,OAAO,CAAC,qBAAqB;IA4E7B,OAAO,CAAC,eAAe;IAevB,OAAO,CAAC,eAAe;IAuBvB,OAAO,CAAC,gBAAgB;IAmBxB,OAAO,CAAC,iBAAiB;IAwBzB,OAAO,CAAC,aAAa;IA+CrB,OAAO,CAAC,aAAa;IAyBrB,OAAO,IAAI,IAAI;CAUhB"}