scribbletune 5.1.2 → 5.4.0

package/dist/index.d.ts

@@ -1,370 +1,323 @@
-// Generated by dts-bundle v0.7.3
-// Dependencies for this module:
-//   ../harmonics
-
-import { scales, chords, scale, chord } from 'harmonics';
-
-export { scale, scale as mode, scales, scales as modes, chord, chords, clip, getChordDegrees, getChordsByProgression, progression, arp, midi, };
-
-export const clip: (params: ClipParams) => NoteObject[];
-
-/**
-    * Get the chords that go with a given scale/mode
-    * This is useful only in case you want to check what chords work with a scale/mode
-    * so that you can come up with chord progressions
-    * @param  {String} mode e.g. major
-    * @return {Array} e.g.['I', 'ii', 'iii', 'IV', 'V', 'vi', 'vii°']
-    */
-export const getChordDegrees: (mode: string) => string[];
-/**
-    * Take the specified scale and degrees and return the chord names for them
-    * These can be used as the value for the `notes` param of the `clip` method
-    * @param {String} noteOctaveScale e.g. 'C4 major'
-    * @param  {String} chordDegress e.g. 'I IV V IV'
-    * @return {String} e.g. 'CM FM GM FM'
-    */
-export const getChordsByProgression: (noteOctaveScale: string, chordDegress: string) => string;
-/**
-    * Generate a chord progression based on basic music theory
-    * where we follow tonic to optionally predominant and then dominant
-    * and then randomly to predominant and continue this till we reach `count`
-    * @param scaleType e.g. M (for major chord progression), m (for minor chord progression)
-    * @param count e.g. 4
-    */
-export const progression: (scaleType: ProgressionScale, count?: number) => any[];
+export { chord, chords, scale as mode, scales as modes, scale, scales } from 'harmonics';
 
+type SizzleStyle = 'sin' | 'cos' | 'rampUp' | 'rampDown';
+type ProgressionScale = 'major' | 'minor' | 'M' | 'm';
+type SeqFn = (time: string, el: string) => void;
 /**
-  *
-  * @param chordsOrParams a string that denotes space (comma?) separated chords to be used or an object with additional properties
-  * By default, if this is a string, the count of notes generated is 8 and the order is ascending.
-  * For instance arp('CM FM') will result in an array of notes [C4, E4, G4, F4, A4, C4, C5, E5]
-  * You can even provide Params as an object.
-  * For e.g. arp({count: 8, order: '10325476', chords: 'FM_4 Gm7b5_4 AbM_4 Bbm_4 Cm_5 DbM_5 EbM_5})
-  */
-export const arp: (chordsOrParams: string | ArpParams) => string[];
-
+ * Callback function triggered when channel has a new event.
+ * @param event - one of ['loaded', 'error']
+ * @param params - object with event data
+ */
+type EventFn = (event: string, params: Record<string, unknown>) => void;
 /**
-  * Take an array of note objects to generate a MIDI file in the same location as this method is called
-  * @param  {NoteObject[]} notes    Notes are in the format: {note: ['c3'], level: 127, length: 64}
-  * @param  {String | null} fileName If a filename is not provided, then `music.mid` is used by default
-  * If `null` is passed for `fileName`, bytes are returned instead of creating a file
-  * If this method is called from a browser then it will return a HTML link that you can append in your page
-  * This link will enable the generated MIDI as a downloadable file.
-  * @param {Number | null} bpm If a value is provided, the generated midi file will be set to this bpm value.
-  */
-export const midi: (notes: NoteObject[], fileName?: string | null, bpm?: number | undefined) => string | HTMLAnchorElement | undefined;
-
+ * Callback function triggered when a note is played.
+ * @param params - object with player data
+ */
+type PlayerObserverFn = (params: Record<string, unknown>) => void;
+/** Recursive pattern element produced by expandStr */
+type PatternElement = string | PatternElement[];
+interface NVP<T> {
+    [key: string]: T;
+}
+interface NoteObject {
+    note: string[] | null;
+    length: number;
+    level: number;
+}
 interface ArpParams {
     count: number;
     order?: string;
-    chords: string | any[];
+    chords: string | string[][];
 }
-export type { ArpParams };
-
-interface ChannelParams {
-        idx?: number | string;
-        name?: string;
-        clips?: any;
-        /**
-            * Audio context (e.g. Tone.getContext())
-            */
-        context?: any;
-        /**
-            * The default MIDI amplitube/ level/ volume of a note.
-            * Used as the upper bound for accents and sizzles (where the lower bound is `accentLow`).
-            *  - Default:  `100`
-            *  - Example:  `127`
-            */
-        amp?: number;
-        /**
-            * This use is depreceated: The name of a synthesizer, listed in `Tone.js`.
-            *  - Example: `'PolySynth'`.
-            *  - See:  [GitHub ~ Tone.js/Tone/instrument](https://github.com/Tonejs/Tone.js/tree/dev/Tone/instrument)
-            *
-            * New use going forward: SynthParams
-            */
-        synth?: string | SynthParams;
-        /**
-            * A `Tone.Instrument` instance or the name of a synthesizer, listed in `Tone.js`. Only in the browser.
-            *  - Example: `'Synth'`
-            *  - Example: `new Tone.Synth()`
-            *  - Example: `getToneMonoSynth('MonoSynth:BassGuitar')`
-            *  - See:     https://github.com/scribbletune/sampler#tone-monosynths
-            */
-        instrument?: any;
-        /**
-            * The `URL` of an audio file containing an instrument sample. Supports `WAV` format.
-            *  - Example:  `'https://scribbletune.com/sounds/kick.wav'`
-            */
-        sample?: any;
-        /**
-            * A `Tone` buffer or any audio buffer.
-            *  - See:  https://tonejs.github.io/docs/13.8.25/Buffer
-            */
-        buffer?: any;
-        /**
-            * A dictionary of audio samples expressed as a `{ 'Note' : 'URI', ... }` object.
-            *  - Example: `{ 'C3': 'https://.../piano48.wav', 'C#3': '/Path/to/piano49.wav', ... }`
-            */
-        samples?: any;
-        /**
-            * A `Promise` that resolves to a `Tone.Sampler`.
-            *  - Example:  `{ sampler: getSampler('korgBass') }`
-            *  - See:      https://github.com/scribbletune/sampler#sampler
-            */
-        sampler?: any;
-        /**
-            * A `Tone.Player` instance.
-            *  - See:  https://tonejs.github.io/docs/13.8.25/Player
-            */
-        player?: any;
-        /**
-            * External sound producer object / module
-            */
-        external?: any;
-        /**
-            * Name of an effect listed in `Tone.js` or `Tone.Effect` instance. Single value or Array.
-            *  - Example:  `'Chorus'`
-            *  - Example:  `new Tone.AutoFilter()`
-            *  - Example:  `[ 'Chorus' ]`
-            *  - Example:  `[ 'Chorus', 'AutoFilter' ]`
-            *  - Example:  `[ 'Chorus', new Tone.AutoFilter() ]`
-            *  - See:  [GitHub ~ Tone.js/Tone/effect](https://github.com/Tonejs/Tone.js/tree/dev/Tone/effect)
-            */
-        effects?: any | any[];
-        /**
-            * The volume in decibels, in the range `-60` to `+12`.
-            * _(Note, not applicable to sample — it gives an error.)_
-            *  - Default:  `0` (?)
-            *  - Example:  `-18`
-            *  - See:      https://tonejs.github.io/docs/13.8.25/Volume
-            */
-        volume?: number;
-        /**
-            * Callback function triggered when a note is played.
-            */
-        eventCb?: EventFn;
-        /**
-            * Callback function triggered when a note is played.
-            */
-        playerCb?: PlayerObserverFn;
+/**
+ * Definition of a synthesizer from `Tone.js`.
+ */
+interface SynthParams {
+    /**
+     *  The name of the synthesizer, listed in `Tone.js`.
+     *  - Example: `'PolySynth'`.
+     *  - See:  [GitHub ~ Tone.js/Tone/instrument](https://github.com/Tonejs/Tone.js/tree/dev/Tone/instrument)
+     */
+    synth: string;
+    /**
+     *  Descriptive name of the preset.
+     */
+    presetName?: string;
+    /**
+     *  Object with parameters for passing to `new Tone[synth](preset)`.
+     */
+    preset: Record<string, unknown>;
 }
-export type { ChannelParams };
-
-type ChannelPattern = {
-        /**
-            * Channel index to apply the playing pattern.
-            * If no index (`idx`) is given at the creation of the Channel, it's a number, starting with 0.
-            * If index is given manually, several channels can have the same index, to be played simultaneously.
-            *  - Example:  `0`
-            *  - Example:  `1`
-            *  - Example:  `'beat'`
-            *  - Example:  `'synth'`
-            */
-        channelIdx: string;
-        /**
-            * The song structure for one channel, saying which clip to play at each step,
-            * Only the 10 first clips of each channel are available through this pattern.
-            * Those numbered by a single char between 0 and 9.
-            * `'-'` means 'silence for 1 step'.
-            * `'_'` means 'extend the last clip by 1 step'.
-            * If index is given manually, several channels can have the same index, to be played simultaneously.
-            *  - Contains: `0123456789_-`
-            *  - Example:  `'0___1___----'`
-            */
-        pattern: string;
-};
-export type { ChannelPattern };
-
 interface ClipParams {
-        /**
-            * A string or array of notes or chords names.
-            *  - Default:  `[ 'C4' ]`
-            *  - Example:  `'C4 D4 C4 D#4 C4 D4 C4 Bb3'`
-            */
-        notes?: string | (string | string[])[];
-        /**
-            * A musical rhythm, expressed using Scribbletune's pattern language,
-            * which can be adapted to output MIDI files or `Tone.js` sequences.
-            *  - Default:  `'x'`
-            *  - Contains: `x_-R[]`
-            *  - Example:  `'x_x_'`
-            */
-        pattern: string;
-        /**
-            * Randomize the order of the `notes` set in the clip.
-            *  - Default:  `false`
-            */
-        shuffle?: boolean;
-        /**
-            * Whether to apply arpeggiation.
-            *  - Default:  `false`
-            */
-        arpegiate?: boolean;
-        /**
-            * Sub-division — each `x` is a quarter note by default.
-            *  - Default: `'4n'`
-            *  - Example: `'1m'`
-            *  - See:  [Tone.js wiki ~ Time](https://github.com/Tonejs/Tone.js/wiki/Time#notation)
-            */
-        subdiv?: string;
-        /**
-            * Align start of clip playing to specific time grid.
-            *  - Default: `'1m'`
-            *  - Example: `'4m'` will align the clip to every 4 measures
-            */
-        align?: string;
-        /**
-            * Offset start of clip playing from the time grid defined by `align` parameter.
-            *  - Default: `'0'`
-            *  - Example: `'0.75m'` will offset the clip to start at 3rd beat of 4:4 measure
-            * well, `'0.75m'` won't really work... Tone.js@14.8.0 does not support fractional measures (for no good reason). Will be sending a PR to Tone.js.
-            */
-        alignOffset?: string;
-        /**
-            * The default MIDI amplitube/ level/ volume of a note.
-            * Used as the upper bound for accents and sizzles (where the lower bound is `accentLow`).
-            *  - Default:  `100`
-            *  - Example:  `127`
-            */
-        amp?: number;
-        /**
-            * Add a “sizzle” (in a manner of speaking) applied to the levels/ volumes.
-            *  - Default: `false`
-            */
-        sizzle?: boolean | SizzleStyle;
-        /**
-            * Accentuate the specified notes in the clip, expressed using `x-` (on/off).
-            *  - Example:  `'x--x'`
-            */
-        accent?: string;
-        /**
-            * The minimum level used for accents.
-            *  - Default:  `70`
-            */
-        accentLow?: number;
-        /**
-            * The number of sizzle repetitions.
-            *  - Default:  `1`
-            */
-        sizzleReps?: number;
-        /**
-            * A string or array of random notes or chords.
-            *  - Default:  `null`
-            *  - Example:  `'C4 D4 C4 D#4 C4 D4 C4 Bb3'`
-            */
-        randomNotes?: null | string | (string | string[])[];
-        /**
-            * The duration of an individual sample that is used in a browser `clip`.
-            *  - Example: `'32n'`, `'1m'`, `2.3`
-            *  - See:  [Tone.js wiki ~ Time](https://github.com/Tonejs/Tone.js/wiki/Time#notation)
-            */
-        dur?: string;
-        /**
-            * Durations of notes in a browser `clip` as a number of quarter notes.
-            * Internal usage only, please use the pattern notation (`x`,`-`,`_`) instead.
-            *  - Example: `[1, 1, 0.5, 0.25]`
-            */
-        durations?: number[];
-        /**
-            * Boolean parameter to trigger offline rendering.
-            * If true, `scribbletune.clip` returns a `Tone.Player` with a buffer containing a pre-rendered sound of the sequence
-            * If false, it returns a `Tone.Sequence` which does live rendering.
-            * Note: The rendering needs some time to complete & be saved in the buffer, before being able to playing.
-            */
-        offlineRendering?: boolean;
-        /**
-            * Callback function triggered when offline rendering is finished. Ignored when `offlineRendering: false`.
-            */
-        offlineRenderingCallback?: any;
-}
-export type { ClipParams };
-
-/**
-  * Callback function triggered when channel has a new event.
-  * @param event - one of ['loaded', 'error']
-  * @param params - object with event data
-  */
-type EventFn = (event: string, params: any) => void;
-export type { EventFn };
-
-interface NoteObject {
-    note: string[];
-    length: number;
-    level: number;
+    /**
+     * A string or array of notes or chords names.
+     *  - Default:  `[ 'C4' ]`
+     *  - Example:  `'C4 D4 C4 D#4 C4 D4 C4 Bb3'`
+     */
+    notes?: string | (string | string[])[];
+    /**
+     * A musical rhythm, expressed using Scribbletune's pattern language,
+     * which can be adapted to output MIDI files or `Tone.js` sequences.
+     *  - Default:  `'x'`
+     *  - Contains: `x_-R[]`
+     *  - Example:  `'x_x_'`
+     */
+    pattern: string;
+    /**
+     * Randomize the order of the `notes` set in the clip.
+     *  - Default:  `false`
+     */
+    shuffle?: boolean;
+    /**
+     * Whether to apply arpeggiation.
+     *  - Default:  `false`
+     */
+    arpegiate?: boolean;
+    /**
+     * Sub-division — each `x` is a quarter note by default.
+     *  - Default: `'4n'`
+     *  - Example: `'1m'`
+     *  - See:  [Tone.js wiki ~ Time](https://github.com/Tonejs/Tone.js/wiki/Time#notation)
+     */
+    subdiv?: string;
+    /**
+     * Align start of clip playing to specific time grid.
+     *  - Default: `'1m'`
+     *  - Example: `'4m'` will align the clip to every 4 measures
+     */
+    align?: string;
+    /**
+     * Offset start of clip playing from the time grid defined by `align` parameter.
+     *  - Default: `'0'`
+     *  - Example: `'0.75m'` will offset the clip to start at 3rd beat of 4:4 measure
+     */
+    alignOffset?: string;
+    /**
+     * The default MIDI amplitube/ level/ volume of a note.
+     * Used as the upper bound for accents and sizzles (where the lower bound is `accentLow`).
+     *  - Default:  `100`
+     *  - Example:  `127`
+     */
+    amp?: number;
+    /**
+     * Add a "sizzle" (in a manner of speaking) applied to the levels/ volumes.
+     *  - Default: `false`
+     */
+    sizzle?: boolean | SizzleStyle;
+    /**
+     * Accentuate the specified notes in the clip, expressed using `x-` (on/off).
+     *  - Example:  `'x--x'`
+     */
+    accent?: string;
+    /**
+     * The minimum level used for accents.
+     *  - Default:  `70`
+     */
+    accentLow?: number;
+    /**
+     * The number of sizzle repetitions.
+     *  - Default:  `1`
+     */
+    sizzleReps?: number;
+    /**
+     * A string or array of random notes or chords.
+     *  - Default:  `null`
+     *  - Example:  `'C4 D4 C4 D#4 C4 D4 C4 Bb3'`
+     */
+    randomNotes?: null | string | (string | string[])[];
+    /**
+     * The duration of an individual sample that is used in a browser `clip`.
+     *  - Example: `'32n'`, `'1m'`, `2.3`
+     *  - See:  [Tone.js wiki ~ Time](https://github.com/Tonejs/Tone.js/wiki/Time#notation)
+     */
+    dur?: string;
+    /**
+     * Durations of notes in a browser `clip` as a number of quarter notes.
+     * Internal usage only, please use the pattern notation (`x`,`-`,`_`) instead.
+     *  - Example: `[1, 1, 0.5, 0.25]`
+     */
+    durations?: number[];
+    /**
+     * Boolean parameter to trigger offline rendering.
+     * If true, `scribbletune.clip` returns a `Tone.Player` with a buffer containing a pre-rendered sound of the sequence
+     * If false, it returns a `Tone.Sequence` which does live rendering.
+     */
+    offlineRendering?: boolean;
+    /**
+     * Callback function triggered when offline rendering is finished. Ignored when `offlineRendering: false`.
+     */
+    offlineRenderingCallback?: () => void;
+    /**
+     * URL of an audio sample for standalone clip usage (without Channel).
+     *  - Example: `'https://scribbletune.com/sounds/kick.wav'`
+     */
+    sample?: string;
 }
-export type { NoteObject };
-
-interface NVP<T> {
-    [key: string]: T;
+interface ChannelParams {
+    idx?: number | string;
+    name?: string;
+    clips?: ClipParams[];
+    /**
+     * Audio context (e.g. Tone.getContext())
+     */
+    context?: ToneAudioContext;
+    /**
+     * The default MIDI amplitube/ level/ volume of a note.
+     * Used as the upper bound for accents and sizzles (where the lower bound is `accentLow`).
+     *  - Default:  `100`
+     *  - Example:  `127`
+     */
+    amp?: number;
+    /**
+     * This use is depreceated: The name of a synthesizer, listed in `Tone.js`.
+     *  - Example: `'PolySynth'`.
+     *
+     * New use going forward: SynthParams
+     */
+    synth?: string | SynthParams;
+    /**
+     * A `Tone.Instrument` instance or the name of a synthesizer, listed in `Tone.js`. Only in the browser.
+     *  - Example: `'Synth'`
+     *  - Example: `new Tone.Synth()`
+     */
+    instrument?: string | ToneInstrument;
+    /**
+     * The `URL` of an audio file containing an instrument sample. Supports `WAV` format.
+     *  - Example:  `'https://scribbletune.com/sounds/kick.wav'`
+     */
+    sample?: string;
+    /**
+     * A `Tone` buffer or any audio buffer.
+     *  - See:  https://tonejs.github.io/docs/13.8.25/Buffer
+     */
+    buffer?: string | ToneLoadable;
+    /**
+     * A dictionary of audio samples expressed as a `{ 'Note' : 'URI', ... }` object.
+     *  - Example: `{ 'C3': 'https://.../piano48.wav', 'C#3': '/Path/to/piano49.wav', ... }`
+     */
+    samples?: Record<string, string>;
+    /**
+     * A `Promise` that resolves to a `Tone.Sampler`.
+     *  - Example:  `{ sampler: getSampler('korgBass') }`
+     *  - See:      https://github.com/scribbletune/sampler#sampler
+     */
+    sampler?: ToneInstrument;
+    /**
+     * A `Tone.Player` instance.
+     *  - See:  https://tonejs.github.io/docs/13.8.25/Player
+     */
+    player?: ToneInstrument;
+    /**
+     * External sound producer object / module
+     */
+    external?: ExternalOutput;
+    /**
+     * Name of an effect listed in `Tone.js` or `Tone.Effect` instance. Single value or Array.
+     *  - Example:  `'Chorus'`
+     *  - Example:  `new Tone.AutoFilter()`
+     *  - Example:  `[ 'Chorus', 'AutoFilter' ]`
+     */
+    effects?: string | ToneNode | (string | ToneNode)[];
+    /**
+     * The volume in decibels, in the range `-60` to `+12`.
+     *  - Default:  `0`
+     *  - Example:  `-18`
+     */
+    volume?: number;
+    /**
+     * Callback function triggered when a note is played.
+     */
+    eventCb?: EventFn;
+    /**
+     * Callback function triggered when a note is played.
+     */
+    playerCb?: PlayerObserverFn;
 }
-export type { NVP };
-
+type ChannelPattern = {
+    /**
+     * Channel index to apply the playing pattern.
+     *  - Example:  `0`
+     *  - Example:  `'beat'`
+     */
+    channelIdx: string;
+    /**
+     * The song structure for one channel, saying which clip to play at each step.
+     *  - Contains: `0123456789_-`
+     *  - Example:  `'0___1___----'`
+     */
+    pattern: string;
+};
 interface PlayParams {
-        /**
-            * An array of ChannelPattern
-            */
-        channelPatterns: ChannelPattern[];
-        /**
-            * The time duration to play each clip in the patterns. Default is 4 bars.
-            *  - Default: `'4:0:0'`
-            *  - Example: `'1:0:0'`
-            *  - See: https://github.com/Tonejs/Tone.js/wiki/Time#transport-time
-            */
-        clipDuration?: string;
+    /**
+     * An array of ChannelPattern
+     */
+    channelPatterns: ChannelPattern[];
+    /**
+     * The time duration to play each clip in the patterns. Default is 4 bars.
+     *  - Default: `'4:0:0'`
+     *  - Example: `'1:0:0'`
+     */
+    clipDuration?: string;
+}
+interface TPD {
+    /** Tonic */
+    T: string[];
+    /** Predominant (or subdominant) */
+    P: string[];
+    /** Dominant */
+    D: string[];
 }
-export type { PlayParams };
 
 /**
-  * Callback function triggered when a note is played.
-  * @param params - object with player data
-  */
-type PlayerObserverFn = (params: any) => void;
-export type { PlayerObserverFn };
-
-type ProgressionScale = 'major' | 'minor' | 'M' | 'm';
-export type { ProgressionScale };
+ *
+ * @param chordsOrParams a string that denotes space (comma?) separated chords to be used or an object with additional properties
+ * By default, if this is a string, the count of notes generated is 8 and the order is ascending.
+ * For instance arp('CM FM') will result in an array of notes [C4, E4, G4, F4, A4, C4, C5, E5]
+ * You can even provide Params as an object.
+ * For e.g. arp({count: 8, order: '10325476', chords: 'FM_4 Gm7b5_4 AbM_4 Bbm_4 Cm_5 DbM_5 EbM_5})
+ */
+declare const arp: (chordsOrParams: string | ArpParams) => string[];
 
-type SeqFn = (time: string, el: string) => void;
-export type { SeqFn };
-
-type SizzleStyle = 'sin' | 'cos' | 'rampUp' | 'rampDown';
-export type { SizzleStyle };
+/**
+ * Generate an array of note objects from clip parameters (for MIDI export).
+ * Applies the pattern to notes, then optionally adds sizzle and accent dynamics.
+ */
+declare const clip: (params: ClipParams) => NoteObject[];
 
 /**
-    * Definition of a synthesizer from `Tone.js`.
-    */
-interface SynthParams {
-        /**
-            *  The name of the synthesizer, listed in `Tone.js`.
-            *  - Example: `'PolySynth'`.
-            *  - See:  [GitHub ~ Tone.js/Tone/instrument](https://github.com/Tonejs/Tone.js/tree/dev/Tone/instrument)
-            */
-        synth: string;
-        /**
-            *  Descriptive name of the preset.
-            */
-        presetName?: string;
-        /**
-            *  Object with parameters for passing to `new Tone[synth](preset)`.
-            */
-        preset: any;
-}
-export type { SynthParams };
+ * Take an array of note objects to generate a MIDI file in the same location as this method is called
+ * @param  {NoteObject[]} notes    Notes are in the format: {note: ['c3'], level: 127, length: 64}
+ * @param  {String | null} fileName If a filename is not provided, then `music.mid` is used by default
+ * If `null` is passed for `fileName`, bytes are returned instead of creating a file
+ * If this method is called from a browser then it will return a HTML link that you can append in your page
+ * This link will enable the generated MIDI as a downloadable file.
+ * @param {Number | null} bpm If a value is provided, the generated midi file will be set to this bpm value.
+ */
+declare const midi: (notes: NoteObject[], fileName?: string | null, bpm?: number) => string | HTMLAnchorElement | undefined;
 
-interface TPD {
-        /**
-            * Tonic
-            */
-        T: string[];
-        /**
-            * Predominant (or subdominant)
-            */
-        P: string[];
-        /**
-            * Dominant
-            */
-        D: string[];
-}
-export type { TPD };
+/**
+ * Get the chords that go with a given scale/mode
+ * This is useful only in case you want to check what chords work with a scale/mode
+ * so that you can come up with chord progressions
+ * @param  {String} mode e.g. major
+ * @return {Array} e.g.['I', 'ii', 'iii', 'IV', 'V', 'vi', 'vii°']
+ */
+declare const getChordDegrees: (mode: string) => string[];
+/**
+ * Take the specified scale and degrees and return the chord names for them
+ * These can be used as the value for the `notes` param of the `clip` method
+ * @param {String} noteOctaveScale e.g. 'C4 major'
+ * @param  {String} chordDegress e.g. 'I IV V IV'
+ * @return {String} e.g. 'CM FM GM FM'
+ */
+declare const getChordsByProgression: (noteOctaveScale: string, chordDegress: string) => string;
+/**
+ * Generate a chord progression based on basic music theory
+ * where we follow tonic to optionally predominant and then dominant
+ * and then randomly to predominant and continue this till we reach `count`
+ * @param scaleType e.g. M (for major chord progression), m (for minor chord progression)
+ * @param count e.g. 4
+ */
+declare const progression: (scaleType: ProgressionScale, count?: number) => string[];
 
+export { type ArpParams, type ChannelParams, type ChannelPattern, type ClipParams, type EventFn, type NVP, type NoteObject, type PatternElement, type PlayParams, type PlayerObserverFn, type ProgressionScale, type SeqFn, type SizzleStyle, type SynthParams, type TPD, arp, clip, getChordDegrees, getChordsByProgression, midi, progression };