@drghaliasri/butex 5.3.1 → 5.3.3

package/dist/document2.js

@@ -27,9 +27,11 @@ __export(document2_exports, {
   BUTEX_CLOSING_HAMDALA: () => BUTEX_CLOSING_HAMDALA,
   DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH: () => DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH,
   DEFAULT_HIJRI_DATE: () => DEFAULT_HIJRI_DATE,
+  DEFAULT_REFERENCE_FIELD_SEPARATOR: () => DEFAULT_REFERENCE_FIELD_SEPARATOR,
   HIJRI_MONTH_IDS: () => HIJRI_MONTH_IDS,
   HIJRI_YEAR_MAX: () => HIJRI_YEAR_MAX,
   HIJRI_YEAR_MIN: () => HIJRI_YEAR_MIN,
+  absoluteHttpHref: () => absoluteHttpHref,
   addDocument2ImageBlock: () => addDocument2ImageBlock,
   addDocument2ListBlock: () => addDocument2ListBlock,
   addDocument2ListItem: () => addDocument2ListItem,
@@ -40,6 +42,7 @@ __export(document2_exports, {
   arabicXeLatexPreambleCmd: () => arabicXeLatexPreambleCmd,
   arabicXeLatexPreambleFont: () => arabicXeLatexPreambleFont,
   arabicXeLatexPreamblePkg: () => arabicXeLatexPreamblePkg,
+  bibliographyEntryBody: () => bibliographyEntryBody,
   bibliographyEntryLatex: () => bibliographyEntryLatex,
   butexBasmalaDisplayLatex: () => butexBasmalaDisplayLatex,
   butexBasmalaDisplayTex: () => butexBasmalaDisplayTex,
@@ -65,6 +68,7 @@ __export(document2_exports, {
   document2HasTitleStack: () => document2HasTitleStack,
   document2HistoryCanRedo: () => document2HistoryCanRedo,
   document2HistoryCanUndo: () => document2HistoryCanUndo,
+  document2KeyError: () => document2KeyError,
   document2Latex: () => document2Latex,
   document2Preview: () => document2Preview,
   emptyBlockSelection: () => emptyBlockSelection,
@@ -75,6 +79,8 @@ __export(document2_exports, {
   findFirstInlineField: () => findFirstInlineField,
   formatBibliographyNumber: () => formatBibliographyNumber,
   formatCiteLabel: () => formatCiteLabel,
+  formatFloatCaptionPreview: () => formatFloatCaptionPreview,
+  formatFloatCaptionTitle: () => formatFloatCaptionTitle,
   formatHijriDate: () => formatHijriDate,
   formatRefLabel: () => formatRefLabel,
   fromDocumentJson2: () => fromDocumentJson2,
@@ -86,6 +92,8 @@ __export(document2_exports, {
   insertMathToken: () => insertMathToken,
   insertMathTokenAtCaret: () => insertMathTokenAtCaret,
   insertRefTokenAtCaret: () => insertRefTokenAtCaret,
+  isDuplicateDocument2Key: () => isDuplicateDocument2Key,
+  isValidDocument2Key: () => isValidDocument2Key,
   labelNumberMap: () => labelNumberMap,
   mathNodeFromArabicSession: () => mathNodeFromArabicSession,
   mathNodeFromSession: () => mathNodeFromSession,
@@ -100,7 +108,9 @@ __export(document2_exports, {
   moveDocument2Reference: () => moveDocument2Reference,
   normalizeBlockSelection: () => normalizeBlockSelection,
   normalizeDocument2HijriDate: () => normalizeDocument2HijriDate,
+  normalizeDocument2Key: () => normalizeDocument2Key,
   normalizeDocument2Meta: () => normalizeDocument2Meta,
+  normalizeReferenceFieldSeparator: () => normalizeReferenceFieldSeparator,
   parseCiteKeys: () => parseCiteKeys,
   parseFloatMetaFromJson: () => parseFloatMetaFromJson,
   parseRefKeys: () => parseRefKeys,
@@ -406,6 +416,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) => {
@@ -451,7 +465,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 = {}) {
@@ -461,15 +476,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) {
@@ -954,6 +987,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");
@@ -1224,7 +1274,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
       })
     );
   }
@@ -1864,7 +1915,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
@@ -1874,6 +1925,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
@@ -1883,6 +1935,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\sim",
     mirror: false,
+    displayMirror: true,
     Label: "\u223C",
     title: "\u0645\u0634\u0627\u0628\u0647",
     svg_path: null
@@ -1901,6 +1954,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
@@ -1910,6 +1964,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
@@ -1919,6 +1974,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
@@ -1928,6 +1984,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
@@ -1938,6 +1995,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
@@ -1947,6 +2005,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
@@ -1956,6 +2015,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
@@ -1965,6 +2025,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
@@ -1974,6 +2035,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
@@ -1983,6 +2045,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
@@ -1992,6 +2055,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
@@ -2001,6 +2065,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\cap",
     mirror: false,
+    displayMirror: true,
     Label: "\u2229",
     title: "\u062A\u0642\u0627\u0637\u0639",
     svg_path: null
@@ -2010,6 +2075,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators2",
     Tex: "\\cup",
     mirror: false,
+    displayMirror: true,
     Label: "\u222A",
     title: "\u0627\u062A\u062D\u0627\u062F",
     svg_path: null
@@ -2019,6 +2085,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
@@ -2028,6 +2095,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
@@ -2037,6 +2105,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
@@ -2248,6 +2317,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
@@ -2257,6 +2327,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
@@ -2266,6 +2337,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
@@ -2275,6 +2347,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
@@ -2284,6 +2357,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
@@ -2293,6 +2367,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
@@ -4406,6 +4481,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) {
@@ -4444,6 +4522,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";
@@ -4994,13 +5118,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") {
@@ -5055,7 +5177,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
       }))
     };
   }
@@ -5109,9 +5232,11 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   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,
@@ -5122,6 +5247,7 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   arabicXeLatexPreambleCmd,
   arabicXeLatexPreambleFont,
   arabicXeLatexPreamblePkg,
+  bibliographyEntryBody,
   bibliographyEntryLatex,
   butexBasmalaDisplayLatex,
   butexBasmalaDisplayTex,
@@ -5147,6 +5273,7 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   document2HasTitleStack,
   document2HistoryCanRedo,
   document2HistoryCanUndo,
+  document2KeyError,
   document2Latex,
   document2Preview,
   emptyBlockSelection,
@@ -5157,6 +5284,8 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   findFirstInlineField,
   formatBibliographyNumber,
   formatCiteLabel,
+  formatFloatCaptionPreview,
+  formatFloatCaptionTitle,
   formatHijriDate,
   formatRefLabel,
   fromDocumentJson2,
@@ -5168,6 +5297,8 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   insertMathToken,
   insertMathTokenAtCaret,
   insertRefTokenAtCaret,
+  isDuplicateDocument2Key,
+  isValidDocument2Key,
   labelNumberMap,
   mathNodeFromArabicSession,
   mathNodeFromSession,
@@ -5182,7 +5313,9 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   moveDocument2Reference,
   normalizeBlockSelection,
   normalizeDocument2HijriDate,
+  normalizeDocument2Key,
   normalizeDocument2Meta,
+  normalizeReferenceFieldSeparator,
   parseCiteKeys,
   parseFloatMetaFromJson,
   parseRefKeys,