tone 14.8.27

package/build/esm/component/filter/BiquadFilter.d.ts

@@ -0,0 +1,64 @@
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Cents, Frequency, GainFactor } from "../../core/type/Units";
+import { Param } from "../../core/context/Param";
+export interface BiquadFilterOptions extends ToneAudioNodeOptions {
+    frequency: Frequency;
+    detune: Cents;
+    Q: number;
+    type: BiquadFilterType;
+    gain: GainFactor;
+}
+/**
+ * Thin wrapper around the native Web Audio [BiquadFilterNode](https://webaudio.github.io/web-audio-api/#biquadfilternode).
+ * BiquadFilter is similar to [[Filter]] but doesn't have the option to set the "rolloff" value.
+ * @category Component
+ */
+export declare class BiquadFilter extends ToneAudioNode<BiquadFilterOptions> {
+    readonly name: string;
+    readonly input: BiquadFilterNode;
+    readonly output: BiquadFilterNode;
+    /**
+     * The frequency of the filter
+     */
+    readonly frequency: Param<"frequency">;
+    /**
+     * A detune value, in cents, for the frequency.
+     */
+    readonly detune: Param<"cents">;
+    /**
+     * The Q factor of the filter.
+     * For lowpass and highpass filters the Q value is interpreted to be in dB.
+     * For these filters the nominal range is [−𝑄𝑙𝑖𝑚,𝑄𝑙𝑖𝑚] where 𝑄𝑙𝑖𝑚 is the largest value for which 10𝑄/20 does not overflow. This is approximately 770.63678.
+     * For the bandpass, notch, allpass, and peaking filters, this value is a linear value.
+     * The value is related to the bandwidth of the filter and hence should be a positive value. The nominal range is
+     * [0,3.4028235𝑒38], the upper limit being the most-positive-single-float.
+     * This is not used for the lowshelf and highshelf filters.
+     */
+    readonly Q: Param<"number">;
+    /**
+     * The gain of the filter. Its value is in dB units. The gain is only used for lowshelf, highshelf, and peaking filters.
+     */
+    readonly gain: Param<"decibels">;
+    private readonly _filter;
+    /**
+     * @param frequency The cutoff frequency of the filter.
+     * @param type The type of filter.
+     */
+    constructor(frequency?: Frequency, type?: BiquadFilterType);
+    constructor(options?: Partial<BiquadFilterOptions>);
+    static getDefaults(): BiquadFilterOptions;
+    /**
+     * The type of this BiquadFilterNode. For a complete list of types and their attributes, see the
+     * [Web Audio API](https://webaudio.github.io/web-audio-api/#dom-biquadfiltertype-lowpass)
+     */
+    get type(): BiquadFilterType;
+    set type(type: BiquadFilterType);
+    /**
+     * Get the frequency response curve. This curve represents how the filter
+     * responses to frequencies between 20hz-20khz.
+     * @param  len The number of values to return
+     * @return The frequency response curve between 20-20kHz
+     */
+    getFrequencyResponse(len?: number): Float32Array;
+    dispose(): this;
+}

package/build/esm/component/filter/BiquadFilter.js

@@ -0,0 +1,101 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Param } from "../../core/context/Param";
+import { assert } from "../../core/util/Debug";
+/**
+ * Thin wrapper around the native Web Audio [BiquadFilterNode](https://webaudio.github.io/web-audio-api/#biquadfilternode).
+ * BiquadFilter is similar to [[Filter]] but doesn't have the option to set the "rolloff" value.
+ * @category Component
+ */
+export class BiquadFilter extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(BiquadFilter.getDefaults(), arguments, ["frequency", "type"]));
+        this.name = "BiquadFilter";
+        const options = optionsFromArguments(BiquadFilter.getDefaults(), arguments, ["frequency", "type"]);
+        this._filter = this.context.createBiquadFilter();
+        this.input = this.output = this._filter;
+        this.Q = new Param({
+            context: this.context,
+            units: "number",
+            value: options.Q,
+            param: this._filter.Q,
+        });
+        this.frequency = new Param({
+            context: this.context,
+            units: "frequency",
+            value: options.frequency,
+            param: this._filter.frequency,
+        });
+        this.detune = new Param({
+            context: this.context,
+            units: "cents",
+            value: options.detune,
+            param: this._filter.detune,
+        });
+        this.gain = new Param({
+            context: this.context,
+            units: "decibels",
+            convert: false,
+            value: options.gain,
+            param: this._filter.gain,
+        });
+        this.type = options.type;
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            Q: 1,
+            type: "lowpass",
+            frequency: 350,
+            detune: 0,
+            gain: 0,
+        });
+    }
+    /**
+     * The type of this BiquadFilterNode. For a complete list of types and their attributes, see the
+     * [Web Audio API](https://webaudio.github.io/web-audio-api/#dom-biquadfiltertype-lowpass)
+     */
+    get type() {
+        return this._filter.type;
+    }
+    set type(type) {
+        const types = ["lowpass", "highpass", "bandpass",
+            "lowshelf", "highshelf", "notch", "allpass", "peaking"];
+        assert(types.indexOf(type) !== -1, `Invalid filter type: ${type}`);
+        this._filter.type = type;
+    }
+    /**
+     * Get the frequency response curve. This curve represents how the filter
+     * responses to frequencies between 20hz-20khz.
+     * @param  len The number of values to return
+     * @return The frequency response curve between 20-20kHz
+     */
+    getFrequencyResponse(len = 128) {
+        // start with all 1s
+        const freqValues = new Float32Array(len);
+        for (let i = 0; i < len; i++) {
+            const norm = Math.pow(i / len, 2);
+            const freq = norm * (20000 - 20) + 20;
+            freqValues[i] = freq;
+        }
+        const magValues = new Float32Array(len);
+        const phaseValues = new Float32Array(len);
+        // clone the filter to remove any connections which may be changing the value
+        const filterClone = this.context.createBiquadFilter();
+        filterClone.type = this.type;
+        filterClone.Q.value = this.Q.value;
+        filterClone.frequency.value = this.frequency.value;
+        filterClone.gain.value = this.gain.value;
+        filterClone.getFrequencyResponse(freqValues, magValues, phaseValues);
+        return magValues;
+    }
+    dispose() {
+        super.dispose();
+        this._filter.disconnect();
+        this.Q.dispose();
+        this.frequency.dispose();
+        this.gain.dispose();
+        this.detune.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=BiquadFilter.js.map

package/build/esm/component/filter/BiquadFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BiquadFilter.js","sourceRoot":"","sources":["../../../../Tone/component/filter/BiquadFilter.ts"],"names":[],"mappings":"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"}

package/build/esm/component/filter/Convolver.d.ts

@@ -0,0 +1,59 @@
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { Gain } from "../../core/context/Gain";
+export interface ConvolverOptions extends ToneAudioNodeOptions {
+    onload: () => void;
+    normalize: boolean;
+    url?: string | AudioBuffer | ToneAudioBuffer;
+}
+/**
+ * Convolver is a wrapper around the Native Web Audio
+ * [ConvolverNode](http://webaudio.github.io/web-audio-api/#the-convolvernode-interface).
+ * Convolution is useful for reverb and filter emulation. Read more about convolution reverb on
+ * [Wikipedia](https://en.wikipedia.org/wiki/Convolution_reverb).
+ *
+ * @example
+ * // initializing the convolver with an impulse response
+ * const convolver = new Tone.Convolver("./path/to/ir.wav").toDestination();
+ * @category Component
+ */
+export declare class Convolver extends ToneAudioNode<ConvolverOptions> {
+    readonly name: string;
+    /**
+     * The native ConvolverNode
+     */
+    private _convolver;
+    /**
+     * The Buffer belonging to the convolver
+     */
+    private _buffer;
+    readonly input: Gain;
+    readonly output: Gain;
+    /**
+     * @param url The URL of the impulse response or the ToneAudioBuffer containing the impulse response.
+     * @param onload The callback to invoke when the url is loaded.
+     */
+    constructor(url?: string | AudioBuffer | ToneAudioBuffer, onload?: () => void);
+    constructor(options?: Partial<ConvolverOptions>);
+    static getDefaults(): ConvolverOptions;
+    /**
+     * Load an impulse response url as an audio buffer.
+     * Decodes the audio asynchronously and invokes
+     * the callback once the audio buffer loads.
+     * @param url The url of the buffer to load. filetype support depends on the browser.
+     */
+    load(url: string): Promise<void>;
+    /**
+     * The convolver's buffer
+     */
+    get buffer(): ToneAudioBuffer | null;
+    set buffer(buffer: ToneAudioBuffer | null);
+    /**
+     * The normalize property of the ConvolverNode interface is a boolean that
+     * controls whether the impulse response from the buffer will be scaled by
+     * an equal-power normalization when the buffer attribute is set, or not.
+     */
+    get normalize(): boolean;
+    set normalize(norm: boolean);
+    dispose(): this;
+}

package/build/esm/component/filter/Convolver.js

@@ -0,0 +1,104 @@
+import { __awaiter } from "tslib";
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { ToneAudioBuffer } from "../../core/context/ToneAudioBuffer";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Gain } from "../../core/context/Gain";
+import { noOp } from "../../core/util/Interface";
+/**
+ * Convolver is a wrapper around the Native Web Audio
+ * [ConvolverNode](http://webaudio.github.io/web-audio-api/#the-convolvernode-interface).
+ * Convolution is useful for reverb and filter emulation. Read more about convolution reverb on
+ * [Wikipedia](https://en.wikipedia.org/wiki/Convolution_reverb).
+ *
+ * @example
+ * // initializing the convolver with an impulse response
+ * const convolver = new Tone.Convolver("./path/to/ir.wav").toDestination();
+ * @category Component
+ */
+export class Convolver extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Convolver.getDefaults(), arguments, ["url", "onload"]));
+        this.name = "Convolver";
+        /**
+         * The native ConvolverNode
+         */
+        this._convolver = this.context.createConvolver();
+        const options = optionsFromArguments(Convolver.getDefaults(), arguments, ["url", "onload"]);
+        this._buffer = new ToneAudioBuffer(options.url, buffer => {
+            this.buffer = buffer;
+            options.onload();
+        });
+        this.input = new Gain({ context: this.context });
+        this.output = new Gain({ context: this.context });
+        // set if it's already loaded, set it immediately
+        if (this._buffer.loaded) {
+            this.buffer = this._buffer;
+        }
+        // initially set normalization
+        this.normalize = options.normalize;
+        // connect it up
+        this.input.chain(this._convolver, this.output);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            normalize: true,
+            onload: noOp,
+        });
+    }
+    /**
+     * Load an impulse response url as an audio buffer.
+     * Decodes the audio asynchronously and invokes
+     * the callback once the audio buffer loads.
+     * @param url The url of the buffer to load. filetype support depends on the browser.
+     */
+    load(url) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.buffer = yield this._buffer.load(url);
+        });
+    }
+    /**
+     * The convolver's buffer
+     */
+    get buffer() {
+        if (this._buffer.length) {
+            return this._buffer;
+        }
+        else {
+            return null;
+        }
+    }
+    set buffer(buffer) {
+        if (buffer) {
+            this._buffer.set(buffer);
+        }
+        // if it's already got a buffer, create a new one
+        if (this._convolver.buffer) {
+            // disconnect the old one
+            this.input.disconnect();
+            this._convolver.disconnect();
+            // create and connect a new one
+            this._convolver = this.context.createConvolver();
+            this.input.chain(this._convolver, this.output);
+        }
+        const buff = this._buffer.get();
+        this._convolver.buffer = buff ? buff : null;
+    }
+    /**
+     * The normalize property of the ConvolverNode interface is a boolean that
+     * controls whether the impulse response from the buffer will be scaled by
+     * an equal-power normalization when the buffer attribute is set, or not.
+     */
+    get normalize() {
+        return this._convolver.normalize;
+    }
+    set normalize(norm) {
+        this._convolver.normalize = norm;
+    }
+    dispose() {
+        super.dispose();
+        this._buffer.dispose();
+        this._convolver.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=Convolver.js.map

package/build/esm/component/filter/Convolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Convolver.js","sourceRoot":"","sources":["../../../../Tone/component/filter/Convolver.ts"],"names":[],"mappings":"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"}

package/build/esm/component/filter/EQ3.d.ts

@@ -0,0 +1,77 @@
+import { Gain } from "../../core/context/Gain";
+import { Param } from "../../core/context/Param";
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Decibels, Frequency } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+import { MultibandSplit } from "../channel/MultibandSplit";
+interface EQ3Options extends ToneAudioNodeOptions {
+    low: Decibels;
+    mid: Decibels;
+    high: Decibels;
+    lowFrequency: Frequency;
+    highFrequency: Frequency;
+}
+/**
+ * EQ3 provides 3 equalizer bins: Low/Mid/High.
+ * @category Component
+ */
+export declare class EQ3 extends ToneAudioNode<EQ3Options> {
+    readonly name: string;
+    /**
+     * the input
+     */
+    readonly input: MultibandSplit;
+    /**
+     * the output
+     */
+    readonly output: Gain<"gain">;
+    /**
+     * Splits the input into three outputs
+     */
+    private _multibandSplit;
+    /**
+     * The gain for the lower signals
+     */
+    private _lowGain;
+    /**
+     * The gain for the mid signals
+     */
+    private _midGain;
+    /**
+     * The gain for the high signals
+     */
+    private _highGain;
+    /**
+     * The gain in decibels of the low part
+     */
+    readonly low: Param<"decibels">;
+    /**
+     * The gain in decibels of the mid part
+     */
+    readonly mid: Param<"decibels">;
+    /**
+     * The gain in decibels of the high part
+     */
+    readonly high: Param<"decibels">;
+    /**
+     * The Q value for all of the filters.
+     */
+    readonly Q: Signal<"positive">;
+    /**
+     * The low/mid crossover frequency.
+     */
+    readonly lowFrequency: Signal<"frequency">;
+    /**
+     * The mid/high crossover frequency.
+     */
+    readonly highFrequency: Signal<"frequency">;
+    protected _internalChannels: ToneAudioNode[];
+    constructor(lowLevel?: Decibels, midLevel?: Decibels, highLevel?: Decibels);
+    constructor(options: Partial<EQ3Options>);
+    static getDefaults(): EQ3Options;
+    /**
+     * Clean up.
+     */
+    dispose(): this;
+}
+export {};

package/build/esm/component/filter/EQ3.js

@@ -0,0 +1,81 @@
+import { Gain } from "../../core/context/Gain";
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly, writable } from "../../core/util/Interface";
+import { MultibandSplit } from "../channel/MultibandSplit";
+/**
+ * EQ3 provides 3 equalizer bins: Low/Mid/High.
+ * @category Component
+ */
+export class EQ3 extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(EQ3.getDefaults(), arguments, ["low", "mid", "high"]));
+        this.name = "EQ3";
+        /**
+         * the output
+         */
+        this.output = new Gain({ context: this.context });
+        this._internalChannels = [];
+        const options = optionsFromArguments(EQ3.getDefaults(), arguments, ["low", "mid", "high"]);
+        this.input = this._multibandSplit = new MultibandSplit({
+            context: this.context,
+            highFrequency: options.highFrequency,
+            lowFrequency: options.lowFrequency,
+        });
+        this._lowGain = new Gain({
+            context: this.context,
+            gain: options.low,
+            units: "decibels",
+        });
+        this._midGain = new Gain({
+            context: this.context,
+            gain: options.mid,
+            units: "decibels",
+        });
+        this._highGain = new Gain({
+            context: this.context,
+            gain: options.high,
+            units: "decibels",
+        });
+        this.low = this._lowGain.gain;
+        this.mid = this._midGain.gain;
+        this.high = this._highGain.gain;
+        this.Q = this._multibandSplit.Q;
+        this.lowFrequency = this._multibandSplit.lowFrequency;
+        this.highFrequency = this._multibandSplit.highFrequency;
+        // the frequency bands
+        this._multibandSplit.low.chain(this._lowGain, this.output);
+        this._multibandSplit.mid.chain(this._midGain, this.output);
+        this._multibandSplit.high.chain(this._highGain, this.output);
+        readOnly(this, ["low", "mid", "high", "lowFrequency", "highFrequency"]);
+        this._internalChannels = [this._multibandSplit];
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            high: 0,
+            highFrequency: 2500,
+            low: 0,
+            lowFrequency: 400,
+            mid: 0,
+        });
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        writable(this, ["low", "mid", "high", "lowFrequency", "highFrequency"]);
+        this._multibandSplit.dispose();
+        this.lowFrequency.dispose();
+        this.highFrequency.dispose();
+        this._lowGain.dispose();
+        this._midGain.dispose();
+        this._highGain.dispose();
+        this.low.dispose();
+        this.mid.dispose();
+        this.high.dispose();
+        this.Q.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=EQ3.js.map

package/build/esm/component/filter/EQ3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EQ3.js","sourceRoot":"","sources":["../../../../Tone/component/filter/EQ3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE/C,OAAO,EAAE,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAU3D;;;GAGG;AACH,MAAM,OAAO,GAAI,SAAQ,aAAyB;IAoEjD;QACC,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;QAnE1E,SAAI,GAAW,KAAK,CAAC;QAO9B;;WAEG;QACM,WAAM,GAAG,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAoD5C,sBAAiB,GAAoB,EAAE,CAAC;QAMjD,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QAE3F,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,eAAe,GAAG,IAAI,cAAc,CAAC;YACtD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,YAAY,EAAE,OAAO,CAAC,YAAY;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,GAAG;YACjB,KAAK,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,GAAG,IAAI,IAAI,CAAC;YACxB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,GAAG;YACjB,KAAK,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,KAAK,EAAE,UAAU;SACjB,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAChC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,eAAe,CAAC,YAAY,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC;QAExD,sBAAsB;QACtB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAC3D,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAE7D,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,IAAI,EAAE,CAAC;YACP,aAAa,EAAE,IAAI;YACnB,GAAG,EAAE,CAAC;YACN,YAAY,EAAE,GAAG;YACjB,GAAG,EAAE,CAAC;SACN,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,CAAC,CAAC,CAAC;QACxE,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC/B,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACjB,OAAO,IAAI,CAAC;IACb,CAAC;CAED"}

package/build/esm/component/filter/FeedbackCombFilter.d.ts

@@ -0,0 +1,45 @@
+import { Gain } from "../../core/context/Gain";
+import { Param } from "../../core/context/Param";
+import { ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { NormalRange, Time } from "../../core/type/Units";
+import { RecursivePartial } from "../../core/util/Interface";
+import { ToneAudioWorklet } from "../../core/worklet/ToneAudioWorklet";
+export interface FeedbackCombFilterOptions extends ToneAudioNodeOptions {
+    delayTime: Time;
+    resonance: NormalRange;
+}
+/**
+ * Comb filters are basic building blocks for physical modeling. Read more
+ * about comb filters on [CCRMA's website](https://ccrma.stanford.edu/~jos/pasp/Feedback_Comb_Filters.html).
+ *
+ * This comb filter is implemented with the AudioWorkletNode which allows it to have feedback delays less than the
+ * Web Audio processing block of 128 samples. There is a polyfill for browsers that don't yet support the
+ * AudioWorkletNode, but it will add some latency and have slower performance than the AudioWorkletNode.
+ * @category Component
+ */
+export declare class FeedbackCombFilter extends ToneAudioWorklet<FeedbackCombFilterOptions> {
+    readonly name = "FeedbackCombFilter";
+    /**
+     * The amount of delay of the comb filter.
+     */
+    readonly delayTime: Param<"time">;
+    /**
+     * The amount of feedback of the delayed signal.
+     */
+    readonly resonance: Param<"normalRange">;
+    readonly input: Gain;
+    readonly output: Gain;
+    /**
+     * @param delayTime The delay time of the filter.
+     * @param resonance The amount of feedback the filter has.
+     */
+    constructor(delayTime?: Time, resonance?: NormalRange);
+    constructor(options?: RecursivePartial<FeedbackCombFilterOptions>);
+    protected _audioWorkletName(): string;
+    /**
+     * The default parameters
+     */
+    static getDefaults(): FeedbackCombFilterOptions;
+    onReady(node: AudioWorkletNode): void;
+    dispose(): this;
+}

package/build/esm/component/filter/FeedbackCombFilter.js

@@ -0,0 +1,72 @@
+import { Gain } from "../../core/context/Gain";
+import { Param } from "../../core/context/Param";
+import { connectSeries, ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly } from "../../core/util/Interface";
+import { ToneAudioWorklet } from "../../core/worklet/ToneAudioWorklet";
+import { workletName } from "./FeedbackCombFilter.worklet";
+/**
+ * Comb filters are basic building blocks for physical modeling. Read more
+ * about comb filters on [CCRMA's website](https://ccrma.stanford.edu/~jos/pasp/Feedback_Comb_Filters.html).
+ *
+ * This comb filter is implemented with the AudioWorkletNode which allows it to have feedback delays less than the
+ * Web Audio processing block of 128 samples. There is a polyfill for browsers that don't yet support the
+ * AudioWorkletNode, but it will add some latency and have slower performance than the AudioWorkletNode.
+ * @category Component
+ */
+export class FeedbackCombFilter extends ToneAudioWorklet {
+    constructor() {
+        super(optionsFromArguments(FeedbackCombFilter.getDefaults(), arguments, ["delayTime", "resonance"]));
+        this.name = "FeedbackCombFilter";
+        const options = optionsFromArguments(FeedbackCombFilter.getDefaults(), arguments, ["delayTime", "resonance"]);
+        this.input = new Gain({ context: this.context });
+        this.output = new Gain({ context: this.context });
+        this.delayTime = new Param({
+            context: this.context,
+            value: options.delayTime,
+            units: "time",
+            minValue: 0,
+            maxValue: 1,
+            param: this._dummyParam,
+            swappable: true,
+        });
+        this.resonance = new Param({
+            context: this.context,
+            value: options.resonance,
+            units: "normalRange",
+            param: this._dummyParam,
+            swappable: true,
+        });
+        readOnly(this, ["resonance", "delayTime"]);
+    }
+    _audioWorkletName() {
+        return workletName;
+    }
+    /**
+     * The default parameters
+     */
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            delayTime: 0.1,
+            resonance: 0.5,
+        });
+    }
+    onReady(node) {
+        connectSeries(this.input, node, this.output);
+        const delayTime = node.parameters.get("delayTime");
+        ;
+        this.delayTime.setParam(delayTime);
+        const feedback = node.parameters.get("feedback");
+        ;
+        this.resonance.setParam(feedback);
+    }
+    dispose() {
+        super.dispose();
+        this.input.dispose();
+        this.output.dispose();
+        this.delayTime.dispose();
+        this.resonance.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=FeedbackCombFilter.js.map

package/build/esm/component/filter/FeedbackCombFilter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackCombFilter.js","sourceRoot":"","sources":["../../../../Tone/component/filter/FeedbackCombFilter.ts"],"names":[],"mappings":"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"}

package/build/esm/component/filter/FeedbackCombFilter.worklet.d.ts

@@ -0,0 +1,3 @@
+import "../../core/worklet/SingleIOProcessor.worklet";
+import "../../core/worklet/DelayLine.worklet";
+export declare const workletName = "feedback-comb-filter";