@musodojo/music-theory-data 25.0.0 → 26.1.0

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

@@ -1,6 +1,6 @@
 import { type NoteCollectionKey } from "../data/note-collections/mod.js";
 import type { RomanSeventhChord, RomanTriad, SeventhChord, Triad } from "../types/chords";
-import { type TransformIntervalsOptions } from "./intervals.js";
+import { type NoteCollectionKeyTransformOptions, type RootAndNoteCollectionKeyTransformOptions } from "./intervals.js";
 import { type RootNote } from "../data/labels/note-labels.js";
 /**
  * Converts standard triad qualities (e.g., "M", "m") into their corresponding Roman numeral representations
@@ -21,27 +21,39 @@ export declare function getRomanSeventhChords(sevenths: SeventhChord[]): RomanSe
 /**
  * Retrieves the triads for a given note collection key.
  */
-export declare function getTriadsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): (Triad | undefined)[];
+export declare function getTriadsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: NoteCollectionKeyTransformOptions): (Triad | undefined)[];
 /**
  * Retrieves the seventh chords for a given note collection key.
  */
-export declare function getSeventhChordsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): (SeventhChord | undefined)[];
+export declare function getSeventhChordsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: NoteCollectionKeyTransformOptions): (SeventhChord | undefined)[];
 /**
  * Retrieves the Roman numeral triads for a given note collection key.
  */
-export declare function getRomanTriadsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): (RomanTriad | undefined)[];
+export declare function getRomanTriadsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: NoteCollectionKeyTransformOptions): (RomanTriad | undefined)[];
 /**
  * Retrieves the Roman numeral seventh chords for a given note collection key.
  */
-export declare function getRomanSeventhChordsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): (RomanSeventhChord | undefined)[];
+export declare function getRomanSeventhChordsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: NoteCollectionKeyTransformOptions): (RomanSeventhChord | undefined)[];
 /**
  * Retrieves the triads with prepended note names for a given root note and note collection key.
  * Example: ["CM", "Dm", "Em", "FM", "GM", "Am", "B°"]
  */
-export declare function getTriadsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): (string | undefined)[];
+export declare function getTriadsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: RootAndNoteCollectionKeyTransformOptions): (string | undefined)[];
 /**
  * Retrieves the seventh chords with prepended note names for a given root note and note collection key.
  * Example: ["CM7", "Dm7", "Em7", "FM7", "G7", "Am7", "Bø7"]
  */
-export declare function getSeventhChordsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): (string | undefined)[];
+export declare function getSeventhChordsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: RootAndNoteCollectionKeyTransformOptions): (string | undefined)[];
+/**
+ * Retrieves the Roman numeral triads for a given root note and note collection key.
+ * This is particularly useful when options.fillChromatic is true, as it positions the chords
+ * at their correct absolute pitch degrees.
+ */
+export declare function getRomanTriadsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: RootAndNoteCollectionKeyTransformOptions): (RomanTriad | undefined)[];
+/**
+ * Retrieves the Roman numeral seventh chords for a given root note and note collection key.
+ * This is particularly useful when options.fillChromatic is true, as it positions the chords
+ * at their correct absolute pitch degrees.
+ */
+export declare function getRomanSeventhChordsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: RootAndNoteCollectionKeyTransformOptions): (RomanSeventhChord | undefined)[];
 //# sourceMappingURL=chords.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"chords.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chords.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,iBAAiB,CAAC;AAkBzB,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAgB5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,iBAAiB,EAAE,CA0BrB;AAoKD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,CAAC,KAAK,GAAG,SAAS,CAAC,EAAE,CAMvB;AAED;;GAEG;AACH,wBAAgB,oCAAoC,CAClD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,CAAC,YAAY,GAAG,SAAS,CAAC,EAAE,CAM9B;AAED;;GAEG;AACH,wBAAgB,kCAAkC,CAChD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,CAAC,UAAU,GAAG,SAAS,CAAC,EAAE,CAO5B;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,CAAC,iBAAiB,GAAG,SAAS,CAAC,EAAE,CAOnC;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAexB;AAED;;;GAGG;AACH,wBAAgB,2CAA2C,CACzD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE,CAexB"}
+{"version":3,"file":"chords.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chords.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,iBAAiB,CAAC;AAkBzB,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAC9C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAEvC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAgB5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,iBAAiB,EAAE,CA0BrB;AAsLD;;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/esm/src/utils/chords.js

@@ -126,22 +126,31 @@ function getModeData(modeKey) {
  * @template T The underlying chord type extracted automatically from ModeData (e.g., `Triad` or `SeventhChord`).
  * @template U The final returned array type. If `transformRoman` is provided, this represents the Roman numeral type (e.g., `RomanTriad`). If no transformation is applied, `U` defaults to `T`.
  */
-function getChordsForNoteCollection(noteCollectionKey, options, extractChords, transformRoman) {
+function getChordsForNoteCollectionKey(noteCollectionKey, options, extractChords, transformRoman, rootOptions) {
     // 1. Verify that the requested note collection exists.
     const collection = noteCollections[noteCollectionKey];
     if (!collection)
         return [];
-    const { rotateRight, rotateToRootInteger0, rootNoteInteger, fillChromatic } = options;
+    const { rotateRight, fillChromatic } = options;
+    const { rotateToRootInteger0, rootNoteInteger } = rootOptions ?? {};
     // Helper function to apply requested rotations after the chord array is cleanly generated.
-    const applyRotations = (chordsArray) => {
+    const applyRotations = (chordsArray, isChromatic) => {
         let result = chordsArray;
         // If fillChromatic is true, the array represents the 12 absolute semitones (where index 0 = the root note relative to itself).
-        if (fillChromatic) {
+        if (isChromatic) {
             if (rotateToRootInteger0 && rootNoteInteger !== undefined) {
                 // Shift the array so that the absolute root note (rootNoteInteger) sits at index 0.
                 result = rotateArrayRight(result, rootNoteInteger);
             }
         }
+        else {
+            // NOTE: When fillChromatic is false, rotateToRootInteger0 doesn't make geometric sense
+            // because the array isn't guaranteed to be 12 elements. But if the user explicitly provided it
+            // we should simply shift the array elements by `rootNoteInteger` positions to satisfy the API.
+            if (rotateToRootInteger0 && rootNoteInteger !== undefined) {
+                result = rotateArrayRight(result, rootNoteInteger);
+            }
+        }
         // Apply any explicit arbitrary rightward rotations requested by the user.
         if (rotateRight !== undefined) {
             result = rotateArrayRight(result, rotateRight);
@@ -160,10 +169,10 @@ function getChordsForNoteCollection(noteCollectionKey, options, extractChords, t
             : rotatedChords;
         // 2c. If requested, map the sequential chord list into a 12-semitone chromatic sparse array.
         if (fillChromatic) {
-            return applyRotations(getChromaticArray(processedChords, data.intervals));
+            return applyRotations(getChromaticArray(processedChords, data.intervals), true);
         }
         // 2d. Otherwise, return the sequentially packed list.
-        return applyRotations(processedChords);
+        return applyRotations(processedChords, false);
     }
     // 3. If the collection is NOT a primary mode (e.g., a custom scale like Minor Pentatonic),
     // we cannot look up predefined chords. Instead, we fall back to its "most Similar Scale".
@@ -186,33 +195,33 @@ function getChordsForNoteCollection(noteCollectionKey, options, extractChords, t
         .filter((chord) => chord !== undefined);
     // 3c. Format and return just like step 2.
     if (fillChromatic) {
-        return applyRotations(getChromaticArray(collectionChords, collection.intervals));
+        return applyRotations(getChromaticArray(collectionChords, collection.intervals), true);
     }
-    return applyRotations(collectionChords);
+    return applyRotations(collectionChords, false);
 }
 /**
  * Retrieves the triads for a given note collection key.
  */
 export function getTriadsForNoteCollectionKey(noteCollectionKey, options = {}) {
-    return getChordsForNoteCollection(noteCollectionKey, options, (data) => data.triads);
+    return getChordsForNoteCollectionKey(noteCollectionKey, options, (data) => data.triads);
 }
 /**
  * Retrieves the seventh chords for a given note collection key.
  */
 export function getSeventhChordsForNoteCollectionKey(noteCollectionKey, options = {}) {
-    return getChordsForNoteCollection(noteCollectionKey, options, (data) => data.sevenths);
+    return getChordsForNoteCollectionKey(noteCollectionKey, options, (data) => data.sevenths);
 }
 /**
  * Retrieves the Roman numeral triads for a given note collection key.
  */
 export function getRomanTriadsForNoteCollectionKey(noteCollectionKey, options = {}) {
-    return getChordsForNoteCollection(noteCollectionKey, options, (data) => data.triads, getRomanTriads);
+    return getChordsForNoteCollectionKey(noteCollectionKey, options, (data) => data.triads, getRomanTriads);
 }
 /**
  * Retrieves the Roman numeral seventh chords for a given note collection key.
  */
 export function getRomanSeventhChordsForNoteCollectionKey(noteCollectionKey, options = {}) {
-    return getChordsForNoteCollection(noteCollectionKey, options, (data) => data.sevenths, getRomanSeventhChords);
+    return getChordsForNoteCollectionKey(noteCollectionKey, options, (data) => data.sevenths, getRomanSeventhChords);
 }
 /**
  * Retrieves the triads with prepended note names for a given root note and note collection key.
@@ -220,9 +229,10 @@ export function getRomanSeventhChordsForNoteCollectionKey(noteCollectionKey, opt
  */
 export function getTriadsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
     const noteNames = getNoteNamesForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options);
-    const chords = getTriadsForNoteCollectionKey(noteCollectionKey, {
-        ...options,
+    const { rotateToRootInteger0, ...restOptions } = options;
+    const chords = getChordsForNoteCollectionKey(noteCollectionKey, restOptions, (data) => data.triads, undefined, {
         rootNoteInteger: noteNameToIntegerMap.get(rootNote),
+        rotateToRootInteger0,
     });
     return chords.map((chord, i) => {
         if (chord === undefined)
@@ -236,9 +246,10 @@ export function getTriadsForRootAndNoteCollectionKey(rootNote, noteCollectionKey
  */
 export function getSeventhChordsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
     const noteNames = getNoteNamesForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options);
-    const chords = getSeventhChordsForNoteCollectionKey(noteCollectionKey, {
-        ...options,
+    const { rotateToRootInteger0, ...restOptions } = options;
+    const chords = getChordsForNoteCollectionKey(noteCollectionKey, restOptions, (data) => data.sevenths, undefined, {
         rootNoteInteger: noteNameToIntegerMap.get(rootNote),
+        rotateToRootInteger0,
     });
     return chords.map((chord, i) => {
         if (chord === undefined)
@@ -246,3 +257,27 @@ export function getSeventhChordsForRootAndNoteCollectionKey(rootNote, noteCollec
         return noteNames[i] + chord;
     });
 }
+/**
+ * Retrieves the Roman numeral triads for a given root note and note collection key.
+ * This is particularly useful when options.fillChromatic is true, as it positions the chords
+ * at their correct absolute pitch degrees.
+ */
+export function getRomanTriadsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
+    const { rotateToRootInteger0, ...restOptions } = options;
+    return getChordsForNoteCollectionKey(noteCollectionKey, restOptions, (data) => data.triads, getRomanTriads, {
+        rootNoteInteger: noteNameToIntegerMap.get(rootNote),
+        rotateToRootInteger0,
+    });
+}
+/**
+ * Retrieves the Roman numeral seventh chords for a given root note and note collection key.
+ * This is particularly useful when options.fillChromatic is true, as it positions the chords
+ * at their correct absolute pitch degrees.
+ */
+export function getRomanSeventhChordsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
+    const { rotateToRootInteger0, ...restOptions } = options;
+    return getChordsForNoteCollectionKey(noteCollectionKey, restOptions, (data) => data.sevenths, getRomanSeventhChords, {
+        rootNoteInteger: noteNameToIntegerMap.get(rootNote),
+        rotateToRootInteger0,
+    });
+}

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

@@ -0,0 +1,41 @@
+import type { 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.
+ */
+export interface ConversionRegistryOptions {
+    fillChromatic: true;
+    rotateToRootInteger0: true;
+    rotateRight?: number;
+}
+/**
+ * A generic function signature for all registry entries.
+ */
+export type ConversionFunction<T> = (rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options: ConversionRegistryOptions) => (T | undefined)[];
+export interface ConversionRegistryEntry<T> {
+    id: string;
+    name: string;
+    shortName: string;
+    description: string;
+    example: 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>;
+    };
+};
+//# sourceMappingURL=conversion-registry.d.ts.map

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

@@ -0,0 +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,CAAC,CAAC,GAAG,SAAS,CAAC,EAAE,CAAC;AAEvB,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"}

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

@@ -0,0 +1,71 @@
+import { getNoteNamesForRootAndNoteCollectionKey } from "./note-names.js";
+import { getCompoundIntervalsForRootAndNoteCollectionKey, getExtensionsForRootAndNoteCollectionKey, getIntervalsForRootAndNoteCollectionKey, } from "./intervals.js";
+import { getRomanSeventhChordsForRootAndNoteCollectionKey, getRomanTriadsForRootAndNoteCollectionKey, getSeventhChordsForRootAndNoteCollectionKey, getTriadsForRootAndNoteCollectionKey, } from "./chords.js";
+export const 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) => 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) => 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) => 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) => getCompoundIntervalsForRootAndNoteCollectionKey(root, key, opts),
+        },
+        triads: {
+            id: "triads",
+            name: "Triads",
+            shortName: "Triads",
+            description: "Returns the triads with prepended note names (e.g., 'Cm', 'E♭M', 'GM').",
+            example: "Cm, E♭M, GM",
+            get: (root, key, opts) => 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', 'GM7').",
+            example: "Cm7, E♭M7, GM7",
+            get: (root, key, opts) => 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) => 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) => getRomanSeventhChordsForRootAndNoteCollectionKey(root, key, opts),
+        },
+    },
+};

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

@@ -1,4 +1,4 @@
-import { type CompoundInterval, type Interval, type IntervalQuality, type SimpleInterval } from "../data/labels/note-labels.js";
+import { type CompoundInterval, type Interval, type IntervalQuality, type RootNote, type SimpleInterval } from "../data/labels/note-labels.js";
 import { type NoteCollectionKey } from "../data/note-collections/mod.js";
 /**
  * Removes octave intervals (such as "8" or "♮8") from a given list of intervals.
@@ -110,6 +110,8 @@ export type TransformIntervalsOptions = {
     rootNoteInteger?: never;
     rotateToRootInteger0?: never;
 });
+export type NoteCollectionKeyTransformOptions = Pick<TransformIntervalsOptions, "intervalTransformation" | "filterOutOctave" | "shouldSort" | "rotateRight" | "fillChromatic">;
+export type RootAndNoteCollectionKeyTransformOptions = Pick<TransformIntervalsOptions, "intervalTransformation" | "filterOutOctave" | "shouldSort" | "rotateRight" | "fillChromatic" | "rootNoteInteger" | "rotateToRootInteger0">;
 export declare function transformIntervals(intervals: readonly Interval[], options?: TransformIntervalsOptions): Interval[];
 /**
  * Retrieves the base intervals associated with a given set of interval qualities.
@@ -126,7 +128,7 @@ export declare function getIntervalsForQualities(qualities: readonly IntervalQua
  * @param options Optional parameter for interval transformations.
  * @returns An array of intervals.
  */
-export declare function getIntervalsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale" | "rootNoteInteger" | "rotateToRootInteger0">): Interval[];
+export declare function getIntervalsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: NoteCollectionKeyTransformOptions): Interval[];
 /**
  * Retrieves an array of extended intervals for a given note collection key.
  * All simple intervals are transformed to their extension equivalents where applicable (e.g. 2 -> 9).
@@ -135,7 +137,7 @@ export declare function getIntervalsForNoteCollectionKey(noteCollectionKey: Note
  * @param options Optional parameter for interval transformations (intervalTransformation is overridden).
  * @returns An array of extended intervals.
  */
-export declare function getExtensionsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale" | "rootNoteInteger" | "rotateToRootInteger0" | "intervalTransformation">): Interval[];
+export declare function getExtensionsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<NoteCollectionKeyTransformOptions, "intervalTransformation">): Interval[];
 /**
  * Retrieves an array of compound intervals for a given note collection key.
  * All simple intervals are transformed to their compound equivalents where applicable (e.g. 2 -> 9, 3 -> 10).
@@ -144,5 +146,35 @@ export declare function getExtensionsForNoteCollectionKey(noteCollectionKey: Not
  * @param options Optional parameter for interval transformations (intervalTransformation is overridden).
  * @returns An array of compound intervals.
  */
-export declare function getCompoundIntervalsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale" | "rootNoteInteger" | "rotateToRootInteger0" | "intervalTransformation">): Interval[];
+export declare function getCompoundIntervalsForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<NoteCollectionKeyTransformOptions, "intervalTransformation">): Interval[];
+/**
+ * Retrieves an array of intervals for a given root note and note collection key.
+ * Can optionally fill chromatically.
+ *
+ * @param rootNote The root note to base the intervals on.
+ * @param noteCollectionKey The key representing the note collection.
+ * @param options Optional parameter for interval transformations.
+ * @returns An array of intervals.
+ */
+export declare function getIntervalsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: RootAndNoteCollectionKeyTransformOptions): Interval[];
+/**
+ * Retrieves an array of extended intervals for a given root note and note collection key.
+ * All simple intervals are transformed to their extension equivalents where applicable (e.g. 2 -> 9).
+ *
+ * @param rootNote The root note to base the intervals on.
+ * @param noteCollectionKey The key representing the note collection.
+ * @param options Optional parameter for interval transformations (intervalTransformation is overridden).
+ * @returns An array of extended intervals.
+ */
+export declare function getExtensionsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<RootAndNoteCollectionKeyTransformOptions, "intervalTransformation">): Interval[];
+/**
+ * Retrieves an array of compound intervals for a given root note and note collection key.
+ * All simple intervals are transformed to their compound equivalents where applicable (e.g. 2 -> 9, 3 -> 10).
+ *
+ * @param rootNote The root note to base the intervals on.
+ * @param noteCollectionKey The key representing the note collection.
+ * @param options Optional parameter for interval transformations (intervalTransformation is overridden).
+ * @returns An array of compound intervals.
+ */
+export declare function getCompoundIntervalsForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<RootAndNoteCollectionKeyTransformOptions, "intervalTransformation">): Interval[];
 //# sourceMappingURL=intervals.d.ts.map

package/esm/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":"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"}

package/esm/src/utils/intervals.js

@@ -1,4 +1,4 @@
-import { compoundToSimpleIntervalMap, extensionToSimpleIntervalMap, intervalQualityToIntervalMap, intervalToIntegerMap, simpleToCompoundIntervalMap, simpleToExtensionIntervalMap, } from "../data/labels/note-labels.js";
+import { compoundToSimpleIntervalMap, extensionToSimpleIntervalMap, intervalQualityToIntervalMap, intervalToIntegerMap, noteNameToIntegerMap, simpleToCompoundIntervalMap, simpleToExtensionIntervalMap, } from "../data/labels/note-labels.js";
 import { noteCollections, } from "../data/note-collections/mod.js";
 import { noteLabelCollections } from "../data/labels/note-label-collections.js";
 import { rotateArrayRight } from "./rotate-array.js";
@@ -273,3 +273,64 @@ export function getCompoundIntervalsForNoteCollectionKey(noteCollectionKey, opti
         intervalTransformation: "simpleToCompound",
     });
 }
+/**
+ * Retrieves an array of intervals for a given root note and note collection key.
+ * Can optionally fill chromatically.
+ *
+ * @param rootNote The root note to base the intervals on.
+ * @param noteCollectionKey The key representing the note collection.
+ * @param options Optional parameter for interval transformations.
+ * @returns An array of intervals.
+ */
+export function getIntervalsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
+    if (!isValidNoteCollectionKey(noteCollectionKey))
+        return [];
+    const collection = noteCollections[noteCollectionKey];
+    const mostSimilarScale = collection.mostSimilarScale;
+    const finalOptions = options.fillChromatic &&
+        mostSimilarScale &&
+        mostSimilarScale !== noteCollectionKey
+        ? {
+            ...options,
+            fillChromatic: true,
+            mostSimilarScale: mostSimilarScale,
+            rootNoteInteger: noteNameToIntegerMap.get(rootNote),
+        }
+        : {
+            ...options,
+            rootNoteInteger: noteNameToIntegerMap.get(rootNote),
+        };
+    return transformIntervals(collection.intervals, finalOptions);
+}
+/**
+ * Retrieves an array of extended intervals for a given root note and note collection key.
+ * All simple intervals are transformed to their extension equivalents where applicable (e.g. 2 -> 9).
+ *
+ * @param rootNote The root note to base the intervals on.
+ * @param noteCollectionKey The key representing the note collection.
+ * @param options Optional parameter for interval transformations (intervalTransformation is overridden).
+ * @returns An array of extended intervals.
+ */
+export function getExtensionsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
+    return getIntervalsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, {
+        filterOutOctave: true,
+        ...options,
+        intervalTransformation: "simpleToExtension",
+    });
+}
+/**
+ * Retrieves an array of compound intervals for a given root note and note collection key.
+ * All simple intervals are transformed to their compound equivalents where applicable (e.g. 2 -> 9, 3 -> 10).
+ *
+ * @param rootNote The root note to base the intervals on.
+ * @param noteCollectionKey The key representing the note collection.
+ * @param options Optional parameter for interval transformations (intervalTransformation is overridden).
+ * @returns An array of compound intervals.
+ */
+export function getCompoundIntervalsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, options = {}) {
+    return getIntervalsForRootAndNoteCollectionKey(rootNote, noteCollectionKey, {
+        filterOutOctave: true,
+        ...options,
+        intervalTransformation: "simpleToCompound",
+    });
+}

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

@@ -1,5 +1,6 @@
 export * from "./colors.js";
 export * from "./chords.js";
+export * from "./conversion-registry.js";
 export * from "./intervals.js";
 export * from "./midi-note-sequences.js";
 export * from "./midi.js";

package/esm/src/utils/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,0BAA0B,CAAC;AACzC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,0BAA0B,CAAC;AACzC,cAAc,WAAW,CAAC;AAC1B,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC"}

package/esm/src/utils/mod.js

@@ -1,5 +1,6 @@
 export * from "./colors.js";
 export * from "./chords.js";
+export * from "./conversion-registry.js";
 export * from "./intervals.js";
 export * from "./midi-note-sequences.js";
 export * from "./midi.js";

package/esm/src/utils/note-names.d.ts

@@ -1,6 +1,6 @@
 import { type Interval, type NoteName, type RootNote, type RootNoteInteger } from "../data/labels/note-labels.js";
 import { type NoteCollectionKey } from "../data/note-collections/mod.js";
-import { type TransformIntervalsOptions } from "./intervals.js";
+import { type RootAndNoteCollectionKeyTransformOptions, type TransformIntervalsOptions } from "./intervals.js";
 /**
  * Parses a string and returns a canonical `NoteName` if the string is a valid note name.
  * This is useful for handling user input that may use ASCII characters like 'b' and '#',
@@ -58,5 +58,5 @@ export declare function getNoteNamesForRootAndIntervals(rootNote: RootNote, inte
  * @param options Optional settings for interval transformations or output formatting.
  * @returns An array of computed note names.
  */
-export declare function getNoteNamesForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): NoteName[];
+export declare function getNoteNamesForRootAndNoteCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: RootAndNoteCollectionKeyTransformOptions): NoteName[];
 //# sourceMappingURL=note-names.d.ts.map

package/esm/src/utils/note-names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-names.d.ts","sourceRoot":"","sources":["../../../src/src/utils/note-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAIb,KAAK,QAAQ,EAGb,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAQxB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CA2B1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,QAAQ,EAAE,CAIZ;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,QAAQ,EAAE,CAIZ;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAI7B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CA+BZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,QAAQ,EAAE,CAqBZ"}
+{"version":3,"file":"note-names.d.ts","sourceRoot":"","sources":["../../../src/src/utils/note-names.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,QAAQ,EAIb,KAAK,QAAQ,EAGb,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,KAAK,wCAAwC,EAE7C,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAQxB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CA2B1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,QAAQ,EAAE,CAIZ;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ1E;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,SAAS,MAAM,EAAE,GACvB,QAAQ,EAAE,CAIZ;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAI7B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CA+BZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,wCAA6C,GACrD,QAAQ,EAAE,CAqBZ"}

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

@@ -1,7 +1,7 @@
 import { type Interval, type IntervalQuality } from "../data/labels/note-labels.js";
 import { type NoteCollectionKey } from "../data/note-collections/mod.js";
 import type { NoteCollection } from "../types/note-collections";
-import { type TransformIntervalsOptions } from "./intervals.js";
+import { type NoteCollectionKeyTransformOptions, type TransformIntervalsOptions } from "./intervals.js";
 /**
  * Calculates an array of specific interval qualities given an array of intervals.
  * Supports filling chromatic passing notes and other transformations via options.
@@ -19,7 +19,7 @@ export declare function getQualitiesForIntervals(intervals: readonly Interval[],
  * @param options Optional settings for interval transformations or output formatting.
  * @returns An array of computed interval qualities.
  */
-export declare function getQualitiesForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): IntervalQuality[];
+export declare function getQualitiesForNoteCollectionKey(noteCollectionKey: NoteCollectionKey, options?: NoteCollectionKeyTransformOptions): IntervalQuality[];
 /**
  * Extracts the interval qualities (e.g., "P1", "M2", "m3") from a NoteCollection.
  * Automatically inherits contextual hint data (like `mostSimilarScale`) from the collection.
@@ -27,5 +27,5 @@ export declare function getQualitiesForNoteCollectionKey(noteCollectionKey: Note
  * @param options Optional settings for interval transformations or output formatting.
  * @returns An array of IntervalQuality strings.
  */
-export declare function getQualitiesForNoteCollection(collection: NoteCollection, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): IntervalQuality[];
+export declare function getQualitiesForNoteCollection(collection: NoteCollection, options?: NoteCollectionKeyTransformOptions): IntervalQuality[];
 //# sourceMappingURL=qualities.d.ts.map

package/esm/src/utils/qualities.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"qualities.d.ts","sourceRoot":"","sources":["../../../src/src/utils/qualities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EAEL,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,eAAe,EAAE,CASnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,eAAe,EAAE,CAKnB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,cAAc,EAC1B,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,eAAe,EAAE,CAanB"}
+{"version":3,"file":"qualities.d.ts","sourceRoot":"","sources":["../../../src/src/utils/qualities.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,eAAe,EAErB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,KAAK,iCAAiC,EAEtC,KAAK,yBAAyB,EAC/B,MAAM,gBAAgB,CAAC;AAGxB;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,eAAe,EAAE,CASnB;AAED;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAC9C,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,iCAAsC,GAC9C,eAAe,EAAE,CAKnB;AAED;;;;;;GAMG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,cAAc,EAC1B,OAAO,GAAE,iCAAsC,GAC9C,eAAe,EAAE,CAanB"}

package/esm/tests/conversion-registry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-registry.test.d.ts","sourceRoot":"","sources":["../../src/tests/conversion-registry.test.ts"],"names":[],"mappings":""}

package/esm/tests/intervals.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intervals.test.d.ts","sourceRoot":"","sources":["../../src/tests/intervals.test.ts"],"names":[],"mappings":""}

package/esm/tests/note-collections.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"note-collections.test.d.ts","sourceRoot":"","sources":["../../src/tests/note-collections.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@musodojo/music-theory-data",
-  "version": "25.0.0",
+  "version": "26.1.0",
   "description": "The musician-friendly TypeScript library for scales, modes, chords, and arpeggios.",
   "keywords": [
     "music",