tone 14.8.27

package/build/esm/classes.d.ts

@@ -0,0 +1,7 @@
+export * from "./core/index";
+export * from "./source/index";
+export * from "./signal/index";
+export * from "./instrument/index";
+export * from "./event/index";
+export * from "./effect/index";
+export * from "./component/index";

package/build/esm/classes.js

@@ -0,0 +1,8 @@
+export * from "./core/index";
+export * from "./source/index";
+export * from "./signal/index";
+export * from "./instrument/index";
+export * from "./event/index";
+export * from "./effect/index";
+export * from "./component/index";
+//# sourceMappingURL=classes.js.map

package/build/esm/classes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classes.js","sourceRoot":"","sources":["../../Tone/classes.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,77 @@
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { NormalRange, PowerOfTwo } from "../../core/type/Units";
+export declare type AnalyserType = "fft" | "waveform";
+export interface AnalyserOptions extends ToneAudioNodeOptions {
+    size: PowerOfTwo;
+    type: AnalyserType;
+    smoothing: NormalRange;
+    channels: number;
+}
+/**
+ * Wrapper around the native Web Audio's [AnalyserNode](http://webaudio.github.io/web-audio-api/#idl-def-AnalyserNode).
+ * Extracts FFT or Waveform data from the incoming signal.
+ * @category Component
+ */
+export declare class Analyser extends ToneAudioNode<AnalyserOptions> {
+    readonly name: string;
+    readonly input: InputNode;
+    readonly output: OutputNode;
+    /**
+     * The analyser node.
+     */
+    private _analysers;
+    /**
+     * Input and output are a gain node
+     */
+    private _gain;
+    /**
+     * The channel splitter node
+     */
+    private _split;
+    /**
+     * The analysis type
+     */
+    private _type;
+    /**
+     * The buffer that the FFT data is written to
+     */
+    private _buffers;
+    /**
+     * @param type The return type of the analysis, either "fft", or "waveform".
+     * @param size The size of the FFT. This must be a power of two in the range 16 to 16384.
+     */
+    constructor(type?: AnalyserType, size?: number);
+    constructor(options?: Partial<AnalyserOptions>);
+    static getDefaults(): AnalyserOptions;
+    /**
+     * Run the analysis given the current settings. If [[channels]] = 1,
+     * it will return a Float32Array. If [[channels]] > 1, it will
+     * return an array of Float32Arrays where each index in the array
+     * represents the analysis done on a channel.
+     */
+    getValue(): Float32Array | Float32Array[];
+    /**
+     * The size of analysis. This must be a power of two in the range 16 to 16384.
+     */
+    get size(): PowerOfTwo;
+    set size(size: PowerOfTwo);
+    /**
+     * The number of channels the analyser does the analysis on. Channel
+     * separation is done using [[Split]]
+     */
+    get channels(): number;
+    /**
+     * The analysis function returned by analyser.getValue(), either "fft" or "waveform".
+     */
+    get type(): AnalyserType;
+    set type(type: AnalyserType);
+    /**
+     * 0 represents no time averaging with the last analysis frame.
+     */
+    get smoothing(): NormalRange;
+    set smoothing(val: NormalRange);
+    /**
+     * Clean up.
+     */
+    dispose(): this;
+}

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

@@ -0,0 +1,121 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { Split } from "../channel/Split";
+import { Gain } from "../../core/context/Gain";
+import { assert, assertRange } from "../../core/util/Debug";
+/**
+ * Wrapper around the native Web Audio's [AnalyserNode](http://webaudio.github.io/web-audio-api/#idl-def-AnalyserNode).
+ * Extracts FFT or Waveform data from the incoming signal.
+ * @category Component
+ */
+export class Analyser extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Analyser.getDefaults(), arguments, ["type", "size"]));
+        this.name = "Analyser";
+        /**
+         * The analyser node.
+         */
+        this._analysers = [];
+        /**
+         * The buffer that the FFT data is written to
+         */
+        this._buffers = [];
+        const options = optionsFromArguments(Analyser.getDefaults(), arguments, ["type", "size"]);
+        this.input = this.output = this._gain = new Gain({ context: this.context });
+        this._split = new Split({
+            context: this.context,
+            channels: options.channels,
+        });
+        this.input.connect(this._split);
+        assertRange(options.channels, 1);
+        // create the analysers
+        for (let channel = 0; channel < options.channels; channel++) {
+            this._analysers[channel] = this.context.createAnalyser();
+            this._split.connect(this._analysers[channel], channel, 0);
+        }
+        // set the values initially
+        this.size = options.size;
+        this.type = options.type;
+        this.smoothing = options.smoothing;
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            size: 1024,
+            smoothing: 0.8,
+            type: "fft",
+            channels: 1,
+        });
+    }
+    /**
+     * Run the analysis given the current settings. If [[channels]] = 1,
+     * it will return a Float32Array. If [[channels]] > 1, it will
+     * return an array of Float32Arrays where each index in the array
+     * represents the analysis done on a channel.
+     */
+    getValue() {
+        this._analysers.forEach((analyser, index) => {
+            const buffer = this._buffers[index];
+            if (this._type === "fft") {
+                analyser.getFloatFrequencyData(buffer);
+            }
+            else if (this._type === "waveform") {
+                analyser.getFloatTimeDomainData(buffer);
+            }
+        });
+        if (this.channels === 1) {
+            return this._buffers[0];
+        }
+        else {
+            return this._buffers;
+        }
+    }
+    /**
+     * The size of analysis. This must be a power of two in the range 16 to 16384.
+     */
+    get size() {
+        return this._analysers[0].frequencyBinCount;
+    }
+    set size(size) {
+        this._analysers.forEach((analyser, index) => {
+            analyser.fftSize = size * 2;
+            this._buffers[index] = new Float32Array(size);
+        });
+    }
+    /**
+     * The number of channels the analyser does the analysis on. Channel
+     * separation is done using [[Split]]
+     */
+    get channels() {
+        return this._analysers.length;
+    }
+    /**
+     * The analysis function returned by analyser.getValue(), either "fft" or "waveform".
+     */
+    get type() {
+        return this._type;
+    }
+    set type(type) {
+        assert(type === "waveform" || type === "fft", `Analyser: invalid type: ${type}`);
+        this._type = type;
+    }
+    /**
+     * 0 represents no time averaging with the last analysis frame.
+     */
+    get smoothing() {
+        return this._analysers[0].smoothingTimeConstant;
+    }
+    set smoothing(val) {
+        this._analysers.forEach(a => a.smoothingTimeConstant = val);
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        this._analysers.forEach(a => a.disconnect());
+        this._split.dispose();
+        this._gain.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Analyser.js.map

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

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

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

@@ -0,0 +1,23 @@
+import { MeterBase, MeterBaseOptions } from "./MeterBase";
+export declare type DCMeterOptions = MeterBaseOptions;
+/**
+ * DCMeter gets the raw value of the input signal at the current time.
+ *
+ * @example
+ * const meter = new Tone.DCMeter();
+ * const mic = new Tone.UserMedia();
+ * mic.open();
+ * // connect mic to the meter
+ * mic.connect(meter);
+ * // the current level of the mic
+ * const level = meter.getValue();
+ * @category Component
+ */
+export declare class DCMeter extends MeterBase<DCMeterOptions> {
+    readonly name: string;
+    constructor(options?: Partial<DCMeterOptions>);
+    /**
+     * Get the signal value of the incoming signal
+     */
+    getValue(): number;
+}

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

@@ -0,0 +1,31 @@
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { MeterBase } from "./MeterBase";
+/**
+ * DCMeter gets the raw value of the input signal at the current time.
+ *
+ * @example
+ * const meter = new Tone.DCMeter();
+ * const mic = new Tone.UserMedia();
+ * mic.open();
+ * // connect mic to the meter
+ * mic.connect(meter);
+ * // the current level of the mic
+ * const level = meter.getValue();
+ * @category Component
+ */
+export class DCMeter extends MeterBase {
+    constructor() {
+        super(optionsFromArguments(DCMeter.getDefaults(), arguments));
+        this.name = "DCMeter";
+        this._analyser.type = "waveform";
+        this._analyser.size = 256;
+    }
+    /**
+     * Get the signal value of the incoming signal
+     */
+    getValue() {
+        const value = this._analyser.getValue();
+        return value[0];
+    }
+}
+//# sourceMappingURL=DCMeter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"DCMeter.js","sourceRoot":"","sources":["../../../../Tone/component/analysis/DCMeter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAI1D;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,OAAQ,SAAQ,SAAyB;IAKrD;QACC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QAJtD,SAAI,GAAW,SAAS,CAAC;QAMjC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,UAAU,CAAC;QACjC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,GAAG,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,QAAQ;QACP,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAkB,CAAC;QACxD,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;CACD"}

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

@@ -0,0 +1,50 @@
+import { Hertz, NormalRange, PowerOfTwo } from "../../core/type/Units";
+import { MeterBase, MeterBaseOptions } from "./MeterBase";
+export interface FFTOptions extends MeterBaseOptions {
+    size: PowerOfTwo;
+    smoothing: NormalRange;
+    normalRange: boolean;
+}
+/**
+ * Get the current frequency data of the connected audio source using a fast Fourier transform.
+ * @category Component
+ */
+export declare class FFT extends MeterBase<FFTOptions> {
+    readonly name: string;
+    /**
+     * If the output should be in decibels or normal range between 0-1. If `normalRange` is false,
+     * the output range will be the measured decibel value, otherwise the decibel value will be converted to
+     * the range of 0-1
+     */
+    normalRange: boolean;
+    /**
+     * @param size The size of the FFT. Value must be a power of two in the range 16 to 16384.
+     */
+    constructor(size?: PowerOfTwo);
+    constructor(options?: Partial<FFTOptions>);
+    static getDefaults(): FFTOptions;
+    /**
+     * Gets the current frequency data from the connected audio source.
+     * Returns the frequency data of length [[size]] as a Float32Array of decibel values.
+     */
+    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]] (i.e. the number of
+     * frequency bins). Large FFT sizes may be costly to compute.
+     */
+    get size(): PowerOfTwo;
+    set size(size: PowerOfTwo);
+    /**
+     * 0 represents no time averaging with the last analysis frame.
+     */
+    get smoothing(): NormalRange;
+    set smoothing(val: NormalRange);
+    /**
+     * Returns the frequency value in hertz of each of the indices of the FFT's [[getValue]] response.
+     * @example
+     * const fft = new Tone.FFT(32);
+     * console.log([0, 1, 2, 3, 4].map(index => fft.getFrequencyOfIndex(index)));
+     */
+    getFrequencyOfIndex(index: number): Hertz;
+}

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

@@ -0,0 +1,65 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { dbToGain } from "../../core/type/Conversions";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { MeterBase } from "./MeterBase";
+import { assert } from "../../core/util/Debug";
+/**
+ * Get the current frequency data of the connected audio source using a fast Fourier transform.
+ * @category Component
+ */
+export class FFT extends MeterBase {
+    constructor() {
+        super(optionsFromArguments(FFT.getDefaults(), arguments, ["size"]));
+        this.name = "FFT";
+        const options = optionsFromArguments(FFT.getDefaults(), arguments, ["size"]);
+        this.normalRange = options.normalRange;
+        this._analyser.type = "fft";
+        this.size = options.size;
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            normalRange: false,
+            size: 1024,
+            smoothing: 0.8,
+        });
+    }
+    /**
+     * Gets the current frequency data from the connected audio source.
+     * Returns the frequency data of length [[size]] as a Float32Array of decibel values.
+     */
+    getValue() {
+        const values = this._analyser.getValue();
+        return values.map(v => this.normalRange ? dbToGain(v) : v);
+    }
+    /**
+     * 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]] (i.e. the number of
+     * frequency bins). Large FFT sizes may be costly to compute.
+     */
+    get size() {
+        return this._analyser.size;
+    }
+    set size(size) {
+        this._analyser.size = size;
+    }
+    /**
+     * 0 represents no time averaging with the last analysis frame.
+     */
+    get smoothing() {
+        return this._analyser.smoothing;
+    }
+    set smoothing(val) {
+        this._analyser.smoothing = val;
+    }
+    /**
+     * Returns the frequency value in hertz of each of the indices of the FFT's [[getValue]] response.
+     * @example
+     * const fft = new Tone.FFT(32);
+     * console.log([0, 1, 2, 3, 4].map(index => fft.getFrequencyOfIndex(index)));
+     */
+    getFrequencyOfIndex(index) {
+        assert(0 <= index && index < this.size, `index must be greater than or equal to 0 and less than ${this.size}`);
+        return index * this.context.sampleRate / (this.size * 2);
+    }
+}
+//# sourceMappingURL=FFT.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"FFT.js","sourceRoot":"","sources":["../../../../Tone/component/analysis/FFT.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAQ/C;;;GAGG;AACH,MAAM,OAAO,GAAI,SAAQ,SAAqB;IAgB7C;QACC,KAAK,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAf5D,SAAI,GAAW,KAAK,CAAC;QAgB7B,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAE7E,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,SAAS,CAAC,IAAI,GAAG,KAAK,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,WAAW,EAAE,KAAK;YAClB,IAAI,EAAE,IAAI;YACV,SAAS,EAAE,GAAG;SACd,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACH,QAAQ;QACP,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAkB,CAAC;QACzD,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;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;IAED;;OAEG;IACH,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;IACjC,CAAC;IACD,IAAI,SAAS,CAAC,GAAG;QAChB,IAAI,CAAC,SAAS,CAAC,SAAS,GAAG,GAAG,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,KAAa;QAChC,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,0DAA0D,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAC/G,OAAO,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,GAAG,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC;IAC1D,CAAC;CACD"}

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

@@ -0,0 +1,44 @@
+import { Time } from "../../core/type/Units";
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+export interface FollowerOptions extends ToneAudioNodeOptions {
+    smoothing: Time;
+}
+/**
+ * Follower is a simple envelope follower.
+ * It's implemented by applying a lowpass filter to the absolute value of the incoming signal.
+ * ```
+ *          +-----+    +---------------+
+ * Input +--> Abs +----> OnePoleFilter +--> Output
+ *          +-----+    +---------------+
+ * ```
+ * @category Component
+ */
+export declare class Follower extends ToneAudioNode<FollowerOptions> {
+    readonly name: string;
+    readonly input: InputNode;
+    readonly output: OutputNode;
+    /**
+     * Private reference to the smoothing parameter
+     */
+    private _smoothing;
+    /**
+     * The lowpass filter
+     */
+    private _lowpass;
+    /**
+     * The absolute value
+     */
+    private _abs;
+    /**
+     * @param smoothing The rate of change of the follower.
+     */
+    constructor(smoothing?: Time);
+    constructor(options?: Partial<FollowerOptions>);
+    static getDefaults(): FollowerOptions;
+    /**
+     * The amount of time it takes a value change to arrive at the updated value.
+     */
+    get smoothing(): Time;
+    set smoothing(smoothing: Time);
+    dispose(): this;
+}

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

@@ -0,0 +1,51 @@
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { OnePoleFilter } from "../filter/OnePoleFilter";
+import { Abs } from "../../signal/Abs";
+/**
+ * Follower is a simple envelope follower.
+ * It's implemented by applying a lowpass filter to the absolute value of the incoming signal.
+ * ```
+ *          +-----+    +---------------+
+ * Input +--> Abs +----> OnePoleFilter +--> Output
+ *          +-----+    +---------------+
+ * ```
+ * @category Component
+ */
+export class Follower extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Follower.getDefaults(), arguments, ["smoothing"]));
+        this.name = "Follower";
+        const options = optionsFromArguments(Follower.getDefaults(), arguments, ["smoothing"]);
+        this._abs = this.input = new Abs({ context: this.context });
+        this._lowpass = this.output = new OnePoleFilter({
+            context: this.context,
+            frequency: 1 / this.toSeconds(options.smoothing),
+            type: "lowpass"
+        });
+        this._abs.connect(this._lowpass);
+        this._smoothing = options.smoothing;
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            smoothing: 0.05
+        });
+    }
+    /**
+     * The amount of time it takes a value change to arrive at the updated value.
+     */
+    get smoothing() {
+        return this._smoothing;
+    }
+    set smoothing(smoothing) {
+        this._smoothing = smoothing;
+        this._lowpass.frequency = 1 / this.toSeconds(this.smoothing);
+    }
+    dispose() {
+        super.dispose();
+        this._abs.dispose();
+        this._lowpass.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Follower.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Follower.js","sourceRoot":"","sources":["../../../../Tone/component/analysis/Follower.ts"],"names":[],"mappings":"AACA,OAAO,EAAyB,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAC9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAMvC;;;;;;;;;GASG;AACH,MAAM,OAAO,QAAS,SAAQ,aAA8B;IA2B3D;QACC,KAAK,CAAC,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QA1BtE,SAAI,GAAW,UAAU,CAAC;QA2BlC,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,GAAG,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC;YAC/C,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC;YAChD,IAAI,EAAE,SAAS;SACf,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,SAAS,EAAE,IAAI;SACf,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACZ,OAAO,IAAI,CAAC,UAAU,CAAC;IACxB,CAAC;IACD,IAAI,SAAS,CAAC,SAAS;QACtB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,QAAQ,CAAC,SAAS,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACxB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

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

@@ -0,0 +1,62 @@
+import { NormalRange } from "../../core/type/Units";
+import { MeterBase, MeterBaseOptions } from "./MeterBase";
+export interface MeterOptions extends MeterBaseOptions {
+    smoothing: NormalRange;
+    normalRange: boolean;
+    channels: number;
+}
+/**
+ * Meter gets the [RMS](https://en.wikipedia.org/wiki/Root_mean_square)
+ * of an input signal. It can also get the raw value of the input signal.
+ *
+ * @example
+ * const meter = new Tone.Meter();
+ * const mic = new Tone.UserMedia();
+ * mic.open();
+ * // connect mic to the meter
+ * mic.connect(meter);
+ * // the current level of the mic
+ * setInterval(() => console.log(meter.getValue()), 100);
+ * @category Component
+ */
+export declare class Meter extends MeterBase<MeterOptions> {
+    readonly name: string;
+    /**
+     * If the output should be in decibels or normal range between 0-1. If `normalRange` is false,
+     * the output range will be the measured decibel value, otherwise the decibel value will be converted to
+     * the range of 0-1
+     */
+    normalRange: boolean;
+    /**
+     * A value from between 0 and 1 where 0 represents no time averaging with the last analysis frame.
+     */
+    smoothing: number;
+    /**
+     * The previous frame's value
+     */
+    private _rms;
+    /**
+     * @param smoothing The amount of smoothing applied between frames.
+     */
+    constructor(smoothing?: NormalRange);
+    constructor(options?: Partial<MeterOptions>);
+    static getDefaults(): MeterOptions;
+    /**
+     * Use [[getValue]] instead. For the previous getValue behavior, use DCMeter.
+     * @deprecated
+     */
+    getLevel(): number | number[];
+    /**
+     * Get the current value of the incoming signal.
+     * Output is in decibels when [[normalRange]] is `false`.
+     * If [[channels]] = 1, then the output is a single number
+     * representing the value of the input signal. When [[channels]] > 1,
+     * then each channel is returned as a value in a number array.
+     */
+    getValue(): number | number[];
+    /**
+     * The number of channels of analysis.
+     */
+    get channels(): number;
+    dispose(): this;
+}

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

@@ -0,0 +1,90 @@
+import { gainToDb } from "../../core/type/Conversions";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { MeterBase } from "./MeterBase";
+import { warn } from "../../core/util/Debug";
+import { Analyser } from "./Analyser";
+/**
+ * Meter gets the [RMS](https://en.wikipedia.org/wiki/Root_mean_square)
+ * of an input signal. It can also get the raw value of the input signal.
+ *
+ * @example
+ * const meter = new Tone.Meter();
+ * const mic = new Tone.UserMedia();
+ * mic.open();
+ * // connect mic to the meter
+ * mic.connect(meter);
+ * // the current level of the mic
+ * setInterval(() => console.log(meter.getValue()), 100);
+ * @category Component
+ */
+export class Meter extends MeterBase {
+    constructor() {
+        super(optionsFromArguments(Meter.getDefaults(), arguments, ["smoothing"]));
+        this.name = "Meter";
+        /**
+         * The previous frame's value
+         */
+        this._rms = 0;
+        const options = optionsFromArguments(Meter.getDefaults(), arguments, ["smoothing"]);
+        this.input = this.output = this._analyser = new Analyser({
+            context: this.context,
+            size: 256,
+            type: "waveform",
+            channels: options.channels,
+        });
+        this.smoothing = options.smoothing,
+            this.normalRange = options.normalRange;
+    }
+    static getDefaults() {
+        return Object.assign(MeterBase.getDefaults(), {
+            smoothing: 0.8,
+            normalRange: false,
+            channels: 1,
+        });
+    }
+    /**
+     * Use [[getValue]] instead. For the previous getValue behavior, use DCMeter.
+     * @deprecated
+     */
+    getLevel() {
+        warn("'getLevel' has been changed to 'getValue'");
+        return this.getValue();
+    }
+    /**
+     * Get the current value of the incoming signal.
+     * Output is in decibels when [[normalRange]] is `false`.
+     * If [[channels]] = 1, then the output is a single number
+     * representing the value of the input signal. When [[channels]] > 1,
+     * then each channel is returned as a value in a number array.
+     */
+    getValue() {
+        const aValues = this._analyser.getValue();
+        const channelValues = this.channels === 1 ? [aValues] : aValues;
+        const vals = channelValues.map(values => {
+            const totalSquared = values.reduce((total, current) => total + current * current, 0);
+            const rms = Math.sqrt(totalSquared / values.length);
+            // the rms can only fall at the rate of the smoothing
+            // but can jump up instantly
+            this._rms = Math.max(rms, this._rms * this.smoothing);
+            return this.normalRange ? this._rms : gainToDb(this._rms);
+        });
+        if (this.channels === 1) {
+            return vals[0];
+        }
+        else {
+            return vals;
+        }
+    }
+    /**
+     * The number of channels of analysis.
+     */
+    get channels() {
+        return this._analyser.channels;
+    }
+    dispose() {
+        super.dispose();
+        this._analyser.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Meter.js.map

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

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