@musodojo/music-theory-data 26.3.0 → 26.4.0

package/README.md

@@ -1,8 +1,8 @@
 # Muso Dojo | Music Theory Data
 
 **Empower your music applications with a comprehensive, type-safe, and
-musician-friendly TypeScript/JavaScript library for modes, scales, chords, and
-more.**
+musician-friendly TypeScript/JavaScript library for notes, dyads, modes, scales,
+chord pitch collections, chord progression templates, and more.**
 
 ## Community & Support
 
@@ -24,7 +24,14 @@ Have a question, a suggestion, or want to report a bug? Get in touch!
 - ✅ Melodic Minor Modes
 - ✅ Diminished Variants
 - ✅ Augmented Variants
-- ✅ Other Note Collections
+- ✅ Other Note Collections, including notes and dyads
+
+## Available Chord Progression Templates
+
+- ✅ Basic Progressions
+- ✅ Pop Progressions
+- ✅ Blues Progressions
+- ✅ Jazz Progressions
 
 ## Features
 
@@ -35,8 +42,9 @@ Have a question, a suggestion, or want to report a bug? Get in touch!
 
 ### Rich Data Structures
 
-Access detailed information for scales, modes, chords, and more, including
-intervals, integer notations, and common names.
+Access detailed information for notes, dyads, scales, modes, chord pitch
+collections, chord progression templates, and more, including intervals, integer
+notations, and common names.
 
 ```ts
 // src/data/note-collections/diatonic-modes.ts
@@ -168,6 +176,22 @@ console.log(Object.keys(music_theory_data.noteCollections));
 // Log an array of all available Grouped Note Collections Keys
 console.log(Object.keys(music_theory_data.groupedNoteCollections));
 // ["diatonicModes", "pentatonicVariants", ...]
+
+// Get a beginner-friendly chord progression template
+const oneFourFive = music_theory_data.chordProgressionTemplates.oneFourFive;
+
+console.log(oneFourFive.primaryName);
+// "One Four Five"
+
+console.log(
+  music_theory_data.getChordProgressionTemplateRomanNames("oneFourFive"),
+);
+// ["I", "IV", "V"]
+
+console.log(
+  music_theory_data.getChordProgressionTemplateChordNames("C", "oneFourFive"),
+);
+// ["CM", "FM", "GM"]
 ```
 
 ## API Documentation

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

@@ -0,0 +1,10 @@
+import type { ChordProgressionTemplate } from "../../types/chord-progressions";
+export declare const basicChordProgressionTemplates: {
+    readonly oneFourFive: ChordProgressionTemplate;
+    readonly oneFive: ChordProgressionTemplate;
+    readonly oneFour: ChordProgressionTemplate;
+    readonly oneOneFiveFive: ChordProgressionTemplate;
+    readonly oneOneFiveFiveSeven: ChordProgressionTemplate;
+    readonly oneFourOneFive: ChordProgressionTemplate;
+};
+//# sourceMappingURL=basic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"basic.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/basic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAoK/E,eAAO,MAAM,8BAA8B;;;;;;;CAOjC,CAAC"}

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

@@ -0,0 +1,164 @@
+const oneFourFive = {
+    templateType: "formula",
+    category: "basic",
+    primaryName: "I IV V",
+    names: ["I IV V", "One Four Five", "1 4 5"],
+    type: ["basic", "formula", "major key", "three chord", "beginner"],
+    characteristics: [
+        "simple",
+        "foundational",
+        "common",
+        "beginner friendly",
+        "tonic subdominant dominant",
+    ],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "4", quality: "M" },
+                { interval: "5", quality: "M" },
+            ],
+        },
+    ],
+};
+const oneFive = {
+    templateType: "formula",
+    category: "basic",
+    primaryName: "I V",
+    names: ["I V", "One Five", "1 5"],
+    type: ["basic", "formula", "major key", "two chord", "beginner"],
+    characteristics: [
+        "simple",
+        "foundational",
+        "common",
+        "beginner friendly",
+        "tonic dominant",
+    ],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "5", quality: "M" },
+            ],
+        },
+    ],
+};
+const oneFour = {
+    templateType: "formula",
+    category: "basic",
+    primaryName: "I IV",
+    names: ["I IV", "One Four", "1 4"],
+    type: ["basic", "formula", "major key", "two chord", "beginner"],
+    characteristics: [
+        "simple",
+        "foundational",
+        "common",
+        "beginner friendly",
+        "tonic subdominant",
+    ],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "4", quality: "M" },
+            ],
+        },
+    ],
+};
+const oneOneFiveFive = {
+    templateType: "loop",
+    category: "basic",
+    primaryName: "I I V V",
+    names: ["I I V V", "One One Five Five", "1 1 5 5", "Tonic Dominant Loop"],
+    type: ["basic", "loop", "major key", "tonic dominant", "beginner"],
+    characteristics: [
+        "simple",
+        "playable",
+        "stable",
+        "beginner friendly",
+        "practice loop",
+    ],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "1", quality: "M" },
+                { interval: "5", quality: "M" },
+                { interval: "5", quality: "M" },
+            ],
+        },
+    ],
+};
+const oneOneFiveFiveSeven = {
+    templateType: "loop",
+    category: "basic",
+    primaryName: "I I V V7",
+    names: [
+        "I I V V7",
+        "One One Five Five-Seven",
+        "Tonic Dominant Seventh Loop",
+    ],
+    type: [
+        "basic",
+        "loop",
+        "major key",
+        "tonic dominant",
+        "turnaround",
+        "beginner",
+    ],
+    characteristics: [
+        "simple",
+        "playable",
+        "resolving",
+        "beginner friendly",
+        "practice loop",
+    ],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "1", quality: "M" },
+                { interval: "5", quality: "M" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+    ],
+};
+const oneFourOneFive = {
+    templateType: "loop",
+    category: "basic",
+    primaryName: "I IV I V",
+    names: ["I IV I V", "One Four One Five", "1 4 1 5"],
+    type: ["basic", "loop", "major key", "three chord", "beginner"],
+    characteristics: [
+        "simple",
+        "playable",
+        "balanced",
+        "beginner friendly",
+        "practice loop",
+    ],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "4", quality: "M" },
+                { interval: "1", quality: "M" },
+                { interval: "5", quality: "M" },
+            ],
+        },
+    ],
+};
+export const basicChordProgressionTemplates = {
+    oneFourFive,
+    oneFive,
+    oneFour,
+    oneOneFiveFive,
+    oneOneFiveFiveSeven,
+    oneFourOneFive,
+};

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

@@ -0,0 +1,5 @@
+import type { ChordProgressionTemplate } from "../../types/chord-progressions";
+export declare const bluesChordProgressionTemplates: {
+    readonly twelveBarBlues: ChordProgressionTemplate;
+};
+//# sourceMappingURL=blues.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blues.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/blues.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AA8B/E,eAAO,MAAM,8BAA8B;;CAEjC,CAAC"}

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

@@ -0,0 +1,30 @@
+const twelveBarBlues = {
+    templateType: "form",
+    category: "blues",
+    primaryName: "Twelve Bar Blues",
+    names: ["Twelve Bar Blues", "12 Bar Blues", "I7 IV7 V7 Blues"],
+    type: ["blues", "form", "dominant seventh", "twelve bar", "beginner"],
+    characteristics: ["foundational", "cyclical", "common", "blues"],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "4", quality: "7" },
+                { interval: "4", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "5", quality: "7" },
+                { interval: "4", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+    ],
+};
+export const bluesChordProgressionTemplates = {
+    twelveBarBlues,
+};

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

@@ -0,0 +1,8 @@
+import type { ChordProgressionTemplate } from "../../types/chord-progressions";
+export declare const jazzChordProgressionTemplates: {
+    readonly twoFiveOneMajor: ChordProgressionTemplate;
+    readonly minorTwoFiveOne: ChordProgressionTemplate;
+    readonly rhythmChanges: ChordProgressionTemplate;
+    readonly jazzBluesBasic: ChordProgressionTemplate;
+};
+//# sourceMappingURL=jazz.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jazz.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/jazz.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AA+I/E,eAAO,MAAM,6BAA6B;;;;;CAKhC,CAAC"}

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

@@ -0,0 +1,143 @@
+const twoFiveOneMajor = {
+    templateType: "formula",
+    category: "jazz",
+    primaryName: "iim7 V7 IM7",
+    names: [
+        "iim7 V7 IM7",
+        "ii V I",
+        "Two Five One",
+        "Major Two Five One",
+        "2 5 1",
+    ],
+    type: ["jazz", "formula", "major key", "cadence", "seventh chords"],
+    characteristics: ["functional", "resolving", "foundational", "jazz"],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+                { interval: "1", quality: "M7" },
+            ],
+        },
+    ],
+};
+const minorTwoFiveOne = {
+    templateType: "formula",
+    category: "jazz",
+    primaryName: "iiø7 V7 i",
+    names: ["iiø7 V7 i", "iiø V i", "Minor Two Five One", "2 5 1 minor"],
+    type: ["jazz", "formula", "minor key", "cadence", "seventh chords"],
+    characteristics: ["functional", "minor", "resolving", "jazz"],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "2", quality: "ø7" },
+                { interval: "5", quality: "7" },
+                { interval: "1", quality: "m" },
+            ],
+        },
+    ],
+};
+const rhythmChanges = {
+    templateType: "form",
+    category: "jazz",
+    primaryName: "Rhythm Changes",
+    names: ["Rhythm Changes", "AABA Rhythm Changes", "Rhythm Changes Form"],
+    type: ["jazz", "form", "major key", "turnaround", "AABA"],
+    characteristics: [
+        "cyclical",
+        "functional",
+        "jazz",
+        "standard",
+        "song form",
+    ],
+    sections: [
+        {
+            name: "A1",
+            chords: [
+                { interval: "1", quality: "M7" },
+                { interval: "6", quality: "m7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+                { interval: "3", quality: "m7" },
+                { interval: "6", quality: "7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+        {
+            name: "A2",
+            chords: [
+                { interval: "1", quality: "M7" },
+                { interval: "6", quality: "m7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+                { interval: "3", quality: "m7" },
+                { interval: "6", quality: "7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+        {
+            name: "B",
+            chords: [
+                { interval: "3", quality: "7" },
+                { interval: "3", quality: "7" },
+                { interval: "6", quality: "7" },
+                { interval: "6", quality: "7" },
+                { interval: "2", quality: "7" },
+                { interval: "2", quality: "7" },
+                { interval: "5", quality: "7" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+        {
+            name: "A3",
+            chords: [
+                { interval: "1", quality: "M7" },
+                { interval: "6", quality: "m7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+                { interval: "3", quality: "m7" },
+                { interval: "6", quality: "7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+    ],
+};
+const jazzBluesBasic = {
+    templateType: "form",
+    category: "jazz",
+    primaryName: "Jazz Blues Basic",
+    names: ["Jazz Blues Basic", "Jazz Blues"],
+    type: ["jazz", "blues", "form", "dominant seventh", "turnaround"],
+    characteristics: ["functional", "blues", "jazz", "cyclical"],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "7" },
+                { interval: "4", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "4", quality: "7" },
+                { interval: "♯4", quality: "°7" },
+                { interval: "1", quality: "7" },
+                { interval: "6", quality: "7" },
+                { interval: "2", quality: "m7" },
+                { interval: "5", quality: "7" },
+                { interval: "1", quality: "7" },
+                { interval: "5", quality: "7" },
+            ],
+        },
+    ],
+};
+export const jazzChordProgressionTemplates = {
+    twoFiveOneMajor,
+    minorTwoFiveOne,
+    rhythmChanges,
+    jazzBluesBasic,
+};

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

@@ -0,0 +1,61 @@
+import type { ChordProgressionTemplateCategory, ChordProgressionTemplateType } from "../../types/chord-progressions";
+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;
+};
+export type ChordProgressionTemplateKey = keyof typeof chordProgressionTemplates;
+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;
+}>;
+//# sourceMappingURL=mod.d.ts.map

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

@@ -0,0 +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;AAExC,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,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"}

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

@@ -0,0 +1,61 @@
+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,
+};
+export const groupedChordProgressionTemplates = {
+    basicChordProgressionTemplates,
+    popChordProgressionTemplates,
+    bluesChordProgressionTemplates,
+    jazzChordProgressionTemplates,
+};
+/** 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.",
+    },
+};
+/** 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,
+};
+/** 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.",
+    },
+};

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

@@ -0,0 +1,6 @@
+import type { ChordProgressionTemplate } from "../../types/chord-progressions";
+export declare const popChordProgressionTemplates: {
+    readonly dooWop: ChordProgressionTemplate;
+    readonly axisProgression: ChordProgressionTemplate;
+};
+//# sourceMappingURL=pop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pop.d.ts","sourceRoot":"","sources":["../../../../src/src/data/chord-progressions/pop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AA0C/E,eAAO,MAAM,4BAA4B;;;CAG/B,CAAC"}

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

@@ -0,0 +1,42 @@
+const dooWop = {
+    templateType: "loop",
+    category: "pop",
+    primaryName: "I vi IV V",
+    names: ["I vi IV V", "Doo Wop", "1 6 4 5", "50s Progression"],
+    type: ["pop", "loop", "major key", "songwriting", "beginner"],
+    characteristics: ["nostalgic", "stable", "songwriting", "common"],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "6", quality: "m" },
+                { interval: "4", quality: "M" },
+                { interval: "5", quality: "M" },
+            ],
+        },
+    ],
+};
+const axisProgression = {
+    templateType: "loop",
+    category: "pop",
+    primaryName: "I V vi IV",
+    names: ["I V vi IV", "Axis Progression", "1 5 6 4", "Pop Punk Progression"],
+    type: ["pop", "loop", "major key", "songwriting", "beginner"],
+    characteristics: ["anthemic", "common", "songwriting", "stable"],
+    sections: [
+        {
+            name: "Main",
+            chords: [
+                { interval: "1", quality: "M" },
+                { interval: "5", quality: "M" },
+                { interval: "6", quality: "m" },
+                { interval: "4", quality: "M" },
+            ],
+        },
+    ],
+};
+export const popChordProgressionTemplates = {
+    dooWop,
+    axisProgression,
+};

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

@@ -1,4 +1,28 @@
-import type { LowerCaseRomanNumeral, SeventhChord, Triad, UpperCaseRomanNumeral } from "../../types/chords";
+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"];
+declare const _lowerCaseRomanNumerals: readonly ["i", "ii", "iii", "iv", "v", "vi", "vii"];
+export type Triad = (typeof _triadChordQualities)[number];
+export type SeventhChord = (typeof _seventhChordQualities)[number];
+export type ChordQuality = Triad | SeventhChord;
+export type UpperCaseRomanNumeral = (typeof _upperCaseRomanNumerals)[number];
+export type LowerCaseRomanNumeral = (typeof _lowerCaseRomanNumerals)[number];
+export type RomanNumeral = UpperCaseRomanNumeral | LowerCaseRomanNumeral;
+export type RomanTriad = `${RomanNumeral}` | `${RomanNumeral}${Triad}`;
+export type RomanSeventhChord = `${RomanNumeral}${SeventhChord}`;
+export type RomanNumeralCase = "upper" | "lower";
+export interface ChordQualityRomanRendering {
+    readonly numeralCase: RomanNumeralCase;
+    readonly suffix: string;
+}
+/** The complete set of supported triad chord qualities. */
+export declare const triadChordQualities: readonly Triad[];
+/** The complete set of supported seventh chord qualities. */
+export declare const seventhChordQualities: readonly SeventhChord[];
+/** The complete set of supported chord suffix qualities. */
+export declare const chordQualities: readonly ChordQuality[];
+/** 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. */
 export declare const diatonicTriads: Triad[];
 /** An ordered array containing the fundamental seventh-chord qualities of the diatonic major scale. */
@@ -12,7 +36,8 @@ export declare const melodicMinorTriads: Triad[];
 /** An ordered array containing the fundamental seventh-chord qualities of the melodic minor scale. */
 export declare const melodicMinorSeventhChords: SeventhChord[];
 /** An array mapping 7 index scale degrees to their corresponding upper-case Roman numerals. */
-export declare const upperCaseRomanNumerals: UpperCaseRomanNumeral[];
+export declare const upperCaseRomanNumerals: readonly UpperCaseRomanNumeral[];
 /** An array mapping 7 index scale degrees to their corresponding lower-case Roman numerals. */
-export declare const lowerCaseRomanNumerals: LowerCaseRomanNumeral[];
+export declare const lowerCaseRomanNumerals: readonly LowerCaseRomanNumeral[];
+export {};
 //# sourceMappingURL=mod.d.ts.map