@drghaliasri/butex 4.4.0 → 5.0.0

package/dist/document2.mjs

@@ -6,6 +6,100 @@ function document2Id(prefix) {
   return id;
 }
 
+// src/editor/digits.ts
+var WESTERN = "0123456789";
+var ARABIC_INDIC = "\u0660\u0661\u0662\u0663\u0664\u0665\u0666\u0667\u0668\u0669";
+var PERSIAN_INDIC = "\u06F0\u06F1\u06F2\u06F3\u06F4\u06F5\u06F6\u06F7\u06F8\u06F9";
+var digitSets = {
+  western: WESTERN,
+  arabicIndic: ARABIC_INDIC,
+  persianIndic: PERSIAN_INDIC
+};
+function digitValue(char) {
+  const western = WESTERN.indexOf(char);
+  if (western >= 0) {
+    return western;
+  }
+  const arabicIndic = ARABIC_INDIC.indexOf(char);
+  if (arabicIndic >= 0) {
+    return arabicIndic;
+  }
+  return PERSIAN_INDIC.indexOf(char);
+}
+function formatDigits(value, digitForm = "western") {
+  const target = digitSets[digitForm];
+  return Array.from(value, (char) => {
+    const value2 = digitValue(char);
+    return value2 >= 0 ? target[value2] : char;
+  }).join("");
+}
+
+// src/document2/citations.ts
+function referenceNumberMap(references) {
+  const map = /* @__PURE__ */ new Map();
+  references.forEach((reference, index) => {
+    if (!map.has(reference.key)) {
+      map.set(reference.key, index + 1);
+    }
+  });
+  return map;
+}
+function resolveCiteNumbers(keys, references) {
+  const map = referenceNumberMap(references);
+  return keys.map((key) => map.get(key) ?? null);
+}
+function formatCiteLabel(keys, references, options = {}) {
+  const documentDirection = options.documentDirection ?? "rtl";
+  const digitForm = options.digitForm ?? (documentDirection === "rtl" ? "arabicIndic" : "western");
+  const numbers = resolveCiteNumbers(keys, references).map((value) => value === null ? "?" : String(value));
+  const display = documentDirection === "rtl" ? [...numbers].reverse() : numbers;
+  const separator = documentDirection === "rtl" ? "\u060C" : ", ";
+  const body = display.map((part) => formatDigits(part, digitForm)).join(separator);
+  return `[${body}]`;
+}
+function formatBibliographyNumber(index, options = {}) {
+  const documentDirection = options.documentDirection ?? "rtl";
+  const digitForm = options.digitForm ?? (documentDirection === "rtl" ? "arabicIndic" : "western");
+  return formatDigits(String(index), digitForm);
+}
+function parseCiteKeys(source) {
+  const match = /^\\cite\{([^}]*)\}$/.exec(source.trim());
+  if (!match) {
+    return [];
+  }
+  return (match[1] ?? "").split(",").map((key) => key.trim()).filter((key) => key.length > 0);
+}
+function citeTokenLatex(keys) {
+  return `\\cite{${keys.join(",")}}`;
+}
+function referenceFromJson(json) {
+  return {
+    id: document2Id("ref"),
+    key: json.key,
+    authors: typeof json.authors === "string" ? json.authors : "",
+    title: typeof json.title === "string" ? json.title : "",
+    year: typeof json.year === "string" ? json.year : "",
+    url: typeof json.url === "string" ? json.url : "",
+    venue: typeof json.venue === "string" ? json.venue : ""
+  };
+}
+function createEmptyReference2(partial = {}) {
+  return referenceFromJson({
+    key: partial.key ?? `ref${String(Date.now()).slice(-4)}`,
+    authors: partial.authors,
+    title: partial.title,
+    year: partial.year,
+    url: partial.url,
+    venue: partial.venue
+  });
+}
+function bibliographyEntryLatex(reference) {
+  const parts = [reference.authors, reference.title, reference.venue, reference.year].filter((part) => part.trim().length > 0);
+  const body = parts.join(", ");
+  const url = reference.url.trim().length > 0 ? ` \\url{${reference.url}}` : "";
+  return `\\bibitem{${reference.key}} ${body}${url}`.trim();
+}
+
 // src/ast/commands/index.ts
 function renderCommandCore(context) {
   const optional = context.optionalArgs.map((arg) => `[${context.renderChain(arg)}]`).join("");
@@ -424,53 +518,84 @@ function environmentSpan(value, start) {
   const end = closingStart + closing.length;
   return { start, end, source: value.slice(start, end), opening, closing, display: true };
 }
-function detectMathSpans2(value) {
-  const spans = [];
-  let i = 0;
-  while (i < value.length) {
-    if (value.startsWith("\\begin{", i)) {
-      const span = environmentSpan(value, i);
-      if (span) {
-        spans.push(span);
-        i = span.end;
-        continue;
-      }
+function citeSpan(value, start) {
+  if (!value.startsWith("\\cite{", start) || isEscaped(value, start)) {
+    return null;
+  }
+  const openBrace = start + "\\cite".length;
+  if (value[openBrace] !== "{") {
+    return null;
+  }
+  let depth = 0;
+  for (let i = openBrace; i < value.length; i += 1) {
+    const char = value[i];
+    if (char === "{" && !isEscaped(value, i)) {
+      depth += 1;
+      continue;
     }
-    if (value.startsWith("\\(", i)) {
-      const close = value.indexOf("\\)", i + 2);
-      if (close >= 0) {
-        const end = close + 2;
-        spans.push({ start: i, end, source: value.slice(i, end), opening: "\\(", closing: "\\)", display: false });
-        i = end;
-        continue;
+    if (char === "}" && !isEscaped(value, i)) {
+      depth -= 1;
+      if (depth === 0) {
+        const end = i + 1;
+        const source = value.slice(start, end);
+        return { kind: "cite", start, end, source, keys: parseCiteKeys(source) };
       }
     }
-    if (value.startsWith("\\[", i)) {
-      const close = value.indexOf("\\]", i + 2);
-      if (close >= 0) {
-        const end = close + 2;
-        spans.push({ start: i, end, source: value.slice(i, end), opening: "\\[", closing: "\\]", display: true });
-        i = end;
-        continue;
-      }
+  }
+  return null;
+}
+function mathSpanAt(value, i) {
+  if (value.startsWith("\\begin{", i)) {
+    return environmentSpan(value, i);
+  }
+  if (value.startsWith("\\(", i)) {
+    const close = value.indexOf("\\)", i + 2);
+    if (close >= 0) {
+      const end = close + 2;
+      return { start: i, end, source: value.slice(i, end), opening: "\\(", closing: "\\)", display: false };
     }
-    if (value.startsWith("$$", i) && !isEscaped(value, i)) {
-      const close = value.indexOf("$$", i + 2);
-      if (close >= 0) {
-        const end = close + 2;
-        spans.push({ start: i, end, source: value.slice(i, end), opening: "$$", closing: "$$", display: true });
-        i = end;
-        continue;
-      }
+  }
+  if (value.startsWith("\\[", i)) {
+    const close = value.indexOf("\\]", i + 2);
+    if (close >= 0) {
+      const end = close + 2;
+      return { start: i, end, source: value.slice(i, end), opening: "\\[", closing: "\\]", display: true };
     }
-    if (value[i] === "$" && !isEscaped(value, i)) {
-      const close = findClosingDollar(value, i + 1);
-      if (close >= 0) {
-        const end = close + 1;
-        spans.push({ start: i, end, source: value.slice(i, end), opening: "$", closing: "$", display: false });
-        i = end;
-        continue;
-      }
+  }
+  if (value.startsWith("$$", i) && !isEscaped(value, i)) {
+    const close = value.indexOf("$$", i + 2);
+    if (close >= 0) {
+      const end = close + 2;
+      return { start: i, end, source: value.slice(i, end), opening: "$$", closing: "$$", display: true };
+    }
+  }
+  if (value[i] === "$" && !isEscaped(value, i)) {
+    const close = findClosingDollar(value, i + 1);
+    if (close >= 0) {
+      const end = close + 1;
+      return { start: i, end, source: value.slice(i, end), opening: "$", closing: "$", display: false };
+    }
+  }
+  return null;
+}
+function detectMathSpans2(value) {
+  return detectInlineSpans2(value).filter((span) => span.kind === "math").map(({ kind: _kind, ...span }) => span);
+}
+function detectInlineSpans2(value) {
+  const spans = [];
+  let i = 0;
+  while (i < value.length) {
+    const cite = citeSpan(value, i);
+    if (cite) {
+      spans.push(cite);
+      i = cite.end;
+      continue;
+    }
+    const math = mathSpanAt(value, i);
+    if (math) {
+      spans.push({ kind: "math", ...math });
+      i = math.end;
+      continue;
     }
     i += 1;
   }
@@ -507,19 +632,53 @@ function pushDiagnostic(diagnostics, options, path, message) {
   }
   diagnostics.push({ code: "math_alignment", message, path });
 }
+function parseReferences(json) {
+  if (!Array.isArray(json)) {
+    return [];
+  }
+  const references = [];
+  for (const entry of json) {
+    if (!isObject2(entry) || typeof entry.key !== "string" || entry.key.trim().length === 0) {
+      continue;
+    }
+    references.push(
+      referenceFromJson({
+        key: entry.key.trim(),
+        authors: typeof entry.authors === "string" ? entry.authors : void 0,
+        title: typeof entry.title === "string" ? entry.title : void 0,
+        year: typeof entry.year === "string" ? entry.year : void 0,
+        url: typeof entry.url === "string" ? entry.url : void 0,
+        venue: typeof entry.venue === "string" ? entry.venue : void 0
+      })
+    );
+  }
+  return references;
+}
 function createInlineField2(value = "", mathObjects = [], options = {}, path = "$", diagnostics = []) {
   const mode = options.mode ?? "english";
-  const spans = detectMathSpans2(value);
+  const spans = detectInlineSpans2(value);
+  const mathSpans = spans.filter((span) => span.kind === "math");
   const tokens = [];
   let index = 0;
-  if (mathObjects.length > 0 && mathObjects.length !== spans.length) {
-    pushDiagnostic(diagnostics, options, path, `math_objects count mismatch: detected ${String(spans.length)}, got ${String(mathObjects.length)}`);
+  let mathObjectIndex = 0;
+  if (mathObjects.length > 0 && mathObjects.length !== mathSpans.length) {
+    pushDiagnostic(diagnostics, options, path, `math_objects count mismatch: detected ${String(mathSpans.length)}, got ${String(mathObjects.length)}`);
   }
-  spans.forEach((span, spanIndex) => {
+  for (const span of spans) {
     if (span.start > index) {
       tokens.push({ id: document2Id("text"), kind: "text", text: value.slice(index, span.start) });
     }
-    const mathJson = mathObjects[spanIndex];
+    if (span.kind === "cite") {
+      tokens.push({
+        id: document2Id("cite"),
+        kind: "cite",
+        keys: span.keys.length > 0 ? span.keys : []
+      });
+      index = span.end;
+      continue;
+    }
+    const mathJson = mathObjects[mathObjectIndex];
+    mathObjectIndex += 1;
     if (mathJson && (mathJson.math_mode !== span.opening || mathJson.closing !== span.closing)) {
       pushDiagnostic(diagnostics, options, path, "math_objects order mismatch");
     }
@@ -551,7 +710,7 @@ function createInlineField2(value = "", mathObjects = [], options = {}, path = "
       });
     }
     index = span.end;
-  });
+  }
   if (index < value.length || tokens.length === 0) {
     tokens.push({ id: document2Id("text"), kind: "text", text: value.slice(index) });
   }
@@ -623,11 +782,14 @@ function parseTableBlock(json, options, path, diagnostics) {
   };
 }
 function parseImageBlock(json) {
+  const assetId = typeof json.asset_id === "string" && json.asset_id.length > 0 ? json.asset_id : void 0;
+  const value = assetId !== void 0 ? typeof json.value === "string" ? json.value : "" : requireString(json.value, "\\includegraphics requires string value");
   return {
     id: document2Id("block"),
     kind: "image",
     command: "\\includegraphics",
-    value: requireString(json.value, "\\includegraphics requires string value"),
+    value,
+    ...assetId !== void 0 ? { assetId } : {},
     options: isRecordOfStrings(json.options) ? json.options : {}
   };
 }
@@ -639,6 +801,14 @@ function parseRawBlock(json) {
     value: typeof json.value === "string" ? json.value : ""
   };
 }
+function parseBibliographyBlock() {
+  return {
+    id: document2Id("block"),
+    kind: "bibliography",
+    command: "\\begin{thebibliography}",
+    closing: "\\end{thebibliography}"
+  };
+}
 function parseBlock(json, options, path, diagnostics) {
   if (TEXT_COMMANDS.has(json.command)) {
     return parseTextBlock(json, options, path, diagnostics);
@@ -652,6 +822,9 @@ function parseBlock(json, options, path, diagnostics) {
   if (json.command === "\\includegraphics") {
     return parseImageBlock(json);
   }
+  if (json.command === "\\begin{thebibliography}" || json.command === "\\bibliography") {
+    return parseBibliographyBlock();
+  }
   if (json.command === "\\raw") {
     return parseRawBlock(json);
   }
@@ -672,12 +845,13 @@ function fromDocumentJson2(json, options = {}) {
   const diagnostics = [];
   return {
     nodeType: "DocumentObject",
+    references: parseReferences(json.references),
     blocks: json.blocks.map((block, index) => parseBlock(asBlockJson(block), options, `$.blocks[${String(index)}]`, diagnostics)),
     diagnostics
   };
 }
 function createEmptyDocument2() {
-  return { nodeType: "DocumentObject", blocks: [], diagnostics: [] };
+  return { nodeType: "DocumentObject", references: [], blocks: [], diagnostics: [] };
 }
 
 // src/editor/atomicCommands.ts
@@ -1700,34 +1874,6 @@ function renderDivideOperatorLatex(side) {
   return side === "arabic" ? "\\backslash" : DIVIDE_OPERATOR_EN;
 }
 
-// src/editor/digits.ts
-var WESTERN = "0123456789";
-var ARABIC_INDIC = "\u0660\u0661\u0662\u0663\u0664\u0665\u0666\u0667\u0668\u0669";
-var PERSIAN_INDIC = "\u06F0\u06F1\u06F2\u06F3\u06F4\u06F5\u06F6\u06F7\u06F8\u06F9";
-var digitSets = {
-  western: WESTERN,
-  arabicIndic: ARABIC_INDIC,
-  persianIndic: PERSIAN_INDIC
-};
-function digitValue(char) {
-  const western = WESTERN.indexOf(char);
-  if (western >= 0) {
-    return western;
-  }
-  const arabicIndic = ARABIC_INDIC.indexOf(char);
-  if (arabicIndic >= 0) {
-    return arabicIndic;
-  }
-  return PERSIAN_INDIC.indexOf(char);
-}
-function formatDigits(value, digitForm = "western") {
-  const target = digitSets[digitForm];
-  return Array.from(value, (char) => {
-    const value2 = digitValue(char);
-    return value2 >= 0 ? target[value2] : char;
-  }).join("");
-}
-
 // src/editor/render.ts
 function selectedDigitForm(options) {
   return options?.digitForm ?? "western";
@@ -3060,6 +3206,7 @@ function cloneBlock(block) {
 function cloneDocument(document2) {
   return {
     nodeType: "DocumentObject",
+    references: document2.references.map((reference) => ({ ...reference })),
     blocks: document2.blocks.map(cloneBlock),
     diagnostics: document2.diagnostics.map((diagnostic) => ({ ...diagnostic }))
   };
@@ -3380,12 +3527,340 @@ function removeDocument2ListItem(document2, listBlockId, itemId) {
   });
   return next;
 }
+function citeTokenFromKeys(keys) {
+  return { id: document2Id("cite"), kind: "cite", keys: [...keys] };
+}
+function insertCiteTokenAtCaret(document2, fieldId, textTokenId, caretOffset, keys) {
+  if (keys.length === 0) {
+    return document2;
+  }
+  const next = cloneDocument(document2);
+  const citeToken = citeTokenFromKeys(keys);
+  visitFields(next.blocks, (field) => {
+    if (field.id !== fieldId) {
+      return false;
+    }
+    const textIndex = textTokenId ? field.tokens.findIndex((token) => token.id === textTokenId && token.kind === "text") : field.tokens.findIndex((token) => token.kind === "text");
+    if (textIndex < 0) {
+      field.tokens.push(citeToken);
+      field.tokens.push({ id: document2Id("text"), kind: "text", text: "" });
+      return true;
+    }
+    const current = field.tokens[textIndex];
+    const [before, after] = splitTextTokenAt(current, caretOffset);
+    const parts = [...field.tokens.slice(0, textIndex)];
+    if (before.text.length > 0) {
+      parts.push(before);
+    }
+    parts.push(citeToken);
+    parts.push(after);
+    parts.push(...field.tokens.slice(textIndex + 1));
+    field.tokens = normalizeFieldTokens(parts);
+    return true;
+  });
+  return next;
+}
+function updateCiteTokenKeys(document2, tokenId, keys) {
+  if (keys.length === 0) {
+    return document2;
+  }
+  const next = cloneDocument(document2);
+  visitFields(next.blocks, (field) => {
+    const token = field.tokens.find((entry) => entry.id === tokenId && entry.kind === "cite");
+    if (!token) {
+      return false;
+    }
+    token.keys = [...keys];
+    return true;
+  });
+  return next;
+}
+function removeCiteTokenById(document2, tokenId) {
+  const next = cloneDocument(document2);
+  visitFields(next.blocks, (field) => {
+    const index = field.tokens.findIndex((token) => token.id === tokenId && token.kind === "cite");
+    if (index < 0) {
+      return false;
+    }
+    field.tokens = normalizeFieldTokens(stitchTextAroundRemovedToken(field.tokens, index));
+    return true;
+  });
+  return next;
+}
+function ensureDocument2BibliographyBlock(document2, afterBlockId) {
+  if (document2.blocks.some((block2) => block2.kind === "bibliography")) {
+    return document2;
+  }
+  const block = {
+    id: document2Id("block"),
+    kind: "bibliography",
+    command: "\\begin{thebibliography}",
+    closing: "\\end{thebibliography}"
+  };
+  return insertDocument2BlockAfter(document2, afterBlockId ?? null, block);
+}
+function addDocument2Reference(document2, partial = {}) {
+  const next = cloneDocument(document2);
+  next.references.push(createEmptyReference2(partial));
+  return next;
+}
+function updateDocument2Reference(document2, referenceId, patch) {
+  const next = cloneDocument(document2);
+  const reference = next.references.find((entry) => entry.id === referenceId);
+  if (!reference) {
+    return document2;
+  }
+  if (typeof patch.key === "string" && patch.key.trim().length > 0) {
+    reference.key = patch.key.trim();
+  }
+  if (typeof patch.authors === "string") {
+    reference.authors = patch.authors;
+  }
+  if (typeof patch.title === "string") {
+    reference.title = patch.title;
+  }
+  if (typeof patch.year === "string") {
+    reference.year = patch.year;
+  }
+  if (typeof patch.url === "string") {
+    reference.url = patch.url;
+  }
+  if (typeof patch.venue === "string") {
+    reference.venue = patch.venue;
+  }
+  return next;
+}
+function removeDocument2Reference(document2, referenceId) {
+  const next = cloneDocument(document2);
+  next.references = next.references.filter((reference) => reference.id !== referenceId);
+  return next;
+}
+function moveDocument2Reference(document2, referenceId, direction) {
+  const next = cloneDocument(document2);
+  const index = next.references.findIndex((reference2) => reference2.id === referenceId);
+  const targetIndex = index + direction;
+  if (index < 0 || targetIndex < 0 || targetIndex >= next.references.length) {
+    return document2;
+  }
+  const [reference] = next.references.splice(index, 1);
+  if (!reference) {
+    return document2;
+  }
+  next.references.splice(targetIndex, 0, reference);
+  return next;
+}
+function setDocument2References(document2, references) {
+  const next = cloneDocument(document2);
+  next.references = references.map((reference) => ({ ...reference }));
+  return next;
+}
+
+// src/document2/arabicPreamble.ts
+function arabicXeLatexPreamblePkg() {
+  return String.raw`
+\documentclass[12pt,a4paper]{article}
+\usepackage{amsmath,amsfonts,amssymb,mathrsfs,tikz,fancyhdr, mathtools}
+\usepackage{fontspec} % For loading OpenType fonts
+\usepackage{unicode-math} % For setting the math font
+\usepackage{polyglossia} % For Arabic support
+\usepackage{array}
+\usepackage{cancel}
+\usepackage{bidi} % For bidirectional text handling
+\usepackage{multirow}
+\usepackage{booktabs}
+\usepackage{graphicx} % For \reflectbox
+\usepackage{xcolor}
+\usepackage{tikz}
+\usepackage{tcolorbox}  % For tcolorbox environment
+\usepackage{textcomp}    % For \textrightarrow command
+
+
+% visit : https://www.symbolcopy.com/punctuation-symbol.html
+% for inversed punctuation
+
+% save inverted comma for use - copy paste ->  ،
+% save back tick for use - copy paste ->  ` + "`";
+}
+function arabicXeLatexPreambleFont(digitsMapping = "arabicdigits") {
+  return `
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% Toggle between eastern and western digits by changing the Mapping in the below fonts (inside math font as well) between "arabicdigits" and "digits"
+\\setdefaultlanguage[calendar=gregorian]{arabic}  % from polyglossia
+\\setmainfont[Script=Arabic , Mapping=${digitsMapping}]{Amiri}
+\\newfontfamily\\diwani[Script=Arabic,Mapping=${digitsMapping}]{Diwani Letter}
+\\newfontfamily\\diwanioutlineshaded[Script=Arabic,Mapping=${digitsMapping}]{Diwani Outline Shaded}
+\\newfontfamily\\takween[Script=Arabic,Mapping=${digitsMapping}]{Takween}
+\\newfontfamily\\boldarabic[Script=Arabic,Mapping=${digitsMapping}]{Amiri Bold}
+\\newfontfamily\\italicarabic[Script=Arabic,Mapping=${digitsMapping}]{Amiri Italic}
+
+% Explicitly set math font to XITS Math
+% Remove "Script=Arabic" to cancel reflected symbols and other RTL symbols
+\\setmathfont[Script=Arabic , Mapping=${digitsMapping}]{XITS Math} % Ensure XITS Math is correctly installed and available
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+`;
+}
+function arabicXeLatexPreambleCmd() {
+  return String.raw`
+% Run with XeLaTeX compiler
+\newcommand{\butextakween}[1]{\text{\takween{#1}}}
+\newcommand{\butexdiwani}[1]{\text{\diwani{#1}}}
+\newcommand{\butexdiwanioutline}[1]{\text{\diwanioutlineshaded{#1}}}
+
+\newcommand{\arabN}{\text{\diwanioutlineshaded{ط}}}
+\newcommand{\arabZ}{\text{\diwanioutlineshaded{ص}}}
+\newcommand{\arabQ}{\text{\diwanioutlineshaded{ن}}}
+\newcommand{\arabR}{\text{\diwanioutlineshaded{ح}}}
+\newcommand{\arabC}{\text{\diwanioutlineshaded{ع}}}
+\newcommand{\arabH}{\text{\diwanioutlineshaded{ر}}}
+
+
+\newcommand{\lowerscript}[1]{\raisebox{-4pt}{\scriptsize #1}}
+\newcommand{\llowerscript}[1]{\raisebox{-8pt}{\scriptsize #1}}
+\newcommand{\lllowerscript}[2]{\raisebox{#2pt}{\scriptsize #1}}
+
+\newcommand{\arabdsub}[3]{\prescript{}{#1}{\prescript{}{#2}{#3}}} % arabic double subscript
+\newcommand{\arabsub}[2]{\prescript{}{#1}{#2}} % arabic single subscript
+
+
+
+\newcommand{\upperscript}[1]{\raisebox{8pt}{\scriptsize #1}}
+\newcommand{\uupperscript}[2]{\raisebox{#2pt}{\scriptsize #1}}
+\newcommand{\vertbar}{\rule[-1ex]{0.5pt}{2.5ex}}
+\newcommand{\horzbar}{\rule[.5ex]{2.5ex}{0.5pt}}
+
+\newcommand{\arabsqrt}[2]{\reflectbox{\(\sqrt[\reflectbox{\(#1\)}]{\reflectbox{\(#2\)}}\)}}
+\newcommand{\arabvec}[1]{\reflectbox{$\vec{\reflectbox{$#1$}}$}}
+
+\newcommand{\arabexp}[1]{{}^{#1}\!\raisebox{-4.5pt}{\text{\diwani{ه}}}}
+\newcommand{\arablog}[2]{\left(\text{#2}\right)\!\prescript{}{\text{#1}}{\text{\diwani{لو}}}}
+\newcommand{\arabnlog}[1]{\left(\text{#1}\right)\!\prescript{}{\text{\diwani{ه}}}{\text{\diwani{لو}}}}
+
+\newcommand{\arabcos}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{جتا}}}}
+\newcommand{\arabsin}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{جا}}}}
+\newcommand{\arabtan}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{ظا}}}}
+\newcommand{\arabcot}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{ظتا}}}}
+\newcommand{\arabsec}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{قا}}}}
+\newcommand{\arabcsc}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{قتا}}}}
+
+\newcommand{\arabacos}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{قجتا}}}}
+\newcommand{\arabasin}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{قجا}}}}
+\newcommand{\arabatan}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{قظا}}}}
+\newcommand{\arabacot}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{قظتا}}}}
+\newcommand{\arabasec}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{ققا}}}}
+\newcommand{\arabacsc}[1]{\left(#1\right)\!\!\raisebox{-2.5pt}{\text{\diwani{ققتا}}}}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% summation
+\newcommand{\arablim}[2]{\underset{#2 \leftarrow #1}{\text{نـــــها}}}
+\newcommand{\arabsum}[2]{\underset{#1}{\overset{#2}{\text{مجـــ}}}}
+\newcommand{\arabprod}[2]{\underset{#1}{\overset{#2}{\text{جـــذ}}}}
+\newcommand{\arabint}[2]{\prescript{#2}{#1\!\!\!}\int}
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% we define this command to make it ease for change of notation later
+\newcommand{\ad}[0]{\text{ء}} % "ad" for arabic differentiation or derivative (ء" لإشتقاق")
+\newcommand{\arpi}[0]{\!\text{\diwani{ط}}}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% differentials
+
+\newcommand{\arabdiff}[2]{\frac{#1\ad}{#2\ad}} % arabic differential
+\newcommand{\arabddiff}[2]{\frac{#1{}^{2}\ad}{{}^{2}#2\ad}} % arabic second differential
+
+\newcommand{\arabode}[2][-5pt]{\stackrel{\raisebox{#1}{$\cdot$}}{\text{#2}}}
+\newcommand{\arabodde}[2][-5pt]{\stackrel{\raisebox{#1}{$\vcenter{\hbox{$\cdot\!\cdot$}}$}}{\text{#2}}}
+\newcommand{\araboddde}[2][-5pt]{\stackrel{\raisebox{#1}{$\vcenter{\hbox{$\cdot\!\cdot\!\cdot$}}$}}{\text{#2}}}
+\newcommand{\arabpde}[1]{\prescript{}{#1\!\!}{\nabla}} % arabic partial differential equation (PDE)
+
+\newcommand{\arabprime}[0]{\reflectbox{$\prime$}\!} % arabic prime notation
+\newcommand{\arabpprime}[0]{\reflectbox{$\prime$}\reflectbox{$\prime$}\!} % arabic prime notation
+\newcommand{\arabppprime}[0]{\reflectbox{$\prime$}\reflectbox{$\prime$}\reflectbox{$\prime$}\!} % arabic prime notation
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% probability
+\newcommand{\ap}[0]{\!\text{\diwani{حـ}}} % arabic Probability - used a lot so short form
+\newcommand{\arabExpct}[0]{\text{\diwani{توقـ}}} % arabic Expectation
+\newcommand{\arabVar}[0]{\!\text{\diwani{با}}} % arabic Variance
+\newcommand{\arabCov}[0]{\!\text{\diwani{ت}}} % arabic Covariance
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+% custom commands specific to lesson
+\newcommand{\lagrange}[2]{\left(#2\right)\!\prescript{}{#1}{\text{\diwani{لا}}}}
+\newcommand{\xii}[0]{\left(\prescript{}{\text{يـ}}{\text{س}}\right)\!}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+\newcommand{\arsqrt}[2][]{\reflectbox{\(\sqrt[\reflectbox{\(#1\)}]{\reflectbox{\(#2\)}}\)}}
+\newcommand{\arexp}[0]{\!\raisebox{-4.5pt}{\text{\diwani{ه}}}}
+\newcommand{\arlog}[0]{\!\!\text{\diwani{لو}}}
+\newcommand{\arln}[0]{\!\!\prescript{}{\text{\diwani{ه}}}{\text{\diwani{لو}}}}
+\newcommand{\ardet}[0]{\!\!\text{\diwani{محدد}}}
+
+\newcommand{\arsum}[0]{\text{مجـــ}}
+\newcommand{\arprod}[0]{\text{جـــذ}}
+
+\newcommand{\arlim}[0]{\text{نـــــها}}
+\newcommand{\armax}[0]{\text{أكبر}}
+\newcommand{\armin}[0]{\text{أصغر}}
+\newcommand{\arsup}[0]{\text{أعلى}}
+\newcommand{\arinf}[0]{\text{أدنى}}
+
+\newcommand{\arsin}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{جا}}}}
+\newcommand{\arcos}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{جتا}}}}
+\newcommand{\artan}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ظا}}}}
+\newcommand{\arcot}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ظتا}}}}
+\newcommand{\arsec}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قا}}}}
+\newcommand{\arcsc}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قتا}}}}   
+
+\newcommand{\arasin}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قجا}}}}
+\newcommand{\aracos}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قجتا}}}}
+\newcommand{\aratan}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قظا}}}}
+\newcommand{\aracot}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قظتا}}}}
+\newcommand{\arasec}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ققا}}}}
+\newcommand{\aracsc}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ققتا}}}}
+
+\newcommand{\arsinh}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{جزا}}}}
+\newcommand{\arcosh}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{جتزا}}}}
+\newcommand{\artanh}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ظزا}}}}
+\newcommand{\arcoth}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ظتزا}}}}
+\newcommand{\arsech}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قزا}}}}
+\newcommand{\arcsch}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قتزا}}}}
+
+\newcommand{\arasinh}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قجزا}}}}
+\newcommand{\aracosh}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قجتزا}}}}  
+\newcommand{\aratanh}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قظزا}}}}
+\newcommand{\aracoth}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{قظتزا}}}}
+\newcommand{\arasech}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ققزا}}}}
+\newcommand{\aracsch}[0]{\!\!\raisebox{-2.5pt}{\text{\diwani{ققتزا}}}}
+
+\newcommand{\unit}[1]{\text{#1}}
+\newcommand{\idx}[1]{#1}
+\newcommand{\arbinom}[2]{\left(\begin{array}{c} #1 \\ #2 \end{array} \right)}
+`;
+}
+function getArabicXeLatexPreamble(digitsMapping = "arabicdigits") {
+  return arabicXeLatexPreamblePkg() + arabicXeLatexPreambleFont(digitsMapping) + arabicXeLatexPreambleCmd();
+}
 
 // src/document2/exportLatex.ts
 function tokenLatex(token) {
   if (token.kind === "text") {
     return token.text;
   }
+  if (token.kind === "cite") {
+    return citeTokenLatex(token.keys);
+  }
   if (!token.math || token.sourceOwner === "raw" || token.sourceOwner === "editor") {
     return token.source;
   }
@@ -3400,9 +3875,9 @@ function textBlockLatex(block) {
 function indent(value) {
   return value.split("\n").map((line) => `  ${line}`).join("\n");
 }
-function listBlockLatex(block) {
+function listBlockLatex(block, references) {
   const items = block.items.map((item) => {
-    const nested = item.blocks.map((child) => "\n" + indent(blockLatex(child))).join("");
+    const nested = item.blocks.map((child) => "\n" + indent(blockLatex(child, references))).join("");
     return `  \\item ${inlineFieldLatex(item.field)}${nested}`;
   }).join("\n");
   return `${block.command}
@@ -3422,12 +3897,12 @@ function imageOptionsLatex(block) {
   }
   return `[${entries.map(([key, value]) => `${key}=${value}`).join(",")}]`;
 }
-function blockLatex(block) {
+function blockLatex(block, references) {
   if (block.kind === "textBlock") {
     return textBlockLatex(block);
   }
   if (block.kind === "list") {
-    return listBlockLatex(block);
+    return listBlockLatex(block, references);
   }
   if (block.kind === "table") {
     return tableBlockLatex(block);
@@ -3435,10 +3910,29 @@ function blockLatex(block) {
   if (block.kind === "image") {
     return `${block.command}${imageOptionsLatex(block)}{${block.value}}`;
   }
+  if (block.kind === "bibliography") {
+    const width = String(Math.max(references.length, 9));
+    const items = references.map((reference) => `  ${bibliographyEntryLatex(reference)}`).join("\n");
+    return `${block.command}{${width}}
+${items}
+${block.closing}`;
+  }
   return block.value;
 }
-function document2Latex(document2) {
-  return document2.blocks.map((block) => blockLatex(block)).join("\n\n");
+function document2Latex(document2, options = {}) {
+  const body = document2.blocks.map((block) => blockLatex(block, document2.references)).join("\n\n");
+  const wrapDocument = options.wrapDocument !== false;
+  if (!wrapDocument) {
+    return body;
+  }
+  const preamble = getArabicXeLatexPreamble(options.digitsMapping ?? "arabicdigits");
+  return `${preamble}
+\\begin{document}
+
+${body}
+
+\\end{document}
+`;
 }
 
 // src/document2/history.ts
@@ -3476,16 +3970,24 @@ function document2HistoryCanRedo(stacks) {
 
 // src/document2/previewModel.ts
 function mathTex(token, equationSide) {
-  if (token.kind === "text") {
-    return token.text;
-  }
   return mathTokenSourceForSide(token, equationSide);
 }
-function previewInlines(field, islands, output, equationSide) {
+function previewInlines(field, islands, output, equationSide, document2, previewOptions) {
   return field.tokens.map((token) => {
     if (token.kind === "text") {
       return { kind: "text", text: token.text };
     }
+    if (token.kind === "cite") {
+      return {
+        kind: "cite",
+        id: token.id,
+        keys: [...token.keys],
+        label: formatCiteLabel(token.keys, document2.references, {
+          documentDirection: previewOptions.documentDirection,
+          digitForm: previewOptions.digitForm
+        })
+      };
+    }
     const island = {
       id: token.id,
       tex: mathTex(token, equationSide),
@@ -3497,21 +3999,22 @@ function previewInlines(field, islands, output, equationSide) {
     return { kind: "math", ...island };
   });
 }
-function textBlockPreview(block, islands, output, equationSide) {
+function textBlockPreview(block, islands, output, equationSide, document2, previewOptions) {
+  const inlines = previewInlines(block.field, islands, output, equationSide, document2, previewOptions);
   if (block.command === "\\section") {
-    return { kind: "heading", id: block.id, level: 1, inlines: previewInlines(block.field, islands, output, equationSide) };
+    return { kind: "heading", id: block.id, level: 1, inlines };
   }
   if (block.command === "\\subsection") {
-    return { kind: "heading", id: block.id, level: 2, inlines: previewInlines(block.field, islands, output, equationSide) };
+    return { kind: "heading", id: block.id, level: 2, inlines };
   }
   if (block.command === "\\subsubsection") {
-    return { kind: "heading", id: block.id, level: 3, inlines: previewInlines(block.field, islands, output, equationSide) };
+    return { kind: "heading", id: block.id, level: 3, inlines };
   }
-  return { kind: "paragraph", id: block.id, inlines: previewInlines(block.field, islands, output, equationSide) };
+  return { kind: "paragraph", id: block.id, inlines };
 }
-function blockPreview(block, islands, output, equationSide) {
+function blockPreview(block, islands, output, equationSide, document2, previewOptions) {
   if (block.kind === "textBlock") {
-    return textBlockPreview(block, islands, output, equationSide);
+    return textBlockPreview(block, islands, output, equationSide, document2, previewOptions);
   }
   if (block.kind === "list") {
     return {
@@ -3520,23 +4023,56 @@ function blockPreview(block, islands, output, equationSide) {
       ordered: block.command === "\\begin{enumerate}",
       items: block.items.map((item) => ({
         id: item.id,
-        inlines: previewInlines(item.field, islands, output, equationSide),
-        blocks: item.blocks.map((child) => blockPreview(child, islands, output, equationSide))
+        inlines: previewInlines(item.field, islands, output, equationSide, document2, previewOptions),
+        blocks: item.blocks.map((child) => blockPreview(child, islands, output, equationSide, document2, previewOptions))
       }))
     };
   }
   if (block.kind === "table") {
-    return { kind: "table", id: block.id, rows: block.rows.map((row) => row.map((cell) => previewInlines(cell, islands, output, equationSide))) };
+    return {
+      kind: "table",
+      id: block.id,
+      rows: block.rows.map((row) => row.map((cell) => previewInlines(cell, islands, output, equationSide, document2, previewOptions)))
+    };
   }
   if (block.kind === "image") {
-    return { kind: "image", id: block.id, src: block.value, options: block.options };
+    return {
+      kind: "image",
+      id: block.id,
+      src: block.value,
+      ...block.assetId !== void 0 ? { assetId: block.assetId } : {},
+      options: block.options
+    };
+  }
+  if (block.kind === "bibliography") {
+    return {
+      kind: "bibliography",
+      id: block.id,
+      items: document2.references.map((reference, index) => ({
+        id: reference.id,
+        numberLabel: formatBibliographyNumber(index + 1, {
+          documentDirection: previewOptions.documentDirection,
+          digitForm: previewOptions.digitForm
+        }),
+        key: reference.key,
+        authors: reference.authors,
+        title: reference.title,
+        year: reference.year,
+        url: reference.url,
+        venue: reference.venue
+      }))
+    };
   }
   return { kind: "omit", id: block.id };
 }
-function document2Preview(document2, output = "svg", equationSide = "arabic") {
+function document2Preview(document2, output = "svg", equationSide = "arabic", previewOptions = {}) {
   const mathIslands = [];
+  const options = {
+    documentDirection: previewOptions.documentDirection ?? "rtl",
+    digitForm: previewOptions.digitForm ?? (previewOptions.documentDirection === "ltr" ? "western" : "arabicIndic")
+  };
   return {
-    blocks: document2.blocks.map((block) => blockPreview(block, mathIslands, output, equationSide)),
+    blocks: document2.blocks.map((block) => blockPreview(block, mathIslands, output, equationSide, document2, options)),
     mathIslands
   };
 }
@@ -3545,22 +4081,35 @@ export {
   addDocument2ImageBlock,
   addDocument2ListBlock,
   addDocument2ListItem,
+  addDocument2Reference,
   addDocument2TableBlock,
   addDocument2TextBlock,
+  arabicXeLatexPreambleCmd,
+  arabicXeLatexPreambleFont,
+  arabicXeLatexPreamblePkg,
+  bibliographyEntryLatex,
+  citeTokenLatex,
   cloneDocument2Node,
   createDocument2History,
   createEmptyArabicEquationSession,
   createEmptyDocument2,
   createEmptyEquationSession,
+  createEmptyReference2,
   createInlineField2,
+  detectInlineSpans2,
   detectMathSpans2,
   document2HistoryCanRedo,
   document2HistoryCanUndo,
   document2Latex,
   document2Preview,
+  ensureDocument2BibliographyBlock,
   findFirstInlineField,
+  formatBibliographyNumber,
+  formatCiteLabel,
   fromDocumentJson2,
+  getArabicXeLatexPreamble,
   inlineFieldLatex,
+  insertCiteTokenAtCaret,
   insertDocument2BlockAfter,
   insertMathToken,
   insertMathTokenAtCaret,
@@ -3572,14 +4121,24 @@ export {
   mathTokenToArabicEditorSession,
   mathTokenToEditorSession,
   moveDocument2BlockById,
+  moveDocument2Reference,
+  parseCiteKeys,
   pushDocument2Snapshot,
+  referenceFromJson,
+  referenceNumberMap,
+  removeCiteTokenById,
   removeDocument2BlockById,
   removeDocument2ListItem,
+  removeDocument2Reference,
   removeMathTokenById,
   replaceMathTokenFromSession,
+  resolveCiteNumbers,
   restoreDocument2Redo,
   restoreDocument2Undo,
+  setDocument2References,
+  updateCiteTokenKeys,
   updateDocument2ImageValue,
+  updateDocument2Reference,
   updateTextToken
 };
 //# sourceMappingURL=document2.mjs.map