@eten-tech-foundation/scripture-utilities 0.1.5 → 0.1.6

package/dist/index.js

@@ -1,10 +1,87 @@
-import { DOMParser as g, DOMImplementation as J } from "@xmldom/xmldom";
-const y = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+import { DOMImplementation as g, DOMParser as M } from "@xmldom/xmldom";
+const j = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
 function m(e) {
-  if (y.has(e))
+  if (j.has(e))
     throw new Error(`The key "${e}" is not allowed to avoid prototype pollution.`);
 }
-const T = "USJ", O = "3.1", H = Object.freeze({ type: T, version: O, content: [] }), I = [
+const A = "$", O = ".content[";
+function I(e) {
+  const t = e.split(O);
+  if (t.shift() !== A)
+    throw new Error(`indexesFromJsonPath: jsonPath didn't start with '${A}'`);
+  return t.map((r) => parseInt(r, 10));
+}
+function D(e) {
+  return e.reduce(
+    (t, n) => `${t}${O}${n}]`,
+    A
+  );
+}
+function v(e) {
+  return e != null && "jsonPath" in e && !("offset" in e) && !("closingMarkerOffset" in e) && !("propertyOffset" in e) && !("keyName" in e);
+}
+function U(e) {
+  return e != null && "jsonPath" in e && "closingMarkerOffset" in e;
+}
+function J(e) {
+  return e != null && "jsonPath" in e && "offset" in e && !("propertyOffset" in e) && !("keyName" in e);
+}
+function L(e) {
+  return e != null && "jsonPath" in e && "propertyOffset" in e;
+}
+function C(e) {
+  return e != null && "jsonPath" in e && "keyName" in e && "keyOffset" in e;
+}
+function X(e) {
+  return e != null && "jsonPath" in e && "keyName" in e && !("keyOffset" in e) && !("keyClosingMarkerOffset" in e);
+}
+function _(e) {
+  return e != null && "jsonPath" in e && "keyName" in e && "keyClosingMarkerOffset" in e;
+}
+function w(e) {
+  return e === void 0 ? "undefined" : e === null ? "null" : _(e) ? "UsjClosingAttributeMarkerLocation" : C(e) ? "UsjAttributeKeyLocation" : X(e) ? "UsjAttributeMarkerLocation" : L(e) ? "UsjPropertyValueLocation" : U(e) ? "UsjClosingMarkerLocation" : J(e) ? "UsjTextContentLocation" : v(e) ? "UsjMarkerLocation" : "Unknown";
+}
+const d = "usx", T = "3.1", K = `<${d} version="${T}" />`;
+let u, c;
+function x(e) {
+  const t = new g().createDocument("", d);
+  return t.documentElement && (t.documentElement.setAttribute("version", T), k(e, t)), t.toString();
+}
+function k(e, t) {
+  if (t.documentElement) {
+    for (const [n, r] of e.content.entries()) {
+      const o = n === e.content.length - 1;
+      y(r, t.documentElement, t, o);
+    }
+    return t.documentElement ?? void 0;
+  }
+}
+function y(e, t, n, r) {
+  let o, f, i;
+  if (typeof e == "string") o = n.createTextNode(e);
+  else if (f = e.type.replace("table:", ""), o = n.createElement(f), R(o, e), e.content)
+    for (const [s, l] of e.content.entries()) {
+      const p = s === e.content.length - 1;
+      y(l, o, n, p);
+    }
+  c && (f === "verse" || t.tagName === "para" && r) && (i = S(n, c), c = void 0), f === "verse" && typeof e != "string" && e.sid !== void 0 && (c = e.sid), u && (f === "chapter" || f === "para" && r) && (i = h(n, u), u = void 0), f === "chapter" && typeof e != "string" && e.sid !== void 0 && (u = e.sid);
+  const a = t.nodeName === d && (i == null ? void 0 : i.tagName) === "verse";
+  i && (!r || a) && t.appendChild(i), t.appendChild(o), i && r && !a && t.appendChild(i), r && t.nodeName === d && (c && t.appendChild(S(n, c)), u && t.appendChild(h(n, u)), c = void 0, u = void 0);
+}
+function R(e, t) {
+  t.marker && (t.type === "unmatched" ? e.setAttribute("marker", t.marker) : e.setAttribute("style", t.marker));
+  for (const [n, r] of Object.entries(t))
+    r && !["type", "marker", "content"].includes(n) && e.setAttribute(n, r);
+}
+function S(e, t) {
+  const n = e.createElement("verse");
+  return n.setAttribute("eid", t), n;
+}
+function h(e, t) {
+  const n = e.createElement("chapter");
+  return n.setAttribute("eid", t), n;
+}
+const N = "USJ", P = "3.1", G = Object.freeze({ type: N, version: P, content: [] }), $ = [
   "type",
   "marker",
   "content",
@@ -18,10 +95,10 @@ const T = "USJ", O = "3.1", H = Object.freeze({ type: T, version: O, content: []
   "align",
   "category"
 ];
-function V(e) {
-  return M.includes(e);
+function F(e) {
+  return V.includes(e);
 }
-const M = [
+const V = [
   // Old Testament
   "GEN",
   "EXO",
@@ -142,108 +219,67 @@ const M = [
   "XXE",
   "XXF",
   "XXG"
-], l = "usx", N = "3.1", C = `<${l} version="${N}" />`;
-function D(e) {
-  const n = new g().parseFromString(e, "text/xml");
-  return X(n.documentElement);
+];
+function Z(e) {
+  const n = new M().parseFromString(e, "text/xml");
+  return B(n.documentElement);
 }
-function X(e) {
+function B(e) {
   const [t] = e ? b(e) : [{ content: [] }];
-  return t.type = T, t.version = O, t;
+  return t.type = N, t.version = P, t;
 }
 function b(e) {
   const t = {};
-  let n = e.tagName, o, s, c = "append";
+  let n = e.tagName, r, o, f = "append";
   if (["row", "cell"].includes(n) && (n = "table:" + n), e.attributes)
-    for (const r of Array.from(e.attributes))
-      m(r.name), t[r.name] = r.value;
-  t.style && (o = t.style, delete t.style), t.vid && delete t.vid, t.status && delete t.status;
+    for (const s of Array.from(e.attributes))
+      m(s.name), t[s.name] = s.value;
+  t.style && (r = t.style, delete t.style), t.vid && delete t.vid, t.status && delete t.status;
   let i = { type: n };
-  o && (i.marker = o), i = { ...i, ...t }, e.firstChild && e.firstChild.nodeType === e.firstChild.TEXT_NODE && e.firstChild.nodeValue && E(e.firstChild.nodeValue) !== "" && (s = e.firstChild.nodeValue);
-  const f = Array.from(e.childNodes);
-  i.content = [], s && i.content.push(s);
-  for (const r of f) {
-    if (r.tagName === void 0)
+  r && (i.marker = r), i = { ...i, ...t }, e.firstChild && e.firstChild.nodeType === e.firstChild.TEXT_NODE && e.firstChild.nodeValue && E(e.firstChild.nodeValue) !== "" && (o = e.firstChild.nodeValue);
+  const a = Array.from(e.childNodes);
+  i.content = [], o && i.content.push(o);
+  for (const s of a) {
+    if (s.tagName === void 0)
       continue;
-    const [u, S] = b(r);
-    switch (S) {
+    const [l, p] = b(s);
+    switch (p) {
       case "append":
-        i.content.push(u);
+        i.content.push(l);
         break;
       case "merge":
-        i.content = i.content.concat(u);
+        i.content = i.content.concat(l);
         break;
     }
-    r.nextSibling && r.nextSibling.nodeType === r.nextSibling.TEXT_NODE && r.nextSibling.nodeValue && (E(r.nextSibling.nodeValue) !== "" || r.nextSibling.nodeValue === " ") && i.content.push(r.nextSibling.nodeValue);
+    s.nextSibling && s.nextSibling.nodeType === s.nextSibling.TEXT_NODE && s.nextSibling.nodeValue && (E(s.nextSibling.nodeValue) !== "" || s.nextSibling.nodeValue === " ") && i.content.push(s.nextSibling.nodeValue);
   }
-  return i.content.length === 0 && i.type !== l && delete i.content, "eid" in i && ["verse", "chapter"].includes(n) && (c = "ignore"), [i, c];
+  return i.content.length === 0 && i.type !== d && delete i.content, "eid" in i && ["verse", "chapter"].includes(n) && (f = "ignore"), [i, f];
 }
 function E(e) {
   return e.replace(/(^[ \t\n\r\f\v]+)|([ \t\n\r\f\v]+$)/g, "");
 }
-let d, a;
-function U(e) {
-  const t = new J().createDocument("", l);
-  return t.documentElement && (t.documentElement.setAttribute("version", N), _(e, t)), t.toString();
-}
-function _(e, t) {
-  if (t.documentElement) {
-    for (const [n, o] of e.content.entries()) {
-      const s = n === e.content.length - 1;
-      v(o, t.documentElement, t, s);
-    }
-    return t.documentElement ?? void 0;
-  }
-}
-function v(e, t, n, o) {
-  let s, c, i;
-  if (typeof e == "string") s = n.createTextNode(e);
-  else if (c = e.type.replace("table:", ""), s = n.createElement(c), R(s, e), e.content)
-    for (const [r, u] of e.content.entries()) {
-      const S = r === e.content.length - 1;
-      v(u, s, n, S);
-    }
-  a && (c === "verse" || t.tagName === "para" && o) && (i = p(n, a), a = void 0), c === "verse" && typeof e != "string" && e.sid !== void 0 && (a = e.sid), d && (c === "chapter" || c === "para" && o) && (i = h(n, d), d = void 0), c === "chapter" && typeof e != "string" && e.sid !== void 0 && (d = e.sid);
-  const f = t.nodeName === l && (i == null ? void 0 : i.tagName) === "verse";
-  i && (!o || f) && t.appendChild(i), t.appendChild(s), i && o && !f && t.appendChild(i), o && t.nodeName === l && (a && t.appendChild(p(n, a)), d && t.appendChild(h(n, d)), a = void 0, d = void 0);
-}
-function R(e, t) {
-  t.marker && (t.type === "unmatched" ? e.setAttribute("marker", t.marker) : e.setAttribute("style", t.marker));
-  for (const [n, o] of Object.entries(t))
-    o && !["type", "marker", "content"].includes(n) && e.setAttribute(n, o);
-}
-function p(e, t) {
-  const n = e.createElement("verse");
-  return n.setAttribute("eid", t), n;
-}
-function h(e, t) {
-  const n = e.createElement("chapter");
-  return n.setAttribute("eid", t), n;
-}
-const A = "$", P = ".content[";
-function w(e) {
-  const t = e.split(P);
-  if (t.shift() !== A)
-    throw new Error(`indexesFromJsonPath: jsonPath didn't start with '${A}'`);
-  return t.map((o) => parseInt(o, 10));
-}
-function L(e) {
-  return e.reduce((t, n) => `${t}${P}${n}]`, A);
-}
 export {
-  H as EMPTY_USJ,
-  C as EMPTY_USX,
-  I as MARKER_OBJECT_PROPS,
-  T as USJ_TYPE,
-  O as USJ_VERSION,
-  l as USX_TYPE,
-  N as USX_VERSION,
-  M as VALID_BOOK_CODES,
+  G as EMPTY_USJ,
+  K as EMPTY_USX,
+  $ as MARKER_OBJECT_PROPS,
+  N as USJ_TYPE,
+  P as USJ_VERSION,
+  d as USX_TYPE,
+  T as USX_VERSION,
+  V as VALID_BOOK_CODES,
   m as assertSafeKey,
-  w as indexesFromUsjJsonPath,
-  V as isValidBookCode,
-  L as usjJsonPathFromIndexes,
-  U as usjToUsxString,
-  D as usxStringToUsj
+  w as getUsjDocumentLocationTypeName,
+  I as indexesFromUsjJsonPath,
+  C as isUsjAttributeKeyLocation,
+  X as isUsjAttributeMarkerLocation,
+  _ as isUsjClosingAttributeMarkerLocation,
+  U as isUsjClosingMarkerLocation,
+  v as isUsjMarkerLocation,
+  L as isUsjPropertyValueLocation,
+  J as isUsjTextContentLocation,
+  F as isValidBookCode,
+  D as usjJsonPathFromIndexes,
+  x as usjToUsxString,
+  Z as usxStringToUsj
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/converters/usj/converter.utils.ts","../src/converters/usj/usj.model.ts","../src/converters/usj/usx.model.ts","../src/converters/usj/usx-to-usj.ts","../src/converters/usj/usj-to-usx.ts","../src/converters/usj/jsonpath-indexes.ts"],"sourcesContent":["/* Utility functions for converters */\n\nconst UNSAFE_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\n/**\n * Avoid prototype pollution by disallowing unsafe keys.\n * @param key - The array key to validate.\n *\n * @public\n */\nexport function assertSafeKey(key: string): void {\n  if (!UNSAFE_KEYS.has(key)) return;\n\n  throw new Error(`The key \"${key}\" is not allowed to avoid prototype pollution.`);\n}\n","/**\n * Unified Scripture JSON (USJ) - The JSON variant of USFM and USX data models.\n * These types follow this schema:\n * @see https://github.com/usfm-bible/tcdocs/blob/usj/grammar/usj.js\n */\n\n/**\n * The USJ spec type\n * @public\n */\nexport const USJ_TYPE = \"USJ\";\n\n/**\n * The USJ spec version\n * @public\n */\nexport const USJ_VERSION = \"3.1\";\n\n/**\n * An empty USJ object\n * @public\n */\nexport const EMPTY_USJ = Object.freeze<Usj>({ type: USJ_TYPE, version: USJ_VERSION, content: [] });\n\n/**\n * List of known properties of `MarkerObject`\n * @public\n */\nexport const MARKER_OBJECT_PROPS: (keyof MarkerObject)[] = [\n  \"type\",\n  \"marker\",\n  \"content\",\n  \"sid\",\n  \"eid\",\n  \"number\",\n  \"code\",\n  \"altnumber\",\n  \"pubnumber\",\n  \"caller\",\n  \"align\",\n  \"category\",\n];\n\n/**\n * Single piece of Scripture content\n * @public\n */\nexport type MarkerContent = string | MarkerObject;\n\n/**\n * A Scripture Marker and its contents\n * @public\n */\nexport interface MarkerObject {\n  /**\n   * The kind/category of node or element this is, corresponding the USFM marker and USX node\n   * @example `para`, `verse`, `char`\n   */\n  type: string;\n  /**\n   * The corresponding marker in USFM or style in USX\n   * @example `p`, `v`, `nd`\n   */\n  marker?: string;\n  /** This marker's contents laid out in order */\n  content?: MarkerContent[];\n  /** Indicates the Book-chapter-verse value in the paragraph based structure */\n  sid?: string;\n  /** Milestone end ID, matches start ID (not currently included in USJ spec) */\n  eid?: string;\n  /** Chapter number or verse number */\n  number?: string;\n  /** The 3-letter book code in ID element */\n  code?: BookCode;\n  /** Alternate chapter number or verse number */\n  altnumber?: string;\n  /** Published character of chapter or verse */\n  pubnumber?: string;\n  /** Caller character for footnotes and cross-refs */\n  caller?: string;\n  /** Alignment of table cells */\n  align?: string;\n  /** Category of extended study bible sections */\n  category?: string;\n}\n\n/**\n * Scripture data represented in JSON format. Data compatible transformation from USX/USFM\n * @public\n */\nexport interface Usj {\n  /** The USJ spec type */\n  type: typeof USJ_TYPE;\n  /** The USJ spec version */\n  version: typeof USJ_VERSION;\n  /** The JSON representation of scripture contents from USFM/USX */\n  content: MarkerContent[];\n}\n\n/**\n * Check if the given code is a valid 3-letter Scripture book code.\n * @public\n */\nexport function isValidBookCode(code: string): boolean {\n  return VALID_BOOK_CODES.includes(code as BookCode);\n}\n\n/**\n * 3-letter Scripture book code\n * @public\n */\nexport type BookCode = (typeof VALID_BOOK_CODES)[number];\n\n/**\n * List of valid 3-letter Scripture book codes\n * @public\n */\nexport const VALID_BOOK_CODES = [\n  // Old Testament\n  \"GEN\",\n  \"EXO\",\n  \"LEV\",\n  \"NUM\",\n  \"DEU\",\n  \"JOS\",\n  \"JDG\",\n  \"RUT\",\n  \"1SA\",\n  \"2SA\",\n  \"1KI\",\n  \"2KI\",\n  \"1CH\",\n  \"2CH\",\n  \"EZR\",\n  \"NEH\",\n  \"EST\",\n  \"JOB\",\n  \"PSA\",\n  \"PRO\",\n  \"ECC\",\n  \"SNG\",\n  \"ISA\",\n  \"JER\",\n  \"LAM\",\n  \"EZK\",\n  \"DAN\",\n  \"HOS\",\n  \"JOL\",\n  \"AMO\",\n  \"OBA\",\n  \"JON\",\n  \"MIC\",\n  \"NAM\",\n  \"HAB\",\n  \"ZEP\",\n  \"HAG\",\n  \"ZEC\",\n  \"MAL\",\n  // New Testament\n  \"MAT\",\n  \"MRK\",\n  \"LUK\",\n  \"JHN\",\n  \"ACT\",\n  \"ROM\",\n  \"1CO\",\n  \"2CO\",\n  \"GAL\",\n  \"EPH\",\n  \"PHP\",\n  \"COL\",\n  \"1TH\",\n  \"2TH\",\n  \"1TI\",\n  \"2TI\",\n  \"TIT\",\n  \"PHM\",\n  \"HEB\",\n  \"JAS\",\n  \"1PE\",\n  \"2PE\",\n  \"1JN\",\n  \"2JN\",\n  \"3JN\",\n  \"JUD\",\n  \"REV\",\n  // Deuterocanon\n  \"TOB\",\n  \"JDT\",\n  \"ESG\",\n  \"WIS\",\n  \"SIR\",\n  \"BAR\",\n  \"LJE\",\n  \"S3Y\",\n  \"SUS\",\n  \"BEL\",\n  \"1MA\",\n  \"2MA\",\n  \"3MA\",\n  \"4MA\",\n  \"1ES\",\n  \"2ES\",\n  \"MAN\",\n  \"PS2\",\n  \"ODA\",\n  \"PSS\",\n  \"EZA\",\n  \"5EZ\",\n  \"6EZ\",\n  \"DAG\",\n  \"PS3\",\n  \"2BA\",\n  \"LBA\",\n  \"JUB\",\n  \"ENO\",\n  \"1MQ\",\n  \"2MQ\",\n  \"3MQ\",\n  \"REP\",\n  \"4BA\",\n  \"LAO\",\n  // Non scripture\n  \"FRT\",\n  \"BAK\",\n  \"OTH\",\n  \"INT\",\n  \"CNC\",\n  \"GLO\",\n  \"TDX\",\n  \"NDX\",\n  \"XXA\",\n  \"XXB\",\n  \"XXC\",\n  \"XXD\",\n  \"XXE\",\n  \"XXF\",\n  \"XXG\",\n] as const;\n","/**\n * Unified Scripture XML (USX).\n * These types follow this schema:\n * @see https://github.com/usfm-bible/tcdocs/blob/main/grammar/usx.rng\n */\n\n/**\n * The USX spec type\n * @public\n */\nexport const USX_TYPE = \"usx\";\n\n/**\n * The USX spec version\n * @public\n */\nexport const USX_VERSION = \"3.1\";\n\n/**\n * An empty USX string\n * @public\n */\nexport const EMPTY_USX = `<${USX_TYPE} version=\"${USX_VERSION}\" />`;\n","/**\n * Convert Scripture from USX to USJ.\n * Adapted to TypeScript from this file:\n * @see https://github.com/usfm-bible/usfmtc/blob/0afa385a1f282b286cc6bff7bbc953ae788aa10c/src/usfmtc/usjproc.py\n */\n\nimport { DOMParser, Element } from \"@xmldom/xmldom\";\nimport { MarkerContent, MarkerObject, USJ_TYPE, USJ_VERSION, Usj } from \"./usj.model.js\";\nimport { USX_TYPE } from \"./usx.model.js\";\nimport { assertSafeKey } from \"./converter.utils.js\";\n\ntype Action = \"append\" | \"merge\" | \"ignore\";\ninterface Attribs {\n  [name: string]: string;\n}\n\n/**\n * Converts a USX string to a USJ object.\n *\n * @param usxString - The USX string to convert.\n * @returns The converted USJ object.\n *\n * @public\n */\nexport function usxStringToUsj(usxString: string): Usj {\n  const parser = new DOMParser();\n  const inputUsxDom = parser.parseFromString(usxString, \"text/xml\");\n  return usxDomToUsj(inputUsxDom.documentElement);\n}\n\nexport function usxDomToUsj(inputUsxDom: Element | null): Usj {\n  const [outputJson] = inputUsxDom\n    ? convertUsxRecurse(inputUsxDom)\n    : [{ content: [] as MarkerContent[] } as Usj];\n  outputJson.type = USJ_TYPE;\n  outputJson.version = USJ_VERSION;\n  return outputJson;\n}\n\nfunction convertUsxRecurse<T extends Usj | MarkerObject = Usj>(\n  inputUsxElement: Element,\n): [outputJson: T, action: Action] {\n  const attribs: Attribs = {};\n  let type: string = inputUsxElement.tagName;\n  let marker: string | undefined;\n  let text: string | undefined;\n  let action: Action = \"append\";\n\n  if ([\"row\", \"cell\"].includes(type)) type = \"table:\" + type;\n  if (inputUsxElement.attributes) {\n    for (const attrib of Array.from(inputUsxElement.attributes)) {\n      assertSafeKey(attrib.name);\n      attribs[attrib.name] = attrib.value;\n    }\n  }\n\n  if (attribs.style) {\n    marker = attribs.style;\n    delete attribs.style;\n  }\n  // dropping because presence of vid in para elements is not consistent in USX\n  if (attribs.vid) delete attribs.vid;\n  // Not dropping `attribs.closed` for backwards compatibility.\n  // dropping because it is nonstandard derived metadata that could get out of date\n  if (attribs.status) delete attribs.status;\n\n  let outObj: T = { type } as T;\n  if (marker) (outObj as MarkerObject).marker = marker;\n  outObj = { ...outObj, ...attribs };\n\n  if (\n    inputUsxElement.firstChild &&\n    inputUsxElement.firstChild.nodeType === inputUsxElement.firstChild.TEXT_NODE &&\n    inputUsxElement.firstChild.nodeValue &&\n    asciiTrim(inputUsxElement.firstChild.nodeValue) !== \"\"\n  ) {\n    text = inputUsxElement.firstChild.nodeValue;\n  }\n\n  const children = Array.from(inputUsxElement.childNodes);\n  outObj.content = [];\n\n  if (text) {\n    outObj.content.push(text);\n  }\n\n  for (const child of children) {\n    // ChildNodes are Elements.\n    if ((child as Element).tagName === undefined) {\n      continue;\n    }\n    // ChildNodes are Elements.\n    const [childDict, whatToDo] = convertUsxRecurse<MarkerObject>(child as Element);\n\n    switch (whatToDo) {\n      case \"append\":\n        outObj.content.push(childDict);\n        break;\n      case \"merge\":\n        outObj.content = outObj.content.concat(childDict);\n        break;\n      case \"ignore\":\n        break;\n      default:\n        break;\n    }\n\n    // Handle tail text\n    if (\n      child.nextSibling &&\n      child.nextSibling.nodeType === child.nextSibling.TEXT_NODE &&\n      child.nextSibling.nodeValue &&\n      (asciiTrim(child.nextSibling.nodeValue) !== \"\" || child.nextSibling.nodeValue === \" \")\n    ) {\n      outObj.content.push(child.nextSibling.nodeValue);\n    }\n  }\n\n  // For backward compatibility, not deleting content for type: chapter, verse, optbreak, ms OR\n  // marker: va, ca, b.\n  if (outObj.content.length === 0 && outObj.type !== USX_TYPE) {\n    delete outObj.content;\n  }\n\n  if (\"eid\" in outObj && [\"verse\", \"chapter\"].includes(type)) {\n    action = \"ignore\";\n  }\n\n  return [outObj, action];\n}\n\n/**\n * Removes leading and trailing ASCII whitespace.\n *\n * Only trim ASCII whitespace characters: space, tab, line feed, carriage return, form feed,\n * vertical tab.\n * @param str - The string to remove whitespace from.\n * @returns the string with leading and trailing whitespace removed.\n */\nfunction asciiTrim(str: string): string {\n  return str.replace(/(^[ \\t\\n\\r\\f\\v]+)|([ \\t\\n\\r\\f\\v]+$)/g, \"\");\n}\n","/**\n * Convert Scripture from USJ to USX.\n * Adapted to TypeScript from this file:\n * @see https://github.com/usfm-bible/usfmtc/blob/0afa385a1f282b286cc6bff7bbc953ae788aa10c/src/usfmtc/usjproc.py\n */\n\nimport { DOMImplementation, Document, Element, Text } from \"@xmldom/xmldom\";\nimport { MarkerContent, MarkerObject, Usj } from \"./usj.model.js\";\nimport { USX_TYPE, USX_VERSION } from \"./usx.model.js\";\n\nlet chapterEid: string | undefined;\nlet verseEid: string | undefined;\n\n/**\n * Converts a USJ object to a USX string.\n *\n * @param usj - The USJ object to convert\n * @returns The converted USX string.\n *\n * @public\n */\nexport function usjToUsxString(usj: Usj): string {\n  const usxDoc = new DOMImplementation().createDocument(\"\", USX_TYPE);\n  if (usxDoc.documentElement) {\n    usxDoc.documentElement.setAttribute(\"version\", USX_VERSION);\n    usjToUsxDom(usj, usxDoc);\n  }\n  return usxDoc.toString();\n}\n\nexport function usjToUsxDom(usj: Usj, usxDoc: Document): Element | undefined {\n  if (!usxDoc.documentElement) return undefined;\n\n  for (const [index, markerContent] of usj.content.entries()) {\n    const isLastItem = index === usj.content.length - 1;\n    convertUsjRecurse(markerContent, usxDoc.documentElement, usxDoc, isLastItem);\n  }\n  return usxDoc.documentElement ?? undefined;\n}\n\nfunction convertUsjRecurse(\n  markerContent: MarkerContent,\n  parentElement: Element,\n  usxDoc: Document,\n  isLastItem: boolean,\n) {\n  let element: Text | Element;\n  let type: string | undefined;\n  let eidElement: Element | undefined;\n  if (typeof markerContent === \"string\") element = usxDoc.createTextNode(markerContent);\n  else {\n    type = markerContent.type.replace(\"table:\", \"\");\n    element = usxDoc.createElement(type);\n    setAttributes(element, markerContent);\n    if (markerContent.content) {\n      for (const [index, item] of markerContent.content.entries()) {\n        const _isLastItem = index === markerContent.content.length - 1;\n        convertUsjRecurse(item, element, usxDoc, _isLastItem);\n      }\n    }\n  }\n\n  // Create chapter and verse end elements from SID attributes.\n  if (verseEid && (type === \"verse\" || (parentElement.tagName === \"para\" && isLastItem))) {\n    eidElement = createVerseEndElement(usxDoc, verseEid);\n    verseEid = undefined;\n  }\n  if (type === \"verse\" && typeof markerContent !== \"string\" && markerContent.sid !== undefined)\n    verseEid = markerContent.sid;\n\n  if (chapterEid && (type === \"chapter\" || (type === \"para\" && isLastItem))) {\n    eidElement = createChapterEndElement(usxDoc, chapterEid);\n    chapterEid = undefined;\n  }\n  if (type === \"chapter\" && typeof markerContent !== \"string\" && markerContent.sid !== undefined)\n    chapterEid = markerContent.sid;\n\n  // Append to parent.\n  const isVerseInImpliedPara =\n    parentElement.nodeName === USX_TYPE && eidElement?.tagName === \"verse\";\n  if (eidElement && (!isLastItem || isVerseInImpliedPara)) parentElement.appendChild(eidElement);\n  parentElement.appendChild(element);\n  if (eidElement && isLastItem && !isVerseInImpliedPara) parentElement.appendChild(eidElement);\n\n  // Allow for final chapter and verse end elements at the end of an implied para.\n  if (isLastItem && parentElement.nodeName === USX_TYPE) {\n    if (verseEid) parentElement.appendChild(createVerseEndElement(usxDoc, verseEid));\n    if (chapterEid) parentElement.appendChild(createChapterEndElement(usxDoc, chapterEid));\n    verseEid = undefined;\n    chapterEid = undefined;\n  }\n}\n\nfunction setAttributes(element: Element, markerContent: MarkerObject) {\n  if (markerContent.marker) {\n    if (markerContent.type === \"unmatched\") element.setAttribute(\"marker\", markerContent.marker);\n    else element.setAttribute(\"style\", markerContent.marker);\n  }\n  for (const [key, value] of Object.entries(markerContent)) {\n    if (value && ![\"type\", \"marker\", \"content\"].includes(key)) {\n      element.setAttribute(key, value as string);\n    }\n  }\n}\n\nfunction createVerseEndElement(usxDoc: Document, verseEid: string): Element {\n  const eidElement = usxDoc.createElement(\"verse\");\n  eidElement.setAttribute(\"eid\", verseEid);\n  return eidElement;\n}\n\nfunction createChapterEndElement(usxDoc: Document, chapterEid: string): Element {\n  const eidElement = usxDoc.createElement(\"chapter\");\n  eidElement.setAttribute(\"eid\", chapterEid);\n  return eidElement;\n}\n","const JSON_PATH_START = \"$\";\nconst JSON_PATH_CONTENT = \".content[\";\n\n/**\n * Converts a USJ JSONPath string into an array of indexes.\n *\n * @param jsonPath - The USJ JSONPath string to convert. It must start with `$` and contain `.content[index]` segments.\n * @returns An array of numeric indexes extracted from the JSONPath.\n * @throws Will throw an error if the JSONPath does not start with `$`.\n *\n * @public\n */\nexport function indexesFromUsjJsonPath(jsonPath: string): number[] {\n  const path = jsonPath.split(JSON_PATH_CONTENT);\n  if (path.shift() !== JSON_PATH_START)\n    throw new Error(`indexesFromJsonPath: jsonPath didn't start with '${JSON_PATH_START}'`);\n\n  const indexes = path.map((str) => parseInt(str, 10));\n  return indexes;\n}\n\n/**\n * Converts an array of indexes into a USJ JSONPath string.\n *\n * @param indexes - An array of numeric indexes to convert.\n * @returns A USJ JSONPath string constructed from the indexes.\n *\n * @public\n */\nexport function usjJsonPathFromIndexes(indexes: number[]): string {\n  return indexes.reduce((path, index) => `${path}${JSON_PATH_CONTENT}${index}]`, JSON_PATH_START);\n}\n"],"names":["UNSAFE_KEYS","assertSafeKey","key","USJ_TYPE","USJ_VERSION","EMPTY_USJ","MARKER_OBJECT_PROPS","isValidBookCode","code","VALID_BOOK_CODES","USX_TYPE","USX_VERSION","EMPTY_USX","usxStringToUsj","usxString","inputUsxDom","DOMParser","usxDomToUsj","outputJson","convertUsxRecurse","inputUsxElement","attribs","type","marker","text","action","attrib","outObj","asciiTrim","children","child","childDict","whatToDo","str","chapterEid","verseEid","usjToUsxString","usj","usxDoc","DOMImplementation","usjToUsxDom","index","markerContent","isLastItem","convertUsjRecurse","parentElement","element","eidElement","setAttributes","item","_isLastItem","createVerseEndElement","createChapterEndElement","isVerseInImpliedPara","value","JSON_PATH_START","JSON_PATH_CONTENT","indexesFromUsjJsonPath","jsonPath","path","usjJsonPathFromIndexes","indexes"],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/converters/usj/converter.utils.ts","../src/converters/usj/jsonpath-indexes.ts","../src/converters/usj/usj-document-location.utils.ts","../src/converters/usj/usx.model.ts","../src/converters/usj/usj-to-usx.ts","../src/converters/usj/usj.model.ts","../src/converters/usj/usx-to-usj.ts"],"sourcesContent":["/* Utility functions for converters */\n\nconst UNSAFE_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\n\n/**\n * Avoid prototype pollution by disallowing unsafe keys.\n * @param key - The array key to validate.\n *\n * @public\n */\nexport function assertSafeKey(key: string): void {\n  if (!UNSAFE_KEYS.has(key)) return;\n\n  throw new Error(`The key \"${key}\" is not allowed to avoid prototype pollution.`);\n}\n","import type { ContentJsonPath } from \"./usj-document-location.model.js\";\n\nconst JSON_PATH_START = \"$\";\nconst JSON_PATH_CONTENT = \".content[\";\n\n/**\n * Converts a USJ JSONPath string into an array of indexes.\n *\n * @param jsonPath - The USJ JSONPath string to convert. It must start with `$` and contain `.content[index]` segments.\n * @returns An array of numeric indexes extracted from the JSONPath.\n * @throws Will throw an error if the JSONPath does not start with `$`.\n *\n * @public\n */\nexport function indexesFromUsjJsonPath(jsonPath: string): number[] {\n  const path = jsonPath.split(JSON_PATH_CONTENT);\n  if (path.shift() !== JSON_PATH_START)\n    throw new Error(`indexesFromJsonPath: jsonPath didn't start with '${JSON_PATH_START}'`);\n\n  const indexes = path.map((str) => parseInt(str, 10));\n  return indexes;\n}\n\n/**\n * Converts an array of indexes into a USJ JSONPath string.\n *\n * @param indexes - An array of numeric indexes to convert.\n * @returns A USJ JSONPath string constructed from the indexes.\n *\n * @public\n */\nexport function usjJsonPathFromIndexes(indexes: number[]): ContentJsonPath {\n  return indexes.reduce<string>(\n    (path, index) => `${path}${JSON_PATH_CONTENT}${index}]`,\n    JSON_PATH_START,\n  ) as ContentJsonPath;\n}\n","/**\n * Type guards for {@link UsjDocumentLocation} subtypes.\n *\n * These guards enable runtime type narrowing to distinguish between the different\n * location types in a USJ document.\n */\n\nimport type {\n  UsjDocumentLocation,\n  UsjMarkerLocation,\n  UsjClosingMarkerLocation,\n  UsjTextContentLocation,\n  UsjPropertyValueLocation,\n  UsjAttributeKeyLocation,\n  UsjAttributeMarkerLocation,\n  UsjClosingAttributeMarkerLocation,\n} from \"./usj-document-location.model.js\";\n\n/**\n * Type guard to check if a location is a {@link UsjMarkerLocation}.\n *\n * A marker location points to the very beginning of a marker (at the backslash in USFM).\n * It only has a `jsonPath` property with no offset properties.\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjMarkerLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjMarkerLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjMarkerLocation {\n  return (\n    location != null &&\n    \"jsonPath\" in location &&\n    !(\"offset\" in location) &&\n    !(\"closingMarkerOffset\" in location) &&\n    !(\"propertyOffset\" in location) &&\n    !(\"keyName\" in location)\n  );\n}\n\n/**\n * Type guard to check if a location is a {@link UsjClosingMarkerLocation}.\n *\n * A closing marker location points to a specific point in the closing marker representation\n * of a marker object (e.g., `\\nd*` in USFM).\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjClosingMarkerLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjClosingMarkerLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjClosingMarkerLocation {\n  return location != null && \"jsonPath\" in location && \"closingMarkerOffset\" in location;\n}\n\n/**\n * Type guard to check if a location is a {@link UsjTextContentLocation}.\n *\n * A text content location points to a specific character offset within a text content string\n * in a marker's content array.\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjTextContentLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjTextContentLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjTextContentLocation {\n  return (\n    location != null &&\n    \"jsonPath\" in location &&\n    \"offset\" in location &&\n    !(\"propertyOffset\" in location) &&\n    !(\"keyName\" in location)\n  );\n}\n\n/**\n * Type guard to check if a location is a {@link UsjPropertyValueLocation}.\n *\n * A property value location points to a specific character offset within a property value\n * (such as `marker` or an attribute value).\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjPropertyValueLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjPropertyValueLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjPropertyValueLocation {\n  return location != null && \"jsonPath\" in location && \"propertyOffset\" in location;\n}\n\n/**\n * Type guard to check if a location is a {@link UsjAttributeKeyLocation}.\n *\n * An attribute key location points to a specific character offset within an attribute's key string.\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjAttributeKeyLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjAttributeKeyLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjAttributeKeyLocation {\n  return (\n    location != null && \"jsonPath\" in location && \"keyName\" in location && \"keyOffset\" in location\n  );\n}\n\n/**\n * Type guard to check if a location is a {@link UsjAttributeMarkerLocation}.\n *\n * An attribute marker location points to the beginning of an attribute marker\n * (at the backslash in USFM, e.g., `\\ca` for chapter alternate number).\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjAttributeMarkerLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjAttributeMarkerLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjAttributeMarkerLocation {\n  return (\n    location != null &&\n    \"jsonPath\" in location &&\n    \"keyName\" in location &&\n    !(\"keyOffset\" in location) &&\n    !(\"keyClosingMarkerOffset\" in location)\n  );\n}\n\n/**\n * Type guard to check if a location is a {@link UsjClosingAttributeMarkerLocation}.\n *\n * A closing attribute marker location points to a specific point in the closing marker\n * representation of an attribute marker (e.g., `\\ca*` in USFM).\n *\n * @param location - The location to check.\n * @returns `true` if the location is a `UsjClosingAttributeMarkerLocation`, `false` otherwise.\n *\n * @public\n */\nexport function isUsjClosingAttributeMarkerLocation(\n  location: UsjDocumentLocation | undefined | null,\n): location is UsjClosingAttributeMarkerLocation {\n  return (\n    location != null &&\n    \"jsonPath\" in location &&\n    \"keyName\" in location &&\n    \"keyClosingMarkerOffset\" in location\n  );\n}\n\n/**\n * Gets a human-readable name for the type of a {@link UsjDocumentLocation}.\n *\n * Useful for error messages when an unsupported location type is encountered.\n *\n * @param location - The location to get the type name for.\n * @returns A string describing the location type, or \"undefined\" / \"null\" if the location is not\n *   provided.\n *\n * @public\n */\nexport function getUsjDocumentLocationTypeName(\n  location: UsjDocumentLocation | undefined | null,\n): string {\n  if (location === undefined) return \"undefined\";\n  if (location === null) return \"null\";\n  if (isUsjClosingAttributeMarkerLocation(location)) return \"UsjClosingAttributeMarkerLocation\";\n  if (isUsjAttributeKeyLocation(location)) return \"UsjAttributeKeyLocation\";\n  if (isUsjAttributeMarkerLocation(location)) return \"UsjAttributeMarkerLocation\";\n  if (isUsjPropertyValueLocation(location)) return \"UsjPropertyValueLocation\";\n  if (isUsjClosingMarkerLocation(location)) return \"UsjClosingMarkerLocation\";\n  if (isUsjTextContentLocation(location)) return \"UsjTextContentLocation\";\n  if (isUsjMarkerLocation(location)) return \"UsjMarkerLocation\";\n  return \"Unknown\";\n}\n","/**\n * Unified Scripture XML (USX).\n * These types follow this schema:\n * @see https://github.com/usfm-bible/tcdocs/blob/main/grammar/usx.rng\n */\n\n/**\n * The USX spec type\n * @public\n */\nexport const USX_TYPE = \"usx\";\n\n/**\n * The USX spec version\n * @public\n */\nexport const USX_VERSION = \"3.1\";\n\n/**\n * An empty USX string\n * @public\n */\nexport const EMPTY_USX = `<${USX_TYPE} version=\"${USX_VERSION}\" />`;\n","/**\n * Convert Scripture from USJ to USX.\n * Adapted to TypeScript from this file:\n * @see https://github.com/usfm-bible/usfmtc/blob/0afa385a1f282b286cc6bff7bbc953ae788aa10c/src/usfmtc/usjproc.py\n */\n\nimport { DOMImplementation, Document, Element, Text } from \"@xmldom/xmldom\";\nimport { MarkerContent, MarkerObject, Usj } from \"./usj.model.js\";\nimport { USX_TYPE, USX_VERSION } from \"./usx.model.js\";\n\nlet chapterEid: string | undefined;\nlet verseEid: string | undefined;\n\n/**\n * Converts a USJ object to a USX string.\n *\n * @param usj - The USJ object to convert\n * @returns The converted USX string.\n *\n * @public\n */\nexport function usjToUsxString(usj: Usj): string {\n  const usxDoc = new DOMImplementation().createDocument(\"\", USX_TYPE);\n  if (usxDoc.documentElement) {\n    usxDoc.documentElement.setAttribute(\"version\", USX_VERSION);\n    usjToUsxDom(usj, usxDoc);\n  }\n  return usxDoc.toString();\n}\n\nexport function usjToUsxDom(usj: Usj, usxDoc: Document): Element | undefined {\n  if (!usxDoc.documentElement) return undefined;\n\n  for (const [index, markerContent] of usj.content.entries()) {\n    const isLastItem = index === usj.content.length - 1;\n    convertUsjRecurse(markerContent, usxDoc.documentElement, usxDoc, isLastItem);\n  }\n  return usxDoc.documentElement ?? undefined;\n}\n\nfunction convertUsjRecurse(\n  markerContent: MarkerContent,\n  parentElement: Element,\n  usxDoc: Document,\n  isLastItem: boolean,\n) {\n  let element: Text | Element;\n  let type: string | undefined;\n  let eidElement: Element | undefined;\n  if (typeof markerContent === \"string\") element = usxDoc.createTextNode(markerContent);\n  else {\n    type = markerContent.type.replace(\"table:\", \"\");\n    element = usxDoc.createElement(type);\n    setAttributes(element, markerContent);\n    if (markerContent.content) {\n      for (const [index, item] of markerContent.content.entries()) {\n        const _isLastItem = index === markerContent.content.length - 1;\n        convertUsjRecurse(item, element, usxDoc, _isLastItem);\n      }\n    }\n  }\n\n  // Create chapter and verse end elements from SID attributes.\n  if (verseEid && (type === \"verse\" || (parentElement.tagName === \"para\" && isLastItem))) {\n    eidElement = createVerseEndElement(usxDoc, verseEid);\n    verseEid = undefined;\n  }\n  if (type === \"verse\" && typeof markerContent !== \"string\" && markerContent.sid !== undefined)\n    verseEid = markerContent.sid;\n\n  if (chapterEid && (type === \"chapter\" || (type === \"para\" && isLastItem))) {\n    eidElement = createChapterEndElement(usxDoc, chapterEid);\n    chapterEid = undefined;\n  }\n  if (type === \"chapter\" && typeof markerContent !== \"string\" && markerContent.sid !== undefined)\n    chapterEid = markerContent.sid;\n\n  // Append to parent.\n  const isVerseInImpliedPara =\n    parentElement.nodeName === USX_TYPE && eidElement?.tagName === \"verse\";\n  if (eidElement && (!isLastItem || isVerseInImpliedPara)) parentElement.appendChild(eidElement);\n  parentElement.appendChild(element);\n  if (eidElement && isLastItem && !isVerseInImpliedPara) parentElement.appendChild(eidElement);\n\n  // Allow for final chapter and verse end elements at the end of an implied para.\n  if (isLastItem && parentElement.nodeName === USX_TYPE) {\n    if (verseEid) parentElement.appendChild(createVerseEndElement(usxDoc, verseEid));\n    if (chapterEid) parentElement.appendChild(createChapterEndElement(usxDoc, chapterEid));\n    verseEid = undefined;\n    chapterEid = undefined;\n  }\n}\n\nfunction setAttributes(element: Element, markerContent: MarkerObject) {\n  if (markerContent.marker) {\n    if (markerContent.type === \"unmatched\") element.setAttribute(\"marker\", markerContent.marker);\n    else element.setAttribute(\"style\", markerContent.marker);\n  }\n  for (const [key, value] of Object.entries(markerContent)) {\n    if (value && ![\"type\", \"marker\", \"content\"].includes(key)) {\n      element.setAttribute(key, value as string);\n    }\n  }\n}\n\nfunction createVerseEndElement(usxDoc: Document, verseEid: string): Element {\n  const eidElement = usxDoc.createElement(\"verse\");\n  eidElement.setAttribute(\"eid\", verseEid);\n  return eidElement;\n}\n\nfunction createChapterEndElement(usxDoc: Document, chapterEid: string): Element {\n  const eidElement = usxDoc.createElement(\"chapter\");\n  eidElement.setAttribute(\"eid\", chapterEid);\n  return eidElement;\n}\n","/**\n * Unified Scripture JSON (USJ) - The JSON variant of USFM and USX data models.\n * These types follow this schema:\n * @see https://github.com/usfm-bible/tcdocs/blob/usj/grammar/usj.js\n */\n\n/**\n * The USJ spec type\n * @public\n */\nexport const USJ_TYPE = \"USJ\";\n\n/**\n * The USJ spec version\n * @public\n */\nexport const USJ_VERSION = \"3.1\";\n\n/**\n * An empty USJ object\n * @public\n */\nexport const EMPTY_USJ = Object.freeze<Usj>({ type: USJ_TYPE, version: USJ_VERSION, content: [] });\n\n/**\n * List of known properties of `MarkerObject`\n * @public\n */\nexport const MARKER_OBJECT_PROPS: (keyof MarkerObject)[] = [\n  \"type\",\n  \"marker\",\n  \"content\",\n  \"sid\",\n  \"eid\",\n  \"number\",\n  \"code\",\n  \"altnumber\",\n  \"pubnumber\",\n  \"caller\",\n  \"align\",\n  \"category\",\n];\n\n/**\n * Single piece of Scripture content\n * @public\n */\nexport type MarkerContent = string | MarkerObject;\n\n/**\n * A Scripture Marker and its contents\n * @public\n */\nexport interface MarkerObject {\n  /**\n   * The kind/category of node or element this is, corresponding the USFM marker and USX node\n   * @example `para`, `verse`, `char`\n   */\n  type: string;\n  /**\n   * The corresponding marker in USFM or style in USX\n   * @example `p`, `v`, `nd`\n   */\n  marker?: string;\n  /** This marker's contents laid out in order */\n  content?: MarkerContent[];\n  /** Indicates the Book-chapter-verse value in the paragraph based structure */\n  sid?: string;\n  /** Milestone end ID, matches start ID (not currently included in USJ spec) */\n  eid?: string;\n  /** Chapter number or verse number */\n  number?: string;\n  /** The 3-letter book code in ID element */\n  code?: BookCode;\n  /** Alternate chapter number or verse number */\n  altnumber?: string;\n  /** Published character of chapter or verse */\n  pubnumber?: string;\n  /** Caller character for footnotes and cross-refs */\n  caller?: string;\n  /** Alignment of table cells */\n  align?: string;\n  /** Category of extended study bible sections */\n  category?: string;\n}\n\n/**\n * Scripture data represented in JSON format. Data compatible transformation from USX/USFM\n * @public\n */\nexport interface Usj {\n  /** The USJ spec type */\n  type: typeof USJ_TYPE;\n  /** The USJ spec version */\n  version: typeof USJ_VERSION;\n  /** The JSON representation of scripture contents from USFM/USX */\n  content: MarkerContent[];\n}\n\n/**\n * Check if the given code is a valid 3-letter Scripture book code.\n * @public\n */\nexport function isValidBookCode(code: string): boolean {\n  return VALID_BOOK_CODES.includes(code as BookCode);\n}\n\n/**\n * 3-letter Scripture book code\n * @public\n */\nexport type BookCode = (typeof VALID_BOOK_CODES)[number];\n\n/**\n * List of valid 3-letter Scripture book codes\n * @public\n */\nexport const VALID_BOOK_CODES = [\n  // Old Testament\n  \"GEN\",\n  \"EXO\",\n  \"LEV\",\n  \"NUM\",\n  \"DEU\",\n  \"JOS\",\n  \"JDG\",\n  \"RUT\",\n  \"1SA\",\n  \"2SA\",\n  \"1KI\",\n  \"2KI\",\n  \"1CH\",\n  \"2CH\",\n  \"EZR\",\n  \"NEH\",\n  \"EST\",\n  \"JOB\",\n  \"PSA\",\n  \"PRO\",\n  \"ECC\",\n  \"SNG\",\n  \"ISA\",\n  \"JER\",\n  \"LAM\",\n  \"EZK\",\n  \"DAN\",\n  \"HOS\",\n  \"JOL\",\n  \"AMO\",\n  \"OBA\",\n  \"JON\",\n  \"MIC\",\n  \"NAM\",\n  \"HAB\",\n  \"ZEP\",\n  \"HAG\",\n  \"ZEC\",\n  \"MAL\",\n  // New Testament\n  \"MAT\",\n  \"MRK\",\n  \"LUK\",\n  \"JHN\",\n  \"ACT\",\n  \"ROM\",\n  \"1CO\",\n  \"2CO\",\n  \"GAL\",\n  \"EPH\",\n  \"PHP\",\n  \"COL\",\n  \"1TH\",\n  \"2TH\",\n  \"1TI\",\n  \"2TI\",\n  \"TIT\",\n  \"PHM\",\n  \"HEB\",\n  \"JAS\",\n  \"1PE\",\n  \"2PE\",\n  \"1JN\",\n  \"2JN\",\n  \"3JN\",\n  \"JUD\",\n  \"REV\",\n  // Deuterocanon\n  \"TOB\",\n  \"JDT\",\n  \"ESG\",\n  \"WIS\",\n  \"SIR\",\n  \"BAR\",\n  \"LJE\",\n  \"S3Y\",\n  \"SUS\",\n  \"BEL\",\n  \"1MA\",\n  \"2MA\",\n  \"3MA\",\n  \"4MA\",\n  \"1ES\",\n  \"2ES\",\n  \"MAN\",\n  \"PS2\",\n  \"ODA\",\n  \"PSS\",\n  \"EZA\",\n  \"5EZ\",\n  \"6EZ\",\n  \"DAG\",\n  \"PS3\",\n  \"2BA\",\n  \"LBA\",\n  \"JUB\",\n  \"ENO\",\n  \"1MQ\",\n  \"2MQ\",\n  \"3MQ\",\n  \"REP\",\n  \"4BA\",\n  \"LAO\",\n  // Non scripture\n  \"FRT\",\n  \"BAK\",\n  \"OTH\",\n  \"INT\",\n  \"CNC\",\n  \"GLO\",\n  \"TDX\",\n  \"NDX\",\n  \"XXA\",\n  \"XXB\",\n  \"XXC\",\n  \"XXD\",\n  \"XXE\",\n  \"XXF\",\n  \"XXG\",\n] as const;\n","/**\n * Convert Scripture from USX to USJ.\n * Adapted to TypeScript from this file:\n * @see https://github.com/usfm-bible/usfmtc/blob/0afa385a1f282b286cc6bff7bbc953ae788aa10c/src/usfmtc/usjproc.py\n */\n\nimport { DOMParser, Element } from \"@xmldom/xmldom\";\nimport { MarkerContent, MarkerObject, USJ_TYPE, USJ_VERSION, Usj } from \"./usj.model.js\";\nimport { USX_TYPE } from \"./usx.model.js\";\nimport { assertSafeKey } from \"./converter.utils.js\";\n\ntype Action = \"append\" | \"merge\" | \"ignore\";\ninterface Attribs {\n  [name: string]: string;\n}\n\n/**\n * Converts a USX string to a USJ object.\n *\n * @param usxString - The USX string to convert.\n * @returns The converted USJ object.\n *\n * @public\n */\nexport function usxStringToUsj(usxString: string): Usj {\n  const parser = new DOMParser();\n  const inputUsxDom = parser.parseFromString(usxString, \"text/xml\");\n  return usxDomToUsj(inputUsxDom.documentElement);\n}\n\nexport function usxDomToUsj(inputUsxDom: Element | null): Usj {\n  const [outputJson] = inputUsxDom\n    ? convertUsxRecurse(inputUsxDom)\n    : [{ content: [] as MarkerContent[] } as Usj];\n  outputJson.type = USJ_TYPE;\n  outputJson.version = USJ_VERSION;\n  return outputJson;\n}\n\nfunction convertUsxRecurse<T extends Usj | MarkerObject = Usj>(\n  inputUsxElement: Element,\n): [outputJson: T, action: Action] {\n  const attribs: Attribs = {};\n  let type: string = inputUsxElement.tagName;\n  let marker: string | undefined;\n  let text: string | undefined;\n  let action: Action = \"append\";\n\n  if ([\"row\", \"cell\"].includes(type)) type = \"table:\" + type;\n  if (inputUsxElement.attributes) {\n    for (const attrib of Array.from(inputUsxElement.attributes)) {\n      assertSafeKey(attrib.name);\n      attribs[attrib.name] = attrib.value;\n    }\n  }\n\n  if (attribs.style) {\n    marker = attribs.style;\n    delete attribs.style;\n  }\n  // dropping because presence of vid in para elements is not consistent in USX\n  if (attribs.vid) delete attribs.vid;\n  // Not dropping `attribs.closed` for backwards compatibility.\n  // dropping because it is nonstandard derived metadata that could get out of date\n  if (attribs.status) delete attribs.status;\n\n  let outObj: T = { type } as T;\n  if (marker) (outObj as MarkerObject).marker = marker;\n  outObj = { ...outObj, ...attribs };\n\n  if (\n    inputUsxElement.firstChild &&\n    inputUsxElement.firstChild.nodeType === inputUsxElement.firstChild.TEXT_NODE &&\n    inputUsxElement.firstChild.nodeValue &&\n    asciiTrim(inputUsxElement.firstChild.nodeValue) !== \"\"\n  ) {\n    text = inputUsxElement.firstChild.nodeValue;\n  }\n\n  const children = Array.from(inputUsxElement.childNodes);\n  outObj.content = [];\n\n  if (text) {\n    outObj.content.push(text);\n  }\n\n  for (const child of children) {\n    // ChildNodes are Elements.\n    if ((child as Element).tagName === undefined) {\n      continue;\n    }\n    // ChildNodes are Elements.\n    const [childDict, whatToDo] = convertUsxRecurse<MarkerObject>(child as Element);\n\n    switch (whatToDo) {\n      case \"append\":\n        outObj.content.push(childDict);\n        break;\n      case \"merge\":\n        outObj.content = outObj.content.concat(childDict);\n        break;\n      case \"ignore\":\n        break;\n      default:\n        break;\n    }\n\n    // Handle tail text\n    if (\n      child.nextSibling &&\n      child.nextSibling.nodeType === child.nextSibling.TEXT_NODE &&\n      child.nextSibling.nodeValue &&\n      (asciiTrim(child.nextSibling.nodeValue) !== \"\" || child.nextSibling.nodeValue === \" \")\n    ) {\n      outObj.content.push(child.nextSibling.nodeValue);\n    }\n  }\n\n  // For backward compatibility, not deleting content for type: chapter, verse, optbreak, ms OR\n  // marker: va, ca, b.\n  if (outObj.content.length === 0 && outObj.type !== USX_TYPE) {\n    delete outObj.content;\n  }\n\n  if (\"eid\" in outObj && [\"verse\", \"chapter\"].includes(type)) {\n    action = \"ignore\";\n  }\n\n  return [outObj, action];\n}\n\n/**\n * Removes leading and trailing ASCII whitespace.\n *\n * Only trim ASCII whitespace characters: space, tab, line feed, carriage return, form feed,\n * vertical tab.\n * @param str - The string to remove whitespace from.\n * @returns the string with leading and trailing whitespace removed.\n */\nfunction asciiTrim(str: string): string {\n  return str.replace(/(^[ \\t\\n\\r\\f\\v]+)|([ \\t\\n\\r\\f\\v]+$)/g, \"\");\n}\n"],"names":["UNSAFE_KEYS","assertSafeKey","key","JSON_PATH_START","JSON_PATH_CONTENT","indexesFromUsjJsonPath","jsonPath","path","str","usjJsonPathFromIndexes","indexes","index","isUsjMarkerLocation","location","isUsjClosingMarkerLocation","isUsjTextContentLocation","isUsjPropertyValueLocation","isUsjAttributeKeyLocation","isUsjAttributeMarkerLocation","isUsjClosingAttributeMarkerLocation","getUsjDocumentLocationTypeName","USX_TYPE","USX_VERSION","EMPTY_USX","chapterEid","verseEid","usjToUsxString","usj","usxDoc","DOMImplementation","usjToUsxDom","markerContent","isLastItem","convertUsjRecurse","parentElement","element","type","eidElement","setAttributes","item","_isLastItem","createVerseEndElement","createChapterEndElement","isVerseInImpliedPara","value","USJ_TYPE","USJ_VERSION","EMPTY_USJ","MARKER_OBJECT_PROPS","isValidBookCode","code","VALID_BOOK_CODES","usxStringToUsj","usxString","inputUsxDom","DOMParser","usxDomToUsj","outputJson","convertUsxRecurse","inputUsxElement","attribs","marker","text","action","attrib","outObj","asciiTrim","children","child","childDict","whatToDo"],"mappings":"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AOC,EAAiB,SAASD,CAAgB;AACnD;AAYO,MAAMC,IAAmB;AAAA;AAAA,EAE9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;ACtNO,SAASC,EAAeC,GAAwB;AAErD,QAAMC,IADS,IAAIC,EAAA,EACQ,gBAAgBF,GAAW,UAAU;AAChE,SAAOG,EAAYF,EAAY,eAAe;AAChD;AAEO,SAASE,EAAYF,GAAkC;AAC5D,QAAM,CAACG,CAAU,IAAIH,IACjBI,EAAkBJ,CAAW,IAC7B,CAAC,EAAE,SAAS,CAAA,GAA8B;AAC9C,SAAAG,EAAW,OAAOZ,GAClBY,EAAW,UAAUX,GACdW;AACT;AAEA,SAASC,EACPC,GACiC;AACjC,QAAMC,IAAmB,CAAA;AACzB,MAAIxB,IAAeuB,EAAgB,SAC/BE,GACAC,GACAC,IAAiB;AAGrB,MADI,CAAC,OAAO,MAAM,EAAE,SAAS3B,CAAI,UAAU,WAAWA,IAClDuB,EAAgB;AAClB,eAAWK,KAAU,MAAM,KAAKL,EAAgB,UAAU;AACxD,MAAA1D,EAAc+D,EAAO,IAAI,GACzBJ,EAAQI,EAAO,IAAI,IAAIA,EAAO;AAIlC,EAAIJ,EAAQ,UACVC,IAASD,EAAQ,OACjB,OAAOA,EAAQ,QAGbA,EAAQ,OAAK,OAAOA,EAAQ,KAG5BA,EAAQ,UAAQ,OAAOA,EAAQ;AAEnC,MAAIK,IAAY,EAAE,MAAA7B,EAAA;AAClB,EAAIyB,MAASI,EAAwB,SAASJ,IAC9CI,IAAS,EAAE,GAAGA,GAAQ,GAAGL,EAAA,GAGvBD,EAAgB,cAChBA,EAAgB,WAAW,aAAaA,EAAgB,WAAW,aACnEA,EAAgB,WAAW,aAC3BO,EAAUP,EAAgB,WAAW,SAAS,MAAM,OAEpDG,IAAOH,EAAgB,WAAW;AAGpC,QAAMQ,IAAW,MAAM,KAAKR,EAAgB,UAAU;AACtD,EAAAM,EAAO,UAAU,CAAA,GAEbH,KACFG,EAAO,QAAQ,KAAKH,CAAI;AAG1B,aAAWM,KAASD,GAAU;AAE5B,QAAKC,EAAkB,YAAY;AACjC;AAGF,UAAM,CAACC,GAAWC,CAAQ,IAAIZ,EAAgCU,CAAgB;AAE9E,YAAQE,GAAA;AAAA,MACN,KAAK;AACH,QAAAL,EAAO,QAAQ,KAAKI,CAAS;AAC7B;AAAA,MACF,KAAK;AACH,QAAAJ,EAAO,UAAUA,EAAO,QAAQ,OAAOI,CAAS;AAChD;AAAA,IAIA;AAIJ,IACED,EAAM,eACNA,EAAM,YAAY,aAAaA,EAAM,YAAY,aACjDA,EAAM,YAAY,cACjBF,EAAUE,EAAM,YAAY,SAAS,MAAM,MAAMA,EAAM,YAAY,cAAc,QAElFH,EAAO,QAAQ,KAAKG,EAAM,YAAY,SAAS;AAAA,EAEnD;AAIA,SAAIH,EAAO,QAAQ,WAAW,KAAKA,EAAO,SAAS5C,KACjD,OAAO4C,EAAO,SAGZ,SAASA,KAAU,CAAC,SAAS,SAAS,EAAE,SAAS7B,CAAI,MACvD2B,IAAS,WAGJ,CAACE,GAAQF,CAAM;AACxB;AAUA,SAASG,EAAU1D,GAAqB;AACtC,SAAOA,EAAI,QAAQ,wCAAwC,EAAE;AAC/D;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eten-tech-foundation/scripture-utilities",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "Utilities for working with Scripture data.",
   "license": "MIT",
   "homepage": "https://github.com/eten-tech-foundation/scripture-editors/tree/main/packages/utilities#readme",

package/src/converters/usj/jsonpath-indexes.ts

@@ -1,3 +1,5 @@
+import type { ContentJsonPath } from "./usj-document-location.model.js";
+
 const JSON_PATH_START = "$";
 const JSON_PATH_CONTENT = ".content[";
 
@@ -27,6 +29,9 @@ export function indexesFromUsjJsonPath(jsonPath: string): number[] {
  *
  * @public
  */
-export function usjJsonPathFromIndexes(indexes: number[]): string {
-  return indexes.reduce((path, index) => `${path}${JSON_PATH_CONTENT}${index}]`, JSON_PATH_START);
+export function usjJsonPathFromIndexes(indexes: number[]): ContentJsonPath {
+  return indexes.reduce<string>(
+    (path, index) => `${path}${JSON_PATH_CONTENT}${index}]`,
+    JSON_PATH_START,
+  ) as ContentJsonPath;
 }