@musodojo/music-theory-data 26.5.0 → 27.0.0

package/README.md

@@ -194,6 +194,58 @@ console.log(
 // ["CM", "FM", "GM"]
 ```
 
+## Note Colors And Chromatic Indexes
+
+Note color collections use 12 chromatic slots. In absolute mode, each index is a
+pitch class where index `0` is C and index `7` is G. In relative mode, each
+index is measured from a musical root where index `0` is the root and index `7`
+is the fifth.
+
+`noteLabelCollections.noteNamesFlat` is the default label set for absolute note
+colors, and `noteLabelCollections.intervalsFlat` is the default label set for
+relative note colors. `ChromaticIndex` is the shared `0`-to-`11` pitch-class
+shape used by chromatic tuples, note labels, root-note integers, and filled
+chromatic interval helpers. `ChromaticMode` is the shared `"absolute"` or
+`"relative"` mode used by note colors and label collections.
+
+Chromatic indexes must be integers. Helpers such as `normalizeChromaticIndex`
+wrap negative or large semitone values into the `0`-to-`11` range, but reject
+fractional or non-finite values.
+
+```ts
+import {
+  colorCollections,
+  getNoteColorIndex,
+  getNoteColorLabels,
+} from "jsr:@musodojo/music-theory-data";
+
+const absoluteIndex = getNoteColorIndex({
+  midi: 67,
+  mode: "absolute",
+});
+console.log(absoluteIndex);
+// 7, the pitch class G
+
+const relativeIndex = getNoteColorIndex({
+  midi: 69,
+  mode: "relative",
+  rootPitchClass: 2,
+});
+console.log(relativeIndex);
+// 7, A as the fifth above D
+
+console.log(getNoteColorLabels(colorCollections.musoDojoRootAndFifth));
+// ["1", "♭2", "2", "♭3", "3", "4", "♭5", "5", "♭6", "6", "♭7", "7"]
+```
+
+Color values may be hex strings or `null`. A `null` value means there is
+intentionally no semantic color for that pitch or degree; consuming apps should
+choose their own visual fallback through theme or UI settings.
+
+Regular note collection interval arrays remain variable length because chords,
+dyads, arpeggios, and scales have different natural sizes. Helpers that opt into
+`fillChromatic: true` return a fixed 12-slot chromatic tuple.
+
 ## API Documentation
 
 For a full list of all available data, types, and utility functions, please see

package/esm/src/data/chromatic.d.ts

@@ -0,0 +1,24 @@
+export declare const CHROMATIC_NOTE_COUNT: 12;
+/** A zero-indexed chromatic pitch-class or relative degree slot. */
+export type ChromaticIndex = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
+/** How a chromatic index should be interpreted. */
+export type ChromaticMode = "absolute" | "relative";
+/** A fixed 12-slot tuple indexed by chromatic pitch class or relative degree. */
+export type ChromaticTuple<T> = readonly [
+    T,
+    T,
+    T,
+    T,
+    T,
+    T,
+    T,
+    T,
+    T,
+    T,
+    T,
+    T
+];
+export declare const CHROMATIC_INDEXES: ChromaticTuple<ChromaticIndex>;
+/** A variable-length set of chromatic indexes, such as the pitch classes in a scale or dyad. */
+export type ChromaticIndexSet = readonly ChromaticIndex[];
+//# sourceMappingURL=chromatic.d.ts.map

package/esm/src/data/chromatic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chromatic.d.ts","sourceRoot":"","sources":["../../../src/src/data/chromatic.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,EAAW,CAAC;AAEhD,oEAAoE;AACpE,MAAM,MAAM,cAAc,GACtB,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,CAAC,GACD,EAAE,GACF,EAAE,CAAC;AAEP,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,UAAU,CAAC;AAEpD,iFAAiF;AACjF,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,SAAS;IACvC,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;IACD,CAAC;CACF,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,cAAc,CAAC,cAAc,CAanD,CAAC;AAEX,gGAAgG;AAChG,MAAM,MAAM,iBAAiB,GAAG,SAAS,cAAc,EAAE,CAAC"}

package/esm/src/data/chromatic.js

@@ -0,0 +1,15 @@
+export const CHROMATIC_NOTE_COUNT = 12;
+export const CHROMATIC_INDEXES = [
+    0,
+    1,
+    2,
+    3,
+    4,
+    5,
+    6,
+    7,
+    8,
+    9,
+    10,
+    11,
+];

package/esm/src/data/colors/mod.d.ts

@@ -1,51 +1,62 @@
-export type Color = string | null;
-export type ColorGroup = readonly [
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color,
-    Color
-];
-export interface ColorCollection {
-    name: string;
-    description: string;
-    relative: boolean;
-    colors: ColorGroup;
+import { type NoteLabelCollectionKey, type NoteLabelGroup } from "../labels/note-label-collections.js";
+import type { ChromaticMode, ChromaticTuple } from "../chromatic.js";
+export type NoteColorMode = ChromaticMode;
+export type NoteColorValue = string | null;
+export type NoteColorTuple = ChromaticTuple<NoteColorValue>;
+export interface NoteColorCollection {
+    readonly name: string;
+    readonly shortName?: string;
+    readonly description: string;
+    readonly mode: NoteColorMode;
+    readonly labelCollectionKey?: NoteLabelCollectionKey;
+    readonly colors: NoteColorTuple;
 }
+export type Color = NoteColorValue;
+export type ColorGroup = NoteColorTuple;
+export type ColorCollection = NoteColorCollection;
+export type DefaultNoteColorLabelCollectionKeys = Readonly<Record<NoteColorMode, NoteLabelCollectionKey>> & Readonly<{
+    absolute: "noteNamesFlat";
+    relative: "intervalsFlat";
+}>;
+export declare const defaultNoteColorLabelCollectionKeys: DefaultNoteColorLabelCollectionKeys;
+export declare function getDefaultNoteColorLabelCollectionKey(mode: NoteColorMode): NoteLabelCollectionKey;
+export declare function getNoteColorLabelCollectionKey(collection: NoteColorCollection): NoteLabelCollectionKey;
+export declare function getNoteColorLabels(collection: NoteColorCollection): NoteLabelGroup;
 declare const _colorCollections: {
     readonly musoDojo: {
         readonly name: "Muso Dojo Colors";
-        readonly description: "A custom set of colors, designed by Muso Dojo.";
-        readonly relative: false;
+        readonly shortName: "Muso Dojo";
+        readonly description: "A custom absolute chromatic palette designed by Muso Dojo.";
+        readonly mode: "absolute";
+        readonly labelCollectionKey: "noteNamesFlat";
         readonly colors: readonly ["#ED2929", "#9F000F", "#78C7C7", "#00008B", "#FF9933", "#EBEB19", "#286704", "#99CC33", "#660099", "#CC00FF", "#BF6A1F", "#FF9EE6"];
     };
     readonly musoDojoRoot: {
         readonly name: "Muso Dojo Root";
+        readonly shortName: "Root";
         readonly description: "Use the red color from Muso Dojo's colors on just the root note.";
-        readonly relative: true;
+        readonly mode: "relative";
+        readonly labelCollectionKey: "intervalsFlat";
         readonly colors: readonly ["#ED2929", null, null, null, null, null, null, null, null, null, null, null];
     };
     readonly musoDojoRootAndFifth: {
         readonly name: "Muso Dojo Root and Fifth";
+        readonly shortName: "Root and Fifth";
         readonly description: "Use the red-and-green colors from Muso Dojo's colors on the root-and-fifth notes.";
-        readonly relative: true;
+        readonly mode: "relative";
+        readonly labelCollectionKey: "intervalsFlat";
         readonly colors: readonly ["#ED2929", null, null, null, null, null, null, "#99CC33", null, null, null, null];
     };
     readonly boomwhackers: {
         readonly name: "Boomwhackers";
+        readonly shortName: "Boomwhackers";
         readonly description: "The colors used by Boomwhackers.";
-        readonly relative: false;
+        readonly mode: "absolute";
+        readonly labelCollectionKey: "noteNamesFlat";
         readonly colors: readonly ["#E21C48", "#F26622", "#F99D1C", "#FFCC33", "#FFF32B", "#BCD85F", "#62BC47", "#009C95", "#0071BB", "#5E50A1", "#8D5BA6", "#CF3E96"];
     };
 };
 export type ColorCollectionKey = keyof typeof _colorCollections;
-export declare const colorCollections: Record<ColorCollectionKey, ColorCollection>;
+export declare const colorCollections: Record<ColorCollectionKey, NoteColorCollection>;
 export {};
 //# sourceMappingURL=mod.d.ts.map

package/esm/src/data/colors/mod.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/colors/mod.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG,IAAI,CAAC;AAElC,MAAM,MAAM,UAAU,GAAG,SAAS;IAChC,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;CACN,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;CA+Eb,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEhE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,kBAAkB,EAAE,eAAe,CACtD,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/colors/mod.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAE3B,KAAK,cAAc,EACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC;AAC1C,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,IAAI,CAAC;AAC3C,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,cAAc,CAAC,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;CACjC;AAED,MAAM,MAAM,KAAK,GAAG,cAAc,CAAC;AACnC,MAAM,MAAM,UAAU,GAAG,cAAc,CAAC;AACxC,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAElD,MAAM,MAAM,mCAAmC,GAC3C,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC,GACvD,QAAQ,CAAC;IACT,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC,CAAC;AAEL,eAAO,MAAM,mCAAmC,EAC9C,mCAGC,CAAC;AAEJ,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,aAAa,GAClB,sBAAsB,CAExB;AAED,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,mBAAmB,GAC9B,sBAAsB,CAMxB;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,mBAAmB,GAC9B,cAAc,CAGhB;AAED,QAAA,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuFb,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAEhE,eAAO,MAAM,gBAAgB,EAAE,MAAM,CACnC,kBAAkB,EAClB,mBAAmB,CACA,CAAC"}

package/esm/src/data/colors/mod.js

@@ -1,8 +1,28 @@
+import { noteLabelCollections, } from "../labels/note-label-collections.js";
+export const defaultNoteColorLabelCollectionKeys = {
+    absolute: "noteNamesFlat",
+    relative: "intervalsFlat",
+};
+export function getDefaultNoteColorLabelCollectionKey(mode) {
+    return defaultNoteColorLabelCollectionKeys[mode];
+}
+export function getNoteColorLabelCollectionKey(collection) {
+    if (collection.labelCollectionKey) {
+        return collection.labelCollectionKey;
+    }
+    return getDefaultNoteColorLabelCollectionKey(collection.mode);
+}
+export function getNoteColorLabels(collection) {
+    return noteLabelCollections[getNoteColorLabelCollectionKey(collection)]
+        .labels;
+}
 const _colorCollections = {
     musoDojo: {
         name: "Muso Dojo Colors",
-        description: "A custom set of colors, designed by Muso Dojo.",
-        relative: false,
+        shortName: "Muso Dojo",
+        description: "A custom absolute chromatic palette designed by Muso Dojo.",
+        mode: "absolute",
+        labelCollectionKey: "noteNamesFlat",
         colors: [
             "#ED2929",
             "#9F000F",
@@ -20,8 +40,10 @@ const _colorCollections = {
     },
     musoDojoRoot: {
         name: "Muso Dojo Root",
+        shortName: "Root",
         description: "Use the red color from Muso Dojo's colors on just the root note.",
-        relative: true,
+        mode: "relative",
+        labelCollectionKey: "intervalsFlat",
         colors: [
             "#ED2929",
             null,
@@ -39,8 +61,10 @@ const _colorCollections = {
     },
     musoDojoRootAndFifth: {
         name: "Muso Dojo Root and Fifth",
+        shortName: "Root and Fifth",
         description: "Use the red-and-green colors from Muso Dojo's colors on the root-and-fifth notes.",
-        relative: true,
+        mode: "relative",
+        labelCollectionKey: "intervalsFlat",
         colors: [
             "#ED2929",
             null,
@@ -58,8 +82,10 @@ const _colorCollections = {
     },
     boomwhackers: {
         name: "Boomwhackers",
+        shortName: "Boomwhackers",
         description: "The colors used by Boomwhackers.",
-        relative: false,
+        mode: "absolute",
+        labelCollectionKey: "noteNamesFlat",
         colors: [
             "#E21C48",
             "#F26622",

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

@@ -1,84 +1,72 @@
+import type { ChromaticMode, ChromaticTuple } from "../chromatic.js";
 /** A fixed 12-element tuple of strings representing each note in the chromatic scale. */
-export type NoteLabelGroup = readonly [
-    string,
-    string,
-    string,
-    string,
-    string,
-    string,
-    string,
-    string,
-    string,
-    string,
-    string,
-    string
-];
+export type NoteLabelGroup = ChromaticTuple<string>;
 /** The data interface governing an entire collection array of 12 note labels. */
 export interface NoteLabelCollection {
     readonly name: string;
     readonly shortName: string;
-    readonly isRelative: boolean;
+    readonly mode: ChromaticMode;
     readonly labels: NoteLabelGroup;
 }
 declare const _noteLabelCollections: {
     readonly noteNamesFlat: {
         readonly name: "Flat Note Names";
         readonly shortName: "Flat Notes";
-        readonly isRelative: false;
+        readonly mode: "absolute";
         readonly labels: readonly ["C", "D♭", "D", "E♭", "E", "F", "G♭", "G", "A♭", "A", "B♭", "B"];
     };
     readonly noteNamesSharp: {
         readonly name: "Sharp Note Names";
         readonly shortName: "Sharp Notes";
-        readonly isRelative: false;
+        readonly mode: "absolute";
         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 mode: "relative";
         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 mode: "relative";
         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 mode: "relative";
         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 mode: "relative";
         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";
-        readonly isRelative: false;
+        readonly mode: "absolute";
         readonly labels: readonly ["do", "re♭", "re", "mi♭", "mi", "fa", "sol♭", "sol", "la♭", "la", "si♭", "si"];
     };
     readonly fixedDoSharp: {
         readonly name: "Solfege Fixed Do Sharp Notes";
         readonly shortName: "Fixed Do Sharp";
-        readonly isRelative: false;
+        readonly mode: "absolute";
         readonly labels: readonly ["do", "do♯", "re", "re♯", "mi", "fa", "fa♯", "sol", "sol♯", "la", "la♯", "si"];
     };
     readonly movableDo: {
         readonly name: "Solfege Movable Do Notes";
         readonly shortName: "Movable Do";
-        readonly isRelative: true;
+        readonly mode: "relative";
         readonly labels: readonly ["do", "ra", "re", "me", "mi", "fa", "fi", "sol", "le", "la", "te", "ti"];
     };
     readonly movableLa: {
         readonly name: "Solfege Movable La Notes";
         readonly shortName: "Movable La";
-        readonly isRelative: true;
+        readonly mode: "relative";
         readonly labels: readonly ["la", "te", "ti", "do", "di", "re", "re", "mi", "fa", "fi", "sol", "si"];
     };
 };

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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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"}
+{"version":3,"file":"note-label-collections.d.ts","sourceRoot":"","sources":["../../../../src/src/data/labels/note-label-collections.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAErE,yFAAyF;AACzF,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;AAEpD,iFAAiF;AACjF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,aAAa,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

@@ -2,31 +2,31 @@ const _noteLabelCollections = {
     noteNamesFlat: {
         name: "Flat Note Names",
         shortName: "Flat Notes",
-        isRelative: false,
+        mode: "absolute",
         labels: ["C", "D♭", "D", "E♭", "E", "F", "G♭", "G", "A♭", "A", "B♭", "B"],
     },
     noteNamesSharp: {
         name: "Sharp Note Names",
         shortName: "Sharp Notes",
-        isRelative: false,
+        mode: "absolute",
         labels: ["C", "C♯", "D", "D♯", "E", "F", "F♯", "G", "G♯", "A", "A♯", "B"],
     },
     intervalsFlat: {
         name: "Flat Note Intervals",
         shortName: "Flat Intervals",
-        isRelative: true,
+        mode: "relative",
         labels: ["1", "♭2", "2", "♭3", "3", "4", "♭5", "5", "♭6", "6", "♭7", "7"],
     },
     intervalsSharp: {
         name: "Sharp Note Intervals",
         shortName: "Sharp Intervals",
-        isRelative: true,
+        mode: "relative",
         labels: ["1", "♯1", "2", "♯2", "3", "4", "♯4", "5", "♯5", "6", "♯6", "7"],
     },
     extensionsFlat: {
         name: "Flat Note Extensions",
         shortName: "Flat Extensions",
-        isRelative: true,
+        mode: "relative",
         labels: [
             "1",
             "♭9",
@@ -45,7 +45,7 @@ const _noteLabelCollections = {
     extensionsSharp: {
         name: "Sharp Note Extensions",
         shortName: "Sharp Extensions",
-        isRelative: true,
+        mode: "relative",
         labels: [
             "1",
             "♯1",
@@ -64,7 +64,7 @@ const _noteLabelCollections = {
     fixedDoFlat: {
         name: "Solfege Fixed Do Flat Notes",
         shortName: "Fixed Do Flat",
-        isRelative: false,
+        mode: "absolute",
         labels: [
             "do",
             "re♭",
@@ -83,7 +83,7 @@ const _noteLabelCollections = {
     fixedDoSharp: {
         name: "Solfege Fixed Do Sharp Notes",
         shortName: "Fixed Do Sharp",
-        isRelative: false,
+        mode: "absolute",
         labels: [
             "do",
             "do♯",
@@ -102,7 +102,7 @@ const _noteLabelCollections = {
     movableDo: {
         name: "Solfege Movable Do Notes",
         shortName: "Movable Do",
-        isRelative: true,
+        mode: "relative",
         labels: [
             "do",
             "ra",
@@ -121,7 +121,7 @@ const _noteLabelCollections = {
     movableLa: {
         name: "Solfege Movable La Notes",
         shortName: "Movable La",
-        isRelative: true,
+        mode: "relative",
         labels: [
             "la",
             "te",

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

@@ -1,5 +1,6 @@
+import type { ChromaticIndex } from "../chromatic.js";
 /** Represents the mathematical zero-indexed pitch class of a root note, where C is 0 and B is 11. */
-export type RootNoteInteger = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | 11;
+export type RootNoteInteger = ChromaticIndex;
 declare const _noteLetters: readonly ["C", "D", "E", "F", "G", "A", "B"];
 /** An alphabetical musical note letter without any accidentals. */
 export type NoteLetter = (typeof _noteLetters)[number];

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

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

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

@@ -1,5 +1,6 @@
 export * from "./chords/mod.js";
 export * from "./chord-progressions/mod.js";
+export * from "./chromatic.js";
 export * from "./colors/mod.js";
 export * from "./labels/mod.js";
 export * from "./note-collections/mod.js";

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/data/mod.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/data/mod.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC"}

package/esm/src/data/mod.js

@@ -1,5 +1,6 @@
 export * from "./chords/mod.js";
 export * from "./chord-progressions/mod.js";
+export * from "./chromatic.js";
 export * from "./colors/mod.js";
 export * from "./labels/mod.js";
 export * from "./note-collections/mod.js";

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

@@ -1,6 +1,6 @@
 import { type NoteCollectionKey } from "../data/note-collections/mod.js";
 import type { ChordQuality, RomanSeventhChord, RomanTriad, SeventhChord, Triad } from "../types/chords";
-import { type NoteCollectionKeyTransformOptions, type RootAndNoteCollectionKeyTransformOptions } from "./intervals.js";
+import type { NoteCollectionKeyTransformOptions, RootAndNoteCollectionKeyTransformOptions } from "./intervals.js";
 import { type RootNote } from "../data/labels/note-labels.js";
 export declare function getRomanNumeralForScaleIndexAndChordQuality(scaleIndex: number, quality: ChordQuality): string | undefined;
 /**

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":"AAWA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,iBAAiB,CAAC;AAkBzB,OAAO,EAEL,KAAK,iCAAiC,EACtC,KAAK,wCAAwC,EAC9C,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,GACpB,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAQ5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,iBAAiB,EAAE,CAQrB;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"}
+{"version":3,"file":"chords.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chords.ts"],"names":[],"mappings":"AAWA,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,KAAK,EACN,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,KAAK,EACV,iCAAiC,EACjC,wCAAwC,EACzC,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAEL,KAAK,QAAQ,EACd,MAAM,+BAA+B,CAAC;AAEvC,wBAAgB,2CAA2C,CACzD,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,YAAY,GACpB,MAAM,GAAG,SAAS,CAYpB;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,EAAE,CAQ5D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EAAE,GACvB,iBAAiB,EAAE,CAQrB;AA2LD;;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

@@ -5,7 +5,7 @@ import { harmonicMinorModes, } from "../data/note-collections/harmonic-minor-mod
 import { melodicMinorModes, } from "../data/note-collections/melodic-minor-modes.js";
 import { intervalToIntegerMap, } from "../data/labels/note-labels.js";
 import { diatonicModes, } from "../data/note-collections/diatonic-modes.js";
-import { filterOutOctaveIntervals, } from "./intervals.js";
+import { createChromaticTuple, normalizeChromaticIndex } from "./chromatic.js";
 import { getNoteNamesForRootAndNoteCollectionKey } from "./note-names.js";
 import { noteNameToIntegerMap, } from "../data/labels/note-labels.js";
 export function getRomanNumeralForScaleIndexAndChordQuality(scaleIndex, quality) {
@@ -67,14 +67,16 @@ function getChromaticArray(items, intervals) {
         undefined,
         undefined,
     ];
-    const filteredIntervals = filterOutOctaveIntervals(intervals);
-    filteredIntervals.forEach((interval, i) => {
+    intervals.forEach((interval, i) => {
+        if (interval === "8" || interval === "♮8") {
+            return;
+        }
         const semitones = intervalToIntegerMap.get(interval);
         if (semitones !== undefined) {
-            result[semitones % 12] = items[i];
+            result[normalizeChromaticIndex(semitones)] = items[i];
         }
     });
-    return result;
+    return createChromaticTuple(result);
 }
 function getModeData(modeKey) {
     if (Object.prototype.hasOwnProperty.call(diatonicModes, modeKey)) {
@@ -121,7 +123,7 @@ function getChordsForNoteCollectionKey(noteCollectionKey, options, extractChords
     const { rotateToRootInteger0, rootNoteInteger } = rootOptions ?? {};
     // Helper function to apply requested rotations after the chord array is cleanly generated.
     const applyRotations = (chordsArray, isChromatic) => {
-        let result = chordsArray;
+        let result = [...chordsArray];
         // If fillChromatic is true, the array represents the 12 absolute semitones (where index 0 = the root note relative to itself).
         if (isChromatic) {
             if (rotateToRootInteger0 && rootNoteInteger !== undefined) {
@@ -173,15 +175,18 @@ function getChordsForNoteCollectionKey(noteCollectionKey, options, extractChords
         : similarChords;
     // 3b. Pluck out only the chords that align with the intervals actually present in the custom scale.
     // E.g. For Minor Pentatonic (intervals 1, b3, 4, 5, b7), we grab the 1st, 3rd, 4th, 5th, and 7th chords of Aeolian.
-    const collectionChords = collection.intervals
+    const collectionChordsByInterval = collection.intervals
         .map((interval) => {
         const index = similarData.intervals.indexOf(interval);
         return index !== -1 ? similarProcessedChords[index] : undefined;
-    })
+    });
+    // Keep a placeholder-preserving array for fillChromatic;
+    // otherwise a missing interval, such as the blues scale ♭5, shifts later chords.
+    const collectionChords = collectionChordsByInterval
         .filter((chord) => chord !== undefined);
     // 3c. Format and return just like step 2.
     if (fillChromatic) {
-        return applyRotations(getChromaticArray(collectionChords, collection.intervals), true);
+        return applyRotations(getChromaticArray(collectionChordsByInterval, collection.intervals), true);
     }
     return applyRotations(collectionChords, false);
 }

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

@@ -0,0 +1,6 @@
+import { type ChromaticIndex, type ChromaticTuple } from "../data/chromatic.js";
+export declare function isChromaticIndex(value: number): value is ChromaticIndex;
+export declare function normalizeChromaticIndex(value: number): ChromaticIndex;
+export declare function isChromaticTuple<T>(values: readonly T[]): values is ChromaticTuple<T>;
+export declare function createChromaticTuple<T>(values: readonly T[]): ChromaticTuple<T>;
+//# sourceMappingURL=chromatic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chromatic.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chromatic.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAE9B,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAcrE;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,MAAM,IAAI,cAAc,CAAC,CAAC,CAAC,CAE7B;AAED,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,MAAM,EAAE,SAAS,CAAC,EAAE,GACnB,cAAc,CAAC,CAAC,CAAC,CAQnB"}

package/esm/src/utils/chromatic.js

@@ -0,0 +1,24 @@
+import { CHROMATIC_NOTE_COUNT, } from "../data/chromatic.js";
+export function isChromaticIndex(value) {
+    return Number.isInteger(value) && value >= 0 && value < CHROMATIC_NOTE_COUNT;
+}
+export function normalizeChromaticIndex(value) {
+    if (!Number.isFinite(value)) {
+        throw new Error(`Chromatic index must be finite. Received ${value}.`);
+    }
+    if (!Number.isInteger(value)) {
+        throw new Error(`Chromatic index must be an integer. Received ${value}.`);
+    }
+    const integer = value;
+    return ((integer % CHROMATIC_NOTE_COUNT + CHROMATIC_NOTE_COUNT) %
+        CHROMATIC_NOTE_COUNT);
+}
+export function isChromaticTuple(values) {
+    return values.length === CHROMATIC_NOTE_COUNT;
+}
+export function createChromaticTuple(values) {
+    if (!isChromaticTuple(values)) {
+        throw new Error(`Expected ${CHROMATIC_NOTE_COUNT} chromatic values. Received ${values.length}.`);
+    }
+    return [...values];
+}