tone 14.8.27

package/build/esm/index.js

@@ -0,0 +1,102 @@
+export { getContext, setContext } from "./core/Global";
+export * from "./classes";
+export * from "./version";
+import { getContext } from "./core/Global";
+import { ToneAudioBuffer } from "./core/context/ToneAudioBuffer";
+export { start } from "./core/Global";
+export { supported } from "./core/context/AudioContext";
+/**
+ * The current audio context time of the global [[Context]].
+ * See [[Context.now]]
+ * @category Core
+ */
+export function now() {
+    return getContext().now();
+}
+/**
+ * The current audio context time of the global [[Context]] without the [[Context.lookAhead]]
+ * See [[Context.immediate]]
+ * @category Core
+ */
+export function immediate() {
+    return getContext().immediate();
+}
+/**
+ * The Transport object belonging to the global Tone.js Context.
+ * See [[Transport]]
+ * @category Core
+ */
+export const Transport = getContext().transport;
+/**
+ * The Transport object belonging to the global Tone.js Context.
+ * See [[Transport]]
+ * @category Core
+ */
+export function getTransport() {
+    return getContext().transport;
+}
+/**
+ * The Destination (output) belonging to the global Tone.js Context.
+ * See [[Destination]]
+ * @category Core
+ */
+export const Destination = getContext().destination;
+/**
+ * @deprecated Use [[Destination]]
+ */
+export const Master = getContext().destination;
+/**
+ * The Destination (output) belonging to the global Tone.js Context.
+ * See [[Destination]]
+ * @category Core
+ */
+export function getDestination() {
+    return getContext().destination;
+}
+/**
+ * The [[Listener]] belonging to the global Tone.js Context.
+ * @category Core
+ */
+export const Listener = getContext().listener;
+/**
+ * The [[Listener]] belonging to the global Tone.js Context.
+ * @category Core
+ */
+export function getListener() {
+    return getContext().listener;
+}
+/**
+ * Draw is used to synchronize the draw frame with the Transport's callbacks.
+ * See [[Draw]]
+ * @category Core
+ */
+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 [[Draw]]
+ * @category Core
+ */
+export function getDraw() {
+    return getContext().draw;
+}
+/**
+ * A reference to the global context
+ * See [[Context]]
+ */
+export const context = getContext();
+/**
+ * Promise which resolves when all of the loading promises are resolved.
+ * Alias for static [[ToneAudioBuffer.loaded]] method.
+ * @category Core
+ */
+export function loaded() {
+    return ToneAudioBuffer.loaded();
+}
+// this fills in name changes from 13.x to 14.x
+import { ToneAudioBuffers } from "./core/context/ToneAudioBuffers";
+import { ToneBufferSource } from "./source/buffer/ToneBufferSource";
+export const Buffer = ToneAudioBuffer;
+export const Buffers = ToneAudioBuffers;
+export const BufferSource = ToneBufferSource;
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../Tone/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACvD,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD;;;;GAIG;AACH,MAAM,UAAU,GAAG;IAClB,OAAO,UAAU,EAAE,CAAC,GAAG,EAAE,CAAC;AAC3B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS;IACxB,OAAO,UAAU,EAAE,CAAC,SAAS,EAAE,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,EAAE,CAAC,SAAS,CAAC;AAEhD;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC3B,OAAO,UAAU,EAAE,CAAC,SAAS,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,EAAE,CAAC,WAAW,CAAC;AAEpD;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,WAAW,CAAC;AAE/C;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC7B,OAAO,UAAU,EAAE,CAAC,WAAW,CAAC;AACjC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAU,EAAE,CAAC,QAAQ,CAAC;AAE9C;;;GAGG;AACH,MAAM,UAAU,WAAW;IAC1B,OAAO,UAAU,EAAE,CAAC,QAAQ,CAAC;AAC9B,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,UAAU,EAAE,CAAC,IAAI,CAAC;AAEtC;;;;;GAKG;AACH,MAAM,UAAU,OAAO;IACtB,OAAO,UAAU,EAAE,CAAC,IAAI,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;AAEpC;;;;GAIG;AACH,MAAM,UAAU,MAAM;IACrB,OAAO,eAAe,CAAC,MAAM,EAAE,CAAC;AACjC,CAAC;AAED,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,MAAM,CAAC,MAAM,MAAM,GAA2B,eAAe,CAAC;AAC9D,MAAM,CAAC,MAAM,OAAO,GAA4B,gBAAgB,CAAC;AACjE,MAAM,CAAC,MAAM,YAAY,GAA4B,gBAAgB,CAAC"}

package/build/esm/instrument/AMSynth.d.ts

@@ -0,0 +1,25 @@
+import { RecursivePartial } from "../core/util/Interface";
+import { ModulationSynth, ModulationSynthOptions } from "./ModulationSynth";
+export declare type AMSynthOptions = ModulationSynthOptions;
+/**
+ * AMSynth uses the output of one Tone.Synth to modulate the
+ * amplitude of another Tone.Synth. The harmonicity (the ratio between
+ * the two signals) affects the timbre of the output signal greatly.
+ * Read more about Amplitude Modulation Synthesis on
+ * [SoundOnSound](https://web.archive.org/web/20160404103653/http://www.soundonsound.com:80/sos/mar00/articles/synthsecrets.htm).
+ *
+ * @example
+ * const synth = new Tone.AMSynth().toDestination();
+ * synth.triggerAttackRelease("C4", "4n");
+ *
+ * @category Instrument
+ */
+export declare class AMSynth extends ModulationSynth<AMSynthOptions> {
+    readonly name: string;
+    /**
+     * Scale the oscillator from -1,1 to 0-1
+     */
+    private _modulationScale;
+    constructor(options?: RecursivePartial<AMSynthOptions>);
+    dispose(): this;
+}

package/build/esm/instrument/AMSynth.js

@@ -0,0 +1,37 @@
+import { AudioToGain } from "../signal/AudioToGain";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { ModulationSynth } from "./ModulationSynth";
+/**
+ * AMSynth uses the output of one Tone.Synth to modulate the
+ * amplitude of another Tone.Synth. The harmonicity (the ratio between
+ * the two signals) affects the timbre of the output signal greatly.
+ * Read more about Amplitude Modulation Synthesis on
+ * [SoundOnSound](https://web.archive.org/web/20160404103653/http://www.soundonsound.com:80/sos/mar00/articles/synthsecrets.htm).
+ *
+ * @example
+ * const synth = new Tone.AMSynth().toDestination();
+ * synth.triggerAttackRelease("C4", "4n");
+ *
+ * @category Instrument
+ */
+export class AMSynth extends ModulationSynth {
+    constructor() {
+        super(optionsFromArguments(AMSynth.getDefaults(), arguments));
+        this.name = "AMSynth";
+        this._modulationScale = new AudioToGain({
+            context: this.context,
+        });
+        // control the two voices frequency
+        this.frequency.connect(this._carrier.frequency);
+        this.frequency.chain(this.harmonicity, this._modulator.frequency);
+        this.detune.fan(this._carrier.detune, this._modulator.detune);
+        this._modulator.chain(this._modulationScale, this._modulationNode.gain);
+        this._carrier.chain(this._modulationNode, this.output);
+    }
+    dispose() {
+        super.dispose();
+        this._modulationScale.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=AMSynth.js.map

package/build/esm/instrument/AMSynth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AMSynth.js","sourceRoot":"","sources":["../../../Tone/instrument/AMSynth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAC;AAI5E;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,OAAQ,SAAQ,eAA+B;IAU3D;QACC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QATtD,SAAI,GAAW,SAAS,CAAC;QAWjC,IAAI,CAAC,gBAAgB,GAAG,IAAI,WAAW,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;QAEH,mCAAmC;QACnC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACxE,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/instrument/DuoSynth.d.ts

@@ -0,0 +1,72 @@
+import { Monophonic, MonophonicOptions } from "./Monophonic";
+import { MonoSynth, MonoSynthOptions } from "./MonoSynth";
+import { Signal } from "../signal/Signal";
+import { RecursivePartial } from "../core/util/Interface";
+import { Frequency, NormalRange, Positive, Seconds, Time } from "../core/type/Units";
+import { Param } from "../core/context/Param";
+export interface DuoSynthOptions extends MonophonicOptions {
+    voice0: Omit<MonoSynthOptions, keyof MonophonicOptions>;
+    voice1: Omit<MonoSynthOptions, keyof MonophonicOptions>;
+    harmonicity: Positive;
+    vibratoRate: Frequency;
+    vibratoAmount: Positive;
+}
+/**
+ * DuoSynth is a monophonic synth composed of two [[MonoSynths]] run in parallel with control over the
+ * frequency ratio between the two voices and vibrato effect.
+ * @example
+ * const duoSynth = new Tone.DuoSynth().toDestination();
+ * duoSynth.triggerAttackRelease("C4", "2n");
+ * @category Instrument
+ */
+export declare class DuoSynth extends Monophonic<DuoSynthOptions> {
+    readonly name: string;
+    readonly frequency: Signal<"frequency">;
+    readonly detune: Signal<"cents">;
+    /**
+     * the first voice
+     */
+    readonly voice0: MonoSynth;
+    /**
+     * the second voice
+     */
+    readonly voice1: MonoSynth;
+    /**
+     * The amount of vibrato
+     */
+    vibratoAmount: Param<"normalRange">;
+    /**
+     * the vibrato frequency
+     */
+    vibratoRate: Signal<"frequency">;
+    /**
+     * Harmonicity is the ratio between the two voices. A harmonicity of
+     * 1 is no change. Harmonicity = 2 means a change of an octave.
+     * @example
+     * const duoSynth = new Tone.DuoSynth().toDestination();
+     * duoSynth.triggerAttackRelease("C4", "2n");
+     * // pitch voice1 an octave below voice0
+     * duoSynth.harmonicity.value = 0.5;
+     */
+    harmonicity: Signal<"positive">;
+    /**
+     * The vibrato LFO.
+     */
+    private _vibrato;
+    /**
+     * the vibrato gain
+     */
+    private _vibratoGain;
+    constructor(options?: RecursivePartial<DuoSynthOptions>);
+    getLevelAtTime(time: Time): NormalRange;
+    static getDefaults(): DuoSynthOptions;
+    /**
+     * Trigger the attack portion of the note
+     */
+    protected _triggerEnvelopeAttack(time: Seconds, velocity: number): void;
+    /**
+     * Trigger the release portion of the note
+     */
+    protected _triggerEnvelopeRelease(time: Seconds): this;
+    dispose(): this;
+}

package/build/esm/instrument/DuoSynth.js

@@ -0,0 +1,140 @@
+import { Monophonic } from "./Monophonic";
+import { MonoSynth } from "./MonoSynth";
+import { Signal } from "../signal/Signal";
+import { readOnly } from "../core/util/Interface";
+import { LFO } from "../source/oscillator/LFO";
+import { Gain, } from "../core/context/Gain";
+import { Multiply } from "../signal/Multiply";
+import { deepMerge, omitFromObject, optionsFromArguments } from "../core/util/Defaults";
+/**
+ * DuoSynth is a monophonic synth composed of two [[MonoSynths]] run in parallel with control over the
+ * frequency ratio between the two voices and vibrato effect.
+ * @example
+ * const duoSynth = new Tone.DuoSynth().toDestination();
+ * duoSynth.triggerAttackRelease("C4", "2n");
+ * @category Instrument
+ */
+export class DuoSynth extends Monophonic {
+    constructor() {
+        super(optionsFromArguments(DuoSynth.getDefaults(), arguments));
+        this.name = "DuoSynth";
+        const options = optionsFromArguments(DuoSynth.getDefaults(), arguments);
+        this.voice0 = new MonoSynth(Object.assign(options.voice0, {
+            context: this.context,
+            onsilence: () => this.onsilence(this)
+        }));
+        this.voice1 = new MonoSynth(Object.assign(options.voice1, {
+            context: this.context,
+        }));
+        this.harmonicity = new Multiply({
+            context: this.context,
+            units: "positive",
+            value: options.harmonicity,
+        });
+        this._vibrato = new LFO({
+            frequency: options.vibratoRate,
+            context: this.context,
+            min: -50,
+            max: 50
+        });
+        // start the vibrato immediately
+        this._vibrato.start();
+        this.vibratoRate = this._vibrato.frequency;
+        this._vibratoGain = new Gain({
+            context: this.context,
+            units: "normalRange",
+            gain: options.vibratoAmount
+        });
+        this.vibratoAmount = this._vibratoGain.gain;
+        this.frequency = new Signal({
+            context: this.context,
+            units: "frequency",
+            value: 440
+        });
+        this.detune = new Signal({
+            context: this.context,
+            units: "cents",
+            value: options.detune
+        });
+        // control the two voices frequency
+        this.frequency.connect(this.voice0.frequency);
+        this.frequency.chain(this.harmonicity, this.voice1.frequency);
+        this._vibrato.connect(this._vibratoGain);
+        this._vibratoGain.fan(this.voice0.detune, this.voice1.detune);
+        this.detune.fan(this.voice0.detune, this.voice1.detune);
+        this.voice0.connect(this.output);
+        this.voice1.connect(this.output);
+        readOnly(this, ["voice0", "voice1", "frequency", "vibratoAmount", "vibratoRate"]);
+    }
+    getLevelAtTime(time) {
+        time = this.toSeconds(time);
+        return this.voice0.envelope.getValueAtTime(time) + this.voice1.envelope.getValueAtTime(time);
+    }
+    static getDefaults() {
+        return deepMerge(Monophonic.getDefaults(), {
+            vibratoAmount: 0.5,
+            vibratoRate: 5,
+            harmonicity: 1.5,
+            voice0: deepMerge(omitFromObject(MonoSynth.getDefaults(), Object.keys(Monophonic.getDefaults())), {
+                filterEnvelope: {
+                    attack: 0.01,
+                    decay: 0.0,
+                    sustain: 1,
+                    release: 0.5
+                },
+                envelope: {
+                    attack: 0.01,
+                    decay: 0.0,
+                    sustain: 1,
+                    release: 0.5
+                }
+            }),
+            voice1: deepMerge(omitFromObject(MonoSynth.getDefaults(), Object.keys(Monophonic.getDefaults())), {
+                filterEnvelope: {
+                    attack: 0.01,
+                    decay: 0.0,
+                    sustain: 1,
+                    release: 0.5
+                },
+                envelope: {
+                    attack: 0.01,
+                    decay: 0.0,
+                    sustain: 1,
+                    release: 0.5
+                }
+            }),
+        });
+    }
+    /**
+     * Trigger the attack portion of the note
+     */
+    _triggerEnvelopeAttack(time, velocity) {
+        // @ts-ignore
+        this.voice0._triggerEnvelopeAttack(time, velocity);
+        // @ts-ignore
+        this.voice1._triggerEnvelopeAttack(time, velocity);
+    }
+    /**
+     * Trigger the release portion of the note
+     */
+    _triggerEnvelopeRelease(time) {
+        // @ts-ignore
+        this.voice0._triggerEnvelopeRelease(time);
+        // @ts-ignore
+        this.voice1._triggerEnvelopeRelease(time);
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this.voice0.dispose();
+        this.voice1.dispose();
+        this.frequency.dispose();
+        this.detune.dispose();
+        this._vibrato.dispose();
+        this.vibratoRate.dispose();
+        this._vibratoGain.dispose();
+        this.harmonicity.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=DuoSynth.js.map

package/build/esm/instrument/DuoSynth.js.map

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

package/build/esm/instrument/FMSynth.d.ts

@@ -0,0 +1,31 @@
+import { Positive } from "../core/type/Units";
+import { RecursivePartial } from "../core/util/Interface";
+import { Multiply } from "../signal/Multiply";
+import { ModulationSynth, ModulationSynthOptions } from "./ModulationSynth";
+export interface FMSynthOptions extends ModulationSynthOptions {
+    modulationIndex: Positive;
+}
+/**
+ * FMSynth is composed of two Tone.Synths where one Tone.Synth modulates
+ * the frequency of a second Tone.Synth. A lot of spectral content
+ * can be explored using the modulationIndex parameter. Read more about
+ * frequency modulation synthesis on Sound On Sound: [Part 1](https://web.archive.org/web/20160403123704/http://www.soundonsound.com/sos/apr00/articles/synthsecrets.htm), [Part 2](https://web.archive.org/web/20160403115835/http://www.soundonsound.com/sos/may00/articles/synth.htm).
+ *
+ * @example
+ * const fmSynth = new Tone.FMSynth().toDestination();
+ * fmSynth.triggerAttackRelease("C5", "4n");
+ *
+ * @category Instrument
+ */
+export declare class FMSynth extends ModulationSynth<FMSynthOptions> {
+    readonly name: string;
+    /**
+     * The modulation index which essentially the depth or amount of the modulation. It is the
+     * ratio of the frequency of the modulating signal (mf) to the amplitude of the
+     * modulating signal (ma) -- as in ma/mf.
+     */
+    readonly modulationIndex: Multiply;
+    constructor(options?: RecursivePartial<FMSynthOptions>);
+    static getDefaults(): FMSynthOptions;
+    dispose(): this;
+}

package/build/esm/instrument/FMSynth.js

@@ -0,0 +1,45 @@
+import { optionsFromArguments } from "../core/util/Defaults";
+import { Multiply } from "../signal/Multiply";
+import { ModulationSynth } from "./ModulationSynth";
+/**
+ * FMSynth is composed of two Tone.Synths where one Tone.Synth modulates
+ * the frequency of a second Tone.Synth. A lot of spectral content
+ * can be explored using the modulationIndex parameter. Read more about
+ * frequency modulation synthesis on Sound On Sound: [Part 1](https://web.archive.org/web/20160403123704/http://www.soundonsound.com/sos/apr00/articles/synthsecrets.htm), [Part 2](https://web.archive.org/web/20160403115835/http://www.soundonsound.com/sos/may00/articles/synth.htm).
+ *
+ * @example
+ * const fmSynth = new Tone.FMSynth().toDestination();
+ * fmSynth.triggerAttackRelease("C5", "4n");
+ *
+ * @category Instrument
+ */
+export class FMSynth extends ModulationSynth {
+    constructor() {
+        super(optionsFromArguments(FMSynth.getDefaults(), arguments));
+        this.name = "FMSynth";
+        const options = optionsFromArguments(FMSynth.getDefaults(), arguments);
+        this.modulationIndex = new Multiply({
+            context: this.context,
+            value: options.modulationIndex,
+        });
+        // control the two voices frequency
+        this.frequency.connect(this._carrier.frequency);
+        this.frequency.chain(this.harmonicity, this._modulator.frequency);
+        this.frequency.chain(this.modulationIndex, this._modulationNode);
+        this.detune.fan(this._carrier.detune, this._modulator.detune);
+        this._modulator.connect(this._modulationNode.gain);
+        this._modulationNode.connect(this._carrier.frequency);
+        this._carrier.connect(this.output);
+    }
+    static getDefaults() {
+        return Object.assign(ModulationSynth.getDefaults(), {
+            modulationIndex: 10,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this.modulationIndex.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=FMSynth.js.map

package/build/esm/instrument/FMSynth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FMSynth.js","sourceRoot":"","sources":["../../../Tone/instrument/FMSynth.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAA0B,MAAM,mBAAmB,CAAC;AAM5E;;;;;;;;;;;GAWG;AAEH,MAAM,OAAO,OAAQ,SAAQ,eAA+B;IAW3D;QACC,KAAK,CAAC,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;QAXtD,SAAI,GAAW,SAAS,CAAC;QAYjC,MAAM,OAAO,GAAG,oBAAoB,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,SAAS,CAAC,CAAC;QAEvE,IAAI,CAAC,eAAe,GAAG,IAAI,QAAQ,CAAC;YACnC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,OAAO,CAAC,eAAe;SAC9B,CAAC,CAAC;QAEH,mCAAmC;QACnC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAChD,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QAC9D,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,EAAE;YACnD,eAAe,EAAE,EAAE;SACnB,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/instrument/Instrument.d.ts

@@ -0,0 +1,100 @@
+import { Param } from "../core/context/Param";
+import { OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+import { Decibels, Frequency, NormalRange, Time } from "../core/type/Units";
+export interface InstrumentOptions extends ToneAudioNodeOptions {
+    volume: Decibels;
+}
+/**
+ * Base-class for all instruments
+ */
+export declare abstract class Instrument<Options extends InstrumentOptions> extends ToneAudioNode<Options> {
+    /**
+     * The output and volume triming node
+     */
+    private _volume;
+    output: OutputNode;
+    /**
+     * The instrument only has an output
+     */
+    input: undefined;
+    /**
+     * The volume of the output in decibels.
+     * @example
+     * const amSynth = new Tone.AMSynth().toDestination();
+     * amSynth.volume.value = -6;
+     * amSynth.triggerAttackRelease("G#3", 0.2);
+     */
+    volume: Param<"decibels">;
+    /**
+     * Keep track of all events scheduled to the transport
+     * when the instrument is 'synced'
+     */
+    private _scheduledEvents;
+    /**
+     * If the instrument is currently synced
+     */
+    private _synced;
+    constructor(options?: Partial<InstrumentOptions>);
+    static getDefaults(): InstrumentOptions;
+    /**
+     * Sync the instrument to the Transport. All subsequent calls of
+     * [[triggerAttack]] and [[triggerRelease]] will be scheduled along the transport.
+     * @example
+     * const fmSynth = new Tone.FMSynth().toDestination();
+     * fmSynth.volume.value = -6;
+     * fmSynth.sync();
+     * // schedule 3 notes when the transport first starts
+     * fmSynth.triggerAttackRelease("C4", "8n", 0);
+     * fmSynth.triggerAttackRelease("E4", "8n", "8n");
+     * fmSynth.triggerAttackRelease("G4", "8n", "4n");
+     * // start the transport to hear the notes
+     * Tone.Transport.start();
+     */
+    sync(): this;
+    /**
+     * set _sync
+     */
+    protected _syncState(): boolean;
+    /**
+     * Wrap the given method so that it can be synchronized
+     * @param method Which method to wrap and sync
+     * @param  timePosition What position the time argument appears in
+     */
+    protected _syncMethod(method: string, timePosition: number): void;
+    /**
+     * Unsync the instrument from the Transport
+     */
+    unsync(): this;
+    /**
+     * Trigger the attack and then the release after the duration.
+     * @param  note     The note to trigger.
+     * @param  duration How long the note should be held for before
+     *                         triggering the release. This value must be greater than 0.
+     * @param time  When the note should be triggered.
+     * @param  velocity The velocity the note should be triggered at.
+     * @example
+     * const synth = new Tone.Synth().toDestination();
+     * // trigger "C4" for the duration of an 8th note
+     * synth.triggerAttackRelease("C4", "8n");
+     */
+    triggerAttackRelease(note: Frequency, duration: Time, time?: Time, velocity?: NormalRange): this;
+    /**
+     * Start the instrument's note.
+     * @param note the note to trigger
+     * @param time the time to trigger the note
+     * @param velocity the velocity to trigger the note (between 0-1)
+     */
+    abstract triggerAttack(note: Frequency, time?: Time, velocity?: NormalRange): this;
+    private _original_triggerAttack;
+    /**
+     * Trigger the release phase of the current note.
+     * @param time when to trigger the release
+     */
+    abstract triggerRelease(...args: any[]): this;
+    private _original_triggerRelease;
+    /**
+     * clean up
+     * @returns {Instrument} this
+     */
+    dispose(): this;
+}