@joewalker/scripture-ref 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# 0.5.0 (2026-05-11)
+
+* Added a `Translation` class that loads a translation's text on demand via `Translation.create('ESV')` and exposes `getPassageText` and `search` as methods, paving the way for additional translations. The top-level `getPassageText` and `search` functions are retained as thin wrappers around an eagerly-loaded ESV translation and are now marked deprecated. The `BookName` and `VerseText` types are now exported from the public API, and the unused `Book` type has been removed.
+* Expanded reference parsing to recognise a normalised registry of alternate book spellings and abbreviations (for example `Gen`, `1Cor`, `Song of Sol`), with case-insensitive and punctuation-insensitive lookup. Parsing now reports an explicit error when a name resolves to more than one book instead of silently picking the first match.
+* Added a Damerau-Levenshtein fuzzy fallback when an exact book name lookup fails, so common typos such as `Genisis`, `Habakuk`, and `Revelaiton` now resolve to the intended book. The allowed edit distance scales with name length, and very short inputs stay unresolved to avoid colliding with the abbreviation table.
+* Reduced the size of the published package by deriving verse ordinal lookup tables from the per-chapter verse counts at load time instead of shipping a pre-built prefix-sum table.
+
 # 0.4.0 (2026-05-10)
 
 * The package is now published to npm as `@joewalker/scripture-ref`, alongside the existing tagged releases on GitLab.

package/README.md

@@ -44,7 +44,7 @@ src/
   __testutil__/index.ts    test-only re-exports (parser internals)
   book/
     books.ts               getPassageText, search
-    esv.json               ESV text (about 10MB)
+    data/*.json            Bible translations (about 10MB per file)
   passage/
     bible-info.ts          structural helpers
     verse.ts               Verse and parser

package/dist/book/books.d.ts

@@ -1,15 +1,26 @@
 import type { Passage } from '../passage/passage.js';
 import type { Verse } from '../passage/verse.js';
-type BookName = string;
-type BibleText = Record<BookName, Chapters>;
-type Chapters = ReadonlyArray<Verses>;
-type Verses = ReadonlyArray<Words>;
-type Words = ReadonlyArray<Word>;
-type Word = [string, string] | [string];
 /**
- *
+ * VerseText returns the text for a verse in calls to `getPassageText(…)`
  */
-export interface Book {
+export interface VerseText {
+    readonly verse: Verse;
+    readonly text: string;
+}
+/**
+ * Words might have Strong's numbers associated with them
+ */
+type WordData = [translation: string] | [translation: string, strongsNumber: string];
+/** A verse is an array of words */
+type VerseData = ReadonlyArray<WordData>;
+/** A chapter is an array of verses */
+type ChapterData = ReadonlyArray<VerseData>;
+/** A chapter is an array of chapters */
+type BookData = ReadonlyArray<ChapterData>;
+/**
+ * A book is metadata plus a record of books to arrays of chapterdata
+ */
+interface TranslationData {
     readonly version: string;
     readonly versionName: string;
     readonly meta: {
@@ -22,24 +33,36 @@ export interface Book {
         readonly license: string | null;
         readonly copyright: string;
     };
+    readonly books: Record<string, BookData>;
+}
+declare const BOOK_NAME: Readonly<{
+    ESV: "./data/ESV.json";
+}>;
+export type BookName = keyof typeof BOOK_NAME;
+/**
+ * The standard interface to the text of a Translation
+ */
+export declare class Translation {
+    #private;
+    static create(bookName: BookName): Promise<Translation>;
+    constructor(translationData: TranslationData);
     /**
-     * Record<BookName, Chapters>
-     * Chapters = ReadonlyArray<Verses>
-     * Verses = ReadonlyArray<Words>
-     * Words = [EnglishWords, StrongsNumber];
+     * Look up the Bible text for a given passage
      */
-    readonly books: BibleText;
-}
-export interface VerseText {
-    readonly verse: Verse;
-    readonly text: string;
+    getPassageText(passage: Passage): ReadonlyArray<VerseText>;
+    /**
+     * Produce the output text needed for a search term
+     */
+    search(terms: string): string;
 }
 /**
  * Look up the Bible text for a given passage
+ * @deprecated Use `Translation.create(bookId).getPassageText(passage)`
  */
 export declare function getPassageText(bookId: string, passage: Passage): ReadonlyArray<VerseText>;
 /**
  * Produce the output text needed for a search term
+ * @deprecated Use `Translation.create(bookId).search(terms)`
  */
 export declare function search(bookId: string, terms: string): string;
 export {};

package/dist/book/books.js

@@ -1,62 +1,8 @@
 import { chaptersInBook, verseOrdinal, versesInChapter, } from '../passage/bible-info.js';
 import { PassageTally } from '../passage/passage-tally.js';
-// https://github.com/jestjs/jest/issues/15000#issuecomment-2470602098
-const esv = (await import(/* webpackChunkName: "mobile/esv" */ './esv.json', {
-    with: { type: 'json' },
-})).default;
-// It's not clear why we need to cast to unknown before Book, I suspect some
-// data inconsistency
-const esvBibleText = esv.books;
-/**
- * Look up the Bible text for a given passage
- */
-export function getPassageText(bookId, passage) {
-    if (bookId !== 'ESV') {
-        throw new Error(`Unknown book: '${bookId}'.`);
-    }
-    const output = [];
-    for (const range of passage.verseRanges()) {
-        for (const verse of range.verses()) {
-            output.push({ verse, text: renderVerseText(lookupWords(verse)) });
-        }
-    }
-    return output;
-}
-function lookupWords(verse) {
-    const bookName = indexLookup[verse.book];
-    return esvBibleText[bookName][verse.chapter - 1][verse.verse - 1];
-}
-/**
- * Join the per-word entries for a single verse into a display string,
- * keeping attaching punctuation (.,;!?:) flush with the preceding word.
- */
-function renderVerseText(words) {
-    let text = '';
-    for (const word of words) {
-        const head = word[0];
-        if (text.length === 0 || isAttachingPunctuation(head)) {
-            text += head;
-        }
-        else {
-            text += ` ${head}`;
-        }
-    }
-    return text;
-}
-/**
- * True for punctuation that should attach to the previous word with no
- * intervening space (sentence/clause punctuation).
- */
-function isAttachingPunctuation(word) {
-    return (word.startsWith('.') ||
-        word.startsWith(',') ||
-        word.startsWith(';') ||
-        word.startsWith('!') ||
-        word.startsWith('?') ||
-        word.startsWith(':'));
-}
-const indexLookup = [
-    '',
+/** A lookup table for book names used in the TranslationData.books record */
+const BOOK_NAME_LOOKUP = [
+    '#ERROR#',
     'Genesis',
     'Exodus',
     'Leviticus',
@@ -124,73 +70,161 @@ const indexLookup = [
     'Jude',
     'Revelation of John',
 ];
+const BOOK_NAME = Object.freeze({
+    ESV: './data/ESV.json',
+});
 /**
- * Escape a string so it can be safely embedded in a regular expression.
+ * The standard interface to the text of a Translation
  */
-function escapeRegExp(value) {
-    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+export class Translation {
+    #translationData;
+    static async create(bookName) {
+        const translationData = (await import(BOOK_NAME[bookName], {
+            with: { type: 'json' },
+        }));
+        return new Translation(translationData.default);
+    }
+    constructor(translationData) {
+        this.#translationData = translationData;
+    }
+    /**
+     * Look up the Bible text for a given passage
+     */
+    getPassageText(passage) {
+        const output = [];
+        for (const verse of passage.verses()) {
+            output.push({ verse, text: renderVerseText(this.#lookupWords(verse)) });
+        }
+        return output;
+    }
+    /**
+     * Produce the output text needed for a search term
+     */
+    search(terms) {
+        const searchWords = terms
+            .split(' ')
+            .filter(word => word.trim().length > 0)
+            .map(word => {
+            const pattern = `\\b(${escapeRegExp(word)})\\b`;
+            return {
+                // The `g` flag mutates `lastIndex` across `.test()` calls and would
+                // make matches on later words start past the beginning of the string.
+                test: new RegExp(pattern, 'i'),
+                highlight: new RegExp(pattern, 'gi'),
+            };
+        });
+        if (searchWords.length === 0) {
+            return '\n\n';
+        }
+        const tally = new PassageTally();
+        const booksData = this.#translationData.books;
+        for (let book = 1; book < BOOK_NAME_LOOKUP.length; book++) {
+            const bookName = BOOK_NAME_LOOKUP[book];
+            const bookData = booksData[bookName];
+            const maxChapter = chaptersInBook(book);
+            for (let chapter = 1; chapter <= maxChapter; chapter++) {
+                const chapterData = bookData[chapter - 1];
+                const maxVerse = versesInChapter(book, chapter);
+                for (let verse = 1; verse <= maxVerse; verse++) {
+                    const ordinal = verseOrdinal(book, chapter, verse);
+                    const words = chapterData[verse - 1];
+                    for (const searchWord of searchWords) {
+                        wordLoop: for (const word of words) {
+                            if (searchWord.test.test(word[0])) {
+                                tally.incrementByOrdinal(ordinal, 1);
+                                // Verses with multiple matches for a search term should not
+                                // get extra weighting
+                                break wordLoop;
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return (
+        // eslint-disable-next-line prefer-template
+        '\n' +
+            tally
+                .results({ minScore: searchWords.length })
+                .map(verse => {
+                let text = renderVerseText(this.#lookupWords(verse));
+                for (const searchWord of searchWords) {
+                    text = text.replace(searchWord.highlight, x => {
+                        return `**${x}**`;
+                    });
+                }
+                return `[${verse.toString()} → ${text}]`;
+            })
+                .join('\n') +
+            '\n');
+    }
+    /**
+     * Convert a verse reference to stored verse data.
+     */
+    #lookupWords(verse) {
+        const bookName = BOOK_NAME_LOOKUP[verse.book];
+        const booksData = this.#translationData.books;
+        return booksData[bookName][verse.chapter - 1][verse.verse - 1];
+    }
+}
+// https://github.com/jestjs/jest/issues/15000#issuecomment-2470602098
+const esvTranslationData = (await import(/* webpackChunkName: "mobile/esv" */ './data/ESV.json', {
+    with: { type: 'json' },
+})).default;
+const esvTranslation = new Translation(esvTranslationData);
+/**
+ * Look up the Bible text for a given passage
+ * @deprecated Use `Translation.create(bookId).getPassageText(passage)`
+ */
+export function getPassageText(bookId, passage) {
+    if (bookId !== 'ESV') {
+        throw new Error(`Unknown book: '${bookId}'.`);
+    }
+    return esvTranslation.getPassageText(passage);
 }
 /**
  * Produce the output text needed for a search term
+ * @deprecated Use `Translation.create(bookId).search(terms)`
  */
 export function search(bookId, terms) {
     if (bookId !== 'ESV') {
         throw new Error(`Unknown book: '${bookId}'.`);
     }
-    const searchWords = terms
-        .split(' ')
-        .filter(word => word.trim().length > 0)
-        .map(word => {
-        const pattern = `\\b(${escapeRegExp(word)})\\b`;
-        return {
-            // The `g` flag mutates `lastIndex` across `.test()` calls and would
-            // make matches on later words start past the beginning of the string.
-            test: new RegExp(pattern, 'i'),
-            highlight: new RegExp(pattern, 'gi'),
-        };
-    });
-    if (searchWords.length === 0) {
-        return '\n\n';
-    }
-    const tally = new PassageTally();
-    for (let book = 1; book < indexLookup.length; book++) {
-        const bookName = indexLookup[book];
-        const bookData = esvBibleText[bookName];
-        const maxChapter = chaptersInBook(book);
-        for (let chapter = 1; chapter <= maxChapter; chapter++) {
-            const chapterData = bookData[chapter - 1];
-            const maxVerse = versesInChapter(book, chapter);
-            for (let verse = 1; verse <= maxVerse; verse++) {
-                const ordinal = verseOrdinal(book, chapter, verse);
-                const words = chapterData[verse - 1];
-                for (const searchWord of searchWords) {
-                    wordLoop: for (const word of words) {
-                        if (searchWord.test.test(word[0])) {
-                            tally.incrementByOrdinal(ordinal, 1);
-                            // Verses with multiple matches for a search term should not
-                            // get extra weighting
-                            break wordLoop;
-                        }
-                    }
-                }
-            }
+    return esvTranslation.search(terms);
+}
+/**
+ * Join the per-word entries for a single verse into a display string,
+ * keeping attaching punctuation (.,;!?:) flush with the preceding word.
+ */
+function renderVerseText(words) {
+    let text = '';
+    for (const word of words) {
+        const head = word[0];
+        if (text.length === 0 || isAttachingPunctuation(head)) {
+            text += head;
+        }
+        else {
+            text += ` ${head}`;
         }
     }
-    return (
-    // eslint-disable-next-line prefer-template
-    '\n' +
-        tally
-            .results({ minScore: searchWords.length })
-            .map(verse => {
-            let text = renderVerseText(lookupWords(verse));
-            for (const searchWord of searchWords) {
-                text = text.replace(searchWord.highlight, x => {
-                    return `**${x}**`;
-                });
-            }
-            return `[${verse.toString()} → ${text}]`;
-        })
-            .join('\n') +
-        '\n');
+    return text;
+}
+/**
+ * True for punctuation that should attach to the previous word with no
+ * intervening space (sentence/clause punctuation).
+ */
+function isAttachingPunctuation(word) {
+    return (word.startsWith('.') ||
+        word.startsWith(',') ||
+        word.startsWith(';') ||
+        word.startsWith('!') ||
+        word.startsWith('?') ||
+        word.startsWith(':'));
+}
+/**
+ * Escape a string so it can be safely embedded in a regular expression.
+ */
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 //# sourceMappingURL=books.js.map

package/dist/book/books.js.map

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

package/dist/index.d.ts

@@ -3,6 +3,6 @@ export type { Accuracy, VerseParseResult } from './passage/verse.js';
 export { VerseRange } from './passage/verse-range.js';
 export { Passage } from './passage/passage.js';
 export { PassageTally } from './passage/passage-tally.js';
-export { getPassageText, search } from './book/books.js';
-export type { Book } from './book/books.js';
+export { getPassageText, search, Translation } from './book/books.js';
+export type { BookName, VerseText } from './book/books.js';
 export { findBookNumber, getShortName, getLongName, chaptersInBook, versesInChapter, versesInBible, chaptersInBible, booksInBible, verseOrdinal, decodeOrdinal, bookNames, shortBookNames, } from './passage/bible-info.js';

package/dist/index.js

@@ -2,6 +2,6 @@ export { Verse, ACCURACY } from './passage/verse.js';
 export { VerseRange } from './passage/verse-range.js';
 export { Passage } from './passage/passage.js';
 export { PassageTally } from './passage/passage-tally.js';
-export { getPassageText, search } from './book/books.js';
+export { getPassageText, search, Translation } from './book/books.js';
 export { findBookNumber, getShortName, getLongName, chaptersInBook, versesInChapter, versesInBible, chaptersInBible, booksInBible, verseOrdinal, decodeOrdinal, bookNames, shortBookNames, } from './passage/bible-info.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGzD,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,GACf,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EACL,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,GACf,MAAM,yBAAyB,CAAC"}

package/dist/passage/bible-info.d.ts

@@ -1,3 +1,20 @@
+export type BookLookupResult = {
+    readonly type: 'found';
+    readonly book: number;
+} | {
+    readonly type: 'unknown';
+} | {
+    readonly type: 'ambiguous';
+    readonly books: string;
+};
+/**
+ * Build the normalized book alias lookup table.
+ *
+ * Throws if the same alias is assigned to two different books, or if an alias
+ * is also listed in `ambiguousAliases` (the ambiguous branch in
+ * `_lookupBookNumber` would otherwise silently shadow the concrete entry).
+ */
+export declare function _buildBookLookup(aliasesByBook: ReadonlyArray<readonly [number, string]>, ambiguousAliases: ReadonlyMap<string, string>): ReadonlyMap<string, number>;
 /**
  * Find the (1-based) book number for a given string.
  * e.g.:
@@ -6,6 +23,10 @@
  * - findBookNumber('g') === undefined
  */
 export declare function findBookNumber(name: string): number | undefined;
+/**
+ * Look up a normalized book name and report ambiguous matches separately.
+ */
+export declare function _lookupBookNumber(name: string): BookLookupResult;
 /**
  * What is the canonical short name for a book?
  */