@drghaliasri/butex 5.0.0 → 5.2.0

package/dist/document2.mjs

@@ -34,6 +34,179 @@ function formatDigits(value, digitForm = "western") {
   }).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();
@@ -469,6 +642,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",
@@ -544,6 +879,43 @@ function citeSpan(value, start) {
   }
   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 (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 };
+      }
+    }
+  }
+  return null;
+}
 function mathSpanAt(value, i) {
   if (value.startsWith("\\begin{", i)) {
     return environmentSpan(value, i);
@@ -591,6 +963,12 @@ function detectInlineSpans2(value) {
       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 });
@@ -677,6 +1055,16 @@ function createInlineField2(value = "", mathObjects = [], options = {}, path = "
       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)) {
@@ -725,7 +1113,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) {
@@ -778,7 +1167,8 @@ 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) {
@@ -790,7 +1180,8 @@ function parseImageBlock(json) {
     command: "\\includegraphics",
     value,
     ...assetId !== void 0 ? { assetId } : {},
-    options: isRecordOfStrings(json.options) ? json.options : {}
+    options: isRecordOfStrings(json.options) ? json.options : {},
+    ...parseFloatMetaFromJson(json)
   };
 }
 function parseRawBlock(json) {
@@ -845,13 +1236,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", references: [], blocks: [], diagnostics: [] };
+  return {
+    nodeType: "DocumentObject",
+    meta: emptyDocument2Meta(),
+    references: [],
+    blocks: [],
+    diagnostics: []
+  };
 }
 
 // src/editor/atomicCommands.ts
@@ -3206,6 +3604,7 @@ 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 }))
@@ -3316,6 +3715,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: "" }];
@@ -3410,16 +3832,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;
+    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);
@@ -3456,7 +3912,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);
 }
@@ -3466,7 +3923,8 @@ function addDocument2ImageBlock(document2, src = "", afterBlockId) {
     kind: "image",
     command: "\\includegraphics",
     value: src,
-    options: {}
+    options: { width: "0.8\\textwidth" },
+    ...defaultFloatMeta()
   };
   return insertDocument2BlockAfter(document2, afterBlockId, block);
 }
@@ -3491,6 +3949,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") {
@@ -3654,12 +4234,24 @@ function setDocument2References(document2, references) {
   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() {
-  return String.raw`
-\documentclass[12pt,a4paper]{article}
-\usepackage{amsmath,amsfonts,amssymb,mathrsfs,tikz,fancyhdr, mathtools}
+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
@@ -3849,11 +4441,21 @@ function arabicXeLatexPreambleCmd() {
 \newcommand{\arbinom}[2]{\left(\begin{array}{c} #1 \\ #2 \end{array} \right)}
 `;
 }
-function getArabicXeLatexPreamble(digitsMapping = "arabicdigits") {
-  return arabicXeLatexPreamblePkg() + arabicXeLatexPreambleFont(digitsMapping) + arabicXeLatexPreambleCmd();
+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;
@@ -3861,6 +4463,16 @@ function tokenLatex(token) {
   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;
   }
@@ -3870,7 +4482,13 @@ 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");
@@ -3884,12 +4502,32 @@ function listBlockLatex(block, references) {
 ${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) {
@@ -3897,6 +4535,16 @@ function imageOptionsLatex(block) {
   }
   return `[${entries.map(([key, value]) => `${key}=${value}`).join(",")}]`;
 }
+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);
@@ -3908,7 +4556,7 @@ function blockLatex(block, references) {
     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));
@@ -3919,13 +4567,42 @@ ${block.closing}`;
   }
   return block.value;
 }
+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 body = document2.blocks.map((block) => blockLatex(block, document2.references)).join("\n\n");
+  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(options.digitsMapping ?? "arabicdigits");
+  const preamble = getArabicXeLatexPreamble({
+    digitsMapping: options.digitsMapping ?? "arabicdigits",
+    twocolumn: options.twocolumn === true
+  });
   return `${preamble}
 \\begin{document}
 
@@ -3968,6 +4645,67 @@ 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) {
   return mathTokenSourceForSide(token, equationSide);
@@ -3988,6 +4726,18 @@ function previewInlines(field, islands, output, equationSide, document2, preview
         })
       };
     }
+    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),
@@ -4010,7 +4760,28 @@ function textBlockPreview(block, islands, output, equationSide, document2, previ
   if (block.command === "\\subsubsection") {
     return { kind: "heading", id: block.id, level: 3, inlines };
   }
-  return { kind: "paragraph", id: block.id, 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;
+  }
+  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, document2, previewOptions) {
   if (block.kind === "textBlock") {
@@ -4029,19 +4800,25 @@ function blockPreview(block, islands, output, equationSide, document2, previewOp
     };
   }
   if (block.kind === "table") {
+    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)))
+      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") {
+    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
+      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") {
@@ -4065,54 +4842,106 @@ function blockPreview(block, islands, output, equationSide, document2, previewOp
   }
   return { kind: "omit", id: block.id };
 }
+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")
+    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, document2, options)),
+    blocks: [
+      ...articleChromePreview(document2, options.uiLocale ?? "ar", options),
+      ...body,
+      { kind: "closing", id: "article-closing", text: BUTEX_CLOSING_HAMDALA, tex: butexDiwaniDisplayTex(BUTEX_CLOSING_HAMDALA) }
+    ],
     mathIslands
   };
 }
 export {
+  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,
@@ -4120,25 +4949,44 @@ export {
   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.mjs.map