tone 14.8.27

package/build/esm/core/context/Destination.d.ts

@@ -0,0 +1,73 @@
+import { Volume } from "../../component/channel/Volume";
+import { Decibels } from "../type/Units";
+import { Gain } from "./Gain";
+import { Param } from "./Param";
+import { ToneAudioNode, ToneAudioNodeOptions } from "./ToneAudioNode";
+interface DestinationOptions extends ToneAudioNodeOptions {
+    volume: Decibels;
+    mute: boolean;
+}
+/**
+ * A single master output which is connected to the
+ * AudioDestinationNode (aka your speakers).
+ * It provides useful conveniences such as the ability
+ * to set the volume and mute the entire application.
+ * It also gives you the ability to apply master effects to your application.
+ *
+ * @example
+ * const oscillator = new Tone.Oscillator().start();
+ * // the audio will go from the oscillator to the speakers
+ * oscillator.connect(Tone.getDestination());
+ * // a convenience for connecting to the master output is also provided:
+ * oscillator.toDestination();
+ * @category Core
+ */
+export declare class Destination extends ToneAudioNode<DestinationOptions> {
+    readonly name: string;
+    input: Volume;
+    output: Gain;
+    /**
+     * The volume of the master output in decibels. -Infinity is silent, and 0 is no change.
+     * @example
+     * const osc = new Tone.Oscillator().toDestination();
+     * osc.start();
+     * // ramp the volume down to silent over 10 seconds
+     * Tone.getDestination().volume.rampTo(-Infinity, 10);
+     */
+    volume: Param<"decibels">;
+    constructor(options: Partial<DestinationOptions>);
+    static getDefaults(): DestinationOptions;
+    /**
+     * Mute the output.
+     * @example
+     * const oscillator = new Tone.Oscillator().start().toDestination();
+     * setTimeout(() => {
+     * 	// mute the output
+     * 	Tone.Destination.mute = true;
+     * }, 1000);
+     */
+    get mute(): boolean;
+    set mute(mute: boolean);
+    /**
+     * Add a master effects chain. NOTE: this will disconnect any nodes which were previously
+     * chained in the master effects chain.
+     * @param args All arguments will be connected in a row and the Master will be routed through it.
+     * @example
+     * // route all audio through a filter and compressor
+     * const lowpass = new Tone.Filter(800, "lowpass");
+     * const compressor = new Tone.Compressor(-18);
+     * Tone.Destination.chain(lowpass, compressor);
+     */
+    chain(...args: Array<AudioNode | ToneAudioNode>): this;
+    /**
+     * The maximum number of channels the system can output
+     * @example
+     * console.log(Tone.Destination.maxChannelCount);
+     */
+    get maxChannelCount(): number;
+    /**
+     * Clean up
+     */
+    dispose(): this;
+}
+export {};

package/build/esm/core/context/Destination.js

@@ -0,0 +1,105 @@
+import { Volume } from "../../component/channel/Volume";
+import { optionsFromArguments } from "../util/Defaults";
+import { onContextClose, onContextInit } from "./ContextInitialization";
+import { Gain } from "./Gain";
+import { connectSeries, ToneAudioNode } from "./ToneAudioNode";
+/**
+ * A single master output which is connected to the
+ * AudioDestinationNode (aka your speakers).
+ * It provides useful conveniences such as the ability
+ * to set the volume and mute the entire application.
+ * It also gives you the ability to apply master effects to your application.
+ *
+ * @example
+ * const oscillator = new Tone.Oscillator().start();
+ * // the audio will go from the oscillator to the speakers
+ * oscillator.connect(Tone.getDestination());
+ * // a convenience for connecting to the master output is also provided:
+ * oscillator.toDestination();
+ * @category Core
+ */
+export class Destination extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Destination.getDefaults(), arguments));
+        this.name = "Destination";
+        this.input = new Volume({ context: this.context });
+        this.output = new Gain({ context: this.context });
+        /**
+         * The volume of the master output in decibels. -Infinity is silent, and 0 is no change.
+         * @example
+         * const osc = new Tone.Oscillator().toDestination();
+         * osc.start();
+         * // ramp the volume down to silent over 10 seconds
+         * Tone.getDestination().volume.rampTo(-Infinity, 10);
+         */
+        this.volume = this.input.volume;
+        const options = optionsFromArguments(Destination.getDefaults(), arguments);
+        connectSeries(this.input, this.output, this.context.rawContext.destination);
+        this.mute = options.mute;
+        this._internalChannels = [this.input, this.context.rawContext.destination, this.output];
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            mute: false,
+            volume: 0,
+        });
+    }
+    /**
+     * Mute the output.
+     * @example
+     * const oscillator = new Tone.Oscillator().start().toDestination();
+     * setTimeout(() => {
+     * 	// mute the output
+     * 	Tone.Destination.mute = true;
+     * }, 1000);
+     */
+    get mute() {
+        return this.input.mute;
+    }
+    set mute(mute) {
+        this.input.mute = mute;
+    }
+    /**
+     * Add a master effects chain. NOTE: this will disconnect any nodes which were previously
+     * chained in the master effects chain.
+     * @param args All arguments will be connected in a row and the Master will be routed through it.
+     * @example
+     * // route all audio through a filter and compressor
+     * const lowpass = new Tone.Filter(800, "lowpass");
+     * const compressor = new Tone.Compressor(-18);
+     * Tone.Destination.chain(lowpass, compressor);
+     */
+    chain(...args) {
+        this.input.disconnect();
+        args.unshift(this.input);
+        args.push(this.output);
+        connectSeries(...args);
+        return this;
+    }
+    /**
+     * The maximum number of channels the system can output
+     * @example
+     * console.log(Tone.Destination.maxChannelCount);
+     */
+    get maxChannelCount() {
+        return this.context.rawContext.destination.maxChannelCount;
+    }
+    /**
+     * Clean up
+     */
+    dispose() {
+        super.dispose();
+        this.volume.dispose();
+        return this;
+    }
+}
+//-------------------------------------
+// 	INITIALIZATION
+//-------------------------------------
+onContextInit(context => {
+    context.destination = new Destination({ context });
+});
+onContextClose(context => {
+    context.destination.dispose();
+});
+//# sourceMappingURL=Destination.js.map

package/build/esm/core/context/Destination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Destination.js","sourceRoot":"","sources":["../../../../Tone/core/context/Destination.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAC;AAExD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,EAAE,aAAa,EAAE,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAOrF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,WAAY,SAAQ,aAAiC;IAkBjE;QAEC,KAAK,CAAC,oBAAoB,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QAlB1D,SAAI,GAAW,aAAa,CAAC;QAEtC,UAAK,GAAW,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QACtD,WAAM,GAAS,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;QAEnD;;;;;;;WAOG;QACH,WAAM,GAAsB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QAM7C,MAAM,OAAO,GAAG,oBAAoB,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;QAE3E,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAE5E,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,iBAAiB,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,CAAC;SACT,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,IAAI;QACP,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACxB,CAAC;IACD,IAAI,IAAI,CAAC,IAAa;QACrB,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;IACxB,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,GAAG,IAAsC;QAC9C,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACvB,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;;OAIG;IACH,IAAI,eAAe;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,eAAe,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC;IACb,CAAC;CACD;AAED,uCAAuC;AACvC,kBAAkB;AAClB,uCAAuC;AAEvC,aAAa,CAAC,OAAO,CAAC,EAAE;IACvB,OAAO,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC,CAAC,CAAC;AAEH,cAAc,CAAC,OAAO,CAAC,EAAE;IACxB,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;AAC/B,CAAC,CAAC,CAAC"}

package/build/esm/core/context/DummyContext.d.ts

@@ -0,0 +1,54 @@
+import { BaseContext } from "./BaseContext";
+import { Seconds } from "../type/Units";
+import { AnyAudioContext } from "./AudioContext";
+declare type Draw = import("../util/Draw").Draw;
+declare type Destination = import("./Destination").Destination;
+declare type Transport = import("../clock/Transport").Transport;
+declare type Listener = import("./Listener").Listener;
+export declare class DummyContext extends BaseContext {
+    createAnalyser(): AnalyserNode;
+    createOscillator(): OscillatorNode;
+    createBufferSource(): AudioBufferSourceNode;
+    createBiquadFilter(): BiquadFilterNode;
+    createBuffer(_numberOfChannels: number, _length: number, _sampleRate: number): AudioBuffer;
+    createChannelMerger(_numberOfInputs?: number | undefined): ChannelMergerNode;
+    createChannelSplitter(_numberOfOutputs?: number | undefined): ChannelSplitterNode;
+    createConstantSource(): ConstantSourceNode;
+    createConvolver(): ConvolverNode;
+    createDelay(_maxDelayTime?: number | undefined): DelayNode;
+    createDynamicsCompressor(): DynamicsCompressorNode;
+    createGain(): GainNode;
+    createIIRFilter(_feedForward: number[] | Float32Array, _feedback: number[] | Float32Array): IIRFilterNode;
+    createPanner(): PannerNode;
+    createPeriodicWave(_real: number[] | Float32Array, _imag: number[] | Float32Array, _constraints?: PeriodicWaveConstraints | undefined): PeriodicWave;
+    createStereoPanner(): StereoPannerNode;
+    createWaveShaper(): WaveShaperNode;
+    createMediaStreamSource(_stream: MediaStream): MediaStreamAudioSourceNode;
+    createMediaElementSource(_element: HTMLMediaElement): MediaElementAudioSourceNode;
+    createMediaStreamDestination(): MediaStreamAudioDestinationNode;
+    decodeAudioData(_audioData: ArrayBuffer): Promise<AudioBuffer>;
+    createAudioWorkletNode(_name: string, _options?: Partial<AudioWorkletNodeOptions>): AudioWorkletNode;
+    get rawContext(): AnyAudioContext;
+    addAudioWorkletModule(_url: string, _name: string): Promise<void>;
+    lookAhead: number;
+    latencyHint: number;
+    resume(): Promise<void>;
+    setTimeout(_fn: (...args: any[]) => void, _timeout: Seconds): number;
+    clearTimeout(_id: number): this;
+    setInterval(_fn: (...args: any[]) => void, _interval: Seconds): number;
+    clearInterval(_id: number): this;
+    getConstant(_val: number): AudioBufferSourceNode;
+    get currentTime(): Seconds;
+    get state(): AudioContextState;
+    get sampleRate(): number;
+    get listener(): Listener;
+    get transport(): Transport;
+    get draw(): Draw;
+    set draw(_d: Draw);
+    get destination(): Destination;
+    set destination(_d: Destination);
+    now(): number;
+    immediate(): number;
+    readonly isOffline: boolean;
+}
+export {};

package/build/esm/core/context/DummyContext.js

@@ -0,0 +1,138 @@
+import { __awaiter } from "tslib";
+import { BaseContext } from "./BaseContext";
+export class DummyContext extends BaseContext {
+    constructor() {
+        super(...arguments);
+        this.lookAhead = 0;
+        this.latencyHint = 0;
+        this.isOffline = false;
+    }
+    //---------------------------
+    // BASE AUDIO CONTEXT METHODS
+    //---------------------------
+    createAnalyser() {
+        return {};
+    }
+    createOscillator() {
+        return {};
+    }
+    createBufferSource() {
+        return {};
+    }
+    createBiquadFilter() {
+        return {};
+    }
+    createBuffer(_numberOfChannels, _length, _sampleRate) {
+        return {};
+    }
+    createChannelMerger(_numberOfInputs) {
+        return {};
+    }
+    createChannelSplitter(_numberOfOutputs) {
+        return {};
+    }
+    createConstantSource() {
+        return {};
+    }
+    createConvolver() {
+        return {};
+    }
+    createDelay(_maxDelayTime) {
+        return {};
+    }
+    createDynamicsCompressor() {
+        return {};
+    }
+    createGain() {
+        return {};
+    }
+    createIIRFilter(_feedForward, _feedback) {
+        return {};
+    }
+    createPanner() {
+        return {};
+    }
+    createPeriodicWave(_real, _imag, _constraints) {
+        return {};
+    }
+    createStereoPanner() {
+        return {};
+    }
+    createWaveShaper() {
+        return {};
+    }
+    createMediaStreamSource(_stream) {
+        return {};
+    }
+    createMediaElementSource(_element) {
+        return {};
+    }
+    createMediaStreamDestination() {
+        return {};
+    }
+    decodeAudioData(_audioData) {
+        return Promise.resolve({});
+    }
+    //---------------------------
+    // TONE AUDIO CONTEXT METHODS
+    //---------------------------
+    createAudioWorkletNode(_name, _options) {
+        return {};
+    }
+    get rawContext() {
+        return {};
+    }
+    addAudioWorkletModule(_url, _name) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return Promise.resolve();
+        });
+    }
+    resume() {
+        return Promise.resolve();
+    }
+    setTimeout(_fn, _timeout) {
+        return 0;
+    }
+    clearTimeout(_id) {
+        return this;
+    }
+    setInterval(_fn, _interval) {
+        return 0;
+    }
+    clearInterval(_id) {
+        return this;
+    }
+    getConstant(_val) {
+        return {};
+    }
+    get currentTime() {
+        return 0;
+    }
+    get state() {
+        return {};
+    }
+    get sampleRate() {
+        return 0;
+    }
+    get listener() {
+        return {};
+    }
+    get transport() {
+        return {};
+    }
+    get draw() {
+        return {};
+    }
+    set draw(_d) { }
+    get destination() {
+        return {};
+    }
+    set destination(_d) { }
+    now() {
+        return 0;
+    }
+    immediate() {
+        return 0;
+    }
+}
+//# sourceMappingURL=DummyContext.js.map

package/build/esm/core/context/DummyContext.js.map

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

package/build/esm/core/context/Gain.d.ts

@@ -0,0 +1,53 @@
+import { Param } from "../context/Param";
+import { UnitMap, UnitName } from "../type/Units";
+import { ToneAudioNode, ToneAudioNodeOptions } from "./ToneAudioNode";
+interface GainOptions<TypeName extends UnitName> extends ToneAudioNodeOptions {
+    gain: UnitMap[TypeName];
+    units: TypeName;
+    convert: boolean;
+    minValue?: number;
+    maxValue?: number;
+}
+/**
+ * A thin wrapper around the Native Web Audio GainNode.
+ * The GainNode is a basic building block of the Web Audio
+ * API and is useful for routing audio and adjusting gains.
+ * @category Core
+ * @example
+ * return Tone.Offline(() => {
+ * 	const gainNode = new Tone.Gain(0).toDestination();
+ * 	const osc = new Tone.Oscillator(30).connect(gainNode).start();
+ * 	gainNode.gain.rampTo(1, 0.1);
+ * 	gainNode.gain.rampTo(0, 0.4, 0.2);
+ * }, 0.7, 1);
+ */
+export declare class Gain<TypeName extends "gain" | "decibels" | "normalRange" = "gain"> extends ToneAudioNode<GainOptions<TypeName>> {
+    readonly name: string;
+    /**
+     * The gain parameter of the gain node.
+     * @example
+     * const gainNode = new Tone.Gain(0).toDestination();
+     * const osc = new Tone.Oscillator().connect(gainNode).start();
+     * gainNode.gain.rampTo(1, 0.1);
+     * gainNode.gain.rampTo(0, 2, "+0.5");
+     */
+    readonly gain: Param<TypeName>;
+    /**
+     * The wrapped GainNode.
+     */
+    private _gainNode;
+    readonly input: GainNode;
+    readonly output: GainNode;
+    /**
+     * @param  gain The initial gain of the GainNode
+     * @param units The units of the gain parameter.
+     */
+    constructor(gain?: UnitMap[TypeName], units?: TypeName);
+    constructor(options?: Partial<GainOptions<TypeName>>);
+    static getDefaults(): GainOptions<any>;
+    /**
+     * Clean up.
+     */
+    dispose(): this;
+}
+export {};

package/build/esm/core/context/Gain.js

@@ -0,0 +1,58 @@
+import { Param } from "../context/Param";
+import { optionsFromArguments } from "../util/Defaults";
+import { readOnly } from "../util/Interface";
+import { ToneAudioNode } from "./ToneAudioNode";
+/**
+ * A thin wrapper around the Native Web Audio GainNode.
+ * The GainNode is a basic building block of the Web Audio
+ * API and is useful for routing audio and adjusting gains.
+ * @category Core
+ * @example
+ * return Tone.Offline(() => {
+ * 	const gainNode = new Tone.Gain(0).toDestination();
+ * 	const osc = new Tone.Oscillator(30).connect(gainNode).start();
+ * 	gainNode.gain.rampTo(1, 0.1);
+ * 	gainNode.gain.rampTo(0, 0.4, 0.2);
+ * }, 0.7, 1);
+ */
+export class Gain extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Gain.getDefaults(), arguments, ["gain", "units"]));
+        this.name = "Gain";
+        /**
+         * The wrapped GainNode.
+         */
+        this._gainNode = this.context.createGain();
+        // input = output
+        this.input = this._gainNode;
+        this.output = this._gainNode;
+        const options = optionsFromArguments(Gain.getDefaults(), arguments, ["gain", "units"]);
+        this.gain = new Param({
+            context: this.context,
+            convert: options.convert,
+            param: this._gainNode.gain,
+            units: options.units,
+            value: options.gain,
+            minValue: options.minValue,
+            maxValue: options.maxValue,
+        });
+        readOnly(this, "gain");
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            convert: true,
+            gain: 1,
+            units: "gain",
+        });
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        this._gainNode.disconnect();
+        this.gain.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Gain.js.map

package/build/esm/core/context/Gain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Gain.js","sourceRoot":"","sources":["../../../../Tone/core/context/Gain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAEzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAUtE;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,IAAoE,SAAQ,aAAoC;IA6B5H;QACC,KAAK,CAAC,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QA5BtE,SAAI,GAAW,MAAM,CAAC;QAY/B;;WAEG;QACK,cAAS,GAAa,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAExD,iBAAiB;QACR,UAAK,GAAa,IAAI,CAAC,SAAS,CAAC;QACjC,WAAM,GAAa,IAAI,CAAC,SAAS,CAAC;QAU1C,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAEvF,IAAI,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC;YACrB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI;YAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,OAAO,CAAC,IAAI;YACnB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC1B,CAAC,CAAC;QACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,OAAO,EAAE,IAAI;YACb,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,MAAM;SACb,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/core/context/Listener.d.ts

@@ -0,0 +1,38 @@
+import { ToneAudioNode, ToneAudioNodeOptions } from "./ToneAudioNode";
+import { Param } from "./Param";
+export interface ListenerOptions extends ToneAudioNodeOptions {
+    positionX: number;
+    positionY: number;
+    positionZ: number;
+    forwardX: number;
+    forwardY: number;
+    forwardZ: number;
+    upX: number;
+    upY: number;
+    upZ: number;
+}
+/**
+ * Tone.Listener is a thin wrapper around the AudioListener. Listener combined
+ * with [[Panner3D]] makes up the Web Audio API's 3D panning system. Panner3D allows you
+ * to place sounds in 3D and Listener allows you to navigate the 3D sound environment from
+ * a first-person perspective. There is only one listener per audio context.
+ */
+export declare class Listener extends ToneAudioNode<ListenerOptions> {
+    readonly name: string;
+    /**
+     * The listener has no inputs or outputs.
+     */
+    output: undefined;
+    input: undefined;
+    readonly positionX: Param;
+    readonly positionY: Param;
+    readonly positionZ: Param;
+    readonly forwardX: Param;
+    readonly forwardY: Param;
+    readonly forwardZ: Param;
+    readonly upX: Param;
+    readonly upY: Param;
+    readonly upZ: Param;
+    static getDefaults(): ListenerOptions;
+    dispose(): this;
+}

package/build/esm/core/context/Listener.js

@@ -0,0 +1,87 @@
+import { ToneAudioNode } from "./ToneAudioNode";
+import { Param } from "./Param";
+import { onContextClose, onContextInit } from "./ContextInitialization";
+/**
+ * Tone.Listener is a thin wrapper around the AudioListener. Listener combined
+ * with [[Panner3D]] makes up the Web Audio API's 3D panning system. Panner3D allows you
+ * to place sounds in 3D and Listener allows you to navigate the 3D sound environment from
+ * a first-person perspective. There is only one listener per audio context.
+ */
+export class Listener extends ToneAudioNode {
+    constructor() {
+        super(...arguments);
+        this.name = "Listener";
+        this.positionX = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.positionX,
+        });
+        this.positionY = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.positionY,
+        });
+        this.positionZ = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.positionZ,
+        });
+        this.forwardX = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.forwardX,
+        });
+        this.forwardY = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.forwardY,
+        });
+        this.forwardZ = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.forwardZ,
+        });
+        this.upX = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.upX,
+        });
+        this.upY = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.upY,
+        });
+        this.upZ = new Param({
+            context: this.context,
+            param: this.context.rawContext.listener.upZ,
+        });
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            positionX: 0,
+            positionY: 0,
+            positionZ: 0,
+            forwardX: 0,
+            forwardY: 0,
+            forwardZ: -1,
+            upX: 0,
+            upY: 1,
+            upZ: 0,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.positionX.dispose();
+        this.positionY.dispose();
+        this.positionZ.dispose();
+        this.forwardX.dispose();
+        this.forwardY.dispose();
+        this.forwardZ.dispose();
+        this.upX.dispose();
+        this.upY.dispose();
+        this.upZ.dispose();
+        return this;
+    }
+}
+//-------------------------------------
+// 	INITIALIZATION
+//-------------------------------------
+onContextInit(context => {
+    context.listener = new Listener({ context });
+});
+onContextClose(context => {
+    context.listener.dispose();
+});
+//# sourceMappingURL=Listener.js.map

package/build/esm/core/context/Listener.js.map

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

package/build/esm/core/context/Offline.d.ts

@@ -0,0 +1,37 @@
+import { Seconds } from "../type/Units";
+import { OfflineContext } from "./OfflineContext";
+import { ToneAudioBuffer } from "./ToneAudioBuffer";
+/**
+ * Generate a buffer by rendering all of the Tone.js code within the callback using the OfflineAudioContext.
+ * The OfflineAudioContext is capable of rendering much faster than real time in many cases.
+ * The callback function also passes in an offline instance of [[Context]] which can be used
+ * to schedule events along the Transport.
+ * @param  callback  All Tone.js nodes which are created and scheduled within this callback are recorded into the output Buffer.
+ * @param  duration     the amount of time to record for.
+ * @return  The promise which is invoked with the ToneAudioBuffer of the recorded output.
+ * @example
+ * // render 2 seconds of the oscillator
+ * Tone.Offline(() => {
+ * 	// only nodes created in this callback will be recorded
+ * 	const oscillator = new Tone.Oscillator().toDestination().start(0);
+ * }, 2).then((buffer) => {
+ * 	// do something with the output buffer
+ * 	console.log(buffer);
+ * });
+ * @example
+ * // can also schedule events along the Transport
+ * // using the passed in Offline Transport
+ * Tone.Offline(({ transport }) => {
+ * 	const osc = new Tone.Oscillator().toDestination();
+ * 	transport.schedule(time => {
+ * 		osc.start(time).stop(time + 0.1);
+ * 	}, 1);
+ * 	// make sure to start the transport
+ * 	transport.start(0.2);
+ * }, 4).then((buffer) => {
+ * 	// do something with the output buffer
+ * 	console.log(buffer);
+ * });
+ * @category Core
+ */
+export declare function Offline(callback: (context: OfflineContext) => Promise<void> | void, duration: Seconds, channels?: number, sampleRate?: number): Promise<ToneAudioBuffer>;