tone 14.8.27

package/build/esm/component/dynamics/Limiter.d.ts

@@ -0,0 +1,39 @@
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Decibels } from "../../core/type/Units";
+import { Param } from "../../core/context/Param";
+export interface LimiterOptions extends ToneAudioNodeOptions {
+    threshold: Decibels;
+}
+/**
+ * Limiter will limit the loudness of an incoming signal.
+ * Under the hood it's composed of a [[Compressor]] with a fast attack
+ * and release and max compression ratio.
+ *
+ * @example
+ * const limiter = new Tone.Limiter(-20).toDestination();
+ * const oscillator = new Tone.Oscillator().connect(limiter);
+ * oscillator.start();
+ * @category Component
+ */
+export declare class Limiter extends ToneAudioNode<LimiterOptions> {
+    readonly name: string;
+    readonly input: InputNode;
+    readonly output: OutputNode;
+    /**
+     * The compressor which does the limiting
+     */
+    private _compressor;
+    readonly threshold: Param<"decibels">;
+    /**
+     * @param threshold The threshold above which the gain reduction is applied.
+     */
+    constructor(threshold?: Decibels);
+    constructor(options?: Partial<LimiterOptions>);
+    static getDefaults(): LimiterOptions;
+    /**
+     * A read-only decibel value for metering purposes, representing the current amount of gain
+     * reduction that the compressor is applying to the signal.
+     */
+    get reduction(): Decibels;
+    dispose(): this;
+}

package/build/esm/component/dynamics/Limiter.js

@@ -0,0 +1,51 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Compressor } from "./Compressor";
+import { readOnly } from "../../core/util/Interface";
+;
+/**
+ * Limiter will limit the loudness of an incoming signal.
+ * Under the hood it's composed of a [[Compressor]] with a fast attack
+ * and release and max compression ratio.
+ *
+ * @example
+ * const limiter = new Tone.Limiter(-20).toDestination();
+ * const oscillator = new Tone.Oscillator().connect(limiter);
+ * oscillator.start();
+ * @category Component
+ */
+export class Limiter extends ToneAudioNode {
+    constructor() {
+        super(Object.assign(optionsFromArguments(Limiter.getDefaults(), arguments, ["threshold"])));
+        this.name = "Limiter";
+        const options = optionsFromArguments(Limiter.getDefaults(), arguments, ["threshold"]);
+        this._compressor = this.input = this.output = new Compressor({
+            context: this.context,
+            ratio: 20,
+            attack: 0.003,
+            release: 0.01,
+            threshold: options.threshold
+        });
+        this.threshold = this._compressor.threshold;
+        readOnly(this, "threshold");
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            threshold: -12
+        });
+    }
+    /**
+     * A read-only decibel value for metering purposes, representing the current amount of gain
+     * reduction that the compressor is applying to the signal.
+     */
+    get reduction() {
+        return this._compressor.reduction;
+    }
+    dispose() {
+        super.dispose();
+        this._compressor.dispose();
+        this.threshold.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Limiter.js.map

package/build/esm/component/dynamics/Limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Limiter.js","sourceRoot":"","sources":["../../../../Tone/component/dynamics/Limiter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAE9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAIpD,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,OAAO,OAAQ,SAAQ,aAA6B;IAmBzD;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAlBpF,SAAI,GAAW,SAAS,CAAC;QAmBjC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAEtF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC;YAC5D,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,KAAK;YACb,OAAO,EAAE,IAAI;YACb,SAAS,EAAE,OAAO,CAAC,SAAS;SAC5B,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;QAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,SAAS,EAAE,CAAC,EAAE;SACd,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QAC3B,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/component/dynamics/MidSideCompressor.d.ts

@@ -0,0 +1,36 @@
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Compressor, CompressorOptions } from "./Compressor";
+import { RecursivePartial } from "../../core/util/Interface";
+export interface MidSideCompressorOptions extends ToneAudioNodeOptions {
+    mid: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
+    side: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
+}
+/**
+ * MidSideCompressor applies two different compressors to the [[mid]]
+ * and [[side]] signal components of the input. See [[MidSideSplit]] and [[MidSideMerge]].
+ * @category Component
+ */
+export declare class MidSideCompressor extends ToneAudioNode<MidSideCompressorOptions> {
+    readonly name: string;
+    readonly input: InputNode;
+    readonly output: OutputNode;
+    /**
+     * Split the incoming signal into Mid/Side
+     */
+    private _midSideSplit;
+    /**
+     * Merge the compressed signal back into a single stream
+     */
+    private _midSideMerge;
+    /**
+     * The compression applied to the mid signal
+     */
+    readonly mid: Compressor;
+    /**
+     * The compression applied to the side signal
+     */
+    readonly side: Compressor;
+    constructor(options?: RecursivePartial<MidSideCompressorOptions>);
+    static getDefaults(): MidSideCompressorOptions;
+    dispose(): this;
+}

package/build/esm/component/dynamics/MidSideCompressor.js

@@ -0,0 +1,52 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { Compressor } from "./Compressor";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { MidSideSplit } from "../channel/MidSideSplit";
+import { MidSideMerge } from "../channel/MidSideMerge";
+import { readOnly } from "../../core/util/Interface";
+/**
+ * MidSideCompressor applies two different compressors to the [[mid]]
+ * and [[side]] signal components of the input. See [[MidSideSplit]] and [[MidSideMerge]].
+ * @category Component
+ */
+export class MidSideCompressor extends ToneAudioNode {
+    constructor() {
+        super(Object.assign(optionsFromArguments(MidSideCompressor.getDefaults(), arguments)));
+        this.name = "MidSideCompressor";
+        const options = optionsFromArguments(MidSideCompressor.getDefaults(), arguments);
+        this._midSideSplit = this.input = new MidSideSplit({ context: this.context });
+        this._midSideMerge = this.output = new MidSideMerge({ context: this.context });
+        this.mid = new Compressor(Object.assign(options.mid, { context: this.context }));
+        this.side = new Compressor(Object.assign(options.side, { context: this.context }));
+        this._midSideSplit.mid.chain(this.mid, this._midSideMerge.mid);
+        this._midSideSplit.side.chain(this.side, this._midSideMerge.side);
+        readOnly(this, ["mid", "side"]);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            mid: {
+                ratio: 3,
+                threshold: -24,
+                release: 0.03,
+                attack: 0.02,
+                knee: 16
+            },
+            side: {
+                ratio: 6,
+                threshold: -30,
+                release: 0.25,
+                attack: 0.03,
+                knee: 10
+            }
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.mid.dispose();
+        this.side.dispose();
+        this._midSideSplit.dispose();
+        this._midSideMerge.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=MidSideCompressor.js.map

package/build/esm/component/dynamics/MidSideCompressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MidSideCompressor.js","sourceRoot":"","sources":["../../../../Tone/component/dynamics/MidSideCompressor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAC9G,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAoB,MAAM,2BAA2B,CAAC;AAOvE;;;;GAIG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAuC;IA4B7E;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QA3B/E,SAAI,GAAW,mBAAmB,CAAC;QA4B3C,MAAM,OAAO,GAAG,oBAAoB,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;QAEjF,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9E,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC/E,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEnF,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC/D,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAClE,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,GAAG,EAAE;gBACJ,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,CAAC,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE;aACR;YACD,IAAI,EAAE;gBACL,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,CAAC,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE;aACR;SACD,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/component/dynamics/MultibandCompressor.d.ts

@@ -0,0 +1,57 @@
+import { InputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Compressor, CompressorOptions } from "./Compressor";
+import { RecursivePartial } from "../../core/util/Interface";
+import { Frequency } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+export interface MultibandCompressorOptions extends ToneAudioNodeOptions {
+    mid: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
+    low: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
+    high: Omit<CompressorOptions, keyof ToneAudioNodeOptions>;
+    lowFrequency: Frequency;
+    highFrequency: Frequency;
+}
+/**
+ * A compressor with separate controls over low/mid/high dynamics. See [[Compressor]] and [[MultibandSplit]]
+ *
+ * @example
+ * const multiband = new Tone.MultibandCompressor({
+ * 	lowFrequency: 200,
+ * 	highFrequency: 1300,
+ * 	low: {
+ * 		threshold: -12
+ * 	}
+ * });
+ * @category Component
+ */
+export declare class MultibandCompressor extends ToneAudioNode<MultibandCompressorOptions> {
+    readonly name: string;
+    readonly input: InputNode;
+    readonly output: ToneAudioNode;
+    /**
+     * Split the incoming signal into high/mid/low
+     */
+    private _splitter;
+    /**
+     * low/mid crossover frequency.
+     */
+    readonly lowFrequency: Signal<"frequency">;
+    /**
+     * mid/high crossover frequency.
+     */
+    readonly highFrequency: Signal<"frequency">;
+    /**
+     * The compressor applied to the low frequencies
+     */
+    readonly low: Compressor;
+    /**
+     * The compressor applied to the mid frequencies
+     */
+    readonly mid: Compressor;
+    /**
+     * The compressor applied to the high frequencies
+     */
+    readonly high: Compressor;
+    constructor(options?: RecursivePartial<MultibandCompressorOptions>);
+    static getDefaults(): MultibandCompressorOptions;
+    dispose(): this;
+}

package/build/esm/component/dynamics/MultibandCompressor.js

@@ -0,0 +1,79 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { Compressor } from "./Compressor";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly } from "../../core/util/Interface";
+import { MultibandSplit } from "../channel/MultibandSplit";
+import { Gain } from "../../core/context/Gain";
+/**
+ * A compressor with separate controls over low/mid/high dynamics. See [[Compressor]] and [[MultibandSplit]]
+ *
+ * @example
+ * const multiband = new Tone.MultibandCompressor({
+ * 	lowFrequency: 200,
+ * 	highFrequency: 1300,
+ * 	low: {
+ * 		threshold: -12
+ * 	}
+ * });
+ * @category Component
+ */
+export class MultibandCompressor extends ToneAudioNode {
+    constructor() {
+        super(Object.assign(optionsFromArguments(MultibandCompressor.getDefaults(), arguments)));
+        this.name = "MultibandCompressor";
+        const options = optionsFromArguments(MultibandCompressor.getDefaults(), arguments);
+        this._splitter = this.input = new MultibandSplit({
+            context: this.context,
+            lowFrequency: options.lowFrequency,
+            highFrequency: options.highFrequency
+        });
+        this.lowFrequency = this._splitter.lowFrequency;
+        this.highFrequency = this._splitter.highFrequency;
+        this.output = new Gain({ context: this.context });
+        this.low = new Compressor(Object.assign(options.low, { context: this.context }));
+        this.mid = new Compressor(Object.assign(options.mid, { context: this.context }));
+        this.high = new Compressor(Object.assign(options.high, { context: this.context }));
+        // connect the compressor
+        this._splitter.low.chain(this.low, this.output);
+        this._splitter.mid.chain(this.mid, this.output);
+        this._splitter.high.chain(this.high, this.output);
+        readOnly(this, ["high", "mid", "low", "highFrequency", "lowFrequency"]);
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            lowFrequency: 250,
+            highFrequency: 2000,
+            low: {
+                ratio: 6,
+                threshold: -30,
+                release: 0.25,
+                attack: 0.03,
+                knee: 10
+            },
+            mid: {
+                ratio: 3,
+                threshold: -24,
+                release: 0.03,
+                attack: 0.02,
+                knee: 16
+            },
+            high: {
+                ratio: 3,
+                threshold: -24,
+                release: 0.03,
+                attack: 0.02,
+                knee: 16
+            },
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._splitter.dispose();
+        this.low.dispose();
+        this.mid.dispose();
+        this.high.dispose();
+        this.output.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=MultibandCompressor.js.map

package/build/esm/component/dynamics/MultibandCompressor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultibandCompressor.js","sourceRoot":"","sources":["../../../../Tone/component/dynamics/MultibandCompressor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,UAAU,EAAqB,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAoB,MAAM,2BAA2B,CAAC;AAEvE,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAU/C;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAoB,SAAQ,aAAyC;IAsCjF;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QArCjF,SAAI,GAAW,qBAAqB,CAAC;QAsC7C,MAAM,OAAO,GAAG,oBAAoB,CAAC,mBAAmB,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;QAEnF,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,cAAc,CAAC;YAChD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,aAAa,EAAE,OAAO,CAAC,aAAa;SACpC,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;QAChD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC;QAClD,IAAI,CAAC,MAAM,GAAG,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACjF,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAEnF,yBAAyB;QACzB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAElD,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,cAAc,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,YAAY,EAAE,GAAG;YACjB,aAAa,EAAE,IAAI;YACnB,GAAG,EAAE;gBACJ,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,CAAC,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE;aACR;YACD,GAAG,EAAE;gBACJ,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,CAAC,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE;aACR;YACD,IAAI,EAAE;gBACL,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,CAAC,EAAE;gBACd,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI;gBACZ,IAAI,EAAE,EAAE;aACR;SACD,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/component/envelope/AmplitudeEnvelope.d.ts

@@ -0,0 +1,46 @@
+import { Gain } from "../../core/context/Gain";
+import { NormalRange, Time } from "../../core/type/Units";
+import { Envelope, EnvelopeOptions } from "./Envelope";
+/**
+ * AmplitudeEnvelope is a Tone.Envelope connected to a gain node.
+ * Unlike Tone.Envelope, which outputs the envelope's value, AmplitudeEnvelope accepts
+ * an audio signal as the input and will apply the envelope to the amplitude
+ * of the signal.
+ * Read more about ADSR Envelopes on [Wikipedia](https://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope).
+ *
+ * @example
+ * return Tone.Offline(() => {
+ * 	const ampEnv = new Tone.AmplitudeEnvelope({
+ * 		attack: 0.1,
+ * 		decay: 0.2,
+ * 		sustain: 1.0,
+ * 		release: 0.8
+ * 	}).toDestination();
+ * 	// create an oscillator and connect it
+ * 	const osc = new Tone.Oscillator().connect(ampEnv).start();
+ * 	// trigger the envelopes attack and release "8t" apart
+ * 	ampEnv.triggerAttackRelease("8t");
+ * }, 1.5, 1);
+ * @category Component
+ */
+export declare class AmplitudeEnvelope extends Envelope {
+    readonly name: string;
+    private _gainNode;
+    output: Gain;
+    input: Gain;
+    /**
+     * @param attack The amount of time it takes for the envelope to go from 0 to it's maximum value.
+     * @param decay	The period of time after the attack that it takes for the envelope
+     *                      	to fall to the sustain value. Value must be greater than 0.
+     * @param sustain	The percent of the maximum value that the envelope rests at until
+     *                               	the release is triggered.
+     * @param release	The amount of time after the release is triggered it takes to reach 0.
+     *                        	Value must be greater than 0.
+     */
+    constructor(attack?: Time, decay?: Time, sustain?: NormalRange, release?: Time);
+    constructor(options?: Partial<EnvelopeOptions>);
+    /**
+     * Clean up
+     */
+    dispose(): this;
+}

package/build/esm/component/envelope/AmplitudeEnvelope.js

@@ -0,0 +1,49 @@
+import { Gain } from "../../core/context/Gain";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Envelope } from "./Envelope";
+/**
+ * AmplitudeEnvelope is a Tone.Envelope connected to a gain node.
+ * Unlike Tone.Envelope, which outputs the envelope's value, AmplitudeEnvelope accepts
+ * an audio signal as the input and will apply the envelope to the amplitude
+ * of the signal.
+ * Read more about ADSR Envelopes on [Wikipedia](https://en.wikipedia.org/wiki/Synthesizer#ADSR_envelope).
+ *
+ * @example
+ * return Tone.Offline(() => {
+ * 	const ampEnv = new Tone.AmplitudeEnvelope({
+ * 		attack: 0.1,
+ * 		decay: 0.2,
+ * 		sustain: 1.0,
+ * 		release: 0.8
+ * 	}).toDestination();
+ * 	// create an oscillator and connect it
+ * 	const osc = new Tone.Oscillator().connect(ampEnv).start();
+ * 	// trigger the envelopes attack and release "8t" apart
+ * 	ampEnv.triggerAttackRelease("8t");
+ * }, 1.5, 1);
+ * @category Component
+ */
+export class AmplitudeEnvelope extends Envelope {
+    constructor() {
+        super(optionsFromArguments(AmplitudeEnvelope.getDefaults(), arguments, ["attack", "decay", "sustain", "release"]));
+        this.name = "AmplitudeEnvelope";
+        this._gainNode = new Gain({
+            context: this.context,
+            gain: 0,
+        });
+        this.output = this._gainNode;
+        this.input = this._gainNode;
+        this._sig.connect(this._gainNode.gain);
+        this.output = this._gainNode;
+        this.input = this._gainNode;
+    }
+    /**
+     * Clean up
+     */
+    dispose() {
+        super.dispose();
+        this._gainNode.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=AmplitudeEnvelope.js.map

package/build/esm/component/envelope/AmplitudeEnvelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AmplitudeEnvelope.js","sourceRoot":"","sources":["../../../../Tone/component/envelope/AmplitudeEnvelope.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAE/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAmB,MAAM,YAAY,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAsB9C;QACC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;QArB3G,SAAI,GAAW,mBAAmB,CAAC;QAEpC,cAAS,GAAS,IAAI,IAAI,CAAC;YAClC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,CAAC;SACP,CAAC,CAAC;QACH,WAAM,GAAS,IAAI,CAAC,SAAS,CAAC;QAC9B,UAAK,GAAS,IAAI,CAAC,SAAS,CAAC;QAe5B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACzB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}