@pepperhorn/chordl-core 0.3.0

package/dist/parser/progression-parser.d.ts

@@ -0,0 +1,16 @@
+import type { Format } from "../types";
+export interface ParsedProgressionRequest {
+    progression: string;
+    key: string;
+    numExamples: number;
+    styleHint?: string;
+    format?: Format;
+}
+/**
+ * Detect whether an input string is a progression request rather than a single chord.
+ */
+export declare function isProgressionRequest(input: string): boolean;
+/**
+ * Parse a progression request from natural language.
+ */
+export declare function parseProgressionRequest(input: string): ParsedProgressionRequest;

package/dist/parser/progression-parser.js

@@ -0,0 +1,97 @@
+import { MAX_EXAMPLES } from "../config";
+// Roman numeral pattern — must not be followed by a letter (prevents "in", "it", "is" etc.)
+const ROMAN_NUMERAL_SRC = `[#b]?(?:iv|vi{1,2}|i{1,3}|IV|VI{1,2}|I{1,3}|V)(?:[°ø]?\\d*(?:maj|m)?[0-9#b]*)(?![a-z])`;
+// A progression: 2+ roman numerals separated by delimiters
+const PROGRESSION_PATTERN = new RegExp(`(?:^|\\s)(${ROMAN_NUMERAL_SRC}(?:[\\s\\-–—→>]+${ROMAN_NUMERAL_SRC})+)`, "i");
+// Example count: "3 examples", "show me 2", "give me 5 examples"
+const EXAMPLE_COUNT_RE = /(\d+)\s*(?:examples?|variations?|versions?|ways?|options?)/i;
+// Style hints
+const STYLE_RE = /(?:(?:in\s+)?(?:the\s+)?style\s+of\s+|like\s+|a\s+la\s+)([\w\s]+?)(?:\s*$|\s*,|\s+(?:in\s|examples?|variations?))/i;
+const STYLE_KEYWORD_RE = /\b(bebop|basie|nestico|ellington|modal|comping|rootless|quartal|block\s*chords?|locked\s*hands|drop\s*2\s*\+?\s*4|drop\s*2|upper\s*structure|shell|stride|spread|4[- ]?note\s*closed|bill\s*evans|mccoy\s*tyner|herbie\s*hancock|bud\s*powell|monk)\b/i;
+// Form template names — must come before roman numeral detection
+const FORM_NAMES = [
+    { pattern: /\bjazz\s*blues\b/i, id: "jazz blues" },
+    { pattern: /\bblues\b/i, id: "blues" },
+    { pattern: /\brhythm\s*changes?\b/i, id: "rhythm changes" },
+    { pattern: /\bturnaround\b/i, id: "I-vi-ii-V" },
+    { pattern: /\bmodal\s*vamp\b/i, id: "modal vamp" },
+    { pattern: /\bbackdoor\b/i, id: "backdoor" },
+    { pattern: /\btritone\s*sub(?:stitution)?\b/i, id: "tritone sub" },
+    { pattern: /\bminor\s*(?:ii[\s\-–—]*v[\s\-–—]*i|2[\s\-–—]*5[\s\-–—]*1)\b/i, id: "minor ii-V-i" },
+];
+/**
+ * Detect whether an input string is a progression request rather than a single chord.
+ */
+export function isProgressionRequest(input) {
+    // Check for form template names first
+    for (const { pattern } of FORM_NAMES) {
+        if (pattern.test(input))
+            return true;
+    }
+    // Check for roman numeral progression pattern (2+ numerals separated by delimiters)
+    if (PROGRESSION_PATTERN.test(input))
+        return true;
+    // Check for "progression" keyword
+    if (/\bprogression\b/i.test(input))
+        return true;
+    return false;
+}
+/**
+ * Parse a progression request from natural language.
+ */
+export function parseProgressionRequest(input) {
+    // Extract example count
+    let numExamples = MAX_EXAMPLES;
+    const countMatch = input.match(EXAMPLE_COUNT_RE);
+    if (countMatch) {
+        numExamples = Math.min(parseInt(countMatch[1], 10), MAX_EXAMPLES);
+    }
+    // Extract style
+    let styleHint;
+    const styleMatch = input.match(STYLE_RE);
+    const styleKeywordMatch = input.match(STYLE_KEYWORD_RE);
+    if (styleMatch) {
+        styleHint = styleMatch[1].trim();
+    }
+    else if (styleKeywordMatch) {
+        styleHint = styleKeywordMatch[1].trim();
+    }
+    // Extract format
+    let format;
+    const formatMatch = input.match(/\b(compact|exact)\b/i);
+    if (formatMatch) {
+        format = formatMatch[1].toLowerCase();
+    }
+    // Extract key — "in G", "in the key of Db", "in F#"
+    let key = "C";
+    const keyMatch = input.match(/\bin\s+(?:the\s+)?(?:key\s+(?:of\s+)?)?([A-Ga-g][#b]?)(?:\s|$)/i);
+    if (keyMatch) {
+        key = keyMatch[1].charAt(0).toUpperCase() + keyMatch[1].slice(1);
+    }
+    // Extract progression — check form names first, then roman numerals
+    let progression = "";
+    for (const { pattern, id } of FORM_NAMES) {
+        if (pattern.test(input)) {
+            progression = id;
+            break;
+        }
+    }
+    // If no form name matched, try roman numeral pattern
+    if (!progression) {
+        const progMatch = input.match(PROGRESSION_PATTERN);
+        if (progMatch) {
+            progression = progMatch[1].trim();
+        }
+    }
+    if (!progression) {
+        progression = "ii-V-I";
+    }
+    return {
+        progression,
+        key,
+        numExamples,
+        styleHint,
+        format,
+    };
+}
+//# sourceMappingURL=progression-parser.js.map

package/dist/parser/progression-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progression-parser.js","sourceRoot":"","sources":["../../src/parser/progression-parser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAUzC,4FAA4F;AAC5F,MAAM,iBAAiB,GAAG,wFAAwF,CAAC;AAEnH,2DAA2D;AAC3D,MAAM,mBAAmB,GAAG,IAAI,MAAM,CACpC,aAAa,iBAAiB,mBAAmB,iBAAiB,KAAK,EACvE,GAAG,CACJ,CAAC;AAEF,iEAAiE;AACjE,MAAM,gBAAgB,GAAG,6DAA6D,CAAC;AAEvF,cAAc;AACd,MAAM,QAAQ,GACZ,oHAAoH,CAAC;AACvH,MAAM,gBAAgB,GACpB,wPAAwP,CAAC;AAE3P,iEAAiE;AACjE,MAAM,UAAU,GAA2C;IACzD,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,YAAY,EAAE;IAClD,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,OAAO,EAAE;IACtC,EAAE,OAAO,EAAE,wBAAwB,EAAE,EAAE,EAAE,gBAAgB,EAAE;IAC3D,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,WAAW,EAAE;IAC/C,EAAE,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,YAAY,EAAE;IAClD,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,UAAU,EAAE;IAC5C,EAAE,OAAO,EAAE,kCAAkC,EAAE,EAAE,EAAE,aAAa,EAAE;IAClE,EAAE,OAAO,EAAE,+DAA+D,EAAE,EAAE,EAAE,cAAc,EAAE;CACjG,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,sCAAsC;IACtC,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,UAAU,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;IACvC,CAAC;IAED,oFAAoF;IACpF,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjD,kCAAkC;IAClC,IAAI,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAa;IACnD,wBAAwB;IACxB,IAAI,WAAW,GAAG,YAAY,CAAC;IAC/B,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACjD,IAAI,UAAU,EAAE,CAAC;QACf,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,YAAY,CAAC,CAAC;IACpE,CAAC;IAED,gBAAgB;IAChB,IAAI,SAA6B,CAAC;IAClC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,SAAS,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,CAAC;SAAM,IAAI,iBAAiB,EAAE,CAAC;QAC7B,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,CAAC;IAED,iBAAiB;IACjB,IAAI,MAA0B,CAAC;IAC/B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACxD,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,EAAY,CAAC;IAClD,CAAC;IAED,oDAAoD;IACpD,IAAI,GAAG,GAAG,GAAG,CAAC;IACd,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;IAChG,IAAI,QAAQ,EAAE,CAAC;QACb,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,oEAAoE;IACpE,IAAI,WAAW,GAAG,EAAE,CAAC;IAErB,KAAK,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,UAAU,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,WAAW,GAAG,EAAE,CAAC;YACjB,MAAM;QACR,CAAC;IACH,CAAC;IAED,qDAAqD;IACrD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACnD,IAAI,SAAS,EAAE,CAAC;YACd,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,CAAC;IACH,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,WAAW,GAAG,QAAQ,CAAC;IACzB,CAAC;IAED,OAAO;QACL,WAAW;QACX,GAAG;QACH,WAAW;QACX,SAAS;QACT,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/pipeline.d.ts

@@ -0,0 +1,33 @@
+import type { LogConfig } from "./logging";
+export interface ChordRequest {
+    input: string;
+    format?: "json" | "svg" | "midi";
+    logConfig?: LogConfig;
+}
+export interface ChordResultKeyboard {
+    startFrom: string;
+    size: number;
+    highlightKeys: string[];
+}
+export interface ChordResultTelemetry {
+    parser: "chord" | "progression";
+    resolver: {
+        root: string;
+        type: string;
+        pitchClasses: string[];
+    };
+    durationMs: number;
+}
+export interface ChordResult {
+    success: boolean;
+    chordName: string;
+    root: string;
+    notes: string[];
+    inversion?: number;
+    keyboard: ChordResultKeyboard;
+    telemetry: ChordResultTelemetry;
+    svg?: string;
+    midi?: Uint8Array;
+    errorMessage?: string;
+}
+export declare function processChordRequest(request: ChordRequest): ChordResult;

package/dist/pipeline.js

@@ -0,0 +1,203 @@
+import { parseChordDescription } from "./parser/natural-language";
+import { resolveChord } from "./resolver/chord-resolver";
+import { calculateLayout } from "./resolver/auto-layout";
+import { computeKeyboard, computeSvgDimensions } from "./engine/keyboard-layout";
+import { mapHighlights, normalizeNote } from "./engine/highlight-mapper";
+import { generateMidiFile } from "./audio/midi-export";
+import { logChordRequest } from "./logging";
+import { WHITE_KEY_RY, BLACK_KEY_RY, DEFAULT_STROKE, DEFAULT_STROKE_WIDTH, } from "./engine/svg-constants";
+// ── SVG builder ───────────────────────────────────────────────────
+function buildSvgString(keys, fills, svgWidth, svgHeight) {
+    const whiteRects = [];
+    const blackRects = [];
+    for (let i = 0; i < keys.length; i++) {
+        const k = keys[i];
+        const fill = fills[i];
+        const ry = k.isBlack ? BLACK_KEY_RY : WHITE_KEY_RY;
+        const rect = `<rect x="${k.x}" y="${k.y}" width="${k.width}" height="${k.height}" rx="${ry}" ry="${ry}" fill="${fill}" stroke="${DEFAULT_STROKE}" stroke-width="${DEFAULT_STROKE_WIDTH}"/>`;
+        if (k.isBlack) {
+            blackRects.push(rect);
+        }
+        else {
+            whiteRects.push(rect);
+        }
+    }
+    return [
+        `<svg xmlns="http://www.w3.org/2000/svg" width="${svgWidth}" height="${svgHeight}" viewBox="0 0 ${svgWidth} ${svgHeight}">`,
+        ...whiteRects,
+        ...blackRects,
+        `</svg>`,
+    ].join("\n");
+}
+import { PC_SEMITONES as NOTE_SEMITONES } from "./engine/note-spelling";
+// ── Main pipeline ─────────────────────────────────────────────────
+export function processChordRequest(request) {
+    const start = performance.now();
+    // Default error result
+    const errorResult = (msg) => ({
+        success: false,
+        chordName: "",
+        root: "",
+        notes: [],
+        keyboard: { startFrom: "C", size: 8, highlightKeys: [] },
+        telemetry: {
+            parser: "chord",
+            resolver: { root: "", type: "", pitchClasses: [] },
+            durationMs: performance.now() - start,
+        },
+        errorMessage: msg,
+    });
+    try {
+        const { input, format: outputFormat, logConfig } = request;
+        if (!input || !input.trim()) {
+            return errorResult("No chord input provided");
+        }
+        // 1. Parse
+        const parsed = parseChordDescription(input);
+        if (!parsed.chordName) {
+            return errorResult("Could not extract a chord name from the input");
+        }
+        // 2. Resolve
+        const resolved = resolveChord(parsed.chordName, parsed.inversion);
+        const pitchClasses = resolved.notes; // display names (Bb, Eb, etc.)
+        const keyboardPitchClasses = pitchClasses.map(normalizeNote); // sharps for keyboard internals
+        // 3. Layout
+        const layoutFormat = parsed.format ?? "compact";
+        const layout = calculateLayout(keyboardPitchClasses, {
+            padding: parsed.padding,
+            startingNote: parsed.startingNote,
+            spanFrom: parsed.spanFrom,
+            spanTo: parsed.spanTo,
+        });
+        // 4. Compute keyboard keys
+        const keys = computeKeyboard(layout.startFrom, layout.size, layoutFormat);
+        // 5. Build octave-qualified highlight keys
+        const baseOctave = 4;
+        const highlightKeys = [];
+        const midiNoteNames = [];
+        // Max playable hand span: octave + fifth (~19 semitones)
+        const MAX_SPAN = 28;
+        // Build ascending semitone sequence for the chord notes
+        let prevSemitone = -1;
+        let currentOctave = baseOctave + layout.chordOctave;
+        // Step 1: naive ascending octave assignment
+        const assigned = [];
+        for (let i = 0; i < pitchClasses.length; i++) {
+            const pc = pitchClasses[i];
+            const kpc = keyboardPitchClasses[i];
+            const semitone = NOTE_SEMITONES[pc];
+            if (semitone === undefined)
+                continue;
+            if (prevSemitone !== -1 && semitone <= prevSemitone) {
+                currentOctave++;
+            }
+            prevSemitone = semitone;
+            assigned.push({ pc, kpc, semitone, octave: currentOctave });
+        }
+        // Step 2: compact — fold notes down if span exceeds playable range
+        if (assigned.length > 1) {
+            const baseSemi = assigned[0].semitone + assigned[0].octave * 12;
+            for (let i = 1; i < assigned.length; i++) {
+                const noteSemi = assigned[i].semitone + assigned[i].octave * 12;
+                if (noteSemi - baseSemi > MAX_SPAN && assigned[i].octave > assigned[0].octave) {
+                    assigned[i].octave--;
+                }
+            }
+        }
+        for (const a of assigned) {
+            midiNoteNames.push(`${a.pc}${a.octave}`);
+            const relOctave = a.octave - baseOctave;
+            highlightKeys.push(`${a.kpc}:${relOctave}`);
+        }
+        // 6. Map highlight fills
+        const fills = mapHighlights(keys, highlightKeys);
+        // 7. Build result
+        const result = {
+            success: true,
+            chordName: parsed.chordName,
+            root: resolved.root,
+            notes: midiNoteNames,
+            inversion: parsed.inversion,
+            keyboard: {
+                startFrom: layout.startFrom,
+                size: layout.size,
+                highlightKeys,
+            },
+            telemetry: {
+                parser: "chord",
+                resolver: {
+                    root: resolved.root,
+                    type: resolved.type,
+                    pitchClasses,
+                },
+                durationMs: performance.now() - start,
+            },
+        };
+        // 8. SVG output
+        if (outputFormat === "svg") {
+            const dims = computeSvgDimensions(layout.size, layoutFormat);
+            result.svg = buildSvgString(keys, fills, dims.width, dims.height);
+        }
+        // 9. MIDI output
+        if (outputFormat === "midi") {
+            result.midi = generateMidiFile({ notes: pitchClasses });
+        }
+        // 10. Optional logging
+        if (logConfig) {
+            const logEntry = {
+                input,
+                pipeline: {
+                    parser: "chord",
+                    parsed: {
+                        chordName: parsed.chordName,
+                        inversion: parsed.inversion,
+                        allInversions: parsed.allInversions,
+                        startingNote: parsed.startingNote,
+                        startingDegree: parsed.startingDegree,
+                        bassNote: parsed.bassNote,
+                        bassDegree: parsed.bassDegree,
+                        spanFrom: parsed.spanFrom,
+                        spanTo: parsed.spanTo,
+                        padding: parsed.padding,
+                        chordOctaveShift: parsed.chordOctaveShift,
+                        bassOctaveShift: parsed.bassOctaveShift,
+                        styleHint: parsed.styleHint,
+                        format: parsed.format,
+                        showNoteNames: parsed.showNoteNames,
+                        fingering: parsed.fingering,
+                        autoFingering: parsed.autoFingering,
+                    },
+                    resolver: {
+                        method: "tonal",
+                        type: resolved.type,
+                        root: resolved.root,
+                        pitchClasses,
+                    },
+                    voicing: {
+                        attempted: false,
+                        found: false,
+                    },
+                    layout: {
+                        startFrom: layout.startFrom,
+                        size: layout.size,
+                        chordOctave: layout.chordOctave,
+                    },
+                    output: {
+                        notes: midiNoteNames,
+                        highlightKeys,
+                        format: outputFormat,
+                    },
+                },
+                success: true,
+                durationMs: performance.now() - start,
+            };
+            logChordRequest(logEntry, logConfig);
+        }
+        return result;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return errorResult(msg);
+    }
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/pipeline.js.map

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

package/dist/progression/form-templates.d.ts

@@ -0,0 +1,11 @@
+export interface FormTemplate {
+    id: string;
+    name: string;
+    numerals: string[];
+    description: string;
+}
+export declare const FORM_TEMPLATES: FormTemplate[];
+/**
+ * Find a form template by ID, name, or keyword alias.
+ */
+export declare function findTemplate(query: string): FormTemplate | undefined;

package/dist/progression/form-templates.js

@@ -0,0 +1,105 @@
+export const FORM_TEMPLATES = [
+    {
+        id: "ii-V-I",
+        name: "ii-V-I",
+        numerals: ["ii7", "V7", "Imaj7"],
+        description: "The most common jazz cadence",
+    },
+    {
+        id: "minor-ii-V-i",
+        name: "Minor ii-V-i",
+        numerals: ["iiø7", "V7", "i7"],
+        description: "Minor key ii-V-i cadence",
+    },
+    {
+        id: "I-vi-ii-V",
+        name: "I-vi-ii-V",
+        numerals: ["Imaj7", "vi7", "ii7", "V7"],
+        description: "Classic turnaround (rhythm changes A section)",
+    },
+    {
+        id: "iii-vi-ii-V",
+        name: "iii-vi-ii-V",
+        numerals: ["iii7", "vi7", "ii7", "V7"],
+        description: "Extended turnaround from the iii chord",
+    },
+    {
+        id: "blues",
+        name: "12-Bar Blues",
+        numerals: [
+            "I7", "IV7", "I7", "I7",
+            "IV7", "IV7", "I7", "I7",
+            "V7", "IV7", "I7", "V7",
+        ],
+        description: "Standard 12-bar blues progression",
+    },
+    {
+        id: "jazz-blues",
+        name: "Jazz Blues",
+        numerals: [
+            "I7", "IV7", "I7", "vi7",
+            "ii7", "V7", "I7", "vi7",
+            "ii7", "V7", "I7", "ii7", "V7",
+        ],
+        description: "Jazz blues with ii-V turnarounds",
+    },
+    {
+        id: "rhythm-changes",
+        name: "Rhythm Changes (A)",
+        numerals: ["Imaj7", "vi7", "ii7", "V7", "iii7", "vi7", "ii7", "V7"],
+        description: "A section of rhythm changes (I Got Rhythm)",
+    },
+    {
+        id: "modal-vamp",
+        name: "Modal Vamp",
+        numerals: ["i7", "bVII7"],
+        description: "Two-chord modal vamp (So What / Impressions style)",
+    },
+    {
+        id: "backdoor-ii-V",
+        name: "Backdoor ii-V",
+        numerals: ["iv7", "bVII7", "Imaj7"],
+        description: "Backdoor resolution via bVII to I",
+    },
+    {
+        id: "tritone-sub",
+        name: "Tritone Sub ii-V-I",
+        numerals: ["ii7", "bII7", "Imaj7"],
+        description: "ii-V-I with tritone substitution on the V",
+    },
+];
+// Keyword aliases for template lookup
+const TEMPLATE_ALIASES = {
+    "blues": "blues",
+    "jazzblues": "jazz-blues",
+    "rhythmchanges": "rhythm-changes",
+    "rhythmchange": "rhythm-changes",
+    "turnaround": "I-vi-ii-V",
+    "modalvamp": "modal-vamp",
+    "backdoor": "backdoor-ii-V",
+    "tritonesub": "tritone-sub",
+    "tritonesubstitution": "tritone-sub",
+    "minoriivi": "minor-ii-V-i",
+    "minorii-v-i": "minor-ii-V-i",
+};
+/**
+ * Find a form template by ID, name, or keyword alias.
+ */
+export function findTemplate(query) {
+    const lower = query.toLowerCase().replace(/[\s\-–—]+/g, "");
+    // Exact ID match
+    const byId = FORM_TEMPLATES.find((t) => t.id.replace(/-/g, "").toLowerCase() === lower);
+    if (byId)
+        return byId;
+    // Alias match
+    const aliasId = TEMPLATE_ALIASES[lower];
+    if (aliasId) {
+        return FORM_TEMPLATES.find((t) => t.id === aliasId);
+    }
+    // Fuzzy name match
+    return FORM_TEMPLATES.find((t) => {
+        const name = t.name.toLowerCase().replace(/[\s\-–—]+/g, "");
+        return name.includes(lower) || lower.includes(name);
+    });
+}
+//# sourceMappingURL=form-templates.js.map

package/dist/progression/form-templates.js.map

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

package/dist/progression/index.d.ts

@@ -0,0 +1,5 @@
+export { resolveProgression, tokenizeProgression } from "./roman-numeral";
+export { FORM_TEMPLATES, findTemplate } from "./form-templates";
+export type { FormTemplate } from "./form-templates";
+export { resolveProgressionRequest, } from "./progression-resolver";
+export type { ProgressionRequest, ProgressionResult, ProgressionExample, ProgressionChord, } from "./progression-resolver";

package/dist/progression/index.js

@@ -0,0 +1,4 @@
+export { resolveProgression, tokenizeProgression } from "./roman-numeral";
+export { FORM_TEMPLATES, findTemplate } from "./form-templates";
+export { resolveProgressionRequest, } from "./progression-resolver";
+//# sourceMappingURL=index.js.map

package/dist/progression/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/progression/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC1E,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEhE,OAAO,EACL,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC"}

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

@@ -0,0 +1,29 @@
+export interface ProgressionChord {
+    symbol: string;
+    root: string;
+    notes: string[];
+    voicingStyle?: string;
+}
+export interface ProgressionExample {
+    label: string;
+    chords: ProgressionChord[];
+}
+export interface ProgressionResult {
+    progressionName: string;
+    key: string;
+    examples: ProgressionExample[];
+}
+export interface ProgressionRequest {
+    /** Roman numeral tokens or a form template name */
+    progression: string;
+    /** Musical key, e.g. "G", "Db" */
+    key: string;
+    /** Number of examples to generate */
+    numExamples?: number;
+    /** Style hint: artist name or voicing style keyword */
+    styleHint?: string;
+}
+/**
+ * Resolve a progression request into multiple voicing examples.
+ */
+export declare function resolveProgressionRequest(req: ProgressionRequest): ProgressionResult;