tone 14.8.27

package/build/esm/effect/Chorus.d.ts

@@ -0,0 +1,104 @@
+import { StereoFeedbackEffect, StereoFeedbackEffectOptions } from "../effect/StereoFeedbackEffect";
+import { Degrees, Frequency, Milliseconds, NormalRange, Time } from "../core/type/Units";
+import { ToneOscillatorType } from "../source/oscillator/OscillatorInterface";
+import { Signal } from "../signal/Signal";
+export interface ChorusOptions extends StereoFeedbackEffectOptions {
+    frequency: Frequency;
+    delayTime: Milliseconds;
+    depth: NormalRange;
+    type: ToneOscillatorType;
+    spread: Degrees;
+}
+/**
+ * Chorus is a stereo chorus effect composed of a left and right delay with an [[LFO]] applied to the delayTime of each channel.
+ * When [[feedback]] is set to a value larger than 0, you also get Flanger-type effects.
+ * Inspiration from [Tuna.js](https://github.com/Dinahmoe/tuna/blob/master/tuna.js).
+ * Read more on the chorus effect on [SoundOnSound](http://www.soundonsound.com/sos/jun04/articles/synthsecrets.htm).
+ *
+ * @example
+ * const chorus = new Tone.Chorus(4, 2.5, 0.5).toDestination().start();
+ * const synth = new Tone.PolySynth().connect(chorus);
+ * synth.triggerAttackRelease(["C3", "E3", "G3"], "8n");
+ *
+ * @category Effect
+ */
+export declare class Chorus extends StereoFeedbackEffect<ChorusOptions> {
+    readonly name: string;
+    /**
+     * the depth of the chorus
+     */
+    private _depth;
+    /**
+     * the delayTime in seconds.
+     */
+    private _delayTime;
+    /**
+     * the lfo which controls the delayTime
+     */
+    private _lfoL;
+    /**
+     * another LFO for the right side with a 180 degree phase diff
+     */
+    private _lfoR;
+    /**
+     * delay for left
+     */
+    private _delayNodeL;
+    /**
+     * delay for right
+     */
+    private _delayNodeR;
+    /**
+     * The frequency of the LFO which modulates the delayTime.
+     */
+    readonly frequency: Signal<"frequency">;
+    /**
+     * @param frequency The frequency of the LFO.
+     * @param delayTime The delay of the chorus effect in ms.
+     * @param depth The depth of the chorus.
+     */
+    constructor(frequency?: Frequency, delayTime?: Milliseconds, depth?: NormalRange);
+    constructor(options?: Partial<ChorusOptions>);
+    static getDefaults(): ChorusOptions;
+    /**
+     * The depth of the effect. A depth of 1 makes the delayTime
+     * modulate between 0 and 2*delayTime (centered around the delayTime).
+     */
+    get depth(): NormalRange;
+    set depth(depth: NormalRange);
+    /**
+     * The delayTime in milliseconds of the chorus. A larger delayTime
+     * will give a more pronounced effect. Nominal range a delayTime
+     * is between 2 and 20ms.
+     */
+    get delayTime(): Milliseconds;
+    set delayTime(delayTime: Milliseconds);
+    /**
+     * The oscillator type of the LFO.
+     */
+    get type(): ToneOscillatorType;
+    set type(type: ToneOscillatorType);
+    /**
+     * Amount of stereo spread. When set to 0, both LFO's will be panned centrally.
+     * When set to 180, LFO's will be panned hard left and right respectively.
+     */
+    get spread(): Degrees;
+    set spread(spread: Degrees);
+    /**
+     * Start the effect.
+     */
+    start(time?: Time): this;
+    /**
+     * Stop the lfo
+     */
+    stop(time?: Time): this;
+    /**
+     * Sync the filter to the transport. See [[LFO.sync]]
+     */
+    sync(): this;
+    /**
+     * Unsync the filter from the transport.
+     */
+    unsync(): this;
+    dispose(): this;
+}

package/build/esm/effect/Chorus.js

@@ -0,0 +1,157 @@
+import { StereoFeedbackEffect } from "../effect/StereoFeedbackEffect";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { LFO } from "../source/oscillator/LFO";
+import { Delay } from "../core/context/Delay";
+import { readOnly } from "../core/util/Interface";
+/**
+ * Chorus is a stereo chorus effect composed of a left and right delay with an [[LFO]] applied to the delayTime of each channel.
+ * When [[feedback]] is set to a value larger than 0, you also get Flanger-type effects.
+ * Inspiration from [Tuna.js](https://github.com/Dinahmoe/tuna/blob/master/tuna.js).
+ * Read more on the chorus effect on [SoundOnSound](http://www.soundonsound.com/sos/jun04/articles/synthsecrets.htm).
+ *
+ * @example
+ * const chorus = new Tone.Chorus(4, 2.5, 0.5).toDestination().start();
+ * const synth = new Tone.PolySynth().connect(chorus);
+ * synth.triggerAttackRelease(["C3", "E3", "G3"], "8n");
+ *
+ * @category Effect
+ */
+export class Chorus extends StereoFeedbackEffect {
+    constructor() {
+        super(optionsFromArguments(Chorus.getDefaults(), arguments, ["frequency", "delayTime", "depth"]));
+        this.name = "Chorus";
+        const options = optionsFromArguments(Chorus.getDefaults(), arguments, ["frequency", "delayTime", "depth"]);
+        this._depth = options.depth;
+        this._delayTime = options.delayTime / 1000;
+        this._lfoL = new LFO({
+            context: this.context,
+            frequency: options.frequency,
+            min: 0,
+            max: 1,
+        });
+        this._lfoR = new LFO({
+            context: this.context,
+            frequency: options.frequency,
+            min: 0,
+            max: 1,
+            phase: 180
+        });
+        this._delayNodeL = new Delay({ context: this.context });
+        this._delayNodeR = new Delay({ context: this.context });
+        this.frequency = this._lfoL.frequency;
+        readOnly(this, ["frequency"]);
+        // have one LFO frequency control the other
+        this._lfoL.frequency.connect(this._lfoR.frequency);
+        // connections
+        this.connectEffectLeft(this._delayNodeL);
+        this.connectEffectRight(this._delayNodeR);
+        // lfo setup
+        this._lfoL.connect(this._delayNodeL.delayTime);
+        this._lfoR.connect(this._delayNodeR.delayTime);
+        // set the initial values
+        this.depth = this._depth;
+        this.type = options.type;
+        this.spread = options.spread;
+    }
+    static getDefaults() {
+        return Object.assign(StereoFeedbackEffect.getDefaults(), {
+            frequency: 1.5,
+            delayTime: 3.5,
+            depth: 0.7,
+            type: "sine",
+            spread: 180,
+            feedback: 0,
+            wet: 0.5,
+        });
+    }
+    /**
+     * The depth of the effect. A depth of 1 makes the delayTime
+     * modulate between 0 and 2*delayTime (centered around the delayTime).
+     */
+    get depth() {
+        return this._depth;
+    }
+    set depth(depth) {
+        this._depth = depth;
+        const deviation = this._delayTime * depth;
+        this._lfoL.min = Math.max(this._delayTime - deviation, 0);
+        this._lfoL.max = this._delayTime + deviation;
+        this._lfoR.min = Math.max(this._delayTime - deviation, 0);
+        this._lfoR.max = this._delayTime + deviation;
+    }
+    /**
+     * The delayTime in milliseconds of the chorus. A larger delayTime
+     * will give a more pronounced effect. Nominal range a delayTime
+     * is between 2 and 20ms.
+     */
+    get delayTime() {
+        return this._delayTime * 1000;
+    }
+    set delayTime(delayTime) {
+        this._delayTime = delayTime / 1000;
+        this.depth = this._depth;
+    }
+    /**
+     * The oscillator type of the LFO.
+     */
+    get type() {
+        return this._lfoL.type;
+    }
+    set type(type) {
+        this._lfoL.type = type;
+        this._lfoR.type = type;
+    }
+    /**
+     * Amount of stereo spread. When set to 0, both LFO's will be panned centrally.
+     * When set to 180, LFO's will be panned hard left and right respectively.
+     */
+    get spread() {
+        return this._lfoR.phase - this._lfoL.phase;
+    }
+    set spread(spread) {
+        this._lfoL.phase = 90 - (spread / 2);
+        this._lfoR.phase = (spread / 2) + 90;
+    }
+    /**
+     * Start the effect.
+     */
+    start(time) {
+        this._lfoL.start(time);
+        this._lfoR.start(time);
+        return this;
+    }
+    /**
+     * Stop the lfo
+     */
+    stop(time) {
+        this._lfoL.stop(time);
+        this._lfoR.stop(time);
+        return this;
+    }
+    /**
+     * Sync the filter to the transport. See [[LFO.sync]]
+     */
+    sync() {
+        this._lfoL.sync();
+        this._lfoR.sync();
+        return this;
+    }
+    /**
+     * Unsync the filter from the transport.
+     */
+    unsync() {
+        this._lfoL.unsync();
+        this._lfoR.unsync();
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._lfoL.dispose();
+        this._lfoR.dispose();
+        this._delayNodeL.dispose();
+        this._delayNodeR.dispose();
+        this.frequency.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Chorus.js.map

package/build/esm/effect/Chorus.js.map

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

package/build/esm/effect/Distortion.d.ts

@@ -0,0 +1,43 @@
+import { Effect, EffectOptions } from "./Effect";
+export interface DistortionOptions extends EffectOptions {
+    distortion: number;
+    oversample: OverSampleType;
+}
+/**
+ * A simple distortion effect using Tone.WaveShaper.
+ * Algorithm from [this stackoverflow answer](http://stackoverflow.com/a/22313408).
+ *
+ * @example
+ * const dist = new Tone.Distortion(0.8).toDestination();
+ * const fm = new Tone.FMSynth().connect(dist);
+ * fm.triggerAttackRelease("A1", "8n");
+ * @category Effect
+ */
+export declare class Distortion extends Effect<DistortionOptions> {
+    readonly name: string;
+    /**
+     * The waveshaper which does the distortion
+     */
+    private _shaper;
+    /**
+     * Stores the distortion value
+     */
+    private _distortion;
+    /**
+     * @param distortion The amount of distortion (nominal range of 0-1)
+     */
+    constructor(distortion?: number);
+    constructor(options?: Partial<DistortionOptions>);
+    static getDefaults(): DistortionOptions;
+    /**
+     * The amount of distortion. Nominal range is between 0 and 1.
+     */
+    get distortion(): number;
+    set distortion(amount: number);
+    /**
+     * The oversampling of the effect. Can either be "none", "2x" or "4x".
+     */
+    get oversample(): OverSampleType;
+    set oversample(oversampling: OverSampleType);
+    dispose(): this;
+}

package/build/esm/effect/Distortion.js

@@ -0,0 +1,69 @@
+import { optionsFromArguments } from "../core/util/Defaults";
+import { WaveShaper } from "../signal/WaveShaper";
+import { Effect } from "./Effect";
+/**
+ * A simple distortion effect using Tone.WaveShaper.
+ * Algorithm from [this stackoverflow answer](http://stackoverflow.com/a/22313408).
+ *
+ * @example
+ * const dist = new Tone.Distortion(0.8).toDestination();
+ * const fm = new Tone.FMSynth().connect(dist);
+ * fm.triggerAttackRelease("A1", "8n");
+ * @category Effect
+ */
+export class Distortion extends Effect {
+    constructor() {
+        super(optionsFromArguments(Distortion.getDefaults(), arguments, ["distortion"]));
+        this.name = "Distortion";
+        const options = optionsFromArguments(Distortion.getDefaults(), arguments, ["distortion"]);
+        this._shaper = new WaveShaper({
+            context: this.context,
+            length: 4096,
+        });
+        this._distortion = options.distortion;
+        this.connectEffect(this._shaper);
+        this.distortion = options.distortion;
+        this.oversample = options.oversample;
+    }
+    static getDefaults() {
+        return Object.assign(Effect.getDefaults(), {
+            distortion: 0.4,
+            oversample: "none",
+        });
+    }
+    /**
+     * The amount of distortion. Nominal range is between 0 and 1.
+     */
+    get distortion() {
+        return this._distortion;
+    }
+    set distortion(amount) {
+        this._distortion = amount;
+        const k = amount * 100;
+        const deg = Math.PI / 180;
+        this._shaper.setMap((x) => {
+            if (Math.abs(x) < 0.001) {
+                // should output 0 when input is 0
+                return 0;
+            }
+            else {
+                return (3 + k) * x * 20 * deg / (Math.PI + k * Math.abs(x));
+            }
+        });
+    }
+    /**
+     * The oversampling of the effect. Can either be "none", "2x" or "4x".
+     */
+    get oversample() {
+        return this._shaper.oversample;
+    }
+    set oversample(oversampling) {
+        this._shaper.oversample = oversampling;
+    }
+    dispose() {
+        super.dispose();
+        this._shaper.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Distortion.js.map

package/build/esm/effect/Distortion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Distortion.js","sourceRoot":"","sources":["../../../Tone/effect/Distortion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAiB,MAAM,UAAU,CAAC;AAOjD;;;;;;;;;GASG;AACH,MAAM,OAAO,UAAW,SAAQ,MAAyB;IAmBxD;QAEC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAnBzE,SAAI,GAAW,YAAY,CAAC;QAoBpC,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;QAE1F,IAAI,CAAC,OAAO,GAAG,IAAI,UAAU,CAAC;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QAEtC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACtC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE;YAC1C,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,MAAwB;SACpC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,WAAW,CAAC;IACzB,CAAC;IACD,IAAI,UAAU,CAAC,MAAM;QACpB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,MAAM,CAAC,GAAG,MAAM,GAAG,GAAG,CAAC;QACvB,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;QAC1B,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YACzB,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,EAAE;gBACxB,kCAAkC;gBAClC,OAAO,CAAC,CAAC;aACT;iBAAM;gBACN,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;aAC5D;QACF,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;IAChC,CAAC;IACD,IAAI,UAAU,CAAC,YAAY;QAC1B,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,YAAY,CAAC;IACxC,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/effect/Effect.d.ts

@@ -0,0 +1,49 @@
+import { CrossFade } from "../component/channel/CrossFade";
+import { Gain } from "../core/context/Gain";
+import { ToneAudioNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+import { NormalRange } from "../core/type/Units";
+import { Signal } from "../signal/Signal";
+export interface EffectOptions extends ToneAudioNodeOptions {
+    wet: NormalRange;
+}
+/**
+ * Effect is the base class for effects. Connect the effect between
+ * the effectSend and effectReturn GainNodes, then control the amount of
+ * effect which goes to the output using the wet control.
+ */
+export declare abstract class Effect<Options extends EffectOptions> extends ToneAudioNode<Options> {
+    readonly name: string;
+    /**
+     * the drywet knob to control the amount of effect
+     */
+    private _dryWet;
+    /**
+     * The wet control is how much of the effected
+     * will pass through to the output. 1 = 100% effected
+     * signal, 0 = 100% dry signal.
+     */
+    wet: Signal<"normalRange">;
+    /**
+     * connect the effectSend to the input of hte effect
+     */
+    protected effectSend: Gain;
+    /**
+     * connect the output of the effect to the effectReturn
+     */
+    protected effectReturn: Gain;
+    /**
+     * The effect input node
+     */
+    input: Gain;
+    /**
+     * The effect output
+     */
+    output: CrossFade;
+    constructor(options: EffectOptions);
+    static getDefaults(): EffectOptions;
+    /**
+     * chains the effect in between the effectSend and effectReturn
+     */
+    protected connectEffect(effect: ToneAudioNode | AudioNode): this;
+    dispose(): this;
+}

package/build/esm/effect/Effect.js

@@ -0,0 +1,70 @@
+import { CrossFade } from "../component/channel/CrossFade";
+import { Gain } from "../core/context/Gain";
+import { ToneAudioNode } from "../core/context/ToneAudioNode";
+import { readOnly } from "../core/util/Interface";
+/**
+ * Effect is the base class for effects. Connect the effect between
+ * the effectSend and effectReturn GainNodes, then control the amount of
+ * effect which goes to the output using the wet control.
+ */
+export class Effect extends ToneAudioNode {
+    constructor(options) {
+        super(options);
+        this.name = "Effect";
+        /**
+         * the drywet knob to control the amount of effect
+         */
+        this._dryWet = new CrossFade({ context: this.context });
+        /**
+         * The wet control is how much of the effected
+         * will pass through to the output. 1 = 100% effected
+         * signal, 0 = 100% dry signal.
+         */
+        this.wet = this._dryWet.fade;
+        /**
+         * connect the effectSend to the input of hte effect
+         */
+        this.effectSend = new Gain({ context: this.context });
+        /**
+         * connect the output of the effect to the effectReturn
+         */
+        this.effectReturn = new Gain({ context: this.context });
+        /**
+         * The effect input node
+         */
+        this.input = new Gain({ context: this.context });
+        /**
+         * The effect output
+         */
+        this.output = this._dryWet;
+        // connections
+        this.input.fan(this._dryWet.a, this.effectSend);
+        this.effectReturn.connect(this._dryWet.b);
+        this.wet.setValueAtTime(options.wet, 0);
+        this._internalChannels = [this.effectReturn, this.effectSend];
+        readOnly(this, "wet");
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            wet: 1,
+        });
+    }
+    /**
+     * chains the effect in between the effectSend and effectReturn
+     */
+    connectEffect(effect) {
+        // add it to the internal channels
+        this._internalChannels.push(effect);
+        this.effectSend.chain(effect, this.effectReturn);
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._dryWet.dispose();
+        this.effectSend.dispose();
+        this.effectReturn.dispose();
+        this.wet.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Effect.js.map

package/build/esm/effect/Effect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Effect.js","sourceRoot":"","sources":["../../../Tone/effect/Effect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAwB,MAAM,+BAA+B,CAAC;AAEpF,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMlD;;;;GAIG;AACH,MAAM,OAAgB,MACrB,SAAQ,aAAsB;IAoC9B,YAAY,OAAsB;QACjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAnCP,SAAI,GAAW,QAAQ,CAAC;QAEjC;;WAEG;QACK,YAAO,GAAc,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtE;;;;WAIG;QACH,QAAG,GAA0B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;QAE/C;;WAEG;QACO,eAAU,GAAS,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEjE;;WAEG;QACO,iBAAY,GAAS,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEnE;;WAEG;QACH,UAAK,GAAS,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAElD;;WAEG;QACH,WAAM,GAAG,IAAI,CAAC,OAAO,CAAC;QAKrB,cAAc;QACd,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAChD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACxC,IAAI,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAC9D,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,GAAG,EAAE,CAAC;SACN,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACO,aAAa,CAAC,MAAiC;QACxD,kCAAkC;QAClC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/effect/FeedbackDelay.d.ts

@@ -0,0 +1,37 @@
+import { Param } from "../core/context/Param";
+import { NormalRange, Time } from "../core/type/Units";
+import { FeedbackEffect, FeedbackEffectOptions } from "./FeedbackEffect";
+interface FeedbackDelayOptions extends FeedbackEffectOptions {
+    delayTime: Time;
+    maxDelay: Time;
+}
+/**
+ * FeedbackDelay is a DelayNode in which part of output signal is fed back into the delay.
+ *
+ * @param delayTime The delay applied to the incoming signal.
+ * @param feedback The amount of the effected signal which is fed back through the delay.
+ * @example
+ * const feedbackDelay = new Tone.FeedbackDelay("8n", 0.5).toDestination();
+ * const tom = new Tone.MembraneSynth({
+ * 	octaves: 4,
+ * 	pitchDecay: 0.1
+ * }).connect(feedbackDelay);
+ * tom.triggerAttackRelease("A2", "32n");
+ * @category Effect
+ */
+export declare class FeedbackDelay extends FeedbackEffect<FeedbackDelayOptions> {
+    readonly name: string;
+    /**
+     * the delay node
+     */
+    private _delayNode;
+    /**
+     * The delayTime of the FeedbackDelay.
+     */
+    readonly delayTime: Param<"time">;
+    constructor(delayTime?: Time, feedback?: NormalRange);
+    constructor(options?: Partial<FeedbackDelayOptions>);
+    static getDefaults(): FeedbackDelayOptions;
+    dispose(): this;
+}
+export {};

package/build/esm/effect/FeedbackDelay.js

@@ -0,0 +1,47 @@
+import { Delay } from "../core/context/Delay";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { readOnly } from "../core/util/Interface";
+import { FeedbackEffect } from "./FeedbackEffect";
+/**
+ * FeedbackDelay is a DelayNode in which part of output signal is fed back into the delay.
+ *
+ * @param delayTime The delay applied to the incoming signal.
+ * @param feedback The amount of the effected signal which is fed back through the delay.
+ * @example
+ * const feedbackDelay = new Tone.FeedbackDelay("8n", 0.5).toDestination();
+ * const tom = new Tone.MembraneSynth({
+ * 	octaves: 4,
+ * 	pitchDecay: 0.1
+ * }).connect(feedbackDelay);
+ * tom.triggerAttackRelease("A2", "32n");
+ * @category Effect
+ */
+export class FeedbackDelay extends FeedbackEffect {
+    constructor() {
+        super(optionsFromArguments(FeedbackDelay.getDefaults(), arguments, ["delayTime", "feedback"]));
+        this.name = "FeedbackDelay";
+        const options = optionsFromArguments(FeedbackDelay.getDefaults(), arguments, ["delayTime", "feedback"]);
+        this._delayNode = new Delay({
+            context: this.context,
+            delayTime: options.delayTime,
+            maxDelay: options.maxDelay,
+        });
+        this.delayTime = this._delayNode.delayTime;
+        // connect it up
+        this.connectEffect(this._delayNode);
+        readOnly(this, "delayTime");
+    }
+    static getDefaults() {
+        return Object.assign(FeedbackEffect.getDefaults(), {
+            delayTime: 0.25,
+            maxDelay: 1,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._delayNode.dispose();
+        this.delayTime.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=FeedbackDelay.js.map

package/build/esm/effect/FeedbackDelay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeedbackDelay.js","sourceRoot":"","sources":["../../../Tone/effect/FeedbackDelay.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAG9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAyB,MAAM,kBAAkB,CAAC;AAOzE;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,aAAc,SAAQ,cAAoC;IAgBtE;QAEC,KAAK,CAAC,oBAAoB,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;QAhBvF,SAAI,GAAW,eAAe,CAAC;QAiBvC,MAAM,OAAO,GAAG,oBAAoB,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC;QAExG,IAAI,CAAC,UAAU,GAAG,IAAI,KAAK,CAAC;YAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;QAE3C,gBAAgB;QAChB,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE;YAClD,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,CAAC;SACX,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/effect/FeedbackEffect.d.ts

@@ -0,0 +1,34 @@
+import { Param } from "../core/context/Param";
+import { NormalRange } from "../core/type/Units";
+import { Effect, EffectOptions } from "./Effect";
+export interface FeedbackEffectOptions extends EffectOptions {
+    /**
+     * The feedback from the output back to the input
+     * ```
+     * +---<--------<---+
+     * |                |
+     * |  +----------+  |
+     * +--> feedback +>-+
+     *    +----------+
+     * ```
+     */
+    feedback: NormalRange;
+}
+/**
+ * FeedbackEffect provides a loop between an audio source and its own output.
+ * This is a base-class for feedback effects.
+ */
+export declare abstract class FeedbackEffect<Options extends FeedbackEffectOptions> extends Effect<Options> {
+    readonly name: string;
+    /**
+     * the gain which controls the feedback
+     */
+    private _feedbackGain;
+    /**
+     * The amount of signal which is fed back into the effect input.
+     */
+    feedback: Param<"normalRange">;
+    constructor(options: FeedbackEffectOptions);
+    static getDefaults(): FeedbackEffectOptions;
+    dispose(): this;
+}

package/build/esm/effect/FeedbackEffect.js

@@ -0,0 +1,34 @@
+import { Gain } from "../core/context/Gain";
+import { readOnly } from "../core/util/Interface";
+import { Effect } from "./Effect";
+/**
+ * FeedbackEffect provides a loop between an audio source and its own output.
+ * This is a base-class for feedback effects.
+ */
+export class FeedbackEffect extends Effect {
+    constructor(options) {
+        super(options);
+        this.name = "FeedbackEffect";
+        this._feedbackGain = new Gain({
+            context: this.context,
+            gain: options.feedback,
+            units: "normalRange",
+        });
+        this.feedback = this._feedbackGain.gain;
+        readOnly(this, "feedback");
+        // the feedback loop
+        this.effectReturn.chain(this._feedbackGain, this.effectSend);
+    }
+    static getDefaults() {
+        return Object.assign(Effect.getDefaults(), {
+            feedback: 0.125,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._feedbackGain.dispose();
+        this.feedback.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=FeedbackEffect.js.map