codexparser 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 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:

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.3.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

@@ -346,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)