@musodojo/music-theory-data 21.1.1 → 23.0.0

package/esm/src/data/labels/note-label-collections.d.ts

@@ -21,18 +21,42 @@ export interface NoteLabelCollection {
     readonly labels: NoteLabelGroup;
 }
 declare const _noteLabelCollections: {
-    readonly flat: {
-        readonly name: "Flat Notes";
-        readonly shortName: "Flat";
+    readonly noteNamesFlat: {
+        readonly name: "Flat Note Names";
+        readonly shortName: "Flat Notes";
         readonly isRelative: false;
         readonly labels: readonly ["C", "D♭", "D", "E♭", "E", "F", "G♭", "G", "A♭", "A", "B♭", "B"];
     };
-    readonly sharp: {
-        readonly name: "Sharp Notes";
-        readonly shortName: "Sharp";
+    readonly noteNamesSharp: {
+        readonly name: "Sharp Note Names";
+        readonly shortName: "Sharp Notes";
         readonly isRelative: false;
         readonly labels: readonly ["C", "C♯", "D", "D♯", "E", "F", "F♯", "G", "G♯", "A", "A♯", "B"];
     };
+    readonly intervalsFlat: {
+        readonly name: "Flat Note Intervals";
+        readonly shortName: "Flat Intervals";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♭2", "2", "♭3", "3", "4", "♭5", "5", "♭6", "6", "♭7", "7"];
+    };
+    readonly intervalsSharp: {
+        readonly name: "Sharp Note Intervals";
+        readonly shortName: "Sharp Intervals";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♯1", "2", "♯2", "3", "4", "♯4", "5", "♯5", "6", "♯6", "7"];
+    };
+    readonly extensionsFlat: {
+        readonly name: "Flat Note Extensions";
+        readonly shortName: "Flat Extensions";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♭9", "9", "♭3", "3", "11", "♭5", "5", "♭13", "13", "♭7", "7"];
+    };
+    readonly extensionsSharp: {
+        readonly name: "Sharp Note Extensions";
+        readonly shortName: "Sharp Extensions";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♯1", "9", "♯9", "3", "11", "♯11", "5", "♯5", "13", "♯13", "7"];
+    };
     readonly fixedDoFlat: {
         readonly name: "Solfege Fixed Do Flat Notes";
         readonly shortName: "Fixed Do Flat";

package/esm/src/data/labels/note-label-collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,SAAS;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FjB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,sBAAsB,EACtB,mBAAmB,CACI,CAAC"}
+{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,SAAS;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoJjB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,sBAAsB,EACtB,mBAAmB,CACI,CAAC"}

package/esm/src/data/labels/note-label-collections.js

@@ -1,16 +1,66 @@
 const _noteLabelCollections = {
-    flat: {
-        name: "Flat Notes",
-        shortName: "Flat",
+    noteNamesFlat: {
+        name: "Flat Note Names",
+        shortName: "Flat Notes",
         isRelative: false,
         labels: ["C", "D♭", "D", "E♭", "E", "F", "G♭", "G", "A♭", "A", "B♭", "B"],
     },
-    sharp: {
-        name: "Sharp Notes",
-        shortName: "Sharp",
+    noteNamesSharp: {
+        name: "Sharp Note Names",
+        shortName: "Sharp Notes",
         isRelative: false,
         labels: ["C", "C♯", "D", "D♯", "E", "F", "F♯", "G", "G♯", "A", "A♯", "B"],
     },
+    intervalsFlat: {
+        name: "Flat Note Intervals",
+        shortName: "Flat Intervals",
+        isRelative: true,
+        labels: ["1", "♭2", "2", "♭3", "3", "4", "♭5", "5", "♭6", "6", "♭7", "7"],
+    },
+    intervalsSharp: {
+        name: "Sharp Note Intervals",
+        shortName: "Sharp Intervals",
+        isRelative: true,
+        labels: ["1", "♯1", "2", "♯2", "3", "4", "♯4", "5", "♯5", "6", "♯6", "7"],
+    },
+    extensionsFlat: {
+        name: "Flat Note Extensions",
+        shortName: "Flat Extensions",
+        isRelative: true,
+        labels: [
+            "1",
+            "♭9",
+            "9",
+            "♭3",
+            "3",
+            "11",
+            "♭5",
+            "5",
+            "♭13",
+            "13",
+            "♭7",
+            "7",
+        ],
+    },
+    extensionsSharp: {
+        name: "Sharp Note Extensions",
+        shortName: "Sharp Extensions",
+        isRelative: true,
+        labels: [
+            "1",
+            "♯1",
+            "9",
+            "♯9",
+            "3",
+            "11",
+            "♯11",
+            "5",
+            "♯5",
+            "13",
+            "♯13",
+            "7",
+        ],
+    },
     fixedDoFlat: {
         name: "Solfege Fixed Do Flat Notes",
         shortName: "Fixed Do Flat",

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

@@ -1,9 +1,10 @@
 import { type Interval, type IntervalQuality } from "../data/labels/note-labels.js";
 import type { NoteCollection } from "../types/note-collections";
-import type { NoteCollectionKey } from "../data/note-collections/mod.js";
+import { type NoteCollectionKey } from "../data/note-collections/mod.js";
 /**
  * Removes octave intervals (such as "8" or "♮8") from a given list of intervals.
- * Highly useful for standardizing chord definitions that conventionally ignore the octave.
+ * Highly useful for standardizing chord and scale definitions (scales conventionally include the octave,
+ * chords conventionally do not).
  *
  * @param intervals The array of intervals to filter.
  * @returns A new array excluding any octave intervals.
@@ -19,14 +20,56 @@ export declare function sortIntervals(intervals: readonly Interval[]): Interval[
 /** Specifies a direction for converting between simple and compound/extension intervals. */
 export type IntervalTransformation = "simpleToExtension" | "extensionToSimple" | "simpleToCompound" | "compoundToSimple";
 /** Options for grouping and preprocessing intervals before they are evaluated. */
-export interface TransformIntervalsOptions {
+export type TransformIntervalsOptions = {
+    /**
+     * Transforms intervals between simple, compound, and extended forms.
+     * For example, "simpleToExtension" might change "2" into "9".
+     */
     intervalTransformation?: IntervalTransformation;
+    /**
+     * Continues to filter out octave intervals (like "8") from the results.
+     * Typically useful for scales where octaves are included by default but not needed for some applications.
+     */
     filterOutOctave?: boolean;
+    /**
+     * Will sort intervals in ascending order based on their integer value.
+     * If `fillChromatic` is true, sorting is ignored as the array is fixed to the 12 semitones.
+     */
     shouldSort?: boolean;
-    fillChromatic?: boolean;
-    rotateToRootInteger0?: boolean;
+    /**
+     * A fixed number of steps to rotate the array left (positive) or right (negative).
+     * Rotation pushes elements from the beginning of the array to the end (left) or vice versa.
+     */
+    rotateLeft?: number;
+} & ({
+    /**
+     * When true, generates a 12-element array representing the chromatic scale (0-11).
+     * Missing semitones are filled with standard flat intervals (like "♭2").
+     * Compound intervals are placed in their respective integer modulo 12 slot.
+     */
+    fillChromatic: true;
+    /**
+     * If `fillChromatic` is true, this optionally overlays intervals from a known
+     * note collection (like a major scale) to provide better enharmonic spelling
+     * for the "background" chromatic notes.
+     */
     mostSimilarScale?: NoteCollectionKey;
-}
+    /**
+     * If provided, allows for absolute rotations (like rotating to C=0).
+     */
+    rootNoteInteger?: number;
+    /**
+     * Rotates the returned array so that the note corresponding to root C (integer 0)
+     * is positioned at index 0. Has no semantic effect on purely relative intervals.
+     * Only applicable when fillChromatic is true and rootNoteInteger is provided.
+     */
+    rotateToRootInteger0?: boolean;
+} | {
+    fillChromatic?: false;
+    mostSimilarScale?: never;
+    rootNoteInteger?: never;
+    rotateToRootInteger0?: never;
+});
 /**
  * Applies a series of formatting steps to an array of intervals, such as changing compound formats,
  * filtering octaves, and sorting.

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":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,eAAe,EAMrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,EAAE,CAEZ;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,kFAAkF;AAClF,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CA+BZ;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,eAAe,EAAE,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,eAAe,EAAE,GAC3B,QAAQ,EAAE,CAKZ;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,cAAc,GACzB,eAAe,EAAE,CAEnB"}
+{"version":3,"file":"intervals.d.ts","sourceRoot":"","sources":["../../../src/src/utils/intervals.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,eAAe,EAMrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AAIzC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,EAAE,CAEZ;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,kFAAkF;AAClF,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,CACA;IACE;;;;OAIG;IACH,aAAa,EAAE,IAAI,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACD;IACE,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,oBAAoB,CAAC,EAAE,KAAK,CAAC;CAC9B,CACJ,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CAiFZ;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,eAAe,EAAE,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,eAAe,EAAE,GAC3B,QAAQ,EAAE,CAKZ;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,cAAc,GACzB,eAAe,EAAE,CAEnB"}

package/esm/src/utils/intervals.js

@@ -1,7 +1,11 @@
 import { compoundToSimpleIntervalMap, extensionToSimpleIntervalMap, intervalQualityToIntervalMap, intervalToIntegerMap, intervalToIntervalQualityMap, simpleToCompoundIntervalMap, simpleToExtensionIntervalMap, } from "../data/labels/note-labels.js";
+import { noteCollections, } from "../data/note-collections/mod.js";
+import { noteLabelCollections } from "../mod.js";
+import { rotateArrayLeft } from "./rotate-array.js";
 /**
  * Removes octave intervals (such as "8" or "♮8") from a given list of intervals.
- * Highly useful for standardizing chord definitions that conventionally ignore the octave.
+ * Highly useful for standardizing chord and scale definitions (scales conventionally include the octave,
+ * chords conventionally do not).
  *
  * @param intervals The array of intervals to filter.
  * @returns A new array excluding any octave intervals.
@@ -33,7 +37,7 @@ export function sortIntervals(intervals) {
  * @returns A new transformed array of intervals.
  */
 export function transformIntervals(intervals, options = {}) {
-    const { intervalTransformation, filterOutOctave = false, shouldSort = true, } = options;
+    const { intervalTransformation, filterOutOctave = false, shouldSort = true, fillChromatic = false, mostSimilarScale, rotateLeft, } = options;
     const intervalMap = (() => {
         switch (intervalTransformation) {
             case "simpleToExtension":
@@ -51,8 +55,46 @@ export function transformIntervals(intervals, options = {}) {
     const fundamentalIntervals = filterOutOctave
         ? filterOutOctaveIntervals(intervals)
         : intervals;
-    const finalIntervals = fundamentalIntervals.map((interval) => intervalMap.get(interval) ?? interval);
-    return shouldSort ? sortIntervals(finalIntervals) : finalIntervals;
+    const transformedIntervals = fundamentalIntervals.map((interval) => intervalMap.get(interval) ?? interval);
+    if (fillChromatic) {
+        const chromaticMap = [
+            ...noteLabelCollections.intervalsFlat.labels,
+        ];
+        if (mostSimilarScale) {
+            const collection = noteCollections[mostSimilarScale];
+            if (collection && collection.intervals !== intervals) {
+                collection.intervals.forEach((interval) => {
+                    const transformed = intervalMap.get(interval) ?? interval;
+                    const semitones = intervalToIntegerMap.get(transformed);
+                    if (semitones !== undefined) {
+                        chromaticMap[semitones % 12] = transformed;
+                    }
+                });
+            }
+        }
+        // Now overlay the provided parsed intervals
+        transformedIntervals.forEach((interval) => {
+            const semitones = intervalToIntegerMap.get(interval);
+            if (semitones !== undefined) {
+                chromaticMap[semitones % 12] = interval;
+            }
+        });
+        let result = chromaticMap;
+        if (options.rotateToRootInteger0 && options.rootNoteInteger !== undefined) {
+            result = rotateArrayLeft(result, -options.rootNoteInteger);
+        }
+        if (rotateLeft !== undefined) {
+            result = rotateArrayLeft(result, rotateLeft);
+        }
+        return result;
+    }
+    let result = shouldSort
+        ? sortIntervals(transformedIntervals)
+        : transformedIntervals;
+    if (rotateLeft !== undefined) {
+        result = rotateArrayLeft(result, rotateLeft);
+    }
+    return result;
 }
 /**
  * Extracts generic interval qualities (e.g., "P5", "m3" becomes "P", "m") from a list of intervals.

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

@@ -44,5 +44,5 @@ export declare function getNoteNamesFromRootAndIntervals(rootNote: RootNote, int
  * @param options Optional settings for interval transformations or output formatting.
  * @returns An array of computed note names.
  */
-export declare function getNoteNamesFromRootAndCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: TransformIntervalsOptions): NoteName[];
+export declare function getNoteNamesFromRootAndCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): 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;AAEvC,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,CAsE1E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAI7B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CA4EZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CAkBZ"}
+{"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,CAsE1E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAI7B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CAgCZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,QAAQ,EAAE,CAuBZ"}

package/esm/src/utils/note-names.js

@@ -1,9 +1,7 @@
 import { enharmonicNoteNameGroups, intervalToIntegerMap, noteLetters, noteNamesSet, noteNameToIntegerMap, rootNotesSet, } from "../data/labels/note-labels.js";
-import { noteLabelCollections } from "../data/labels/note-label-collections.js";
 import { noteCollections, } from "../data/note-collections/mod.js";
 import { transformIntervals, } from "./intervals.js";
 import { isValidNoteCollectionKey } from "./note-collections.js";
-import { rotateArrayLeft } from "./rotate-array.js";
 const NOTE_LETTER_REGEX = /^[A-Ga-g]/;
 const ACCIDENTAL_REGEX = /([#♯xX𝄪]+)|([b♭𝄫]+)/gu;
 const INTERVAL_NUMBER_REGEX = /\d+/;
@@ -148,56 +146,21 @@ export function getNoteNamesFromRootAndIntervals(rootNote, intervals, options =
     const rootNoteLetter = rootNote.charAt(0).toUpperCase();
     const rootNoteLetterIndex = noteLetters.indexOf(rootNoteLetter);
     // 2. Transform Intervals
-    const intervalsToConvert = Object.keys(options).length > 0
-        ? transformIntervals(intervals, options)
+    const enhancedOptions = options.fillChromatic
+        ? {
+            ...options,
+            ...(options.rotateToRootInteger0 ? { rootNoteInteger } : {}),
+        }
+        : options;
+    const intervalsToConvert = Object.keys(enhancedOptions).length > 0
+        ? transformIntervals(intervals, enhancedOptions)
         : intervals;
-    let noteNames;
     // 3. Generate Note Names
-    if (options.fillChromatic) {
-        // Initialize 12-note array with default flat notes relative to the root
-        // This ensures every semitone slot has a value (e.g., C, Db, D...)
-        const flatNotes = noteLabelCollections.flat.labels;
-        noteNames = Array.from({ length: 12 }, (_, i) => {
-            const absoluteInteger = (rootNoteInteger + i) % 12;
-            return flatNotes[absoluteInteger];
-        });
-        // 3a. Overlay mostSimilarScale if provided (to provide better accidental contexts)
-        if (options.mostSimilarScale) {
-            const similarCollection = noteCollections[options.mostSimilarScale];
-            if (similarCollection && similarCollection.intervals !== intervals) {
-                similarCollection.intervals.forEach((interval) => {
-                    const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
-                    if (result) {
-                        noteNames[result.semitoneOffset] = result.noteName;
-                    }
-                });
-            }
-        }
-        // Overwrite default notes with specific notes calculated from intervals
-        intervalsToConvert.forEach((interval) => {
-            const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
-            if (result) {
-                noteNames[result.semitoneOffset] = result.noteName;
-            }
-        });
-    }
-    else {
-        // Map intervals directly to note names
-        noteNames = intervalsToConvert.flatMap((interval) => {
-            const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
-            return result ? [result.noteName] : [];
-        });
-    }
-    // 4. Rotate Array (Optional)
-    if (options.rotateToRootInteger0) {
-        // Rotate so that the note corresponding to integer 0 (C) is at index 0.
-        // e.g., if Root is D (2), the array currently starts at D.
-        // To move C (currently at index 10) to index 0, we rotate right by 2 (rootNoteInteger).
-        // rotateArrayLeft performs a left shift for positive values.
-        // To move C (at index -rootNoteInteger) to 0, we need to shift right by rootNoteInteger.
-        // So we rotate by -rootNoteInteger.
-        noteNames = rotateArrayLeft(noteNames, -rootNoteInteger);
-    }
+    // Map intervals directly to note names
+    const noteNames = intervalsToConvert.flatMap((interval) => {
+        const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
+        return result ? [result.noteName] : [];
+    });
     return noteNames;
 }
 /**
@@ -214,11 +177,15 @@ export function getNoteNamesFromRootAndCollectionKey(rootNote, noteCollectionKey
     if (!isValidNoteCollectionKey(noteCollectionKey))
         return [];
     const collection = noteCollections[noteCollectionKey];
-    const mostSimilarScale = "mostSimilarScale" in collection
-        ? collection.mostSimilarScale
-        : undefined;
-    const finalOptions = mostSimilarScale && mostSimilarScale !== noteCollectionKey
-        ? { ...options, mostSimilarScale: mostSimilarScale }
+    const mostSimilarScale = "mostSimilarScale" in collection ? collection.mostSimilarScale : undefined;
+    const finalOptions = options.fillChromatic &&
+        mostSimilarScale &&
+        mostSimilarScale !== noteCollectionKey
+        ? {
+            ...options,
+            fillChromatic: true,
+            mostSimilarScale: mostSimilarScale,
+        }
         : options;
     return getNoteNamesFromRootAndIntervals(rootNote, collection.intervals, finalOptions);
 }

package/package.json

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

package/script/src/data/labels/note-label-collections.d.ts

@@ -21,18 +21,42 @@ export interface NoteLabelCollection {
     readonly labels: NoteLabelGroup;
 }
 declare const _noteLabelCollections: {
-    readonly flat: {
-        readonly name: "Flat Notes";
-        readonly shortName: "Flat";
+    readonly noteNamesFlat: {
+        readonly name: "Flat Note Names";
+        readonly shortName: "Flat Notes";
         readonly isRelative: false;
         readonly labels: readonly ["C", "D♭", "D", "E♭", "E", "F", "G♭", "G", "A♭", "A", "B♭", "B"];
     };
-    readonly sharp: {
-        readonly name: "Sharp Notes";
-        readonly shortName: "Sharp";
+    readonly noteNamesSharp: {
+        readonly name: "Sharp Note Names";
+        readonly shortName: "Sharp Notes";
         readonly isRelative: false;
         readonly labels: readonly ["C", "C♯", "D", "D♯", "E", "F", "F♯", "G", "G♯", "A", "A♯", "B"];
     };
+    readonly intervalsFlat: {
+        readonly name: "Flat Note Intervals";
+        readonly shortName: "Flat Intervals";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♭2", "2", "♭3", "3", "4", "♭5", "5", "♭6", "6", "♭7", "7"];
+    };
+    readonly intervalsSharp: {
+        readonly name: "Sharp Note Intervals";
+        readonly shortName: "Sharp Intervals";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♯1", "2", "♯2", "3", "4", "♯4", "5", "♯5", "6", "♯6", "7"];
+    };
+    readonly extensionsFlat: {
+        readonly name: "Flat Note Extensions";
+        readonly shortName: "Flat Extensions";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♭9", "9", "♭3", "3", "11", "♭5", "5", "♭13", "13", "♭7", "7"];
+    };
+    readonly extensionsSharp: {
+        readonly name: "Sharp Note Extensions";
+        readonly shortName: "Sharp Extensions";
+        readonly isRelative: true;
+        readonly labels: readonly ["1", "♯1", "9", "♯9", "3", "11", "♯11", "5", "♯5", "13", "♯13", "7"];
+    };
     readonly fixedDoFlat: {
         readonly name: "Solfege Fixed Do Flat Notes";
         readonly shortName: "Fixed Do Flat";

package/script/src/data/labels/note-label-collections.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,SAAS;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8FjB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,sBAAsB,EACtB,mBAAmB,CACI,CAAC"}
+{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,SAAS;IACpC,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACP,CAAC;AAEF,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoJjB,CAAC;AAEX,+EAA+E;AAC/E,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,qBAAqB,CAAC;AAExE,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,EAAE,MAAM,CACvC,sBAAsB,EACtB,mBAAmB,CACI,CAAC"}

package/script/src/data/labels/note-label-collections.js

@@ -2,18 +2,68 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.noteLabelCollections = void 0;
 const _noteLabelCollections = {
-    flat: {
-        name: "Flat Notes",
-        shortName: "Flat",
+    noteNamesFlat: {
+        name: "Flat Note Names",
+        shortName: "Flat Notes",
         isRelative: false,
         labels: ["C", "D♭", "D", "E♭", "E", "F", "G♭", "G", "A♭", "A", "B♭", "B"],
     },
-    sharp: {
-        name: "Sharp Notes",
-        shortName: "Sharp",
+    noteNamesSharp: {
+        name: "Sharp Note Names",
+        shortName: "Sharp Notes",
         isRelative: false,
         labels: ["C", "C♯", "D", "D♯", "E", "F", "F♯", "G", "G♯", "A", "A♯", "B"],
     },
+    intervalsFlat: {
+        name: "Flat Note Intervals",
+        shortName: "Flat Intervals",
+        isRelative: true,
+        labels: ["1", "♭2", "2", "♭3", "3", "4", "♭5", "5", "♭6", "6", "♭7", "7"],
+    },
+    intervalsSharp: {
+        name: "Sharp Note Intervals",
+        shortName: "Sharp Intervals",
+        isRelative: true,
+        labels: ["1", "♯1", "2", "♯2", "3", "4", "♯4", "5", "♯5", "6", "♯6", "7"],
+    },
+    extensionsFlat: {
+        name: "Flat Note Extensions",
+        shortName: "Flat Extensions",
+        isRelative: true,
+        labels: [
+            "1",
+            "♭9",
+            "9",
+            "♭3",
+            "3",
+            "11",
+            "♭5",
+            "5",
+            "♭13",
+            "13",
+            "♭7",
+            "7",
+        ],
+    },
+    extensionsSharp: {
+        name: "Sharp Note Extensions",
+        shortName: "Sharp Extensions",
+        isRelative: true,
+        labels: [
+            "1",
+            "♯1",
+            "9",
+            "♯9",
+            "3",
+            "11",
+            "♯11",
+            "5",
+            "♯5",
+            "13",
+            "♯13",
+            "7",
+        ],
+    },
     fixedDoFlat: {
         name: "Solfege Fixed Do Flat Notes",
         shortName: "Fixed Do Flat",

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

@@ -1,9 +1,10 @@
 import { type Interval, type IntervalQuality } from "../data/labels/note-labels.js";
 import type { NoteCollection } from "../types/note-collections";
-import type { NoteCollectionKey } from "../data/note-collections/mod.js";
+import { type NoteCollectionKey } from "../data/note-collections/mod.js";
 /**
  * Removes octave intervals (such as "8" or "♮8") from a given list of intervals.
- * Highly useful for standardizing chord definitions that conventionally ignore the octave.
+ * Highly useful for standardizing chord and scale definitions (scales conventionally include the octave,
+ * chords conventionally do not).
  *
  * @param intervals The array of intervals to filter.
  * @returns A new array excluding any octave intervals.
@@ -19,14 +20,56 @@ export declare function sortIntervals(intervals: readonly Interval[]): Interval[
 /** Specifies a direction for converting between simple and compound/extension intervals. */
 export type IntervalTransformation = "simpleToExtension" | "extensionToSimple" | "simpleToCompound" | "compoundToSimple";
 /** Options for grouping and preprocessing intervals before they are evaluated. */
-export interface TransformIntervalsOptions {
+export type TransformIntervalsOptions = {
+    /**
+     * Transforms intervals between simple, compound, and extended forms.
+     * For example, "simpleToExtension" might change "2" into "9".
+     */
     intervalTransformation?: IntervalTransformation;
+    /**
+     * Continues to filter out octave intervals (like "8") from the results.
+     * Typically useful for scales where octaves are included by default but not needed for some applications.
+     */
     filterOutOctave?: boolean;
+    /**
+     * Will sort intervals in ascending order based on their integer value.
+     * If `fillChromatic` is true, sorting is ignored as the array is fixed to the 12 semitones.
+     */
     shouldSort?: boolean;
-    fillChromatic?: boolean;
-    rotateToRootInteger0?: boolean;
+    /**
+     * A fixed number of steps to rotate the array left (positive) or right (negative).
+     * Rotation pushes elements from the beginning of the array to the end (left) or vice versa.
+     */
+    rotateLeft?: number;
+} & ({
+    /**
+     * When true, generates a 12-element array representing the chromatic scale (0-11).
+     * Missing semitones are filled with standard flat intervals (like "♭2").
+     * Compound intervals are placed in their respective integer modulo 12 slot.
+     */
+    fillChromatic: true;
+    /**
+     * If `fillChromatic` is true, this optionally overlays intervals from a known
+     * note collection (like a major scale) to provide better enharmonic spelling
+     * for the "background" chromatic notes.
+     */
     mostSimilarScale?: NoteCollectionKey;
-}
+    /**
+     * If provided, allows for absolute rotations (like rotating to C=0).
+     */
+    rootNoteInteger?: number;
+    /**
+     * Rotates the returned array so that the note corresponding to root C (integer 0)
+     * is positioned at index 0. Has no semantic effect on purely relative intervals.
+     * Only applicable when fillChromatic is true and rootNoteInteger is provided.
+     */
+    rotateToRootInteger0?: boolean;
+} | {
+    fillChromatic?: false;
+    mostSimilarScale?: never;
+    rootNoteInteger?: never;
+    rotateToRootInteger0?: never;
+});
 /**
  * Applies a series of formatting steps to an array of intervals, such as changing compound formats,
  * filtering octaves, and sorting.

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":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,eAAe,EAMrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,EAAE,CAEZ;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,kFAAkF;AAClF,MAAM,WAAW,yBAAyB;IACxC,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;CACtC;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CA+BZ;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,eAAe,EAAE,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,eAAe,EAAE,GAC3B,QAAQ,EAAE,CAKZ;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,cAAc,GACzB,eAAe,EAAE,CAEnB"}
+{"version":3,"file":"intervals.d.ts","sourceRoot":"","sources":["../../../src/src/utils/intervals.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,QAAQ,EACb,KAAK,eAAe,EAMrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AAIzC;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,QAAQ,EAAE,CAEZ;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,kFAAkF;AAClF,MAAM,MAAM,yBAAyB,GAAG;IACtC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,sBAAsB,CAAC;IAChD;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,CACA;IACE;;;;OAIG;IACH,aAAa,EAAE,IAAI,CAAC;IACpB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,iBAAiB,CAAC;IACrC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC,GACD;IACE,aAAa,CAAC,EAAE,KAAK,CAAC;IACtB,gBAAgB,CAAC,EAAE,KAAK,CAAC;IACzB,eAAe,CAAC,EAAE,KAAK,CAAC;IACxB,oBAAoB,CAAC,EAAE,KAAK,CAAC;CAC9B,CACJ,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CAiFZ;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,SAAS,QAAQ,EAAE,GAC7B,eAAe,EAAE,CAKnB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,eAAe,EAAE,GAC3B,QAAQ,EAAE,CAKZ;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,cAAc,GACzB,eAAe,EAAE,CAEnB"}

package/script/src/utils/intervals.js

@@ -7,9 +7,13 @@ exports.getQualitiesFromIntervals = getQualitiesFromIntervals;
 exports.getIntervalsFromQualities = getIntervalsFromQualities;
 exports.getQualitiesFromNoteCollection = getQualitiesFromNoteCollection;
 const note_labels_js_1 = require("../data/labels/note-labels.js");
+const mod_js_1 = require("../data/note-collections/mod.js");
+const mod_js_2 = require("../mod.js");
+const rotate_array_js_1 = require("./rotate-array.js");
 /**
  * Removes octave intervals (such as "8" or "♮8") from a given list of intervals.
- * Highly useful for standardizing chord definitions that conventionally ignore the octave.
+ * Highly useful for standardizing chord and scale definitions (scales conventionally include the octave,
+ * chords conventionally do not).
  *
  * @param intervals The array of intervals to filter.
  * @returns A new array excluding any octave intervals.
@@ -41,7 +45,7 @@ function sortIntervals(intervals) {
  * @returns A new transformed array of intervals.
  */
 function transformIntervals(intervals, options = {}) {
-    const { intervalTransformation, filterOutOctave = false, shouldSort = true, } = options;
+    const { intervalTransformation, filterOutOctave = false, shouldSort = true, fillChromatic = false, mostSimilarScale, rotateLeft, } = options;
     const intervalMap = (() => {
         switch (intervalTransformation) {
             case "simpleToExtension":
@@ -59,8 +63,46 @@ function transformIntervals(intervals, options = {}) {
     const fundamentalIntervals = filterOutOctave
         ? filterOutOctaveIntervals(intervals)
         : intervals;
-    const finalIntervals = fundamentalIntervals.map((interval) => intervalMap.get(interval) ?? interval);
-    return shouldSort ? sortIntervals(finalIntervals) : finalIntervals;
+    const transformedIntervals = fundamentalIntervals.map((interval) => intervalMap.get(interval) ?? interval);
+    if (fillChromatic) {
+        const chromaticMap = [
+            ...mod_js_2.noteLabelCollections.intervalsFlat.labels,
+        ];
+        if (mostSimilarScale) {
+            const collection = mod_js_1.noteCollections[mostSimilarScale];
+            if (collection && collection.intervals !== intervals) {
+                collection.intervals.forEach((interval) => {
+                    const transformed = intervalMap.get(interval) ?? interval;
+                    const semitones = note_labels_js_1.intervalToIntegerMap.get(transformed);
+                    if (semitones !== undefined) {
+                        chromaticMap[semitones % 12] = transformed;
+                    }
+                });
+            }
+        }
+        // Now overlay the provided parsed intervals
+        transformedIntervals.forEach((interval) => {
+            const semitones = note_labels_js_1.intervalToIntegerMap.get(interval);
+            if (semitones !== undefined) {
+                chromaticMap[semitones % 12] = interval;
+            }
+        });
+        let result = chromaticMap;
+        if (options.rotateToRootInteger0 && options.rootNoteInteger !== undefined) {
+            result = (0, rotate_array_js_1.rotateArrayLeft)(result, -options.rootNoteInteger);
+        }
+        if (rotateLeft !== undefined) {
+            result = (0, rotate_array_js_1.rotateArrayLeft)(result, rotateLeft);
+        }
+        return result;
+    }
+    let result = shouldSort
+        ? sortIntervals(transformedIntervals)
+        : transformedIntervals;
+    if (rotateLeft !== undefined) {
+        result = (0, rotate_array_js_1.rotateArrayLeft)(result, rotateLeft);
+    }
+    return result;
 }
 /**
  * Extracts generic interval qualities (e.g., "P5", "m3" becomes "P", "m") from a list of intervals.

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

@@ -44,5 +44,5 @@ export declare function getNoteNamesFromRootAndIntervals(rootNote: RootNote, int
  * @param options Optional settings for interval transformations or output formatting.
  * @returns An array of computed note names.
  */
-export declare function getNoteNamesFromRootAndCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: TransformIntervalsOptions): NoteName[];
+export declare function getNoteNamesFromRootAndCollectionKey(rootNote: RootNote, noteCollectionKey: NoteCollectionKey, options?: Omit<TransformIntervalsOptions, "mostSimilarScale">): NoteName[];
 //# sourceMappingURL=note-names.d.ts.map

package/script/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;AAEvC,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,CAsE1E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAI7B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CA4EZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CAkBZ"}
+{"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,CAsE1E;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAQ1E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,GACf,eAAe,GAAG,SAAS,CAI7B;AA4CD;;;;;;;;;GASG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,GAAE,yBAA8B,GACtC,QAAQ,EAAE,CAgCZ;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAClD,QAAQ,EAAE,QAAQ,EAClB,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,GAAE,IAAI,CAAC,yBAAyB,EAAE,kBAAkB,CAAM,GAChE,QAAQ,EAAE,CAuBZ"}

package/script/src/utils/note-names.js

@@ -6,11 +6,9 @@ exports.getNoteIntegerFromString = getNoteIntegerFromString;
 exports.getNoteNamesFromRootAndIntervals = getNoteNamesFromRootAndIntervals;
 exports.getNoteNamesFromRootAndCollectionKey = getNoteNamesFromRootAndCollectionKey;
 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 mod_js_1 = require("../data/note-collections/mod.js");
 const intervals_js_1 = require("./intervals.js");
 const note_collections_js_1 = require("./note-collections.js");
-const rotate_array_js_1 = require("./rotate-array.js");
 const NOTE_LETTER_REGEX = /^[A-Ga-g]/;
 const ACCIDENTAL_REGEX = /([#♯xX𝄪]+)|([b♭𝄫]+)/gu;
 const INTERVAL_NUMBER_REGEX = /\d+/;
@@ -155,56 +153,21 @@ function getNoteNamesFromRootAndIntervals(rootNote, intervals, options = {}) {
     const rootNoteLetter = rootNote.charAt(0).toUpperCase();
     const rootNoteLetterIndex = note_labels_js_1.noteLetters.indexOf(rootNoteLetter);
     // 2. Transform Intervals
-    const intervalsToConvert = Object.keys(options).length > 0
-        ? (0, intervals_js_1.transformIntervals)(intervals, options)
+    const enhancedOptions = options.fillChromatic
+        ? {
+            ...options,
+            ...(options.rotateToRootInteger0 ? { rootNoteInteger } : {}),
+        }
+        : options;
+    const intervalsToConvert = Object.keys(enhancedOptions).length > 0
+        ? (0, intervals_js_1.transformIntervals)(intervals, enhancedOptions)
         : intervals;
-    let noteNames;
     // 3. Generate Note Names
-    if (options.fillChromatic) {
-        // Initialize 12-note array with default flat notes relative to the root
-        // This ensures every semitone slot has a value (e.g., C, Db, D...)
-        const flatNotes = note_label_collections_js_1.noteLabelCollections.flat.labels;
-        noteNames = Array.from({ length: 12 }, (_, i) => {
-            const absoluteInteger = (rootNoteInteger + i) % 12;
-            return flatNotes[absoluteInteger];
-        });
-        // 3a. Overlay mostSimilarScale if provided (to provide better accidental contexts)
-        if (options.mostSimilarScale) {
-            const similarCollection = mod_js_1.noteCollections[options.mostSimilarScale];
-            if (similarCollection && similarCollection.intervals !== intervals) {
-                similarCollection.intervals.forEach((interval) => {
-                    const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
-                    if (result) {
-                        noteNames[result.semitoneOffset] = result.noteName;
-                    }
-                });
-            }
-        }
-        // Overwrite default notes with specific notes calculated from intervals
-        intervalsToConvert.forEach((interval) => {
-            const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
-            if (result) {
-                noteNames[result.semitoneOffset] = result.noteName;
-            }
-        });
-    }
-    else {
-        // Map intervals directly to note names
-        noteNames = intervalsToConvert.flatMap((interval) => {
-            const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
-            return result ? [result.noteName] : [];
-        });
-    }
-    // 4. Rotate Array (Optional)
-    if (options.rotateToRootInteger0) {
-        // Rotate so that the note corresponding to integer 0 (C) is at index 0.
-        // e.g., if Root is D (2), the array currently starts at D.
-        // To move C (currently at index 10) to index 0, we rotate right by 2 (rootNoteInteger).
-        // rotateArrayLeft performs a left shift for positive values.
-        // To move C (at index -rootNoteInteger) to 0, we need to shift right by rootNoteInteger.
-        // So we rotate by -rootNoteInteger.
-        noteNames = (0, rotate_array_js_1.rotateArrayLeft)(noteNames, -rootNoteInteger);
-    }
+    // Map intervals directly to note names
+    const noteNames = intervalsToConvert.flatMap((interval) => {
+        const result = getNoteFromRootAndInterval(rootNoteInteger, rootNoteLetterIndex, interval);
+        return result ? [result.noteName] : [];
+    });
     return noteNames;
 }
 /**
@@ -221,11 +184,15 @@ function getNoteNamesFromRootAndCollectionKey(rootNote, noteCollectionKey, optio
     if (!(0, note_collections_js_1.isValidNoteCollectionKey)(noteCollectionKey))
         return [];
     const collection = mod_js_1.noteCollections[noteCollectionKey];
-    const mostSimilarScale = "mostSimilarScale" in collection
-        ? collection.mostSimilarScale
-        : undefined;
-    const finalOptions = mostSimilarScale && mostSimilarScale !== noteCollectionKey
-        ? { ...options, mostSimilarScale: mostSimilarScale }
+    const mostSimilarScale = "mostSimilarScale" in collection ? collection.mostSimilarScale : undefined;
+    const finalOptions = options.fillChromatic &&
+        mostSimilarScale &&
+        mostSimilarScale !== noteCollectionKey
+        ? {
+            ...options,
+            fillChromatic: true,
+            mostSimilarScale: mostSimilarScale,
+        }
         : options;
     return getNoteNamesFromRootAndIntervals(rootNote, collection.intervals, finalOptions);
 }