tone 14.8.27

package/Tone/core/type/Midi.ts

@@ -0,0 +1,82 @@
+import { getContext } from "../Global";
+import { ftom, mtof } from "./Conversions";
+import { FrequencyClass, FrequencyUnit } from "./Frequency";
+import { TimeValue } from "./TimeBase";
+import { Hertz, Interval, MidiNote, Seconds, Ticks } from "./Units";
+
+/**
+ * Midi is a primitive type for encoding Time values.
+ * Midi can be constructed with or without the `new` keyword. Midi can be passed
+ * into the parameter of any method which takes time as an argument.
+ * @category Unit
+ */
+export class MidiClass extends FrequencyClass<MidiNote> {
+
+	readonly name: string = "MidiClass";
+
+	readonly defaultUnits = "midi";
+
+	/**
+	 * Returns the value of a frequency in the current units
+	 */
+	protected _frequencyToUnits(freq: Hertz): MidiNote {
+		return ftom(super._frequencyToUnits(freq));
+	}
+
+	/**
+	 * Returns the value of a tick in the current time units
+	 */
+	protected _ticksToUnits(ticks: Ticks): MidiNote {
+		return ftom(super._ticksToUnits(ticks));
+	}
+
+	/**
+	 * Return the value of the beats in the current units
+	 */
+	protected _beatsToUnits(beats: number): MidiNote {
+		return ftom(super._beatsToUnits(beats));
+	}
+
+	/**
+	 * Returns the value of a second in the current units
+	 */
+	protected _secondsToUnits(seconds: Seconds): MidiNote {
+		return ftom(super._secondsToUnits(seconds));
+	}
+
+	/**
+	 * Return the value of the frequency as a MIDI note
+	 * @example
+	 * Tone.Midi(60).toMidi(); // 60
+	 */
+	toMidi(): MidiNote {
+		return this.valueOf();
+	}
+
+	/**
+	 * Return the value of the frequency as a MIDI note
+	 * @example
+	 * Tone.Midi(60).toFrequency(); // 261.6255653005986
+	 */
+	toFrequency(): Hertz {
+		return mtof(this.toMidi());
+	}
+
+	/**
+	 * Transposes the frequency by the given number of semitones.
+	 * @return A new transposed MidiClass
+	 * @example
+	 * Tone.Midi("A4").transpose(3); // "C5"
+	 */
+	transpose(interval: Interval): MidiClass {
+		return new MidiClass(this.context, this.toMidi() + interval);
+	}
+}
+
+/**
+ * Convert a value into a FrequencyClass object.
+ * @category Unit
+ */
+export function Midi(value?: TimeValue, units?: FrequencyUnit): MidiClass {
+	return new MidiClass(getContext(), value, units);
+}

package/Tone/core/type/NoteUnits.ts

@@ -0,0 +1,36 @@
+// this file contains all of the valid note names for all pitches between C-4 and C11
+
+/**
+ * A note in Scientific pitch notation.
+ * The pitch class + octave number
+ * e.g. "C4", "D#3", "G-1"
+ * @category Unit
+ */
+export type Note = "Cbb-4" | "Cb-4" | "C-4" | "C#-4" | "Cx-4" | "Dbb-4" | "Db-4" | "D-4" | "D#-4" | "Dx-4" | "Ebb-4" | "Eb-4" | "E-4" | "E#-4" | "Ex-4" | "Fbb-4" | "Fb-4" | "F-4" | "F#-4" | "Fx-4" | "Gbb-4" | "Gb-4" | "G-4" | "G#-4" | "Gx-4" | "Abb-4" | "Ab-4" | "A-4" | "A#-4" | "Ax-4" | "Bbb-4" | "Bb-4" | "B-4" | "B#-4" | "Bx-4" |
+"Cbb-3" | "Cb-3" | "C-3" | "C#-3" | "Cx-3" | "Dbb-3" | "Db-3" | "D-3" | "D#-3" | "Dx-3" | "Ebb-3" | "Eb-3" | "E-3" | "E#-3" | "Ex-3" | "Fbb-3" | "Fb-3" | "F-3" | "F#-3" | "Fx-3" | "Gbb-3" | "Gb-3" | "G-3" | "G#-3" | "Gx-3" | "Abb-3" | "Ab-3" | "A-3" | "A#-3" | "Ax-3" | "Bbb-3" | "Bb-3" | "B-3" | "B#-3" | "Bx-3" |
+"Cbb-2" | "Cb-2" | "C-2" | "C#-2" | "Cx-2" | "Dbb-2" | "Db-2" | "D-2" | "D#-2" | "Dx-2" | "Ebb-2" | "Eb-2" | "E-2" | "E#-2" | "Ex-2" | "Fbb-2" | "Fb-2" | "F-2" | "F#-2" | "Fx-2" | "Gbb-2" | "Gb-2" | "G-2" | "G#-2" | "Gx-2" | "Abb-2" | "Ab-2" | "A-2" | "A#-2" | "Ax-2" | "Bbb-2" | "Bb-2" | "B-2" | "B#-2" | "Bx-2" |
+"Cbb-1" | "Cb-1" | "C-1" | "C#-1" | "Cx-1" | "Dbb-1" | "Db-1" | "D-1" | "D#-1" | "Dx-1" | "Ebb-1" | "Eb-1" | "E-1" | "E#-1" | "Ex-1" | "Fbb-1" | "Fb-1" | "F-1" | "F#-1" | "Fx-1" | "Gbb-1" | "Gb-1" | "G-1" | "G#-1" | "Gx-1" | "Abb-1" | "Ab-1" | "A-1" | "A#-1" | "Ax-1" | "Bbb-1" | "Bb-1" | "B-1" | "B#-1" | "Bx-1" |
+"Cbb0" | "Cb0" | "C0" | "C#0" | "Cx0" | "Dbb0" | "Db0" | "D0" | "D#0" | "Dx0" | "Ebb0" | "Eb0" | "E0" | "E#0" | "Ex0" | "Fbb0" | "Fb0" | "F0" | "F#0" | "Fx0" | "Gbb0" | "Gb0" | "G0" | "G#0" | "Gx0" | "Abb0" | "Ab0" | "A0" | "A#0" | "Ax0" | "Bbb0" | "Bb0" | "B0" | "B#0" | "Bx0" |
+"Cbb1" | "Cb1" | "C1" | "C#1" | "Cx1" | "Dbb1" | "Db1" | "D1" | "D#1" | "Dx1" | "Ebb1" | "Eb1" | "E1" | "E#1" | "Ex1" | "Fbb1" | "Fb1" | "F1" | "F#1" | "Fx1" | "Gbb1" | "Gb1" | "G1" | "G#1" | "Gx1" | "Abb1" | "Ab1" | "A1" | "A#1" | "Ax1" | "Bbb1" | "Bb1" | "B1" | "B#1" | "Bx1" |
+"Cbb2" | "Cb2" | "C2" | "C#2" | "Cx2" | "Dbb2" | "Db2" | "D2" | "D#2" | "Dx2" | "Ebb2" | "Eb2" | "E2" | "E#2" | "Ex2" | "Fbb2" | "Fb2" | "F2" | "F#2" | "Fx2" | "Gbb2" | "Gb2" | "G2" | "G#2" | "Gx2" | "Abb2" | "Ab2" | "A2" | "A#2" | "Ax2" | "Bbb2" | "Bb2" | "B2" | "B#2" | "Bx2" |
+"Cbb3" | "Cb3" | "C3" | "C#3" | "Cx3" | "Dbb3" | "Db3" | "D3" | "D#3" | "Dx3" | "Ebb3" | "Eb3" | "E3" | "E#3" | "Ex3" | "Fbb3" | "Fb3" | "F3" | "F#3" | "Fx3" | "Gbb3" | "Gb3" | "G3" | "G#3" | "Gx3" | "Abb3" | "Ab3" | "A3" | "A#3" | "Ax3" | "Bbb3" | "Bb3" | "B3" | "B#3" | "Bx3" |
+"Cbb4" | "Cb4" | "C4" | "C#4" | "Cx4" | "Dbb4" | "Db4" | "D4" | "D#4" | "Dx4" | "Ebb4" | "Eb4" | "E4" | "E#4" | "Ex4" | "Fbb4" | "Fb4" | "F4" | "F#4" | "Fx4" | "Gbb4" | "Gb4" | "G4" | "G#4" | "Gx4" | "Abb4" | "Ab4" | "A4" | "A#4" | "Ax4" | "Bbb4" | "Bb4" | "B4" | "B#4" | "Bx4" |
+"Cbb5" | "Cb5" | "C5" | "C#5" | "Cx5" | "Dbb5" | "Db5" | "D5" | "D#5" | "Dx5" | "Ebb5" | "Eb5" | "E5" | "E#5" | "Ex5" | "Fbb5" | "Fb5" | "F5" | "F#5" | "Fx5" | "Gbb5" | "Gb5" | "G5" | "G#5" | "Gx5" | "Abb5" | "Ab5" | "A5" | "A#5" | "Ax5" | "Bbb5" | "Bb5" | "B5" | "B#5" | "Bx5" |
+"Cbb6" | "Cb6" | "C6" | "C#6" | "Cx6" | "Dbb6" | "Db6" | "D6" | "D#6" | "Dx6" | "Ebb6" | "Eb6" | "E6" | "E#6" | "Ex6" | "Fbb6" | "Fb6" | "F6" | "F#6" | "Fx6" | "Gbb6" | "Gb6" | "G6" | "G#6" | "Gx6" | "Abb6" | "Ab6" | "A6" | "A#6" | "Ax6" | "Bbb6" | "Bb6" | "B6" | "B#6" | "Bx6" |
+"Cbb7" | "Cb7" | "C7" | "C#7" | "Cx7" | "Dbb7" | "Db7" | "D7" | "D#7" | "Dx7" | "Ebb7" | "Eb7" | "E7" | "E#7" | "Ex7" | "Fbb7" | "Fb7" | "F7" | "F#7" | "Fx7" | "Gbb7" | "Gb7" | "G7" | "G#7" | "Gx7" | "Abb7" | "Ab7" | "A7" | "A#7" | "Ax7" | "Bbb7" | "Bb7" | "B7" | "B#7" | "Bx7" |
+"Cbb8" | "Cb8" | "C8" | "C#8" | "Cx8" | "Dbb8" | "Db8" | "D8" | "D#8" | "Dx8" | "Ebb8" | "Eb8" | "E8" | "E#8" | "Ex8" | "Fbb8" | "Fb8" | "F8" | "F#8" | "Fx8" | "Gbb8" | "Gb8" | "G8" | "G#8" | "Gx8" | "Abb8" | "Ab8" | "A8" | "A#8" | "Ax8" | "Bbb8" | "Bb8" | "B8" | "B#8" | "Bx8" |
+"Cbb9" | "Cb9" | "C9" | "C#9" | "Cx9" | "Dbb9" | "Db9" | "D9" | "D#9" | "Dx9" | "Ebb9" | "Eb9" | "E9" | "E#9" | "Ex9" | "Fbb9" | "Fb9" | "F9" | "F#9" | "Fx9" | "Gbb9" | "Gb9" | "G9" | "G#9" | "Gx9" | "Abb9" | "Ab9" | "A9" | "A#9" | "Ax9" | "Bbb9" | "Bb9" | "B9" | "B#9" | "Bx9" |
+"Cbb10" | "Cb10" | "C10" | "C#10" | "Cx10" | "Dbb10" | "Db10" | "D10" | "D#10" | "Dx10" | "Ebb10" | "Eb10" | "E10" | "E#10" | "Ex10" | "Fbb10" | "Fb10" | "F10" | "F#10" | "Fx10" | "Gbb10" | "Gb10" | "G10" | "G#10" | "Gx10" | "Abb10" | "Ab10" | "A10" | "A#10" | "Ax10" | "Bbb10" | "Bb10" | "B10" | "B#10" | "Bx10" |
+"Cbb11" | "Cb11" | "C11" | "C#11" | "Cx11" | "Dbb11" | "Db11" | "D11" | "D#11" | "Dx11" | "Ebb11" | "Eb11" | "E11" | "E#11" | "Ex11" | "Fbb11" | "Fb11" | "F11" | "F#11" | "Fx11" | "Gbb11" | "Gb11" | "G11" | "G#11" | "Gx11" | "Abb11" | "Ab11" | "A11" | "A#11" | "Ax11" | "Bbb11" | "Bb11" | "B11" | "B#11" | "Bx11";
+
+/**
+ * A number representing a midi note. Integers between 0-127
+ * @category Unit
+ */
+export type MidiNote = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | 16 | 17 | 18 | 19 | 20 |
+21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 34 | 35 | 36 | 37 | 38 | 39 | 40 |
+41 | 42 | 43 | 44 | 45 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | 53 | 54 | 55 | 56 | 57 | 58 | 59 | 60 |
+61 | 62 | 63 | 64 | 65 | 66 | 67 | 68 | 69 | 70 | 71 | 72 | 73 | 74 | 75 | 76 | 77 | 78 | 79 | 80 |
+81 | 82 | 83 | 84 | 85 | 86 | 87 | 88 | 89 | 90 | 91 | 92 | 93 | 94 | 95 | 96 | 97 | 98 | 99 | 100 |
+101 | 102 | 103 | 104 | 105 | 106 | 107 | 108 | 109 | 110 | 111 | 112 | 113 | 114 | 115 | 116 | 117 | 118 | 119 | 120 |
+121 | 122 | 123 | 124 | 125 | 126 | 127;

package/Tone/core/type/Ticks.test.ts

@@ -0,0 +1,190 @@
+import { expect } from "chai";
+import { BasicTests } from "test/helper/Basic";
+import { atTime, Offline } from "test/helper/Offline";
+import { getContext } from "../Global";
+import { Frequency } from "./Frequency";
+import { Ticks, TicksClass } from "./Ticks";
+import { Time } from "./Time";
+import { TransportTime } from "./TransportTime";
+
+describe("TicksClass", () => {
+
+	BasicTests(Ticks);
+
+	context("Constructor", () => {
+
+		it("can be made with or without 'new'", () => {
+			const t0 = Ticks();
+			expect(t0).to.be.instanceOf(TicksClass);
+			t0.dispose();
+			const t1 = new TicksClass(getContext());
+			expect(t1).to.be.instanceOf(TicksClass);
+			t1.dispose();
+		});
+
+		it("can pass in a number in the constructor", () => {
+			return Offline(({ transport }) => {
+				const time = Ticks(1);
+				expect(time).to.be.instanceOf(TicksClass);
+				expect(time.valueOf()).to.equal(1);
+				time.dispose();
+			});
+		});
+
+		it("can pass in a string in the constructor", () => {
+			return Offline(({ transport }) => {
+				const time = Ticks("1");
+				expect(time).to.be.instanceOf(TicksClass);
+				expect(time.valueOf()).to.equal(1);
+				time.dispose();
+			});
+		});
+
+		it("can pass in a value and a type", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(4, "m").valueOf()).to.equal(transport.PPQ * 16);
+			});
+		});
+
+		it("with no arguments evaluates to 0 when the transport is stopped", () => {
+			return Offline(() => {
+				expect(Ticks().valueOf()).to.equal(0);
+			});
+		});
+
+		it("with no arguments evaluates to the current ticks when the transport is started", () => {
+			return Offline((context) => {
+				context.transport.start();
+				return atTime(0.29, () => {
+					expect(new TicksClass(context).valueOf()).to.equal(context.transport.ticks);
+					context.transport.stop();
+				});
+			}, 0.3);
+		});
+
+		it("is evaluated in equations and comparisons using valueOf", () => {
+			// @ts-ignore
+			expect(Ticks("1i") + 1).to.equal(2);
+			// @ts-ignore
+			expect(Ticks("1i") + Ticks("1i")).to.equal(2);
+			expect(Ticks("1i") > Ticks(0)).to.be.true;
+			expect(+Ticks("1i")).to.equal(1);
+		});
+
+		it("can convert from Time", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(Time(2)).valueOf()).to.equal(transport.PPQ * 4);
+				expect(Ticks(Time("4n")).valueOf()).to.equal(transport.PPQ);
+				expect(Ticks(Time(4, "n")).valueOf()).to.equal(transport.PPQ);
+			});
+		});
+
+		it("can convert from Frequency", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(Frequency(2)).valueOf()).to.equal(transport.PPQ);
+				expect(Ticks(Frequency("4n")).valueOf()).to.equal(transport.PPQ);
+				expect(Ticks(Frequency(4, "n")).valueOf()).to.equal(transport.PPQ);
+			});
+		});
+
+		it("can convert from TransportTime", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(TransportTime(2)).valueOf()).to.equal(transport.PPQ * 4);
+				expect(Ticks(TransportTime("4n")).valueOf()).to.equal(transport.PPQ);
+			});
+		});
+
+		it("can convert from Ticks", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(Ticks(transport.PPQ)).valueOf()).to.equal(transport.PPQ);
+				expect(Ticks(Ticks("4n")).valueOf()).to.equal(transport.PPQ);
+			});
+		});
+
+		it("can convert from an Object", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks({ "4n": 2 }).valueOf()).to.equal(transport.PPQ * 2);
+				expect(Ticks({ "1n": 1, "8t": 2 }).valueOf()).to.equal(transport.PPQ * 4 + transport.PPQ * (2 / 3));
+			});
+		});
+	});
+
+	context("Quantizes values", () => {
+
+		it("can quantize values", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks("4t").quantize("4n").valueOf()).to.be.closeTo(transport.PPQ, 0.01);
+			});
+		});
+
+		it("can get the next subdivison when the transport is started", () => {
+			return Offline((context) => {
+				const transport = context.transport;
+				transport.start();
+				return atTime(0.59, () => {
+					expect(new TicksClass(context, "@1m").valueOf()).to.be.closeTo(4 * transport.PPQ, 1);
+					expect(new TicksClass(context, "@4n").valueOf()).to.be.closeTo(transport.PPQ * 2, 1);
+				});
+			}, 0.6);
+		});
+	});
+
+	context("Operators", () => {
+
+		it("can add the current time", () => {
+			return Offline((context) => {
+				context.transport.start();
+				return atTime(0.59, () => {
+					const now = context.transport.ticks;
+					expect(new TicksClass(context, "+4i").valueOf()).to.be.closeTo(4 + now, 0.01);
+					expect(new TicksClass(context, "+2n").valueOf()).to.be.closeTo(context.transport.PPQ * 2 + now, 0.01);
+					expect(new TicksClass(context, "+2n").valueOf()).to.be.closeTo(context.transport.PPQ * 2 + now, 0.01);
+					context.transport.stop();
+				});
+			}, 0.6);
+		});
+
+	});
+
+	context("Conversions", () => {
+
+		it("converts time into notation", () => {
+			return Offline(({ transport }) => {
+				transport.bpm.value = 120;
+				transport.timeSignature = 4;
+				expect(Ticks("4n").toNotation()).to.equal("4n");
+				// expect(Ticks(1.5 * transport.PPQ).toNotation()).to.equal("2n + 4n");
+				expect(Ticks(0).toNotation()).to.equal("0");
+				// expect(Ticks("1:2:3").toNotation()).to.equal("1m + 2n + 8n + 16n");
+			});
+		});
+
+		it("converts time into samples", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(transport.PPQ).toSamples()).to.equal(0.5 * getContext().sampleRate);
+			});
+		});
+
+		it("converts time into frequency", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks(transport.PPQ * 4).toFrequency()).to.equal(0.5);
+				expect(Ticks("2n").toFrequency()).to.equal(1);
+			});
+		});
+
+		it("converts time into seconds", () => {
+			return Offline(() => {
+				expect(Ticks("2n").toSeconds()).to.equal(1);
+			});
+		});
+
+		it("converts time into BarsBeatsSixteenths", () => {
+			return Offline(({ transport }) => {
+				expect(Ticks("3:1:3").toBarsBeatsSixteenths()).to.equal("3:1:3");
+				expect(Ticks(4 * transport.PPQ).toBarsBeatsSixteenths()).to.equal("1:0:0");
+			});
+		});
+
+	});
+
+});

package/Tone/core/type/Ticks.ts

@@ -0,0 +1,69 @@
+import { getContext } from "../Global";
+import { TimeBaseUnit, TimeValue } from "./TimeBase";
+import { TransportTimeClass } from "./TransportTime";
+import { Seconds, Ticks } from "./Units";
+
+/**
+ * Ticks is a primitive type for encoding Time values.
+ * Ticks can be constructed with or without the `new` keyword. Ticks can be passed
+ * into the parameter of any method which takes time as an argument.
+ * @example
+ * const t = Tone.Ticks("4n"); // a quarter note as ticks
+ * @category Unit
+ */
+export class TicksClass extends TransportTimeClass<Ticks> {
+
+	readonly name: string = "Ticks";
+
+	readonly defaultUnits: TimeBaseUnit = "i";
+
+	/**
+	 * Get the current time in the given units
+	 */
+	protected _now(): Ticks {
+		return this.context.transport.ticks;
+	}
+
+	/**
+	 * Return the value of the beats in the current units
+	 */
+	protected _beatsToUnits(beats: number): Ticks {
+		return this._getPPQ() * beats;
+	}
+
+	/**
+	 * Returns the value of a second in the current units
+	 */
+	protected _secondsToUnits(seconds: Seconds): Ticks {
+		return Math.floor(seconds / (60 / this._getBpm()) * this._getPPQ());
+	}
+
+	/**
+	 * Returns the value of a tick in the current time units
+	 */
+	protected _ticksToUnits(ticks: Ticks): Ticks {
+		return ticks;
+	}
+
+	/**
+	 * Return the time in ticks
+	 */
+	toTicks(): Ticks {
+		return this.valueOf() as Ticks;
+	}
+
+	/**
+	 * Return the time in seconds
+	 */
+	toSeconds(): Seconds {
+		return (this.valueOf() / this._getPPQ()) * (60 / this._getBpm());
+	}
+}
+
+/**
+ * Convert a time representation to ticks
+ * @category Unit
+ */
+export function Ticks(value?: TimeValue, units?: TimeBaseUnit): TicksClass {
+	return new TicksClass(getContext(), value, units);
+}

package/Tone/core/type/Time.test.ts

@@ -0,0 +1,181 @@
+import { expect } from "chai";
+import { BasicTests } from "test/helper/Basic";
+import { atTime, Offline } from "test/helper/Offline";
+import { getContext } from "../Global";
+import { Frequency } from "./Frequency";
+import { Ticks } from "./Ticks";
+import { Time, TimeClass } from "./Time";
+import { TransportTime } from "./TransportTime";
+
+describe("TimeClass", () => {
+
+	BasicTests(TimeClass);
+
+	context("Constructor", () => {
+
+		it("can be used as a function or instantiated", () => {
+			const t0 = Time();
+			expect(t0).to.be.instanceOf(TimeClass);
+			t0.dispose();
+			const t1 = new TimeClass(getContext());
+			expect(t1).to.be.instanceOf(TimeClass);
+			t1.dispose();
+		});
+
+		it("can pass in a number in the constructor", () => {
+			const time = Time(1);
+			expect(time.valueOf()).to.equal(1);
+			expect(time).to.be.instanceOf(TimeClass);
+			time.dispose();
+		});
+
+		it("can pass in a string in the constructor", () => {
+			const time = Time("1");
+			expect(time.valueOf()).to.equal(1);
+			expect(time).to.be.instanceOf(TimeClass);
+			time.dispose();
+		});
+
+		it("can pass in a value and a type", () => {
+			expect(Time(4, "m").valueOf()).to.equal(8);
+		});
+
+		it("with no arguments evaluates to 'now'", () => {
+			const now = getContext().now();
+			expect(Time().valueOf()).to.be.closeTo(now, 0.01);
+		});
+
+		it("is evaluated in equations and comparisons using valueOf", () => {
+			expect(Time(1).valueOf() + 1).to.equal(2);
+			expect(Time(1).valueOf() + Time(1).valueOf()).to.equal(2);
+			expect(Time(1) > Time(0)).to.equal(true);
+			expect(+Time(1)).to.equal(1);
+		});
+
+		it("can convert from Time", () => {
+			expect(Time(Time(2)).valueOf()).to.equal(2);
+			expect(Time("4n").valueOf()).to.equal(0.5);
+		});
+
+		it("can convert from Frequency", () => {
+			expect(Time(Frequency(2)).valueOf()).to.equal(0.5);
+			expect(Time(Frequency("4n")).valueOf()).to.equal(0.5);
+		});
+
+		it("can convert from TransportTime", () => {
+			expect(Time(TransportTime(2)).valueOf()).to.equal(2);
+			expect(Time(TransportTime("4n")).valueOf()).to.equal(0.5);
+		});
+
+		it("can convert from Ticks", () => {
+			return Offline(({ transport }) => {
+				expect(Time(Ticks(transport.PPQ)).valueOf()).to.equal(0.5);
+				expect(Time(Ticks("4n")).valueOf()).to.equal(0.5);
+			});
+		});
+
+		it("evalutes objects", () => {
+			return Offline(() => {
+				expect(Time({ "4n": 3 }).valueOf()).to.equal(1.5);
+				expect(Time({ "8t": 2, "1m": 3 }).valueOf()).to.be.closeTo(6.33, 0.01);
+				expect(Time({ "2n": 1, "8n": 1.5 }).valueOf()).to.equal(1.375);
+				expect(Time({ "2n": 1, "8n": -1 }).valueOf()).to.equal(0.75);
+			});
+		});
+	});
+
+	context("Quantizes values", () => {
+
+		it("returns the time quantized to the a subdivision", () => {
+			expect(Time(1.1).quantize(0.5).valueOf()).to.be.closeTo(1, 0.01);
+			expect(Time(2.3).quantize(0.5).valueOf()).to.be.closeTo(2.5, 0.01);
+			expect(Time(0).quantize(4).valueOf()).to.be.closeTo(0, 0.01);
+		});
+
+		it("can quantize with a percentage", () => {
+			expect(Time(4).quantize(8, 0.5).valueOf()).to.equal(6);
+			expect(Time(10).quantize(8, 0.5).valueOf()).to.equal(9);
+			expect(Time(2).quantize(8, 0.75).valueOf()).to.equal(0.5);
+		});
+
+		it("can get the next subdivison when the transport is started", () => {
+			return Offline((context) => {
+				const transport = context.transport;
+				transport.start(0.1);
+				return atTime(0.69, () => {
+					expect(new TimeClass(context, "@1m").valueOf()).to.be.closeTo(2.1, 0.01);
+					expect(new TimeClass(context, "@4n").valueOf()).to.be.closeTo(1.1, 0.01);
+					expect(new TimeClass(context, "@8n").valueOf()).to.be.closeTo(0.85, 0.01);
+				});
+			}, 0.7);
+		});
+	});
+
+	context("Operators", () => {
+
+		it("can add the current time", () => {
+			const now = getContext().now();
+			expect(Time("+4").valueOf()).to.be.closeTo(4 + now, 0.02);
+			expect(Time("+2n").valueOf()).to.be.closeTo(1 + now, 0.02);
+		});
+
+		it("can quantize the value", () => {
+			expect(Time(4).quantize(3)).to.equal(3);
+			expect(Time(5).quantize(3)).to.equal(6);
+		});
+
+	});
+
+	context("Conversions", () => {
+
+		it("converts time into notation", () => {
+			return Offline(() => {
+				expect(Time("4n").toNotation()).to.equal("4n");
+				expect(Time(1.5).toNotation()).to.equal("2n.");
+				expect(Time(0).toNotation()).to.equal("0");
+				expect(Time("1:2:3").toNotation()).to.equal("1m");
+				expect(Time(Time("2n").valueOf() + Time("4n").valueOf()).toNotation()).to.equal("2n.");
+			});
+		});
+
+		it("converts time into milliseconds", () => {
+			expect(Time(2).toMilliseconds()).to.equal(2000);
+			expect(Time("4n").toMilliseconds()).to.equal(500);
+		});
+
+		it("converts time into samples", () => {
+			expect(Time(2).toSamples()).to.equal(2 * getContext().sampleRate);
+		});
+
+		it("converts time into frequency", () => {
+			expect(Time(2).toFrequency()).to.equal(0.5);
+		});
+
+		it("converts time into ticks", () => {
+			return Offline(({ transport }) => {
+				expect(Time("2n").toTicks()).to.equal(2 * transport.PPQ);
+				// floating point checks
+				const bpmOrig = transport.bpm.value;
+				transport.bpm.value = 100;
+				expect(Time("0:1:3").toTicks()).to.equal(1.75 * transport.PPQ);
+				transport.bpm.value = bpmOrig;
+			});
+		});
+
+		it("converts time into BarsBeatsSixteenths", () => {
+			return Offline(({ transport }) => {
+				expect(Time("3:1:3").toBarsBeatsSixteenths()).to.equal("3:1:3");
+				expect(Time(2).toBarsBeatsSixteenths()).to.equal("1:0:0");
+				// trailing zero removal test
+				transport.bpm.value = 100;
+				expect(Time("0:1:3").toBarsBeatsSixteenths()).to.equal("0:1:3");
+				expect(Time("14:0:0").toBarsBeatsSixteenths()).to.equal("14:0:0");
+				expect(Time("15:0:0").toBarsBeatsSixteenths()).to.equal("15:0:0");
+				transport.bpm.value = 90;
+				expect(Time("100:0:0").toBarsBeatsSixteenths()).to.equal("100:0:0");
+			});
+		});
+
+	});
+
+});