tone 14.8.27

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

@@ -0,0 +1,251 @@
+import { Tone } from "../Tone";
+import { isDefined, isObject, isString, isUndef } from "../util/TypeCheck";
+/**
+ * TimeBase is a flexible encoding of time which can be evaluated to and from a string.
+ */
+export class TimeBaseClass extends Tone {
+    /**
+     * @param context The context associated with the time value. Used to compute
+     * Transport and context-relative timing.
+     * @param  value  The time value as a number, string or object
+     * @param  units  Unit values
+     */
+    constructor(context, value, units) {
+        super();
+        /**
+         * The default units
+         */
+        this.defaultUnits = "s";
+        this._val = value;
+        this._units = units;
+        this.context = context;
+        this._expressions = this._getExpressions();
+    }
+    /**
+     * All of the time encoding expressions
+     */
+    _getExpressions() {
+        return {
+            hz: {
+                method: (value) => {
+                    return this._frequencyToUnits(parseFloat(value));
+                },
+                regexp: /^(\d+(?:\.\d+)?)hz$/i,
+            },
+            i: {
+                method: (value) => {
+                    return this._ticksToUnits(parseInt(value, 10));
+                },
+                regexp: /^(\d+)i$/i,
+            },
+            m: {
+                method: (value) => {
+                    return this._beatsToUnits(parseInt(value, 10) * this._getTimeSignature());
+                },
+                regexp: /^(\d+)m$/i,
+            },
+            n: {
+                method: (value, dot) => {
+                    const numericValue = parseInt(value, 10);
+                    const scalar = dot === "." ? 1.5 : 1;
+                    if (numericValue === 1) {
+                        return this._beatsToUnits(this._getTimeSignature()) * scalar;
+                    }
+                    else {
+                        return this._beatsToUnits(4 / numericValue) * scalar;
+                    }
+                },
+                regexp: /^(\d+)n(\.?)$/i,
+            },
+            number: {
+                method: (value) => {
+                    return this._expressions[this.defaultUnits].method.call(this, value);
+                },
+                regexp: /^(\d+(?:\.\d+)?)$/,
+            },
+            s: {
+                method: (value) => {
+                    return this._secondsToUnits(parseFloat(value));
+                },
+                regexp: /^(\d+(?:\.\d+)?)s$/,
+            },
+            samples: {
+                method: (value) => {
+                    return parseInt(value, 10) / this.context.sampleRate;
+                },
+                regexp: /^(\d+)samples$/,
+            },
+            t: {
+                method: (value) => {
+                    const numericValue = parseInt(value, 10);
+                    return this._beatsToUnits(8 / (Math.floor(numericValue) * 3));
+                },
+                regexp: /^(\d+)t$/i,
+            },
+            tr: {
+                method: (m, q, s) => {
+                    let total = 0;
+                    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;
+                },
+                regexp: /^(\d+(?:\.\d+)?):(\d+(?:\.\d+)?):?(\d+(?:\.\d+)?)?$/,
+            },
+        };
+    }
+    //-------------------------------------
+    // 	VALUE OF
+    //-------------------------------------
+    /**
+     * Evaluate the time value. Returns the time in seconds.
+     */
+    valueOf() {
+        if (this._val instanceof TimeBaseClass) {
+            this.fromType(this._val);
+        }
+        if (isUndef(this._val)) {
+            return this._noArg();
+        }
+        else if (isString(this._val) && isUndef(this._units)) {
+            for (const units in this._expressions) {
+                if (this._expressions[units].regexp.test(this._val.trim())) {
+                    this._units = units;
+                    break;
+                }
+            }
+        }
+        else if (isObject(this._val)) {
+            let total = 0;
+            for (const typeName in this._val) {
+                if (isDefined(this._val[typeName])) {
+                    const quantity = this._val[typeName];
+                    // @ts-ignore
+                    const time = (new this.constructor(this.context, typeName)).valueOf() * quantity;
+                    total += time;
+                }
+            }
+            return total;
+        }
+        if (isDefined(this._units)) {
+            const expr = this._expressions[this._units];
+            const matching = this._val.toString().trim().match(expr.regexp);
+            if (matching) {
+                return expr.method.apply(this, matching.slice(1));
+            }
+            else {
+                return expr.method.call(this, this._val);
+            }
+        }
+        else if (isString(this._val)) {
+            return parseFloat(this._val);
+        }
+        else {
+            return this._val;
+        }
+    }
+    //-------------------------------------
+    // 	UNIT CONVERSIONS
+    //-------------------------------------
+    /**
+     * Returns the value of a frequency in the current units
+     */
+    _frequencyToUnits(freq) {
+        return 1 / freq;
+    }
+    /**
+     * Return the value of the beats in the current units
+     */
+    _beatsToUnits(beats) {
+        return (60 / this._getBpm()) * beats;
+    }
+    /**
+     * Returns the value of a second in the current units
+     */
+    _secondsToUnits(seconds) {
+        return seconds;
+    }
+    /**
+     * Returns the value of a tick in the current time units
+     */
+    _ticksToUnits(ticks) {
+        return (ticks * (this._beatsToUnits(1)) / this._getPPQ());
+    }
+    /**
+     * With no arguments, return 'now'
+     */
+    _noArg() {
+        return this._now();
+    }
+    //-------------------------------------
+    // 	TEMPO CONVERSIONS
+    //-------------------------------------
+    /**
+     * Return the bpm
+     */
+    _getBpm() {
+        return this.context.transport.bpm.value;
+    }
+    /**
+     * Return the timeSignature
+     */
+    _getTimeSignature() {
+        return this.context.transport.timeSignature;
+    }
+    /**
+     * Return the PPQ or 192 if Transport is not available
+     */
+    _getPPQ() {
+        return this.context.transport.PPQ;
+    }
+    //-------------------------------------
+    // 	CONVERSION INTERFACE
+    //-------------------------------------
+    /**
+     * Coerce a time type into this units type.
+     * @param type Any time type units
+     */
+    fromType(type) {
+        this._units = undefined;
+        switch (this.defaultUnits) {
+            case "s":
+                this._val = type.toSeconds();
+                break;
+            case "i":
+                this._val = type.toTicks();
+                break;
+            case "hz":
+                this._val = type.toFrequency();
+                break;
+            case "midi":
+                this._val = type.toMidi();
+                break;
+        }
+        return this;
+    }
+    /**
+     * Return the value in hertz
+     */
+    toFrequency() {
+        return 1 / this.toSeconds();
+    }
+    /**
+     * Return the time in samples
+     */
+    toSamples() {
+        return this.toSeconds() * this.context.sampleRate;
+    }
+    /**
+     * Return the time in milliseconds.
+     */
+    toMilliseconds() {
+        return this.toSeconds() * 1000;
+    }
+}
+//# sourceMappingURL=TimeBase.js.map

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

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

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

@@ -0,0 +1,25 @@
+import { Seconds, Ticks } from "../type/Units";
+import { TimeClass } from "./Time";
+import { TimeBaseUnit, TimeValue } from "./TimeBase";
+/**
+ * TransportTime is a the time along the Transport's
+ * timeline. It is similar to Tone.Time, but instead of evaluating
+ * against the AudioContext's clock, it is evaluated against
+ * the Transport's position. See [TransportTime wiki](https://github.com/Tonejs/Tone.js/wiki/TransportTime).
+ * @category Unit
+ */
+export declare class TransportTimeClass<Type extends Seconds | Ticks = Seconds> extends TimeClass<Type> {
+    readonly name: string;
+    /**
+     * Return the current time in whichever context is relevant
+     */
+    protected _now(): Type;
+}
+/**
+ * TransportTime is a the time along the Transport's
+ * timeline. It is similar to [[Time]], but instead of evaluating
+ * against the AudioContext's clock, it is evaluated against
+ * the Transport's position. See [TransportTime wiki](https://github.com/Tonejs/Tone.js/wiki/TransportTime).
+ * @category Unit
+ */
+export declare function TransportTime(value?: TimeValue, units?: TimeBaseUnit): TransportTimeClass;

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

@@ -0,0 +1,32 @@
+import { getContext } from "../Global";
+import { TimeClass } from "./Time";
+/**
+ * TransportTime is a the time along the Transport's
+ * timeline. It is similar to Tone.Time, but instead of evaluating
+ * against the AudioContext's clock, it is evaluated against
+ * the Transport's position. See [TransportTime wiki](https://github.com/Tonejs/Tone.js/wiki/TransportTime).
+ * @category Unit
+ */
+export class TransportTimeClass extends TimeClass {
+    constructor() {
+        super(...arguments);
+        this.name = "TransportTime";
+    }
+    /**
+     * Return the current time in whichever context is relevant
+     */
+    _now() {
+        return this.context.transport.seconds;
+    }
+}
+/**
+ * TransportTime is a the time along the Transport's
+ * timeline. It is similar to [[Time]], but instead of evaluating
+ * against the AudioContext's clock, it is evaluated against
+ * the Transport's position. See [TransportTime wiki](https://github.com/Tonejs/Tone.js/wiki/TransportTime).
+ * @category Unit
+ */
+export function TransportTime(value, units) {
+    return new TransportTimeClass(getContext(), value, units);
+}
+//# sourceMappingURL=TransportTime.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransportTime.js","sourceRoot":"","sources":["../../../../Tone/core/type/TransportTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAGnC;;;;;;GAMG;AACH,MAAM,OAAO,kBAA2D,SAAQ,SAAe;IAA/F;;QAEU,SAAI,GAAW,eAAe,CAAC;IAQzC,CAAC;IANA;;OAEG;IACO,IAAI;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAe,CAAC;IAC/C,CAAC;CACD;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAiB,EAAE,KAAoB;IACpE,OAAO,IAAI,kBAAkB,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAC3D,CAAC"}

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

@@ -0,0 +1,176 @@
+export * from "./NoteUnits";
+import { Note } from "./NoteUnits";
+/**
+ * A number representing a time in seconds
+ * @category Unit
+ */
+export declare type Seconds = number;
+/**
+ * A number used to measure the intensity of a sound on a logarithmic scale.
+ * @category Unit
+ */
+export declare type Decibels = number;
+/**
+ * A number that is between [0, 1]
+ * @category Unit
+ */
+export declare type NormalRange = number;
+/**
+ * A number that is between [-1, 1]
+ * @category Unit
+ */
+export declare type AudioRange = number;
+/**
+ * Half-step note increments, i.e. 12 is an octave above the root. and 1 is a half-step up.
+ * @category Unit
+ */
+export declare type Interval = number;
+/**
+ * A number representing the multiplication factor applied to a signal
+ * @category Unit
+ */
+export declare type GainFactor = number;
+/**
+ * A number greater than or equal to 0.
+ * @category Unit
+ */
+export declare type Positive = number;
+/**
+ * Represents a subdivision of a measure.
+ * The number represents the subdivision. "t" represents a triplet. A "." add a half.
+ * e.g. "4n" is a quarter note, "4t" is a quarter note triplet, and "4n." is a dotted quarter note.
+ * @category Unit
+ */
+export declare type Subdivision = "1m" | "1n" | "1n." | "2n" | "2n." | "2t" | "4n" | "4n." | "4t" | "8n" | "8n." | "8t" | "16n" | "16n." | "16t" | "32n" | "32n." | "32t" | "64n" | "64n." | "64t" | "128n" | "128n." | "128t" | "256n" | "256n." | "256t" | "0";
+/**
+ * A time object has a subdivision as the keys and a number as the values.
+ * @example
+ * Tone.Time({
+ * 	"2n": 1,
+ * 	"8n": 3
+ * }).valueOf(); // 2n + 8n * 3
+ * @category Unit
+ */
+export declare type TimeObject = {
+    [sub in Subdivision]?: number;
+};
+/**
+ * Time can be described in a number of ways. Read more [Time](https://github.com/Tonejs/Tone.js/wiki/Time).
+ * * Numbers, which will be taken literally as the time (in seconds).
+ * * Notation, ("4n", "8t") describes time in BPM and time signature relative values.
+ * * TransportTime, ("4:3:2") will also provide tempo and time signature relative times in the form BARS:QUARTERS:SIXTEENTHS.
+ * * Frequency, ("8hz") is converted to the length of the cycle in seconds.
+ * * Now-Relative, ("+1") prefix any of the above with "+" and it will be interpreted as "the current time plus whatever expression follows".
+ * * Object, ({"4n" : 3, "8t" : -1}). The resulting time is equal to the sum of all of the keys multiplied by the values in the object.
+ * * No Argument, for methods which accept time, no argument will be interpreted as "now" (i.e. the currentTime).
+ * @category Unit
+ */
+export declare type Time = string | Seconds | TimeObject | Subdivision;
+/**
+ * Frequency can be described similar to time, except ultimately the
+ * values are converted to frequency instead of seconds. A number
+ * is taken literally as the value in hertz. Additionally any of the
+ * Time encodings can be used. Note names in the form
+ * of NOTE OCTAVE (i.e. C4) are also accepted and converted to their
+ * frequency value.
+ * @category Unit
+ */
+export declare type Frequency = Subdivision | Note | string | Hertz;
+/**
+ *
+ * @category Unit
+ */
+export declare type TimeSignature = number | number[];
+/**
+ * TransportTime describes a position along the Transport's timeline. It is
+ * similar to Time in that it uses all the same encodings, but TransportTime specifically
+ * pertains to the Transport's timeline, which is startable, stoppable, loopable, and seekable.
+ * [Read more](https://github.com/Tonejs/Tone.js/wiki/TransportTime)
+ * @category Unit
+ */
+export declare type TransportTime = Time;
+/**
+ * Ticks are the basic subunit of the Transport. They are
+ * the smallest unit of time that the Transport supports.
+ * @category Unit
+ */
+export declare type Ticks = number;
+/**
+ * Beats per minute
+ * @category Unit
+ */
+export declare type BPM = number;
+/**
+ * Angle between 0 and 360.
+ * @category Unit
+ */
+export declare type Degrees = number;
+/**
+ * Angle between 0 and 2 * PI.
+ * @category Unit
+ */
+export declare type Radians = number;
+/**
+ * A colon-separated representation of time in the form of
+ * Bars:Beats:Sixteenths.
+ * @category Unit
+ */
+export declare type BarsBeatsSixteenths = string;
+/**
+ * Sampling is the reduction of a continuous signal to a discrete signal.
+ * Audio is typically sampled 44100 times per second.
+ * @category Unit
+ */
+export declare type Samples = number;
+/**
+ * Hertz are a frequency representation defined as one cycle per second.
+ * @category Unit
+ */
+export declare type Hertz = number;
+/**
+ * A Cent is 1/100th of a semitone.
+ * e.g. a value of 50 cents would be halfway between two intervals.
+ * @category Unit
+ */
+export declare type Cents = number;
+/**
+ * One millisecond is a thousandth of a second.
+ * @category Unit
+ */
+export declare type Milliseconds = number;
+/**
+ * A value which is a power of 2
+ * @category Unit
+ */
+export declare type PowerOfTwo = number;
+/**
+ * Map the unit name to a unit value
+ */
+export interface UnitMap {
+    number: number;
+    decibels: Decibels;
+    normalRange: NormalRange;
+    audioRange: AudioRange;
+    gain: GainFactor;
+    positive: Positive;
+    time: Time;
+    frequency: Frequency;
+    transportTime: TransportTime;
+    ticks: Ticks;
+    bpm: BPM;
+    degrees: Degrees;
+    radians: Radians;
+    samples: Samples;
+    hertz: Hertz;
+    cents: Cents;
+}
+/**
+ * All of the unit types
+ * @category Unit
+ */
+export declare type Unit = UnitMap[keyof UnitMap];
+/**
+ * All of the unit names
+ * @category Unit
+ */
+export declare type UnitName = keyof UnitMap;

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

@@ -0,0 +1,2 @@
+export * from "./NoteUnits";
+//# sourceMappingURL=Units.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Units.js","sourceRoot":"","sources":["../../../../Tone/core/type/Units.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,21 @@
+import { AudioBuffer } from "standardized-audio-context";
+/**
+ * Test if the given value is an instanceof AudioParam
+ */
+export declare function isAudioParam(arg: any): arg is AudioParam;
+/**
+ * Test if the given value is an instanceof AudioNode
+ */
+export declare function isAudioNode(arg: any): arg is AudioNode;
+/**
+ * Test if the arg is instanceof an OfflineAudioContext
+ */
+export declare function isOfflineAudioContext(arg: any): arg is OfflineAudioContext;
+/**
+ * Test if the arg is an instanceof AudioContext
+ */
+export declare function isAudioContext(arg: any): arg is AudioContext;
+/**
+ * Test if the arg is instanceof an AudioBuffer
+ */
+export declare function isAudioBuffer(arg: any): arg is AudioBuffer;

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

@@ -0,0 +1,32 @@
+import { AudioBuffer, isAnyAudioContext, isAnyAudioNode, isAnyAudioParam, isAnyOfflineAudioContext } from "standardized-audio-context";
+/**
+ * Test if the given value is an instanceof AudioParam
+ */
+export function isAudioParam(arg) {
+    return isAnyAudioParam(arg);
+}
+/**
+ * Test if the given value is an instanceof AudioNode
+ */
+export function isAudioNode(arg) {
+    return isAnyAudioNode(arg);
+}
+/**
+ * Test if the arg is instanceof an OfflineAudioContext
+ */
+export function isOfflineAudioContext(arg) {
+    return isAnyOfflineAudioContext(arg);
+}
+/**
+ * Test if the arg is an instanceof AudioContext
+ */
+export function isAudioContext(arg) {
+    return isAnyAudioContext(arg);
+}
+/**
+ * Test if the arg is instanceof an AudioBuffer
+ */
+export function isAudioBuffer(arg) {
+    return arg instanceof AudioBuffer;
+}
+//# sourceMappingURL=AdvancedTypeCheck.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AdvancedTypeCheck.js","sourceRoot":"","sources":["../../../../Tone/core/util/AdvancedTypeCheck.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,WAAW,EAAE,iBAAiB,EAC9B,cAAc,EAAE,eAAe,EAC/B,wBAAwB,EACxB,MAAM,4BAA4B,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,GAAQ;IACpC,OAAO,eAAe,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAQ;IACnC,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,GAAQ;IAC7C,OAAO,wBAAwB,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,GAAQ;IACtC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAQ;IACrC,OAAO,GAAG,YAAY,WAAW,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,34 @@
+/**
+ * Assert that the statement is true, otherwise invoke the error.
+ * @param statement
+ * @param error The message which is passed into an Error
+ */
+export declare function assert(statement: boolean, error: string): void;
+/**
+ * Make sure that the given value is within the range
+ */
+export declare function assertRange(value: number, gte: number, lte?: number): void;
+/**
+ * Make sure that the given value is within the range
+ */
+export declare function assertContextRunning(context: import("../context/BaseContext").BaseContext): void;
+/**
+ * A basic logging interface
+ */
+interface Logger {
+    log: (args?: any[]) => void;
+    warn: (args?: any[]) => void;
+}
+/**
+ * Set the logging interface
+ */
+export declare function setLogger(logger: Logger): void;
+/**
+ * Log anything
+ */
+export declare function log(...args: any[]): void;
+/**
+ * Warn anything
+ */
+export declare function warn(...args: any[]): void;
+export {};

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

@@ -0,0 +1,50 @@
+/**
+ * Assert that the statement is true, otherwise invoke the error.
+ * @param statement
+ * @param error The message which is passed into an Error
+ */
+export function assert(statement, error) {
+    if (!statement) {
+        throw new Error(error);
+    }
+}
+/**
+ * Make sure that the given value is within the range
+ */
+export function assertRange(value, gte, lte = Infinity) {
+    if (!(gte <= value && value <= lte)) {
+        throw new RangeError(`Value must be within [${gte}, ${lte}], got: ${value}`);
+    }
+}
+/**
+ * Make sure that the given value is within the range
+ */
+export function assertContextRunning(context) {
+    // add a warning if the context is not started
+    if (!context.isOffline && context.state !== "running") {
+        warn("The AudioContext is \"suspended\". Invoke Tone.start() from a user action to start the audio.");
+    }
+}
+/**
+ * The default logger is the console
+ */
+let defaultLogger = console;
+/**
+ * Set the logging interface
+ */
+export function setLogger(logger) {
+    defaultLogger = logger;
+}
+/**
+ * Log anything
+ */
+export function log(...args) {
+    defaultLogger.log(...args);
+}
+/**
+ * Warn anything
+ */
+export function warn(...args) {
+    defaultLogger.warn(...args);
+}
+//# sourceMappingURL=Debug.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Debug.js","sourceRoot":"","sources":["../../../../Tone/core/util/Debug.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,SAAkB,EAAE,KAAa;IACvD,IAAI,CAAC,SAAS,EAAE;QACf,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC;KACvB;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,GAAW,EAAE,GAAG,GAAG,QAAQ;IACrE,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,IAAI,KAAK,IAAI,GAAG,CAAC,EAAE;QACpC,MAAM,IAAI,UAAU,CAAC,yBAAyB,GAAG,KAAK,GAAG,WAAW,KAAK,EAAE,CAAC,CAAC;KAC7E;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAqD;IACzF,8CAA8C;IAC9C,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE;QACtD,IAAI,CAAC,+FAA+F,CAAC,CAAC;KACtG;AACF,CAAC;AAUD;;GAEG;AACH,IAAI,aAAa,GAAW,OAAO,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,MAAc;IACvC,aAAa,GAAG,MAAM,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,GAAG,IAAW;IACjC,aAAa,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,IAAI,CAAC,GAAG,IAAW;IAClC,aAAa,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;AAC7B,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Assert that the number is in the given range.
+ */
+export declare function range(min: number, max?: number): (target: any, propertyKey: string | symbol) => void;
+/**
+ * Convert the time to seconds and assert that the time is in between the two
+ * values when being set.
+ */
+export declare function timeRange(min: number, max?: number): (target: any, propertyKey: string) => void;