@drghaliasri/butex 4.4.0 → 5.2.0

package/dist/document2.js

@@ -20,29 +20,66 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/document2/index.ts
 var document2_exports = {};
 __export(document2_exports, {
+  BUTEX_BASMALA: () => BUTEX_BASMALA,
+  BUTEX_CLOSING_HAMDALA: () => BUTEX_CLOSING_HAMDALA,
   DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH: () => DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH,
+  DEFAULT_HIJRI_DATE: () => DEFAULT_HIJRI_DATE,
+  HIJRI_MONTH_IDS: () => HIJRI_MONTH_IDS,
+  HIJRI_YEAR_MAX: () => HIJRI_YEAR_MAX,
+  HIJRI_YEAR_MIN: () => HIJRI_YEAR_MIN,
   addDocument2ImageBlock: () => addDocument2ImageBlock,
   addDocument2ListBlock: () => addDocument2ListBlock,
   addDocument2ListItem: () => addDocument2ListItem,
+  addDocument2Reference: () => addDocument2Reference,
   addDocument2TableBlock: () => addDocument2TableBlock,
   addDocument2TextBlock: () => addDocument2TextBlock,
+  applyFloatMetaPatch: () => applyFloatMetaPatch,
+  arabicXeLatexPreambleCmd: () => arabicXeLatexPreambleCmd,
+  arabicXeLatexPreambleFont: () => arabicXeLatexPreambleFont,
+  arabicXeLatexPreamblePkg: () => arabicXeLatexPreamblePkg,
+  bibliographyEntryLatex: () => bibliographyEntryLatex,
+  butexDiwaniDisplayLatex: () => butexDiwaniDisplayLatex,
+  butexDiwaniDisplayTex: () => butexDiwaniDisplayTex,
+  citeTokenLatex: () => citeTokenLatex,
+  cloneDocument2Meta: () => cloneDocument2Meta,
   cloneDocument2Node: () => cloneDocument2Node,
+  collectDocument2Labels: () => collectDocument2Labels,
   createDocument2History: () => createDocument2History,
   createEmptyArabicEquationSession: () => createEmptyArabicEquationSession,
   createEmptyDocument2: () => createEmptyDocument2,
   createEmptyEquationSession: () => createEmptyEquationSession,
+  createEmptyReference2: () => createEmptyReference2,
   createInlineField2: () => createInlineField2,
+  defaultFloatMeta: () => defaultFloatMeta,
+  detectInlineSpans2: () => detectInlineSpans2,
   detectMathSpans2: () => detectMathSpans2,
+  document2HasAbstract: () => document2HasAbstract,
+  document2HasMaketitle: () => document2HasMaketitle,
+  document2HasTitleStack: () => document2HasTitleStack,
   document2HistoryCanRedo: () => document2HistoryCanRedo,
   document2HistoryCanUndo: () => document2HistoryCanUndo,
   document2Latex: () => document2Latex,
   document2Preview: () => document2Preview,
+  emptyBlockSelection: () => emptyBlockSelection,
+  emptyDocument2Meta: () => emptyDocument2Meta,
+  ensureDocument2BibliographyBlock: () => ensureDocument2BibliographyBlock,
+  extendBlockSelectionFromAnchor: () => extendBlockSelectionFromAnchor,
+  fillDocument2MetaGaps: () => fillDocument2MetaGaps,
   findFirstInlineField: () => findFirstInlineField,
+  formatBibliographyNumber: () => formatBibliographyNumber,
+  formatCiteLabel: () => formatCiteLabel,
+  formatHijriDate: () => formatHijriDate,
+  formatRefLabel: () => formatRefLabel,
   fromDocumentJson2: () => fromDocumentJson2,
+  getArabicXeLatexPreamble: () => getArabicXeLatexPreamble,
+  hijriMonthLabel: () => hijriMonthLabel,
   inlineFieldLatex: () => inlineFieldLatex,
+  insertCiteTokenAtCaret: () => insertCiteTokenAtCaret,
   insertDocument2BlockAfter: () => insertDocument2BlockAfter,
   insertMathToken: () => insertMathToken,
   insertMathTokenAtCaret: () => insertMathTokenAtCaret,
+  insertRefTokenAtCaret: () => insertRefTokenAtCaret,
+  labelNumberMap: () => labelNumberMap,
   mathNodeFromArabicSession: () => mathNodeFromArabicSession,
   mathNodeFromSession: () => mathNodeFromSession,
   mathSourceFromArabicSession: () => mathSourceFromArabicSession,
@@ -50,15 +87,44 @@ __export(document2_exports, {
   mathTokenSourceForSide: () => mathTokenSourceForSide,
   mathTokenToArabicEditorSession: () => mathTokenToArabicEditorSession,
   mathTokenToEditorSession: () => mathTokenToEditorSession,
+  mergeDocument2Meta: () => mergeDocument2Meta,
   moveDocument2BlockById: () => moveDocument2BlockById,
+  moveDocument2BlockRange: () => moveDocument2BlockRange,
+  moveDocument2Reference: () => moveDocument2Reference,
+  normalizeBlockSelection: () => normalizeBlockSelection,
+  normalizeDocument2HijriDate: () => normalizeDocument2HijriDate,
+  normalizeDocument2Meta: () => normalizeDocument2Meta,
+  parseCiteKeys: () => parseCiteKeys,
+  parseFloatMetaFromJson: () => parseFloatMetaFromJson,
+  parseRefKeys: () => parseRefKeys,
   pushDocument2Snapshot: () => pushDocument2Snapshot,
+  refTokenLatex: () => refTokenLatex,
+  referenceFromJson: () => referenceFromJson,
+  referenceNumberMap: () => referenceNumberMap,
+  remapSelectionAfterRangeMove: () => remapSelectionAfterRangeMove,
+  removeCiteTokenById: () => removeCiteTokenById,
   removeDocument2BlockById: () => removeDocument2BlockById,
+  removeDocument2BlockRange: () => removeDocument2BlockRange,
   removeDocument2ListItem: () => removeDocument2ListItem,
+  removeDocument2Reference: () => removeDocument2Reference,
   removeMathTokenById: () => removeMathTokenById,
+  removeRefTokenById: () => removeRefTokenById,
   replaceMathTokenFromSession: () => replaceMathTokenFromSession,
+  resolveCiteNumbers: () => resolveCiteNumbers,
   restoreDocument2Redo: () => restoreDocument2Redo,
   restoreDocument2Undo: () => restoreDocument2Undo,
+  setDocument2References: () => setDocument2References,
+  stripDisplayMathDelimiters: () => stripDisplayMathDelimiters,
+  toggleBlockInSelection: () => toggleBlockInSelection,
+  updateCiteTokenKeys: () => updateCiteTokenKeys,
+  updateDocument2ImageMeta: () => updateDocument2ImageMeta,
   updateDocument2ImageValue: () => updateDocument2ImageValue,
+  updateDocument2Meta: () => updateDocument2Meta,
+  updateDocument2Reference: () => updateDocument2Reference,
+  updateDocument2TableMeta: () => updateDocument2TableMeta,
+  updateDocument2TextBlockCentered: () => updateDocument2TextBlockCentered,
+  updateMathTokenLabel: () => updateMathTokenLabel,
+  updateRefTokenKeys: () => updateRefTokenKeys,
   updateTextToken: () => updateTextToken
 });
 module.exports = __toCommonJS(document2_exports);
@@ -71,6 +137,273 @@ 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/articleMeta.ts
+var BUTEX_BASMALA = "\u0628\u0650\u0633\u0652\u0645\u0650 \u0627\u0644\u0644\u064E\u0651\u0647\u0650 \u0627\u0644\u0631\u064E\u0651\u062D\u0652\u0645\u064E\u0670\u0646\u0650 \u0627\u0644\u0631\u064E\u0651\u062D\u0650\u064A\u0645\u0650 \u0648\u064E\u0627\u0644\u0635\u064E\u0651\u0644\u064E\u0627\u0629\u064F \u0648\u064E\u0627\u0644\u0633\u064E\u0651\u0644\u064E\u0627\u0645\u064F \u0639\u064E\u0644\u064E\u0649\u0670 \u0631\u064E\u0633\u064F\u0648\u0644\u0650 \u0627\u0644\u0644\u064E\u0651\u0647\u0650 \uFDFA";
+var BUTEX_CLOSING_HAMDALA = "\u0627\u0644\u0652\u062D\u064E\u0645\u0652\u062F\u064F \u0644\u0650\u0644\u064E\u0651\u0647\u0650 \u0646\u064E\u0641\u064E\u0639\u064E\u0646\u064E\u0627 \u0628\u0650\u0639\u0650\u0644\u0652\u0645\u0650\u0647\u0650";
+function escapeButexTextArg(text) {
+  return text.replace(/\\/g, "\\textbackslash{}").replace(/[{}]/g, "\\$&");
+}
+function butexDiwaniDisplayTex(text) {
+  return `\\butexdiwani{${escapeButexTextArg(text)}}`;
+}
+function butexDiwaniDisplayLatex(text) {
+  return `\\[
+${butexDiwaniDisplayTex(text)}
+\\]`;
+}
+var HIJRI_YEAR_MIN = 1400;
+var HIJRI_YEAR_MAX = 1500;
+var HIJRI_MONTH_IDS = [
+  "\u0645\u062D\u0631\u0645",
+  "\u0635\u0641\u0631",
+  "\u0631\u0628\u064A\u0639 \u0627\u0644\u0623\u0648\u0644",
+  "\u0631\u0628\u064A\u0639 \u0627\u0644\u0622\u062E\u0631",
+  "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0623\u0648\u0644\u0649",
+  "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0622\u062E\u0631\u0629",
+  "\u0631\u062C\u0628",
+  "\u0634\u0639\u0628\u0627\u0646",
+  "\u0631\u0645\u0636\u0627\u0646",
+  "\u0634\u0648\u0627\u0644",
+  "\u0630\u0648 \u0627\u0644\u0642\u0639\u062F\u0629",
+  "\u0630\u0648 \u0627\u0644\u062D\u062C\u0629"
+];
+var HIJRI_MONTH_LABELS_EN = {
+  \u0645\u062D\u0631\u0645: "Muharram",
+  \u0635\u0641\u0631: "Safar",
+  "\u0631\u0628\u064A\u0639 \u0627\u0644\u0623\u0648\u0644": "Rabi\u02BB I",
+  "\u0631\u0628\u064A\u0639 \u0627\u0644\u0622\u062E\u0631": "Rabi\u02BB II",
+  "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0623\u0648\u0644\u0649": "Jumada I",
+  "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0622\u062E\u0631\u0629": "Jumada II",
+  \u0631\u062C\u0628: "Rajab",
+  \u0634\u0639\u0628\u0627\u0646: "Sha\u02BBban",
+  \u0631\u0645\u0636\u0627\u0646: "Ramadan",
+  \u0634\u0648\u0627\u0644: "Shawwal",
+  "\u0630\u0648 \u0627\u0644\u0642\u0639\u062F\u0629": "Dhul Qa\u02BBdah",
+  "\u0630\u0648 \u0627\u0644\u062D\u062C\u0629": "Dhul Hijjah"
+};
+var LEGACY_LATIN_MONTH = {
+  muharram: "\u0645\u062D\u0631\u0645",
+  safar: "\u0635\u0641\u0631",
+  rabiAwwal: "\u0631\u0628\u064A\u0639 \u0627\u0644\u0623\u0648\u0644",
+  rabiThani: "\u0631\u0628\u064A\u0639 \u0627\u0644\u0622\u062E\u0631",
+  jumadaAwwal: "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0623\u0648\u0644\u0649",
+  jumadaThani: "\u062C\u0645\u0627\u062F\u0649 \u0627\u0644\u0622\u062E\u0631\u0629",
+  rajab: "\u0631\u062C\u0628",
+  shaban: "\u0634\u0639\u0628\u0627\u0646",
+  ramadan: "\u0631\u0645\u0636\u0627\u0646",
+  shawwal: "\u0634\u0648\u0627\u0644",
+  dhulQadah: "\u0630\u0648 \u0627\u0644\u0642\u0639\u062F\u0629",
+  dhulHijjah: "\u0630\u0648 \u0627\u0644\u062D\u062C\u0629"
+};
+var DEFAULT_HIJRI_DATE = {
+  day: 1,
+  month: "\u0645\u062D\u0631\u0645",
+  year: 1448
+};
+function hijriMonthLabel(month, locale = "ar") {
+  return locale === "en" ? HIJRI_MONTH_LABELS_EN[month] : month;
+}
+function emptyDocument2Meta() {
+  return {
+    title: "",
+    authors: "",
+    date: { ...DEFAULT_HIJRI_DATE },
+    abstract: ""
+  };
+}
+function clampInt(value, min, max) {
+  if (!Number.isFinite(value)) {
+    return min;
+  }
+  return Math.min(max, Math.max(min, Math.trunc(value)));
+}
+function isHijriMonthId(value) {
+  return typeof value === "string" && HIJRI_MONTH_IDS.includes(value);
+}
+function resolveHijriMonthId(value) {
+  if (isHijriMonthId(value)) {
+    return value;
+  }
+  if (typeof value === "string" && value in LEGACY_LATIN_MONTH) {
+    return LEGACY_LATIN_MONTH[value];
+  }
+  return DEFAULT_HIJRI_DATE.month;
+}
+function normalizeDocument2HijriDate(value) {
+  if (typeof value !== "object" || value === null) {
+    return { ...DEFAULT_HIJRI_DATE };
+  }
+  const raw = value;
+  const day = clampInt(typeof raw.day === "number" ? raw.day : Number(raw.day), 1, 30);
+  const year = clampInt(typeof raw.year === "number" ? raw.year : Number(raw.year), HIJRI_YEAR_MIN, HIJRI_YEAR_MAX);
+  const month = resolveHijriMonthId(raw.month);
+  return { day, month, year };
+}
+function normalizeDocument2Meta(value) {
+  if (typeof value !== "object" || value === null) {
+    return emptyDocument2Meta();
+  }
+  const raw = value;
+  return {
+    title: typeof raw.title === "string" ? raw.title : "",
+    authors: typeof raw.authors === "string" ? raw.authors : "",
+    date: normalizeDocument2HijriDate(raw.date),
+    abstract: typeof raw.abstract === "string" ? raw.abstract : ""
+  };
+}
+function mergeDocument2Meta(fromJson, fromProp) {
+  const fromPropMeta = {
+    title: typeof fromProp?.title === "string" ? fromProp.title : "",
+    authors: typeof fromProp?.authors === "string" ? fromProp.authors : "",
+    abstract: typeof fromProp?.abstract === "string" ? fromProp.abstract : "",
+    date: fromProp?.date ? normalizeDocument2HijriDate({ ...DEFAULT_HIJRI_DATE, ...fromProp.date }) : { ...DEFAULT_HIJRI_DATE }
+  };
+  if (typeof fromJson !== "object" || fromJson === null) {
+    return fromPropMeta;
+  }
+  const json = fromJson;
+  return {
+    title: "title" in json && typeof json.title === "string" ? json.title : fromPropMeta.title,
+    authors: "authors" in json && typeof json.authors === "string" ? json.authors : fromPropMeta.authors,
+    abstract: "abstract" in json && typeof json.abstract === "string" ? json.abstract : fromPropMeta.abstract,
+    date: "date" in json ? normalizeDocument2HijriDate(json.date) : fromPropMeta.date
+  };
+}
+function fillDocument2MetaGaps(current, fromProp) {
+  if (!fromProp) {
+    return cloneDocument2Meta(current);
+  }
+  return {
+    title: current.title.trim().length > 0 ? current.title : typeof fromProp.title === "string" ? fromProp.title : current.title,
+    authors: current.authors.trim().length > 0 ? current.authors : typeof fromProp.authors === "string" ? fromProp.authors : current.authors,
+    abstract: current.abstract.trim().length > 0 ? current.abstract : typeof fromProp.abstract === "string" ? fromProp.abstract : current.abstract,
+    date: fromProp.date ? normalizeDocument2HijriDate({ ...current.date, ...fromProp.date }) : { ...current.date }
+  };
+}
+function document2HasMaketitle(meta) {
+  return meta.title.trim().length > 0 || meta.authors.trim().length > 0;
+}
+function document2HasAbstract(meta) {
+  return meta.abstract.trim().length > 0;
+}
+function document2HasTitleStack(meta) {
+  return document2HasMaketitle(meta) || document2HasAbstract(meta);
+}
+function formatHijriDate(date, options = "ar") {
+  const opts = typeof options === "string" ? { locale: options } : options;
+  const locale = opts.locale ?? "ar";
+  const digitForm = opts.digitForm ?? (locale === "en" ? "western" : "arabicIndic");
+  const month = hijriMonthLabel(date.month, locale);
+  const day = formatDigits(String(date.day), digitForm);
+  const year = formatDigits(String(date.year), digitForm);
+  if (locale === "en") {
+    return `${day} ${month} ${year} AH`;
+  }
+  return `${day} ${month} ${year}\u0647\u0640`;
+}
+function cloneDocument2Meta(meta) {
+  return {
+    title: meta.title,
+    authors: meta.authors,
+    date: { ...meta.date },
+    abstract: meta.abstract
+  };
+}
+
+// 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("");
@@ -440,6 +773,168 @@ ${lines.map((line) => `    ${line}`).join(" \\\\\n")}
 ${math.closing}`;
 }
 
+// src/document2/labels.ts
+function defaultFloatMeta() {
+  return {
+    centered: true,
+    captionEnabled: false,
+    caption: "",
+    labelEnabled: false,
+    label: ""
+  };
+}
+function parseFloatMetaFromJson(json) {
+  const caption = typeof json.caption === "string" ? json.caption : "";
+  const label = typeof json.label === "string" ? json.label : "";
+  return {
+    centered: json.centered !== false,
+    captionEnabled: json.caption_enabled === true || typeof json.caption_enabled !== "boolean" && caption.length > 0,
+    caption,
+    labelEnabled: json.label_enabled === true || typeof json.label_enabled !== "boolean" && label.trim().length > 0,
+    label
+  };
+}
+function parseRefKeys(source) {
+  const eqref = /^\\eqref\{([^}]*)\}$/.exec(source.trim());
+  if (eqref) {
+    return {
+      refCommand: "eqref",
+      keys: (eqref[1] ?? "").split(",").map((key) => key.trim()).filter((key) => key.length > 0)
+    };
+  }
+  const ref = /^\\ref\{([^}]*)\}$/.exec(source.trim());
+  if (ref) {
+    return {
+      refCommand: "ref",
+      keys: (ref[1] ?? "").split(",").map((key) => key.trim()).filter((key) => key.length > 0)
+    };
+  }
+  return { keys: [], refCommand: "ref" };
+}
+function refTokenLatex(keys, refCommand) {
+  const command = refCommand === "eqref" ? "\\eqref" : "\\ref";
+  return `${command}{${keys.join(",")}}`;
+}
+function collectDocument2Labels(document2) {
+  const entries = [];
+  const counters = { fig: 0, tab: 0, eq: 0 };
+  function pushEqFromField(tokens) {
+    for (const token of tokens) {
+      if (token.kind !== "math") {
+        continue;
+      }
+      if (token.display && token.labelEnabled && token.label && token.label.trim().length > 0) {
+        counters.eq += 1;
+        entries.push({
+          key: token.label.trim(),
+          kind: "eq",
+          caption: "",
+          ownerId: token.id,
+          number: counters.eq
+        });
+      }
+    }
+  }
+  function walk(blocks) {
+    for (const block of blocks) {
+      if (block.kind === "image" && block.labelEnabled && block.label.trim().length > 0) {
+        counters.fig += 1;
+        entries.push({
+          key: block.label.trim(),
+          kind: "fig",
+          caption: block.captionEnabled ? block.caption : "",
+          ownerId: block.id,
+          number: counters.fig
+        });
+      }
+      if (block.kind === "table") {
+        if (block.labelEnabled && block.label.trim().length > 0) {
+          counters.tab += 1;
+          entries.push({
+            key: block.label.trim(),
+            kind: "tab",
+            caption: block.captionEnabled ? block.caption : "",
+            ownerId: block.id,
+            number: counters.tab
+          });
+        }
+        for (const row of block.rows) {
+          for (const cell of row) {
+            pushEqFromField(cell.tokens);
+          }
+        }
+      }
+      if (block.kind === "textBlock") {
+        pushEqFromField(block.field.tokens);
+      }
+      if (block.kind === "list") {
+        for (const item of block.items) {
+          pushEqFromField(item.field.tokens);
+          walk(item.blocks);
+        }
+      }
+    }
+  }
+  walk(document2.blocks);
+  return entries;
+}
+function labelNumberMap(document2) {
+  const map = /* @__PURE__ */ new Map();
+  for (const entry of collectDocument2Labels(document2)) {
+    if (!map.has(entry.key)) {
+      map.set(entry.key, { kind: entry.kind, number: entry.number });
+    }
+  }
+  return map;
+}
+function formatRefLabel(keys, document2, refCommand, options = {}) {
+  const documentDirection = options.documentDirection ?? "rtl";
+  const digitForm = options.digitForm ?? (documentDirection === "rtl" ? "arabicIndic" : "western");
+  const map = labelNumberMap(document2);
+  const parts = keys.map((key) => {
+    const hit = map.get(key);
+    if (!hit) {
+      return "?";
+    }
+    return formatDigits(String(hit.number), digitForm);
+  });
+  const body = parts.join(documentDirection === "rtl" ? "\u060C" : ", ");
+  if (refCommand === "eqref") {
+    return `(${body})`;
+  }
+  return body;
+}
+function stripDisplayMathDelimiters(source) {
+  const trimmed = source.trim();
+  if (trimmed.startsWith("\\[") && trimmed.endsWith("\\]")) {
+    return trimmed.slice(2, -2).trim();
+  }
+  if (trimmed.startsWith("$$") && trimmed.endsWith("$$")) {
+    return trimmed.slice(2, -2).trim();
+  }
+  if (trimmed.startsWith("\\begin{equation}") && trimmed.endsWith("\\end{equation}")) {
+    return trimmed.slice("\\begin{equation}".length, -"\\end{equation}".length).trim();
+  }
+  return trimmed;
+}
+function applyFloatMetaPatch(block, patch) {
+  if (typeof patch.centered === "boolean") {
+    block.centered = patch.centered;
+  }
+  if (typeof patch.captionEnabled === "boolean") {
+    block.captionEnabled = patch.captionEnabled;
+  }
+  if (typeof patch.caption === "string") {
+    block.caption = patch.caption;
+  }
+  if (typeof patch.labelEnabled === "boolean") {
+    block.labelEnabled = patch.labelEnabled;
+  }
+  if (typeof patch.label === "string") {
+    block.label = patch.label;
+  }
+}
+
 // src/document2/inlineScanner.ts
 var MATH_ENVIRONMENTS = /* @__PURE__ */ new Set([
   "equation",
@@ -489,53 +984,127 @@ 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 refSpan(value, start) {
+  const eqrefPrefix = "\\eqref{";
+  const refPrefix = "\\ref{";
+  let refCommand = "ref";
+  let prefix = refPrefix;
+  if (value.startsWith(eqrefPrefix, start) && !isEscaped(value, start)) {
+    refCommand = "eqref";
+    prefix = eqrefPrefix;
+  } else if (value.startsWith(refPrefix, start) && !isEscaped(value, start)) {
+    refCommand = "ref";
+    prefix = refPrefix;
+  } else {
+    return null;
+  }
+  const openBrace = start + prefix.length - 1;
+  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) && !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 (char === "}" && !isEscaped(value, i)) {
+      depth -= 1;
+      if (depth === 0) {
+        const end = i + 1;
+        const source = value.slice(start, end);
+        const parsed = parseRefKeys(source);
+        return { kind: "ref", start, end, source, keys: parsed.keys, refCommand };
       }
     }
-    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;
-      }
+  }
+  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)) {
+    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.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 ref = refSpan(value, i);
+    if (ref) {
+      spans.push(ref);
+      i = ref.end;
+      continue;
+    }
+    const math = mathSpanAt(value, i);
+    if (math) {
+      spans.push({ kind: "math", ...math });
+      i = math.end;
+      continue;
     }
     i += 1;
   }
@@ -572,19 +1141,63 @@ 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;
+    }
+    if (span.kind === "ref") {
+      tokens.push({
+        id: document2Id("ref"),
+        kind: "ref",
+        keys: span.keys.length > 0 ? span.keys : [],
+        refCommand: span.refCommand
+      });
+      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");
     }
@@ -616,7 +1229,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) });
   }
@@ -631,7 +1244,8 @@ function parseTextBlock(json, options, path, diagnostics) {
     id: document2Id("block"),
     kind: "textBlock",
     command: json.command,
-    field: createInlineField2(value, json.math_objects ?? [], options, `${path}.value`, diagnostics)
+    field: createInlineField2(value, json.math_objects ?? [], options, `${path}.value`, diagnostics),
+    ...json.centered === true ? { centered: true } : {}
   };
 }
 function parseListItem(json, options, path, diagnostics) {
@@ -684,16 +1298,21 @@ function parseTableBlock(json, options, path, diagnostics) {
     command: "\\begin{tabular}",
     closing: "\\end{tabular}",
     columns: typeof json.columns === "string" ? json.columns : "",
-    rows
+    rows,
+    ...parseFloatMetaFromJson(json)
   };
 }
 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"),
-    options: isRecordOfStrings(json.options) ? json.options : {}
+    value,
+    ...assetId !== void 0 ? { assetId } : {},
+    options: isRecordOfStrings(json.options) ? json.options : {},
+    ...parseFloatMetaFromJson(json)
   };
 }
 function parseRawBlock(json) {
@@ -704,6 +1323,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);
@@ -717,6 +1344,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);
   }
@@ -737,12 +1367,20 @@ function fromDocumentJson2(json, options = {}) {
   const diagnostics = [];
   return {
     nodeType: "DocumentObject",
+    meta: normalizeDocument2Meta(json.meta),
+    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",
+    meta: emptyDocument2Meta(),
+    references: [],
+    blocks: [],
+    diagnostics: []
+  };
 }
 
 // src/editor/atomicCommands.ts
@@ -1765,34 +2403,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";
@@ -3125,6 +3735,8 @@ function cloneBlock(block) {
 function cloneDocument(document2) {
   return {
     nodeType: "DocumentObject",
+    meta: cloneDocument2Meta(document2.meta ?? emptyDocument2Meta()),
+    references: document2.references.map((reference) => ({ ...reference })),
     blocks: document2.blocks.map(cloneBlock),
     diagnostics: document2.diagnostics.map((diagnostic) => ({ ...diagnostic }))
   };
@@ -3234,6 +3846,29 @@ function moveDocument2BlockById(document2, blockId, direction) {
   next.blocks.splice(targetIndex, 0, block);
   return next;
 }
+function moveDocument2BlockRange(document2, from, to, direction) {
+  const count = document2.blocks.length;
+  if (from < 0 || to < 0 || from >= count || to >= count || from > to) {
+    return document2;
+  }
+  const insertAt = from + direction;
+  if (insertAt < 0 || to + direction >= count) {
+    return document2;
+  }
+  const next = cloneDocument(document2);
+  const slice = next.blocks.splice(from, to - from + 1);
+  next.blocks.splice(insertAt, 0, ...slice);
+  return next;
+}
+function removeDocument2BlockRange(document2, from, to) {
+  const count = document2.blocks.length;
+  if (from < 0 || to < 0 || from >= count || to >= count || from > to) {
+    return document2;
+  }
+  const next = cloneDocument(document2);
+  next.blocks = [...next.blocks.slice(0, from), ...next.blocks.slice(to + 1)];
+  return next;
+}
 function normalizeFieldTokens(tokens) {
   if (tokens.length === 0) {
     return [{ id: document2Id("text"), kind: "text", text: "" }];
@@ -3328,16 +3963,50 @@ function replaceMathTokenFromSession(document2, tokenId, session, opening, closi
     const current = field.tokens[index];
     const open = opening ?? current.opening;
     const close = closing ?? current.closing;
-    field.tokens[index] = mathTokenFromSession(session, open, close, side);
-    field.tokens[index].id = current.id;
-    return true;
+    const replaced = mathTokenFromSession(session, open, close, side);
+    replaced.id = current.id;
+    if (current.labelEnabled !== void 0) {
+      replaced.labelEnabled = current.labelEnabled;
+    }
+    if (current.label !== void 0) {
+      replaced.label = current.label;
+    }
+    field.tokens[index] = replaced;
+    return true;
   });
   return next;
 }
 function addDocument2TextBlock(document2, command = "\\paragraph", afterBlockId) {
-  const block = { id: document2Id("block"), kind: "textBlock", command, field: createInlineField2("") };
+  const block = {
+    id: document2Id("block"),
+    kind: "textBlock",
+    command,
+    field: createInlineField2(""),
+    ...command === "\\paragraph" ? { centered: false } : {}
+  };
   return insertDocument2BlockAfter(document2, afterBlockId, block);
 }
+function updateDocument2TextBlockCentered(document2, blockId, centered) {
+  const next = cloneDocument(document2);
+  function visit(blocks) {
+    for (const block of blocks) {
+      if (block.id === blockId && block.kind === "textBlock" && block.command === "\\paragraph") {
+        block.centered = centered;
+        return true;
+      }
+      if (block.kind === "list") {
+        for (const item of block.items) {
+          if (visit(item.blocks)) {
+            return true;
+          }
+        }
+      }
+    }
+    return false;
+  }
+  visit(next.blocks);
+  return next;
+}
 function removeDocument2BlockById(document2, blockId) {
   const next = cloneDocument(document2);
   next.blocks = next.blocks.filter((block) => block.id !== blockId);
@@ -3374,7 +4043,8 @@ function addDocument2TableBlock(document2, columns = "lll", rowCount = 3, colCou
     command: "\\begin{tabular}",
     closing: "\\end{tabular}",
     columns: columns || "l".repeat(cols),
-    rows: tableRows
+    rows: tableRows,
+    ...defaultFloatMeta()
   };
   return insertDocument2BlockAfter(document2, afterBlockId, block);
 }
@@ -3384,7 +4054,8 @@ function addDocument2ImageBlock(document2, src = "", afterBlockId) {
     kind: "image",
     command: "\\includegraphics",
     value: src,
-    options: {}
+    options: { width: "0.8\\textwidth" },
+    ...defaultFloatMeta()
   };
   return insertDocument2BlockAfter(document2, afterBlockId, block);
 }
@@ -3409,6 +4080,128 @@ function updateDocument2ImageValue(document2, blockId, value) {
   visit(next.blocks);
   return next;
 }
+function updateDocument2ImageMeta(document2, blockId, patch) {
+  const next = cloneDocument(document2);
+  function visit(blocks) {
+    for (const block of blocks) {
+      if (block.id === blockId && block.kind === "image") {
+        applyFloatMetaPatch(block, patch);
+        return true;
+      }
+      if (block.kind === "list") {
+        for (const item of block.items) {
+          if (visit(item.blocks)) {
+            return true;
+          }
+        }
+      }
+    }
+    return false;
+  }
+  visit(next.blocks);
+  return next;
+}
+function updateDocument2TableMeta(document2, blockId, patch) {
+  const next = cloneDocument(document2);
+  function visit(blocks) {
+    for (const block of blocks) {
+      if (block.id === blockId && block.kind === "table") {
+        applyFloatMetaPatch(block, patch);
+        return true;
+      }
+      if (block.kind === "list") {
+        for (const item of block.items) {
+          if (visit(item.blocks)) {
+            return true;
+          }
+        }
+      }
+    }
+    return false;
+  }
+  visit(next.blocks);
+  return next;
+}
+function updateMathTokenLabel(document2, tokenId, patch) {
+  const next = cloneDocument(document2);
+  visitFields(next.blocks, (field) => {
+    const token = field.tokens.find((entry) => entry.id === tokenId && entry.kind === "math");
+    if (!token) {
+      return false;
+    }
+    if (typeof patch.labelEnabled === "boolean") {
+      token.labelEnabled = patch.labelEnabled;
+    }
+    if (typeof patch.label === "string") {
+      token.label = patch.label;
+    }
+    return true;
+  });
+  return next;
+}
+function refTokenFromKeys(keys, refCommand) {
+  return { id: document2Id("ref"), kind: "ref", keys: [...keys], refCommand };
+}
+function insertRefTokenAtCaret(document2, fieldId, textTokenId, caretOffset, keys, refCommand = "ref") {
+  if (keys.length === 0) {
+    return document2;
+  }
+  const next = cloneDocument(document2);
+  const refToken = refTokenFromKeys(keys, refCommand);
+  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(refToken);
+      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(refToken);
+    parts.push(after);
+    parts.push(...field.tokens.slice(textIndex + 1));
+    field.tokens = normalizeFieldTokens(parts);
+    return true;
+  });
+  return next;
+}
+function updateRefTokenKeys(document2, tokenId, keys, refCommand) {
+  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 === "ref");
+    if (!token) {
+      return false;
+    }
+    token.keys = [...keys];
+    if (refCommand) {
+      token.refCommand = refCommand;
+    }
+    return true;
+  });
+  return next;
+}
+function removeRefTokenById(document2, tokenId) {
+  const next = cloneDocument(document2);
+  visitFields(next.blocks, (field) => {
+    const index = field.tokens.findIndex((token) => token.id === tokenId && token.kind === "ref");
+    if (index < 0) {
+      return false;
+    }
+    field.tokens = normalizeFieldTokens(stitchTextAroundRemovedToken(field.tokens, index));
+    return true;
+  });
+  return next;
+}
 function mutateListBlockById(blocks, listBlockId, mutator) {
   for (const block of blocks) {
     if (block.id === listBlockId && block.kind === "list") {
@@ -3445,12 +4238,372 @@ 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;
+}
+function updateDocument2Meta(document2, patch) {
+  const next = cloneDocument(document2);
+  const current = next.meta ?? emptyDocument2Meta();
+  next.meta = {
+    title: typeof patch.title === "string" ? patch.title : current.title,
+    authors: typeof patch.authors === "string" ? patch.authors : current.authors,
+    abstract: typeof patch.abstract === "string" ? patch.abstract : current.abstract,
+    date: patch.date ? normalizeDocument2HijriDate({ ...current.date, ...patch.date }) : { ...current.date }
+  };
+  return next;
+}
+
+// src/document2/arabicPreamble.ts
+function arabicXeLatexPreamblePkg(twocolumn = false) {
+  const classOptions = twocolumn ? "12pt,a4paper,twocolumn" : "12pt,a4paper";
+  return `
+\\documentclass[${classOptions}]{article}
+` + String.raw`\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(digitsMappingOrOptions = "arabicdigits") {
+  const options = typeof digitsMappingOrOptions === "string" ? { digitsMapping: digitsMappingOrOptions } : digitsMappingOrOptions;
+  const digitsMapping = options.digitsMapping ?? "arabicdigits";
+  const twocolumn = options.twocolumn === true;
+  return arabicXeLatexPreamblePkg(twocolumn) + arabicXeLatexPreambleFont(digitsMapping) + arabicXeLatexPreambleCmd();
+}
 
 // src/document2/exportLatex.ts
+function mathBodyLatex(token) {
+  if (!token.math || token.sourceOwner === "raw" || token.sourceOwner === "editor") {
+    return stripDisplayMathDelimiters(token.source);
+  }
+  const rendered = renderMathNodeLatex(token.math);
+  return stripDisplayMathDelimiters(rendered);
+}
 function tokenLatex(token) {
   if (token.kind === "text") {
     return token.text;
   }
+  if (token.kind === "cite") {
+    return citeTokenLatex(token.keys);
+  }
+  if (token.kind === "ref") {
+    return refTokenLatex(token.keys, token.refCommand);
+  }
+  if (token.display && token.labelEnabled && token.label && token.label.trim().length > 0) {
+    const body = mathBodyLatex(token);
+    return `\\begin{equation}
+${body}
+\\label{${token.label.trim()}}
+\\end{equation}`;
+  }
   if (!token.math || token.sourceOwner === "raw" || token.sourceOwner === "editor") {
     return token.source;
   }
@@ -3460,26 +4613,52 @@ function inlineFieldLatex(field) {
   return field.tokens.map((token) => tokenLatex(token)).join("");
 }
 function textBlockLatex(block) {
-  return `${block.command}{${inlineFieldLatex(block.field)}}`;
+  const body = `${block.command}{${inlineFieldLatex(block.field)}}`;
+  if (block.command === "\\paragraph" && block.centered) {
+    return `\\begin{center}
+${body}
+\\end{center}`;
+  }
+  return body;
 }
 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}
 ${items}
 ${block.closing}`;
 }
-function tableBlockLatex(block) {
+function tabularInnerLatex(block) {
   const rows = block.rows.map((row) => `  ${row.map((cell) => inlineFieldLatex(cell)).join(" & ")}`).join(" \\\\\n");
   return `${block.command}{${block.columns}}
 ${rows}
 ${block.closing}`;
 }
+function floatCaptionLabelLines(block) {
+  const lines = [];
+  if (block.captionEnabled && block.caption.trim().length > 0) {
+    lines.push(`  \\caption{${block.caption.trim()}}`);
+  }
+  if (block.labelEnabled && block.label.trim().length > 0) {
+    lines.push(`  \\label{${block.label.trim()}}`);
+  }
+  return lines;
+}
+function tableBlockLatex(block) {
+  const lines = ["\\begin{table}[htbp]"];
+  if (block.centered) {
+    lines.push("  \\centering");
+  }
+  lines.push(...floatCaptionLabelLines(block));
+  lines.push(indent(tabularInnerLatex(block)));
+  lines.push("\\end{table}");
+  return lines.join("\n");
+}
 function imageOptionsLatex(block) {
   const entries = Object.entries(block.options);
   if (entries.length === 0) {
@@ -3487,23 +4666,81 @@ function imageOptionsLatex(block) {
   }
   return `[${entries.map(([key, value]) => `${key}=${value}`).join(",")}]`;
 }
-function blockLatex(block) {
+function imageBlockLatex(block) {
+  const lines = ["\\begin{figure}[htbp]"];
+  if (block.centered) {
+    lines.push("  \\centering");
+  }
+  lines.push(`  ${block.command}${imageOptionsLatex(block)}{${block.value}}`);
+  lines.push(...floatCaptionLabelLines(block));
+  lines.push("\\end{figure}");
+  return lines.join("\n");
+}
+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);
   }
   if (block.kind === "image") {
-    return `${block.command}${imageOptionsLatex(block)}{${block.value}}`;
+    return imageBlockLatex(block);
+  }
+  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 authorLatex(authors) {
+  return authors.split(/\n+/).map((line) => line.trim()).filter((line) => line.length > 0).join(" \\\\ ");
+}
+function articleFrontMatterLatex(meta) {
+  const parts = [butexDiwaniDisplayLatex(BUTEX_BASMALA)];
+  if (document2HasMaketitle(meta)) {
+    if (meta.title.trim().length > 0) {
+      parts.push(`\\title{${meta.title.trim()}}`);
+    }
+    if (meta.authors.trim().length > 0) {
+      parts.push(`\\author{${authorLatex(meta.authors)}}`);
+    }
+    parts.push(`\\date{${formatHijriDate(meta.date, { locale: "ar", digitForm: "arabicIndic" })}}`);
+    parts.push("\\maketitle");
+  }
+  if (document2HasAbstract(meta)) {
+    parts.push(`\\begin{abstract}
+${meta.abstract.trim()}
+\\end{abstract}`);
+  }
+  return parts;
+}
+function document2Latex(document2, options = {}) {
+  const meta = document2.meta ?? emptyDocument2Meta();
+  const front = articleFrontMatterLatex(meta);
+  const bodyBlocks = document2.blocks.map((block) => blockLatex(block, document2.references));
+  const closing = butexDiwaniDisplayLatex(BUTEX_CLOSING_HAMDALA);
+  const body = [...front, ...bodyBlocks, closing].filter((part) => part.length > 0).join("\n\n");
+  const wrapDocument = options.wrapDocument !== false;
+  if (!wrapDocument) {
+    return body;
+  }
+  const preamble = getArabicXeLatexPreamble({
+    digitsMapping: options.digitsMapping ?? "arabicdigits",
+    twocolumn: options.twocolumn === true
+  });
+  return `${preamble}
+\\begin{document}
+
+${body}
+
+\\end{document}
+`;
 }
 
 // src/document2/history.ts
@@ -3539,18 +4776,99 @@ function document2HistoryCanRedo(stacks) {
   return stacks.future.length > 0;
 }
 
+// src/document2/blockSelection.ts
+function emptyBlockSelection() {
+  return { selection: null, anchor: null };
+}
+function normalizeBlockSelection(selection, blockCount) {
+  if (!selection) {
+    return null;
+  }
+  const { from, to } = selection;
+  if (blockCount <= 0 || from < 0 || to < 0 || from >= blockCount || to >= blockCount || from > to) {
+    return null;
+  }
+  return { from, to };
+}
+function inRange(selection, index) {
+  return index >= selection.from && index <= selection.to;
+}
+function toggleBlockInSelection(state, index, blockCount) {
+  if (index < 0 || index >= blockCount) {
+    return state;
+  }
+  const selection = normalizeBlockSelection(state.selection, blockCount);
+  if (!selection) {
+    return { selection: { from: index, to: index }, anchor: index };
+  }
+  if (inRange(selection, index)) {
+    if (selection.from === selection.to) {
+      return emptyBlockSelection();
+    }
+    if (index === selection.from) {
+      return { selection: { from: selection.from + 1, to: selection.to }, anchor: state.anchor };
+    }
+    if (index === selection.to) {
+      return { selection: { from: selection.from, to: selection.to - 1 }, anchor: state.anchor };
+    }
+    return emptyBlockSelection();
+  }
+  if (index === selection.from - 1) {
+    return { selection: { from: index, to: selection.to }, anchor: state.anchor ?? index };
+  }
+  if (index === selection.to + 1) {
+    return { selection: { from: selection.from, to: index }, anchor: state.anchor ?? index };
+  }
+  return { selection: { from: index, to: index }, anchor: index };
+}
+function extendBlockSelectionFromAnchor(state, index, blockCount) {
+  if (index < 0 || index >= blockCount) {
+    return state;
+  }
+  const anchor = state.anchor ?? index;
+  const from = Math.min(anchor, index);
+  const to = Math.max(anchor, index);
+  return {
+    selection: { from, to },
+    anchor: state.anchor ?? index
+  };
+}
+function remapSelectionAfterRangeMove(selection, direction) {
+  return { from: selection.from + direction, to: selection.to + direction };
+}
+
 // 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
+        })
+      };
+    }
+    if (token.kind === "ref") {
+      return {
+        kind: "ref",
+        id: token.id,
+        keys: [...token.keys],
+        refCommand: token.refCommand,
+        label: formatRefLabel(token.keys, document2, token.refCommand, {
+          documentDirection: previewOptions.documentDirection,
+          digitForm: previewOptions.digitForm
+        })
+      };
+    }
     const island = {
       id: token.id,
       tex: mathTex(token, equationSide),
@@ -3562,21 +4880,43 @@ 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,
+    ...block.centered ? { centered: true } : {}
+  };
+}
+function floatNumberLabel(document2, key, previewOptions) {
+  if (!key || key.trim().length === 0) {
+    return void 0;
+  }
+  const hit = labelNumberMap(document2).get(key.trim());
+  if (!hit || hit.kind !== "fig" && hit.kind !== "tab") {
+    return void 0;
   }
-  return { kind: "paragraph", id: block.id, inlines: previewInlines(block.field, islands, output, equationSide) };
+  const locale = previewOptions.uiLocale ?? "ar";
+  const kindWord = hit.kind === "fig" ? locale === "ar" ? "\u0627\u0644\u0634\u0643\u0644" : "Figure" : locale === "ar" ? "\u0627\u0644\u062C\u062F\u0648\u0644" : "Table";
+  const digits = formatBibliographyNumber(hit.number, {
+    documentDirection: previewOptions.documentDirection,
+    digitForm: previewOptions.digitForm
+  });
+  return `${kindWord} ${digits}`;
 }
-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 {
@@ -3585,51 +4925,155 @@ 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))) };
+    const label = block.labelEnabled ? block.label.trim() : "";
+    return {
+      kind: "table",
+      id: block.id,
+      rows: block.rows.map((row) => row.map((cell) => previewInlines(cell, islands, output, equationSide, document2, previewOptions))),
+      ...block.captionEnabled && block.caption.trim().length > 0 ? { caption: block.caption.trim() } : {},
+      ...label.length > 0 ? { label, numberLabel: floatNumberLabel(document2, label, previewOptions) } : {}
+    };
   }
   if (block.kind === "image") {
-    return { kind: "image", id: block.id, src: block.value, options: block.options };
+    const label = block.labelEnabled ? block.label.trim() : "";
+    return {
+      kind: "image",
+      id: block.id,
+      src: block.value,
+      ...block.assetId !== void 0 ? { assetId: block.assetId } : {},
+      options: block.options,
+      ...block.captionEnabled && block.caption.trim().length > 0 ? { caption: block.caption.trim() } : {},
+      ...label.length > 0 ? { label, numberLabel: floatNumberLabel(document2, label, previewOptions) } : {}
+    };
+  }
+  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 articleChromePreview(document2, uiLocale, previewOptions) {
+  const meta = document2.meta ?? emptyDocument2Meta();
+  const blocks = [
+    { kind: "basmala", id: "article-basmala", text: BUTEX_BASMALA, tex: butexDiwaniDisplayTex(BUTEX_BASMALA) }
+  ];
+  if (document2HasMaketitle(meta)) {
+    blocks.push({
+      kind: "titleBlock",
+      id: "article-title",
+      ...meta.title.trim().length > 0 ? { title: meta.title.trim() } : {},
+      ...meta.authors.trim().length > 0 ? { authors: meta.authors.trim() } : {},
+      date: formatHijriDate(meta.date, {
+        locale: uiLocale,
+        digitForm: previewOptions.digitForm
+      })
+    });
+  }
+  if (document2HasAbstract(meta)) {
+    blocks.push({ kind: "abstract", id: "article-abstract", text: meta.abstract.trim() });
+  }
+  return blocks;
+}
+function document2Preview(document2, output = "svg", equationSide = "arabic", previewOptions = {}) {
   const mathIslands = [];
+  const options = {
+    documentDirection: previewOptions.documentDirection ?? "rtl",
+    digitForm: previewOptions.digitForm ?? (previewOptions.documentDirection === "ltr" ? "western" : "arabicIndic"),
+    uiLocale: previewOptions.uiLocale ?? "ar"
+  };
+  const body = document2.blocks.map((block) => blockPreview(block, mathIslands, output, equationSide, document2, options));
   return {
-    blocks: document2.blocks.map((block) => blockPreview(block, mathIslands, output, equationSide)),
+    blocks: [
+      ...articleChromePreview(document2, options.uiLocale ?? "ar", options),
+      ...body,
+      { kind: "closing", id: "article-closing", text: BUTEX_CLOSING_HAMDALA, tex: butexDiwaniDisplayTex(BUTEX_CLOSING_HAMDALA) }
+    ],
     mathIslands
   };
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUTEX_BASMALA,
+  BUTEX_CLOSING_HAMDALA,
   DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH,
+  DEFAULT_HIJRI_DATE,
+  HIJRI_MONTH_IDS,
+  HIJRI_YEAR_MAX,
+  HIJRI_YEAR_MIN,
   addDocument2ImageBlock,
   addDocument2ListBlock,
   addDocument2ListItem,
+  addDocument2Reference,
   addDocument2TableBlock,
   addDocument2TextBlock,
+  applyFloatMetaPatch,
+  arabicXeLatexPreambleCmd,
+  arabicXeLatexPreambleFont,
+  arabicXeLatexPreamblePkg,
+  bibliographyEntryLatex,
+  butexDiwaniDisplayLatex,
+  butexDiwaniDisplayTex,
+  citeTokenLatex,
+  cloneDocument2Meta,
   cloneDocument2Node,
+  collectDocument2Labels,
   createDocument2History,
   createEmptyArabicEquationSession,
   createEmptyDocument2,
   createEmptyEquationSession,
+  createEmptyReference2,
   createInlineField2,
+  defaultFloatMeta,
+  detectInlineSpans2,
   detectMathSpans2,
+  document2HasAbstract,
+  document2HasMaketitle,
+  document2HasTitleStack,
   document2HistoryCanRedo,
   document2HistoryCanUndo,
   document2Latex,
   document2Preview,
+  emptyBlockSelection,
+  emptyDocument2Meta,
+  ensureDocument2BibliographyBlock,
+  extendBlockSelectionFromAnchor,
+  fillDocument2MetaGaps,
   findFirstInlineField,
+  formatBibliographyNumber,
+  formatCiteLabel,
+  formatHijriDate,
+  formatRefLabel,
   fromDocumentJson2,
+  getArabicXeLatexPreamble,
+  hijriMonthLabel,
   inlineFieldLatex,
+  insertCiteTokenAtCaret,
   insertDocument2BlockAfter,
   insertMathToken,
   insertMathTokenAtCaret,
+  insertRefTokenAtCaret,
+  labelNumberMap,
   mathNodeFromArabicSession,
   mathNodeFromSession,
   mathSourceFromArabicSession,
@@ -3637,15 +5081,44 @@ function document2Preview(document2, output = "svg", equationSide = "arabic") {
   mathTokenSourceForSide,
   mathTokenToArabicEditorSession,
   mathTokenToEditorSession,
+  mergeDocument2Meta,
   moveDocument2BlockById,
+  moveDocument2BlockRange,
+  moveDocument2Reference,
+  normalizeBlockSelection,
+  normalizeDocument2HijriDate,
+  normalizeDocument2Meta,
+  parseCiteKeys,
+  parseFloatMetaFromJson,
+  parseRefKeys,
   pushDocument2Snapshot,
+  refTokenLatex,
+  referenceFromJson,
+  referenceNumberMap,
+  remapSelectionAfterRangeMove,
+  removeCiteTokenById,
   removeDocument2BlockById,
+  removeDocument2BlockRange,
   removeDocument2ListItem,
+  removeDocument2Reference,
   removeMathTokenById,
+  removeRefTokenById,
   replaceMathTokenFromSession,
+  resolveCiteNumbers,
   restoreDocument2Redo,
   restoreDocument2Undo,
+  setDocument2References,
+  stripDisplayMathDelimiters,
+  toggleBlockInSelection,
+  updateCiteTokenKeys,
+  updateDocument2ImageMeta,
   updateDocument2ImageValue,
+  updateDocument2Meta,
+  updateDocument2Reference,
+  updateDocument2TableMeta,
+  updateDocument2TextBlockCentered,
+  updateMathTokenLabel,
+  updateRefTokenKeys,
   updateTextToken
 });
 //# sourceMappingURL=document2.js.map