codexparser 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,29 @@
+# Changelog
+
+All notable changes to this project are documented here. For full details, see the Release Notes in README and the GitHub Releases page.
+
+## 0.3.0 — 2026-01-10
+
+- Added `convertVersion(targetVersion)` method on passage objects for versification conversion.
+- Accepts version string: `"eng"`, `"lxx"`, `"mt"`, or `"bhs"` (alias for MT).
+- Automatically converts chapter/verse references between versifications when versification data exists.
+- Returns same reference with updated version metadata if no versification exists.
+- Tested with Psalms, Zechariah, and NT passages.
+- Published to npm as `codexparser@0.3.0`.
+
+See the release: https://github.com/jeremyam/CodexParser/releases/tag/v0.3.0
+
+## 0.2.0 — 2026-01-10
+
+- Refactored internal architecture into clear folders:
+  - `src/core` (parser, scanner, validator, collection, version/versification handlers)
+  - `src/utils` (helpers, regex, chapter-verse data loader)
+  - `src/format` (OSIS formatter, abbreviations)
+  - `src/data` (bible lists, chapter_verses, versifications, sbl abbreviations)
+- Adopted OSIS textual hashes (e.g., `John.3.16`, `Rev.1.8-Rev.2.17`).
+- Added numeric OSIS using pythonbible-style integer verse IDs (`book*1_000_000 + chapter*1_000 + verse`).
+- Attached per-passage version helpers: `getVersion()`, `getLXX()`, `getMT()`, `getBHS()`, `getEnglish()`.
+- Cleaned dependencies and removed vulnerable toolchain; `npm audit` is clean.
+- Published to npm as `codexparser@0.2.0`.
+
+See the release: https://github.com/jeremyam/CodexParser/releases/tag/v0.2.0

package/README.md

@@ -1,5 +1,7 @@
 # CodexParser: The Ultimate Bible Reference Parser 📖✨
 
+[![GitHub Release](https://img.shields.io/github/v/release/jeremyam/CodexParser?sort=semver)](https://github.com/jeremyam/CodexParser/releases)
+
 Welcome to **CodexParser**, a powerful and flexible Node.js library crafted to parse, validate, and structure Bible references with ease. Whether you're extracting verses from a sermon, building a scripture app, or analyzing biblical texts, CodexParser transforms raw references like "John 3:16" or "Psalm 115:5,7,10" into rich, actionable data—complete with start and end points, SBL-style abbreviations, versification support, and validation. Dive into the Word like never before!
 
 Built with precision and passion, CodexParser handles single verses, ranges, multi-chapter spans, and single-chapter books (looking at you, Jude!). It’s your trusty companion for navigating the sacred texts, supporting English, Septuagint (LXX), and Masoretic Text (MT) versions. Let’s unleash its power!
@@ -38,6 +40,8 @@ npm install
 
 ## Quick Start ⚡
 
+For version detection and switching examples, see [Versions & Versification](#versions--versification).
+
 Here’s how to wield CodexParser’s might:
 
 ```javascript
@@ -100,6 +104,61 @@ console.log(parser.parse("Genesis 1:1-5, 10; 2:1-3").getPassages().combine())
 
 ---
 
+## Versions & Versification 🔁
+
+CodexParser supports English (`ENG`), Septuagint (`LXX`), and Masoretic (`MT`/`BHS`) versifications. You can set a default via `.bibleVersion()` or use per-passage helpers to convert.
+
+- Set default version for parsing:
+
+```javascript
+const CodexParser = require("codexparser")
+const parser = new CodexParser()
+
+// Default LXX if no suffix in the input
+parser.bibleVersion("lxx")
+const [p] = parser.parse("Psalms 4:5").getPassages()
+console.log(p.version.abbreviation) // "lxx"
+console.log(p.scripture.hash)       // "Ps.4.5"
+
+// Convert to English versification
+const eng = p.getEnglish()
+console.log(eng.scripture.cv)       // "4:4" (example of LXX→ENG shift)
+```
+
+- Detect version from suffix and convert across versions:
+
+```javascript
+const CodexParser = require("codexparser")
+const parser = new CodexParser()
+
+// Suffix sets version automatically
+const passages = parser.parse("Psalms 94:4-100:6 MT").getPassages()
+const base = passages[0]
+console.log(base.version.abbreviation) // "mt"
+console.log(base.scripture.hash)       // e.g., "Ps.94.4-Ps.100.6"
+
+// Convert to LXX and ENG with helpers
+const lxx = base.getLXX()
+const eng = base.getEnglish()
+console.log(lxx.scripture.cv) // "93:4-23; 94:1-11; ..." (mapped LXX ranges)
+console.log(eng.scripture.cv) // "94:4-23; 95:1-11; ..." (ENG/MT alignment)
+```
+
+- Zechariah example (chapter offsets):
+
+```javascript
+const parser = new CodexParser()
+const [z] = parser.parse("Zechariah 2:8").getPassages()
+console.log(z.getEnglish().scripture.hash) // "Zech.2.8"
+console.log(z.getLXX().scripture.hash)     // "Zech.2.12" (LXX mapping)
+```
+
+Notes:
+- `getVersion("eng"|"lxx"|"mt"|"bhs")` is available; `getBHS()` aliases `MT`.
+- `.scripture.hash` is OSIS textual (e.g., `John.3.16`), `.osisNumeric` uses pythonbible-style integer IDs.
+
+---
+
 ## API: Your Codex Arsenal 🛠️
 
 Here’s the breakdown of CodexParser’s key methods—your tools for mastering scripture:
@@ -240,3 +299,20 @@ Built with love by [jeremyam], powered by coffee and scripture.
 ---
 
 Let’s parse the scriptures together—happy coding! ✝️📚
+
+---
+
+## Release Notes
+
+### 0.2.0 (2026-01-10)
+
+- Refactored internal architecture into clear folders:
+  - `src/core` (parser, scanner, validator, collection, version/versification handlers)
+  - `src/utils` (helpers, regex, chapter-verse data loader)
+  - `src/format` (OSIS formatter, abbreviations)
+  - `src/data` (bible lists, chapter_verses, versifications, sbl abbreviations)
+- Adopted OSIS textual hashes (e.g., `John.3.16`, `Rev.1.8-Rev.2.17`).
+- Added numeric OSIS using pythonbible-style integer verse IDs (`book*1_000_000 + chapter*1_000 + verse`).
+- Attached per-passage version helpers: `getVersion()`, `getLXX()`, `getMT()`, `getBHS()`, `getEnglish()`.
+- Cleaned dependencies and removed vulnerable toolchain; `npm audit` is clean.
+- Published to npm as `codexparser@0.2.0`.

package/RELEASE_NOTES_v0.2.0.md

@@ -0,0 +1,5 @@
+# CodexParser 0.2.0
+
+Refactor into core/utils/format/data; OSIS textual hashes (e.g., John.3.16); pythonbible-style integer verse IDs for `osisNumeric`; per-passage version helpers (`getVersion/getLXX/getMT/getBHS/getEnglish`); dependency cleanup and audit fix; published to npm as `codexparser@0.2.0`.
+
+See detailed notes in README under "Release Notes" → 0.2.0.

package/RELEASE_NOTES_v0.3.0.md

@@ -0,0 +1,32 @@
+# CodexParser 0.3.0
+
+Added `convertVersion(targetVersion)` method on passage objects for versification conversion.
+
+## Features
+
+- **New Method**: `passage.convertVersion(targetVersion)` accepts version string (`"eng"`, `"lxx"`, `"mt"`, or `"bhs"`).
+- **Smart Conversion**: Automatically converts chapter/verse references between versifications when versification data exists (e.g., Psalms, Zechariah).
+- **Fallback Behavior**: Returns same reference with updated version metadata if no versification exists (e.g., NT passages).
+- **Tested**: Verified with Psalms, Zechariah, and NT passages.
+
+## Usage Example
+
+```javascript
+const CodexParser = require("codexparser")
+const parser = new CodexParser()
+
+// Convert English reference to LXX
+const [p] = parser.parse("Psalm 4:5").getPassages()
+console.log(p.scripture.hash) // "Ps.4.5"
+
+const lxx = p.convertVersion("lxx")
+console.log(lxx.scripture.hash) // "Ps.4.6"
+
+// No versification (NT) - returns same reference
+const [j] = parser.parse("John 3:16").getPassages()
+const jLxx = j.convertVersion("lxx")
+console.log(jLxx.scripture.hash) // "John.3.16" (same)
+console.log(jLxx.version.abbreviation) // "lxx" (version updated)
+```
+
+See full CHANGELOG: https://github.com/jeremyam/CodexParser/blob/main/CHANGELOG.md

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codexparser",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "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",
   "scripts": {

package/src/core/ReferenceParser.js

@@ -267,6 +267,22 @@ class ReferenceParser {
         passage.getEnglish = function () {
             return this.getVersion("eng")
         }
+        passage.convertVersion = function (targetVersion) {
+            const targetAbbr = targetVersion.toLowerCase() === "bhs" ? "mt" : targetVersion.toLowerCase()
+
+            // Check if any passages have versification data
+            const hasVersification = this.passages.some((p) => p.versification)
+
+            if (!hasVersification) {
+                // No versification exists, return a clone with updated version info only
+                const cloned = JSON.parse(JSON.stringify(this))
+                cloned.version = VersionHandler.getVersionObject(targetAbbr)
+                return cloned
+            }
+
+            // Has versification, use the full conversion
+            return computeConverted(this, targetAbbr)
+        }
     }
 
     /**
@@ -330,8 +346,8 @@ class ReferenceParser {
                 }
             }
 
-            // Handle chapter-only references
-            if (!part.includes(":") && !part.includes("-") && !singleChapterBook) {
+            // Handle chapter-only references (only when no chapter has been established yet)
+            if (!part.includes(":") && !part.includes("-") && !singleChapterBook && !passage.chapter) {
                 this.#parseChapterOnly(passage, part)
             } else if (part.includes(":")) {
                 this.#parseChapterVerse(passage, part, isFirstPart)