tone 14.8.27

package/build/esm/event/Part.d.ts

@@ -0,0 +1,193 @@
+import { TransportTimeClass } from "../core/type/TransportTime";
+import { NormalRange, Positive, Seconds, Ticks, Time, TransportTime } from "../core/type/Units";
+import { StateTimeline } from "../core/util/StateTimeline";
+import { ToneEvent, ToneEventCallback, ToneEventOptions } from "./ToneEvent";
+declare type CallbackType<T> = T extends {
+    time: Time;
+    [key: string]: any;
+} ? T : T extends ArrayLike<any> ? T[1] : T extends Time ? null : never;
+interface PartOptions<T> extends Omit<ToneEventOptions<CallbackType<T>>, "value"> {
+    events: T[];
+}
+/**
+ * Part is a collection ToneEvents which can be started/stopped and looped as a single unit.
+ *
+ * @example
+ * const synth = new Tone.Synth().toDestination();
+ * const part = new Tone.Part(((time, note) => {
+ * 	// the notes given as the second element in the array
+ * 	// will be passed in as the second argument
+ * 	synth.triggerAttackRelease(note, "8n", time);
+ * }), [[0, "C2"], ["0:2", "C3"], ["0:3:2", "G2"]]).start(0);
+ * Tone.Transport.start();
+ * @example
+ * const synth = new Tone.Synth().toDestination();
+ * // use an array of objects as long as the object has a "time" attribute
+ * const part = new Tone.Part(((time, value) => {
+ * 	// the value is an object which contains both the note and the velocity
+ * 	synth.triggerAttackRelease(value.note, "8n", time, value.velocity);
+ * }), [{ time: 0, note: "C3", velocity: 0.9 },
+ * 	{ time: "0:2", note: "C4", velocity: 0.5 }
+ * ]).start(0);
+ * Tone.Transport.start();
+ * @category Event
+ */
+export declare class Part<ValueType = any> extends ToneEvent<ValueType> {
+    readonly name: string;
+    /**
+     * Tracks the scheduled events
+     */
+    protected _state: StateTimeline<{
+        id: number;
+        offset: number;
+    }>;
+    /**
+     * The events that belong to this part
+     */
+    private _events;
+    /**
+     * @param callback The callback to invoke on each event
+     * @param events the array of events
+     */
+    constructor(callback?: ToneEventCallback<CallbackType<ValueType>>, value?: ValueType[]);
+    constructor(options?: Partial<PartOptions<ValueType>>);
+    static getDefaults(): PartOptions<any>;
+    /**
+     * Start the part at the given time.
+     * @param  time    When to start the part.
+     * @param  offset  The offset from the start of the part to begin playing at.
+     */
+    start(time?: TransportTime, offset?: Time): this;
+    /**
+     * Start the event in the given event at the correct time given
+     * the ticks and offset and looping.
+     * @param  event
+     * @param  ticks
+     * @param  offset
+     */
+    private _startNote;
+    get startOffset(): Ticks;
+    set startOffset(offset: Ticks);
+    /**
+     * Stop the part at the given time.
+     * @param  time  When to stop the part.
+     */
+    stop(time?: TransportTime): this;
+    /**
+     * Get/Set an Event's value at the given time.
+     * If a value is passed in and no event exists at
+     * the given time, one will be created with that value.
+     * If two events are at the same time, the first one will
+     * be returned.
+     * @example
+     * const part = new Tone.Part();
+     * part.at("1m"); // returns the part at the first measure
+     * part.at("2m", "C2"); // set the value at "2m" to C2.
+     * // if an event didn't exist at that time, it will be created.
+     * @param time The time of the event to get or set.
+     * @param value If a value is passed in, the value of the event at the given time will be set to it.
+     */
+    at(time: Time, value?: any): ToneEvent | null;
+    /**
+     * Add a an event to the part.
+     * @param time The time the note should start. If an object is passed in, it should
+     * 		have a 'time' attribute and the rest of the object will be used as the 'value'.
+     * @param  value
+     * @example
+     * const part = new Tone.Part();
+     * part.add("1m", "C#+11");
+     */
+    add(obj: {
+        time: Time;
+        [key: string]: any;
+    }): this;
+    add(time: Time, value?: any): this;
+    /**
+     * Restart the given event
+     */
+    private _restartEvent;
+    /**
+     * Remove an event from the part. If the event at that time is a Part,
+     * it will remove the entire part.
+     * @param time The time of the event
+     * @param value Optionally select only a specific event value
+     */
+    remove(obj: {
+        time: Time;
+        [key: string]: any;
+    }): this;
+    remove(time: Time, value?: any): this;
+    /**
+     * Remove all of the notes from the group.
+     */
+    clear(): this;
+    /**
+     * Cancel scheduled state change events: i.e. "start" and "stop".
+     * @param after The time after which to cancel the scheduled events.
+     */
+    cancel(after?: TransportTime | TransportTimeClass): this;
+    /**
+     * Iterate over all of the events
+     */
+    private _forEach;
+    /**
+     * Set the attribute of all of the events
+     * @param  attr  the attribute to set
+     * @param  value      The value to set it to
+     */
+    private _setAll;
+    /**
+     * Internal tick method
+     * @param  time  The time of the event in seconds
+     */
+    protected _tick(time: Seconds, value?: any): void;
+    /**
+     * Determine if the event should be currently looping
+     * given the loop boundries of this Part.
+     * @param  event  The event to test
+     */
+    private _testLoopBoundries;
+    get probability(): NormalRange;
+    set probability(prob: NormalRange);
+    get humanize(): boolean | Time;
+    set humanize(variation: boolean | Time);
+    /**
+     * If the part should loop or not
+     * between Part.loopStart and
+     * Part.loopEnd. If set to true,
+     * the part will loop indefinitely,
+     * if set to a number greater than 1
+     * it will play a specific number of
+     * times, if set to false, 0 or 1, the
+     * part will only play once.
+     * @example
+     * const part = new Tone.Part();
+     * // loop the part 8 times
+     * part.loop = 8;
+     */
+    get loop(): boolean | number;
+    set loop(loop: boolean | number);
+    /**
+     * The loopEnd point determines when it will
+     * loop if Part.loop is true.
+     */
+    get loopEnd(): Time;
+    set loopEnd(loopEnd: Time);
+    /**
+     * The loopStart point determines when it will
+     * loop if Part.loop is true.
+     */
+    get loopStart(): Time;
+    set loopStart(loopStart: Time);
+    /**
+     * The playback rate of the part
+     */
+    get playbackRate(): Positive;
+    set playbackRate(rate: Positive);
+    /**
+     * The number of scheduled notes in the part.
+     */
+    get length(): number;
+    dispose(): this;
+}
+export {};

package/build/esm/event/Part.js

@@ -0,0 +1,401 @@
+import { TicksClass } from "../core/type/Ticks";
+import { TransportTimeClass } from "../core/type/TransportTime";
+import { defaultArg, optionsFromArguments } from "../core/util/Defaults";
+import { StateTimeline } from "../core/util/StateTimeline";
+import { isArray, isDefined, isObject, isUndef } from "../core/util/TypeCheck";
+import { ToneEvent } from "./ToneEvent";
+/**
+ * Part is a collection ToneEvents which can be started/stopped and looped as a single unit.
+ *
+ * @example
+ * const synth = new Tone.Synth().toDestination();
+ * const part = new Tone.Part(((time, note) => {
+ * 	// the notes given as the second element in the array
+ * 	// will be passed in as the second argument
+ * 	synth.triggerAttackRelease(note, "8n", time);
+ * }), [[0, "C2"], ["0:2", "C3"], ["0:3:2", "G2"]]).start(0);
+ * Tone.Transport.start();
+ * @example
+ * const synth = new Tone.Synth().toDestination();
+ * // use an array of objects as long as the object has a "time" attribute
+ * const part = new Tone.Part(((time, value) => {
+ * 	// the value is an object which contains both the note and the velocity
+ * 	synth.triggerAttackRelease(value.note, "8n", time, value.velocity);
+ * }), [{ time: 0, note: "C3", velocity: 0.9 },
+ * 	{ time: "0:2", note: "C4", velocity: 0.5 }
+ * ]).start(0);
+ * Tone.Transport.start();
+ * @category Event
+ */
+export class Part extends ToneEvent {
+    constructor() {
+        super(optionsFromArguments(Part.getDefaults(), arguments, ["callback", "events"]));
+        this.name = "Part";
+        /**
+         * Tracks the scheduled events
+         */
+        this._state = new StateTimeline("stopped");
+        /**
+         * The events that belong to this part
+         */
+        this._events = new Set();
+        const options = optionsFromArguments(Part.getDefaults(), arguments, ["callback", "events"]);
+        // make sure things are assigned in the right order
+        this._state.increasing = true;
+        // add the events
+        options.events.forEach(event => {
+            if (isArray(event)) {
+                this.add(event[0], event[1]);
+            }
+            else {
+                this.add(event);
+            }
+        });
+    }
+    static getDefaults() {
+        return Object.assign(ToneEvent.getDefaults(), {
+            events: [],
+        });
+    }
+    /**
+     * Start the part at the given time.
+     * @param  time    When to start the part.
+     * @param  offset  The offset from the start of the part to begin playing at.
+     */
+    start(time, offset) {
+        const ticks = this.toTicks(time);
+        if (this._state.getValueAtTime(ticks) !== "started") {
+            offset = defaultArg(offset, this._loop ? this._loopStart : 0);
+            if (this._loop) {
+                offset = defaultArg(offset, this._loopStart);
+            }
+            else {
+                offset = defaultArg(offset, 0);
+            }
+            const computedOffset = this.toTicks(offset);
+            this._state.add({
+                id: -1,
+                offset: computedOffset,
+                state: "started",
+                time: ticks,
+            });
+            this._forEach(event => {
+                this._startNote(event, ticks, computedOffset);
+            });
+        }
+        return this;
+    }
+    /**
+     * Start the event in the given event at the correct time given
+     * the ticks and offset and looping.
+     * @param  event
+     * @param  ticks
+     * @param  offset
+     */
+    _startNote(event, ticks, offset) {
+        ticks -= offset;
+        if (this._loop) {
+            if (event.startOffset >= this._loopStart && event.startOffset < this._loopEnd) {
+                if (event.startOffset < offset) {
+                    // start it on the next loop
+                    ticks += this._getLoopDuration();
+                }
+                event.start(new TicksClass(this.context, ticks));
+            }
+            else if (event.startOffset < this._loopStart && event.startOffset >= offset) {
+                event.loop = false;
+                event.start(new TicksClass(this.context, ticks));
+            }
+        }
+        else if (event.startOffset >= offset) {
+            event.start(new TicksClass(this.context, ticks));
+        }
+    }
+    get startOffset() {
+        return this._startOffset;
+    }
+    set startOffset(offset) {
+        this._startOffset = offset;
+        this._forEach(event => {
+            event.startOffset += this._startOffset;
+        });
+    }
+    /**
+     * Stop the part at the given time.
+     * @param  time  When to stop the part.
+     */
+    stop(time) {
+        const ticks = this.toTicks(time);
+        this._state.cancel(ticks);
+        this._state.setStateAtTime("stopped", ticks);
+        this._forEach(event => {
+            event.stop(time);
+        });
+        return this;
+    }
+    /**
+     * Get/Set an Event's value at the given time.
+     * If a value is passed in and no event exists at
+     * the given time, one will be created with that value.
+     * If two events are at the same time, the first one will
+     * be returned.
+     * @example
+     * const part = new Tone.Part();
+     * part.at("1m"); // returns the part at the first measure
+     * part.at("2m", "C2"); // set the value at "2m" to C2.
+     * // if an event didn't exist at that time, it will be created.
+     * @param time The time of the event to get or set.
+     * @param value If a value is passed in, the value of the event at the given time will be set to it.
+     */
+    at(time, value) {
+        const timeInTicks = new TransportTimeClass(this.context, time).toTicks();
+        const tickTime = new TicksClass(this.context, 1).toSeconds();
+        const iterator = this._events.values();
+        let result = iterator.next();
+        while (!result.done) {
+            const event = result.value;
+            if (Math.abs(timeInTicks - event.startOffset) < tickTime) {
+                if (isDefined(value)) {
+                    event.value = value;
+                }
+                return event;
+            }
+            result = iterator.next();
+        }
+        // if there was no event at that time, create one
+        if (isDefined(value)) {
+            this.add(time, value);
+            // return the new event
+            return this.at(time);
+        }
+        else {
+            return null;
+        }
+    }
+    add(time, value) {
+        // extract the parameters
+        if (time instanceof Object && Reflect.has(time, "time")) {
+            value = time;
+            time = value.time;
+        }
+        const ticks = this.toTicks(time);
+        let event;
+        if (value instanceof ToneEvent) {
+            event = value;
+            event.callback = this._tick.bind(this);
+        }
+        else {
+            event = new ToneEvent({
+                callback: this._tick.bind(this),
+                context: this.context,
+                value,
+            });
+        }
+        // the start offset
+        event.startOffset = ticks;
+        // initialize the values
+        event.set({
+            humanize: this.humanize,
+            loop: this.loop,
+            loopEnd: this.loopEnd,
+            loopStart: this.loopStart,
+            playbackRate: this.playbackRate,
+            probability: this.probability,
+        });
+        this._events.add(event);
+        // start the note if it should be played right now
+        this._restartEvent(event);
+        return this;
+    }
+    /**
+     * Restart the given event
+     */
+    _restartEvent(event) {
+        this._state.forEach((stateEvent) => {
+            if (stateEvent.state === "started") {
+                this._startNote(event, stateEvent.time, stateEvent.offset);
+            }
+            else {
+                // stop the note
+                event.stop(new TicksClass(this.context, stateEvent.time));
+            }
+        });
+    }
+    remove(time, value) {
+        // extract the parameters
+        if (isObject(time) && time.hasOwnProperty("time")) {
+            value = time;
+            time = value.time;
+        }
+        time = this.toTicks(time);
+        this._events.forEach(event => {
+            if (event.startOffset === time) {
+                if (isUndef(value) || (isDefined(value) && event.value === value)) {
+                    this._events.delete(event);
+                    event.dispose();
+                }
+            }
+        });
+        return this;
+    }
+    /**
+     * Remove all of the notes from the group.
+     */
+    clear() {
+        this._forEach(event => event.dispose());
+        this._events.clear();
+        return this;
+    }
+    /**
+     * Cancel scheduled state change events: i.e. "start" and "stop".
+     * @param after The time after which to cancel the scheduled events.
+     */
+    cancel(after) {
+        this._forEach(event => event.cancel(after));
+        this._state.cancel(this.toTicks(after));
+        return this;
+    }
+    /**
+     * Iterate over all of the events
+     */
+    _forEach(callback) {
+        if (this._events) {
+            this._events.forEach(event => {
+                if (event instanceof Part) {
+                    event._forEach(callback);
+                }
+                else {
+                    callback(event);
+                }
+            });
+        }
+        return this;
+    }
+    /**
+     * Set the attribute of all of the events
+     * @param  attr  the attribute to set
+     * @param  value      The value to set it to
+     */
+    _setAll(attr, value) {
+        this._forEach(event => {
+            event[attr] = value;
+        });
+    }
+    /**
+     * Internal tick method
+     * @param  time  The time of the event in seconds
+     */
+    _tick(time, value) {
+        if (!this.mute) {
+            this.callback(time, value);
+        }
+    }
+    /**
+     * Determine if the event should be currently looping
+     * given the loop boundries of this Part.
+     * @param  event  The event to test
+     */
+    _testLoopBoundries(event) {
+        if (this._loop && (event.startOffset < this._loopStart || event.startOffset >= this._loopEnd)) {
+            event.cancel(0);
+        }
+        else if (event.state === "stopped") {
+            // reschedule it if it's stopped
+            this._restartEvent(event);
+        }
+    }
+    get probability() {
+        return this._probability;
+    }
+    set probability(prob) {
+        this._probability = prob;
+        this._setAll("probability", prob);
+    }
+    get humanize() {
+        return this._humanize;
+    }
+    set humanize(variation) {
+        this._humanize = variation;
+        this._setAll("humanize", variation);
+    }
+    /**
+     * If the part should loop or not
+     * between Part.loopStart and
+     * Part.loopEnd. If set to true,
+     * the part will loop indefinitely,
+     * if set to a number greater than 1
+     * it will play a specific number of
+     * times, if set to false, 0 or 1, the
+     * part will only play once.
+     * @example
+     * const part = new Tone.Part();
+     * // loop the part 8 times
+     * part.loop = 8;
+     */
+    get loop() {
+        return this._loop;
+    }
+    set loop(loop) {
+        this._loop = loop;
+        this._forEach(event => {
+            event.loopStart = this.loopStart;
+            event.loopEnd = this.loopEnd;
+            event.loop = loop;
+            this._testLoopBoundries(event);
+        });
+    }
+    /**
+     * The loopEnd point determines when it will
+     * loop if Part.loop is true.
+     */
+    get loopEnd() {
+        return new TicksClass(this.context, this._loopEnd).toSeconds();
+    }
+    set loopEnd(loopEnd) {
+        this._loopEnd = this.toTicks(loopEnd);
+        if (this._loop) {
+            this._forEach(event => {
+                event.loopEnd = loopEnd;
+                this._testLoopBoundries(event);
+            });
+        }
+    }
+    /**
+     * The loopStart point determines when it will
+     * loop if Part.loop is true.
+     */
+    get loopStart() {
+        return new TicksClass(this.context, this._loopStart).toSeconds();
+    }
+    set loopStart(loopStart) {
+        this._loopStart = this.toTicks(loopStart);
+        if (this._loop) {
+            this._forEach(event => {
+                event.loopStart = this.loopStart;
+                this._testLoopBoundries(event);
+            });
+        }
+    }
+    /**
+     * The playback rate of the part
+     */
+    get playbackRate() {
+        return this._playbackRate;
+    }
+    set playbackRate(rate) {
+        this._playbackRate = rate;
+        this._setAll("playbackRate", rate);
+    }
+    /**
+     * The number of scheduled notes in the part.
+     */
+    get length() {
+        return this._events.size;
+    }
+    dispose() {
+        super.dispose();
+        this.clear();
+        return this;
+    }
+}
+//# sourceMappingURL=Part.js.map

package/build/esm/event/Part.js.map

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

package/build/esm/event/Pattern.d.ts

@@ -0,0 +1,67 @@
+import { Loop, LoopOptions } from "./Loop";
+import { PatternName } from "./PatternGenerator";
+import { ToneEventCallback } from "./ToneEvent";
+import { Seconds } from "../core/type/Units";
+export interface PatternOptions<ValueType> extends LoopOptions {
+    pattern: PatternName;
+    values: ValueType[];
+    callback: (time: Seconds, value?: ValueType) => void;
+}
+/**
+ * Pattern arpeggiates between the given notes
+ * in a number of patterns.
+ * @example
+ * const pattern = new Tone.Pattern((time, note) => {
+ * 	// the order of the notes passed in depends on the pattern
+ * }, ["C2", "D4", "E5", "A6"], "upDown");
+ * @category Event
+ */
+export declare class Pattern<ValueType> extends Loop<PatternOptions<ValueType>> {
+    readonly name: string;
+    /**
+     * The pattern generator function
+     */
+    private _pattern;
+    /**
+     * The current value
+     */
+    private _value?;
+    /**
+     * Hold the pattern type
+     */
+    private _type;
+    /**
+     * Hold the values
+     */
+    private _values;
+    /**
+     * The callback to be invoked at a regular interval
+     */
+    callback: (time: Seconds, value?: ValueType) => void;
+    /**
+     * @param  callback The callback to invoke with the event.
+     * @param  values The values to arpeggiate over.
+     * @param  pattern  The name of the pattern
+     */
+    constructor(callback?: ToneEventCallback<ValueType>, values?: ValueType[], pattern?: PatternName);
+    constructor(options?: Partial<PatternOptions<ValueType>>);
+    static getDefaults(): PatternOptions<any>;
+    /**
+     * Internal function called when the notes should be called
+     */
+    protected _tick(time: Seconds): void;
+    /**
+     * The array of events.
+     */
+    get values(): ValueType[];
+    set values(val: ValueType[]);
+    /**
+     * The current value of the pattern.
+     */
+    get value(): ValueType | undefined;
+    /**
+     * The pattern type. See Tone.CtrlPattern for the full list of patterns.
+     */
+    get pattern(): PatternName;
+    set pattern(pattern: PatternName);
+}