@pepperhorn/chordl-core 0.3.0

package/dist/resolver/scale-resolver.d.ts

@@ -0,0 +1,9 @@
+export interface ResolvedScale {
+    /** Pitch classes for the full multi-octave display (includes final tonic). */
+    notes: string[];
+    root: string;
+    type: string;
+    /** Single-octave Tonal intervals (e.g. ["1P","2M","3M","4P","5P","6M","7M"]). */
+    intervals: string[];
+}
+export declare function resolveScale(root: string, scaleType: string, direction?: "ascending" | "descending", octaves?: number): ResolvedScale;

package/dist/resolver/scale-resolver.js

@@ -0,0 +1,45 @@
+/**
+ * Scale resolver — resolves scale names to notes via Tonal.
+ * Handles melodic minor direction, multi-octave expansion, and
+ * generates Tonal interval arrays for degree label computation.
+ */
+import { Scale } from "tonal";
+/** Normalize common scale name variants for Tonal compatibility. */
+const SCALE_NAME_MAP = {
+    "natural minor": "minor",
+    "minor harmonic": "harmonic minor",
+    "minor melodic": "melodic minor",
+    "major pentatonic": "major pentatonic",
+    "minor pentatonic": "minor pentatonic",
+    "whole tone": "whole tone",
+    "bebop": "bebop major",
+};
+export function resolveScale(root, scaleType, direction, octaves = 1) {
+    // Melodic minor descending = natural minor
+    let effectiveType = scaleType;
+    if (scaleType === "melodic minor" && direction === "descending") {
+        effectiveType = "minor";
+    }
+    // Apply name normalization
+    const tonalName = SCALE_NAME_MAP[effectiveType] ?? effectiveType;
+    const scale = Scale.get(`${root} ${tonalName}`);
+    if (scale.empty) {
+        throw new Error(`Unknown scale: "${root} ${scaleType}"`);
+    }
+    const oneOctaveNotes = scale.notes;
+    const intervals = scale.intervals;
+    // Expand across octaves: repeat pitch classes + add final tonic
+    const notes = [];
+    for (let oct = 0; oct < octaves; oct++) {
+        notes.push(...oneOctaveNotes);
+    }
+    // Add the final tonic to complete the last octave
+    notes.push(oneOctaveNotes[0]);
+    return {
+        notes,
+        root,
+        type: scaleType,
+        intervals,
+    };
+}
+//# sourceMappingURL=scale-resolver.js.map

package/dist/resolver/scale-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-resolver.js","sourceRoot":"","sources":["../../src/resolver/scale-resolver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAW9B,oEAAoE;AACpE,MAAM,cAAc,GAA2B;IAC7C,eAAe,EAAE,OAAO;IACxB,gBAAgB,EAAE,gBAAgB;IAClC,eAAe,EAAE,eAAe;IAChC,kBAAkB,EAAE,kBAAkB;IACtC,kBAAkB,EAAE,kBAAkB;IACtC,YAAY,EAAE,YAAY;IAC1B,OAAO,EAAE,aAAa;CACvB,CAAC;AAEF,MAAM,UAAU,YAAY,CAC1B,IAAY,EACZ,SAAiB,EACjB,SAAsC,EACtC,UAAkB,CAAC;IAEnB,2CAA2C;IAC3C,IAAI,aAAa,GAAG,SAAS,CAAC;IAC9B,IAAI,SAAS,KAAK,eAAe,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAChE,aAAa,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,2BAA2B;IAC3B,MAAM,SAAS,GAAG,cAAc,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC;IAEjE,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,SAAS,EAAE,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,IAAI,SAAS,GAAG,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC;IACnC,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;IAElC,gEAAgE;IAChE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QACvC,KAAK,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,CAAC;IAChC,CAAC;IACD,kDAAkD;IAClD,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAE9B,OAAO;QACL,KAAK;QACL,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/themes/boomwhacker.d.ts

@@ -0,0 +1,2 @@
+import type { ColorTheme } from "../types";
+export declare const boomwhackerTheme: ColorTheme;

package/dist/themes/boomwhacker.js

@@ -0,0 +1,35 @@
+import { DEFAULT_WHITE_FILL, DEFAULT_BLACK_FILL } from "../engine/svg-constants";
+// Boomwhacker chromatic pitch-class colors
+const PITCH_COLORS = {
+    C: "#e81c1c",
+    "C#": "#d44a1a",
+    D: "#f09819",
+    "D#": "#c8b816",
+    E: "#f5e616",
+    F: "#59b816",
+    "F#": "#16a085",
+    G: "#16a3b8",
+    "G#": "#1670b8",
+    A: "#5b16b8",
+    "A#": "#8b16b8",
+    B: "#b816a0",
+};
+// Muted versions for non-highlighted keys
+const MUTED_ALPHA = "33"; // ~20% opacity in hex
+function mute(hex) {
+    return hex + MUTED_ALPHA;
+}
+export const boomwhackerTheme = {
+    name: "boomwhacker",
+    whiteKey: (note, highlighted) => {
+        if (!highlighted)
+            return DEFAULT_WHITE_FILL;
+        return PITCH_COLORS[note] ?? DEFAULT_WHITE_FILL;
+    },
+    blackKey: (note, highlighted) => {
+        if (!highlighted)
+            return DEFAULT_BLACK_FILL;
+        return PITCH_COLORS[note] ?? DEFAULT_BLACK_FILL;
+    },
+};
+//# sourceMappingURL=boomwhacker.js.map

package/dist/themes/boomwhacker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boomwhacker.js","sourceRoot":"","sources":["../../src/themes/boomwhacker.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,2CAA2C;AAC3C,MAAM,YAAY,GAA2B;IAC3C,CAAC,EAAE,SAAS;IACZ,IAAI,EAAE,SAAS;IACf,CAAC,EAAE,SAAS;IACZ,IAAI,EAAE,SAAS;IACf,CAAC,EAAE,SAAS;IACZ,CAAC,EAAE,SAAS;IACZ,IAAI,EAAE,SAAS;IACf,CAAC,EAAE,SAAS;IACZ,IAAI,EAAE,SAAS;IACf,CAAC,EAAE,SAAS;IACZ,IAAI,EAAE,SAAS;IACf,CAAC,EAAE,SAAS;CACb,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,GAAG,IAAI,CAAC,CAAC,sBAAsB;AAEhD,SAAS,IAAI,CAAC,GAAW;IACvB,OAAO,GAAG,GAAG,WAAW,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAe;IAC1C,IAAI,EAAE,aAAa;IACnB,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;QAC9B,IAAI,CAAC,WAAW;YAAE,OAAO,kBAAkB,CAAC;QAC5C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC;IAClD,CAAC;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;QAC9B,IAAI,CAAC,WAAW;YAAE,OAAO,kBAAkB,CAAC;QAC5C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC;IAClD,CAAC;CACF,CAAC"}

package/dist/themes/crf.d.ts

@@ -0,0 +1,19 @@
+import type { ColorTheme } from "../types";
+/**
+ * Creative Ranges Foundation piano keyboard colors.
+ *
+ * Each pitch has a screen color (hex/sRGB) for SVG rendering and a CMYK
+ * reference for print pipelines. The hex values are derived from the CMYK
+ * spec, so SVGs render true to the print intent — but if a downstream tool
+ * needs CMYK directly (Illustrator, InDesign, PDF/X export), use
+ * `CRF_PITCH_PALETTE[note].cmyk` rather than re-converting from hex.
+ */
+export interface CrfPitchEntry {
+    hex: string;
+    /** [C, M, Y, K] in 0–100. */
+    cmyk: [number, number, number, number];
+}
+export declare const CRF_PITCH_PALETTE: Record<string, CrfPitchEntry>;
+/** Format a CMYK tuple as a CSS-style string for metadata (`"cmyk(0%, 56%, 56%, 3%)"`). */
+export declare function formatCmyk(cmyk: [number, number, number, number]): string;
+export declare const crfTheme: ColorTheme;

package/dist/themes/crf.js

@@ -0,0 +1,34 @@
+import { DEFAULT_WHITE_FILL, DEFAULT_BLACK_FILL } from "../engine/svg-constants";
+export const CRF_PITCH_PALETTE = {
+    C: { hex: "#f86e6e", cmyk: [0, 56, 56, 3] },
+    "C#": { hex: "#f58841", cmyk: [0, 44, 73, 4] },
+    D: { hex: "#ffbc57", cmyk: [0, 26, 66, 0] },
+    "D#": { hex: "#b8a334", cmyk: [0, 11, 72, 28] },
+    E: { hex: "#fff56d", cmyk: [0, 4, 57, 0] },
+    F: { hex: "#b3f888", cmyk: [28, 0, 45, 3] },
+    "F#": { hex: "#93d154", cmyk: [30, 0, 60, 18] },
+    G: { hex: "#6bc6a0", cmyk: [46, 0, 19, 22] },
+    "G#": { hex: "#7ee8df", cmyk: [46, 0, 4, 9] },
+    A: { hex: "#88a7f8", cmyk: [45, 33, 0, 3] },
+    "A#": { hex: "#cc97e8", cmyk: [12, 35, 0, 9] },
+    B: { hex: "#e277b1", cmyk: [0, 47, 22, 11] },
+};
+/** Format a CMYK tuple as a CSS-style string for metadata (`"cmyk(0%, 56%, 56%, 3%)"`). */
+export function formatCmyk(cmyk) {
+    const [c, m, y, k] = cmyk;
+    return `cmyk(${c}%, ${m}%, ${y}%, ${k}%)`;
+}
+export const crfTheme = {
+    name: "crf",
+    whiteKey: (note, highlighted) => {
+        if (!highlighted)
+            return DEFAULT_WHITE_FILL;
+        return CRF_PITCH_PALETTE[note]?.hex ?? DEFAULT_WHITE_FILL;
+    },
+    blackKey: (note, highlighted) => {
+        if (!highlighted)
+            return DEFAULT_BLACK_FILL;
+        return CRF_PITCH_PALETTE[note]?.hex ?? DEFAULT_BLACK_FILL;
+    },
+};
+//# sourceMappingURL=crf.js.map

package/dist/themes/crf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crf.js","sourceRoot":"","sources":["../../src/themes/crf.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAiBjF,MAAM,CAAC,MAAM,iBAAiB,GAAkC;IAC9D,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;IAC9C,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;IAC9C,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;IAC9C,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;IAC/C,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;IAC7C,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE;IAC9C,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;IAC/C,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;IAC/C,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC7C,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC9C,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE;IAC9C,CAAC,EAAK,EAAE,GAAG,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE;CAChD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,UAAU,UAAU,CAAC,IAAsC;IAC/D,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1B,OAAO,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,QAAQ,GAAe;IAClC,IAAI,EAAE,KAAK;IACX,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;QAC9B,IAAI,CAAC,WAAW;YAAE,OAAO,kBAAkB,CAAC;QAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,kBAAkB,CAAC;IAC5D,CAAC;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;QAC9B,IAAI,CAAC,WAAW;YAAE,OAAO,kBAAkB,CAAC;QAC5C,OAAO,iBAAiB,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,kBAAkB,CAAC;IAC5D,CAAC;CACF,CAAC"}

package/dist/themes/index.d.ts

@@ -0,0 +1,3 @@
+import type { ColorTheme } from "../types";
+export declare function getTheme(name: string): ColorTheme | undefined;
+export declare function resolveTheme(theme: ColorTheme | string | undefined, highlightColor?: string): ColorTheme | undefined;

package/dist/themes/index.js

@@ -0,0 +1,25 @@
+import { boomwhackerTheme } from "./boomwhacker";
+import { crfTheme } from "./crf";
+import { createSimpleTheme } from "./simple";
+const themeRegistry = {
+    boomwhacker: boomwhackerTheme,
+    crf: crfTheme,
+    simple: createSimpleTheme(),
+};
+export function getTheme(name) {
+    return themeRegistry[name];
+}
+export function resolveTheme(theme, highlightColor) {
+    if (!theme && !highlightColor)
+        return undefined;
+    if (!theme && highlightColor)
+        return createSimpleTheme(highlightColor);
+    if (typeof theme === "string") {
+        if (theme === "simple" && highlightColor) {
+            return createSimpleTheme(highlightColor);
+        }
+        return themeRegistry[theme];
+    }
+    return theme;
+}
+//# sourceMappingURL=index.js.map

package/dist/themes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/themes/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE7C,MAAM,aAAa,GAA+B;IAChD,WAAW,EAAE,gBAAgB;IAC7B,GAAG,EAAE,QAAQ;IACb,MAAM,EAAE,iBAAiB,EAAE;CAC5B,CAAC;AAEF,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,KAAsC,EACtC,cAAuB;IAEvB,IAAI,CAAC,KAAK,IAAI,CAAC,cAAc;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,CAAC,KAAK,IAAI,cAAc;QAAE,OAAO,iBAAiB,CAAC,cAAc,CAAC,CAAC;IACvE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,IAAI,KAAK,KAAK,QAAQ,IAAI,cAAc,EAAE,CAAC;YACzC,OAAO,iBAAiB,CAAC,cAAc,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/themes/simple.d.ts

@@ -0,0 +1,2 @@
+import type { ColorTheme } from "../types";
+export declare function createSimpleTheme(highlightColor?: string): ColorTheme;

package/dist/themes/simple.js

@@ -0,0 +1,13 @@
+import { DEFAULT_WHITE_FILL, DEFAULT_BLACK_FILL } from "../engine/svg-constants";
+const DEFAULT_HIGHLIGHT = "#a0c6e8";
+const DEFAULT_BLACK_HIGHLIGHT = "#5a8ab5";
+export function createSimpleTheme(highlightColor) {
+    const whiteHighlight = highlightColor ?? DEFAULT_HIGHLIGHT;
+    const blackHighlight = highlightColor ?? DEFAULT_BLACK_HIGHLIGHT;
+    return {
+        name: "simple",
+        whiteKey: (_note, highlighted) => highlighted ? whiteHighlight : DEFAULT_WHITE_FILL,
+        blackKey: (_note, highlighted) => highlighted ? blackHighlight : DEFAULT_BLACK_FILL,
+    };
+}
+//# sourceMappingURL=simple.js.map

package/dist/themes/simple.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"simple.js","sourceRoot":"","sources":["../../src/themes/simple.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAEjF,MAAM,iBAAiB,GAAG,SAAS,CAAC;AACpC,MAAM,uBAAuB,GAAG,SAAS,CAAC;AAE1C,MAAM,UAAU,iBAAiB,CAAC,cAAuB;IACvD,MAAM,cAAc,GAAG,cAAc,IAAI,iBAAiB,CAAC;IAC3D,MAAM,cAAc,GAAG,cAAc,IAAI,uBAAuB,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAC/B,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,kBAAkB;QACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,EAAE,CAC/B,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,kBAAkB;KACpD,CAAC;AACJ,CAAC"}

package/dist/theory/chord-tones.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Chord tone classification engine.
+ *
+ * Classifies each note in a chord by its functional role:
+ * - identity: defines the chord (3rd, 7th, altered tensions) — never drop
+ * - color: adds character (natural 9th, 13th) — drop last
+ * - foundation: structural (root) — drop when bass covers it
+ * - omittable: standard to omit (perfect 5th, natural 11th) — drop first
+ *
+ * Inspired by Mark Levine's "The Jazz Piano Book" approach to voicing.
+ */
+export type ChordToneRole = "identity" | "color" | "foundation" | "omittable";
+export interface ChordTone {
+    note: string;
+    interval: string;
+    degree: number;
+    quality: string;
+    role: ChordToneRole;
+}
+export interface ChordToneAnalysis {
+    root: string;
+    type: string;
+    tones: ChordTone[];
+    /** Notes that define the chord — never drop */
+    identityTones: string[];
+    /** Smallest set that still communicates the chord */
+    minVoicing: string[];
+    /** Notes ordered safe-to-drop-first → never-drop-last */
+    dropOrder: string[];
+}
+/**
+ * Parse a Tonal interval string like "3M", "5d", "9A", "1P".
+ * Format: degree number + quality letter(s).
+ */
+export declare function parseInterval(interval: string): {
+    degree: number;
+    quality: string;
+};
+/**
+ * Classify each tone in a chord by its functional role.
+ *
+ * @param root - Root note ("C", "Bb", etc.)
+ * @param chordType - Tonal chord type string ("major seventh", "dominant sharp ninth")
+ * @param intervals - Tonal interval names (["1P", "3M", "5P", "7M"])
+ * @param notes - Pitch classes matching intervals (["C", "E", "G", "B"])
+ * @param instrument - "piano" (default) or "guitar" — shifts role assignments
+ */
+export declare function classifyTones(root: string, chordType: string, intervals: string[], notes: string[], instrument?: "piano" | "guitar"): ChordToneAnalysis;
+/**
+ * Get the minimal voicing — the fewest notes that still communicate the chord.
+ */
+export declare function minimalVoicing(analysis: ChordToneAnalysis): string[];
+/**
+ * Get notes in order of safe-to-drop (first = safest to drop).
+ */
+export declare function dropOrder(analysis: ChordToneAnalysis): string[];

package/dist/theory/chord-tones.js

@@ -0,0 +1,215 @@
+/**
+ * Chord tone classification engine.
+ *
+ * Classifies each note in a chord by its functional role:
+ * - identity: defines the chord (3rd, 7th, altered tensions) — never drop
+ * - color: adds character (natural 9th, 13th) — drop last
+ * - foundation: structural (root) — drop when bass covers it
+ * - omittable: standard to omit (perfect 5th, natural 11th) — drop first
+ *
+ * Inspired by Mark Levine's "The Jazz Piano Book" approach to voicing.
+ */
+// ── Interval parsing ──────────────────────────────────────────────
+/**
+ * Parse a Tonal interval string like "3M", "5d", "9A", "1P".
+ * Format: degree number + quality letter(s).
+ */
+export function parseInterval(interval) {
+    const match = interval.match(/^(\d+)(.*)/);
+    if (!match)
+        return { degree: 0, quality: "" };
+    return {
+        degree: parseInt(match[1], 10),
+        quality: match[2],
+    };
+}
+/**
+ * Check if an interval is "altered" — i.e., not the natural/default quality
+ * for that scale degree.
+ *
+ * Natural defaults:
+ *   1=P, 2=M, 3=M(maj)/m(min), 4=P, 5=P, 6=M, 7=M(maj)/m(dom/min)
+ *   9=M, 11=P, 13=M
+ *
+ * Anything else (A=augmented, d=diminished, or wrong M/m) is altered.
+ */
+function isAltered(degree, quality) {
+    switch (degree) {
+        case 1: return quality !== "P";
+        case 2:
+        case 9: return quality !== "M";
+        case 3: return quality !== "M" && quality !== "m"; // both are "natural" depending on chord
+        case 4:
+        case 11: return quality !== "P";
+        case 5: return quality !== "P";
+        case 6:
+        case 13: return quality !== "M";
+        case 7: return quality !== "M" && quality !== "m"; // both natural depending on chord
+        default: return false;
+    }
+}
+function classifyQualityFamily(type, intervals) {
+    const t = type.toLowerCase();
+    if (t.includes("alt"))
+        return "alt";
+    if (t.includes("dim") && t.includes("seventh"))
+        return "dim7";
+    if (t.includes("half") || t.includes("m7b5"))
+        return "half-dim";
+    if (t.includes("sus"))
+        return "sus";
+    if (t.includes("sixth") || t.includes("6"))
+        return "sixth";
+    if (/seven|7|ninth|9|eleven|11|thirteen|13/.test(t))
+        return "seventh";
+    // Fallback: infer from intervals when type string is empty/ambiguous
+    if (intervals && intervals.length > 0) {
+        const hasAugOrDimFifth = intervals.some((i) => {
+            const { degree, quality } = parseInterval(i);
+            return degree === 5 && (quality === "A" || quality === "d");
+        });
+        const hasSeventh = intervals.some((i) => parseInterval(i).degree === 7);
+        const hasAlteredExtension = intervals.some((i) => {
+            const { degree, quality } = parseInterval(i);
+            return degree >= 9 && isAltered(degree, quality);
+        });
+        if (hasAlteredExtension && hasAugOrDimFifth)
+            return "alt";
+        if (hasSeventh) {
+            const dimFifth = intervals.some((i) => {
+                const p = parseInterval(i);
+                return p.degree === 5 && p.quality === "d";
+            });
+            const dimSeventh = intervals.some((i) => {
+                const p = parseInterval(i);
+                return p.degree === 7 && p.quality === "d";
+            });
+            if (dimFifth && dimSeventh)
+                return "dim7";
+            if (dimFifth)
+                return "half-dim";
+            return "seventh";
+        }
+    }
+    return "triad";
+}
+// ── Role assignment ───────────────────────────────────────────────
+/**
+ * Assign a role to a chord tone based on its degree, quality, and the
+ * chord's quality family.
+ */
+function assignRole(degree, quality, family, instrument) {
+    const altered = isAltered(degree, quality);
+    switch (degree) {
+        case 1:
+            // Root: foundation in most contexts, omittable in rootless jazz piano
+            if (family === "alt" && instrument === "piano")
+                return "omittable";
+            return "foundation";
+        case 3:
+            // 3rd always defines major/minor quality
+            return "identity";
+        case 4:
+            // sus4: the 4th replaces the 3rd, so it's identity
+            if (family === "sus")
+                return "identity";
+            // #11 is identity (lydian character)
+            if (altered)
+                return "identity";
+            // Natural 11 clashes with major 3rd — omittable
+            return "omittable";
+        case 5:
+            // Perfect 5th is omittable in 7th chords — adds nothing to identity
+            // But altered 5th (b5, #5) IS the identity (dim, aug, m7b5)
+            if (altered)
+                return "identity";
+            if (family === "triad")
+                return instrument === "guitar" ? "omittable" : "identity";
+            return "omittable";
+        case 6:
+            // 6th in sixth chords is identity
+            if (family === "sixth")
+                return "identity";
+            return "color";
+        case 7:
+            // 7th defines the chord in 7th-chord families
+            if (family === "triad")
+                return "color"; // shouldn't normally appear
+            return "identity";
+        case 2:
+        case 9:
+            // Altered 9ths (#9, b9) are identity — they define the chord
+            if (altered)
+                return "identity";
+            return "color";
+        case 11:
+            if (altered)
+                return "identity"; // #11 = lydian
+            return "omittable"; // natural 11 clashes with 3rd
+        case 13:
+            if (altered)
+                return "identity"; // b13 in alt chords
+            return "color";
+        default:
+            return "color";
+    }
+}
+// ── Main classification ───────────────────────────────────────────
+/**
+ * Classify each tone in a chord by its functional role.
+ *
+ * @param root - Root note ("C", "Bb", etc.)
+ * @param chordType - Tonal chord type string ("major seventh", "dominant sharp ninth")
+ * @param intervals - Tonal interval names (["1P", "3M", "5P", "7M"])
+ * @param notes - Pitch classes matching intervals (["C", "E", "G", "B"])
+ * @param instrument - "piano" (default) or "guitar" — shifts role assignments
+ */
+export function classifyTones(root, chordType, intervals, notes, instrument = "piano") {
+    const family = classifyQualityFamily(chordType, intervals);
+    const tones = intervals.map((interval, i) => {
+        const { degree, quality } = parseInterval(interval);
+        const role = assignRole(degree, quality, family, instrument);
+        return {
+            note: notes[i] ?? "",
+            interval,
+            degree,
+            quality,
+            role,
+        };
+    });
+    const identityTones = tones.filter((t) => t.role === "identity").map((t) => t.note);
+    // Minimal voicing: identity tones + foundation (root) for grounding
+    const foundationTones = tones.filter((t) => t.role === "foundation").map((t) => t.note);
+    const minVoicing = [...foundationTones, ...identityTones];
+    // Drop order: omittable first, then color, then foundation, identity last
+    const ROLE_PRIORITY = {
+        omittable: 0,
+        color: 1,
+        foundation: 2,
+        identity: 3,
+    };
+    const dropOrder = [...tones]
+        .sort((a, b) => ROLE_PRIORITY[a.role] - ROLE_PRIORITY[b.role])
+        .map((t) => t.note);
+    return {
+        root,
+        type: chordType,
+        tones,
+        identityTones,
+        minVoicing,
+        dropOrder,
+    };
+}
+/**
+ * Get the minimal voicing — the fewest notes that still communicate the chord.
+ */
+export function minimalVoicing(analysis) {
+    return analysis.minVoicing;
+}
+/**
+ * Get notes in order of safe-to-drop (first = safest to drop).
+ */
+export function dropOrder(analysis) {
+    return analysis.dropOrder;
+}
+//# sourceMappingURL=chord-tones.js.map

package/dist/theory/chord-tones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chord-tones.js","sourceRoot":"","sources":["../../src/theory/chord-tones.ts"],"names":[],"mappings":"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"}

package/dist/theory/degree-labels.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Jazz roman numeral degree labels.
+ *
+ * Maps Tonal interval strings (1P, 3M, 5A, 7m, etc.) to jazz-standard
+ * roman numeral notation with accidentals (I, bIII, #V, bVII, etc.).
+ *
+ * The accidental reflects the interval alteration from the major scale:
+ * - Perfect/Major = natural (no accidental)
+ * - Minor/Diminished = flat (b)
+ * - Augmented = sharp (#)
+ */
+/**
+ * Convert a Tonal interval string to a jazz roman numeral degree label.
+ *
+ * @example
+ * intervalToDegreeLabel("1P")  → "I"
+ * intervalToDegreeLabel("3M")  → "III"
+ * intervalToDegreeLabel("3m")  → "bIII"
+ * intervalToDegreeLabel("5A")  → "#V"
+ * intervalToDegreeLabel("7m")  → "bVII"
+ * intervalToDegreeLabel("9A")  → "#IX"
+ * intervalToDegreeLabel("5d")  → "bV"
+ */
+export declare function intervalToDegreeLabel(interval: string): string;
+/**
+ * Convert an array of Tonal intervals to jazz degree labels.
+ *
+ * @example
+ * degreesForIntervals(["1P", "3M", "5A", "7m"]) → ["I", "III", "#V", "bVII"]
+ */
+export declare function degreesForIntervals(intervals: string[]): string[];

package/dist/theory/degree-labels.js

@@ -0,0 +1,74 @@
+/**
+ * Jazz roman numeral degree labels.
+ *
+ * Maps Tonal interval strings (1P, 3M, 5A, 7m, etc.) to jazz-standard
+ * roman numeral notation with accidentals (I, bIII, #V, bVII, etc.).
+ *
+ * The accidental reflects the interval alteration from the major scale:
+ * - Perfect/Major = natural (no accidental)
+ * - Minor/Diminished = flat (b)
+ * - Augmented = sharp (#)
+ */
+import { parseInterval } from "./chord-tones";
+const ROMAN = ["", "I", "II", "III", "IV", "V", "VI", "VII"];
+const ROMAN_EXT = {
+    9: "IX", 10: "X", 11: "XI", 12: "XII", 13: "XIII",
+};
+/**
+ * The "natural" quality for each scale degree in the major scale.
+ * 1, 4, 5 are perfect (P). 2, 3, 6, 7 are major (M).
+ * Extensions follow the same pattern: 9=M, 11=P, 13=M.
+ */
+function naturalQuality(degree) {
+    const simple = degree > 7 ? degree - 7 : degree;
+    if (simple === 1 || simple === 4 || simple === 5)
+        return "P";
+    return "M";
+}
+/**
+ * Convert a Tonal interval string to a jazz roman numeral degree label.
+ *
+ * @example
+ * intervalToDegreeLabel("1P")  → "I"
+ * intervalToDegreeLabel("3M")  → "III"
+ * intervalToDegreeLabel("3m")  → "bIII"
+ * intervalToDegreeLabel("5A")  → "#V"
+ * intervalToDegreeLabel("7m")  → "bVII"
+ * intervalToDegreeLabel("9A")  → "#IX"
+ * intervalToDegreeLabel("5d")  → "bV"
+ */
+export function intervalToDegreeLabel(interval) {
+    const { degree, quality } = parseInterval(interval);
+    if (degree === 0)
+        return "?";
+    const numeral = degree <= 7
+        ? (ROMAN[degree] ?? String(degree))
+        : (ROMAN_EXT[degree] ?? String(degree));
+    const nat = naturalQuality(degree);
+    // Determine accidental
+    if (quality === nat) {
+        // Natural quality for this degree — no accidental
+        return numeral;
+    }
+    if (quality === "m" || quality === "d") {
+        return `b${numeral}`;
+    }
+    if (quality === "A") {
+        return `#${numeral}`;
+    }
+    // Edge case: double diminished (bb7 in dim7) → still flat in jazz notation
+    if (quality === "dd") {
+        return `bb${numeral}`;
+    }
+    return numeral;
+}
+/**
+ * Convert an array of Tonal intervals to jazz degree labels.
+ *
+ * @example
+ * degreesForIntervals(["1P", "3M", "5A", "7m"]) → ["I", "III", "#V", "bVII"]
+ */
+export function degreesForIntervals(intervals) {
+    return intervals.map(intervalToDegreeLabel);
+}
+//# sourceMappingURL=degree-labels.js.map

package/dist/theory/degree-labels.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"degree-labels.js","sourceRoot":"","sources":["../../src/theory/degree-labels.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;AAC7D,MAAM,SAAS,GAA2B;IACxC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM;CAClD,CAAC;AAEF;;;;GAIG;AACH,SAAS,cAAc,CAAC,MAAc;IACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC7D,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAE7B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC;QACzB,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAE1C,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAEnC,uBAAuB;IACvB,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,kDAAkD;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACvC,OAAO,IAAI,OAAO,EAAE,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,KAAK,GAAG,EAAE,CAAC;QACpB,OAAO,IAAI,OAAO,EAAE,CAAC;IACvB,CAAC;IACD,2EAA2E;IAC3E,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACrB,OAAO,KAAK,OAAO,EAAE,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAmB;IACrD,OAAO,SAAS,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAC9C,CAAC"}