tone 14.8.27

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

@@ -0,0 +1,62 @@
+import { Seconds, Time } from "../core/type/Units";
+import { Effect, EffectOptions } from "./Effect";
+interface ReverbOptions extends EffectOptions {
+    decay: Seconds;
+    preDelay: Seconds;
+}
+/**
+ * Simple convolution created with decaying noise.
+ * Generates an Impulse Response Buffer
+ * with Tone.Offline then feeds the IR into ConvolverNode.
+ * The impulse response generation is async, so you have
+ * to wait until [[ready]] resolves before it will make a sound.
+ *
+ * Inspiration from [ReverbGen](https://github.com/adelespinasse/reverbGen).
+ * Copyright (c) 2014 Alan deLespinasse Apache 2.0 License.
+ *
+ * @category Effect
+ */
+export declare class Reverb extends Effect<ReverbOptions> {
+    readonly name: string;
+    /**
+     * Convolver node
+     */
+    private _convolver;
+    /**
+     * The duration of the reverb.
+     */
+    private _decay;
+    /**
+     * The amount of time before the reverb is fully ramped in.
+     */
+    private _preDelay;
+    /**
+     * Resolves when the reverb buffer is generated. Whenever either [[decay]]
+     * or [[preDelay]] are set, you have to wait until [[ready]] resolves
+     * before the IR is generated with the latest values.
+     */
+    ready: Promise<void>;
+    /**
+     * @param decay The amount of time it will reverberate for.
+     */
+    constructor(decay?: Seconds);
+    constructor(options?: Partial<ReverbOptions>);
+    static getDefaults(): ReverbOptions;
+    /**
+     * The duration of the reverb.
+     */
+    get decay(): Time;
+    set decay(time: Time);
+    /**
+     * The amount of time before the reverb is fully ramped in.
+     */
+    get preDelay(): Time;
+    set preDelay(time: Time);
+    /**
+     * Generate the Impulse Response. Returns a promise while the IR is being generated.
+     * @return Promise which returns this object.
+     */
+    generate(): Promise<this>;
+    dispose(): this;
+}
+export {};

package/build/esm/effect/Reverb.js

@@ -0,0 +1,111 @@
+import { __awaiter } from "tslib";
+import { Merge } from "../component/channel/Merge";
+import { Gain } from "../core/context/Gain";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { Noise } from "../source/Noise";
+import { Effect } from "./Effect";
+import { OfflineContext } from "../core/context/OfflineContext";
+import { noOp } from "../core/util/Interface";
+import { assertRange } from "../core/util/Debug";
+/**
+ * Simple convolution created with decaying noise.
+ * Generates an Impulse Response Buffer
+ * with Tone.Offline then feeds the IR into ConvolverNode.
+ * The impulse response generation is async, so you have
+ * to wait until [[ready]] resolves before it will make a sound.
+ *
+ * Inspiration from [ReverbGen](https://github.com/adelespinasse/reverbGen).
+ * Copyright (c) 2014 Alan deLespinasse Apache 2.0 License.
+ *
+ * @category Effect
+ */
+export class Reverb extends Effect {
+    constructor() {
+        super(optionsFromArguments(Reverb.getDefaults(), arguments, ["decay"]));
+        this.name = "Reverb";
+        /**
+         * Convolver node
+         */
+        this._convolver = this.context.createConvolver();
+        /**
+         * Resolves when the reverb buffer is generated. Whenever either [[decay]]
+         * or [[preDelay]] are set, you have to wait until [[ready]] resolves
+         * before the IR is generated with the latest values.
+         */
+        this.ready = Promise.resolve();
+        const options = optionsFromArguments(Reverb.getDefaults(), arguments, ["decay"]);
+        this._decay = options.decay;
+        this._preDelay = options.preDelay;
+        this.generate();
+        this.connectEffect(this._convolver);
+    }
+    static getDefaults() {
+        return Object.assign(Effect.getDefaults(), {
+            decay: 1.5,
+            preDelay: 0.01,
+        });
+    }
+    /**
+     * The duration of the reverb.
+     */
+    get decay() {
+        return this._decay;
+    }
+    set decay(time) {
+        time = this.toSeconds(time);
+        assertRange(time, 0.001);
+        this._decay = time;
+        this.generate();
+    }
+    /**
+     * The amount of time before the reverb is fully ramped in.
+     */
+    get preDelay() {
+        return this._preDelay;
+    }
+    set preDelay(time) {
+        time = this.toSeconds(time);
+        assertRange(time, 0);
+        this._preDelay = time;
+        this.generate();
+    }
+    /**
+     * Generate the Impulse Response. Returns a promise while the IR is being generated.
+     * @return Promise which returns this object.
+     */
+    generate() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const previousReady = this.ready;
+            // create a noise burst which decays over the duration in each channel
+            const context = new OfflineContext(2, this._decay + this._preDelay, this.context.sampleRate);
+            const noiseL = new Noise({ context });
+            const noiseR = new Noise({ context });
+            const merge = new Merge({ context });
+            noiseL.connect(merge, 0, 0);
+            noiseR.connect(merge, 0, 1);
+            const gainNode = new Gain({ context }).toDestination();
+            merge.connect(gainNode);
+            noiseL.start(0);
+            noiseR.start(0);
+            // predelay
+            gainNode.gain.setValueAtTime(0, 0);
+            gainNode.gain.setValueAtTime(1, this._preDelay);
+            // decay
+            gainNode.gain.exponentialApproachValueAtTime(0, this._preDelay, this.decay);
+            // render the buffer
+            const renderPromise = context.render();
+            this.ready = renderPromise.then(noOp);
+            // wait for the previous `ready` to resolve
+            yield previousReady;
+            // set the buffer
+            this._convolver.buffer = (yield renderPromise).get();
+            return this;
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._convolver.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=Reverb.js.map

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

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

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

@@ -0,0 +1,44 @@
+import { EffectOptions } from "./Effect";
+import { OutputNode, ToneAudioNode } from "../core/context/ToneAudioNode";
+import { CrossFade } from "../component/channel/CrossFade";
+import { Signal } from "../signal/Signal";
+import { Split } from "../component/channel/Split";
+import { Gain } from "../core/context/Gain";
+import { Merge } from "../component/channel/Merge";
+export declare type StereoEffectOptions = EffectOptions;
+/**
+ * Base class for Stereo effects.
+ */
+export declare class StereoEffect<Options extends StereoEffectOptions> extends ToneAudioNode<Options> {
+    readonly name: string;
+    readonly input: Gain;
+    readonly output: CrossFade;
+    /**
+     * the drywet knob to control the amount of effect
+     */
+    private _dryWet;
+    /**
+     * The wet control, i.e. how much of the effected
+     * will pass through to the output.
+     */
+    readonly wet: Signal<"normalRange">;
+    /**
+     * Split it
+     */
+    protected _split: Split;
+    /**
+     * the stereo effect merger
+     */
+    protected _merge: Merge;
+    constructor(options: StereoEffectOptions);
+    /**
+     * Connect the left part of the effect
+     */
+    protected connectEffectLeft(...nodes: OutputNode[]): void;
+    /**
+     * Connect the right part of the effect
+     */
+    protected connectEffectRight(...nodes: OutputNode[]): void;
+    static getDefaults(): StereoEffectOptions;
+    dispose(): this;
+}

package/build/esm/effect/StereoEffect.js

@@ -0,0 +1,61 @@
+import { connect, connectSeries, ToneAudioNode } from "../core/context/ToneAudioNode";
+import { CrossFade } from "../component/channel/CrossFade";
+import { Split } from "../component/channel/Split";
+import { Gain } from "../core/context/Gain";
+import { Merge } from "../component/channel/Merge";
+import { readOnly } from "../core/util/Interface";
+/**
+ * Base class for Stereo effects.
+ */
+export class StereoEffect extends ToneAudioNode {
+    constructor(options) {
+        super(options);
+        this.name = "StereoEffect";
+        this.input = new Gain({ context: this.context });
+        // force mono sources to be stereo
+        this.input.channelCount = 2;
+        this.input.channelCountMode = "explicit";
+        this._dryWet = this.output = new CrossFade({
+            context: this.context,
+            fade: options.wet
+        });
+        this.wet = this._dryWet.fade;
+        this._split = new Split({ context: this.context, channels: 2 });
+        this._merge = new Merge({ context: this.context, channels: 2 });
+        // connections
+        this.input.connect(this._split);
+        // dry wet connections
+        this.input.connect(this._dryWet.a);
+        this._merge.connect(this._dryWet.b);
+        readOnly(this, ["wet"]);
+    }
+    /**
+     * Connect the left part of the effect
+     */
+    connectEffectLeft(...nodes) {
+        this._split.connect(nodes[0], 0, 0);
+        connectSeries(...nodes);
+        connect(nodes[nodes.length - 1], this._merge, 0, 0);
+    }
+    /**
+     * Connect the right part of the effect
+     */
+    connectEffectRight(...nodes) {
+        this._split.connect(nodes[0], 1, 0);
+        connectSeries(...nodes);
+        connect(nodes[nodes.length - 1], this._merge, 0, 1);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            wet: 1,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._dryWet.dispose();
+        this._split.dispose();
+        this._merge.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=StereoEffect.js.map

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

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

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

@@ -0,0 +1,39 @@
+import { StereoEffect, StereoEffectOptions } from "./StereoEffect";
+import { NormalRange } from "../core/type/Units";
+import { Signal } from "../signal/Signal";
+import { Gain } from "../core/context/Gain";
+import { Split } from "../component/channel/Split";
+import { Merge } from "../component/channel/Merge";
+export interface StereoFeedbackEffectOptions extends StereoEffectOptions {
+    feedback: NormalRange;
+}
+/**
+ * Base class for stereo feedback effects where the effectReturn is fed back into the same channel.
+ */
+export declare class StereoFeedbackEffect<Options extends StereoFeedbackEffectOptions> extends StereoEffect<Options> {
+    /**
+     * The amount of feedback from the output
+     * back into the input of the effect (routed
+     * across left and right channels).
+     */
+    readonly feedback: Signal<"normalRange">;
+    /**
+     * the left side feedback
+     */
+    protected _feedbackL: Gain;
+    /**
+     * the right side feedback
+     */
+    protected _feedbackR: Gain;
+    /**
+     * Split the channels for feedback
+     */
+    protected _feedbackSplit: Split;
+    /**
+     * Merge the channels for feedback
+     */
+    protected _feedbackMerge: Merge;
+    constructor(options: StereoFeedbackEffectOptions);
+    static getDefaults(): StereoFeedbackEffectOptions;
+    dispose(): this;
+}

package/build/esm/effect/StereoFeedbackEffect.js

@@ -0,0 +1,49 @@
+import { StereoEffect } from "./StereoEffect";
+import { Signal } from "../signal/Signal";
+import { Gain } from "../core/context/Gain";
+import { readOnly } from "../core/util/Interface";
+import { Split } from "../component/channel/Split";
+import { Merge } from "../component/channel/Merge";
+/**
+ * Base class for stereo feedback effects where the effectReturn is fed back into the same channel.
+ */
+export class StereoFeedbackEffect extends StereoEffect {
+    constructor(options) {
+        super(options);
+        this.feedback = new Signal({
+            context: this.context,
+            value: options.feedback,
+            units: "normalRange"
+        });
+        this._feedbackL = new Gain({ context: this.context });
+        this._feedbackR = new Gain({ context: this.context });
+        this._feedbackSplit = new Split({ context: this.context, channels: 2 });
+        this._feedbackMerge = new Merge({ context: this.context, channels: 2 });
+        this._merge.connect(this._feedbackSplit);
+        this._feedbackMerge.connect(this._split);
+        // the left output connected to the left input
+        this._feedbackSplit.connect(this._feedbackL, 0, 0);
+        this._feedbackL.connect(this._feedbackMerge, 0, 0);
+        // the right output connected to the right input
+        this._feedbackSplit.connect(this._feedbackR, 1, 0);
+        this._feedbackR.connect(this._feedbackMerge, 0, 1);
+        // the feedback control
+        this.feedback.fan(this._feedbackL.gain, this._feedbackR.gain);
+        readOnly(this, ["feedback"]);
+    }
+    static getDefaults() {
+        return Object.assign(StereoEffect.getDefaults(), {
+            feedback: 0.5,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.feedback.dispose();
+        this._feedbackL.dispose();
+        this._feedbackR.dispose();
+        this._feedbackSplit.dispose();
+        this._feedbackMerge.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=StereoFeedbackEffect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StereoFeedbackEffect.js","sourceRoot":"","sources":["../../../Tone/effect/StereoFeedbackEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAuB,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAMnD;;GAEG;AACH,MAAM,OAAO,oBAAkE,SAAQ,YAAqB;IA6B3G,YAAY,OAAoC;QAE/C,KAAK,CAAC,OAAO,CAAC,CAAC;QAEf,IAAI,CAAC,QAAQ,GAAG,IAAI,MAAM,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,OAAO,CAAC,QAAQ;YACvB,KAAK,EAAE,aAAa;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,IAAI,CAAC,UAAU,GAAG,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEtD,IAAI,CAAC,cAAc,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,CAAC,cAAc,GAAG,IAAI,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC;QAExE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QACzC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEzC,8CAA8C;QAC9C,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnD,gDAAgD;QAChD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnD,uBAAuB;QACvB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAC9D,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,WAAW,EAAE,EAAE;YAChD,QAAQ,EAAE,GAAG;SACb,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC1B,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC9B,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

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

@@ -0,0 +1,50 @@
+import { MidSideEffect, MidSideEffectOptions } from "../effect/MidSideEffect";
+import { Signal } from "../signal/Signal";
+import { NormalRange } from "../core/type/Units";
+export interface StereoWidenerOptions extends MidSideEffectOptions {
+    width: NormalRange;
+}
+/**
+ * Applies a width factor to the mid/side seperation.
+ * 0 is all mid and 1 is all side.
+ * Algorithm found in [kvraudio forums](http://www.kvraudio.com/forum/viewtopic.php?t=212587).
+ * ```
+ * Mid *= 2*(1-width)<br>
+ * Side *= 2*width
+ * ```
+ * @category Effect
+ */
+export declare class StereoWidener extends MidSideEffect<StereoWidenerOptions> {
+    readonly name: string;
+    /**
+     * The width control. 0 = 100% mid. 1 = 100% side. 0.5 = no change.
+     */
+    readonly width: Signal<"normalRange">;
+    /**
+     * Two times the (1-width) for the mid channel
+     */
+    private _twoTimesWidthMid;
+    /**
+     * Two times the width for the side channel
+     */
+    private _twoTimesWidthSide;
+    /**
+     * Mid multiplier
+     */
+    private _midMult;
+    /**
+     * 1 - width
+     */
+    private _oneMinusWidth;
+    /**
+     * Side multiplier
+     */
+    private _sideMult;
+    /**
+     * @param width The stereo width. A width of 0 is mono and 1 is stereo. 0.5 is no change.
+     */
+    constructor(width?: NormalRange);
+    constructor(options?: Partial<StereoWidenerOptions>);
+    static getDefaults(): StereoWidenerOptions;
+    dispose(): this;
+}

package/build/esm/effect/StereoWidener.js

@@ -0,0 +1,65 @@
+import { MidSideEffect } from "../effect/MidSideEffect";
+import { Signal } from "../signal/Signal";
+import { Multiply } from "../signal/Multiply";
+import { Subtract } from "../signal/Subtract";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { readOnly } from "../core/util/Interface";
+import { connect } from "../core/context/ToneAudioNode";
+/**
+ * Applies a width factor to the mid/side seperation.
+ * 0 is all mid and 1 is all side.
+ * Algorithm found in [kvraudio forums](http://www.kvraudio.com/forum/viewtopic.php?t=212587).
+ * ```
+ * Mid *= 2*(1-width)<br>
+ * Side *= 2*width
+ * ```
+ * @category Effect
+ */
+export class StereoWidener extends MidSideEffect {
+    constructor() {
+        super(optionsFromArguments(StereoWidener.getDefaults(), arguments, ["width"]));
+        this.name = "StereoWidener";
+        const options = optionsFromArguments(StereoWidener.getDefaults(), arguments, ["width"]);
+        this.width = new Signal({
+            context: this.context,
+            value: options.width,
+            units: "normalRange",
+        });
+        readOnly(this, ["width"]);
+        this._twoTimesWidthMid = new Multiply({
+            context: this.context,
+            value: 2,
+        });
+        this._twoTimesWidthSide = new Multiply({
+            context: this.context,
+            value: 2,
+        });
+        this._midMult = new Multiply({ context: this.context });
+        this._twoTimesWidthMid.connect(this._midMult.factor);
+        this.connectEffectMid(this._midMult);
+        this._oneMinusWidth = new Subtract({ context: this.context });
+        this._oneMinusWidth.connect(this._twoTimesWidthMid);
+        connect(this.context.getConstant(1), this._oneMinusWidth);
+        this.width.connect(this._oneMinusWidth.subtrahend);
+        this._sideMult = new Multiply({ context: this.context });
+        this.width.connect(this._twoTimesWidthSide);
+        this._twoTimesWidthSide.connect(this._sideMult.factor);
+        this.connectEffectSide(this._sideMult);
+    }
+    static getDefaults() {
+        return Object.assign(MidSideEffect.getDefaults(), {
+            width: 0.5,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.width.dispose();
+        this._midMult.dispose();
+        this._sideMult.dispose();
+        this._twoTimesWidthMid.dispose();
+        this._twoTimesWidthSide.dispose();
+        this._oneMinusWidth.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=StereoWidener.js.map

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

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

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

@@ -0,0 +1,21 @@
+import { StereoFeedbackEffect, StereoFeedbackEffectOptions } from "./StereoFeedbackEffect";
+import { NormalRange } from "../core/type/Units";
+export interface StereoXFeedbackEffectOptions extends StereoFeedbackEffectOptions {
+    feedback: NormalRange;
+}
+/**
+ * Just like a [[StereoFeedbackEffect]], but the feedback is routed from left to right
+ * and right to left instead of on the same channel.
+ * ```
+ * +--------------------------------+ feedbackL <-----------------------------------+
+ * |                                                                                |
+ * +-->                          +----->        +---->                          +-----+
+ *      feedbackMerge +--> split        (EFFECT)       merge +--> feedbackSplit     | |
+ * +-->                          +----->        +---->                          +---+ |
+ * |                                                                                  |
+ * +--------------------------------+ feedbackR <-------------------------------------+
+ * ```
+ */
+export declare class StereoXFeedbackEffect<Options extends StereoXFeedbackEffectOptions> extends StereoFeedbackEffect<Options> {
+    constructor(options: StereoXFeedbackEffectOptions);
+}

package/build/esm/effect/StereoXFeedbackEffect.js

@@ -0,0 +1,28 @@
+import { StereoFeedbackEffect } from "./StereoFeedbackEffect";
+import { readOnly } from "../core/util/Interface";
+/**
+ * Just like a [[StereoFeedbackEffect]], but the feedback is routed from left to right
+ * and right to left instead of on the same channel.
+ * ```
+ * +--------------------------------+ feedbackL <-----------------------------------+
+ * |                                                                                |
+ * +-->                          +----->        +---->                          +-----+
+ *      feedbackMerge +--> split        (EFFECT)       merge +--> feedbackSplit     | |
+ * +-->                          +----->        +---->                          +---+ |
+ * |                                                                                  |
+ * +--------------------------------+ feedbackR <-------------------------------------+
+ * ```
+ */
+export class StereoXFeedbackEffect extends StereoFeedbackEffect {
+    constructor(options) {
+        super(options);
+        // the left output connected to the right input
+        this._feedbackL.disconnect();
+        this._feedbackL.connect(this._feedbackMerge, 0, 1);
+        // the left output connected to the right input
+        this._feedbackR.disconnect();
+        this._feedbackR.connect(this._feedbackMerge, 0, 0);
+        readOnly(this, ["feedback"]);
+    }
+}
+//# sourceMappingURL=StereoXFeedbackEffect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"StereoXFeedbackEffect.js","sourceRoot":"","sources":["../../../Tone/effect/StereoXFeedbackEffect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAA+B,MAAM,wBAAwB,CAAC;AAE3F,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAMlD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAoE,SAAQ,oBAA6B;IAErH,YAAY,OAAqC;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,+CAA+C;QAC/C,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnD,+CAA+C;QAC/C,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;QAC7B,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEnD,QAAQ,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;IAC9B,CAAC;CACD"}

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

@@ -0,0 +1,86 @@
+import { StereoEffect, StereoEffectOptions } from "./StereoEffect";
+import { Signal } from "../signal/Signal";
+import { Degrees, Frequency, NormalRange, Time } from "../core/type/Units";
+import { ToneOscillatorType } from "../source/oscillator/OscillatorInterface";
+export interface TremoloOptions extends StereoEffectOptions {
+    frequency: Frequency;
+    type: ToneOscillatorType;
+    depth: NormalRange;
+    spread: Degrees;
+}
+/**
+ * Tremolo modulates the amplitude of an incoming signal using an [[LFO]].
+ * The effect is a stereo effect where the modulation phase is inverted in each channel.
+ *
+ * @example
+ * // create a tremolo and start it's LFO
+ * const tremolo = new Tone.Tremolo(9, 0.75).toDestination().start();
+ * // route an oscillator through the tremolo and start it
+ * const oscillator = new Tone.Oscillator().connect(tremolo).start();
+ *
+ * @category Effect
+ */
+export declare class Tremolo extends StereoEffect<TremoloOptions> {
+    readonly name: string;
+    /**
+     * The tremolo LFO in the left channel
+     */
+    private _lfoL;
+    /**
+     * The tremolo LFO in the left channel
+     */
+    private _lfoR;
+    /**
+     * Where the gain is multiplied
+     */
+    private _amplitudeL;
+    /**
+     * Where the gain is multiplied
+     */
+    private _amplitudeR;
+    /**
+     * The frequency of the tremolo.
+     */
+    readonly frequency: Signal<"frequency">;
+    /**
+     * The depth of the effect. A depth of 0, has no effect
+     * on the amplitude, and a depth of 1 makes the amplitude
+     * modulate fully between 0 and 1.
+     */
+    readonly depth: Signal<"normalRange">;
+    /**
+     * @param frequency The rate of the effect.
+     * @param depth The depth of the effect.
+     */
+    constructor(frequency?: Frequency, depth?: NormalRange);
+    constructor(options?: Partial<TremoloOptions>);
+    static getDefaults(): TremoloOptions;
+    /**
+     * Start the tremolo.
+     */
+    start(time?: Time): this;
+    /**
+     * Stop the tremolo.
+     */
+    stop(time?: Time): this;
+    /**
+     * Sync the effect to the transport.
+     */
+    sync(): this;
+    /**
+     * Unsync the filter from the transport
+     */
+    unsync(): this;
+    /**
+     * The oscillator type.
+     */
+    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);
+    dispose(): this;
+}