@babylonjs/lite 1.4.0 → 1.5.0

package/lib/audio/static-sound.js

@@ -0,0 +1,313 @@
+import { getBusInputNode } from './audio-bus.js';
+import { setRampTarget, createRampParam } from './audio-param.js';
+import { createAudioSignal } from './audio-signal.js';
+import { createSoundBufferAsync } from './sound-buffer.js';
+import { createSoundSubGraph, connectSoundSubGraph, disposeSoundSubGraph, setSoundSubGraphVolume } from './sound-sub-graph.js';
+
+const SoundState = {
+  Stopping: 0,
+  Stopped: 1,
+  Starting: 2,
+  Started: 3,
+  FailedToStart: 4,
+  Paused: 5
+};
+async function createSoundAsync(engine, source, options = {}) {
+  const buffer = await createSoundBufferAsync(engine, source, options);
+  const graph = createSoundSubGraph(engine._ctx, engine, options.volume ?? 1);
+  const outBus = options.outBus ?? engine._mainBus;
+  connectSoundSubGraph(graph, getBusInputNode(outBus));
+  const onEnded = createAudioSignal();
+  const sound = {
+    get state() {
+      return sound._state;
+    },
+    get instanceCount() {
+      return sound._instances.size;
+    },
+    get buffer() {
+      return sound._buffer;
+    },
+    get onEnded() {
+      return onEnded;
+    },
+    _engine: engine,
+    _buffer: buffer,
+    _graph: graph,
+    _outBus: outBus,
+    _options: {
+      autoplay: options.autoplay ?? false,
+      duration: options.duration ?? 0,
+      loop: options.loop ?? false,
+      loopEnd: options.loopEnd ?? 0,
+      loopStart: options.loopStart ?? 0,
+      maxInstances: options.maxInstances ?? Infinity,
+      pitch: options.pitch ?? 0,
+      playbackRate: options.playbackRate ?? 1,
+      startOffset: options.startOffset ?? 0
+    },
+    _instances: /* @__PURE__ */ new Set(),
+    _newest: null,
+    _state: SoundState.Stopped,
+    _onEnded: onEnded,
+    _dispose: () => disposeSound(sound)
+  };
+  engine._sounds.add(sound);
+  if (sound._options.autoplay) {
+    playSound(sound);
+  }
+  return sound;
+}
+function setSoundVolume(sound, value, options) {
+  setSoundSubGraphVolume(sound._graph, value, options);
+}
+function playSound(sound, options = {}) {
+  if (sound._state === SoundState.Paused) {
+    resumeSound(sound, options);
+    return;
+  }
+  const opts = {
+    duration: options.duration ?? sound._options.duration,
+    loop: options.loop ?? sound._options.loop,
+    loopStart: options.loopStart ?? sound._options.loopStart,
+    loopEnd: options.loopEnd ?? sound._options.loopEnd,
+    startOffset: options.startOffset ?? sound._options.startOffset,
+    volume: options.volume ?? 1,
+    waitTime: options.waitTime ?? 0
+  };
+  const instance = _createInstance(sound);
+  instance._onEnded.addOnce(instance._endedHandler);
+  sound._instances.add(instance);
+  sound._newest = instance;
+  _instancePlay(instance, opts);
+  sound._state = instance._state;
+  _stopExcessInstances(sound);
+}
+function pauseSound(sound) {
+  for (const instance of sound._instances) {
+    _instancePause(instance);
+  }
+  sound._state = SoundState.Paused;
+}
+function resumeSound(sound, options = {}) {
+  if (sound._state !== SoundState.Paused) {
+    return;
+  }
+  for (const instance of sound._instances) {
+    _instanceResume(instance, options);
+  }
+  sound._state = SoundState.Started;
+}
+function stopSound(sound, options = {}) {
+  sound._state = options.waitTime && options.waitTime > 0 ? SoundState.Stopping : SoundState.Stopped;
+  for (const instance of Array.from(sound._instances)) {
+    _instanceStop(instance, options);
+  }
+}
+function disposeSound(sound) {
+  stopSound(sound);
+  for (const instance of Array.from(sound._instances)) {
+    _instanceDispose(instance);
+  }
+  sound._instances.clear();
+  disposeSoundSubGraph(sound._graph);
+  sound._onEnded._clear();
+  sound._engine._sounds.delete(sound);
+}
+function _stopExcessInstances(sound) {
+  if (sound._options.maxInstances < Infinity) {
+    const started = Array.from(sound._instances).filter((i) => i._state === SoundState.Started);
+    const toStop = started.length - sound._options.maxInstances;
+    for (let i = 0; i < toStop; i++) {
+      _instanceStop(started[i]);
+    }
+  }
+}
+function _onInstanceEnded(sound, instance) {
+  if (sound._newest === instance) {
+    sound._newest = null;
+  }
+  sound._instances.delete(instance);
+  if (sound._instances.size === 0) {
+    sound._state = SoundState.Stopped;
+    sound._onEnded._notify(sound);
+  }
+  _instanceDispose(instance);
+}
+function _createInstance(sound) {
+  const engine = sound._engine;
+  const instance = {
+    _sound: sound,
+    _engine: engine,
+    _options: {
+      duration: sound._options.duration,
+      loop: sound._options.loop,
+      loopEnd: sound._options.loopEnd,
+      loopStart: sound._options.loopStart,
+      startOffset: sound._options.startOffset
+    },
+    _volumeNode: new GainNode(engine._ctx),
+    _sourceNode: null,
+    _state: SoundState.Stopped,
+    _enginePlayTime: 0,
+    _enginePauseTime: 0,
+    _isConnected: false,
+    _pitch: null,
+    _playbackRate: null,
+    _engineStateUnsub: null,
+    _onEnded: createAudioSignal(),
+    _onStateChanged: createAudioSignal(),
+    _endedHandler: () => _onInstanceEnded(sound, instance),
+    _engineStateHandler: () => _onEngineStateChanged(instance)
+  };
+  return instance;
+}
+function _setInstanceState(instance, state) {
+  instance._state = state;
+  instance._onStateChanged._notify(instance);
+}
+function _instancePlay(instance, options) {
+  if (instance._state === SoundState.Started) {
+    return;
+  }
+  instance._options.duration = options.duration;
+  instance._options.loop = options.loop;
+  instance._options.loopStart = options.loopStart;
+  instance._options.loopEnd = options.loopEnd;
+  instance._options.startOffset = options.startOffset;
+  let startOffset = instance._options.startOffset;
+  if (instance._state === SoundState.Paused) {
+    startOffset += instance._enginePauseTime;
+    startOffset %= instance._sound._buffer.duration;
+  }
+  instance._enginePlayTime = instance._engine.currentTime + options.waitTime;
+  if (options.volume !== void 0) {
+    instance._volumeNode.gain.value = options.volume;
+  }
+  _initSourceNode(instance);
+  if (instance._engine.state === "running") {
+    _setInstanceState(instance, SoundState.Started);
+    instance._sourceNode?.start(instance._enginePlayTime, startOffset, instance._options.duration > 0 ? instance._options.duration : void 0);
+  } else if (instance._options.loop) {
+    _setInstanceState(instance, SoundState.Starting);
+    instance._engineStateUnsub = instance._engine.onStateChanged.add(instance._engineStateHandler);
+  }
+}
+function _instancePause(instance) {
+  if (instance._state !== SoundState.Started && instance._state !== SoundState.Starting) {
+    return;
+  }
+  const wasStarted = instance._state === SoundState.Started;
+  _setInstanceState(instance, SoundState.Paused);
+  instance._enginePauseTime += instance._engine.currentTime - instance._enginePlayTime;
+  if (wasStarted) {
+    instance._sourceNode?.stop();
+  } else {
+    instance._engineStateUnsub?.();
+    instance._engineStateUnsub = null;
+  }
+  _deinitSourceNode(instance);
+}
+function _instanceResume(instance, options) {
+  if (instance._state === SoundState.Paused) {
+    const opts = {
+      duration: options.duration ?? instance._options.duration,
+      loop: options.loop ?? instance._options.loop,
+      loopStart: options.loopStart ?? instance._options.loopStart,
+      loopEnd: options.loopEnd ?? instance._options.loopEnd,
+      startOffset: options.startOffset ?? instance._options.startOffset,
+      volume: options.volume ?? instance._volumeNode.gain.value,
+      waitTime: options.waitTime ?? 0
+    };
+    _instancePlay(instance, opts);
+  }
+}
+function _instanceStop(instance, options = {}) {
+  if (instance._state === SoundState.Stopped) {
+    return;
+  }
+  if (instance._state === SoundState.Started) {
+    const stopTime = instance._engine.currentTime + (options.waitTime ?? 0);
+    instance._sourceNode?.stop(stopTime);
+  }
+  if (options.waitTime === void 0 || options.waitTime <= 0) {
+    _setInstanceState(instance, SoundState.Stopped);
+    instance._engineStateUnsub?.();
+    instance._engineStateUnsub = null;
+  }
+}
+function _instanceDispose(instance) {
+  _instanceStop(instance);
+  _deinitSourceNode(instance);
+  instance._engineStateUnsub?.();
+  instance._engineStateUnsub = null;
+  instance._pitch = null;
+  instance._playbackRate = null;
+  instance._onEnded._clear();
+  instance._onStateChanged._clear();
+}
+function _onEngineStateChanged(instance) {
+  if (instance._engine.state !== "running") {
+    return;
+  }
+  if (instance._options.loop && instance._state === SoundState.Starting) {
+    const opts = {
+      duration: instance._options.duration,
+      loop: instance._options.loop,
+      loopStart: instance._options.loopStart,
+      loopEnd: instance._options.loopEnd,
+      startOffset: instance._options.startOffset,
+      volume: instance._volumeNode.gain.value,
+      waitTime: 0
+    };
+    instance._state = SoundState.Stopped;
+    _instancePlay(instance, opts);
+  }
+}
+function _onInstanceEndedEvent(instance) {
+  instance._enginePlayTime = 0;
+  if (instance._state !== SoundState.Paused) {
+    instance._onEnded._notify(instance);
+  }
+  _deinitSourceNode(instance);
+}
+function _initSourceNode(instance) {
+  const sound = instance._sound;
+  if (!instance._sourceNode) {
+    const sourceNode = new AudioBufferSourceNode(instance._engine._ctx, { buffer: sound._buffer._audioBuffer });
+    instance._sourceNode = sourceNode;
+    sourceNode.addEventListener("ended", () => _onInstanceEndedEvent(instance), { once: true });
+    sourceNode.connect(instance._volumeNode);
+    instance._volumeNode.connect(sound._graph._in);
+    instance._isConnected = true;
+    instance._pitch = createRampParam(sourceNode.detune, instance._engine);
+    instance._playbackRate = createRampParam(sourceNode.playbackRate, instance._engine);
+  }
+  const node = instance._sourceNode;
+  node.detune.value = sound._options.pitch;
+  node.loop = instance._options.loop;
+  node.loopEnd = instance._options.loopEnd;
+  node.loopStart = instance._options.loopStart;
+  node.playbackRate.value = sound._options.playbackRate;
+}
+function _deinitSourceNode(instance) {
+  const node = instance._sourceNode;
+  if (!node) {
+    return;
+  }
+  if (instance._isConnected) {
+    instance._volumeNode.disconnect(instance._sound._graph._in);
+    instance._isConnected = false;
+  }
+  node.disconnect(instance._volumeNode);
+  instance._sourceNode = null;
+}
+function _setNewestInstancePitch(sound, value, options) {
+  const instance = sound._newest;
+  if (instance?._pitch) {
+    setRampTarget(instance._pitch, value, options);
+  }
+}
+
+export { SoundState, _setNewestInstancePitch, createSoundAsync, disposeSound, pauseSound, playSound, resumeSound, setSoundVolume, stopSound };
+//# sourceMappingURL=static-sound.js.map

package/lib/audio/static-sound.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-sound.js","sources":["../../../src/audio/static-sound.ts"],"sourcesContent":["/**\n * Static sounds (fully-decoded, buffer-backed) and their play instances.\n *\n * Faithful port of AudioV2 `_WebAudioStaticSound` / `_WebAudioStaticSoundInstance`\n * (and the relevant `AbstractSound` instance management), collapsed to pure\n * state + standalone functions.\n *\n * Graph per playing instance (Phase 1):\n *\n * `AudioBufferSourceNode` -\\> `instance._volumeNode` -\\> `sound._graph._in`\n *   -\\> `sound._graph._out` -\\> `outBus._in` -\\> `mainBus` -\\> `mainOut` -\\> destination\n *\n * Each `playSound` call spawns a fresh `AudioBufferSourceNode` (Web Audio source\n * nodes are single-use), exactly as Babylon.js does.\n */\n\nimport { type AudioEngine } from \"./audio-engine.js\";\nimport { type PrimaryAudioBus, getBusInputNode } from \"./audio-bus.js\";\nimport { type RampOptions, type RampParam, createRampParam, setRampTarget } from \"./audio-param.js\";\nimport { type AudioSignal, type AudioSignalImpl, createAudioSignal } from \"./audio-signal.js\";\nimport { type SoundBuffer, type SoundBufferOptions, type SoundSource, createSoundBufferAsync } from \"./sound-buffer.js\";\nimport { type SoundSubGraph, connectSoundSubGraph, createSoundSubGraph, disposeSoundSubGraph, setSoundSubGraphVolume } from \"./sound-sub-graph.js\";\n\n/** Playback state of a sound or sound instance. Values match Babylon.js exactly. */\nexport const SoundState = {\n    Stopping: 0,\n    Stopped: 1,\n    Starting: 2,\n    Started: 3,\n    FailedToStart: 4,\n    Paused: 5,\n} as const;\nexport type SoundState = (typeof SoundState)[keyof typeof SoundState];\n\n/** Options for {@link createSoundAsync}. */\nexport interface StaticSoundOptions extends SoundBufferOptions {\n    /** Play immediately once ready. Defaults to `false`. */\n    autoplay?: boolean;\n    /** Play duration in seconds (`0` = full buffer). Defaults to `0`. */\n    duration?: number;\n    /** Loop playback. Defaults to `false`. */\n    loop?: boolean;\n    /** Loop end point in seconds. Defaults to `0`. */\n    loopEnd?: number;\n    /** Loop start point in seconds. Defaults to `0`. */\n    loopStart?: number;\n    /** Maximum simultaneous instances. Defaults to `Infinity`. */\n    maxInstances?: number;\n    /** Output bus. Defaults to the engine's default main bus. */\n    outBus?: PrimaryAudioBus;\n    /** Detune in cents. Defaults to `0`. */\n    pitch?: number;\n    /** Playback rate multiplier. Defaults to `1`. */\n    playbackRate?: number;\n    /** Start offset in seconds. Defaults to `0`. */\n    startOffset?: number;\n    /** Initial volume. Defaults to `1`. */\n    volume?: number;\n}\n\n/** Per-play overrides for {@link playSound}. */\nexport interface StaticSoundPlayOptions {\n    /** Play duration in seconds (`0` = full buffer). */\n    duration?: number;\n    /** Loop playback. */\n    loop?: boolean;\n    /** Loop end point in seconds. */\n    loopEnd?: number;\n    /** Loop start point in seconds. */\n    loopStart?: number;\n    /** Start offset in seconds. */\n    startOffset?: number;\n    /** Per-instance volume. */\n    volume?: number;\n    /** Delay before playback starts, in seconds. */\n    waitTime?: number;\n}\n\n/** Options for {@link stopSound}. */\nexport interface StaticSoundStopOptions {\n    /** Delay before stopping, in seconds. */\n    waitTime?: number;\n}\n\ninterface StoredOptions {\n    autoplay: boolean;\n    duration: number;\n    loop: boolean;\n    loopEnd: number;\n    loopStart: number;\n    maxInstances: number;\n    pitch: number;\n    playbackRate: number;\n    startOffset: number;\n}\n\n/** A buffer-backed sound. Pure state — drive it with the sound functions. */\nexport interface StaticSound {\n    /** Optional name. */\n    readonly name?: string;\n    /** The decoded buffer this sound plays. */\n    readonly buffer: SoundBuffer;\n    /** Current playback state. */\n    readonly state: SoundState;\n    /** Number of live instances. */\n    readonly instanceCount: number;\n    /** Fires when the sound finishes (all instances ended). */\n    readonly onEnded: AudioSignal<StaticSound>;\n\n    /** @internal */ _engine: AudioEngine;\n    /** @internal */ _buffer: SoundBuffer;\n    /** @internal */ _graph: SoundSubGraph;\n    /** @internal */ _outBus: PrimaryAudioBus;\n    /** @internal */ _options: StoredOptions;\n    /** @internal */ _instances: Set<SoundInstance>;\n    /** @internal */ _newest: SoundInstance | null;\n    /** @internal */ _state: SoundState;\n    /** @internal */ _onEnded: AudioSignalImpl<StaticSound>;\n    /** @internal */ _dispose(): void;\n}\n\n/** A single in-flight playback of a {@link StaticSound}. @internal */\nexport interface SoundInstance {\n    /** @internal */ _sound: StaticSound;\n    /** @internal */ _engine: AudioEngine;\n    /** @internal */ _options: { duration: number; loop: boolean; loopEnd: number; loopStart: number; startOffset: number };\n    /** @internal */ _volumeNode: GainNode;\n    /** @internal */ _sourceNode: AudioBufferSourceNode | null;\n    /** @internal */ _state: SoundState;\n    /** @internal */ _enginePlayTime: number;\n    /** @internal */ _enginePauseTime: number;\n    /** @internal */ _isConnected: boolean;\n    /** @internal */ _pitch: RampParam | null;\n    /** @internal */ _playbackRate: RampParam | null;\n    /** @internal */ _engineStateUnsub: (() => void) | null;\n    /** @internal */ _onEnded: AudioSignalImpl<SoundInstance>;\n    /** @internal */ _onStateChanged: AudioSignalImpl<SoundInstance>;\n    /** @internal */ _endedHandler: () => void;\n    /** @internal */ _engineStateHandler: () => void;\n}\n\n/**\n * Creates a buffer-backed sound, routed to the given output bus (or the\n * engine's default main bus).\n * @param engine - The audio engine.\n * @param source - An `AudioBuffer`, `ArrayBuffer`, URL, URL list, or `SoundBuffer`.\n * @param options - Sound options.\n * @returns A promise that resolves with the ready sound.\n */\nexport async function createSoundAsync(engine: AudioEngine, source: SoundSource, options: StaticSoundOptions = {}): Promise<StaticSound> {\n    const buffer = await createSoundBufferAsync(engine, source, options);\n    const graph = createSoundSubGraph(engine._ctx, engine, options.volume ?? 1);\n    const outBus = options.outBus ?? engine._mainBus;\n    connectSoundSubGraph(graph, getBusInputNode(outBus));\n\n    const onEnded = createAudioSignal<StaticSound>();\n\n    const sound: StaticSound = {\n        get state() {\n            return sound._state;\n        },\n        get instanceCount() {\n            return sound._instances.size;\n        },\n        get buffer() {\n            return sound._buffer;\n        },\n        get onEnded(): AudioSignal<StaticSound> {\n            return onEnded;\n        },\n        _engine: engine,\n        _buffer: buffer,\n        _graph: graph,\n        _outBus: outBus,\n        _options: {\n            autoplay: options.autoplay ?? false,\n            duration: options.duration ?? 0,\n            loop: options.loop ?? false,\n            loopEnd: options.loopEnd ?? 0,\n            loopStart: options.loopStart ?? 0,\n            maxInstances: options.maxInstances ?? Infinity,\n            pitch: options.pitch ?? 0,\n            playbackRate: options.playbackRate ?? 1,\n            startOffset: options.startOffset ?? 0,\n        },\n        _instances: new Set<SoundInstance>(),\n        _newest: null,\n        _state: SoundState.Stopped,\n        _onEnded: onEnded,\n        _dispose: () => disposeSound(sound),\n    };\n\n    engine._sounds.add(sound);\n\n    if (sound._options.autoplay) {\n        playSound(sound);\n    }\n\n    return sound;\n}\n\n/** Sets the sound's output volume, optionally ramping. */\nexport function setSoundVolume(sound: StaticSound, value: number, options?: RampOptions): void {\n    setSoundSubGraphVolume(sound._graph, value, options);\n}\n\n/**\n * Plays the sound. Spawns a new instance per call (subject to `maxInstances`).\n * A paused sound is resumed instead.\n * @param sound - The sound to play.\n * @param options - Per-play overrides.\n */\nexport function playSound(sound: StaticSound, options: StaticSoundPlayOptions = {}): void {\n    if (sound._state === SoundState.Paused) {\n        resumeSound(sound, options);\n        return;\n    }\n\n    const opts: Required<StaticSoundPlayOptions> = {\n        duration: options.duration ?? sound._options.duration,\n        loop: options.loop ?? sound._options.loop,\n        loopStart: options.loopStart ?? sound._options.loopStart,\n        loopEnd: options.loopEnd ?? sound._options.loopEnd,\n        startOffset: options.startOffset ?? sound._options.startOffset,\n        volume: options.volume ?? 1,\n        waitTime: options.waitTime ?? 0,\n    };\n\n    const instance = _createInstance(sound);\n    instance._onEnded.addOnce(instance._endedHandler);\n    sound._instances.add(instance);\n    sound._newest = instance;\n\n    _instancePlay(instance, opts);\n\n    sound._state = instance._state;\n    _stopExcessInstances(sound);\n}\n\n/** Pauses all of the sound's instances. */\nexport function pauseSound(sound: StaticSound): void {\n    for (const instance of sound._instances) {\n        _instancePause(instance);\n    }\n    sound._state = SoundState.Paused;\n}\n\n/** Resumes a paused sound. */\nexport function resumeSound(sound: StaticSound, options: StaticSoundPlayOptions = {}): void {\n    if (sound._state !== SoundState.Paused) {\n        return;\n    }\n    for (const instance of sound._instances) {\n        _instanceResume(instance, options);\n    }\n    sound._state = SoundState.Started;\n}\n\n/** Stops the sound (and all its instances). */\nexport function stopSound(sound: StaticSound, options: StaticSoundStopOptions = {}): void {\n    sound._state = options.waitTime && options.waitTime > 0 ? SoundState.Stopping : SoundState.Stopped;\n    for (const instance of Array.from(sound._instances)) {\n        _instanceStop(instance, options);\n    }\n}\n\n/** Disposes the sound, stopping playback and releasing its graph. */\nexport function disposeSound(sound: StaticSound): void {\n    stopSound(sound);\n    for (const instance of Array.from(sound._instances)) {\n        _instanceDispose(instance);\n    }\n    sound._instances.clear();\n    disposeSoundSubGraph(sound._graph);\n    sound._onEnded._clear();\n    sound._engine._sounds.delete(sound);\n}\n\nfunction _stopExcessInstances(sound: StaticSound): void {\n    if (sound._options.maxInstances < Infinity) {\n        const started = Array.from(sound._instances).filter((i) => i._state === SoundState.Started);\n        const toStop = started.length - sound._options.maxInstances;\n        for (let i = 0; i < toStop; i++) {\n            _instanceStop(started[i]!);\n        }\n    }\n}\n\nfunction _onInstanceEnded(sound: StaticSound, instance: SoundInstance): void {\n    if (sound._newest === instance) {\n        sound._newest = null;\n    }\n    sound._instances.delete(instance);\n    if (sound._instances.size === 0) {\n        sound._state = SoundState.Stopped;\n        sound._onEnded._notify(sound);\n    }\n    _instanceDispose(instance);\n}\n\n// --- Instance ---------------------------------------------------------------\n\nfunction _createInstance(sound: StaticSound): SoundInstance {\n    const engine = sound._engine;\n    const instance: SoundInstance = {\n        _sound: sound,\n        _engine: engine,\n        _options: {\n            duration: sound._options.duration,\n            loop: sound._options.loop,\n            loopEnd: sound._options.loopEnd,\n            loopStart: sound._options.loopStart,\n            startOffset: sound._options.startOffset,\n        },\n        _volumeNode: new GainNode(engine._ctx),\n        _sourceNode: null,\n        _state: SoundState.Stopped,\n        _enginePlayTime: 0,\n        _enginePauseTime: 0,\n        _isConnected: false,\n        _pitch: null,\n        _playbackRate: null,\n        _engineStateUnsub: null,\n        _onEnded: createAudioSignal<SoundInstance>(),\n        _onStateChanged: createAudioSignal<SoundInstance>(),\n        _endedHandler: () => _onInstanceEnded(sound, instance),\n        _engineStateHandler: () => _onEngineStateChanged(instance),\n    };\n    return instance;\n}\n\nfunction _setInstanceState(instance: SoundInstance, state: SoundState): void {\n    instance._state = state;\n    instance._onStateChanged._notify(instance);\n}\n\nfunction _instancePlay(instance: SoundInstance, options: Required<StaticSoundPlayOptions>): void {\n    if (instance._state === SoundState.Started) {\n        return;\n    }\n\n    instance._options.duration = options.duration;\n    instance._options.loop = options.loop;\n    instance._options.loopStart = options.loopStart;\n    instance._options.loopEnd = options.loopEnd;\n    instance._options.startOffset = options.startOffset;\n\n    let startOffset = instance._options.startOffset;\n    if (instance._state === SoundState.Paused) {\n        startOffset += instance._enginePauseTime;\n        startOffset %= instance._sound._buffer.duration;\n    }\n\n    instance._enginePlayTime = instance._engine.currentTime + options.waitTime;\n\n    if (options.volume !== undefined) {\n        instance._volumeNode.gain.value = options.volume;\n    }\n\n    _initSourceNode(instance);\n\n    if (instance._engine.state === \"running\") {\n        _setInstanceState(instance, SoundState.Started);\n        instance._sourceNode?.start(instance._enginePlayTime, startOffset, instance._options.duration > 0 ? instance._options.duration : undefined);\n    } else if (instance._options.loop) {\n        _setInstanceState(instance, SoundState.Starting);\n        instance._engineStateUnsub = instance._engine.onStateChanged.add(instance._engineStateHandler);\n    }\n}\n\nfunction _instancePause(instance: SoundInstance): void {\n    if (instance._state !== SoundState.Started && instance._state !== SoundState.Starting) {\n        return;\n    }\n\n    const wasStarted = instance._state === SoundState.Started;\n    _setInstanceState(instance, SoundState.Paused);\n    instance._enginePauseTime += instance._engine.currentTime - instance._enginePlayTime;\n\n    if (wasStarted) {\n        instance._sourceNode?.stop();\n    } else {\n        instance._engineStateUnsub?.();\n        instance._engineStateUnsub = null;\n    }\n\n    _deinitSourceNode(instance);\n}\n\nfunction _instanceResume(instance: SoundInstance, options: StaticSoundPlayOptions): void {\n    if (instance._state === SoundState.Paused) {\n        const opts: Required<StaticSoundPlayOptions> = {\n            duration: options.duration ?? instance._options.duration,\n            loop: options.loop ?? instance._options.loop,\n            loopStart: options.loopStart ?? instance._options.loopStart,\n            loopEnd: options.loopEnd ?? instance._options.loopEnd,\n            startOffset: options.startOffset ?? instance._options.startOffset,\n            volume: options.volume ?? instance._volumeNode.gain.value,\n            waitTime: options.waitTime ?? 0,\n        };\n        _instancePlay(instance, opts);\n    }\n}\n\nfunction _instanceStop(instance: SoundInstance, options: StaticSoundStopOptions = {}): void {\n    if (instance._state === SoundState.Stopped) {\n        return;\n    }\n\n    if (instance._state === SoundState.Started) {\n        const stopTime = instance._engine.currentTime + (options.waitTime ?? 0);\n        instance._sourceNode?.stop(stopTime);\n    }\n\n    if (options.waitTime === undefined || options.waitTime <= 0) {\n        _setInstanceState(instance, SoundState.Stopped);\n        instance._engineStateUnsub?.();\n        instance._engineStateUnsub = null;\n    }\n}\n\nfunction _instanceDispose(instance: SoundInstance): void {\n    _instanceStop(instance);\n    _deinitSourceNode(instance);\n    instance._engineStateUnsub?.();\n    instance._engineStateUnsub = null;\n    instance._pitch = null;\n    instance._playbackRate = null;\n    instance._onEnded._clear();\n    instance._onStateChanged._clear();\n}\n\nfunction _onEngineStateChanged(instance: SoundInstance): void {\n    if (instance._engine.state !== \"running\") {\n        return;\n    }\n    if (instance._options.loop && instance._state === SoundState.Starting) {\n        const opts: Required<StaticSoundPlayOptions> = {\n            duration: instance._options.duration,\n            loop: instance._options.loop,\n            loopStart: instance._options.loopStart,\n            loopEnd: instance._options.loopEnd,\n            startOffset: instance._options.startOffset,\n            volume: instance._volumeNode.gain.value,\n            waitTime: 0,\n        };\n        // Reset to a non-started state so `_instancePlay` proceeds.\n        instance._state = SoundState.Stopped;\n        _instancePlay(instance, opts);\n    }\n}\n\nfunction _onInstanceEndedEvent(instance: SoundInstance): void {\n    instance._enginePlayTime = 0;\n    if (instance._state !== SoundState.Paused) {\n        instance._onEnded._notify(instance);\n    }\n    _deinitSourceNode(instance);\n}\n\nfunction _initSourceNode(instance: SoundInstance): void {\n    const sound = instance._sound;\n    if (!instance._sourceNode) {\n        const sourceNode = new AudioBufferSourceNode(instance._engine._ctx, { buffer: sound._buffer._audioBuffer });\n        instance._sourceNode = sourceNode;\n\n        sourceNode.addEventListener(\"ended\", () => _onInstanceEndedEvent(instance), { once: true });\n        sourceNode.connect(instance._volumeNode);\n\n        // Connect this instance's output into the sound's sub-graph input.\n        instance._volumeNode.connect(sound._graph._in);\n        instance._isConnected = true;\n\n        instance._pitch = createRampParam(sourceNode.detune, instance._engine);\n        instance._playbackRate = createRampParam(sourceNode.playbackRate, instance._engine);\n    }\n\n    const node = instance._sourceNode;\n    node.detune.value = sound._options.pitch;\n    node.loop = instance._options.loop;\n    node.loopEnd = instance._options.loopEnd;\n    node.loopStart = instance._options.loopStart;\n    node.playbackRate.value = sound._options.playbackRate;\n}\n\nfunction _deinitSourceNode(instance: SoundInstance): void {\n    const node = instance._sourceNode;\n    if (!node) {\n        return;\n    }\n\n    if (instance._isConnected) {\n        instance._volumeNode.disconnect(instance._sound._graph._in);\n        instance._isConnected = false;\n    }\n\n    node.disconnect(instance._volumeNode);\n    instance._sourceNode = null;\n}\n\n/**\n * Sets the detune (pitch) of the newest instance, in cents.\n * Provided for completeness; ramps via the instance's detune param.\n * @internal\n */\nexport function _setNewestInstancePitch(sound: StaticSound, value: number, options?: RampOptions): void {\n    const instance = sound._newest;\n    if (instance?._pitch) {\n        setRampTarget(instance._pitch, value, options);\n    }\n}\n"],"names":[],"mappings":";;;;;;AAwBO,MAAM,UAAA,GAAa;AAAA,EACtB,QAAA,EAAU,CAAA;AAAA,EACV,OAAA,EAAS,CAAA;AAAA,EACT,QAAA,EAAU,CAAA;AAAA,EACV,OAAA,EAAS,CAAA;AAAA,EACT,aAAA,EAAe,CAAA;AAAA,EACf,MAAA,EAAQ;AACZ;AAsHA,eAAsB,gBAAA,CAAiB,MAAA,EAAqB,MAAA,EAAqB,OAAA,GAA8B,EAAC,EAAyB;AACrI,EAAA,MAAM,MAAA,GAAS,MAAM,sBAAA,CAAuB,MAAA,EAAQ,QAAQ,OAAO,CAAA;AACnE,EAAA,MAAM,QAAQ,mBAAA,CAAoB,MAAA,CAAO,MAAM,MAAA,EAAQ,OAAA,CAAQ,UAAU,CAAC,CAAA;AAC1E,EAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,IAAU,MAAA,CAAO,QAAA;AACxC,EAAA,oBAAA,CAAqB,KAAA,EAAO,eAAA,CAAgB,MAAM,CAAC,CAAA;AAEnD,EAAA,MAAM,UAAU,iBAAA,EAA+B;AAE/C,EAAA,MAAM,KAAA,GAAqB;AAAA,IACvB,IAAI,KAAA,GAAQ;AACR,MAAA,OAAO,KAAA,CAAM,MAAA;AAAA,IACjB,CAAA;AAAA,IACA,IAAI,aAAA,GAAgB;AAChB,MAAA,OAAO,MAAM,UAAA,CAAW,IAAA;AAAA,IAC5B,CAAA;AAAA,IACA,IAAI,MAAA,GAAS;AACT,MAAA,OAAO,KAAA,CAAM,OAAA;AAAA,IACjB,CAAA;AAAA,IACA,IAAI,OAAA,GAAoC;AACpC,MAAA,OAAO,OAAA;AAAA,IACX,CAAA;AAAA,IACA,OAAA,EAAS,MAAA;AAAA,IACT,OAAA,EAAS,MAAA;AAAA,IACT,MAAA,EAAQ,KAAA;AAAA,IACR,OAAA,EAAS,MAAA;AAAA,IACT,QAAA,EAAU;AAAA,MACN,QAAA,EAAU,QAAQ,QAAA,IAAY,KAAA;AAAA,MAC9B,QAAA,EAAU,QAAQ,QAAA,IAAY,CAAA;AAAA,MAC9B,IAAA,EAAM,QAAQ,IAAA,IAAQ,KAAA;AAAA,MACtB,OAAA,EAAS,QAAQ,OAAA,IAAW,CAAA;AAAA,MAC5B,SAAA,EAAW,QAAQ,SAAA,IAAa,CAAA;AAAA,MAChC,YAAA,EAAc,QAAQ,YAAA,IAAgB,QAAA;AAAA,MACtC,KAAA,EAAO,QAAQ,KAAA,IAAS,CAAA;AAAA,MACxB,YAAA,EAAc,QAAQ,YAAA,IAAgB,CAAA;AAAA,MACtC,WAAA,EAAa,QAAQ,WAAA,IAAe;AAAA,KACxC;AAAA,IACA,UAAA,sBAAgB,GAAA,EAAmB;AAAA,IACnC,OAAA,EAAS,IAAA;AAAA,IACT,QAAQ,UAAA,CAAW,OAAA;AAAA,IACnB,QAAA,EAAU,OAAA;AAAA,IACV,QAAA,EAAU,MAAM,YAAA,CAAa,KAAK;AAAA,GACtC;AAEA,EAAA,MAAA,CAAO,OAAA,CAAQ,IAAI,KAAK,CAAA;AAExB,EAAA,IAAI,KAAA,CAAM,SAAS,QAAA,EAAU;AACzB,IAAA,SAAA,CAAU,KAAK,CAAA;AAAA,EACnB;AAEA,EAAA,OAAO,KAAA;AACX;AAGO,SAAS,cAAA,CAAe,KAAA,EAAoB,KAAA,EAAe,OAAA,EAA6B;AAC3F,EAAA,sBAAA,CAAuB,KAAA,CAAM,MAAA,EAAQ,KAAA,EAAO,OAAO,CAAA;AACvD;AAQO,SAAS,SAAA,CAAU,KAAA,EAAoB,OAAA,GAAkC,EAAC,EAAS;AACtF,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,UAAA,CAAW,MAAA,EAAQ;AACpC,IAAA,WAAA,CAAY,OAAO,OAAO,CAAA;AAC1B,IAAA;AAAA,EACJ;AAEA,EAAA,MAAM,IAAA,GAAyC;AAAA,IAC3C,QAAA,EAAU,OAAA,CAAQ,QAAA,IAAY,KAAA,CAAM,QAAA,CAAS,QAAA;AAAA,IAC7C,IAAA,EAAM,OAAA,CAAQ,IAAA,IAAQ,KAAA,CAAM,QAAA,CAAS,IAAA;AAAA,IACrC,SAAA,EAAW,OAAA,CAAQ,SAAA,IAAa,KAAA,CAAM,QAAA,CAAS,SAAA;AAAA,IAC/C,OAAA,EAAS,OAAA,CAAQ,OAAA,IAAW,KAAA,CAAM,QAAA,CAAS,OAAA;AAAA,IAC3C,WAAA,EAAa,OAAA,CAAQ,WAAA,IAAe,KAAA,CAAM,QAAA,CAAS,WAAA;AAAA,IACnD,MAAA,EAAQ,QAAQ,MAAA,IAAU,CAAA;AAAA,IAC1B,QAAA,EAAU,QAAQ,QAAA,IAAY;AAAA,GAClC;AAEA,EAAA,MAAM,QAAA,GAAW,gBAAgB,KAAK,CAAA;AACtC,EAAA,QAAA,CAAS,QAAA,CAAS,OAAA,CAAQ,QAAA,CAAS,aAAa,CAAA;AAChD,EAAA,KAAA,CAAM,UAAA,CAAW,IAAI,QAAQ,CAAA;AAC7B,EAAA,KAAA,CAAM,OAAA,GAAU,QAAA;AAEhB,EAAA,aAAA,CAAc,UAAU,IAAI,CAAA;AAE5B,EAAA,KAAA,CAAM,SAAS,QAAA,CAAS,MAAA;AACxB,EAAA,oBAAA,CAAqB,KAAK,CAAA;AAC9B;AAGO,SAAS,WAAW,KAAA,EAA0B;AACjD,EAAA,KAAA,MAAW,QAAA,IAAY,MAAM,UAAA,EAAY;AACrC,IAAA,cAAA,CAAe,QAAQ,CAAA;AAAA,EAC3B;AACA,EAAA,KAAA,CAAM,SAAS,UAAA,CAAW,MAAA;AAC9B;AAGO,SAAS,WAAA,CAAY,KAAA,EAAoB,OAAA,GAAkC,EAAC,EAAS;AACxF,EAAA,IAAI,KAAA,CAAM,MAAA,KAAW,UAAA,CAAW,MAAA,EAAQ;AACpC,IAAA;AAAA,EACJ;AACA,EAAA,KAAA,MAAW,QAAA,IAAY,MAAM,UAAA,EAAY;AACrC,IAAA,eAAA,CAAgB,UAAU,OAAO,CAAA;AAAA,EACrC;AACA,EAAA,KAAA,CAAM,SAAS,UAAA,CAAW,OAAA;AAC9B;AAGO,SAAS,SAAA,CAAU,KAAA,EAAoB,OAAA,GAAkC,EAAC,EAAS;AACtF,EAAA,KAAA,CAAM,MAAA,GAAS,QAAQ,QAAA,IAAY,OAAA,CAAQ,WAAW,CAAA,GAAI,UAAA,CAAW,WAAW,UAAA,CAAW,OAAA;AAC3F,EAAA,KAAA,MAAW,QAAA,IAAY,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA,EAAG;AACjD,IAAA,aAAA,CAAc,UAAU,OAAO,CAAA;AAAA,EACnC;AACJ;AAGO,SAAS,aAAa,KAAA,EAA0B;AACnD,EAAA,SAAA,CAAU,KAAK,CAAA;AACf,EAAA,KAAA,MAAW,QAAA,IAAY,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA,EAAG;AACjD,IAAA,gBAAA,CAAiB,QAAQ,CAAA;AAAA,EAC7B;AACA,EAAA,KAAA,CAAM,WAAW,KAAA,EAAM;AACvB,EAAA,oBAAA,CAAqB,MAAM,MAAM,CAAA;AACjC,EAAA,KAAA,CAAM,SAAS,MAAA,EAAO;AACtB,EAAA,KAAA,CAAM,OAAA,CAAQ,OAAA,CAAQ,MAAA,CAAO,KAAK,CAAA;AACtC;AAEA,SAAS,qBAAqB,KAAA,EAA0B;AACpD,EAAA,IAAI,KAAA,CAAM,QAAA,CAAS,YAAA,GAAe,QAAA,EAAU;AACxC,IAAA,MAAM,OAAA,GAAU,KAAA,CAAM,IAAA,CAAK,KAAA,CAAM,UAAU,CAAA,CAAE,MAAA,CAAO,CAAC,CAAA,KAAM,CAAA,CAAE,MAAA,KAAW,UAAA,CAAW,OAAO,CAAA;AAC1F,IAAA,MAAM,MAAA,GAAS,OAAA,CAAQ,MAAA,GAAS,KAAA,CAAM,QAAA,CAAS,YAAA;AAC/C,IAAA,KAAA,IAAS,CAAA,GAAI,CAAA,EAAG,CAAA,GAAI,MAAA,EAAQ,CAAA,EAAA,EAAK;AAC7B,MAAA,aAAA,CAAc,OAAA,CAAQ,CAAC,CAAE,CAAA;AAAA,IAC7B;AAAA,EACJ;AACJ;AAEA,SAAS,gBAAA,CAAiB,OAAoB,QAAA,EAA+B;AACzE,EAAA,IAAI,KAAA,CAAM,YAAY,QAAA,EAAU;AAC5B,IAAA,KAAA,CAAM,OAAA,GAAU,IAAA;AAAA,EACpB;AACA,EAAA,KAAA,CAAM,UAAA,CAAW,OAAO,QAAQ,CAAA;AAChC,EAAA,IAAI,KAAA,CAAM,UAAA,CAAW,IAAA,KAAS,CAAA,EAAG;AAC7B,IAAA,KAAA,CAAM,SAAS,UAAA,CAAW,OAAA;AAC1B,IAAA,KAAA,CAAM,QAAA,CAAS,QAAQ,KAAK,CAAA;AAAA,EAChC;AACA,EAAA,gBAAA,CAAiB,QAAQ,CAAA;AAC7B;AAIA,SAAS,gBAAgB,KAAA,EAAmC;AACxD,EAAA,MAAM,SAAS,KAAA,CAAM,OAAA;AACrB,EAAA,MAAM,QAAA,GAA0B;AAAA,IAC5B,MAAA,EAAQ,KAAA;AAAA,IACR,OAAA,EAAS,MAAA;AAAA,IACT,QAAA,EAAU;AAAA,MACN,QAAA,EAAU,MAAM,QAAA,CAAS,QAAA;AAAA,MACzB,IAAA,EAAM,MAAM,QAAA,CAAS,IAAA;AAAA,MACrB,OAAA,EAAS,MAAM,QAAA,CAAS,OAAA;AAAA,MACxB,SAAA,EAAW,MAAM,QAAA,CAAS,SAAA;AAAA,MAC1B,WAAA,EAAa,MAAM,QAAA,CAAS;AAAA,KAChC;AAAA,IACA,WAAA,EAAa,IAAI,QAAA,CAAS,MAAA,CAAO,IAAI,CAAA;AAAA,IACrC,WAAA,EAAa,IAAA;AAAA,IACb,QAAQ,UAAA,CAAW,OAAA;AAAA,IACnB,eAAA,EAAiB,CAAA;AAAA,IACjB,gBAAA,EAAkB,CAAA;AAAA,IAClB,YAAA,EAAc,KAAA;AAAA,IACd,MAAA,EAAQ,IAAA;AAAA,IACR,aAAA,EAAe,IAAA;AAAA,IACf,iBAAA,EAAmB,IAAA;AAAA,IACnB,UAAU,iBAAA,EAAiC;AAAA,IAC3C,iBAAiB,iBAAA,EAAiC;AAAA,IAClD,aAAA,EAAe,MAAM,gBAAA,CAAiB,KAAA,EAAO,QAAQ,CAAA;AAAA,IACrD,mBAAA,EAAqB,MAAM,qBAAA,CAAsB,QAAQ;AAAA,GAC7D;AACA,EAAA,OAAO,QAAA;AACX;AAEA,SAAS,iBAAA,CAAkB,UAAyB,KAAA,EAAyB;AACzE,EAAA,QAAA,CAAS,MAAA,GAAS,KAAA;AAClB,EAAA,QAAA,CAAS,eAAA,CAAgB,QAAQ,QAAQ,CAAA;AAC7C;AAEA,SAAS,aAAA,CAAc,UAAyB,OAAA,EAAiD;AAC7F,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,OAAA,EAAS;AACxC,IAAA;AAAA,EACJ;AAEA,EAAA,QAAA,CAAS,QAAA,CAAS,WAAW,OAAA,CAAQ,QAAA;AACrC,EAAA,QAAA,CAAS,QAAA,CAAS,OAAO,OAAA,CAAQ,IAAA;AACjC,EAAA,QAAA,CAAS,QAAA,CAAS,YAAY,OAAA,CAAQ,SAAA;AACtC,EAAA,QAAA,CAAS,QAAA,CAAS,UAAU,OAAA,CAAQ,OAAA;AACpC,EAAA,QAAA,CAAS,QAAA,CAAS,cAAc,OAAA,CAAQ,WAAA;AAExC,EAAA,IAAI,WAAA,GAAc,SAAS,QAAA,CAAS,WAAA;AACpC,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,MAAA,EAAQ;AACvC,IAAA,WAAA,IAAe,QAAA,CAAS,gBAAA;AACxB,IAAA,WAAA,IAAe,QAAA,CAAS,OAAO,OAAA,CAAQ,QAAA;AAAA,EAC3C;AAEA,EAAA,QAAA,CAAS,eAAA,GAAkB,QAAA,CAAS,OAAA,CAAQ,WAAA,GAAc,OAAA,CAAQ,QAAA;AAElE,EAAA,IAAI,OAAA,CAAQ,WAAW,MAAA,EAAW;AAC9B,IAAA,QAAA,CAAS,WAAA,CAAY,IAAA,CAAK,KAAA,GAAQ,OAAA,CAAQ,MAAA;AAAA,EAC9C;AAEA,EAAA,eAAA,CAAgB,QAAQ,CAAA;AAExB,EAAA,IAAI,QAAA,CAAS,OAAA,CAAQ,KAAA,KAAU,SAAA,EAAW;AACtC,IAAA,iBAAA,CAAkB,QAAA,EAAU,WAAW,OAAO,CAAA;AAC9C,IAAA,QAAA,CAAS,WAAA,EAAa,KAAA,CAAM,QAAA,CAAS,eAAA,EAAiB,WAAA,EAAa,QAAA,CAAS,QAAA,CAAS,QAAA,GAAW,CAAA,GAAI,QAAA,CAAS,QAAA,CAAS,QAAA,GAAW,MAAS,CAAA;AAAA,EAC9I,CAAA,MAAA,IAAW,QAAA,CAAS,QAAA,CAAS,IAAA,EAAM;AAC/B,IAAA,iBAAA,CAAkB,QAAA,EAAU,WAAW,QAAQ,CAAA;AAC/C,IAAA,QAAA,CAAS,oBAAoB,QAAA,CAAS,OAAA,CAAQ,cAAA,CAAe,GAAA,CAAI,SAAS,mBAAmB,CAAA;AAAA,EACjG;AACJ;AAEA,SAAS,eAAe,QAAA,EAA+B;AACnD,EAAA,IAAI,SAAS,MAAA,KAAW,UAAA,CAAW,WAAW,QAAA,CAAS,MAAA,KAAW,WAAW,QAAA,EAAU;AACnF,IAAA;AAAA,EACJ;AAEA,EAAA,MAAM,UAAA,GAAa,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,OAAA;AAClD,EAAA,iBAAA,CAAkB,QAAA,EAAU,WAAW,MAAM,CAAA;AAC7C,EAAA,QAAA,CAAS,gBAAA,IAAoB,QAAA,CAAS,OAAA,CAAQ,WAAA,GAAc,QAAA,CAAS,eAAA;AAErE,EAAA,IAAI,UAAA,EAAY;AACZ,IAAA,QAAA,CAAS,aAAa,IAAA,EAAK;AAAA,EAC/B,CAAA,MAAO;AACH,IAAA,QAAA,CAAS,iBAAA,IAAoB;AAC7B,IAAA,QAAA,CAAS,iBAAA,GAAoB,IAAA;AAAA,EACjC;AAEA,EAAA,iBAAA,CAAkB,QAAQ,CAAA;AAC9B;AAEA,SAAS,eAAA,CAAgB,UAAyB,OAAA,EAAuC;AACrF,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,MAAA,EAAQ;AACvC,IAAA,MAAM,IAAA,GAAyC;AAAA,MAC3C,QAAA,EAAU,OAAA,CAAQ,QAAA,IAAY,QAAA,CAAS,QAAA,CAAS,QAAA;AAAA,MAChD,IAAA,EAAM,OAAA,CAAQ,IAAA,IAAQ,QAAA,CAAS,QAAA,CAAS,IAAA;AAAA,MACxC,SAAA,EAAW,OAAA,CAAQ,SAAA,IAAa,QAAA,CAAS,QAAA,CAAS,SAAA;AAAA,MAClD,OAAA,EAAS,OAAA,CAAQ,OAAA,IAAW,QAAA,CAAS,QAAA,CAAS,OAAA;AAAA,MAC9C,WAAA,EAAa,OAAA,CAAQ,WAAA,IAAe,QAAA,CAAS,QAAA,CAAS,WAAA;AAAA,MACtD,MAAA,EAAQ,OAAA,CAAQ,MAAA,IAAU,QAAA,CAAS,YAAY,IAAA,CAAK,KAAA;AAAA,MACpD,QAAA,EAAU,QAAQ,QAAA,IAAY;AAAA,KAClC;AACA,IAAA,aAAA,CAAc,UAAU,IAAI,CAAA;AAAA,EAChC;AACJ;AAEA,SAAS,aAAA,CAAc,QAAA,EAAyB,OAAA,GAAkC,EAAC,EAAS;AACxF,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,OAAA,EAAS;AACxC,IAAA;AAAA,EACJ;AAEA,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,OAAA,EAAS;AACxC,IAAA,MAAM,QAAA,GAAW,QAAA,CAAS,OAAA,CAAQ,WAAA,IAAe,QAAQ,QAAA,IAAY,CAAA,CAAA;AACrE,IAAA,QAAA,CAAS,WAAA,EAAa,KAAK,QAAQ,CAAA;AAAA,EACvC;AAEA,EAAA,IAAI,OAAA,CAAQ,QAAA,KAAa,MAAA,IAAa,OAAA,CAAQ,YAAY,CAAA,EAAG;AACzD,IAAA,iBAAA,CAAkB,QAAA,EAAU,WAAW,OAAO,CAAA;AAC9C,IAAA,QAAA,CAAS,iBAAA,IAAoB;AAC7B,IAAA,QAAA,CAAS,iBAAA,GAAoB,IAAA;AAAA,EACjC;AACJ;AAEA,SAAS,iBAAiB,QAAA,EAA+B;AACrD,EAAA,aAAA,CAAc,QAAQ,CAAA;AACtB,EAAA,iBAAA,CAAkB,QAAQ,CAAA;AAC1B,EAAA,QAAA,CAAS,iBAAA,IAAoB;AAC7B,EAAA,QAAA,CAAS,iBAAA,GAAoB,IAAA;AAC7B,EAAA,QAAA,CAAS,MAAA,GAAS,IAAA;AAClB,EAAA,QAAA,CAAS,aAAA,GAAgB,IAAA;AACzB,EAAA,QAAA,CAAS,SAAS,MAAA,EAAO;AACzB,EAAA,QAAA,CAAS,gBAAgB,MAAA,EAAO;AACpC;AAEA,SAAS,sBAAsB,QAAA,EAA+B;AAC1D,EAAA,IAAI,QAAA,CAAS,OAAA,CAAQ,KAAA,KAAU,SAAA,EAAW;AACtC,IAAA;AAAA,EACJ;AACA,EAAA,IAAI,SAAS,QAAA,CAAS,IAAA,IAAQ,QAAA,CAAS,MAAA,KAAW,WAAW,QAAA,EAAU;AACnE,IAAA,MAAM,IAAA,GAAyC;AAAA,MAC3C,QAAA,EAAU,SAAS,QAAA,CAAS,QAAA;AAAA,MAC5B,IAAA,EAAM,SAAS,QAAA,CAAS,IAAA;AAAA,MACxB,SAAA,EAAW,SAAS,QAAA,CAAS,SAAA;AAAA,MAC7B,OAAA,EAAS,SAAS,QAAA,CAAS,OAAA;AAAA,MAC3B,WAAA,EAAa,SAAS,QAAA,CAAS,WAAA;AAAA,MAC/B,MAAA,EAAQ,QAAA,CAAS,WAAA,CAAY,IAAA,CAAK,KAAA;AAAA,MAClC,QAAA,EAAU;AAAA,KACd;AAEA,IAAA,QAAA,CAAS,SAAS,UAAA,CAAW,OAAA;AAC7B,IAAA,aAAA,CAAc,UAAU,IAAI,CAAA;AAAA,EAChC;AACJ;AAEA,SAAS,sBAAsB,QAAA,EAA+B;AAC1D,EAAA,QAAA,CAAS,eAAA,GAAkB,CAAA;AAC3B,EAAA,IAAI,QAAA,CAAS,MAAA,KAAW,UAAA,CAAW,MAAA,EAAQ;AACvC,IAAA,QAAA,CAAS,QAAA,CAAS,QAAQ,QAAQ,CAAA;AAAA,EACtC;AACA,EAAA,iBAAA,CAAkB,QAAQ,CAAA;AAC9B;AAEA,SAAS,gBAAgB,QAAA,EAA+B;AACpD,EAAA,MAAM,QAAQ,QAAA,CAAS,MAAA;AACvB,EAAA,IAAI,CAAC,SAAS,WAAA,EAAa;AACvB,IAAA,MAAM,UAAA,GAAa,IAAI,qBAAA,CAAsB,QAAA,CAAS,OAAA,CAAQ,IAAA,EAAM,EAAE,MAAA,EAAQ,KAAA,CAAM,OAAA,CAAQ,YAAA,EAAc,CAAA;AAC1G,IAAA,QAAA,CAAS,WAAA,GAAc,UAAA;AAEvB,IAAA,UAAA,CAAW,gBAAA,CAAiB,SAAS,MAAM,qBAAA,CAAsB,QAAQ,CAAA,EAAG,EAAE,IAAA,EAAM,IAAA,EAAM,CAAA;AAC1F,IAAA,UAAA,CAAW,OAAA,CAAQ,SAAS,WAAW,CAAA;AAGvC,IAAA,QAAA,CAAS,WAAA,CAAY,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,GAAG,CAAA;AAC7C,IAAA,QAAA,CAAS,YAAA,GAAe,IAAA;AAExB,IAAA,QAAA,CAAS,MAAA,GAAS,eAAA,CAAgB,UAAA,CAAW,MAAA,EAAQ,SAAS,OAAO,CAAA;AACrE,IAAA,QAAA,CAAS,aAAA,GAAgB,eAAA,CAAgB,UAAA,CAAW,YAAA,EAAc,SAAS,OAAO,CAAA;AAAA,EACtF;AAEA,EAAA,MAAM,OAAO,QAAA,CAAS,WAAA;AACtB,EAAA,IAAA,CAAK,MAAA,CAAO,KAAA,GAAQ,KAAA,CAAM,QAAA,CAAS,KAAA;AACnC,EAAA,IAAA,CAAK,IAAA,GAAO,SAAS,QAAA,CAAS,IAAA;AAC9B,EAAA,IAAA,CAAK,OAAA,GAAU,SAAS,QAAA,CAAS,OAAA;AACjC,EAAA,IAAA,CAAK,SAAA,GAAY,SAAS,QAAA,CAAS,SAAA;AACnC,EAAA,IAAA,CAAK,YAAA,CAAa,KAAA,GAAQ,KAAA,CAAM,QAAA,CAAS,YAAA;AAC7C;AAEA,SAAS,kBAAkB,QAAA,EAA+B;AACtD,EAAA,MAAM,OAAO,QAAA,CAAS,WAAA;AACtB,EAAA,IAAI,CAAC,IAAA,EAAM;AACP,IAAA;AAAA,EACJ;AAEA,EAAA,IAAI,SAAS,YAAA,EAAc;AACvB,IAAA,QAAA,CAAS,WAAA,CAAY,UAAA,CAAW,QAAA,CAAS,MAAA,CAAO,OAAO,GAAG,CAAA;AAC1D,IAAA,QAAA,CAAS,YAAA,GAAe,KAAA;AAAA,EAC5B;AAEA,EAAA,IAAA,CAAK,UAAA,CAAW,SAAS,WAAW,CAAA;AACpC,EAAA,QAAA,CAAS,WAAA,GAAc,IAAA;AAC3B;AAOO,SAAS,uBAAA,CAAwB,KAAA,EAAoB,KAAA,EAAe,OAAA,EAA6B;AACpG,EAAA,MAAM,WAAW,KAAA,CAAM,OAAA;AACvB,EAAA,IAAI,UAAU,MAAA,EAAQ;AAClB,IAAA,aAAA,CAAc,QAAA,CAAS,MAAA,EAAQ,KAAA,EAAO,OAAO,CAAA;AAAA,EACjD;AACJ;;;;"}

package/lib/audio/stereo.js

@@ -0,0 +1,40 @@
+import { setRampTarget, createRampParam } from './audio-param.js';
+import { rebuildSoundSubGraphHead } from './sound-sub-graph.js';
+
+const DEFAULT_PAN = 0;
+function createStereoSubNode(engine) {
+  const node = new StereoPannerNode(engine._ctx);
+  node.pan.value = DEFAULT_PAN;
+  return {
+    _engine: engine,
+    _inputNode: node,
+    _pan: createRampParam(node.pan, engine),
+    _dispose: () => {
+      node.disconnect();
+    }
+  };
+}
+function ensureStereoSubNode(host) {
+  const graph = host._graph;
+  if (graph._stereo) {
+    return graph._stereo;
+  }
+  const node = createStereoSubNode(host._engine);
+  node._inputNode.connect(graph._volume);
+  graph._stereo = node;
+  rebuildSoundSubGraphHead(graph, host._instances);
+  return node;
+}
+function enableStereo(host, options = {}) {
+  const node = ensureStereoSubNode(host);
+  if (options.pan !== void 0) {
+    setRampTarget(node._pan, options.pan);
+  }
+}
+function setStereoPan(host, pan, options) {
+  const node = ensureStereoSubNode(host);
+  setRampTarget(node._pan, pan, options);
+}
+
+export { enableStereo, setStereoPan };
+//# sourceMappingURL=stereo.js.map

package/lib/audio/stereo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stereo.js","sources":["../../../src/audio/stereo.ts"],"sourcesContent":["/**\n * Stereo panning — opt-in feature module.\n *\n * Faithful port of AudioV2 `_StereoAudioSubNode` / `_StereoWebAudioSubNode`,\n * re-architected to Lite idioms (pure state + standalone functions). Building\n * the sub-node is lazy, so importing nothing from here costs nothing.\n *\n * The stereo sub-node wraps a Web Audio `StereoPannerNode`. It is spliced into\n * the host's sub-graph in parallel with the optional spatial sub-node (see\n * {@link rebuildSoundSubGraphHead}); when both are present a split gain feeds\n * both branches, exactly as AudioV2 `_onSubNodesChanged` does.\n */\n\nimport { type AudioEngine } from \"./audio-engine.js\";\nimport { type RampOptions, type RampParam, createRampParam, setRampTarget } from \"./audio-param.js\";\nimport { rebuildSoundSubGraphHead } from \"./sound-sub-graph.js\";\nimport { type AudioGraphHost, type AudioGraphHostState } from \"./host-types.js\";\n\n/** Default stereo pan: centered. */\nconst DEFAULT_PAN = 0;\n\n/** Options for {@link enableStereo}. */\nexport interface StereoSoundOptions {\n    /** Stereo pan in the range `[-1, 1]` (`-1` = full left, `1` = full right). Defaults to `0`. */\n    pan?: number;\n}\n\n/** Stereo-pan sub-node state. Pure state — driven by the stereo functions. @internal */\nexport interface StereoSubNode {\n    /** @internal */ _engine: AudioEngine;\n    /** Head node — playing instances connect here; also the output to volume. @internal */ _inputNode: StereoPannerNode;\n    /** @internal */ _pan: RampParam;\n    /** @internal */ _dispose: () => void;\n}\n\nfunction createStereoSubNode(engine: AudioEngine): StereoSubNode {\n    const node = new StereoPannerNode(engine._ctx);\n    node.pan.value = DEFAULT_PAN;\n    return {\n        _engine: engine,\n        _inputNode: node,\n        _pan: createRampParam(node.pan, engine),\n        _dispose: () => {\n            node.disconnect();\n        },\n    };\n}\n\n/**\n * Lazily build the stereo sub-node and splice it into the host's sub-graph,\n * reconnecting any live instances. Idempotent.\n */\nfunction ensureStereoSubNode(host: AudioGraphHostState): StereoSubNode {\n    const graph = host._graph;\n    if (graph._stereo) {\n        // The graph stores a structural slot; this feature module owns the full node.\n        return graph._stereo as StereoSubNode;\n    }\n\n    const node = createStereoSubNode(host._engine);\n    node._inputNode.connect(graph._volume);\n    graph._stereo = node;\n\n    // Recompute the head and reconnect live instances (handles spatial+stereo parallel routing).\n    rebuildSoundSubGraphHead(graph, host._instances);\n\n    return node;\n}\n\n// ─── Public API ──────────────────────────────────────────────────────\n\n/**\n * Enables (or reconfigures) stereo panning on a sound or bus, building the\n * stereo sub-node on first use. Pulls the stereo module only when called.\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param options - Stereo options (pan).\n */\nexport function enableStereo(host: AudioGraphHost, options: StereoSoundOptions = {}): void {\n    const node = ensureStereoSubNode(host);\n    if (options.pan !== undefined) {\n        setRampTarget(node._pan, options.pan);\n    }\n}\n\n/**\n * Sets the stereo pan of a sound or bus, building the stereo sub-node on first\n * use.\n * @param host - A `StaticSound`, `StreamingSound`, or `AudioBus`.\n * @param pan - Pan in the range `[-1, 1]` (`-1` = full left, `1` = full right).\n * @param options - Optional ramp options for a smooth transition.\n */\nexport function setStereoPan(host: AudioGraphHost, pan: number, options?: RampOptions): void {\n    const node = ensureStereoSubNode(host);\n    setRampTarget(node._pan, pan, options);\n}\n"],"names":[],"mappings":";;;AAmBA,MAAM,WAAA,GAAc,CAAA;AAgBpB,SAAS,oBAAoB,MAAA,EAAoC;AAC7D,EAAA,MAAM,IAAA,GAAO,IAAI,gBAAA,CAAiB,MAAA,CAAO,IAAI,CAAA;AAC7C,EAAA,IAAA,CAAK,IAAI,KAAA,GAAQ,WAAA;AACjB,EAAA,OAAO;AAAA,IACH,OAAA,EAAS,MAAA;AAAA,IACT,UAAA,EAAY,IAAA;AAAA,IACZ,IAAA,EAAM,eAAA,CAAgB,IAAA,CAAK,GAAA,EAAK,MAAM,CAAA;AAAA,IACtC,UAAU,MAAM;AACZ,MAAA,IAAA,CAAK,UAAA,EAAW;AAAA,IACpB;AAAA,GACJ;AACJ;AAMA,SAAS,oBAAoB,IAAA,EAA0C;AACnE,EAAA,MAAM,QAAQ,IAAA,CAAK,MAAA;AACnB,EAAA,IAAI,MAAM,OAAA,EAAS;AAEf,IAAA,OAAO,KAAA,CAAM,OAAA;AAAA,EACjB;AAEA,EAAA,MAAM,IAAA,GAAO,mBAAA,CAAoB,IAAA,CAAK,OAAO,CAAA;AAC7C,EAAA,IAAA,CAAK,UAAA,CAAW,OAAA,CAAQ,KAAA,CAAM,OAAO,CAAA;AACrC,EAAA,KAAA,CAAM,OAAA,GAAU,IAAA;AAGhB,EAAA,wBAAA,CAAyB,KAAA,EAAO,KAAK,UAAU,CAAA;AAE/C,EAAA,OAAO,IAAA;AACX;AAUO,SAAS,YAAA,CAAa,IAAA,EAAsB,OAAA,GAA8B,EAAC,EAAS;AACvF,EAAA,MAAM,IAAA,GAAO,oBAAoB,IAAI,CAAA;AACrC,EAAA,IAAI,OAAA,CAAQ,QAAQ,MAAA,EAAW;AAC3B,IAAA,aAAA,CAAc,IAAA,CAAK,IAAA,EAAM,OAAA,CAAQ,GAAG,CAAA;AAAA,EACxC;AACJ;AASO,SAAS,YAAA,CAAa,IAAA,EAAsB,GAAA,EAAa,OAAA,EAA6B;AACzF,EAAA,MAAM,IAAA,GAAO,oBAAoB,IAAI,CAAA;AACrC,EAAA,aAAA,CAAc,IAAA,CAAK,IAAA,EAAM,GAAA,EAAK,OAAO,CAAA;AACzC;;;;"}