tone 14.8.27

package/build/esm/component/analysis/MeterBase.d.ts

@@ -0,0 +1,23 @@
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Analyser } from "./Analyser";
+export declare type MeterBaseOptions = ToneAudioNodeOptions;
+/**
+ * The base class for Metering classes.
+ */
+export declare class MeterBase<Options extends MeterBaseOptions> extends ToneAudioNode<Options> {
+    readonly name: string;
+    /**
+     * The signal to be analysed
+     */
+    input: InputNode;
+    /**
+     * The output is just a pass through of the input
+     */
+    output: OutputNode;
+    /**
+     * The analyser node for the incoming signal
+     */
+    protected _analyser: Analyser;
+    constructor(options?: Partial<MeterBaseOptions>);
+    dispose(): this;
+}

package/build/esm/component/analysis/MeterBase.js

@@ -0,0 +1,23 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Analyser } from "./Analyser";
+/**
+ * The base class for Metering classes.
+ */
+export class MeterBase extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(MeterBase.getDefaults(), arguments));
+        this.name = "MeterBase";
+        this.input = this.output = this._analyser = new Analyser({
+            context: this.context,
+            size: 256,
+            type: "waveform",
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._analyser.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=MeterBase.js.map

package/build/esm/component/analysis/MeterBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MeterBase.js","sourceRoot":"","sources":["../../../../Tone/component/analysis/MeterBase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAItC;;GAEG;AACH,MAAM,OAAO,SAA4C,SAAQ,aAAsB;IAoBtF;QACC,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QAnBxD,SAAI,GAAW,WAAW,CAAC;QAqBnC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,QAAQ,CAAC;YACxD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,UAAU;SAChB,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/component/analysis/Waveform.d.ts

@@ -0,0 +1,32 @@
+import { PowerOfTwo } from "../../core/type/Units";
+import { MeterBase, MeterBaseOptions } from "./MeterBase";
+export interface WaveformOptions extends MeterBaseOptions {
+    /**
+     * The size of the Waveform. Value must be a power of two in the range 16 to 16384.
+     */
+    size: PowerOfTwo;
+}
+/**
+ * Get the current waveform data of the connected audio source.
+ * @category Component
+ */
+export declare class Waveform extends MeterBase<WaveformOptions> {
+    readonly name: string;
+    /**
+     * @param size The size of the Waveform. Value must be a power of two in the range 16 to 16384.
+     */
+    constructor(size?: PowerOfTwo);
+    constructor(options?: Partial<WaveformOptions>);
+    static getDefaults(): WaveformOptions;
+    /**
+     * Return the waveform for the current time as a Float32Array where each value in the array
+     * represents a sample in the waveform.
+     */
+    getValue(): Float32Array;
+    /**
+     * The size of analysis. This must be a power of two in the range 16 to 16384.
+     * Determines the size of the array returned by [[getValue]].
+     */
+    get size(): PowerOfTwo;
+    set size(size: PowerOfTwo);
+}

package/build/esm/component/analysis/Waveform.js

@@ -0,0 +1,38 @@
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { MeterBase } from "./MeterBase";
+/**
+ * Get the current waveform data of the connected audio source.
+ * @category Component
+ */
+export class Waveform extends MeterBase {
+    constructor() {
+        super(optionsFromArguments(Waveform.getDefaults(), arguments, ["size"]));
+        this.name = "Waveform";
+        const options = optionsFromArguments(Waveform.getDefaults(), arguments, ["size"]);
+        this._analyser.type = "waveform";
+        this.size = options.size;
+    }
+    static getDefaults() {
+        return Object.assign(MeterBase.getDefaults(), {
+            size: 1024,
+        });
+    }
+    /**
+     * Return the waveform for the current time as a Float32Array where each value in the array
+     * represents a sample in the waveform.
+     */
+    getValue() {
+        return this._analyser.getValue();
+    }
+    /**
+     * The size of analysis. This must be a power of two in the range 16 to 16384.
+     * Determines the size of the array returned by [[getValue]].
+     */
+    get size() {
+        return this._analyser.size;
+    }
+    set size(size) {
+        this._analyser.size = size;
+    }
+}
+//# sourceMappingURL=Waveform.js.map

package/build/esm/component/analysis/Waveform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Waveform.js","sourceRoot":"","sources":["../../../../Tone/component/analysis/Waveform.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAS1D;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,SAA0B;IASvD;QACC,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QARjE,SAAI,GAAW,UAAU,CAAC;QASlC,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAElF,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,UAAU,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE;YAC7C,IAAI,EAAE,IAAI;SACV,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,QAAQ;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAkB,CAAC;IAClD,CAAC;IAED;;;OAGG;IACH,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC5B,CAAC;IACD,IAAI,IAAI,CAAC,IAAI;QACZ,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC;IAC5B,CAAC;CACD"}

package/build/esm/component/channel/Channel.d.ts

@@ -0,0 +1,91 @@
+import { AudioRange, Decibels } from "../../core/type/Units";
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Param } from "../../core/context/Param";
+import { Gain } from "../../core/context/Gain";
+export interface ChannelOptions extends ToneAudioNodeOptions {
+    pan: AudioRange;
+    volume: Decibels;
+    solo: boolean;
+    mute: boolean;
+    channelCount: number;
+}
+/**
+ * Channel provides a channel strip interface with volume, pan, solo and mute controls.
+ * See [[PanVol]] and [[Solo]]
+ * @example
+ * // pan the incoming signal left and drop the volume 12db
+ * const channel = new Tone.Channel(-0.25, -12);
+ * @category Component
+ */
+export declare class Channel extends ToneAudioNode<ChannelOptions> {
+    readonly name: string;
+    readonly input: InputNode;
+    readonly output: OutputNode;
+    /**
+     * The soloing interface
+     */
+    private _solo;
+    /**
+     * The panning and volume node
+     */
+    private _panVol;
+    /**
+     * The L/R panning control. -1 = hard left, 1 = hard right.
+     * @min -1
+     * @max 1
+     */
+    readonly pan: Param<"audioRange">;
+    /**
+     * The volume control in decibels.
+     */
+    readonly volume: Param<"decibels">;
+    /**
+     * @param volume The output volume.
+     * @param pan the initial pan
+     */
+    constructor(volume?: Decibels, pan?: AudioRange);
+    constructor(options?: Partial<ChannelOptions>);
+    static getDefaults(): ChannelOptions;
+    /**
+     * Solo/unsolo the channel. Soloing is only relative to other [[Channels]] and [[Solo]] instances
+     */
+    get solo(): boolean;
+    set solo(solo: boolean);
+    /**
+     * If the current instance is muted, i.e. another instance is soloed,
+     * or the channel is muted
+     */
+    get muted(): boolean;
+    /**
+     * Mute/unmute the volume
+     */
+    get mute(): boolean;
+    set mute(mute: boolean);
+    /**
+     * Store the send/receive channels by name.
+     */
+    private static buses;
+    /**
+     * Get the gain node belonging to the bus name. Create it if
+     * it doesn't exist
+     * @param name The bus name
+     */
+    private _getBus;
+    /**
+     * Send audio to another channel using a string. `send` is a lot like
+     * [[connect]], except it uses a string instead of an object. This can
+     * be useful in large applications to decouple sections since [[send]]
+     * and [[receive]] can be invoked separately in order to connect an object
+     * @param name The channel name to send the audio
+     * @param volume The amount of the signal to send.
+     * 	Defaults to 0db, i.e. send the entire signal
+     * @returns Returns the gain node of this connection.
+     */
+    send(name: string, volume?: Decibels): Gain<"decibels">;
+    /**
+     * Receive audio from a channel which was connected with [[send]].
+     * @param name The channel name to receive audio from.
+     */
+    receive(name: string): this;
+    dispose(): this;
+}

package/build/esm/component/channel/Channel.js

@@ -0,0 +1,124 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Solo } from "./Solo";
+import { PanVol } from "./PanVol";
+import { readOnly } from "../../core/util/Interface";
+import { Gain } from "../../core/context/Gain";
+/**
+ * Channel provides a channel strip interface with volume, pan, solo and mute controls.
+ * See [[PanVol]] and [[Solo]]
+ * @example
+ * // pan the incoming signal left and drop the volume 12db
+ * const channel = new Tone.Channel(-0.25, -12);
+ * @category Component
+ */
+export class Channel extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Channel.getDefaults(), arguments, ["volume", "pan"]));
+        this.name = "Channel";
+        const options = optionsFromArguments(Channel.getDefaults(), arguments, ["volume", "pan"]);
+        this._solo = this.input = new Solo({
+            solo: options.solo,
+            context: this.context,
+        });
+        this._panVol = this.output = new PanVol({
+            context: this.context,
+            pan: options.pan,
+            volume: options.volume,
+            mute: options.mute,
+            channelCount: options.channelCount
+        });
+        this.pan = this._panVol.pan;
+        this.volume = this._panVol.volume;
+        this._solo.connect(this._panVol);
+        readOnly(this, ["pan", "volume"]);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            pan: 0,
+            volume: 0,
+            mute: false,
+            solo: false,
+            channelCount: 1,
+        });
+    }
+    /**
+     * Solo/unsolo the channel. Soloing is only relative to other [[Channels]] and [[Solo]] instances
+     */
+    get solo() {
+        return this._solo.solo;
+    }
+    set solo(solo) {
+        this._solo.solo = solo;
+    }
+    /**
+     * If the current instance is muted, i.e. another instance is soloed,
+     * or the channel is muted
+     */
+    get muted() {
+        return this._solo.muted || this.mute;
+    }
+    /**
+     * Mute/unmute the volume
+     */
+    get mute() {
+        return this._panVol.mute;
+    }
+    set mute(mute) {
+        this._panVol.mute = mute;
+    }
+    /**
+     * Get the gain node belonging to the bus name. Create it if
+     * it doesn't exist
+     * @param name The bus name
+     */
+    _getBus(name) {
+        if (!Channel.buses.has(name)) {
+            Channel.buses.set(name, new Gain({ context: this.context }));
+        }
+        return Channel.buses.get(name);
+    }
+    /**
+     * Send audio to another channel using a string. `send` is a lot like
+     * [[connect]], except it uses a string instead of an object. This can
+     * be useful in large applications to decouple sections since [[send]]
+     * and [[receive]] can be invoked separately in order to connect an object
+     * @param name The channel name to send the audio
+     * @param volume The amount of the signal to send.
+     * 	Defaults to 0db, i.e. send the entire signal
+     * @returns Returns the gain node of this connection.
+     */
+    send(name, volume = 0) {
+        const bus = this._getBus(name);
+        const sendKnob = new Gain({
+            context: this.context,
+            units: "decibels",
+            gain: volume,
+        });
+        this.connect(sendKnob);
+        sendKnob.connect(bus);
+        return sendKnob;
+    }
+    /**
+     * Receive audio from a channel which was connected with [[send]].
+     * @param name The channel name to receive audio from.
+     */
+    receive(name) {
+        const bus = this._getBus(name);
+        bus.connect(this);
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._panVol.dispose();
+        this.pan.dispose();
+        this.volume.dispose();
+        this._solo.dispose();
+        return this;
+    }
+}
+/**
+ * Store the send/receive channels by name.
+ */
+Channel.buses = new Map();
+//# sourceMappingURL=Channel.js.map

package/build/esm/component/channel/Channel.js.map

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

package/build/esm/component/channel/CrossFade.d.ts

@@ -0,0 +1,80 @@
+import { Gain } from "../../core/context/Gain";
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { NormalRange } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+interface CrossFadeOptions extends ToneAudioNodeOptions {
+    fade: NormalRange;
+}
+/**
+ * Tone.Crossfade provides equal power fading between two inputs.
+ * More on crossfading technique [here](https://en.wikipedia.org/wiki/Fade_(audio_engineering)#Crossfading).
+ * ```
+ *                                             +---------+
+ *                                            +> input a +>--+
+ * +-----------+   +---------------------+     |         |   |
+ * | 1s signal +>--> stereoPannerNode  L +>----> gain    |   |
+ * +-----------+   |                     |     +---------+   |
+ *               +-> pan               R +>-+                |   +--------+
+ *               | +---------------------+  |                +---> output +>
+ *  +------+     |                          |  +---------+   |   +--------+
+ *  | fade +>----+                          | +> input b +>--+
+ *  +------+                                |  |         |
+ *                                          +--> gain    |
+ *                                             +---------+
+ * ```
+ * @example
+ * const crossFade = new Tone.CrossFade().toDestination();
+ * // connect two inputs Tone.to a/b
+ * const inputA = new Tone.Oscillator(440, "square").connect(crossFade.a).start();
+ * const inputB = new Tone.Oscillator(440, "sine").connect(crossFade.b).start();
+ * // use the fade to control the mix between the two
+ * crossFade.fade.value = 0.5;
+ * @category Component
+ */
+export declare class CrossFade extends ToneAudioNode<CrossFadeOptions> {
+    readonly name: string;
+    /**
+     * The crossfading is done by a StereoPannerNode
+     */
+    private _panner;
+    /**
+     * Split the output of the panner node into two values used to control the gains.
+     */
+    private _split;
+    /**
+     * Convert the fade value into an audio range value so it can be connected
+     * to the panner.pan AudioParam
+     */
+    private _g2a;
+    /**
+     * The input which is at full level when fade = 0
+     */
+    readonly a: Gain;
+    /**
+     * The input which is at full level when fade = 1
+     */
+    readonly b: Gain;
+    /**
+     * The output is a mix between `a` and `b` at the ratio of `fade`
+     */
+    readonly output: Gain;
+    /**
+     * CrossFade has no input, you must choose either `a` or `b`
+     */
+    readonly input: undefined;
+    /**
+     * The mix between the two inputs. A fade value of 0
+     * will output 100% crossFade.a and
+     * a value of 1 will output 100% crossFade.b.
+     */
+    readonly fade: Signal<"normalRange">;
+    protected _internalChannels: Gain<"gain">[];
+    /**
+     * @param fade The initial fade value [0, 1].
+     */
+    constructor(fade?: NormalRange);
+    constructor(options?: Partial<CrossFadeOptions>);
+    static getDefaults(): CrossFadeOptions;
+    dispose(): this;
+}
+export {};

package/build/esm/component/channel/CrossFade.js

@@ -0,0 +1,106 @@
+import { Gain } from "../../core/context/Gain";
+import { connect, ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly } from "../../core/util/Interface";
+import { GainToAudio } from "../../signal/GainToAudio";
+import { Signal } from "../../signal/Signal";
+/**
+ * Tone.Crossfade provides equal power fading between two inputs.
+ * More on crossfading technique [here](https://en.wikipedia.org/wiki/Fade_(audio_engineering)#Crossfading).
+ * ```
+ *                                             +---------+
+ *                                            +> input a +>--+
+ * +-----------+   +---------------------+     |         |   |
+ * | 1s signal +>--> stereoPannerNode  L +>----> gain    |   |
+ * +-----------+   |                     |     +---------+   |
+ *               +-> pan               R +>-+                |   +--------+
+ *               | +---------------------+  |                +---> output +>
+ *  +------+     |                          |  +---------+   |   +--------+
+ *  | fade +>----+                          | +> input b +>--+
+ *  +------+                                |  |         |
+ *                                          +--> gain    |
+ *                                             +---------+
+ * ```
+ * @example
+ * const crossFade = new Tone.CrossFade().toDestination();
+ * // connect two inputs Tone.to a/b
+ * const inputA = new Tone.Oscillator(440, "square").connect(crossFade.a).start();
+ * const inputB = new Tone.Oscillator(440, "sine").connect(crossFade.b).start();
+ * // use the fade to control the mix between the two
+ * crossFade.fade.value = 0.5;
+ * @category Component
+ */
+export class CrossFade extends ToneAudioNode {
+    constructor() {
+        super(Object.assign(optionsFromArguments(CrossFade.getDefaults(), arguments, ["fade"])));
+        this.name = "CrossFade";
+        /**
+         * The crossfading is done by a StereoPannerNode
+         */
+        this._panner = this.context.createStereoPanner();
+        /**
+         * Split the output of the panner node into two values used to control the gains.
+         */
+        this._split = this.context.createChannelSplitter(2);
+        /**
+         * Convert the fade value into an audio range value so it can be connected
+         * to the panner.pan AudioParam
+         */
+        this._g2a = new GainToAudio({ context: this.context });
+        /**
+         * The input which is at full level when fade = 0
+         */
+        this.a = new Gain({
+            context: this.context,
+            gain: 0,
+        });
+        /**
+         * The input which is at full level when fade = 1
+         */
+        this.b = new Gain({
+            context: this.context,
+            gain: 0,
+        });
+        /**
+         * The output is a mix between `a` and `b` at the ratio of `fade`
+         */
+        this.output = new Gain({ context: this.context });
+        this._internalChannels = [this.a, this.b];
+        const options = optionsFromArguments(CrossFade.getDefaults(), arguments, ["fade"]);
+        this.fade = new Signal({
+            context: this.context,
+            units: "normalRange",
+            value: options.fade,
+        });
+        readOnly(this, "fade");
+        this.context.getConstant(1).connect(this._panner);
+        this._panner.connect(this._split);
+        // this is necessary for standardized-audio-context
+        // doesn't make any difference for the native AudioContext
+        // https://github.com/chrisguttandin/standardized-audio-context/issues/647
+        this._panner.channelCount = 1;
+        this._panner.channelCountMode = "explicit";
+        connect(this._split, this.a.gain, 0);
+        connect(this._split, this.b.gain, 1);
+        this.fade.chain(this._g2a, this._panner.pan);
+        this.a.connect(this.output);
+        this.b.connect(this.output);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            fade: 0.5,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.a.dispose();
+        this.b.dispose();
+        this.output.dispose();
+        this.fade.dispose();
+        this._g2a.dispose();
+        this._panner.disconnect();
+        this._split.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=CrossFade.js.map

package/build/esm/component/channel/CrossFade.js.map

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

package/build/esm/component/channel/Merge.d.ts

@@ -0,0 +1,39 @@
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Positive } from "../../core/type/Units";
+interface MergeOptions extends ToneAudioNodeOptions {
+    channels: Positive;
+}
+/**
+ * Merge brings multiple mono input channels into a single multichannel output channel.
+ *
+ * @example
+ * const merge = new Tone.Merge().toDestination();
+ * // routing a sine tone in the left channel
+ * const osc = new Tone.Oscillator().connect(merge, 0, 0).start();
+ * // and noise in the right channel
+ * const noise = new Tone.Noise().connect(merge, 0, 1).start();;
+ * @category Component
+ */
+export declare class Merge extends ToneAudioNode<MergeOptions> {
+    readonly name: string;
+    /**
+     * The merger node for the channels.
+     */
+    private _merger;
+    /**
+     * The output is the input channels combined into a single (multichannel) output
+     */
+    readonly output: ChannelMergerNode;
+    /**
+     * Multiple input connections combine into a single output.
+     */
+    readonly input: ChannelMergerNode;
+    /**
+     * @param channels The number of channels to merge.
+     */
+    constructor(channels?: Positive);
+    constructor(options?: Partial<MergeOptions>);
+    static getDefaults(): MergeOptions;
+    dispose(): this;
+}
+export {};

package/build/esm/component/channel/Merge.js

@@ -0,0 +1,32 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+/**
+ * Merge brings multiple mono input channels into a single multichannel output channel.
+ *
+ * @example
+ * const merge = new Tone.Merge().toDestination();
+ * // routing a sine tone in the left channel
+ * const osc = new Tone.Oscillator().connect(merge, 0, 0).start();
+ * // and noise in the right channel
+ * const noise = new Tone.Noise().connect(merge, 0, 1).start();;
+ * @category Component
+ */
+export class Merge extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Merge.getDefaults(), arguments, ["channels"]));
+        this.name = "Merge";
+        const options = optionsFromArguments(Merge.getDefaults(), arguments, ["channels"]);
+        this._merger = this.output = this.input = this.context.createChannelMerger(options.channels);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            channels: 2,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._merger.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=Merge.js.map

package/build/esm/component/channel/Merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Merge.js","sourceRoot":"","sources":["../../../../Tone/component/channel/Merge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAMhE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,KAAM,SAAQ,aAA2B;IAwBrD;QACC,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAvBlE,SAAI,GAAW,OAAO,CAAC;QAwB/B,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAEnF,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9F,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,QAAQ,EAAE,CAAC;SACX,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}