@mcptoolshop/ai-jam-sessions 0.1.0

package/dist/note-parser.js

@@ -0,0 +1,319 @@
+// ─── pianoai: Note Parser ────────────────────────────────────────────────────
+//
+// Converts scientific pitch notation (e.g. "C4:q", "F#5:e", "Bb3:h")
+// into MIDI note numbers and durations for playback.
+// ─────────────────────────────────────────────────────────────────────────────
+import { NOTE_OFFSETS, DURATION_MAP } from "./types.js";
+/**
+ * Parse a scientific pitch string into a MIDI note number.
+ *
+ * Examples:
+ *   "C4"  → 60  (middle C)
+ *   "A4"  → 69  (concert A)
+ *   "F#5" → 78
+ *   "Bb3" → 58
+ *   "R"   → -1  (rest)
+ */
+export function parseNoteToMidi(noteStr) {
+    const trimmed = noteStr.trim();
+    if (trimmed === "R" || trimmed === "r")
+        return -1; // rest
+    // Match: letter + optional accidental + octave
+    // e.g. "C4", "F#5", "Bb3", "G#4"
+    const match = trimmed.match(/^([A-Ga-g])(#|b)?(\d)$/);
+    if (!match) {
+        throw new Error(`Invalid note: "${noteStr}"`);
+    }
+    const [, letter, accidental, octaveStr] = match;
+    const base = NOTE_OFFSETS[letter.toUpperCase()];
+    if (base === undefined) {
+        throw new Error(`Unknown note letter: "${letter}"`);
+    }
+    const octave = parseInt(octaveStr, 10);
+    let midi = (octave + 1) * 12 + base;
+    if (accidental === "#")
+        midi += 1;
+    if (accidental === "b")
+        midi -= 1;
+    if (midi < 0 || midi > 127) {
+        throw new Error(`MIDI note out of range: ${midi} (from "${noteStr}")`);
+    }
+    return midi;
+}
+/**
+ * Parse a duration suffix into a multiplier relative to a quarter note.
+ *
+ * ":w" → 4.0 (whole), ":h" → 2.0 (half), ":q" → 1.0 (quarter),
+ * ":e" → 0.5 (eighth), ":s" → 0.25 (sixteenth).
+ * Default (no suffix) → 1.0 (quarter).
+ */
+export function parseDuration(suffix) {
+    const mult = DURATION_MAP[suffix];
+    if (mult === undefined) {
+        throw new Error(`Unknown duration suffix: "${suffix}"`);
+    }
+    return mult;
+}
+/**
+ * Convert a BPM tempo + duration multiplier → milliseconds.
+ *
+ * At 120 BPM, a quarter note = 500ms.
+ * A half note at 120 BPM = 1000ms.
+ */
+export function durationToMs(multiplier, bpm) {
+    const quarterMs = 60_000 / bpm;
+    return quarterMs * multiplier;
+}
+/**
+ * Parse a single note token like "C4:q" or "R:h" into a MidiNote.
+ *
+ * @param token   - e.g. "C4:q", "F#5:e", "Bb3:h", "R:q"
+ * @param bpm     - tempo in beats per minute
+ * @param channel - MIDI channel (0-15)
+ * @param velocity - MIDI velocity (0-127)
+ */
+export function parseNoteToken(token, bpm, channel = 0, velocity = 80) {
+    const trimmed = token.trim();
+    const parts = trimmed.split(":");
+    const noteStr = parts[0];
+    const durationSuffix = parts[1] ?? "q"; // default to quarter note
+    const midi = parseNoteToMidi(noteStr);
+    const mult = parseDuration(durationSuffix);
+    const durationMs = durationToMs(mult, bpm);
+    return {
+        note: midi,
+        velocity: midi === -1 ? 0 : velocity, // rests have 0 velocity
+        durationMs,
+        channel,
+    };
+}
+/**
+ * Parse a hand string like "C4:q E4:q G4:q" into an array of Beats.
+ *
+ * Each space-separated token becomes a sequential beat.
+ * Chords use "+" to join simultaneous notes: "C4+E4+G4:q"
+ * The duration suffix on the last note applies to all chord tones.
+ */
+export function parseHandString(handStr, hand, bpm, channel = 0, velocity = 80) {
+    if (!handStr || handStr.trim() === "")
+        return [];
+    const tokens = handStr.trim().split(/\s+/);
+    return tokens.map((token) => {
+        if (token.includes("+")) {
+            return parseChordToken(token, hand, bpm, channel, velocity);
+        }
+        return {
+            notes: [parseNoteToken(token, bpm, channel, velocity)],
+            hand,
+        };
+    });
+}
+/**
+ * Parse a chord token like "C4+E4+G4:q" into a Beat with multiple notes.
+ * The duration suffix from the last sub-token applies to all notes.
+ */
+function parseChordToken(token, hand, bpm, channel, velocity) {
+    const parts = token.split("+");
+    // Find the duration from the part that has one (last part has ":dur")
+    let sharedDuration = "q";
+    for (const part of parts) {
+        if (part.includes(":")) {
+            sharedDuration = part.split(":")[1];
+        }
+    }
+    const notes = parts.map((part) => {
+        if (part.includes(":")) {
+            return parseNoteToken(part, bpm, channel, velocity);
+        }
+        return parseNoteToken(`${part}:${sharedDuration}`, bpm, channel, velocity);
+    });
+    return { notes, hand };
+}
+/**
+ * Parse a full Measure into a PlayableMeasure with MIDI-ready beats.
+ */
+export function parseMeasure(measure, bpm, velocity = 80) {
+    return {
+        source: measure,
+        rightBeats: parseHandString(measure.rightHand, "right", bpm, 0, velocity),
+        leftBeats: parseHandString(measure.leftHand, "left", bpm, 0, velocity),
+    };
+}
+/**
+ * Safely parse a note token — returns null on error instead of throwing.
+ * Collects a warning in the provided array when parsing fails.
+ */
+export function safeParseNoteToken(token, bpm, location, warnings, channel = 0, velocity = 80) {
+    try {
+        return parseNoteToken(token, bpm, channel, velocity);
+    }
+    catch (err) {
+        warnings.push({
+            location,
+            token,
+            message: err instanceof Error ? err.message : String(err),
+        });
+        return null;
+    }
+}
+/**
+ * Safe version of parseHandString — skips bad tokens, collects warnings.
+ */
+export function safeParseHandString(handStr, hand, bpm, measureNumber, warnings, channel = 0, velocity = 80) {
+    if (!handStr || handStr.trim() === "")
+        return [];
+    const tokens = handStr.trim().split(/\s+/);
+    const beats = [];
+    for (const token of tokens) {
+        if (token.includes("+")) {
+            // Chord token — parse each sub-note
+            try {
+                beats.push(parseChordToken(token, hand, bpm, channel, velocity));
+            }
+            catch (err) {
+                warnings.push({
+                    location: `measure ${measureNumber} ${hand} hand`,
+                    token,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        else {
+            const note = safeParseNoteToken(token, bpm, `measure ${measureNumber} ${hand} hand`, warnings, channel, velocity);
+            if (note) {
+                beats.push({ notes: [note], hand });
+            }
+        }
+    }
+    return beats;
+}
+/**
+ * Safe version of parseMeasure — skips bad notes, collects warnings.
+ */
+export function safeParseMeasure(measure, bpm, warnings, velocity = 80) {
+    return {
+        source: measure,
+        rightBeats: safeParseHandString(measure.rightHand, "right", bpm, measure.number, warnings, 0, velocity),
+        leftBeats: safeParseHandString(measure.leftHand, "left", bpm, measure.number, warnings, 0, velocity),
+    };
+}
+/**
+ * Convert a MIDI note number back to a note name (for display).
+ *
+ * 60 → "C4", 69 → "A4", 78 → "F#5"
+ */
+export function midiToNoteName(midi) {
+    if (midi < 0)
+        return "R";
+    const noteNames = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+    const octave = Math.floor(midi / 12) - 1;
+    const noteIndex = midi % 12;
+    return `${noteNames[noteIndex]}${octave}`;
+}
+/** Solfege mapping: note name (with optional accidental) → solfege syllable. */
+const SOLFEGE_MAP = {
+    C: "Do", "C#": "Di", Db: "Ra",
+    D: "Re", "D#": "Ri", Eb: "Me",
+    E: "Mi",
+    F: "Fa", "F#": "Fi", Gb: "Se",
+    G: "Sol", "G#": "Si", Ab: "Le",
+    A: "La", "A#": "Li", Bb: "Te",
+    B: "Ti",
+};
+/**
+ * Convert a single note string (e.g. "C4", "F#5") to a singable syllable.
+ *
+ * - "note-names": "C", "F sharp", "B flat"
+ * - "solfege": "Do", "Fi", "Te"
+ * - "syllables": always "da"
+ * - "contour": falls back to letter (contour handled at measure level)
+ */
+export function noteToSingable(noteStr, mode) {
+    const trimmed = noteStr.trim();
+    if (trimmed === "R" || trimmed === "r")
+        return mode === "syllables" ? "..." : "rest";
+    const match = trimmed.match(/^([A-Ga-g])(#|b)?(\d)?$/);
+    if (!match)
+        return trimmed; // pass through unparseable
+    const [, letter, accidental] = match;
+    const upperLetter = letter.toUpperCase();
+    switch (mode) {
+        case "note-names": {
+            const acc = accidental === "#" ? " sharp" : accidental === "b" ? " flat" : "";
+            return `${upperLetter}${acc}`;
+        }
+        case "solfege": {
+            const key = accidental ? `${upperLetter}${accidental}` : upperLetter;
+            return SOLFEGE_MAP[key] ?? upperLetter;
+        }
+        case "syllables":
+            return "da";
+        case "contour":
+            return upperLetter; // fallback — contour handled at measure level
+    }
+}
+/**
+ * Convert a hand string (e.g. "C4:q E4:q G4:q") to singable text.
+ *
+ * For "contour" mode, compares consecutive MIDI pitches and returns
+ * direction words: "up", "down", "same".
+ *
+ * For other modes, maps each note token through noteToSingable and
+ * joins with "... " (speech pause).
+ */
+export function handToSingableText(handStr, mode) {
+    if (!handStr || handStr.trim() === "")
+        return "";
+    const tokens = handStr.trim().split(/\s+/);
+    if (mode === "contour") {
+        if (tokens.length <= 1)
+            return "hold";
+        const midis = tokens.map((t) => {
+            const noteStr = t.split(":")[0];
+            try {
+                return parseNoteToMidi(noteStr);
+            }
+            catch {
+                return -1;
+            }
+        });
+        const dirs = [];
+        for (let i = 1; i < midis.length; i++) {
+            if (midis[i] < 0 || midis[i - 1] < 0) {
+                dirs.push("rest");
+                continue;
+            }
+            const diff = midis[i] - midis[i - 1];
+            dirs.push(diff > 0 ? "up" : diff < 0 ? "down" : "same");
+        }
+        return dirs.join("... ");
+    }
+    // note-names, solfege, syllables
+    const syllables = tokens.map((t) => {
+        const noteStr = t.split(":")[0];
+        return noteToSingable(noteStr, mode);
+    });
+    return syllables.join("... ");
+}
+/**
+ * Convert a Measure to singable text for voice narration.
+ *
+ * Returns the singable syllables for the specified hand(s).
+ * When hand="both", right hand text comes first, then "Left hand:" prefix.
+ */
+export function measureToSingableText(measure, options) {
+    const { mode, hand } = options;
+    if (hand === "right")
+        return handToSingableText(measure.rightHand, mode);
+    if (hand === "left")
+        return handToSingableText(measure.leftHand, mode);
+    // both
+    const right = handToSingableText(measure.rightHand, mode);
+    const left = handToSingableText(measure.leftHand, mode);
+    if (!left)
+        return right;
+    if (!right)
+        return left;
+    return `${right}. Left hand: ${left}`;
+}
+//# sourceMappingURL=note-parser.js.map

package/dist/note-parser.js.map

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

package/dist/piano-roll.d.ts

@@ -0,0 +1,28 @@
+import type { SongEntry } from "./songs/types.js";
+export type PianoRollColorMode = "hand" | "pitch-class";
+export interface PianoRollOptions {
+    /** First measure to render (1-based). Default: 1 */
+    startMeasure?: number;
+    /** Last measure to render (1-based). Default: last measure */
+    endMeasure?: number;
+    /** Horizontal pixels per beat. Default: 60 */
+    pixelsPerBeat?: number;
+    /** Vertical pixels per semitone row. Default: 10 */
+    pitchRowHeight?: number;
+    /** Show metronome dots on downbeats. Default: true */
+    showMetronome?: boolean;
+    /** Show dynamics markings. Default: true */
+    showDynamics?: boolean;
+    /** Show measure teaching notes as tooltip titles. Default: false */
+    showTeachingNotes?: boolean;
+    /** Note coloring mode. Default: "hand" (blue RH / coral LH). */
+    colorMode?: PianoRollColorMode;
+}
+/**
+ * Render a SongEntry as an SVG piano roll string.
+ *
+ * Returns a complete SVG document as a string — no file I/O,
+ * no DOM, no external dependencies.
+ */
+export declare function renderPianoRoll(song: SongEntry, options?: PianoRollOptions): string;
+//# sourceMappingURL=piano-roll.d.ts.map

package/dist/piano-roll.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"piano-roll.d.ts","sourceRoot":"","sources":["../src/piano-roll.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,SAAS,EAAW,MAAM,kBAAkB,CAAC;AAI3D,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,aAAa,CAAC;AAExD,MAAM,WAAW,gBAAgB;IAC/B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8CAA8C;IAC9C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sDAAsD;IACtD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gEAAgE;IAChE,SAAS,CAAC,EAAE,kBAAkB,CAAC;CAChC;AA2ID;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,SAAS,EACf,OAAO,CAAC,EAAE,gBAAgB,GACzB,MAAM,CAwNR"}