rv-bible-cli 0.1.0

package/dist/ui/Pager.js

@@ -0,0 +1,999 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState, useMemo, useEffect, useCallback, useRef } from 'react';
+import { render, Box, Text, useInput, useApp, useStdout } from 'ink';
+import chalk from 'chalk';
+import clipboard from 'clipboardy';
+import { getVersesByRef, getSectionHeaders, getFootnotesForChapter, getFootnotesForVerses, getCrossRefsForVerse, getBookInfo, getAllBooks, } from '../db.js';
+import { renderVerses, stripMarkers, highlightTerms, toSuperscript } from '../format.js';
+import { saveLastRead, getLastRead } from '../state.js';
+import { resolveBook } from '../parser.js';
+import { getNextChapter, getPrevChapter } from './nav.js';
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function stripAnsi(s) {
+    return s.replace(/\x1b\[[0-9;]*m/g, '');
+}
+// Detect verse-number lines by checking for chalk.dim() ANSI code (\x1b[2m) before
+// a superscript character. This distinguishes verse numbers (dim) from inline footnote
+// markers (cyan) that could appear at the start of word-wrapped continuation lines.
+// Fallback regex (no ANSI) for edge cases where chalk colors are disabled.
+const VERSE_NUM_ANSI = /^\s+\x1b\[2m[\u2070-\u209F\u00B9\u00B2\u00B3]/;
+const VERSE_NUM_PLAIN = /^\s{2,4}[\u2070-\u209F\u00B9\u00B2\u00B3]/;
+function buildVerseLineMap(lines, verses) {
+    // Pick regex: check if first lines contain ANSI codes at all
+    const hasAnsi = lines.some(l => /\x1b\[/.test(l));
+    const re = hasAnsi ? VERSE_NUM_ANSI : VERSE_NUM_PLAIN;
+    const map = [];
+    let vIdx = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (re.test(lines[i]) && vIdx < verses.length) {
+            if (map.length > 0)
+                map[map.length - 1].endLine = i - 1;
+            map.push({ verse: verses[vIdx].verse, startLine: i, endLine: i });
+            vIdx++;
+        }
+    }
+    if (map.length > 0)
+        map[map.length - 1].endLine = lines.length - 1;
+    return map;
+}
+function verseAtLine(map, line) {
+    for (let i = map.length - 1; i >= 0; i--) {
+        if (map[i].startLine <= line)
+            return i;
+    }
+    return 0;
+}
+// ── Home screen helpers ──────────────────────────────────────────────────────
+const GRID_COLS = 12;
+function getBookGrid() {
+    const all = getAllBooks();
+    return { ot: all.filter(b => b.testament === 'OT'), nt: all.filter(b => b.testament === 'NT') };
+}
+function flatBookList() {
+    const { ot, nt } = getBookGrid();
+    return [...ot, ...nt];
+}
+const OT_COUNT = 39;
+const TOTAL_BOOKS = 66;
+const OT_ROWS = Math.ceil(OT_COUNT / GRID_COLS);
+const NT_ROWS = Math.ceil((TOTAL_BOOKS - OT_COUNT) / GRID_COLS);
+// Navigate the home grid: handles OT↔NT boundary, row/col aware
+function gridMove(idx, dir) {
+    if (dir === 'left')
+        return Math.max(0, idx - 1);
+    if (dir === 'right')
+        return Math.min(TOTAL_BOOKS - 1, idx + 1);
+    const inOT = idx < OT_COUNT;
+    const sectionStart = inOT ? 0 : OT_COUNT;
+    const localIdx = idx - sectionStart;
+    const row = Math.floor(localIdx / GRID_COLS);
+    const col = localIdx % GRID_COLS;
+    if (dir === 'down') {
+        if (inOT) {
+            const nextRow = row + 1;
+            if (nextRow < OT_ROWS) {
+                // Stay in OT, clamp to last book in that row
+                return Math.min(sectionStart + nextRow * GRID_COLS + col, OT_COUNT - 1);
+            }
+            // Jump to NT row 0, same column
+            return Math.min(OT_COUNT + col, TOTAL_BOOKS - 1);
+        }
+        else {
+            const nextRow = row + 1;
+            if (nextRow < NT_ROWS) {
+                return Math.min(sectionStart + nextRow * GRID_COLS + col, TOTAL_BOOKS - 1);
+            }
+            return idx; // already at bottom
+        }
+    }
+    // dir === 'up'
+    if (inOT) {
+        if (row > 0) {
+            return sectionStart + (row - 1) * GRID_COLS + col;
+        }
+        return idx; // already at top
+    }
+    else {
+        if (row > 0) {
+            return Math.min(sectionStart + (row - 1) * GRID_COLS + col, TOTAL_BOOKS - 1);
+        }
+        // Jump to OT last row, same column
+        const otLastRowStart = (OT_ROWS - 1) * GRID_COLS;
+        return Math.min(otLastRowStart + col, OT_COUNT - 1);
+    }
+}
+// ── Pager Component ──────────────────────────────────────────────────────────
+function Pager({ initialBook, initialChapter, initialNotes, initialOutline, startHome }) {
+    const { exit } = useApp();
+    const { stdout } = useStdout();
+    // Chapter position (state + refs for useInput access)
+    const [book, setBook] = useState(initialBook ?? 'Gen');
+    const [chapter, setChapter] = useState(initialChapter ?? 1);
+    const bookRef = useRef(book);
+    const chapterRef = useRef(chapter);
+    useEffect(() => { bookRef.current = book; }, [book]);
+    useEffect(() => { chapterRef.current = chapter; }, [chapter]);
+    // Display toggles
+    const [notes, setNotes] = useState(initialNotes);
+    const [outline, setOutline] = useState(initialOutline);
+    // Scroll
+    const [scrollOffset, setScrollOffset] = useState(0);
+    const scrollRef = useRef(scrollOffset);
+    useEffect(() => { scrollRef.current = scrollOffset; }, [scrollOffset]);
+    // Mode
+    const [mode, setMode] = useState(startHome ? 'home' : 'normal');
+    // Copy mode state
+    const [cursorIdx, setCursorIdx] = useState(0);
+    const [selStart, setSelStart] = useState(null);
+    // Search mode state
+    const [searchQuery, setSearchQuery] = useState('');
+    const [searchSubmitted, setSearchSubmitted] = useState(false);
+    const [searchMatches, setSearchMatches] = useState([]);
+    const [matchIdx, setMatchIdx] = useState(0);
+    // Goto mode state
+    const [gotoInput, setGotoInput] = useState('');
+    // Navigation history: back/forward stacks (refs so useInput always sees latest)
+    const historyRef = useRef([]);
+    const forwardRef = useRef([]);
+    // Home mode state
+    const [homeIdx, setHomeIdx] = useState(0); // index into flat book list
+    const [homeChapter, setHomeChapter] = useState(1); // chapter selector
+    const allBooks = useMemo(() => flatBookList(), []);
+    const lastLetterRef = useRef(''); // tracks last typed letter for cycling
+    // Study mode state
+    const [studyCursorIdx, setStudyCursorIdx] = useState(0);
+    const [studySelStart, setStudySelStart] = useState(null);
+    const [studyRefInput, setStudyRefInput] = useState(''); // multi-digit ref number
+    const studyActiveRef = useRef(false); // persists across navigate so study mode survives ref follows
+    const pendingVerseRef = useRef(null); // target verse to jump to after navigate
+    // Flash message
+    const [flash, setFlash] = useState('');
+    // Terminal dimensions
+    const rows = stdout?.rows ?? 24;
+    const cols = stdout?.columns ?? 80;
+    // ── Chapter data (derived) ───────────────────────────────────────────────
+    const { verses, lines, verseMap, bookName, chapterCount } = useMemo(() => {
+        if (mode === 'home' || mode === 'home-chapter') {
+            return { verses: [], lines: [], verseMap: [], bookName: '', chapterCount: 0 };
+        }
+        const ref = { book, chapter };
+        const v = getVersesByRef(ref);
+        const info = getBookInfo(book);
+        const bName = info?.full_name ?? book;
+        const cCount = info?.chapter_count ?? 1;
+        const headers = outline ? getSectionHeaders(book) : [];
+        // In study mode: show inline markers but skip the footnote block (panel handles it)
+        const showBlock = notes && !studyActiveRef.current;
+        const footnotes = showBlock ? getFootnotesForChapter(book, chapter) : [];
+        const title = `${bName} ${chapter}`;
+        const rendered = renderVerses(v, headers, footnotes, { notes, title });
+        const ls = rendered.split('\n');
+        const vm = buildVerseLineMap(ls, v);
+        return { verses: v, lines: ls, verseMap: vm, bookName: bName, chapterCount: cCount };
+    }, [book, chapter, notes, outline, cols, mode]);
+    // ── Jump to pending target verse after navigate ───────────────────────
+    useEffect(() => {
+        const target = pendingVerseRef.current;
+        if (!target || verseMap.length === 0)
+            return;
+        pendingVerseRef.current = null;
+        // Find the verse in the map (handle sub-verses: '8' matches '8', '8a', '8b')
+        let idx = verseMap.findIndex(e => e.verse === target);
+        if (idx < 0)
+            idx = verseMap.findIndex(e => e.verse.startsWith(target));
+        if (idx >= 0) {
+            setStudyCursorIdx(idx);
+            const entry = verseMap[idx];
+            setScrollOffset(Math.max(0, entry.startLine - 2)); // show a couple lines of context above
+        }
+    }, [verseMap]);
+    const studyPanel = useMemo(() => {
+        if (mode !== 'study' || verseMap.length === 0)
+            return { lines: [], refs: [] };
+        const entry = verseMap[studyCursorIdx];
+        if (!entry)
+            return { lines: [], refs: [] };
+        const v = verses.find(vv => vv.verse === entry.verse);
+        if (!v)
+            return { lines: [], refs: [] };
+        // Get footnotes for this verse (only markers that appear inline)
+        const allFootnotes = getFootnotesForVerses(book, chapter, [v.verse]);
+        const inlineMarkers = new Set([...v.text.matchAll(/\[([^\]]+)\]/g)].map(m => m[1]));
+        const fns = allFootnotes.filter(f => inlineMarkers.has(f.marker));
+        // Get cross-refs for this verse, grouped by marker
+        const crossRefs = getCrossRefsForVerse(book, chapter, v.verse);
+        const refsByMarker = new Map();
+        for (const cr of crossRefs) {
+            const list = refsByMarker.get(cr.src_marker) ?? [];
+            list.push(cr);
+            refsByMarker.set(cr.src_marker, list);
+        }
+        // Build numbered refs and display lines
+        const studyRefs = [];
+        const panelLines = [];
+        const verseLabel = `${bookName} ${chapter}:${v.verse}`;
+        panelLines.push(`  ${chalk.bold(verseLabel)} ${chalk.dim(`— ${fns.length} note${fns.length === 1 ? '' : 's'}`)}`);
+        for (const fn of fns) {
+            // Extract the word the marker attaches to (first word after "Book ch:v word" in footnote text)
+            const fnTextParts = fn.text.split(/\s+/);
+            const word = fnTextParts[2] ?? ''; // "Joh 3:16 loved ..." → "loved"
+            const markerDisp = toSuperscript(fn.marker);
+            const refs = refsByMarker.get(fn.marker) ?? [];
+            // Deduplicate refs by target
+            const seen = new Set();
+            const uniqueRefs = refs.filter(r => {
+                const key = `${r.tgt_book}:${r.tgt_chapter}:${r.tgt_verse}`;
+                if (seen.has(key))
+                    return false;
+                seen.add(key);
+                return true;
+            });
+            if (uniqueRefs.length === 0) {
+                // Study note with no cross-refs — show truncated text
+                const notePreview = fn.text.length > 60 ? fn.text.substring(0, 57) + '...' : fn.text;
+                panelLines.push(`  ${chalk.cyan(markerDisp)} ${chalk.dim(word)}  ${chalk.dim(notePreview)}`);
+            }
+            else {
+                // Build numbered ref labels
+                const refLabels = [];
+                for (const r of uniqueRefs) {
+                    const refNum = studyRefs.length + 1;
+                    const tgtBookName = getBookInfo(r.tgt_book)?.abbr ?? r.tgt_book;
+                    const label = `${tgtBookName} ${r.tgt_chapter}:${r.tgt_verse}`;
+                    studyRefs.push({
+                        num: refNum, marker: fn.marker,
+                        tgt_book: r.tgt_book, tgt_chapter: r.tgt_chapter, tgt_verse: r.tgt_verse, label,
+                    });
+                    refLabels.push(`${chalk.yellow(`[${refNum}]`)} ${chalk.dim(label)}`);
+                }
+                // Compact: marker + word + refs on one line (wrap if needed)
+                const hasStudyNote = fn.text.length > 80;
+                const noteHint = hasStudyNote ? chalk.dim(' (note)') : '';
+                panelLines.push(`  ${chalk.cyan(markerDisp)} ${chalk.dim(word)}${noteHint}  ${refLabels.join('  ')}`);
+            }
+        }
+        return { lines: panelLines, refs: studyRefs };
+    }, [mode, studyCursorIdx, verseMap, verses, book, chapter, bookName]);
+    // ── Viewport height (shrinks when study panel is visible) ────────────
+    const studyPanelH = studyPanel.lines.length > 0 ? studyPanel.lines.length + 1 : 0; // +1 for separator
+    const hasFooter2 = mode === 'normal' || mode === 'study';
+    const chromeH = 3 + (hasFooter2 ? 2 : 1) + studyPanelH; // header + sep + footer(s) + sep + panel
+    const viewportH = Math.max(1, rows - chromeH);
+    // Clamp scroll when content or viewport changes
+    const maxScroll = Math.max(0, lines.length - viewportH);
+    useEffect(() => {
+        setScrollOffset(prev => Math.min(prev, maxScroll));
+    }, [maxScroll]);
+    // ── Search highlights ────────────────────────────────────────────────────
+    const displayLines = useMemo(() => {
+        if (!searchSubmitted || searchMatches.length === 0)
+            return lines;
+        const q = searchQuery.toLowerCase();
+        return lines.map((line) => {
+            const stripped = stripAnsi(line);
+            if (!stripped.toLowerCase().includes(q))
+                return line;
+            return highlightTerms(stripped, [searchQuery]);
+        });
+    }, [lines, searchSubmitted, searchMatches, searchQuery]);
+    // ── Navigation helpers ───────────────────────────────────────────────────
+    const restoreMode = useCallback(() => {
+        setMode(studyActiveRef.current ? 'study' : 'normal');
+        setSearchSubmitted(false);
+        setSearchQuery('');
+        setSearchMatches([]);
+        setStudyRefInput('');
+        setStudyCursorIdx(0);
+    }, []);
+    const navigate = useCallback((newBook, newChapter, pushHistory = true) => {
+        if (pushHistory) {
+            historyRef.current = [...historyRef.current, { book: bookRef.current, chapter: chapterRef.current, scroll: scrollRef.current }];
+            forwardRef.current = [];
+        }
+        setBook(newBook);
+        setChapter(newChapter);
+        setScrollOffset(0);
+        restoreMode();
+        saveLastRead(newBook, newChapter);
+    }, [restoreMode]);
+    const goBack = useCallback(() => {
+        const hist = historyRef.current;
+        if (hist.length === 0)
+            return;
+        const last = hist[hist.length - 1];
+        forwardRef.current = [...forwardRef.current, { book: bookRef.current, chapter: chapterRef.current, scroll: scrollRef.current }];
+        historyRef.current = hist.slice(0, -1);
+        setBook(last.book);
+        setChapter(last.chapter);
+        setScrollOffset(last.scroll);
+        restoreMode();
+        saveLastRead(last.book, last.chapter);
+    }, [restoreMode]);
+    const goForward = useCallback(() => {
+        const fwd = forwardRef.current;
+        if (fwd.length === 0)
+            return;
+        const next = fwd[fwd.length - 1];
+        historyRef.current = [...historyRef.current, { book: bookRef.current, chapter: chapterRef.current, scroll: scrollRef.current }];
+        forwardRef.current = fwd.slice(0, -1);
+        setBook(next.book);
+        setChapter(next.chapter);
+        setScrollOffset(next.scroll);
+        restoreMode();
+        saveLastRead(next.book, next.chapter);
+    }, [restoreMode]);
+    const goNext = useCallback(() => {
+        const next = getNextChapter(book, chapter);
+        if (next)
+            navigate(next.book, next.chapter);
+    }, [book, chapter, navigate]);
+    const goPrev = useCallback(() => {
+        const prev = getPrevChapter(book, chapter);
+        if (prev)
+            navigate(prev.book, prev.chapter);
+    }, [book, chapter, navigate]);
+    // ── Scroll helpers ───────────────────────────────────────────────────────
+    const scrollTo = useCallback((n) => {
+        setScrollOffset(Math.max(0, Math.min(n, maxScroll)));
+    }, [maxScroll]);
+    const scrollDown = useCallback(() => scrollTo(scrollOffset + 1), [scrollOffset, scrollTo]);
+    const scrollUp = useCallback(() => scrollTo(scrollOffset - 1), [scrollOffset, scrollTo]);
+    const pageDown = useCallback(() => scrollTo(scrollOffset + viewportH - 2), [scrollOffset, viewportH, scrollTo]);
+    const pageUp = useCallback(() => scrollTo(scrollOffset - viewportH + 2), [scrollOffset, viewportH, scrollTo]);
+    // ── Copy helpers ─────────────────────────────────────────────────────────
+    const doCopy = useCallback(async () => {
+        const lo = selStart !== null ? Math.min(selStart, cursorIdx) : cursorIdx;
+        const hi = selStart !== null ? Math.max(selStart, cursorIdx) : cursorIdx;
+        const selected = verses.slice(lo, hi + 1);
+        if (selected.length === 0)
+            return;
+        const text = selected.map(v => `${bookName} ${v.chapter}:${v.verse}  ${stripMarkers(v.text)}`).join('\n');
+        await clipboard.write(text);
+        const refLabel = selected.length === 1
+            ? `${bookName} ${chapter}:${selected[0].verse}`
+            : `${bookName} ${chapter}:${selected[0].verse}–${selected[selected.length - 1].verse}`;
+        setFlash(`Copied ${refLabel}`);
+        setTimeout(() => setFlash(''), 2000);
+        setMode('normal');
+        setSelStart(null);
+    }, [selStart, cursorIdx, verses, bookName, chapter]);
+    // ── Search helpers ───────────────────────────────────────────────────────
+    const submitSearch = useCallback(() => {
+        if (!searchQuery)
+            return;
+        const q = searchQuery.toLowerCase();
+        const matches = [];
+        for (let i = 0; i < lines.length; i++) {
+            if (stripAnsi(lines[i]).toLowerCase().includes(q))
+                matches.push(i);
+        }
+        setSearchMatches(matches);
+        setSearchSubmitted(true);
+        setMatchIdx(0);
+        if (matches.length > 0)
+            scrollTo(matches[0]);
+    }, [searchQuery, lines, scrollTo]);
+    const nextMatch = useCallback(() => {
+        if (searchMatches.length === 0)
+            return;
+        const next = (matchIdx + 1) % searchMatches.length;
+        setMatchIdx(next);
+        scrollTo(searchMatches[next]);
+    }, [matchIdx, searchMatches, scrollTo]);
+    const prevMatch = useCallback(() => {
+        if (searchMatches.length === 0)
+            return;
+        const prev = (matchIdx - 1 + searchMatches.length) % searchMatches.length;
+        setMatchIdx(prev);
+        scrollTo(searchMatches[prev]);
+    }, [matchIdx, searchMatches, scrollTo]);
+    // ── Goto helpers ─────────────────────────────────────────────────────────
+    const submitGoto = useCallback(() => {
+        const trimmed = gotoInput.trim();
+        if (!trimmed) {
+            setMode(studyActiveRef.current ? 'study' : 'normal');
+            return;
+        }
+        // Try parsing as "book chapter" or just "book"
+        const parts = trimmed.split(/\s+/);
+        // Try longest book match first (e.g. "song of songs 1")
+        for (let nameLen = Math.min(parts.length, 4); nameLen >= 1; nameLen--) {
+            const bookCandidate = parts.slice(0, nameLen).join(' ');
+            const resolved = resolveBook(bookCandidate);
+            if (resolved) {
+                const chNum = parts[nameLen] ? parseInt(parts[nameLen], 10) : 1;
+                const info = getBookInfo(resolved);
+                const validCh = Math.max(1, Math.min(chNum || 1, info?.chapter_count ?? 1));
+                navigate(resolved, validCh);
+                setGotoInput('');
+                return;
+            }
+        }
+        // No match — flash error
+        setFlash(`Unknown: "${trimmed}"`);
+        setTimeout(() => setFlash(''), 2000);
+        setMode(studyActiveRef.current ? 'study' : 'normal');
+        setGotoInput('');
+    }, [gotoInput, navigate]);
+    // ── Keyboard input ───────────────────────────────────────────────────────
+    useInput((input, key) => {
+        // ── Home mode: book grid browser ─────────────────────────────────────
+        if (mode === 'home') {
+            if (key.escape || input === 'q') {
+                if (initialBook) {
+                    setMode('normal');
+                }
+                else {
+                    exit();
+                }
+                return;
+            }
+            // Space = continue reading last-read chapter
+            if (input === ' ') {
+                const last = getLastRead();
+                if (last)
+                    navigate(last.book, last.chapter);
+                return;
+            }
+            if (key.return) {
+                const selectedBook = allBooks[homeIdx];
+                if (selectedBook) {
+                    const info = getBookInfo(selectedBook.abbr);
+                    if (info && info.chapter_count === 1) {
+                        navigate(selectedBook.abbr, 1);
+                    }
+                    else {
+                        setHomeChapter(1);
+                        setMode('home-chapter');
+                    }
+                }
+                return;
+            }
+            // Arrow keys only for grid navigation (no j/k/h/l — those are type-ahead)
+            if (key.rightArrow) {
+                setHomeIdx(prev => gridMove(prev, 'right'));
+                return;
+            }
+            if (key.leftArrow) {
+                setHomeIdx(prev => gridMove(prev, 'left'));
+                return;
+            }
+            if (key.downArrow) {
+                setHomeIdx(prev => gridMove(prev, 'down'));
+                return;
+            }
+            if (key.upArrow) {
+                setHomeIdx(prev => gridMove(prev, 'up'));
+                return;
+            }
+            // All letter/number keys → type-ahead jump; repeat same letter cycles matches
+            if (input && /^[a-zA-Z0-9]$/.test(input)) {
+                const lower = input.toLowerCase();
+                const matches = allBooks
+                    .map((b, i) => ({ i, b }))
+                    .filter(({ b }) => b.abbr.toLowerCase().startsWith(lower) || b.full_name.toLowerCase().startsWith(lower));
+                if (matches.length > 0) {
+                    if (lower === lastLetterRef.current) {
+                        // Same letter again: cycle to next match after current position
+                        const nextMatch = matches.find(m => m.i > homeIdx) ?? matches[0];
+                        setHomeIdx(nextMatch.i);
+                    }
+                    else {
+                        setHomeIdx(matches[0].i);
+                    }
+                    lastLetterRef.current = lower;
+                }
+                return;
+            }
+            return;
+        }
+        // ── Home-chapter mode: chapter number selector ───────────────────────
+        if (mode === 'home-chapter') {
+            const selectedBook = allBooks[homeIdx];
+            const maxCh = selectedBook ? (getBookInfo(selectedBook.abbr)?.chapter_count ?? 1) : 1;
+            if (key.escape) {
+                setMode('home');
+                return;
+            }
+            if (key.return) {
+                if (selectedBook)
+                    navigate(selectedBook.abbr, homeChapter);
+                return;
+            }
+            if (key.rightArrow || input === 'l') {
+                setHomeChapter(prev => Math.min(prev + 1, maxCh));
+                return;
+            }
+            if (key.leftArrow || input === 'h') {
+                setHomeChapter(prev => Math.max(prev - 1, 1));
+                return;
+            }
+            if (key.downArrow || input === 'j') {
+                setHomeChapter(prev => Math.min(prev + 10, maxCh));
+                return;
+            }
+            if (key.upArrow || input === 'k') {
+                setHomeChapter(prev => Math.max(prev - 10, 1));
+                return;
+            }
+            // Number keys: build chapter number
+            if (input && /^[0-9]$/.test(input)) {
+                setHomeChapter(prev => {
+                    const next = prev * 10 + parseInt(input, 10);
+                    return next > maxCh ? parseInt(input, 10) : next;
+                });
+                return;
+            }
+            return;
+        }
+        // ── Search mode ──────────────────────────────────────────────────────
+        if (mode === 'search') {
+            const returnMode = studyActiveRef.current ? 'study' : 'normal';
+            if (key.escape) {
+                setMode(returnMode);
+                setSearchQuery('');
+                setSearchSubmitted(false);
+                setSearchMatches([]);
+                return;
+            }
+            if (key.return) {
+                submitSearch();
+                setMode(returnMode);
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setSearchQuery(prev => prev.slice(0, -1));
+                return;
+            }
+            if (searchSubmitted && input === 'n') {
+                nextMatch();
+                return;
+            }
+            if (searchSubmitted && input === 'N') {
+                prevMatch();
+                return;
+            }
+            if (input && !key.ctrl && !key.meta) {
+                setSearchQuery(prev => prev + input);
+            }
+            return;
+        }
+        // ── Goto mode ────────────────────────────────────────────────────────
+        if (mode === 'goto') {
+            if (key.escape) {
+                setMode(studyActiveRef.current ? 'study' : 'normal');
+                setGotoInput('');
+                return;
+            }
+            if (key.return) {
+                submitGoto();
+                return;
+            }
+            if (key.backspace || key.delete) {
+                setGotoInput(prev => prev.slice(0, -1));
+                return;
+            }
+            if (input && !key.ctrl && !key.meta) {
+                setGotoInput(prev => prev + input);
+            }
+            return;
+        }
+        // ── Study mode ───────────────────────────────────────────────────────
+        if (mode === 'study') {
+            if (key.escape || input === 'd') {
+                setMode('normal');
+                studyActiveRef.current = false;
+                setStudyRefInput('');
+                setStudySelStart(null);
+                return;
+            }
+            if (input === '[') {
+                goBack();
+                return;
+            }
+            if (input === ']') {
+                goForward();
+                return;
+            }
+            if (input === 'j' || key.downArrow) {
+                setStudyCursorIdx(prev => {
+                    const next = Math.min(prev + 1, verseMap.length - 1);
+                    const entry = verseMap[next];
+                    if (entry && entry.startLine >= scrollOffset + viewportH) {
+                        scrollTo(entry.startLine - viewportH + 3);
+                    }
+                    return next;
+                });
+                setStudyRefInput('');
+                return;
+            }
+            if (input === 'k' || key.upArrow) {
+                setStudyCursorIdx(prev => {
+                    const next = Math.max(prev - 1, 0);
+                    const entry = verseMap[next];
+                    if (entry && entry.startLine < scrollOffset) {
+                        scrollTo(entry.startLine);
+                    }
+                    return next;
+                });
+                setStudyRefInput('');
+                return;
+            }
+            // Number keys: build ref number, then follow on Enter or after short delay
+            if (input && /^[0-9]$/.test(input)) {
+                const newInput = studyRefInput + input;
+                setStudyRefInput(newInput);
+                const num = parseInt(newInput, 10);
+                // Auto-follow if the number can't grow to match any ref
+                const maxRef = studyPanel.refs.length;
+                if (num > 0 && num <= maxRef && num * 10 > maxRef) {
+                    // Unambiguous — follow immediately
+                    const ref = studyPanel.refs[num - 1];
+                    setStudyRefInput('');
+                    pendingVerseRef.current = ref.tgt_verse;
+                    navigate(ref.tgt_book, ref.tgt_chapter);
+                }
+                return;
+            }
+            if (key.return && studyRefInput) {
+                const num = parseInt(studyRefInput, 10);
+                if (num > 0 && num <= studyPanel.refs.length) {
+                    const ref = studyPanel.refs[num - 1];
+                    setStudyRefInput('');
+                    pendingVerseRef.current = ref.tgt_verse;
+                    navigate(ref.tgt_book, ref.tgt_chapter);
+                }
+                else {
+                    setStudyRefInput('');
+                }
+                return;
+            }
+            // Chapter nav
+            if (input === 'n' || key.rightArrow) {
+                goNext();
+                return;
+            }
+            if (input === 'p' || key.leftArrow) {
+                goPrev();
+                return;
+            }
+            // Range selection
+            if (input === 'v') {
+                setStudySelStart(studyCursorIdx);
+                return;
+            }
+            // Copy cursor verse or selected range
+            if (input === 'c') {
+                const lo = studySelStart !== null ? Math.min(studySelStart, studyCursorIdx) : studyCursorIdx;
+                const hi = studySelStart !== null ? Math.max(studySelStart, studyCursorIdx) : studyCursorIdx;
+                const selected = verses.slice(lo, hi + 1);
+                if (selected.length > 0) {
+                    const text = selected.map(v => `${bookName} ${v.chapter}:${v.verse}  ${stripMarkers(v.text)}`).join('\n');
+                    const refLabel = selected.length === 1
+                        ? `${bookName} ${chapter}:${selected[0].verse}`
+                        : `${bookName} ${chapter}:${selected[0].verse}–${selected[selected.length - 1].verse}`;
+                    clipboard.write(text).then(() => {
+                        setFlash(`Copied ${refLabel}`);
+                        setTimeout(() => setFlash(''), 2000);
+                    });
+                    setStudySelStart(null);
+                }
+                return;
+            }
+            // Goto
+            if (input === ':') {
+                setMode('goto');
+                setGotoInput('');
+                return;
+            }
+            // Search within chapter
+            if (input === '/') {
+                setMode('search');
+                setSearchQuery('');
+                setSearchSubmitted(false);
+                setSearchMatches([]);
+                return;
+            }
+            return;
+        }
+        // ── Copy mode ────────────────────────────────────────────────────────
+        if (mode === 'copy') {
+            if (key.escape) {
+                setMode('normal');
+                setSelStart(null);
+                return;
+            }
+            if (input === 'j' || key.downArrow) {
+                setCursorIdx(prev => {
+                    const next = Math.min(prev + 1, verseMap.length - 1);
+                    const entry = verseMap[next];
+                    if (entry && entry.startLine >= scrollOffset + viewportH) {
+                        scrollTo(entry.startLine - viewportH + 3);
+                    }
+                    return next;
+                });
+                return;
+            }
+            if (input === 'k' || key.upArrow) {
+                setCursorIdx(prev => {
+                    const next = Math.max(prev - 1, 0);
+                    const entry = verseMap[next];
+                    if (entry && entry.startLine < scrollOffset) {
+                        scrollTo(entry.startLine);
+                    }
+                    return next;
+                });
+                return;
+            }
+            if (input === 'v') {
+                setSelStart(cursorIdx);
+                return;
+            }
+            if (key.return || input === 'c') {
+                doCopy();
+                return;
+            }
+            return;
+        }
+        // ── Normal mode ──────────────────────────────────────────────────────
+        if (input === 'q' || key.escape) {
+            exit();
+            return;
+        }
+        if (input === 'j' || key.downArrow) {
+            scrollDown();
+            return;
+        }
+        if (input === 'k' || key.upArrow) {
+            scrollUp();
+            return;
+        }
+        if (input === ' ') {
+            pageDown();
+            return;
+        }
+        if (input === 'b') {
+            pageUp();
+            return;
+        }
+        if (input === 'g') {
+            scrollTo(0);
+            return;
+        }
+        if (input === 'G') {
+            scrollTo(maxScroll);
+            return;
+        }
+        if (input === 'n' || key.rightArrow) {
+            if (searchSubmitted && searchMatches.length > 0) {
+                nextMatch();
+            }
+            else {
+                goNext();
+            }
+            return;
+        }
+        if (input === 'N') {
+            prevMatch();
+            return;
+        }
+        if (input === 'p' || key.leftArrow) {
+            goPrev();
+            return;
+        }
+        if (input === 'f') {
+            setNotes(prev => !prev);
+            return;
+        }
+        if (input === 'o') {
+            setOutline(prev => !prev);
+            return;
+        }
+        if (input === '/') {
+            setMode('search');
+            setSearchQuery('');
+            setSearchSubmitted(false);
+            setSearchMatches([]);
+            return;
+        }
+        if (input === 'c') {
+            setMode('copy');
+            setCursorIdx(verseAtLine(verseMap, scrollOffset));
+            setSelStart(null);
+            return;
+        }
+        if (input === ':') {
+            setMode('goto');
+            setGotoInput('');
+            return;
+        }
+        if (input === 'd') {
+            setMode('study');
+            studyActiveRef.current = true;
+            if (!notes)
+                setNotes(true);
+            setStudyCursorIdx(verseAtLine(verseMap, scrollOffset));
+            setStudyRefInput('');
+            return;
+        }
+        if (input === 'H') {
+            setMode('home');
+            return;
+        }
+        if (input === '[') {
+            goBack();
+            return;
+        }
+        if (input === ']') {
+            goForward();
+            return;
+        }
+    });
+    // ── Home screen render ───────────────────────────────────────────────────
+    if (mode === 'home' || mode === 'home-chapter') {
+        const { ot, nt } = getBookGrid();
+        const last = getLastRead();
+        const selectedBook = allBooks[homeIdx];
+        const homeLines = [];
+        homeLines.push('');
+        homeLines.push(chalk.bold('  Recovery Version Bible'));
+        homeLines.push('');
+        if (last) {
+            const lastBookName = getBookInfo(last.book)?.full_name ?? last.book;
+            homeLines.push(`  Last read: ${chalk.bold(`${lastBookName} ${last.chapter}`)}  ${chalk.dim('— press Space to continue')}`);
+        }
+        else {
+            homeLines.push(chalk.dim('  Select a book to start reading'));
+        }
+        homeLines.push('');
+        // Render book grid with cursor highlight
+        function renderGridRow(books, startIdx) {
+            return '  ' + books.map((b, i) => {
+                const flatIdx = startIdx + i;
+                const abbr = b.abbr.padEnd(5);
+                if (flatIdx === homeIdx)
+                    return chalk.inverse.bold(abbr);
+                return abbr;
+            }).join('');
+        }
+        homeLines.push(chalk.dim('  OLD TESTAMENT'));
+        for (let i = 0; i < ot.length; i += GRID_COLS) {
+            const row = ot.slice(i, i + GRID_COLS);
+            homeLines.push(renderGridRow(row, i));
+        }
+        homeLines.push('');
+        homeLines.push(chalk.dim('  NEW TESTAMENT'));
+        const otLen = ot.length;
+        for (let i = 0; i < nt.length; i += GRID_COLS) {
+            const row = nt.slice(i, i + GRID_COLS);
+            homeLines.push(renderGridRow(row, otLen + i));
+        }
+        if (mode === 'home-chapter' && selectedBook) {
+            const info = getBookInfo(selectedBook.abbr);
+            const maxCh = info?.chapter_count ?? 1;
+            homeLines.push('');
+            homeLines.push(`  ${chalk.bold(selectedBook.full_name)} — select chapter:`);
+            // Render chapter numbers in rows of 10
+            const chNums = [];
+            for (let c = 1; c <= maxCh; c++) {
+                const label = String(c).padStart(3);
+                chNums.push(c === homeChapter ? chalk.inverse.bold(label) : chalk.dim(label));
+            }
+            for (let i = 0; i < chNums.length; i += 10) {
+                homeLines.push('  ' + chNums.slice(i, i + 10).join(' '));
+            }
+        }
+        const homeContent = homeLines.join('\n');
+        let homeFooter;
+        if (mode === 'home-chapter') {
+            homeFooter = `  ${chalk.dim('←/→ or type number · Enter go · Esc back')}`;
+        }
+        else {
+            const lastRead = getLastRead();
+            const continueHint = lastRead ? 'Space continue · ' : '';
+            homeFooter = `  ${chalk.dim(`↑↓←→ navigate · Enter select · ${continueHint}type letter to jump · q quit`)}`;
+        }
+        const homeSep = chalk.dim('─'.repeat(cols));
+        return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsx(Text, { children: chalk.bold('  rv') }), _jsx(Text, { children: homeSep }), _jsx(Box, { flexGrow: 1, overflow: "hidden", children: _jsx(Text, { children: homeContent }) }), _jsx(Text, { children: homeSep }), _jsx(Text, { children: homeFooter })] }));
+    }
+    // ── Chapter view: build visible content ──────────────────────────────────
+    const visibleSlice = displayLines.slice(scrollOffset, scrollOffset + viewportH);
+    // Apply cursor highlight for copy mode and study mode
+    const contentLines = (mode === 'copy' || mode === 'study') ? visibleSlice.map((line, viewIdx) => {
+        const absLine = scrollOffset + viewIdx;
+        const isCopy = mode === 'copy';
+        const cursor = isCopy ? cursorIdx : studyCursorIdx;
+        const sel = isCopy ? selStart : studySelStart;
+        const lo = sel !== null ? Math.min(sel, cursor) : cursor;
+        const hi = sel !== null ? Math.max(sel, cursor) : cursor;
+        for (let v = lo; v <= hi; v++) {
+            const entry = verseMap[v];
+            if (entry && absLine >= entry.startLine && absLine <= entry.endLine) {
+                if (isCopy) {
+                    // Copy mode: full inverse highlight
+                    return absLine === entry.startLine
+                        ? chalk.inverse(`› ${stripAnsi(line)}`)
+                        : chalk.inverse(`  ${stripAnsi(line)}`);
+                }
+                // Study mode: subtle — just a › marker on first line, no bg change
+                if (absLine === entry.startLine) {
+                    return `${chalk.cyan('›')}${line.substring(1)}`;
+                }
+                return line;
+            }
+        }
+        return line;
+    }) : visibleSlice;
+    const content = contentLines.join('\n');
+    // ── Header ───────────────────────────────────────────────────────────────
+    const CATEGORY_LABELS = {
+        Moses: 'Books of Moses', Israel: 'History of Israel', Poetry: 'Poetry & Wisdom',
+        MajorProphets: 'Major Prophets', MinorProphets: 'Minor Prophets',
+        Gospels: 'Gospels', Paul: 'Epistles of Paul', Others: 'General Epistles & Prophecy',
+    };
+    const bookInfo = getBookInfo(book);
+    const categoryLabel = CATEGORY_LABELS[bookInfo?.category ?? ''] ?? '';
+    const topVerseIdx = verseAtLine(verseMap, scrollOffset) + 1;
+    const title = `${bookName} ${chapter}`;
+    const position = `${topVerseIdx}/${verses.length}`;
+    const titleLeft = categoryLabel
+        ? `  ${title}  ${chalk.dim('·')}  ${chalk.dim(categoryLabel)}`
+        : `  ${title}`;
+    const headerPad = Math.max(1, cols - stripAnsi(titleLeft).length - position.length - 2);
+    const header = `${titleLeft}${' '.repeat(headerPad)}${chalk.dim(position)}`;
+    // ── Footer (two lines for normal/study, one line for modal modes) ──────
+    let footer1;
+    let footer2 = null;
+    if (flash) {
+        footer1 = `  ${chalk.green(`✓ ${flash}`)}`;
+    }
+    else if (mode === 'search') {
+        if (searchSubmitted) {
+            const countLabel = searchMatches.length === 0
+                ? 'no matches'
+                : `match ${matchIdx + 1}/${searchMatches.length}`;
+            footer1 = `  / ${searchQuery}  ${chalk.dim(countLabel)}  ${chalk.dim('n/N cycle · Esc clear')}`;
+        }
+        else {
+            footer1 = `  / ${searchQuery}${chalk.dim('_')}  ${chalk.dim('Enter search · Esc cancel')}`;
+        }
+    }
+    else if (mode === 'goto') {
+        footer1 = `  : ${gotoInput}${chalk.dim('_')}  ${chalk.dim('e.g. rom 8 · Enter go · Esc cancel')}`;
+    }
+    else if (mode === 'study') {
+        const inputHint = studyRefInput ? ` ${chalk.yellow(studyRefInput)}${chalk.dim('_')}` : '';
+        const rangeHint = studySelStart !== null ? chalk.dim(' (range)') : '';
+        footer1 = `  ${chalk.cyan('STUDY')}${inputHint}${rangeHint}  ${chalk.dim('# follow ref · v range · c copy · / find')}`;
+        footer2 = `  ${chalk.dim('↑↓ verse · ←→ ch · : goto · [/] back/fwd · d exit')}`;
+    }
+    else if (mode === 'copy') {
+        const rangeHint = selStart !== null ? chalk.dim(' (range active)') : '';
+        footer1 = `  ${chalk.cyan('COPY')}${rangeHint}  ${chalk.dim('↑↓ move · v range · Enter copy · Esc cancel')}`;
+    }
+    else {
+        const noteFlag = notes ? chalk.cyan('f notes') : chalk.dim('f notes');
+        const outlineFlag = outline ? chalk.cyan('o outline') : chalk.dim('o outline');
+        footer1 = `  ${noteFlag} ${chalk.dim('·')} ${outlineFlag} ${chalk.dim('· d study · c copy · / find')}`;
+        footer2 = `  ${chalk.dim('↑↓ scroll · ←→ ch · : goto · H home · [/] back/fwd · q quit')}`;
+    }
+    const separator = chalk.dim('· '.repeat(Math.floor(cols / 2)));
+    // ── Render ───────────────────────────────────────────────────────────────
+    const studyPanelContent = studyPanel.lines.length > 0
+        ? studyPanel.lines.join('\n')
+        : null;
+    return (_jsxs(Box, { flexDirection: "column", height: rows, children: [_jsx(Text, { children: header }), _jsx(Text, { children: separator }), _jsx(Box, { flexGrow: 1, overflow: "hidden", children: _jsx(Text, { children: content }) }), _jsx(Text, { children: separator }), studyPanelContent && _jsx(Text, { children: studyPanelContent }), studyPanelContent && _jsx(Text, { children: separator }), _jsx(Text, { children: footer1 }), footer2 && _jsx(Text, { children: footer2 })] }));
+}
+// ── Launcher ─────────────────────────────────────────────────────────────────
+export async function launchPager(book, chapter, opts) {
+    process.stdout.write('\x1b[?1049h');
+    const instance = render(_jsx(Pager, { initialBook: book, initialChapter: chapter, initialNotes: opts.notes, initialOutline: opts.outline }));
+    await instance.waitUntilExit();
+    process.stdout.write('\x1b[?1049l');
+}
+export async function launchPagerHome() {
+    process.stdout.write('\x1b[?1049h');
+    const instance = render(_jsx(Pager, { initialNotes: false, initialOutline: false, startHome: true }));
+    await instance.waitUntilExit();
+    process.stdout.write('\x1b[?1049l');
+}