@pepperhorn/chordl-guitar 0.2.0

package/dist/generatedShapes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Generated (not stored) shapes: bass root-fifth-octave patterns and violin
+ * first-position placements.
+ *
+ * chords-db covers guitar and ukulele only, and neither instrument here wants
+ * a database anyway:
+ *
+ * - A bass line is built from patterns, not strummed chords. The teachable
+ *   unit is the root-fifth-octave shape, which is the same movable pattern
+ *   for every root — so it is computed from the root, and the computation IS
+ *   the lesson.
+ * - Violin chord tones in first position are fully determined by the tuning
+ *   and the first-position reach (open + four fingers ≈ 0-7 semitones above
+ *   the open string). Given a chord's pitch classes, each string's nearest
+ *   chord tone is arithmetic, not curation.
+ *
+ * Both return svguitar `Chord` objects so they render through exactly the
+ * same pipeline as the chords-db shapes.
+ */
+import type { Chord } from "svguitar";
+export declare function bassShapeFor(root: string): Chord | null;
+/**
+ * Violin first-position shape for a chord's pitch classes.
+ *
+ * The placement is chosen across all four strings at once, not string by
+ * string. Picking each string's *nearest* chord tone independently is the
+ * obvious approach and it is wrong: on A major the G string's nearest tone is
+ * A, the D string's is E, and both open strings are already A and E, so the
+ * card sounds A-E-A-E and the third never appears. That greedy version
+ * silently dropped a chord tone in 32 of the 60 chords this library generates,
+ * including the root of C7, B7 and F#7. A chord card that omits the third is
+ * not teaching the chord.
+ *
+ * So: enumerate every assignment (each string plays one reachable chord tone
+ * or is silent) and rank them by
+ *   1. how many DISTINCT chord tones sound — the thing that was broken;
+ *   2. how many strings sound at all — prefer a fuller chord;
+ *   3. total semitone offset — prefer the lower, easier hand shape;
+ *   4. the offsets read low-string-first, purely so the result is stable.
+ * Four strings with at most five options each is 625 combinations at worst,
+ * so the exhaustive search costs nothing and removes the whole class of bug.
+ *
+ * A tone can still be unreachable — with only 0-7 semitones above four fixed
+ * open strings, not every chord fits — so criterion 1 maximises coverage
+ * rather than guaranteeing it. `violinCoverage` reports what was achieved.
+ *
+ * The diagram's "fret" axis is semitones above the open string; markers are
+ * labelled with VIOLIN finger numbers via `violinFingerFor`, not guitar
+ * fingerings.
+ */
+export declare function violinShapeFor(pitchClasses: string[]): Chord | null;
+/**
+ * Which of a chord's pitch classes the first-position shape actually sounds.
+ *
+ * Exists so callers and tests can assert coverage instead of trusting it —
+ * the bug this replaced was invisible precisely because nothing measured it.
+ */
+export declare function violinCoverage(pitchClasses: string[]): {
+    sounded: number[];
+    missing: number[];
+} | null;

package/dist/generatedShapes.js

@@ -0,0 +1,212 @@
+/**
+ * Generated (not stored) shapes: bass root-fifth-octave patterns and violin
+ * first-position placements.
+ *
+ * chords-db covers guitar and ukulele only, and neither instrument here wants
+ * a database anyway:
+ *
+ * - A bass line is built from patterns, not strummed chords. The teachable
+ *   unit is the root-fifth-octave shape, which is the same movable pattern
+ *   for every root — so it is computed from the root, and the computation IS
+ *   the lesson.
+ * - Violin chord tones in first position are fully determined by the tuning
+ *   and the first-position reach (open + four fingers ≈ 0-7 semitones above
+ *   the open string). Given a chord's pitch classes, each string's nearest
+ *   chord tone is arithmetic, not curation.
+ *
+ * Both return svguitar `Chord` objects so they render through exactly the
+ * same pipeline as the chords-db shapes.
+ */
+const PC = {
+    C: 0, "C#": 1, Db: 1, D: 2, "D#": 3, Eb: 3, E: 4, F: 5, "F#": 6, Gb: 6,
+    G: 7, "G#": 8, Ab: 8, A: 9, "A#": 10, Bb: 10, B: 11,
+};
+/**
+ * Bass root-fifth-octave shape for one root, placed where it sounds good.
+ *
+ * The root always lands FRETTED between the 3rd and 9th fret — never on an
+ * open string and never crammed against the nut. Two reasons, both audible:
+ * open-position roots boom and mud on a bass, and the whole point of the
+ * pattern is that it is movable, which an open string breaks (you cannot
+ * slide an open E up a tone). E string is preferred when its root fret sits
+ * in the sweet range; otherwise the A string's does (every root lands in
+ * 3-9 on one of the two).
+ *
+ * The window slides to the root (chords-db convention, matching
+ * `dbPositionToChord`: `position` is the window's first fret, finger frets
+ * window-relative) — D at the 5th fret is the same shape as G at the 3rd.
+ *
+ * svguitar strings are numbered from the highest pitch: 1=G, 2=D, 3=A, 4=E.
+ * Fingers carry the conventional one-finger-per-fret labels: root 1,
+ * fifth 3, octave 4.
+ */
+const BASS_SWEET_LOW = 3;
+const BASS_SWEET_HIGH = 9;
+export function bassShapeFor(root) {
+    const pc = PC[root];
+    if (pc === undefined)
+        return null;
+    const fretOnE = (pc - PC.E + 12) % 12;
+    const fretOnA = (pc - PC.A + 12) % 12;
+    const sweet = (f) => f >= BASS_SWEET_LOW && f <= BASS_SWEET_HIGH;
+    const onEString = sweet(fretOnE) || !sweet(fretOnA);
+    const rootFret = onEString ? fretOnE : fretOnA;
+    // [rootString, fifthString, octaveString] in svguitar numbering.
+    const [rootS, fifthS, octaveS] = onEString ? [4, 3, 2] : [3, 2, 1];
+    const mutedS = onEString ? 1 : 4;
+    // Slide the window to the root whenever the pattern outgrows the nut view.
+    const slide = rootFret + 2 > 6;
+    const position = slide ? rootFret : 1;
+    const rel = (abs) => (slide ? abs - rootFret + 1 : abs);
+    return {
+        fingers: [
+            [rootS, rel(rootFret), "1"],
+            [fifthS, rel(rootFret + 2), "3"],
+            [octaveS, rel(rootFret + 2), "4"],
+            [mutedS, "x"],
+        ],
+        barres: [],
+        position,
+    };
+}
+/**
+ * First-position reach: how far above the open string each violin finger
+ * falls, in semitones. Low/high placements share a finger — offset 1 or 2 is
+ * first finger, 3 or 4 second, and so on — which is exactly how first
+ * position is named on a fingering chart.
+ */
+function violinFingerFor(offset) {
+    if (offset === 0)
+        return null; // open string: nut ring, no label
+    if (offset <= 2)
+        return "1";
+    if (offset <= 4)
+        return "2";
+    if (offset <= 6)
+        return "3";
+    return "4"; // offset 7 — fourth finger, the octave of the next string down
+}
+const FIRST_POSITION_REACH = 7;
+/**
+ * Violin first-position shape for a chord's pitch classes.
+ *
+ * The placement is chosen across all four strings at once, not string by
+ * string. Picking each string's *nearest* chord tone independently is the
+ * obvious approach and it is wrong: on A major the G string's nearest tone is
+ * A, the D string's is E, and both open strings are already A and E, so the
+ * card sounds A-E-A-E and the third never appears. That greedy version
+ * silently dropped a chord tone in 32 of the 60 chords this library generates,
+ * including the root of C7, B7 and F#7. A chord card that omits the third is
+ * not teaching the chord.
+ *
+ * So: enumerate every assignment (each string plays one reachable chord tone
+ * or is silent) and rank them by
+ *   1. how many DISTINCT chord tones sound — the thing that was broken;
+ *   2. how many strings sound at all — prefer a fuller chord;
+ *   3. total semitone offset — prefer the lower, easier hand shape;
+ *   4. the offsets read low-string-first, purely so the result is stable.
+ * Four strings with at most five options each is 625 combinations at worst,
+ * so the exhaustive search costs nothing and removes the whole class of bug.
+ *
+ * A tone can still be unreachable — with only 0-7 semitones above four fixed
+ * open strings, not every chord fits — so criterion 1 maximises coverage
+ * rather than guaranteeing it. `violinCoverage` reports what was achieved.
+ *
+ * The diagram's "fret" axis is semitones above the open string; markers are
+ * labelled with VIOLIN finger numbers via `violinFingerFor`, not guitar
+ * fingerings.
+ */
+export function violinShapeFor(pitchClasses) {
+    const tones = pitchClasses.map((p) => PC[p]);
+    if (tones.some((t) => t === undefined) || tones.length === 0)
+        return null;
+    const wanted = [...new Set(tones)];
+    // Low to high: G D A E; svguitar numbering: 4=G, 3=D, 2=A, 1=E.
+    const strings = [
+        { svguitarString: 4, openPc: PC.G },
+        { svguitarString: 3, openPc: PC.D },
+        { svguitarString: 2, openPc: PC.A },
+        { svguitarString: 1, openPc: PC.E },
+    ];
+    // Per string: every reachable chord tone, plus silence. Within a 0-7 window
+    // a pitch class occurs at most once, so one offset per tone per string.
+    const choices = strings.map(({ openPc }) => {
+        const opts = [];
+        for (const tone of wanted) {
+            const offset = (tone - openPc + 12) % 12;
+            if (offset <= FIRST_POSITION_REACH)
+                opts.push({ offset, tone });
+        }
+        opts.push(null); // silent — better than inventing a placement out of position
+        return opts;
+    });
+    // Cartesian product of the per-string options. Four strings, at most five
+    // options each — 625 combinations at the absolute worst.
+    let combos = [[]];
+    for (const opts of choices) {
+        const next = [];
+        for (const combo of combos)
+            for (const opt of opts)
+                next.push([...combo, opt]);
+        combos = next;
+    }
+    let best = null;
+    for (const picks of combos) {
+        const sounded = picks.filter((p) => p !== null);
+        const covered = new Set(sounded.map((p) => p.tone)).size;
+        const total = sounded.reduce((n, p) => n + p.offset, 0);
+        // Negated where higher is better, so the whole score compares smallest-first.
+        const score = [
+            -covered,
+            -sounded.length,
+            total,
+            ...picks.map((p) => (p === null ? 99 : p.offset)),
+        ];
+        if (best === null || lessThan(score, best.score))
+            best = { picks, score };
+    }
+    if (best === null)
+        return null;
+    const fingers = best.picks.map((pick, i) => {
+        const s = strings[i].svguitarString;
+        if (pick === null)
+            return [s, "x"];
+        const label = violinFingerFor(pick.offset);
+        return label ? [s, pick.offset, label] : [s, pick.offset];
+    });
+    return { fingers, barres: [] };
+}
+/**
+ * Which of a chord's pitch classes the first-position shape actually sounds.
+ *
+ * Exists so callers and tests can assert coverage instead of trusting it —
+ * the bug this replaced was invisible precisely because nothing measured it.
+ */
+export function violinCoverage(pitchClasses) {
+    const shape = violinShapeFor(pitchClasses);
+    if (shape === null)
+        return null;
+    const wanted = [...new Set(pitchClasses.map((p) => PC[p]))];
+    const openPcs = [PC.E, PC.A, PC.D, PC.G]; // svguitar string 1..4
+    const sounded = new Set();
+    for (const f of shape.fingers) {
+        if (f[1] === "x")
+            continue;
+        sounded.add((openPcs[Number(f[0]) - 1] + Number(f[1])) % 12);
+    }
+    return {
+        sounded: [...sounded].sort((a, b) => a - b),
+        missing: wanted.filter((t) => !sounded.has(t)).sort((a, b) => a - b),
+    };
+}
+/** Lexicographic compare for the ranking tuple above. */
+function lessThan(a, b) {
+    for (let i = 0; i < Math.max(a.length, b.length); i++) {
+        const x = a[i] ?? 0;
+        const y = b[i] ?? 0;
+        if (x !== y)
+            return x < y;
+    }
+    return false;
+}
+//# sourceMappingURL=generatedShapes.js.map

package/dist/generatedShapes.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+export { INSTRUMENTS, dbPositionToChord } from "./instruments.js";
+export type { InstrumentId, InstrumentConfig, ChordsDb, ChordsDbEntry, ChordsDbPosition, } from "./instruments.js";
+export { lookupGuitarChord, hasGuitarChord } from "./chordLookup.js";
+export type { GuitarChordResult } from "./chordLookup.js";
+export { GUITAR_TOP3_PRESETS, lookupTop3Chord } from "./staticPresets.js";
+export type { StaticPreset } from "./staticPresets.js";
+export { positionToMidi, rootPitchClass } from "./pitch.js";
+export { positionFacts, duplicateVoicingMap } from "./voicingFacts.js";
+export type { Inversion, PositionFacts } from "./voicingFacts.js";
+export { matchesShapeClass, canonicalPositionIndex, selectVoicings, SHAPE_CLASS_LADDER, } from "./voicingSelect.js";
+export type { ShapeClass, CanonicalOptions, VoicingChoice, SelectVoicingsOptions, SelectVoicingsResult, } from "./voicingSelect.js";
+export { powerChordPosition, powerChordShape } from "./powerChords.js";
+export type { PowerChordStringSet, PowerChordOptions } from "./powerChords.js";
+export { bassShapeFor, violinShapeFor, violinCoverage } from "./generatedShapes.js";

package/dist/index.js

@@ -0,0 +1,14 @@
+// @pepperhorn/chordl-guitar — guitar chord-shape lookup and svguitar diagram data.
+//
+// Backed by @tombatossals/chords-db; returns every stored fret position for a
+// chord (alternate placements). Shapes convert to svguitar `Chord` objects for
+// rendering. Based on pepperhorn/frames.
+export { INSTRUMENTS, dbPositionToChord } from "./instruments.js";
+export { lookupGuitarChord, hasGuitarChord } from "./chordLookup.js";
+export { GUITAR_TOP3_PRESETS, lookupTop3Chord } from "./staticPresets.js";
+export { positionToMidi, rootPitchClass } from "./pitch.js";
+export { positionFacts, duplicateVoicingMap } from "./voicingFacts.js";
+export { matchesShapeClass, canonicalPositionIndex, selectVoicings, SHAPE_CLASS_LADDER, } from "./voicingSelect.js";
+export { powerChordPosition, powerChordShape } from "./powerChords.js";
+export { bassShapeFor, violinShapeFor, violinCoverage } from "./generatedShapes.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,yCAAyC;AAEzC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AASlE,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGrE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1E,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5D,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,cAAc,EACd,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAS5B,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAGvE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/instruments.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Instrument configs + chords-db types + position→svguitar conversion.
+ *
+ * Ported/adapted from pepperhorn/frames (src/lib/instruments.ts). chords-db
+ * ships guitar and ukulele voicing libraries; we start with guitar and keep the
+ * config table so ukulele is a small follow-up.
+ */
+import type { Chord } from "svguitar";
+export type InstrumentId = "guitar" | "ukulele" | "guitar-top3" | "bass4" | "bass5" | "violin";
+export interface InstrumentConfig {
+    id: InstrumentId;
+    label: string;
+    description: string;
+    strings: number;
+    /** Default number of frets to draw. */
+    frets: number;
+    /** Open-string tuning, low → high. */
+    tuning: string[];
+    /**
+     * Open-string MIDI numbers in **chords-db index order** — `openMidi[i]` is
+     * the string that `frets[i]` refers to. This is NOT svguitar's string
+     * numbering, which runs highest-pitch-first; `dbPositionToChord` is the one
+     * place that inverts. Ukulele's reentrant high-G means the array is not
+     * ascending, so the order cannot be recovered by sorting.
+     */
+    openMidi: number[];
+}
+export declare const INSTRUMENTS: Record<InstrumentId, InstrumentConfig>;
+export interface ChordsDbPosition {
+    /** Per-string fret, low→high. -1 = muted, 0 = open, else absolute-ish (see baseFret). */
+    frets: number[];
+    /** Per-string finger number (0 = none). */
+    fingers: number[];
+    /** Lowest fret the diagram window starts on (1 = nut). */
+    baseFret: number;
+    /** Fret numbers that carry a barre. */
+    barres: number[];
+    capo?: boolean;
+    midi?: number[];
+}
+export interface ChordsDbEntry {
+    key: string;
+    suffix: string;
+    positions: ChordsDbPosition[];
+}
+export interface ChordsDb {
+    main: {
+        strings: number;
+        fretsOnChord: number;
+        name: string;
+        numberOfChords: number;
+    };
+    tunings: Record<string, string[]>;
+    keys: string[];
+    suffixes: string[];
+    chords: Record<string, ChordsDbEntry[]>;
+}
+/**
+ * Convert a chords-db position into an svguitar Chord (fingers + barres +
+ * window position). Ported from pepperhorn/frames.
+ *
+ * @param pos - chords-db position
+ * @param stringCount - number of strings (6 guitar, 4 ukulele)
+ * @param title - optional diagram title
+ */
+export declare function dbPositionToChord(pos: ChordsDbPosition, stringCount: number, title?: string): Chord;

package/dist/instruments.js

@@ -0,0 +1,114 @@
+export const INSTRUMENTS = {
+    guitar: {
+        id: "guitar",
+        label: "Guitar",
+        description: "Standard 6-string guitar (E A D G B E)",
+        strings: 6,
+        frets: 5,
+        tuning: ["E", "A", "D", "G", "B", "E"],
+        openMidi: [40, 45, 50, 55, 59, 64],
+    },
+    ukulele: {
+        id: "ukulele",
+        label: "Ukulele",
+        description: "Standard ukulele (G C E A)",
+        strings: 4,
+        frets: 5,
+        tuning: ["G", "C", "E", "A"],
+        openMidi: [67, 60, 64, 69],
+    },
+    "guitar-top3": {
+        id: "guitar-top3",
+        label: "Guitar (top 3)",
+        description: "Six-string guitar, beginner voicings on the top three strings only (G B E). " +
+            "Strings 4-6 are muted at render time.",
+        strings: 6,
+        frets: 4,
+        tuning: ["E", "A", "D", "G", "B", "E"],
+        openMidi: [40, 45, 50, 55, 59, 64],
+    },
+    bass4: {
+        id: "bass4",
+        label: "Bass (4-string)",
+        description: "Standard 4-string bass (E A D G). Also the instrument `bassShapeFor` " +
+            "targets: generated root-fifth-octave patterns rather than chords-db " +
+            "lookups, because a bass card teaches the pattern, not a strum.",
+        strings: 4,
+        // Six, not five: the generated root-fifth-octave patterns reach a sixth
+        // fret, and this count is what consumers draw the window from. Five clips
+        // them. See generatedShapes.bassShapeFor and its test.
+        frets: 6,
+        tuning: ["E", "A", "D", "G"],
+        openMidi: [28, 33, 38, 43],
+    },
+    bass5: {
+        id: "bass5",
+        label: "Bass (5-string)",
+        description: "5-string bass with low B (B E A D G)",
+        strings: 5,
+        frets: 5,
+        tuning: ["B", "E", "A", "D", "G"],
+        openMidi: [23, 28, 33, 38, 43],
+    },
+    violin: {
+        id: "violin",
+        label: "Violin",
+        description: "Violin in first position (G D A E). The \"fret\" axis is semitones above the " +
+            "open string (0-7, the first-position reach); markers carry violin finger " +
+            "numbers, not guitar fingerings. Generated from chord tones — see generatedShapes.",
+        strings: 4,
+        frets: 7,
+        tuning: ["G", "D", "A", "E"],
+        openMidi: [55, 62, 69, 76],
+    },
+};
+/**
+ * Convert a chords-db position into an svguitar Chord (fingers + barres +
+ * window position). Ported from pepperhorn/frames.
+ *
+ * @param pos - chords-db position
+ * @param stringCount - number of strings (6 guitar, 4 ukulele)
+ * @param title - optional diagram title
+ */
+export function dbPositionToChord(pos, stringCount, title) {
+    const fingers = [];
+    const barreFrets = new Set(pos.barres);
+    pos.frets.forEach((fret, dbIdx) => {
+        // chords-db lists strings low→high; svguitar numbers strings high→low.
+        const stringNum = stringCount - dbIdx;
+        if (fret === -1) {
+            fingers.push([stringNum, "x"]);
+            return;
+        }
+        if (fret === 0) {
+            fingers.push([stringNum, 0]);
+            return;
+        }
+        // Skip strings covered by a barre — the barre draws them.
+        if (barreFrets.has(fret))
+            return;
+        const fingerNum = pos.fingers[dbIdx];
+        const text = fingerNum && fingerNum > 0 ? String(fingerNum) : undefined;
+        fingers.push(text ? [stringNum, fret, text] : [stringNum, fret]);
+    });
+    const barres = pos.barres.map((fret) => {
+        const playingIdxs = pos.frets
+            .map((f, i) => (f === fret ? i : -1))
+            .filter((i) => i >= 0);
+        const stringNums = playingIdxs.map((i) => stringCount - i);
+        const fromString = Math.max(...stringNums);
+        const toString = Math.min(...stringNums);
+        const fingerNums = playingIdxs
+            .map((i) => pos.fingers[i])
+            .filter((n) => typeof n === "number" && n > 0);
+        const fingerLabel = fingerNums.length ? String(Math.min(...fingerNums)) : undefined;
+        return { fromString, toString, fret, ...(fingerLabel ? { text: fingerLabel } : {}) };
+    });
+    return {
+        fingers,
+        barres,
+        position: pos.baseFret,
+        ...(title ? { title } : {}),
+    };
+}
+//# sourceMappingURL=instruments.js.map

package/dist/instruments.js.map

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

package/dist/pitch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Fret → pitch derivation.
+ *
+ * chords-db ships a `midi` array per position, but scripts/build-data.mjs
+ * strips it from the shipped JSON to cut bundle weight. Deriving rather than
+ * reviving keeps one pitch code path: the candidate szaza merge source ships
+ * no midi field at all, so derivation is required regardless.
+ */
+import type { ChordsDbPosition } from "./instruments.js";
+/**
+ * Sounding MIDI pitches for a chords-db position.
+ *
+ * `frets` values are relative to `baseFret`, not absolute fret numbers: a
+ * value of 1 at baseFret 3 sounds fret 3. Muted strings (-1) are omitted;
+ * open strings (0) sound the open pitch regardless of the diagram window.
+ *
+ * `capo` is deliberately ignored — it is a rendering hint (draw a bar), not a
+ * pitch offset. All 901 capo-flagged guitar positions reproduce chords-db's
+ * own `midi` array exactly without it; see test/pitch-golden.test.ts.
+ *
+ * @param pos - chords-db position
+ * @param openMidi - open-string MIDI in chords-db index order (InstrumentConfig.openMidi)
+ * @returns sounding pitches only, in chords-db string order
+ */
+export declare function positionToMidi(pos: ChordsDbPosition, openMidi: number[]): number[];
+/**
+ * Pitch class of a chord label's root, or null when unparseable.
+ *
+ * Derived from the requested label rather than from a chords-db `key` field:
+ * chords-db spells the same root inconsistently ("Csharp" as a container key,
+ * "C#" on the entry), and the label is what the caller actually asked for.
+ */
+export declare function rootPitchClass(label: string): number | null;

package/dist/pitch.js

@@ -0,0 +1,57 @@
+/**
+ * Sounding MIDI pitches for a chords-db position.
+ *
+ * `frets` values are relative to `baseFret`, not absolute fret numbers: a
+ * value of 1 at baseFret 3 sounds fret 3. Muted strings (-1) are omitted;
+ * open strings (0) sound the open pitch regardless of the diagram window.
+ *
+ * `capo` is deliberately ignored — it is a rendering hint (draw a bar), not a
+ * pitch offset. All 901 capo-flagged guitar positions reproduce chords-db's
+ * own `midi` array exactly without it; see test/pitch-golden.test.ts.
+ *
+ * @param pos - chords-db position
+ * @param openMidi - open-string MIDI in chords-db index order (InstrumentConfig.openMidi)
+ * @returns sounding pitches only, in chords-db string order
+ */
+export function positionToMidi(pos, openMidi) {
+    const out = [];
+    pos.frets.forEach((fret, i) => {
+        if (fret === -1)
+            return;
+        const open = openMidi[i];
+        if (open === undefined)
+            return;
+        out.push(fret === 0 ? open : open + pos.baseFret + fret - 1);
+    });
+    return out;
+}
+const PITCH_CLASSES = {
+    C: 0, "B#": 0,
+    "C#": 1, Db: 1,
+    D: 2,
+    "D#": 3, Eb: 3,
+    E: 4, Fb: 4,
+    F: 5, "E#": 5,
+    "F#": 6, Gb: 6,
+    G: 7,
+    "G#": 8, Ab: 8,
+    A: 9,
+    "A#": 10, Bb: 10,
+    B: 11, Cb: 11,
+};
+/**
+ * Pitch class of a chord label's root, or null when unparseable.
+ *
+ * Derived from the requested label rather than from a chords-db `key` field:
+ * chords-db spells the same root inconsistently ("Csharp" as a container key,
+ * "C#" on the entry), and the label is what the caller actually asked for.
+ */
+export function rootPitchClass(label) {
+    const m = label.trim().match(/^([A-Ga-g][#b]?)/);
+    if (!m)
+        return null;
+    const root = m[1].charAt(0).toUpperCase() + m[1].slice(1);
+    const pc = PITCH_CLASSES[root];
+    return pc === undefined ? null : pc;
+}
+//# sourceMappingURL=pitch.js.map

package/dist/pitch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pitch.js","sourceRoot":"","sources":["../src/pitch.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,GAAqB,EAAE,QAAkB;IACtE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QAC5B,IAAI,IAAI,KAAK,CAAC,CAAC;YAAE,OAAO;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO;QAC/B,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,QAAQ,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,aAAa,GAA2B;IAC5C,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACb,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACd,CAAC,EAAE,CAAC;IACJ,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACd,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACX,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACb,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACd,CAAC,EAAE,CAAC;IACJ,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;IACd,CAAC,EAAE,CAAC;IACJ,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;IAChB,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACjD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IAC/B,OAAO,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC"}

package/dist/powerChords.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Movable power-chord (root + fifth + octave) shapes.
+ *
+ * chords-db has no power-chord suffix, so these cannot be looked up. They also
+ * need no curation: the shape is perfectly regular, so it derives from the
+ * instrument's open-string pitches. Output goes through dbPositionToChord so
+ * renderers see the same contract as any other shape.
+ */
+import type { Chord } from "svguitar";
+import type { ChordsDbPosition } from "./instruments.js";
+/** Which string carries the root. "E" = 6th string, "A" = 5th string. */
+export type PowerChordStringSet = "E" | "A";
+export interface PowerChordOptions {
+    stringSet: PowerChordStringSet;
+    /** Include the octave doubling on the next string up. Default true. */
+    includeOctave?: boolean;
+    title?: string;
+}
+/**
+ * Build a chords-db-shaped position for a power chord.
+ *
+ * @param rootPc - root pitch class, 0 = C
+ * @returns null when rootPc is out of range
+ */
+export declare function powerChordPosition(rootPc: number, opts: PowerChordOptions): ChordsDbPosition | null;
+/** The same shape as an svguitar Chord, ready to render. */
+export declare function powerChordShape(rootPc: number, opts: PowerChordOptions): Chord | null;