@codexo/exojs 0.12.0 → 0.14.0

package/dist/esm/audio/BaseVoice.js

@@ -0,0 +1,298 @@
+import { Signal } from '../core/Signal.js';
+import { clamp } from '../math/utils.js';
+import { Vector } from '../math/Vector.js';
+
+const defaultSpatialConfig = {
+    distanceModel: 'linear',
+    refDistance: 50,
+    maxDistance: 1000,
+    rolloffFactor: 1,
+};
+/**
+ * Shared base for the concrete voices ({@link SoundVoice},
+ * {@link AudioStreamVoice}, {@link AudioGeneratorVoice}). Implements the common
+ * {@link Voice} control surface — volume, fade, stop, lifecycle Signal, bus
+ * routing — and the {@link Spatializable} capability via a lazily-inserted
+ * `PannerNode`.
+ *
+ * The voice graph is `<source> → [panner] → output(gain) → bus.input`. The
+ * `output` gain is always the last node (a stable tap point); the panner is
+ * inserted between the source and the gain only once the voice is actually
+ * spatialized. Concrete voices provide the two source-specific hooks
+ * {@link BaseVoice._routeThroughPanner} and {@link BaseVoice._teardownSource}.
+ *
+ * @internal
+ */
+class BaseVoice {
+    _audioContext;
+    _output;
+    _manager;
+    _bus;
+    _volume;
+    _ended = false;
+    _stopTimer = null;
+    onEnd = new Signal();
+    _spatialConfig;
+    _panner = null;
+    _position = null;
+    _followNode = null;
+    _spatialRegistered = false;
+    /** Per-voice effect chain, inserted between the output gain and the bus. */
+    _effects = [];
+    constructor(init) {
+        this._audioContext = init.audioContext;
+        this._output = init.output;
+        this._bus = init.bus;
+        this._manager = init.manager;
+        this._volume = clamp(init.volume, 0, 1);
+        this._spatialConfig = { ...defaultSpatialConfig, ...init.spatial };
+        this._output.gain.setTargetAtTime(this._volume, this._audioContext.currentTime, 0.01);
+        if (init.autoConnect !== false) {
+            this._connectOutput();
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Voice
+    // -------------------------------------------------------------------------
+    get ended() {
+        return this._ended;
+    }
+    get output() {
+        return this._output;
+    }
+    get volume() {
+        return this._volume;
+    }
+    set volume(value) {
+        this._volume = clamp(value, 0, 1);
+        if (!this._ended) {
+            this._output.gain.setTargetAtTime(this._volume, this._audioContext.currentTime, 0.01);
+        }
+    }
+    get bus() {
+        return this._bus;
+    }
+    set bus(bus) {
+        if (bus === this._bus)
+            return;
+        if (this._ended) {
+            this._bus = bus;
+            return;
+        }
+        this._tail().disconnect();
+        this._bus = bus;
+        this._connectOutput();
+    }
+    addEffect(effect) {
+        if (this._ended)
+            return this;
+        this._effects.push(effect);
+        this._rebuildEffectChain();
+        return this;
+    }
+    removeEffect(effect) {
+        const index = this._effects.indexOf(effect);
+        if (index !== -1) {
+            this._effects.splice(index, 1);
+            // Detach the removed effect's output from the graph (its internal input
+            // wiring is left intact so the caller can reuse it). The rebuild below
+            // only touches the effects still in the chain.
+            effect.outputNode.disconnect();
+            this._rebuildEffectChain();
+        }
+        return this;
+    }
+    fade(to, ms) {
+        if (this._ended)
+            return;
+        const target = clamp(to, 0, 1);
+        this._volume = target;
+        const ctx = this._audioContext;
+        const node = this._output;
+        if (ms <= 0) {
+            node.gain.setTargetAtTime(target, ctx.currentTime, 0.01);
+            return;
+        }
+        node.gain.cancelScheduledValues(ctx.currentTime);
+        node.gain.setValueAtTime(node.gain.value, ctx.currentTime);
+        node.gain.linearRampToValueAtTime(target, ctx.currentTime + ms / 1000);
+    }
+    stop(fadeMs) {
+        if (this._ended)
+            return;
+        if (fadeMs !== undefined && fadeMs > 0) {
+            const ctx = this._audioContext;
+            const node = this._output;
+            node.gain.cancelScheduledValues(ctx.currentTime);
+            node.gain.setValueAtTime(node.gain.value, ctx.currentTime);
+            node.gain.linearRampToValueAtTime(0, ctx.currentTime + fadeMs / 1000);
+            this._clearStopTimer();
+            this._stopTimer = setTimeout(() => {
+                this._stopTimer = null;
+                this._finish();
+            }, fadeMs);
+            return;
+        }
+        this._finish();
+    }
+    // -------------------------------------------------------------------------
+    // Spatializable
+    // -------------------------------------------------------------------------
+    get position() {
+        return this._position;
+    }
+    set position(value) {
+        if (this._ended)
+            return;
+        if (value === null) {
+            if (this._position !== null) {
+                this._position.destroy();
+                this._position = null;
+            }
+            return;
+        }
+        if (this._position === null) {
+            this._position = new Vector(value.x, value.y);
+        }
+        else {
+            this._position.set(value.x, value.y);
+        }
+        this._ensurePanner();
+        this._tickSpatial();
+    }
+    follow(node) {
+        if (this._ended)
+            return;
+        this._followNode = node;
+        if (node !== null) {
+            this._ensurePanner();
+            this._tickSpatial();
+        }
+    }
+    /** @internal Called once per frame by {@link AudioManager.update} for spatial voices. */
+    _tickSpatial() {
+        if (this._panner === null || this._ended)
+            return;
+        let x;
+        let y;
+        if (this._followNode !== null) {
+            const transform = this._followNode.getGlobalTransform();
+            x = transform.x;
+            y = transform.y;
+        }
+        else if (this._position !== null) {
+            x = this._position.x;
+            y = this._position.y;
+        }
+        else {
+            return;
+        }
+        const panner = this._panner;
+        const t = this._audioContext.currentTime;
+        if (panner.positionX) {
+            panner.positionX.setValueAtTime(x, t);
+            panner.positionY.setValueAtTime(y, t);
+            panner.positionZ.setValueAtTime(0, t);
+        }
+        else if (panner.setPosition) {
+            panner.setPosition(x, y, 0);
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Internals
+    // -------------------------------------------------------------------------
+    /** The last node in the voice chain before the bus — the output gain, or the last effect. */
+    _tail() {
+        const lastEffect = this._effects[this._effects.length - 1];
+        return lastEffect !== undefined ? lastEffect.outputNode : this._output;
+    }
+    _connectOutput() {
+        this._connectTail(this._tail());
+    }
+    /** Connect `tail` to the bus input, or to the destination with a deferred reroute while the bus is still locked. */
+    _connectTail(tail) {
+        const input = this._bus._getInputNode();
+        if (input !== null) {
+            tail.connect(input);
+            return;
+        }
+        // Bus not set up yet (AudioContext still locked) — route to the destination
+        // for now and reconnect to the bus once it comes online.
+        tail.connect(this._audioContext.destination);
+        this._bus.onceSetup(() => {
+            if (this._ended)
+                return;
+            const node = this._bus._getInputNode();
+            if (node !== null) {
+                const current = this._tail();
+                current.disconnect();
+                current.connect(node);
+            }
+        });
+    }
+    /** Rewire `output → [effects...] → bus` after the per-voice effect chain changes. */
+    _rebuildEffectChain() {
+        if (this._ended)
+            return;
+        this._output.disconnect();
+        for (const effect of this._effects) {
+            effect.outputNode.disconnect();
+        }
+        let prev = this._output;
+        for (const effect of this._effects) {
+            prev.connect(effect.inputNode);
+            prev = effect.outputNode;
+        }
+        this._connectTail(prev);
+    }
+    _clearStopTimer() {
+        if (this._stopTimer !== null) {
+            clearTimeout(this._stopTimer);
+            this._stopTimer = null;
+        }
+    }
+    _ensurePanner() {
+        if (this._panner !== null || this._ended)
+            return;
+        const panner = this._audioContext.createPanner();
+        panner.panningModel = 'equalpower';
+        panner.distanceModel = this._spatialConfig.distanceModel;
+        panner.refDistance = this._spatialConfig.refDistance;
+        panner.maxDistance = this._spatialConfig.maxDistance;
+        panner.rolloffFactor = this._spatialConfig.rolloffFactor;
+        this._routeThroughPanner(panner);
+        this._panner = panner;
+        if (!this._spatialRegistered) {
+            this._spatialRegistered = true;
+            this._manager._registerSpatial(this);
+        }
+    }
+    /**
+     * Called once on natural end or explicit {@link BaseVoice.stop}. Idempotent —
+     * subsequent calls are no-ops once `_ended` is set.
+     */
+    _finish() {
+        if (this._ended)
+            return;
+        this._ended = true;
+        this._clearStopTimer();
+        this._teardownSource();
+        this._panner?.disconnect();
+        this._output.disconnect();
+        // Detach per-voice effects from the chain (the caller still owns them).
+        for (const effect of this._effects) {
+            effect.outputNode.disconnect();
+        }
+        this._effects.length = 0;
+        if (this._position !== null) {
+            this._position.destroy();
+            this._position = null;
+        }
+        this._followNode = null;
+        this.onEnd.dispatch();
+        this.onEnd.destroy();
+    }
+}
+
+export { BaseVoice };
+//# sourceMappingURL=BaseVoice.js.map

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

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

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

@@ -0,0 +1,53 @@
+import { AudioEffect } from './AudioEffect';
+/** Construction options for {@link BiquadEffect}. */
+export interface BiquadEffectOptions {
+    /** Filter response. Default `'lowpass'`. */
+    type?: BiquadFilterType;
+    /** Center / cutoff frequency in Hz. Range 0..nyquist. Default 1000. */
+    frequency?: number;
+    /** Quality factor (resonance / bandwidth). Default 1. */
+    resonance?: number;
+    /** Gain in dB — only used by `peaking`, `lowshelf`, `highshelf`. Default 0. */
+    gain?: number;
+    /** Fine frequency offset in cents. Default 0. */
+    detune?: number;
+}
+/**
+ * Native biquad filter effect backed by a single `BiquadFilterNode` — the most
+ * common audio-shaping need, covering `lowpass` / `highpass` / `bandpass` /
+ * `notch` / `peaking` / `lowshelf` / `highshelf` / `allpass` via one `type`
+ * parameter. Insert it on an {@link AudioBus} (`bus.addEffect`) or a
+ * {@link Voice} (`voice.addEffect`).
+ *
+ * The single node serves as both {@link inputNode} and {@link outputNode}.
+ */
+export declare class BiquadEffect extends AudioEffect {
+    private _node;
+    private _type;
+    private _frequency;
+    private _resonance;
+    private _gain;
+    private _detune;
+    private readonly _onAudioContextReady;
+    constructor(options?: BiquadEffectOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /** Filter response type. */
+    get type(): BiquadFilterType;
+    set type(value: BiquadFilterType);
+    /** Center / cutoff frequency in Hz. */
+    get frequency(): number;
+    set frequency(value: number);
+    /** Quality factor (resonance / bandwidth). */
+    get resonance(): number;
+    set resonance(value: number);
+    /** Gain in dB — applies to `peaking`, `lowshelf`, and `highshelf` types. */
+    get gain(): number;
+    set gain(value: number);
+    /** Fine frequency offset in cents. */
+    get detune(): number;
+    set detune(value: number);
+    destroy(): void;
+    private _setup;
+}
+//# sourceMappingURL=BiquadEffect.d.ts.map

package/dist/esm/audio/BiquadEffect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BiquadEffect.d.ts","sourceRoot":"","sources":["../../../src/audio/BiquadEffect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,4CAA4C;IAC5C,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,uEAAuE;IACvE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAGnC;gBAEiB,OAAO,GAAE,mBAAwB;IAepD,IAAW,SAAS,IAAI,SAAS,CAGhC;IAED,IAAW,UAAU,IAAI,SAAS,CAGjC;IAED,4BAA4B;IAC5B,IAAW,IAAI,IAAI,gBAAgB,CAElC;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,gBAAgB,EAGtC;IAED,uCAAuC;IACvC,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAGjC;IAED,8CAA8C;IAC9C,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,SAAS,CAAC,KAAK,EAAE,MAAM,EAGjC;IAED,4EAA4E;IAC5E,IAAW,IAAI,IAAI,MAAM,CAExB;IAED,IAAW,IAAI,CAAC,KAAK,EAAE,MAAM,EAG5B;IAED,sCAAsC;IACtC,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,KAAK,EAAE,MAAM,EAG9B;IAEe,OAAO,IAAI,IAAI;IAM/B,OAAO,CAAC,MAAM;CASf"}

package/dist/esm/audio/BiquadEffect.js

@@ -0,0 +1,110 @@
+import { onAudioContextReady, isAudioContextReady, getAudioContext } from './audio-context.js';
+import { AudioEffect } from './AudioEffect.js';
+
+/**
+ * Native biquad filter effect backed by a single `BiquadFilterNode` — the most
+ * common audio-shaping need, covering `lowpass` / `highpass` / `bandpass` /
+ * `notch` / `peaking` / `lowshelf` / `highshelf` / `allpass` via one `type`
+ * parameter. Insert it on an {@link AudioBus} (`bus.addEffect`) or a
+ * {@link Voice} (`voice.addEffect`).
+ *
+ * The single node serves as both {@link inputNode} and {@link outputNode}.
+ */
+class BiquadEffect extends AudioEffect {
+    _node = null;
+    _type;
+    _frequency;
+    _resonance;
+    _gain;
+    _detune;
+    _onAudioContextReady = (ctx) => {
+        onAudioContextReady.remove(this._onAudioContextReady);
+        this._setup(ctx);
+    };
+    constructor(options = {}) {
+        super();
+        this._type = options.type ?? 'lowpass';
+        this._frequency = options.frequency ?? 1000;
+        this._resonance = options.resonance ?? 1;
+        this._gain = options.gain ?? 0;
+        this._detune = options.detune ?? 0;
+        if (isAudioContextReady()) {
+            this._setup(getAudioContext());
+        }
+        else {
+            onAudioContextReady.add(this._onAudioContextReady);
+        }
+    }
+    get inputNode() {
+        if (!this._node)
+            throw new Error('BiquadEffect not yet initialized.');
+        return this._node;
+    }
+    get outputNode() {
+        if (!this._node)
+            throw new Error('BiquadEffect not yet initialized.');
+        return this._node;
+    }
+    /** Filter response type. */
+    get type() {
+        return this._type;
+    }
+    set type(value) {
+        this._type = value;
+        if (this._node)
+            this._node.type = value;
+    }
+    /** Center / cutoff frequency in Hz. */
+    get frequency() {
+        return this._frequency;
+    }
+    set frequency(value) {
+        this._frequency = value;
+        if (this._node)
+            this._node.frequency.setTargetAtTime(value, this._node.context.currentTime, 0.01);
+    }
+    /** Quality factor (resonance / bandwidth). */
+    get resonance() {
+        return this._resonance;
+    }
+    set resonance(value) {
+        this._resonance = value;
+        if (this._node)
+            this._node.Q.setTargetAtTime(value, this._node.context.currentTime, 0.01);
+    }
+    /** Gain in dB — applies to `peaking`, `lowshelf`, and `highshelf` types. */
+    get gain() {
+        return this._gain;
+    }
+    set gain(value) {
+        this._gain = value;
+        if (this._node)
+            this._node.gain.setTargetAtTime(value, this._node.context.currentTime, 0.01);
+    }
+    /** Fine frequency offset in cents. */
+    get detune() {
+        return this._detune;
+    }
+    set detune(value) {
+        this._detune = value;
+        if (this._node)
+            this._node.detune.setTargetAtTime(value, this._node.context.currentTime, 0.01);
+    }
+    destroy() {
+        onAudioContextReady.remove(this._onAudioContextReady);
+        this._node?.disconnect();
+        this._node = null;
+    }
+    _setup(ctx) {
+        const node = ctx.createBiquadFilter();
+        node.type = this._type;
+        node.frequency.setValueAtTime(this._frequency, ctx.currentTime);
+        node.Q.setValueAtTime(this._resonance, ctx.currentTime);
+        node.gain.setValueAtTime(this._gain, ctx.currentTime);
+        node.detune.setValueAtTime(this._detune, ctx.currentTime);
+        this._node = node;
+    }
+}
+
+export { BiquadEffect };
+//# sourceMappingURL=BiquadEffect.js.map

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

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

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

@@ -0,0 +1,41 @@
+import type { AudioBus } from './AudioBus';
+import { BaseVoice, type BaseVoiceInit } from './BaseVoice';
+import { Sound } from './Sound';
+/** Construction parameters for {@link InputVoice}. */
+export interface InputVoiceInit extends BaseVoiceInit {
+    sourceNode: MediaStreamAudioSourceNode;
+    stream: MediaStream;
+}
+/**
+ * Live control handle for an {@link AudioInput} (microphone / WebRTC stream),
+ * created via {@link AudioManager.open}. Unlike a {@link Playable} voice it is
+ * **analysis-only by default** — its output is not routed to a bus, so it never
+ * causes feedback. Tap it for visualisation/beat-detection (`new AudioAnalyser({
+ * source: inputVoice })`), opt into monitoring with {@link InputVoice.routeTo},
+ * or capture it with {@link InputVoice.record}.
+ *
+ * A live stream cannot be seeked, paused, looped, or rate-shifted, so it only
+ * mixes in {@link Spatializable} (via {@link BaseVoice}) on top of the base
+ * Voice surface (volume / fade / stop / effects / output tap / bus).
+ *
+ * @internal
+ */
+export declare class InputVoice extends BaseVoice {
+    private readonly _sourceNode;
+    private readonly _stream;
+    constructor(init: InputVoiceInit);
+    /**
+     * Make the live input audible by routing it to a bus (monitoring). Use
+     * sparingly — routing a microphone to the speakers risks feedback.
+     */
+    routeTo(bus: AudioBus): this;
+    /**
+     * Record `durationMs` of the live input and resolve with a playable
+     * {@link Sound}. Uses `MediaRecorder` under the hood, then decodes the
+     * captured blob into an `AudioBuffer`.
+     */
+    record(durationMs: number): Promise<Sound>;
+    protected _routeThroughPanner(panner: PannerNode): void;
+    protected _teardownSource(): void;
+}
+//# sourceMappingURL=InputVoice.d.ts.map

package/dist/esm/audio/InputVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InputVoice.d.ts","sourceRoot":"","sources":["../../../src/audio/InputVoice.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,sDAAsD;AACtD,MAAM,WAAW,cAAe,SAAQ,aAAa;IACnD,UAAU,EAAE,0BAA0B,CAAC;IACvC,MAAM,EAAE,WAAW,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAc;gBAEnB,IAAI,EAAE,cAAc;IAQvC;;;OAGG;IACI,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI;IAQnC;;;;OAIG;IACU,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;cAgCpC,mBAAmB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;cAM7C,eAAe,IAAI,IAAI;CAG3C"}

package/dist/esm/audio/InputVoice.js

@@ -0,0 +1,85 @@
+import { decodeAudioData } from './audio-context.js';
+import { BaseVoice } from './BaseVoice.js';
+import { Sound } from './Sound.js';
+
+/**
+ * Live control handle for an {@link AudioInput} (microphone / WebRTC stream),
+ * created via {@link AudioManager.open}. Unlike a {@link Playable} voice it is
+ * **analysis-only by default** — its output is not routed to a bus, so it never
+ * causes feedback. Tap it for visualisation/beat-detection (`new AudioAnalyser({
+ * source: inputVoice })`), opt into monitoring with {@link InputVoice.routeTo},
+ * or capture it with {@link InputVoice.record}.
+ *
+ * A live stream cannot be seeked, paused, looped, or rate-shifted, so it only
+ * mixes in {@link Spatializable} (via {@link BaseVoice}) on top of the base
+ * Voice surface (volume / fade / stop / effects / output tap / bus).
+ *
+ * @internal
+ */
+class InputVoice extends BaseVoice {
+    _sourceNode;
+    _stream;
+    constructor(init) {
+        // Analysis-only: do not connect to the bus until routeTo() is called.
+        super({ ...init, autoConnect: false });
+        this._sourceNode = init.sourceNode;
+        this._stream = init.stream;
+        this._sourceNode.connect(this._output);
+    }
+    /**
+     * Make the live input audible by routing it to a bus (monitoring). Use
+     * sparingly — routing a microphone to the speakers risks feedback.
+     */
+    routeTo(bus) {
+        if (this._ended)
+            return this;
+        this._tail().disconnect();
+        this._bus = bus;
+        this._connectOutput();
+        return this;
+    }
+    /**
+     * Record `durationMs` of the live input and resolve with a playable
+     * {@link Sound}. Uses `MediaRecorder` under the hood, then decodes the
+     * captured blob into an `AudioBuffer`.
+     */
+    async record(durationMs) {
+        const recorder = new MediaRecorder(this._stream);
+        const chunks = [];
+        recorder.addEventListener('dataavailable', event => {
+            if (event.data.size > 0)
+                chunks.push(event.data);
+        });
+        return new Promise((resolve, reject) => {
+            recorder.addEventListener('stop', () => {
+                void (async () => {
+                    try {
+                        const blob = new Blob(chunks, { type: recorder.mimeType || 'audio/webm' });
+                        const buffer = await decodeAudioData(await blob.arrayBuffer());
+                        resolve(new Sound(buffer));
+                    }
+                    catch (error) {
+                        reject(error instanceof Error ? error : new Error(String(error)));
+                    }
+                })();
+            });
+            recorder.addEventListener('error', () => reject(new Error('Recording failed.')));
+            recorder.start();
+            setTimeout(() => {
+                if (recorder.state !== 'inactive')
+                    recorder.stop();
+            }, Math.max(0, durationMs));
+        });
+    }
+    _routeThroughPanner(panner) {
+        this._sourceNode.disconnect();
+        this._sourceNode.connect(panner);
+        panner.connect(this._output);
+    }
+    _teardownSource() {
+        this._sourceNode.disconnect();
+    }
+}
+
+export { InputVoice };
+//# sourceMappingURL=InputVoice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InputVoice.js","sources":["../../../../src/audio/InputVoice.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAWA;;;;;;;;;;;;;AAaG;AACG,MAAO,UAAW,SAAQ,SAAS,CAAA;AACtB,IAAA,WAAW;AACX,IAAA,OAAO;AAExB,IAAA,WAAA,CAAmB,IAAoB,EAAA;;QAErC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;AACtC,QAAA,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU;AAClC,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM;QAC1B,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;IACxC;AAEA;;;AAGG;AACI,IAAA,OAAO,CAAC,GAAa,EAAA;QAC1B,IAAI,IAAI,CAAC,MAAM;AAAE,YAAA,OAAO,IAAI;AAC5B,QAAA,IAAI,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE;AACzB,QAAA,IAAI,CAAC,IAAI,GAAG,GAAG;QACf,IAAI,CAAC,cAAc,EAAE;AACrB,QAAA,OAAO,IAAI;IACb;AAEA;;;;AAIG;IACI,MAAM,MAAM,CAAC,UAAkB,EAAA;QACpC,MAAM,QAAQ,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC;QAChD,MAAM,MAAM,GAAW,EAAE;AAEzB,QAAA,QAAQ,CAAC,gBAAgB,CAAC,eAAe,EAAE,KAAK,IAAG;AACjD,YAAA,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAAE,gBAAA,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;AAClD,QAAA,CAAC,CAAC;QAEF,OAAO,IAAI,OAAO,CAAQ,CAAC,OAAO,EAAE,MAAM,KAAI;AAC5C,YAAA,QAAQ,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAK;gBACrC,KAAK,CAAC,YAA0B;AAC9B,oBAAA,IAAI;AACF,wBAAA,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,QAAQ,IAAI,YAAY,EAAE,CAAC;wBAC1E,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;AAC9D,wBAAA,OAAO,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC;oBAC5B;oBAAE,OAAO,KAAK,EAAE;wBACd,MAAM,CAAC,KAAK,YAAY,KAAK,GAAG,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;oBACnE;gBACF,CAAC,GAAG;AACN,YAAA,CAAC,CAAC;AACF,YAAA,QAAQ,CAAC,gBAAgB,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAEhF,QAAQ,CAAC,KAAK,EAAE;YAChB,UAAU,CACR,MAAK;AACH,gBAAA,IAAI,QAAQ,CAAC,KAAK,KAAK,UAAU;oBAAE,QAAQ,CAAC,IAAI,EAAE;YACpD,CAAC,EACD,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CACxB;AACH,QAAA,CAAC,CAAC;IACJ;AAEmB,IAAA,mBAAmB,CAAC,MAAkB,EAAA;AACvD,QAAA,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;AAC7B,QAAA,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;AAChC,QAAA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC;IAC9B;IAEmB,eAAe,GAAA;AAChC,QAAA,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE;IAC/B;AACD;;;;"}

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

@@ -0,0 +1,29 @@
+import { Signal } from '#core/Signal';
+import type { AudioBus } from './AudioBus';
+import type { AudioEffect } from './AudioEffect';
+import type { Voice } from './Playable';
+/**
+ * An already-ended {@link Voice} returned for degenerate play calls — a seek
+ * offset past the asset's duration, or a generator played before the
+ * `AudioContext` is unlocked. All controls are inert; `ended` is `true` from
+ * the start and {@link NoopVoice.onEnd} never fires.
+ *
+ * @internal
+ */
+export declare class NoopVoice implements Voice {
+    readonly onEnd: Signal<[]>;
+    private readonly _bus;
+    private _output;
+    constructor(bus: AudioBus);
+    get ended(): boolean;
+    get output(): AudioNode;
+    get volume(): number;
+    set volume(_value: number);
+    get bus(): AudioBus;
+    set bus(_bus: AudioBus);
+    fade(_to: number, _ms: number): void;
+    stop(_fadeMs?: number): void;
+    addEffect(_effect: AudioEffect): this;
+    removeEffect(_effect: AudioEffect): this;
+}
+//# sourceMappingURL=NoopVoice.d.ts.map

package/dist/esm/audio/NoopVoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NoopVoice.d.ts","sourceRoot":"","sources":["../../../src/audio/NoopVoice.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC;;;;;;;GAOG;AACH,qBAAa,SAAU,YAAW,KAAK;IACrC,SAAgB,KAAK,aAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,OAAO,CAA0B;gBAEtB,GAAG,EAAE,QAAQ;IAIhC,IAAW,KAAK,IAAI,OAAO,CAE1B;IAED,IAAW,MAAM,IAAI,SAAS,CAE7B;IAED,IAAW,MAAM,IAAI,MAAM,CAE1B;IAED,IAAW,MAAM,CAAC,MAAM,EAAE,MAAM,EAE/B;IAED,IAAW,GAAG,IAAI,QAAQ,CAEzB;IAED,IAAW,GAAG,CAAC,IAAI,EAAE,QAAQ,EAE5B;IAEM,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAIpC,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5B,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAIrC,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAGhD"}