@sadhaka/loom-engine 0.14.0 → 0.15.0

package/dist/audio/music-director.js

@@ -0,0 +1,177 @@
+// MusicDirector - high-level music playback with fade + crossfade.
+//
+// Per LOOM-AUDIO-SPEC §4.3. Wraps AudioBufferSourceNode + GainNode
+// chains and routes them through audioBus.input('music'). The 'music'
+// bus is an AudioBus default (priority 'ambient'), so VE-budget gating
+// already mutes it under load - the director does not duplicate that.
+//
+// State machine (single track at a time, except mid-crossfade):
+//   idle: nothing playing
+//   playing(track): one source -> one gain -> music bus
+//   crossfading(from -> to): two sources, two gains, both ramping
+//
+// playMusic(name, fadeIn): stops prior immediately (no fade), creates a
+// new source+gain at gain=0, ramps to 1 over fadeInMs (default 500).
+// Loops by default. No-op if asset not in cache.
+//
+// stopMusic(fadeOut): ramps current gain to 0 over fadeOutMs (default
+// 800), stops source after fade. Resolves when fade completes. Safe
+// when nothing playing.
+//
+// crossfadeMusic(name, fade): starts new track gain=0, ramps prior to 0
+// + new to 1 simultaneously over fadeMs (default 1000), stops prior
+// after fade. If nothing was playing, equivalent to playMusic with the
+// same fade in.
+const DEFAULT_FADE_IN_MS = 500;
+const DEFAULT_FADE_OUT_MS = 800;
+const DEFAULT_CROSSFADE_MS = 1000;
+export class MusicDirector {
+    audioBus;
+    cache;
+    current = null;
+    constructor(audioBus, cache) {
+        this.audioBus = audioBus;
+        this.cache = cache;
+    }
+    static create(audioBus, cache) {
+        return new MusicDirector(audioBus, cache);
+    }
+    // Start a music track. If music is already playing, stops it
+    // immediately (no fade). Use crossfadeMusic for smooth transitions.
+    // No-op if asset not in cache.
+    playMusic(name, fadeInMs) {
+        var buffer = this.cache.get(name);
+        if (!buffer)
+            return;
+        // Stop prior immediately - no fade.
+        if (this.current) {
+            this.hardStop(this.current);
+            this.current = null;
+        }
+        var fade = fadeInMs !== undefined ? fadeInMs : DEFAULT_FADE_IN_MS;
+        this.current = this.startTrack(name, buffer, fade);
+    }
+    // Stop the current track with a fade-out. Resolves when fade
+    // completes. Safe to call when no music is playing.
+    stopMusic(fadeOutMs) {
+        var track = this.current;
+        if (!track)
+            return Promise.resolve();
+        var fade = fadeOutMs !== undefined ? fadeOutMs : DEFAULT_FADE_OUT_MS;
+        this.current = null;
+        return this.fadeOutAndStop(track, fade);
+    }
+    // Smoothly transition to a different track. If no track is playing,
+    // equivalent to playMusic with fadeMs as the fade-in. Same name as
+    // current is treated as a fresh play (the new buffer plays, prior
+    // fades; useful when the buffer was reloaded with a new variant).
+    crossfadeMusic(name, fadeMs) {
+        var buffer = this.cache.get(name);
+        if (!buffer)
+            return;
+        var fade = fadeMs !== undefined ? fadeMs : DEFAULT_CROSSFADE_MS;
+        var prior = this.current;
+        var next = this.startTrack(name, buffer, fade);
+        this.current = next;
+        if (prior) {
+            // Fade prior out; clean up after fade. We do not await - crossfade
+            // is fire-and-forget. If a NEW playMusic / crossfadeMusic call
+            // arrives mid-fade, hardStop on the prior (which is no longer
+            // referenced as `current`) is safe; the in-flight setTimeout
+            // closure will then call stop() on an already-stopped source,
+            // which the standard tolerates.
+            this.fadeOutAndStop(prior, fade);
+        }
+    }
+    // Currently-playing track name; null if silent. Mid-crossfade returns
+    // the NEW (incoming) track name - the prior is fading out and is no
+    // longer the canonical "current".
+    currentMusic() {
+        return this.current ? this.current.name : null;
+    }
+    // ---------- private ----------
+    startTrack(name, buffer, fadeInMs) {
+        var ctx = this.audioBus.ctx;
+        var source = ctx.createBufferSource();
+        source.buffer = buffer;
+        source.loop = true;
+        var gain = ctx.createGain();
+        var now = ctx.currentTime;
+        var fadeSec = Math.max(0, fadeInMs) / 1000;
+        if (fadeSec <= 0) {
+            gain.gain.value = 1;
+        }
+        else {
+            // setValueAtTime + linearRampToValueAtTime is the canonical
+            // Web Audio fade pattern. Browsers schedule the ramp on the
+            // audio thread; no JS timer needed for the audio side.
+            gain.gain.setValueAtTime(0, now);
+            gain.gain.linearRampToValueAtTime(1, now + fadeSec);
+        }
+        source.connect(gain).connect(this.audioBus.input('music'));
+        source.start();
+        return { name: name, source: source, gain: gain };
+    }
+    fadeOutAndStop(track, fadeOutMs) {
+        var ctx = this.audioBus.ctx;
+        var now = ctx.currentTime;
+        var fadeSec = Math.max(0, fadeOutMs) / 1000;
+        if (fadeSec <= 0) {
+            // Immediate stop.
+            this.hardStop(track);
+            return Promise.resolve();
+        }
+        // Cancel any prior ramps on this gain (e.g. an in-progress fade-in)
+        // so the fade-out starts from the actual current value rather than
+        // a stale ramp target. cancelScheduledValues + setValueAtTime at
+        // the live gain.value is the standard pattern.
+        try {
+            track.gain.gain.cancelScheduledValues(now);
+        }
+        catch {
+            // some implementations / mocks may lack cancelScheduledValues;
+            // best-effort
+        }
+        var startVal = track.gain.gain.value;
+        track.gain.gain.setValueAtTime(startVal, now);
+        track.gain.gain.linearRampToValueAtTime(0, now + fadeSec);
+        return new Promise((resolve) => {
+            // Timer in JS-land mirrors the audio-thread ramp duration. After
+            // the fade window, hardStop disconnects the nodes and stops the
+            // source. setTimeout in tests runs against fake timers if the
+            // test installs them, but in production the duration matches the
+            // ramp.
+            setTimeout(() => {
+                this.hardStop(track);
+                resolve();
+            }, fadeOutMs);
+        });
+    }
+    hardStop(track) {
+        try {
+            track.source.stop();
+        }
+        catch {
+            // source.stop() throws if already-stopped on some implementations
+            // or if start() was never called - we don't treat that as an
+            // error.
+        }
+        try {
+            track.source.disconnect();
+        }
+        catch {
+            // ignore
+        }
+        try {
+            track.gain.disconnect();
+        }
+        catch {
+            // ignore
+        }
+    }
+}
+// Resource key for the world's resource registry. Engine consumers
+// register a MusicDirector instance under this key alongside the audio
+// bus + asset cache.
+export const RESOURCE_MUSIC_DIRECTOR = 'music_director';
+//# sourceMappingURL=music-director.js.map

package/dist/audio/music-director.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"music-director.js","sourceRoot":"","sources":["../../src/audio/music-director.ts"],"names":[],"mappings":"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"}

package/dist/audio/spatial-audio-bus.d.ts

@@ -0,0 +1,66 @@
+import type { AudioBus } from './audio-bus.js';
+export interface PositionalPlayOptions {
+    x: number;
+    y: number;
+    z?: number;
+    distanceModel?: 'linear' | 'inverse' | 'exponential';
+    refDistance?: number;
+    maxDistance?: number;
+    rolloffFactor?: number;
+    gain?: number;
+    rate?: number;
+    loop?: boolean;
+}
+export interface AudioListenerPose {
+    x: number;
+    y: number;
+    z?: number;
+    forward?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    up?: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export interface SpatialSourceHandle {
+    stop(): void;
+    setPosition(x: number, y: number, z?: number): void;
+    fadeOut(durationMs: number): Promise<void>;
+    isPlaying(): boolean;
+}
+export declare const SPATIAL_BUS_NAME = "spatial";
+export declare function spatialDistance(listener: {
+    x: number;
+    y: number;
+    z?: number;
+}, source: {
+    x: number;
+    y: number;
+    z?: number;
+}): number;
+export declare class SpatialAudioBus {
+    private readonly audioBus;
+    private readonly ctx;
+    private active;
+    private lastPose;
+    private constructor();
+    static create(audioBus: AudioBus): SpatialAudioBus;
+    getAudioBus(): AudioBus;
+    getListenerPose(): AudioListenerPose;
+    setListener(pose: AudioListenerPose): void;
+    playPositional(buffer: AudioBuffer, options: PositionalPlayOptions): SpatialSourceHandle | null;
+    playPositionalTone(freq: number, durationMs: number, options: PositionalPlayOptions & {
+        type?: OscillatorType;
+    }): SpatialSourceHandle | null;
+    stopAll(): void;
+    dispose(): void;
+    private canPlay;
+    private startSource;
+    private applyPositionTo;
+    private releaseSource;
+}
+//# sourceMappingURL=spatial-audio-bus.d.ts.map

package/dist/audio/spatial-audio-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-audio-bus.d.ts","sourceRoot":"","sources":["../../src/audio/spatial-audio-bus.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C,MAAM,WAAW,qBAAqB;IAGpC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IAEV,CAAC,CAAC,EAAE,MAAM,CAAC;IAKX,aAAa,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,aAAa,CAAC;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAID,MAAM,WAAW,iBAAiB;IAChC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,CAAC,EAAE,MAAM,CAAC;IAEX,OAAO,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAE9C,EAAE,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1C;AAKD,MAAM,WAAW,mBAAmB;IAGlC,IAAI,IAAI,IAAI,CAAC;IAGb,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpD,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C,SAAS,IAAI,OAAO,CAAC;CACtB;AAKD,eAAO,MAAM,gBAAgB,YAAY,CAAC;AAM1C,wBAAgB,eAAe,CAC7B,QAAQ,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC9C,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C,MAAM,CAeR;AAYD,qBAAa,eAAe;IAG1B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAW;IAGpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAGnC,OAAO,CAAC,MAAM,CAAgC;IAI9C,OAAO,CAAC,QAAQ,CAMd;IAEF,OAAO;IAgBP,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,QAAQ,GAAG,eAAe;IAMlD,WAAW,IAAI,QAAQ;IAKvB,eAAe,IAAI,iBAAiB;IAOpC,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,IAAI;IA6C1C,cAAc,CACZ,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,qBAAqB,GAC7B,mBAAmB,GAAG,IAAI;IAa7B,kBAAkB,CAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,qBAAqB,GAAG;QAAE,IAAI,CAAC,EAAE,cAAc,CAAA;KAAE,GACzD,mBAAmB,GAAG,IAAI;IAiB7B,OAAO,IAAI,IAAI;IAaf,OAAO,IAAI,IAAI;IAcf,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,WAAW;IA2FnB,OAAO,CAAC,eAAe;IAsBvB,OAAO,CAAC,aAAa;CAQtB"}

package/dist/audio/spatial-audio-bus.js

@@ -0,0 +1,341 @@
+// SpatialAudioBus - positional 3D audio for the Loom Engine.
+//
+// Composes the existing AudioBus (Phase 5 lock) and adds a 'spatial'
+// sub-bus whose sources route through Web Audio PannerNodes. The
+// existing 'sfx' / 'music' / 'voice' / 'ui' buses are untouched.
+//
+// Architecture per LOOM-AUDIO-SPEC.md Section 3.1:
+//
+//   AudioContext.destination
+//     <- AudioBus.master (existing, Phase 5)
+//          <- 'sfx', 'music', 'voice', 'ui' (existing AudioBus sub-buses)
+//          <- 'spatial' (NEW: ambient priority, VE-budget gated)
+//                 <- per-source PannerNode
+//                       <- per-source GainNode
+//                             <- AudioBufferSourceNode | OscillatorNode
+//
+// Each call to playPositional / playPositionalTone allocates ONE
+// PannerNode + ONE GainNode + ONE source node. The PannerNode is reused
+// when handle.setPosition is called - no realloc per frame for moving
+// sources. fadeOut animates the gain to 0 over the requested duration
+// then disconnects.
+//
+// VE-budget integration: SpatialAudioBus.create adds a 'spatial' bus on
+// the underlying AudioBus with priority 'ambient'. Under VE-budget
+// pressure (audioBudget < AUDIO_BUDGET_AMBIENT_FLOOR per audio-bus.ts)
+// the entire spatial bus mutes; we surface that as null returns from
+// playPositional so callers don't waste cycles building handles for
+// inaudible sounds.
+//
+// Listener pose: setListener writes to AudioContext.listener
+// (positionX/Y/Z + forwardX/Y/Z + upX/Y/Z). Per spec §8.4 the listener
+// orientation is fixed in v1 to forward=(0,0,-1), up=(0,1,0); only
+// position is meaningful. Modern AudioParam-style API is preferred;
+// we fall back to the deprecated setPosition/setOrientation if the
+// runtime exposes those instead (some test mocks).
+//
+// Inspirations (per PRIOR-ART.md):
+//   Web Audio PannerNode HRTF spec - W3C public technique
+//   Distance falloff models (linear / inverse / exponential) - Web
+//     Audio canonical, also FMOD / Wwise standard
+//   No patented techniques used.
+// Name of the new sub-bus this class adds to the underlying AudioBus.
+// Exported so consumers can adjust gain/mute via audioBus.setBusGain
+// without depending on the literal.
+export const SPATIAL_BUS_NAME = 'spatial';
+// Distance helper shared with tests. Returns the Euclidean distance
+// from the listener pose to a source. Treats undefined z as 0 and
+// guards against NaN inputs (returns Infinity for any NaN coordinate
+// so a defensive caller can skip muted sources cleanly).
+export function spatialDistance(listener, source) {
+    if (Number.isNaN(listener.x) || Number.isNaN(listener.y) ||
+        Number.isNaN(source.x) || Number.isNaN(source.y) ||
+        (listener.z !== undefined && Number.isNaN(listener.z)) ||
+        (source.z !== undefined && Number.isNaN(source.z))) {
+        return Number.POSITIVE_INFINITY;
+    }
+    const dx = source.x - listener.x;
+    const dy = source.y - listener.y;
+    const lz = listener.z ?? 0;
+    const sz = source.z ?? 0;
+    const dz = sz - lz;
+    return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+export class SpatialAudioBus {
+    // The composed AudioBus. We don't alter its master/sub-buses; we
+    // just add a 'spatial' sub-bus on it via addBus.
+    audioBus;
+    // The AudioContext from the underlying bus. Cached for cheap access.
+    ctx;
+    // Tracks live sources so dispose() / debug introspection can sweep.
+    active = new Set();
+    // Latest listener pose; remembered so handlers can read it without
+    // re-traversing the AudioContext.
+    lastPose = {
+        x: 0,
+        y: 0,
+        z: 0,
+        forward: { x: 0, y: 0, z: -1 },
+        up: { x: 0, y: 1, z: 0 },
+    };
+    constructor(audioBus) {
+        this.audioBus = audioBus;
+        this.ctx = audioBus.ctx;
+        // Idempotent: if a 'spatial' bus already exists (engine consumer
+        // wired one early), AudioBus.addBus is a no-op and we reuse it.
+        if (!audioBus.hasBus(SPATIAL_BUS_NAME)) {
+            audioBus.addBus(SPATIAL_BUS_NAME, {
+                initialGain: 1.0,
+                priority: 'ambient',
+            });
+        }
+    }
+    // Construct on top of an existing AudioBus. The AudioBus owns the
+    // AudioContext lifecycle (unlock, dispose). v1 does not own a second
+    // master gain; the spatial bus IS the master path through AudioBus.
+    static create(audioBus) {
+        return new SpatialAudioBus(audioBus);
+    }
+    // Read-only accessor for the underlying AudioBus, useful for tests
+    // and consumers that want to tweak the spatial sub-bus gain.
+    getAudioBus() {
+        return this.audioBus;
+    }
+    // Read-only accessor for the cached listener pose.
+    getListenerPose() {
+        return this.lastPose;
+    }
+    // Update the listener pose. Renderer pushes this each frame from the
+    // local character's transform via SpatialAudioSystem. Pose is global
+    // to the AudioContext - one listener per context.
+    setListener(pose) {
+        this.lastPose = pose;
+        var listener = this.ctx.listener;
+        if (!listener)
+            return;
+        var z = pose.z ?? 0;
+        var fwd = pose.forward ?? { x: 0, y: 0, z: -1 };
+        var up = pose.up ?? { x: 0, y: 1, z: 0 };
+        // Modern AudioParam API (Chrome 64+, Firefox 58+, Safari 14+).
+        if (listener.positionX !== undefined &&
+            typeof listener.positionX.setValueAtTime === 'function') {
+            var asParam = listener;
+            var now = this.ctx.currentTime;
+            asParam.positionX.setValueAtTime(pose.x, now);
+            asParam.positionY.setValueAtTime(pose.y, now);
+            asParam.positionZ.setValueAtTime(z, now);
+            asParam.forwardX.setValueAtTime(fwd.x, now);
+            asParam.forwardY.setValueAtTime(fwd.y, now);
+            asParam.forwardZ.setValueAtTime(fwd.z, now);
+            asParam.upX.setValueAtTime(up.x, now);
+            asParam.upY.setValueAtTime(up.y, now);
+            asParam.upZ.setValueAtTime(up.z, now);
+            return;
+        }
+        // Deprecated fallback (older Safari, some test mocks).
+        var legacy = listener;
+        if (typeof legacy.setPosition === 'function') {
+            legacy.setPosition(pose.x, pose.y, z);
+        }
+        if (typeof legacy.setOrientation === 'function') {
+            legacy.setOrientation(fwd.x, fwd.y, fwd.z, up.x, up.y, up.z);
+        }
+    }
+    // Play a one-shot positional sound. Returns null if the AudioContext
+    // is suspended (AudioBus.unlock not yet called) or if the 'spatial'
+    // bus is muted by VE-budget pressure.
+    playPositional(buffer, options) {
+        if (!this.canPlay())
+            return null;
+        var src = this.ctx.createBufferSource();
+        src.buffer = buffer;
+        src.playbackRate.value = options.rate ?? 1;
+        src.loop = options.loop ?? false;
+        return this.startSource(src, false, options);
+    }
+    // Convenience: play a positional tone (no asset needed). Useful for
+    // tests and code-only demos. Honours options.type for the oscillator
+    // waveform; envelope is left to the consumer (or the natural source
+    // duration).
+    playPositionalTone(freq, durationMs, options) {
+        if (!this.canPlay())
+            return null;
+        var osc = this.ctx.createOscillator();
+        osc.type = options.type ?? 'sine';
+        osc.frequency.value = freq;
+        var handle = this.startSource(osc, true, options);
+        if (handle) {
+            // Schedule a stop at the end of the requested duration so the
+            // tone doesn't run forever. Tiny tail keeps the click low.
+            var stopAt = this.ctx.currentTime + Math.max(0.01, durationMs / 1000) + 0.05;
+            try {
+                osc.stop(stopAt);
+            }
+            catch { /* runtime may not support timestamped stop */ }
+        }
+        return handle;
+    }
+    // Stop every live spatial source and disconnect their nodes. Called
+    // by dispose() and useful for "scene change, kill everything" flows.
+    stopAll() {
+        // Snapshot to a list because handle.stop mutates the set.
+        var sources = [];
+        this.active.forEach(function (s) { sources.push(s); });
+        for (var i = 0; i < sources.length; i++) {
+            this.releaseSource(sources[i]);
+        }
+        this.active.clear();
+    }
+    // Tear down. Useful in tests; production demo lives the lifetime of
+    // the page. Does NOT dispose the underlying AudioBus - the consumer
+    // may still want sfx/music/etc.
+    dispose() {
+        this.stopAll();
+    }
+    // -------- private --------
+    // Returns true iff a play call would have a chance of producing
+    // audible output: context unlocked AND spatial bus not muted by
+    // VE-budget. We do NOT introspect AudioBus's internal state directly;
+    // we mirror the public contract:
+    //   - audioBus.isUnlocked() must be true
+    //   - audioBus.isBusMuted('spatial') must be false (explicit mute)
+    //   - audioBus.getBusGain('spatial') must be > 0 after budget gating
+    //     (the bus's input GainNode reflects this; we check the live gain)
+    canPlay() {
+        if (!this.audioBus.isUnlocked())
+            return false;
+        if (this.audioBus.isBusMuted(SPATIAL_BUS_NAME))
+            return false;
+        // Live gain after budget gating - if VE budget knocked it to 0,
+        // there's no point creating a source we can't hear.
+        var input = this.audioBus.input(SPATIAL_BUS_NAME);
+        if (input && input.gain && input.gain.value === 0)
+            return false;
+        return true;
+    }
+    // Wires a fresh source -> gain -> panner -> spatial bus input,
+    // applies position + falloff fields, registers the active source,
+    // and returns a handle. Caller is responsible for src.start() in the
+    // BufferSource case (we do it here so paths converge).
+    startSource(source, isOscillator, options) {
+        var panner = this.ctx.createPanner();
+        var gain = this.ctx.createGain();
+        gain.gain.value = options.gain ?? 1.0;
+        // Falloff fields. PannerNode defaults are ref=1, max=10000,
+        // rolloff=1, model='inverse'. Our defaults are documented in
+        // PositionalPlayOptions.
+        panner.distanceModel = options.distanceModel ?? 'inverse';
+        panner.refDistance = options.refDistance ?? 1;
+        panner.maxDistance = options.maxDistance ?? 32;
+        panner.rolloffFactor = options.rolloffFactor ?? 1;
+        panner.panningModel = 'HRTF';
+        var z = options.z ?? 0;
+        this.applyPositionTo(panner, options.x, options.y, z);
+        // Wire: source -> gain -> panner -> spatial-bus input.
+        source.connect(gain);
+        gain.connect(panner);
+        var spatialInput = this.audioBus.input(SPATIAL_BUS_NAME);
+        panner.connect(spatialInput);
+        // Track for cleanup BEFORE start() so an immediate end-of-buffer
+        // event still finds us in the active set.
+        var record = {
+            panner: panner,
+            gain: gain,
+            source: source,
+            isOscillator: isOscillator,
+            stopped: false,
+        };
+        this.active.add(record);
+        // BufferSourceNode.onended fires when the buffer plays out OR
+        // stop() is called. Use it to auto-cleanup so we don't leak nodes.
+        var self = this;
+        source.onended = function () {
+            self.releaseSource(record);
+        };
+        try {
+            source.start();
+        }
+        catch {
+            // Some runtimes throw if start() called twice; harmless here.
+        }
+        var handle = {
+            stop: function () {
+                if (record.stopped)
+                    return;
+                try {
+                    source.stop();
+                }
+                catch { /* already stopped */ }
+                self.releaseSource(record);
+            },
+            setPosition: function (nx, ny, nz) {
+                if (record.stopped)
+                    return;
+                self.applyPositionTo(record.panner, nx, ny, nz ?? 0);
+            },
+            fadeOut: function (durationMs) {
+                if (record.stopped)
+                    return Promise.resolve();
+                var dur = Math.max(0, durationMs) / 1000;
+                var now = self.ctx.currentTime;
+                try {
+                    // setValueAtTime to current then ramp to 0 - prevents the
+                    // ramp from interpolating from whatever the previous
+                    // setValueAtTime scheduled (could be a jump).
+                    record.gain.gain.setValueAtTime(record.gain.gain.value, now);
+                    record.gain.gain.linearRampToValueAtTime(0, now + dur);
+                }
+                catch { /* fake AudioParam may not support */ }
+                return new Promise(function (resolve) {
+                    var ms = Math.max(0, durationMs);
+                    // setTimeout in test environments without a real audio clock.
+                    setTimeout(function () {
+                        handle.stop();
+                        resolve();
+                    }, ms);
+                });
+            },
+            isPlaying: function () {
+                return !record.stopped;
+            },
+        };
+        return handle;
+    }
+    // Apply x/y/z to a PannerNode. Prefers AudioParam.setValueAtTime when
+    // available (modern API); falls back to the deprecated direct
+    // assignment via setPosition for older runtimes / mocks.
+    applyPositionTo(panner, x, y, z) {
+        var asParam = panner;
+        if (asParam.positionX && typeof asParam.positionX.setValueAtTime === 'function') {
+            var now = this.ctx.currentTime;
+            asParam.positionX.setValueAtTime(x, now);
+            asParam.positionY.setValueAtTime(y, now);
+            asParam.positionZ.setValueAtTime(z, now);
+            return;
+        }
+        var legacy = panner;
+        if (typeof legacy.setPosition === 'function') {
+            legacy.setPosition(x, y, z);
+        }
+    }
+    // Disconnect + drop one active source. Idempotent.
+    releaseSource(record) {
+        if (record.stopped)
+            return;
+        record.stopped = true;
+        this.active.delete(record);
+        try {
+            record.source.disconnect();
+        }
+        catch { /* ignore */ }
+        try {
+            record.gain.disconnect();
+        }
+        catch { /* ignore */ }
+        try {
+            record.panner.disconnect();
+        }
+        catch { /* ignore */ }
+    }
+}
+//# sourceMappingURL=spatial-audio-bus.js.map

package/dist/audio/spatial-audio-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-audio-bus.js","sourceRoot":"","sources":["../../src/audio/spatial-audio-bus.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,17 @@
+import type { System } from '../system.js';
+import type { World } from '../world.js';
+import type { EntityId } from '../entity.js';
+import type { SpatialAudioBus } from './spatial-audio-bus.js';
+export declare class SpatialAudioSystem implements System {
+    readonly name: string;
+    private localCharacter;
+    private spatialBus;
+    constructor(opts?: {
+        spatialBus?: SpatialAudioBus;
+    });
+    setSpatialBus(bus: SpatialAudioBus | null): void;
+    setLocalCharacterEntity(entity: EntityId | null): void;
+    getLocalCharacterEntity(): EntityId | null;
+    update(world: World, _dt: number): void;
+}
+//# sourceMappingURL=spatial-audio-system.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"spatial-audio-system.d.ts","sourceRoot":"","sources":["../../src/audio/spatial-audio-system.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAY7C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D,qBAAa,kBAAmB,YAAW,MAAM;IAC/C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAmB;IAExC,OAAO,CAAC,cAAc,CAAyB;IAC/C,OAAO,CAAC,UAAU,CAAgC;gBAMtC,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,eAAe,CAAA;KAAO;IAOvD,aAAa,CAAC,GAAG,EAAE,eAAe,GAAG,IAAI,GAAG,IAAI;IAQhD,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI;IAItD,uBAAuB,IAAI,QAAQ,GAAG,IAAI;IAI1C,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;CA4BxC"}