codexparser 0.4.0 → 0.5.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project are documented here. For full details, see the Release Notes in README and the GitHub Releases page.
 
+## 0.4.1 — 2026-04-28
+
+### Fixed
+
+- **Genesis 5:32 LXX missing entry.** ENG/MT Gen 5:32 ("Noah was 500 years old, and he fathered Shem, Ham, and Japheth") is folded into LXX Göttingen Gen 6:1, so LXX Genesis 5 has only 31 verses. The previous data left ENG Gen 5:32 unmapped, so `convertVersion("lxx")` returned 32 verses for Gen 5 and downstream lookups against an LXX corpus 404'd. Now correctly emits `missingPassages: [{ verse: 32 }]` and `verses: ["1-31"]`.
+
 ## 0.4.0 — 2026-04-28
 
 LXX versification audit + structural fixes. Major data-correctness pass against authoritative sources (Hanhart's Göttingen Esther, Rahlfs-Hanhart 2006, Göttingen Theodotion Daniel/Susanna/Bel) verified via Logos library.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexparser",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "This is a Javascript Bible parser and text scanner. It will search through texts and collate all scripture references into an array and parse them into objects, and it will parse passages into objects by book, chapter, verse, and testament. ",
   "main": "index.js",
   "files": [

package/src/core/ScriptureScanner.js

@@ -82,7 +82,10 @@ class ScriptureScanner {
                 let refStartIndex = bookStartIndex
                 let originalRefStartIndex = bookStartIndex
 
-                while (i < normalizedText.length && this.#isValidChapterVerseChar(normalizedText[i])) {
+                while (
+                    i < normalizedText.length &&
+                    this.#isValidChapterVerseChar(normalizedText[i], normalizedText[i - 1])
+                ) {
                     if (this.#isNextBibleBook(i, lowerCaseText, lowercaseBibleFullNames, lowercaseBibleAbbreviations)) {
                         break
                     }
@@ -178,11 +181,15 @@ class ScriptureScanner {
     }
 
     /**
-     * Checks if character is valid for chapter/verse references
+     * Checks if character is valid for chapter/verse references.
+     * Letter suffixes (a-e) only count when they directly follow a digit, so
+     * "6:1a" continues the token but "6:1 Amos" still breaks at "A".
      * @private
      */
-    #isValidChapterVerseChar(char) {
-        return /[\d:,\-;\s]/.test(char)
+    #isValidChapterVerseChar(char, prevChar) {
+        if (/[\d:,\-;\s]/.test(char)) return true
+        if (/[a-eA-E]/.test(char) && prevChar && /\d/.test(prevChar)) return true
+        return false
     }
 
     /**

package/src/core/VersificationHandler.js

@@ -92,10 +92,13 @@ class VersificationHandler {
             const hasVersification = this.#versificationDifferences[passage.book]
 
             passage.passages.forEach((subPassage) => {
+                const verseRef = subPassage.verseSuffix
+                    ? `${subPassage.chapter}:${subPassage.verse}${subPassage.verseSuffix}`
+                    : `${subPassage.chapter}:${subPassage.verse}`
+
                 if (hasVersification) {
-                    const key = `${subPassage.chapter}:${subPassage.verse}`
-                    if (this.#versificationDifferences[passage.book][key]) {
-                        subPassage.versification = this.#versificationDifferences[passage.book][key]
+                    if (this.#versificationDifferences[passage.book][verseRef]) {
+                        subPassage.versification = this.#versificationDifferences[passage.book][verseRef]
                     }
                 }
 
@@ -105,11 +108,9 @@ class VersificationHandler {
                         versionAbbreviation === "lxx" ? "lxx" : versionAbbreviation === "mt" ? "mt" : null
 
                     if (versionType) {
-                        const versionReference = `${subPassage.chapter}:${subPassage.verse}`
                         for (const versification in this.#versificationDifferences[passage.book]) {
                             if (
-                                this.#versificationDifferences[passage.book][versification][versionType] ===
-                                versionReference
+                                this.#versificationDifferences[passage.book][versification][versionType] === verseRef
                             ) {
                                 subPassage.versification = this.#versificationDifferences[passage.book][versification]
                                 break

package/src/data/versifications/1kings.js

@@ -169,6 +169,54 @@ module.exports = {
         mt: "5:32",
         eng: "5:18",
     },
+    // Chapter 6: LXX 3 Reigns adds material between 6:1 and 6:14 (6:1a-d) and
+    // omits MT/Eng 6:11-14 (the divine promise speech) and 6:18 (cedar carving).
+    // Reference: Rahlfs, Septuaginta, ad loc.
+    "6:1a": {
+        lxx: "6:1a",
+        mt: "",
+        eng: "",
+    },
+    "6:1b": {
+        lxx: "6:1b",
+        mt: "",
+        eng: "",
+    },
+    "6:1c": {
+        lxx: "6:1c",
+        mt: "",
+        eng: "",
+    },
+    "6:1d": {
+        lxx: "6:1d",
+        mt: "",
+        eng: "",
+    },
+    "6:11": {
+        lxx: "",
+        mt: "6:11",
+        eng: "6:11",
+    },
+    "6:12": {
+        lxx: "",
+        mt: "6:12",
+        eng: "6:12",
+    },
+    "6:13": {
+        lxx: "",
+        mt: "6:13",
+        eng: "6:13",
+    },
+    "6:14": {
+        lxx: "",
+        mt: "6:14",
+        eng: "6:14",
+    },
+    "6:18": {
+        lxx: "",
+        mt: "6:18",
+        eng: "6:18",
+    },
     "7:13": {
         lxx: "7:1",
         mt: "7:13",

package/src/data/versifications/genesis.js

@@ -1,4 +1,12 @@
 module.exports = {
+    // LXX/Göttingen Genesis 5 has only 31 verses. The content of ENG/MT 5:32
+    // ("Noah was 500 years old, and he fathered Shem, Ham, and Japheth")
+    // is folded into LXX 6:1, which then continues with the start of ENG/MT 6:1.
+    "5:32": {
+        lxx: "",
+        mt: "5:32",
+        eng: "5:32",
+    },
     "31:55": {
         lxx: "32:1",
         mt: "32:1",

package/src/utils/PassageUtils.js

@@ -46,6 +46,16 @@ class PassageUtils {
                 for (let i = start; i <= end && i <= chapterVerses[chapterVerses.length - 1]; i++) {
                     passages.push({ book, chapter, verse: i })
                 }
+            } else if (typeof verse === "string") {
+                const match = verse.trim().match(/^(\d+)([a-eA-E])?$/)
+                if (match) {
+                    const verseNum = Number(match[1])
+                    if (verseNum > 0) {
+                        const entry = { book, chapter, verse: verseNum }
+                        if (match[2]) entry.verseSuffix = match[2].toLowerCase()
+                        passages.push(entry)
+                    }
+                }
             } else {
                 const verseNum = Number(verse)
                 if (!isNaN(verseNum) && verseNum > 0) {