@babylonjs/core 7.51.3 → 7.52.1

package/AudioV2/abstractAudio/staticSoundInstance.d.ts

@@ -0,0 +1,15 @@
+import type { IAbstractSoundInstanceOptions } from "./abstractSoundInstance";
+import { _AbstractSoundInstance } from "./abstractSoundInstance";
+import type { IStaticSoundOptionsBase, IStaticSoundPlayOptions, IStaticSoundStopOptions } from "./staticSound";
+/**
+ * Options for creating a static sound instance.
+ * @internal
+ */
+export interface IStaticSoundInstanceOptions extends IAbstractSoundInstanceOptions, IStaticSoundOptionsBase {
+}
+/** @internal */
+export declare abstract class _StaticSoundInstance extends _AbstractSoundInstance {
+    protected abstract readonly _options: IStaticSoundInstanceOptions;
+    abstract play(options: Partial<IStaticSoundPlayOptions>): void;
+    abstract stop(options?: Partial<IStaticSoundStopOptions>): void;
+}

package/AudioV2/abstractAudio/staticSoundInstance.js

@@ -0,0 +1,5 @@
+import { _AbstractSoundInstance } from "./abstractSoundInstance.js";
+/** @internal */
+export class _StaticSoundInstance extends _AbstractSoundInstance {
+}
+//# sourceMappingURL=staticSoundInstance.js.map

package/AudioV2/abstractAudio/staticSoundInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticSoundInstance.js","sourceRoot":"","sources":["../../../../../dev/core/src/AudioV2/abstractAudio/staticSoundInstance.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AASjE,gBAAgB;AAChB,MAAM,OAAgB,oBAAqB,SAAQ,sBAAsB;CAKxE","sourcesContent":["import type { IAbstractSoundInstanceOptions } from \"./abstractSoundInstance\";\nimport { _AbstractSoundInstance } from \"./abstractSoundInstance\";\nimport type { IStaticSoundOptionsBase, IStaticSoundPlayOptions, IStaticSoundStopOptions } from \"./staticSound\";\n\n/**\n * Options for creating a static sound instance.\n * @internal\n */\nexport interface IStaticSoundInstanceOptions extends IAbstractSoundInstanceOptions, IStaticSoundOptionsBase {}\n\n/** @internal */\nexport abstract class _StaticSoundInstance extends _AbstractSoundInstance {\n    protected abstract override readonly _options: IStaticSoundInstanceOptions;\n\n    public abstract override play(options: Partial<IStaticSoundPlayOptions>): void;\n    public abstract override stop(options?: Partial<IStaticSoundStopOptions>): void;\n}\n"]}

package/AudioV2/abstractAudio/streamingSound.d.ts

@@ -0,0 +1,77 @@
+import type { IAbstractSoundOptions, IAbstractSoundPlayOptions, IAbstractSoundStoredOptions } from "./abstractSound";
+import { AbstractSound } from "./abstractSound";
+import type { AudioEngineV2 } from "./audioEngineV2";
+import type { _StreamingSoundInstance } from "./streamingSoundInstance";
+/** @internal */
+export interface IStreamingSoundOptionsBase {
+    /**
+     * The number of instances to preload. Defaults to 1.
+     * */
+    preloadCount: number;
+}
+/**
+ * Options for creating a streaming sound.
+ */
+export interface IStreamingSoundOptions extends IAbstractSoundOptions, IStreamingSoundOptionsBase {
+}
+/**
+ * Options for playing a streaming sound.
+ */
+export interface IStreamingSoundPlayOptions extends IAbstractSoundPlayOptions {
+}
+/**
+ * Options stored in a streaming sound.
+ * @internal
+ */
+export interface IStreamingSoundStoredOptions extends IAbstractSoundStoredOptions, IStreamingSoundOptionsBase {
+}
+/**
+ * Abstract class representing a streaming sound.
+ *
+ * A streaming sound has a sound buffer that is loaded into memory in chunks as it is played. This allows it to be played
+ * more quickly than a static sound, but it also means that it cannot have loop points or playback rate changes.
+ *
+ * Due to the way streaming sounds are typically implemented, there can be a significant delay when attempting to play
+ * a streaming sound for the first time. To prevent this delay, it is recommended to preload instances of the sound
+ * using the {@link IStreamingSoundStoredOptions.preloadCount} options, or the {@link preloadInstance} and
+ * {@link preloadInstances} methods before calling the `play` method.
+ *
+ * Streaming sounds are created by the {@link CreateStreamingSoundAsync} function.
+ */
+export declare abstract class StreamingSound extends AbstractSound {
+    private _preloadedInstances;
+    protected abstract readonly _options: IStreamingSoundStoredOptions;
+    protected constructor(name: string, engine: AudioEngineV2, options: Partial<IStreamingSoundOptions>);
+    /**
+     * The number of instances to preload.
+     */
+    get preloadCount(): number;
+    /**
+     * Returns the number of instances that have been preloaded.
+     */
+    get preloadCompletedCount(): number;
+    /**
+     * Preloads an instance of the sound.
+     * @returns A promise that resolves when the instance is preloaded.
+     */
+    preloadInstance(): Promise<void>;
+    /**
+     * Preloads the given number of instances of the sound.
+     * @param count - The number of instances to preload.
+     * @returns A promise that resolves when all instances are preloaded.
+     */
+    preloadInstances(count: number): Promise<void>;
+    /**
+     * Plays the sound.
+     * - Triggers `onEndedObservable` if played for the full duration and the `loop` option is not set.
+     * @param options The options to use when playing the sound. Options set here override the sound's options.
+     */
+    play(options?: Partial<IStreamingSoundPlayOptions>): void;
+    /**
+     * Stops the sound.
+     */
+    stop(): void;
+    protected abstract _createInstance(): _StreamingSoundInstance;
+    private _addPreloadedInstance;
+    private _removePreloadedInstance;
+}

package/AudioV2/abstractAudio/streamingSound.js

@@ -0,0 +1,109 @@
+import { AbstractSound } from "./abstractSound.js";
+/**
+ * Abstract class representing a streaming sound.
+ *
+ * A streaming sound has a sound buffer that is loaded into memory in chunks as it is played. This allows it to be played
+ * more quickly than a static sound, but it also means that it cannot have loop points or playback rate changes.
+ *
+ * Due to the way streaming sounds are typically implemented, there can be a significant delay when attempting to play
+ * a streaming sound for the first time. To prevent this delay, it is recommended to preload instances of the sound
+ * using the {@link IStreamingSoundStoredOptions.preloadCount} options, or the {@link preloadInstance} and
+ * {@link preloadInstances} methods before calling the `play` method.
+ *
+ * Streaming sounds are created by the {@link CreateStreamingSoundAsync} function.
+ */
+export class StreamingSound extends AbstractSound {
+    constructor(name, engine, options) {
+        super(name, engine, options);
+        this._preloadedInstances = new Array();
+    }
+    /**
+     * The number of instances to preload.
+     */
+    get preloadCount() {
+        return this._options.preloadCount ?? 1;
+    }
+    /**
+     * Returns the number of instances that have been preloaded.
+     */
+    get preloadCompletedCount() {
+        return this._preloadedInstances.length;
+    }
+    /**
+     * Preloads an instance of the sound.
+     * @returns A promise that resolves when the instance is preloaded.
+     */
+    preloadInstance() {
+        const instance = this._createInstance();
+        this._addPreloadedInstance(instance);
+        return instance.preloadedPromise;
+    }
+    /**
+     * Preloads the given number of instances of the sound.
+     * @param count - The number of instances to preload.
+     * @returns A promise that resolves when all instances are preloaded.
+     */
+    async preloadInstances(count) {
+        for (let i = 0; i < count; i++) {
+            this.preloadInstance();
+        }
+        await Promise.all(this._preloadedInstances.map((instance) => instance.preloadedPromise));
+    }
+    /**
+     * Plays the sound.
+     * - Triggers `onEndedObservable` if played for the full duration and the `loop` option is not set.
+     * @param options The options to use when playing the sound. Options set here override the sound's options.
+     */
+    play(options = {}) {
+        if (this.state === 5 /* SoundState.Paused */) {
+            this.resume();
+            return;
+        }
+        let instance;
+        if (this.preloadCompletedCount > 0) {
+            instance = this._preloadedInstances[0];
+            instance.startOffset = this.startOffset;
+            this._removePreloadedInstance(instance);
+        }
+        else {
+            instance = this._createInstance();
+        }
+        const onInstanceStateChanged = () => {
+            if (instance.state === 3 /* SoundState.Started */) {
+                this._stopExcessInstances();
+                instance.onStateChangedObservable.removeCallback(onInstanceStateChanged);
+            }
+        };
+        instance.onStateChangedObservable.add(onInstanceStateChanged);
+        options.startOffset ?? (options.startOffset = this.startOffset);
+        options.loop ?? (options.loop = this.loop);
+        options.volume ?? (options.volume = 1);
+        this._beforePlay(instance);
+        instance.play(options);
+        this._afterPlay(instance);
+    }
+    /**
+     * Stops the sound.
+     */
+    stop() {
+        this._setState(1 /* SoundState.Stopped */);
+        if (!this._instances) {
+            return;
+        }
+        for (const instance of Array.from(this._instances)) {
+            instance.stop();
+        }
+    }
+    _addPreloadedInstance(instance) {
+        if (!this._preloadedInstances.includes(instance)) {
+            this._preloadedInstances.push(instance);
+        }
+    }
+    _removePreloadedInstance(instance) {
+        const index = this._preloadedInstances.indexOf(instance);
+        if (index !== -1) {
+            this._preloadedInstances.splice(index, 1);
+        }
+    }
+}
+//# sourceMappingURL=streamingSound.js.map

package/AudioV2/abstractAudio/streamingSound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingSound.js","sourceRoot":"","sources":["../../../../../dev/core/src/AudioV2/abstractAudio/streamingSound.ts"],"names":[],"mappings":"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","sourcesContent":["import { SoundState } from \"../soundState\";\nimport type { IAbstractSoundOptions, IAbstractSoundPlayOptions, IAbstractSoundStoredOptions } from \"./abstractSound\";\nimport { AbstractSound } from \"./abstractSound\";\nimport type { AudioEngineV2 } from \"./audioEngineV2\";\nimport type { _StreamingSoundInstance } from \"./streamingSoundInstance\";\n\n/** @internal */\nexport interface IStreamingSoundOptionsBase {\n    /**\n     * The number of instances to preload. Defaults to 1.\n     * */\n    preloadCount: number;\n}\n\n/**\n * Options for creating a streaming sound.\n */\nexport interface IStreamingSoundOptions extends IAbstractSoundOptions, IStreamingSoundOptionsBase {}\n\n/**\n * Options for playing a streaming sound.\n */\nexport interface IStreamingSoundPlayOptions extends IAbstractSoundPlayOptions {}\n\n/**\n * Options stored in a streaming sound.\n * @internal\n */\nexport interface IStreamingSoundStoredOptions extends IAbstractSoundStoredOptions, IStreamingSoundOptionsBase {}\n\n/**\n * Abstract class representing a streaming sound.\n *\n * A streaming sound has a sound buffer that is loaded into memory in chunks as it is played. This allows it to be played\n * more quickly than a static sound, but it also means that it cannot have loop points or playback rate changes.\n *\n * Due to the way streaming sounds are typically implemented, there can be a significant delay when attempting to play\n * a streaming sound for the first time. To prevent this delay, it is recommended to preload instances of the sound\n * using the {@link IStreamingSoundStoredOptions.preloadCount} options, or the {@link preloadInstance} and\n * {@link preloadInstances} methods before calling the `play` method.\n *\n * Streaming sounds are created by the {@link CreateStreamingSoundAsync} function.\n */\nexport abstract class StreamingSound extends AbstractSound {\n    private _preloadedInstances = new Array<_StreamingSoundInstance>();\n\n    protected abstract override readonly _options: IStreamingSoundStoredOptions;\n\n    protected constructor(name: string, engine: AudioEngineV2, options: Partial<IStreamingSoundOptions>) {\n        super(name, engine, options);\n    }\n\n    /**\n     * The number of instances to preload.\n     */\n    public get preloadCount(): number {\n        return this._options.preloadCount ?? 1;\n    }\n\n    /**\n     * Returns the number of instances that have been preloaded.\n     */\n    public get preloadCompletedCount(): number {\n        return this._preloadedInstances.length;\n    }\n\n    /**\n     * Preloads an instance of the sound.\n     * @returns A promise that resolves when the instance is preloaded.\n     */\n    public preloadInstance(): Promise<void> {\n        const instance = this._createInstance();\n\n        this._addPreloadedInstance(instance);\n\n        return instance.preloadedPromise;\n    }\n\n    /**\n     * Preloads the given number of instances of the sound.\n     * @param count - The number of instances to preload.\n     * @returns A promise that resolves when all instances are preloaded.\n     */\n    public async preloadInstances(count: number): Promise<void> {\n        for (let i = 0; i < count; i++) {\n            this.preloadInstance();\n        }\n\n        await Promise.all(this._preloadedInstances.map((instance) => instance.preloadedPromise));\n    }\n\n    /**\n     * Plays the sound.\n     * - Triggers `onEndedObservable` if played for the full duration and the `loop` option is not set.\n     * @param options The options to use when playing the sound. Options set here override the sound's options.\n     */\n    public play(options: Partial<IStreamingSoundPlayOptions> = {}): void {\n        if (this.state === SoundState.Paused) {\n            this.resume();\n            return;\n        }\n\n        let instance: _StreamingSoundInstance;\n\n        if (this.preloadCompletedCount > 0) {\n            instance = this._preloadedInstances[0];\n            instance.startOffset = this.startOffset;\n            this._removePreloadedInstance(instance);\n        } else {\n            instance = this._createInstance();\n        }\n\n        const onInstanceStateChanged = () => {\n            if (instance.state === SoundState.Started) {\n                this._stopExcessInstances();\n                instance.onStateChangedObservable.removeCallback(onInstanceStateChanged);\n            }\n        };\n        instance.onStateChangedObservable.add(onInstanceStateChanged);\n\n        options.startOffset ??= this.startOffset;\n        options.loop ??= this.loop;\n        options.volume ??= 1;\n\n        this._beforePlay(instance);\n        instance.play(options);\n        this._afterPlay(instance);\n    }\n\n    /**\n     * Stops the sound.\n     */\n    public stop(): void {\n        this._setState(SoundState.Stopped);\n\n        if (!this._instances) {\n            return;\n        }\n\n        for (const instance of Array.from(this._instances)) {\n            instance.stop();\n        }\n    }\n\n    protected abstract override _createInstance(): _StreamingSoundInstance;\n\n    private _addPreloadedInstance(instance: _StreamingSoundInstance): void {\n        if (!this._preloadedInstances.includes(instance)) {\n            this._preloadedInstances.push(instance);\n        }\n    }\n\n    private _removePreloadedInstance(instance: _StreamingSoundInstance): void {\n        const index = this._preloadedInstances.indexOf(instance);\n        if (index !== -1) {\n            this._preloadedInstances.splice(index, 1);\n        }\n    }\n}\n"]}

package/AudioV2/abstractAudio/streamingSoundInstance.d.ts

@@ -0,0 +1,25 @@
+import { Observable } from "../../Misc/observable";
+import type { IAbstractSoundInstanceOptions } from "./abstractSoundInstance";
+import { _AbstractSoundInstance } from "./abstractSoundInstance";
+import type { IStreamingSoundOptionsBase, StreamingSound } from "./streamingSound";
+/**
+ * Options for creating streaming sound instance.
+ * @internal
+ */
+export interface IStreamingSoundInstanceOptions extends IAbstractSoundInstanceOptions, IStreamingSoundOptionsBase {
+}
+/** @internal */
+export declare abstract class _StreamingSoundInstance extends _AbstractSoundInstance {
+    private _rejectPreloadedProimse;
+    private _resolvePreloadedPromise;
+    protected abstract readonly _options: IStreamingSoundInstanceOptions;
+    /** @internal */
+    readonly onReadyObservable: Observable<_StreamingSoundInstance>;
+    /** @internal */
+    readonly preloadedPromise: Promise<void>;
+    protected constructor(sound: StreamingSound);
+    /** @internal */
+    set startOffset(value: number);
+    /** @internal */
+    dispose(): void;
+}

package/AudioV2/abstractAudio/streamingSoundInstance.js

@@ -0,0 +1,29 @@
+import { Observable } from "../../Misc/observable.js";
+import { _AbstractSoundInstance } from "./abstractSoundInstance.js";
+/** @internal */
+export class _StreamingSoundInstance extends _AbstractSoundInstance {
+    constructor(sound) {
+        super(sound);
+        /** @internal */
+        this.onReadyObservable = new Observable();
+        /** @internal */
+        this.preloadedPromise = new Promise((resolve, reject) => {
+            this._rejectPreloadedProimse = reject;
+            this._resolvePreloadedPromise = resolve;
+        });
+        this.onErrorObservable.add(this._rejectPreloadedProimse);
+        this.onReadyObservable.add(this._resolvePreloadedPromise);
+    }
+    /** @internal */
+    set startOffset(value) {
+        this._options.startOffset = value;
+    }
+    /** @internal */
+    dispose() {
+        super.dispose();
+        this.onErrorObservable.clear();
+        this.onReadyObservable.clear();
+        this._resolvePreloadedPromise();
+    }
+}
+//# sourceMappingURL=streamingSoundInstance.js.map

package/AudioV2/abstractAudio/streamingSoundInstance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamingSoundInstance.js","sourceRoot":"","sources":["../../../../../dev/core/src/AudioV2/abstractAudio/streamingSoundInstance.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AASjE,gBAAgB;AAChB,MAAM,OAAgB,uBAAwB,SAAQ,sBAAsB;IAexE,YAAsB,KAAqB;QACvC,KAAK,CAAC,KAAK,CAAC,CAAC;QAVjB,gBAAgB;QACA,sBAAiB,GAAG,IAAI,UAAU,EAA2B,CAAC;QAE9E,gBAAgB;QACA,qBAAgB,GAAG,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrE,IAAI,CAAC,uBAAuB,GAAG,MAAM,CAAC;YACtC,IAAI,CAAC,wBAAwB,GAAG,OAAO,CAAC;QAC5C,CAAC,CAAC,CAAC;QAKC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACzD,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;IAC9D,CAAC;IAED,gBAAgB;IAChB,IAAW,WAAW,CAAC,KAAa;QAChC,IAAI,CAAC,QAAQ,CAAC,WAAW,GAAG,KAAK,CAAC;IACtC,CAAC;IAED,gBAAgB;IACA,OAAO;QACnB,KAAK,CAAC,OAAO,EAAE,CAAC;QAEhB,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAE/B,IAAI,CAAC,wBAAwB,EAAE,CAAC;IACpC,CAAC;CACJ","sourcesContent":["import { Observable } from \"../../Misc/observable\";\nimport type { IAbstractSoundInstanceOptions } from \"./abstractSoundInstance\";\nimport { _AbstractSoundInstance } from \"./abstractSoundInstance\";\nimport type { IStreamingSoundOptionsBase, StreamingSound } from \"./streamingSound\";\n\n/**\n * Options for creating streaming sound instance.\n * @internal\n */\nexport interface IStreamingSoundInstanceOptions extends IAbstractSoundInstanceOptions, IStreamingSoundOptionsBase {}\n\n/** @internal */\nexport abstract class _StreamingSoundInstance extends _AbstractSoundInstance {\n    private _rejectPreloadedProimse: (reason?: any) => void;\n    private _resolvePreloadedPromise: () => void;\n\n    protected abstract override readonly _options: IStreamingSoundInstanceOptions;\n\n    /** @internal */\n    public readonly onReadyObservable = new Observable<_StreamingSoundInstance>();\n\n    /** @internal */\n    public readonly preloadedPromise = new Promise<void>((resolve, reject) => {\n        this._rejectPreloadedProimse = reject;\n        this._resolvePreloadedPromise = resolve;\n    });\n\n    protected constructor(sound: StreamingSound) {\n        super(sound);\n\n        this.onErrorObservable.add(this._rejectPreloadedProimse);\n        this.onReadyObservable.add(this._resolvePreloadedPromise);\n    }\n\n    /** @internal */\n    public set startOffset(value: number) {\n        this._options.startOffset = value;\n    }\n\n    /** @internal */\n    public override dispose(): void {\n        super.dispose();\n\n        this.onErrorObservable.clear();\n        this.onReadyObservable.clear();\n\n        this._resolvePreloadedPromise();\n    }\n}\n"]}

package/AudioV2/abstractAudio/subNodes/abstractAudioSubGraph.d.ts

@@ -0,0 +1,53 @@
+import type { Nullable } from "../../../types";
+import type { AbstractNamedAudioNode } from "../abstractAudioNode";
+import type { _AbstractAudioSubNode } from "./abstractAudioSubNode";
+/**
+ * Adds common sub graph functionality to an audio node.
+ *
+ * Audio nodes such as static sounds, streaming sounds, and buses can use audio sub graphs to process audio internally
+ * before sending it to connected downstream audio nodes. This is useful for applying effects, spatial audio, and other
+ * audio processing tasks common to multiple audio node classes.
+ *
+ * A key feature of audio sub graphs is their audio sub nodes are created asynchronously on demand so the minimum set
+ * of sub nodes are used at all times to save memory and CPU resources. The tradeoff is a small delay when first
+ * setting a property backed by a sub node. This delay is avoided by using the appropriate options to initialize the
+ * sub node on creation, e.g. `spatialEnabled` and `stereoEnabled`, or by setting any creation option backed by the
+ * sub node, e.g. `spatialPosition` and `stereoPan`.
+ *
+ * @internal
+ */
+export declare abstract class _AbstractAudioSubGraph {
+    private _createSubNodePromises;
+    private _subNodes;
+    /**
+     * Executes the given callback with the named sub node, creating the sub node if needed.
+     *
+     * Note that `callback` is executed synchronously if the sub node already exists, otherwise the sub node is created
+     * asynchronously before `callback` is executed.
+     *
+     * @param name The name of the sub node
+     * @param callback The function to call with the named sub node
+     */
+    callOnSubNode<T extends _AbstractAudioSubNode>(name: string, callback: (node: T) => void): void;
+    /**
+     * Releases associated resources.
+     */
+    dispose(): void;
+    /**
+     * Gets a previously created sub node.
+     * @param name - The name of the sub node
+     * @returns The named sub node, or `null` if it has not been created, yet
+     * @internal
+     * */
+    getSubNode<T extends AbstractNamedAudioNode>(name: string): Nullable<T>;
+    protected abstract _createSubNode(name: string): Nullable<Promise<_AbstractAudioSubNode>>;
+    /**
+     * Called when sub-nodes are added or removed.
+     * - Override this to connect and reconnect sub-nodes as needed.
+     */
+    protected _onSubNodesChanged(): void;
+    protected _createSubNodePromisesResolved(): Promise<_AbstractAudioSubNode[]>;
+    private _addSubNode;
+    protected _createAndAddSubNode(name: string): Promise<_AbstractAudioSubNode>;
+    private _onSubNodeDisposed;
+}

package/AudioV2/abstractAudio/subNodes/abstractAudioSubGraph.js

@@ -0,0 +1,97 @@
+/**
+ * Adds common sub graph functionality to an audio node.
+ *
+ * Audio nodes such as static sounds, streaming sounds, and buses can use audio sub graphs to process audio internally
+ * before sending it to connected downstream audio nodes. This is useful for applying effects, spatial audio, and other
+ * audio processing tasks common to multiple audio node classes.
+ *
+ * A key feature of audio sub graphs is their audio sub nodes are created asynchronously on demand so the minimum set
+ * of sub nodes are used at all times to save memory and CPU resources. The tradeoff is a small delay when first
+ * setting a property backed by a sub node. This delay is avoided by using the appropriate options to initialize the
+ * sub node on creation, e.g. `spatialEnabled` and `stereoEnabled`, or by setting any creation option backed by the
+ * sub node, e.g. `spatialPosition` and `stereoPan`.
+ *
+ * @internal
+ */
+export class _AbstractAudioSubGraph {
+    constructor() {
+        this._createSubNodePromises = {};
+        this._subNodes = {};
+        this._onSubNodeDisposed = (node) => {
+            const subNode = node;
+            delete this._subNodes[subNode.name];
+            this._onSubNodesChanged();
+        };
+    }
+    /**
+     * Executes the given callback with the named sub node, creating the sub node if needed.
+     *
+     * Note that `callback` is executed synchronously if the sub node already exists, otherwise the sub node is created
+     * asynchronously before `callback` is executed.
+     *
+     * @param name The name of the sub node
+     * @param callback The function to call with the named sub node
+     */
+    callOnSubNode(name, callback) {
+        const node = this.getSubNode(name);
+        if (node) {
+            callback(node);
+            return;
+        }
+        const promise = this._createSubNodePromises[name] ?? this._createAndAddSubNode(name);
+        promise.then((node) => {
+            callback(node);
+        });
+    }
+    /**
+     * Releases associated resources.
+     */
+    dispose() {
+        const subNodes = Object.values(this._subNodes);
+        for (const subNode of subNodes) {
+            subNode.dispose();
+        }
+        this._subNodes = {};
+        this._createSubNodePromises = {};
+    }
+    /**
+     * Gets a previously created sub node.
+     * @param name - The name of the sub node
+     * @returns The named sub node, or `null` if it has not been created, yet
+     * @internal
+     * */
+    getSubNode(name) {
+        return this._subNodes[name] ?? null;
+    }
+    /**
+     * Called when sub-nodes are added or removed.
+     * - Override this to connect and reconnect sub-nodes as needed.
+     */
+    _onSubNodesChanged() { }
+    _createSubNodePromisesResolved() {
+        return Promise.all(Object.values(this._createSubNodePromises));
+    }
+    _addSubNode(node) {
+        this._subNodes[node.name] = node;
+        node.onDisposeObservable.addOnce(this._onSubNodeDisposed);
+        this._onSubNodesChanged();
+    }
+    _createAndAddSubNode(name) {
+        const promise = this._createSubNode(name);
+        if (!promise) {
+            return Promise.reject(`Failed to create subnode "${name}"`);
+        }
+        this._createSubNodePromises[name] = new Promise((resolve, reject) => {
+            promise
+                .then((node) => {
+                this._addSubNode(node);
+                resolve(node);
+            })
+                .catch((error) => {
+                reject(error);
+            });
+        });
+        return promise;
+    }
+}
+//# sourceMappingURL=abstractAudioSubGraph.js.map

package/AudioV2/abstractAudio/subNodes/abstractAudioSubGraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractAudioSubGraph.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subNodes/abstractAudioSubGraph.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAgB,sBAAsB;IAA5C;QACY,2BAAsB,GAAsD,EAAE,CAAC;QAC/E,cAAS,GAA8C,EAAE,CAAC;QAyF1D,uBAAkB,GAAG,CAAC,IAAuB,EAAE,EAAE;YACrD,MAAM,OAAO,GAAG,IAA8B,CAAC;YAE/C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAEpC,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAC9B,CAAC,CAAC;IACN,CAAC;IA9FG;;;;;;;;OAQG;IACI,aAAa,CAAkC,IAAY,EAAE,QAA2B;QAC3F,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,IAAI,EAAE,CAAC;YACP,QAAQ,CAAC,IAAS,CAAC,CAAC;YACpB,OAAO;QACX,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAErF,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,QAAQ,CAAC,IAAS,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;IACP,CAAC;IAED;;OAEG;IACI,OAAO;QACV,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC/C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,OAAO,EAAE,CAAC;QACtB,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;QACpB,IAAI,CAAC,sBAAsB,GAAG,EAAE,CAAC;IACrC,CAAC;IAED;;;;;SAKK;IACE,UAAU,CAAmC,IAAY;QAC5D,OAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAO,IAAI,IAAI,CAAC;IAC/C,CAAC;IAID;;;OAGG;IACO,kBAAkB,KAAU,CAAC;IAE7B,8BAA8B;QACpC,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACnE,CAAC;IAEO,WAAW,CAAC,IAA4B;QAC5C,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;QAEjC,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAE1D,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC9B,CAAC;IAES,oBAAoB,CAAC,IAAY;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,OAAO,CAAC,MAAM,CAAC,6BAA6B,IAAI,GAAG,CAAC,CAAC;QAChE,CAAC;QAED,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChE,OAAO;iBACF,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;gBACX,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO,CAAC,IAAI,CAAC,CAAC;YAClB,CAAC,CAAC;iBACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACb,MAAM,CAAC,KAAK,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;QACX,CAAC,CAAC,CAAC;QAEH,OAAO,OAAO,CAAC;IACnB,CAAC;CASJ","sourcesContent":["import type { Nullable } from \"../../../types\";\nimport type { AbstractAudioNode, AbstractNamedAudioNode } from \"../abstractAudioNode\";\nimport type { _AbstractAudioSubNode } from \"./abstractAudioSubNode\";\n\n/**\n * Adds common sub graph functionality to an audio node.\n *\n * Audio nodes such as static sounds, streaming sounds, and buses can use audio sub graphs to process audio internally\n * before sending it to connected downstream audio nodes. This is useful for applying effects, spatial audio, and other\n * audio processing tasks common to multiple audio node classes.\n *\n * A key feature of audio sub graphs is their audio sub nodes are created asynchronously on demand so the minimum set\n * of sub nodes are used at all times to save memory and CPU resources. The tradeoff is a small delay when first\n * setting a property backed by a sub node. This delay is avoided by using the appropriate options to initialize the\n * sub node on creation, e.g. `spatialEnabled` and `stereoEnabled`, or by setting any creation option backed by the\n * sub node, e.g. `spatialPosition` and `stereoPan`.\n *\n * @internal\n */\nexport abstract class _AbstractAudioSubGraph {\n    private _createSubNodePromises: { [key: string]: Promise<_AbstractAudioSubNode> } = {};\n    private _subNodes: { [key: string]: AbstractNamedAudioNode } = {};\n\n    /**\n     * Executes the given callback with the named sub node, creating the sub node if needed.\n     *\n     * Note that `callback` is executed synchronously if the sub node already exists, otherwise the sub node is created\n     * asynchronously before `callback` is executed.\n     *\n     * @param name The name of the sub node\n     * @param callback The function to call with the named sub node\n     */\n    public callOnSubNode<T extends _AbstractAudioSubNode>(name: string, callback: (node: T) => void): void {\n        const node = this.getSubNode(name);\n        if (node) {\n            callback(node as T);\n            return;\n        }\n\n        const promise = this._createSubNodePromises[name] ?? this._createAndAddSubNode(name);\n\n        promise.then((node) => {\n            callback(node as T);\n        });\n    }\n\n    /**\n     * Releases associated resources.\n     */\n    public dispose() {\n        const subNodes = Object.values(this._subNodes);\n        for (const subNode of subNodes) {\n            subNode.dispose();\n        }\n\n        this._subNodes = {};\n        this._createSubNodePromises = {};\n    }\n\n    /**\n     * Gets a previously created sub node.\n     * @param name - The name of the sub node\n     * @returns The named sub node, or `null` if it has not been created, yet\n     * @internal\n     * */\n    public getSubNode<T extends AbstractNamedAudioNode>(name: string): Nullable<T> {\n        return (this._subNodes[name] as T) ?? null;\n    }\n\n    protected abstract _createSubNode(name: string): Nullable<Promise<_AbstractAudioSubNode>>;\n\n    /**\n     * Called when sub-nodes are added or removed.\n     * - Override this to connect and reconnect sub-nodes as needed.\n     */\n    protected _onSubNodesChanged(): void {}\n\n    protected _createSubNodePromisesResolved(): Promise<_AbstractAudioSubNode[]> {\n        return Promise.all(Object.values(this._createSubNodePromises));\n    }\n\n    private _addSubNode(node: AbstractNamedAudioNode): void {\n        this._subNodes[node.name] = node;\n\n        node.onDisposeObservable.addOnce(this._onSubNodeDisposed);\n\n        this._onSubNodesChanged();\n    }\n\n    protected _createAndAddSubNode(name: string): Promise<_AbstractAudioSubNode> {\n        const promise = this._createSubNode(name);\n\n        if (!promise) {\n            return Promise.reject(`Failed to create subnode \"${name}\"`);\n        }\n\n        this._createSubNodePromises[name] = new Promise((resolve, reject) => {\n            promise\n                .then((node) => {\n                    this._addSubNode(node);\n                    resolve(node);\n                })\n                .catch((error) => {\n                    reject(error);\n                });\n        });\n\n        return promise;\n    }\n\n    private _onSubNodeDisposed = (node: AbstractAudioNode) => {\n        const subNode = node as AbstractNamedAudioNode;\n\n        delete this._subNodes[subNode.name];\n\n        this._onSubNodesChanged();\n    };\n}\n"]}

package/AudioV2/abstractAudio/subNodes/abstractAudioSubNode.d.ts

@@ -0,0 +1,13 @@
+import { AbstractNamedAudioNode } from "../abstractAudioNode";
+import type { AudioEngineV2 } from "../audioEngineV2";
+/** @internal */
+export declare abstract class _AbstractAudioSubNode extends AbstractNamedAudioNode {
+    /** @internal */
+    protected constructor(name: string, engine: AudioEngineV2);
+    /** @internal */
+    connect(node: _AbstractAudioSubNode): void;
+    /** @internal */
+    disconnect(node: _AbstractAudioSubNode): void;
+    /** @internal */
+    disconnectAll(): void;
+}

package/AudioV2/abstractAudio/subNodes/abstractAudioSubNode.js

@@ -0,0 +1,33 @@
+import { AbstractNamedAudioNode } from "../abstractAudioNode.js";
+/** @internal */
+export class _AbstractAudioSubNode extends AbstractNamedAudioNode {
+    /** @internal */
+    constructor(name, engine) {
+        super(name, engine, 3 /* AudioNodeType.HAS_INPUTS_AND_OUTPUTS */);
+    }
+    /** @internal */
+    connect(node) {
+        if (!this._connect(node)) {
+            throw new Error("Connect failed");
+        }
+    }
+    /** @internal */
+    disconnect(node) {
+        if (!this._disconnect(node)) {
+            throw new Error("Disconnect failed");
+        }
+    }
+    /** @internal */
+    disconnectAll() {
+        if (!this._downstreamNodes) {
+            throw new Error("Disconnect failed");
+        }
+        const it = this._downstreamNodes.values();
+        for (let next = it.next(); !next.done; next = it.next()) {
+            if (!this._disconnect(next.value)) {
+                throw new Error("Disconnect failed");
+            }
+        }
+    }
+}
+//# sourceMappingURL=abstractAudioSubNode.js.map

package/AudioV2/abstractAudio/subNodes/abstractAudioSubNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstractAudioSubNode.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subNodes/abstractAudioSubNode.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG7E,gBAAgB;AAChB,MAAM,OAAgB,qBAAsB,SAAQ,sBAAsB;IACtE,gBAAgB;IAChB,YAAsB,IAAY,EAAE,MAAqB;QACrD,KAAK,CAAC,IAAI,EAAE,MAAM,+CAAuC,CAAC;IAC9D,CAAC;IAED,gBAAgB;IACT,OAAO,CAAC,IAA2B;QACtC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtC,CAAC;IACL,CAAC;IAED,gBAAgB;IACT,UAAU,CAAC,IAA2B;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IAED,gBAAgB;IACT,aAAa;QAChB,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACzC,CAAC;QAED,MAAM,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC;QAE1C,KAAK,IAAI,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;YACzC,CAAC;QACL,CAAC;IACL,CAAC;CACJ","sourcesContent":["import { AudioNodeType, AbstractNamedAudioNode } from \"../abstractAudioNode\";\nimport type { AudioEngineV2 } from \"../audioEngineV2\";\n\n/** @internal */\nexport abstract class _AbstractAudioSubNode extends AbstractNamedAudioNode {\n    /** @internal */\n    protected constructor(name: string, engine: AudioEngineV2) {\n        super(name, engine, AudioNodeType.HAS_INPUTS_AND_OUTPUTS);\n    }\n\n    /** @internal */\n    public connect(node: _AbstractAudioSubNode): void {\n        if (!this._connect(node)) {\n            throw new Error(\"Connect failed\");\n        }\n    }\n\n    /** @internal */\n    public disconnect(node: _AbstractAudioSubNode): void {\n        if (!this._disconnect(node)) {\n            throw new Error(\"Disconnect failed\");\n        }\n    }\n\n    /** @internal */\n    public disconnectAll(): void {\n        if (!this._downstreamNodes) {\n            throw new Error(\"Disconnect failed\");\n        }\n\n        const it = this._downstreamNodes.values();\n\n        for (let next = it.next(); !next.done; next = it.next()) {\n            if (!this._disconnect(next.value)) {\n                throw new Error(\"Disconnect failed\");\n            }\n        }\n    }\n}\n"]}

package/AudioV2/abstractAudio/subNodes/audioSubNode.d.ts

@@ -0,0 +1,6 @@
+/** @internal */
+export declare enum AudioSubNode {
+    STEREO = "Stereo",
+    SPATIAL = "Spatial",
+    VOLUME = "Volume"
+}

package/AudioV2/abstractAudio/subNodes/audioSubNode.js

@@ -0,0 +1,8 @@
+/** @internal */
+export var AudioSubNode;
+(function (AudioSubNode) {
+    AudioSubNode["STEREO"] = "Stereo";
+    AudioSubNode["SPATIAL"] = "Spatial";
+    AudioSubNode["VOLUME"] = "Volume";
+})(AudioSubNode || (AudioSubNode = {}));
+//# sourceMappingURL=audioSubNode.js.map

package/AudioV2/abstractAudio/subNodes/audioSubNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audioSubNode.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subNodes/audioSubNode.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,MAAM,CAAN,IAAkB,YAIjB;AAJD,WAAkB,YAAY;IAC1B,iCAAiB,CAAA;IACjB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;AACrB,CAAC,EAJiB,YAAY,KAAZ,YAAY,QAI7B","sourcesContent":["/** @internal */\nexport const enum AudioSubNode {\n    STEREO = \"Stereo\",\n    SPATIAL = \"Spatial\",\n    VOLUME = \"Volume\",\n}\n"]}

package/AudioV2/abstractAudio/subNodes/spatialAudioSubNode.d.ts

@@ -0,0 +1,31 @@
+import type { Quaternion, Vector3 } from "../../../Maths/math.vector";
+import type { Nullable } from "../../../types";
+import type { AudioEngineV2 } from "../audioEngineV2";
+import type { ISpatialAudioOptions } from "../subProperties/abstractSpatialAudio";
+import { _SpatialAudioDefaults } from "../subProperties/abstractSpatialAudio";
+import type { _AbstractAudioSubGraph } from "./abstractAudioSubGraph";
+import { _AbstractAudioSubNode } from "./abstractAudioSubNode";
+/** @internal */
+export declare abstract class _SpatialAudioSubNode extends _AbstractAudioSubNode {
+    protected constructor(engine: AudioEngineV2);
+    abstract coneInnerAngle: number;
+    abstract coneOuterAngle: number;
+    abstract coneOuterVolume: number;
+    abstract distanceModel: DistanceModelType;
+    abstract maxDistance: number;
+    abstract panningModel: PanningModelType;
+    abstract position: Vector3;
+    abstract referenceDistance: number;
+    abstract rolloffFactor: number;
+    abstract rotation: Vector3;
+    abstract rotationQuaternion: Quaternion;
+    abstract inNode: AudioNode;
+    /** @internal */
+    setOptions(options: Partial<ISpatialAudioOptions>): void;
+}
+/** @internal */
+export declare function _GetSpatialAudioSubNode(subGraph: _AbstractAudioSubGraph): Nullable<_SpatialAudioSubNode>;
+/** @internal */
+export declare function _GetSpatialAudioProperty<K extends keyof typeof _SpatialAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K): (typeof _SpatialAudioDefaults)[K];
+/** @internal */
+export declare function _SetSpatialAudioProperty<K extends keyof typeof _SpatialAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K, value: _SpatialAudioSubNode[K]): void;

package/AudioV2/abstractAudio/subNodes/spatialAudioSubNode.js

@@ -0,0 +1,46 @@
+import { _SpatialAudioDefaults } from "../subProperties/abstractSpatialAudio.js";
+import { _AbstractAudioSubNode } from "./abstractAudioSubNode.js";
+/** @internal */
+export class _SpatialAudioSubNode extends _AbstractAudioSubNode {
+    constructor(engine) {
+        super("Spatial" /* AudioSubNode.SPATIAL */, engine);
+    }
+    /** @internal */
+    setOptions(options) {
+        this.coneInnerAngle = options.spatialConeInnerAngle ?? _SpatialAudioDefaults.coneInnerAngle;
+        this.coneOuterAngle = options.spatialConeOuterAngle ?? _SpatialAudioDefaults.coneOuterAngle;
+        this.coneOuterVolume = options.spatialConeOuterVolume ?? _SpatialAudioDefaults.coneOuterVolume;
+        this.distanceModel = options.spatialDistanceModel ?? _SpatialAudioDefaults.distanceModel;
+        this.maxDistance = options.spatialMaxDistance ?? _SpatialAudioDefaults.maxDistance;
+        this.panningModel = options.spatialPanningModel ?? _SpatialAudioDefaults.panningModel;
+        this.referenceDistance = options.spatialReferenceDistance ?? _SpatialAudioDefaults.referenceDistance;
+        this.rolloffFactor = options.spatialRolloffFactor ?? _SpatialAudioDefaults.rolloffFactor;
+        if (options.spatialPosition !== undefined) {
+            this.position = options.spatialPosition.clone();
+        }
+        if (options.spatialRotationQuaternion !== undefined) {
+            this.rotationQuaternion = options.spatialRotationQuaternion.clone();
+        }
+        else if (options.spatialRotation !== undefined) {
+            this.rotation = options.spatialRotation.clone();
+        }
+        else {
+            this.rotationQuaternion = _SpatialAudioDefaults.rotationQuaternion.clone();
+        }
+    }
+}
+/** @internal */
+export function _GetSpatialAudioSubNode(subGraph) {
+    return subGraph.getSubNode("Spatial" /* AudioSubNode.SPATIAL */);
+}
+/** @internal */
+export function _GetSpatialAudioProperty(subGraph, property) {
+    return _GetSpatialAudioSubNode(subGraph)?.[property] ?? _SpatialAudioDefaults[property];
+}
+/** @internal */
+export function _SetSpatialAudioProperty(subGraph, property, value) {
+    subGraph.callOnSubNode("Spatial" /* AudioSubNode.SPATIAL */, (node) => {
+        node[property] = value;
+    });
+}
+//# sourceMappingURL=spatialAudioSubNode.js.map

package/AudioV2/abstractAudio/subNodes/spatialAudioSubNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatialAudioSubNode.js","sourceRoot":"","sources":["../../../../../../dev/core/src/AudioV2/abstractAudio/subNodes/spatialAudioSubNode.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,gBAAgB;AAChB,MAAM,OAAgB,oBAAqB,SAAQ,qBAAqB;IACpE,YAAsB,MAAqB;QACvC,KAAK,uCAAuB,MAAM,CAAC,CAAC;IACxC,CAAC;IAeD,gBAAgB;IACT,UAAU,CAAC,OAAsC;QACpD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,qBAAqB,IAAI,qBAAqB,CAAC,cAAc,CAAC;QAC5F,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,qBAAqB,IAAI,qBAAqB,CAAC,cAAc,CAAC;QAC5F,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,sBAAsB,IAAI,qBAAqB,CAAC,eAAe,CAAC;QAC/F,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,oBAAoB,IAAI,qBAAqB,CAAC,aAAa,CAAC;QACzF,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,kBAAkB,IAAI,qBAAqB,CAAC,WAAW,CAAC;QACnF,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,mBAAmB,IAAI,qBAAqB,CAAC,YAAY,CAAC;QACtF,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,wBAAwB,IAAI,qBAAqB,CAAC,iBAAiB,CAAC;QACrG,IAAI,CAAC,aAAa,GAAG,OAAO,CAAC,oBAAoB,IAAI,qBAAqB,CAAC,aAAa,CAAC;QAEzF,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;QAED,IAAI,OAAO,CAAC,yBAAyB,KAAK,SAAS,EAAE,CAAC;YAClD,IAAI,CAAC,kBAAkB,GAAG,OAAO,CAAC,yBAAyB,CAAC,KAAK,EAAE,CAAC;QACxE,CAAC;aAAM,IAAI,OAAO,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YAC/C,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QACpD,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,kBAAkB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;QAC/E,CAAC;IACL,CAAC;CACJ;AAED,gBAAgB;AAChB,MAAM,UAAU,uBAAuB,CAAC,QAAgC;IACpE,OAAO,QAAQ,CAAC,UAAU,sCAA4C,CAAC;AAC3E,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,wBAAwB,CAA+C,QAAgC,EAAE,QAAW;IAChI,OAAO,uBAAuB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,qBAAqB,CAAC,QAAQ,CAAC,CAAC;AAC5F,CAAC;AAED,gBAAgB;AAChB,MAAM,UAAU,wBAAwB,CAA+C,QAAgC,EAAE,QAAW,EAAE,KAA8B;IAChK,QAAQ,CAAC,aAAa,uCAA6C,CAAC,IAAI,EAAE,EAAE;QACxE,IAAI,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;IAC3B,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["import type { Quaternion, Vector3 } from \"../../../Maths/math.vector\";\nimport type { Nullable } from \"../../../types\";\nimport type { AudioEngineV2 } from \"../audioEngineV2\";\nimport type { ISpatialAudioOptions } from \"../subProperties/abstractSpatialAudio\";\nimport { _SpatialAudioDefaults } from \"../subProperties/abstractSpatialAudio\";\nimport type { _AbstractAudioSubGraph } from \"./abstractAudioSubGraph\";\nimport { _AbstractAudioSubNode } from \"./abstractAudioSubNode\";\nimport { AudioSubNode } from \"./audioSubNode\";\n\n/** @internal */\nexport abstract class _SpatialAudioSubNode extends _AbstractAudioSubNode {\n    protected constructor(engine: AudioEngineV2) {\n        super(AudioSubNode.SPATIAL, engine);\n    }\n\n    public abstract coneInnerAngle: number;\n    public abstract coneOuterAngle: number;\n    public abstract coneOuterVolume: number;\n    public abstract distanceModel: DistanceModelType;\n    public abstract maxDistance: number;\n    public abstract panningModel: PanningModelType;\n    public abstract position: Vector3;\n    public abstract referenceDistance: number;\n    public abstract rolloffFactor: number;\n    public abstract rotation: Vector3;\n    public abstract rotationQuaternion: Quaternion;\n    public abstract inNode: AudioNode;\n\n    /** @internal */\n    public setOptions(options: Partial<ISpatialAudioOptions>): void {\n        this.coneInnerAngle = options.spatialConeInnerAngle ?? _SpatialAudioDefaults.coneInnerAngle;\n        this.coneOuterAngle = options.spatialConeOuterAngle ?? _SpatialAudioDefaults.coneOuterAngle;\n        this.coneOuterVolume = options.spatialConeOuterVolume ?? _SpatialAudioDefaults.coneOuterVolume;\n        this.distanceModel = options.spatialDistanceModel ?? _SpatialAudioDefaults.distanceModel;\n        this.maxDistance = options.spatialMaxDistance ?? _SpatialAudioDefaults.maxDistance;\n        this.panningModel = options.spatialPanningModel ?? _SpatialAudioDefaults.panningModel;\n        this.referenceDistance = options.spatialReferenceDistance ?? _SpatialAudioDefaults.referenceDistance;\n        this.rolloffFactor = options.spatialRolloffFactor ?? _SpatialAudioDefaults.rolloffFactor;\n\n        if (options.spatialPosition !== undefined) {\n            this.position = options.spatialPosition.clone();\n        }\n\n        if (options.spatialRotationQuaternion !== undefined) {\n            this.rotationQuaternion = options.spatialRotationQuaternion.clone();\n        } else if (options.spatialRotation !== undefined) {\n            this.rotation = options.spatialRotation.clone();\n        } else {\n            this.rotationQuaternion = _SpatialAudioDefaults.rotationQuaternion.clone();\n        }\n    }\n}\n\n/** @internal */\nexport function _GetSpatialAudioSubNode(subGraph: _AbstractAudioSubGraph): Nullable<_SpatialAudioSubNode> {\n    return subGraph.getSubNode<_SpatialAudioSubNode>(AudioSubNode.SPATIAL);\n}\n\n/** @internal */\nexport function _GetSpatialAudioProperty<K extends keyof typeof _SpatialAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K): (typeof _SpatialAudioDefaults)[K] {\n    return _GetSpatialAudioSubNode(subGraph)?.[property] ?? _SpatialAudioDefaults[property];\n}\n\n/** @internal */\nexport function _SetSpatialAudioProperty<K extends keyof typeof _SpatialAudioDefaults>(subGraph: _AbstractAudioSubGraph, property: K, value: _SpatialAudioSubNode[K]): void {\n    subGraph.callOnSubNode<_SpatialAudioSubNode>(AudioSubNode.SPATIAL, (node) => {\n        node[property] = value;\n    });\n}\n"]}