@drghaliasri/butex 5.3.1 → 5.3.2

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
       })
     );
   }
@@ -4406,6 +4457,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 +4498,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 +5094,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 +5153,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 +5208,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 +5223,7 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   arabicXeLatexPreambleCmd,
   arabicXeLatexPreambleFont,
   arabicXeLatexPreamblePkg,
+  bibliographyEntryBody,
   bibliographyEntryLatex,
   butexBasmalaDisplayLatex,
   butexBasmalaDisplayTex,
@@ -5147,6 +5249,7 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   document2HasTitleStack,
   document2HistoryCanRedo,
   document2HistoryCanUndo,
+  document2KeyError,
   document2Latex,
   document2Preview,
   emptyBlockSelection,
@@ -5157,6 +5260,8 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   findFirstInlineField,
   formatBibliographyNumber,
   formatCiteLabel,
+  formatFloatCaptionPreview,
+  formatFloatCaptionTitle,
   formatHijriDate,
   formatRefLabel,
   fromDocumentJson2,
@@ -5168,6 +5273,8 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   insertMathToken,
   insertMathTokenAtCaret,
   insertRefTokenAtCaret,
+  isDuplicateDocument2Key,
+  isValidDocument2Key,
   labelNumberMap,
   mathNodeFromArabicSession,
   mathNodeFromSession,
@@ -5182,7 +5289,9 @@ function document2Preview(document2, output = "svg", equationSide = "arabic", pr
   moveDocument2Reference,
   normalizeBlockSelection,
   normalizeDocument2HijriDate,
+  normalizeDocument2Key,
   normalizeDocument2Meta,
+  normalizeReferenceFieldSeparator,
   parseCiteKeys,
   parseFloatMetaFromJson,
   parseRefKeys,