tone 14.8.27

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

@@ -0,0 +1,55 @@
+import { Param } from "../../core/context/Param";
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly } from "../../core/util/Interface";
+/**
+ * Panner is an equal power Left/Right Panner. It is a wrapper around the StereoPannerNode.
+ * @example
+ * return Tone.Offline(() => {
+ * // move the input signal from right to left
+ * 	const panner = new Tone.Panner(1).toDestination();
+ * 	panner.pan.rampTo(-1, 0.5);
+ * 	const osc = new Tone.Oscillator(100).connect(panner).start();
+ * }, 0.5, 2);
+ * @category Component
+ */
+export class Panner extends ToneAudioNode {
+    constructor() {
+        super(Object.assign(optionsFromArguments(Panner.getDefaults(), arguments, ["pan"])));
+        this.name = "Panner";
+        /**
+         * the panner node
+         */
+        this._panner = this.context.createStereoPanner();
+        this.input = this._panner;
+        this.output = this._panner;
+        const options = optionsFromArguments(Panner.getDefaults(), arguments, ["pan"]);
+        this.pan = new Param({
+            context: this.context,
+            param: this._panner.pan,
+            value: options.pan,
+            minValue: -1,
+            maxValue: 1,
+        });
+        // 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 = options.channelCount;
+        this._panner.channelCountMode = "explicit";
+        // initial value
+        readOnly(this, "pan");
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            pan: 0,
+            channelCount: 1,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._panner.disconnect();
+        this.pan.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Panner.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Panner.js","sourceRoot":"","sources":["../../../../Tone/component/channel/Panner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACjD,OAAO,EAAE,aAAa,EAAwB,MAAM,kCAAkC,CAAC;AAEvF,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAOrD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,MAAO,SAAQ,aAAgC;IA+B3D;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QA9B7E,SAAI,GAAW,QAAQ,CAAC;QAEjC;;WAEG;QACK,YAAO,GAAqB,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAC7D,UAAK,GAAqB,IAAI,CAAC,OAAO,CAAC;QACvC,WAAM,GAAqB,IAAI,CAAC,OAAO,CAAC;QAwBhD,MAAM,OAAO,GAAG,oBAAoB,CAAC,MAAM,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;QAE/E,IAAI,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC;YACpB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YACvB,KAAK,EAAE,OAAO,CAAC,GAAG;YAClB,QAAQ,EAAE,CAAC,CAAC;YACZ,QAAQ,EAAE,CAAC;SACX,CAAC,CAAC;QAEH,mDAAmD;QACnD,0DAA0D;QAC1D,0EAA0E;QAC1E,IAAI,CAAC,OAAO,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;QACjD,IAAI,CAAC,OAAO,CAAC,gBAAgB,GAAG,UAAU,CAAC;QAE3C,gBAAgB;QAChB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,EAAE;YACjD,GAAG,EAAE,CAAC;YACN,YAAY,EAAE,CAAC;SACf,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

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

@@ -0,0 +1,98 @@
+import { Param } from "../../core/context/Param";
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Degrees, GainFactor } from "../../core/type/Units";
+import "../../core/context/Listener";
+export interface Panner3DOptions extends ToneAudioNodeOptions {
+    coneInnerAngle: Degrees;
+    coneOuterAngle: Degrees;
+    coneOuterGain: GainFactor;
+    distanceModel: DistanceModelType;
+    maxDistance: number;
+    orientationX: number;
+    orientationY: number;
+    orientationZ: number;
+    panningModel: PanningModelType;
+    positionX: number;
+    positionY: number;
+    positionZ: number;
+    refDistance: number;
+    rolloffFactor: number;
+}
+/**
+ * A spatialized panner node which supports equalpower or HRTF panning.
+ * @category Component
+ */
+export declare class Panner3D extends ToneAudioNode<Panner3DOptions> {
+    readonly name: string;
+    /**
+     * The panning object
+     */
+    private _panner;
+    readonly input: PannerNode;
+    readonly output: PannerNode;
+    readonly positionX: Param<"number">;
+    readonly positionY: Param<"number">;
+    readonly positionZ: Param<"number">;
+    readonly orientationX: Param<"number">;
+    readonly orientationY: Param<"number">;
+    readonly orientationZ: Param<"number">;
+    /**
+     * @param positionX The initial x position.
+     * @param positionY The initial y position.
+     * @param positionZ The initial z position.
+     */
+    constructor(positionX: number, positionY: number, positionZ: number);
+    constructor(options?: Partial<Panner3DOptions>);
+    static getDefaults(): Panner3DOptions;
+    /**
+     * Sets the position of the source in 3d space.
+     */
+    setPosition(x: number, y: number, z: number): this;
+    /**
+     * Sets the orientation of the source in 3d space.
+     */
+    setOrientation(x: number, y: number, z: number): this;
+    /**
+     * The panning model. Either "equalpower" or "HRTF".
+     */
+    get panningModel(): PanningModelType;
+    set panningModel(val: PanningModelType);
+    /**
+     * A reference distance for reducing volume as source move further from the listener
+     */
+    get refDistance(): number;
+    set refDistance(val: number);
+    /**
+     * Describes how quickly the volume is reduced as source moves away from listener.
+     */
+    get rolloffFactor(): number;
+    set rolloffFactor(val: number);
+    /**
+     * The distance model used by,  "linear", "inverse", or "exponential".
+     */
+    get distanceModel(): DistanceModelType;
+    set distanceModel(val: DistanceModelType);
+    /**
+     * The angle, in degrees, inside of which there will be no volume reduction
+     */
+    get coneInnerAngle(): Degrees;
+    set coneInnerAngle(val: Degrees);
+    /**
+     * The angle, in degrees, outside of which the volume will be reduced
+     * to a constant value of coneOuterGain
+     */
+    get coneOuterAngle(): Degrees;
+    set coneOuterAngle(val: Degrees);
+    /**
+     * The gain outside of the coneOuterAngle
+     */
+    get coneOuterGain(): GainFactor;
+    set coneOuterGain(val: GainFactor);
+    /**
+     * The maximum distance between source and listener,
+     * after which the volume will not be reduced any further.
+     */
+    get maxDistance(): number;
+    set maxDistance(val: number);
+    dispose(): this;
+}

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

@@ -0,0 +1,177 @@
+import { Param } from "../../core/context/Param";
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import "../../core/context/Listener";
+/**
+ * A spatialized panner node which supports equalpower or HRTF panning.
+ * @category Component
+ */
+export class Panner3D extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Panner3D.getDefaults(), arguments, ["positionX", "positionY", "positionZ"]));
+        this.name = "Panner3D";
+        const options = optionsFromArguments(Panner3D.getDefaults(), arguments, ["positionX", "positionY", "positionZ"]);
+        this._panner = this.input = this.output = this.context.createPanner();
+        // set some values
+        this.panningModel = options.panningModel;
+        this.maxDistance = options.maxDistance;
+        this.distanceModel = options.distanceModel;
+        this.coneOuterGain = options.coneOuterGain;
+        this.coneOuterAngle = options.coneOuterAngle;
+        this.coneInnerAngle = options.coneInnerAngle;
+        this.refDistance = options.refDistance;
+        this.rolloffFactor = options.rolloffFactor;
+        this.positionX = new Param({
+            context: this.context,
+            param: this._panner.positionX,
+            value: options.positionX,
+        });
+        this.positionY = new Param({
+            context: this.context,
+            param: this._panner.positionY,
+            value: options.positionY,
+        });
+        this.positionZ = new Param({
+            context: this.context,
+            param: this._panner.positionZ,
+            value: options.positionZ,
+        });
+        this.orientationX = new Param({
+            context: this.context,
+            param: this._panner.orientationX,
+            value: options.orientationX,
+        });
+        this.orientationY = new Param({
+            context: this.context,
+            param: this._panner.orientationY,
+            value: options.orientationY,
+        });
+        this.orientationZ = new Param({
+            context: this.context,
+            param: this._panner.orientationZ,
+            value: options.orientationZ,
+        });
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            coneInnerAngle: 360,
+            coneOuterAngle: 360,
+            coneOuterGain: 0,
+            distanceModel: "inverse",
+            maxDistance: 10000,
+            orientationX: 0,
+            orientationY: 0,
+            orientationZ: 0,
+            panningModel: "equalpower",
+            positionX: 0,
+            positionY: 0,
+            positionZ: 0,
+            refDistance: 1,
+            rolloffFactor: 1,
+        });
+    }
+    /**
+     * Sets the position of the source in 3d space.
+     */
+    setPosition(x, y, z) {
+        this.positionX.value = x;
+        this.positionY.value = y;
+        this.positionZ.value = z;
+        return this;
+    }
+    /**
+     * Sets the orientation of the source in 3d space.
+     */
+    setOrientation(x, y, z) {
+        this.orientationX.value = x;
+        this.orientationY.value = y;
+        this.orientationZ.value = z;
+        return this;
+    }
+    /**
+     * The panning model. Either "equalpower" or "HRTF".
+     */
+    get panningModel() {
+        return this._panner.panningModel;
+    }
+    set panningModel(val) {
+        this._panner.panningModel = val;
+    }
+    /**
+     * A reference distance for reducing volume as source move further from the listener
+     */
+    get refDistance() {
+        return this._panner.refDistance;
+    }
+    set refDistance(val) {
+        this._panner.refDistance = val;
+    }
+    /**
+     * Describes how quickly the volume is reduced as source moves away from listener.
+     */
+    get rolloffFactor() {
+        return this._panner.rolloffFactor;
+    }
+    set rolloffFactor(val) {
+        this._panner.rolloffFactor = val;
+    }
+    /**
+     * The distance model used by,  "linear", "inverse", or "exponential".
+     */
+    get distanceModel() {
+        return this._panner.distanceModel;
+    }
+    set distanceModel(val) {
+        this._panner.distanceModel = val;
+    }
+    /**
+     * The angle, in degrees, inside of which there will be no volume reduction
+     */
+    get coneInnerAngle() {
+        return this._panner.coneInnerAngle;
+    }
+    set coneInnerAngle(val) {
+        this._panner.coneInnerAngle = val;
+    }
+    /**
+     * The angle, in degrees, outside of which the volume will be reduced
+     * to a constant value of coneOuterGain
+     */
+    get coneOuterAngle() {
+        return this._panner.coneOuterAngle;
+    }
+    set coneOuterAngle(val) {
+        this._panner.coneOuterAngle = val;
+    }
+    /**
+     * The gain outside of the coneOuterAngle
+     */
+    get coneOuterGain() {
+        return this._panner.coneOuterGain;
+    }
+    set coneOuterGain(val) {
+        this._panner.coneOuterGain = val;
+    }
+    /**
+     * The maximum distance between source and listener,
+     * after which the volume will not be reduced any further.
+     */
+    get maxDistance() {
+        return this._panner.maxDistance;
+    }
+    set maxDistance(val) {
+        this._panner.maxDistance = val;
+    }
+    dispose() {
+        super.dispose();
+        this._panner.disconnect();
+        this.orientationX.dispose();
+        this.orientationY.dispose();
+        this.orientationZ.dispose();
+        this.positionX.dispose();
+        this.positionY.dispose();
+        this.positionZ.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Panner3D.js.map

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

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

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

@@ -0,0 +1,77 @@
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+import { Gain } from "../../core/context/Gain";
+import { PlaybackState } from "../../core/util/StateTimeline";
+export interface RecorderOptions extends ToneAudioNodeOptions {
+    mimeType?: string;
+}
+/**
+ * A wrapper around the MediaRecorder API. Unlike the rest of Tone.js, this module does not offer
+ * any sample-accurate scheduling because it is not a feature of the MediaRecorder API.
+ * This is only natively supported in Chrome and Firefox.
+ * For a cross-browser shim, install (audio-recorder-polyfill)[https://www.npmjs.com/package/audio-recorder-polyfill].
+ * @example
+ * const recorder = new Tone.Recorder();
+ * const synth = new Tone.Synth().connect(recorder);
+ * // start recording
+ * recorder.start();
+ * // generate a few notes
+ * synth.triggerAttackRelease("C3", 0.5);
+ * synth.triggerAttackRelease("C4", 0.5, "+1");
+ * synth.triggerAttackRelease("C5", 0.5, "+2");
+ * // wait for the notes to end and stop the recording
+ * setTimeout(async () => {
+ * 	// the recorded audio is returned as a blob
+ * 	const recording = await recorder.stop();
+ * 	// download the recording by creating an anchor element and blob url
+ * 	const url = URL.createObjectURL(recording);
+ * 	const anchor = document.createElement("a");
+ * 	anchor.download = "recording.webm";
+ * 	anchor.href = url;
+ * 	anchor.click();
+ * }, 4000);
+ * @category Component
+ */
+export declare class Recorder extends ToneAudioNode<RecorderOptions> {
+    readonly name = "Recorder";
+    /**
+     * Recorder uses the Media Recorder API
+     */
+    private _recorder;
+    /**
+     * MediaRecorder requires
+     */
+    private _stream;
+    readonly input: Gain;
+    readonly output: undefined;
+    constructor(options?: Partial<RecorderOptions>);
+    static getDefaults(): RecorderOptions;
+    /**
+     * The mime type is the format that the audio is encoded in. For Chrome
+     * that is typically webm encoded as "vorbis".
+     */
+    get mimeType(): string;
+    /**
+     * Test if your platform supports the Media Recorder API. If it's not available,
+     * try installing this (polyfill)[https://www.npmjs.com/package/audio-recorder-polyfill].
+     */
+    static get supported(): boolean;
+    /**
+     * Get the playback state of the Recorder, either "started", "stopped" or "paused"
+     */
+    get state(): PlaybackState;
+    /**
+     * Start the Recorder. Returns a promise which resolves
+     * when the recorder has started.
+     */
+    start(): Promise<unknown>;
+    /**
+     * Stop the recorder. Returns a promise with the recorded content until this point
+     * encoded as [[mimeType]]
+     */
+    stop(): Promise<Blob>;
+    /**
+     * Pause the recorder
+     */
+    pause(): this;
+    dispose(): this;
+}

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

@@ -0,0 +1,131 @@
+import { __awaiter } from "tslib";
+import { ToneAudioNode } from "../../core/context/ToneAudioNode";
+import { Gain } from "../../core/context/Gain";
+import { assert } from "../../core/util/Debug";
+import { theWindow } from "../../core/context/AudioContext";
+import { optionsFromArguments } from "../../core/util/Defaults";
+/**
+ * A wrapper around the MediaRecorder API. Unlike the rest of Tone.js, this module does not offer
+ * any sample-accurate scheduling because it is not a feature of the MediaRecorder API.
+ * This is only natively supported in Chrome and Firefox.
+ * For a cross-browser shim, install (audio-recorder-polyfill)[https://www.npmjs.com/package/audio-recorder-polyfill].
+ * @example
+ * const recorder = new Tone.Recorder();
+ * const synth = new Tone.Synth().connect(recorder);
+ * // start recording
+ * recorder.start();
+ * // generate a few notes
+ * synth.triggerAttackRelease("C3", 0.5);
+ * synth.triggerAttackRelease("C4", 0.5, "+1");
+ * synth.triggerAttackRelease("C5", 0.5, "+2");
+ * // wait for the notes to end and stop the recording
+ * setTimeout(async () => {
+ * 	// the recorded audio is returned as a blob
+ * 	const recording = await recorder.stop();
+ * 	// download the recording by creating an anchor element and blob url
+ * 	const url = URL.createObjectURL(recording);
+ * 	const anchor = document.createElement("a");
+ * 	anchor.download = "recording.webm";
+ * 	anchor.href = url;
+ * 	anchor.click();
+ * }, 4000);
+ * @category Component
+ */
+export class Recorder extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Recorder.getDefaults(), arguments));
+        this.name = "Recorder";
+        const options = optionsFromArguments(Recorder.getDefaults(), arguments);
+        this.input = new Gain({
+            context: this.context
+        });
+        assert(Recorder.supported, "Media Recorder API is not available");
+        this._stream = this.context.createMediaStreamDestination();
+        this.input.connect(this._stream);
+        this._recorder = new MediaRecorder(this._stream.stream, {
+            mimeType: options.mimeType
+        });
+    }
+    static getDefaults() {
+        return ToneAudioNode.getDefaults();
+    }
+    /**
+     * The mime type is the format that the audio is encoded in. For Chrome
+     * that is typically webm encoded as "vorbis".
+     */
+    get mimeType() {
+        return this._recorder.mimeType;
+    }
+    /**
+     * Test if your platform supports the Media Recorder API. If it's not available,
+     * try installing this (polyfill)[https://www.npmjs.com/package/audio-recorder-polyfill].
+     */
+    static get supported() {
+        return theWindow !== null && Reflect.has(theWindow, "MediaRecorder");
+    }
+    /**
+     * Get the playback state of the Recorder, either "started", "stopped" or "paused"
+     */
+    get state() {
+        if (this._recorder.state === "inactive") {
+            return "stopped";
+        }
+        else if (this._recorder.state === "paused") {
+            return "paused";
+        }
+        else {
+            return "started";
+        }
+    }
+    /**
+     * Start the Recorder. Returns a promise which resolves
+     * when the recorder has started.
+     */
+    start() {
+        return __awaiter(this, void 0, void 0, function* () {
+            assert(this.state !== "started", "Recorder is already started");
+            const startPromise = new Promise(done => {
+                const handleStart = () => {
+                    this._recorder.removeEventListener("start", handleStart, false);
+                    done();
+                };
+                this._recorder.addEventListener("start", handleStart, false);
+            });
+            this._recorder.start();
+            return yield startPromise;
+        });
+    }
+    /**
+     * Stop the recorder. Returns a promise with the recorded content until this point
+     * encoded as [[mimeType]]
+     */
+    stop() {
+        return __awaiter(this, void 0, void 0, function* () {
+            assert(this.state !== "stopped", "Recorder is not started");
+            const dataPromise = new Promise(done => {
+                const handleData = (e) => {
+                    this._recorder.removeEventListener("dataavailable", handleData, false);
+                    done(e.data);
+                };
+                this._recorder.addEventListener("dataavailable", handleData, false);
+            });
+            this._recorder.stop();
+            return yield dataPromise;
+        });
+    }
+    /**
+     * Pause the recorder
+     */
+    pause() {
+        assert(this.state === "started", "Recorder must be started");
+        this._recorder.pause();
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this.input.dispose();
+        this._stream.disconnect();
+        return this;
+    }
+}
+//# sourceMappingURL=Recorder.js.map

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

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

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

@@ -0,0 +1,68 @@
+import { Gain } from "../../core/context/Gain";
+import { ToneAudioNode, ToneAudioNodeOptions } from "../../core/context/ToneAudioNode";
+export interface SoloOptions extends ToneAudioNodeOptions {
+    solo: boolean;
+}
+/**
+ * Solo lets you isolate a specific audio stream. When an instance is set to `solo=true`,
+ * it will mute all other instances of Solo.
+ * @example
+ * const soloA = new Tone.Solo().toDestination();
+ * const oscA = new Tone.Oscillator("C4", "sawtooth").connect(soloA);
+ * const soloB = new Tone.Solo().toDestination();
+ * const oscB = new Tone.Oscillator("E4", "square").connect(soloB);
+ * soloA.solo = true;
+ * // no audio will pass through soloB
+ * @category Component
+ */
+export declare class Solo extends ToneAudioNode<SoloOptions> {
+    readonly name: string;
+    readonly input: Gain;
+    readonly output: Gain;
+    /**
+     * @param solo If the connection should be initially solo'ed.
+     */
+    constructor(solo?: boolean);
+    constructor(options?: Partial<SoloOptions>);
+    static getDefaults(): SoloOptions;
+    /**
+     * Hold all of the solo'ed tracks belonging to a specific context
+     */
+    private static _allSolos;
+    /**
+     * Hold the currently solo'ed instance(s)
+     */
+    private static _soloed;
+    /**
+     * Isolates this instance and mutes all other instances of Solo.
+     * Only one instance can be soloed at a time. A soloed
+     * instance will report `solo=false` when another instance is soloed.
+     */
+    get solo(): boolean;
+    set solo(solo: boolean);
+    /**
+     * If the current instance is muted, i.e. another instance is soloed
+     */
+    get muted(): boolean;
+    /**
+     * Add this to the soloed array
+     */
+    private _addSolo;
+    /**
+     * Remove this from the soloed array
+     */
+    private _removeSolo;
+    /**
+     * Is this on the soloed array
+     */
+    private _isSoloed;
+    /**
+     * Returns true if no one is soloed
+     */
+    private _noSolos;
+    /**
+     * Solo the current instance and unsolo all other instances.
+     */
+    private _updateSolo;
+    dispose(): this;
+}