@pepperhorn/chordl-guitar 0.2.0

package/dist/powerChords.js

@@ -0,0 +1,41 @@
+import { INSTRUMENTS, dbPositionToChord } from "./instruments.js";
+const ROOT_STRING_INDEX = { E: 0, A: 1 };
+/**
+ * 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 function powerChordPosition(rootPc, opts) {
+    if (!Number.isInteger(rootPc) || rootPc < 0 || rootPc > 11)
+        return null;
+    const openMidi = INSTRUMENTS.guitar.openMidi;
+    const rootIdx = ROOT_STRING_INDEX[opts.stringSet];
+    const includeOctave = opts.includeOctave ?? true;
+    // Fret on the root string that sounds rootPc.
+    const fret = (rootPc - (openMidi[rootIdx] % 12) + 12) % 12;
+    // Open position keeps baseFret at the nut so the diagram shows the nut;
+    // elsewhere the window starts at the root fret and frets are window-relative.
+    const baseFret = fret === 0 ? 1 : fret;
+    const rootFret = fret === 0 ? 0 : 1;
+    const upperFret = fret === 0 ? 2 : 3;
+    const frets = new Array(6).fill(-1);
+    const fingers = new Array(6).fill(0);
+    frets[rootIdx] = rootFret;
+    fingers[rootIdx] = rootFret === 0 ? 0 : 1;
+    frets[rootIdx + 1] = upperFret;
+    fingers[rootIdx + 1] = fret === 0 ? 2 : 3;
+    if (includeOctave) {
+        frets[rootIdx + 2] = upperFret;
+        fingers[rootIdx + 2] = fret === 0 ? 3 : 4;
+    }
+    return { frets, fingers, baseFret, barres: [] };
+}
+/** The same shape as an svguitar Chord, ready to render. */
+export function powerChordShape(rootPc, opts) {
+    const pos = powerChordPosition(rootPc, opts);
+    if (!pos)
+        return null;
+    return dbPositionToChord(pos, INSTRUMENTS.guitar.strings, opts.title);
+}
+//# sourceMappingURL=powerChords.js.map

package/dist/powerChords.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"powerChords.js","sourceRoot":"","sources":["../src/powerChords.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAYlE,MAAM,iBAAiB,GAAwC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAE9E;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAc,EACd,IAAuB;IAEvB,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,EAAE;QAAE,OAAO,IAAI,CAAC;IAExE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC7C,MAAM,OAAO,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAClD,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC;IAEjD,8CAA8C;IAC9C,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAE3D,wEAAwE;IACxE,8EAA8E;IAC9E,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACvC,MAAM,QAAQ,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAErC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE7C,KAAK,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IAC1B,OAAO,CAAC,OAAO,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;IAC/B,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,IAAI,aAAa,EAAE,CAAC;QAClB,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC;QAC/B,OAAO,CAAC,OAAO,GAAG,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAClD,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,IAAuB;IACrE,MAAM,GAAG,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7C,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,iBAAiB,CAAC,GAAG,EAAE,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;AACxE,CAAC"}

package/dist/staticPresets.d.ts

@@ -0,0 +1,16 @@
+import type { Chord } from "svguitar";
+export interface StaticPreset {
+    key: string;
+    suffix: string;
+    chord: Chord;
+}
+/**
+ * Hand-authored beginner voicings on the top three strings (G B E).
+ *
+ * chords-db has no three-string voicings, so these cannot be derived — the table
+ * is the sole source. Every entry is checked against pitch-class arithmetic by
+ * staticPresets.test.ts, because a wrong shape is unrecoverable once printed.
+ */
+export declare const GUITAR_TOP3_PRESETS: StaticPreset[];
+/** Look up a top-3 shape. Returns null rather than guessing at an unknown chord. */
+export declare function lookupTop3Chord(key: string, suffix: string): Chord | null;

package/dist/staticPresets.js

@@ -0,0 +1,48 @@
+/** Strings 4-6 are always muted for top-3 voicings. */
+const MUTED_LOW = [[4, "x"], [5, "x"], [6, "x"]];
+function top3(key, suffix, g, b, e) {
+    const finger = (s, [fret, label]) => label ? [s, fret, label] : [s, fret];
+    return {
+        key,
+        suffix,
+        chord: {
+            fingers: [finger(3, g), finger(2, b), finger(1, e), ...MUTED_LOW],
+            barres: [],
+        },
+    };
+}
+/**
+ * Hand-authored beginner voicings on the top three strings (G B E).
+ *
+ * chords-db has no three-string voicings, so these cannot be derived — the table
+ * is the sole source. Every entry is checked against pitch-class arithmetic by
+ * staticPresets.test.ts, because a wrong shape is unrecoverable once printed.
+ */
+export const GUITAR_TOP3_PRESETS = [
+    top3("C", "major", [0], [1, "1"], [0]),
+    top3("G", "major", [0], [0], [3, "3"]),
+    top3("D", "major", [2, "1"], [3, "3"], [2, "2"]),
+    top3("A", "major", [2, "1"], [2, "2"], [0]),
+    top3("E", "minor", [0], [0], [0]),
+    top3("A", "minor", [2, "2"], [1, "1"], [0]),
+    top3("D", "minor", [2, "2"], [3, "3"], [1, "1"]),
+    top3("E", "major", [1, "1"], [0], [0]),
+    top3("C", "7", [3, "3"], [1, "1"], [0]),
+    top3("G", "7", [0], [0], [1, "1"]),
+    top3("B", "minor", [4, "3"], [3, "2"], [2, "1"]),
+    top3("F", "major", [2, "2"], [1, "1"], [1, "1"]),
+    top3("D", "7", [2, "2"], [1, "1"], [2, "3"]),
+    top3("E", "7", [1, "1"], [3, "3"], [0]),
+    top3("A", "7", [0], [2, "2"], [0]),
+    top3("A", "m7", [0], [1, "1"], [0]),
+    top3("D", "m7", [2, "2"], [1, "1"], [1, "1"]),
+    top3("E", "m7", [0], [3, "3"], [0]),
+    top3("F", "maj7", [2, "2"], [1, "1"], [0]),
+    top3("G", "minor", [3, "1"], [3, "2"], [3, "3"]),
+];
+/** Look up a top-3 shape. Returns null rather than guessing at an unknown chord. */
+export function lookupTop3Chord(key, suffix) {
+    const hit = GUITAR_TOP3_PRESETS.find((p) => p.key === key && p.suffix === suffix);
+    return hit ? hit.chord : null;
+}
+//# sourceMappingURL=staticPresets.js.map

package/dist/staticPresets.js.map

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

package/dist/voicingFacts.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Facts about a chord shape, derived from its sounding pitches.
+ *
+ * This module states facts; it never decides which shape a product should
+ * display. Selection lives in src/voicingSelect.ts.
+ */
+import type { ChordsDbPosition } from "./instruments.js";
+export type Inversion = "root" | "1st" | "2nd" | "3rd" | "other";
+export interface PositionFacts {
+    /** Sounding pitches, chords-db string order. */
+    midi: number[];
+    /** Lowest sounding pitch, or -1 for an all-muted position. */
+    bassMidi: number;
+    /** Pitch class of the bass note, or -1 when nothing sounds. */
+    bassPitchClass: number;
+    inversion: Inversion;
+    /** Sounding string count, including doublings. */
+    noteCount: number;
+    /** Distinct pitch classes, ascending. */
+    pitchClasses: number[];
+    /** Sounding strings beyond the first of each pitch class. */
+    doubledCount: number;
+    hasBarre: boolean;
+    /** Barre-free and at the nut — the beginner "open chord" rung. */
+    isOpenShape: boolean;
+    baseFret: number;
+}
+/**
+ * Derive facts for one position.
+ *
+ * @param pos - chords-db position
+ * @param openMidi - open-string MIDI in chords-db index order
+ * @param rootPc - root pitch class from `rootPitchClass(label)`, or null when
+ *   unparseable; null yields inversion "other" rather than a wrong guess.
+ */
+export declare function positionFacts(pos: ChordsDbPosition, openMidi: number[], rootPc: number | null): PositionFacts;
+/**
+ * For each position, the index of the first earlier position that sounds
+ * exactly the same pitches, or null when it is the first of its kind.
+ *
+ * chords-db ships 63 such redundant positions across 62 guitar entries
+ * (ukulele has none). Callers offering alternate voicings must skip these or
+ * they will present visual twins.
+ *
+ * Flags rather than removes: frames' /api/frame exposes a positionIndex
+ * parameter, so renumbering positions would silently change existing results.
+ */
+export declare function duplicateVoicingMap(positions: ChordsDbPosition[], openMidi: number[]): Array<number | null>;

package/dist/voicingFacts.js

@@ -0,0 +1,74 @@
+import { positionToMidi } from "./pitch.js";
+/**
+ * Interval from root to bass → inversion name.
+ *
+ * On guitar this constrains the bass note only: doubling, note count and
+ * register are all unconstrained, so "root position" means far less here than
+ * on a keyboard. Both major and minor thirds map to 1st inversion, and altered
+ * fifths to 2nd, so dim/aug shapes classify rather than falling through.
+ */
+function inversionFor(interval) {
+    if (interval === 0)
+        return "root";
+    if (interval === 3 || interval === 4)
+        return "1st";
+    if (interval === 6 || interval === 7 || interval === 8)
+        return "2nd";
+    if (interval === 9 || interval === 10 || interval === 11)
+        return "3rd";
+    return "other";
+}
+/**
+ * Derive facts for one position.
+ *
+ * @param pos - chords-db position
+ * @param openMidi - open-string MIDI in chords-db index order
+ * @param rootPc - root pitch class from `rootPitchClass(label)`, or null when
+ *   unparseable; null yields inversion "other" rather than a wrong guess.
+ */
+export function positionFacts(pos, openMidi, rootPc) {
+    const midi = positionToMidi(pos, openMidi);
+    const bassMidi = midi.length ? Math.min(...midi) : -1;
+    const bassPitchClass = bassMidi >= 0 ? bassMidi % 12 : -1;
+    const pitchClasses = [...new Set(midi.map((m) => m % 12))].sort((a, b) => a - b);
+    const hasBarre = pos.barres.length > 0;
+    const inversion = rootPc === null || bassPitchClass < 0
+        ? "other"
+        : inversionFor((bassPitchClass - rootPc + 12) % 12);
+    return {
+        midi,
+        bassMidi,
+        bassPitchClass,
+        inversion,
+        noteCount: midi.length,
+        pitchClasses,
+        doubledCount: midi.length - pitchClasses.length,
+        hasBarre,
+        isOpenShape: !hasBarre && pos.baseFret === 1,
+        baseFret: pos.baseFret,
+    };
+}
+/**
+ * For each position, the index of the first earlier position that sounds
+ * exactly the same pitches, or null when it is the first of its kind.
+ *
+ * chords-db ships 63 such redundant positions across 62 guitar entries
+ * (ukulele has none). Callers offering alternate voicings must skip these or
+ * they will present visual twins.
+ *
+ * Flags rather than removes: frames' /api/frame exposes a positionIndex
+ * parameter, so renumbering positions would silently change existing results.
+ */
+export function duplicateVoicingMap(positions, openMidi) {
+    const firstSeen = new Map();
+    return positions.map((pos, i) => {
+        const key = positionToMidi(pos, openMidi).join(",");
+        const seen = firstSeen.get(key);
+        if (seen === undefined) {
+            firstSeen.set(key, i);
+            return null;
+        }
+        return seen;
+    });
+}
+//# sourceMappingURL=voicingFacts.js.map

package/dist/voicingFacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voicingFacts.js","sourceRoot":"","sources":["../src/voicingFacts.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAwB5C;;;;;;;GAOG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrE,IAAI,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACvE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,GAAqB,EACrB,QAAkB,EAClB,MAAqB;IAErB,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,YAAY,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC;IAEvC,MAAM,SAAS,GACb,MAAM,KAAK,IAAI,IAAI,cAAc,GAAG,CAAC;QACnC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC,YAAY,CAAC,CAAC,cAAc,GAAG,MAAM,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;IAExD,OAAO;QACL,IAAI;QACJ,QAAQ;QACR,cAAc;QACd,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,MAAM;QACtB,YAAY;QACZ,YAAY,EAAE,IAAI,CAAC,MAAM,GAAG,YAAY,CAAC,MAAM;QAC/C,QAAQ;QACR,WAAW,EAAE,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,CAAC;QAC5C,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAA6B,EAC7B,QAAkB;IAElB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC9B,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;YACtB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/voicingSelect.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Choosing among a chord's stored shapes.
+ *
+ * The package offers a sensible default and a ranked list; which shape a
+ * product actually displays stays the consumer's decision.
+ */
+import type { Chord } from "svguitar";
+import type { ChordsDbPosition, InstrumentId } from "./instruments.js";
+import type { PositionFacts } from "./voicingFacts.js";
+/**
+ * Difficulty rungs expressible as a filter over stored shapes.
+ *
+ * The `guitar-top3` and `power` rungs are not filters — top-3 comes from
+ * GUITAR_TOP3_PRESETS and power chords are generated (src/powerChords.ts),
+ * because chords-db has neither.
+ */
+export type ShapeClass = "open" | "no-barre" | "any";
+/** Rungs ordered easiest → hardest, for the "widen by one rung" option. */
+export declare const SHAPE_CLASS_LADDER: ShapeClass[];
+export declare function matchesShapeClass(facts: PositionFacts, cls: ShapeClass): boolean;
+export interface CanonicalOptions {
+    instrument: InstrumentId;
+    /** Root pitch class from `rootPitchClass(label)`; null disables inversion ranking. */
+    rootPc: number | null;
+}
+/**
+ * Index of the shape to present by default.
+ *
+ * Guitar: the first root-position shape, falling back to the first shape when
+ * none is root position (50 of 529 guitar entries have none).
+ *
+ * Ukulele: lowest baseFret, because root position barely applies — its
+ * reentrant high-G tuning leaves 317 of 552 entries with no root-position
+ * shape at all.
+ *
+ * Duplicate voicings are never chosen.
+ */
+export declare function canonicalPositionIndex(positions: ChordsDbPosition[], opts: CanonicalOptions): number;
+export interface VoicingChoice {
+    /** Index into the original positions array — stable, so it round-trips. */
+    index: number;
+    facts: PositionFacts;
+    shape: Chord;
+    /**
+     * Human label derived from facts, e.g. "Open", "Barre, fret 8". English
+     * display text only — consumers who need their own wording or i18n should
+     * derive it from `facts` instead, which carries every fact this label is
+     * built from.
+     */
+    label: string;
+}
+export interface SelectVoicingsOptions extends CanonicalOptions {
+    /** How many alternates to return alongside the primary. */
+    alternates: number;
+    /** Restrict candidates to a difficulty rung. Default "any". */
+    shapeClass?: ShapeClass;
+    /** Widen the pool by one rung when the requested rung runs dry. Default false. */
+    allowNextRung?: boolean;
+    title?: string;
+}
+export interface SelectVoicingsResult {
+    primary: VoicingChoice;
+    alternates: VoicingChoice[];
+    /** True when fewer alternates were available than requested. */
+    short: boolean;
+}
+/**
+ * A primary shape plus up to `alternates` maximally-contrasting others.
+ *
+ * Alternates are chosen greedily: each pick maximises its minimum contrast
+ * against everything already chosen. Naive first-n selection repeats an
+ * (inversion, barre) profile on 74.9% of guitar entries, which reads as a
+ * broken card when three shapes appear side by side.
+ *
+ * Duplicate voicings are excluded, so a card can never print visual twins.
+ * Returns fewer alternates than asked for rather than padding, with `short`
+ * set — 5 guitar entries have fewer than 3 unique voicings.
+ *
+ * Returns `null` in two distinct cases: an empty `positions` array, or a
+ * `positions` array whose entries all fail the requested `shapeClass` (after
+ * `allowNextRung` widening, if set). The second case is common, not
+ * exceptional — `shapeClass: "open"` alone returns `null` for roughly 40% of
+ * entries (220/529 guitar, 211/552 ukulele), so callers must handle `null`
+ * as a normal outcome rather than an error.
+ *
+ * When the requested `shapeClass` filters out the corpus-wide canonical
+ * position entirely, the primary falls back to `primaryPool[0]` (array
+ * order) rather than re-running root-position preference within the
+ * filtered pool. Measured at ~0.9% of entries — accepted as a known
+ * shortcut, not an oversight.
+ */
+export declare function selectVoicings(positions: ChordsDbPosition[], opts: SelectVoicingsOptions): SelectVoicingsResult | null;

package/dist/voicingSelect.js

@@ -0,0 +1,151 @@
+import { INSTRUMENTS, dbPositionToChord } from "./instruments.js";
+import { positionFacts, duplicateVoicingMap } from "./voicingFacts.js";
+/** Rungs ordered easiest → hardest, for the "widen by one rung" option. */
+export const SHAPE_CLASS_LADDER = ["open", "no-barre", "any"];
+export function matchesShapeClass(facts, cls) {
+    if (cls === "any")
+        return true;
+    if (cls === "no-barre")
+        return !facts.hasBarre;
+    return facts.isOpenShape;
+}
+/**
+ * Index of the shape to present by default.
+ *
+ * Guitar: the first root-position shape, falling back to the first shape when
+ * none is root position (50 of 529 guitar entries have none).
+ *
+ * Ukulele: lowest baseFret, because root position barely applies — its
+ * reentrant high-G tuning leaves 317 of 552 entries with no root-position
+ * shape at all.
+ *
+ * Duplicate voicings are never chosen.
+ */
+export function canonicalPositionIndex(positions, opts) {
+    if (positions.length === 0)
+        return -1;
+    const openMidi = INSTRUMENTS[opts.instrument].openMidi;
+    const dupes = duplicateVoicingMap(positions, openMidi);
+    const candidates = positions
+        .map((pos, index) => ({ index, facts: positionFacts(pos, openMidi, opts.rootPc) }))
+        .filter((c) => dupes[c.index] === null);
+    if (opts.instrument === "ukulele") {
+        let best = candidates[0];
+        for (const c of candidates) {
+            if (c.facts.baseFret < best.facts.baseFret)
+                best = c;
+        }
+        return best.index;
+    }
+    const rootPosition = candidates.find((c) => c.facts.inversion === "root");
+    return (rootPosition ?? candidates[0]).index;
+}
+function labelFor(facts) {
+    if (facts.isOpenShape)
+        return "Open";
+    if (facts.hasBarre)
+        return `Barre, fret ${facts.baseFret}`;
+    return `Fret ${facts.baseFret}`;
+}
+/**
+ * How different two shapes look and feel to a player. Higher = more contrast.
+ *
+ * Inversion dominates because it changes what the chord sounds like; barre vs
+ * open is the next most visible difference; neck distance breaks ties.
+ */
+function contrast(a, b) {
+    let score = 0;
+    if (a.inversion !== b.inversion)
+        score += 4;
+    if (a.hasBarre !== b.hasBarre)
+        score += 2;
+    score += Math.min(Math.abs(a.baseFret - b.baseFret), 5) / 5;
+    return score;
+}
+function widen(cls) {
+    const i = SHAPE_CLASS_LADDER.indexOf(cls);
+    return SHAPE_CLASS_LADDER[Math.min(i + 1, SHAPE_CLASS_LADDER.length - 1)];
+}
+/**
+ * A primary shape plus up to `alternates` maximally-contrasting others.
+ *
+ * Alternates are chosen greedily: each pick maximises its minimum contrast
+ * against everything already chosen. Naive first-n selection repeats an
+ * (inversion, barre) profile on 74.9% of guitar entries, which reads as a
+ * broken card when three shapes appear side by side.
+ *
+ * Duplicate voicings are excluded, so a card can never print visual twins.
+ * Returns fewer alternates than asked for rather than padding, with `short`
+ * set — 5 guitar entries have fewer than 3 unique voicings.
+ *
+ * Returns `null` in two distinct cases: an empty `positions` array, or a
+ * `positions` array whose entries all fail the requested `shapeClass` (after
+ * `allowNextRung` widening, if set). The second case is common, not
+ * exceptional — `shapeClass: "open"` alone returns `null` for roughly 40% of
+ * entries (220/529 guitar, 211/552 ukulele), so callers must handle `null`
+ * as a normal outcome rather than an error.
+ *
+ * When the requested `shapeClass` filters out the corpus-wide canonical
+ * position entirely, the primary falls back to `primaryPool[0]` (array
+ * order) rather than re-running root-position preference within the
+ * filtered pool. Measured at ~0.9% of entries — accepted as a known
+ * shortcut, not an oversight.
+ */
+export function selectVoicings(positions, opts) {
+    if (positions.length === 0)
+        return null;
+    const openMidi = INSTRUMENTS[opts.instrument].openMidi;
+    const dupes = duplicateVoicingMap(positions, openMidi);
+    const stringCount = INSTRUMENTS[opts.instrument].strings;
+    const build = (index) => {
+        const facts = positionFacts(positions[index], openMidi, opts.rootPc);
+        return {
+            index,
+            facts,
+            shape: dbPositionToChord(positions[index], stringCount, opts.title),
+            label: labelFor(facts),
+        };
+    };
+    const requested = opts.shapeClass ?? "any";
+    const classes = opts.allowNextRung ? [requested, widen(requested)] : [requested];
+    // narrowPool is the pool for the originally requested rung; pool may widen
+    // beyond it when allowNextRung kicks in. The primary must come from
+    // narrowPool whenever it has candidates — widening exists to backfill
+    // alternates, not to bump the primary to a harder rung. See Fix 4.
+    let pool = [];
+    let narrowPool = [];
+    for (const cls of classes) {
+        pool = positions
+            .map((_, index) => index)
+            .filter((index) => dupes[index] === null)
+            .map(build)
+            .filter((c) => matchesShapeClass(c.facts, cls));
+        if (cls === requested)
+            narrowPool = pool;
+        if (pool.length > opts.alternates)
+            break;
+    }
+    if (pool.length === 0)
+        return null;
+    const canonical = canonicalPositionIndex(positions, opts);
+    const primaryPool = narrowPool.length > 0 ? narrowPool : pool;
+    // Fallback to primaryPool[0] documented on the function's JSDoc above.
+    const primary = primaryPool.find((c) => c.index === canonical) ?? primaryPool[0];
+    const chosen = [primary];
+    const remaining = pool.filter((c) => c.index !== primary.index);
+    while (chosen.length <= opts.alternates && remaining.length > 0) {
+        let bestAt = 0;
+        let bestScore = -Infinity;
+        remaining.forEach((cand, i) => {
+            const score = Math.min(...chosen.map((c) => contrast(c.facts, cand.facts)));
+            if (score > bestScore) {
+                bestScore = score;
+                bestAt = i;
+            }
+        });
+        chosen.push(remaining.splice(bestAt, 1)[0]);
+    }
+    const alternates = chosen.slice(1);
+    return { primary, alternates, short: alternates.length < opts.alternates };
+}
+//# sourceMappingURL=voicingSelect.js.map

package/dist/voicingSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voicingSelect.js","sourceRoot":"","sources":["../src/voicingSelect.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAWvE,2EAA2E;AAC3E,MAAM,CAAC,MAAM,kBAAkB,GAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAE5E,MAAM,UAAU,iBAAiB,CAAC,KAAoB,EAAE,GAAe;IACrE,IAAI,GAAG,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,GAAG,KAAK,UAAU;QAAE,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC/C,OAAO,KAAK,CAAC,WAAW,CAAC;AAC3B,CAAC;AAQD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAA6B,EAC7B,IAAsB;IAEtB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC;IACvD,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,SAAS;SACzB,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;SAClF,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;IAE1C,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QACzB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;YAC3B,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ;gBAAE,IAAI,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC;IAC1E,OAAO,CAAC,YAAY,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC;AAiCD,SAAS,QAAQ,CAAC,KAAoB;IACpC,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IACrC,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,eAAe,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC3D,OAAO,QAAQ,KAAK,CAAC,QAAQ,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CAAC,CAAgB,EAAE,CAAgB;IAClD,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,CAAC,CAAC,SAAS,KAAK,CAAC,CAAC,SAAS;QAAE,KAAK,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,QAAQ;QAAE,KAAK,IAAI,CAAC,CAAC;IAC1C,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;IAC5D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,KAAK,CAAC,GAAe;IAC5B,MAAM,CAAC,GAAG,kBAAkB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1C,OAAO,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAC5B,SAA6B,EAC7B,IAA2B;IAE3B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC;IACvD,MAAM,KAAK,GAAG,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,CAAC;IAEzD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAiB,EAAE;QAC7C,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrE,OAAO;YACL,KAAK;YACL,KAAK;YACL,KAAK,EAAE,iBAAiB,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC;YACnE,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC;SACvB,CAAC;IACJ,CAAC,CAAC;IAEF,MAAM,SAAS,GAAe,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAEjF,2EAA2E;IAC3E,oEAAoE;IACpE,sEAAsE;IACtE,mEAAmE;IACnE,IAAI,IAAI,GAAoB,EAAE,CAAC;IAC/B,IAAI,UAAU,GAAoB,EAAE,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,IAAI,GAAG,SAAS;aACb,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;aACxB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC;aACxC,GAAG,CAAC,KAAK,CAAC;aACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,GAAG,KAAK,SAAS;YAAE,UAAU,GAAG,IAAI,CAAC;QACzC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU;YAAE,MAAM;IAC3C,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEnC,MAAM,SAAS,GAAG,sBAAsB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,uEAAuE;IACvE,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IAEjF,MAAM,MAAM,GAAoB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC;IAEhE,OAAO,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,UAAU,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChE,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,IAAI,SAAS,GAAG,CAAC,QAAQ,CAAC;QAC1B,SAAS,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YAC5B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC5E,IAAI,KAAK,GAAG,SAAS,EAAE,CAAC;gBACtB,SAAS,GAAG,KAAK,CAAC;gBAClB,MAAM,GAAG,CAAC,CAAC;YACb,CAAC;QACH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;AAC7E,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@pepperhorn/chordl-guitar",
+  "version": "0.2.0",
+  "description": "Guitar/ukulele chord-shape lookup and svguitar diagram data — chords-db backed, with alternate fret positions",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "engines": {
+    "node": ">=20.10"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@tombatossals/chords-db": "^0.5.1",
+    "svguitar": "^2.5.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build:data": "node scripts/build-data.mjs",
+    "build": "pnpm run build:data && tsc",
+    "lint": "pnpm run build:data && tsc --noEmit",
+    "test": "pnpm run build:data && vitest",
+    "test:run": "pnpm run build:data && vitest run"
+  }
+}