@pepperhorn/chordl-core 0.3.0

package/dist/engine/note-spelling.js.map

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

package/dist/engine/scale-fingering.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Scale fingering lookup for piano.
+ *
+ * Standard fingerings from established piano pedagogy (Hanon, Czerny, ABRSM).
+ * Core rule: thumb always crosses to a white key.
+ *
+ * Each entry is one octave ascending. For multi-octave scales, the pattern
+ * repeats with the last finger of one octave becoming the first of the next.
+ * The final note of the last octave always uses finger 5 (RH) or 1 (LH).
+ */
+export type ScaleHand = "rh" | "lh";
+/**
+ * Get scale fingering for a given root and scale type.
+ *
+ * @param root - Root note (e.g. "C", "Bb", "F#")
+ * @param scaleType - Scale type (e.g. "major", "minor", "harmonic minor", "melodic minor", "dorian")
+ * @param hand - "rh" (default) or "lh"
+ * @param octaves - Number of octaves (default 1)
+ * @returns Array of finger numbers, one per note. Empty array if no fingering available.
+ */
+export declare function scaleAutoFingering(root: string, scaleType: string, hand?: ScaleHand, octaves?: number): number[];

package/dist/engine/scale-fingering.js

@@ -0,0 +1,130 @@
+/**
+ * Scale fingering lookup for piano.
+ *
+ * Standard fingerings from established piano pedagogy (Hanon, Czerny, ABRSM).
+ * Core rule: thumb always crosses to a white key.
+ *
+ * Each entry is one octave ascending. For multi-octave scales, the pattern
+ * repeats with the last finger of one octave becoming the first of the next.
+ * The final note of the last octave always uses finger 5 (RH) or 1 (LH).
+ */
+// ── Major scale fingerings ────────────────────────────────────────
+const MAJOR_FINGERINGS = {
+    // White-key scales: standard 1-2-3, 1-2-3-4-5
+    C: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    G: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    D: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    A: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    E: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    B: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [4, 3, 2, 1, 4, 3, 2, 1] },
+    // F major: thumb on C after Bb
+    F: { rh: [1, 2, 3, 4, 1, 2, 3, 4], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    // Flat-key scales: thumb avoids black keys
+    Bb: { rh: [2, 1, 2, 3, 1, 2, 3, 4], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+    Eb: { rh: [2, 1, 2, 3, 4, 1, 2, 3], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+    Ab: { rh: [2, 3, 1, 2, 3, 1, 2, 3], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+    Db: { rh: [2, 3, 1, 2, 3, 4, 1, 2], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+    Gb: { rh: [2, 3, 4, 1, 2, 3, 1, 2], lh: [4, 3, 2, 1, 3, 2, 1, 4] },
+    // Enharmonic equivalents
+    "F#": { rh: [2, 3, 4, 1, 2, 3, 1, 2], lh: [4, 3, 2, 1, 3, 2, 1, 4] },
+    "C#": { rh: [2, 3, 1, 2, 3, 4, 1, 2], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+};
+// ── Minor scale fingerings (natural minor) ────────────────────────
+// Harmonic and melodic minor use the same fingerings.
+const MINOR_FINGERINGS = {
+    A: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    E: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    B: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [4, 3, 2, 1, 4, 3, 2, 1] },
+    D: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    G: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    C: { rh: [1, 2, 3, 1, 2, 3, 4, 5], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    F: { rh: [1, 2, 3, 4, 1, 2, 3, 4], lh: [5, 4, 3, 2, 1, 3, 2, 1] },
+    "F#": { rh: [2, 3, 1, 2, 3, 1, 2, 3], lh: [4, 3, 2, 1, 3, 2, 1, 4] },
+    "C#": { rh: [2, 3, 1, 2, 3, 1, 2, 3], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+    "G#": { rh: [2, 3, 1, 2, 3, 1, 2, 3], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+    Bb: { rh: [2, 1, 2, 3, 1, 2, 3, 4], lh: [2, 1, 3, 2, 1, 4, 3, 2] },
+    Eb: { rh: [2, 1, 2, 3, 4, 1, 2, 3], lh: [2, 1, 4, 3, 2, 1, 3, 2] },
+    Ab: { rh: [2, 3, 1, 2, 3, 1, 2, 3], lh: [3, 2, 1, 4, 3, 2, 1, 3] },
+};
+// ── Normalize note name ───────────────────────────────────────────
+const FLAT_TO_SHARP = {
+    Db: "C#", Eb: "D#", Gb: "F#", Ab: "G#", Bb: "A#",
+};
+function normalizeRoot(root) {
+    // Keep the original if it's in the lookup; otherwise try sharp equivalent
+    return root;
+}
+// ── Public API ────────────────────────────────────────────────────
+/**
+ * Get scale fingering for a given root and scale type.
+ *
+ * @param root - Root note (e.g. "C", "Bb", "F#")
+ * @param scaleType - Scale type (e.g. "major", "minor", "harmonic minor", "melodic minor", "dorian")
+ * @param hand - "rh" (default) or "lh"
+ * @param octaves - Number of octaves (default 1)
+ * @returns Array of finger numbers, one per note. Empty array if no fingering available.
+ */
+export function scaleAutoFingering(root, scaleType, hand = "rh", octaves = 1) {
+    const type = scaleType.toLowerCase().replace(/\s+/g, " ").trim();
+    // Map scale types to fingering tables
+    let table;
+    if (type === "major" || type === "ionian") {
+        table = MAJOR_FINGERINGS;
+    }
+    else if (type === "minor" || type === "natural minor" ||
+        type === "harmonic minor" || type === "minor harmonic" ||
+        type === "melodic minor" || type === "minor melodic" ||
+        type === "aeolian") {
+        table = MINOR_FINGERINGS;
+    }
+    else if (type === "dorian" || type === "mixolydian" || type === "phrygian" ||
+        type === "lydian" || type === "locrian") {
+        // Modal scales use the fingering of their parent major/minor key.
+        // For simplicity, use the relative major fingering pattern rotated.
+        // This is an approximation — use the minor table as a reasonable default.
+        table = MINOR_FINGERINGS;
+    }
+    else {
+        // Pentatonic, blues, whole tone, etc. — no standard fingering
+        return [];
+    }
+    // Look up the pattern: try original root, then flat equivalent, then sharp
+    let pattern = table[root];
+    if (!pattern) {
+        const sharp = FLAT_TO_SHARP[root];
+        if (sharp)
+            pattern = table[sharp];
+    }
+    if (!pattern) {
+        // Try reverse: if root is sharp, check if flat version exists
+        for (const [flat, sharp] of Object.entries(FLAT_TO_SHARP)) {
+            if (sharp === root) {
+                pattern = table[flat];
+                break;
+            }
+        }
+    }
+    if (!pattern)
+        return [];
+    const oneOctave = hand === "rh" ? pattern.rh : pattern.lh;
+    if (octaves <= 1)
+        return oneOctave;
+    // Multi-octave: repeat the inner pattern (notes 1-7), then cap with final finger.
+    // Pattern is 8 notes: [start...middle...end]. For continuation:
+    // - Octave 1: notes 0-6 (drop the 8th — it becomes the 1st of next octave)
+    // - Octave 2..N-1: same
+    // - Final octave: full 8 notes
+    const result = [];
+    for (let oct = 0; oct < octaves; oct++) {
+        if (oct < octaves - 1) {
+            // Not the last octave: use first 7 fingers (skip the tonic repeat)
+            result.push(...oneOctave.slice(0, 7));
+        }
+        else {
+            // Last octave: use all 8 fingers
+            result.push(...oneOctave);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=scale-fingering.js.map

package/dist/engine/scale-fingering.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-fingering.js","sourceRoot":"","sources":["../../src/engine/scale-fingering.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,qEAAqE;AAErE,MAAM,gBAAgB,GAA0C;IAC9D,8CAA8C;IAC9C,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,+BAA+B;IAC/B,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,2CAA2C;IAC3C,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,yBAAyB;IACzB,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACtD,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;CACvD,CAAC;AAEF,qEAAqE;AACrE,sDAAsD;AAEtD,MAAM,gBAAgB,GAA0C;IAC9D,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,CAAC,EAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACtD,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACtD,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACtD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;IACpD,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,EAAC,CAAC,CAAC,EAAE;CACrD,CAAC;AAEF,qEAAqE;AAErE,MAAM,aAAa,GAA2B;IAC5C,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI;CACjD,CAAC;AAEF,SAAS,aAAa,CAAC,IAAY;IACjC,0EAA0E;IAC1E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,qEAAqE;AAErE;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,SAAiB,EACjB,OAAkB,IAAI,EACtB,UAAkB,CAAC;IAEnB,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEjE,sCAAsC;IACtC,IAAI,KAA4C,CAAC;IACjD,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1C,KAAK,GAAG,gBAAgB,CAAC;IAC3B,CAAC;SAAM,IACL,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,eAAe;QAC5C,IAAI,KAAK,gBAAgB,IAAI,IAAI,KAAK,gBAAgB;QACtD,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,eAAe;QACpD,IAAI,KAAK,SAAS,EAClB,CAAC;QACD,KAAK,GAAG,gBAAgB,CAAC;IAC3B,CAAC;SAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,UAAU;QACjE,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACnD,kEAAkE;QAClE,oEAAoE;QACpE,0EAA0E;QAC1E,KAAK,GAAG,gBAAgB,CAAC;IAC3B,CAAC;SAAM,CAAC;QACN,8DAA8D;QAC9D,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,2EAA2E;IAC3E,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,KAAK;YAAE,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,8DAA8D;QAC9D,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBAAC,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;gBAAC,MAAM;YAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IAExB,MAAM,SAAS,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAE1D,IAAI,OAAO,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAEnC,kFAAkF;IAClF,gEAAgE;IAChE,2EAA2E;IAC3E,wBAAwB;IACxB,+BAA+B;IAC/B,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC;QACvC,IAAI,GAAG,GAAG,OAAO,GAAG,CAAC,EAAE,CAAC;YACtB,mEAAmE;YACnE,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,iCAAiC;YACjC,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/engine/staff-constants.d.ts

@@ -0,0 +1,16 @@
+export declare const STAFF_LINE_SPACING = 8;
+export declare const HALF_STAFF_SPACING = 4;
+export declare const STAFF_WIDTH = 120;
+export declare const CLEF_AREA_WIDTH = 30;
+export declare const NOTE_COLUMN_X = 75;
+export declare const NOTE_HEAD_RX = 6.75;
+export declare const ACCIDENTAL_OFFSET = 14;
+export declare const SECOND_OFFSET: number;
+export declare const ACCIDENTAL_COL_WIDTH = 10;
+export declare const LEDGER_LINE_EXTEND = 7;
+export declare const LEDGER_LINE_STROKE = 1;
+export declare const STAFF_GAP = 20;
+export declare const STAFF_TOP_MARGIN = 22;
+export declare const STAFF_BOTTOM_MARGIN = 10;
+export declare const STAFF_LINE_STROKE = 0.8;
+export declare const BRACE_WIDTH = 8;

package/dist/engine/staff-constants.js

@@ -0,0 +1,20 @@
+// Staff notation dimensions (SVG pixels)
+export const STAFF_LINE_SPACING = 8;
+export const HALF_STAFF_SPACING = 4; // one diatonic step
+export const STAFF_WIDTH = 120;
+export const CLEF_AREA_WIDTH = 30;
+export const NOTE_COLUMN_X = 75;
+// Half-width of the notehead glyph (used for ledger line extent and second offsets).
+// Bravura wholeNote: 422 font units wide, scaled to STAFF_LINE_SPACING height (250→8px) = 13.5px → rx≈6.75
+export const NOTE_HEAD_RX = 6.75;
+export const ACCIDENTAL_OFFSET = 14;
+export const SECOND_OFFSET = NOTE_HEAD_RX * 2; // horizontal shift for seconds
+export const ACCIDENTAL_COL_WIDTH = 10; // width of one accidental column
+export const LEDGER_LINE_EXTEND = 7;
+export const LEDGER_LINE_STROKE = 1;
+export const STAFF_GAP = 20;
+export const STAFF_TOP_MARGIN = 22;
+export const STAFF_BOTTOM_MARGIN = 10;
+export const STAFF_LINE_STROKE = 0.8;
+export const BRACE_WIDTH = 8;
+//# sourceMappingURL=staff-constants.js.map

package/dist/engine/staff-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-constants.js","sourceRoot":"","sources":["../../src/engine/staff-constants.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,CAAC,oBAAoB;AACzD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,CAAC;AAClC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,CAAC;AAChC,qFAAqF;AACrF,2GAA2G;AAC3G,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,CAAC;AACjC,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,YAAY,GAAG,CAAC,CAAC,CAAC,+BAA+B;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC,CAAC,iCAAiC;AACzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC;AACpC,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAC;AACnC,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAC;AACtC,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC;AACrC,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC"}

package/dist/engine/staff-glyphs.d.ts

@@ -0,0 +1,17 @@
+export interface StaffGlyphSet {
+    name: string;
+    fontFamily: string;
+    glyphs: {
+        trebleClef: string;
+        bassClef: string;
+        sharp: string;
+        flat: string;
+        natural: string;
+        wholeNote: string;
+    };
+    brace: (height: number) => string;
+}
+export declare const BRAVURA_GLYPHS: StaffGlyphSet;
+export declare const PETALUMA_GLYPHS: StaffGlyphSet;
+export declare function getDefaultGlyphs(): StaffGlyphSet;
+export declare function setDefaultGlyphs(glyphs: StaffGlyphSet): void;

package/dist/engine/staff-glyphs.js

@@ -0,0 +1,59 @@
+// SMuFL (Standard Music Font Layout) glyph sets.
+//
+// Glyphs are addressed by Unicode codepoint and rendered as <text> with the
+// matching font-family. SMuFL fonts are designed so that 1 em = 4 staff
+// spaces, which means setting font-size = 4 * staffLineSpacing makes glyphs
+// render at the correct staff size with no per-glyph scaling.
+//
+// Required @font-face: consumers must load 'Bravura' / 'Petaluma' (or any
+// other SMuFL-compliant font) before rendering. The dev playground loads
+// woff2 files from /fonts/. See dev/index.html.
+const SMUFL = {
+    gClef: "",
+    fClef: "",
+    noteheadWhole: "",
+    accidentalSharp: "",
+    accidentalFlat: "",
+    accidentalNatural: "",
+};
+function synthesizedBrace(curl) {
+    return (height) => {
+        const mid = height / 2;
+        const q = height / 4;
+        return `M ${curl} 0 C ${curl - 4} ${q} 0 ${mid - 4} 0 ${mid} C 0 ${mid + 4} ${curl - 4} ${mid + q} ${curl} ${height}`;
+    };
+}
+export const BRAVURA_GLYPHS = {
+    name: "Bravura",
+    fontFamily: "Bravura, serif",
+    glyphs: {
+        trebleClef: SMUFL.gClef,
+        bassClef: SMUFL.fClef,
+        sharp: SMUFL.accidentalSharp,
+        flat: SMUFL.accidentalFlat,
+        natural: SMUFL.accidentalNatural,
+        wholeNote: SMUFL.noteheadWhole,
+    },
+    brace: synthesizedBrace(6),
+};
+export const PETALUMA_GLYPHS = {
+    name: "Petaluma",
+    fontFamily: "Petaluma, serif",
+    glyphs: {
+        trebleClef: SMUFL.gClef,
+        bassClef: SMUFL.fClef,
+        sharp: SMUFL.accidentalSharp,
+        flat: SMUFL.accidentalFlat,
+        natural: SMUFL.accidentalNatural,
+        wholeNote: SMUFL.noteheadWhole,
+    },
+    brace: synthesizedBrace(6),
+};
+let _defaultGlyphs = BRAVURA_GLYPHS;
+export function getDefaultGlyphs() {
+    return _defaultGlyphs;
+}
+export function setDefaultGlyphs(glyphs) {
+    _defaultGlyphs = glyphs;
+}
+//# sourceMappingURL=staff-glyphs.js.map

package/dist/engine/staff-glyphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"staff-glyphs.js","sourceRoot":"","sources":["../../src/engine/staff-glyphs.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,4EAA4E;AAC5E,wEAAwE;AACxE,4EAA4E;AAC5E,8DAA8D;AAC9D,EAAE;AACF,0EAA0E;AAC1E,yEAAyE;AACzE,gDAAgD;AAgBhD,MAAM,KAAK,GAAG;IACZ,KAAK,EAAE,GAAG;IACV,KAAK,EAAE,GAAG;IACV,aAAa,EAAE,GAAG;IAClB,eAAe,EAAE,GAAG;IACpB,cAAc,EAAE,GAAG;IACnB,iBAAiB,EAAE,GAAG;CACd,CAAC;AAEX,SAAS,gBAAgB,CAAC,IAAY;IACpC,OAAO,CAAC,MAAc,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,CAAC;QACvB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;QACrB,OAAO,KAAK,IAAI,QAAQ,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,IAAI,MAAM,EAAE,CAAC;IACxH,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAkB;IAC3C,IAAI,EAAE,SAAS;IACf,UAAU,EAAE,gBAAgB;IAC5B,MAAM,EAAE;QACN,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,KAAK,EAAE,KAAK,CAAC,eAAe;QAC5B,IAAI,EAAE,KAAK,CAAC,cAAc;QAC1B,OAAO,EAAE,KAAK,CAAC,iBAAiB;QAChC,SAAS,EAAE,KAAK,CAAC,aAAa;KAC/B;IACD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC3B,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,IAAI,EAAE,UAAU;IAChB,UAAU,EAAE,iBAAiB;IAC7B,MAAM,EAAE;QACN,UAAU,EAAE,KAAK,CAAC,KAAK;QACvB,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,KAAK,EAAE,KAAK,CAAC,eAAe;QAC5B,IAAI,EAAE,KAAK,CAAC,cAAc;QAC1B,OAAO,EAAE,KAAK,CAAC,iBAAiB;QAChC,SAAS,EAAE,KAAK,CAAC,aAAa;KAC/B;IACD,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;CAC3B,CAAC;AAEF,IAAI,cAAc,GAAkB,cAAc,CAAC;AAEnD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IACpD,cAAc,GAAG,MAAM,CAAC;AAC1B,CAAC"}

package/dist/engine/staff-layout.d.ts

@@ -0,0 +1,28 @@
+export interface StaffNote {
+    pitchClass: string;
+    octave: number;
+    staff: "treble" | "bass";
+    y: number;
+    noteX: number;
+    accidental: "sharp" | "flat" | null;
+    accidentalX: number;
+    ledgerLines: number[];
+    diatonicPos: number;
+}
+export interface StaffLayoutResult {
+    notes: StaffNote[];
+    staffMode: "treble" | "bass" | "grand";
+    totalHeight: number;
+    totalWidth: number;
+    trebleTopY: number;
+    bassTopY: number;
+}
+export interface StaffLayoutOptions {
+    lhNotes?: string[];
+    rhOctave?: number;
+    lhOctave?: number;
+    /** Pre-resolved octave-qualified notes (e.g. from keyboard layout).
+     *  Format: "C:4", "G#:5". Bypasses internal octave assignment. */
+    octaveQualifiedNotes?: string[];
+}
+export declare function computeStaffLayout(notes: string[], options?: StaffLayoutOptions): StaffLayoutResult;

package/dist/engine/staff-layout.js

@@ -0,0 +1,238 @@
+import { normalizeToSharps } from "./note-spelling";
+import { STAFF_LINE_SPACING, HALF_STAFF_SPACING, STAFF_WIDTH, STAFF_GAP, STAFF_TOP_MARGIN, STAFF_BOTTOM_MARGIN, NOTE_COLUMN_X, ACCIDENTAL_OFFSET, SECOND_OFFSET, ACCIDENTAL_COL_WIDTH, } from "./staff-constants";
+function parseOctaveQualified(notes) {
+    return notes.map((n) => {
+        const [pc, oct] = n.split(":");
+        return { pitchClass: normalizePitchClass(pc), octave: parseInt(oct, 10) };
+    });
+}
+const DIATONIC_INDEX = {
+    C: 0, D: 1, E: 2, F: 3, G: 4, A: 5, B: 6,
+};
+const TREBLE_BOTTOM_LINE_POS = 30; // E4
+const BASS_BOTTOM_LINE_POS = 18; // G2
+function normalizePitchClass(note) {
+    return normalizeToSharps(note);
+}
+function letterFromPitchClass(pc) {
+    return pc.replace("#", "").replace("b", "");
+}
+function noteToMidi(pitchClass, octave) {
+    const letter = letterFromPitchClass(pitchClass);
+    const chromaticBase = {
+        C: 0, D: 2, E: 4, F: 5, G: 7, A: 9, B: 11,
+    };
+    const base = chromaticBase[letter] ?? 0;
+    const acc = pitchClass.includes("#") ? 1 : pitchClass.includes("b") ? -1 : 0;
+    return (octave + 1) * 12 + base + acc;
+}
+function absoluteDiatonicPos(pitchClass, octave) {
+    const letter = letterFromPitchClass(pitchClass);
+    return octave * 7 + (DIATONIC_INDEX[letter] ?? 0);
+}
+function computeY(absolutePos, staffBottomLineY, refPos) {
+    return staffBottomLineY - (absolutePos - refPos) * HALF_STAFF_SPACING;
+}
+function computeLedgerLines(absolutePos, staffBottomLinePos, staffBottomLineY) {
+    const staffTopLinePos = staffBottomLinePos + 8;
+    const ledgers = [];
+    if (absolutePos < staffBottomLinePos) {
+        for (let pos = staffBottomLinePos - 2; pos >= absolutePos; pos -= 2) {
+            ledgers.push(computeY(pos, staffBottomLineY, staffBottomLinePos));
+        }
+    }
+    else if (absolutePos > staffTopLinePos) {
+        for (let pos = staffTopLinePos + 2; pos <= absolutePos; pos += 2) {
+            ledgers.push(computeY(pos, staffBottomLineY, staffBottomLinePos));
+        }
+    }
+    return ledgers;
+}
+function assignOctaves(notes, baseOctave) {
+    const result = [];
+    let currentOctave = baseOctave;
+    let prevDiatonic = -1;
+    for (const note of notes) {
+        const pc = normalizePitchClass(note);
+        const letter = letterFromPitchClass(pc);
+        const diatonic = DIATONIC_INDEX[letter] ?? 0;
+        if (prevDiatonic >= 0 && diatonic <= prevDiatonic) {
+            currentOctave++;
+        }
+        prevDiatonic = diatonic;
+        result.push({ pitchClass: pc, octave: currentOctave });
+    }
+    return result;
+}
+/**
+ * Standard engraving: when two adjacent notes form a second (1 diatonic step),
+ * the higher note shifts right so the noteheads sit side-by-side.
+ *
+ * Process bottom-to-top. When a note is exactly 1 diatonic step above
+ * the previous, and the previous was NOT offset, offset this one right.
+ * If the previous was already offset, don't offset this one (alternating pattern).
+ */
+function resolveNoteheadOffsets(notes) {
+    // Sort by diatonic position ascending (lowest first)
+    const sorted = [...notes].sort((a, b) => a.diatonicPos - b.diatonicPos);
+    const offsetSet = new Set();
+    for (let i = 1; i < sorted.length; i++) {
+        const gap = sorted[i].diatonicPos - sorted[i - 1].diatonicPos;
+        if (gap === 1) {
+            // Second interval — the upper note gets offset, unless the lower was already offset
+            if (!offsetSet.has(sorted[i - 1])) {
+                offsetSet.add(sorted[i]);
+                sorted[i].noteX = NOTE_COLUMN_X + SECOND_OFFSET;
+            }
+            // If lower was offset, upper stays normal (alternating)
+        }
+    }
+}
+/**
+ * Standard engraving accidental placement.
+ *
+ * Process notes top-to-bottom (highest pitch first). Each accidental
+ * tries the closest column to the notehead first (column 0 = just left of note).
+ * If that column is occupied by an accidental whose Y is too close (within
+ * ~3 staff spaces), try the next column further left.
+ *
+ * Also: if a note's notehead is offset right (second), its accidental
+ * must clear the offset notehead — so it starts from column 0 relative
+ * to the LEFT notehead position (normal noteX).
+ */
+function resolveAccidentalPositions(notes) {
+    const accNotes = notes
+        .filter((n) => n.accidental !== null)
+        .sort((a, b) => a.y - b.y); // top-to-bottom (lower Y = higher on staff)
+    if (accNotes.length === 0)
+        return;
+    // Track occupied columns: array of { column, y } entries
+    const occupied = [];
+    // Minimum Y distance before two accidentals can share a column
+    const minYGap = STAFF_LINE_SPACING * 2.5;
+    for (const note of accNotes) {
+        // Base X: just left of the notehead. If any note is offset right,
+        // accidentals should clear it by starting further left.
+        const hasOffsetNeighbor = notes.some((n) => n.noteX > NOTE_COLUMN_X && Math.abs(n.y - note.y) < STAFF_LINE_SPACING * 2);
+        const startCol = hasOffsetNeighbor ? 1 : 0;
+        let col = startCol;
+        // eslint-disable-next-line no-constant-condition
+        while (true) {
+            const conflict = occupied.some((o) => o.col === col && Math.abs(o.y - note.y) < minYGap);
+            if (!conflict)
+                break;
+            col++;
+        }
+        occupied.push({ col, y: note.y });
+        note.accidentalX = NOTE_COLUMN_X - ACCIDENTAL_OFFSET - col * ACCIDENTAL_COL_WIDTH;
+    }
+}
+export function computeStaffLayout(notes, options = {}) {
+    const { lhNotes, rhOctave = 4, lhOctave = 3, octaveQualifiedNotes } = options;
+    let allWithOctaves;
+    let lhNotesList;
+    if (octaveQualifiedNotes) {
+        // Use pre-resolved octaves — bypass internal assignment
+        allWithOctaves = parseOctaveQualified(octaveQualifiedNotes);
+        lhNotesList = lhNotes ?? [];
+    }
+    else {
+        const rhNotesList = lhNotes
+            ? notes.filter((n) => !lhNotes.includes(n))
+            : notes;
+        lhNotesList = lhNotes ?? [];
+        const rhWithOctaves = assignOctaves(rhNotesList, rhOctave);
+        const lhWithOctaves = assignOctaves(lhNotesList, lhOctave);
+        allWithOctaves = [...lhWithOctaves, ...rhWithOctaves];
+    }
+    // Determine clef based on where the majority of notes sit.
+    // A3 = MIDI 57, C4 = MIDI 60.
+    // If explicitly split (LH/RH), use grand staff.
+    // Otherwise, use predominance: count notes above vs at-or-below the midpoint.
+    const hasExplicitSplit = lhNotes && lhNotes.length > 0;
+    const midpoint = 57; // A3 — notes above here lean treble, at/below lean bass
+    const trebleCount = allWithOctaves.filter((n) => noteToMidi(n.pitchClass, n.octave) > midpoint).length;
+    const bassCount = allWithOctaves.filter((n) => noteToMidi(n.pitchClass, n.octave) <= midpoint).length;
+    let staffMode;
+    if (hasExplicitSplit) {
+        // Explicit LH/RH split → grand staff
+        staffMode = "grand";
+    }
+    else if (trebleCount > 0 && bassCount > 0) {
+        // Notes span both ranges — use predominance
+        staffMode = trebleCount >= bassCount ? "treble" : "bass";
+    }
+    else if (trebleCount > 0) {
+        staffMode = "treble";
+    }
+    else {
+        staffMode = "bass";
+    }
+    const trebleBottomLineY = STAFF_TOP_MARGIN + STAFF_LINE_SPACING * 4;
+    const bassTopLineY = staffMode === "grand"
+        ? trebleBottomLineY + STAFF_GAP
+        : staffMode === "bass"
+            ? STAFF_TOP_MARGIN
+            : -1;
+    const bassBottomLineY = bassTopLineY >= 0 ? bassTopLineY + STAFF_LINE_SPACING * 4 : -1;
+    const trebleTopY = staffMode !== "bass" ? STAFF_TOP_MARGIN : -1;
+    const bassTopY = bassTopLineY;
+    const staffNotes = allWithOctaves.map((n) => {
+        const midi = noteToMidi(n.pitchClass, n.octave);
+        const isLH = lhNotes
+            ? lhNotesList.some((lh) => normalizePitchClass(lh) === n.pitchClass)
+            : midi < 60;
+        let staff;
+        let bottomLineY;
+        let bottomLinePos;
+        if (isLH && staffMode !== "treble") {
+            staff = "bass";
+            bottomLineY = bassBottomLineY;
+            bottomLinePos = BASS_BOTTOM_LINE_POS;
+        }
+        else {
+            staff = "treble";
+            bottomLineY = trebleBottomLineY;
+            bottomLinePos = TREBLE_BOTTOM_LINE_POS;
+        }
+        const diatonicPos = absoluteDiatonicPos(n.pitchClass, n.octave);
+        const y = computeY(diatonicPos, bottomLineY, bottomLinePos);
+        const ledgerLines = computeLedgerLines(diatonicPos, bottomLinePos, bottomLineY);
+        const accidental = n.pitchClass.includes("#")
+            ? "sharp"
+            : n.pitchClass.includes("b")
+                ? "flat"
+                : null;
+        return {
+            pitchClass: n.pitchClass,
+            octave: n.octave,
+            staff,
+            y,
+            noteX: NOTE_COLUMN_X,
+            accidental,
+            accidentalX: NOTE_COLUMN_X - ACCIDENTAL_OFFSET,
+            ledgerLines,
+            diatonicPos,
+        };
+    });
+    // Resolve notehead offsets for seconds
+    resolveNoteheadOffsets(staffNotes);
+    // Resolve accidental column positions
+    resolveAccidentalPositions(staffNotes);
+    // Total height
+    const lastLineY = staffMode === "bass" || staffMode === "grand"
+        ? bassBottomLineY
+        : trebleBottomLineY;
+    const maxNoteY = Math.max(lastLineY, ...staffNotes.map((n) => n.y));
+    const maxLedgerY = Math.max(lastLineY, ...staffNotes.flatMap((n) => n.ledgerLines));
+    const totalHeight = Math.max(maxNoteY, maxLedgerY) + STAFF_BOTTOM_MARGIN + HALF_STAFF_SPACING;
+    return {
+        notes: staffNotes,
+        staffMode,
+        totalHeight,
+        totalWidth: STAFF_WIDTH,
+        trebleTopY,
+        bassTopY,
+    };
+}
+//# sourceMappingURL=staff-layout.js.map

package/dist/engine/staff-layout.js.map

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

package/dist/engine/svg-constants.d.ts

@@ -0,0 +1,19 @@
+export declare const WHITE_KEY_WIDTH = 23;
+export declare const WHITE_KEY_WIDTH_EXACT = 25.3;
+export declare const WHITE_KEY_HEIGHT_COMPACT = 65;
+export declare const WHITE_KEY_HEIGHT_EXACT = 120;
+export declare const WHITE_KEY_RY = 3;
+export declare const BLACK_KEY_WIDTH = 13;
+export declare const BLACK_KEY_WIDTH_EXACT = 14.3;
+export declare const BLACK_KEY_HEIGHT_COMPACT = 40;
+export declare const BLACK_KEY_HEIGHT_EXACT = 80;
+export declare const BLACK_KEY_RY = 1;
+export declare const DEFAULT_WHITE_FILL = "#fafafa";
+export declare const DEFAULT_BLACK_FILL = "#222222";
+export declare const DEFAULT_STROKE = "#333333";
+export declare const DEFAULT_STROKE_WIDTH = 1;
+export declare const BLACK_KEY_OFFSETS: Record<string, number>;
+export declare const BLACK_KEY_OFFSETS_EXACT: Record<string, number>;
+export declare const WHITE_NOTES_WITH_SHARPS: Set<string>;
+export declare const FLAT_TO_SHARP: Record<string, string>;
+export declare const WHITE_NOTE_ORDER: readonly ["C", "D", "E", "F", "G", "A", "B"];

package/dist/engine/svg-constants.js

@@ -0,0 +1,40 @@
+export const WHITE_KEY_WIDTH = 23;
+export const WHITE_KEY_WIDTH_EXACT = 25.3;
+export const WHITE_KEY_HEIGHT_COMPACT = 65;
+export const WHITE_KEY_HEIGHT_EXACT = 120;
+export const WHITE_KEY_RY = 3;
+export const BLACK_KEY_WIDTH = 13;
+export const BLACK_KEY_WIDTH_EXACT = 14.3;
+export const BLACK_KEY_HEIGHT_COMPACT = 40;
+export const BLACK_KEY_HEIGHT_EXACT = 80;
+export const BLACK_KEY_RY = 1;
+export const DEFAULT_WHITE_FILL = "#fafafa";
+export const DEFAULT_BLACK_FILL = "#222222";
+export const DEFAULT_STROKE = "#333333";
+export const DEFAULT_STROKE_WIDTH = 1;
+// Black key x-offsets relative to the left edge of the parent white key
+export const BLACK_KEY_OFFSETS = {
+    C: 14.33,
+    D: 18.67,
+    F: 13.25,
+    G: 16.25,
+    A: 19.75,
+};
+export const BLACK_KEY_OFFSETS_EXACT = {
+    C: 15.76,
+    D: 20.54,
+    F: 14.58,
+    G: 17.88,
+    A: 21.73,
+};
+// Which white notes have a black key to their right
+export const WHITE_NOTES_WITH_SHARPS = new Set(["C", "D", "F", "G", "A"]);
+export const FLAT_TO_SHARP = {
+    Db: "C#",
+    Eb: "D#",
+    Gb: "F#",
+    Ab: "G#",
+    Bb: "A#",
+};
+export const WHITE_NOTE_ORDER = ["C", "D", "E", "F", "G", "A", "B"];
+//# sourceMappingURL=svg-constants.js.map