tone 14.8.31 → 14.8.35

package/Tone/core/type/Frequency.ts

@@ -50,7 +50,7 @@ export class FrequencyClass<Type extends number = Hertz> extends TimeClass<Type,
 				},
 			},
 			note: {
-				regexp: /^([a-g]{1}(?:b|#|x|bb)?)(-?[0-9]+)/i,
+				regexp: /^([a-g]{1}(?:b|#|##|x|bb|###|#x|x#|bbb)?)(-?[0-9]+)/i,
 				method(pitch, octave): number {
 					const index = noteToScaleIndex[pitch.toLowerCase()];
 					const noteNumber = index + (parseInt(octave, 10) + 1) * 12;
@@ -219,13 +219,13 @@ export class FrequencyClass<Type extends number = Hertz> extends TimeClass<Type,
  * @hidden
  */
 const noteToScaleIndex = {
-	cbb: -2, cb: -1, c: 0, "c#": 1, cx: 2,
-	dbb: 0, db: 1, d: 2, "d#": 3, dx: 4,
-	ebb: 2, eb: 3, e: 4, "e#": 5, ex: 6,
-	fbb: 3, fb: 4, f: 5, "f#": 6, fx: 7,
-	gbb: 5, gb: 6, g: 7, "g#": 8, gx: 9,
-	abb: 7, ab: 8, a: 9, "a#": 10, ax: 11,
-	bbb: 9, bb: 10, b: 11, "b#": 12, bx: 13,
+	cbbb: -3, cbb: -2, cb: -1, c:  0, "c#":  1, cx:  2, "c##":  2, "c###":  3, "cx#":  3, "c#x":  3,
+	dbbb: -1, dbb:  0, db:  1, d:  2, "d#":  3, dx:  4, "d##":  4, "d###":  5, "dx#":  5, "d#x":  5,
+	ebbb:  1, ebb:  2, eb:  3, e:  4, "e#":  5, ex:  6, "e##":  6, "e###":  7, "ex#":  7, "e#x":  7,
+	fbbb:  2, fbb:  3, fb:  4, f:  5, "f#":  6, fx:  7, "f##":  7, "f###":  8, "fx#":  8, "f#x":  8,
+	gbbb:  4, gbb:  5, gb:  6, g:  7, "g#":  8, gx:  9, "g##":  9, "g###": 10, "gx#": 10, "g#x": 10,
+	abbb:  6, abb:  7, ab:  8, a:  9, "a#": 10, ax: 11, "a##": 11, "a###": 12, "ax#": 12, "a#x": 12,
+	bbbb:  8, bbb:  9, bb: 10, b: 11, "b#": 12, bx: 13, "b##": 13, "b###": 14, "bx#": 14, "b#x": 14,
 };
 
 /**

package/Tone/effect/Chorus.test.ts

@@ -7,25 +7,29 @@ import { Oscillator } from "Tone/source";
 import { Offline } from "test/helper/Offline";
 
 describe("Chorus", () => {
-
 	BasicTests(Chorus);
 	EffectTests(Chorus);
 
 	it("matches a file", () => {
-		return CompareToFile(() => {
-			const chorus = new Chorus().toDestination().start();
-			const osc = new Oscillator(220, "sawtooth").connect(chorus).start();
-		}, "chorus.wav", 0.1);
+		return CompareToFile(
+			() => {
+				const chorus = new Chorus().toDestination().start();
+				const osc = new Oscillator(220, "sawtooth")
+					.connect(chorus)
+					.start();
+			},
+			"chorus.wav",
+			0.25
+		);
 	});
 
 	context("API", () => {
-
 		it("can pass in options in the constructor", () => {
 			const chorus = new Chorus({
 				frequency: 2,
 				delayTime: 1,
 				depth: 0.4,
-				spread: 90
+				spread: 90,
 			});
 			expect(chorus.frequency.value).to.be.closeTo(2, 0.01);
 			expect(chorus.delayTime).to.be.closeTo(1, 0.01);
@@ -84,4 +88,3 @@ describe("Chorus", () => {
 		});
 	});
 });
-

package/Tone/instrument/NoiseSynth.ts

@@ -4,7 +4,10 @@ import { omitFromObject, optionsFromArguments } from "../core/util/Defaults";
 import { RecursivePartial } from "../core/util/Interface";
 import { Noise, NoiseOptions } from "../source/Noise";
 import { Instrument, InstrumentOptions } from "./Instrument";
-import { ToneAudioNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+import {
+	ToneAudioNode,
+	ToneAudioNodeOptions,
+} from "../core/context/ToneAudioNode";
 import { Envelope, EnvelopeOptions } from "../component/envelope/Envelope";
 import { Source } from "../source/Source";
 
@@ -14,7 +17,7 @@ export interface NoiseSynthOptions extends InstrumentOptions {
 }
 
 /**
- * Tone.NoiseSynth is composed of [[Noise]] through an [[AmplitudeEnvelope]]. 
+ * Tone.NoiseSynth is composed of [[Noise]] through an [[AmplitudeEnvelope]].
  * ```
  * +-------+   +-------------------+
  * | Noise +>--> AmplitudeEnvelope +>--> Output
@@ -26,7 +29,6 @@ export interface NoiseSynthOptions extends InstrumentOptions {
  * @category Instrument
  */
 export class NoiseSynth extends Instrument<NoiseSynthOptions> {
-
 	readonly name = "NoiseSynth";
 
 	/**
@@ -39,17 +41,30 @@ export class NoiseSynth extends Instrument<NoiseSynthOptions> {
 	 */
 	readonly envelope: AmplitudeEnvelope;
 
-	constructor(options?: RecursivePartial<NoiseSynthOptions>)
+	constructor(options?: RecursivePartial<NoiseSynthOptions>);
 	constructor() {
 		super(optionsFromArguments(NoiseSynth.getDefaults(), arguments));
-		const options = optionsFromArguments(NoiseSynth.getDefaults(), arguments);
-		this.noise = new Noise(Object.assign({
-			context: this.context,
-		}, options.noise));
+		const options = optionsFromArguments(
+			NoiseSynth.getDefaults(),
+			arguments
+		);
+		this.noise = new Noise(
+			Object.assign(
+				{
+					context: this.context,
+				},
+				options.noise
+			)
+		);
 
-		this.envelope = new AmplitudeEnvelope(Object.assign({
-			context: this.context,
-		}, options.envelope));
+		this.envelope = new AmplitudeEnvelope(
+			Object.assign(
+				{
+					context: this.context,
+				},
+				options.envelope
+			)
+		);
 
 		// connect the noise to the output
 		this.noise.chain(this.envelope, this.output);
@@ -58,17 +73,23 @@ export class NoiseSynth extends Instrument<NoiseSynthOptions> {
 	static getDefaults(): NoiseSynthOptions {
 		return Object.assign(Instrument.getDefaults(), {
 			envelope: Object.assign(
-				omitFromObject(Envelope.getDefaults(), Object.keys(ToneAudioNode.getDefaults())),
+				omitFromObject(
+					Envelope.getDefaults(),
+					Object.keys(ToneAudioNode.getDefaults())
+				),
 				{
 					decay: 0.1,
 					sustain: 0.0,
-				},
+				}
 			),
 			noise: Object.assign(
-				omitFromObject(Noise.getDefaults(), Object.keys(Source.getDefaults())),
+				omitFromObject(
+					Noise.getDefaults(),
+					Object.keys(Source.getDefaults())
+				),
 				{
 					type: "white",
-				},
+				}
 			),
 		});
 	}
@@ -87,7 +108,11 @@ export class NoiseSynth extends Instrument<NoiseSynthOptions> {
 		// start the noise
 		this.noise.start(time);
 		if (this.envelope.sustain === 0) {
-			this.noise.stop(time + this.toSeconds(this.envelope.attack) + this.toSeconds(this.envelope.decay));
+			this.noise.stop(
+				time +
+					this.toSeconds(this.envelope.attack) +
+					this.toSeconds(this.envelope.decay)
+			);
 		}
 		return this;
 	}
@@ -110,7 +135,21 @@ export class NoiseSynth extends Instrument<NoiseSynthOptions> {
 		return this;
 	}
 
-	triggerAttackRelease(duration: Time, time?: Time, velocity: NormalRange = 1): this {
+	/**
+	 * Trigger the attack and then the release after the duration.
+	 * @param duration The amount of time to hold the note for
+	 * @param time The time the note should start
+	 * @param velocity The volume of the note (0-1)
+	 * @example
+	 * const noiseSynth = new Tone.NoiseSynth().toDestination();
+	 * // hold the note for 0.5 seconds
+	 * noiseSynth.triggerAttackRelease(0.5);
+	 */
+	triggerAttackRelease(
+		duration: Time,
+		time?: Time,
+		velocity: NormalRange = 1
+	): this {
 		time = this.toSeconds(time);
 		duration = this.toSeconds(duration);
 		this.triggerAttack(time, velocity);

package/Tone/source/Source.ts

@@ -2,11 +2,19 @@ import { Volume } from "../component/channel/Volume";
 import "../core/context/Destination";
 import "../core/clock/Transport";
 import { Param } from "../core/context/Param";
-import { OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+import {
+	OutputNode,
+	ToneAudioNode,
+	ToneAudioNodeOptions,
+} from "../core/context/ToneAudioNode";
 import { Decibels, Seconds, Time } from "../core/type/Units";
 import { defaultArg } from "../core/util/Defaults";
 import { noOp, readOnly } from "../core/util/Interface";
-import { BasicPlaybackState, StateTimeline, StateTimelineEvent } from "../core/util/StateTimeline";
+import {
+	BasicPlaybackState,
+	StateTimeline,
+	StateTimelineEvent,
+} from "../core/util/StateTimeline";
 import { isDefined, isUndef } from "../core/util/TypeCheck";
 import { assert, assertContextRunning } from "../core/util/Debug";
 import { GT } from "../core/util/Math";
@@ -20,9 +28,9 @@ export interface SourceOptions extends ToneAudioNodeOptions {
 }
 
 /**
- * Base class for sources. 
+ * Base class for sources.
  * start/stop of this.context.transport.
- * 
+ *
  * ```
  * // Multiple state change events can be chained together,
  * // but must be set in the correct order and with ascending times
@@ -36,8 +44,9 @@ export interface SourceOptions extends ToneAudioNodeOptions {
  * state.start("+0.3").stop("+0.2");
  * ```
  */
-export abstract class Source<Options extends SourceOptions> extends ToneAudioNode<Options> {
-
+export abstract class Source<
+	Options extends SourceOptions
+> extends ToneAudioNode<Options> {
 	/**
 	 * The output volume node
 	 */
@@ -129,7 +138,9 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 	get state(): BasicPlaybackState {
 		if (this._synced) {
 			if (this.context.transport.state === "started") {
-				return this._state.getValueAtTime(this.context.transport.seconds) as BasicPlaybackState;
+				return this._state.getValueAtTime(
+					this.context.transport.seconds
+				) as BasicPlaybackState;
 			} else {
 				return "stopped";
 			}
@@ -155,7 +166,11 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 	// overwrite these functions
 	protected abstract _start(time: Time, offset?: Time, duration?: Time): void;
 	protected abstract _stop(time: Time): void;
-	protected abstract _restart(time: Seconds, offset?: Time, duration?: Time): void;
+	protected abstract _restart(
+		time: Seconds,
+		offset?: Time,
+		duration?: Time
+	): void;
 
 	/**
 	 * Ensure that the scheduled time is not before the current time.
@@ -178,12 +193,24 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 	 * source.start("+0.5"); // starts the source 0.5 seconds from now
 	 */
 	start(time?: Time, offset?: Time, duration?: Time): this {
-		let computedTime = isUndef(time) && this._synced ? this.context.transport.seconds : this.toSeconds(time);
+		let computedTime =
+			isUndef(time) && this._synced
+				? this.context.transport.seconds
+				: this.toSeconds(time);
 		computedTime = this._clampToCurrentTime(computedTime);
 		// if it's started, stop it and restart it
-		if (!this._synced && this._state.getValueAtTime(computedTime) === "started") {
+		if (
+			!this._synced &&
+			this._state.getValueAtTime(computedTime) === "started"
+		) {
 			// time should be strictly greater than the previous start time
-			assert(GT(computedTime, (this._state.get(computedTime) as StateTimelineEvent).time), "Start time must be strictly greater than previous start time");
+			assert(
+				GT(
+					computedTime,
+					(this._state.get(computedTime) as StateTimelineEvent).time
+				),
+				"Start time must be strictly greater than previous start time"
+			);
 			this._state.cancel(computedTime);
 			this._state.setStateAtTime("started", computedTime);
 			this.log("restart", computedTime);
@@ -196,18 +223,26 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 				const event = this._state.get(computedTime);
 				if (event) {
 					event.offset = this.toSeconds(defaultArg(offset, 0));
-					event.duration = duration ? this.toSeconds(duration) : undefined;
+					event.duration = duration
+						? this.toSeconds(duration)
+						: undefined;
 				}
-				const sched = this.context.transport.schedule(t => {
+				const sched = this.context.transport.schedule((t) => {
 					this._start(t, offset, duration);
 				}, computedTime);
 				this._scheduled.push(sched);
 
 				// if the transport is already started
 				// and the time is greater than where the transport is
-				if (this.context.transport.state === "started" && 
-					this.context.transport.getSecondsAtTime(this.immediate()) > computedTime) {
-					this._syncedStart(this.now(), this.context.transport.seconds);
+				if (
+					this.context.transport.state === "started" &&
+					this.context.transport.getSecondsAtTime(this.immediate()) >
+						computedTime
+				) {
+					this._syncedStart(
+						this.now(),
+						this.context.transport.seconds
+					);
 				}
 			} else {
 				assertContextRunning(this.context);
@@ -227,14 +262,23 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 	 * source.stop("+0.5"); // stops the source 0.5 seconds from now
 	 */
 	stop(time?: Time): this {
-		let computedTime = isUndef(time) && this._synced ? this.context.transport.seconds : this.toSeconds(time);
+		let computedTime =
+			isUndef(time) && this._synced
+				? this.context.transport.seconds
+				: this.toSeconds(time);
 		computedTime = this._clampToCurrentTime(computedTime);
-		if (this._state.getValueAtTime(computedTime) === "started" || isDefined(this._state.getNextState("started", computedTime))) {
+		if (
+			this._state.getValueAtTime(computedTime) === "started" ||
+			isDefined(this._state.getNextState("started", computedTime))
+		) {
 			this.log("stop", computedTime);
 			if (!this._synced) {
 				this._stop(computedTime);
 			} else {
-				const sched = this.context.transport.schedule(this._stop.bind(this), computedTime);
+				const sched = this.context.transport.schedule(
+					this._stop.bind(this),
+					computedTime
+				);
 				this._scheduled.push(sched);
 			}
 			this._state.cancel(computedTime);
@@ -274,23 +318,36 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 		if (!this._synced) {
 			this._synced = true;
 			this._syncedStart = (time, offset) => {
-				if (offset > 0) {
+				if (GT(offset, 0)) {
 					// get the playback state at that time
 					const stateEvent = this._state.get(offset);
 					// listen for start events which may occur in the middle of the sync'ed time
-					if (stateEvent && stateEvent.state === "started" && stateEvent.time !== offset) {
+					if (
+						stateEvent &&
+						stateEvent.state === "started" &&
+						stateEvent.time !== offset
+					) {
 						// get the offset
-						const startOffset = offset - this.toSeconds(stateEvent.time);
+						const startOffset =
+							offset - this.toSeconds(stateEvent.time);
 						let duration: number | undefined;
 						if (stateEvent.duration) {
-							duration = this.toSeconds(stateEvent.duration) - startOffset;
+							duration =
+								this.toSeconds(stateEvent.duration) -
+								startOffset;
 						}
-						this._start(time, this.toSeconds(stateEvent.offset) + startOffset, duration);
+						this._start(
+							time,
+							this.toSeconds(stateEvent.offset) + startOffset,
+							duration
+						);
 					}
 				}
 			};
-			this._syncedStop = time => {
-				const seconds = this.context.transport.getSecondsAtTime(Math.max(time - this.sampleTime, 0));
+			this._syncedStop = (time) => {
+				const seconds = this.context.transport.getSecondsAtTime(
+					Math.max(time - this.sampleTime, 0)
+				);
 				if (this._state.getValueAtTime(seconds) === "started") {
 					this._stop(time);
 				}
@@ -317,7 +374,7 @@ export abstract class Source<Options extends SourceOptions> extends ToneAudioNod
 		}
 		this._synced = false;
 		// clear all of the scheduled ids
-		this._scheduled.forEach(id => this.context.transport.clear(id));
+		this._scheduled.forEach((id) => this.context.transport.clear(id));
 		this._scheduled = [];
 		this._state.cancel(0);
 		// stop it also