tone 15.2.13 → 15.3.1

package/Tone/core/context/Context.test.ts

@@ -2,13 +2,13 @@ import { expect } from "chai";
 
 import { ConstantOutput } from "../../../test/helper/ConstantOutput.js";
 import { Offline } from "../../../test/helper/Offline.js";
-import { TransportClass } from "../clock/Transport.js";
+import { TransportInstance } from "../clock/Transport.js";
 import { getContext } from "../Global.js";
-import { DrawClass } from "../util/Draw.js";
+import { DrawInstance } from "../util/Draw.js";
 import { createAudioContext } from "./AudioContext.js";
 import { Context } from "./Context.js";
-import { DestinationClass } from "./Destination.js";
-import { ListenerClass } from "./Listener.js";
+import { DestinationInstance } from "./Destination.js";
+import { ListenerInstance } from "./Listener.js";
 import { connect } from "./ToneAudioNode.js";
 
 describe("Context", () => {
@@ -19,9 +19,9 @@ describe("Context", () => {
 		const ctxDraw = context.draw;
 		const ctxTransport = context.transport;
 		const ctxListener = context.listener;
-		expect(context.destination).is.instanceOf(DestinationClass);
-		expect(context.draw).is.instanceOf(DrawClass);
-		expect(context.listener).is.instanceOf(ListenerClass);
+		expect(context.destination).is.instanceOf(DestinationInstance);
+		expect(context.draw).is.instanceOf(DrawInstance);
+		expect(context.listener).is.instanceOf(ListenerInstance);
 		await context.close();
 		expect(ctxDest.disposed).to.be.true;
 		expect(ctxDraw.disposed).to.be.true;
@@ -214,7 +214,7 @@ describe("Context", () => {
 
 		it("is invoked in the offline context", () => {
 			return Offline((context) => {
-				const transport = new TransportClass({ context });
+				const transport = new TransportInstance({ context });
 				transport.context.setTimeout(() => {
 					expect(transport.now()).to.be.closeTo(0.01, 0.005);
 				}, 0.01);

package/Tone/core/context/Context.ts

@@ -1,10 +1,10 @@
 import { Ticker, TickerClockSource } from "../clock/Ticker.js";
-import type { TransportClass as Transport } from "../clock/Transport.js";
+import type { TransportInstance as Transport } from "../clock/Transport.js";
 import { Seconds } from "../type/Units.js";
 import { isAudioContext } from "../util/AdvancedTypeCheck.js";
 import { assert } from "../util/Debug.js";
 import { optionsFromArguments } from "../util/Defaults.js";
-import type { DrawClass as Draw } from "../util/Draw.js";
+import type { DrawInstance as Draw } from "../util/Draw.js";
 import { Timeline } from "../util/Timeline.js";
 import { isDefined } from "../util/TypeCheck.js";
 import {
@@ -14,8 +14,8 @@ import {
 } from "./AudioContext.js";
 import { BaseContext, ContextLatencyHint } from "./BaseContext.js";
 import { closeContext, initializeContext } from "./ContextInitialization.js";
-import type { DestinationClass as Destination } from "./Destination.js";
-import type { ListenerClass as Listener } from "./Listener.js";
+import type { DestinationInstance as Destination } from "./Destination.js";
+import type { ListenerInstance as Listener } from "./Listener.js";
 
 export interface ContextOptions {
 	clockSource: TickerClockSource;
@@ -117,12 +117,16 @@ export class Context extends BaseContext {
 			// custom context provided, latencyHint unknown (unless explicitly provided in options)
 			this._latencyHint = arguments[0]?.latencyHint || "";
 		} else {
-			this._context = createAudioContext(options.sampleRate ? {
-				latencyHint: options.latencyHint,
-				sampleRate: options.sampleRate,
-			} : {
-				latencyHint: options.latencyHint,
-			});
+			this._context = createAudioContext(
+				options.sampleRate
+					? {
+							latencyHint: options.latencyHint,
+							sampleRate: options.sampleRate,
+						}
+					: {
+							latencyHint: options.latencyHint,
+						}
+			);
 			this._latencyHint = options.latencyHint;
 		}
 

package/Tone/core/context/Destination.test.ts

@@ -5,11 +5,11 @@ import { Offline } from "../../../test/helper/Offline.js";
 import { PassAudio } from "../../../test/helper/PassAudio.js";
 import { Oscillator } from "../../source/oscillator/Oscillator.js";
 import { getContext } from "../Global.js";
-import { DestinationClass } from "./Destination.js";
+import { DestinationInstance } from "./Destination.js";
 
 describe("Destination", () => {
 	it("creates itself on the context", () => {
-		expect(getContext().destination).instanceOf(DestinationClass);
+		expect(getContext().destination).instanceOf(DestinationInstance);
 	});
 
 	it("can be muted and unmuted", () => {

package/Tone/core/context/Destination.ts

@@ -30,7 +30,7 @@ interface DestinationOptions extends ToneAudioNodeOptions {
  * oscillator.toDestination();
  * @category Core
  */
-export class DestinationClass extends ToneAudioNode<DestinationOptions> {
+export class DestinationInstance extends ToneAudioNode<DestinationOptions> {
 	readonly name: string = "Destination";
 
 	input: Volume = new Volume({ context: this.context });
@@ -49,7 +49,7 @@ export class DestinationClass extends ToneAudioNode<DestinationOptions> {
 	constructor(options: Partial<DestinationOptions>);
 	constructor() {
 		const options = optionsFromArguments(
-			DestinationClass.getDefaults(),
+			DestinationInstance.getDefaults(),
 			arguments
 		);
 		super(options);
@@ -133,7 +133,7 @@ export class DestinationClass extends ToneAudioNode<DestinationOptions> {
 //-------------------------------------
 
 onContextInit((context) => {
-	context.destination = new DestinationClass({ context });
+	context.destination = new DestinationInstance({ context });
 });
 
 onContextClose((context) => {

package/Tone/core/context/DummyContext.ts

@@ -1,10 +1,10 @@
-import type { TransportClass as Transport } from "../clock/Transport.js";
+import type { TransportInstance as Transport } from "../clock/Transport.js";
 import { Seconds } from "../type/Units.js";
-import type { DrawClass as Draw } from "../util/Draw.js";
+import type { DrawInstance as Draw } from "../util/Draw.js";
 import { AnyAudioContext } from "./AudioContext.js";
 import { BaseContext } from "./BaseContext.js";
-import type { DestinationClass as Destination } from "./Destination.js";
-import type { ListenerClass as Listener } from "./Listener.js";
+import type { DestinationInstance as Destination } from "./Destination.js";
+import type { ListenerInstance as Listener } from "./Listener.js";
 
 export class DummyContext extends BaseContext {
 	//---------------------------

package/Tone/core/context/Listener.test.ts

@@ -2,11 +2,11 @@ import { expect } from "chai";
 
 import { Offline } from "../../../test/helper/Offline.js";
 import { getContext } from "../Global.js";
-import { ListenerClass } from "./Listener.js";
+import { ListenerInstance } from "./Listener.js";
 
 describe("Listener", () => {
 	it("creates itself on the context", () => {
-		expect(getContext().listener).instanceOf(ListenerClass);
+		expect(getContext().listener).instanceOf(ListenerInstance);
 	});
 
 	it("can get and set values as an object", () => {

package/Tone/core/context/Listener.ts

@@ -19,8 +19,9 @@ export interface ListenerOptions extends ToneAudioNodeOptions {
  * with {@link 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.
+ * @category Core
  */
-export class ListenerClass extends ToneAudioNode<ListenerOptions> {
+export class ListenerInstance extends ToneAudioNode<ListenerOptions> {
 	readonly name: string = "Listener";
 
 	/**
@@ -108,7 +109,7 @@ export class ListenerClass extends ToneAudioNode<ListenerOptions> {
 //-------------------------------------
 
 onContextInit((context) => {
-	context.listener = new ListenerClass({ context });
+	context.listener = new ListenerInstance({ context });
 });
 
 onContextClose((context) => {

package/Tone/core/context/ToneWithContext.ts

@@ -110,7 +110,7 @@ export abstract class ToneWithContext<
 
 	/**
 	 * Convert the incoming time to seconds.
-	 * This is calculated against the current {@link TransportClass} bpm
+	 * This is calculated against the current {@link TransportInstance} bpm
 	 * @example
 	 * const gain = new Tone.Gain();
 	 * setInterval(() => console.log(gain.toSeconds("4n")), 100);

package/Tone/core/index.ts

@@ -1,10 +1,7 @@
 export * from "./clock/Clock.js";
-// export * from "./clock/Transport";
-
 export * from "./context/BaseContext.js";
 export * from "./context/Context.js";
 export * from "./context/Delay.js";
-// export * from "./context/Destination";
 export * from "./context/Gain.js";
 export * from "./context/Offline.js";
 export * from "./context/OfflineContext.js";

package/Tone/core/util/Draw.test.ts

@@ -1,6 +1,6 @@
 import { expect } from "chai";
 
-import { DrawClass } from "./Draw.js";
+import { DrawInstance } from "./Draw.js";
 
 describe("Draw", () => {
 	const originalRAF = window.requestAnimationFrame;
@@ -15,7 +15,7 @@ describe("Draw", () => {
 	});
 
 	it("can schedule a callback at a AudioContext time", (done) => {
-		const draw = new DrawClass();
+		const draw = new DrawInstance();
 		const scheduledTime = draw.now() + 0.2;
 		draw.schedule(() => {
 			expect(draw.context.currentTime).to.be.closeTo(scheduledTime, 0.05);
@@ -25,7 +25,7 @@ describe("Draw", () => {
 	});
 
 	it("can schedule multiple callbacks", (done) => {
-		const draw = new DrawClass();
+		const draw = new DrawInstance();
 		let callbackCount = 0;
 		const firstEvent = draw.now() + 0.1;
 		draw.schedule(() => {
@@ -50,7 +50,7 @@ describe("Draw", () => {
 	});
 
 	it("can cancel scheduled events", (done) => {
-		const draw = new DrawClass();
+		const draw = new DrawInstance();
 		let callbackCount = 0;
 		draw.schedule(() => {
 			callbackCount++;

package/Tone/core/util/Draw.ts

@@ -31,7 +31,7 @@ interface DrawEvent extends TimelineEvent {
  * Tone.Transport.start();
  * @category Core
  */
-export class DrawClass extends ToneWithContext<ToneWithContextOptions> {
+export class DrawInstance extends ToneWithContext<ToneWithContextOptions> {
 	readonly name: string = "Draw";
 
 	/**
@@ -122,7 +122,7 @@ export class DrawClass extends ToneWithContext<ToneWithContextOptions> {
 //-------------------------------------
 
 onContextInit((context) => {
-	context.draw = new DrawClass({ context });
+	context.draw = new DrawInstance({ context });
 });
 
 onContextClose((context) => {

package/Tone/fromContext.ts

@@ -1,15 +1,15 @@
 import * as Classes from "./classes.js";
-import { TransportClass } from "./core/clock/Transport.js";
+import { TransportInstance } from "./core/clock/Transport.js";
 import { Context } from "./core/context/Context.js";
-import { DestinationClass } from "./core/context/Destination.js";
-import { ListenerClass } from "./core/context/Listener.js";
+import { DestinationInstance } from "./core/context/Destination.js";
+import { ListenerInstance } from "./core/context/Listener.js";
 import { FrequencyClass } from "./core/type/Frequency.js";
 import { MidiClass } from "./core/type/Midi.js";
 import { TicksClass } from "./core/type/Ticks.js";
 import { TimeClass } from "./core/type/Time.js";
 import { TransportTimeClass } from "./core/type/TransportTime.js";
 import { omitFromObject } from "./core/util/Defaults.js";
-import { DrawClass } from "./core/util/Draw.js";
+import { DrawInstance } from "./core/util/Draw.js";
 import { isDefined, isFunction } from "./core/util/TypeCheck.js";
 
 type ClassesWithoutSingletons = Omit<
@@ -22,10 +22,10 @@ type ClassesWithoutSingletons = Omit<
  * to the same context and contains a singleton Transport and Destination node.
  */
 type ToneObject = {
-	Transport: TransportClass;
-	Destination: DestinationClass;
-	Listener: ListenerClass;
-	Draw: DrawClass;
+	Transport: TransportInstance;
+	Destination: DestinationInstance;
+	Listener: ListenerInstance;
+	Draw: DrawInstance;
 	context: Context;
 	now: () => number;
 	immediate: () => number;

package/Tone/index.test.ts

@@ -1,9 +1,9 @@
 import { expect } from "chai";
 
-import { TransportClass } from "./core/clock/Transport.js";
+import { TransportInstance } from "./core/clock/Transport.js";
 import { Context } from "./core/context/Context.js";
-import { DestinationClass } from "./core/context/Destination.js";
-import { DrawClass } from "./core/util/Draw.js";
+import { DestinationInstance } from "./core/context/Destination.js";
+import { DrawInstance } from "./core/util/Draw.js";
 import * as Tone from "./index.js";
 
 describe("Tone", () => {
@@ -15,16 +15,16 @@ describe("Tone", () => {
 	});
 
 	it("exports the global singletons", () => {
-		expect(Tone.Destination).to.be.an.instanceOf(DestinationClass);
-		expect(Tone.Draw).to.be.an.instanceOf(DrawClass);
-		expect(Tone.Transport).to.be.an.instanceOf(TransportClass);
+		expect(Tone.Destination).to.be.an.instanceOf(DestinationInstance);
+		expect(Tone.Draw).to.be.an.instanceOf(DrawInstance);
+		expect(Tone.Transport).to.be.an.instanceOf(TransportInstance);
 		expect(Tone.context).to.be.an.instanceOf(Context);
 	});
 
 	it("exports the global singleton getters", () => {
-		expect(Tone.getDestination()).to.be.an.instanceOf(DestinationClass);
-		expect(Tone.getDraw()).to.be.an.instanceOf(DrawClass);
-		expect(Tone.getTransport()).to.be.an.instanceOf(TransportClass);
+		expect(Tone.getDestination()).to.be.an.instanceOf(DestinationInstance);
+		expect(Tone.getDraw()).to.be.an.instanceOf(DrawInstance);
+		expect(Tone.getTransport()).to.be.an.instanceOf(TransportInstance);
 	});
 
 	it("can start the global context", () => {

package/Tone/index.ts

@@ -6,10 +6,14 @@ import { getContext } from "./core/Global.js";
 export { start } from "./core/Global.js";
 import { Seconds } from "./core/type/Units.js";
 export { supported } from "./core/context/AudioContext.js";
-import type { TransportClass } from "./core/clock/Transport.js";
-import type { DestinationClass } from "./core/context/Destination.js";
-import type { ListenerClass } from "./core/context/Listener.js";
-import type { DrawClass } from "./core/util/Draw.js";
+import type { TransportInstance } from "./core/clock/Transport.js";
+export type { TransportInstance } from "./core/clock/Transport.js";
+import type { DestinationInstance } from "./core/context/Destination.js";
+export type { DestinationInstance } from "./core/context/Destination.js";
+import type { ListenerInstance } from "./core/context/Listener.js";
+export type { ListenerInstance } from "./core/context/Listener.js";
+import type { DrawInstance } from "./core/util/Draw.js";
+export type { DrawInstance } from "./core/util/Draw.js";
 
 /**
  * The current audio context time of the global {@link BaseContext}.
@@ -31,7 +35,7 @@ export function immediate(): Seconds {
 
 /**
  * The Transport object belonging to the global Tone.js Context.
- * @see {@link TransportClass}
+ * @see {@link TransportInstance}
  * @category Core
  * @deprecated Use {@link getTransport} instead
  */
@@ -39,16 +43,16 @@ export const Transport = getContext().transport;
 
 /**
  * The Transport object belonging to the global Tone.js Context.
- * @see {@link TransportClass}
+ * @see {@link TransportInstance}
  * @category Core
  */
-export function getTransport(): TransportClass {
+export function getTransport(): TransportInstance {
 	return getContext().transport;
 }
 
 /**
  * The Destination (output) belonging to the global Tone.js Context.
- * @see {@link DestinationClass}
+ * @see {@link DestinationInstance}
  * @category Core
  * @deprecated Use {@link getDestination} instead
  */
@@ -61,31 +65,31 @@ export const Master = getContext().destination;
 
 /**
  * The Destination (output) belonging to the global Tone.js Context.
- * @see {@link DestinationClass}
+ * @see {@link DestinationInstance}
  * @category Core
  */
-export function getDestination(): DestinationClass {
+export function getDestination(): DestinationInstance {
 	return getContext().destination;
 }
 
 /**
- * The {@link ListenerClass} belonging to the global Tone.js Context.
+ * The {@link ListenerInstance} belonging to the global Tone.js Context.
  * @category Core
  * @deprecated Use {@link getListener} instead
  */
 export const Listener = getContext().listener;
 
 /**
- * The {@link ListenerClass} belonging to the global Tone.js Context.
+ * The {@link ListenerInstance} belonging to the global Tone.js Context.
  * @category Core
  */
-export function getListener(): ListenerClass {
+export function getListener(): ListenerInstance {
 	return getContext().listener;
 }
 
 /**
  * Draw is used to synchronize the draw frame with the Transport's callbacks.
- * @see {@link DrawClass}
+ * @see {@link DrawInstance}
  * @category Core
  * @deprecated Use {@link getDraw} instead
  */
@@ -94,10 +98,10 @@ export const Draw = getContext().draw;
 /**
  * Get the singleton attached to the global context.
  * Draw is used to synchronize the draw frame with the Transport's callbacks.
- * @see {@link DrawClass}
+ * @see {@link DrawInstance}
  * @category Core
  */
-export function getDraw(): DrawClass {
+export function getDraw(): DrawInstance {
 	return getContext().draw;
 }
 

package/Tone/signal/SyncedSignal.ts

@@ -15,7 +15,7 @@ import { Signal, SignalOptions } from "./Signal.js";
 import { ToneConstantSource } from "./ToneConstantSource.js";
 
 /**
- * Adds the ability to synchronize the signal to the {@link TransportClass}
+ * Adds the ability to synchronize the signal to the {@link TransportInstance}
  * @category Signal
  */
 export class SyncedSignal<