tone 14.8.27

package/build/esm/core/context/ToneWithContext.js

@@ -0,0 +1,170 @@
+import { getContext } from "../Global";
+import { Tone } from "../Tone";
+import { FrequencyClass } from "../type/Frequency";
+import { TimeClass } from "../type/Time";
+import { TransportTimeClass } from "../type/TransportTime";
+import { getDefaultsFromInstance, optionsFromArguments } from "../util/Defaults";
+import { isArray, isBoolean, isDefined, isNumber, isString, isUndef } from "../util/TypeCheck";
+/**
+ * The Base class for all nodes that have an AudioContext.
+ */
+export class ToneWithContext extends Tone {
+    constructor() {
+        super();
+        const options = optionsFromArguments(ToneWithContext.getDefaults(), arguments, ["context"]);
+        if (this.defaultContext) {
+            this.context = this.defaultContext;
+        }
+        else {
+            this.context = options.context;
+        }
+    }
+    static getDefaults() {
+        return {
+            context: getContext(),
+        };
+    }
+    /**
+     * Return the current time of the Context clock plus the lookAhead.
+     * @example
+     * setInterval(() => {
+     * 	console.log(Tone.now());
+     * }, 100);
+     */
+    now() {
+        return this.context.currentTime + this.context.lookAhead;
+    }
+    /**
+     * Return the current time of the Context clock without any lookAhead.
+     * @example
+     * setInterval(() => {
+     * 	console.log(Tone.immediate());
+     * }, 100);
+     */
+    immediate() {
+        return this.context.currentTime;
+    }
+    /**
+     * The duration in seconds of one sample.
+     * @example
+     * console.log(Tone.Transport.sampleTime);
+     */
+    get sampleTime() {
+        return 1 / this.context.sampleRate;
+    }
+    /**
+     * The number of seconds of 1 processing block (128 samples)
+     * @example
+     * console.log(Tone.Destination.blockTime);
+     */
+    get blockTime() {
+        return 128 / this.context.sampleRate;
+    }
+    /**
+     * Convert the incoming time to seconds.
+     * This is calculated against the current [[Tone.Transport]] bpm
+     * @example
+     * const gain = new Tone.Gain();
+     * setInterval(() => console.log(gain.toSeconds("4n")), 100);
+     * // ramp the tempo to 60 bpm over 30 seconds
+     * Tone.getTransport().bpm.rampTo(60, 30);
+     */
+    toSeconds(time) {
+        return new TimeClass(this.context, time).toSeconds();
+    }
+    /**
+     * Convert the input to a frequency number
+     * @example
+     * const gain = new Tone.Gain();
+     * console.log(gain.toFrequency("4n"));
+     */
+    toFrequency(freq) {
+        return new FrequencyClass(this.context, freq).toFrequency();
+    }
+    /**
+     * Convert the input time into ticks
+     * @example
+     * const gain = new Tone.Gain();
+     * console.log(gain.toTicks("4n"));
+     */
+    toTicks(time) {
+        return new TransportTimeClass(this.context, time).toTicks();
+    }
+    //-------------------------------------
+    // 	GET/SET
+    //-------------------------------------
+    /**
+     * Get a subset of the properties which are in the partial props
+     */
+    _getPartialProperties(props) {
+        const options = this.get();
+        // remove attributes from the prop that are not in the partial
+        Object.keys(options).forEach(name => {
+            if (isUndef(props[name])) {
+                delete options[name];
+            }
+        });
+        return options;
+    }
+    /**
+     * Get the object's attributes.
+     * @example
+     * const osc = new Tone.Oscillator();
+     * console.log(osc.get());
+     */
+    get() {
+        const defaults = getDefaultsFromInstance(this);
+        Object.keys(defaults).forEach(attribute => {
+            if (Reflect.has(this, attribute)) {
+                const member = this[attribute];
+                if (isDefined(member) && isDefined(member.value) && isDefined(member.setValueAtTime)) {
+                    defaults[attribute] = member.value;
+                }
+                else if (member instanceof ToneWithContext) {
+                    defaults[attribute] = member._getPartialProperties(defaults[attribute]);
+                    // otherwise make sure it's a serializable type
+                }
+                else if (isArray(member) || isNumber(member) || isString(member) || isBoolean(member)) {
+                    defaults[attribute] = member;
+                }
+                else {
+                    // remove all undefined and unserializable attributes
+                    delete defaults[attribute];
+                }
+            }
+        });
+        return defaults;
+    }
+    /**
+     * Set multiple properties at once with an object.
+     * @example
+     * const filter = new Tone.Filter().toDestination();
+     * // set values using an object
+     * filter.set({
+     * 	frequency: "C6",
+     * 	type: "highpass"
+     * });
+     * const player = new Tone.Player("https://tonejs.github.io/audio/berklee/Analogsynth_octaves_highmid.mp3").connect(filter);
+     * player.autostart = true;
+     */
+    set(props) {
+        Object.keys(props).forEach(attribute => {
+            if (Reflect.has(this, attribute) && isDefined(this[attribute])) {
+                if (this[attribute] && isDefined(this[attribute].value) && isDefined(this[attribute].setValueAtTime)) {
+                    // small optimization
+                    if (this[attribute].value !== props[attribute]) {
+                        this[attribute].value = props[attribute];
+                    }
+                }
+                else if (this[attribute] instanceof ToneWithContext) {
+                    this[attribute].set(props[attribute]);
+                }
+                else {
+                    this[attribute] = props[attribute];
+                }
+            }
+        });
+        return this;
+    }
+}
+//# sourceMappingURL=ToneWithContext.js.map

package/build/esm/core/context/ToneWithContext.js.map

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

package/build/esm/core/index.d.ts

@@ -0,0 +1,28 @@
+export * from "./clock/Clock";
+export * from "./context/Context";
+export * from "./context/BaseContext";
+export * from "./context/Delay";
+export * from "./context/Gain";
+export * from "./context/Offline";
+export * from "./context/OfflineContext";
+export * from "./context/Param";
+export * from "./context/ToneAudioBuffer";
+export * from "./context/ToneAudioBuffers";
+export * from "./context/ToneAudioNode";
+export * from "./type/Frequency";
+export * from "./type/Midi";
+export * from "./type/Time";
+export * from "./type/Ticks";
+export * from "./type/TransportTime";
+import "./util/Draw";
+export * from "./util/Emitter";
+export * from "./util/IntervalTimeline";
+export * from "./util/StateTimeline";
+export * from "./util/Timeline";
+export * from "./util/TypeCheck";
+export { dbToGain, gainToDb, intervalToFrequencyRatio, ftom, mtof } from "./type/Conversions";
+export { optionsFromArguments, defaultArg } from "./util/Defaults";
+import * as Unit from "./type/Units";
+export { Unit };
+import * as debug from "./util/Debug";
+export { debug };

package/build/esm/core/index.js

@@ -0,0 +1,33 @@
+export * from "./clock/Clock";
+// export * from "./clock/Transport";
+export * from "./context/Context";
+export * from "./context/BaseContext";
+export * from "./context/Delay";
+// export * from "./context/Destination";
+export * from "./context/Gain";
+export * from "./context/Offline";
+export * from "./context/OfflineContext";
+export * from "./context/Param";
+export * from "./context/ToneAudioBuffer";
+export * from "./context/ToneAudioBuffers";
+export * from "./context/ToneAudioNode";
+export * from "./type/Frequency";
+export * from "./type/Midi";
+export * from "./type/Time";
+export * from "./type/Ticks";
+export * from "./type/TransportTime";
+import "./util/Draw";
+export * from "./util/Emitter";
+export * from "./util/IntervalTimeline";
+export * from "./util/StateTimeline";
+export * from "./util/Timeline";
+export * from "./util/TypeCheck";
+export { dbToGain, gainToDb, intervalToFrequencyRatio, ftom, mtof } from "./type/Conversions";
+export { optionsFromArguments, defaultArg } from "./util/Defaults";
+// get the units and export them under the "Unit" namespace
+import * as Unit from "./type/Units";
+export { Unit };
+// export the debug stuff as Debug
+import * as debug from "./util/Debug";
+export { debug };
+//# sourceMappingURL=index.js.map

package/build/esm/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../Tone/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,qCAAqC;AAErC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,yCAAyC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AAExC,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AAErC,OAAO,aAAa,CAAC;AACrB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AAEjC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,wBAAwB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC9F,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEnE,2DAA2D;AAC3D,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,CAAC;AAEhB,kCAAkC;AAClC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/build/esm/core/type/Conversions.d.ts

@@ -0,0 +1,44 @@
+import { Decibels, GainFactor, Hertz, Interval, MidiNote, NormalRange } from "./Units";
+/**
+ * Equal power gain scale. Good for cross-fading.
+ * @param  percent (0-1)
+ */
+export declare function equalPowerScale(percent: NormalRange): number;
+/**
+ * Convert decibels into gain.
+ */
+export declare function dbToGain(db: Decibels): GainFactor;
+/**
+ * Convert gain to decibels.
+ */
+export declare function gainToDb(gain: GainFactor): Decibels;
+/**
+ * Convert an interval (in semitones) to a frequency ratio.
+ * @param interval the number of semitones above the base note
+ * @example
+ * Tone.intervalToFrequencyRatio(0); // 1
+ * Tone.intervalToFrequencyRatio(12); // 2
+ * Tone.intervalToFrequencyRatio(-12); // 0.5
+ */
+export declare function intervalToFrequencyRatio(interval: Interval): number;
+export declare function getA4(): Hertz;
+export declare function setA4(freq: Hertz): void;
+/**
+ * Convert a frequency value to a MIDI note.
+ * @param frequency The value to frequency value to convert.
+ * @example
+ * Tone.ftom(440); // returns 69
+ */
+export declare function ftom(frequency: Hertz): MidiNote;
+/**
+ * Convert a frequency to a floating point midi value
+ */
+export declare function ftomf(frequency: Hertz): number;
+/**
+ * Convert a MIDI note to frequency value.
+ * @param  midi The midi number to convert.
+ * @return The corresponding frequency value
+ * @example
+ * Tone.mtof(69); // 440
+ */
+export declare function mtof(midi: MidiNote): Hertz;

package/build/esm/core/type/Conversions.js

@@ -0,0 +1,68 @@
+/**
+ * Equal power gain scale. Good for cross-fading.
+ * @param  percent (0-1)
+ */
+export function equalPowerScale(percent) {
+    const piFactor = 0.5 * Math.PI;
+    return Math.sin(percent * piFactor);
+}
+/**
+ * Convert decibels into gain.
+ */
+export function dbToGain(db) {
+    return Math.pow(10, db / 20);
+}
+/**
+ * Convert gain to decibels.
+ */
+export function gainToDb(gain) {
+    return 20 * (Math.log(gain) / Math.LN10);
+}
+/**
+ * Convert an interval (in semitones) to a frequency ratio.
+ * @param interval the number of semitones above the base note
+ * @example
+ * Tone.intervalToFrequencyRatio(0); // 1
+ * Tone.intervalToFrequencyRatio(12); // 2
+ * Tone.intervalToFrequencyRatio(-12); // 0.5
+ */
+export function intervalToFrequencyRatio(interval) {
+    return Math.pow(2, (interval / 12));
+}
+/**
+ * The Global [concert tuning pitch](https://en.wikipedia.org/wiki/Concert_pitch) which is used
+ * to generate all the other pitch values from notes. A4's values in Hertz.
+ */
+let A4 = 440;
+export function getA4() {
+    return A4;
+}
+export function setA4(freq) {
+    A4 = freq;
+}
+/**
+ * Convert a frequency value to a MIDI note.
+ * @param frequency The value to frequency value to convert.
+ * @example
+ * Tone.ftom(440); // returns 69
+ */
+export function ftom(frequency) {
+    return Math.round(ftomf(frequency));
+}
+/**
+ * Convert a frequency to a floating point midi value
+ */
+export function ftomf(frequency) {
+    return 69 + 12 * Math.log2(frequency / A4);
+}
+/**
+ * Convert a MIDI note to frequency value.
+ * @param  midi The midi number to convert.
+ * @return The corresponding frequency value
+ * @example
+ * Tone.mtof(69); // 440
+ */
+export function mtof(midi) {
+    return A4 * Math.pow(2, (midi - 69) / 12);
+}
+//# sourceMappingURL=Conversions.js.map

package/build/esm/core/type/Conversions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Conversions.js","sourceRoot":"","sources":["../../../../Tone/core/type/Conversions.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,OAAoB;IACnD,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC;IAC/B,OAAO,IAAI,CAAC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAY;IACpC,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAgB;IACxC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAkB;IAC1D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,IAAI,EAAE,GAAU,GAAG,CAAC;AAEpB,MAAM,UAAU,KAAK;IACpB,OAAO,EAAE,CAAC;AACX,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAW;IAChC,EAAE,GAAG,IAAI,CAAC;AACX,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,IAAI,CAAC,SAAgB;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAa,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,SAAgB;IACrC,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,IAAc;IAClC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/build/esm/core/type/Frequency.d.ts

@@ -0,0 +1,101 @@
+import { TimeClass } from "./Time";
+import { TimeBaseUnit, TimeExpression, TimeValue } from "./TimeBase";
+import { Frequency, Hertz, Interval, MidiNote, Note, Seconds, Ticks } from "./Units";
+export declare type FrequencyUnit = TimeBaseUnit | "midi";
+/**
+ * Frequency is a primitive type for encoding Frequency values.
+ * Eventually all time values are evaluated to hertz using the `valueOf` method.
+ * @example
+ * Tone.Frequency("C3"); // 261
+ * Tone.Frequency(38, "midi");
+ * Tone.Frequency("C3").transpose(4);
+ * @category Unit
+ */
+export declare class FrequencyClass<Type extends number = Hertz> extends TimeClass<Type, FrequencyUnit> {
+    readonly name: string;
+    readonly defaultUnits: FrequencyUnit;
+    /**
+     * The [concert tuning pitch](https://en.wikipedia.org/wiki/Concert_pitch) which is used
+     * to generate all the other pitch values from notes. A4's values in Hertz.
+     */
+    static get A4(): Hertz;
+    static set A4(freq: Hertz);
+    protected _getExpressions(): TimeExpression<Type>;
+    /**
+     * Transposes the frequency by the given number of semitones.
+     * @return  A new transposed frequency
+     * @example
+     * Tone.Frequency("A4").transpose(3); // "C5"
+     */
+    transpose(interval: Interval): FrequencyClass;
+    /**
+     * Takes an array of semitone intervals and returns
+     * an array of frequencies transposed by those intervals.
+     * @return  Returns an array of Frequencies
+     * @example
+     * Tone.Frequency("A4").harmonize([0, 3, 7]); // ["A4", "C5", "E5"]
+     */
+    harmonize(intervals: Interval[]): FrequencyClass[];
+    /**
+     * Return the value of the frequency as a MIDI note
+     * @example
+     * Tone.Frequency("C4").toMidi(); // 60
+     */
+    toMidi(): MidiNote;
+    /**
+     * Return the value of the frequency in Scientific Pitch Notation
+     * @example
+     * Tone.Frequency(69, "midi").toNote(); // "A4"
+     */
+    toNote(): Note;
+    /**
+     * Return the duration of one cycle in seconds.
+     */
+    toSeconds(): Seconds;
+    /**
+     * Return the duration of one cycle in ticks
+     */
+    toTicks(): Ticks;
+    /**
+     * With no arguments, return 0
+     */
+    protected _noArg(): Type;
+    /**
+     * Returns the value of a frequency in the current units
+     */
+    protected _frequencyToUnits(freq: Hertz): Type;
+    /**
+     * Returns the value of a tick in the current time units
+     */
+    protected _ticksToUnits(ticks: Ticks): Type;
+    /**
+     * Return the value of the beats in the current units
+     */
+    protected _beatsToUnits(beats: number): Type;
+    /**
+     * Returns the value of a second in the current units
+     */
+    protected _secondsToUnits(seconds: Seconds): Type;
+    /**
+     * Convert a MIDI note to frequency value.
+     * @param  midi The midi number to convert.
+     * @return The corresponding frequency value
+     */
+    static mtof(midi: MidiNote): Hertz;
+    /**
+     * Convert a frequency value to a MIDI note.
+     * @param frequency The value to frequency value to convert.
+     */
+    static ftom(frequency: Hertz): MidiNote;
+}
+/**
+ * Convert a value into a FrequencyClass object.
+ * @category Unit
+ * @example
+ * const midi = Tone.Frequency("C3").toMidi();
+ * console.log(midi);
+ * @example
+ * const hertz = Tone.Frequency(38, "midi").toFrequency();
+ * console.log(hertz);
+ */
+export declare function Frequency(value?: TimeValue | Frequency, units?: FrequencyUnit): FrequencyClass;

package/build/esm/core/type/Frequency.js

@@ -0,0 +1,225 @@
+import { getContext } from "../Global";
+import { intervalToFrequencyRatio, mtof } from "./Conversions";
+import { ftom, getA4, setA4 } from "./Conversions";
+import { TimeClass } from "./Time";
+/**
+ * Frequency is a primitive type for encoding Frequency values.
+ * Eventually all time values are evaluated to hertz using the `valueOf` method.
+ * @example
+ * Tone.Frequency("C3"); // 261
+ * Tone.Frequency(38, "midi");
+ * Tone.Frequency("C3").transpose(4);
+ * @category Unit
+ */
+export class FrequencyClass extends TimeClass {
+    constructor() {
+        super(...arguments);
+        this.name = "Frequency";
+        this.defaultUnits = "hz";
+    }
+    /**
+     * The [concert tuning pitch](https://en.wikipedia.org/wiki/Concert_pitch) which is used
+     * to generate all the other pitch values from notes. A4's values in Hertz.
+     */
+    static get A4() {
+        return getA4();
+    }
+    static set A4(freq) {
+        setA4(freq);
+    }
+    //-------------------------------------
+    // 	AUGMENT BASE EXPRESSIONS
+    //-------------------------------------
+    _getExpressions() {
+        return Object.assign({}, super._getExpressions(), {
+            midi: {
+                regexp: /^(\d+(?:\.\d+)?midi)/,
+                method(value) {
+                    if (this.defaultUnits === "midi") {
+                        return value;
+                    }
+                    else {
+                        return FrequencyClass.mtof(value);
+                    }
+                },
+            },
+            note: {
+                regexp: /^([a-g]{1}(?:b|#|x|bb)?)(-?[0-9]+)/i,
+                method(pitch, octave) {
+                    const index = noteToScaleIndex[pitch.toLowerCase()];
+                    const noteNumber = index + (parseInt(octave, 10) + 1) * 12;
+                    if (this.defaultUnits === "midi") {
+                        return noteNumber;
+                    }
+                    else {
+                        return FrequencyClass.mtof(noteNumber);
+                    }
+                },
+            },
+            tr: {
+                regexp: /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?/,
+                method(m, q, s) {
+                    let total = 1;
+                    if (m && m !== "0") {
+                        total *= this._beatsToUnits(this._getTimeSignature() * parseFloat(m));
+                    }
+                    if (q && q !== "0") {
+                        total *= this._beatsToUnits(parseFloat(q));
+                    }
+                    if (s && s !== "0") {
+                        total *= this._beatsToUnits(parseFloat(s) / 4);
+                    }
+                    return total;
+                },
+            },
+        });
+    }
+    //-------------------------------------
+    // 	EXPRESSIONS
+    //-------------------------------------
+    /**
+     * Transposes the frequency by the given number of semitones.
+     * @return  A new transposed frequency
+     * @example
+     * Tone.Frequency("A4").transpose(3); // "C5"
+     */
+    transpose(interval) {
+        return new FrequencyClass(this.context, this.valueOf() * intervalToFrequencyRatio(interval));
+    }
+    /**
+     * Takes an array of semitone intervals and returns
+     * an array of frequencies transposed by those intervals.
+     * @return  Returns an array of Frequencies
+     * @example
+     * Tone.Frequency("A4").harmonize([0, 3, 7]); // ["A4", "C5", "E5"]
+     */
+    harmonize(intervals) {
+        return intervals.map(interval => {
+            return this.transpose(interval);
+        });
+    }
+    //-------------------------------------
+    // 	UNIT CONVERSIONS
+    //-------------------------------------
+    /**
+     * Return the value of the frequency as a MIDI note
+     * @example
+     * Tone.Frequency("C4").toMidi(); // 60
+     */
+    toMidi() {
+        return ftom(this.valueOf());
+    }
+    /**
+     * Return the value of the frequency in Scientific Pitch Notation
+     * @example
+     * Tone.Frequency(69, "midi").toNote(); // "A4"
+     */
+    toNote() {
+        const freq = this.toFrequency();
+        const log = Math.log2(freq / FrequencyClass.A4);
+        let noteNumber = Math.round(12 * log) + 57;
+        const octave = Math.floor(noteNumber / 12);
+        if (octave < 0) {
+            noteNumber += -12 * octave;
+        }
+        const noteName = scaleIndexToNote[noteNumber % 12];
+        return noteName + octave.toString();
+    }
+    /**
+     * Return the duration of one cycle in seconds.
+     */
+    toSeconds() {
+        return 1 / super.toSeconds();
+    }
+    /**
+     * Return the duration of one cycle in ticks
+     */
+    toTicks() {
+        const quarterTime = this._beatsToUnits(1);
+        const quarters = this.valueOf() / quarterTime;
+        return Math.floor(quarters * this._getPPQ());
+    }
+    //-------------------------------------
+    // 	UNIT CONVERSIONS HELPERS
+    //-------------------------------------
+    /**
+     * With no arguments, return 0
+     */
+    _noArg() {
+        return 0;
+    }
+    /**
+     * Returns the value of a frequency in the current units
+     */
+    _frequencyToUnits(freq) {
+        return freq;
+    }
+    /**
+     * Returns the value of a tick in the current time units
+     */
+    _ticksToUnits(ticks) {
+        return 1 / ((ticks * 60) / (this._getBpm() * this._getPPQ()));
+    }
+    /**
+     * Return the value of the beats in the current units
+     */
+    _beatsToUnits(beats) {
+        return 1 / super._beatsToUnits(beats);
+    }
+    /**
+     * Returns the value of a second in the current units
+     */
+    _secondsToUnits(seconds) {
+        return 1 / seconds;
+    }
+    /**
+     * Convert a MIDI note to frequency value.
+     * @param  midi The midi number to convert.
+     * @return The corresponding frequency value
+     */
+    static mtof(midi) {
+        return mtof(midi);
+    }
+    /**
+     * Convert a frequency value to a MIDI note.
+     * @param frequency The value to frequency value to convert.
+     */
+    static ftom(frequency) {
+        return ftom(frequency);
+    }
+}
+//-------------------------------------
+// 	FREQUENCY CONVERSIONS
+//-------------------------------------
+/**
+ * Note to scale index.
+ * @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,
+};
+/**
+ * scale index to note (sharps)
+ * @hidden
+ */
+const scaleIndexToNote = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+/**
+ * Convert a value into a FrequencyClass object.
+ * @category Unit
+ * @example
+ * const midi = Tone.Frequency("C3").toMidi();
+ * console.log(midi);
+ * @example
+ * const hertz = Tone.Frequency(38, "midi").toFrequency();
+ * console.log(hertz);
+ */
+export function Frequency(value, units) {
+    return new FrequencyClass(getContext(), value, units);
+}
+//# sourceMappingURL=Frequency.js.map