rv-bible-cli 0.1.0

package/README.md

@@ -0,0 +1,159 @@
+# rv — Recovery Version Bible CLI
+
+A fast, study-grade terminal Bible reader for the Recovery Version. Offline-first, footnote-aware, cross-reference deep-linking, clipboard-friendly.
+
+```
+npm install -g rv-bible-cli
+rv
+```
+
+## Quick Start
+
+```bash
+rv john 3          # read a chapter (interactive pager)
+rv john 3:16       # read a single verse
+rv search grace    # concordance search (1,129 curated words)
+rv help            # see all commands and shortcuts
+```
+
+## Features
+
+### Reading
+
+```bash
+rv john 3              # chapter mode — opens full-screen pager
+rv john 3:16           # single verse
+rv john 3:16-18        # verse range
+rv john 3:16,18,20     # specific verses
+rv john 3:16 rom 8:28  # verses across books
+rv jn 3                # fuzzy book names (jn, gen, rm, eph, rev, etc.)
+rv john 3 --notes      # inline footnote markers + footnote block
+rv john 3 --outline    # section headers inline
+rv john 3 --full       # both notes and outline
+rv john 3 --raw        # plain text, no pager (also auto when piped)
+```
+
+### Footnotes
+
+```bash
+rv note john 3:16      # all footnotes for a verse
+rv note john 3:16 2d   # specific footnote by marker
+rv note john 3:14-16   # footnotes for a range
+```
+
+### Search
+
+Concordance-first for known words (1,129 curated entries), FTS5 full-text for everything else.
+
+```bash
+rv search grace              # concordance lookup
+rv search grace in romans    # scoped to a book
+rv search "only begotten"    # phrase match
+rv search eternal life       # multi-word AND
+rv search grace --fts        # force raw FTS5
+rv search grace --all        # show all results (default: 20/page)
+```
+
+### Copy to Clipboard
+
+Add `--copy` to any read command. Output displays normally AND goes to clipboard.
+
+```bash
+rv john 3:16 --copy              # "John 3:16 For God so loved..."
+rv john 3:16 --copy --no-ref     # plain text only
+rv john 3:16 --copy --numbered   # "16 For God so loved..."
+rv john 3:16 --copy --md         # markdown block quote
+rv search grace --copy           # copy all results
+```
+
+### Navigation
+
+```bash
+rv                # home screen — browse books, pick chapters
+rv continue       # resume last-read chapter
+```
+
+## Pager
+
+Chapter mode in a terminal automatically launches a full-screen interactive pager.
+
+### Normal Mode
+
+| Key | Action |
+|-----|--------|
+| `j` / `k` / arrows | scroll up/down |
+| `Space` / `b` | page down/up |
+| `g` / `G` | top / bottom |
+| `n` / `p` / left/right | next / prev chapter (cross-book) |
+| `f` | toggle footnotes |
+| `o` | toggle outline |
+| `d` | enter study mode |
+| `c` | enter copy mode |
+| `/` | search within chapter |
+| `:` | goto — type a reference (e.g. `rom 8`) |
+| `[` / `]` | back / forward (navigation history) |
+| `H` | home screen |
+| `q` / `Esc` | quit |
+
+### Study Mode (`d`)
+
+Browse footnotes and follow cross-references. The footnote panel updates dynamically as you move between verses.
+
+| Key | Action |
+|-----|--------|
+| up/down | move verse cursor |
+| left/right | prev / next chapter |
+| type number | follow a numbered cross-reference |
+| `v` | start range selection |
+| `c` | copy verse or range |
+| `/` | search within chapter |
+| `:` | goto |
+| `[` / `]` | back / forward |
+| `d` / `Esc` | exit study mode |
+
+Study mode persists across navigation — follow a cross-ref and you stay in study mode, landing on the exact target verse. Press `[` to go back.
+
+### Copy Mode (`c`)
+
+| Key | Action |
+|-----|--------|
+| up/down | move verse cursor |
+| `v` | start range selection |
+| `Enter` / `c` | copy to clipboard |
+| `Esc` | cancel |
+
+### Home Screen
+
+Press `H` from the pager or run `rv` with no arguments.
+
+| Key | Action |
+|-----|--------|
+| arrows | navigate the book grid |
+| type a letter | jump to first matching book (repeat to cycle) |
+| `Enter` | select book, then pick chapter |
+| `Space` | continue last-read chapter |
+| `q` | quit |
+
+## Database
+
+The bundled SQLite database (`rv.db`, 43 MB) contains:
+
+| Content | Count |
+|---------|-------|
+| Books | 66 |
+| Verses | 31,220 |
+| Footnotes | 47,436 |
+| Cross-references | 199,369 |
+| Section headers | 2,907 |
+| Concordance entries | ~110,000 |
+
+All data is from the Recovery Version Bible. Offline — no network requests.
+
+## Requirements
+
+- Node.js 18+
+- A terminal that supports ANSI colors
+
+## License
+
+For personal study use.

package/dist/db.d.ts

@@ -0,0 +1,63 @@
+import type { ParsedRef } from './parser.js';
+export interface Verse {
+    book: string;
+    chapter: number;
+    verse: string;
+    text: string;
+    outline_anchor: string;
+}
+export interface Footnote {
+    book: string;
+    chapter: number;
+    verse: string;
+    marker: string;
+    anchor: string;
+    text: string;
+}
+export interface SectionHeader {
+    id: number;
+    book: string;
+    outline_anchor: string;
+    level: number;
+    label: string;
+    text: string;
+    verse_start: string;
+    verse_end: string | null;
+}
+export interface BookInfo {
+    abbr: string;
+    full_name: string;
+    testament: string;
+    category: string;
+    sort_order: number;
+    author: string;
+    date_written: string;
+    place_of_writing: string;
+    time_period: string;
+    recipient: string;
+    subject_short: string;
+    subject_full: string;
+    intro_text: string;
+    chapter_count: number;
+}
+export declare function getChapter(book: string, chapter: number): Verse[];
+export declare function getVerse(book: string, chapter: number, verse: string): Verse | null;
+export declare function getVerseRange(book: string, chapter: number, start: string, end: string): Verse[];
+export declare function getVersesByRef(ref: ParsedRef): Verse[];
+export declare function getVersesByRefList(refs: ParsedRef[]): Verse[];
+export declare function getSectionHeaders(book: string): SectionHeader[];
+export declare function getFootnote(book: string, chapter: number, verse: string, marker: string): Footnote | null;
+export declare function getFootnotesForChapter(book: string, chapter: number): Footnote[];
+export declare function getFootnotesForVerses(book: string, chapter: number, verseIds: string[]): Footnote[];
+export declare function getBookInfo(book: string): BookInfo | null;
+export declare function getAllBooks(): BookInfo[];
+export interface CrossRef {
+    src_marker: string;
+    tgt_book: string;
+    tgt_chapter: number;
+    tgt_verse: string;
+}
+export declare function getCrossRefsForVerse(book: string, chapter: number, verse: string): CrossRef[];
+export declare function isInConcordance(word: string): boolean;
+export declare function getTopicVerses(word: string, book?: string): Verse[];
+export declare function searchFTS(queryStr: string, book?: string): Verse[];

package/dist/db.js

@@ -0,0 +1,153 @@
+import initSqlJs from 'sql.js';
+import { readFileSync } from 'node:fs';
+import path from 'node:path';
+// ---------------------------------------------------------------------------
+// Connection — sql.js (pure JS/WASM, no native compilation)
+// Top-level await: module consumers wait for DB to be ready before importing
+// ---------------------------------------------------------------------------
+const SQL = await initSqlJs();
+const dbPath = path.join(import.meta.dirname, '../rv.db');
+const dbBuffer = readFileSync(dbPath);
+const db = new SQL.Database(dbBuffer);
+// ---------------------------------------------------------------------------
+// Query helpers — typed wrappers over sql.js statement API
+// ---------------------------------------------------------------------------
+function query(sql, params = []) {
+    const stmt = db.prepare(sql);
+    if (params.length > 0)
+        stmt.bind(params);
+    const results = [];
+    while (stmt.step()) {
+        results.push(stmt.getAsObject());
+    }
+    stmt.free();
+    return results;
+}
+function queryOne(sql, params = []) {
+    const results = query(sql, params);
+    return results[0] ?? null;
+}
+// ---------------------------------------------------------------------------
+// Query functions
+// ---------------------------------------------------------------------------
+export function getChapter(book, chapter) {
+    return query('SELECT book, chapter, verse, text, outline_anchor FROM verses WHERE book = ? AND chapter = ? ORDER BY rowid', [book, chapter]);
+}
+export function getVerse(book, chapter, verse) {
+    return queryOne('SELECT book, chapter, verse, text, outline_anchor FROM verses WHERE book = ? AND chapter = ? AND verse = ?', [book, chapter, verse]);
+}
+// Returns verses between start and end (inclusive) in rowid order.
+// Handles sub-verses: range '1-2' includes '2a' and '2b' if '2' doesn't exist.
+export function getVerseRange(book, chapter, start, end) {
+    const all = getChapter(book, chapter);
+    const findFirst = (target) => all.findIndex(v => v.verse === target || v.verse.startsWith(target));
+    const findLast = (target) => {
+        for (let i = all.length - 1; i >= 0; i--) {
+            const v = all[i];
+            if (v.verse === target || v.verse.startsWith(target))
+                return i;
+        }
+        return -1;
+    };
+    const startIdx = findFirst(start);
+    const endIdx = findLast(end);
+    if (startIdx === -1 || endIdx === -1 || startIdx > endIdx)
+        return [];
+    return all.slice(startIdx, endIdx + 1);
+}
+// Resolves a ParsedRef to its matching verses. Chapter-only refs return all verses.
+export function getVersesByRef(ref) {
+    if (!ref.verses) {
+        return getChapter(ref.book, ref.chapter);
+    }
+    const { verses } = ref;
+    if (verses.type === 'single') {
+        const v = getVerse(ref.book, ref.chapter, verses.verse);
+        return v ? [v] : [];
+    }
+    if (verses.type === 'range') {
+        return getVerseRange(ref.book, ref.chapter, verses.start, verses.end);
+    }
+    // list
+    return verses.verses
+        .map(v => getVerse(ref.book, ref.chapter, v))
+        .filter((v) => v !== null);
+}
+// Resolves a list of ParsedRefs to a flat array of verses. No deduplication.
+export function getVersesByRefList(refs) {
+    return refs.flatMap(ref => getVersesByRef(ref));
+}
+export function getSectionHeaders(book) {
+    return query('SELECT id, book, outline_anchor, level, label, text, verse_start, verse_end FROM section_headers WHERE book = ? ORDER BY id', [book]);
+}
+export function getFootnote(book, chapter, verse, marker) {
+    return queryOne('SELECT book, chapter, verse, marker, anchor, text FROM footnotes WHERE book = ? AND chapter = ? AND verse = ? AND marker = ?', [book, chapter, verse, marker]);
+}
+export function getFootnotesForChapter(book, chapter) {
+    return query('SELECT book, chapter, verse, marker, anchor, text FROM footnotes WHERE book = ? AND chapter = ? ORDER BY rowid', [book, chapter]);
+}
+// Returns footnotes only for the given set of verse ids
+export function getFootnotesForVerses(book, chapter, verseIds) {
+    if (verseIds.length === 0)
+        return [];
+    const placeholders = verseIds.map(() => '?').join(', ');
+    return query(`SELECT book, chapter, verse, marker, anchor, text FROM footnotes
+     WHERE book = ? AND chapter = ? AND verse IN (${placeholders}) ORDER BY rowid`, [book, chapter, ...verseIds]);
+}
+export function getBookInfo(book) {
+    return queryOne('SELECT * FROM book_info WHERE abbr = ?', [book]);
+}
+export function getAllBooks() {
+    return query('SELECT * FROM book_info ORDER BY sort_order');
+}
+// Returns cross-refs for all footnote markers on a given verse.
+// Filters out self-references (where target = source verse).
+export function getCrossRefsForVerse(book, chapter, verse) {
+    const all = query(`SELECT src_marker, tgt_book, tgt_chapter, tgt_verse
+     FROM cross_refs WHERE src_book = ? AND src_chapter = ? AND src_verse = ?
+     ORDER BY rowid`, [book, chapter, verse]);
+    return all.filter(r => !(r.tgt_book === book && r.tgt_chapter === chapter && r.tgt_verse === verse));
+}
+// ── Search & Topic ───────────────────────────────────────────────────────────
+export function isInConcordance(word) {
+    return (queryOne('SELECT COUNT(*) as cnt FROM concordance WHERE word = ?', [word.toLowerCase()])?.cnt ?? 0) > 0;
+}
+export function getTopicVerses(word, book) {
+    const w = word.toLowerCase();
+    if (book) {
+        return query(`SELECT v.book, v.chapter, v.verse, v.text, v.outline_anchor
+       FROM concordance c JOIN verses v USING (book, chapter, verse)
+       WHERE c.word = ? AND c.book = ?
+       ORDER BY v.rowid`, [w, book]);
+    }
+    return query(`SELECT v.book, v.chapter, v.verse, v.text, v.outline_anchor
+     FROM concordance c JOIN verses v USING (book, chapter, verse)
+     WHERE c.word = ?
+     ORDER BY v.rowid`, [w]);
+}
+// Full-text search using LIKE (sql.js doesn't include FTS5).
+// Parses the FTS5-style query into LIKE conditions:
+//   '"grace"'            → text LIKE '%grace%'
+//   '"eternal" AND "life"' → text LIKE '%eternal%' AND text LIKE '%life%'
+// Returns [] on parse failure rather than throwing.
+export function searchFTS(queryStr, book) {
+    try {
+        // Extract quoted terms from FTS5-style query
+        const terms = [...queryStr.matchAll(/"([^"]+)"/g)].map(m => m[1]);
+        if (terms.length === 0)
+            return [];
+        const likeClauses = terms.map(() => 'text LIKE ?').join(' AND ');
+        const likeParams = terms.map(t => `%${t}%`);
+        if (book) {
+            return query(`SELECT book, chapter, verse, text, outline_anchor FROM verses
+         WHERE ${likeClauses} AND book = ?
+         ORDER BY rowid LIMIT 500`, [...likeParams, book]);
+        }
+        return query(`SELECT book, chapter, verse, text, outline_anchor FROM verses
+       WHERE ${likeClauses}
+       ORDER BY rowid LIMIT 500`, likeParams);
+    }
+    catch {
+        return [];
+    }
+}

package/dist/format.d.ts

@@ -0,0 +1,13 @@
+import type { Verse, Footnote, SectionHeader } from './db.js';
+export declare function toSuperscript(s: string): string;
+export declare function stripMarkers(text: string): string;
+export declare function highlightTerms(text: string, terms: string[]): string;
+export declare function renderVerseInline(verse: Verse, bookName: string, notes: boolean): string;
+export declare function renderFootnoteBlock(footnotes: Footnote[]): string;
+export declare function renderNoteDisplayAll(verse: Verse, footnotes: Footnote[], bookName: string): string;
+export declare function renderNoteDisplay(verse: Verse, fn: Footnote, bookName: string): string;
+export interface RenderOpts {
+    notes: boolean;
+    title?: string;
+}
+export declare function renderVerses(verses: Verse[], headers: SectionHeader[], footnotes: Footnote[], opts: RenderOpts): string;

package/dist/format.js

@@ -0,0 +1,258 @@
+import chalk from 'chalk';
+// ── Superscript helpers ──────────────────────────────────────────────────────
+const SUPER_DIGITS = ['⁰', '¹', '²', '³', '⁴', '⁵', '⁶', '⁷', '⁸', '⁹'];
+const SUPER_LOWER = {
+    a: 'ᵃ', b: 'ᵇ', c: 'ᶜ', d: 'ᵈ', e: 'ᵉ', f: 'ᶠ', g: 'ᵍ',
+    h: 'ʰ', i: 'ⁱ', j: 'ʲ', k: 'ᵏ', l: 'ˡ', m: 'ᵐ', n: 'ⁿ',
+    o: 'ᵒ', p: 'ᵖ', r: 'ʳ', s: 'ˢ', t: 'ᵗ', u: 'ᵘ', v: 'ᵛ',
+    w: 'ʷ', x: 'ˣ', y: 'ʸ', z: 'ᶻ',
+};
+// Converts "16" → "¹⁶", "2a" → "²ᵃ", "1a" → "¹ᵃ"
+export function toSuperscript(s) {
+    return s.split('').map(c => {
+        if (/[0-9]/.test(c))
+            return SUPER_DIGITS[parseInt(c)] ?? c;
+        return SUPER_LOWER[c] ?? c;
+    }).join('');
+}
+// ── Verse text processing ────────────────────────────────────────────────────
+// Strips [marker] tokens entirely — clean reading mode (default)
+export function stripMarkers(text) {
+    return text.replace(/\[[^\]]+\]/g, '');
+}
+// Escape special regex chars — used by highlightTerms
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+// Bold + yellow highlight for search/topic term matches in stripped verse text.
+export function highlightTerms(text, terms) {
+    if (terms.length === 0)
+        return text;
+    let result = text;
+    for (const term of terms) {
+        const re = new RegExp(`\\b(${escapeRegex(term)})\\b`, 'gi');
+        result = result.replace(re, chalk.bold.yellow('$1'));
+    }
+    return result;
+}
+// Inline format for verse-level queries: "John 3:16  For God so loved..."
+// Used when displaying specific verses rather than a full chapter.
+export function renderVerseInline(verse, bookName, notes) {
+    const label = chalk.bold(`${bookName} ${verse.chapter}:${verse.verse}`);
+    const text = notes ? highlightMarkers(verse.text) : stripMarkers(verse.text);
+    return `${label}  ${text}`;
+}
+// Renders [marker] tokens as styled superscript — notes mode
+function highlightMarkers(text) {
+    return text.replace(/\[([^\]]+)\]/g, (_, m) => chalk.cyan(toSuperscript(m)));
+}
+// ── Section header rendering ─────────────────────────────────────────────────
+// Margin + 2 spaces per level, starting at level 1
+function headerIndent(level) {
+    return margin() + '  '.repeat(Math.min(level, 5));
+}
+function renderHeader(h) {
+    const indent = headerIndent(h.level);
+    const label = `${h.label}.`;
+    const range = h.verse_end
+        ? chalk.dim(` (${h.verse_start}–${h.verse_end})`)
+        : '';
+    if (h.level === 1) {
+        return chalk.bold(`${indent}${label}  ${h.text}`) + range;
+    }
+    if (h.level <= 3) {
+        return `${indent}${chalk.dim(label)}  ${h.text}${range}`;
+    }
+    return chalk.dim(`${indent}${label}  ${h.text}`) + range;
+}
+// Groups section headers by outline_anchor for fast lookup during verse rendering
+function buildHeaderMap(headers) {
+    const map = new Map();
+    for (const h of headers) {
+        const bucket = map.get(h.outline_anchor) ?? [];
+        bucket.push(h);
+        map.set(h.outline_anchor, bucket);
+    }
+    return map;
+}
+// ── Layout constants ────────────────────────────────────────────────────────
+const LEFT_MARGIN = 6; // extra left padding for a book-like feel
+const MAX_TEXT_WIDTH = 90; // cap text block width on wide terminals
+// Effective content width: terminal width minus margins, capped at MAX_TEXT_WIDTH
+function contentWidth() {
+    const termWidth = process.stdout.columns ?? 80;
+    return Math.min(termWidth - LEFT_MARGIN, MAX_TEXT_WIDTH);
+}
+// Left margin string
+function margin() {
+    return ' '.repeat(LEFT_MARGIN);
+}
+// ── Visible-length helper ────────────────────────────────────────────────────
+// Strip ANSI escape codes before measuring — needed for word-wrap width checks
+// on text that may contain chalk styling (e.g. highlighted markers in notes mode).
+function visibleLength(s) {
+    return s.replace(/\x1b\[[0-9;]*m/g, '').length;
+}
+// ── Word-wrap helper ─────────────────────────────────────────────────────────
+// Wraps plain `text` to `maxWidth` columns. Returns array of line strings.
+// Use visibleLength=true when words may contain ANSI escape codes.
+function wrapWords(text, maxWidth, ansi = false) {
+    if (maxWidth < 20)
+        return [text];
+    const words = text.split(' ');
+    const textLines = [];
+    let current = '';
+    let currentW = 0;
+    for (const word of words) {
+        const wLen = ansi ? visibleLength(word) : word.length;
+        if (current === '') {
+            current = word;
+            currentW = wLen;
+        }
+        else if (currentW + 1 + wLen <= maxWidth) {
+            current += ' ' + word;
+            currentW += 1 + wLen;
+        }
+        else {
+            textLines.push(current);
+            current = word;
+            currentW = wLen;
+        }
+    }
+    if (current)
+        textLines.push(current);
+    return textLines;
+}
+// ── Single verse line ────────────────────────────────────────────────────────
+// numWidth: max superscript width of all verse numbers in the set — used to
+// right-align numbers so verse text always starts at the same column.
+// Wraps long lines at terminal width with a hanging indent so continuation
+// lines re-align with the text start, not the terminal edge.
+function renderVerse(verse, notes, numWidth = 1) {
+    const numStr = toSuperscript(verse.verse);
+    const pad = ' '.repeat(Math.max(0, numWidth - numStr.length));
+    const num = chalk.dim(numStr);
+    const rawText = notes ? highlightMarkers(verse.text) : stripMarkers(verse.text);
+    const m = margin();
+    const localPrefixLen = 2 + numWidth + 1; // verse num + spacing within margin
+    const textWidth = contentWidth() - localPrefixLen;
+    const linePrefix = `${m}${pad}${num} `;
+    const continuation = `${m}${' '.repeat(localPrefixLen)}`;
+    if (textWidth < 20)
+        return `${linePrefix}${rawText}`;
+    const textLines = wrapWords(rawText, textWidth, true);
+    const first = `${linePrefix}${textLines[0] ?? ''}`;
+    const rest = textLines.slice(1).map(l => `${continuation}${l}`);
+    return [first, ...rest].join('\n');
+}
+// ── Footnote block ───────────────────────────────────────────────────────────
+// Paragraph continuation markers (e.g. 1P1, 1P2) extend the base note but
+// don't appear inline in verse text. Skip them when rendering the block —
+// the base marker already covers the note.
+function isParagraphContinuation(marker) {
+    return /P\d+$/.test(marker);
+}
+export function renderFootnoteBlock(footnotes) {
+    // Deduplicate by anchor (same text can appear under multiple markers)
+    const seen = new Set();
+    const unique = footnotes.filter(f => {
+        if (isParagraphContinuation(f.marker))
+            return false;
+        if (seen.has(f.anchor))
+            return false;
+        seen.add(f.anchor);
+        return true;
+    });
+    if (unique.length === 0)
+        return '';
+    const m = margin();
+    const cw = contentWidth();
+    const sep = m + chalk.dim('─'.repeat(cw));
+    const lines = [sep];
+    for (const fn of unique) {
+        const markerStr = toSuperscript(fn.marker);
+        const localPrefixLen = 2 + markerStr.length + 1;
+        const linePrefix = `${m}${chalk.cyan(markerStr)} `;
+        const continuation = `${m}${' '.repeat(localPrefixLen)}`;
+        const textLines = wrapWords(fn.text, cw - localPrefixLen);
+        const first = `${linePrefix}${chalk.dim(textLines[0] ?? '')}`;
+        const rest = textLines.slice(1).map(l => `${continuation}${chalk.dim(l)}`);
+        lines.push([first, ...rest].join('\n'));
+    }
+    return lines.join('\n');
+}
+// ── Note display (rv note <ref> <marker>) ────────────────────────────────────
+// All inline footnotes for one verse — used when no marker is specified.
+export function renderNoteDisplayAll(verse, footnotes, bookName) {
+    const title = chalk.bold(`${bookName} ${verse.chapter}:${verse.verse}`);
+    const verseLine = renderVerse(verse, true);
+    if (footnotes.length === 0) {
+        return [title, '', verseLine].join('\n');
+    }
+    return [title, '', verseLine, '', renderFootnoteBlock(footnotes)].join('\n');
+}
+export function renderNoteDisplay(verse, fn, bookName) {
+    const title = chalk.bold(`${bookName} ${verse.chapter}:${verse.verse}`) +
+        chalk.dim(`  note ${fn.marker}`);
+    const verseLine = renderVerse(verse, true); // show markers so user sees where note attaches
+    const markerStr = toSuperscript(fn.marker);
+    const prefixLen = 2 + markerStr.length + 1;
+    const continuation = ' '.repeat(prefixLen);
+    const textLines = wrapWords(fn.text, (process.stdout.columns ?? 80) - prefixLen);
+    const noteLine = [`  ${chalk.cyan(markerStr)} ${textLines[0] ?? ''}`,
+        ...textLines.slice(1).map(l => `${continuation}${l}`)].join('\n');
+    return [title, '', verseLine, '', noteLine].join('\n');
+}
+export function renderVerses(verses, headers, footnotes, opts) {
+    const lines = [];
+    const headerMap = buildHeaderMap(headers);
+    let lastAnchor = null;
+    let verseCount = 0;
+    const maxNumWidth = verses.length > 0
+        ? Math.max(...verses.map(v => toSuperscript(v.verse).length))
+        : 1;
+    if (opts.title) {
+        const m = margin();
+        lines.push(`${m}${' '.repeat(2 + maxNumWidth + 1)}${chalk.bold(opts.title)}`);
+        lines.push('');
+    }
+    for (const verse of verses) {
+        // Insert section header(s) when we enter a new outline section
+        const anchor = verse.outline_anchor;
+        if (anchor && anchor !== lastAnchor) {
+            const hdrs = headerMap.get(anchor);
+            if (hdrs) {
+                if (lines.length > 0 && lines[lines.length - 1] !== '')
+                    lines.push('');
+                // Dim separator before top-level (Roman numeral) section breaks, after at least one verse
+                if (verseCount > 0 && hdrs.some(h => h.level === 1)) {
+                    lines.push(margin() + chalk.dim('─'.repeat(40)));
+                }
+                for (const h of hdrs)
+                    lines.push(renderHeader(h));
+                lines.push('');
+            }
+            lastAnchor = anchor;
+        }
+        lines.push(renderVerse(verse, opts.notes, maxNumWidth));
+        verseCount++;
+    }
+    if (opts.notes && footnotes.length > 0) {
+        // Only show footnotes whose markers actually appear inline in the displayed
+        // verses. This prevents duplicates where the same note is stored under
+        // multiple markers (e.g. '2', 'd', and '2d' for the same footnote — only
+        // '2d' appears in the verse text so only that one is shown).
+        const inlineMarkers = new Set();
+        for (const v of verses) {
+            for (const m of v.text.matchAll(/\[([^\]]+)\]/g)) {
+                inlineMarkers.add(m[1]);
+            }
+        }
+        const scoped = footnotes.filter(f => inlineMarkers.has(f.marker));
+        if (scoped.length > 0) {
+            lines.push('');
+            lines.push(renderFootnoteBlock(scoped));
+        }
+    }
+    return lines.join('\n');
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};