@drghaliasri/butex 5.5.5 → 5.6.0

package/dist/react-document2.mjs

@@ -65,7 +65,9 @@ function butexBasmalaDisplayTex() {
 }
 function butexBasmalaDisplayLatex() {
   return `\\[
-${butexBasmalaDisplayTex()}
+\\begin{gathered}
+${BASMALA_LINES.map((line) => butexMaghribiDisplayTex(line)).join(" \\\\\n")}
+\\end{gathered}
 \\]`;
 }
 function butexInColumnMaketitleHook() {
@@ -2067,6 +2069,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators1",
     Tex: "\\neq",
     mirror: true,
+    compileMirror: true,
     Label: "\u2260",
     title: "\u0644\u0627 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2106,6 +2109,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\leq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2264",
     title: "\u0623\u0635\u063A\u0631 \u0645\u0646 \u0623\u0648 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2116,6 +2120,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\geq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2265",
     title: "\u0623\u0643\u0628\u0631 \u0645\u0646 \u0623\u0648 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2126,6 +2131,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\coloneqq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2254",
     title: "\u064A\u0639\u0631\u0641 \u0628\u0623\u0646\u0647 \u064A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2136,6 +2142,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\eqqcolon",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2255",
     title: "\u064A\u0633\u0627\u0648\u064A \u0628\u0627\u0644\u062A\u0639\u0631\u064A\u0641",
     svg_path: null
@@ -2147,6 +2154,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\propto",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u221D",
     title: "\u064A\u062A\u0646\u0627\u0633\u0628 \u0645\u0639",
     svg_path: null
@@ -2157,6 +2165,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\in",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2208",
     title: "\u064A\u0646\u062A\u0645\u064A \u0625\u0644\u0649",
     svg_path: null
@@ -2177,6 +2186,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\subset",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2282",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u062C\u0632\u0626\u064A\u0629 \u0645\u0646",
     svg_path: null
@@ -2187,6 +2197,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\supset",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2283",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u0634\u0627\u0645\u0644\u0629 \u0644\u0640",
     svg_path: null
@@ -2197,6 +2208,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\subseteq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2286",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u062C\u0632\u0626\u064A\u0629 \u0623\u0648 \u062A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2207,6 +2219,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\supseteq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2287",
     title: "\u0645\u062C\u0645\u0648\u0639\u0629 \u0634\u0627\u0645\u0644\u0629 \u0623\u0648 \u062A\u0633\u0627\u0648\u064A",
     svg_path: null
@@ -2247,6 +2260,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\nsubseteq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     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
@@ -2257,6 +2271,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\nsupseteq",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     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
@@ -2304,6 +2319,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\ddots",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u22F1",
     title: "\u0646\u0642\u0627\u0637 \u0642\u0637\u0631\u064A\u0629",
     svg_path: null
@@ -2323,6 +2339,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\implies",
     mirror: true,
+    compileMirror: true,
     Label: "\u21D2",
     title: "\u064A\u0633\u062A\u0644\u0632\u0645",
     svg_path: null
@@ -2332,6 +2349,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\impliedby",
     mirror: true,
+    compileMirror: true,
     Label: "\u21D0",
     title: "\u0645\u0633\u062A\u0644\u0632\u0645 \u0645\u0646",
     svg_path: null
@@ -2350,6 +2368,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\Longrightarrow",
     mirror: true,
+    compileMirror: true,
     Label: "\u27F9",
     title: "\u0633\u0647\u0645 \u0645\u0632\u062F\u0648\u062C \u0637\u0648\u064A\u0644 \u0625\u0644\u0649 \u0627\u0644\u064A\u0645\u064A\u0646",
     svg_path: null
@@ -2359,6 +2378,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\Longleftarrow",
     mirror: true,
+    compileMirror: true,
     Label: "\u27F8",
     title: "\u0633\u0647\u0645 \u0645\u0632\u062F\u0648\u062C \u0637\u0648\u064A\u0644 \u0625\u0644\u0649 \u0627\u0644\u064A\u0633\u0627\u0631",
     svg_path: null
@@ -2368,6 +2388,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\to",
     mirror: true,
+    compileMirror: true,
     Label: "\u2192",
     title: "\u064A\u0624\u0648\u0644 \u0625\u0644\u0649",
     svg_path: null
@@ -2377,6 +2398,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\rightleftharpoons",
     mirror: true,
+    compileMirror: true,
     Label: "\u21CC",
     title: "\u0627\u062A\u0632\u0627\u0646",
     svg_path: null
@@ -2386,6 +2408,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\leftarrow",
     mirror: true,
+    compileMirror: true,
     Label: "\u2190",
     title: "\u0633\u0647\u0645 \u0625\u0644\u0649 \u0627\u0644\u064A\u0633\u0627\u0631",
     svg_path: null
@@ -2395,6 +2418,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\rightarrow",
     mirror: true,
+    compileMirror: true,
     Label: "\u2192",
     title: "\u0633\u0647\u0645 \u0625\u0644\u0649 \u0627\u0644\u064A\u0645\u064A\u0646",
     svg_path: null
@@ -2404,6 +2428,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\Leftarrow",
     mirror: true,
+    compileMirror: true,
     Label: "\u21D0",
     title: "\u0633\u0647\u0645 \u0645\u0632\u062F\u0648\u062C \u0625\u0644\u0649 \u0627\u0644\u064A\u0633\u0627\u0631",
     svg_path: null
@@ -2413,6 +2438,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\Rightarrow",
     mirror: true,
+    compileMirror: true,
     Label: "\u21D2",
     title: "\u0633\u0647\u0645 \u0645\u0632\u062F\u0648\u062C \u0625\u0644\u0649 \u0627\u0644\u064A\u0645\u064A\u0646",
     svg_path: null
@@ -2422,6 +2448,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\leftharpoonup",
     mirror: true,
+    compileMirror: true,
     Label: "\u21BC",
     title: "\u0633\u0647\u0645 \u062E\u0637\u0627\u0641\u064A \u0639\u0644\u0648\u064A \u0625\u0644\u0649 \u0627\u0644\u064A\u0633\u0627\u0631",
     svg_path: null
@@ -2431,6 +2458,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\rightharpoonup",
     mirror: true,
+    compileMirror: true,
     Label: "\u21C0",
     title: "\u0633\u0647\u0645 \u062E\u0637\u0627\u0641\u064A \u0639\u0644\u0648\u064A \u0625\u0644\u0649 \u0627\u0644\u064A\u0645\u064A\u0646",
     svg_path: null
@@ -2440,6 +2468,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\leftharpoondown",
     mirror: true,
+    compileMirror: true,
     Label: "\u21BD",
     title: "\u0633\u0647\u0645 \u062E\u0637\u0627\u0641\u064A \u0633\u0641\u0644\u064A \u0625\u0644\u0649 \u0627\u0644\u064A\u0633\u0627\u0631",
     svg_path: null
@@ -2449,6 +2478,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "operators3",
     Tex: "\\rightharpoondown",
     mirror: true,
+    compileMirror: true,
     Label: "\u21C1",
     title: "\u0633\u0647\u0645 \u062E\u0637\u0627\u0641\u064A \u0633\u0641\u0644\u064A \u0625\u0644\u0649 \u0627\u0644\u064A\u0645\u064A\u0646",
     svg_path: null
@@ -2459,6 +2489,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     category: "integrals",
     Tex: "\\int",
     mirror: true,
+    compileMirror: true,
     Label: "\u222B",
     title: "\u062A\u0643\u0627\u0645\u0644",
     svg_path: null
@@ -2469,6 +2500,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\iint",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u222C",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0645\u0632\u062F\u0648\u062C",
     svg_path: null
@@ -2479,6 +2511,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\iiint",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u222D",
     title: "\u062A\u0643\u0627\u0645\u0644 \u062B\u0644\u0627\u062B\u064A",
     svg_path: null
@@ -2489,6 +2522,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\iiiint",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2A0C",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0631\u0628\u0627\u0639\u064A",
     svg_path: null
@@ -2499,6 +2533,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\oint",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u222E",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0645\u063A\u0644\u0642",
     svg_path: null
@@ -2509,6 +2544,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\oiint",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u222F",
     title: "\u062A\u0643\u0627\u0645\u0644 \u0633\u0637\u062D\u064A \u0645\u063A\u0644\u0642",
     svg_path: null
@@ -2519,6 +2555,7 @@ var ATOMIC_OPERATOR_COMMANDS = {
     Tex: "\\oiiint",
     mirror: true,
     displayMirror: false,
+    compileMirror: true,
     Label: "\u2230",
     title: "\u062A\u0643\u0627\u0645\u0644 \u062D\u062C\u0645\u064A \u0645\u063A\u0644\u0642",
     svg_path: null
@@ -2528,8 +2565,9 @@ function shouldMirrorOperatorDisplay(command) {
   return command?.displayMirror ?? command?.mirror ?? false;
 }
 var MIRRORED_OPERATOR_TEX = Object.values(ATOMIC_OPERATOR_COMMANDS).filter((command) => command.mirror).map((command) => command.Tex).sort((a, b) => b.length - a.length);
-function matchingMirroredOperator(tex, index) {
-  for (const operatorTex of MIRRORED_OPERATOR_TEX) {
+var COMPILE_MIRRORED_OPERATOR_TEX = Object.values(ATOMIC_OPERATOR_COMMANDS).filter((command) => "compileMirror" in command && command.compileMirror).map((command) => command.Tex).sort((a, b) => b.length - a.length);
+function matchingMirroredOperatorFrom(tex, index, operatorTexList) {
+  for (const operatorTex of operatorTexList) {
     if (!tex.startsWith(operatorTex, index)) {
       continue;
     }
@@ -2560,19 +2598,26 @@ function findMatchingBrace(tex, openIndex) {
   }
   return -1;
 }
-function mirrorBuTeXOperatorsInTex(tex) {
+function mirrorBuTeXOperatorsInTex(tex, options = {}) {
+  const mirroredOperatorTex = options.target === "compile" ? COMPILE_MIRRORED_OPERATOR_TEX : MIRRORED_OPERATOR_TEX;
   let result = "";
   let index = 0;
   while (index < tex.length) {
     if (tex.startsWith("\\butexmirror{", index)) {
       const end = findMatchingBrace(tex, index + "\\butexmirror".length);
       if (end !== -1) {
-        result += tex.slice(index, end + 1);
+        const bodyStart = index + "\\butexmirror{".length;
+        const body = tex.slice(bodyStart, end);
+        if (options.target === "compile" && MIRRORED_OPERATOR_TEX.includes(body) && !mirroredOperatorTex.includes(body)) {
+          result += body;
+        } else {
+          result += tex.slice(index, end + 1);
+        }
         index = end + 1;
         continue;
       }
     }
-    const operatorTex = matchingMirroredOperator(tex, index);
+    const operatorTex = matchingMirroredOperatorFrom(tex, index, mirroredOperatorTex);
     if (operatorTex) {
       result += `\\butexmirror{${operatorTex}}`;
       index += operatorTex.length;
@@ -8234,18 +8279,19 @@ function mathNodeFromSession(session, opening = "$", closing = "$") {
   }
   return { nodeType: "MathObject", mathMode: opening, lines: [], closing };
 }
-function mathTokenSourceForSide(token, side) {
+function mathTokenSourceForSide(token, side, digitForm) {
   if (!token.math || token.sourceOwner === "raw") {
     return token.source;
   }
-  if (token.sourceSide === side) {
+  if (token.sourceSide === side && digitForm === void 0) {
     return token.source;
   }
   const result = mathTokenToEditorSession(token.math, side);
   if (!result.editable) {
     return token.source;
   }
-  return mathSourceFromSession(result.session, side, token.opening, token.closing);
+  const session = digitForm === void 0 ? result.session : setCurrentDigitForm(result.session, digitForm);
+  return mathSourceFromSession(session, side, token.opening, token.closing);
 }
 
 // src/document2/commands.ts
@@ -8979,6 +9025,19 @@ function document2KeyError(key, namespace = {}) {
 }
 
 // src/document2/arabicPreamble.ts
+function fontOptions(digitsMapping, includeScript = true) {
+  const parts = [];
+  if (includeScript) {
+    parts.push("Script=Arabic");
+  }
+  if (digitsMapping !== "digits") {
+    parts.push(`Mapping=${digitsMapping}`);
+  }
+  if (parts.length === 0) {
+    return "";
+  }
+  return `[${parts.join(",")}]`;
+}
 function arabicXeLatexPreamblePkg(twocolumn = false) {
   const classOptions = twocolumn ? "12pt,a4paper,notitlepage,twocolumn" : "12pt,a4paper,notitlepage";
   return `
@@ -9007,25 +9066,27 @@ function arabicXeLatexPreamblePkg(twocolumn = false) {
 % save back tick for use - copy paste ->  ` + "`";
 }
 function arabicXeLatexPreambleFont(digitsMapping = "arabicdigits") {
-  const customFonts = NON_DEFAULT_CHARACTER_FONT_SPECS.filter((font) => font.latexFontCommand && font.latexFontFamily).map((font) => `\\newfontfamily${font.latexFontCommand}[Script=Arabic,Mapping=${digitsMapping}]{${font.latexFontFamily}}`).join("\n");
+  const customFonts = NON_DEFAULT_CHARACTER_FONT_SPECS.filter((font) => font.latexFontCommand && font.latexFontFamily).map((font) => `\\newfontfamily${font.latexFontCommand}${fontOptions(digitsMapping)}{${font.latexFontFamily}}`).join("\n");
+  const mathFontOptions = fontOptions(digitsMapping, false);
   return `
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-% Toggle between eastern and western digits by changing the Mapping in the below fonts (inside math font as well) between "arabicdigits" and "digits"
+% Persian digits: Mapping=farsidigits
+% Arabic-Indic digits: Mapping=arabicdigits
+% Western digits: omit Mapping entirely
 \\setdefaultlanguage[calendar=gregorian]{arabic}  % from polyglossia
-\\setmainfont[Script=Arabic , Mapping=${digitsMapping}]{Amiri}
+\\setmainfont${fontOptions(digitsMapping)}{Amiri}
 ${customFonts}
-\\newfontfamily\\boldarabic[Script=Arabic,Mapping=${digitsMapping}]{Amiri Bold}
-\\newfontfamily\\italicarabic[Script=Arabic,Mapping=${digitsMapping}]{Amiri Italic}
+\\newfontfamily\\boldarabic${fontOptions(digitsMapping)}{Amiri Bold}
+\\newfontfamily\\italicarabic${fontOptions(digitsMapping)}{Amiri Italic}
 
 % for polyglossia url I dont know, sugggested by cursor
-\\newfontfamily\\arabicfonttt[Script=Arabic,Mapping=${digitsMapping}]{Amiri}
-\\newfontfamily\\arabicfontsf[Script=Arabic,Mapping=${digitsMapping}]{Amiri}
+\\newfontfamily\\arabicfonttt${fontOptions(digitsMapping)}{Amiri}
+\\newfontfamily\\arabicfontsf${fontOptions(digitsMapping)}{Amiri}
 
 
 % 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
+\\setmathfont${mathFontOptions}{XITS Math} % Ensure XITS Math is correctly installed and available
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 `;
@@ -9187,8 +9248,20 @@ function getArabicXeLatexPreamble(digitsMappingOrOptions = "arabicdigits") {
 }
 
 // src/document2/exportLatex.ts
+function digitsMappingFromDigitForm(digitForm) {
+  if (digitForm === "western") {
+    return "digits";
+  }
+  if (digitForm === "persianIndic") {
+    return "farsidigits";
+  }
+  return "arabicdigits";
+}
 function mathBodyLatex(token) {
-  if (!token.math || token.sourceOwner === "raw" || token.sourceOwner === "editor") {
+  if (token.sourceOwner === "editor") {
+    return stripDisplayMathDelimiters(mirrorBuTeXOperatorsInTex(token.source, { target: "compile" }));
+  }
+  if (!token.math || token.sourceOwner === "raw") {
     return stripDisplayMathDelimiters(token.source);
   }
   const rendered = renderMathNodeLatex(token.math);
@@ -9224,7 +9297,10 @@ ${body}
 \\label{${token.label.trim()}}
 \\end{equation}`;
   }
-  if (!token.math || token.sourceOwner === "raw" || token.sourceOwner === "editor") {
+  if (token.sourceOwner === "editor") {
+    return mirrorBuTeXOperatorsInTex(token.source, { target: "compile" });
+  }
+  if (!token.math || token.sourceOwner === "raw") {
     return token.source;
   }
   return renderMathNodeLatex(token.math);
@@ -9342,7 +9418,7 @@ function articleMaketitlePreamble(meta, twocolumn = false) {
   if (meta.authors.trim().length > 0) {
     parts.push(`\\author{${authorLatex(meta.authors)}}`);
   }
-  parts.push(`\\date{${formatHijriDate(meta.date, { locale: "ar", digitForm: "arabicIndic" })}}`);
+  parts.push(`\\date{${formatHijriDate(meta.date, { locale: "ar", digitForm: "western" })}}`);
   return parts.join("\n");
 }
 function articleFrontMatterLatex(meta) {
@@ -9374,7 +9450,7 @@ function document2Latex(document2, options = {}) {
 ${body}` : body;
   }
   const preamble = getArabicXeLatexPreamble({
-    digitsMapping: options.digitsMapping ?? "arabicdigits",
+    digitsMapping: options.digitsMapping ?? digitsMappingFromDigitForm(options.digitForm),
     twocolumn
   }) + "\n" + articleMaketitlePreamble(meta, twocolumn);
   return `${preamble}
@@ -9630,8 +9706,8 @@ function remapSelectionAfterRangeMove(selection, direction) {
 }
 
 // src/document2/previewModel.ts
-function mathTex(token, equationSide) {
-  return mathTokenSourceForSide(token, equationSide);
+function mathTex(token, equationSide, digitForm) {
+  return mathTokenSourceForSide(token, equationSide, digitForm);
 }
 function previewInlines(field, islands, output, equationSide, document2, previewOptions) {
   return field.tokens.map((token) => {
@@ -9663,7 +9739,7 @@ function previewInlines(field, islands, output, equationSide, document2, preview
     }
     const island = {
       id: token.id,
-      tex: mathTex(token, equationSide),
+      tex: mathTex(token, equationSide, previewOptions.digitForm),
       display: token.display,
       output,
       editable: token.editable
@@ -10306,6 +10382,32 @@ function focusArticleMetaPanel(panel) {
 // src/react-document2/ButexDocumentEditor2.tsx
 import { useCallback as useCallback2, useEffect as useEffect9, useMemo as useMemo2, useRef as useRef8, useState as useState12 } from "react";
 
+// src/debugJson.ts
+function lineColumnForPosition(text, position) {
+  const before = text.slice(0, Math.max(0, position));
+  const lines = before.split("\n");
+  return {
+    line: lines.length,
+    column: (lines[lines.length - 1]?.length ?? 0) + 1
+  };
+}
+function parseJsonDebugInput(text) {
+  try {
+    return { ok: true, value: JSON.parse(text) };
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    const positionMatch = message.match(/position\s+(\d+)/i);
+    if (positionMatch) {
+      const position = Number(positionMatch[1]);
+      if (Number.isFinite(position)) {
+        const location = lineColumnForPosition(text, position);
+        return { ok: false, error: `Invalid JSON at line ${String(location.line)}, column ${String(location.column)}: ${message}` };
+      }
+    }
+    return { ok: false, error: `Invalid JSON: ${message}` };
+  }
+}
+
 // src/react-document2/BlockEditor.tsx
 import { useState as useState3 } from "react";
 
@@ -10845,6 +10947,7 @@ function MathChip({
   token,
   output = "svg",
   documentDirection = "rtl",
+  digitForm,
   equationSide = "arabic",
   editable = true,
   uiLocale = "ar",
@@ -10856,7 +10959,7 @@ function MathChip({
   onTextInputFromFocus
 }) {
   const messages = document2Messages(uiLocale);
-  const tex = mathTokenSourceForSide(token, equationSide);
+  const tex = mathTokenSourceForSide(token, equationSide, digitForm);
   const forwardArrowKey = documentDirection === "rtl" ? "ArrowLeft" : "ArrowRight";
   const backwardArrowKey = documentDirection === "rtl" ? "ArrowRight" : "ArrowLeft";
   const island = /* @__PURE__ */ jsx4(MathIsland, { id: token.id, tex, display: token.display, output });
@@ -11266,6 +11369,7 @@ function InlineField({
         token,
         output: mathOutput,
         equationSide,
+        digitForm,
         editable: editableEquations,
         uiLocale,
         buttonRef: (element) => {
@@ -12817,6 +12921,11 @@ var WIDGET_CHROME_CSS = `
   font-family: ${BUTEX_DIWANI_OUTLINE_FONT_STACK};
 }
 
+.butex-widget .font-mode-btn--maghribi,
+.butex-widget .character-font-option--maghribi {
+  font-family: ${BUTEX_MAGHRIBI_FONT_STACK};
+}
+
 .butex-widget .character-font-options {
   position: absolute;
   z-index: 10;
@@ -13351,6 +13460,36 @@ var WIDGET_CHROME_CSS = `
   background: var(--butex-dev-inset-bg);
   color: var(--butex-dev-inset-fg);
 }
+
+.butex-widget .debug-json-import {
+  display: grid;
+  gap: 8px;
+  margin-bottom: 10px;
+}
+
+.butex-widget .debug-json-import textarea {
+  min-height: 150px;
+  resize: vertical;
+  border: 1px solid var(--butex-dev-inset-border);
+  border-radius: 8px;
+  padding: 8px 10px;
+  direction: ltr;
+  text-align: left;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 11px;
+  background: var(--butex-dev-inset-bg);
+  color: var(--butex-dev-inset-fg);
+}
+
+.butex-widget .debug-json-error {
+  margin: 0;
+  border: 1px solid rgba(220, 38, 38, 0.45);
+  background: rgba(254, 226, 226, 0.9);
+  color: #991b1b;
+  border-radius: 8px;
+  padding: 8px 10px;
+  white-space: pre-wrap;
+}
 `.trim();
 var CHROME_STYLE_ID = "butex-widget-chrome-css";
 function injectWidgetChromeCss(doc) {
@@ -13479,6 +13618,7 @@ ${latex || messages.empty}`;
 var ButexEditor = forwardRef(
   function ButexEditor2({ className, debug = false, defaultSide, uiLocale = "ar", initialSession, onSessionChange }, ref) {
     const messages = equationEditorMessages(uiLocale);
+    const debugEnabled = debug || typeof window !== "undefined" && new URLSearchParams(window.location.search).get("debug") === "1";
     const wrapperRef = useRef6(null);
     const surfaceRef = useRef6(null);
     const inputRef = useRef6(null);
@@ -13496,7 +13636,7 @@ var ButexEditor = forwardRef(
     const digitFormBtnRef = useRef6(null);
     const runtimeRef = useRef6(null);
     const debugRef = useRef6(debug);
-    debugRef.current = debug;
+    debugRef.current = debugEnabled;
     const uiLocaleRef = useRef6(uiLocale);
     uiLocaleRef.current = uiLocale;
     const onSessionChangeRef = useRef6(onSessionChange);
@@ -13504,6 +13644,9 @@ var ButexEditor = forwardRef(
     const debugBodyHiddenRef = useRef6(false);
     const [debugBodyHidden, setDebugBodyHidden] = useState7(false);
     debugBodyHiddenRef.current = debugBodyHidden;
+    const [debugImportOpen, setDebugImportOpen] = useState7(false);
+    const [debugImportText, setDebugImportText] = useState7("");
+    const [debugImportError, setDebugImportError] = useState7("");
     const [digitMenuOpen, setDigitMenuOpen] = useState7(false);
     const [characterFontMenuOpen, setCharacterFontMenuOpen] = useState7(false);
     const [delimiterMenuOpen, setDelimiterMenuOpen] = useState7(false);
@@ -13584,6 +13727,54 @@ ${arabic || currentMessages.empty}`;
     }, []);
     const updatePreviewRef = useRef6(updatePreview);
     updatePreviewRef.current = updatePreview;
+    async function copyDebugText(text) {
+      try {
+        await navigator.clipboard.writeText(text);
+      } catch {
+      }
+    }
+    function currentMathObjectJsonText() {
+      const session = runtimeRef.current?.getSession();
+      if (!session) {
+        return "";
+      }
+      const math = mathNodeFromEditorSession(session);
+      if (!math.ok) {
+        return "";
+      }
+      return JSON.stringify(toMathObjectJson(math.math), null, 2);
+    }
+    function openDebugMathObjectImport() {
+      setDebugImportText(currentMathObjectJsonText());
+      setDebugImportError("");
+      setDebugImportOpen(true);
+    }
+    function applyDebugMathObjectImport() {
+      const parsed = parseJsonDebugInput(debugImportText);
+      if (!parsed.ok) {
+        setDebugImportError(parsed.error);
+        return;
+      }
+      try {
+        const math = fromMathObjectJson(parsed.value, activeEditorSide);
+        const result = mathObjectToEditorSession(math);
+        if (!result.editable) {
+          setDebugImportError(result.reason);
+          return;
+        }
+        const next = { ...result.session, activeSide: activeEditorSide };
+        runtimeRef.current?.setSession(next);
+        setSelectedDigitForm(next.currentDigitForm ?? "western");
+        setSelectedCharacterFont(next.currentCharacterFont ?? "default");
+        setActiveEditorSide(next.activeSide);
+        onSessionChangeRef.current?.(next);
+        setDebugImportError("");
+        setDebugImportOpen(false);
+        void updatePreviewRef.current(next);
+      } catch (importError) {
+        setDebugImportError(importError instanceof Error ? importError.message : String(importError));
+      }
+    }
     useEffect6(() => {
       injectWidgetChromeCss();
       injectBuTeXEditorStyles(typeof document !== "undefined" ? document : void 0);
@@ -14744,7 +14935,7 @@ ${arabic || currentMessages.empty}`;
             /* @__PURE__ */ jsx12("div", { ref: renderErrorRef, className: "error", hidden: true })
           ] }),
           /* @__PURE__ */ jsx12("section", { className: "panel panel-preview", "aria-label": messages.renderPreview, children: /* @__PURE__ */ jsx12("div", { ref: mathOutputRef, className: "preview-box" }) }),
-          debug ? /* @__PURE__ */ jsxs10("section", { className: "panel", children: [
+          debugEnabled ? /* @__PURE__ */ jsxs10("section", { className: "panel", children: [
             /* @__PURE__ */ jsxs10("div", { className: "dev-strip", children: [
               /* @__PURE__ */ jsx12("span", { className: "dev-badge", children: messages.development }),
               /* @__PURE__ */ jsx12("div", { ref: latexLinesRef, className: "ascii" }),
@@ -14752,6 +14943,8 @@ ${arabic || currentMessages.empty}`;
             ] }),
             /* @__PURE__ */ jsxs10("div", { style: { marginTop: 12 }, children: [
               /* @__PURE__ */ jsxs10("div", { className: "debug-head", children: [
+                /* @__PURE__ */ jsx12("button", { type: "button", onClick: () => void copyDebugText(currentMathObjectJsonText()), children: "Copy MathObject JSON" }),
+                /* @__PURE__ */ jsx12("button", { type: "button", "aria-expanded": debugImportOpen, onClick: openDebugMathObjectImport, children: "Import MathObject JSON" }),
                 /* @__PURE__ */ jsx12(
                   "button",
                   {
@@ -14787,6 +14980,35 @@ ${arabic || currentMessages.empty}`;
                   }
                 )
               ] }),
+              debugImportOpen ? /* @__PURE__ */ jsxs10("div", { className: "debug-json-import", children: [
+                /* @__PURE__ */ jsx12(
+                  "textarea",
+                  {
+                    value: debugImportText,
+                    "aria-label": "Import MathObject JSON",
+                    spellCheck: false,
+                    onChange: (event) => {
+                      setDebugImportText(event.currentTarget.value);
+                      setDebugImportError("");
+                    }
+                  }
+                ),
+                /* @__PURE__ */ jsxs10("div", { className: "debug-head", children: [
+                  /* @__PURE__ */ jsx12("button", { type: "button", onClick: applyDebugMathObjectImport, children: "Apply" }),
+                  /* @__PURE__ */ jsx12(
+                    "button",
+                    {
+                      type: "button",
+                      onClick: () => {
+                        setDebugImportOpen(false);
+                        setDebugImportError("");
+                      },
+                      children: "Cancel"
+                    }
+                  )
+                ] }),
+                debugImportError ? /* @__PURE__ */ jsx12("p", { className: "debug-json-error", children: debugImportError }) : null
+              ] }) : null,
               /* @__PURE__ */ jsx12("div", { ref: debugLogRef, className: "debug-log" })
             ] })
           ] }) : null
@@ -14812,6 +15034,7 @@ function keyErrorMessage2(error, messages) {
   return null;
 }
 function EquationDrawer({
+  debug = false,
   session,
   reason,
   mathMode,
@@ -14929,7 +15152,7 @@ function EquationDrawer({
           /* @__PURE__ */ jsx13(
             ButexEditor,
             {
-              debug: false,
+              debug,
               defaultSide: equationSide,
               uiLocale,
               initialSession: session,
@@ -16511,6 +16734,42 @@ var DOCUMENT2_WIDGET_CSS = `
   white-space: pre-wrap;
 }
 
+.butex-document2-widget__dev-actions {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+  margin: 0 0 10px;
+}
+
+.butex-document2-widget__dev-import {
+  display: grid;
+  gap: 8px;
+  margin-bottom: 12px;
+}
+
+.butex-document2-widget__dev-import textarea {
+  background: var(--butex-document2-dev-code-bg);
+  border: 1px solid var(--butex-document2-dev-border);
+  border-radius: 8px;
+  color: var(--butex-document2-dev-code-fg);
+  direction: ltr;
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  min-height: 180px;
+  padding: 10px;
+  resize: vertical;
+  text-align: left;
+}
+
+.butex-document2-widget__dev-error {
+  background: rgba(254, 226, 226, 0.9);
+  border: 1px solid rgba(220, 38, 38, 0.45);
+  border-radius: 8px;
+  color: #991b1b;
+  margin: 0;
+  padding: 8px 10px;
+  white-space: pre-wrap;
+}
+
 .butex-document2-widget__dev-diagnostic {
   background: rgba(251, 191, 36, 0.18);
   border: 1px solid rgba(217, 119, 6, 0.4);
@@ -17374,11 +17633,17 @@ function ButexDocumentEditor2({
   const [labelsOpen, setLabelsOpen] = useState12(false);
   const [refPicker, setRefPicker] = useState12(null);
   const [digitFormState, setDigitFormState] = useState12(null);
+  const [debugImportOpen, setDebugImportOpen] = useState12(false);
+  const [debugImportText, setDebugImportText] = useState12("");
+  const [debugImportError, setDebugImportError] = useState12("");
   const [editorFocus, setEditorFocus] = useState12(createEmptyDocument2EditorFocus());
   const [collapsedBlockIds, setCollapsedBlockIds] = useState12(() => /* @__PURE__ */ new Set());
   const [blockSelectionState, setBlockSelectionState] = useState12(emptyBlockSelection);
   const [historyTick, setHistoryTick] = useState12(0);
   const digitForm = digitFormProp ?? digitFormState ?? (documentDirection === "rtl" ? "arabicIndic" : "western");
+  function equationSessionWithDocumentDigits(session) {
+    return setCurrentDigitForm(session, digitForm);
+  }
   const historyRef = useRef8(createDocument2History());
   const documentRef = useRef8(documentNode);
   const textSnapshotArmedRef = useRef8(false);
@@ -17387,7 +17652,7 @@ function ButexDocumentEditor2({
   const articleMetaPanelRef = useRef8(null);
   const pendingFocusRef = useRef8(null);
   documentRef.current = documentNode;
-  const latex = document2Latex(documentNode);
+  const latex = document2Latex(documentNode, { digitForm });
   const documentJson = useMemo2(() => toDocumentJson2(documentNode), [documentNode]);
   const documentLabels = useMemo2(() => collectDocument2Labels(documentNode), [documentNode]);
   const preview = useMemo2(
@@ -17595,6 +17860,46 @@ function ButexDocumentEditor2({
   function openAllBlocks() {
     setCollapsedBlockIds(/* @__PURE__ */ new Set());
   }
+  async function copyDebugText(text) {
+    try {
+      await navigator.clipboard.writeText(text);
+    } catch {
+    }
+  }
+  function openDebugJsonImport() {
+    setDebugImportText(JSON.stringify(documentJson, null, 2));
+    setDebugImportError("");
+    setDebugImportOpen(true);
+  }
+  function applyDebugJsonImport() {
+    const parsed = parseJsonDebugInput(debugImportText);
+    if (!parsed.ok) {
+      setDebugImportError(parsed.error);
+      return;
+    }
+    try {
+      const imported = fromDocumentJson2(parsed.value);
+      textSnapshotArmedRef.current = false;
+      if (textDebounceRef.current !== null) {
+        window.clearTimeout(textDebounceRef.current);
+        textDebounceRef.current = null;
+      }
+      setDocumentNode(imported);
+      setError(null);
+      setSelectedMath(null);
+      setCitePicker(null);
+      setRefPicker(null);
+      clearBlockSelection();
+      setCollapsedBlockIds(/* @__PURE__ */ new Set());
+      setEditorFocus(createEmptyDocument2EditorFocus());
+      historyRef.current = createDocument2History();
+      bumpHistoryUi();
+      setDebugImportError("");
+      setDebugImportOpen(false);
+    } catch (importError) {
+      setDebugImportError(importError instanceof Error ? importError.message : String(importError));
+    }
+  }
   useEffect9(() => {
     const root = widgetRef.current;
     if (!root) {
@@ -17650,7 +17955,7 @@ function ButexDocumentEditor2({
       textTokenId: target?.textTokenId ?? null,
       insertAt: target?.caretOffset ?? 0,
       mathMode: mode,
-      session: createEmptyEquationSession(equationSide),
+      session: equationSessionWithDocumentDigits(createEmptyEquationSession(equationSide)),
       reason: null,
       labelEnabled: false,
       label: ""
@@ -17670,7 +17975,7 @@ function ButexDocumentEditor2({
         insertAt: 0,
         textTokenId: null,
         mathMode: mode,
-        session: createEmptyEquationSession(equationSide),
+        session: equationSessionWithDocumentDigits(createEmptyEquationSession(equationSide)),
         reason: result.reason,
         labelEnabled: Boolean(token.labelEnabled),
         label: token.label ?? ""
@@ -17683,7 +17988,7 @@ function ButexDocumentEditor2({
       insertAt: 0,
       textTokenId: null,
       mathMode: mode,
-      session: result.session,
+      session: equationSessionWithDocumentDigits(result.session),
       reason: null,
       labelEnabled: Boolean(token.labelEnabled),
       label: token.label ?? ""
@@ -18108,14 +18413,51 @@ function ButexDocumentEditor2({
             /* @__PURE__ */ jsx17("strong", { children: messages.importWarnings }),
             documentNode.diagnostics.map((diagnostic) => /* @__PURE__ */ jsx17("p", { className: "butex-document2-widget__dev-diagnostic", children: formatDocument2Diagnostic(diagnostic, messages) }, `${diagnostic.path}-${diagnostic.message}`))
           ] }) : null,
+          /* @__PURE__ */ jsxs15("div", { className: "butex-document2-widget__dev-actions", children: [
+            /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => void copyDebugText(JSON.stringify(documentJson, null, 2)), children: "Copy JSON" }),
+            /* @__PURE__ */ jsx17("button", { type: "button", onClick: () => void copyDebugText(latex), children: "Copy TeX" }),
+            /* @__PURE__ */ jsx17("button", { type: "button", "aria-expanded": debugImportOpen, onClick: openDebugJsonImport, children: "Import JSON" })
+          ] }),
+          debugImportOpen ? /* @__PURE__ */ jsxs15("div", { className: "butex-document2-widget__dev-import", children: [
+            /* @__PURE__ */ jsx17(
+              "textarea",
+              {
+                value: debugImportText,
+                "aria-label": "Import Document2 JSON",
+                spellCheck: false,
+                onChange: (event) => {
+                  setDebugImportText(event.currentTarget.value);
+                  setDebugImportError("");
+                }
+              }
+            ),
+            /* @__PURE__ */ jsxs15("div", { className: "butex-document2-widget__dev-actions", children: [
+              /* @__PURE__ */ jsx17("button", { type: "button", onClick: applyDebugJsonImport, children: "Apply" }),
+              /* @__PURE__ */ jsx17(
+                "button",
+                {
+                  type: "button",
+                  onClick: () => {
+                    setDebugImportOpen(false);
+                    setDebugImportError("");
+                  },
+                  children: "Cancel"
+                }
+              )
+            ] }),
+            debugImportError ? /* @__PURE__ */ jsx17("p", { className: "butex-document2-widget__dev-error", children: debugImportError }) : null
+          ] }) : null,
           /* @__PURE__ */ jsx17("strong", { children: "LaTeX" }),
           /* @__PURE__ */ jsx17("pre", { children: latex }),
+          /* @__PURE__ */ jsx17("strong", { children: "JSON" }),
+          /* @__PURE__ */ jsx17("pre", { children: JSON.stringify(documentJson, null, 2) }),
           /* @__PURE__ */ jsx17("strong", { children: "AST" }),
           /* @__PURE__ */ jsx17("pre", { children: JSON.stringify(documentNode, null, 2) })
         ] }) : null,
         !previewOnly && selectedMath ? /* @__PURE__ */ jsx17(
           EquationDrawer,
           {
+            debug: debugEnabled,
             session: selectedMath.session,
             reason: selectedMath.reason,
             mathMode: selectedMath.mathMode,