scriptures-js

A batteries-included JavaScript library for working with biblical scriptures, morphology, and lexicons.

This package provides a complete, ready-to-use solution for scripture analysis by bundling the core library with all official data sources.

Included Packages

| Package | Description | |---------|-------------| | @metaxia/scriptures-core | Core API, gematria, morphology parsing, registry | | @metaxia/scriptures-source-openscriptures-ohb | Hebrew Bible (Open Scriptures Project) | | @metaxia/scriptures-source-crosswire-kjv | King James Version (CrossWire) | | @metaxia/scriptures-source-stepbible-tagnt-tr | Greek New Testament (STEP Bible TAGNT, Textus Receptus) | | @metaxia/scriptures-source-stepbible-lexicon | Hebrew & Greek lexicons (STEP Bible) | | @metaxia/scriptures-source-stepbible-versification | Cross-tradition versification (MT / LXX / English), STEPBible TVTMS |

Installation

npm install @metaxia/scriptures

Usage

import { getVerse, gematria, lookupStrongs } from '@metaxia/scriptures';

// All sources are auto-registered and ready to use
const verse = await getVerse('Genesis', 1, 1, { edition: 'openscriptures-OHB' });
const value = gematria.compute(verse.text, { language: 'hebrew', method: 'standard' });
const definition = await lookupStrongs('H7225');

Gematria

The gematria system supports Hebrew, Greek, and English calculations with multiple methods.

Hebrew Gematria

| Method | Hebrew Name | Description | |--------|-------------|-------------| | Standard | Mispar Hechrachi | Traditional letter values (א=1, י=10, ק=100, etc.) | | Ordinal | Mispar Siduri | Alphabetic position (1-22) | | Reduced | Mispar Katan | Each letter reduced to single digit, then summed |

Example: בראשית (Bereshit) = 913 standard, 76 ordinal, 13 reduced

Greek Isopsephy

| Method | Description | |--------|-------------| | Standard | Traditional Greek numeral values (α=1, ι=10, ρ=100, etc.) | | Ordinal | Alphabetic position (1-24) | | Reduced | Digital root of standard value (always 1-9) |

Example: λογος (logos) = 373 standard, 62 ordinal, 4 reduced

English Gematria

| Method | Description | |--------|-------------| | Ordinal | A=1 through Z=26 |

For Advanced Users

If you only need specific sources or want finer control over bundle size, install @metaxia/scriptures-core directly and add only the sources you need:

npm install @metaxia/scriptures-core @metaxia/scriptures-source-crosswire-kjv

import '@metaxia/scriptures-source-crosswire-kjv';
import { getVerse } from '@metaxia/scriptures-core';

const verse = await getVerse('Genesis', 1, 1, { edition: 'crosswire-KJV' });

License

The scriptures-js package code is licensed MIT.

This package bundles data-source packages by dependency, and each carries its own license and provider. When you redistribute output that includes their data, you must comply with those terms:

• Hebrew text & morphology — Open Scriptures Hebrew Bible (based on the Westminster Leningrad Codex), via @metaxia/scriptures-source-openscriptures-ohb. CC BY 4.0 — attribution required.
• Lexical data (TBESH / TBESG / TFLSJ) — STEP Bible, Tyndale House, Cambridge, via @metaxia/scriptures-source-stepbible-lexicon. CC BY 4.0 — attribution required.
• Greek New Testament (TAGNT, Textus Receptus) — STEP Bible, Tyndale House, Cambridge, via @metaxia/scriptures-source-stepbible-tagnt-tr. CC BY 4.0 — attribution required.
• King James Version text — provided by the CrossWire Bible Society (from their OSIS XML), via @metaxia/scriptures-source-crosswire-kjv. Public domain (Crown Copyright in the United Kingdom); no attribution required.
• Versification mapping (TVTMS) — STEP Bible, Tyndale House, Cambridge, via @metaxia/scriptures-source-stepbible-versification. CC BY 4.0 — attribution required.

See each source package's LICENSE for the exact required attribution.