@drghaliasri/butex 5.3.1 → 5.3.3

package/dist/document2.mjs

@@ -268,6 +268,10 @@ function cloneDocument2Meta(meta) {
 }
 
 // src/document2/citations.ts
+var DEFAULT_REFERENCE_FIELD_SEPARATOR = "\u060C";
+function normalizeReferenceFieldSeparator(value) {
+  return value === "," ? "," : DEFAULT_REFERENCE_FIELD_SEPARATOR;
+}
 function referenceNumberMap(references) {
   const map = /* @__PURE__ */ new Map();
   references.forEach((reference, index) => {
@@ -313,7 +317,8 @@ function referenceFromJson(json) {
     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 : ""
+    venue: typeof json.venue === "string" ? json.venue : "",
+    fieldSeparator: normalizeReferenceFieldSeparator(json.field_separator)
   };
 }
 function createEmptyReference2(partial = {}) {
@@ -323,15 +328,33 @@ function createEmptyReference2(partial = {}) {
     title: partial.title,
     year: partial.year,
     url: partial.url,
-    venue: partial.venue
+    venue: partial.venue,
+    field_separator: partial.field_separator
   });
 }
+function bibliographyEntryBody(reference, separator = reference.fieldSeparator, options = {}) {
+  const year = options.digitForm !== void 0 ? formatDigits(reference.year, options.digitForm) : reference.year;
+  const parts = [reference.authors, reference.title, reference.venue, year].filter((part) => part.trim().length > 0);
+  return parts.join(`${separator} `);
+}
 function bibliographyEntryLatex(reference) {
-  const parts = [reference.authors, reference.title, reference.venue, reference.year].filter((part) => part.trim().length > 0);
-  const body = parts.join(", ");
+  const body = bibliographyEntryBody(reference);
   const url = reference.url.trim().length > 0 ? ` \\url{${reference.url}}` : "";
   return `\\bibitem{${reference.key}} ${body}${url}`.trim();
 }
+function absoluteHttpHref(url) {
+  const trimmed = url.trim();
+  if (trimmed.length === 0) {
+    return "";
+  }
+  if (/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(trimmed)) {
+    return trimmed;
+  }
+  if (trimmed.startsWith("//")) {
+    return `https:${trimmed}`;
+  }
+  return `https://${trimmed}`;
+}
 
 // src/ast/commands/index.ts
 function renderCommandCore(context) {
@@ -816,6 +839,23 @@ function labelNumberMap(document2) {
   }
   return map;
 }
+function formatFloatCaptionTitle(kind, number, options = {}) {
+  const locale = options.uiLocale ?? "ar";
+  const kindWord = kind === "fig" ? locale === "ar" ? "\u0627\u0644\u0634\u0643\u0644" : "Figure" : kind === "tab" ? locale === "ar" ? "\u0627\u0644\u062C\u062F\u0648\u0644" : "Table" : locale === "ar" ? "\u0627\u0644\u0645\u0639\u0627\u062F\u0644\u0629" : "Equation";
+  const digits = formatBibliographyNumber(number, {
+    documentDirection: options.documentDirection ?? (locale === "ar" ? "rtl" : "ltr"),
+    digitForm: options.digitForm ?? (locale === "ar" ? "arabicIndic" : "western")
+  });
+  return `${kindWord} ${digits}`;
+}
+function formatFloatCaptionPreview(title, caption, uiLocale = "ar") {
+  const trimmed = caption?.trim() ?? "";
+  if (trimmed.length === 0) {
+    return title;
+  }
+  const separator = uiLocale === "ar" ? ": " : ". ";
+  return `${title}${separator}${trimmed}`;
+}
 function formatRefLabel(keys, document2, refCommand, options = {}) {
   const documentDirection = options.documentDirection ?? "rtl";
   const digitForm = options.digitForm ?? (documentDirection === "rtl" ? "arabicIndic" : "western");
@@ -1086,7 +1126,8 @@ function parseReferences(json) {
         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
+        venue: typeof entry.venue === "string" ? entry.venue : void 0,
+        field_separator: entry.field_separator === "," || entry.field_separator === "\u060C" ? entry.field_separator : void 0
       })
     );
   }
@@ -1726,7 +1767,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     id: "neq",
     category: "operators1",
     Tex: "\\neq",
-    mirror: false,
+    mirror: true,
     Label: "\u2260",
     title: "\u0644\u0627 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1736,6 +1777,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\approx",
     mirror: false,
+    displayMirror: true,
     Label: "\u2248",
     title: "\u062A\u0642\u0631\u064A\u0628\u0627 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1745,6 +1787,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\sim",
     mirror: false,
+    displayMirror: true,
     Label: "\u223C",
     title: "\u0645\u0634\u0627\u0628\u0647",
     svg_path: null
@@ -1763,6 +1806,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\leq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2264",
     title: "\u0623\u0635\u063A\u0631 \u0645\u0646 \u0623\u0648 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1772,6 +1816,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\geq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2265",
     title: "\u0623\u0643\u0628\u0631 \u0645\u0646 \u0623\u0648 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1781,6 +1826,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\coloneqq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2254",
     title: "\u064A\u0639\u0631\u0641 \u0628\u0623\u0646\u0647 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1790,6 +1836,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\eqqcolon",
     mirror: true,
+    displayMirror: false,
     Label: "\u2255",
     title: "\u064A\u0633\u0627\u0648\u064A \u0628\u0627\u0644\u062A\u0639\u0631\u064A\u0641",
     svg_path: null
@@ -1800,6 +1847,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\propto",
     mirror: true,
+    displayMirror: false,
     Label: "\u221D",
     title: "\u064A\u062A\u0646\u0627\u0633\u0628 \u0645\u0639",
     svg_path: null
@@ -1809,6 +1857,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\in",
     mirror: true,
+    displayMirror: false,
     Label: "\u2208",
     title: "\u064A\u0646\u062A\u0645\u064A \u0625\u0644\u0649",
     svg_path: null
@@ -1818,6 +1867,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\notin",
     mirror: false,
+    displayMirror: true,
     Label: "\u2209",
     title: "\u0644\u0627 \u064A\u0646\u062A\u0645\u064A \u0625\u0644\u0649",
     svg_path: null
@@ -1827,6 +1877,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\subset",
     mirror: true,
+    displayMirror: false,
     Label: "\u2282",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u062C\u0632\u0626\u064A\u0629 \u0645\u0646",
     svg_path: null
@@ -1836,6 +1887,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\supset",
     mirror: true,
+    displayMirror: false,
     Label: "\u2283",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u0634\u0627\u0645\u0644\u0629 \u0644\u0640",
     svg_path: null
@@ -1845,6 +1897,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\subseteq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2286",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u062C\u0632\u0626\u064A\u0629 \u0623\u0648 \u062A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1854,6 +1907,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\supseteq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2287",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u0634\u0627\u0645\u0644\u0629 \u0623\u0648 \u062A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1863,6 +1917,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\cap",
     mirror: false,
+    displayMirror: true,
     Label: "\u2229",
     title: "\u062A\u0642\u0627\u0637\u0639",
     svg_path: null
@@ -1872,6 +1927,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\cup",
     mirror: false,
+    displayMirror: true,
     Label: "\u222A",
     title: "\u0627\u062A\u062D\u0627\u062F",
     svg_path: null
@@ -1881,6 +1937,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\emptyset",
     mirror: false,
+    displayMirror: true,
     Label: "\u2205",
     title: "\u0627\u0644\u0645\u062C\u0645\u0648\u0639\u0629 \u0627\u0644\u062E\u0627\u0644\u064A\u0629",
     svg_path: null
@@ -1890,6 +1947,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\nsubseteq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2288",
     title: "\u0644\u064A\u0633\u062A \u0645\u062C\u0645\u0648\u0639\u0629 \u062C\u0632\u0626\u064A\u0629 \u0623\u0648 \u062A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -1899,6 +1957,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\nsupseteq",
     mirror: true,
+    displayMirror: false,
     Label: "\u2289",
     title: "\u0644\u064A\u0633\u062A \u0645\u062C\u0645\u0648\u0639\u0629 \u0634\u0627\u0645\u0644\u0629 \u0623\u0648 \u062A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2110,6 +2169,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\iint",
     mirror: true,
+    displayMirror: false,
     Label: "\u222C",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0645\u0632\u062F\u0648\u062C",
     svg_path: null
@@ -2119,6 +2179,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\iiint",
     mirror: true,
+    displayMirror: false,
     Label: "\u222D",
     title: "\u062A\u0643\u0627\u0645\u0644 \u062B\u0644\u0627\u062B\u064A",
     svg_path: null
@@ -2128,6 +2189,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\iiiint",
     mirror: true,
+    displayMirror: false,
     Label: "\u2A0C",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0631\u0628\u0627\u0639\u064A",
     svg_path: null
@@ -2137,6 +2199,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\oint",
     mirror: true,
+    displayMirror: false,
     Label: "\u222E",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0645\u063A\u0644\u0642",
     svg_path: null
@@ -2146,6 +2209,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\oiint",
     mirror: true,
+    displayMirror: false,
     Label: "\u222F",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0633\u0637\u062D\u064A \u0645\u063A\u0644\u0642",
     svg_path: null
@@ -2155,6 +2219,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\oiiint",
     mirror: true,
+    displayMirror: false,
     Label: "\u2230",
     title: "\u062A\u0643\u0627\u0645\u0644 \u062D\u062C\u0645\u064A \u0645\u063A\u0644\u0642",
     svg_path: null
@@ -4268,6 +4333,9 @@ function updateDocument2Reference(document2, referenceId, patch) {
   if (typeof patch.venue === "string") {
     reference.venue = patch.venue;
   }
+  if (patch.field_separator === "," || patch.field_separator === "\u060C") {
+    reference.fieldSeparator = patch.field_separator;
+  }
   return next;
 }
 function removeDocument2Reference(document2, referenceId) {
@@ -4306,6 +4374,52 @@ function updateDocument2Meta(document2, patch) {
   return next;
 }
 
+// src/document2/keys.ts
+var DOCUMENT2_KEY_PATTERN = /^[\p{L}\p{M}0-9:._-]+$/u;
+function normalizeDocument2Key(key) {
+  return key.normalize("NFC").trim();
+}
+function isValidDocument2Key(key) {
+  const normalized = normalizeDocument2Key(key);
+  return normalized.length > 0 && DOCUMENT2_KEY_PATTERN.test(normalized);
+}
+function isDuplicateDocument2Key(key, namespace) {
+  const normalized = normalizeDocument2Key(key);
+  if (normalized.length === 0) {
+    return false;
+  }
+  for (const reference of namespace.references ?? []) {
+    if (namespace.excludeReferenceId && reference.id === namespace.excludeReferenceId) {
+      continue;
+    }
+    if (normalizeDocument2Key(reference.key) === normalized) {
+      return true;
+    }
+  }
+  for (const label of namespace.labels ?? []) {
+    if (namespace.excludeOwnerId && label.ownerId === namespace.excludeOwnerId) {
+      continue;
+    }
+    if (normalizeDocument2Key(label.key) === normalized) {
+      return true;
+    }
+  }
+  return false;
+}
+function document2KeyError(key, namespace = {}) {
+  const normalized = normalizeDocument2Key(key);
+  if (normalized.length === 0) {
+    return "empty";
+  }
+  if (!DOCUMENT2_KEY_PATTERN.test(normalized)) {
+    return "invalid";
+  }
+  if (isDuplicateDocument2Key(normalized, namespace)) {
+    return "duplicate";
+  }
+  return null;
+}
+
 // src/document2/arabicPreamble.ts
 function arabicXeLatexPreamblePkg(twocolumn = false) {
   const classOptions = twocolumn ? "12pt,a4paper,notitlepage,twocolumn" : "12pt,a4paper,notitlepage";
@@ -4856,13 +4970,11 @@ function floatNumberLabel(document2, key, previewOptions) {
   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, {
+  return formatFloatCaptionTitle(hit.kind, hit.number, {
+    uiLocale: previewOptions.uiLocale ?? "ar",
     documentDirection: previewOptions.documentDirection,
     digitForm: previewOptions.digitForm
   });
-  return `${kindWord} ${digits}`;
 }
 function blockPreview(block, islands, output, equationSide, document2, previewOptions) {
   if (block.kind === "textBlock") {
@@ -4917,7 +5029,8 @@ function blockPreview(block, islands, output, equationSide, document2, previewOp
         title: reference.title,
         year: reference.year,
         url: reference.url,
-        venue: reference.venue
+        venue: reference.venue,
+        fieldSeparator: reference.fieldSeparator
       }))
     };
   }
@@ -4970,9 +5083,11 @@ export {
   BUTEX_CLOSING_HAMDALA,
   DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH,
   DEFAULT_HIJRI_DATE,
+  DEFAULT_REFERENCE_FIELD_SEPARATOR,
   HIJRI_MONTH_IDS,
   HIJRI_YEAR_MAX,
   HIJRI_YEAR_MIN,
+  absoluteHttpHref,
   addDocument2ImageBlock,
   addDocument2ListBlock,
   addDocument2ListItem,
@@ -4983,6 +5098,7 @@ export {
   arabicXeLatexPreambleCmd,
   arabicXeLatexPreambleFont,
   arabicXeLatexPreamblePkg,
+  bibliographyEntryBody,
   bibliographyEntryLatex,
   butexBasmalaDisplayLatex,
   butexBasmalaDisplayTex,
@@ -5008,6 +5124,7 @@ export {
   document2HasTitleStack,
   document2HistoryCanRedo,
   document2HistoryCanUndo,
+  document2KeyError,
   document2Latex,
   document2Preview,
   emptyBlockSelection,
@@ -5018,6 +5135,8 @@ export {
   findFirstInlineField,
   formatBibliographyNumber,
   formatCiteLabel,
+  formatFloatCaptionPreview,
+  formatFloatCaptionTitle,
   formatHijriDate,
   formatRefLabel,
   fromDocumentJson2,
@@ -5029,6 +5148,8 @@ export {
   insertMathToken,
   insertMathTokenAtCaret,
   insertRefTokenAtCaret,
+  isDuplicateDocument2Key,
+  isValidDocument2Key,
   labelNumberMap,
   mathNodeFromArabicSession,
   mathNodeFromSession,
@@ -5043,7 +5164,9 @@ export {
   moveDocument2Reference,
   normalizeBlockSelection,
   normalizeDocument2HijriDate,
+  normalizeDocument2Key,
   normalizeDocument2Meta,
+  normalizeReferenceFieldSeparator,
   parseCiteKeys,
   parseFloatMetaFromJson,
   parseRefKeys,