polyphon 0.0.0-stage → 0.1.0

package/dist/notation/transform.js.map

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

package/dist/song.d.ts

@@ -0,0 +1,140 @@
+import type { Room } from './instruments/dsp/reverb.ts';
+import type { InstrumentName } from './instruments/registry.ts';
+import { type Meter, type Part } from './notation/part.ts';
+import { type TempoChange } from './tempo.ts';
+export interface Song {
+    title: string;
+    /** One line on the mood and the instrumentation */
+    description?: string;
+    /** Beats (quarter notes) per minute: the tempo the song starts at */
+    bpm: number;
+    /** Changes of tempo along the way: at once (a new section) or gliding (ritardando, accelerando) */
+    tempo?: TempoChange[];
+    /** Dead stops: moments where everything falls silent, the room's echo too, before the music crashes back in */
+    silences?: Silence[];
+    /** Time signature (default '4/4') */
+    meter?: Meter;
+    /** Eighth-note swing 0-0.5 (0.33 is roughly a triplet feel) */
+    swing?: number;
+    /** Sixteenth-note swing 0-0.5 */
+    swing16?: number;
+    /** The room (default: a medium hall) */
+    reverb?: Reverb;
+    /** A tempo-synced stereo ping-pong delay that tracks can send to */
+    delay?: Delay;
+    /** Level of the whole song (linear, default 1) */
+    gain?: number;
+    /** Mastering: EQ, glue compression and, for loud genres, a limiter */
+    master?: Master;
+    /** Plays once before the tracks start looping */
+    intro?: Track[];
+    /** The body of the song; loops unless `loop` is false */
+    tracks: Track[];
+    /** false: play the body once and end (jingles, fanfares). Default true */
+    loop?: boolean;
+}
+export interface Track {
+    /** Shown in mixers; defaults to the instrument name */
+    name?: string;
+    instrument: InstrumentName;
+    /** The notes: a part, or a melody string read in the song's meter */
+    part: Part | string;
+    /** Level (linear, default 1) */
+    gain?: number;
+    /** -1 left to 1 right */
+    pan?: number;
+    /** How much goes to the reverb, 0-1 (default 0.25) */
+    reverb?: number;
+    /** How much goes to the delay, 0-1 (default 0) */
+    delay?: number;
+    /** Duck under another track's hits, the pumping of house and EDM: that track's name (usually 'Kick'), or how deep and how long too */
+    duck?: string | Duck;
+    /** Low-pass filter: a cutoff in Hz, or a sweep */
+    lowpass?: number | Sweep;
+    /** High-pass filter: a cutoff in Hz, or a sweep */
+    highpass?: number | Sweep;
+    /** Semitones */
+    transpose?: number;
+    /** Timing looseness: the most a note may land early or late, in seconds (default 0.008, drums 0.003) */
+    humanize?: number;
+    /** Instrument settings, such as attack, release, bright, glide */
+    params?: Record<string, number>;
+    /** false: play once at the start of the section instead of repeating to fill it. Default true */
+    repeat?: boolean;
+}
+/**
+ * A dead stop from `bar` (counted from 1 at the start of the song, the intro's bars first; fractional to start mid-bar, so 32.75 is the
+ * last beat of bar 32) for `beats` quarter notes. Everything falls silent, the reverb and delay tails too, as if the room were switched off,
+ * and comes back at full level when it ends. A silence in the body happens on every pass.
+ */
+export interface Silence {
+    bar: number;
+    beats: number;
+}
+export interface Reverb extends Room {
+    /** Level of the reverb return (default 1) */
+    mix?: number;
+}
+export interface Delay {
+    /** Delay time, in sixteenth-note steps at the song's opening tempo */
+    steps: number;
+    /** Echo feedback 0-1 (default 0.35) */
+    feedback?: number;
+    /** Low-pass on the echoes, Hz (default 2800) */
+    tone?: number;
+    /** Level of the delay return (default 0.8) */
+    mix?: number;
+}
+/** Sidechain pumping: at every hit of another track (usually the kick) the level dips, then swells back */
+export interface Duck {
+    /** The name of the track whose hits duck this one, in the same section (it pumps even while that track is muted) */
+    by: string;
+    /** How far the level dips, 0-1 (default 0.7) */
+    depth?: number;
+    /** Steps until it is back up, at the song's opening tempo (default 4: a beat) */
+    release?: number;
+}
+/**
+ * A filter sweep, { step: Hz }, counted from the start of the section: the cutoff glides from one to the next (evenly in pitch) and
+ * holds before the first and after the last. `{ 0: 400, 128: 400, 256: 18000 }` stays dark for eight bars, then opens over eight more.
+ */
+export type Sweep = Record<number, number>;
+export interface Master {
+    /** Body at 150 Hz, dB */
+    warm?: number;
+    /** Pulls 1.3 kHz down, dB */
+    cut?: number;
+    /** Level of the mix, dB */
+    trim?: number;
+    /** Bus compression that glues the mix together, 0-1 (0.3 gentle, 0.6 firm) */
+    glue?: number;
+    /** Master loud: dB pushed into a brickwall limiter that keeps the peaks under -1 dBFS, between the samples too (EDM: about 6-10). The song then bypasses the gentle limiter other songs share */
+    loud?: number;
+}
+export declare const DEFAULT_REVERB: Reverb;
+/**
+ * Declare a song. It returns the song unchanged; it exists so editors can type-check and autocomplete it.
+ *
+ * @example
+ * export default defineSong({
+ *   title: 'Morning Market',
+ *   bpm: 112,
+ *   tracks: [
+ *     { instrument: 'marimba', part: 'C5:2 E5 G5 E5 | D5:4 B4:4 G4:8 |' },
+ *     { instrument: 'pizzBass', part: bassline(chords('C | G'), 'x...x...x...x...', '1 5') },
+ *   ],
+ * });
+ */
+export declare function defineSong(song: Song): Song;
+/** A track's name: its own, or its instrument's */
+export declare function trackName(track: Track): string;
+/** The part a track plays (melody strings are read in the song's meter) */
+export declare function trackPart(track: Track, meter: Meter): Part;
+/** Length of a section whose tracks have these parts: the longest, rounded up to whole bars (at least one bar) */
+export declare function sectionSteps(parts: Part[], meter: Meter): number;
+/** How long the intro and one pass of the body last, in seconds */
+export declare function songDuration(song: Song): {
+    intro: number;
+    loop: number;
+};
+//# sourceMappingURL=song.d.ts.map

package/dist/song.d.ts.map

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

package/dist/song.js

@@ -0,0 +1,45 @@
+// A song is plain data: tempo, the room it plays in, and tracks that pair an instrument with a part.
+import { melody } from './notation/melody.js';
+import { stepsPerBar } from './notation/part.js';
+import { tempoClock } from './tempo.js';
+export const DEFAULT_REVERB = { size: 1.8, damp: 0.45 };
+/**
+ * Declare a song. It returns the song unchanged; it exists so editors can type-check and autocomplete it.
+ *
+ * @example
+ * export default defineSong({
+ *   title: 'Morning Market',
+ *   bpm: 112,
+ *   tracks: [
+ *     { instrument: 'marimba', part: 'C5:2 E5 G5 E5 | D5:4 B4:4 G4:8 |' },
+ *     { instrument: 'pizzBass', part: bassline(chords('C | G'), 'x...x...x...x...', '1 5') },
+ *   ],
+ * });
+ */
+export function defineSong(song) {
+    return song;
+}
+/** A track's name: its own, or its instrument's */
+export function trackName(track) {
+    return track.name ?? track.instrument;
+}
+/** The part a track plays (melody strings are read in the song's meter) */
+export function trackPart(track, meter) {
+    return typeof track.part === 'string' ? melody(track.part, meter) : track.part;
+}
+/** Length of a section whose tracks have these parts: the longest, rounded up to whole bars (at least one bar) */
+export function sectionSteps(parts, meter) {
+    const bar = stepsPerBar(meter);
+    const longest = Math.max(bar, ...parts.map((p) => p.duration));
+    return Math.ceil(longest / bar - 1e-6) * bar;
+}
+/** How long the intro and one pass of the body last, in seconds */
+export function songDuration(song) {
+    const meter = song.meter ?? 16;
+    const steps = (tracks) => sectionSteps(tracks.map((t) => trackPart(t, meter)), meter);
+    const clock = tempoClock(song);
+    const introSteps = song.intro?.length ? steps(song.intro) : 0;
+    const intro = clock.seconds(introSteps);
+    return { intro, loop: clock.seconds(introSteps + steps(song.tracks)) - intro };
+}
+//# sourceMappingURL=song.js.map

package/dist/song.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"song.js","sourceRoot":"","sources":["../src/song.ts"],"names":[],"mappings":"AAAA,qGAAqG;AAIrG,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAyB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAoB,MAAM,YAAY,CAAC;AAuH1D,MAAM,CAAC,MAAM,cAAc,GAAW,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEhE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,UAAU,CAAC,IAAU;IACnC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,SAAS,CAAC,KAAY;IACpC,OAAO,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;AACxC,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,SAAS,CAAC,KAAY,EAAE,KAAY;IAClD,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;AACjF,CAAC;AAED,kHAAkH;AAClH,MAAM,UAAU,YAAY,CAAC,KAAa,EAAE,KAAY;IACtD,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,GAAG,CAAC;AAC/C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,YAAY,CAAC,IAAU;IACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,MAAe,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC/F,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,EAAE,CAAC;AACjF,CAAC"}

package/dist/tempo.d.ts

@@ -0,0 +1,36 @@
+import { type Meter } from './notation/part.ts';
+/**
+ * A change of tempo at the start of a bar, counted from 1 at the start of the song (the intro's bars first, then the body's).
+ * `{ bar: 90, bpm: 66 }` is a new tempo from bar 90; `{ bar: 120, bpm: 80, over: 4 }` slows down evenly to 80 across bars 120 to 123.
+ * A bar may be fractional to change mid-bar: 12.5 is halfway through bar 12.
+ */
+export interface TempoChange {
+    bar: number;
+    /** Beats (quarter notes) per minute */
+    bpm: number;
+    /** How many bars the change takes, gliding evenly from the tempo before it (default 0: at once) */
+    over?: number;
+}
+/** A song's tempo through its score: positions in steps from the start of the song, as seconds and back */
+export interface TempoClock {
+    /** Seconds from the start of the song to a step */
+    seconds(step: number): number;
+    /** The step the song has reached after `seconds` */
+    step(seconds: number): number;
+    /** Beats per minute at a step */
+    bpm(step: number): number;
+}
+/**
+ * The clock of a song (its `bpm`, `tempo` and `meter`). Each pass of a looping body plays the same changes: the body's steps follow
+ * the intro's, so a body step's time within its pass is `seconds(introSteps + step) - seconds(introSteps)`.
+ *
+ * @example
+ * const clock = tempoClock({ bpm: 120, meter: '3/4', tempo: [{ bar: 9, bpm: 60 }] });
+ * clock.seconds(8 * 12 + 4); // 12 + 0.25 * 4 = 13: eight bars at 120, then a beat at 60
+ */
+export declare function tempoClock({ bpm, tempo, meter }: {
+    bpm: number;
+    tempo?: readonly TempoChange[];
+    meter?: Meter;
+}): TempoClock;
+//# sourceMappingURL=tempo.d.ts.map

package/dist/tempo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tempo.d.ts","sourceRoot":"","sources":["../src/tempo.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAC;IACZ,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,2GAA2G;AAC3G,MAAM,WAAW,UAAU;IACzB,mDAAmD;IACnD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,oDAAoD;IACpD,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IAC9B,iCAAiC;IACjC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAeD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,EAAE,GAAG,EAAE,KAAU,EAAE,KAAK,EAAE,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,UAAU,CA8CjI"}

package/dist/tempo.js

@@ -0,0 +1,81 @@
+// Tempo through a song: changes at once (a new section) or gradually (ritardando, accelerando), and the clock that turns positions in
+// the score into seconds.
+import { stepsPerBar } from './notation/part.js';
+/** Seconds a step lasts at a tempo: 60 / bpm / 4 */
+const stepSeconds = (bpm) => 15 / bpm;
+/**
+ * The clock of a song (its `bpm`, `tempo` and `meter`). Each pass of a looping body plays the same changes: the body's steps follow
+ * the intro's, so a body step's time within its pass is `seconds(introSteps + step) - seconds(introSteps)`.
+ *
+ * @example
+ * const clock = tempoClock({ bpm: 120, meter: '3/4', tempo: [{ bar: 9, bpm: 60 }] });
+ * clock.seconds(8 * 12 + 4); // 12 + 0.25 * 4 = 13: eight bars at 120, then a beat at 60
+ */
+export function tempoClock({ bpm, tempo = [], meter }) {
+    const bar = stepsPerBar(meter);
+    if (!(bpm > 0))
+        throw new Error(`Invalid tempo: ${bpm} bpm`);
+    const spans = [{ step: 0, bpm, seconds: 0, slope: 0 }];
+    /** Hold or glide from the end of the last span to `step`, arriving at `target` bpm */
+    const to = (step, target) => {
+        const last = spans[spans.length - 1];
+        if (step <= last.step)
+            return;
+        last.slope = (target - last.bpm) / (step - last.step);
+        spans.push({ step, bpm: target, seconds: last.seconds + within(last, step - last.step), slope: 0 });
+    };
+    for (const change of [...tempo].sort((a, b) => a.bar - b.bar)) {
+        const start = (change.bar - 1) * bar;
+        const end = start + (change.over ?? 0) * bar;
+        const before = spans[spans.length - 1];
+        if (!(change.bpm > 0) || !(change.bar >= 1) || !(end >= start))
+            throw new Error(`Invalid tempo change: ${JSON.stringify(change)}`);
+        if (start < before.step - 1e-9)
+            throw new Error(`The tempo change at bar ${change.bar} starts before the change before it has finished`);
+        to(start, before.bpm);
+        if (end > start)
+            to(end, change.bpm);
+        else
+            spans[spans.length - 1].bpm = change.bpm;
+    }
+    /** The last span starting at or before `value` (a MIDI file's rubato can make thousands) */
+    const spanAt = (key, value) => {
+        let lo = 0;
+        let hi = spans.length - 1;
+        while (lo < hi) {
+            const mid = (lo + hi + 1) >> 1;
+            if (spans[mid][key] <= value)
+                lo = mid;
+            else
+                hi = mid - 1;
+        }
+        return spans[lo];
+    };
+    return {
+        seconds: (step) => {
+            const span = spanAt('step', step);
+            return span.seconds + within(span, step - span.step);
+        },
+        step: (seconds) => {
+            const span = spanAt('seconds', seconds);
+            return span.step + stepsWithin(span, seconds - span.seconds);
+        },
+        bpm: (step) => {
+            const span = spanAt('step', step);
+            return span.bpm + span.slope * Math.max(0, step - span.step);
+        },
+    };
+}
+/** Seconds for the first `steps` of a span: the tempo glides linearly, so the time is the integral of 15 / bpm(step) */
+function within({ bpm, slope }, steps) {
+    if (Math.abs(slope) < 1e-12 || steps <= 0)
+        return steps * stepSeconds(bpm);
+    return (15 / slope) * Math.log(1 + (slope * steps) / bpm);
+}
+/** Steps a span covers in its first `seconds` (the inverse of `within`) */
+function stepsWithin({ bpm, slope }, seconds) {
+    if (Math.abs(slope) < 1e-12 || seconds <= 0)
+        return seconds / stepSeconds(bpm);
+    return (bpm / slope) * Math.expm1((slope * seconds) / 15);
+}
+//# sourceMappingURL=tempo.js.map

package/dist/tempo.js.map

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

package/dist/theory.d.ts

@@ -0,0 +1,70 @@
+/** A pitch: a note name such as 'C4', 'F#3', 'Bb5', or a MIDI number (C4 = 60) */
+export type Pitch = string | number;
+/** Note name (or MIDI number) to MIDI: C4 = 60. Supports #, b, ##, bb */
+export declare function midi(pitch: Pitch): number;
+/** Frequency in Hz (A4 = 440) */
+export declare const frequency: (pitch: Pitch) => number;
+/** MIDI to a note name: 61 → 'C#4' */
+export declare const noteName: (m: number) => string;
+/** Modes and scales (semitones relative to the tonic) */
+export declare const MODES: {
+    readonly ionian: readonly [0, 2, 4, 5, 7, 9, 11];
+    readonly dorian: readonly [0, 2, 3, 5, 7, 9, 10];
+    readonly phrygian: readonly [0, 1, 3, 5, 7, 8, 10];
+    readonly lydian: readonly [0, 2, 4, 6, 7, 9, 11];
+    readonly mixolydian: readonly [0, 2, 4, 5, 7, 9, 10];
+    readonly aeolian: readonly [0, 2, 3, 5, 7, 8, 10];
+    readonly locrian: readonly [0, 1, 3, 5, 6, 8, 10];
+    readonly harmonicMinor: readonly [0, 2, 3, 5, 7, 8, 11];
+    readonly melodicMinor: readonly [0, 2, 3, 5, 7, 9, 11];
+    /** Phrygian dominant scale (Spanish / Middle Eastern flavour) */
+    readonly phrygianDom: readonly [0, 1, 4, 5, 7, 8, 10];
+    /** Hungarian minor (the Gypsy flavour of the augmented fourth) */
+    readonly hungarianMinor: readonly [0, 2, 3, 6, 7, 8, 11];
+    readonly lydianDom: readonly [0, 2, 4, 6, 7, 9, 10];
+    /** Double harmonic (Byzantine) scale */
+    readonly doubleHarmonic: readonly [0, 1, 4, 5, 7, 8, 11];
+    readonly majorPent: readonly [0, 2, 4, 7, 9];
+    readonly minorPent: readonly [0, 3, 5, 7, 10];
+    /** Japanese miyako-bushi (the In scale), used only to give the Rift an alien feel */
+    readonly inSen: readonly [0, 1, 5, 7, 10];
+    readonly wholeTone: readonly [0, 2, 4, 6, 8, 10];
+    /** Half-whole diminished scale */
+    readonly octatonic: readonly [0, 1, 3, 4, 6, 7, 9, 10];
+};
+export type Mode = keyof typeof MODES;
+/** A parsed chord symbol */
+export interface ChordInfo {
+    symbol: string;
+    /** Root pitch class 0-11 */
+    root: number;
+    /** Semitones relative to the root (sorted, may be > 12) */
+    intervals: number[];
+    /** Bass pitch class (differs from the root for slash chords) */
+    bass: number;
+    /** Third: minor third 3, major third 4, no third 0 (used when a bass line writes "3") */
+    third: number;
+}
+/** Parse a chord symbol: Am7, F#m7b5, Bb/D, Gsus4, C5, Ebmaj7s11, Dq4... */
+export declare function parseChord(symbol: string): ChordInfo;
+export interface VoicingOptions {
+    /** The register to center the chord around (default C4) */
+    center?: Pitch;
+    /** The previous voicing: pick the inversion that moves the least from it */
+    previous?: number[];
+    /** Number of notes (default: every chord tone, at least 3) */
+    size?: number;
+}
+/** Voice a chord in close position around a center; with a previous voicing, pick the smoothest inversion */
+export declare function voiceChord(chord: ChordInfo, { center, previous, size }?: VoicingOptions): number[];
+/** The note at a degree of a mode (0-based, may be negative or exceed 7) above a tonic */
+export declare function scaleDegree(tonic: Pitch, mode: Mode, degree: number): number;
+/**
+ * Mode remapping: map a note written on C's natural notes (white keys) to the same scale degree of tonic + mode.
+ * Accidentals are kept as a "semitone offset", so a C major melody can be written once and dropped into Phrygian or harmonic minor.
+ * base is the written tonic (by default the C at C4 = 60).
+ */
+export declare function remapToMode(m: number, tonic: Pitch, mode: Mode, base?: Pitch): number;
+/** Roman-numeral chord in a key, as a chord symbol: romanChord('bVII', 'D4', 'aeolian') → 'C' ('i', 'IV', 'bVII', 'v7', 'ii°') */
+export declare function romanChord(numeral: string, tonic: Pitch, mode: Mode): string;
+//# sourceMappingURL=theory.d.ts.map

package/dist/theory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theory.d.ts","sourceRoot":"","sources":["../src/theory.ts"],"names":[],"mappings":"AAEA,kFAAkF;AAClF,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAEpC,yEAAyE;AACzE,wBAAgB,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAOzC;AAED,iCAAiC;AACjC,eAAO,MAAM,SAAS,UAAW,KAAK,KAAG,MAAoD,CAAC;AAG9F,sCAAsC;AACtC,eAAO,MAAM,QAAQ,MAAO,MAAM,KAAG,MAAmE,CAAC;AAEzG,yDAAyD;AACzD,eAAO,MAAM,KAAK;;;;;;;;;;IAUhB,iEAAiE;;IAEjE,kEAAkE;;;IAGlE,wCAAwC;;;;IAIxC,qFAAqF;;;IAGrF,kCAAkC;;CAEkB,CAAC;AACvD,MAAM,MAAM,IAAI,GAAG,MAAM,OAAO,KAAK,CAAC;AAuCtC,4BAA4B;AAC5B,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,2DAA2D;IAC3D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAC;CACf;AASD,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CASpD;AAED,MAAM,WAAW,cAAc;IAC7B,2DAA2D;IAC3D,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6GAA6G;AAC7G,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,MAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAE,cAAmB,GAAG,MAAM,EAAE,CA8B3G;AAED,0FAA0F;AAC1F,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM5E;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,GAAE,KAAU,GAAG,MAAM,CAmBzF;AAED,kIAAkI;AAClI,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,CAU5E"}

package/dist/theory.js

@@ -0,0 +1,183 @@
+// Music theory: note names, modes, chord symbols, voicing and mode remapping. Pure functions only.
+/** Note name (or MIDI number) to MIDI: C4 = 60. Supports #, b, ##, bb */
+export function midi(pitch) {
+    if (typeof pitch === 'number')
+        return pitch;
+    const m = /^([A-Ga-g])(##|bb|#|b)?(-?\d)$/.exec(pitch.trim());
+    if (!m)
+        throw new Error(`Unrecognized note name: ${pitch}`);
+    const base = { C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11 }[m[1].toUpperCase()];
+    const acc = m[2] === '#' ? 1 : m[2] === '##' ? 2 : m[2] === 'b' ? -1 : m[2] === 'bb' ? -2 : 0;
+    return 12 * (Number(m[3]) + 1) + base + acc;
+}
+/** Frequency in Hz (A4 = 440) */
+export const frequency = (pitch) => 440 * Math.pow(2, (midi(pitch) - 69) / 12);
+const NAMES = ['C', 'C#', 'D', 'Eb', 'E', 'F', 'F#', 'G', 'Ab', 'A', 'Bb', 'B'];
+/** MIDI to a note name: 61 → 'C#4' */
+export const noteName = (m) => `${NAMES[((m % 12) + 12) % 12]}${Math.floor(m / 12) - 1}`;
+/** Modes and scales (semitones relative to the tonic) */
+export const MODES = {
+    ionian: [0, 2, 4, 5, 7, 9, 11],
+    dorian: [0, 2, 3, 5, 7, 9, 10],
+    phrygian: [0, 1, 3, 5, 7, 8, 10],
+    lydian: [0, 2, 4, 6, 7, 9, 11],
+    mixolydian: [0, 2, 4, 5, 7, 9, 10],
+    aeolian: [0, 2, 3, 5, 7, 8, 10],
+    locrian: [0, 1, 3, 5, 6, 8, 10],
+    harmonicMinor: [0, 2, 3, 5, 7, 8, 11],
+    melodicMinor: [0, 2, 3, 5, 7, 9, 11],
+    /** Phrygian dominant scale (Spanish / Middle Eastern flavour) */
+    phrygianDom: [0, 1, 4, 5, 7, 8, 10],
+    /** Hungarian minor (the Gypsy flavour of the augmented fourth) */
+    hungarianMinor: [0, 2, 3, 6, 7, 8, 11],
+    lydianDom: [0, 2, 4, 6, 7, 9, 10],
+    /** Double harmonic (Byzantine) scale */
+    doubleHarmonic: [0, 1, 4, 5, 7, 8, 11],
+    majorPent: [0, 2, 4, 7, 9],
+    minorPent: [0, 3, 5, 7, 10],
+    /** Japanese miyako-bushi (the In scale), used only to give the Rift an alien feel */
+    inSen: [0, 1, 5, 7, 10],
+    wholeTone: [0, 2, 4, 6, 8, 10],
+    /** Half-whole diminished scale */
+    octatonic: [0, 1, 3, 4, 6, 7, 9, 10],
+};
+/** Chord qualities (semitones relative to the root; slash-chord bass not included) */
+const QUALITIES = {
+    '': [0, 4, 7],
+    maj: [0, 4, 7],
+    m: [0, 3, 7],
+    dim: [0, 3, 6],
+    aug: [0, 4, 8],
+    '+': [0, 4, 8],
+    sus2: [0, 2, 7],
+    sus4: [0, 5, 7],
+    sus: [0, 5, 7],
+    '5': [0, 7],
+    '6': [0, 4, 7, 9],
+    m6: [0, 3, 7, 9],
+    '7': [0, 4, 7, 10],
+    maj7: [0, 4, 7, 11],
+    m7: [0, 3, 7, 10],
+    mmaj7: [0, 3, 7, 11],
+    m7b5: [0, 3, 6, 10],
+    dim7: [0, 3, 6, 9],
+    '7sus4': [0, 5, 7, 10],
+    add9: [0, 4, 7, 14],
+    madd9: [0, 3, 7, 14],
+    '9': [0, 4, 7, 10, 14],
+    maj9: [0, 4, 7, 11, 14],
+    m9: [0, 3, 7, 10, 14],
+    '7b9': [0, 4, 7, 10, 13],
+    '7#9': [0, 4, 7, 10, 15],
+    m11: [0, 3, 7, 10, 14, 17],
+    '11': [0, 7, 10, 14, 17],
+    maj7s11: [0, 4, 7, 11, 18],
+    '6/9': [0, 4, 7, 9, 14],
+    /** Stacked fourths (ethereal, floating) */
+    q: [0, 5, 10],
+    q4: [0, 5, 10, 15],
+};
+const PC = { C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11 };
+const pcOf = (s) => {
+    const m = /^([A-G])(#|b)?$/.exec(s);
+    if (!m)
+        throw new Error(`Unrecognized root note: ${s}`);
+    return (PC[m[1]] + (m[2] === '#' ? 1 : m[2] === 'b' ? -1 : 0) + 12) % 12;
+};
+/** Parse a chord symbol: Am7, F#m7b5, Bb/D, Gsus4, C5, Ebmaj7s11, Dq4... */
+export function parseChord(symbol) {
+    const m = /^([A-G](?:#|b)?)([^/]*)(?:\/([A-G](?:#|b)?))?$/.exec(symbol.trim());
+    if (!m)
+        throw new Error(`Unrecognized chord: ${symbol}`);
+    const root = pcOf(m[1]);
+    const q = m[2];
+    const iv = QUALITIES[q];
+    if (!iv)
+        throw new Error(`Unrecognized chord quality "${q}" (${symbol})`);
+    const third = iv.includes(4) ? 4 : iv.includes(3) ? 3 : 0;
+    return { symbol, root, intervals: [...iv], bass: m[3] ? pcOf(m[3]) : root, third };
+}
+/** Voice a chord in close position around a center; with a previous voicing, pick the smoothest inversion */
+export function voiceChord(chord, { center = 60, previous, size } = {}) {
+    const mid0 = midi(center);
+    const pcs = chord.intervals.map((i) => (chord.root + i) % 12);
+    const uniq = [...new Set(pcs)];
+    const n = size ?? Math.max(3, uniq.length);
+    // List every inversion: starting from the first note above center-9 or center-3, stack upward
+    const cands = [];
+    for (let inv = 0; inv < uniq.length; inv++) {
+        for (const lo of [mid0 - 9, mid0 - 3]) {
+            const out = [];
+            let p = lo;
+            for (let k = 0; k < n; k++) {
+                const pc = uniq[(inv + k) % uniq.length];
+                while (((p % 12) + 12) % 12 !== pc)
+                    p++;
+                out.push(p);
+                p++;
+            }
+            cands.push(out);
+        }
+    }
+    const score = (v) => {
+        const mid = (v[0] + v[v.length - 1]) / 2;
+        let s = Math.abs(mid - mid0) * 0.6;
+        if (previous && previous.length) {
+            for (let i = 0; i < v.length; i++)
+                s += Math.abs(v[i] - previous[Math.min(i, previous.length - 1)]);
+        }
+        return s;
+    };
+    cands.sort((a, b) => score(a) - score(b));
+    return cands[0];
+}
+/** The note at a degree of a mode (0-based, may be negative or exceed 7) above a tonic */
+export function scaleDegree(tonic, mode, degree) {
+    const sc = MODES[mode];
+    const n = sc.length;
+    const oct = Math.floor(degree / n);
+    const i = ((degree % n) + n) % n;
+    return midi(tonic) + oct * 12 + sc[i];
+}
+/**
+ * Mode remapping: map a note written on C's natural notes (white keys) to the same scale degree of tonic + mode.
+ * Accidentals are kept as a "semitone offset", so a C major melody can be written once and dropped into Phrygian or harmonic minor.
+ * base is the written tonic (by default the C at C4 = 60).
+ */
+export function remapToMode(m, tonic, mode, base = 60) {
+    const WHITE = [0, 2, 4, 5, 7, 9, 11];
+    const rel = m - midi(base);
+    const oct = Math.floor(rel / 12);
+    const pc = ((rel % 12) + 12) % 12;
+    let idx = WHITE.indexOf(pc);
+    let off = 0;
+    if (idx < 0) {
+        idx = WHITE.indexOf(pc - 1);
+        off = 1;
+    }
+    const t = midi(tonic);
+    const sc = MODES[mode];
+    if (sc.length === 7)
+        return t + oct * 12 + sc[idx] + off;
+    // Pentatonic and other non-heptatonic scales: take the nearest scale note
+    const target = MODES.ionian[idx];
+    let best = sc[0];
+    for (const s of sc)
+        if (Math.abs(s - target) < Math.abs(best - target))
+            best = s;
+    return t + oct * 12 + best + off;
+}
+/** Roman-numeral chord in a key, as a chord symbol: romanChord('bVII', 'D4', 'aeolian') → 'C' ('i', 'IV', 'bVII', 'v7', 'ii°') */
+export function romanChord(numeral, tonic, mode) {
+    const m = /^(b|#)?(iv|vi{0,2}|i{1,3}|IV|VI{0,2}|I{1,3})(°|\+)?(.*)$/.exec(numeral);
+    if (!m)
+        throw new Error(`Unrecognized scale degree: ${numeral}`);
+    const ROM = ['i', 'ii', 'iii', 'iv', 'v', 'vi', 'vii'];
+    const deg = ROM.indexOf(m[2].toLowerCase());
+    const sc = MODES[mode];
+    const pc = (midi(tonic) + sc[deg % sc.length] + (m[1] === 'b' ? -1 : m[1] === '#' ? 1 : 0) + 120) % 12;
+    const minor = m[2] === m[2].toLowerCase();
+    const q = m[3] === '°' ? 'dim' : m[3] === '+' ? 'aug' : minor ? 'm' : '';
+    return NAMES[pc] + q + (m[4] ?? '');
+}
+//# sourceMappingURL=theory.js.map

package/dist/theory.js.map

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