@codexo/exojs 0.6.12 → 0.7.12

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

@@ -0,0 +1,176 @@
+import { WorkletFilter } from './WorkletFilter.js';
+
+const granularWorkletSource = `
+const sampleRate = globalThis.sampleRate;
+
+class GranularProcessor extends AudioWorkletProcessor {
+    static get parameterDescriptors() {
+        return [
+            { name: 'grainSize', defaultValue: 0.05, minValue: 0.005, maxValue: 0.5, automationRate: 'k-rate' },
+            { name: 'density', defaultValue: 50, minValue: 1, maxValue: 500, automationRate: 'k-rate' },
+            { name: 'spread', defaultValue: 0.5, minValue: 0, maxValue: 1.0, automationRate: 'k-rate' },
+            { name: 'pitchMin', defaultValue: 1.0, minValue: 0.25, maxValue: 4.0, automationRate: 'k-rate' },
+            { name: 'pitchMax', 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 opts = options.processorOptions ?? {};
+        const bufferSeconds = opts.bufferSeconds ?? 2;
+        this._bufferLength = Math.floor(bufferSeconds * sampleRate);
+        this._buffer = new Float32Array(this._bufferLength);
+        this._writePos = 0;
+        this._timeUntilNextGrainSamples = 0;
+        this._grains = [];  // { startPos, ageSamples, lengthSamples, pitch }
+    }
+
+    process(inputs, outputs, parameters) {
+        const input = inputs[0]?.[0];
+        const output = outputs[0]?.[0];
+        if (!input || !output) return true;
+
+        const grainSize = parameters.grainSize[0];
+        const density = parameters.density[0];
+        const spread = parameters.spread[0];
+        const pitchMin = parameters.pitchMin[0];
+        const pitchMax = parameters.pitchMax[0];
+        const wet = parameters.wet[0];
+
+        const grainSizeSamples = Math.max(8, Math.floor(grainSize * sampleRate));
+        const samplesPerGrain = sampleRate / Math.max(1, density);
+
+        for (let i = 0; i < input.length; i++) {
+            // Write input to circular buffer
+            this._buffer[this._writePos] = input[i];
+            this._writePos = (this._writePos + 1) % this._bufferLength;
+
+            // Spawn new grain if scheduled
+            this._timeUntilNextGrainSamples -= 1;
+            if (this._timeUntilNextGrainSamples <= 0) {
+                // Random offset into recent past, biased by spread
+                const maxOffset = Math.floor(spread * this._bufferLength);
+                const offset = Math.floor(Math.random() * Math.max(1, maxOffset));
+                const startPos = (this._writePos - offset - grainSizeSamples + this._bufferLength) % this._bufferLength;
+                // Random pitch in [pitchMin, pitchMax]
+                const pitch = pitchMin + Math.random() * Math.max(0, pitchMax - pitchMin);
+
+                this._grains.push({ startPos, ageSamples: 0, lengthSamples: grainSizeSamples, pitch });
+                this._timeUntilNextGrainSamples = samplesPerGrain;
+            }
+
+            // Mix all active grains (apply Hann window)
+            let grainSum = 0;
+            for (let g = this._grains.length - 1; g >= 0; g--) {
+                const grain = this._grains[g];
+                if (grain.ageSamples >= grain.lengthSamples) {
+                    this._grains.splice(g, 1);
+                    continue;
+                }
+
+                const phase = grain.ageSamples / grain.lengthSamples;
+                const window = 0.5 * (1 - Math.cos(2 * Math.PI * phase));
+                const readPos = grain.startPos + grain.ageSamples * grain.pitch;
+                const idx = Math.floor(readPos) % this._bufferLength;
+                const safeIdx = (idx + this._bufferLength) % this._bufferLength;
+                grainSum += this._buffer[safeIdx] * window;
+
+                grain.ageSamples++;
+            }
+
+            output[i] = (1 - wet) * input[i] + wet * grainSum;
+        }
+        return true;
+    }
+}
+registerProcessor('exojs-granular', GranularProcessor);
+`;
+/**
+ * Granular synthesis filter — slices input into small Hann-windowed grains
+ * and replays them with randomized parameters. Use cases:
+ *
+ *   - Ambient texture: long grain (200ms+), low density (10-30/s), high
+ *     spread, pitch range 0.5-1.5x. Creates evolving pad-like sounds.
+ *   - Glitch: short grain (10-20ms), high density (100+/s), very high
+ *     spread, pitch range 0.7-1.3x. Stuttering, lo-fi effects.
+ *   - Time-stretch (low pitch with overlap): grain ~50ms, density 50/s,
+ *     spread 0, pitch 1.0. Pseudo-stretches the input by buffering.
+ *   - Pitch cloud: medium grain, medium density, pitchMin 0.5, pitchMax 2.0
+ *     gives a "shimmer" effect of overlapping pitches.
+ */
+class GranularFilter extends WorkletFilter {
+    _grainSize;
+    _density;
+    _spread;
+    _pitchMin;
+    _pitchMax;
+    _wet;
+    _bufferSeconds;
+    constructor(options = {}) {
+        super();
+        this._grainSize = Math.max(0.005, Math.min(0.5, options.grainSize ?? 0.05));
+        this._density = Math.max(1, Math.min(500, options.density ?? 50));
+        this._spread = Math.max(0, Math.min(1, options.spread ?? 0.5));
+        this._pitchMin = Math.max(0.25, Math.min(4, options.pitchMin ?? 1.0));
+        this._pitchMax = Math.max(0.25, Math.min(4, options.pitchMax ?? 1.0));
+        this._wet = Math.max(0, Math.min(1, options.wet ?? 1.0));
+        this._bufferSeconds = options.bufferSeconds ?? 2;
+    }
+    get _workletName() { return 'exojs-granular'; }
+    get _workletSource() { return granularWorkletSource; }
+    get _workletOptions() {
+        return {
+            numberOfInputs: 1,
+            numberOfOutputs: 1,
+            processorOptions: { bufferSeconds: this._bufferSeconds },
+        };
+    }
+    _onWorkletReady() {
+        this._setAudioParam('grainSize', this._grainSize);
+        this._setAudioParam('density', this._density);
+        this._setAudioParam('spread', this._spread);
+        this._setAudioParam('pitchMin', this._pitchMin);
+        this._setAudioParam('pitchMax', this._pitchMax);
+        this._setAudioParam('wet', this._wet);
+    }
+    /** Duration of each grain in seconds. Range 0.005..0.5, default 0.05. */
+    get grainSize() { return this._grainSize; }
+    set grainSize(value) {
+        this._grainSize = Math.max(0.005, Math.min(0.5, value));
+        this._setAudioParam('grainSize', this._grainSize);
+    }
+    /** Number of grains spawned per second. Range 1..500, default 50. */
+    get density() { return this._density; }
+    set density(value) {
+        this._density = Math.max(1, Math.min(500, value));
+        this._setAudioParam('density', this._density);
+    }
+    /** Random time-offset spread for grain start positions, 0..1. Higher values scatter grains further into the past. Default 0.5. */
+    get spread() { return this._spread; }
+    set spread(value) {
+        this._spread = Math.max(0, Math.min(1, value));
+        this._setAudioParam('spread', this._spread);
+    }
+    /** Minimum per-grain pitch ratio. Range 0.25..4, default 1.0. */
+    get pitchMin() { return this._pitchMin; }
+    set pitchMin(value) {
+        this._pitchMin = Math.max(0.25, Math.min(4, value));
+        this._setAudioParam('pitchMin', this._pitchMin);
+    }
+    /** Maximum per-grain pitch ratio. Range 0.25..4, default 1.0. */
+    get pitchMax() { return this._pitchMax; }
+    set pitchMax(value) {
+        this._pitchMax = Math.max(0.25, Math.min(4, value));
+        this._setAudioParam('pitchMax', this._pitchMax);
+    }
+    /** Wet (granular) mix level, 0..1. Default 1.0. */
+    get wet() { return this._wet; }
+    set wet(value) {
+        this._wet = Math.max(0, Math.min(1, value));
+        this._setAudioParam('wet', this._wet);
+    }
+}
+
+export { GranularFilter };
+//# sourceMappingURL=GranularFilter.js.map

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

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

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

@@ -0,0 +1,29 @@
+import { AudioFilter } from '../AudioFilter';
+/** Construction options for {@link HighpassFilter}. */
+export interface HighpassFilterOptions {
+    frequency?: number;
+    resonance?: number;
+}
+/**
+ * High-pass filter backed by a `BiquadFilterNode` in `highpass` mode.
+ * Attenuates frequencies below the cutoff and passes everything above it.
+ * Useful for removing low-frequency rumble, thinning out bass-heavy audio,
+ * or sculpting mix headroom. The `resonance` (Q) parameter controls the
+ * sharpness of the roll-off peak at the cutoff frequency.
+ */
+export declare class HighpassFilter extends AudioFilter {
+    private _node;
+    private _frequency;
+    private _resonance;
+    constructor(options?: HighpassFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /** Cutoff frequency in Hz. Signals below this frequency are attenuated. Range 20..20000, default 1000. */
+    get frequency(): number;
+    set frequency(value: number);
+    /** Q (resonance) at the cutoff. Higher values create a sharper, resonant peak. Minimum 0.0001, default 1. */
+    get resonance(): number;
+    set resonance(value: number);
+    destroy(): void;
+    private _setup;
+}

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

@@ -0,0 +1,71 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+/**
+ * High-pass filter backed by a `BiquadFilterNode` in `highpass` mode.
+ * Attenuates frequencies below the cutoff and passes everything above it.
+ * Useful for removing low-frequency rumble, thinning out bass-heavy audio,
+ * or sculpting mix headroom. The `resonance` (Q) parameter controls the
+ * sharpness of the roll-off peak at the cutoff frequency.
+ */
+class HighpassFilter 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('HighpassFilter not yet initialized.');
+        return this._node;
+    }
+    get outputNode() {
+        if (!this._node)
+            throw new Error('HighpassFilter not yet initialized.');
+        return this._node;
+    }
+    /** Cutoff frequency in Hz. Signals below this frequency are attenuated. Range 20..20000, default 1000. */
+    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);
+        }
+    }
+    /** Q (resonance) at the cutoff. Higher values create a sharper, resonant peak. Minimum 0.0001, default 1. */
+    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 = 'highpass';
+        node.frequency.setValueAtTime(this._frequency, ctx.currentTime);
+        node.Q.setValueAtTime(this._resonance, ctx.currentTime);
+        this._node = node;
+    }
+}
+
+export { HighpassFilter };
+//# sourceMappingURL=HighpassFilter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"HighpassFilter.js","sources":["../../../../../src/audio/filters/HighpassFilter.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AASA;;;;;;AAMG;AACG,MAAO,cAAe,SAAQ,WAAW,CAAA;IACnC,KAAK,GAA4B,IAAI;AACrC,IAAA,UAAU;AACV,IAAA,UAAU;AAElB,IAAA,WAAA,CAAmB,UAAiC,EAAE,EAAA;AAClD,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,qCAAqC,CAAC;QACvE,OAAO,IAAI,CAAC,KAAK;IACrB;AAEA,IAAA,IAAW,UAAU,GAAA;QACjB,IAAI,CAAC,IAAI,CAAC,KAAK;AAAE,YAAA,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC;QACvE,OAAO,IAAI,CAAC,KAAK;IACrB;;AAGA,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;;AAGA,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,UAAU;AACtB,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/LowpassFilter.d.ts

@@ -0,0 +1,29 @@
+import { AudioFilter } from '../AudioFilter';
+/** Construction options for {@link LowpassFilter}. */
+export interface LowpassFilterOptions {
+    frequency?: number;
+    resonance?: number;
+}
+/**
+ * Low-pass filter backed by a `BiquadFilterNode` in `lowpass` mode.
+ * Attenuates frequencies above the cutoff and passes everything below it.
+ * Useful for muffling audio (e.g., sound heard through a wall), taming
+ * harsh high-frequency content, or creating underwater/telephone effects.
+ * The `resonance` (Q) parameter controls the sharpness of the roll-off peak.
+ */
+export declare class LowpassFilter extends AudioFilter {
+    private _node;
+    private _frequency;
+    private _resonance;
+    constructor(options?: LowpassFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /** Cutoff frequency in Hz. Signals above this frequency are attenuated. Range 20..20000, default 1000. */
+    get frequency(): number;
+    set frequency(value: number);
+    /** Q (resonance) at the cutoff. Higher values create a sharper, resonant peak. Minimum 0.0001, default 1. */
+    get resonance(): number;
+    set resonance(value: number);
+    destroy(): void;
+    private _setup;
+}

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

@@ -0,0 +1,71 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+/**
+ * Low-pass filter backed by a `BiquadFilterNode` in `lowpass` mode.
+ * Attenuates frequencies above the cutoff and passes everything below it.
+ * Useful for muffling audio (e.g., sound heard through a wall), taming
+ * harsh high-frequency content, or creating underwater/telephone effects.
+ * The `resonance` (Q) parameter controls the sharpness of the roll-off peak.
+ */
+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;
+    }
+    /** Cutoff frequency in Hz. Signals above this frequency are attenuated. Range 20..20000, default 1000. */
+    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);
+        }
+    }
+    /** Q (resonance) at the cutoff. Higher values create a sharper, resonant peak. Minimum 0.0001, default 1. */
+    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":";;;AASA;;;;;;AAMG;AACG,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;;AAGA,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;;AAGA,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,44 @@
+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;
+    /** Pitch ratio relative to the original. 1.0 = no change, 0.5 = one octave down, 2.0 = one octave up. Range 0.25..4.0, default 1.0. */
+    get pitch(): number;
+    set pitch(value: number);
+    /** Wet (pitch-shifted) mix level, 0..1. Default 1.0 (full wet). */
+    get wet(): number;
+    set wet(value: number);
+}

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

@@ -0,0 +1,132 @@
+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);
+    }
+    /** Pitch ratio relative to the original. 1.0 = no change, 0.5 = one octave down, 2.0 = one octave up. Range 0.25..4.0, default 1.0. */
+    get pitch() { return this._pitch; }
+    set pitch(value) {
+        this._pitch = Math.max(0.25, Math.min(4.0, value));
+        this._setAudioParam('pitch', this._pitch);
+    }
+    /** Wet (pitch-shifted) mix level, 0..1. Default 1.0 (full wet). */
+    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;;IAGA,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;;IAGA,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,36 @@
+import { AudioFilter } from '../AudioFilter';
+/** Construction options for {@link ReverbFilter}. */
+export interface ReverbFilterOptions {
+    durationSeconds?: number;
+    decay?: number;
+    wet?: number;
+}
+/**
+ * Convolution reverb using a procedurally-generated impulse response loaded
+ * into a `ConvolverNode`. The impulse response is a stereo noise burst whose
+ * amplitude decays exponentially, simulating room reflections. Adjusting
+ * `durationSeconds` or `decay` rebuilds the impulse response immediately, so
+ * avoid animating these properties at audio rate — use `wet` for real-time
+ * mix control instead.
+ */
+export declare class ReverbFilter extends AudioFilter {
+    private _setup;
+    private _duration;
+    private _decay;
+    private _wet;
+    constructor(options?: ReverbFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /** Length of the generated impulse response in seconds. Range 0.1..5, default 2. Changing this rebuilds the IR buffer. */
+    get durationSeconds(): number;
+    set durationSeconds(value: number);
+    /** Exponential decay rate of the impulse response. Higher values produce a tighter, drier reverb tail. Range 0.5..10, default 2. Changing this rebuilds the IR buffer. */
+    get decay(): number;
+    set decay(value: number);
+    /** Wet (reverberated) mix level, 0..1. The dry level is automatically `1 - wet`. Default 0.4. */
+    get wet(): number;
+    set wet(value: number);
+    destroy(): void;
+    private _generateImpulseResponse;
+    private _setupNodes;
+}