@musodojo/music-theory-data 14.0.0

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

@@ -0,0 +1,74 @@
+import { diatonicModes } from "./diatonic-modes.ts";
+import { harmonicMinorModes } from "./harmonic-minor-modes.ts";
+import { melodicMinorModes } from "./melodic-minor-modes.ts";
+import { dominantVariants } from "./dominant-variants.ts";
+import { majorVariants } from "./major-variants.ts";
+import { otherNoteCollections } from "./other-collections.ts";
+
+export { diatonicModes } from "./diatonic-modes.ts";
+export { dominantVariants } from "./dominant-variants.ts";
+export { harmonicMinorModes } from "./harmonic-minor-modes.ts";
+export { majorVariants } from "./major-variants.ts";
+export { melodicMinorModes } from "./melodic-minor-modes.ts";
+export { otherNoteCollections } from "./other-collections.ts";
+
+export const noteCollections = {
+  ...diatonicModes,
+  ...harmonicMinorModes,
+  ...melodicMinorModes,
+  ...dominantVariants,
+  ...majorVariants,
+  ...otherNoteCollections,
+} as const;
+
+export type NoteCollectionKey = keyof typeof noteCollections;
+
+export const groupedNoteCollections = {
+  diatonicModes,
+  harmonicMinorModes,
+  melodicMinorModes,
+  dominantVariants,
+  majorVariants,
+  otherNoteCollections,
+} as const;
+
+export type NoteCollectionGroupKey = keyof typeof groupedNoteCollections;
+
+export const noteCollectionGroupsMetadata: Record<
+  NoteCollectionGroupKey,
+  {
+    displayName: string;
+    description: string;
+  }
+> = {
+  diatonicModes: {
+    displayName: "Diatonic Modes",
+    description:
+      "Traditional seven-note scales derived from the major scale, each starting on a different scale degree.",
+  },
+  harmonicMinorModes: {
+    displayName: "Harmonic Minor Modes",
+    description:
+      "Seven-note scales derived from the harmonic minor scale, each starting on a different scale degree.",
+  },
+  melodicMinorModes: {
+    displayName: "Melodic Minor Modes",
+    description:
+      "Seven-note scales derived from the melodic minor scale, each starting on a different scale degree.",
+  },
+  dominantVariants: {
+    displayName: "Dominant Variants",
+    description:
+      "Chord structures based on the dominant seventh chord, including extended harmonies (9ths, 11ths, 13ths).",
+  },
+  majorVariants: {
+    displayName: "Major Variants",
+    description:
+      "Chord structures based on the major triad, including sixth and major seventh harmonies.",
+  },
+  otherNoteCollections: {
+    displayName: "Other",
+    description:
+      "Other note collections that don't fall into a specific category.",
+  },
+} as const;

package/src/data/note-collections/other-collections.ts

@@ -0,0 +1,76 @@
+import type { NoteCollection } from "../../types/note-collections.d.ts";
+const chromatic: NoteCollection = {
+  primaryName: "Chromatic",
+  names: ["Chromatic", "Twelve-Tone Scale"],
+  intervals: [
+    "1",
+    "♭2",
+    "2",
+    "♭3",
+    "3",
+    "4",
+    "♭5",
+    "5",
+    "♭6",
+    "6",
+    "♭7",
+    "7",
+    "8",
+  ],
+  integers: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
+  type: ["chromatic", "scale", "non-diatonic", "dodecaphonic"],
+  characteristics: [
+    "atonal",
+    "dissonant",
+    "no tonal center",
+    "contains all 12 pitches",
+    "used for passing tones and creating tension",
+  ],
+  pattern: [
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+    "half",
+  ],
+  patternShort: ["H", "H", "H", "H", "H", "H", "H", "H", "H", "H", "H"],
+} as const;
+
+const wholeTone: NoteCollection = {
+  primaryName: "Whole Tone Scale",
+  names: [
+    "Whole Tone Scale",
+  ],
+  intervals: ["1", "2", "3", "♯4", "♯5", "♯6", "8"],
+  integers: [0, 2, 4, 6, 8, 10],
+  type: ["whole tone", "scale", "symmetrical", "hexatonic"],
+  characteristics: [
+    "six pitches in an octave",
+    "no tonal center",
+    "no leading tone and because all tones are the same distance apart",
+    "used in impressionistic music",
+    "creates a dreamy or ethereal sound",
+    "often used in film scores",
+    "associated with composers like Debussy and Ravel",
+  ],
+  pattern: ["whole", "whole", "whole", "whole", "whole"],
+  patternShort: ["W", "W", "W", "W", "W"],
+} as const;
+
+export const _otherNoteCollections = {
+  chromatic,
+  wholeTone,
+} as const;
+
+export type OtherNoteCollectionKey = keyof typeof _otherNoteCollections;
+
+export const otherNoteCollections: Record<
+  OtherNoteCollectionKey,
+  NoteCollection
+> = _otherNoteCollections;

package/src/data/note-collections/todo.txt

@@ -0,0 +1,265 @@
+// MINOR VARIANTS
+export default [
+  {
+    name: "m / Minor",
+    category: "Minor",
+    sequence: [0, 3, 7],
+  },
+  {
+    name: "m6 / Minor  Major 6th",
+    category: "Minor",
+    sequence: [0, 3, 7, 9],
+  },
+  {
+    name: "m7 / Minor 7th",
+    category: "Minor",
+    sequence: [0, 3, 7, 10],
+  },
+  {
+    name: "m9 / Minor 9th",
+    category: "Minor",
+    sequence: [0, 2, 3, 7, 10],
+    labels: {
+      Quality: { 2: "M9" },
+      Relative: { 2: "9" },
+    },
+  },
+  {
+    name: "m(add9) / Minor add 9",
+    category: "Minor",
+    sequence: [0, 2, 3, 7],
+    labels: {
+      Quality: { 2: "M9" },
+      Relative: { 2: "9" },
+    },
+  },
+  {
+    name: "m6/9 / Minor 6/9",
+    category: "Minor",
+    sequence: [0, 2, 3, 7, 9],
+    labels: {
+      Quality: { 2: "M9" },
+      Relative: { 2: "9" },
+    },
+  },
+];
+
+
+// PENTATONIC
+export default [
+  {
+    name: "Major Pentatonic",
+    category: "Pentatonic",
+    sequence: [0, 2, 4, 7, 9],
+  },
+  {
+    name: "Suspended Pentatonic",
+    category: "Pentatonic",
+    sequence: [0, 2, 5, 7, 10],
+  },
+  {
+    name: "Blues Minor Pentatonic",
+    category: "Pentatonic",
+    sequence: [0, 3, 5, 8, 10],
+  },
+  {
+    name: "Blues Major Pentatonic",
+    category: "Pentatonic",
+    sequence: [0, 2, 5, 7, 9],
+  },
+  {
+    name: "Minor Pentatonic",
+    category: "Pentatonic",
+    sequence: [0, 3, 5, 7, 10],
+  },
+  {
+    name: "Dominant Pentatonic",
+    category: "Pentatonic",
+    sequence: [0, 2, 4, 7, 10],
+  },
+];
+
+
+// OTHER
+export default [
+  // Diminished
+  {
+    name: "dim / o / Diminished Triad",
+    category: "Diminished",
+    sequence: [0, 3, 6],
+  },
+  {
+    name: "dim7 / o7 / Diminished 7th",
+    category: "Diminished",
+    sequence: [0, 3, 6, 9],
+    labels: {
+      Quality: { 9: "d7" },
+      Relative: { 9: "♭♭7" },
+      Extension: { 9: "♭♭7" },
+    },
+  },
+  {
+    name: "m7♭5 / ø7 / Half Diminished 7th",
+    category: "Diminished",
+    sequence: [0, 3, 6, 10],
+  },
+  {
+    name: "Whole Half Diminished",
+    category: "Diminished",
+    sequence: [0, 2, 3, 5, 6, 8, 9, 11],
+    labels: {
+      Quality: { 8: "A5" },
+      Relative: { 8: "♯5" },
+      Extension: { 8: "♯5" },
+    },
+  },
+  {
+    name: "Half Whole / Dominant Diminished",
+    category: "Diminished",
+    sequence: [0, 1, 3, 4, 6, 7, 9, 10],
+    labels: {
+      Quality: { 3: "A2", 6: "A4" },
+      Relative: { 3: "♯2", 6: "♯4" },
+      Extension: { 3: "♯9", 6: "♯11" },
+    },
+  },
+  // Augmented
+  {
+    name: "aug / + / Augmented Triad",
+    category: "Augmented",
+    sequence: [0, 4, 8],
+    labels: {
+      Quality: { 8: "A5" },
+      Relative: { 8: "♯5" },
+      Extension: { 8: "♯5" },
+    },
+  },
+  {
+    name: "It+6 / Italian 6th",
+    category: "Augmented",
+    sequence: [0, 4, 10],
+    labels: {
+      Quality: { 10: "A6" },
+      Relative: { 10: "♯6" },
+      Extension: { 10: "♯13" },
+    },
+  },
+  {
+    name: "Fr+6 / French 6th",
+    category: "Augmented",
+    sequence: [0, 4, 6, 10],
+    labels: {
+      Quality: { 10: "A6" },
+      Relative: { 10: "♯6" },
+      Extension: { 10: "♯13" },
+    },
+  },
+  {
+    name: "Ger+6 / German 6th",
+    category: "Augmented",
+    sequence: [0, 4, 7, 10],
+    labels: {
+      Quality: { 10: "A6" },
+      Relative: { 10: "♯6" },
+      Extension: { 10: "♯13" },
+    },
+  },
+  {
+    name: "aug7 / +7 / 7♯5 / Augmented Seventh",
+    category: "Augmented",
+    sequence: [0, 4, 8, 10],
+    labels: {
+      Quality: { 8: "A5" },
+      Relative: { 8: "♯5" },
+      Extension: { 8: "♯5" },
+    },
+  },
+
+  // Harmonic Minor
+  {
+    name: "Harmonic Minor",
+    category: "Harmonic Minor",
+    sequence: [0, 2, 3, 5, 7, 8, 11],
+  },
+  {
+    name: "Locrian ♯6",
+    category: "Harmonic Minor",
+    sequence: [0, 1, 3, 5, 6, 9, 10],
+  },
+  {
+    name: "Ionian ♯5",
+    category: "Harmonic Minor",
+    sequence: [0, 2, 4, 5, 8, 9, 11],
+    labels: {
+      Quality: { 8: "A5" },
+      Relative: { 8: "♯5" },
+      Extension: { 8: "♯5" },
+    },
+  },
+  {
+    name: "Dorian ♯4",
+    category: "Harmonic Minor",
+    sequence: [0, 2, 3, 6, 7, 9, 10],
+    labels: {
+      Quality: { 6: "A4" },
+      Relative: { 6: "♯4" },
+      Extension: { 6: "♯11" },
+    },
+  },
+  {
+    name: "Phrygian Dominant",
+    category: "Harmonic Minor",
+    sequence: [0, 1, 4, 5, 7, 8, 10],
+  },
+  {
+    name: "Lydian ♯2",
+    category: "Harmonic Minor",
+    sequence: [0, 3, 4, 6, 7, 9, 11],
+    labels: {
+      Quality: { 3: "A2", 6: "A4" },
+      Relative: { 3: "♯2", 6: "♯4" },
+      Extension: { 3: "♯9", 6: "♯11" },
+    },
+  },
+  {
+    name: "Super Locrian ♭♭7",
+    category: "Harmonic Minor",
+    sequence: [0, 1, 3, 4, 6, 8, 9],
+    labels: {
+      Quality: { 4: "d4", 9: "d7" },
+      Relative: { 4: "♭4", 9: "♭♭7" },
+      Extension: { 4: "♭11", 9: "♭♭7" },
+    },
+  },
+  // Other
+  {
+    name: "R / Root",
+    category: "Other",
+    sequence: [0],
+  },
+  {
+    name: "Chromatic",
+    category: "Other",
+    sequence: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11],
+  },
+  {
+    name: "Blank",
+    category: "Other",
+    sequence: [],
+  },
+  {
+    name: "Root and 5th",
+    category: "Other",
+    sequence: [0, 7],
+  },
+  {
+    name: "Blues",
+    category: "Other",
+    sequence: [0, 3, 5, 6, 7, 10],
+  },
+  {
+    name: "Whole Tone",
+    category: "Other",
+    sequence: [0, 2, 4, 6, 8, 10],
+  },
+];

package/src/mod.ts

@@ -0,0 +1,24 @@
+/**
+ * A comprehensive library of music theory data, including scales, chords, and notes.
+ *
+ * This package provides a collection of datasets and utility functions
+ * to work with fundamental concepts of music theory. It's designed to be
+ * a foundational block for music-related applications, educational tools,
+ * and creative coding projects.
+ *
+ * @module
+ * @example
+ * ```ts
+ * // Import the entire library
+ * import * as music_theory_data from "jsr:@musodojo/music-theory-data";
+ *
+ * // You can now access all the data and functions.
+ * // The details for the Ionian Diatonic Mode (Major Scale).
+ * console.log("ionian details: ", music_theory_data.noteCollections.ionian);
+ * // Get the notes of a stored chord, or scale.
+ * console.log("A harmonic minor: ", music_theory_data.getNoteNamesFromRootAndCollectionKey("A", "harmonicMinor"))
+ * ```
+ */
+export * from "./data/mod.ts";
+export type * from "./types/mod.d.ts";
+export * from "./utils/mod.ts";

package/src/types/chords.d.ts

@@ -0,0 +1,48 @@
+import type { Interval } from "../data/labels/note-labels.ts";
+
+export type Triad = "M" | "m" | "°" | "+";
+
+export type SeventhChord =
+  | "M7"
+  | "m7"
+  | "7"
+  | "ø7"
+  | "m7♭5"
+  | "°7"
+  | "m(M7)"
+  | "+M7"
+  | "M7♯5";
+
+export type UpperCaseRomanNumeral =
+  | "I"
+  | "II"
+  | "III"
+  | "IV"
+  | "V"
+  | "VI"
+  | "VII";
+
+export type LowerCaseRomanNumeral =
+  | "i"
+  | "ii"
+  | "iii"
+  | "iv"
+  | "v"
+  | "vi"
+  | "vii";
+
+export type RomanNumeral = UpperCaseRomanNumeral | LowerCaseRomanNumeral;
+
+export type RomanTriad =
+  | `${RomanNumeral}`
+  | `${RomanNumeral}${Triad}`;
+
+export type RomanSeventhChord = `${RomanNumeral}${SeventhChord}`;
+
+export interface ChordDetails {
+  interval: Interval;
+  triad: Triad;
+  seventh: SeventhChord;
+  romanTriad: RomanTriad;
+  romanSeventhChord: RomanSeventhChord;
+}

package/src/types/midi.d.ts

@@ -0,0 +1,133 @@
+export type OctaveNumber = -1 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9;
+
+export type MidiNoteNumber =
+  | 0
+  | 1
+  | 2
+  | 3
+  | 4
+  | 5
+  | 6
+  | 7
+  | 8
+  | 9
+  | 10
+  | 11
+  | 12
+  | 13
+  | 14
+  | 15
+  | 16
+  | 17
+  | 18
+  | 19
+  | 20
+  | 21
+  | 22
+  | 23
+  | 24
+  | 25
+  | 26
+  | 27
+  | 28
+  | 29
+  | 30
+  | 31
+  | 32
+  | 33
+  | 34
+  | 35
+  | 36
+  | 37
+  | 38
+  | 39
+  | 40
+  | 41
+  | 42
+  | 43
+  | 44
+  | 45
+  | 46
+  | 47
+  | 48
+  | 49
+  | 50
+  | 51
+  | 52
+  | 53
+  | 54
+  | 55
+  | 56
+  | 57
+  | 58
+  | 59
+  | 60
+  | 61
+  | 62
+  | 63
+  | 64
+  | 65
+  | 66
+  | 67
+  | 68
+  | 69
+  | 70
+  | 71
+  | 72
+  | 73
+  | 74
+  | 75
+  | 76
+  | 77
+  | 78
+  | 79
+  | 80
+  | 81
+  | 82
+  | 83
+  | 84
+  | 85
+  | 86
+  | 87
+  | 88
+  | 89
+  | 90
+  | 91
+  | 92
+  | 93
+  | 94
+  | 95
+  | 96
+  | 97
+  | 98
+  | 99
+  | 100
+  | 101
+  | 102
+  | 103
+  | 104
+  | 105
+  | 106
+  | 107
+  | 108
+  | 109
+  | 110
+  | 111
+  | 112
+  | 113
+  | 114
+  | 115
+  | 116
+  | 117
+  | 118
+  | 119
+  | 120
+  | 121
+  | 122
+  | 123
+  | 124
+  | 125
+  | 126
+  | 127;
+
+export type MidiNoteSequence = (MidiNoteNumber | null)[];

package/src/types/mod.d.ts

@@ -0,0 +1,3 @@
+export type * from "./chords.d.ts";
+export type * from "./midi.d.ts";
+export type * from "./note-collections.d.ts";

package/src/types/note-collections.d.ts

@@ -0,0 +1,13 @@
+import type { Interval, NoteInteger } from "../data/labels/note-labels.ts";
+
+export interface NoteCollection {
+  readonly primaryName: string;
+  readonly names: readonly string[];
+  readonly intervals: readonly Interval[];
+  readonly integers: readonly NoteInteger[];
+  readonly rotation?: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+  readonly type: readonly string[];
+  readonly characteristics: readonly string[];
+  readonly pattern: readonly string[];
+  readonly patternShort: readonly string[];
+}