@musodojo/music-theory-data 27.0.0 → 28.0.0

package/esm/src/utils/chord-progressions.js

@@ -1,111 +1,55 @@
-import { chordProgressionTemplates, } from "../data/chord-progressions/mod.js";
-import { getRomanNumeralForScaleIndexAndChordQuality } from "./chords.js";
-import { getNoteNamesForRootAndIntervals } from "./note-names.js";
-const INTERVAL_REGEX = /^([𝄫♭♮♯𝄪]*)([1-7])$/;
-export function isValidChordProgressionTemplateKey(key) {
-    return Object.prototype.hasOwnProperty.call(chordProgressionTemplates, key);
-}
-function flattenTemplateSteps(template) {
-    return template.sections.flatMap((section) => section.chords);
-}
-function normalizeSearchTerm(str) {
-    return str
-        .trim()
-        .replaceAll("-", " ")
-        .replace(/\s+/g, " ")
-        .toLowerCase();
-}
-function getSearchableTemplateText(template) {
-    return [
-        template.primaryName,
-        template.templateType,
-        template.category,
-        ...template.names,
-        ...template.type,
-        ...template.characteristics,
-        ...getChordProgressionTemplateDegreeNames(template),
-        ...getChordProgressionTemplateRomanNames(template),
-    ]
-        .map(normalizeSearchTerm)
-        .join(" ");
-}
-export function searchChordProgressionTemplates(options = {}) {
-    const { query, category, templateType, type } = options;
-    let candidates = Object.values(chordProgressionTemplates);
-    if (category) {
-        candidates = candidates.filter((template) => template.category === category);
-    }
-    if (templateType) {
-        candidates = candidates.filter((template) => template.templateType === templateType);
-    }
-    if (type) {
-        const normalizedType = normalizeSearchTerm(type);
-        candidates = candidates.filter((template) => template.type.map(normalizeSearchTerm).includes(normalizedType));
-    }
-    if (!query)
-        return candidates;
-    const normalizedQuery = normalizeSearchTerm(query);
-    if (!normalizedQuery)
-        return candidates;
-    const queryWords = normalizedQuery.split(" ");
-    const textFilteredCandidates = candidates.filter((template) => {
-        const searchableText = getSearchableTemplateText(template);
-        return queryWords.every((word) => searchableText.includes(word));
-    });
-    const prioritizedResults = new Set();
-    const passes = [
-        (template) => normalizeSearchTerm(template.primaryName) === normalizedQuery,
-        (template) => template.names.some((name) => normalizeSearchTerm(name) === normalizedQuery),
-        (template) => normalizeSearchTerm(template.primaryName).startsWith(normalizedQuery),
-        (template) => template.names.some((name) => normalizeSearchTerm(name).startsWith(normalizedQuery)),
-    ];
-    for (const pass of passes) {
-        for (const template of textFilteredCandidates) {
-            if (pass(template))
-                prioritizedResults.add(template);
-        }
-    }
-    for (const template of textFilteredCandidates) {
-        prioritizedResults.add(template);
-    }
-    return Array.from(prioritizedResults);
-}
-export function findChordProgressionTemplate(options = {}) {
-    return searchChordProgressionTemplates(options)[0];
-}
-function resolveTemplate(templateOrKey) {
-    if (typeof templateOrKey !== "string")
-        return templateOrKey;
-    return chordProgressionTemplates[templateOrKey];
-}
-export function getRomanNumeralForIntervalAndChordQuality(interval, quality) {
-    const match = interval.match(INTERVAL_REGEX);
-    if (!match)
-        return undefined;
-    const [, accidental, intervalNumber] = match;
-    const roman = getRomanNumeralForScaleIndexAndChordQuality(Number(intervalNumber) - 1, quality);
-    return roman === undefined ? undefined : accidental + roman;
-}
-export function getChordProgressionTemplateDegreeNames(templateOrKey) {
-    const template = resolveTemplate(templateOrKey);
-    if (!template)
+import { chordProgressions, } from "../data/chord-progressions/mod.js";
+import { getChordQualityNoteCollectionKey } from "../data/chords/mod.js";
+import { getNoteNamesForRootAndIntervals, normalizeRootNoteString, } from "./note-names.js";
+export function isValidChordProgressionKey(key) {
+    return Object.prototype.hasOwnProperty.call(chordProgressions, key);
+}
+function resolveProgression(progressionOrKey) {
+    if (typeof progressionOrKey !== "string")
+        return progressionOrKey;
+    return chordProgressions[progressionOrKey];
+}
+export function getChordProgressionChordNames(rootNote, progressionOrKey) {
+    const progression = resolveProgression(progressionOrKey);
+    if (!progression)
         return [];
-    return flattenTemplateSteps(template).map((step) => step.interval + step.quality);
+    const noteNames = getNoteNamesForRootAndIntervals(rootNote, progression.chords.map((chord) => chord.degree));
+    return progression.chords.map((chord, index) => noteNames[index] + chord.quality);
 }
-export function getChordProgressionTemplateRomanNames(templateOrKey) {
-    const template = resolveTemplate(templateOrKey);
-    if (!template)
+export function getChordProgressionUniqueChordNames(rootNote, progressionOrKey) {
+    return Array.from(new Set(getChordProgressionChordNames(rootNote, progressionOrKey)));
+}
+export function getChordProgressionChordReferences(rootNote, progressionOrKey) {
+    const progression = resolveProgression(progressionOrKey);
+    if (!progression)
         return [];
-    return flattenTemplateSteps(template).flatMap((step) => {
-        const roman = getRomanNumeralForIntervalAndChordQuality(step.interval, step.quality);
-        return roman ? [roman] : [];
+    const chordRootNotes = getNoteNamesForRootAndIntervals(rootNote, progression.chords.map((chord) => chord.degree)).map((noteName) => normalizeRootNoteString(noteName));
+    return progression.chords.flatMap((chord, index) => {
+        const chordRootNote = chordRootNotes[index];
+        if (!chordRootNote)
+            return [];
+        return [{
+                rootNote: chordRootNote,
+                chordName: chordRootNote + chord.quality,
+                noteCollectionKey: getChordQualityNoteCollectionKey(chord.quality),
+            }];
     });
 }
-export function getChordProgressionTemplateChordNames(rootNote, templateOrKey) {
-    const template = resolveTemplate(templateOrKey);
-    if (!template)
-        return [];
-    const steps = flattenTemplateSteps(template);
-    const noteNames = getNoteNamesForRootAndIntervals(rootNote, steps.map((step) => step.interval));
-    return noteNames.map((noteName, i) => noteName + steps[i].quality);
+export function getChordProgressionUniqueChordReferences(rootNote, progressionOrKey) {
+    const uniqueReferences = [];
+    const seen = new Set();
+    for (const reference of getChordProgressionChordReferences(rootNote, progressionOrKey)) {
+        const key = `${reference.rootNote}:${reference.noteCollectionKey}:${reference.chordName}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        uniqueReferences.push(reference);
+    }
+    return uniqueReferences;
+}
+export function getChordProgressionTotalDurationInBars(progressionOrKey) {
+    const progression = resolveProgression(progressionOrKey);
+    if (!progression)
+        return 0;
+    return progression.chords.reduce((total, chord) => total + chord.durationInBars, 0);
 }

package/package.json

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

package/script/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("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly minorTwoFiveOne: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly rhythmChanges: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly jazzBluesBasic: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly twelveBarBlues: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly dooWop: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly axisProgression: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly oneFourFive: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly oneFive: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly oneFour: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly oneOneFiveFive: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly oneOneFiveFiveSeven: import("../../types/chord-progressions").ChordProgressionTemplate;
-    readonly oneFourOneFive: import("../../types/chord-progressions").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("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly oneFive: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly oneFour: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly oneOneFiveFive: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly oneOneFiveFiveSeven: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly oneFourOneFive: import("../../types/chord-progressions").ChordProgressionTemplate;
-    };
-    readonly popChordProgressionTemplates: {
-        readonly dooWop: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly axisProgression: import("../../types/chord-progressions").ChordProgressionTemplate;
-    };
-    readonly bluesChordProgressionTemplates: {
-        readonly twelveBarBlues: import("../../types/chord-progressions").ChordProgressionTemplate;
-    };
-    readonly jazzChordProgressionTemplates: {
-        readonly twoFiveOneMajor: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly minorTwoFiveOne: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly rhythmChanges: import("../../types/chord-progressions").ChordProgressionTemplate;
-        readonly jazzBluesBasic: import("../../types/chord-progressions").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/script/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/script/src/data/chord-progressions/mod.js

@@ -1,78 +1,158 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.chordProgressionTemplateTypeMetadata = exports.chordProgressionTemplateCategoryMetadata = exports.chordProgressionTemplateGroupsMetadata = exports.groupedChordProgressionTemplates = exports.chordProgressionStepNoteCollectionKeys = exports.chordProgressionTemplates = exports.popChordProgressionTemplates = exports.jazzChordProgressionTemplates = exports.bluesChordProgressionTemplates = exports.basicChordProgressionTemplates = void 0;
-const basic_js_1 = require("./basic.js");
-const blues_js_1 = require("./blues.js");
-const jazz_js_1 = require("./jazz.js");
-const pop_js_1 = require("./pop.js");
-var basic_js_2 = require("./basic.js");
-Object.defineProperty(exports, "basicChordProgressionTemplates", { enumerable: true, get: function () { return basic_js_2.basicChordProgressionTemplates; } });
-var blues_js_2 = require("./blues.js");
-Object.defineProperty(exports, "bluesChordProgressionTemplates", { enumerable: true, get: function () { return blues_js_2.bluesChordProgressionTemplates; } });
-var jazz_js_2 = require("./jazz.js");
-Object.defineProperty(exports, "jazzChordProgressionTemplates", { enumerable: true, get: function () { return jazz_js_2.jazzChordProgressionTemplates; } });
-var pop_js_2 = require("./pop.js");
-Object.defineProperty(exports, "popChordProgressionTemplates", { enumerable: true, get: function () { return pop_js_2.popChordProgressionTemplates; } });
-exports.chordProgressionTemplates = {
-    ...basic_js_1.basicChordProgressionTemplates,
-    ...pop_js_1.popChordProgressionTemplates,
-    ...blues_js_1.bluesChordProgressionTemplates,
-    ...jazz_js_1.jazzChordProgressionTemplates,
+exports.chordProgressions = void 0;
+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. */
-exports.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),
+    ],
 };
-exports.groupedChordProgressionTemplates = {
-    basicChordProgressionTemplates: basic_js_1.basicChordProgressionTemplates,
-    popChordProgressionTemplates: pop_js_1.popChordProgressionTemplates,
-    bluesChordProgressionTemplates: blues_js_1.bluesChordProgressionTemplates,
-    jazzChordProgressionTemplates: jazz_js_1.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. */
-exports.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. */
-exports.chordProgressionTemplateCategoryMetadata = {
-    basic: exports.chordProgressionTemplateGroupsMetadata.basicChordProgressionTemplates,
-    pop: exports.chordProgressionTemplateGroupsMetadata.popChordProgressionTemplates,
-    blues: exports.chordProgressionTemplateGroupsMetadata.bluesChordProgressionTemplates,
-    jazz: exports.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. */
-exports.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,
+};
+exports.chordProgressions = _chordProgressions;

package/script/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/script/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/script/src/data/chords/mod.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.lowerCaseRomanNumerals = exports.upperCaseRomanNumerals = exports.melodicMinorSeventhChords = exports.melodicMinorTriads = exports.harmonicMinorSeventhChords = exports.harmonicMinorTriads = exports.diatonicSeventhChords = exports.diatonicTriads = exports.chordQualityRomanRenderings = exports.chordQualities = exports.seventhChordQualities = exports.triadChordQualities = void 0;
+exports.lowerCaseRomanNumerals = exports.upperCaseRomanNumerals = exports.melodicMinorSeventhChords = exports.melodicMinorTriads = exports.harmonicMinorSeventhChords = exports.harmonicMinorTriads = exports.diatonicSeventhChords = exports.diatonicTriads = exports.chordQualityRomanRenderings = exports.chordQualityNoteCollectionKeys = exports.chordQualities = exports.seventhChordQualities = exports.triadChordQualities = void 0;
+exports.getChordQualityNoteCollectionKey = getChordQualityNoteCollectionKey;
 const _triadChordQualities = ["M", "m", "°", "+"];
 const _seventhChordQualities = [
     "M7",
@@ -31,6 +32,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. */
 exports.triadChordQualities = _triadChordQualities;
 /** The complete set of supported seventh chord qualities. */
@@ -40,6 +56,8 @@ exports.chordQualities = [
     ...exports.triadChordQualities,
     ...exports.seventhChordQualities,
 ];
+/** Note-collection keys for every supported chord quality. */
+exports.chordQualityNoteCollectionKeys = _chordQualityNoteCollectionKeys;
 /** Roman numeral rendering metadata for each supported chord quality. */
 exports.chordQualityRomanRenderings = new Map([
     ["M", { numeralCase: "upper", suffix: "" }],
@@ -120,3 +138,6 @@ exports.melodicMinorSeventhChords = [
 exports.upperCaseRomanNumerals = _upperCaseRomanNumerals;
 /** An array mapping 7 index scale degrees to their corresponding lower-case Roman numerals. */
 exports.lowerCaseRomanNumerals = _lowerCaseRomanNumerals;
+function getChordQualityNoteCollectionKey(quality) {
+    return exports.chordQualityNoteCollectionKeys[quality];
+}

package/script/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/script/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/script/src/data/note-collections/augmented-variants.js

@@ -25,8 +25,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"],
+};
 exports._augmentedVariants = {
     augmentedTriad,
     augmented7,
+    augmentedMajor7,
 };
 exports.augmentedVariants = exports._augmentedVariants;

package/script/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. */