tone 14.8.27

package/build/esm/effect/AutoPanner.js

@@ -0,0 +1,41 @@
+import { Panner } from "../component/channel/Panner";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { LFOEffect } from "./LFOEffect";
+/**
+ * AutoPanner is a [[Panner]] with an [[LFO]] connected to the pan amount.
+ * [Related Reading](https://www.ableton.com/en/blog/autopan-chopper-effect-and-more-liveschool/).
+ *
+ * @example
+ * // create an autopanner and start it
+ * const autoPanner = new Tone.AutoPanner("4n").toDestination().start();
+ * // route an oscillator through the panner and start it
+ * const oscillator = new Tone.Oscillator().connect(autoPanner).start();
+ * @category Effect
+ */
+export class AutoPanner extends LFOEffect {
+    constructor() {
+        super(optionsFromArguments(AutoPanner.getDefaults(), arguments, ["frequency"]));
+        this.name = "AutoPanner";
+        const options = optionsFromArguments(AutoPanner.getDefaults(), arguments, ["frequency"]);
+        this._panner = new Panner({
+            context: this.context,
+            channelCount: options.channelCount
+        });
+        // connections
+        this.connectEffect(this._panner);
+        this._lfo.connect(this._panner.pan);
+        this._lfo.min = -1;
+        this._lfo.max = 1;
+    }
+    static getDefaults() {
+        return Object.assign(LFOEffect.getDefaults(), {
+            channelCount: 1
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._panner.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=AutoPanner.js.map

package/build/esm/effect/AutoPanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoPanner.js","sourceRoot":"","sources":["../../../Tone/effect/AutoPanner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,SAAS,EAAoB,MAAM,aAAa,CAAC;AAO1D;;;;;;;;;;GAUG;AACH,MAAM,OAAO,UAAW,SAAQ,SAA4B;IAc3D;QAEC,KAAK,CAAC,oBAAoB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAdxE,SAAI,GAAW,YAAY,CAAC;QAepC,MAAM,OAAO,GAAG,oBAAoB,CAAC,UAAU,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC;QAEzF,IAAI,CAAC,OAAO,GAAG,IAAI,MAAM,CAAC;YACzB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,YAAY,EAAE,OAAO,CAAC,YAAY;SAClC,CAAC,CAAC;QACH,cAAc;QACd,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,WAAW;QACjB,OAAO,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE;YAC7C,YAAY,EAAE,CAAC;SACf,CAAC,CAAC;IACJ,CAAC;IAED,OAAO;QACN,KAAK,CAAC,OAAO,EAAE,CAAC;QAChB,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;CACD"}

package/build/esm/effect/AutoWah.d.ts

@@ -0,0 +1,99 @@
+import { Effect, EffectOptions } from "./Effect";
+import { Decibels, Frequency, GainFactor, Positive, Time } from "../core/type/Units";
+import { Signal } from "../signal/Signal";
+export interface AutoWahOptions extends EffectOptions {
+    baseFrequency: Frequency;
+    octaves: Positive;
+    sensitivity: Decibels;
+    Q: Positive;
+    gain: GainFactor;
+    follower: Time;
+}
+/**
+ * AutoWah connects a [[Follower]] to a [[Filter]].
+ * The frequency of the filter, follows the input amplitude curve.
+ * Inspiration from [Tuna.js](https://github.com/Dinahmoe/tuna).
+ *
+ * @example
+ * const autoWah = new Tone.AutoWah(50, 6, -30).toDestination();
+ * // initialize the synth and connect to autowah
+ * const synth = new Tone.Synth().connect(autoWah);
+ * // Q value influences the effect of the wah - default is 2
+ * autoWah.Q.value = 6;
+ * // more audible on higher notes
+ * synth.triggerAttackRelease("C4", "8n");
+ * @category Effect
+ */
+export declare class AutoWah extends Effect<AutoWahOptions> {
+    readonly name: string;
+    /**
+     * The envelope follower. Set the attack/release
+     * timing to adjust how the envelope is followed.
+     */
+    private _follower;
+    /**
+     * scales the follower value to the frequency domain
+     */
+    private _sweepRange;
+    /**
+     * Hold the base frequency value
+     */
+    private _baseFrequency;
+    /**
+     * Private holder for the octave count
+     */
+    private _octaves;
+    /**
+     * the input gain to adjust the sensitivity
+     */
+    private _inputBoost;
+    /**
+     * Private holder for the filter
+     */
+    private _bandpass;
+    /**
+     * The peaking fitler
+     */
+    private _peaking;
+    /**
+     * The gain of the filter.
+     */
+    readonly gain: Signal<"decibels">;
+    /**
+     * The quality of the filter.
+     */
+    readonly Q: Signal<"positive">;
+    /**
+     * @param baseFrequency The frequency the filter is set to at the low point of the wah
+     * @param octaves The number of octaves above the baseFrequency the filter will sweep to when fully open.
+     * @param sensitivity The decibel threshold sensitivity for the incoming signal. Normal range of -40 to 0.
+     */
+    constructor(baseFrequency?: Frequency, octaves?: Positive, sensitivity?: Decibels);
+    constructor(options?: Partial<AutoWahOptions>);
+    static getDefaults(): AutoWahOptions;
+    /**
+     * The number of octaves that the filter will sweep above the baseFrequency.
+     */
+    get octaves(): number;
+    set octaves(octaves: number);
+    /**
+     * The follower's smoothing time
+     */
+    get follower(): Time;
+    set follower(follower: Time);
+    /**
+     * The base frequency from which the sweep will start from.
+     */
+    get baseFrequency(): Frequency;
+    set baseFrequency(baseFreq: Frequency);
+    /**
+     * The sensitivity to control how responsive to the input signal the filter is.
+     */
+    get sensitivity(): Decibels;
+    set sensitivity(sensitivity: Decibels);
+    /**
+     * sets the sweep range of the scaler
+     */
+    private _setSweepRange;
+    dispose(): this;
+}

package/build/esm/effect/AutoWah.js

@@ -0,0 +1,131 @@
+import { Effect } from "./Effect";
+import { Filter } from "../component/filter/Filter";
+import { Follower } from "../component/analysis/Follower";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { Gain } from "../core/context/Gain";
+import { dbToGain, gainToDb } from "../core/type/Conversions";
+import { ScaleExp } from "../signal/ScaleExp";
+import { readOnly } from "../core/util/Interface";
+/**
+ * AutoWah connects a [[Follower]] to a [[Filter]].
+ * The frequency of the filter, follows the input amplitude curve.
+ * Inspiration from [Tuna.js](https://github.com/Dinahmoe/tuna).
+ *
+ * @example
+ * const autoWah = new Tone.AutoWah(50, 6, -30).toDestination();
+ * // initialize the synth and connect to autowah
+ * const synth = new Tone.Synth().connect(autoWah);
+ * // Q value influences the effect of the wah - default is 2
+ * autoWah.Q.value = 6;
+ * // more audible on higher notes
+ * synth.triggerAttackRelease("C4", "8n");
+ * @category Effect
+ */
+export class AutoWah extends Effect {
+    constructor() {
+        super(optionsFromArguments(AutoWah.getDefaults(), arguments, ["baseFrequency", "octaves", "sensitivity"]));
+        this.name = "AutoWah";
+        const options = optionsFromArguments(AutoWah.getDefaults(), arguments, ["baseFrequency", "octaves", "sensitivity"]);
+        this._follower = new Follower({
+            context: this.context,
+            smoothing: options.follower,
+        });
+        this._sweepRange = new ScaleExp({
+            context: this.context,
+            min: 0,
+            max: 1,
+            exponent: 0.5,
+        });
+        this._baseFrequency = this.toFrequency(options.baseFrequency);
+        this._octaves = options.octaves;
+        this._inputBoost = new Gain({ context: this.context });
+        this._bandpass = new Filter({
+            context: this.context,
+            rolloff: -48,
+            frequency: 0,
+            Q: options.Q,
+        });
+        this._peaking = new Filter({
+            context: this.context,
+            type: "peaking"
+        });
+        this._peaking.gain.value = options.gain;
+        this.gain = this._peaking.gain;
+        this.Q = this._bandpass.Q;
+        // the control signal path
+        this.effectSend.chain(this._inputBoost, this._follower, this._sweepRange);
+        this._sweepRange.connect(this._bandpass.frequency);
+        this._sweepRange.connect(this._peaking.frequency);
+        // the filtered path
+        this.effectSend.chain(this._bandpass, this._peaking, this.effectReturn);
+        // set the initial value
+        this._setSweepRange();
+        this.sensitivity = options.sensitivity;
+        readOnly(this, ["gain", "Q"]);
+    }
+    static getDefaults() {
+        return Object.assign(Effect.getDefaults(), {
+            baseFrequency: 100,
+            octaves: 6,
+            sensitivity: 0,
+            Q: 2,
+            gain: 2,
+            follower: 0.2,
+        });
+    }
+    /**
+     * The number of octaves that the filter will sweep above the baseFrequency.
+     */
+    get octaves() {
+        return this._octaves;
+    }
+    set octaves(octaves) {
+        this._octaves = octaves;
+        this._setSweepRange();
+    }
+    /**
+     * The follower's smoothing time
+     */
+    get follower() {
+        return this._follower.smoothing;
+    }
+    set follower(follower) {
+        this._follower.smoothing = follower;
+    }
+    /**
+     * The base frequency from which the sweep will start from.
+     */
+    get baseFrequency() {
+        return this._baseFrequency;
+    }
+    set baseFrequency(baseFreq) {
+        this._baseFrequency = this.toFrequency(baseFreq);
+        this._setSweepRange();
+    }
+    /**
+     * The sensitivity to control how responsive to the input signal the filter is.
+     */
+    get sensitivity() {
+        return gainToDb(1 / this._inputBoost.gain.value);
+    }
+    set sensitivity(sensitivity) {
+        this._inputBoost.gain.value = 1 / dbToGain(sensitivity);
+    }
+    /**
+     * sets the sweep range of the scaler
+     */
+    _setSweepRange() {
+        this._sweepRange.min = this._baseFrequency;
+        this._sweepRange.max = Math.min(this._baseFrequency * Math.pow(2, this._octaves), this.context.sampleRate / 2);
+    }
+    dispose() {
+        super.dispose();
+        this._follower.dispose();
+        this._sweepRange.dispose();
+        this._bandpass.dispose();
+        this._peaking.dispose();
+        this._inputBoost.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=AutoWah.js.map

package/build/esm/effect/AutoWah.js.map

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

package/build/esm/effect/BitCrusher.d.ts

@@ -0,0 +1,40 @@
+import { ToneAudioWorkletOptions } from "../core/worklet/ToneAudioWorklet";
+import { Effect, EffectOptions } from "./Effect";
+import { Positive } from "../core/type/Units";
+import { Param } from "../core/context/Param";
+export interface BitCrusherOptions extends EffectOptions {
+    bits: Positive;
+}
+/**
+ * BitCrusher down-samples the incoming signal to a different bit depth.
+ * Lowering the bit depth of the signal creates distortion. Read more about BitCrushing
+ * on [Wikipedia](https://en.wikipedia.org/wiki/Bitcrusher).
+ * @example
+ * // initialize crusher and route a synth through it
+ * const crusher = new Tone.BitCrusher(4).toDestination();
+ * const synth = new Tone.Synth().connect(crusher);
+ * synth.triggerAttackRelease("C2", 2);
+ *
+ * @category Effect
+ */
+export declare class BitCrusher extends Effect<BitCrusherOptions> {
+    readonly name: string;
+    /**
+     * The bit depth of the effect
+     * @min 1
+     * @max 16
+     */
+    readonly bits: Param<"positive">;
+    /**
+     * The node which does the bit crushing effect. Runs in an AudioWorklet when possible.
+     */
+    private _bitCrusherWorklet;
+    constructor(bits?: Positive);
+    constructor(options?: Partial<BitCrusherWorkletOptions>);
+    static getDefaults(): BitCrusherOptions;
+    dispose(): this;
+}
+interface BitCrusherWorkletOptions extends ToneAudioWorkletOptions {
+    bits: number;
+}
+export {};

package/build/esm/effect/BitCrusher.js

@@ -0,0 +1,85 @@
+import { ToneAudioWorklet } from "../core/worklet/ToneAudioWorklet";
+import { Effect } from "./Effect";
+import { Gain } from "../core/context/Gain";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { connectSeries } from "../core/context/ToneAudioNode";
+import { Param } from "../core/context/Param";
+import { workletName } from "./BitCrusher.worklet";
+/**
+ * BitCrusher down-samples the incoming signal to a different bit depth.
+ * Lowering the bit depth of the signal creates distortion. Read more about BitCrushing
+ * on [Wikipedia](https://en.wikipedia.org/wiki/Bitcrusher).
+ * @example
+ * // initialize crusher and route a synth through it
+ * const crusher = new Tone.BitCrusher(4).toDestination();
+ * const synth = new Tone.Synth().connect(crusher);
+ * synth.triggerAttackRelease("C2", 2);
+ *
+ * @category Effect
+ */
+export class BitCrusher extends Effect {
+    constructor() {
+        super(optionsFromArguments(BitCrusher.getDefaults(), arguments, ["bits"]));
+        this.name = "BitCrusher";
+        const options = optionsFromArguments(BitCrusher.getDefaults(), arguments, ["bits"]);
+        this._bitCrusherWorklet = new BitCrusherWorklet({
+            context: this.context,
+            bits: options.bits,
+        });
+        // connect it up
+        this.connectEffect(this._bitCrusherWorklet);
+        this.bits = this._bitCrusherWorklet.bits;
+    }
+    static getDefaults() {
+        return Object.assign(Effect.getDefaults(), {
+            bits: 4,
+        });
+    }
+    dispose() {
+        super.dispose();
+        this._bitCrusherWorklet.dispose();
+        return this;
+    }
+}
+/**
+ * Internal class which creates an AudioWorklet to do the bit crushing
+ */
+class BitCrusherWorklet extends ToneAudioWorklet {
+    constructor() {
+        super(optionsFromArguments(BitCrusherWorklet.getDefaults(), arguments));
+        this.name = "BitCrusherWorklet";
+        const options = optionsFromArguments(BitCrusherWorklet.getDefaults(), arguments);
+        this.input = new Gain({ context: this.context });
+        this.output = new Gain({ context: this.context });
+        this.bits = new Param({
+            context: this.context,
+            value: options.bits,
+            units: "positive",
+            minValue: 1,
+            maxValue: 16,
+            param: this._dummyParam,
+            swappable: true,
+        });
+    }
+    static getDefaults() {
+        return Object.assign(ToneAudioWorklet.getDefaults(), {
+            bits: 12,
+        });
+    }
+    _audioWorkletName() {
+        return workletName;
+    }
+    onReady(node) {
+        connectSeries(this.input, node, this.output);
+        const bits = node.parameters.get("bits");
+        this.bits.setParam(bits);
+    }
+    dispose() {
+        super.dispose();
+        this.input.dispose();
+        this.output.dispose();
+        this.bits.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=BitCrusher.js.map

package/build/esm/effect/BitCrusher.js.map

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

package/build/esm/effect/BitCrusher.worklet.d.ts

@@ -0,0 +1,3 @@
+import "../core/worklet/SingleIOProcessor.worklet";
+export declare const workletName = "bit-crusher";
+export declare const bitCrusherWorklet = "\n\tclass BitCrusherWorklet extends SingleIOProcessor {\n\n\t\tstatic get parameterDescriptors() {\n\t\t\treturn [{\n\t\t\t\tname: \"bits\",\n\t\t\t\tdefaultValue: 12,\n\t\t\t\tminValue: 1,\n\t\t\t\tmaxValue: 16,\n\t\t\t\tautomationRate: 'k-rate'\n\t\t\t}];\n\t\t}\n\n\t\tgenerate(input, _channel, parameters) {\n\t\t\tconst step = Math.pow(0.5, parameters.bits - 1);\n\t\t\tconst val = step * Math.floor(input / step + 0.5);\n\t\t\treturn val;\n\t\t}\n\t}\n";

package/build/esm/effect/BitCrusher.worklet.js

@@ -0,0 +1,25 @@
+import "../core/worklet/SingleIOProcessor.worklet";
+import { registerProcessor } from "../core/worklet/WorkletGlobalScope";
+export const workletName = "bit-crusher";
+export const bitCrusherWorklet = /* javascript */ `
+	class BitCrusherWorklet extends SingleIOProcessor {
+
+		static get parameterDescriptors() {
+			return [{
+				name: "bits",
+				defaultValue: 12,
+				minValue: 1,
+				maxValue: 16,
+				automationRate: 'k-rate'
+			}];
+		}
+
+		generate(input, _channel, parameters) {
+			const step = Math.pow(0.5, parameters.bits - 1);
+			const val = step * Math.floor(input / step + 0.5);
+			return val;
+		}
+	}
+`;
+registerProcessor(workletName, bitCrusherWorklet);
+//# sourceMappingURL=BitCrusher.worklet.js.map

package/build/esm/effect/BitCrusher.worklet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BitCrusher.worklet.js","sourceRoot":"","sources":["../../../Tone/effect/BitCrusher.worklet.ts"],"names":[],"mappings":"AAAA,OAAO,2CAA2C,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AAEzC,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAA;;;;;;;;;;;;;;;;;;;CAmBhD,CAAC;AAEF,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC"}

package/build/esm/effect/Chebyshev.d.ts

@@ -0,0 +1,62 @@
+import { Effect, EffectOptions } from "./Effect";
+import { Positive } from "../core/type/Units";
+export interface ChebyshevOptions extends EffectOptions {
+    order: Positive;
+    oversample: OverSampleType;
+}
+/**
+ * Chebyshev is a waveshaper which is good
+ * for making different types of distortion sounds.
+ * Note that odd orders sound very different from even ones,
+ * and order = 1 is no change.
+ * Read more at [music.columbia.edu](http://music.columbia.edu/cmc/musicandcomputers/chapter4/04_06.php).
+ * @example
+ * // create a new cheby
+ * const cheby = new Tone.Chebyshev(50).toDestination();
+ * // create a monosynth connected to our cheby
+ * const synth = new Tone.MonoSynth().connect(cheby);
+ * synth.triggerAttackRelease("C2", 0.4);
+ * @category Effect
+ */
+export declare class Chebyshev extends Effect<ChebyshevOptions> {
+    readonly name: string;
+    /**
+     * The private waveshaper node
+     */
+    private _shaper;
+    /**
+     * holds onto the order of the filter
+     */
+    private _order;
+    /**
+     * @param order The order of the chebyshev polynomial. Normal range between 1-100.
+     */
+    constructor(order?: Positive);
+    constructor(options?: Partial<ChebyshevOptions>);
+    static getDefaults(): ChebyshevOptions;
+    /**
+     * get the coefficient for that degree
+     * @param  x the x value
+     * @param  degree
+     * @param  memo memoize the computed value. this speeds up computation greatly.
+     */
+    private _getCoefficient;
+    /**
+     * The order of the Chebyshev polynomial which creates the equation which is applied to the incoming
+     * signal through a Tone.WaveShaper. Must be an integer. The equations are in the form:
+     * ```
+     * order 2: 2x^2 + 1
+     * order 3: 4x^3 + 3x
+     * ```
+     * @min 1
+     * @max 100
+     */
+    get order(): Positive;
+    set order(order: Positive);
+    /**
+     * The oversampling of the effect. Can either be "none", "2x" or "4x".
+     */
+    get oversample(): OverSampleType;
+    set oversample(oversampling: OverSampleType);
+    dispose(): this;
+}

package/build/esm/effect/Chebyshev.js

@@ -0,0 +1,95 @@
+import { Effect } from "./Effect";
+import { optionsFromArguments } from "../core/util/Defaults";
+import { WaveShaper } from "../signal/WaveShaper";
+import { assert } from "../core/util/Debug";
+/**
+ * Chebyshev is a waveshaper which is good
+ * for making different types of distortion sounds.
+ * Note that odd orders sound very different from even ones,
+ * and order = 1 is no change.
+ * Read more at [music.columbia.edu](http://music.columbia.edu/cmc/musicandcomputers/chapter4/04_06.php).
+ * @example
+ * // create a new cheby
+ * const cheby = new Tone.Chebyshev(50).toDestination();
+ * // create a monosynth connected to our cheby
+ * const synth = new Tone.MonoSynth().connect(cheby);
+ * synth.triggerAttackRelease("C2", 0.4);
+ * @category Effect
+ */
+export class Chebyshev extends Effect {
+    constructor() {
+        super(optionsFromArguments(Chebyshev.getDefaults(), arguments, ["order"]));
+        this.name = "Chebyshev";
+        const options = optionsFromArguments(Chebyshev.getDefaults(), arguments, ["order"]);
+        this._shaper = new WaveShaper({
+            context: this.context,
+            length: 4096
+        });
+        this._order = options.order;
+        this.connectEffect(this._shaper);
+        this.order = options.order;
+        this.oversample = options.oversample;
+    }
+    static getDefaults() {
+        return Object.assign(Effect.getDefaults(), {
+            order: 1,
+            oversample: "none"
+        });
+    }
+    /**
+     * get the coefficient for that degree
+     * @param  x the x value
+     * @param  degree
+     * @param  memo memoize the computed value. this speeds up computation greatly.
+     */
+    _getCoefficient(x, degree, memo) {
+        if (memo.has(degree)) {
+            return memo.get(degree);
+        }
+        else if (degree === 0) {
+            memo.set(degree, 0);
+        }
+        else if (degree === 1) {
+            memo.set(degree, x);
+        }
+        else {
+            memo.set(degree, 2 * x * this._getCoefficient(x, degree - 1, memo) - this._getCoefficient(x, degree - 2, memo));
+        }
+        return memo.get(degree);
+    }
+    /**
+     * The order of the Chebyshev polynomial which creates the equation which is applied to the incoming
+     * signal through a Tone.WaveShaper. Must be an integer. The equations are in the form:
+     * ```
+     * order 2: 2x^2 + 1
+     * order 3: 4x^3 + 3x
+     * ```
+     * @min 1
+     * @max 100
+     */
+    get order() {
+        return this._order;
+    }
+    set order(order) {
+        assert(Number.isInteger(order), "'order' must be an integer");
+        this._order = order;
+        this._shaper.setMap((x => {
+            return this._getCoefficient(x, order, new Map());
+        }));
+    }
+    /**
+     * The oversampling of the effect. Can either be "none", "2x" or "4x".
+     */
+    get oversample() {
+        return this._shaper.oversample;
+    }
+    set oversample(oversampling) {
+        this._shaper.oversample = oversampling;
+    }
+    dispose() {
+        super.dispose();
+        this._shaper.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=Chebyshev.js.map

package/build/esm/effect/Chebyshev.js.map

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