tone 14.8.27

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

@@ -0,0 +1,37 @@
+import "../../core/worklet/SingleIOProcessor.worklet";
+import "../../core/worklet/DelayLine.worklet";
+import { registerProcessor } from "../../core/worklet/WorkletGlobalScope";
+export const workletName = "feedback-comb-filter";
+const feedbackCombFilter = /* javascript */ `
+	class FeedbackCombFilterWorklet extends SingleIOProcessor {
+
+		constructor(options) {
+			super(options);
+			this.delayLine = new DelayLine(this.sampleRate, options.channelCount || 2);
+		}
+
+		static get parameterDescriptors() {
+			return [{
+				name: "delayTime",
+				defaultValue: 0.1,
+				minValue: 0,
+				maxValue: 1,
+				automationRate: "k-rate"
+			}, {
+				name: "feedback",
+				defaultValue: 0.5,
+				minValue: 0,
+				maxValue: 0.9999,
+				automationRate: "k-rate"
+			}];
+		}
+
+		generate(input, channel, parameters) {
+			const delayedSample = this.delayLine.get(channel, parameters.delayTime * this.sampleRate);
+			this.delayLine.push(channel, input + delayedSample * parameters.feedback);
+			return delayedSample;
+		}
+	}
+`;
+registerProcessor(workletName, feedbackCombFilter);
+//# sourceMappingURL=FeedbackCombFilter.worklet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackCombFilter.worklet.js","sourceRoot":"","sources":["../../../../Tone/component/filter/FeedbackCombFilter.worklet.ts"],"names":[],"mappings":"AAAA,OAAO,8CAA8C,CAAC;AACtD,OAAO,sCAAsC,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE1E,MAAM,CAAC,MAAM,WAAW,GAAG,sBAAsB,CAAC;AAElD,MAAM,kBAAkB,GAAG,gBAAgB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8B1C,CAAC;AAEF,iBAAiB,CAAC,WAAW,EAAE,kBAAkB,CAAC,CAAC"}

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

@@ -0,0 +1,79 @@
+import { Gain } from "../../core/context/Gain";
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { Frequency } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+import { BiquadFilterOptions } from "./BiquadFilter";
+export declare type FilterRollOff = -12 | -24 | -48 | -96;
+export declare type FilterOptions = BiquadFilterOptions & {
+    rolloff: FilterRollOff;
+};
+/**
+ * Tone.Filter is a filter which allows for all of the same native methods
+ * as the [BiquadFilterNode](http://webaudio.github.io/web-audio-api/#the-biquadfilternode-interface).
+ * Tone.Filter has the added ability to set the filter rolloff at -12
+ * (default), -24 and -48.
+ * @example
+ * const filter = new Tone.Filter(1500, "highpass").toDestination();
+ * filter.frequency.rampTo(20000, 10);
+ * const noise = new Tone.Noise().connect(filter).start();
+ * @category Component
+ */
+export declare class Filter extends ToneAudioNode<FilterOptions> {
+    readonly name: string;
+    readonly input: Gain<"gain">;
+    readonly output: Gain<"gain">;
+    private _filters;
+    /**
+     * the rolloff value of the filter
+     */
+    private _rolloff;
+    private _type;
+    /**
+     * The Q or Quality of the filter
+     */
+    readonly Q: Signal<"positive">;
+    /**
+     * The cutoff frequency of the filter.
+     */
+    readonly frequency: Signal<"frequency">;
+    /**
+     * The detune parameter
+     */
+    readonly detune: Signal<"cents">;
+    /**
+     * The gain of the filter, only used in certain filter types
+     */
+    readonly gain: Signal<"decibels">;
+    /**
+     * @param frequency The cutoff frequency of the filter.
+     * @param type The type of filter.
+     * @param rolloff The drop in decibels per octave after the cutoff frequency
+     */
+    constructor(frequency?: Frequency, type?: BiquadFilterType, rolloff?: FilterRollOff);
+    constructor(options?: Partial<FilterOptions>);
+    static getDefaults(): FilterOptions;
+    /**
+     * The type of the filter. Types: "lowpass", "highpass",
+     * "bandpass", "lowshelf", "highshelf", "notch", "allpass", or "peaking".
+     */
+    get type(): BiquadFilterType;
+    set type(type: BiquadFilterType);
+    /**
+     * The rolloff of the filter which is the drop in db
+     * per octave. Implemented internally by cascading filters.
+     * Only accepts the values -12, -24, -48 and -96.
+     */
+    get rolloff(): FilterRollOff;
+    set rolloff(rolloff: FilterRollOff);
+    /**
+     * 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;
+    /**
+     * Clean up.
+     */
+    dispose(): this;
+}

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

@@ -0,0 +1,150 @@
+import { Gain } from "../../core/context/Gain";
+import { connectSeries, ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly, writable } from "../../core/util/Interface";
+import { isNumber } from "../../core/util/TypeCheck";
+import { Signal } from "../../signal/Signal";
+import { assert } from "../../core/util/Debug";
+import { BiquadFilter } from "./BiquadFilter";
+/**
+ * Tone.Filter is a filter which allows for all of the same native methods
+ * as the [BiquadFilterNode](http://webaudio.github.io/web-audio-api/#the-biquadfilternode-interface).
+ * Tone.Filter has the added ability to set the filter rolloff at -12
+ * (default), -24 and -48.
+ * @example
+ * const filter = new Tone.Filter(1500, "highpass").toDestination();
+ * filter.frequency.rampTo(20000, 10);
+ * const noise = new Tone.Noise().connect(filter).start();
+ * @category Component
+ */
+export class Filter extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Filter.getDefaults(), arguments, ["frequency", "type", "rolloff"]));
+        this.name = "Filter";
+        this.input = new Gain({ context: this.context });
+        this.output = new Gain({ context: this.context });
+        this._filters = [];
+        const options = optionsFromArguments(Filter.getDefaults(), arguments, ["frequency", "type", "rolloff"]);
+        this._filters = [];
+        this.Q = new Signal({
+            context: this.context,
+            units: "positive",
+            value: options.Q,
+        });
+        this.frequency = new Signal({
+            context: this.context,
+            units: "frequency",
+            value: options.frequency,
+        });
+        this.detune = new Signal({
+            context: this.context,
+            units: "cents",
+            value: options.detune,
+        });
+        this.gain = new Signal({
+            context: this.context,
+            units: "decibels",
+            convert: false,
+            value: options.gain,
+        });
+        this._type = options.type;
+        this.rolloff = options.rolloff;
+        readOnly(this, ["detune", "frequency", "gain", "Q"]);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            Q: 1,
+            detune: 0,
+            frequency: 350,
+            gain: 0,
+            rolloff: -12,
+            type: "lowpass",
+        });
+    }
+    /**
+     * The type of the filter. Types: "lowpass", "highpass",
+     * "bandpass", "lowshelf", "highshelf", "notch", "allpass", or "peaking".
+     */
+    get type() {
+        return this._type;
+    }
+    set type(type) {
+        const types = ["lowpass", "highpass", "bandpass",
+            "lowshelf", "highshelf", "notch", "allpass", "peaking"];
+        assert(types.indexOf(type) !== -1, `Invalid filter type: ${type}`);
+        this._type = type;
+        this._filters.forEach(filter => filter.type = type);
+    }
+    /**
+     * The rolloff of the filter which is the drop in db
+     * per octave. Implemented internally by cascading filters.
+     * Only accepts the values -12, -24, -48 and -96.
+     */
+    get rolloff() {
+        return this._rolloff;
+    }
+    set rolloff(rolloff) {
+        const rolloffNum = isNumber(rolloff) ? rolloff : parseInt(rolloff, 10);
+        const possibilities = [-12, -24, -48, -96];
+        let cascadingCount = possibilities.indexOf(rolloffNum);
+        // check the rolloff is valid
+        assert(cascadingCount !== -1, `rolloff can only be ${possibilities.join(", ")}`);
+        cascadingCount += 1;
+        this._rolloff = rolloffNum;
+        this.input.disconnect();
+        this._filters.forEach(filter => filter.disconnect());
+        this._filters = new Array(cascadingCount);
+        for (let count = 0; count < cascadingCount; count++) {
+            const filter = new BiquadFilter({
+                context: this.context,
+            });
+            filter.type = this._type;
+            this.frequency.connect(filter.frequency);
+            this.detune.connect(filter.detune);
+            this.Q.connect(filter.Q);
+            this.gain.connect(filter.gain);
+            this._filters[count] = filter;
+        }
+        this._internalChannels = this._filters;
+        connectSeries(this.input, ...this._internalChannels, this.output);
+    }
+    /**
+     * 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) {
+        const filterClone = new BiquadFilter({
+            frequency: this.frequency.value,
+            gain: this.gain.value,
+            Q: this.Q.value,
+            type: this._type,
+            detune: this.detune.value,
+        });
+        // start with all 1s
+        const totalResponse = new Float32Array(len).map(() => 1);
+        this._filters.forEach(() => {
+            const response = filterClone.getFrequencyResponse(len);
+            response.forEach((val, i) => totalResponse[i] *= val);
+        });
+        filterClone.dispose();
+        return totalResponse;
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        this._filters.forEach(filter => {
+            filter.dispose();
+        });
+        writable(this, ["detune", "frequency", "gain", "Q"]);
+        this.frequency.dispose();
+        this.Q.dispose();
+        this.detune.dispose();
+        this.gain.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Filter.js.map

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

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

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

@@ -0,0 +1,50 @@
+import { Param } from "../../core/context/Param";
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Frequency, NormalRange, Time } from "../../core/type/Units";
+import { RecursivePartial } from "../../core/util/Interface";
+interface LowpassCombFilterOptions extends ToneAudioNodeOptions {
+    delayTime: Time;
+    resonance: NormalRange;
+    dampening: Frequency;
+}
+/**
+ * A lowpass feedback comb filter. It is similar to
+ * [[FeedbackCombFilter]], but includes a lowpass filter.
+ * @category Component
+ */
+export declare class LowpassCombFilter extends ToneAudioNode<LowpassCombFilterOptions> {
+    readonly name = "LowpassCombFilter";
+    /**
+     * The delay node
+     */
+    private _combFilter;
+    /**
+     * The lowpass filter
+     */
+    private _lowpass;
+    /**
+     * The delayTime of the comb filter.
+     */
+    readonly delayTime: Param<"time">;
+    /**
+     * The amount of feedback of the delayed signal.
+     */
+    readonly resonance: Param<"normalRange">;
+    readonly input: InputNode;
+    readonly output: OutputNode;
+    /**
+     * @param delayTime The delay time of the comb filter
+     * @param resonance The resonance (feedback) of the comb filter
+     * @param dampening The cutoff of the lowpass filter dampens the signal as it is fedback.
+     */
+    constructor(delayTime?: Time, resonance?: NormalRange, dampening?: Frequency);
+    constructor(options?: RecursivePartial<LowpassCombFilterOptions>);
+    static getDefaults(): LowpassCombFilterOptions;
+    /**
+     * The dampening control of the feedback
+     */
+    get dampening(): Frequency;
+    set dampening(fq: Frequency);
+    dispose(): this;
+}
+export {};

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

@@ -0,0 +1,53 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { FeedbackCombFilter } from "./FeedbackCombFilter";
+import { OnePoleFilter } from "./OnePoleFilter";
+/**
+ * A lowpass feedback comb filter. It is similar to
+ * [[FeedbackCombFilter]], but includes a lowpass filter.
+ * @category Component
+ */
+export class LowpassCombFilter extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(LowpassCombFilter.getDefaults(), arguments, ["delayTime", "resonance", "dampening"]));
+        this.name = "LowpassCombFilter";
+        const options = optionsFromArguments(LowpassCombFilter.getDefaults(), arguments, ["delayTime", "resonance", "dampening"]);
+        this._combFilter = this.output = new FeedbackCombFilter({
+            context: this.context,
+            delayTime: options.delayTime,
+            resonance: options.resonance,
+        });
+        this.delayTime = this._combFilter.delayTime;
+        this.resonance = this._combFilter.resonance;
+        this._lowpass = this.input = new OnePoleFilter({
+            context: this.context,
+            frequency: options.dampening,
+            type: "lowpass",
+        });
+        // connections
+        this._lowpass.connect(this._combFilter);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            dampening: 3000,
+            delayTime: 0.1,
+            resonance: 0.5,
+        });
+    }
+    /**
+     * The dampening control of the feedback
+     */
+    get dampening() {
+        return this._lowpass.frequency;
+    }
+    set dampening(fq) {
+        this._lowpass.frequency = fq;
+    }
+    dispose() {
+        super.dispose();
+        this._combFilter.dispose();
+        this._lowpass.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=LowpassCombFilter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LowpassCombFilter.js","sourceRoot":"","sources":["../../../../Tone/component/filter/LowpassCombFilter.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAE9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAQhD;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAuC;IAkC7E;QACC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;QAjCzG,SAAI,GAAG,mBAAmB,CAAC;QAkCnC,MAAM,OAAO,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;QAE1H,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,kBAAkB,CAAC;YACvD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;QAE5C,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC;YAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,IAAI,EAAE,SAAS;SACf,CAAC,CAAC;QAEH,cAAc;QACd,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,GAAG;SACd,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;IAChC,CAAC;IACD,IAAI,SAAS,CAAC,EAAE;QACf,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,EAAE,CAAC;IAC9B,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

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

@@ -0,0 +1,64 @@
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Frequency } from "../../core/type/Units";
+import { Gain } from "../../core/context/Gain";
+export declare type OnePoleFilterType = "highpass" | "lowpass";
+export interface OnePoleFilterOptions extends ToneAudioNodeOptions {
+    frequency: Frequency;
+    type: OnePoleFilterType;
+}
+/**
+ * A one pole filter with 6db-per-octave rolloff. Either "highpass" or "lowpass".
+ * Note that changing the type or frequency may result in a discontinuity which
+ * can sound like a click or pop.
+ * References:
+ * * http://www.earlevel.com/main/2012/12/15/a-one-pole-filter/
+ * * http://www.dspguide.com/ch19/2.htm
+ * * https://github.com/vitaliy-bobrov/js-rocks/blob/master/src/app/audio/effects/one-pole-filters.ts
+ * @category Component
+ */
+export declare class OnePoleFilter extends ToneAudioNode<OnePoleFilterOptions> {
+    readonly name: string;
+    /**
+     * Hold the current frequency
+     */
+    private _frequency;
+    /**
+     * the current one pole type
+     */
+    private _type;
+    /**
+     * the current one pole filter
+     */
+    private _filter;
+    readonly input: Gain;
+    readonly output: Gain;
+    /**
+     * @param frequency The frequency
+     * @param type The  filter type, either "lowpass" or "highpass"
+     */
+    constructor(frequency?: Frequency, type?: OnePoleFilterType);
+    constructor(options?: Partial<OnePoleFilterOptions>);
+    static getDefaults(): OnePoleFilterOptions;
+    /**
+     * Create a filter and dispose the old one
+     */
+    private _createFilter;
+    /**
+     * The frequency value.
+     */
+    get frequency(): Frequency;
+    set frequency(fq: Frequency);
+    /**
+     * The OnePole Filter type, either "highpass" or "lowpass"
+     */
+    get type(): OnePoleFilterType;
+    set type(t: OnePoleFilterType);
+    /**
+     * 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/OnePoleFilter.js

@@ -0,0 +1,104 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Gain } from "../../core/context/Gain";
+/**
+ * A one pole filter with 6db-per-octave rolloff. Either "highpass" or "lowpass".
+ * Note that changing the type or frequency may result in a discontinuity which
+ * can sound like a click or pop.
+ * References:
+ * * http://www.earlevel.com/main/2012/12/15/a-one-pole-filter/
+ * * http://www.dspguide.com/ch19/2.htm
+ * * https://github.com/vitaliy-bobrov/js-rocks/blob/master/src/app/audio/effects/one-pole-filters.ts
+ * @category Component
+ */
+export class OnePoleFilter extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(OnePoleFilter.getDefaults(), arguments, ["frequency", "type"]));
+        this.name = "OnePoleFilter";
+        const options = optionsFromArguments(OnePoleFilter.getDefaults(), arguments, ["frequency", "type"]);
+        this._frequency = options.frequency;
+        this._type = options.type;
+        this.input = new Gain({ context: this.context });
+        this.output = new Gain({ context: this.context });
+        this._createFilter();
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            frequency: 880,
+            type: "lowpass"
+        });
+    }
+    /**
+     * Create a filter and dispose the old one
+     */
+    _createFilter() {
+        const oldFilter = this._filter;
+        const freq = this.toFrequency(this._frequency);
+        const t = 1 / (2 * Math.PI * freq);
+        if (this._type === "lowpass") {
+            const a0 = 1 / (t * this.context.sampleRate);
+            const b1 = a0 - 1;
+            this._filter = this.context.createIIRFilter([a0, 0], [1, b1]);
+        }
+        else {
+            const b1 = 1 / (t * this.context.sampleRate) - 1;
+            this._filter = this.context.createIIRFilter([1, -1], [1, b1]);
+        }
+        this.input.chain(this._filter, this.output);
+        if (oldFilter) {
+            // dispose it on the next block
+            this.context.setTimeout(() => {
+                if (!this.disposed) {
+                    this.input.disconnect(oldFilter);
+                    oldFilter.disconnect();
+                }
+            }, this.blockTime);
+        }
+    }
+    /**
+     * The frequency value.
+     */
+    get frequency() {
+        return this._frequency;
+    }
+    set frequency(fq) {
+        this._frequency = fq;
+        this._createFilter();
+    }
+    /**
+     * The OnePole Filter type, either "highpass" or "lowpass"
+     */
+    get type() {
+        return this._type;
+    }
+    set type(t) {
+        this._type = t;
+        this._createFilter();
+    }
+    /**
+     * 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) {
+        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);
+        this._filter.getFrequencyResponse(freqValues, magValues, phaseValues);
+        return magValues;
+    }
+    dispose() {
+        super.dispose();
+        this.input.dispose();
+        this.output.dispose();
+        this._filter.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=OnePoleFilter.js.map

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

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

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

@@ -0,0 +1,40 @@
+import { Gain } from "../../core/context/Gain";
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+/**
+ * PhaseShiftAllpass is an very efficient implementation of a Hilbert Transform
+ * using two Allpass filter banks whose outputs have a phase difference of 90°.
+ * Here the `offset90` phase is offset by +90° in relation to `output`.
+ * Coefficients and structure was developed by Olli Niemitalo.
+ * For more details see: http://yehar.com/blog/?p=368
+ * @category Component
+ */
+export declare class PhaseShiftAllpass extends ToneAudioNode<ToneAudioNodeOptions> {
+    readonly name: string;
+    readonly input: Gain<"gain">;
+    /**
+     * The Allpass filter in the first bank
+     */
+    private _bank0;
+    /**
+     * The Allpass filter in the seconds bank
+     */
+    private _bank1;
+    /**
+     * A IIR filter implementing a delay by one sample used by the first bank
+     */
+    private _oneSampleDelay;
+    /**
+     * The phase shifted output
+     */
+    readonly output: Gain<"gain">;
+    /**
+     * The PhaseShifted allpass output
+     */
+    readonly offset90: Gain<"gain">;
+    constructor(options?: Partial<ToneAudioNodeOptions>);
+    /**
+     * Create all of the IIR filters from an array of values using the coefficient calculation.
+     */
+    private _createAllPassFilterBank;
+    dispose(): this;
+}

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

@@ -0,0 +1,54 @@
+import { Gain } from "../../core/context/Gain";
+import { connectSeries, ToneAudioNode } from "../../core/context/ToneAudioNode";
+/**
+ * PhaseShiftAllpass is an very efficient implementation of a Hilbert Transform
+ * using two Allpass filter banks whose outputs have a phase difference of 90°.
+ * Here the `offset90` phase is offset by +90° in relation to `output`.
+ * Coefficients and structure was developed by Olli Niemitalo.
+ * For more details see: http://yehar.com/blog/?p=368
+ * @category Component
+ */
+export class PhaseShiftAllpass extends ToneAudioNode {
+    constructor(options) {
+        super(options);
+        this.name = "PhaseShiftAllpass";
+        this.input = new Gain({ context: this.context });
+        /**
+         * The phase shifted output
+         */
+        this.output = new Gain({ context: this.context });
+        /**
+         * The PhaseShifted allpass output
+         */
+        this.offset90 = new Gain({ context: this.context });
+        const allpassBank1Values = [0.6923878, 0.9360654322959, 0.9882295226860, 0.9987488452737];
+        const allpassBank2Values = [0.4021921162426, 0.8561710882420, 0.9722909545651, 0.9952884791278];
+        this._bank0 = this._createAllPassFilterBank(allpassBank1Values);
+        this._bank1 = this._createAllPassFilterBank(allpassBank2Values);
+        this._oneSampleDelay = this.context.createIIRFilter([0.0, 1.0], [1.0, 0.0]);
+        // connect Allpass filter banks
+        connectSeries(this.input, ...this._bank0, this._oneSampleDelay, this.output);
+        connectSeries(this.input, ...this._bank1, this.offset90);
+    }
+    /**
+     * Create all of the IIR filters from an array of values using the coefficient calculation.
+     */
+    _createAllPassFilterBank(bankValues) {
+        const nodes = bankValues.map(value => {
+            const coefficients = [[value * value, 0, -1], [1, 0, -(value * value)]];
+            return this.context.createIIRFilter(coefficients[0], coefficients[1]);
+        });
+        return nodes;
+    }
+    dispose() {
+        super.dispose();
+        this.input.dispose();
+        this.output.dispose();
+        this.offset90.dispose();
+        this._bank0.forEach(f => f.disconnect());
+        this._bank1.forEach(f => f.disconnect());
+        this._oneSampleDelay.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=PhaseShiftAllpass.js.map