@musodojo/music-theory-data 27.0.0 → 28.0.0

package/README.md

@@ -26,12 +26,11 @@ Have a question, a suggestion, or want to report a bug? Get in touch!
 - ✅ Augmented Variants
 - ✅ Other Note Collections, including notes and dyads
 
-## Available Chord Progression Templates
+## Available Chord Progressions
 
-- ✅ Basic Progressions
-- ✅ Pop Progressions
-- ✅ Blues Progressions
-- ✅ Jazz Progressions
+- ✅ 4-bar foundational loops
+- ✅ 8-bar loops
+- ✅ 12-bar blues
 
 ## Features
 
@@ -177,21 +176,52 @@ console.log(Object.keys(music_theory_data.noteCollections));
 console.log(Object.keys(music_theory_data.groupedNoteCollections));
 // ["diatonicModes", "pentatonicVariants", ...]
 
-// Get a beginner-friendly chord progression template
-const oneFourFive = music_theory_data.chordProgressionTemplates.oneFourFive;
+// Get a chord progression
+const oneSixFourFive = music_theory_data.chordProgressions.oneSixFourFive;
 
-console.log(oneFourFive.primaryName);
-// "One Four Five"
+console.log(oneSixFourFive.primaryName);
+// "I | vi | IV | V"
+
+console.log(oneSixFourFive.chords);
+// [
+//   { degree: "1", quality: "M", durationInBars: 1 },
+//   { degree: "6", quality: "m", durationInBars: 1 },
+//   { degree: "4", quality: "M", durationInBars: 1 },
+//   { degree: "5", quality: "M", durationInBars: 1 },
+// ]
 
 console.log(
-  music_theory_data.getChordProgressionTemplateRomanNames("oneFourFive"),
+  music_theory_data.getChordProgressionChordNames(
+    "C",
+    "oneSixFourFive",
+  ),
 );
-// ["I", "IV", "V"]
+// ["CM", "Am", "FM", "GM"]
 
 console.log(
-  music_theory_data.getChordProgressionTemplateChordNames("C", "oneFourFive"),
+  music_theory_data.getChordProgressionUniqueChordNames(
+    "C",
+    "oneFourOneFiveSplitReturn",
+  ),
 );
 // ["CM", "FM", "GM"]
+
+console.log(
+  music_theory_data.getChordProgressionUniqueChordReferences(
+    "C",
+    "oneFourOneFiveSplitReturn",
+  ),
+);
+// [
+//   { rootNote: "C", chordName: "CM", noteCollectionKey: "major" },
+//   { rootNote: "C", chordName: "FM", noteCollectionKey: "major" },
+//   { rootNote: "C", chordName: "GM", noteCollectionKey: "major" },
+// ]
+
+console.log(
+  music_theory_data.getChordProgressionTotalDurationInBars("twelveBarBlues"),
+);
+// 12
 ```
 
 ## Note Colors And Chromatic Indexes

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

@@ -1,66 +1,21 @@
-import type { ChordProgressionTemplateCategory, ChordProgressionTemplateType } from "../../types/chord-progressions";
-import type { ChordQuality } from "../../types/chords";
-import type { NoteCollectionKey } from "../note-collections/mod.js";
-export { basicChordProgressionTemplates } from "./basic.js";
-export { bluesChordProgressionTemplates } from "./blues.js";
-export { jazzChordProgressionTemplates } from "./jazz.js";
-export { popChordProgressionTemplates } from "./pop.js";
-export declare const chordProgressionTemplates: {
-    readonly twoFiveOneMajor: import("../../mod.js").ChordProgressionTemplate;
-    readonly minorTwoFiveOne: import("../../mod.js").ChordProgressionTemplate;
-    readonly rhythmChanges: import("../../mod.js").ChordProgressionTemplate;
-    readonly jazzBluesBasic: import("../../mod.js").ChordProgressionTemplate;
-    readonly twelveBarBlues: import("../../mod.js").ChordProgressionTemplate;
-    readonly dooWop: import("../../mod.js").ChordProgressionTemplate;
-    readonly axisProgression: import("../../mod.js").ChordProgressionTemplate;
-    readonly oneFourFive: import("../../mod.js").ChordProgressionTemplate;
-    readonly oneFive: import("../../mod.js").ChordProgressionTemplate;
-    readonly oneFour: import("../../mod.js").ChordProgressionTemplate;
-    readonly oneOneFiveFive: import("../../mod.js").ChordProgressionTemplate;
-    readonly oneOneFiveFiveSeven: import("../../mod.js").ChordProgressionTemplate;
-    readonly oneFourOneFive: import("../../mod.js").ChordProgressionTemplate;
+import type { ChordProgression } from "../../types/chord-progressions";
+declare const _chordProgressions: {
+    readonly oneOneFiveFive: ChordProgression;
+    readonly oneOneFiveFiveDominant7: ChordProgression;
+    readonly oneOneFourFour: ChordProgression;
+    readonly oneOneFourFive: ChordProgression;
+    readonly oneFourOneFive: ChordProgression;
+    readonly oneSixFourFive: ChordProgression;
+    readonly oneFiveSixFour: ChordProgression;
+    readonly oneSixTwoFive: ChordProgression;
+    readonly sixTwoFiveOne: ChordProgression;
+    readonly majorTwoFiveOne: ChordProgression;
+    readonly minorTwoFiveOne: ChordProgression;
+    readonly oneFourOneFiveSplitReturn: ChordProgression;
+    readonly twelveBarBlues: ChordProgression;
+    readonly twelveBarBluesQuickChange: ChordProgression;
 };
-export type ChordProgressionTemplateKey = keyof typeof chordProgressionTemplates;
-export type ChordProgressionStepNoteCollectionKeyMap = Partial<Record<ChordQuality, NoteCollectionKey>>;
-/** Canonical chord/arpeggio collection keys for chord qualities used by progression steps. */
-export declare const chordProgressionStepNoteCollectionKeys: ChordProgressionStepNoteCollectionKeyMap;
-export declare const groupedChordProgressionTemplates: {
-    readonly basicChordProgressionTemplates: {
-        readonly oneFourFive: import("../../mod.js").ChordProgressionTemplate;
-        readonly oneFive: import("../../mod.js").ChordProgressionTemplate;
-        readonly oneFour: import("../../mod.js").ChordProgressionTemplate;
-        readonly oneOneFiveFive: import("../../mod.js").ChordProgressionTemplate;
-        readonly oneOneFiveFiveSeven: import("../../mod.js").ChordProgressionTemplate;
-        readonly oneFourOneFive: import("../../mod.js").ChordProgressionTemplate;
-    };
-    readonly popChordProgressionTemplates: {
-        readonly dooWop: import("../../mod.js").ChordProgressionTemplate;
-        readonly axisProgression: import("../../mod.js").ChordProgressionTemplate;
-    };
-    readonly bluesChordProgressionTemplates: {
-        readonly twelveBarBlues: import("../../mod.js").ChordProgressionTemplate;
-    };
-    readonly jazzChordProgressionTemplates: {
-        readonly twoFiveOneMajor: import("../../mod.js").ChordProgressionTemplate;
-        readonly minorTwoFiveOne: import("../../mod.js").ChordProgressionTemplate;
-        readonly rhythmChanges: import("../../mod.js").ChordProgressionTemplate;
-        readonly jazzBluesBasic: import("../../mod.js").ChordProgressionTemplate;
-    };
-};
-export type ChordProgressionTemplateGroupKey = keyof typeof groupedChordProgressionTemplates;
-/** Human-readable DisplayName and Description metadata for top-level chord progression groups. */
-export declare const chordProgressionTemplateGroupsMetadata: Record<ChordProgressionTemplateGroupKey, {
-    displayName: string;
-    description: string;
-}>;
-/** Human-readable DisplayName and Description metadata for chord progression categories. */
-export declare const chordProgressionTemplateCategoryMetadata: Record<ChordProgressionTemplateCategory, {
-    displayName: string;
-    description: string;
-}>;
-/** Human-readable DisplayName and Description metadata for chord progression template types. */
-export declare const chordProgressionTemplateTypeMetadata: Record<ChordProgressionTemplateType, {
-    displayName: string;
-    description: string;
-}>;
+export type ChordProgressionKey = keyof typeof _chordProgressions;
+export declare const chordProgressions: Record<ChordProgressionKey, ChordProgression>;
+export {};
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/mod.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gCAAgC,EAChC,4BAA4B,EAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AAExD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;CAK5B,CAAC;AAEX,MAAM,MAAM,2BAA2B,GACrC,MAAM,OAAO,yBAAyB,CAAC;AAEzC,MAAM,MAAM,wCAAwC,GAAG,OAAO,CAC5D,MAAM,CAAC,YAAY,EAAE,iBAAiB,CAAC,CACxC,CAAC;AAEF,8FAA8F;AAC9F,eAAO,MAAM,sCAAsC,EACjD,wCAQU,CAAC;AAEb,eAAO,MAAM,gCAAgC;;;;;;;;;;;;;;;;;;;;;;CAKnC,CAAC;AAEX,MAAM,MAAM,gCAAgC,GAC1C,MAAM,OAAO,gCAAgC,CAAC;AAEhD,kGAAkG;AAClG,eAAO,MAAM,sCAAsC,EAAE,MAAM,CACzD,gCAAgC,EAChC;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAsBO,CAAC;AAEX,4FAA4F;AAC5F,eAAO,MAAM,wCAAwC,EAAE,MAAM,CAC3D,gCAAgC,EAChC;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAMO,CAAC;AAEX,gGAAgG;AAChG,eAAO,MAAM,oCAAoC,EAAE,MAAM,CACvD,4BAA4B,EAC5B;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAgBO,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAEjB,MAAM,gCAAgC,CAAC;AA+JxC,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;CAed,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,EAAE,gBAAgB,CACxD,CAAC"}

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

@@ -1,71 +1,155 @@
-import { basicChordProgressionTemplates } from "./basic.js";
-import { bluesChordProgressionTemplates } from "./blues.js";
-import { jazzChordProgressionTemplates } from "./jazz.js";
-import { popChordProgressionTemplates } from "./pop.js";
-export { basicChordProgressionTemplates } from "./basic.js";
-export { bluesChordProgressionTemplates } from "./blues.js";
-export { jazzChordProgressionTemplates } from "./jazz.js";
-export { popChordProgressionTemplates } from "./pop.js";
-export const chordProgressionTemplates = {
-    ...basicChordProgressionTemplates,
-    ...popChordProgressionTemplates,
-    ...bluesChordProgressionTemplates,
-    ...jazzChordProgressionTemplates,
+function chord(degree, quality, durationInBars) {
+    return {
+        degree,
+        quality,
+        durationInBars,
+    };
+}
+const oneOneFiveFive = {
+    primaryName: "I | I | V | V",
+    chords: [
+        chord("1", "M", 2),
+        chord("5", "M", 2),
+    ],
 };
-/** Canonical chord/arpeggio collection keys for chord qualities used by progression steps. */
-export const chordProgressionStepNoteCollectionKeys = {
-    M: "major",
-    m: "minor",
-    "7": "dominant7",
-    M7: "major7",
-    m7: "minor7",
-    "ø7": "halfDiminished7",
-    "°7": "diminished7",
+const oneOneFiveFiveDominant7 = {
+    primaryName: "I | I | V | V7",
+    chords: [
+        chord("1", "M", 2),
+        chord("5", "M", 1),
+        chord("5", "7", 1),
+    ],
 };
-export const groupedChordProgressionTemplates = {
-    basicChordProgressionTemplates,
-    popChordProgressionTemplates,
-    bluesChordProgressionTemplates,
-    jazzChordProgressionTemplates,
+const oneOneFourFour = {
+    primaryName: "I | I | IV | IV",
+    chords: [
+        chord("1", "M", 2),
+        chord("4", "M", 2),
+    ],
 };
-/** Human-readable DisplayName and Description metadata for top-level chord progression groups. */
-export const chordProgressionTemplateGroupsMetadata = {
-    basicChordProgressionTemplates: {
-        displayName: "Basic",
-        description: "Simple beginner-friendly formulas and playable loops built from foundational harmonic movement.",
-    },
-    popChordProgressionTemplates: {
-        displayName: "Pop",
-        description: "Common songwriting loops used across pop, rock, folk, and related styles.",
-    },
-    bluesChordProgressionTemplates: {
-        displayName: "Blues",
-        description: "Blues forms and dominant-chord progressions, including twelve-bar templates.",
-    },
-    jazzChordProgressionTemplates: {
-        displayName: "Jazz",
-        description: "Functional harmony templates, turnarounds, cadences, and standard jazz forms.",
-    },
+const oneOneFourFive = {
+    primaryName: "I | I | IV | V",
+    chords: [
+        chord("1", "M", 2),
+        chord("4", "M", 1),
+        chord("5", "M", 1),
+    ],
 };
-/** Human-readable DisplayName and Description metadata for chord progression categories. */
-export const chordProgressionTemplateCategoryMetadata = {
-    basic: chordProgressionTemplateGroupsMetadata.basicChordProgressionTemplates,
-    pop: chordProgressionTemplateGroupsMetadata.popChordProgressionTemplates,
-    blues: chordProgressionTemplateGroupsMetadata.bluesChordProgressionTemplates,
-    jazz: chordProgressionTemplateGroupsMetadata.jazzChordProgressionTemplates,
+const oneFourOneFive = {
+    primaryName: "I | IV | I | V",
+    chords: [
+        chord("1", "M", 1),
+        chord("4", "M", 1),
+        chord("1", "M", 1),
+        chord("5", "M", 1),
+    ],
 };
-/** Human-readable DisplayName and Description metadata for chord progression template types. */
-export const chordProgressionTemplateTypeMetadata = {
-    formula: {
-        displayName: "Formula",
-        description: "A reusable harmonic relationship, not necessarily a complete playable loop or song form.",
-    },
-    loop: {
-        displayName: "Loop",
-        description: "A short playable chord progression intended to repeat.",
-    },
-    form: {
-        displayName: "Form",
-        description: "A longer structured progression with named sections or a conventional song form.",
-    },
+const oneSixFourFive = {
+    primaryName: "I | vi | IV | V",
+    chords: [
+        chord("1", "M", 1),
+        chord("6", "m", 1),
+        chord("4", "M", 1),
+        chord("5", "M", 1),
+    ],
 };
+const oneFiveSixFour = {
+    primaryName: "I | V | vi | IV",
+    chords: [
+        chord("1", "M", 1),
+        chord("5", "M", 1),
+        chord("6", "m", 1),
+        chord("4", "M", 1),
+    ],
+};
+const oneSixTwoFive = {
+    primaryName: "I | vi | ii | V",
+    chords: [
+        chord("1", "M", 1),
+        chord("6", "m", 1),
+        chord("2", "m", 1),
+        chord("5", "M", 1),
+    ],
+};
+const sixTwoFiveOne = {
+    primaryName: "vi | ii | V | I",
+    chords: [
+        chord("6", "m", 1),
+        chord("2", "m", 1),
+        chord("5", "M", 1),
+        chord("1", "M", 1),
+    ],
+};
+const majorTwoFiveOne = {
+    primaryName: "iim7 | V7 | Imaj7 | Imaj7",
+    chords: [
+        chord("2", "m7", 1),
+        chord("5", "7", 1),
+        chord("1", "M7", 2),
+    ],
+};
+const minorTwoFiveOne = {
+    primaryName: "iiø7 | V7 | i | i",
+    chords: [
+        chord("2", "ø7", 1),
+        chord("5", "7", 1),
+        chord("1", "m", 2),
+    ],
+};
+const oneFourOneFiveSplitReturn = {
+    primaryName: "I | IV | I | V | I | IV | I V | I",
+    chords: [
+        chord("1", "M", 1),
+        chord("4", "M", 1),
+        chord("1", "M", 1),
+        chord("5", "M", 1),
+        chord("1", "M", 1),
+        chord("4", "M", 1),
+        chord("1", "M", 0.5),
+        chord("5", "M", 0.5),
+        chord("1", "M", 1),
+    ],
+};
+const twelveBarBlues = {
+    primaryName: "12 Bar Blues",
+    chords: [
+        chord("1", "7", 4),
+        chord("4", "7", 2),
+        chord("1", "7", 2),
+        chord("5", "7", 1),
+        chord("4", "7", 1),
+        chord("1", "7", 1),
+        chord("5", "7", 1),
+    ],
+};
+const twelveBarBluesQuickChange = {
+    primaryName: "12 Bar Blues Quick Change",
+    chords: [
+        chord("1", "7", 1),
+        chord("4", "7", 1),
+        chord("1", "7", 2),
+        chord("4", "7", 2),
+        chord("1", "7", 2),
+        chord("5", "7", 1),
+        chord("4", "7", 1),
+        chord("1", "7", 1),
+        chord("5", "7", 1),
+    ],
+};
+const _chordProgressions = {
+    oneOneFiveFive,
+    oneOneFiveFiveDominant7,
+    oneOneFourFour,
+    oneOneFourFive,
+    oneFourOneFive,
+    oneSixFourFive,
+    oneFiveSixFour,
+    oneSixTwoFive,
+    sixTwoFiveOne,
+    majorTwoFiveOne,
+    minorTwoFiveOne,
+    oneFourOneFiveSplitReturn,
+    twelveBarBlues,
+    twelveBarBluesQuickChange,
+};
+export const chordProgressions = _chordProgressions;

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

@@ -1,3 +1,4 @@
+import type { NoteCollectionKey } from "../note-collections/mod.js";
 declare const _triadChordQualities: readonly ["M", "m", "°", "+"];
 declare const _seventhChordQualities: readonly ["M7", "m7", "7", "ø7", "m7♭5", "°7", "m(M7)", "+M7", "M7♯5"];
 declare const _upperCaseRomanNumerals: readonly ["I", "II", "III", "IV", "V", "VI", "VII"];
@@ -21,6 +22,9 @@ export declare const triadChordQualities: readonly Triad[];
 export declare const seventhChordQualities: readonly SeventhChord[];
 /** The complete set of supported chord suffix qualities. */
 export declare const chordQualities: readonly ChordQuality[];
+export type ChordQualityNoteCollectionKeyMap = Record<ChordQuality, NoteCollectionKey>;
+/** Note-collection keys for every supported chord quality. */
+export declare const chordQualityNoteCollectionKeys: ChordQualityNoteCollectionKeyMap;
 /** Roman numeral rendering metadata for each supported chord quality. */
 export declare const chordQualityRomanRenderings: ReadonlyMap<ChordQuality, ChordQualityRomanRendering>;
 /** An ordered array containing the fundamental triad qualities of the diatonic major scale. */
@@ -39,5 +43,6 @@ export declare const melodicMinorSeventhChords: SeventhChord[];
 export declare const upperCaseRomanNumerals: readonly UpperCaseRomanNumeral[];
 /** An array mapping 7 index scale degrees to their corresponding lower-case Roman numerals. */
 export declare const lowerCaseRomanNumerals: readonly LowerCaseRomanNumeral[];
+export declare function getChordQualityNoteCollectionKey(quality: ChordQuality): NoteCollectionKey;
 export {};
 //# sourceMappingURL=mod.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chords/mod.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,oBAAoB,+BAAgC,CAAC;AAE3D,QAAA,MAAM,sBAAsB,wEAUlB,CAAC;AAEX,QAAA,MAAM,uBAAuB,qDAQnB,CAAC;AAEX,QAAA,MAAM,uBAAuB,qDAQnB,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,YAAY,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG,GAAG,YAAY,EAAE,GAAG,GAAG,YAAY,GAAG,KAAK,EAAE,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,GAAG,YAAY,GAAG,YAAY,EAAE,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,EAAE,SAAS,KAAK,EAAyB,CAAC;AAE1E,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EACjC,CAAC;AAEzB,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAGjD,CAAC;AAEF,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,EAAE,WAAW,CACnD,YAAY,EACZ,0BAA0B,CAe1B,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,cAAc,EAAE,KAAK,EAQxB,CAAC;AAEX,uGAAuG;AACvG,eAAO,MAAM,qBAAqB,EAAE,YAAY,EAQtC,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,EAAE,KAAK,EAQ7B,CAAC;AAEX,uGAAuG;AACvG,eAAO,MAAM,0BAA0B,EAAE,YAAY,EAQ3C,CAAC;AAEX,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAQ5B,CAAC;AAEX,sGAAsG;AACtG,eAAO,MAAM,yBAAyB,EAAE,YAAY,EAQ1C,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB,EAAE,SAAS,qBAAqB,EAC1C,CAAC;AAE1B,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB,EAAE,SAAS,qBAAqB,EAC1C,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chords/mod.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,QAAA,MAAM,oBAAoB,+BAAgC,CAAC;AAE3D,QAAA,MAAM,sBAAsB,wEAUlB,CAAC;AAEX,QAAA,MAAM,uBAAuB,qDAQnB,CAAC;AAEX,QAAA,MAAM,uBAAuB,qDAQnB,CAAC;AAEX,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,YAAY,CAAC;AAEhD,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7E,MAAM,MAAM,YAAY,GAAG,qBAAqB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,MAAM,UAAU,GAAG,GAAG,YAAY,EAAE,GAAG,GAAG,YAAY,GAAG,KAAK,EAAE,CAAC;AACvE,MAAM,MAAM,iBAAiB,GAAG,GAAG,YAAY,GAAG,YAAY,EAAE,CAAC;AACjE,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,OAAO,CAAC;AAEjD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAkBD,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB,EAAE,SAAS,KAAK,EAAyB,CAAC;AAE1E,6DAA6D;AAC7D,eAAO,MAAM,qBAAqB,EAAE,SAAS,YAAY,EACjC,CAAC;AAEzB,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,SAAS,YAAY,EAGjD,CAAC;AAEF,MAAM,MAAM,gCAAgC,GAAG,MAAM,CACnD,YAAY,EACZ,iBAAiB,CAClB,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,8BAA8B,EAAE,gCACZ,CAAC;AAElC,yEAAyE;AACzE,eAAO,MAAM,2BAA2B,EAAE,WAAW,CACnD,YAAY,EACZ,0BAA0B,CAe1B,CAAC;AAEH,+FAA+F;AAC/F,eAAO,MAAM,cAAc,EAAE,KAAK,EAQxB,CAAC;AAEX,uGAAuG;AACvG,eAAO,MAAM,qBAAqB,EAAE,YAAY,EAQtC,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,mBAAmB,EAAE,KAAK,EAQ7B,CAAC;AAEX,uGAAuG;AACvG,eAAO,MAAM,0BAA0B,EAAE,YAAY,EAQ3C,CAAC;AAEX,8FAA8F;AAC9F,eAAO,MAAM,kBAAkB,EAAE,KAAK,EAQ5B,CAAC;AAEX,sGAAsG;AACtG,eAAO,MAAM,yBAAyB,EAAE,YAAY,EAQ1C,CAAC;AAEX,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB,EAAE,SAAS,qBAAqB,EAC1C,CAAC;AAE1B,+FAA+F;AAC/F,eAAO,MAAM,sBAAsB,EAAE,SAAS,qBAAqB,EAC1C,CAAC;AAE1B,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,YAAY,GACpB,iBAAiB,CAEnB"}

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

@@ -28,6 +28,21 @@ const _lowerCaseRomanNumerals = [
     "vi",
     "vii",
 ];
+const _chordQualityNoteCollectionKeys = {
+    M: "major",
+    m: "minor",
+    "°": "diminishedTriad",
+    "+": "augmentedTriad",
+    M7: "major7",
+    m7: "minor7",
+    "7": "dominant7",
+    "ø7": "halfDiminished7",
+    "m7♭5": "halfDiminished7",
+    "°7": "diminished7",
+    "m(M7)": "minorMajor7",
+    "+M7": "augmentedMajor7",
+    "M7♯5": "augmentedMajor7",
+};
 /** The complete set of supported triad chord qualities. */
 export const triadChordQualities = _triadChordQualities;
 /** The complete set of supported seventh chord qualities. */
@@ -37,6 +52,8 @@ export const chordQualities = [
     ...triadChordQualities,
     ...seventhChordQualities,
 ];
+/** Note-collection keys for every supported chord quality. */
+export const chordQualityNoteCollectionKeys = _chordQualityNoteCollectionKeys;
 /** Roman numeral rendering metadata for each supported chord quality. */
 export const chordQualityRomanRenderings = new Map([
     ["M", { numeralCase: "upper", suffix: "" }],
@@ -117,3 +134,6 @@ export const melodicMinorSeventhChords = [
 export const upperCaseRomanNumerals = _upperCaseRomanNumerals;
 /** An array mapping 7 index scale degrees to their corresponding lower-case Roman numerals. */
 export const lowerCaseRomanNumerals = _lowerCaseRomanNumerals;
+export function getChordQualityNoteCollectionKey(quality) {
+    return chordQualityNoteCollectionKeys[quality];
+}

package/esm/src/data/note-collections/augmented-variants.d.ts

@@ -2,6 +2,7 @@ import type { ChordCollection } from "../../types/note-collections";
 export declare const _augmentedVariants: {
     readonly augmentedTriad: ChordCollection;
     readonly augmented7: ChordCollection;
+    readonly augmentedMajor7: ChordCollection;
 };
 export type AugmentedVariantKey = keyof typeof _augmentedVariants;
 export declare const augmentedVariants: Record<AugmentedVariantKey, ChordCollection>;

package/esm/src/data/note-collections/augmented-variants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"augmented-variants.d.ts","sourceRoot":"","sources":["../../../../src/src/data/note-collections/augmented-variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AA4BpE,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,EAAE,eAAe,CACvD,CAAC"}
+{"version":3,"file":"augmented-variants.d.ts","sourceRoot":"","sources":["../../../../src/src/data/note-collections/augmented-variants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAqDpE,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,kBAAkB,CAAC;AAElE,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,mBAAmB,EAAE,eAAe,CACvD,CAAC"}

package/esm/src/data/note-collections/augmented-variants.js

@@ -22,8 +22,33 @@ const augmented7 = {
     pattern: ["major third", "major third", "major second"],
     patternShort: ["M3", "M3", "M2"],
 };
+const augmentedMajor7 = {
+    category: "chord",
+    mostSimilarScale: "ionianSharp5",
+    primaryName: "+M7",
+    names: [
+        "+M7",
+        "M7♯5",
+        "maj7♯5",
+        "Augmented Major 7th",
+        "Augmented Major Seventh",
+    ],
+    intervals: ["1", "3", "♯5", "7"],
+    integers: [0, 4, 8, 11],
+    type: ["augmented", "major", "chord", "arpeggio", "tetrad"],
+    characteristics: [
+        "dreamy",
+        "unstable",
+        "lush",
+        "bright",
+        "used in jazz and film harmony",
+    ],
+    pattern: ["major third", "major third", "minor third"],
+    patternShort: ["M3", "M3", "m3"],
+};
 export const _augmentedVariants = {
     augmentedTriad,
     augmented7,
+    augmentedMajor7,
 };
 export const augmentedVariants = _augmentedVariants;

package/esm/src/data/note-collections/mod.d.ts

@@ -19,6 +19,7 @@ export declare const noteCollections: {
     readonly wholeTone: import("../../mod.js").NoteCollection;
     readonly augmentedTriad: import("../../mod.js").ChordCollection;
     readonly augmented7: import("../../mod.js").ChordCollection;
+    readonly augmentedMajor7: import("../../mod.js").ChordCollection;
     readonly diminishedTriad: import("../../mod.js").NoteCollection;
     readonly diminished7: import("../../mod.js").NoteCollection;
     readonly halfDiminished7: import("../../mod.js").NoteCollection;
@@ -81,7 +82,7 @@ export declare const groupedNoteCollections: {
     readonly harmonicMinorModes: Record<"harmonicMinor" | "locrianNatural6" | "ionianSharp5" | "dorianSharp4" | "phrygianDominant" | "lydianSharp2" | "superLocrianDoubleFlat7", import("../../mod.js").ModalScaleCollection>;
     readonly melodicMinorModes: Record<"melodicMinor" | "dorianFlat2" | "lydianAugmented" | "lydianDominant" | "mixolydianFlat6" | "aeolianFlat5" | "altered", import("../../mod.js").ModalScaleCollection>;
     readonly diminishedVariants: Record<"diminishedTriad" | "diminished7" | "halfDiminished7" | "wholeHalfDiminished" | "halfWholeDiminished", import("../../mod.js").NoteCollection>;
-    readonly augmentedVariants: Record<"augmentedTriad" | "augmented7", import("../../mod.js").ChordCollection>;
+    readonly augmentedVariants: Record<"augmentedTriad" | "augmented7" | "augmentedMajor7", import("../../mod.js").ChordCollection>;
     readonly otherNoteCollections: Record<"root" | "rootAndFifth" | "rootAndFourth" | "rootAndTritone" | "bluesPentatonic" | "chromatic" | "wholeTone", import("../../mod.js").NoteCollection>;
 };
 /** A strictly typed generic string representing the key of a top-level note collection category array. */

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

@@ -1 +1 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/note-collections/mod.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,oIAAoI;AACpI,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWlB,CAAC;AAEX,0HAA0H;AAC1H,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE7D,qIAAqI;AACrI,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAWzB,CAAC;AAEX,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEzE,sHAAsH;AACtH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,sBAAsB,EACtB;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAkDO,CAAC"}
+{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../../src/src/data/note-collections/mod.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,oIAAoI;AACpI,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWlB,CAAC;AAEX,0HAA0H;AAC1H,MAAM,MAAM,iBAAiB,GAAG,MAAM,OAAO,eAAe,CAAC;AAE7D,qIAAqI;AACrI,eAAO,MAAM,sBAAsB;;;;;;;;;;;CAWzB,CAAC;AAEX,0GAA0G;AAC1G,MAAM,MAAM,sBAAsB,GAAG,MAAM,OAAO,sBAAsB,CAAC;AAEzE,sHAAsH;AACtH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAC/C,sBAAsB,EACtB;IACE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAkDO,CAAC"}

package/esm/src/mod.d.ts

@@ -1,5 +1,5 @@
 /**
- * A comprehensive library of music theory data, including notes, dyads, scales, chord pitch collections, and chord progression templates.
+ * A comprehensive library of music theory data, including notes, dyads, scales, chord pitch collections, and chord progressions.
  *
  * This package provides a collection of datasets and utility functions
  * to work with fundamental concepts of music theory. It's designed to be

package/esm/src/mod.js

@@ -1,5 +1,5 @@
 /**
- * A comprehensive library of music theory data, including notes, dyads, scales, chord pitch collections, and chord progression templates.
+ * A comprehensive library of music theory data, including notes, dyads, scales, chord pitch collections, and chord progressions.
  *
  * This package provides a collection of datasets and utility functions
  * to work with fundamental concepts of music theory. It's designed to be

package/esm/src/utils/chord-progressions.d.ts

@@ -1,18 +1,16 @@
-import { type ChordProgressionTemplateKey } from "../data/chord-progressions/mod.js";
-import type { ChordProgressionTemplate, ChordProgressionTemplateCategory, ChordProgressionTemplateType } from "../types/chord-progressions";
-import type { ChordQuality } from "../types/chords";
-import type { Interval, RootNote } from "../data/labels/note-labels.js";
-export interface ChordProgressionTemplateSearchOptions {
-    query?: string;
-    category?: ChordProgressionTemplateCategory;
-    templateType?: ChordProgressionTemplateType;
-    type?: string;
+import { type ChordProgressionKey } from "../data/chord-progressions/mod.js";
+import type { ChordProgression } from "../types/chord-progressions";
+import type { RootNote } from "../data/labels/note-labels.js";
+import type { NoteCollectionKey } from "../data/note-collections/mod.js";
+export interface ChordProgressionChordReference {
+    readonly rootNote: RootNote;
+    readonly chordName: string;
+    readonly noteCollectionKey: NoteCollectionKey;
 }
-export declare function isValidChordProgressionTemplateKey(key: string): key is ChordProgressionTemplateKey;
-export declare function searchChordProgressionTemplates(options?: ChordProgressionTemplateSearchOptions): ChordProgressionTemplate[];
-export declare function findChordProgressionTemplate(options?: ChordProgressionTemplateSearchOptions): ChordProgressionTemplate | undefined;
-export declare function getRomanNumeralForIntervalAndChordQuality(interval: Interval, quality: ChordQuality): string | undefined;
-export declare function getChordProgressionTemplateDegreeNames(templateOrKey: ChordProgressionTemplate | ChordProgressionTemplateKey): string[];
-export declare function getChordProgressionTemplateRomanNames(templateOrKey: ChordProgressionTemplate | ChordProgressionTemplateKey): string[];
-export declare function getChordProgressionTemplateChordNames(rootNote: RootNote, templateOrKey: ChordProgressionTemplate | ChordProgressionTemplateKey): string[];
+export declare function isValidChordProgressionKey(key: string): key is ChordProgressionKey;
+export declare function getChordProgressionChordNames(rootNote: RootNote, progressionOrKey: ChordProgression | ChordProgressionKey): string[];
+export declare function getChordProgressionUniqueChordNames(rootNote: RootNote, progressionOrKey: ChordProgression | ChordProgressionKey): string[];
+export declare function getChordProgressionChordReferences(rootNote: RootNote, progressionOrKey: ChordProgression | ChordProgressionKey): ChordProgressionChordReference[];
+export declare function getChordProgressionUniqueChordReferences(rootNote: RootNote, progressionOrKey: ChordProgression | ChordProgressionKey): ChordProgressionChordReference[];
+export declare function getChordProgressionTotalDurationInBars(progressionOrKey: ChordProgression | ChordProgressionKey): number;
 //# sourceMappingURL=chord-progressions.d.ts.map

package/esm/src/utils/chord-progressions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"chord-progressions.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chord-progressions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EACV,wBAAwB,EACxB,gCAAgC,EAEhC,4BAA4B,EAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAMxE,MAAM,WAAW,qCAAqC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,gCAAgC,CAAC;IAC5C,YAAY,CAAC,EAAE,4BAA4B,CAAC;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,kCAAkC,CAChD,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,2BAA2B,CAEpC;AAiCD,wBAAgB,+BAA+B,CAC7C,OAAO,GAAE,qCAA0C,GAClD,wBAAwB,EAAE,CA6D5B;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,GAAE,qCAA0C,GAClD,wBAAwB,GAAG,SAAS,CAEtC;AASD,wBAAgB,yCAAyC,CACvD,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,YAAY,GACpB,MAAM,GAAG,SAAS,CAWpB;AAED,wBAAgB,sCAAsC,CACpD,aAAa,EAAE,wBAAwB,GAAG,2BAA2B,GACpE,MAAM,EAAE,CAOV;AAED,wBAAgB,qCAAqC,CACnD,aAAa,EAAE,wBAAwB,GAAG,2BAA2B,GACpE,MAAM,EAAE,CAWV;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,QAAQ,EAClB,aAAa,EAAE,wBAAwB,GAAG,2BAA2B,GACpE,MAAM,EAAE,CAWV"}
+{"version":3,"file":"chord-progressions.d.ts","sourceRoot":"","sources":["../../../src/src/utils/chord-progressions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,mBAAmB,EAEzB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAMzE,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;CAC/C;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,MAAM,GACV,GAAG,IAAI,mBAAmB,CAE5B;AASD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAYV;AAED,wBAAgB,mCAAmC,CACjD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,EAAE,CAIV;AAED,wBAAgB,kCAAkC,CAChD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAmBlC;AAED,wBAAgB,wCAAwC,CACtD,QAAQ,EAAE,QAAQ,EAClB,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,8BAA8B,EAAE,CAkBlC;AAED,wBAAgB,sCAAsC,CACpD,gBAAgB,EAAE,gBAAgB,GAAG,mBAAmB,GACvD,MAAM,CAQR"}