@codexo/exojs 0.6.12 → 0.7.12

package/dist/esm/audio/AudioBus.js

@@ -0,0 +1,255 @@
+import { clamp } from '../math/utils.js';
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from './audio-context.js';
+
+/**
+ * Hierarchical mixer node in the engine's audio routing graph. Each bus
+ * owns three Web Audio nodes (input gain, optional filter chain, stereo
+ * pan, output gain) and routes its output into its parent's input — the
+ * root bus connects to the destination.
+ *
+ * The three engine-built-in busses are constructed by {@link AudioManager}:
+ * `master` (root), `music` (child of master), `sound` (child of master).
+ * User code creates additional busses via `new AudioBus(name, { parent })`
+ * and registers them via {@link AudioManager.registerBus}.
+ *
+ * Volume is in 0..2 (1 = unity), pan is -1..1, mute is a boolean override.
+ * {@link AudioBus.fadeIn} / {@link AudioBus.fadeOut} produce smooth ramps
+ * over the output gain. Filter changes via {@link AudioBus.addFilter} /
+ * {@link AudioBus.removeFilter} rebuild the chain in place.
+ *
+ * Setup is deferred until the global `AudioContext` is unlocked
+ * (browser autoplay policy); operations that need live nodes are no-ops
+ * until that happens.
+ */
+class AudioBus {
+    name;
+    _parent;
+    _volume;
+    _muted;
+    _pan;
+    _filters = [];
+    _setup = null;
+    _scheduledStopId = null;
+    constructor(name, options = {}) {
+        if (!name || typeof name !== 'string') {
+            throw new Error('AudioBus requires a non-empty string name.');
+        }
+        this.name = name;
+        this._parent = options.parent ?? null;
+        this._volume = clamp(options.volume ?? 1, 0, 2);
+        this._muted = options.muted ?? false;
+        this._pan = clamp(options.pan ?? 0, -1, 1);
+        if (options.filters) {
+            this._filters.push(...options.filters);
+        }
+        if (isAudioContextReady()) {
+            this._setupAudio(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupAudio, this);
+        }
+    }
+    get parent() {
+        return this._parent;
+    }
+    get volume() {
+        return this._volume;
+    }
+    set volume(value) {
+        const clamped = clamp(value, 0, 2);
+        if (this._volume === clamped)
+            return;
+        this._volume = clamped;
+        this._applyVolume();
+    }
+    get muted() {
+        return this._muted;
+    }
+    set muted(value) {
+        if (this._muted === value)
+            return;
+        this._muted = value;
+        this._applyVolume();
+    }
+    get pan() {
+        return this._pan;
+    }
+    set pan(value) {
+        const clamped = clamp(value, -1, 1);
+        if (this._pan === clamped)
+            return;
+        this._pan = clamped;
+        if (this._setup) {
+            this._setup.panNode.pan.setTargetAtTime(clamped, this._setup.audioContext.currentTime, 0.01);
+        }
+    }
+    get inputNode() {
+        return this._setup?.inputNode ?? null;
+    }
+    /**
+     * Append a filter to the end of the chain (before the pan stage). The
+     * chain is rebuilt in place; existing audio routes through the new
+     * filter on the next frame.
+     */
+    addFilter(filter) {
+        this._filters.push(filter);
+        this._rebuildFilterChain();
+        return this;
+    }
+    /** Remove `filter` from the chain. No-op if not present. Caller still owns + must `destroy()` it. */
+    removeFilter(filter) {
+        const index = this._filters.indexOf(filter);
+        if (index !== -1) {
+            this._filters.splice(index, 1);
+            this._rebuildFilterChain();
+        }
+        return this;
+    }
+    /**
+     * Linearly ramp the output gain from 0 to the current volume over
+     * `durationMs`. Cancels any in-flight ramps on the same gain node.
+     */
+    fadeIn(durationMs) {
+        this._clearScheduledStop();
+        if (durationMs <= 0 || !this._setup) {
+            return this;
+        }
+        const ctx = this._setup.audioContext;
+        const node = this._setup.outputNode;
+        const target = this._muted ? 0 : this._volume;
+        node.gain.cancelScheduledValues(ctx.currentTime);
+        node.gain.setValueAtTime(0, ctx.currentTime);
+        node.gain.linearRampToValueAtTime(target, ctx.currentTime + durationMs / 1000);
+        return this;
+    }
+    /**
+     * Linearly ramp the output gain to 0 over `durationMs`. By default
+     * mutes the bus once the ramp completes (`stopAfter: true`); pass
+     * `stopAfter: false` to let the ramp finish silently while leaving
+     * `muted` unchanged.
+     */
+    fadeOut(durationMs, options = {}) {
+        const stopAfter = options.stopAfter ?? true;
+        this._clearScheduledStop();
+        if (durationMs <= 0 || !this._setup) {
+            if (stopAfter)
+                this.muted = true;
+            return this;
+        }
+        const ctx = this._setup.audioContext;
+        const node = this._setup.outputNode;
+        node.gain.cancelScheduledValues(ctx.currentTime);
+        node.gain.setValueAtTime(node.gain.value, ctx.currentTime);
+        node.gain.linearRampToValueAtTime(0, ctx.currentTime + durationMs / 1000);
+        if (stopAfter) {
+            this._scheduledStopId = setTimeout(() => {
+                this._scheduledStopId = null;
+                this.muted = true;
+            }, durationMs);
+        }
+        return this;
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        this._clearScheduledStop();
+        for (const filter of this._filters) {
+            filter.destroy();
+        }
+        this._filters.length = 0;
+        if (this._setup) {
+            this._setup.inputNode.disconnect();
+            this._setup.outputNode.disconnect();
+            this._setup.panNode.disconnect();
+            this._setup = null;
+        }
+    }
+    /** Internal: returns the input GainNode where children should connect. */
+    _getInputNode() {
+        return this._setup?.inputNode ?? null;
+    }
+    /** Internal: returns the output GainNode that connects upstream. */
+    _getOutputNode() {
+        return this._setup?.outputNode ?? null;
+    }
+    _setupAudio(audioContext) {
+        const inputNode = audioContext.createGain();
+        const panNode = audioContext.createStereoPanner();
+        const outputNode = audioContext.createGain();
+        // Internal chain: input → [filters...] → pan → output
+        outputNode.gain.setTargetAtTime(this._muted ? 0 : this._volume, audioContext.currentTime, 0.01);
+        panNode.pan.setTargetAtTime(this._pan, audioContext.currentTime, 0.01);
+        this._setup = { audioContext, inputNode, outputNode, panNode };
+        this._rebuildFilterChain();
+        this._connectUpstream();
+    }
+    _connectUpstream() {
+        if (!this._setup)
+            return;
+        if (this._parent) {
+            const parentInput = this._parent._getInputNode();
+            if (parentInput) {
+                this._setup.outputNode.connect(parentInput);
+            }
+            else {
+                // Parent not yet ready — subscribe to parent's setup
+                this._parent.onceSetup(() => {
+                    if (this._setup && this._parent) {
+                        const node = this._parent._getInputNode();
+                        if (node)
+                            this._setup.outputNode.connect(node);
+                    }
+                });
+            }
+        }
+        else {
+            this._setup.outputNode.connect(this._setup.audioContext.destination);
+        }
+    }
+    /** Subscribe to the moment this bus's audio nodes are ready. Internal use. */
+    onceSetup(callback) {
+        if (this._setup) {
+            callback();
+        }
+        else {
+            onAudioContextReady.once(() => {
+                if (this._setup)
+                    callback();
+            }, this);
+        }
+    }
+    _rebuildFilterChain() {
+        if (!this._setup)
+            return;
+        const { inputNode, panNode } = this._setup;
+        // Disconnect current chain
+        inputNode.disconnect();
+        for (const filter of this._filters) {
+            filter.inputNode.disconnect();
+            filter.outputNode.disconnect();
+        }
+        panNode.disconnect();
+        // Rebuild: input → filter[0].input → filter[0].output → filter[1].input → ... → pan → output
+        let prev = inputNode;
+        for (const filter of this._filters) {
+            prev.connect(filter.inputNode);
+            prev = filter.outputNode;
+        }
+        prev.connect(panNode);
+        panNode.connect(this._setup.outputNode);
+    }
+    _applyVolume() {
+        if (!this._setup)
+            return;
+        const target = this._muted ? 0 : this._volume;
+        this._setup.outputNode.gain.setTargetAtTime(target, this._setup.audioContext.currentTime, 0.01);
+    }
+    _clearScheduledStop() {
+        if (this._scheduledStopId !== null) {
+            clearTimeout(this._scheduledStopId);
+            this._scheduledStopId = null;
+        }
+    }
+}
+
+export { AudioBus };
+//# sourceMappingURL=AudioBus.js.map

package/dist/esm/audio/AudioBus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioBus.js","sources":["../../../../src/audio/AudioBus.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAoBA;;;;;;;;;;;;;;;;;;;AAmBG;MACU,QAAQ,CAAA;AACD,IAAA,IAAI;AACZ,IAAA,OAAO;AACP,IAAA,OAAO;AACP,IAAA,MAAM;AACN,IAAA,IAAI;IACK,QAAQ,GAAuB,EAAE;IAC1C,MAAM,GAAyB,IAAI;IACnC,gBAAgB,GAAyC,IAAI;IAErE,WAAA,CAAmB,IAAY,EAAE,OAAA,GAA2B,EAAE,EAAA;QAC1D,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AACnC,YAAA,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC;QACjE;AACA,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI;QAChB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,IAAI;AACrC,QAAA,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/C,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,KAAK;AACpC,QAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAE1C,QAAA,IAAI,OAAO,CAAC,OAAO,EAAE;YACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;QAC1C;QAEA,IAAI,mBAAmB,EAAE,EAAE;AACvB,YAAA,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC;QACvC;aAAO;YACH,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC;QACpD;IACJ;AAEA,IAAA,IAAW,MAAM,GAAA;QACb,OAAO,IAAI,CAAC,OAAO;IACvB;AAEA,IAAA,IAAW,MAAM,GAAA;QACb,OAAO,IAAI,CAAC,OAAO;IACvB;IAEA,IAAW,MAAM,CAAC,KAAa,EAAA;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;AAClC,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO;YAAE;AAC9B,QAAA,IAAI,CAAC,OAAO,GAAG,OAAO;QACtB,IAAI,CAAC,YAAY,EAAE;IACvB;AAEA,IAAA,IAAW,KAAK,GAAA;QACZ,OAAO,IAAI,CAAC,MAAM;IACtB;IAEA,IAAW,KAAK,CAAC,KAAc,EAAA;AAC3B,QAAA,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK;YAAE;AAC3B,QAAA,IAAI,CAAC,MAAM,GAAG,KAAK;QACnB,IAAI,CAAC,YAAY,EAAE;IACvB;AAEA,IAAA,IAAW,GAAG,GAAA;QACV,OAAO,IAAI,CAAC,IAAI;IACpB;IAEA,IAAW,GAAG,CAAC,KAAa,EAAA;QACxB,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;AACnC,QAAA,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO;YAAE;AAC3B,QAAA,IAAI,CAAC,IAAI,GAAG,OAAO;AACnB,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;YACb,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CACnC,OAAO,EACP,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,EACpC,IAAI,CACP;QACL;IACJ;AAEA,IAAA,IAAW,SAAS,GAAA;AAChB,QAAA,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI;IACzC;AAEA;;;;AAIG;AACI,IAAA,SAAS,CAAC,MAAmB,EAAA;AAChC,QAAA,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,mBAAmB,EAAE;AAC1B,QAAA,OAAO,IAAI;IACf;;AAGO,IAAA,YAAY,CAAC,MAAmB,EAAA;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;AAC3C,QAAA,IAAI,KAAK,KAAK,EAAE,EAAE;YACd,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YAC9B,IAAI,CAAC,mBAAmB,EAAE;QAC9B;AACA,QAAA,OAAO,IAAI;IACf;AAEA;;;AAGG;AACI,IAAA,MAAM,CAAC,UAAkB,EAAA;QAC5B,IAAI,CAAC,mBAAmB,EAAE;QAC1B,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AACjC,YAAA,OAAO,IAAI;QACf;AACA,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY;AACpC,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU;AACnC,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO;QAC7C,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC;QAChD,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,CAAC;AAC5C,QAAA,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;AAC9E,QAAA,OAAO,IAAI;IACf;AAEA;;;;;AAKG;AACI,IAAA,OAAO,CAAC,UAAkB,EAAE,OAAA,GAAmC,EAAE,EAAA;AACpE,QAAA,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI;QAC3C,IAAI,CAAC,mBAAmB,EAAE;QAC1B,IAAI,UAAU,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;AACjC,YAAA,IAAI,SAAS;AAAE,gBAAA,IAAI,CAAC,KAAK,GAAG,IAAI;AAChC,YAAA,OAAO,IAAI;QACf;AACA,QAAA,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY;AACpC,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,UAAU;QACnC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC;AAChD,QAAA,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC;AAC1D,QAAA,IAAI,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,EAAE,GAAG,CAAC,WAAW,GAAG,UAAU,GAAG,IAAI,CAAC;QACzE,IAAI,SAAS,EAAE;AACX,YAAA,IAAI,CAAC,gBAAgB,GAAG,UAAU,CAAC,MAAK;AACpC,gBAAA,IAAI,CAAC,gBAAgB,GAAG,IAAI;AAC5B,gBAAA,IAAI,CAAC,KAAK,GAAG,IAAI;YACrB,CAAC,EAAE,UAAU,CAAC;QAClB;AACA,QAAA,OAAO,IAAI;IACf;IAEO,OAAO,GAAA;AACV,QAAA,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC;QACxC,IAAI,CAAC,mBAAmB,EAAE;AAC1B,QAAA,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE;YAChC,MAAM,CAAC,OAAO,EAAE;QACpB;AACA,QAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;AACxB,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AACb,YAAA,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE;AAClC,YAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE;AACnC,YAAA,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE;AAChC,YAAA,IAAI,CAAC,MAAM,GAAG,IAAI;QACtB;IACJ;;IAGO,aAAa,GAAA;AAChB,QAAA,OAAO,IAAI,CAAC,MAAM,EAAE,SAAS,IAAI,IAAI;IACzC;;IAGO,cAAc,GAAA;AACjB,QAAA,OAAO,IAAI,CAAC,MAAM,EAAE,UAAU,IAAI,IAAI;IAC1C;AAEQ,IAAA,WAAW,CAAC,YAA0B,EAAA;AAC1C,QAAA,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE;AAC3C,QAAA,MAAM,OAAO,GAAG,YAAY,CAAC,kBAAkB,EAAE;AACjD,QAAA,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,EAAE;;QAG5C,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC;AAC/F,QAAA,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,YAAY,CAAC,WAAW,EAAE,IAAI,CAAC;AAEtE,QAAA,IAAI,CAAC,MAAM,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE;QAC9D,IAAI,CAAC,mBAAmB,EAAE;QAC1B,IAAI,CAAC,gBAAgB,EAAE;IAC3B;IAEQ,gBAAgB,GAAA;QACpB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE;AAClB,QAAA,IAAI,IAAI,CAAC,OAAO,EAAE;YACd,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;YAChD,IAAI,WAAW,EAAE;gBACb,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,CAAC;YAC/C;iBAAO;;AAEH,gBAAA,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAK;oBACxB,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE;wBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;AACzC,wBAAA,IAAI,IAAI;4BAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC;oBAClD;AACJ,gBAAA,CAAC,CAAC;YACN;QACJ;aAAO;AACH,YAAA,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,CAAC;QACxE;IACJ;;AAGO,IAAA,SAAS,CAAC,QAAoB,EAAA;AACjC,QAAA,IAAI,IAAI,CAAC,MAAM,EAAE;AACb,YAAA,QAAQ,EAAE;QACd;aAAO;AACH,YAAA,mBAAmB,CAAC,IAAI,CAAC,MAAK;gBAC1B,IAAI,IAAI,CAAC,MAAM;AAAE,oBAAA,QAAQ,EAAE;YAC/B,CAAC,EAAE,IAAI,CAAC;QACZ;IACJ;IAEQ,mBAAmB,GAAA;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE;QAClB,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM;;QAG1C,SAAS,CAAC,UAAU,EAAE;AACtB,QAAA,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE;AAChC,YAAA,MAAM,CAAC,SAAS,CAAC,UAAU,EAAE;AAC7B,YAAA,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE;QAClC;QACA,OAAO,CAAC,UAAU,EAAE;;QAGpB,IAAI,IAAI,GAAc,SAAS;AAC/B,QAAA,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE;AAChC,YAAA,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;AAC9B,YAAA,IAAI,GAAG,MAAM,CAAC,UAAU;QAC5B;AACA,QAAA,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;QACrB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC;IAC3C;IAEQ,YAAY,GAAA;QAChB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE;AAClB,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO;QAC7C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,eAAe,CACvC,MAAM,EACN,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,EACpC,IAAI,CACP;IACL;IAEQ,mBAAmB,GAAA;AACvB,QAAA,IAAI,IAAI,CAAC,gBAAgB,KAAK,IAAI,EAAE;AAChC,YAAA,YAAY,CAAC,IAAI,CAAC,gBAAgB,CAAC;AACnC,YAAA,IAAI,CAAC,gBAAgB,GAAG,IAAI;QAChC;IACJ;AACH;;;;"}

package/dist/esm/audio/AudioFilter.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Abstract base for all audio processing filters in ExoJS. Each filter exposes
+ * stable {@link inputNode} and {@link outputNode} AudioNodes that the audio bus
+ * connects into the Web Audio graph. Async filters (e.g., worklet-based) expose
+ * a {@link ready} promise that resolves once the filter is fully initialized.
+ */
+export declare abstract class AudioFilter {
+    /** The node where audio enters this filter. */
+    abstract get inputNode(): AudioNode;
+    /** The node where audio exits this filter. */
+    abstract get outputNode(): AudioNode;
+    /** Resolves when the filter is fully initialized. Defaults to immediately-resolved for sync filters. */
+    get ready(): Promise<void>;
+    /** Disconnects all audio nodes and releases resources. Must be called when the filter is no longer needed. */
+    abstract destroy(): void;
+}

package/dist/esm/audio/AudioFilter.js

@@ -0,0 +1,13 @@
+/**
+ * Abstract base for all audio processing filters in ExoJS. Each filter exposes
+ * stable {@link inputNode} and {@link outputNode} AudioNodes that the audio bus
+ * connects into the Web Audio graph. Async filters (e.g., worklet-based) expose
+ * a {@link ready} promise that resolves once the filter is fully initialized.
+ */
+class AudioFilter {
+    /** Resolves when the filter is fully initialized. Defaults to immediately-resolved for sync filters. */
+    get ready() { return Promise.resolve(); }
+}
+
+export { AudioFilter };
+//# sourceMappingURL=AudioFilter.js.map

package/dist/esm/audio/AudioFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioFilter.js","sources":["../../../../src/audio/AudioFilter.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;AAKG;MACmB,WAAW,CAAA;;IAM7B,IAAW,KAAK,KAAoB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;AAGjE;;;;"}

package/dist/esm/audio/AudioListener.d.ts

@@ -0,0 +1,39 @@
+import { Vector } from '@/math/Vector';
+import type { SceneNode } from '@/core/SceneNode';
+import type { View } from '@/rendering/View';
+/**
+ * Anything {@link AudioListener.target} can be set to. The listener reads
+ * its world-space position from the target each frame:
+ * - {@link SceneNode}: uses `getGlobalTransform()` translation
+ * - {@link View}: uses `view.center`
+ * - Plain `{ x, y }` object: read directly
+ * - `null`: no automatic tracking — set `position` manually.
+ */
+export type AudioListenerTarget = SceneNode | View | {
+    x: number;
+    y: number;
+} | null;
+/**
+ * Singleton observer position fed to the Web Audio panner nodes used by
+ * spatial sounds. Sets the listener orientation once at setup (forward = -Z,
+ * up = +Y for 2D scenes) and updates `positionX/Y/Z` (or legacy
+ * `setPosition`) every frame from {@link AudioListener.position} —
+ * which is in turn read from {@link AudioListener.target} when one is set.
+ *
+ * Owned by {@link AudioManager}; one instance per engine. `velocity` is a
+ * placeholder for future Doppler support (currently not piped to the Web
+ * Audio listener).
+ */
+export declare class AudioListener {
+    readonly position: Vector;
+    readonly velocity: Vector;
+    target: AudioListenerTarget;
+    private _audioListener;
+    private _ctx;
+    constructor();
+    /** Internal: called by AudioManager.update() once per frame. */
+    _tick(): void;
+    destroy(): void;
+    private _readTargetPosition;
+    private _setup;
+}

package/dist/esm/audio/AudioListener.js

@@ -0,0 +1,97 @@
+import { Vector } from '../math/Vector.js';
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from './audio-context.js';
+
+/**
+ * Singleton observer position fed to the Web Audio panner nodes used by
+ * spatial sounds. Sets the listener orientation once at setup (forward = -Z,
+ * up = +Y for 2D scenes) and updates `positionX/Y/Z` (or legacy
+ * `setPosition`) every frame from {@link AudioListener.position} —
+ * which is in turn read from {@link AudioListener.target} when one is set.
+ *
+ * Owned by {@link AudioManager}; one instance per engine. `velocity` is a
+ * placeholder for future Doppler support (currently not piped to the Web
+ * Audio listener).
+ */
+class AudioListener {
+    position = new Vector(0, 0);
+    velocity = new Vector(0, 0);
+    target = null;
+    _audioListener = null;
+    _ctx = null;
+    constructor() {
+        if (isAudioContextReady()) {
+            this._setup(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setup, this);
+        }
+    }
+    /** Internal: called by AudioManager.update() once per frame. */
+    _tick() {
+        if (this.target !== null) {
+            this._readTargetPosition();
+        }
+        if (this._audioListener !== null && this._ctx !== null) {
+            const t = this._ctx.currentTime;
+            const listener = this._audioListener;
+            if (listener.positionX) {
+                listener.positionX.setValueAtTime(this.position.x, t);
+                listener.positionY.setValueAtTime(this.position.y, t);
+                listener.positionZ.setValueAtTime(0, t);
+            }
+            else if (listener.setPosition) {
+                listener.setPosition(this.position.x, this.position.y, 0);
+            }
+        }
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        this.position.destroy();
+        this.velocity.destroy();
+        this.target = null;
+        this._audioListener = null;
+        this._ctx = null;
+    }
+    _readTargetPosition() {
+        const target = this.target;
+        if (target === null)
+            return;
+        // Check for SceneNode (has getGlobalTransform)
+        const asSceneNode = target;
+        if (typeof asSceneNode.getGlobalTransform === 'function') {
+            const m = asSceneNode.getGlobalTransform();
+            this.position.set(m.x, m.y);
+            return;
+        }
+        // Check for View (has center with x/y)
+        const asView = target;
+        if (asView.center !== undefined && typeof asView.center === 'object') {
+            this.position.set(asView.center.x, asView.center.y);
+            return;
+        }
+        // Plain { x, y } object
+        const plain = target;
+        this.position.set(plain.x, plain.y);
+    }
+    _setup(ctx) {
+        this._ctx = ctx;
+        this._audioListener = ctx.listener;
+        const t = ctx.currentTime;
+        const listener = ctx.listener;
+        // Set 2D orientation: forward = -Z (into screen), up = +Y (screen up)
+        if (listener.forwardX) {
+            listener.forwardX.setValueAtTime(0, t);
+            listener.forwardY.setValueAtTime(0, t);
+            listener.forwardZ.setValueAtTime(-1, t);
+            listener.upX.setValueAtTime(0, t);
+            listener.upY.setValueAtTime(1, t);
+            listener.upZ.setValueAtTime(0, t);
+        }
+        else if (listener.setOrientation) {
+            listener.setOrientation(0, 0, -1, 0, 1, 0);
+        }
+    }
+}
+
+export { AudioListener };
+//# sourceMappingURL=AudioListener.js.map

package/dist/esm/audio/AudioListener.js.map

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

package/dist/esm/audio/AudioManager.d.ts

@@ -0,0 +1,68 @@
+import { AudioBus } from './AudioBus';
+import { AudioListener } from './AudioListener';
+import type { Sound } from './Sound';
+/**
+ * Module-level singleton that owns the engine-wide audio mix: three
+ * pre-configured {@link AudioBus} instances (`master` ← `music` + `sound`),
+ * a single shared {@link AudioListener} for spatial audio, and a registry
+ * of any extra busses the user constructs.
+ *
+ * Access the singleton via {@link getAudioManager} (or `app.audio`). The
+ * instance is constructed lazily on first access so client code that does
+ * not need audio pays no startup cost.
+ *
+ * Drives the per-frame `_tick()` on the listener and every spatial sound;
+ * propagates visibility-driven mute when {@link AudioManager.muteOnHidden}
+ * is enabled.
+ */
+export declare class AudioManager {
+    readonly master: AudioBus;
+    readonly music: AudioBus;
+    readonly sound: AudioBus;
+    readonly listener: AudioListener;
+    private readonly _registered;
+    private readonly _spatialSounds;
+    private _muteOnHidden;
+    constructor();
+    /**
+     * When `true`, the master bus is muted while `document.hidden` is true.
+     * Wired to {@link Application.onVisibilityChange} via
+     * {@link AudioManager._applyVisibility}; the application calls that
+     * hook automatically — set this flag to opt in to the behavior.
+     */
+    get muteOnHidden(): boolean;
+    set muteOnHidden(value: boolean);
+    /** Called once per frame from Application.update(). */
+    update(): void;
+    /** Internal: called by Sound when it becomes spatial. */
+    _registerSpatialSound(sound: Sound): void;
+    /** Internal: called by Sound when it stops being spatial. */
+    _unregisterSpatialSound(sound: Sound): void;
+    /** Internal: called by Application when visibility changes. */
+    _applyVisibility(visible: boolean): void;
+    /**
+     * Register a user-constructed {@link AudioBus} so it can be looked up by
+     * name via {@link AudioManager.getBus}. Throws if a bus with the same
+     * name is already registered.
+     */
+    registerBus(bus: AudioBus): this;
+    /**
+     * Unregister and {@link AudioBus.destroy} a previously registered bus.
+     * Throws if you attempt to unregister one of the three built-ins
+     * (`master`, `music`, `sound`). No-op if the bus is unknown.
+     */
+    unregisterBus(bus: AudioBus): this;
+    /** Look up a bus by name. Throws if the name is not registered. */
+    getBus(name: string): AudioBus;
+    /** `true` when a bus with `name` has been registered. */
+    hasBus(name: string): boolean;
+    destroy(): void;
+}
+/**
+ * Lazy accessor for the singleton {@link AudioManager}. Constructs the
+ * instance on first call, returns the same instance for every subsequent
+ * call. Equivalent to `app.audio`.
+ */
+export declare function getAudioManager(): AudioManager;
+/** For tests: reset the singleton so fresh instances can be created. */
+export declare function _resetAudioManagerForTesting(): void;

package/dist/esm/audio/AudioManager.js

@@ -0,0 +1,139 @@
+import { AudioBus } from './AudioBus.js';
+import { AudioListener } from './AudioListener.js';
+
+/**
+ * Module-level singleton that owns the engine-wide audio mix: three
+ * pre-configured {@link AudioBus} instances (`master` ← `music` + `sound`),
+ * a single shared {@link AudioListener} for spatial audio, and a registry
+ * of any extra busses the user constructs.
+ *
+ * Access the singleton via {@link getAudioManager} (or `app.audio`). The
+ * instance is constructed lazily on first access so client code that does
+ * not need audio pays no startup cost.
+ *
+ * Drives the per-frame `_tick()` on the listener and every spatial sound;
+ * propagates visibility-driven mute when {@link AudioManager.muteOnHidden}
+ * is enabled.
+ */
+class AudioManager {
+    master;
+    music;
+    sound;
+    listener;
+    _registered = new Map();
+    _spatialSounds = new Set();
+    _muteOnHidden = false;
+    constructor() {
+        this.master = new AudioBus('master', { parent: null });
+        this.music = new AudioBus('music', { parent: this.master });
+        this.sound = new AudioBus('sound', { parent: this.master });
+        this.listener = new AudioListener();
+        // Built-ins are also lookup-able via getBus.
+        this._registered.set('master', this.master);
+        this._registered.set('music', this.music);
+        this._registered.set('sound', this.sound);
+    }
+    /**
+     * When `true`, the master bus is muted while `document.hidden` is true.
+     * Wired to {@link Application.onVisibilityChange} via
+     * {@link AudioManager._applyVisibility}; the application calls that
+     * hook automatically — set this flag to opt in to the behavior.
+     */
+    get muteOnHidden() {
+        return this._muteOnHidden;
+    }
+    set muteOnHidden(value) {
+        this._muteOnHidden = value;
+        // Wiring to app.onVisibilityChange happens externally — the
+        // Application is responsible for calling _applyVisibility() when
+        // visibility changes.
+    }
+    /** Called once per frame from Application.update(). */
+    update() {
+        this.listener._tick();
+        for (const sound of this._spatialSounds) {
+            sound._tickSpatial();
+        }
+    }
+    /** Internal: called by Sound when it becomes spatial. */
+    _registerSpatialSound(sound) {
+        this._spatialSounds.add(sound);
+    }
+    /** Internal: called by Sound when it stops being spatial. */
+    _unregisterSpatialSound(sound) {
+        this._spatialSounds.delete(sound);
+    }
+    /** Internal: called by Application when visibility changes. */
+    _applyVisibility(visible) {
+        if (this._muteOnHidden) {
+            this.master.muted = !visible;
+        }
+    }
+    /**
+     * Register a user-constructed {@link AudioBus} so it can be looked up by
+     * name via {@link AudioManager.getBus}. Throws if a bus with the same
+     * name is already registered.
+     */
+    registerBus(bus) {
+        if (this._registered.has(bus.name)) {
+            throw new Error(`Audio bus "${bus.name}" is already registered.`);
+        }
+        this._registered.set(bus.name, bus);
+        return this;
+    }
+    /**
+     * Unregister and {@link AudioBus.destroy} a previously registered bus.
+     * Throws if you attempt to unregister one of the three built-ins
+     * (`master`, `music`, `sound`). No-op if the bus is unknown.
+     */
+    unregisterBus(bus) {
+        if (bus === this.master || bus === this.music || bus === this.sound) {
+            throw new Error(`Cannot unregister built-in bus "${bus.name}".`);
+        }
+        const existing = this._registered.get(bus.name);
+        if (existing !== bus) {
+            // Either not registered, or different instance with same name.
+            return this;
+        }
+        this._registered.delete(bus.name);
+        bus.destroy();
+        return this;
+    }
+    /** Look up a bus by name. Throws if the name is not registered. */
+    getBus(name) {
+        const bus = this._registered.get(name);
+        if (!bus) {
+            throw new Error(`Audio bus "${name}" is not registered.`);
+        }
+        return bus;
+    }
+    /** `true` when a bus with `name` has been registered. */
+    hasBus(name) {
+        return this._registered.has(name);
+    }
+    destroy() {
+        this.listener.destroy();
+        this._spatialSounds.clear();
+        for (const bus of this._registered.values()) {
+            // Note: destroying built-ins too — AudioManager is destroyed only when app shuts down.
+            bus.destroy();
+        }
+        this._registered.clear();
+    }
+}
+// Module-level singleton (lazy)
+let _manager = null;
+/**
+ * Lazy accessor for the singleton {@link AudioManager}. Constructs the
+ * instance on first call, returns the same instance for every subsequent
+ * call. Equivalent to `app.audio`.
+ */
+function getAudioManager() {
+    if (_manager === null) {
+        _manager = new AudioManager();
+    }
+    return _manager;
+}
+
+export { AudioManager, getAudioManager };
+//# sourceMappingURL=AudioManager.js.map

package/dist/esm/audio/AudioManager.js.map

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