tone 14.8.27

package/build/esm/signal/Pow.js

@@ -0,0 +1,58 @@
+import { WaveShaper } from "./WaveShaper";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { SignalOperator } from "./SignalOperator";
+/**
+ * Pow applies an exponent to the incoming signal. The incoming signal must be AudioRange [-1, 1]
+ *
+ * @example
+ * const pow = new Tone.Pow(2);
+ * const sig = new Tone.Signal(0.5).connect(pow);
+ * // output of pow is 0.25.
+ * @category Signal
+ */
+export class Pow extends SignalOperator {
+    constructor() {
+        super(Object.assign(optionsFromArguments(Pow.getDefaults(), arguments, ["value"])));
+        this.name = "Pow";
+        const options = optionsFromArguments(Pow.getDefaults(), arguments, ["value"]);
+        this._exponentScaler = this.input = this.output = new WaveShaper({
+            context: this.context,
+            mapping: this._expFunc(options.value),
+            length: 8192,
+        });
+        this._exponent = options.value;
+    }
+    static getDefaults() {
+        return Object.assign(SignalOperator.getDefaults(), {
+            value: 1,
+        });
+    }
+    /**
+     * the function which maps the waveshaper
+     * @param exponent exponent value
+     */
+    _expFunc(exponent) {
+        return (val) => {
+            return Math.pow(Math.abs(val), exponent);
+        };
+    }
+    /**
+     * The value of the exponent.
+     */
+    get value() {
+        return this._exponent;
+    }
+    set value(exponent) {
+        this._exponent = exponent;
+        this._exponentScaler.setMap(this._expFunc(this._exponent));
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        this._exponentScaler.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Pow.js.map

package/build/esm/signal/Pow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pow.js","sourceRoot":"","sources":["../../../Tone/signal/Pow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAuB,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOlD;;;;;;;;GAQG;AACH,MAAM,OAAO,GAAI,SAAQ,cAA0B;IAiBlD;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAhB5E,SAAI,GAAW,KAAK,CAAC;QAiB7B,MAAM,OAAO,GAAG,oBAAoB,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAE9E,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC;YAChE,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC;YACrC,MAAM,EAAE,IAAI;SACZ,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;IAChC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE;YAClD,KAAK,EAAE,CAAC;SACR,CAAC,CAAC;IACJ,CAAC;IAED;;;OAGG;IACK,QAAQ,CAAC,QAAgB;QAChC,OAAO,CAAC,GAAW,EAAE,EAAE;YACtB,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QAC1C,CAAC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IACD,IAAI,KAAK,CAAC,QAAgB;QACzB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC/B,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/signal/Scale.d.ts

@@ -0,0 +1,62 @@
+import { InputNode, OutputNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+import { Add } from "./Add";
+import { Multiply } from "./Multiply";
+import { SignalOperator } from "./SignalOperator";
+export interface ScaleOptions extends ToneAudioNodeOptions {
+    min: number;
+    max: number;
+}
+/**
+ * Performs a linear scaling on an input signal.
+ * Scales a NormalRange input to between
+ * outputMin and outputMax.
+ *
+ * @example
+ * const scale = new Tone.Scale(50, 100);
+ * const signal = new Tone.Signal(0.5).connect(scale);
+ * // the output of scale equals 75
+ * @category Signal
+ */
+export declare class Scale<Options extends ScaleOptions = ScaleOptions> extends SignalOperator<Options> {
+    readonly name: string;
+    input: InputNode;
+    output: OutputNode;
+    /**
+     * Hold the multiple
+     */
+    protected _mult: Multiply;
+    /**
+     * Hold the adder
+     */
+    protected _add: Add;
+    /**
+     * Private reference to the min value
+     */
+    private _min;
+    /**
+     * Private reference to the max value
+     */
+    private _max;
+    /**
+     * @param min The output value when the input is 0.
+     * @param max The output value when the input is 1.
+     */
+    constructor(min?: number, max?: number);
+    constructor(options?: Partial<ScaleOptions>);
+    static getDefaults(): ScaleOptions;
+    /**
+     * The minimum output value. This number is output when the value input value is 0.
+     */
+    get min(): number;
+    set min(min: number);
+    /**
+     * The maximum output value. This number is output when the value input value is 1.
+     */
+    get max(): number;
+    set max(max: number);
+    /**
+     * set the values
+     */
+    private _setRange;
+    dispose(): this;
+}

package/build/esm/signal/Scale.js

@@ -0,0 +1,73 @@
+import { optionsFromArguments } from "../core/util/Defaults";
+import { Add } from "./Add";
+import { Multiply } from "./Multiply";
+import { SignalOperator } from "./SignalOperator";
+/**
+ * Performs a linear scaling on an input signal.
+ * Scales a NormalRange input to between
+ * outputMin and outputMax.
+ *
+ * @example
+ * const scale = new Tone.Scale(50, 100);
+ * const signal = new Tone.Signal(0.5).connect(scale);
+ * // the output of scale equals 75
+ * @category Signal
+ */
+export class Scale extends SignalOperator {
+    constructor() {
+        super(Object.assign(optionsFromArguments(Scale.getDefaults(), arguments, ["min", "max"])));
+        this.name = "Scale";
+        const options = optionsFromArguments(Scale.getDefaults(), arguments, ["min", "max"]);
+        this._mult = this.input = new Multiply({
+            context: this.context,
+            value: options.max - options.min,
+        });
+        this._add = this.output = new Add({
+            context: this.context,
+            value: options.min,
+        });
+        this._min = options.min;
+        this._max = options.max;
+        this.input.connect(this.output);
+    }
+    static getDefaults() {
+        return Object.assign(SignalOperator.getDefaults(), {
+            max: 1,
+            min: 0,
+        });
+    }
+    /**
+     * The minimum output value. This number is output when the value input value is 0.
+     */
+    get min() {
+        return this._min;
+    }
+    set min(min) {
+        this._min = min;
+        this._setRange();
+    }
+    /**
+     * The maximum output value. This number is output when the value input value is 1.
+     */
+    get max() {
+        return this._max;
+    }
+    set max(max) {
+        this._max = max;
+        this._setRange();
+    }
+    /**
+     * set the values
+     */
+    _setRange() {
+        this._add.value = this._min;
+        this._mult.value = this._max - this._min;
+    }
+    dispose() {
+        super.dispose();
+        this._add.dispose();
+        this._mult.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Scale.js.map

package/build/esm/signal/Scale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Scale.js","sourceRoot":"","sources":["../../../Tone/signal/Scale.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAOlD;;;;;;;;;;GAUG;AACH,MAAM,OAAO,KAAmD,SAAQ,cAAuB;IAiC9F;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAhCnF,SAAI,GAAW,OAAO,CAAC;QAiC/B,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;QAErF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC;YACtC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,OAAO,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,CAAC;YACjC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,OAAO,CAAC,GAAG;SAClB,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC;QAExB,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE;YAClD,GAAG,EAAE,CAAC;YACN,GAAG,EAAE,CAAC;SACN,CAAC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACN,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,GAAG;QACV,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,IAAI,GAAG;QACN,OAAO,IAAI,CAAC,IAAI,CAAC;IAClB,CAAC;IACD,IAAI,GAAG,CAAC,GAAG;QACV,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,IAAI,CAAC,SAAS,EAAE,CAAC;IAClB,CAAC;IAED;;OAEG;IACK,SAAS;QAChB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IAC1C,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACrB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/signal/ScaleExp.d.ts

@@ -0,0 +1,37 @@
+import { Scale, ScaleOptions } from "./Scale";
+import { Positive } from "../core/type/Units";
+export interface ScaleExpOptions extends ScaleOptions {
+    exponent: Positive;
+}
+/**
+ * Performs an exponential scaling on an input signal.
+ * Scales a NormalRange value [0,1] exponentially
+ * to the output range of outputMin to outputMax.
+ * @example
+ * const scaleExp = new Tone.ScaleExp(0, 100, 2);
+ * const signal = new Tone.Signal(0.5).connect(scaleExp);
+ * @category Signal
+ */
+export declare class ScaleExp extends Scale<ScaleExpOptions> {
+    readonly name: string;
+    /**
+     * The exponent scaler
+     */
+    private _exp;
+    /**
+     * @param min The output value when the input is 0.
+     * @param max The output value when the input is 1.
+     * @param exponent The exponent which scales the incoming signal.
+     */
+    constructor(min?: number, max?: number, exponent?: number);
+    constructor(options?: Partial<ScaleExpOptions>);
+    static getDefaults(): ScaleExpOptions;
+    /**
+     * Instead of interpolating linearly between the [[min]] and
+     * [[max]] values, setting the exponent will interpolate between
+     * the two values with an exponential curve.
+     */
+    get exponent(): Positive;
+    set exponent(exp: Positive);
+    dispose(): this;
+}

package/build/esm/signal/ScaleExp.js

@@ -0,0 +1,46 @@
+import { Scale } from "./Scale";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { Pow } from "./Pow";
+/**
+ * Performs an exponential scaling on an input signal.
+ * Scales a NormalRange value [0,1] exponentially
+ * to the output range of outputMin to outputMax.
+ * @example
+ * const scaleExp = new Tone.ScaleExp(0, 100, 2);
+ * const signal = new Tone.Signal(0.5).connect(scaleExp);
+ * @category Signal
+ */
+export class ScaleExp extends Scale {
+    constructor() {
+        super(Object.assign(optionsFromArguments(ScaleExp.getDefaults(), arguments, ["min", "max", "exponent"])));
+        this.name = "ScaleExp";
+        const options = optionsFromArguments(ScaleExp.getDefaults(), arguments, ["min", "max", "exponent"]);
+        this.input = this._exp = new Pow({
+            context: this.context,
+            value: options.exponent,
+        });
+        this._exp.connect(this._mult);
+    }
+    static getDefaults() {
+        return Object.assign(Scale.getDefaults(), {
+            exponent: 1,
+        });
+    }
+    /**
+     * Instead of interpolating linearly between the [[min]] and
+     * [[max]] values, setting the exponent will interpolate between
+     * the two values with an exponential curve.
+     */
+    get exponent() {
+        return this._exp.value;
+    }
+    set exponent(exp) {
+        this._exp.value = exp;
+    }
+    dispose() {
+        super.dispose();
+        this._exp.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=ScaleExp.js.map

package/build/esm/signal/ScaleExp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScaleExp.js","sourceRoot":"","sources":["../../../Tone/signal/ScaleExp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAgB,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAM5B;;;;;;;;GAQG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAsB;IAgBnD;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAflG,SAAI,GAAW,UAAU,CAAC;QAgBlC,MAAM,OAAO,GAAG,oBAAoB,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;QAEpG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,CAAC;YAChC,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,KAAK,EAAE,OAAO,CAAC,QAAQ;SACvB,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,EAAE,EAAE;YACzC,QAAQ,EAAE,CAAC;SACX,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAI,QAAQ;QACX,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IACxB,CAAC;IACD,IAAI,QAAQ,CAAC,GAAG;QACf,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC;IACvB,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/signal/Signal.d.ts

@@ -0,0 +1,92 @@
+import { AbstractParam } from "../core/context/AbstractParam";
+import { Param } from "../core/context/Param";
+import { InputNode, OutputNode, ToneAudioNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+import { Time, UnitMap, UnitName } from "../core/type/Units";
+import { ToneConstantSource } from "./ToneConstantSource";
+export interface SignalOptions<TypeName extends UnitName> extends ToneAudioNodeOptions {
+    value: UnitMap[TypeName];
+    units: TypeName;
+    convert: boolean;
+    minValue?: number;
+    maxValue?: number;
+}
+/**
+ * A signal is an audio-rate value. Tone.Signal is a core component of the library.
+ * Unlike a number, Signals can be scheduled with sample-level accuracy. Tone.Signal
+ * has all of the methods available to native Web Audio
+ * [AudioParam](http://webaudio.github.io/web-audio-api/#the-audioparam-interface)
+ * as well as additional conveniences. Read more about working with signals
+ * [here](https://github.com/Tonejs/Tone.js/wiki/Signals).
+ *
+ * @example
+ * const osc = new Tone.Oscillator().toDestination().start();
+ * // a scheduleable signal which can be connected to control an AudioParam or another Signal
+ * const signal = new Tone.Signal({
+ * 	value: "C4",
+ * 	units: "frequency"
+ * }).connect(osc.frequency);
+ * // the scheduled ramp controls the connected signal
+ * signal.rampTo("C2", 4, "+0.5");
+ * @category Signal
+ */
+export declare class Signal<TypeName extends UnitName = "number"> extends ToneAudioNode<SignalOptions<any>> implements AbstractParam<TypeName> {
+    readonly name: string;
+    /**
+     * Indicates if the value should be overridden on connection.
+     */
+    readonly override: boolean;
+    /**
+     * The constant source node which generates the signal
+     */
+    protected _constantSource: ToneConstantSource<TypeName>;
+    readonly output: OutputNode;
+    protected _param: Param<TypeName>;
+    readonly input: InputNode;
+    /**
+     * @param value Initial value of the signal
+     * @param units The unit name, e.g. "frequency"
+     */
+    constructor(value?: UnitMap[TypeName], units?: TypeName);
+    constructor(options?: Partial<SignalOptions<TypeName>>);
+    static getDefaults(): SignalOptions<any>;
+    connect(destination: InputNode, outputNum?: number, inputNum?: number): this;
+    dispose(): this;
+    setValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    getValueAtTime(time: Time): UnitMap[TypeName];
+    setRampPoint(time: Time): this;
+    linearRampToValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    exponentialRampToValueAtTime(value: UnitMap[TypeName], time: Time): this;
+    exponentialRampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    linearRampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    targetRampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    exponentialApproachValueAtTime(value: UnitMap[TypeName], time: Time, rampTime: Time): this;
+    setTargetAtTime(value: UnitMap[TypeName], startTime: Time, timeConstant: number): this;
+    setValueCurveAtTime(values: UnitMap[TypeName][], startTime: Time, duration: Time, scaling?: number): this;
+    cancelScheduledValues(time: Time): this;
+    cancelAndHoldAtTime(time: Time): this;
+    rampTo(value: UnitMap[TypeName], rampTime: Time, startTime?: Time): this;
+    get value(): UnitMap[TypeName];
+    set value(value: UnitMap[TypeName]);
+    get convert(): boolean;
+    set convert(convert: boolean);
+    get units(): UnitName;
+    get overridden(): boolean;
+    set overridden(overridden: boolean);
+    get maxValue(): number;
+    get minValue(): number;
+    /**
+     * See [[Param.apply]].
+     */
+    apply(param: Param | AudioParam): this;
+}
+/**
+ * When connecting from a signal, it's necessary to zero out the node destination
+ * node if that node is also a signal. If the destination is not 0, then the values
+ * will be summed. This method insures that the output of the destination signal will
+ * be the same as the source signal, making the destination signal a pass through node.
+ * @param signal The output signal to connect from
+ * @param destination the destination to connect to
+ * @param outputNum the optional output number
+ * @param inputNum the input number
+ */
+export declare function connectSignal(signal: OutputNode, destination: InputNode, outputNum?: number, inputNum?: number): void;

package/build/esm/signal/Signal.js

@@ -0,0 +1,183 @@
+import { Param } from "../core/context/Param";
+import { ToneAudioNode } from "../core/context/ToneAudioNode";
+import { connect } from "../core/context/ToneAudioNode";
+import { isAudioParam } from "../core/util/AdvancedTypeCheck";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { ToneConstantSource } from "./ToneConstantSource";
+/**
+ * A signal is an audio-rate value. Tone.Signal is a core component of the library.
+ * Unlike a number, Signals can be scheduled with sample-level accuracy. Tone.Signal
+ * has all of the methods available to native Web Audio
+ * [AudioParam](http://webaudio.github.io/web-audio-api/#the-audioparam-interface)
+ * as well as additional conveniences. Read more about working with signals
+ * [here](https://github.com/Tonejs/Tone.js/wiki/Signals).
+ *
+ * @example
+ * const osc = new Tone.Oscillator().toDestination().start();
+ * // a scheduleable signal which can be connected to control an AudioParam or another Signal
+ * const signal = new Tone.Signal({
+ * 	value: "C4",
+ * 	units: "frequency"
+ * }).connect(osc.frequency);
+ * // the scheduled ramp controls the connected signal
+ * signal.rampTo("C2", 4, "+0.5");
+ * @category Signal
+ */
+export class Signal extends ToneAudioNode {
+    constructor() {
+        super(optionsFromArguments(Signal.getDefaults(), arguments, ["value", "units"]));
+        this.name = "Signal";
+        /**
+         * Indicates if the value should be overridden on connection.
+         */
+        this.override = true;
+        const options = optionsFromArguments(Signal.getDefaults(), arguments, ["value", "units"]);
+        this.output = this._constantSource = new ToneConstantSource({
+            context: this.context,
+            convert: options.convert,
+            offset: options.value,
+            units: options.units,
+            minValue: options.minValue,
+            maxValue: options.maxValue,
+        });
+        this._constantSource.start(0);
+        this.input = this._param = this._constantSource.offset;
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioNode.getDefaults(), {
+            convert: true,
+            units: "number",
+            value: 0,
+        });
+    }
+    connect(destination, outputNum = 0, inputNum = 0) {
+        // start it only when connected to something
+        connectSignal(this, destination, outputNum, inputNum);
+        return this;
+    }
+    dispose() {
+        super.dispose();
+        this._param.dispose();
+        this._constantSource.dispose();
+        return this;
+    }
+    //-------------------------------------
+    // ABSTRACT PARAM INTERFACE
+    // just a proxy for the ConstantSourceNode's offset AudioParam
+    // all docs are generated from AbstractParam.ts
+    //-------------------------------------
+    setValueAtTime(value, time) {
+        this._param.setValueAtTime(value, time);
+        return this;
+    }
+    getValueAtTime(time) {
+        return this._param.getValueAtTime(time);
+    }
+    setRampPoint(time) {
+        this._param.setRampPoint(time);
+        return this;
+    }
+    linearRampToValueAtTime(value, time) {
+        this._param.linearRampToValueAtTime(value, time);
+        return this;
+    }
+    exponentialRampToValueAtTime(value, time) {
+        this._param.exponentialRampToValueAtTime(value, time);
+        return this;
+    }
+    exponentialRampTo(value, rampTime, startTime) {
+        this._param.exponentialRampTo(value, rampTime, startTime);
+        return this;
+    }
+    linearRampTo(value, rampTime, startTime) {
+        this._param.linearRampTo(value, rampTime, startTime);
+        return this;
+    }
+    targetRampTo(value, rampTime, startTime) {
+        this._param.targetRampTo(value, rampTime, startTime);
+        return this;
+    }
+    exponentialApproachValueAtTime(value, time, rampTime) {
+        this._param.exponentialApproachValueAtTime(value, time, rampTime);
+        return this;
+    }
+    setTargetAtTime(value, startTime, timeConstant) {
+        this._param.setTargetAtTime(value, startTime, timeConstant);
+        return this;
+    }
+    setValueCurveAtTime(values, startTime, duration, scaling) {
+        this._param.setValueCurveAtTime(values, startTime, duration, scaling);
+        return this;
+    }
+    cancelScheduledValues(time) {
+        this._param.cancelScheduledValues(time);
+        return this;
+    }
+    cancelAndHoldAtTime(time) {
+        this._param.cancelAndHoldAtTime(time);
+        return this;
+    }
+    rampTo(value, rampTime, startTime) {
+        this._param.rampTo(value, rampTime, startTime);
+        return this;
+    }
+    get value() {
+        return this._param.value;
+    }
+    set value(value) {
+        this._param.value = value;
+    }
+    get convert() {
+        return this._param.convert;
+    }
+    set convert(convert) {
+        this._param.convert = convert;
+    }
+    get units() {
+        return this._param.units;
+    }
+    get overridden() {
+        return this._param.overridden;
+    }
+    set overridden(overridden) {
+        this._param.overridden = overridden;
+    }
+    get maxValue() {
+        return this._param.maxValue;
+    }
+    get minValue() {
+        return this._param.minValue;
+    }
+    /**
+     * See [[Param.apply]].
+     */
+    apply(param) {
+        this._param.apply(param);
+        return this;
+    }
+}
+/**
+ * When connecting from a signal, it's necessary to zero out the node destination
+ * node if that node is also a signal. If the destination is not 0, then the values
+ * will be summed. This method insures that the output of the destination signal will
+ * be the same as the source signal, making the destination signal a pass through node.
+ * @param signal The output signal to connect from
+ * @param destination the destination to connect to
+ * @param outputNum the optional output number
+ * @param inputNum the input number
+ */
+export function connectSignal(signal, destination, outputNum, inputNum) {
+    if (destination instanceof Param || isAudioParam(destination) ||
+        (destination instanceof Signal && destination.override)) {
+        // cancel changes
+        destination.cancelScheduledValues(0);
+        // reset the value
+        destination.setValueAtTime(0, 0);
+        // mark the value as overridden
+        if (destination instanceof Signal) {
+            destination.overridden = true;
+        }
+    }
+    connect(signal, destination, outputNum, inputNum);
+}
+//# sourceMappingURL=Signal.js.map

package/build/esm/signal/Signal.js.map

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

package/build/esm/signal/SignalOperator.d.ts

@@ -0,0 +1,9 @@
+import { InputNode, ToneAudioNode, ToneAudioNodeOptions } from "../core/context/ToneAudioNode";
+export declare type SignalOperatorOptions = ToneAudioNodeOptions;
+/**
+ * A signal operator has an input and output and modifies the signal.
+ */
+export declare abstract class SignalOperator<Options extends SignalOperatorOptions> extends ToneAudioNode<Options> {
+    constructor(options?: Partial<Options>);
+    connect(destination: InputNode, outputNum?: number, inputNum?: number): this;
+}

package/build/esm/signal/SignalOperator.js

@@ -0,0 +1,16 @@
+import { optionsFromArguments } from "../core/util/Defaults";
+import { ToneAudioNode } from "../core/context/ToneAudioNode";
+import { connectSignal } from "./Signal";
+/**
+ * A signal operator has an input and output and modifies the signal.
+ */
+export class SignalOperator extends ToneAudioNode {
+    constructor() {
+        super(Object.assign(optionsFromArguments(SignalOperator.getDefaults(), arguments, ["context"])));
+    }
+    connect(destination, outputNum = 0, inputNum = 0) {
+        connectSignal(this, destination, outputNum, inputNum);
+        return this;
+    }
+}
+//# sourceMappingURL=SignalOperator.js.map

package/build/esm/signal/SignalOperator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SignalOperator.js","sourceRoot":"","sources":["../../../Tone/signal/SignalOperator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAa,aAAa,EAAwB,MAAM,+BAA+B,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAIzC;;GAEG;AACH,MAAM,OAAgB,cAAsD,SAAQ,aAAsB;IAGzG;QACC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IAClG,CAAC;IAED,OAAO,CAAC,WAAsB,EAAE,SAAS,GAAG,CAAC,EAAE,QAAQ,GAAG,CAAC;QAC1D,aAAa,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/signal/Subtract.d.ts

@@ -0,0 +1,48 @@
+import { Gain } from "../core/context/Gain";
+import { Param } from "../core/context/Param";
+import { Signal, SignalOptions } from "../signal/Signal";
+/**
+ * Subtract the signal connected to the input is subtracted from the signal connected
+ * The subtrahend.
+ *
+ * @example
+ * // subtract a scalar from a signal
+ * const sub = new Tone.Subtract(1);
+ * const sig = new Tone.Signal(4).connect(sub);
+ * // the output of sub is 3.
+ * @example
+ * // subtract two signals
+ * const sub = new Tone.Subtract();
+ * const sigA = new Tone.Signal(10);
+ * const sigB = new Tone.Signal(2.5);
+ * sigA.connect(sub);
+ * sigB.connect(sub.subtrahend);
+ * // output of sub is 7.5
+ * @category Signal
+ */
+export declare class Subtract extends Signal {
+    override: boolean;
+    readonly name: string;
+    /**
+     * the summing node
+     */
+    private _sum;
+    readonly input: Gain;
+    readonly output: Gain;
+    /**
+     * Negate the input of the second input before connecting it to the summing node.
+     */
+    private _neg;
+    /**
+     * The value which is subtracted from the main signal
+     */
+    subtrahend: Param<"number">;
+    /**
+     * @param value The value to subtract from the incoming signal. If the value
+     *             is omitted, it will subtract the second signal from the first.
+     */
+    constructor(value?: number);
+    constructor(options?: Partial<SignalOptions<"number">>);
+    static getDefaults(): SignalOptions<"number">;
+    dispose(): this;
+}