@musodojo/music-theory-data 33.0.0 → 35.0.0

package/README.md

@@ -108,14 +108,19 @@ const availableForMajorChord = getAvailableRootAndNoteCollectionConversions(
 
 console.log(availableForMajorChord.map((entry) => entry.id));
 // ["note-names", "intervals", "extensions", "compound-intervals"]
+
+console.log(availableForMajorChord.map((entry) => entry.outputPreview));
+// ["C, D♭, D...", "1, ♭2, 2...", "1, ♭9, 9...", "1, ♭9, 9, ♭10..."]
 ```
 
 The conversion registry is useful when an app needs selectable display layers
 for the same root and note collection. Each entry includes UI metadata such as
-`name`, `shortName`, `description`, `outputShape`, and whether empty chromatic
-slots can appear. Authored harmony conversions are exposed for modal collections
-such as `ionian`, but are filtered out for collections that do not define modal
-harmony, such as the `major` triad.
+`name`, `shortName`, `description`, `outputPreview`, `sampleOutput`,
+`outputShape`, and whether empty chromatic slots can appear. `outputPreview` is
+intended for compact UI subtitles, while `sampleOutput` is a fuller
+representative output string. Authored harmony conversions are exposed for modal
+collections such as `ionian`, but are filtered out for collections that do not
+define modal harmony, such as the `major` triad.
 
 ### Inspect A Note Collection
 
@@ -167,10 +172,10 @@ console.log(getChordProgressionRomanSymbols("oneSixFourFive"));
 // ["I", "vi", "IV", "V"]
 
 console.log(chordProgressionCategoryGroups.map((group) => group.name));
-// ["Fundamentals", "Popular Loops", "Jazz & Turnarounds", "Blues"]
+// ["Common Loops & Sequences", "Cadences", "Blues Forms", "Jazz Cadences & Standards"]
 
 console.log(getChordProgressionKeysForCategory("jazz"));
-// ["oneSixTwoFive", "sixTwoFiveOne", "majorTwoFiveOne", ...]
+// ["majorTwoFiveOne", "minorTwoFiveOne", "backdoorTwoFiveOne", ...]
 
 console.log(getChordProgressionChordNames("C", "oneSixFourFive"));
 // ["CM", "Am", "FM", "GM"]

package/esm/src/data/chord-progressions/mod.d.ts

@@ -16,14 +16,24 @@ declare const _chordProgressions: {
     readonly oneFiveSixFour: BuiltInChordProgression;
     readonly oneSixTwoFive: BuiltInChordProgression;
     readonly sixTwoFiveOne: BuiltInChordProgression;
+    readonly oneFourOneFiveSplitReturn: BuiltInChordProgression;
+    readonly circleOfFifths: BuiltInChordProgression;
+    readonly pachelbelCanon: BuiltInChordProgression;
+    readonly authenticCadence: BuiltInChordProgression;
+    readonly plagalCadence: BuiltInChordProgression;
+    readonly deceptiveCadence: BuiltInChordProgression;
+    readonly andalusianCadence: BuiltInChordProgression;
+    readonly twelveBarBlues: BuiltInChordProgression;
+    readonly twelveBarBluesQuickChange: BuiltInChordProgression;
+    readonly minorBlues: BuiltInChordProgression;
+    readonly jazzBlues: BuiltInChordProgression;
     readonly majorTwoFiveOne: BuiltInChordProgression;
     readonly minorTwoFiveOne: BuiltInChordProgression;
-    readonly oneFourOneFiveSplitReturn: BuiltInChordProgression;
+    readonly backdoorTwoFiveOne: BuiltInChordProgression;
     readonly autumnLeavesA: BuiltInChordProgression;
     readonly autumnLeavesB: BuiltInChordProgression;
-    readonly twelveBarBlues: BuiltInChordProgression;
-    readonly twelveBarBluesQuickChange: BuiltInChordProgression;
-    readonly rhythmChanges: BuiltInChordProgression;
+    readonly rhythmChangesA: BuiltInChordProgression;
+    readonly rhythmChangesBridge: BuiltInChordProgression;
 };
 /** A key for one of the built-in chord progression templates. */
 export type ChordProgressionKey = keyof typeof _chordProgressions;

package/esm/src/data/chord-progressions/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAEjC,MAAM,gCAAgC,CAAC;AAExC,KAAK,uBAAuB,GAAG,gBAAgB,GAAG;IAChD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD,CAAC;AAgDF,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,2BAA2B,EAC3B,gCAAgC,CACH,CAAC;AAEhC,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,EACvC,SAAS,2BAA2B,EAKnC,CAAC;AAsNJ,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;CAkBd,CAAC;AAEX,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAElE,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,mBAAmB,EACnB,uBAAuB,CACH,CAAC;AAiBvB,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,EAAE,SAAS,wBAAwB,CACvE,mBAAmB,CACpB,EAM0C,CAAC;AAE5C,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,EACzC,SAAS,6BAA6B,CAAC,mBAAmB,CAAC,EAQtD,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,gCAAgC,EAEjC,MAAM,gCAAgC,CAAC;AAExC,KAAK,uBAAuB,GAAG,gBAAgB,GAAG;IAChD,QAAQ,CAAC,QAAQ,EAAE,2BAA2B,CAAC;CAChD,CAAC;AAgDF,iEAAiE;AACjE,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAC7C,2BAA2B,EAC3B,gCAAgC,CACH,CAAC;AAEhC,6EAA6E;AAC7E,eAAO,MAAM,4BAA4B,EACvC,SAAS,2BAA2B,EAKnC,CAAC;AA8UJ,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4Bd,CAAC;AAEX,iEAAiE;AACjE,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAElE,oEAAoE;AACpE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CACpC,mBAAmB,EACnB,uBAAuB,CACH,CAAC;AAiBvB,yEAAyE;AACzE,eAAO,MAAM,yBAAyB,EAAE,SAAS,wBAAwB,CACvE,mBAAmB,CACpB,EAM0C,CAAC;AAE5C,mEAAmE;AACnE,eAAO,MAAM,8BAA8B,EACzC,SAAS,6BAA6B,CAAC,mBAAmB,CAAC,EAQtD,CAAC"}

package/esm/src/data/chord-progressions/mod.js

@@ -12,41 +12,41 @@ function chord(degree, chordCollectionKey, durationInBars, analysis) {
     };
 }
 const _chordProgressionCategories = {
-    fundamentals: {
-        name: "Fundamentals",
-        description: "Small tonic, subdominant, and dominant patterns for core harmonic motion.",
+    commonLoops: {
+        name: "Common Loops & Sequences",
+        description: "Reusable diatonic and modal loops, pop progressions, and root-motion sequences.",
     },
-    popular: {
-        name: "Popular Loops",
-        description: "Common diatonic loops used widely in popular, rock, folk, and songwriting contexts.",
-    },
-    jazz: {
-        name: "Jazz & Turnarounds",
-        description: "ii-V motion, turnarounds, and jazz-standard forms with richer chord collections.",
+    cadences: {
+        name: "Cadences",
+        description: "Short resolution patterns for tonic arrival, plagal motion, deceptive motion, and modal minor closure.",
     },
     blues: {
-        name: "Blues",
+        name: "Blues Forms",
         description: "Blues forms built from dominant-function tonic, subdominant, and dominant areas.",
     },
+    jazz: {
+        name: "Jazz Cadences & Standards",
+        description: "Seventh-chord cadences and reusable sections from foundational jazz-standard forms.",
+    },
 };
 /** Category display metadata for built-in chord progressions. */
 export const chordProgressionCategories = _chordProgressionCategories;
 /** Built-in chord progression category keys in recommended display order. */
 export const chordProgressionCategoryKeys = [
-    "fundamentals",
-    "popular",
-    "jazz",
+    "commonLoops",
+    "cadences",
     "blues",
+    "jazz",
 ];
 const oneOneFiveFive = {
-    category: "fundamentals",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 2),
         chord("5", "major", 2),
     ],
 };
 const oneOneFiveFiveDominant7 = {
-    category: "fundamentals",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 2),
         chord("5", "major", 1),
@@ -54,14 +54,14 @@ const oneOneFiveFiveDominant7 = {
     ],
 };
 const oneOneFourFour = {
-    category: "fundamentals",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 2),
         chord("4", "major", 2),
     ],
 };
 const oneOneFourFive = {
-    category: "fundamentals",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 2),
         chord("4", "major", 1),
@@ -69,7 +69,7 @@ const oneOneFourFive = {
     ],
 };
 const oneFourOneFive = {
-    category: "fundamentals",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 1),
         chord("4", "major", 1),
@@ -78,7 +78,7 @@ const oneFourOneFive = {
     ],
 };
 const oneSixFourFive = {
-    category: "popular",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 1),
         chord("6", "minor", 1),
@@ -87,7 +87,7 @@ const oneSixFourFive = {
     ],
 };
 const oneFiveSixFour = {
-    category: "popular",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 1),
         chord("5", "major", 1),
@@ -96,7 +96,7 @@ const oneFiveSixFour = {
     ],
 };
 const oneSixTwoFive = {
-    category: "jazz",
+    category: "commonLoops",
     chords: [
         chord("1", "major", 1),
         chord("6", "minor", 1),
@@ -105,7 +105,7 @@ const oneSixTwoFive = {
     ],
 };
 const sixTwoFiveOne = {
-    category: "jazz",
+    category: "commonLoops",
     chords: [
         chord("6", "minor", 1),
         chord("2", "minor", 1),
@@ -113,60 +113,80 @@ const sixTwoFiveOne = {
         chord("1", "major", 1),
     ],
 };
-const majorTwoFiveOne = {
-    category: "jazz",
+const oneFourOneFiveSplitReturn = {
+    category: "commonLoops",
     chords: [
-        chord("2", "minor7", 1),
-        chord("5", "dominant7", 1),
-        chord("1", "major7", 2),
+        chord("1", "major", 1),
+        chord("4", "major", 1),
+        chord("1", "major", 1),
+        chord("5", "major", 1),
+        chord("1", "major", 1),
+        chord("4", "major", 1),
+        chord("1", "major", 0.5),
+        chord("5", "major", 0.5),
+        chord("1", "major", 1),
     ],
 };
-const minorTwoFiveOne = {
-    category: "jazz",
+const circleOfFifths = {
+    commonName: "Circle of Fifths Progression",
+    category: "commonLoops",
     chords: [
-        chord("2", "halfDiminished7", 1),
-        chord("5", "dominant7", 1),
-        chord("1", "minor", 2),
+        chord("1", "major", 1),
+        chord("4", "major", 1),
+        chord("7", "diminishedTriad", 1),
+        chord("3", "minor", 1),
+        chord("6", "minor", 1),
+        chord("2", "minor", 1),
+        chord("5", "major", 1),
+        chord("1", "major", 1),
     ],
 };
-const autumnLeavesA = {
-    commonName: "Autumn Leaves A Section",
-    category: "jazz",
+const pachelbelCanon = {
+    commonName: "Pachelbel Canon",
+    category: "commonLoops",
     chords: [
-        chord("2", "minor7", 1),
-        chord("5", "dominant7", 1),
-        chord("1", "major7", 1),
-        chord("4", "major7", 1),
-        chord("7", "halfDiminished7", 1, { romanSymbol: "iiø7/vi" }),
-        chord("3", "dominant7", 1, { romanSymbol: "V7/vi" }),
-        chord("6", "minor", 2),
+        chord("1", "major", 1),
+        chord("5", "major", 1),
+        chord("6", "minor", 1),
+        chord("3", "minor", 1),
+        chord("4", "major", 1),
+        chord("1", "major", 1),
+        chord("4", "major", 1),
+        chord("5", "major", 1),
     ],
 };
-const autumnLeavesB = {
-    commonName: "Autumn Leaves B Section",
-    category: "jazz",
+const authenticCadence = {
+    commonName: "Authentic Cadence",
+    category: "cadences",
     chords: [
-        chord("7", "halfDiminished7", 1, { romanSymbol: "iiø7/vi" }),
-        chord("3", "dominant7", 1, { romanSymbol: "V7/vi" }),
-        chord("6", "minor", 2),
-        chord("2", "minor7", 1),
         chord("5", "dominant7", 1),
-        chord("1", "major7", 1),
-        chord("4", "major7", 1),
+        chord("1", "major", 1),
     ],
 };
-const oneFourOneFiveSplitReturn = {
-    category: "fundamentals",
+const plagalCadence = {
+    commonName: "Plagal Cadence",
+    category: "cadences",
     chords: [
-        chord("1", "major", 1),
         chord("4", "major", 1),
         chord("1", "major", 1),
+    ],
+};
+const deceptiveCadence = {
+    commonName: "Deceptive Cadence",
+    category: "cadences",
+    chords: [
+        chord("5", "dominant7", 1),
+        chord("6", "minor", 1),
+    ],
+};
+const andalusianCadence = {
+    commonName: "Andalusian Cadence",
+    category: "cadences",
+    chords: [
+        chord("1", "minor", 1),
+        chord("♭7", "major", 1),
+        chord("♭6", "major", 1),
         chord("5", "major", 1),
-        chord("1", "major", 1),
-        chord("4", "major", 1),
-        chord("1", "major", 0.5),
-        chord("5", "major", 0.5),
-        chord("1", "major", 1),
     ],
 };
 const twelveBarBlues = {
@@ -197,38 +217,130 @@ const twelveBarBluesQuickChange = {
         chord("5", "dominant7", 1),
     ],
 };
-const rhythmChangesAChords = [
-    chord("1", "major", 0.5),
-    chord("6", "dominant7", 0.5),
-    chord("2", "minor7", 0.5),
-    chord("5", "dominant7", 0.5),
-    chord("3", "minor7", 0.5),
-    chord("6", "dominant7", 0.5),
-    chord("2", "minor7", 0.5),
-    chord("5", "dominant7", 0.5),
-    chord("1", "major", 0.5),
-    chord("1", "dominant7", 0.5),
-    chord("4", "major", 0.5),
-    chord("♯4", "diminished7", 0.5),
-    chord("1", "major", 0.5),
-    chord("6", "dominant7", 0.5),
-    chord("2", "minor7", 0.5),
-    chord("5", "dominant7", 0.5),
-];
-const rhythmChangesBridgeChords = [
-    chord("3", "dominant7", 2),
-    chord("6", "dominant7", 2),
-    chord("2", "dominant7", 2),
-    chord("5", "dominant7", 2),
-];
-const rhythmChanges = {
-    commonName: "Rhythm Changes",
+const minorBlues = {
+    commonName: "Minor Blues",
+    category: "blues",
+    chords: [
+        chord("1", "minor7", 1),
+        chord("4", "minor7", 1),
+        chord("1", "minor7", 1),
+        chord("1", "minor7", 1),
+        chord("4", "minor7", 1),
+        chord("4", "minor7", 1),
+        chord("1", "minor7", 1),
+        chord("1", "minor7", 1),
+        chord("♭6", "dominant7", 1),
+        chord("5", "dominant7", 1),
+        chord("1", "minor7", 1),
+        chord("5", "dominant7", 1),
+    ],
+};
+const jazzBlues = {
+    commonName: "Jazz Blues",
+    category: "blues",
+    chords: [
+        chord("1", "dominant7", 1),
+        chord("4", "dominant7", 1),
+        chord("1", "dominant7", 1),
+        chord("5", "minor7", 0.5),
+        chord("1", "dominant7", 0.5),
+        chord("4", "dominant7", 1),
+        chord("♯4", "diminished7", 1),
+        chord("1", "dominant7", 0.5),
+        chord("6", "dominant7", 0.5),
+        chord("2", "minor7", 0.5),
+        chord("5", "dominant7", 0.5),
+        chord("3", "minor7", 0.5),
+        chord("6", "dominant7", 0.5),
+        chord("2", "minor7", 0.5),
+        chord("5", "dominant7", 0.5),
+        chord("1", "dominant7", 0.5),
+        chord("6", "dominant7", 0.5),
+        chord("2", "minor7", 0.5),
+        chord("5", "dominant7", 0.5),
+    ],
+};
+const majorTwoFiveOne = {
+    category: "jazz",
+    chords: [
+        chord("2", "minor7", 1),
+        chord("5", "dominant7", 1),
+        chord("1", "major7", 2),
+    ],
+};
+const minorTwoFiveOne = {
+    category: "jazz",
+    chords: [
+        chord("2", "halfDiminished7", 1),
+        chord("5", "dominant7", 1),
+        chord("1", "minor", 2),
+    ],
+};
+const backdoorTwoFiveOne = {
+    commonName: "Backdoor ii-V-I",
+    category: "jazz",
+    chords: [
+        chord("4", "minor7", 1),
+        chord("♭7", "dominant7", 1),
+        chord("1", "major7", 2),
+    ],
+};
+const autumnLeavesA = {
+    commonName: "Autumn Leaves A Section",
     category: "jazz",
     chords: [
-        ...rhythmChangesAChords,
-        ...rhythmChangesAChords,
-        ...rhythmChangesBridgeChords,
-        ...rhythmChangesAChords,
+        chord("2", "minor7", 1),
+        chord("5", "dominant7", 1),
+        chord("1", "major7", 1),
+        chord("4", "major7", 1),
+        chord("7", "halfDiminished7", 1, { romanSymbol: "iiø7/vi" }),
+        chord("3", "dominant7", 1, { romanSymbol: "V7/vi" }),
+        chord("6", "minor", 2),
+    ],
+};
+const autumnLeavesB = {
+    commonName: "Autumn Leaves B Section",
+    category: "jazz",
+    chords: [
+        chord("7", "halfDiminished7", 1, { romanSymbol: "iiø7/vi" }),
+        chord("3", "dominant7", 1, { romanSymbol: "V7/vi" }),
+        chord("6", "minor", 2),
+        chord("2", "minor7", 1),
+        chord("5", "dominant7", 1),
+        chord("1", "major7", 1),
+        chord("4", "major7", 1),
+    ],
+};
+const rhythmChangesA = {
+    commonName: "Rhythm Changes A Section",
+    category: "jazz",
+    chords: [
+        chord("1", "major", 0.5),
+        chord("6", "dominant7", 0.5),
+        chord("2", "minor7", 0.5),
+        chord("5", "dominant7", 0.5),
+        chord("3", "minor7", 0.5),
+        chord("6", "dominant7", 0.5),
+        chord("2", "minor7", 0.5),
+        chord("5", "dominant7", 0.5),
+        chord("1", "major", 0.5),
+        chord("1", "dominant7", 0.5),
+        chord("4", "major", 0.5),
+        chord("4", "minor", 0.5),
+        chord("1", "major", 0.5),
+        chord("5", "dominant7", 0.5),
+        chord("1", "major", 0.5),
+        chord("5", "dominant7", 0.5),
+    ],
+};
+const rhythmChangesBridge = {
+    commonName: "Rhythm Changes Bridge",
+    category: "jazz",
+    chords: [
+        chord("3", "dominant7", 2),
+        chord("6", "dominant7", 2),
+        chord("2", "dominant7", 2),
+        chord("5", "dominant7", 2),
     ],
 };
 const _chordProgressions = {
@@ -241,14 +353,24 @@ const _chordProgressions = {
     oneFiveSixFour,
     oneSixTwoFive,
     sixTwoFiveOne,
+    oneFourOneFiveSplitReturn,
+    circleOfFifths,
+    pachelbelCanon,
+    authenticCadence,
+    plagalCadence,
+    deceptiveCadence,
+    andalusianCadence,
+    twelveBarBlues,
+    twelveBarBluesQuickChange,
+    minorBlues,
+    jazzBlues,
     majorTwoFiveOne,
     minorTwoFiveOne,
-    oneFourOneFiveSplitReturn,
+    backdoorTwoFiveOne,
     autumnLeavesA,
     autumnLeavesB,
-    twelveBarBlues,
-    twelveBarBluesQuickChange,
-    rhythmChanges,
+    rhythmChangesA,
+    rhythmChangesBridge,
 };
 /** Built-in chord progression templates keyed by progression id. */
 export const chordProgressions = _chordProgressions;

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

@@ -28,7 +28,8 @@ export interface ConversionRegistryEntry<T, TId extends string = string> {
     name: string;
     shortName: string;
     description: string;
-    example: string;
+    outputPreview: string;
+    sampleOutput: string;
     inputKind: ConversionInputKind;
     outputKind: ConversionOutputKind;
     outputShape: ConversionOutputShape;

package/esm/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":"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"}
+{"version":3,"file":"conversion-registry.d.ts","sourceRoot":"","sources":["../../../src/src/utils/conversion-registry.ts"],"names":[],"mappings":"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"}

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

@@ -15,7 +15,8 @@ export const conversions = {
             name: "Note Names",
             shortName: "Notes",
             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",
+            outputPreview: "C, D♭, D...",
+            sampleOutput: "C, D♭, D, E♭, E, F, G♭, G, A♭, A, B♭, B",
             inputKind: "rootAndNoteCollection",
             outputKind: "noteNames",
             outputShape: "chromatic-12",
@@ -29,7 +30,8 @@ export const conversions = {
             name: "Intervals",
             shortName: "Intervals",
             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",
+            outputPreview: "1, ♭2, 2...",
+            sampleOutput: "1, ♭2, 2, ♭3, 3, 4, ♭5, 5, ♭6, 6, ♭7, 7",
             inputKind: "rootAndNoteCollection",
             outputKind: "intervals",
             outputShape: "chromatic-12",
@@ -43,7 +45,8 @@ export const conversions = {
             name: "Extensions",
             shortName: "Extensions",
             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",
+            outputPreview: "1, ♭9, 9...",
+            sampleOutput: "1, ♭9, 9, ♭3, 3, 11, ♭5, 5, ♭13, 13, ♭7, 7",
             inputKind: "rootAndNoteCollection",
             outputKind: "intervals",
             outputShape: "chromatic-12",
@@ -57,7 +60,8 @@ export const conversions = {
             name: "Compound Intervals",
             shortName: "Compound",
             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",
+            outputPreview: "1, ♭9, 9, ♭10...",
+            sampleOutput: "1, ♭9, 9, ♭10, 10, 11, ♭12, 12, ♭13, 13, ♭14, 14",
             inputKind: "rootAndNoteCollection",
             outputKind: "intervals",
             outputShape: "chromatic-12",
@@ -71,7 +75,8 @@ export const conversions = {
             name: "Triads",
             shortName: "Triads",
             description: "Returns 12 chromatic triad-name slots for note collections with authored modal harmony.",
-            example: "CM, -, Dm, -, Em, FM, -, GM, -, Am, -, B°",
+            outputPreview: "CM, Dm, Em...",
+            sampleOutput: "CM, -, Dm, -, Em, FM, -, GM, -, Am, -, B°",
             inputKind: "rootAndNoteCollection",
             outputKind: "chordNames",
             outputShape: "chromatic-12",
@@ -87,7 +92,8 @@ export const conversions = {
             name: "Seventh Chords",
             shortName: "Sevenths",
             description: "Returns 12 chromatic seventh-chord-name slots for note collections with authored modal harmony.",
-            example: "CM7, -, Dm7, -, Em7, FM7, -, G7, -, Am7, -, Bø7",
+            outputPreview: "CM7, Dm7, Em7...",
+            sampleOutput: "CM7, -, Dm7, -, Em7, FM7, -, G7, -, Am7, -, Bø7",
             inputKind: "rootAndNoteCollection",
             outputKind: "chordNames",
             outputShape: "chromatic-12",
@@ -103,7 +109,8 @@ export const conversions = {
             name: "Roman Numeral Triads",
             shortName: "Roman Triads",
             description: "Returns 12 chromatic Roman numeral triad slots for note collections with authored modal harmony.",
-            example: "I, -, ii, -, iii, IV, -, V, -, vi, -, vii°",
+            outputPreview: "I, ii, iii...",
+            sampleOutput: "I, -, ii, -, iii, IV, -, V, -, vi, -, vii°",
             inputKind: "rootAndNoteCollection",
             outputKind: "romanNumerals",
             outputShape: "chromatic-12",
@@ -119,7 +126,8 @@ export const conversions = {
             name: "Roman Numeral Seventh Chords",
             shortName: "Roman Sevenths",
             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",
+            outputPreview: "IM7, iim7, iiim7...",
+            sampleOutput: "IM7, -, iim7, -, iiim7, IVM7, -, V7, -, vim7, -, viiø7",
             inputKind: "rootAndNoteCollection",
             outputKind: "romanNumerals",
             outputShape: "chromatic-12",

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

@@ -1,12 +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 declare function getScientificPitchOctaveForMidiNote(midi: number): number;
+export type MidiNoteSpellingPreference = "flat" | "sharp";
 export interface FormatMidiNoteOptions {
-    spelling?: MidiNoteSpelling;
+    spelling?: MidiNoteSpellingPreference;
 }
 export declare function formatMidiNote(midi: number, options?: FormatMidiNoteOptions): string;
-export declare function formatSpelledMidiNote(noteName: string, midi: number): string;
+export declare function formatNoteNameWithMidiOctave(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/esm/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;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"}
+{"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,mCAAmC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExE;AAED,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,OAAO,CAAC;AAE1D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,0BAA0B,CAAC;CACvC;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,qBAA0B,GAClC,MAAM,CAQR;AAED,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,MAAM,CAIR;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"}