@codexo/exojs 0.6.12 → 0.7.11

package/dist/esm/audio/filters/LowpassFilter.js

@@ -0,0 +1,62 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+class LowpassFilter extends AudioFilter {
+    _node = null;
+    _frequency;
+    _resonance;
+    constructor(options = {}) {
+        super();
+        this._frequency = options.frequency ?? 1000;
+        this._resonance = options.resonance ?? 1;
+        if (isAudioContextReady()) {
+            this._setup(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setup, this);
+        }
+    }
+    get inputNode() {
+        if (!this._node)
+            throw new Error('LowpassFilter not yet initialized.');
+        return this._node;
+    }
+    get outputNode() {
+        if (!this._node)
+            throw new Error('LowpassFilter not yet initialized.');
+        return this._node;
+    }
+    get frequency() {
+        return this._frequency;
+    }
+    set frequency(value) {
+        this._frequency = Math.max(20, Math.min(20000, value));
+        if (this._node) {
+            this._node.frequency.setTargetAtTime(this._frequency, this._node.context.currentTime, 0.01);
+        }
+    }
+    get resonance() {
+        return this._resonance;
+    }
+    set resonance(value) {
+        this._resonance = Math.max(0.0001, value);
+        if (this._node) {
+            this._node.Q.setTargetAtTime(this._resonance, this._node.context.currentTime, 0.01);
+        }
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        this._node?.disconnect();
+        this._node = null;
+    }
+    _setup(ctx) {
+        const node = ctx.createBiquadFilter();
+        node.type = 'lowpass';
+        node.frequency.setValueAtTime(this._frequency, ctx.currentTime);
+        node.Q.setValueAtTime(this._resonance, ctx.currentTime);
+        this._node = node;
+    }
+}
+
+export { LowpassFilter };
+//# sourceMappingURL=LowpassFilter.js.map

package/dist/esm/audio/filters/LowpassFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LowpassFilter.js","sources":["../../../../../src/audio/filters/LowpassFilter.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAQM,MAAO,aAAc,SAAQ,WAAW,CAAA;IAClC,KAAK,GAA4B,IAAI;AACrC,IAAA,UAAU;AACV,IAAA,UAAU;AAElB,IAAA,WAAA,CAAmB,UAAgC,EAAE,EAAA;AACjD,QAAA,KAAK,EAAE;QACP,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI;QAC3C,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,CAAC;QACxC,IAAI,mBAAmB,EAAE,EAAE;AACvB,YAAA,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;QAClC;aAAO;YACH,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;QAC/C;IACJ;AAEA,IAAA,IAAW,SAAS,GAAA;QAChB,IAAI,CAAC,IAAI,CAAC,KAAK;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC;QACtE,OAAO,IAAI,CAAC,KAAK;IACrB;AAEA,IAAA,IAAW,UAAU,GAAA;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC;QACtE,OAAO,IAAI,CAAC,KAAK;IACrB;AAEA,IAAA,IAAW,SAAS,GAAA;QAChB,OAAO,IAAI,CAAC,UAAU;IAC1B;IAEA,IAAW,SAAS,CAAC,KAAa,EAAA;AAC9B,QAAA,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACtD,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;YACZ,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;QAC/F;IACJ;AAEA,IAAA,IAAW,SAAS,GAAA;QAChB,OAAO,IAAI,CAAC,UAAU;IAC1B;IAEA,IAAW,SAAS,CAAC,KAAa,EAAA;QAC9B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;AACzC,QAAA,IAAI,IAAI,CAAC,KAAK,EAAE;YACZ,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC;QACvF;IACJ;IAEgB,OAAO,GAAA;AACnB,QAAA,mBAAmB,CAAC,cAAc,CAAC,IAAI,CAAC;AACxC,QAAA,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE;AACxB,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI;IACrB;AAEQ,IAAA,MAAM,CAAC,GAAiB,EAAA;AAC5B,QAAA,MAAM,IAAI,GAAG,GAAG,CAAC,kBAAkB,EAAE;AACrC,QAAA,IAAI,CAAC,IAAI,GAAG,SAAS;AACrB,QAAA,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC;AAC/D,QAAA,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,WAAW,CAAC;AACvD,QAAA,IAAI,CAAC,KAAK,GAAG,IAAI;IACrB;AACH;;;;"}

package/dist/esm/audio/filters/PitchShiftFilter.d.ts

@@ -0,0 +1,42 @@
+import { WorkletFilter } from './WorkletFilter';
+export interface PitchShiftFilterOptions {
+    /** Pitch ratio. 1.0 = no change, 0.5 = octave down, 2.0 = octave up. Default 1.0. */
+    pitch?: number;
+    /** Dry/wet mix, 0..1. Default 1.0 (full wet). */
+    wet?: number;
+    /**
+     * Internal grain size in samples. Default 1024 (~21ms at 48kHz).
+     * Larger = more delay but cleaner pitch shifting.
+     */
+    grainSize?: number;
+}
+/**
+ * Real-time pitch shifter via granular synthesis (WorkletFilter).
+ *
+ * Quality: good for ±1 octave (pitch 0.5x-2.0x). Beyond that, audible
+ * artifacts (graininess, phase issues). For high-quality pitch shift,
+ * a phase-vocoder approach is required and not available in V1.
+ *
+ * Latency: ~half-grain-size = ~10ms at default 1024-sample grains
+ * (at 48kHz sample rate). Not suitable for live monitoring; fine for
+ * games / playback.
+ *
+ * Use cases:
+ *   - Sound variation: random ±200 cent pitch on each footstep / bullet
+ *   - Voice effects: chipmunk (1.5x) or demon (0.7x) for game NPCs
+ *   - Detune layering: stack 0.99x and 1.01x for thick chorused sound
+ */
+export declare class PitchShiftFilter extends WorkletFilter {
+    private _pitch;
+    private _wet;
+    private readonly _grainSize;
+    constructor(options?: PitchShiftFilterOptions);
+    protected get _workletName(): string;
+    protected get _workletSource(): string;
+    protected get _workletOptions(): AudioWorkletNodeOptions;
+    protected _onWorkletReady(): void;
+    get pitch(): number;
+    set pitch(value: number);
+    get wet(): number;
+    set wet(value: number);
+}

package/dist/esm/audio/filters/PitchShiftFilter.js

@@ -0,0 +1,130 @@
+import { WorkletFilter } from './WorkletFilter.js';
+
+const pitchShiftWorkletSource = `
+class PitchShiftProcessor extends AudioWorkletProcessor {
+    static get parameterDescriptors() {
+        return [
+            { name: 'pitch', defaultValue: 1.0, minValue: 0.25, maxValue: 4.0, automationRate: 'k-rate' },
+            { name: 'wet', defaultValue: 1.0, minValue: 0, maxValue: 1.0, automationRate: 'k-rate' },
+        ];
+    }
+
+    constructor(options) {
+        super();
+        const grainSize = options.processorOptions?.grainSize ?? 1024;
+        this._grainSize = grainSize;
+        this._bufferLength = grainSize * 4;
+        this._buffer = new Float32Array(this._bufferLength);
+        this._writePos = 0;
+        // Two staggered read positions for overlap-add
+        this._readPosA = 0;
+        this._readPosB = grainSize / 2;
+        this._hannWindow = this._buildHannWindow(grainSize);
+    }
+
+    _buildHannWindow(n) {
+        const w = new Float32Array(n);
+        for (let i = 0; i < n; i++) {
+            w[i] = 0.5 * (1 - Math.cos(2 * Math.PI * i / (n - 1)));
+        }
+        return w;
+    }
+
+    _readGrain(readPos) {
+        const grainSize = this._grainSize;
+        const idx = Math.floor(readPos);
+        const phase = idx % grainSize;  // position within the grain envelope
+        const win = this._hannWindow[phase];
+        const bufIdx = ((this._writePos - this._bufferLength + idx) % this._bufferLength + this._bufferLength) % this._bufferLength;
+        return this._buffer[bufIdx] * win;
+    }
+
+    process(inputs, outputs, parameters) {
+        const input = inputs[0]?.[0];
+        const output = outputs[0]?.[0];
+        if (!input || !output) return true;
+
+        const pitch = parameters.pitch[0];
+        const wet = parameters.wet[0];
+
+        for (let i = 0; i < input.length; i++) {
+            // Write to circular buffer
+            this._buffer[this._writePos] = input[i];
+            this._writePos = (this._writePos + 1) % this._bufferLength;
+
+            // Read two grains and sum
+            const grainA = this._readGrain(this._readPosA);
+            const grainB = this._readGrain(this._readPosB);
+            const shifted = grainA + grainB;
+
+            // Mix with dry
+            output[i] = (1 - wet) * input[i] + wet * shifted;
+
+            // Advance read positions at pitch rate
+            this._readPosA += pitch;
+            this._readPosB += pitch;
+            if (this._readPosA >= this._grainSize) this._readPosA -= this._grainSize;
+            if (this._readPosB >= this._grainSize) this._readPosB -= this._grainSize;
+        }
+        return true;
+    }
+}
+registerProcessor('exojs-pitch-shift', PitchShiftProcessor);
+`;
+/**
+ * Real-time pitch shifter via granular synthesis (WorkletFilter).
+ *
+ * Quality: good for ±1 octave (pitch 0.5x-2.0x). Beyond that, audible
+ * artifacts (graininess, phase issues). For high-quality pitch shift,
+ * a phase-vocoder approach is required and not available in V1.
+ *
+ * Latency: ~half-grain-size = ~10ms at default 1024-sample grains
+ * (at 48kHz sample rate). Not suitable for live monitoring; fine for
+ * games / playback.
+ *
+ * Use cases:
+ *   - Sound variation: random ±200 cent pitch on each footstep / bullet
+ *   - Voice effects: chipmunk (1.5x) or demon (0.7x) for game NPCs
+ *   - Detune layering: stack 0.99x and 1.01x for thick chorused sound
+ */
+class PitchShiftFilter extends WorkletFilter {
+    _pitch;
+    _wet;
+    _grainSize;
+    constructor(options = {}) {
+        super();
+        this._pitch = Math.max(0.25, Math.min(4.0, options.pitch ?? 1.0));
+        this._wet = Math.max(0, Math.min(1.0, options.wet ?? 1.0));
+        this._grainSize = options.grainSize ?? 1024;
+    }
+    get _workletName() {
+        return 'exojs-pitch-shift';
+    }
+    get _workletSource() {
+        return pitchShiftWorkletSource;
+    }
+    get _workletOptions() {
+        return {
+            numberOfInputs: 1,
+            numberOfOutputs: 1,
+            processorOptions: { grainSize: this._grainSize },
+        };
+    }
+    _onWorkletReady() {
+        this._setAudioParam('pitch', this._pitch);
+        this._setAudioParam('wet', this._wet);
+    }
+    get pitch() { return this._pitch; }
+    set pitch(value) {
+        this._pitch = Math.max(0.25, Math.min(4.0, value));
+        this._setAudioParam('pitch', this._pitch);
+    }
+    get wet() { return this._wet; }
+    set wet(value) {
+        this._wet = Math.max(0, Math.min(1.0, value));
+        this._setAudioParam('wet', this._wet);
+    }
+}
+
+export { PitchShiftFilter };
+//# sourceMappingURL=PitchShiftFilter.js.map

package/dist/esm/audio/filters/PitchShiftFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PitchShiftFilter.js","sources":["../../../../../src/audio/filters/PitchShiftFilter.ts"],"sourcesContent":[null],"names":[],"mappings":";;AAEA,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsE/B;AAcD;;;;;;;;;;;;;;;AAeG;AACG,MAAO,gBAAiB,SAAQ,aAAa,CAAA;AACvC,IAAA,MAAM;AACN,IAAA,IAAI;AACK,IAAA,UAAU;AAE3B,IAAA,WAAA,CAAmB,UAAmC,EAAE,EAAA;AACpD,QAAA,KAAK,EAAE;QACP,IAAI,CAAC,MAAM,GAAO,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC;QACrE,IAAI,CAAC,IAAI,GAAS,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC;QAChE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI;IAC/C;AAEA,IAAA,IAAc,YAAY,GAAA;AACtB,QAAA,OAAO,mBAAmB;IAC9B;AAEA,IAAA,IAAc,cAAc,GAAA;AACxB,QAAA,OAAO,uBAAuB;IAClC;AAEA,IAAA,IAAuB,eAAe,GAAA;QAClC,OAAO;AACH,YAAA,cAAc,EAAE,CAAC;AACjB,YAAA,eAAe,EAAE,CAAC;AAClB,YAAA,gBAAgB,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE;SACnD;IACL;IAEmB,eAAe,GAAA;QAC9B,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;IACzC;IAEA,IAAW,KAAK,KAAa,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,IAAW,KAAK,CAAC,KAAa,EAAA;AAC1B,QAAA,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClD,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC;IAC7C;IAEA,IAAW,GAAG,KAAa,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,IAAW,GAAG,CAAC,KAAa,EAAA;AACxB,QAAA,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC7C,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC;IACzC;AACH;;;;"}

package/dist/esm/audio/filters/ReverbFilter.d.ts

@@ -0,0 +1,24 @@
+import { AudioFilter } from '../AudioFilter';
+export interface ReverbFilterOptions {
+    durationSeconds?: number;
+    decay?: number;
+    wet?: number;
+}
+export declare class ReverbFilter extends AudioFilter {
+    private _setup;
+    private _duration;
+    private _decay;
+    private _wet;
+    constructor(options?: ReverbFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    get durationSeconds(): number;
+    set durationSeconds(value: number);
+    get decay(): number;
+    set decay(value: number);
+    get wet(): number;
+    set wet(value: number);
+    destroy(): void;
+    private _generateImpulseResponse;
+    private _setupNodes;
+}

package/dist/esm/audio/filters/ReverbFilter.js

@@ -0,0 +1,107 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+class ReverbFilter extends AudioFilter {
+    _setup = null;
+    _duration;
+    _decay;
+    _wet;
+    constructor(options = {}) {
+        super();
+        this._duration = Math.max(0.1, Math.min(5, options.durationSeconds ?? 2));
+        this._decay = Math.max(0.5, Math.min(10, options.decay ?? 2));
+        this._wet = Math.max(0, Math.min(1, options.wet ?? 0.4));
+        if (isAudioContextReady()) {
+            this._setupNodes(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupNodes, this);
+        }
+    }
+    get inputNode() {
+        if (!this._setup)
+            throw new Error('ReverbFilter not yet initialized.');
+        return this._setup.inputGain;
+    }
+    get outputNode() {
+        if (!this._setup)
+            throw new Error('ReverbFilter not yet initialized.');
+        return this._setup.outputGain;
+    }
+    get durationSeconds() {
+        return this._duration;
+    }
+    set durationSeconds(value) {
+        this._duration = Math.max(0.1, Math.min(5, value));
+        if (this._setup) {
+            this._setup.convolver.buffer = this._generateImpulseResponse(this._setup.convolver.context);
+        }
+    }
+    get decay() {
+        return this._decay;
+    }
+    set decay(value) {
+        this._decay = Math.max(0.5, Math.min(10, value));
+        if (this._setup) {
+            this._setup.convolver.buffer = this._generateImpulseResponse(this._setup.convolver.context);
+        }
+    }
+    get wet() {
+        return this._wet;
+    }
+    set wet(value) {
+        this._wet = Math.max(0, Math.min(1, value));
+        if (this._setup) {
+            const ctx = this._setup.wetGain.context;
+            this._setup.wetGain.gain.setTargetAtTime(this._wet, ctx.currentTime, 0.01);
+            this._setup.dryGain.gain.setTargetAtTime(1 - this._wet, ctx.currentTime, 0.01);
+        }
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        if (this._setup) {
+            this._setup.inputGain.disconnect();
+            this._setup.convolver.disconnect();
+            this._setup.dryGain.disconnect();
+            this._setup.wetGain.disconnect();
+            this._setup.outputGain.disconnect();
+            this._setup = null;
+        }
+    }
+    _generateImpulseResponse(ctx) {
+        const length = Math.floor(ctx.sampleRate * this._duration);
+        const buffer = ctx.createBuffer(2, length, ctx.sampleRate);
+        for (let channel = 0; channel < 2; channel++) {
+            const data = buffer.getChannelData(channel);
+            for (let i = 0; i < length; i++) {
+                const t = i / length;
+                const decayFactor = Math.pow(1 - t, this._decay);
+                data[i] = (Math.random() * 2 - 1) * decayFactor;
+            }
+        }
+        return buffer;
+    }
+    _setupNodes(ctx) {
+        const inputGain = ctx.createGain();
+        const outputGain = ctx.createGain();
+        const convolver = ctx.createConvolver();
+        const dryGain = ctx.createGain();
+        const wetGain = ctx.createGain();
+        inputGain.gain.setValueAtTime(1, ctx.currentTime);
+        outputGain.gain.setValueAtTime(1, ctx.currentTime);
+        dryGain.gain.setValueAtTime(1 - this._wet, ctx.currentTime);
+        wetGain.gain.setValueAtTime(this._wet, ctx.currentTime);
+        convolver.buffer = this._generateImpulseResponse(ctx);
+        // Dry path: input → dryGain → output
+        inputGain.connect(dryGain);
+        dryGain.connect(outputGain);
+        // Wet path: input → convolver → wetGain → output
+        inputGain.connect(convolver);
+        convolver.connect(wetGain);
+        wetGain.connect(outputGain);
+        this._setup = { inputGain, outputGain, convolver, dryGain, wetGain };
+    }
+}
+
+export { ReverbFilter };
+//# sourceMappingURL=ReverbFilter.js.map

package/dist/esm/audio/filters/ReverbFilter.js.map

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

package/dist/esm/audio/filters/VocoderFilter.d.ts

@@ -0,0 +1,38 @@
+import { WorkletFilter } from './WorkletFilter';
+import type { AudioBus } from '../AudioBus';
+export interface VocoderFilterOptions {
+    /** Modulator AudioBus — its output drives the spectral envelope.
+     *  Typically routed from a microphone or voice sample. */
+    modulator: AudioBus;
+    /** Number of frequency bands. More bands = better resolution, more CPU. Default 16. */
+    numBands?: number;
+    /** Lowest band center frequency in Hz. Default 80. */
+    minHz?: number;
+    /** Highest band center frequency in Hz. Default 8000. */
+    maxHz?: number;
+    /** Bandpass Q factor. Higher = narrower bands. Default 4. */
+    bandQ?: number;
+    /** Dry/wet mix, 0..1. Default 1.0. */
+    wet?: number;
+    /** Envelope follower smoothing factor (one-pole coefficient).
+     *  Smaller = smoother / slower. Default 0.005. */
+    envelopeSmoothing?: number;
+}
+export declare class VocoderFilter extends WorkletFilter {
+    private readonly _modulator;
+    private readonly _numBands;
+    private readonly _minHz;
+    private readonly _maxHz;
+    private readonly _bandQ;
+    private _wet;
+    private _envelopeSmoothing;
+    constructor(options: VocoderFilterOptions);
+    protected get _workletName(): string;
+    protected get _workletSource(): string;
+    protected get _workletOptions(): AudioWorkletNodeOptions;
+    protected _onWorkletReady(audioContext: AudioContext): void;
+    get wet(): number;
+    set wet(value: number);
+    get envelopeSmoothing(): number;
+    set envelopeSmoothing(value: number);
+}

package/dist/esm/audio/filters/VocoderFilter.js

@@ -0,0 +1,163 @@
+import { WorkletFilter } from './WorkletFilter.js';
+
+const vocoderWorkletSource = `
+const sampleRate = globalThis.sampleRate;
+
+class VocoderProcessor extends AudioWorkletProcessor {
+    static get parameterDescriptors() {
+        return [
+            { name: 'wet', defaultValue: 1.0, minValue: 0, maxValue: 1.0, automationRate: 'k-rate' },
+            { name: 'envelopeSmoothing', defaultValue: 0.005, minValue: 0.0001, maxValue: 0.1, automationRate: 'k-rate' },
+        ];
+    }
+
+    constructor(options) {
+        super();
+        const opts = options.processorOptions ?? {};
+        const numBands = opts.numBands ?? 16;
+        const minHz = opts.minHz ?? 80;
+        const maxHz = opts.maxHz ?? 8000;
+        const Q = opts.bandQ ?? 4;
+
+        // Log-spaced band centers + biquad coefficients
+        this._bands = [];
+        for (let i = 0; i < numBands; i++) {
+            const ratio = numBands === 1 ? 0 : i / (numBands - 1);
+            const centerHz = minHz * Math.pow(maxHz / minHz, ratio);
+            const omega = 2 * Math.PI * centerHz / sampleRate;
+            const cos = Math.cos(omega);
+            const sin = Math.sin(omega);
+            const alpha = sin / (2 * Q);
+
+            // Bandpass (constant 0 dB peak) biquad
+            const a0 = 1 + alpha;
+            const b0 = alpha / a0;
+            const b1 = 0;
+            const b2 = -alpha / a0;
+            const a1 = (-2 * cos) / a0;
+            const a2 = (1 - alpha) / a0;
+            this._bands.push({ b0, b1, b2, a1, a2 });
+        }
+
+        // Per-band biquad state (one for carrier, one for modulator)
+        this._carrierStates = this._bands.map(() => ({ x1: 0, x2: 0, y1: 0, y2: 0 }));
+        this._modulatorStates = this._bands.map(() => ({ x1: 0, x2: 0, y1: 0, y2: 0 }));
+
+        // Per-band envelope follower
+        this._envelopes = new Float32Array(numBands);
+    }
+
+    _processBiquad(state, coef, x) {
+        const y = coef.b0 * x + coef.b1 * state.x1 + coef.b2 * state.x2 - coef.a1 * state.y1 - coef.a2 * state.y2;
+        state.x2 = state.x1; state.x1 = x;
+        state.y2 = state.y1; state.y1 = y;
+        return y;
+    }
+
+    process(inputs, outputs, parameters) {
+        const carrier = inputs[0]?.[0];
+        const modulator = inputs[1]?.[0];
+        const output = outputs[0]?.[0];
+        if (!carrier || !output) return true;
+
+        const wet = parameters.wet[0];
+        const envSmoothing = parameters.envelopeSmoothing[0];
+        const numBands = this._bands.length;
+
+        for (let i = 0; i < carrier.length; i++) {
+            const carrierSample = carrier[i];
+            const modulatorSample = modulator?.[i] ?? 0;
+
+            let bandSum = 0;
+            for (let b = 0; b < numBands; b++) {
+                const coef = this._bands[b];
+
+                // Modulator band → envelope follower
+                const modBand = this._processBiquad(this._modulatorStates[b], coef, modulatorSample);
+                const target = Math.abs(modBand);
+                this._envelopes[b] += (target - this._envelopes[b]) * envSmoothing;
+
+                // Carrier band, scaled by modulator envelope
+                const carBand = this._processBiquad(this._carrierStates[b], coef, carrierSample);
+                bandSum += carBand * this._envelopes[b];
+            }
+
+            output[i] = (1 - wet) * carrierSample + wet * bandSum;
+        }
+        return true;
+    }
+}
+registerProcessor('exojs-vocoder', VocoderProcessor);
+`;
+class VocoderFilter extends WorkletFilter {
+    // Declared nullable because super() may trigger _onWorkletReady before the
+    // subclass constructor body runs (if construction is aborted by a throw).
+    _modulator = null;
+    _numBands;
+    _minHz;
+    _maxHz;
+    _bandQ;
+    _wet;
+    _envelopeSmoothing;
+    constructor(options) {
+        super();
+        if (!options.modulator) {
+            throw new Error('VocoderFilter requires a modulator AudioBus.');
+        }
+        this._modulator = options.modulator;
+        this._numBands = options.numBands ?? 16;
+        this._minHz = options.minHz ?? 80;
+        this._maxHz = options.maxHz ?? 8000;
+        this._bandQ = options.bandQ ?? 4;
+        this._wet = Math.max(0, Math.min(1, options.wet ?? 1.0));
+        this._envelopeSmoothing = Math.max(0.0001, Math.min(0.1, options.envelopeSmoothing ?? 0.005));
+    }
+    get _workletName() { return 'exojs-vocoder'; }
+    get _workletSource() { return vocoderWorkletSource; }
+    get _workletOptions() {
+        return {
+            numberOfInputs: 2,
+            numberOfOutputs: 1,
+            processorOptions: {
+                numBands: this._numBands,
+                minHz: this._minHz,
+                maxHz: this._maxHz,
+                bandQ: this._bandQ,
+            },
+        };
+    }
+    _onWorkletReady(audioContext) {
+        // Guard against partially-constructed instances (constructor threw after super()).
+        if (!this._modulator)
+            return;
+        this._setAudioParam('wet', this._wet);
+        this._setAudioParam('envelopeSmoothing', this._envelopeSmoothing);
+        // Wire modulator bus output to input 1 of the worklet
+        const modulator = this._modulator;
+        const modOutput = modulator._getOutputNode();
+        if (modOutput && this._workletNode) {
+            modOutput.connect(this._workletNode, 0, 1);
+        }
+        else {
+            modulator.onceSetup(() => {
+                const node = modulator._getOutputNode();
+                if (node && this._workletNode) {
+                    node.connect(this._workletNode, 0, 1);
+                }
+            });
+        }
+    }
+    get wet() { return this._wet; }
+    set wet(value) {
+        this._wet = Math.max(0, Math.min(1, value));
+        this._setAudioParam('wet', this._wet);
+    }
+    get envelopeSmoothing() { return this._envelopeSmoothing; }
+    set envelopeSmoothing(value) {
+        this._envelopeSmoothing = Math.max(0.0001, Math.min(0.1, value));
+        this._setAudioParam('envelopeSmoothing', this._envelopeSmoothing);
+    }
+}
+
+export { VocoderFilter };
+//# sourceMappingURL=VocoderFilter.js.map

package/dist/esm/audio/filters/VocoderFilter.js.map

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

package/dist/esm/audio/filters/WorkletFilter.d.ts

@@ -0,0 +1,46 @@
+import { AudioFilter } from '../AudioFilter';
+/**
+ * Base class for filters implemented as AudioWorkletProcessors. Subclasses
+ * declare the worklet's name, source code, and node options; this class
+ * handles the async lifecycle.
+ *
+ * Stable input/output nodes (GainNodes) are created immediately on setup.
+ * While the worklet loads asynchronously, audio passes through directly
+ * (effectively bypassing the filter for ~10-50ms during initial load).
+ * Once the worklet loads, it's inserted into the chain and audio routes
+ * through it.
+ *
+ * Subclasses can override `_onWorkletReady` to perform additional wiring
+ * (e.g., sidechain inputs).
+ */
+export declare abstract class WorkletFilter extends AudioFilter {
+    protected _inputGain: GainNode | null;
+    protected _outputGain: GainNode | null;
+    protected _workletNode: AudioWorkletNode | null;
+    protected _ready: Promise<void> | null;
+    /** The processor name registered via `registerProcessor()` in the worklet source. */
+    protected abstract get _workletName(): string;
+    /** The full worklet source code as a JavaScript string. */
+    protected abstract get _workletSource(): string;
+    /** AudioWorkletNode constructor options. Default: 1 input, 1 output. */
+    protected get _workletOptions(): AudioWorkletNodeOptions;
+    constructor();
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /**
+     * Resolves once the underlying worklet is loaded and inserted into the
+     * audio chain. Use this if you need to wait before applying parameters
+     * that depend on the worklet node.
+     */
+    get ready(): Promise<void>;
+    destroy(): void;
+    /**
+     * Subclass hook — called once when the worklet has loaded and the
+     * AudioWorkletNode is inserted into the chain. Use this for additional
+     * wiring (e.g., connecting a sidechain input).
+     */
+    protected _onWorkletReady?(audioContext: AudioContext): void;
+    /** Helper for subclasses: ramp an AudioParam smoothly. */
+    protected _setAudioParam(name: string, value: number): void;
+    private _setup;
+}