tone 14.8.27

package/build/esm/source/oscillator/OscillatorInterface.d.ts

@@ -0,0 +1,298 @@
+import { AudioRange, Cents, Degrees, Frequency, Positive } from "../../core/type/Units";
+import { Omit } from "../../core/util/Interface";
+import { Signal } from "../../signal/Signal";
+import { SourceOptions } from "../Source";
+/**
+ * The common interface of all Oscillators
+ */
+export interface ToneOscillatorInterface {
+    /**
+     * The oscillator type without the partialsCount appended to the end
+     * @example
+     * const osc = new Tone.Oscillator();
+     * osc.type = "sine2";
+     * console.log(osc.baseType); // "sine"
+     */
+    baseType: OscillatorType | "pulse" | "pwm";
+    /**
+     * The oscillator's type. Also capable of setting the first x number of partials of the oscillator.
+     * For example: "sine4" would set be the first 4 partials of the sine wave and "triangle8" would
+     * set the first 8 partials of the triangle wave.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const osc = new Tone.Oscillator().toDestination().start();
+     * 	osc.type = "sine2";
+     * }, 0.1, 1);
+     */
+    type: ExtendedToneOscillatorType;
+    /**
+     * The frequency value of the oscillator
+     * @example
+     * const osc = new Tone.FMOscillator("Bb4").toDestination().start();
+     * osc.frequency.rampTo("D2", 3);
+     */
+    readonly frequency: Signal<"frequency">;
+    /**
+     * The detune value in cents (100th of a semitone).
+     * @example
+     * const osc = new Tone.PulseOscillator("F3").toDestination().start();
+     * // pitch it 1 octave = 12 semitones = 1200 cents
+     * osc.detune.setValueAtTime(-1200, Tone.now());
+     * osc.detune.setValueAtTime(1200, Tone.now() + 0.5);
+     * osc.detune.linearRampToValueAtTime(0, Tone.now() + 1);
+     * osc.stop(Tone.now() + 1.5);
+     */
+    readonly detune: Signal<"cents">;
+    /**
+     * The phase is the starting position within the oscillator's cycle. For example
+     * a phase of 180 would start halfway through the oscillator's cycle.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const osc = new Tone.Oscillator({
+     * 		frequency: 20,
+     * 		phase: 90
+     * 	}).toDestination().start();
+     * }, 0.1, 1);
+     */
+    phase: Degrees;
+    /**
+     * The partials describes the relative amplitude of each of the harmonics of the oscillator.
+     * The first value in the array is the first harmonic (i.e. the fundamental frequency), the
+     * second harmonic is an octave up, the third harmonic is an octave and a fifth, etc. The resulting
+     * oscillator output is composed of a sine tone at the relative amplitude at each of the harmonic intervals.
+     *
+     * Setting this value will automatically set the type to "custom".
+     * The value is an empty array when the type is not "custom".
+     * @example
+     * const osc = new Tone.Oscillator("F3").toDestination().start();
+     * setInterval(() => {
+     * 	// generate 8 random partials
+     * 	osc.partials = new Array(8).fill(0).map(() => Math.random());
+     * }, 1000);
+     */
+    partials: number[];
+    /**
+     * 'partialCount' offers an alternative way to set the number of used partials.
+     * When partialCount is 0, the maximum number of partials are used when representing
+     * the waveform using the periodicWave. When 'partials' is set, this value is
+     * not settable, but equals the length of the partials array. A square wave wave
+     * is composed of only odd harmonics up through the harmonic series. Partial count
+     * can limit the number of harmonics which are used to generate the waveform.
+     * @example
+     * const osc = new Tone.Oscillator("C3", "square").toDestination().start();
+     * osc.partialCount = 1;
+     * setInterval(() => {
+     * 	osc.partialCount++;
+     * 	console.log(osc.partialCount);
+     * }, 500);
+     */
+    partialCount?: number;
+    /**
+     * Returns an array of values which represents the waveform.
+     * @param length The length of the waveform to return
+     */
+    asArray(length: number): Promise<Float32Array>;
+}
+/**
+ * Render a segment of the oscillator to an offline context and return the results as an array
+ */
+export declare function generateWaveform(instance: any, length: number): Promise<Float32Array>;
+/**
+ * Oscillators with partials
+ */
+declare type SineWithPartials = "sine1" | "sine2" | "sine3" | "sine4" | "sine5" | "sine6" | "sine7" | "sine8" | "sine9" | "sine10" | "sine11" | "sine12" | "sine13" | "sine14" | "sine15" | "sine16" | "sine17" | "sine18" | "sine19" | "sine20" | "sine21" | "sine22" | "sine23" | "sine24" | "sine25" | "sine26" | "sine27" | "sine28" | "sine29" | "sine30" | "sine31" | "sine32";
+declare type SquareWithPartials = "square1" | "square2" | "square3" | "square4" | "square5" | "square6" | "square7" | "square8" | "square9" | "square10" | "square11" | "square12" | "square13" | "square14" | "square15" | "square16" | "square17" | "square18" | "square19" | "square20" | "square21" | "square22" | "square23" | "square24" | "square25" | "square26" | "square27" | "square28" | "square29" | "square30" | "square31" | "square32";
+declare type SawtoothWithPartials = "sawtooth1" | "sawtooth2" | "sawtooth3" | "sawtooth4" | "sawtooth5" | "sawtooth6" | "sawtooth7" | "sawtooth8" | "sawtooth9" | "sawtooth10" | "sawtooth11" | "sawtooth12" | "sawtooth13" | "sawtooth14" | "sawtooth15" | "sawtooth16" | "sawtooth17" | "sawtooth18" | "sawtooth19" | "sawtooth20" | "sawtooth21" | "sawtooth22" | "sawtooth23" | "sawtooth24" | "sawtooth25" | "sawtooth26" | "sawtooth27" | "sawtooth28" | "sawtooth29" | "sawtooth30" | "sawtooth31" | "sawtooth32";
+declare type TriangleWithPartials = "triangle1" | "triangle2" | "triangle3" | "triangle4" | "triangle5" | "triangle6" | "triangle7" | "triangle8" | "triangle9" | "triangle10" | "triangle11" | "triangle12" | "triangle13" | "triangle14" | "triangle15" | "triangle16" | "triangle17" | "triangle18" | "triangle19" | "triangle20" | "triangle21" | "triangle22" | "triangle23" | "triangle24" | "triangle25" | "triangle26" | "triangle27" | "triangle28" | "triangle29" | "triangle30" | "triangle31" | "triangle32";
+declare type TypeWithPartials = SineWithPartials | SquareWithPartials | TriangleWithPartials | SawtoothWithPartials;
+interface BaseOscillatorOptions extends SourceOptions {
+    frequency: Frequency;
+    detune: Cents;
+    phase: Degrees;
+}
+export declare type NonCustomOscillatorType = Exclude<OscillatorType, "custom">;
+declare type AllNonCustomOscillatorType = NonCustomOscillatorType | TypeWithPartials;
+export declare type ToneOscillatorType = AllNonCustomOscillatorType | "custom";
+export declare type ExtendedToneOscillatorType = ToneOscillatorType | "pwm" | "pulse";
+/**
+ * Oscillator Interfaces
+ */
+interface ToneCustomOscillatorOptions extends BaseOscillatorOptions {
+    type: "custom";
+    partials: number[];
+}
+interface ToneTypeOscillatorOptions extends BaseOscillatorOptions {
+    type: NonCustomOscillatorType;
+    partialCount?: number;
+}
+interface TonePartialOscillatorOptions extends BaseOscillatorOptions {
+    type: TypeWithPartials;
+}
+export declare type ToneOscillatorConstructorOptions = ToneCustomOscillatorOptions | ToneTypeOscillatorOptions | TonePartialOscillatorOptions;
+export interface ToneOscillatorOptions extends BaseOscillatorOptions {
+    type: ToneOscillatorType;
+    partialCount: number;
+    partials: number[];
+}
+/**
+ * FMOscillator Interface
+ */
+interface FMBaseOscillatorOptions extends BaseOscillatorOptions {
+    harmonicity: Positive;
+    modulationIndex: Positive;
+    modulationType: AllNonCustomOscillatorType;
+}
+interface FMCustomOscillatorOptions extends FMBaseOscillatorOptions {
+    type: "custom";
+    partials: number[];
+}
+interface FMTypeOscillatorOptions extends FMBaseOscillatorOptions {
+    type: NonCustomOscillatorType;
+    partialsCount?: number;
+}
+interface FMPartialsOscillatorOptions extends FMBaseOscillatorOptions {
+    type: TypeWithPartials;
+}
+export declare type FMConstructorOptions = FMTypeOscillatorOptions | FMCustomOscillatorOptions | FMPartialsOscillatorOptions;
+export interface FMOscillatorOptions extends ToneOscillatorOptions {
+    harmonicity: Positive;
+    modulationIndex: Positive;
+    modulationType: AllNonCustomOscillatorType;
+}
+/**
+ * AMOscillator Interface
+ */
+interface AMBaseOscillatorOptions extends BaseOscillatorOptions {
+    harmonicity: Positive;
+    modulationType: AllNonCustomOscillatorType;
+}
+interface AMCustomOscillatorOptions extends AMBaseOscillatorOptions {
+    type: "custom";
+    partials: number[];
+}
+interface AMTypeOscillatorOptions extends AMBaseOscillatorOptions {
+    type: NonCustomOscillatorType;
+    partialsCount?: number;
+}
+interface AMPartialsOscillatorOptions extends AMBaseOscillatorOptions {
+    type: TypeWithPartials;
+}
+export declare type AMConstructorOptions = AMCustomOscillatorOptions | AMTypeOscillatorOptions | AMPartialsOscillatorOptions;
+export interface AMOscillatorOptions extends ToneOscillatorOptions {
+    harmonicity: Positive;
+    modulationType: AllNonCustomOscillatorType;
+}
+/**
+ * FatOscillator
+ */
+interface FatBaseOscillatorOptions extends BaseOscillatorOptions {
+    spread: Cents;
+    count: Positive;
+}
+interface FatCustomOscillatorOptions extends FatBaseOscillatorOptions {
+    type: "custom";
+    partials: number[];
+}
+interface FatTypeOscillatorOptions extends FatBaseOscillatorOptions {
+    type: NonCustomOscillatorType;
+    partialCount?: number;
+}
+interface FatPartialsOscillatorOptions extends FatBaseOscillatorOptions {
+    type: TypeWithPartials;
+}
+export declare type FatConstructorOptions = FatCustomOscillatorOptions | FatTypeOscillatorOptions | FatPartialsOscillatorOptions;
+export interface FatOscillatorOptions extends ToneOscillatorOptions {
+    spread: Cents;
+    count: Positive;
+}
+/**
+ * Pulse Oscillator
+ */
+export interface PulseOscillatorOptions extends BaseOscillatorOptions {
+    type: "pulse";
+    width: AudioRange;
+}
+/**
+ * PWM Oscillator
+ */
+export interface PWMOscillatorOptions extends BaseOscillatorOptions {
+    type: "pwm";
+    modulationFrequency: Frequency;
+}
+/**
+ * OMNI OSCILLATOR
+ */
+/**
+ * FM Oscillators with partials
+ */
+declare type FMSineWithPartials = "fmsine1" | "fmsine2" | "fmsine3" | "fmsine4" | "fmsine5" | "fmsine6" | "fmsine7" | "fmsine8" | "fmsine9" | "fmsine10" | "fmsine11" | "fmsine12" | "fmsine13" | "fmsine14" | "fmsine15" | "fmsine16" | "fmsine17" | "fmsine18" | "fmsine19" | "fmsine20" | "fmsine21" | "fmsine22" | "fmsine23" | "fmsine24" | "fmsine25" | "fmsine26" | "fmsine27" | "fmsine28" | "fmsine29" | "fmsine30" | "fmsine31" | "fmsine32";
+declare type FMSquareWithPartials = "fmsquare1" | "fmsquare2" | "fmsquare3" | "fmsquare4" | "fmsquare5" | "fmsquare6" | "fmsquare7" | "fmsquare8" | "fmsquare9" | "fmsquare10" | "fmsquare11" | "fmsquare12" | "fmsquare13" | "fmsquare14" | "fmsquare15" | "fmsquare16" | "fmsquare17" | "fmsquare18" | "fmsquare19" | "fmsquare20" | "fmsquare21" | "fmsquare22" | "fmsquare23" | "fmsquare24" | "fmsquare25" | "fmsquare26" | "fmsquare27" | "fmsquare28" | "fmsquare29" | "fmsquare30" | "fmsquare31" | "fmsquare32";
+declare type FMSawtoothWithPartials = "fmsawtooth1" | "fmsawtooth2" | "fmsawtooth3" | "fmsawtooth4" | "fmsawtooth5" | "fmsawtooth6" | "fmsawtooth7" | "fmsawtooth8" | "fmsawtooth9" | "fmsawtooth10" | "fmsawtooth11" | "fmsawtooth12" | "fmsawtooth13" | "fmsawtooth14" | "fmsawtooth15" | "fmsawtooth16" | "fmsawtooth17" | "fmsawtooth18" | "fmsawtooth19" | "fmsawtooth20" | "fmsawtooth21" | "fmsawtooth22" | "fmsawtooth23" | "fmsawtooth24" | "fmsawtooth25" | "fmsawtooth26" | "fmsawtooth27" | "fmsawtooth28" | "fmsawtooth29" | "fmsawtooth30" | "fmsawtooth31" | "fmsawtooth32";
+declare type FMTriangleWithPartials = "fmtriangle1" | "fmtriangle2" | "fmtriangle3" | "fmtriangle4" | "fmtriangle5" | "fmtriangle6" | "fmtriangle7" | "fmtriangle8" | "fmtriangle9" | "fmtriangle10" | "fmtriangle11" | "fmtriangle12" | "fmtriangle13" | "fmtriangle14" | "fmtriangle15" | "fmtriangle16" | "fmtriangle17" | "fmtriangle18" | "fmtriangle19" | "fmtriangle20" | "fmtriangle21" | "fmtriangle22" | "fmtriangle23" | "fmtriangle24" | "fmtriangle25" | "fmtriangle26" | "fmtriangle27" | "fmtriangle28" | "fmtriangle29" | "fmtriangle30" | "fmtriangle31" | "fmtriangle32";
+declare type FMTypeWithPartials = FMSineWithPartials | FMSquareWithPartials | FMSawtoothWithPartials | FMTriangleWithPartials;
+/**
+ * AM Oscillators with partials
+ */
+declare type AMSineWithPartials = "amsine1" | "amsine2" | "amsine3" | "amsine4" | "amsine5" | "amsine6" | "amsine7" | "amsine8" | "amsine9" | "amsine10" | "amsine11" | "amsine12" | "amsine13" | "amsine14" | "amsine15" | "amsine16" | "amsine17" | "amsine18" | "amsine19" | "amsine20" | "amsine21" | "amsine22" | "amsine23" | "amsine24" | "amsine25" | "amsine26" | "amsine27" | "amsine28" | "amsine29" | "amsine30" | "amsine31" | "amsine32";
+declare type AMSquareWithPartials = "amsquare1" | "amsquare2" | "amsquare3" | "amsquare4" | "amsquare5" | "amsquare6" | "amsquare7" | "amsquare8" | "amsquare9" | "amsquare10" | "amsquare11" | "amsquare12" | "amsquare13" | "amsquare14" | "amsquare15" | "amsquare16" | "amsquare17" | "amsquare18" | "amsquare19" | "amsquare20" | "amsquare21" | "amsquare22" | "amsquare23" | "amsquare24" | "amsquare25" | "amsquare26" | "amsquare27" | "amsquare28" | "amsquare29" | "amsquare30" | "amsquare31" | "amsquare32";
+declare type AMSawtoothWithPartials = "amsawtooth1" | "amsawtooth2" | "amsawtooth3" | "amsawtooth4" | "amsawtooth5" | "amsawtooth6" | "amsawtooth7" | "amsawtooth8" | "amsawtooth9" | "amsawtooth10" | "amsawtooth11" | "amsawtooth12" | "amsawtooth13" | "amsawtooth14" | "amsawtooth15" | "amsawtooth16" | "amsawtooth17" | "amsawtooth18" | "amsawtooth19" | "amsawtooth20" | "amsawtooth21" | "amsawtooth22" | "amsawtooth23" | "amsawtooth24" | "amsawtooth25" | "amsawtooth26" | "amsawtooth27" | "amsawtooth28" | "amsawtooth29" | "amsawtooth30" | "amsawtooth31" | "amsawtooth32";
+declare type AMTriangleWithPartials = "amtriangle1" | "amtriangle2" | "amtriangle3" | "amtriangle4" | "amtriangle5" | "amtriangle6" | "amtriangle7" | "amtriangle8" | "amtriangle9" | "amtriangle10" | "amtriangle11" | "amtriangle12" | "amtriangle13" | "amtriangle14" | "amtriangle15" | "amtriangle16" | "amtriangle17" | "amtriangle18" | "amtriangle19" | "amtriangle20" | "amtriangle21" | "amtriangle22" | "amtriangle23" | "amtriangle24" | "amtriangle25" | "amtriangle26" | "amtriangle27" | "amtriangle28" | "amtriangle29" | "amtriangle30" | "amtriangle31" | "amtriangle32";
+declare type AMTypeWithPartials = AMSineWithPartials | AMSquareWithPartials | AMSawtoothWithPartials | AMTriangleWithPartials;
+/**
+ * Fat Oscillators with partials
+ */
+declare type FatSineWithPartials = "fatsine1" | "fatsine2" | "fatsine3" | "fatsine4" | "fatsine5" | "fatsine6" | "fatsine7" | "fatsine8" | "fatsine9" | "fatsine10" | "fatsine11" | "fatsine12" | "fatsine13" | "fatsine14" | "fatsine15" | "fatsine16" | "fatsine17" | "fatsine18" | "fatsine19" | "fatsine20" | "fatsine21" | "fatsine22" | "fatsine23" | "fatsine24" | "fatsine25" | "fatsine26" | "fatsine27" | "fatsine28" | "fatsine29" | "fatsine30" | "fatsine31" | "fatsine32";
+declare type FatSquareWithPartials = "fatsquare1" | "fatsquare2" | "fatsquare3" | "fatsquare4" | "fatsquare5" | "fatsquare6" | "fatsquare7" | "fatsquare8" | "fatsquare9" | "fatsquare10" | "fatsquare11" | "fatsquare12" | "fatsquare13" | "fatsquare14" | "fatsquare15" | "fatsquare16" | "fatsquare17" | "fatsquare18" | "fatsquare19" | "fatsquare20" | "fatsquare21" | "fatsquare22" | "fatsquare23" | "fatsquare24" | "fatsquare25" | "fatsquare26" | "fatsquare27" | "fatsquare28" | "fatsquare29" | "fatsquare30" | "fatsquare31" | "fatsquare32";
+declare type FatSawtoothWithPartials = "fatsawtooth1" | "fatsawtooth2" | "fatsawtooth3" | "fatsawtooth4" | "fatsawtooth5" | "fatsawtooth6" | "fatsawtooth7" | "fatsawtooth8" | "fatsawtooth9" | "fatsawtooth10" | "fatsawtooth11" | "fatsawtooth12" | "fatsawtooth13" | "fatsawtooth14" | "fatsawtooth15" | "fatsawtooth16" | "fatsawtooth17" | "fatsawtooth18" | "fatsawtooth19" | "fatsawtooth20" | "fatsawtooth21" | "fatsawtooth22" | "fatsawtooth23" | "fatsawtooth24" | "fatsawtooth25" | "fatsawtooth26" | "fatsawtooth27" | "fatsawtooth28" | "fatsawtooth29" | "fatsawtooth30" | "fatsawtooth31" | "fatsawtooth32";
+declare type FatTriangleWithPartials = "fattriangle1" | "fattriangle2" | "fattriangle3" | "fattriangle4" | "fattriangle5" | "fattriangle6" | "fattriangle7" | "fattriangle8" | "fattriangle9" | "fattriangle10" | "fattriangle11" | "fattriangle12" | "fattriangle13" | "fattriangle14" | "fattriangle15" | "fattriangle16" | "fattriangle17" | "fattriangle18" | "fattriangle19" | "fattriangle20" | "fattriangle21" | "fattriangle22" | "fattriangle23" | "fattriangle24" | "fattriangle25" | "fattriangle26" | "fattriangle27" | "fattriangle28" | "fattriangle29" | "fattriangle30" | "fattriangle31" | "fattriangle32";
+declare type FatTypeWithPartials = FatSineWithPartials | FatSquareWithPartials | FatSawtoothWithPartials | FatTriangleWithPartials;
+/**
+ * Omni FM
+ */
+interface OmniFMCustomOscillatorOptions extends FMBaseOscillatorOptions {
+    type: "fmcustom";
+    partials: number[];
+}
+interface OmniFMTypeOscillatorOptions extends FMBaseOscillatorOptions {
+    type: "fmsine" | "fmsquare" | "fmsawtooth" | "fmtriangle";
+    partialsCount?: number;
+}
+interface OmniFMPartialsOscillatorOptions extends FMBaseOscillatorOptions {
+    type: FMTypeWithPartials;
+}
+/**
+ * Omni AM
+ */
+interface OmniAMCustomOscillatorOptions extends AMBaseOscillatorOptions {
+    type: "amcustom";
+    partials: number[];
+}
+interface OmniAMTypeOscillatorOptions extends AMBaseOscillatorOptions {
+    type: "amsine" | "amsquare" | "amsawtooth" | "amtriangle";
+    partialsCount?: number;
+}
+interface OmniAMPartialsOscillatorOptions extends AMBaseOscillatorOptions {
+    type: AMTypeWithPartials;
+}
+/**
+ * Omni Fat
+ */
+interface OmniFatCustomOscillatorOptions extends FatBaseOscillatorOptions {
+    type: "fatcustom";
+    partials: number[];
+}
+interface OmniFatTypeOscillatorOptions extends FatBaseOscillatorOptions {
+    type: "fatsine" | "fatsquare" | "fatsawtooth" | "fattriangle";
+    partialsCount?: number;
+}
+interface OmniFatPartialsOscillatorOptions extends FatBaseOscillatorOptions {
+    type: FatTypeWithPartials;
+}
+export declare type OmniOscillatorType = "fatsine" | "fatsquare" | "fatsawtooth" | "fattriangle" | "fatcustom" | FatTypeWithPartials | "fmsine" | "fmsquare" | "fmsawtooth" | "fmtriangle" | "fmcustom" | FMTypeWithPartials | "amsine" | "amsquare" | "amsawtooth" | "amtriangle" | "amcustom" | AMTypeWithPartials | TypeWithPartials | OscillatorType | "pulse" | "pwm";
+export declare type OmniOscillatorOptions = PulseOscillatorOptions | PWMOscillatorOptions | OmniFatCustomOscillatorOptions | OmniFatTypeOscillatorOptions | OmniFatPartialsOscillatorOptions | OmniFMCustomOscillatorOptions | OmniFMTypeOscillatorOptions | OmniFMPartialsOscillatorOptions | OmniAMCustomOscillatorOptions | OmniAMTypeOscillatorOptions | OmniAMPartialsOscillatorOptions | ToneOscillatorConstructorOptions;
+declare type OmitSourceOptions<T extends BaseOscillatorOptions> = Omit<T, "frequency" | "detune" | "context">;
+/**
+ * The settable options for the omni oscillator inside of the source which excludes certain attributes that are defined by the parent class
+ */
+export declare type OmniOscillatorSynthOptions = OmitSourceOptions<PulseOscillatorOptions> | OmitSourceOptions<PWMOscillatorOptions> | OmitSourceOptions<OmniFatCustomOscillatorOptions> | OmitSourceOptions<OmniFatTypeOscillatorOptions> | OmitSourceOptions<OmniFatPartialsOscillatorOptions> | OmitSourceOptions<OmniFMCustomOscillatorOptions> | OmitSourceOptions<OmniFMTypeOscillatorOptions> | OmitSourceOptions<OmniFMPartialsOscillatorOptions> | OmitSourceOptions<OmniAMCustomOscillatorOptions> | OmitSourceOptions<OmniAMTypeOscillatorOptions> | OmitSourceOptions<OmniAMPartialsOscillatorOptions> | OmitSourceOptions<ToneCustomOscillatorOptions> | OmitSourceOptions<ToneTypeOscillatorOptions> | OmitSourceOptions<TonePartialOscillatorOptions>;
+export {};

package/build/esm/source/oscillator/OscillatorInterface.js

@@ -0,0 +1,22 @@
+import { __awaiter } from "tslib";
+import { OfflineContext } from "../../core/context/OfflineContext";
+/**
+ * Render a segment of the oscillator to an offline context and return the results as an array
+ */
+export function generateWaveform(instance, length) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const duration = length / instance.context.sampleRate;
+        const context = new OfflineContext(1, duration, instance.context.sampleRate);
+        const clone = new instance.constructor(Object.assign(instance.get(), {
+            // should do 2 iterations
+            frequency: 2 / duration,
+            // zero out the detune
+            detune: 0,
+            context
+        })).toDestination();
+        clone.start(0);
+        const buffer = yield context.render();
+        return buffer.getChannelData(0);
+    });
+}
+//# sourceMappingURL=OscillatorInterface.js.map

package/build/esm/source/oscillator/OscillatorInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OscillatorInterface.js","sourceRoot":"","sources":["../../../../Tone/source/oscillator/OscillatorInterface.ts"],"names":[],"mappings":";AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAsGnE;;GAEG;AACH,MAAM,UAAgB,gBAAgB,CAAC,QAAa,EAAE,MAAc;;QACnE,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QACtD,MAAM,OAAO,GAAG,IAAI,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC7E,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE;YACpE,yBAAyB;YACzB,SAAS,EAAE,CAAC,GAAG,QAAQ;YACvB,sBAAsB;YACtB,MAAM,EAAE,CAAC;YACT,OAAO;SACP,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACjC,CAAC;CAAA"}

package/build/esm/source/oscillator/PWMOscillator.d.ts

@@ -0,0 +1,94 @@
+import { Degrees, Frequency, Seconds, Time } from "../../core/type/Units";
+import { Signal } from "../../signal/Signal";
+import { Source } from "../Source";
+import { PWMOscillatorOptions, ToneOscillatorInterface } from "./OscillatorInterface";
+export { PWMOscillatorOptions } from "./OscillatorInterface";
+/**
+ * PWMOscillator modulates the width of a Tone.PulseOscillator
+ * at the modulationFrequency. This has the effect of continuously
+ * changing the timbre of the oscillator by altering the harmonics
+ * generated.
+ * @example
+ * return Tone.Offline(() => {
+ * 	const pwm = new Tone.PWMOscillator(60, 0.3).toDestination().start();
+ * }, 0.1, 1);
+ * @category Source
+ */
+export declare class PWMOscillator extends Source<PWMOscillatorOptions> implements ToneOscillatorInterface {
+    readonly name: string;
+    readonly sourceType = "pwm";
+    /**
+     * the pulse oscillator
+     */
+    private _pulse;
+    /**
+     * the modulator
+     */
+    private _modulator;
+    /**
+     * Scale the oscillator so it doesn't go silent
+     * at the extreme values.
+     */
+    private _scale;
+    /**
+     * The frequency control.
+     */
+    readonly frequency: Signal<"frequency">;
+    /**
+     * The detune of the oscillator.
+     */
+    readonly detune: Signal<"cents">;
+    /**
+     * The width modulation rate of the oscillator.
+     * @example
+     * return Tone.Offline(() => {
+     * 	const osc = new Tone.PWMOscillator(20, 2).toDestination().start();
+     * }, 0.1, 1);
+     */
+    readonly modulationFrequency: Signal<"frequency">;
+    /**
+     * @param {Frequency} frequency The starting frequency of the oscillator.
+     * @param {Frequency} modulationFrequency The modulation frequency of the width of the pulse.
+     */
+    constructor(frequency?: Frequency, modulationFrequency?: Frequency);
+    constructor(options?: Partial<PWMOscillatorOptions>);
+    static getDefaults(): PWMOscillatorOptions;
+    /**
+     * start the oscillator
+     */
+    protected _start(time: Time): void;
+    /**
+     * stop the oscillator
+     */
+    protected _stop(time: Time): void;
+    /**
+     * restart the oscillator
+     */
+    protected _restart(time: Seconds): void;
+    /**
+     * The type of the oscillator. Always returns "pwm".
+     */
+    get type(): "pwm";
+    /**
+     * The baseType of the oscillator. Always returns "pwm".
+     */
+    get baseType(): "pwm";
+    /**
+     * The partials of the waveform. Cannot set partials for this waveform type
+     */
+    get partials(): number[];
+    /**
+     * No partials for this waveform type.
+     */
+    get partialCount(): number;
+    /**
+     * The phase of the oscillator in degrees.
+     */
+    get phase(): Degrees;
+    set phase(phase: Degrees);
+    asArray(length?: number): Promise<Float32Array>;
+    /**
+     * Clean up.
+     */
+    dispose(): this;
+}

package/build/esm/source/oscillator/PWMOscillator.js

@@ -0,0 +1,136 @@
+import { __awaiter } from "tslib";
+import { optionsFromArguments } from "../../core/util/Defaults";
+import { readOnly } from "../../core/util/Interface";
+import { Multiply } from "../../signal/Multiply";
+import { Source } from "../Source";
+import { Oscillator } from "./Oscillator";
+import { generateWaveform } from "./OscillatorInterface";
+import { PulseOscillator } from "./PulseOscillator";
+/**
+ * PWMOscillator modulates the width of a Tone.PulseOscillator
+ * at the modulationFrequency. This has the effect of continuously
+ * changing the timbre of the oscillator by altering the harmonics
+ * generated.
+ * @example
+ * return Tone.Offline(() => {
+ * 	const pwm = new Tone.PWMOscillator(60, 0.3).toDestination().start();
+ * }, 0.1, 1);
+ * @category Source
+ */
+export class PWMOscillator extends Source {
+    constructor() {
+        super(optionsFromArguments(PWMOscillator.getDefaults(), arguments, ["frequency", "modulationFrequency"]));
+        this.name = "PWMOscillator";
+        this.sourceType = "pwm";
+        /**
+         * Scale the oscillator so it doesn't go silent
+         * at the extreme values.
+         */
+        this._scale = new Multiply({
+            context: this.context,
+            value: 2,
+        });
+        const options = optionsFromArguments(PWMOscillator.getDefaults(), arguments, ["frequency", "modulationFrequency"]);
+        this._pulse = new PulseOscillator({
+            context: this.context,
+            frequency: options.modulationFrequency,
+        });
+        // change the pulse oscillator type
+        this._pulse.carrierType = "sine";
+        this.modulationFrequency = this._pulse.frequency;
+        this._modulator = new Oscillator({
+            context: this.context,
+            detune: options.detune,
+            frequency: options.frequency,
+            onstop: () => this.onstop(this),
+            phase: options.phase,
+        });
+        this.frequency = this._modulator.frequency;
+        this.detune = this._modulator.detune;
+        // connections
+        this._modulator.chain(this._scale, this._pulse.width);
+        this._pulse.connect(this.output);
+        readOnly(this, ["modulationFrequency", "frequency", "detune"]);
+    }
+    static getDefaults() {
+        return Object.assign(Source.getDefaults(), {
+            detune: 0,
+            frequency: 440,
+            modulationFrequency: 0.4,
+            phase: 0,
+            type: "pwm",
+        });
+    }
+    /**
+     * start the oscillator
+     */
+    _start(time) {
+        time = this.toSeconds(time);
+        this._modulator.start(time);
+        this._pulse.start(time);
+    }
+    /**
+     * stop the oscillator
+     */
+    _stop(time) {
+        time = this.toSeconds(time);
+        this._modulator.stop(time);
+        this._pulse.stop(time);
+    }
+    /**
+     * restart the oscillator
+     */
+    _restart(time) {
+        this._modulator.restart(time);
+        this._pulse.restart(time);
+    }
+    /**
+     * The type of the oscillator. Always returns "pwm".
+     */
+    get type() {
+        return "pwm";
+    }
+    /**
+     * The baseType of the oscillator. Always returns "pwm".
+     */
+    get baseType() {
+        return "pwm";
+    }
+    /**
+     * The partials of the waveform. Cannot set partials for this waveform type
+     */
+    get partials() {
+        return [];
+    }
+    /**
+     * No partials for this waveform type.
+     */
+    get partialCount() {
+        return 0;
+    }
+    /**
+     * The phase of the oscillator in degrees.
+     */
+    get phase() {
+        return this._modulator.phase;
+    }
+    set phase(phase) {
+        this._modulator.phase = phase;
+    }
+    asArray(length = 1024) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return generateWaveform(this, length);
+        });
+    }
+    /**
+     * Clean up.
+     */
+    dispose() {
+        super.dispose();
+        this._pulse.dispose();
+        this._scale.dispose();
+        this._modulator.dispose();
+        return this;
+    }
+}
+//# sourceMappingURL=PWMOscillator.js.map

package/build/esm/source/oscillator/PWMOscillator.js.map

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