@ambry/scripture 0.0.0-stage → 0.1.0

package/dist/esm/references.js

@@ -0,0 +1,79 @@
+import { scriptureBooks } from './books.js';
+function positiveLimit(value, name) {
+    if (!Number.isSafeInteger(value) || value < 1)
+        throw new RangeError(`${name} must be a positive safe integer.`);
+    return value;
+}
+export const scriptureLanguages = {
+    english: { label: 'English', field: 'english_text' },
+    greek: { label: 'Greek', field: 'greek_text' },
+    latin: { label: 'Latin', field: 'latin_text' },
+};
+const languagePattern = 'ENGLISH|ENG|EN|GREEK|GRK|GRC|LATIN|LAT|LA';
+const languageSuffixes = {
+    ENGLISH: 'english',
+    ENG: 'english',
+    EN: 'english',
+    GREEK: 'greek',
+    GRK: 'greek',
+    GRC: 'greek',
+    LATIN: 'latin',
+    LAT: 'latin',
+    LA: 'latin',
+};
+const normalizeBook = (name) => name.toLowerCase().replace(/[\s.]/g, '');
+const bookNames = scriptureBooks.flatMap((book) => [book.name, book.code, ...book.aliases].map((name) => ({ name, book })));
+const escapePattern = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+const bookPattern = bookNames
+    .map(({ name }) => escapePattern(name).replace(/ /g, '\\s*'))
+    .sort((a, b) => b.length - a.length)
+    .join('|');
+const embeddedReferencePattern = new RegExp(String.raw `(?<![\p{L}\p{N}_])(${bookPattern})\.?\s*(\d{1,3})\s*:\s*(\d{1,3})(?:\s*[-–]\s*(\d{1,3}))?(?:\s+(${languagePattern}))?(?![\p{L}\p{N}_]|\s*[:–-]\s*\d)`, 'giu');
+export function parseScriptureReference(input, options = {}) {
+    const maxVerses = positiveLimit(options.maxVerses ?? 176, 'maxVerses');
+    const match = input
+        .trim()
+        .match(new RegExp(String.raw `^(.+?)\s*(\d{1,3})(?:\s*:\s*(\d{1,3})(?:\s*[-–]\s*(\d{1,3}))?)?(?:\s+(${languagePattern}))?$`, 'i'));
+    if (!match)
+        return;
+    const book = bookNames.find(({ name }) => normalizeBook(name) === normalizeBook(match[1]))?.book;
+    const chapter = Number(match[2]);
+    const firstVerse = match[3] ? Number(match[3]) : undefined;
+    const lastVerse = match[4] ? Number(match[4]) : firstVerse;
+    if (!book || chapter < 1 || chapter > 150)
+        return;
+    if (firstVerse != null &&
+        (firstVerse < 1 || lastVerse > 176 || lastVerse < firstVerse || lastVerse - firstVerse + 1 > maxVerses))
+        return;
+    return {
+        book: book.name,
+        bookCode: book.code,
+        chapter,
+        firstVerse,
+        lastVerse,
+        language: languageSuffixes[match[5]?.toUpperCase()] ?? 'english',
+    };
+}
+export function findScriptureReferences(content, options = {}) {
+    const maxReferences = positiveLimit(options.maxReferences ?? 10, 'maxReferences');
+    positiveLimit(options.maxVerses ?? 176, 'maxVerses');
+    const trailingLanguage = content.match(new RegExp(String.raw `\b(${languagePattern})\s*[.!?]?\s*$`, 'i'));
+    const defaultLanguage = languageSuffixes[trailingLanguage?.[1].toUpperCase() ?? ''] ?? 'english';
+    const references = [];
+    const seen = new Set();
+    for (const match of content.matchAll(embeddedReferencePattern)) {
+        const reference = parseScriptureReference(match[0], options);
+        if (!reference)
+            continue;
+        if (!match[5])
+            reference.language = defaultLanguage;
+        const key = `${reference.bookCode}:${reference.chapter}:${reference.firstVerse}:${reference.lastVerse}:${reference.language}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        references.push(reference);
+        if (references.length === maxReferences)
+            break;
+    }
+    return references;
+}

package/package.json

@@ -1,6 +1,67 @@
 {
   "name": "@ambry/scripture",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Ambry Bible books, aliases, reference parsing, language suffixes, and scripture API client.",
+  "type": "module",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "sideEffects": false,
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    },
+    "./client": {
+      "import": {
+        "types": "./dist/esm/client.d.ts",
+        "default": "./dist/esm/client.js"
+      },
+      "require": {
+        "types": "./dist/cjs/client.d.ts",
+        "default": "./dist/cjs/client.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "ambry",
+    "bible",
+    "scripture",
+    "catholic",
+    "reference-parser"
+  ],
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  },
+  "typesVersions": {
+    "*": {
+      "client": [
+        "dist/cjs/client.d.ts"
+      ]
+    }
+  },
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }