tone 14.8.27

package/build/esm/core/util/Decorator.js

@@ -0,0 +1,41 @@
+import { assertRange } from "./Debug";
+/**
+ * Assert that the number is in the given range.
+ */
+export function range(min, max = Infinity) {
+    const valueMap = new WeakMap();
+    return function (target, propertyKey) {
+        Reflect.defineProperty(target, propertyKey, {
+            configurable: true,
+            enumerable: true,
+            get: function () {
+                return valueMap.get(this);
+            },
+            set: function (newValue) {
+                assertRange(newValue, min, max);
+                valueMap.set(this, newValue);
+            }
+        });
+    };
+}
+/**
+ * Convert the time to seconds and assert that the time is in between the two
+ * values when being set.
+ */
+export function timeRange(min, max = Infinity) {
+    const valueMap = new WeakMap();
+    return function (target, propertyKey) {
+        Reflect.defineProperty(target, propertyKey, {
+            configurable: true,
+            enumerable: true,
+            get: function () {
+                return valueMap.get(this);
+            },
+            set: function (newValue) {
+                assertRange(this.toSeconds(newValue), min, max);
+                valueMap.set(this, newValue);
+            }
+        });
+    };
+}
+//# sourceMappingURL=Decorator.js.map

package/build/esm/core/util/Decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Decorator.js","sourceRoot":"","sources":["../../../../Tone/core/util/Decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAGtC;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW,EAAE,GAAG,GAAG,QAAQ;IAChD,MAAM,QAAQ,GAAyB,IAAI,OAAO,EAAE,CAAC;IACrD,OAAO,UAAS,MAAW,EAAE,WAA4B;QACxD,OAAO,CAAC,cAAc,CACrB,MAAM,EACN,WAAW,EACX;YACC,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE;gBACJ,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YACD,GAAG,EAAE,UAAS,QAAgB;gBAC7B,WAAW,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAChC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9B,CAAC;SACD,CACD,CAAC;IACH,CAAC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,GAAG,GAAG,QAAQ;IACpD,MAAM,QAAQ,GAAuB,IAAI,OAAO,EAAE,CAAC;IACnD,OAAO,UAAS,MAAW,EAAE,WAAmB;QAC/C,OAAO,CAAC,cAAc,CACrB,MAAM,EACN,WAAW,EACX;YACC,YAAY,EAAE,IAAI;YAClB,UAAU,EAAE,IAAI;YAChB,GAAG,EAAE;gBACJ,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3B,CAAC;YACD,GAAG,EAAE,UAAS,QAAc;gBAC3B,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;gBAChD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC9B,CAAC;SACD,CACD,CAAC;IACH,CAAC,CAAC;AACH,CAAC"}

package/build/esm/core/util/Defaults.d.ts

@@ -0,0 +1,32 @@
+declare type BaseToneOptions = import("../Tone").BaseToneOptions;
+/**
+ * Recursively merge an object
+ * @param target the object to merge into
+ * @param sources the source objects to merge
+ */
+export declare function deepMerge<T>(target: T): T;
+export declare function deepMerge<T, U>(target: T, source1: U): T & U;
+export declare function deepMerge<T, U, V>(target: T, source1: U, source2: V): T & U & V;
+export declare function deepMerge<T, U, V, W>(target: T, source1: U, source2: V, source3: W): T & U & V & W;
+/**
+ * Returns true if the two arrays have the same value for each of the elements
+ */
+export declare function deepEquals<T>(arrayA: T[], arrayB: T[]): boolean;
+/**
+ * Convert an args array into an object.
+ */
+export declare function optionsFromArguments<T extends object>(defaults: T, argsArray: IArguments, keys?: Array<keyof T>, objKey?: keyof T): T;
+/**
+ * Return this instances default values by calling Constructor.getDefaults()
+ */
+export declare function getDefaultsFromInstance<T>(instance: T): BaseToneOptions;
+/**
+ * Returns the fallback if the given object is undefined.
+ * Take an array of arguments and return a formatted options object.
+ */
+export declare function defaultArg<T>(given: T, fallback: T): T;
+/**
+ * Remove all of the properties belonging to omit from obj.
+ */
+export declare function omitFromObject<T extends object, O extends string[]>(obj: T, omit: O): Omit<T, keyof O>;
+export {};

package/build/esm/core/util/Defaults.js

@@ -0,0 +1,99 @@
+import { isAudioBuffer, isAudioNode, isAudioParam } from "./AdvancedTypeCheck";
+import { isDefined, isObject, isUndef } from "./TypeCheck";
+/**
+ * Some objects should not be merged
+ */
+function noCopy(key, arg) {
+    return key === "value" || isAudioParam(arg) || isAudioNode(arg) || isAudioBuffer(arg);
+}
+export function deepMerge(target, ...sources) {
+    if (!sources.length) {
+        return target;
+    }
+    const source = sources.shift();
+    if (isObject(target) && isObject(source)) {
+        for (const key in source) {
+            if (noCopy(key, source[key])) {
+                target[key] = source[key];
+            }
+            else if (isObject(source[key])) {
+                if (!target[key]) {
+                    Object.assign(target, { [key]: {} });
+                }
+                deepMerge(target[key], source[key]);
+            }
+            else {
+                Object.assign(target, { [key]: source[key] });
+            }
+        }
+    }
+    // @ts-ignore
+    return deepMerge(target, ...sources);
+}
+/**
+ * Returns true if the two arrays have the same value for each of the elements
+ */
+export function deepEquals(arrayA, arrayB) {
+    return arrayA.length === arrayB.length && arrayA.every((element, index) => arrayB[index] === element);
+}
+/**
+ * Convert an args array into an object.
+ */
+export function optionsFromArguments(defaults, argsArray, keys = [], objKey) {
+    const opts = {};
+    const args = Array.from(argsArray);
+    // if the first argument is an object and has an object key
+    if (isObject(args[0]) && objKey && !Reflect.has(args[0], objKey)) {
+        // if it's not part of the defaults
+        const partOfDefaults = Object.keys(args[0]).some(key => Reflect.has(defaults, key));
+        if (!partOfDefaults) {
+            // merge that key
+            deepMerge(opts, { [objKey]: args[0] });
+            // remove the obj key from the keys
+            keys.splice(keys.indexOf(objKey), 1);
+            // shift the first argument off
+            args.shift();
+        }
+    }
+    if (args.length === 1 && isObject(args[0])) {
+        deepMerge(opts, args[0]);
+    }
+    else {
+        for (let i = 0; i < keys.length; i++) {
+            if (isDefined(args[i])) {
+                opts[keys[i]] = args[i];
+            }
+        }
+    }
+    return deepMerge(defaults, opts);
+}
+/**
+ * Return this instances default values by calling Constructor.getDefaults()
+ */
+export function getDefaultsFromInstance(instance) {
+    return instance.constructor.getDefaults();
+}
+/**
+ * Returns the fallback if the given object is undefined.
+ * Take an array of arguments and return a formatted options object.
+ */
+export function defaultArg(given, fallback) {
+    if (isUndef(given)) {
+        return fallback;
+    }
+    else {
+        return given;
+    }
+}
+/**
+ * Remove all of the properties belonging to omit from obj.
+ */
+export function omitFromObject(obj, omit) {
+    omit.forEach(prop => {
+        if (Reflect.has(obj, prop)) {
+            delete obj[prop];
+        }
+    });
+    return obj;
+}
+//# sourceMappingURL=Defaults.js.map

package/build/esm/core/util/Defaults.js.map

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

package/build/esm/core/util/Draw.d.ts

@@ -0,0 +1,67 @@
+import { ToneWithContext, ToneWithContextOptions } from "../context/ToneWithContext";
+import { Seconds, Time } from "../type/Units";
+/**
+ * Draw is useful for synchronizing visuals and audio events.
+ * Callbacks from Tone.Transport or any of the Tone.Event classes
+ * always happen _before_ the scheduled time and are not synchronized
+ * to the animation frame so they are not good for triggering tightly
+ * synchronized visuals and sound. Draw makes it easy to schedule
+ * callbacks using the AudioContext time and uses requestAnimationFrame.
+ * @example
+ * Tone.Transport.schedule((time) => {
+ * 	// use the time argument to schedule a callback with Draw
+ * 	Tone.Draw.schedule(() => {
+ * 		// do drawing or DOM manipulation here
+ * 		console.log(time);
+ * 	}, time);
+ * }, "+0.5");
+ * Tone.Transport.start();
+ * @category Core
+ */
+export declare class Draw extends ToneWithContext<ToneWithContextOptions> {
+    readonly name: string;
+    /**
+     * The duration after which events are not invoked.
+     */
+    expiration: Seconds;
+    /**
+     * The amount of time before the scheduled time
+     * that the callback can be invoked. Default is
+     * half the time of an animation frame (0.008 seconds).
+     */
+    anticipation: Seconds;
+    /**
+     * All of the events.
+     */
+    private _events;
+    /**
+     * The draw loop
+     */
+    private _boundDrawLoop;
+    /**
+     * The animation frame id
+     */
+    private _animationFrame;
+    /**
+     * Schedule a function at the given time to be invoked
+     * on the nearest animation frame.
+     * @param  callback  Callback is invoked at the given time.
+     * @param  time      The time relative to the AudioContext time to invoke the callback.
+     * @example
+     * Tone.Transport.scheduleRepeat(time => {
+     * 	Tone.Draw.schedule(() => console.log(time), time);
+     * }, 1);
+     * Tone.Transport.start();
+     */
+    schedule(callback: () => void, time: Time): this;
+    /**
+     * Cancel events scheduled after the given time
+     * @param  after  Time after which scheduled events will be removed from the scheduling timeline.
+     */
+    cancel(after?: Time): this;
+    /**
+     * The draw loop
+     */
+    private _drawLoop;
+    dispose(): this;
+}

package/build/esm/core/util/Draw.js

@@ -0,0 +1,110 @@
+import { ToneWithContext } from "../context/ToneWithContext";
+import { Timeline } from "./Timeline";
+import { onContextClose, onContextInit } from "../context/ContextInitialization";
+/**
+ * Draw is useful for synchronizing visuals and audio events.
+ * Callbacks from Tone.Transport or any of the Tone.Event classes
+ * always happen _before_ the scheduled time and are not synchronized
+ * to the animation frame so they are not good for triggering tightly
+ * synchronized visuals and sound. Draw makes it easy to schedule
+ * callbacks using the AudioContext time and uses requestAnimationFrame.
+ * @example
+ * Tone.Transport.schedule((time) => {
+ * 	// use the time argument to schedule a callback with Draw
+ * 	Tone.Draw.schedule(() => {
+ * 		// do drawing or DOM manipulation here
+ * 		console.log(time);
+ * 	}, time);
+ * }, "+0.5");
+ * Tone.Transport.start();
+ * @category Core
+ */
+export class Draw extends ToneWithContext {
+    constructor() {
+        super(...arguments);
+        this.name = "Draw";
+        /**
+         * The duration after which events are not invoked.
+         */
+        this.expiration = 0.25;
+        /**
+         * The amount of time before the scheduled time
+         * that the callback can be invoked. Default is
+         * half the time of an animation frame (0.008 seconds).
+         */
+        this.anticipation = 0.008;
+        /**
+         * All of the events.
+         */
+        this._events = new Timeline();
+        /**
+         * The draw loop
+         */
+        this._boundDrawLoop = this._drawLoop.bind(this);
+        /**
+         * The animation frame id
+         */
+        this._animationFrame = -1;
+    }
+    /**
+     * Schedule a function at the given time to be invoked
+     * on the nearest animation frame.
+     * @param  callback  Callback is invoked at the given time.
+     * @param  time      The time relative to the AudioContext time to invoke the callback.
+     * @example
+     * Tone.Transport.scheduleRepeat(time => {
+     * 	Tone.Draw.schedule(() => console.log(time), time);
+     * }, 1);
+     * Tone.Transport.start();
+     */
+    schedule(callback, time) {
+        this._events.add({
+            callback,
+            time: this.toSeconds(time),
+        });
+        // start the draw loop on the first event
+        if (this._events.length === 1) {
+            this._animationFrame = requestAnimationFrame(this._boundDrawLoop);
+        }
+        return this;
+    }
+    /**
+     * Cancel events scheduled after the given time
+     * @param  after  Time after which scheduled events will be removed from the scheduling timeline.
+     */
+    cancel(after) {
+        this._events.cancel(this.toSeconds(after));
+        return this;
+    }
+    /**
+     * The draw loop
+     */
+    _drawLoop() {
+        const now = this.context.currentTime;
+        while (this._events.length && this._events.peek().time - this.anticipation <= now) {
+            const event = this._events.shift();
+            if (event && now - event.time <= this.expiration) {
+                event.callback();
+            }
+        }
+        if (this._events.length > 0) {
+            this._animationFrame = requestAnimationFrame(this._boundDrawLoop);
+        }
+    }
+    dispose() {
+        super.dispose();
+        this._events.dispose();
+        cancelAnimationFrame(this._animationFrame);
+        return this;
+    }
+}
+//-------------------------------------
+// 	INITIALIZATION
+//-------------------------------------
+onContextInit(context => {
+    context.draw = new Draw({ context });
+});
+onContextClose(context => {
+    context.draw.dispose();
+});
+//# sourceMappingURL=Draw.js.map

package/build/esm/core/util/Draw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Draw.js","sourceRoot":"","sources":["../../../../Tone/core/util/Draw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAA0B,MAAM,4BAA4B,CAAC;AAErF,OAAO,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAMjF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,OAAO,IAAK,SAAQ,eAAuC;IAAjE;;QAEU,SAAI,GAAW,MAAM,CAAC;QAE/B;;WAEG;QACH,eAAU,GAAY,IAAI,CAAC;QAE3B;;;;WAIG;QACH,iBAAY,GAAY,KAAK,CAAC;QAE9B;;WAEG;QACK,YAAO,GAAwB,IAAI,QAAQ,EAAE,CAAC;QAEtD;;WAEG;QACK,mBAAc,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEnD;;WAEG;QACK,oBAAe,GAAG,CAAC,CAAC,CAAC;IAwD9B,CAAC;IAtDA;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,QAAoB,EAAE,IAAU;QACxC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;YAChB,QAAQ;YACR,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;SAC1B,CAAC,CAAC;QACH,yCAAyC;QACzC,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE;YAC9B,IAAI,CAAC,eAAe,GAAG,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAClE;QACD,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAY;QAClB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACb,CAAC;IAED;;OAEG;IACK,SAAS;QAChB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,IAAK,IAAI,CAAC,OAAO,CAAC,IAAI,EAAgB,CAAC,IAAI,GAAG,IAAI,CAAC,YAAY,IAAI,GAAG,EAAE;YACjG,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACnC,IAAI,KAAK,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE;gBACjD,KAAK,CAAC,QAAQ,EAAE,CAAC;aACjB;SACD;QACD,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;YAC5B,IAAI,CAAC,eAAe,GAAG,qBAAqB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;SAClE;IACF,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,oBAAoB,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC3C,OAAO,IAAI,CAAC;IACb,CAAC;CACD;AAED,uCAAuC;AACvC,kBAAkB;AAClB,uCAAuC;AAEvC,aAAa,CAAC,OAAO,CAAC,EAAE;IACvB,OAAO,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AACtC,CAAC,CAAC,CAAC;AAEH,cAAc,CAAC,OAAO,CAAC,EAAE;IACxB,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;AACxB,CAAC,CAAC,CAAC"}

package/build/esm/core/util/Emitter.d.ts

@@ -0,0 +1,52 @@
+import { Tone } from "../Tone";
+export interface EmitterEventObject {
+    [event: string]: Array<(...args: any[]) => void>;
+}
+/**
+ * Emitter gives classes which extend it
+ * the ability to listen for and emit events.
+ * Inspiration and reference from Jerome Etienne's [MicroEvent](https://github.com/jeromeetienne/microevent.js).
+ * MIT (c) 2011 Jerome Etienne.
+ * @category Core
+ */
+export declare class Emitter<EventType extends string = string> extends Tone {
+    readonly name: string;
+    /**
+     * Private container for the events
+     */
+    private _events?;
+    /**
+     * Bind a callback to a specific event.
+     * @param  event     The name of the event to listen for.
+     * @param  callback  The callback to invoke when the event is emitted
+     */
+    on(event: EventType, callback: (...args: any[]) => void): this;
+    /**
+     * Bind a callback which is only invoked once
+     * @param  event     The name of the event to listen for.
+     * @param  callback  The callback to invoke when the event is emitted
+     */
+    once(event: EventType, callback: (...args: any[]) => void): this;
+    /**
+     * Remove the event listener.
+     * @param  event     The event to stop listening to.
+     * @param  callback  The callback which was bound to the event with Emitter.on.
+     *                   If no callback is given, all callbacks events are removed.
+     */
+    off(event: EventType, callback?: (...args: any[]) => void): this;
+    /**
+     * Invoke all of the callbacks bound to the event
+     * with any arguments passed in.
+     * @param  event  The name of the event.
+     * @param args The arguments to pass to the functions listening.
+     */
+    emit(event: any, ...args: any[]): this;
+    /**
+     * Add Emitter functions (on/off/emit) to the object
+     */
+    static mixin(constr: any): void;
+    /**
+     * Clean up
+     */
+    dispose(): this;
+}

package/build/esm/core/util/Emitter.js

@@ -0,0 +1,113 @@
+import { Tone } from "../Tone";
+import { isUndef } from "./TypeCheck";
+/**
+ * Emitter gives classes which extend it
+ * the ability to listen for and emit events.
+ * Inspiration and reference from Jerome Etienne's [MicroEvent](https://github.com/jeromeetienne/microevent.js).
+ * MIT (c) 2011 Jerome Etienne.
+ * @category Core
+ */
+export class Emitter extends Tone {
+    constructor() {
+        super(...arguments);
+        this.name = "Emitter";
+    }
+    /**
+     * Bind a callback to a specific event.
+     * @param  event     The name of the event to listen for.
+     * @param  callback  The callback to invoke when the event is emitted
+     */
+    on(event, callback) {
+        // split the event
+        const events = event.split(/\W+/);
+        events.forEach(eventName => {
+            if (isUndef(this._events)) {
+                this._events = {};
+            }
+            if (!this._events.hasOwnProperty(eventName)) {
+                this._events[eventName] = [];
+            }
+            this._events[eventName].push(callback);
+        });
+        return this;
+    }
+    /**
+     * Bind a callback which is only invoked once
+     * @param  event     The name of the event to listen for.
+     * @param  callback  The callback to invoke when the event is emitted
+     */
+    once(event, callback) {
+        const boundCallback = (...args) => {
+            // invoke the callback
+            callback(...args);
+            // remove the event
+            this.off(event, boundCallback);
+        };
+        this.on(event, boundCallback);
+        return this;
+    }
+    /**
+     * Remove the event listener.
+     * @param  event     The event to stop listening to.
+     * @param  callback  The callback which was bound to the event with Emitter.on.
+     *                   If no callback is given, all callbacks events are removed.
+     */
+    off(event, callback) {
+        const events = event.split(/\W+/);
+        events.forEach(eventName => {
+            if (isUndef(this._events)) {
+                this._events = {};
+            }
+            if (this._events.hasOwnProperty(eventName)) {
+                if (isUndef(callback)) {
+                    this._events[eventName] = [];
+                }
+                else {
+                    const eventList = this._events[eventName];
+                    for (let i = eventList.length - 1; i >= 0; i--) {
+                        if (eventList[i] === callback) {
+                            eventList.splice(i, 1);
+                        }
+                    }
+                }
+            }
+        });
+        return this;
+    }
+    /**
+     * Invoke all of the callbacks bound to the event
+     * with any arguments passed in.
+     * @param  event  The name of the event.
+     * @param args The arguments to pass to the functions listening.
+     */
+    emit(event, ...args) {
+        if (this._events) {
+            if (this._events.hasOwnProperty(event)) {
+                const eventList = this._events[event].slice(0);
+                for (let i = 0, len = eventList.length; i < len; i++) {
+                    eventList[i].apply(this, args);
+                }
+            }
+        }
+        return this;
+    }
+    /**
+     * Add Emitter functions (on/off/emit) to the object
+     */
+    static mixin(constr) {
+        // instance._events = {};
+        ["on", "once", "off", "emit"].forEach(name => {
+            const property = Object.getOwnPropertyDescriptor(Emitter.prototype, name);
+            Object.defineProperty(constr.prototype, name, property);
+        });
+    }
+    /**
+     * Clean up
+     */
+    dispose() {
+        super.dispose();
+        this._events = undefined;
+        return this;
+    }
+}
+//# sourceMappingURL=Emitter.js.map

package/build/esm/core/util/Emitter.js.map

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

package/build/esm/core/util/Interface.d.ts

@@ -0,0 +1,16 @@
+export declare type Omit<T, K extends keyof T> = Pick<T, Exclude<keyof T, K>>;
+/**
+ * Make the property not writable using `defineProperty`. Internal use only.
+ */
+export declare function readOnly(target: object, property: string | string[]): void;
+/**
+ * Make an attribute writeable. Internal use only.
+ */
+export declare function writable(target: object, property: string | string[]): void;
+export declare const noOp: (...args: any[]) => any;
+/**
+ * Recursive Partial taken from here: https://stackoverflow.com/a/51365037
+ */
+export declare type RecursivePartial<T> = {
+    [P in keyof T]?: T[P] extends Array<infer U> ? Array<RecursivePartial<U>> : T[P] extends object ? RecursivePartial<T[P]> : T[P];
+};

package/build/esm/core/util/Interface.js

@@ -0,0 +1,32 @@
+import { isArray } from "./TypeCheck";
+/**
+ * Make the property not writable using `defineProperty`. Internal use only.
+ */
+export function readOnly(target, property) {
+    if (isArray(property)) {
+        property.forEach(str => readOnly(target, str));
+    }
+    else {
+        Object.defineProperty(target, property, {
+            enumerable: true,
+            writable: false,
+        });
+    }
+}
+/**
+ * Make an attribute writeable. Internal use only.
+ */
+export function writable(target, property) {
+    if (isArray(property)) {
+        property.forEach(str => writable(target, str));
+    }
+    else {
+        Object.defineProperty(target, property, {
+            writable: true,
+        });
+    }
+}
+export const noOp = () => {
+    // no operation here!
+};
+//# sourceMappingURL=Interface.js.map

package/build/esm/core/util/Interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Interface.js","sourceRoot":"","sources":["../../../../Tone/core/util/Interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAKtC;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,QAA2B;IACnE,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE;QACtB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;KAC/C;SAAM;QACN,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE;YACvC,UAAU,EAAE,IAAI;YAChB,QAAQ,EAAE,KAAK;SACf,CAAC,CAAC;KACH;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,QAA2B;IACnE,IAAI,OAAO,CAAC,QAAQ,CAAC,EAAE;QACtB,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC;KAC/C;SAAM;QACN,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,EAAE;YACvC,QAAQ,EAAE,IAAI;SACd,CAAC,CAAC;KACH;AACF,CAAC;AAED,MAAM,CAAC,MAAM,IAAI,GAA4B,GAAG,EAAE;IACjD,qBAAqB;AACtB,CAAC,CAAC"}