tone 14.8.27

package/build/esm/core/clock/TransportEvent.js

@@ -0,0 +1,66 @@
+import { noOp } from "../util/Interface";
+/**
+ * TransportEvent is an internal class used by [[Transport]]
+ * to schedule events. Do no invoke this class directly, it is
+ * handled from within Tone.Transport.
+ */
+export class TransportEvent {
+    /**
+     * @param transport The transport object which the event belongs to
+     */
+    constructor(transport, opts) {
+        /**
+         * The unique id of the event
+         */
+        this.id = TransportEvent._eventId++;
+        /**
+         * The remaining value between the passed in time, and Math.floor(time).
+         * This value is later added back when scheduling to get sub-tick precision.
+         */
+        this._remainderTime = 0;
+        const options = Object.assign(TransportEvent.getDefaults(), opts);
+        this.transport = transport;
+        this.callback = options.callback;
+        this._once = options.once;
+        this.time = Math.floor(options.time);
+        this._remainderTime = options.time - this.time;
+    }
+    static getDefaults() {
+        return {
+            callback: noOp,
+            once: false,
+            time: 0,
+        };
+    }
+    /**
+     * Get the time and remainder time.
+     */
+    get floatTime() {
+        return this.time + this._remainderTime;
+    }
+    /**
+     * Invoke the event callback.
+     * @param  time  The AudioContext time in seconds of the event
+     */
+    invoke(time) {
+        if (this.callback) {
+            const tickDuration = this.transport.bpm.getDurationOfTicks(1, time);
+            this.callback(time + this._remainderTime * tickDuration);
+            if (this._once) {
+                this.transport.clear(this.id);
+            }
+        }
+    }
+    /**
+     * Clean up
+     */
+    dispose() {
+        this.callback = undefined;
+        return this;
+    }
+}
+/**
+ * Current ID counter
+ */
+TransportEvent._eventId = 0;
+//# sourceMappingURL=TransportEvent.js.map

package/build/esm/core/clock/TransportEvent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransportEvent.js","sourceRoot":"","sources":["../../../../Tone/core/clock/TransportEvent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAUzC;;;;GAIG;AACH,MAAM,OAAO,cAAc;IAiC1B;;OAEG;IACH,YAAY,SAAoB,EAAE,IAAoC;QA7BtE;;WAEG;QACH,OAAE,GAAW,cAAc,CAAC,QAAQ,EAAE,CAAC;QAiBvC;;;WAGG;QACO,mBAAc,GAAG,CAAC,CAAC;QAO5B,MAAM,OAAO,GAA0B,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,IAAI,CAAC,CAAC;QAEzF,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAChD,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO;YACN,QAAQ,EAAE,IAAI;YACd,IAAI,EAAE,KAAK;YACX,IAAI,EAAE,CAAC;SACP,CAAC;IACH,CAAC;IAOD;;OAEG;IACH,IAAc,SAAS;QACtB,OAAO,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC;IACxC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,IAAa;QACnB,IAAI,IAAI,CAAC,QAAQ,EAAE;YAClB,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YACpE,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,CAAC;YACzD,IAAI,IAAI,CAAC,KAAK,EAAE;gBACf,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;aAC9B;SACD;IACF,CAAC;IAED;;OAEG;IACH,OAAO;QACN,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,OAAO,IAAI,CAAC;IACb,CAAC;;AAhCD;;GAEG;AACY,uBAAQ,GAAG,CAAC,CAAC"}

package/build/esm/core/clock/TransportRepeatEvent.d.ts

@@ -0,0 +1,70 @@
+import { BaseContext } from "../context/BaseContext";
+import { Seconds, Ticks } from "../type/Units";
+import { TransportEvent, TransportEventOptions } from "./TransportEvent";
+declare type Transport = import("../clock/Transport").Transport;
+interface TransportRepeatEventOptions extends TransportEventOptions {
+    interval: Ticks;
+    duration: Ticks;
+}
+/**
+ * TransportRepeatEvent is an internal class used by Tone.Transport
+ * to schedule repeat events. This class should not be instantiated directly.
+ */
+export declare class TransportRepeatEvent extends TransportEvent {
+    /**
+     * When the event should stop repeating
+     */
+    private duration;
+    /**
+     * The interval of the repeated event
+     */
+    private _interval;
+    /**
+     * The ID of the current timeline event
+     */
+    private _currentId;
+    /**
+     * The ID of the next timeline event
+     */
+    private _nextId;
+    /**
+     * The time of the next event
+     */
+    private _nextTick;
+    /**
+     * a reference to the bound start method
+     */
+    private _boundRestart;
+    /**
+     * The audio context belonging to this event
+     */
+    protected context: BaseContext;
+    /**
+     * @param transport The transport object which the event belongs to
+     */
+    constructor(transport: Transport, opts: Partial<TransportRepeatEventOptions>);
+    static getDefaults(): TransportRepeatEventOptions;
+    /**
+     * Invoke the callback. Returns the tick time which
+     * the next event should be scheduled at.
+     * @param  time  The AudioContext time in seconds of the event
+     */
+    invoke(time: Seconds): void;
+    /**
+     * Create an event on the transport on the nextTick
+     */
+    private _createEvent;
+    /**
+     * Push more events onto the timeline to keep up with the position of the timeline
+     */
+    private _createEvents;
+    /**
+     * Re-compute the events when the transport time has changed from a start/ticks/loopStart event
+     */
+    private _restart;
+    /**
+     * Clean up
+     */
+    dispose(): this;
+}
+export {};

package/build/esm/core/clock/TransportRepeatEvent.js

@@ -0,0 +1,110 @@
+import { TicksClass } from "../type/Ticks";
+import { TransportEvent } from "./TransportEvent";
+import { GT, LT } from "../util/Math";
+/**
+ * TransportRepeatEvent is an internal class used by Tone.Transport
+ * to schedule repeat events. This class should not be instantiated directly.
+ */
+export class TransportRepeatEvent extends TransportEvent {
+    /**
+     * @param transport The transport object which the event belongs to
+     */
+    constructor(transport, opts) {
+        super(transport, opts);
+        /**
+         * The ID of the current timeline event
+         */
+        this._currentId = -1;
+        /**
+         * The ID of the next timeline event
+         */
+        this._nextId = -1;
+        /**
+         * The time of the next event
+         */
+        this._nextTick = this.time;
+        /**
+         * a reference to the bound start method
+         */
+        this._boundRestart = this._restart.bind(this);
+        const options = Object.assign(TransportRepeatEvent.getDefaults(), opts);
+        this.duration = options.duration;
+        this._interval = options.interval;
+        this._nextTick = options.time;
+        this.transport.on("start", this._boundRestart);
+        this.transport.on("loopStart", this._boundRestart);
+        this.transport.on("ticks", this._boundRestart);
+        this.context = this.transport.context;
+        this._restart();
+    }
+    static getDefaults() {
+        return Object.assign({}, TransportEvent.getDefaults(), {
+            duration: Infinity,
+            interval: 1,
+            once: false,
+        });
+    }
+    /**
+     * Invoke the callback. Returns the tick time which
+     * the next event should be scheduled at.
+     * @param  time  The AudioContext time in seconds of the event
+     */
+    invoke(time) {
+        // create more events if necessary
+        this._createEvents(time);
+        // call the super class
+        super.invoke(time);
+    }
+    /**
+     * Create an event on the transport on the nextTick
+     */
+    _createEvent() {
+        if (LT(this._nextTick, this.floatTime + this.duration)) {
+            return this.transport.scheduleOnce(this.invoke.bind(this), new TicksClass(this.context, this._nextTick).toSeconds());
+        }
+        return -1;
+    }
+    /**
+     * Push more events onto the timeline to keep up with the position of the timeline
+     */
+    _createEvents(time) {
+        // schedule the next event
+        // const ticks = this.transport.getTicksAtTime(time);
+        // if the next tick is within the bounds set by "duration"
+        if (LT(this._nextTick + this._interval, this.floatTime + this.duration)) {
+            this._nextTick += this._interval;
+            this._currentId = this._nextId;
+            this._nextId = this.transport.scheduleOnce(this.invoke.bind(this), new TicksClass(this.context, this._nextTick).toSeconds());
+        }
+    }
+    /**
+     * Re-compute the events when the transport time has changed from a start/ticks/loopStart event
+     */
+    _restart(time) {
+        this.transport.clear(this._currentId);
+        this.transport.clear(this._nextId);
+        // start at the first event
+        this._nextTick = this.floatTime;
+        const ticks = this.transport.getTicksAtTime(time);
+        if (GT(ticks, this.time)) {
+            // the event is not being scheduled from the beginning and should be offset
+            this._nextTick = this.floatTime + Math.ceil((ticks - this.floatTime) / this._interval) * this._interval;
+        }
+        this._currentId = this._createEvent();
+        this._nextTick += this._interval;
+        this._nextId = this._createEvent();
+    }
+    /**
+     * Clean up
+     */
+    dispose() {
+        super.dispose();
+        this.transport.clear(this._currentId);
+        this.transport.clear(this._nextId);
+        this.transport.off("start", this._boundRestart);
+        this.transport.off("loopStart", this._boundRestart);
+        this.transport.off("ticks", this._boundRestart);
+        return this;
+    }
+}
+//# sourceMappingURL=TransportRepeatEvent.js.map

package/build/esm/core/clock/TransportRepeatEvent.js.map

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

package/build/esm/core/context/AbstractParam.d.ts

@@ -0,0 +1,239 @@
+import { Time, UnitMap, UnitName } from "../type/Units";
+/**
+ * Abstract base class for [[Param]] and [[Signal]]
+ */
+export declare abstract class AbstractParam<TypeName extends UnitName> {
+    /**
+     * Schedules a parameter value change at the given time.
+     * @param value The value to set the signal.
+     * @param time The time when the change should occur.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const osc = new Tone.Oscillator(20).toDestination().start();
+     * 	// set the frequency to 40 at exactly 0.25 seconds
+     * 	osc.frequency.setValueAtTime(40, 0.25);
+     * }, 0.5, 1);
+     */
+    abstract setValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    /**
+     * Get the signals value at the given time. Subsequent scheduling
+     * may invalidate the returned value.
+     * @param time When to get the value
+     * @example
+     * const signal = new Tone.Signal().toDestination();
+     * // ramp up to '8' over 3 seconds
+     * signal.rampTo(8, 3);
+     * // ramp back down to '0' over 3 seconds
+     * signal.rampTo(0, 3, "+3");
+     * setInterval(() => {
+     * 	// check the value every 100 ms
+     * 	console.log(signal.getValueAtTime(Tone.now()));
+     * }, 100);
+     */
+    abstract getValueAtTime(time: Time): UnitMap[TypeName];
+    /**
+     * Creates a schedule point with the current value at the current time.
+     * Automation methods like [[linearRampToValueAtTime]] and [[exponentialRampToValueAtTime]]
+     * require a starting automation value usually set by [[setValueAtTime]]. This method
+     * is useful since it will do a `setValueAtTime` with whatever the currently computed
+     * value at the given time is.
+     * @param time When to add a ramp point.
+     * @example
+     * const osc = new Tone.Oscillator().toDestination().start();
+     * // set the frequency to "G4" in exactly 1 second from now.
+     * osc.frequency.setRampPoint("+1");
+     * osc.frequency.linearRampToValueAtTime("C1", "+2");
+     */
+    abstract setRampPoint(time: Time): this;
+    /**
+     * Schedules a linear continuous change in parameter value from the
+     * previous scheduled parameter value to the given value.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(0).toDestination();
+     * 	// the ramp starts from the previously scheduled value
+     * 	signal.setValueAtTime(0, 0.1);
+     * 	signal.linearRampToValueAtTime(1, 0.4);
+     * }, 0.5, 1);
+     */
+    abstract linearRampToValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    /**
+     * Schedules an exponential continuous change in parameter value from
+     * the previous scheduled parameter value to the given value.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(1).toDestination();
+     * 	// the ramp starts from the previously scheduled value, which must be positive
+     * 	signal.setValueAtTime(1, 0.1);
+     * 	signal.exponentialRampToValueAtTime(0, 0.4);
+     * }, 0.5, 1);
+     */
+    abstract exponentialRampToValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    /**
+     * Schedules an exponential continuous change in parameter value from
+     * the current time and current value to the given value over the
+     * duration of the rampTime.
+     * @param value   The value to ramp to.
+     * @param rampTime the time that it takes the
+     *                             value to ramp from it's current value
+     * @param startTime When the ramp should start.
+     * @example
+     * const delay = new Tone.FeedbackDelay(0.5, 0.98).toDestination();
+     * // a short burst of noise through the feedback delay
+     * const noise = new Tone.Noise().connect(delay).start().stop("+0.1");
+     * // making the delay time shorter over time will also make the pitch rise
+     * delay.delayTime.exponentialRampTo(0.01, 20);
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(.1).toDestination();
+     * 	signal.exponentialRampTo(5, 0.3, 0.1);
+     * }, 0.5, 1);
+     */
+    abstract exponentialRampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    /**
+     * Schedules an linear continuous change in parameter value from
+     * the current time and current value to the given value over the
+     * duration of the rampTime.
+     *
+     * @param  value   The value to ramp to.
+     * @param  rampTime the time that it takes the
+     *                              value to ramp from it's current value
+     * @param startTime 	When the ramp should start.
+     * @returns {Param} this
+     * @example
+     * const delay = new Tone.FeedbackDelay(0.5, 0.98).toDestination();
+     * // a short burst of noise through the feedback delay
+     * const noise = new Tone.Noise().connect(delay).start().stop("+0.1");
+     * // making the delay time shorter over time will also make the pitch rise
+     * delay.delayTime.linearRampTo(0.01, 20);
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(1).toDestination();
+     * 	signal.linearRampTo(0, 0.3, 0.1);
+     * }, 0.5, 1);
+     */
+    abstract linearRampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    /**
+     * Start exponentially approaching the target value at the given time. Since it
+     * is an exponential approach it will continue approaching after the ramp duration. The
+     * rampTime is the time that it takes to reach over 99% of the way towards the value.
+     * @param  value   The value to ramp to.
+     * @param  rampTime the time that it takes the
+     *                              value to ramp from it's current value
+     * @param startTime 	When the ramp should start.
+     * @example
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(1).toDestination();
+     * 	signal.targetRampTo(0, 0.3, 0.1);
+     * }, 0.5, 1);
+     */
+    abstract targetRampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    /**
+     * Start exponentially approaching the target value at the given time. Since it
+     * is an exponential approach it will continue approaching after the ramp duration. The
+     * rampTime is the time that it takes to reach over 99% of the way towards the value. This methods
+     * is similar to setTargetAtTime except the third argument is a time instead of a 'timeConstant'
+     * @param  value   The value to ramp to.
+     * @param time 	When the ramp should start.
+     * @param  rampTime the time that it takes the value to ramp from it's current value
+     * @example
+     * const osc = new Tone.Oscillator().toDestination().start();
+     * // exponential approach over 4 seconds starting in 1 second
+     * osc.frequency.exponentialApproachValueAtTime("C4", "+1", 4);
+     */
+    abstract exponentialApproachValueAtTime(value: UnitMap[TypeName], time: Time, rampTime: Time): this;
+    /**
+     * Start exponentially approaching the target value at the given time with
+     * a rate having the given time constant.
+     * @param value
+     * @param startTime
+     * @param timeConstant
+     */
+    abstract setTargetAtTime(value: UnitMap[TypeName], startTime: Time, timeConstant: number): this;
+    /**
+     * Sets an array of arbitrary parameter values starting at the given time
+     * for the given duration.
+     *
+     * @param values
+     * @param startTime
+     * @param duration
+     * @param scaling If the values in the curve should be scaled by some value
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(1).toDestination();
+     * 	signal.setValueCurveAtTime([1, 0.2, 0.8, 0.1, 0], 0.2, 0.3);
+     * }, 0.5, 1);
+     */
+    abstract setValueCurveAtTime(values: UnitMap[TypeName][], startTime: Time, duration: Time, scaling?: number): this;
+    /**
+     * Cancels all scheduled parameter changes with times greater than or
+     * equal to startTime.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(0).toDestination();
+     * 	signal.setValueAtTime(0.1, 0.1);
+     * 	signal.setValueAtTime(0.2, 0.2);
+     * 	signal.setValueAtTime(0.3, 0.3);
+     * 	signal.setValueAtTime(0.4, 0.4);
+     * 	// cancels the last two scheduled changes
+     * 	signal.cancelScheduledValues(0.3);
+     * }, 0.5, 1);
+     */
+    abstract cancelScheduledValues(time: Time): this;
+    /**
+     * This is similar to [[cancelScheduledValues]] except
+     * it holds the automated value at time until the next automated event.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const signal = new Tone.Signal(0).toDestination();
+     * 	signal.linearRampTo(1, 0.5, 0);
+     * 	signal.cancelAndHoldAtTime(0.3);
+     * }, 0.5, 1);
+     */
+    abstract cancelAndHoldAtTime(time: Time): this;
+    /**
+     * Ramps to the given value over the duration of the rampTime.
+     * Automatically selects the best ramp type (exponential or linear)
+     * depending on the `units` of the signal
+     *
+     * @param  value
+     * @param  rampTime The time that it takes the value to ramp from it's current value
+     * @param startTime When the ramp should start.
+     * @example
+     * const osc = new Tone.Oscillator().toDestination().start();
+     * // schedule it to ramp either linearly or exponentially depending on the units
+     * osc.frequency.rampTo("A2", 10);
+     * @example
+     * const osc = new Tone.Oscillator().toDestination().start();
+     * // schedule it to ramp starting at a specific time
+     * osc.frequency.rampTo("A2", 10, "+2");
+     */
+    abstract rampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    /**
+     * The current value of the parameter. Setting this value
+     * is equivalent to setValueAtTime(value, context.currentTime)
+     */
+    abstract value: UnitMap[TypeName];
+    /**
+     * If the value should be converted or not
+     */
+    abstract convert: boolean;
+    /**
+     * The unit type
+     */
+    abstract readonly units: UnitName;
+    /**
+     * True if the signal value is being overridden by
+     * a connected signal. Internal use only.
+     */
+    abstract overridden: boolean;
+    /**
+     * The minimum value of the output given the units
+     */
+    abstract readonly minValue: number;
+    /**
+     * The maximum value of the output given the units
+     */
+    abstract readonly maxValue: number;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Abstract base class for [[Param]] and [[Signal]]
+ */
+export class AbstractParam {
+}
+//# sourceMappingURL=AbstractParam.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractParam.js","sourceRoot":"","sources":["../../../../Tone/core/context/AbstractParam.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,OAAgB,aAAa;CA8PlC"}

package/build/esm/core/context/AudioContext.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Create a new AudioContext
+ */
+export declare function createAudioContext(options?: AudioContextOptions): AudioContext;
+/**
+ * Create a new OfflineAudioContext
+ */
+export declare function createOfflineAudioContext(channels: number, length: number, sampleRate: number): OfflineAudioContext;
+/**
+ * Either the online or offline audio context
+ */
+export declare type AnyAudioContext = AudioContext | OfflineAudioContext;
+/**
+ * Interface for things that Tone.js adds to the window
+ */
+interface ToneWindow extends Window {
+    TONE_SILENCE_LOGGING?: boolean;
+    TONE_DEBUG_CLASS?: string;
+}
+/**
+ * A reference to the window object
+ * @hidden
+ */
+export declare const theWindow: ToneWindow | null;
+/**
+ * If the browser has a window object which has an AudioContext
+ * @hidden
+ */
+export declare const hasAudioContext: boolean | null;
+export declare function createAudioWorkletNode(context: AnyAudioContext, name: string, options?: Partial<AudioWorkletNodeOptions>): AudioWorkletNode;
+/**
+ * This promise resolves to a boolean which indicates if the
+ * functionality is supported within the currently used browse.
+ * Taken from [standardized-audio-context](https://github.com/chrisguttandin/standardized-audio-context#issupported)
+ */
+export { isSupported as supported } from "standardized-audio-context";

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

@@ -0,0 +1,38 @@
+import { AudioContext as stdAudioContext, AudioWorkletNode as stdAudioWorkletNode, OfflineAudioContext as stdOfflineAudioContext } from "standardized-audio-context";
+import { assert } from "../util/Debug";
+import { isDefined } from "../util/TypeCheck";
+/**
+ * Create a new AudioContext
+ */
+export function createAudioContext(options) {
+    return new stdAudioContext(options);
+}
+/**
+ * Create a new OfflineAudioContext
+ */
+export function createOfflineAudioContext(channels, length, sampleRate) {
+    return new stdOfflineAudioContext(channels, length, sampleRate);
+}
+/**
+ * A reference to the window object
+ * @hidden
+ */
+export const theWindow = typeof self === "object" ? self : null;
+/**
+ * If the browser has a window object which has an AudioContext
+ * @hidden
+ */
+export const hasAudioContext = theWindow &&
+    (theWindow.hasOwnProperty("AudioContext") || theWindow.hasOwnProperty("webkitAudioContext"));
+export function createAudioWorkletNode(context, name, options) {
+    assert(isDefined(stdAudioWorkletNode), "This node only works in a secure context (https or localhost)");
+    // @ts-ignore
+    return new stdAudioWorkletNode(context, name, options);
+}
+/**
+ * This promise resolves to a boolean which indicates if the
+ * functionality is supported within the currently used browse.
+ * Taken from [standardized-audio-context](https://github.com/chrisguttandin/standardized-audio-context#issupported)
+ */
+export { isSupported as supported } from "standardized-audio-context";
+//# sourceMappingURL=AudioContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AudioContext.js","sourceRoot":"","sources":["../../../../Tone/core/context/AudioContext.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,YAAY,IAAI,eAAe,EAC/B,gBAAgB,IAAI,mBAAmB,EACvC,mBAAmB,IAAI,sBAAsB,EAC7C,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAA6B;IAC/D,OAAO,IAAI,eAAe,CAAC,OAAO,CAA4B,CAAC;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,QAAgB,EAAE,MAAc,EAAE,UAAkB;IAC7F,OAAO,IAAI,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAmC,CAAC;AACnG,CAAC;AAeD;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAsB,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAEnF;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,SAAS;IACvC,CAAC,SAAS,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,SAAS,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC;AAE9F,MAAM,UAAU,sBAAsB,CAAC,OAAwB,EAAE,IAAY,EAAE,OAA0C;IACxH,MAAM,CAAC,SAAS,CAAC,mBAAmB,CAAC,EAAE,+DAA+D,CAAC,CAAC;IACxG,aAAa;IACb,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,OAAO,EAAE,WAAW,IAAI,SAAS,EAAE,MAAM,4BAA4B,CAAC"}

package/build/esm/core/context/BaseContext.d.ts

@@ -0,0 +1,56 @@
+import { Seconds } from "../type/Units";
+import { Emitter } from "../util/Emitter";
+import { AnyAudioContext } from "./AudioContext";
+declare type Draw = import("../util/Draw").Draw;
+declare type Destination = import("./Destination").Destination;
+declare type Transport = import("../clock/Transport").Transport;
+declare type Listener = import("./Listener").Listener;
+export declare type ExcludedFromBaseAudioContext = "onstatechange" | "addEventListener" | "removeEventListener" | "listener" | "dispatchEvent" | "audioWorklet" | "destination" | "createScriptProcessor";
+export declare type BaseAudioContextSubset = Omit<BaseAudioContext, ExcludedFromBaseAudioContext>;
+export declare type ContextLatencyHint = AudioContextLatencyCategory;
+export declare abstract class BaseContext extends Emitter<"statechange" | "tick"> implements BaseAudioContextSubset {
+    abstract createAnalyser(): AnalyserNode;
+    abstract createOscillator(): OscillatorNode;
+    abstract createBufferSource(): AudioBufferSourceNode;
+    abstract createBiquadFilter(): BiquadFilterNode;
+    abstract createBuffer(_numberOfChannels: number, _length: number, _sampleRate: number): AudioBuffer;
+    abstract createChannelMerger(_numberOfInputs?: number | undefined): ChannelMergerNode;
+    abstract createChannelSplitter(_numberOfOutputs?: number | undefined): ChannelSplitterNode;
+    abstract createConstantSource(): ConstantSourceNode;
+    abstract createConvolver(): ConvolverNode;
+    abstract createDelay(_maxDelayTime?: number | undefined): DelayNode;
+    abstract createDynamicsCompressor(): DynamicsCompressorNode;
+    abstract createGain(): GainNode;
+    abstract createIIRFilter(_feedForward: number[] | Float32Array, _feedback: number[] | Float32Array): IIRFilterNode;
+    abstract createPanner(): PannerNode;
+    abstract createPeriodicWave(_real: number[] | Float32Array, _imag: number[] | Float32Array, _constraints?: PeriodicWaveConstraints | undefined): PeriodicWave;
+    abstract createStereoPanner(): StereoPannerNode;
+    abstract createWaveShaper(): WaveShaperNode;
+    abstract createMediaStreamSource(_stream: MediaStream): MediaStreamAudioSourceNode;
+    abstract createMediaElementSource(_element: HTMLMediaElement): MediaElementAudioSourceNode;
+    abstract createMediaStreamDestination(): MediaStreamAudioDestinationNode;
+    abstract decodeAudioData(_audioData: ArrayBuffer): Promise<AudioBuffer>;
+    abstract createAudioWorkletNode(_name: string, _options?: Partial<AudioWorkletNodeOptions>): AudioWorkletNode;
+    abstract get rawContext(): AnyAudioContext;
+    abstract addAudioWorkletModule(_url: string, _name: string): Promise<void>;
+    abstract lookAhead: number;
+    abstract latencyHint: ContextLatencyHint | Seconds;
+    abstract resume(): Promise<void>;
+    abstract setTimeout(_fn: (...args: any[]) => void, _timeout: Seconds): number;
+    abstract clearTimeout(_id: number): this;
+    abstract setInterval(_fn: (...args: any[]) => void, _interval: Seconds): number;
+    abstract clearInterval(_id: number): this;
+    abstract getConstant(_val: number): AudioBufferSourceNode;
+    abstract get currentTime(): Seconds;
+    abstract get state(): AudioContextState;
+    abstract get sampleRate(): number;
+    abstract get listener(): Listener;
+    abstract get transport(): Transport;
+    abstract get draw(): Draw;
+    abstract get destination(): Destination;
+    abstract now(): Seconds;
+    abstract immediate(): Seconds;
+    toJSON(): Record<string, any>;
+    readonly isOffline: boolean;
+}
+export {};

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

@@ -0,0 +1,16 @@
+import { Emitter } from "../util/Emitter";
+export class BaseContext extends Emitter {
+    constructor() {
+        super(...arguments);
+        this.isOffline = false;
+    }
+    /*
+     * This is a placeholder so that JSON.stringify does not throw an error
+     * This matches what JSON.stringify(audioContext) returns on a native
+     * audioContext instance.
+     */
+    toJSON() {
+        return {};
+    }
+}
+//# sourceMappingURL=BaseContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseContext.js","sourceRoot":"","sources":["../../../../Tone/core/context/BaseContext.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AA2B1C,MAAM,OAAgB,WACrB,SAAQ,OAA+B;IADxC;;QAoIU,cAAS,GAAY,KAAK,CAAC;IACrC,CAAC;IAVA;;;;OAIG;IACH,MAAM;QACL,OAAO,EAAE,CAAC;IACX,CAAC;CAGD"}