tone 15.3.3 → 15.3.4

package/Tone/core/clock/Transport.test.ts

@@ -241,6 +241,33 @@ describe("Transport", () => {
 			});
 		});
 
+		it("can schedule the current seconds position", () => {
+			return Offline((context) => {
+				const transport = new TransportInstance({ context });
+				transport.start();
+
+				let scheduled = false;
+
+				return (time) => {
+					if (time > 0.5 && !scheduled) {
+						scheduled = true;
+						transport.setSecondsAtTime(3, 0.5);
+					}
+
+					whenBetween(time, 0, 0.5, () => {
+						expect(transport.seconds).to.be.closeTo(time, 0.01);
+					});
+
+					whenBetween(time, 0.5, 1, () => {
+						expect(transport.seconds).to.be.closeTo(
+							2.5 + time,
+							0.01
+						);
+					});
+				};
+			}, 1);
+		});
+
 		it("can set the current position in BarsBeatsSixteenths", () => {
 			return Offline((context) => {
 				const transport = new TransportInstance({ context });
@@ -423,6 +450,36 @@ describe("Transport", () => {
 			}, 2.5);
 			expect(invocations).to.equal(2);
 		});
+
+		it("can schedule the ticks", () => {
+			return Offline((context) => {
+				const transport = new TransportInstance({ context });
+				transport.start();
+
+				let scheduled = false;
+
+				return (time) => {
+					if (time > 0.5 && !scheduled) {
+						scheduled = true;
+						transport.setTicksAtTime(0, 0.5);
+					}
+
+					whenBetween(time, 0, 0.5, () => {
+						expect(transport.ticks).to.be.closeTo(
+							transport.toTicks(time),
+							1
+						);
+					});
+
+					whenBetween(time, 0.5, 1, () => {
+						expect(transport.ticks).to.be.closeTo(
+							transport.toTicks(time - 0.5),
+							1
+						);
+					});
+				};
+			}, 1);
+		});
 	});
 
 	context("schedule", () => {

package/Tone/core/clock/Transport.ts

@@ -27,6 +27,7 @@ import {
 	TransportTime,
 } from "../type/Units.js";
 import { enterScheduledCallback } from "../util/Debug.js";
+import { assertUsedScheduleTime } from "../util/Debug.js";
 import { optionsFromArguments } from "../util/Defaults.js";
 import { Emitter } from "../util/Emitter.js";
 import { readOnly, writable } from "../util/Interface.js";
@@ -623,6 +624,7 @@ export class TransportInstance
 		return this._clock.ticks;
 	}
 	set ticks(t: Ticks) {
+		assertUsedScheduleTime();
 		if (this._clock.ticks !== t) {
 			const now = this.now();
 			// stop everything synced to the transport
@@ -654,6 +656,16 @@ export class TransportInstance
 		return this._clock.getTicksAtTime(time);
 	}
 
+	/**
+	 * Set the Transport's {@link ticks} value at the given time
+	 * @param  ticks  The tick value to set
+	 * @param  time   The Context time at which to set the seconds value
+	 */
+	setTicksAtTime(ticks: Ticks, time: Time): this {
+		this._clock.setTicksAtTime(ticks, time);
+		return this;
+	}
+
 	/**
 	 * Return the elapsed seconds at the given time.
 	 * @param  time  When to get the elapsed seconds
@@ -663,6 +675,16 @@ export class TransportInstance
 		return this._clock.getSecondsAtTime(time);
 	}
 
+	/**
+	 * Set the Transport's {@link seconds} value at the given time.
+	 * @param seconds The seconds value to set
+	 * @param time The Context time at which to set the seconds value
+	 */
+	setSecondsAtTime(seconds: Seconds, time: Time): this {
+		this.setTicksAtTime(this.toTicks(seconds), time);
+		return this;
+	}
+
 	/**
 	 * Pulses Per Quarter note. This is the smallest resolution
 	 * the Transport timing supports. This should be set once

package/Tone/core/context/BaseContext.ts

@@ -25,6 +25,9 @@ export type BaseAudioContextSubset = Omit<
 
 export type ContextLatencyHint = AudioContextLatencyCategory;
 
+/**
+ * Shared class for both Offline and Online Audio Context's
+ */
 export abstract class BaseContext
 	extends Emitter<"statechange" | "tick">
 	implements BaseAudioContextSubset

package/Tone/core/util/Debug.ts

@@ -60,7 +60,7 @@ export function assertUsedScheduleTime(time?: Time): void {
 	) {
 		printedScheduledWarning = true;
 		warn(
-			"Events scheduled inside of scheduled callbacks should use the passed in scheduling time. See https://github.com/Tonejs/Tone.js/wiki/Accurate-Timing"
+			"Schedulable methods should include the provided time argument to ensure accurate timing. See https://github.com/Tonejs/Tone.js/wiki/Accurate-Timing"
 		);
 	}
 }

package/Tone/core/util/Emitter.ts

@@ -10,7 +10,6 @@ export interface EmitterEventObject {
  * the ability to listen for and emit events.
  * Inspiration and reference from Jerome Etienne's [MicroEvent](https://github.com/jeromeetienne/microevent.js).
  * MIT (c) 2011 Jerome Etienne.
- * @category Core
  */
 export class Emitter<EventType extends string = string> extends Tone {
 	readonly name: string = "Emitter";

package/Tone/source/Source.ts

@@ -217,7 +217,6 @@ export abstract class Source<
 			this.log("restart", computedTime);
 			this.restart(computedTime, offset, duration);
 		} else {
-			this.log("start", computedTime);
 			this._state.setStateAtTime("started", computedTime);
 			if (this._synced) {
 				// add the offset time to the event

package/Tone/version.ts

@@ -1 +1 @@
-export const version: string = "15.3.3";
+export const version: string = "15.3.4";