@codexo/exojs 0.6.12 → 0.7.12

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

@@ -0,0 +1,34 @@
+import { AudioFilter } from '../AudioFilter';
+/** Construction options for {@link DelayFilter}. */
+export interface DelayFilterOptions {
+    delaySeconds?: number;
+    feedback?: number;
+    wet?: number;
+}
+/**
+ * Echo/delay effect using a Web Audio `DelayNode` with a feedback loop and
+ * dry/wet mix. The feedback path feeds the delayed signal back into itself,
+ * producing repeating echoes that decay naturally. Setting `feedback` near
+ * its maximum of 0.95 produces a long, prominent tail; lower values create
+ * a single slap-back echo.
+ */
+export declare class DelayFilter extends AudioFilter {
+    private _setup;
+    private _delaySeconds;
+    private _feedback;
+    private _wet;
+    constructor(options?: DelayFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /** Delay time in seconds. Range 0..5, default 0.3. */
+    get delaySeconds(): number;
+    set delaySeconds(value: number);
+    /** Fraction of the delayed signal fed back into the delay input. Range 0..0.95, default 0.4. */
+    get feedback(): number;
+    set feedback(value: number);
+    /** Wet (delayed) mix level, 0..1. The dry level is automatically `1 - wet`. Default 0.5. */
+    get wet(): number;
+    set wet(value: number);
+    destroy(): void;
+    private _setupNodes;
+}

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

@@ -0,0 +1,110 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+/**
+ * Echo/delay effect using a Web Audio `DelayNode` with a feedback loop and
+ * dry/wet mix. The feedback path feeds the delayed signal back into itself,
+ * producing repeating echoes that decay naturally. Setting `feedback` near
+ * its maximum of 0.95 produces a long, prominent tail; lower values create
+ * a single slap-back echo.
+ */
+class DelayFilter extends AudioFilter {
+    _setup = null;
+    _delaySeconds;
+    _feedback;
+    _wet;
+    constructor(options = {}) {
+        super();
+        this._delaySeconds = Math.max(0, Math.min(5, options.delaySeconds ?? 0.3));
+        this._feedback = Math.max(0, Math.min(0.95, options.feedback ?? 0.4));
+        this._wet = Math.max(0, Math.min(1, options.wet ?? 0.5));
+        if (isAudioContextReady()) {
+            this._setupNodes(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupNodes, this);
+        }
+    }
+    get inputNode() {
+        if (!this._setup)
+            throw new Error('DelayFilter not yet initialized.');
+        return this._setup.inputGain;
+    }
+    get outputNode() {
+        if (!this._setup)
+            throw new Error('DelayFilter not yet initialized.');
+        return this._setup.outputGain;
+    }
+    /** Delay time in seconds. Range 0..5, default 0.3. */
+    get delaySeconds() {
+        return this._delaySeconds;
+    }
+    set delaySeconds(value) {
+        this._delaySeconds = Math.max(0, Math.min(5, value));
+        if (this._setup) {
+            this._setup.delayNode.delayTime.setTargetAtTime(this._delaySeconds, this._setup.delayNode.context.currentTime, 0.01);
+        }
+    }
+    /** Fraction of the delayed signal fed back into the delay input. Range 0..0.95, default 0.4. */
+    get feedback() {
+        return this._feedback;
+    }
+    set feedback(value) {
+        this._feedback = Math.max(0, Math.min(0.95, value));
+        if (this._setup) {
+            this._setup.feedbackGain.gain.setTargetAtTime(this._feedback, this._setup.feedbackGain.context.currentTime, 0.01);
+        }
+    }
+    /** Wet (delayed) mix level, 0..1. The dry level is automatically `1 - wet`. Default 0.5. */
+    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.delayNode.disconnect();
+            this._setup.feedbackGain.disconnect();
+            this._setup.dryGain.disconnect();
+            this._setup.wetGain.disconnect();
+            this._setup.outputGain.disconnect();
+            this._setup = null;
+        }
+    }
+    _setupNodes(ctx) {
+        const inputGain = ctx.createGain();
+        const outputGain = ctx.createGain();
+        const delayNode = ctx.createDelay(5);
+        const feedbackGain = ctx.createGain();
+        const dryGain = ctx.createGain();
+        const wetGain = ctx.createGain();
+        inputGain.gain.setValueAtTime(1, ctx.currentTime);
+        outputGain.gain.setValueAtTime(1, ctx.currentTime);
+        delayNode.delayTime.setValueAtTime(this._delaySeconds, ctx.currentTime);
+        feedbackGain.gain.setValueAtTime(this._feedback, ctx.currentTime);
+        dryGain.gain.setValueAtTime(1 - this._wet, ctx.currentTime);
+        wetGain.gain.setValueAtTime(this._wet, ctx.currentTime);
+        // Dry path: input → dryGain → output
+        inputGain.connect(dryGain);
+        dryGain.connect(outputGain);
+        // Wet path: input → delay → wetGain → output
+        inputGain.connect(delayNode);
+        delayNode.connect(wetGain);
+        wetGain.connect(outputGain);
+        // Feedback loop: delay → feedbackGain → delay
+        delayNode.connect(feedbackGain);
+        feedbackGain.connect(delayNode);
+        this._setup = { inputGain, outputGain, delayNode, feedbackGain, dryGain, wetGain };
+    }
+}
+
+export { DelayFilter };
+//# sourceMappingURL=DelayFilter.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { WorkletFilter } from './WorkletFilter';
+import type { AudioBus } from '../AudioBus';
+/** Construction options for {@link DuckingFilter}. `sidechain` is required. */
+export interface DuckingFilterOptions {
+    sidechain: AudioBus;
+    threshold?: number;
+    ratio?: number;
+    attackMs?: number;
+    releaseMs?: number;
+}
+/**
+ * Sidechain compressor (ducker) implemented as an {@link WorkletFilter}.
+ * Attenuates the main audio signal whenever the `sidechain` {@link AudioBus}
+ * exceeds the threshold, then releases when it drops back down. Commonly used
+ * to duck background music under dialogue or sound effects. Attack and release
+ * times are expressed in milliseconds and converted internally to one-pole
+ * filter coefficients.
+ */
+export declare class DuckingFilter extends WorkletFilter {
+    private readonly _sidechain;
+    private _threshold;
+    private _ratio;
+    private _attackMs;
+    private _releaseMs;
+    constructor(options: DuckingFilterOptions);
+    protected get _workletName(): string;
+    protected get _workletSource(): string;
+    protected get _workletOptions(): AudioWorkletNodeOptions;
+    protected _onWorkletReady(audioContext: AudioContext): void;
+    /** Convert ms time-constant to one-pole filter coefficient at given sample rate. */
+    private _msToCoeff;
+    /** Sidechain level above which the main signal is attenuated, in dBFS. Range −100..0, default −20. */
+    get threshold(): number;
+    set threshold(value: number);
+    /** Compression ratio applied to the main signal above the threshold. Range 1..20, default 4. */
+    get ratio(): number;
+    set ratio(value: number);
+    /** Attack time in milliseconds — how quickly the ducker engages. Default 30. */
+    get attackMs(): number;
+    set attackMs(value: number);
+    /** Release time in milliseconds — how quickly the ducker disengages. Default 300. */
+    get releaseMs(): number;
+    set releaseMs(value: number);
+}

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

@@ -0,0 +1,164 @@
+import { WorkletFilter } from './WorkletFilter.js';
+
+const duckingWorkletSource = `
+class DuckingProcessor extends AudioWorkletProcessor {
+    static get parameterDescriptors() {
+        return [
+            { name: 'threshold', defaultValue: -20, minValue: -100, maxValue: 0, automationRate: 'k-rate' },
+            { name: 'ratio', defaultValue: 4, minValue: 1, maxValue: 20, automationRate: 'k-rate' },
+            { name: 'attack', defaultValue: 0.03, minValue: 0.001, maxValue: 1, automationRate: 'k-rate' },
+            { name: 'release', defaultValue: 0.3, minValue: 0.001, maxValue: 5, automationRate: 'k-rate' },
+        ];
+    }
+
+    constructor() {
+        super();
+        this._envelope = 0;
+    }
+
+    process(inputs, outputs, parameters) {
+        const main = inputs[0];
+        const sidechain = inputs[1];
+        const output = outputs[0];
+
+        if (!main || main.length === 0 || !output || output.length === 0) {
+            return true;
+        }
+
+        const threshold = parameters.threshold[0];
+        const ratio = parameters.ratio[0];
+        const attackCoeff = parameters.attack[0];
+        const releaseCoeff = parameters.release[0];
+
+        const blockLength = main[0]?.length ?? 0;
+        for (let i = 0; i < blockLength; i++) {
+            // Sidechain RMS sample (mono-mix L+R for detection)
+            let scSample = 0;
+            if (sidechain && sidechain.length > 0) {
+                const left = sidechain[0]?.[i] ?? 0;
+                const right = sidechain[1]?.[i] ?? left;
+                scSample = (Math.abs(left) + Math.abs(right)) * 0.5;
+            }
+
+            // Envelope follower
+            const coeff = scSample > this._envelope ? attackCoeff : releaseCoeff;
+            this._envelope += (scSample - this._envelope) * coeff;
+
+            // Compute gain reduction in dB
+            const envDb = 20 * Math.log10(this._envelope + 1e-9);
+            const overshoot = Math.max(0, envDb - threshold);
+            const reduction = overshoot * (1 - 1 / ratio);
+            const gain = Math.pow(10, -reduction / 20);
+
+            // Apply to all main channels
+            for (let ch = 0; ch < main.length; ch++) {
+                const mainCh = main[ch];
+                const outCh = output[ch];
+                if (mainCh && outCh && i < mainCh.length) {
+                    outCh[i] = mainCh[i] * gain;
+                }
+            }
+        }
+
+        return true;
+    }
+}
+registerProcessor('exojs-ducking', DuckingProcessor);
+`;
+/**
+ * Sidechain compressor (ducker) implemented as an {@link WorkletFilter}.
+ * Attenuates the main audio signal whenever the `sidechain` {@link AudioBus}
+ * exceeds the threshold, then releases when it drops back down. Commonly used
+ * to duck background music under dialogue or sound effects. Attack and release
+ * times are expressed in milliseconds and converted internally to one-pole
+ * filter coefficients.
+ */
+class DuckingFilter extends WorkletFilter {
+    // Declared nullable because super() may trigger _onWorkletReady before the
+    // subclass constructor body runs (if construction is aborted by a throw).
+    _sidechain = null;
+    _threshold;
+    _ratio;
+    _attackMs;
+    _releaseMs;
+    constructor(options) {
+        super();
+        if (!options.sidechain) {
+            throw new Error('DuckingFilter requires a sidechain AudioBus.');
+        }
+        this._sidechain = options.sidechain;
+        this._threshold = options.threshold ?? -20;
+        this._ratio = options.ratio ?? 4;
+        this._attackMs = options.attackMs ?? 30;
+        this._releaseMs = options.releaseMs ?? 300;
+    }
+    get _workletName() {
+        return 'exojs-ducking';
+    }
+    get _workletSource() {
+        return duckingWorkletSource;
+    }
+    get _workletOptions() {
+        return { numberOfInputs: 2, numberOfOutputs: 1 };
+    }
+    _onWorkletReady(audioContext) {
+        // Guard against partially-constructed instances (constructor threw after super()).
+        if (!this._sidechain)
+            return;
+        // Apply current parameter values
+        this._setAudioParam('threshold', this._threshold);
+        this._setAudioParam('ratio', this._ratio);
+        this._setAudioParam('attack', this._msToCoeff(this._attackMs, audioContext.sampleRate));
+        this._setAudioParam('release', this._msToCoeff(this._releaseMs, audioContext.sampleRate));
+        // Wire sidechain to input 1 of the worklet
+        const sidechain = this._sidechain;
+        const sidechainOut = sidechain._getOutputNode();
+        if (sidechainOut && this._workletNode) {
+            sidechainOut.connect(this._workletNode, 0, 1);
+        }
+        else {
+            sidechain.onceSetup(() => {
+                const node = sidechain._getOutputNode();
+                if (node && this._workletNode) {
+                    node.connect(this._workletNode, 0, 1);
+                }
+            });
+        }
+    }
+    /** Convert ms time-constant to one-pole filter coefficient at given sample rate. */
+    _msToCoeff(ms, sampleRate) {
+        const tau = (ms * 0.001) * sampleRate;
+        return 1 - Math.exp(-1 / Math.max(1, tau));
+    }
+    /** Sidechain level above which the main signal is attenuated, in dBFS. Range −100..0, default −20. */
+    get threshold() { return this._threshold; }
+    set threshold(value) {
+        this._threshold = Math.max(-100, Math.min(0, value));
+        this._setAudioParam('threshold', this._threshold);
+    }
+    /** Compression ratio applied to the main signal above the threshold. Range 1..20, default 4. */
+    get ratio() { return this._ratio; }
+    set ratio(value) {
+        this._ratio = Math.max(1, Math.min(20, value));
+        this._setAudioParam('ratio', this._ratio);
+    }
+    /** Attack time in milliseconds — how quickly the ducker engages. Default 30. */
+    get attackMs() { return this._attackMs; }
+    set attackMs(value) {
+        this._attackMs = Math.max(0.001, value);
+        if (this._workletNode) {
+            this._setAudioParam('attack', this._msToCoeff(this._attackMs, this._workletNode.context.sampleRate));
+        }
+    }
+    /** Release time in milliseconds — how quickly the ducker disengages. Default 300. */
+    get releaseMs() { return this._releaseMs; }
+    set releaseMs(value) {
+        this._releaseMs = Math.max(0.001, value);
+        if (this._workletNode) {
+            this._setAudioParam('release', this._msToCoeff(this._releaseMs, this._workletNode.context.sampleRate));
+        }
+    }
+}
+
+export { DuckingFilter };
+//# sourceMappingURL=DuckingFilter.js.map

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

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

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

@@ -0,0 +1,49 @@
+import { AudioFilter } from '../AudioFilter';
+/** Construction options for {@link EqualizerFilter}. */
+export interface EqualizerFilterOptions {
+    low?: number;
+    mid?: number;
+    high?: number;
+    lowFrequency?: number;
+    midFrequency?: number;
+    highFrequency?: number;
+}
+/**
+ * Three-band equalizer (low shelf / peaking mid / high shelf) built from a
+ * series chain of `BiquadFilterNode` instances. Gain values are in dB and
+ * clamped to ±40 dB. All six parameters (gains + frequencies) are
+ * adjustable at runtime via the corresponding setters; gain changes use a
+ * short exponential ramp to avoid clicks.
+ */
+export declare class EqualizerFilter extends AudioFilter {
+    private _setup;
+    private _low;
+    private _mid;
+    private _high;
+    private _lowFrequency;
+    private _midFrequency;
+    private _highFrequency;
+    constructor(options?: EqualizerFilterOptions);
+    get inputNode(): AudioNode;
+    get outputNode(): AudioNode;
+    /** Low-shelf gain in dB applied below `lowFrequency`. Range −40..40, default 0. */
+    get low(): number;
+    set low(value: number);
+    /** Peaking mid-band gain in dB centered at `midFrequency`. Range −40..40, default 0. */
+    get mid(): number;
+    set mid(value: number);
+    /** High-shelf gain in dB applied above `highFrequency`. Range −40..40, default 0. */
+    get high(): number;
+    set high(value: number);
+    /** Cutoff frequency in Hz of the low-shelf band. Default 250. */
+    get lowFrequency(): number;
+    set lowFrequency(value: number);
+    /** Center frequency in Hz of the peaking mid band. Default 1500. */
+    get midFrequency(): number;
+    set midFrequency(value: number);
+    /** Cutoff frequency in Hz of the high-shelf band. Default 6000. */
+    get highFrequency(): number;
+    set highFrequency(value: number);
+    destroy(): void;
+    private _setupNodes;
+}

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

@@ -0,0 +1,134 @@
+import { isAudioContextReady, getAudioContext, onAudioContextReady } from '../audio-context.js';
+import { AudioFilter } from '../AudioFilter.js';
+
+/**
+ * Three-band equalizer (low shelf / peaking mid / high shelf) built from a
+ * series chain of `BiquadFilterNode` instances. Gain values are in dB and
+ * clamped to ±40 dB. All six parameters (gains + frequencies) are
+ * adjustable at runtime via the corresponding setters; gain changes use a
+ * short exponential ramp to avoid clicks.
+ */
+class EqualizerFilter extends AudioFilter {
+    _setup = null;
+    _low;
+    _mid;
+    _high;
+    _lowFrequency;
+    _midFrequency;
+    _highFrequency;
+    constructor(options = {}) {
+        super();
+        this._low = Math.max(-40, Math.min(40, options.low ?? 0));
+        this._mid = Math.max(-40, Math.min(40, options.mid ?? 0));
+        this._high = Math.max(-40, Math.min(40, options.high ?? 0));
+        this._lowFrequency = options.lowFrequency ?? 250;
+        this._midFrequency = options.midFrequency ?? 1500;
+        this._highFrequency = options.highFrequency ?? 6000;
+        if (isAudioContextReady()) {
+            this._setupNodes(getAudioContext());
+        }
+        else {
+            onAudioContextReady.once(this._setupNodes, this);
+        }
+    }
+    get inputNode() {
+        if (!this._setup)
+            throw new Error('EqualizerFilter not yet initialized.');
+        return this._setup.lowShelf;
+    }
+    get outputNode() {
+        if (!this._setup)
+            throw new Error('EqualizerFilter not yet initialized.');
+        return this._setup.highShelf;
+    }
+    /** Low-shelf gain in dB applied below `lowFrequency`. Range −40..40, default 0. */
+    get low() {
+        return this._low;
+    }
+    set low(value) {
+        this._low = Math.max(-40, Math.min(40, value));
+        if (this._setup) {
+            this._setup.lowShelf.gain.setTargetAtTime(this._low, this._setup.lowShelf.context.currentTime, 0.01);
+        }
+    }
+    /** Peaking mid-band gain in dB centered at `midFrequency`. Range −40..40, default 0. */
+    get mid() {
+        return this._mid;
+    }
+    set mid(value) {
+        this._mid = Math.max(-40, Math.min(40, value));
+        if (this._setup) {
+            this._setup.peaking.gain.setTargetAtTime(this._mid, this._setup.peaking.context.currentTime, 0.01);
+        }
+    }
+    /** High-shelf gain in dB applied above `highFrequency`. Range −40..40, default 0. */
+    get high() {
+        return this._high;
+    }
+    set high(value) {
+        this._high = Math.max(-40, Math.min(40, value));
+        if (this._setup) {
+            this._setup.highShelf.gain.setTargetAtTime(this._high, this._setup.highShelf.context.currentTime, 0.01);
+        }
+    }
+    /** Cutoff frequency in Hz of the low-shelf band. Default 250. */
+    get lowFrequency() {
+        return this._lowFrequency;
+    }
+    set lowFrequency(value) {
+        this._lowFrequency = Math.max(0, value);
+        if (this._setup) {
+            this._setup.lowShelf.frequency.setTargetAtTime(this._lowFrequency, this._setup.lowShelf.context.currentTime, 0.01);
+        }
+    }
+    /** Center frequency in Hz of the peaking mid band. Default 1500. */
+    get midFrequency() {
+        return this._midFrequency;
+    }
+    set midFrequency(value) {
+        this._midFrequency = Math.max(0, value);
+        if (this._setup) {
+            this._setup.peaking.frequency.setTargetAtTime(this._midFrequency, this._setup.peaking.context.currentTime, 0.01);
+        }
+    }
+    /** Cutoff frequency in Hz of the high-shelf band. Default 6000. */
+    get highFrequency() {
+        return this._highFrequency;
+    }
+    set highFrequency(value) {
+        this._highFrequency = Math.max(0, value);
+        if (this._setup) {
+            this._setup.highShelf.frequency.setTargetAtTime(this._highFrequency, this._setup.highShelf.context.currentTime, 0.01);
+        }
+    }
+    destroy() {
+        onAudioContextReady.clearByContext(this);
+        if (this._setup) {
+            this._setup.lowShelf.disconnect();
+            this._setup.peaking.disconnect();
+            this._setup.highShelf.disconnect();
+            this._setup = null;
+        }
+    }
+    _setupNodes(ctx) {
+        const lowShelf = ctx.createBiquadFilter();
+        lowShelf.type = 'lowshelf';
+        lowShelf.frequency.setValueAtTime(this._lowFrequency, ctx.currentTime);
+        lowShelf.gain.setValueAtTime(this._low, ctx.currentTime);
+        const peaking = ctx.createBiquadFilter();
+        peaking.type = 'peaking';
+        peaking.frequency.setValueAtTime(this._midFrequency, ctx.currentTime);
+        peaking.gain.setValueAtTime(this._mid, ctx.currentTime);
+        const highShelf = ctx.createBiquadFilter();
+        highShelf.type = 'highshelf';
+        highShelf.frequency.setValueAtTime(this._highFrequency, ctx.currentTime);
+        highShelf.gain.setValueAtTime(this._high, ctx.currentTime);
+        // Series chain: lowShelf → peaking → highShelf
+        lowShelf.connect(peaking);
+        peaking.connect(highShelf);
+        this._setup = { lowShelf, peaking, highShelf };
+    }
+}
+
+export { EqualizerFilter };
+//# sourceMappingURL=EqualizerFilter.js.map

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

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

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

@@ -0,0 +1,62 @@
+import { WorkletFilter } from './WorkletFilter';
+export interface GranularFilterOptions {
+    /** Grain size in seconds. 0.005-0.5. Default 0.05 (50ms). */
+    grainSize?: number;
+    /** Grains per second (overlap density). 1-500. Default 50. */
+    density?: number;
+    /** Random offset spread, 0-1. Higher = wider time-window scatter. Default 0.5. */
+    spread?: number;
+    /** Minimum random pitch ratio per grain. Default 1.0. */
+    pitchMin?: number;
+    /** Maximum random pitch ratio per grain. Default 1.0. */
+    pitchMax?: number;
+    /** Dry/wet mix, 0..1. Default 1.0. */
+    wet?: number;
+    /** Internal circular-buffer length in seconds. Compile-time, not runtime. Default 2. */
+    bufferSeconds?: number;
+}
+/**
+ * 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.
+ */
+export declare class GranularFilter extends WorkletFilter {
+    private _grainSize;
+    private _density;
+    private _spread;
+    private _pitchMin;
+    private _pitchMax;
+    private _wet;
+    private readonly _bufferSeconds;
+    constructor(options?: GranularFilterOptions);
+    protected get _workletName(): string;
+    protected get _workletSource(): string;
+    protected get _workletOptions(): AudioWorkletNodeOptions;
+    protected _onWorkletReady(): void;
+    /** Duration of each grain in seconds. Range 0.005..0.5, default 0.05. */
+    get grainSize(): number;
+    set grainSize(value: number);
+    /** Number of grains spawned per second. Range 1..500, default 50. */
+    get density(): number;
+    set density(value: number);
+    /** Random time-offset spread for grain start positions, 0..1. Higher values scatter grains further into the past. Default 0.5. */
+    get spread(): number;
+    set spread(value: number);
+    /** Minimum per-grain pitch ratio. Range 0.25..4, default 1.0. */
+    get pitchMin(): number;
+    set pitchMin(value: number);
+    /** Maximum per-grain pitch ratio. Range 0.25..4, default 1.0. */
+    get pitchMax(): number;
+    set pitchMax(value: number);
+    /** Wet (granular) mix level, 0..1. Default 1.0. */
+    get wet(): number;
+    set wet(value: number);
+}