@musodojo/music-theory-data 31.1.0 → 33.0.0

package/script/src/utils/chord-progressions.js

@@ -1,9 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isValidChordProgressionKey = isValidChordProgressionKey;
+exports.getChordProgressionChordDirectRomanSymbol = getChordProgressionChordDirectRomanSymbol;
 exports.getChordProgressionChordNames = getChordProgressionChordNames;
+exports.getChordProgressionDirectRomanSymbols = getChordProgressionDirectRomanSymbols;
 exports.getChordProgressionRomanSymbols = getChordProgressionRomanSymbols;
+exports.getChordProgressionDisplayRomanSymbols = getChordProgressionDisplayRomanSymbols;
 exports.getChordProgressionKeysForTotalBars = getChordProgressionKeysForTotalBars;
+exports.getChordProgressionKeysForCategory = getChordProgressionKeysForCategory;
 exports.getChordProgressionUniqueChordNames = getChordProgressionUniqueChordNames;
 exports.getChordProgressionChordChangeReferences = getChordProgressionChordChangeReferences;
 exports.getChordProgressionUniqueChordReferences = getChordProgressionUniqueChordReferences;
@@ -13,7 +17,10 @@ exports.getChordProgressionTotalDurationInBars = getChordProgressionTotalDuratio
 const mod_js_1 = require("../data/chord-progressions/mod.js");
 const mod_js_2 = require("../data/chords/mod.js");
 const note_names_js_1 = require("./note-names.js");
+const chords_js_1 = require("./chords.js");
 const BAR_DURATION_EPSILON = 0.000000001;
+const DIATONIC_SCALE_DEGREES = 7;
+const INTERVAL_LABEL_REGEX = /^(𝄫|♭|♮|♯|𝄪)?(\d+)$/;
 /** Returns whether a string is one of the built-in chord progression keys. */
 function isValidChordProgressionKey(key) {
     return Object.prototype.hasOwnProperty.call(mod_js_1.chordProgressions, key);
@@ -26,8 +33,9 @@ function resolveProgression(progressionOrKey) {
 function createChordProgressionChordReference(chord, chordRootNote) {
     return {
         rootNote: chordRootNote,
-        chordName: chordRootNote + chord.quality,
-        noteCollectionKey: (0, mod_js_2.getChordQualityNoteCollectionKey)(chord.quality),
+        chordName: chordRootNote +
+            (0, mod_js_2.getChordCollectionChordSuffix)(chord.chordCollectionKey),
+        noteCollectionKey: chord.chordCollectionKey,
     };
 }
 function getResolvedChordProgressionChordReferences(rootNote, progressionOrKey) {
@@ -45,26 +53,85 @@ function getResolvedChordProgressionChordReferences(rootNote, progressionOrKey)
             }];
     });
 }
+function getRomanAccidentalForIntervalLabel(accidental) {
+    switch (accidental) {
+        case undefined:
+        case "":
+        case "♮":
+            return "";
+        case "𝄫":
+        case "♭":
+        case "♯":
+        case "𝄪":
+            return accidental;
+        default:
+            throw new Error(`Invalid chord degree accidental: ${accidental}`);
+    }
+}
+/** Returns the direct tonic-relative Roman symbol for a progression chord. */
+function getChordProgressionChordDirectRomanSymbol(chord) {
+    const match = chord.degree.match(INTERVAL_LABEL_REGEX);
+    if (!match) {
+        throw new Error(`Invalid chord degree: ${chord.degree}`);
+    }
+    const [, rawAccidental, degreeLabel] = match;
+    const degree = Number(degreeLabel);
+    if (!Number.isInteger(degree) || degree < 1) {
+        throw new Error(`Invalid chord degree: ${chord.degree}`);
+    }
+    const scaleIndex = (degree - 1) % DIATONIC_SCALE_DEGREES;
+    const romanSymbol = (0, chords_js_1.getRomanNumeralForScaleIndexAndChordCollectionKey)(scaleIndex, chord.chordCollectionKey);
+    if (romanSymbol === undefined) {
+        throw new Error(`Unhandled chord collection: ${chord.chordCollectionKey}`);
+    }
+    const accidental = getRomanAccidentalForIntervalLabel(rawAccidental);
+    return `${accidental}${romanSymbol}`;
+}
 /** Returns the spelled chord names for a progression in the requested root. */
 function getChordProgressionChordNames(rootNote, progressionOrKey) {
     const progression = resolveProgression(progressionOrKey);
     if (!progression)
         return [];
     const noteNames = (0, note_names_js_1.getNoteNamesForRootAndIntervals)(rootNote, progression.chords.map((chord) => chord.degree));
-    return progression.chords.map((chord, index) => noteNames[index] + chord.quality);
+    return progression.chords.map((chord, index) => noteNames[index] + (0, mod_js_2.getChordCollectionChordSuffix)(chord.chordCollectionKey));
 }
-/** Returns the roman symbols authored for a chord progression. */
+/**
+ * Returns direct tonic-relative Roman symbols derived from each chord's
+ * `degree` and `chordCollectionKey`.
+ */
+function getChordProgressionDirectRomanSymbols(progressionOrKey) {
+    const progression = resolveProgression(progressionOrKey);
+    if (!progression)
+        return [];
+    return progression.chords.map((chord) => getChordProgressionChordDirectRomanSymbol(chord));
+}
+/**
+ * Returns Roman symbols suitable for theory display, preferring optional
+ * harmonic-function analysis labels when present.
+ */
 function getChordProgressionRomanSymbols(progressionOrKey) {
     const progression = resolveProgression(progressionOrKey);
     if (!progression)
         return [];
-    return progression.chords.map((chord) => chord.romanSymbol);
+    return progression.chords.map((chord) => chord.analysis?.romanSymbol ?? getChordProgressionChordDirectRomanSymbol(chord));
+}
+/**
+ * Returns Roman symbols suitable for display, preferring optional
+ * harmonic-function analysis labels when present.
+ */
+function getChordProgressionDisplayRomanSymbols(progressionOrKey) {
+    return getChordProgressionRomanSymbols(progressionOrKey);
 }
 /** Returns all built-in chord progression keys with the requested total bar count. */
 function getChordProgressionKeysForTotalBars(totalBars) {
     return mod_js_1.chordProgressionBarGroups.find((group) => group.totalBars === totalBars)
         ?.progressionKeys.slice() ?? [];
 }
+/** Returns all built-in chord progression keys in the requested musical category. */
+function getChordProgressionKeysForCategory(category) {
+    return mod_js_1.chordProgressionCategoryGroups.find((group) => group.category === category)
+        ?.progressionKeys.slice() ?? [];
+}
 /** Returns each distinct chord name in a progression, preserving first-seen order. */
 function getChordProgressionUniqueChordNames(rootNote, progressionOrKey) {
     return Array.from(new Set(getChordProgressionChordNames(rootNote, progressionOrKey)));

package/script/src/utils/chords.d.ts

@@ -1,8 +1,9 @@
-import { type NoteCollectionKey } from "../data/note-collections/mod.js";
+import { type ChordCollectionKey, type NoteCollectionKey } from "../data/note-collections/mod.js";
 import type { ChordQuality, RomanSeventhChord, RomanTriad, SeventhChord, Triad } from "../types/chords";
 import { type NoteCollectionKeyTransformOptions, type RootAndNoteCollectionKeyTransformOptions } from "./intervals.js";
 import { type RootNote } from "../data/labels/note-labels.js";
 export declare function getRomanNumeralForScaleIndexAndChordQuality(scaleIndex: number, quality: ChordQuality): string | undefined;
+export declare function getRomanNumeralForScaleIndexAndChordCollectionKey(scaleIndex: number, chordCollectionKey: ChordCollectionKey): string | undefined;
 /**
  * Converts standard triad qualities (e.g., "M", "m") into their corresponding Roman numeral representations
  * based on their scale degree index.
@@ -19,6 +20,11 @@ export declare function getRomanTriads(triads: Triad[]): RomanTriad[];
  * @returns An array of string-based Roman numeral seventh chords (e.g., "IM7", "ii7", "vii°7").
  */
 export declare function getRomanSeventhChords(sevenths: SeventhChord[]): RomanSeventhChord[];
+/**
+ * Checks whether a note collection has authored modal harmony data.
+ * Collections without authored harmony intentionally return undefined chord placeholders.
+ */
+export declare function hasAuthoredNoteCollectionHarmony(noteCollectionKey: NoteCollectionKey): boolean;
 /**
  * Retrieves the triads for a given note collection key.
  */

package/script/src/utils/chords.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chords.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chords.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAC9C,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,GACpB,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAQ5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,iBAAiB,EAAE,CAQrB;AA0KD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,CAMvB;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAM9B;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAO5B;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,CAOnC;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAsBxB;AAED;;;GAGG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAsBxB;AAED;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAY5B;AAED;;;;GAIG;AACH,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,CAYnC"}
+{"version":3,"file":"chords.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chords.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAC9C,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,GACpB,MAAM,GAAG,SAAS,CAYpB;AAED,wBAAgB,iDAAiD,CAC/D,UAAU,EAAE,MAAM,EAClB,kBAAkB,EAAE,kBAAkB,GACrC,MAAM,GAAG,SAAS,CAUpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAQ5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,iBAAiB,EAAE,CAQrB;AAyED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,iBAAiB,EAAE,iBAAiB,GACnC,OAAO,CAET;AAmGD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,CAMvB;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAM9B;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAO5B;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,CAOnC;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAsBxB;AAED;;;GAGG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAsBxB;AAED;;;;GAIG;AACH,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAY5B;AAED;;;;GAIG;AACH,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,CAYnC"}

package/script/src/utils/chords.js

@@ -1,8 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getRomanNumeralForScaleIndexAndChordQuality = getRomanNumeralForScaleIndexAndChordQuality;
+exports.getRomanNumeralForScaleIndexAndChordCollectionKey = getRomanNumeralForScaleIndexAndChordCollectionKey;
 exports.getRomanTriads = getRomanTriads;
 exports.getRomanSeventhChords = getRomanSeventhChords;
+exports.hasAuthoredNoteCollectionHarmony = hasAuthoredNoteCollectionHarmony;
 exports.getTriadsForNoteCollectionKey = getTriadsForNoteCollectionKey;
 exports.getSeventhChordsForNoteCollectionKey = getSeventhChordsForNoteCollectionKey;
 exports.getRomanTriadsForNoteCollectionKey = getRomanTriadsForNoteCollectionKey;
@@ -34,6 +36,16 @@ function getRomanNumeralForScaleIndexAndChordQuality(scaleIndex, quality) {
         return undefined;
     return romanNumeral + rendering.suffix;
 }
+function getRomanNumeralForScaleIndexAndChordCollectionKey(scaleIndex, chordCollectionKey) {
+    const rendering = (0, mod_js_1.getChordCollectionSymbolRendering)(chordCollectionKey);
+    const numerals = rendering.numeralCase === "lower"
+        ? mod_js_1.lowerCaseRomanNumerals
+        : mod_js_1.upperCaseRomanNumerals;
+    const romanNumeral = numerals[scaleIndex];
+    if (romanNumeral === undefined)
+        return undefined;
+    return romanNumeral + rendering.romanSuffix;
+}
 /**
  * Converts standard triad qualities (e.g., "M", "m") into their corresponding Roman numeral representations
  * based on their scale degree index.
@@ -122,6 +134,13 @@ function getModeData(modeKey) {
     }
     return undefined;
 }
+/**
+ * Checks whether a note collection has authored modal harmony data.
+ * Collections without authored harmony intentionally return undefined chord placeholders.
+ */
+function hasAuthoredNoteCollectionHarmony(noteCollectionKey) {
+    return getModeData(noteCollectionKey) !== undefined;
+}
 function getUndefinedChordPlaceholders(intervals, fillChromatic) {
     if (fillChromatic) {
         return (0, chromatic_js_1.createChromaticTuple)(Array.from({ length: 12 }, () => undefined));

package/script/src/utils/conversion-registry.d.ts

@@ -1,13 +1,12 @@
-import type { RootNote } from "../data/labels/note-labels.js";
+import type { ChromaticTuple } from "../data/chromatic.js";
+import type { Interval, NoteName, RootNote } from "../data/labels/note-labels.js";
 import type { NoteCollectionKey } from "../data/note-collections/mod.js";
-import type { Interval } from "../data/labels/note-labels.js";
 import type { RomanSeventhChord, RomanTriad } from "../types/chords";
-import type { NoteName } from "../data/labels/note-labels.js";
 /**
  * Options specifically tailored for robust Conversion Registry UI usage.
  * Requires `fillChromatic: true` and `rotateToRootInteger0: true` to ensure
- * all returned arrays are 12 elements long and uniformly anchored to C=0,
- * making them easy to align in a UI like a fretboard.
+ * all returned arrays are 12 elements long and indexed by absolute pitch class
+ * where C is index 0. The selected root appears at its pitch-class index.
  */
 export interface ConversionRegistryOptions {
     fillChromatic: true;
@@ -17,25 +16,46 @@ export interface ConversionRegistryOptions {
 /**
  * A generic function signature for all registry entries.
  */
-export type ConversionFunction<T> = (rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options: ConversionRegistryOptions) => readonly (T | undefined)[];
-export interface ConversionRegistryEntry<T> {
-    id: string;
+export type ConversionFunction<T> = (rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options: ConversionRegistryOptions) => ChromaticTuple<T | undefined>;
+export type ConversionInputKind = "rootAndNoteCollection";
+export type ConversionOutputKind = "noteNames" | "intervals" | "chordNames" | "romanNumerals";
+export type ConversionOutputShape = "chromatic-12";
+export type ConversionOutputIndexing = "absolutePitchClassC0";
+export type ConversionEmptySlot = "none" | "undefined";
+export type ConversionAvailabilityFunction = (rootNote: RootNote, noteCollectionKey: NoteCollectionKey) => boolean;
+export interface ConversionRegistryEntry<T, TId extends string = string> {
+    id: TId;
     name: string;
     shortName: string;
     description: string;
     example: string;
+    inputKind: ConversionInputKind;
+    outputKind: ConversionOutputKind;
+    outputShape: ConversionOutputShape;
+    outputIndexing: ConversionOutputIndexing;
+    allowsEmptySlots: boolean;
+    emptySlot: ConversionEmptySlot;
+    isAvailable?: ConversionAvailabilityFunction;
+    unavailableReason?: string;
     get: ConversionFunction<T>;
 }
-export declare const conversions: {
-    rootAndNoteCollection: {
-        noteNames: ConversionRegistryEntry<NoteName | string>;
-        intervals: ConversionRegistryEntry<Interval>;
-        extensions: ConversionRegistryEntry<Interval>;
-        compoundIntervals: ConversionRegistryEntry<Interval>;
-        triads: ConversionRegistryEntry<string>;
-        seventhChords: ConversionRegistryEntry<string>;
-        romanTriads: ConversionRegistryEntry<RomanTriad>;
-        romanSeventhChords: ConversionRegistryEntry<RomanSeventhChord>;
-    };
-};
+export interface RootAndNoteCollectionConversions {
+    noteNames: ConversionRegistryEntry<NoteName, "note-names">;
+    intervals: ConversionRegistryEntry<Interval, "intervals">;
+    extensions: ConversionRegistryEntry<Interval, "extensions">;
+    compoundIntervals: ConversionRegistryEntry<Interval, "compound-intervals">;
+    triads: ConversionRegistryEntry<string, "triads">;
+    seventhChords: ConversionRegistryEntry<string, "seventh-chords">;
+    romanTriads: ConversionRegistryEntry<RomanTriad, "roman-triads">;
+    romanSeventhChords: ConversionRegistryEntry<RomanSeventhChord, "roman-seventh-chords">;
+}
+export interface ConversionRegistry {
+    rootAndNoteCollection: RootAndNoteCollectionConversions;
+}
+export declare const conversions: ConversionRegistry;
+export declare const rootAndNoteCollectionConversions: RootAndNoteCollectionConversions;
+export type RootAndNoteCollectionConversionKey = keyof typeof rootAndNoteCollectionConversions;
+export type RootAndNoteCollectionConversion = typeof rootAndNoteCollectionConversions[RootAndNoteCollectionConversionKey];
+export declare function isRootAndNoteCollectionConversionAvailable(conversion: RootAndNoteCollectionConversion, rootNote: RootNote, noteCollectionKey: NoteCollectionKey): boolean;
+export declare function getAvailableRootAndNoteCollectionConversions(rootNote: RootNote, noteCollectionKey: NoteCollectionKey): RootAndNoteCollectionConversion[];
 //# sourceMappingURL=conversion-registry.d.ts.map

package/script/src/utils/conversion-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conversion-registry.d.ts","sourceRoot":"","sources":["../../../src/src/utils/conversion-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAc9D;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,IAAI,CAAC;IACpB,oBAAoB,EAAE,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAClC,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,yBAAyB,KAC/B,SAAS,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;AAEhC,MAAM,WAAW,uBAAuB,CAAC,CAAC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;CAC5B;AAED,eAAO,MAAM,WAAW;;mBAWf,uBAAuB,CAAC,QAAQ,GAAG,MAAM,CAAC;mBAU1C,uBAAuB,CAAC,QAAQ,CAAC;oBAUjC,uBAAuB,CAAC,QAAQ,CAAC;2BAUjC,uBAAuB,CAAC,QAAQ,CAAC;gBAUjC,uBAAuB,CAAC,MAAM,CAAC;uBAU/B,uBAAuB,CAAC,MAAM,CAAC;qBAU/B,uBAAuB,CAAC,UAAU,CAAC;4BAUnC,uBAAuB,CAAC,iBAAiB,CAAC;;CAElD,CAAC"}
+{"version":3,"file":"conversion-registry.d.ts","sourceRoot":"","sources":["../../../src/src/utils/conversion-registry.ts"],"names":[],"mappings":"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"}

package/script/src/utils/conversion-registry.js

@@ -1,74 +1,146 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.conversions = void 0;
+exports.rootAndNoteCollectionConversions = exports.conversions = void 0;
+exports.isRootAndNoteCollectionConversionAvailable = isRootAndNoteCollectionConversionAvailable;
+exports.getAvailableRootAndNoteCollectionConversions = getAvailableRootAndNoteCollectionConversions;
+const chords_js_1 = require("./chords.js");
+const chromatic_js_1 = require("./chromatic.js");
 const note_names_js_1 = require("./note-names.js");
 const intervals_js_1 = require("./intervals.js");
-const chords_js_1 = require("./chords.js");
+const authoredHarmonyUnavailableReason = "This note collection does not have authored modal harmony data.";
+const isAuthoredHarmonyAvailable = (_rootNote, noteCollectionKey) => (0, chords_js_1.hasAuthoredNoteCollectionHarmony)(noteCollectionKey);
+const absolutePitchClassC0 = "absolutePitchClassC0";
+function createConversionResult(values) {
+    return (0, chromatic_js_1.createChromaticTuple)(values);
+}
 exports.conversions = {
     rootAndNoteCollection: {
         noteNames: {
             id: "note-names",
             name: "Note Names",
             shortName: "Notes",
-            description: "Returns the specific note names (e.g., 'C', 'E♭', 'G') for the root and collection.",
-            example: "C, E♭, G",
-            get: (root, key, opts) => (0, note_names_js_1.getNoteNamesForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 absolute pitch-class slots for the root and collection, indexed so C is slot 0.",
+            example: "C, D♭, D, E♭, E, F, G♭, G, A♭, A, B♭, B",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "noteNames",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: false,
+            emptySlot: "none",
+            get: (root, key, opts) => createConversionResult((0, note_names_js_1.getNoteNamesForRootAndNoteCollectionKey)(root, key, opts)),
         },
         intervals: {
             id: "intervals",
             name: "Intervals",
             shortName: "Intervals",
-            description: "Returns the relative intervals (e.g., '1', '♭3', '5') for the collection.",
-            example: "1, ♭3, 5",
-            get: (root, key, opts) => (0, intervals_js_1.getIntervalsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 absolute pitch-class slots labeled with intervals relative to the root, indexed so C is slot 0.",
+            example: "1, ♭2, 2, ♭3, 3, 4, ♭5, 5, ♭6, 6, ♭7, 7",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "intervals",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: false,
+            emptySlot: "none",
+            get: (root, key, opts) => createConversionResult((0, intervals_js_1.getIntervalsForRootAndNoteCollectionKey)(root, key, opts)),
         },
         extensions: {
             id: "extensions",
             name: "Extensions",
             shortName: "Extensions",
-            description: "Returns intervals with simple intervals converted to extensions where applicable (e.g., '2' becomes '9').",
-            example: "9, ♯11, ♭13",
-            get: (root, key, opts) => (0, intervals_js_1.getExtensionsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 chromatic interval slots with simple intervals converted to extensions where applicable.",
+            example: "1, ♭9, 9, ♭3, 3, 11, ♭5, 5, ♭13, 13, ♭7, 7",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "intervals",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: false,
+            emptySlot: "none",
+            get: (root, key, opts) => createConversionResult((0, intervals_js_1.getExtensionsForRootAndNoteCollectionKey)(root, key, opts)),
         },
         compoundIntervals: {
             id: "compound-intervals",
             name: "Compound Intervals",
             shortName: "Compound",
-            description: "Returns intervals converted to their compound equivalents (e.g., '3' becomes '10').",
-            example: "10, 12, 14",
-            get: (root, key, opts) => (0, intervals_js_1.getCompoundIntervalsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 chromatic interval slots with simple intervals converted to compound equivalents.",
+            example: "1, ♭9, 9, ♭10, 10, 11, ♭12, 12, ♭13, 13, ♭14, 14",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "intervals",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: false,
+            emptySlot: "none",
+            get: (root, key, opts) => createConversionResult((0, intervals_js_1.getCompoundIntervalsForRootAndNoteCollectionKey)(root, key, opts)),
         },
         triads: {
             id: "triads",
             name: "Triads",
             shortName: "Triads",
-            description: "Returns the triads with prepended note names (e.g., 'Cm', 'E♭M').",
-            example: "Cm, E♭M",
-            get: (root, key, opts) => (0, chords_js_1.getTriadsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 chromatic triad-name slots for note collections with authored modal harmony.",
+            example: "CM, -, Dm, -, Em, FM, -, GM, -, Am, -, B°",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "chordNames",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: true,
+            emptySlot: "undefined",
+            isAvailable: isAuthoredHarmonyAvailable,
+            unavailableReason: authoredHarmonyUnavailableReason,
+            get: (root, key, opts) => createConversionResult((0, chords_js_1.getTriadsForRootAndNoteCollectionKey)(root, key, opts)),
         },
         seventhChords: {
             id: "seventh-chords",
             name: "Seventh Chords",
             shortName: "Sevenths",
-            description: "Returns the seventh chords with prepended note names (e.g., 'Cm7', 'E♭M7').",
-            example: "Cm7, E♭M7",
-            get: (root, key, opts) => (0, chords_js_1.getSeventhChordsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 chromatic seventh-chord-name slots for note collections with authored modal harmony.",
+            example: "CM7, -, Dm7, -, Em7, FM7, -, G7, -, Am7, -, Bø7",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "chordNames",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: true,
+            emptySlot: "undefined",
+            isAvailable: isAuthoredHarmonyAvailable,
+            unavailableReason: authoredHarmonyUnavailableReason,
+            get: (root, key, opts) => createConversionResult((0, chords_js_1.getSeventhChordsForRootAndNoteCollectionKey)(root, key, opts)),
         },
         romanTriads: {
             id: "roman-triads",
             name: "Roman Numeral Triads",
             shortName: "Roman Triads",
-            description: "Returns the Roman numeral representation of the triads (e.g., 'I', 'ii', 'iii').",
-            example: "I, ii, iii",
-            get: (root, key, opts) => (0, chords_js_1.getRomanTriadsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 chromatic Roman numeral triad slots for note collections with authored modal harmony.",
+            example: "I, -, ii, -, iii, IV, -, V, -, vi, -, vii°",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "romanNumerals",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: true,
+            emptySlot: "undefined",
+            isAvailable: isAuthoredHarmonyAvailable,
+            unavailableReason: authoredHarmonyUnavailableReason,
+            get: (root, key, opts) => createConversionResult((0, chords_js_1.getRomanTriadsForRootAndNoteCollectionKey)(root, key, opts)),
         },
         romanSeventhChords: {
             id: "roman-seventh-chords",
             name: "Roman Numeral Seventh Chords",
             shortName: "Roman Sevenths",
-            description: "Returns the Roman numeral representation of the seventh chords (e.g., 'I7', 'ii7', 'iii7').",
-            example: "I7, ii7, iii7",
-            get: (root, key, opts) => (0, chords_js_1.getRomanSeventhChordsForRootAndNoteCollectionKey)(root, key, opts),
+            description: "Returns 12 chromatic Roman numeral seventh-chord slots for note collections with authored modal harmony.",
+            example: "IM7, -, iim7, -, iiim7, IVM7, -, V7, -, vim7, -, viiø7",
+            inputKind: "rootAndNoteCollection",
+            outputKind: "romanNumerals",
+            outputShape: "chromatic-12",
+            outputIndexing: absolutePitchClassC0,
+            allowsEmptySlots: true,
+            emptySlot: "undefined",
+            isAvailable: isAuthoredHarmonyAvailable,
+            unavailableReason: authoredHarmonyUnavailableReason,
+            get: (root, key, opts) => createConversionResult((0, chords_js_1.getRomanSeventhChordsForRootAndNoteCollectionKey)(root, key, opts)),
         },
     },
 };
+exports.rootAndNoteCollectionConversions = exports.conversions.rootAndNoteCollection;
+function isRootAndNoteCollectionConversionAvailable(conversion, rootNote, noteCollectionKey) {
+    return conversion.isAvailable?.(rootNote, noteCollectionKey) ?? true;
+}
+function getAvailableRootAndNoteCollectionConversions(rootNote, noteCollectionKey) {
+    return Object.values(exports.rootAndNoteCollectionConversions).filter((conversion) => isRootAndNoteCollectionConversionAvailable(conversion, rootNote, noteCollectionKey));
+}

package/script/src/utils/intervals.d.ts

@@ -1,6 +1,7 @@
 import { type CompoundInterval, type Interval, type IntervalQuality, type RootNote, type SimpleInterval } from "../data/labels/note-labels.js";
 import type { ChromaticIndex, ChromaticTuple } from "../data/chromatic.js";
 import { type NoteCollectionKey } from "../data/note-collections/mod.js";
+export declare const DIATONIC_STEPS_PER_OCTAVE = 7;
 export type ChromaticIntervalTuple = ChromaticTuple<Interval>;
 export declare function isOctaveInterval(interval: Interval): boolean;
 /**
@@ -52,6 +53,8 @@ export declare function normalizeCompoundIntervalString(name: string): CompoundI
  * Parses an array of strings and returns an array of canonical `CompoundInterval`s.
  */
 export declare function normalizeCompoundIntervalStringArray(names: readonly string[]): CompoundInterval[];
+export declare function getIntervalLabelDegree(intervalLabel: string): number | undefined;
+export declare function shiftIntervalLabelByOctaves(intervalLabel: string, octaveOffset: number): string;
 /**
  * Sorts an array of intervals in ascending order based on their integer value.
  * This is a pure function and returns a new sorted array, leaving the original array unchanged.

package/script/src/utils/intervals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"intervals.d.ts","sourceRoot":"","sources":["../../../src/src/utils/intervals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"intervals.d.ts","sourceRoot":"","sources":["../../../src/src/utils/intervals.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,gBAAgB,EAGrB,KAAK,QAAQ,EACb,KAAK,eAAe,EAIpB,KAAK,QAAQ,EACb,KAAK,cAAc,EAGpB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AAUzC,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,MAAM,sBAAsB,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;AAE9D,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,EAAE,CAEZ;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,EAAE,CAuBZ;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAmC1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,QAAQ,EAAE,CAIZ;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,GACX,cAAc,GAAG,SAAS,CAU5B;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,cAAc,EAAE,CAIlB;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,IAAI,EAAE,MAAM,GACX,gBAAgB,GAAG,SAAS,CAU9B;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,gBAAgB,EAAE,CAIpB;AAED,wBAAgB,sBAAsB,CACpC,aAAa,EAAE,MAAM,GACpB,MAAM,GAAG,SAAS,CAMpB;AAED,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,MAAM,CAcR;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAAG,QAAQ,EAAE,CAOxE;AAED,4FAA4F;AAC5F,MAAM,MAAM,sBAAsB,GAC9B,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,kBAAkB,CAAC;AAEvB,kEAAkE;AAClE,MAAM,WAAW,6BAA6B;IAC5C;;;OAGG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,mFAAmF;AACnF,MAAM,WAAW,sCACf,SAAQ,6BAA6B;IACrC;;;;OAIG;IACH,aAAa,EAAE,IAAI,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,mFAAmF;AACnF,MAAM,WAAW,+BACf,SAAQ,6BAA6B;IACrC,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,oBAAoB,CAAC,EAAE,KAAK,CAAC;CAC9B;AAED,kFAAkF;AAClF,MAAM,MAAM,yBAAyB,GACjC,sCAAsC,GACtC,+BAA+B,CAAC;AAEpC,MAAM,MAAM,iCAAiC,GAAG,IAAI,CAClD,yBAAyB,EACvB,wBAAwB,GACxB,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,eAAe,CAClB,CAAC;AAEF,MAAM,MAAM,wCAAwC,GAAG,IAAI,CACzD,yBAAyB,EACvB,wBAAwB,GACxB,iBAAiB,GACjB,YAAY,GACZ,aAAa,GACb,eAAe,GACf,iBAAiB,GACjB,sBAAsB,CACzB,CAAC;AAEF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,EAAE,sCAAsC,GAC9C,sBAAsB,CAAC;AAC1B,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,CAAC,EAAE,yBAAyB,GAClC,QAAQ,EAAE,CAAC;AA+Fd;;;;;GAKG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,eAAe,EAAE,GACpC,QAAQ,EAAE,CAKZ;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,iCAAiC,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GACnE,sBAAsB,CAAC;AAC1B,wBAAgB,gCAAgC,CAC9C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,iCAAiC,GAC1C,QAAQ,EAAE,CAAC;AAuBd;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EACH,IAAI,CACJ,iCAAiC,EACjC,wBAAwB,CACzB,GACC;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GAC1B,sBAAsB,CAAC;AAC1B,wBAAgB,iCAAiC,CAC/C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,IAAI,CACZ,iCAAiC,EACjC,wBAAwB,CACzB,GACA,QAAQ,EAAE,CAAC;AAed;;;;;;;GAOG;AACH,wBAAgB,wCAAwC,CACtD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EACH,IAAI,CACJ,iCAAiC,EACjC,wBAAwB,CACzB,GACC;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GAC1B,sBAAsB,CAAC;AAC1B,wBAAgB,wCAAwC,CACtD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,IAAI,CACZ,iCAAiC,EACjC,wBAAwB,CACzB,GACA,QAAQ,EAAE,CAAC;AAed;;;;;;;;GAQG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EAAE,wCAAwC,GAAG;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GAC1E,sBAAsB,CAAC;AAC1B,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,wCAAwC,GACjD,QAAQ,EAAE,CAAC;AA4Bd;;;;;;;;GAQG;AACH,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EACH,IAAI,CACJ,wCAAwC,EACxC,wBAAwB,CACzB,GACC;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GAC1B,sBAAsB,CAAC;AAC1B,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,IAAI,CACZ,wCAAwC,EACxC,wBAAwB,CACzB,GACA,QAAQ,EAAE,CAAC;AAgBd;;;;;;;;GAQG;AACH,wBAAgB,+CAA+C,CAC7D,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,EACH,IAAI,CACJ,wCAAwC,EACxC,wBAAwB,CACzB,GACC;IAAE,aAAa,EAAE,IAAI,CAAA;CAAE,GAC1B,sBAAsB,CAAC;AAC1B,wBAAgB,+CAA+C,CAC7D,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,IAAI,CACZ,wCAAwC,EACxC,wBAAwB,CACzB,GACA,QAAQ,EAAE,CAAC"}

package/script/src/utils/intervals.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DIATONIC_STEPS_PER_OCTAVE = void 0;
 exports.isOctaveInterval = isOctaveInterval;
 exports.filterOutOctaveIntervals = filterOutOctaveIntervals;
 exports.filterOutRootLikeIntervals = filterOutRootLikeIntervals;
@@ -9,6 +10,8 @@ exports.normalizeSimpleIntervalString = normalizeSimpleIntervalString;
 exports.normalizeSimpleIntervalStringArray = normalizeSimpleIntervalStringArray;
 exports.normalizeCompoundIntervalString = normalizeCompoundIntervalString;
 exports.normalizeCompoundIntervalStringArray = normalizeCompoundIntervalStringArray;
+exports.getIntervalLabelDegree = getIntervalLabelDegree;
+exports.shiftIntervalLabelByOctaves = shiftIntervalLabelByOctaves;
 exports.sortIntervals = sortIntervals;
 exports.transformIntervals = transformIntervals;
 exports.getIntervalsForQualities = getIntervalsForQualities;
@@ -26,6 +29,8 @@ const accidentals_js_1 = require("./accidentals.js");
 const note_collections_js_1 = require("./note-collections.js");
 const chromatic_js_1 = require("./chromatic.js");
 const INTERVAL_NUMBER_REGEX = /\d+$/;
+const INTERVAL_LABEL_REGEX = /^([^\d]*)(\d+)$/;
+exports.DIATONIC_STEPS_PER_OCTAVE = 7;
 function isOctaveInterval(interval) {
     return interval === "8" || interval === "♮8";
 }
@@ -155,6 +160,27 @@ function normalizeCompoundIntervalStringArray(names) {
         .map((name) => normalizeCompoundIntervalString(name))
         .filter((name) => name !== undefined);
 }
+function getIntervalLabelDegree(intervalLabel) {
+    const match = intervalLabel.match(INTERVAL_LABEL_REGEX);
+    if (!match)
+        return undefined;
+    const degree = Number(match[2]);
+    return Number.isInteger(degree) && degree > 0 ? degree : undefined;
+}
+function shiftIntervalLabelByOctaves(intervalLabel, octaveOffset) {
+    if (octaveOffset === 0)
+        return intervalLabel;
+    const match = intervalLabel.match(INTERVAL_LABEL_REGEX);
+    if (!match)
+        return intervalLabel;
+    const [, accidental = "", degreeLabel] = match;
+    const degree = Number(degreeLabel);
+    if (!Number.isInteger(degree) || degree < 1)
+        return intervalLabel;
+    const shiftedDegree = degree +
+        octaveOffset * exports.DIATONIC_STEPS_PER_OCTAVE;
+    return shiftedDegree >= 1 ? `${accidental}${shiftedDegree}` : intervalLabel;
+}
 /**
  * Sorts an array of intervals in ascending order based on their integer value.
  * This is a pure function and returns a new sorted array, leaving the original array unchanged.

package/script/src/utils/midi.d.ts

@@ -1,5 +1,12 @@
 import { type Interval, type NoteName } from "../data/labels/note-labels.js";
 import type { MidiNoteNumber } from "../types/midi";
+export declare function getMidiOctave(midi: number): number;
+export type MidiNoteSpelling = "flat" | "sharp";
+export interface FormatMidiNoteOptions {
+    spelling?: MidiNoteSpelling;
+}
+export declare function formatMidiNote(midi: number, options?: FormatMidiNoteOptions): string;
+export declare function formatSpelledMidiNote(noteName: string, midi: number): string;
 /**
  * Calculates a MIDI note number based on a starting musical note (represented by its integer value and octave)
  * and an interval to apply to it.

package/script/src/utils/midi.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"midi.d.ts","sourceRoot":"","sources":["../../../src/src/utils/midi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,QAAQ,EAEd,MAAM,+BAA+B,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,QAAQ,GACjB,cAAc,GAAG,SAAS,CAM5B;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,QAAQ,GACjB,cAAc,GAAG,SAAS,CAQ5B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,GACjB,cAAc,GAAG,SAAS,CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,MAAM,GACvB,cAAc,GAAG,SAAS,CAI5B"}
+{"version":3,"file":"midi.d.ts","sourceRoot":"","sources":["../../../src/src/utils/midi.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EAEb,KAAK,QAAQ,EAEd,MAAM,+BAA+B,CAAC;AAGvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,OAAO,CAAC;AAEhD,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;CAC7B;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAQR;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CAER;AAED;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAC9C,WAAW,EAAE,MAAM,EACnB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,QAAQ,GACjB,cAAc,GAAG,SAAS,CAM5B;AAED;;;;;;;GAOG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,QAAQ,GACjB,cAAc,GAAG,SAAS,CAQ5B;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,GACjB,cAAc,GAAG,SAAS,CAI5B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,MAAM,GACvB,cAAc,GAAG,SAAS,CAI5B"}

package/script/src/utils/midi.js

@@ -1,10 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMidiOctave = getMidiOctave;
+exports.formatMidiNote = formatMidiNote;
+exports.formatSpelledMidiNote = formatSpelledMidiNote;
 exports.getMidiForNoteIntegerAndInterval = getMidiForNoteIntegerAndInterval;
 exports.getMidiForNoteNameAndInterval = getMidiForNoteNameAndInterval;
 exports.getMidiForNoteMidiAndInterval = getMidiForNoteMidiAndInterval;
 exports.getMidiForNoteName = getMidiForNoteName;
 const note_labels_js_1 = require("../data/labels/note-labels.js");
+const note_label_collections_js_1 = require("../data/labels/note-label-collections.js");
+const chromatic_js_1 = require("./chromatic.js");
+function getMidiOctave(midi) {
+    return Math.floor(midi / 12) - 1;
+}
+function formatMidiNote(midi, options = {}) {
+    const { spelling = "flat" } = options;
+    const labels = spelling === "sharp"
+        ? note_label_collections_js_1.noteLabelCollections.noteNamesSharp.labels
+        : note_label_collections_js_1.noteLabelCollections.noteNamesFlat.labels;
+    const noteName = labels[(0, chromatic_js_1.normalizeChromaticIndex)(midi)];
+    return `${noteName}${getMidiOctave(midi)}`;
+}
+function formatSpelledMidiNote(noteName, midi) {
+    return noteName === "" ? "" : `${noteName}${getMidiOctave(midi)}`;
+}
 /**
  * Calculates a MIDI note number based on a starting musical note (represented by its integer value and octave)
  * and an interval to apply to it.