@drghaliasri/butex 5.3.3 → 5.4.0

package/dist/react.mjs

@@ -36,6 +36,9 @@ function createEditorNode(kind, expr) {
     denominator: null,
     radicand: null,
     rootIndex: null,
+    overExpr: null,
+    underExpr: null,
+    baseExpr: null,
     envName: null,
     matrixStyle: null,
     matrixRows: null,
@@ -64,6 +67,26 @@ function createSqrtNode() {
     rootIndex: createEditorChain()
   };
 }
+function createOversetNode() {
+  return {
+    ...createEditorNode("overset", ""),
+    overExpr: createEditorChain(),
+    baseExpr: createEditorChain()
+  };
+}
+function createUndersetNode() {
+  return {
+    ...createEditorNode("underset", ""),
+    underExpr: createEditorChain(),
+    baseExpr: createEditorChain()
+  };
+}
+function createAccentNode(accentId) {
+  return {
+    ...createEditorNode("accent", accentId),
+    baseExpr: createEditorChain()
+  };
+}
 function createGridEnvNode(envName, rows, columns, columnAlignments) {
   const safeRows = Math.max(1, Math.min(12, Math.trunc(rows)));
   const safeColumns = Math.max(1, Math.min(12, Math.trunc(columns)));
@@ -105,6 +128,144 @@ function cloneEditorSession(session) {
   };
 }
 
+// src/editor/accentCommands.ts
+var ACCENT_COMMANDS = {
+  vec: {
+    id: "vec",
+    englishTex: "\\vec",
+    arabicTex: "\\arabvec",
+    placement: "over",
+    label: "\u20D7",
+    title: "\u0633\u0647\u0645 \u0641\u0648\u0642"
+  },
+  hat: {
+    id: "hat",
+    englishTex: "\\hat",
+    arabicTex: "\\hat",
+    placement: "over",
+    label: "\u02C6",
+    title: "\u0642\u0628\u0639\u0629"
+  },
+  tilde: {
+    id: "tilde",
+    englishTex: "\\tilde",
+    arabicTex: "\\tilde",
+    placement: "over",
+    label: "\u02DC",
+    title: "\u0645\u062F\u0629"
+  },
+  dot: {
+    id: "dot",
+    englishTex: "\\dot",
+    arabicTex: "\\dot",
+    placement: "over",
+    label: "\u02D9",
+    title: "\u0646\u0642\u0637\u0629 \u0641\u0648\u0642"
+  },
+  ddot: {
+    id: "ddot",
+    englishTex: "\\ddot",
+    arabicTex: "\\ddot",
+    placement: "over",
+    label: "\xA8",
+    title: "\u0646\u0642\u0637\u062A\u0627\u0646 \u0641\u0648\u0642"
+  },
+  dddot: {
+    id: "dddot",
+    englishTex: "\\dddot",
+    arabicTex: "\\dddot",
+    placement: "over",
+    label: "\u20DB",
+    title: "\u062B\u0644\u0627\u062B \u0646\u0642\u0627\u0637 \u0641\u0648\u0642"
+  },
+  bar: {
+    id: "bar",
+    englishTex: "\\bar",
+    arabicTex: "\\bar",
+    placement: "over",
+    label: "\xAF",
+    title: "\u062E\u0637 \u0641\u0648\u0642"
+  },
+  check: {
+    id: "check",
+    englishTex: "\\check",
+    arabicTex: "\\check",
+    placement: "over",
+    label: "\u02C7",
+    title: "\u0639\u0644\u0627\u0645\u0629 \u062A\u062D\u0642\u0642"
+  },
+  breve: {
+    id: "breve",
+    englishTex: "\\breve",
+    arabicTex: "\\breve",
+    placement: "over",
+    label: "\u02D8",
+    title: "\u0642\u0648\u0633 \u0642\u0635\u064A\u0631"
+  },
+  acute: {
+    id: "acute",
+    englishTex: "\\acute",
+    arabicTex: "\\grave",
+    placement: "over",
+    label: "\xB4",
+    title: "\u0646\u0628\u0631\u0629 \u062D\u0627\u062F\u0629"
+  },
+  grave: {
+    id: "grave",
+    englishTex: "\\grave",
+    arabicTex: "\\acute",
+    placement: "over",
+    label: "`",
+    title: "\u0646\u0628\u0631\u0629 \u062B\u0642\u064A\u0644\u0629"
+  },
+  overline: {
+    id: "overline",
+    englishTex: "\\overline",
+    arabicTex: "\\overline",
+    placement: "over",
+    label: "\u203E",
+    title: "\u062E\u0637 \u0639\u0644\u0648\u064A \u0645\u0645\u062A\u062F"
+  },
+  underline: {
+    id: "underline",
+    englishTex: "\\underline",
+    arabicTex: "\\underline",
+    placement: "under",
+    label: "_",
+    title: "\u062E\u0637 \u0633\u0641\u0644\u064A"
+  },
+  overleftarrow: {
+    id: "overleftarrow",
+    englishTex: "\\overleftarrow",
+    arabicTex: "\\overrightarrow",
+    placement: "over",
+    label: "\u2190",
+    title: "\u0633\u0647\u0645 \u0639\u0644\u0648\u064A \u0625\u0644\u0649 \u0627\u0644\u064A\u0633\u0627\u0631"
+  },
+  overrightarrow: {
+    id: "overrightarrow",
+    englishTex: "\\overrightarrow",
+    arabicTex: "\\overleftarrow",
+    placement: "over",
+    label: "\u2192",
+    title: "\u0633\u0647\u0645 \u0639\u0644\u0648\u064A \u0625\u0644\u0649 \u0627\u0644\u064A\u0645\u064A\u0646"
+  },
+  overleftrightarrow: {
+    id: "overleftrightarrow",
+    englishTex: "\\overleftrightarrow",
+    arabicTex: "\\overleftrightarrow",
+    placement: "over",
+    label: "\u2194",
+    title: "\u0633\u0647\u0645 \u0639\u0644\u0648\u064A \u0645\u0632\u062F\u0648\u062C \u0627\u0644\u0627\u062A\u062C\u0627\u0647"
+  }
+};
+function accentCommandSpec(id) {
+  return Object.prototype.hasOwnProperty.call(ACCENT_COMMANDS, id) ? ACCENT_COMMANDS[id] : null;
+}
+function accentCommandsList() {
+  return Object.values(ACCENT_COMMANDS);
+}
+
 // src/editor/atomicCommands.ts
 var ATOMIC_COMMANDS = {
   ///////////////////////// Functions ////////////////////////////////
@@ -1172,6 +1333,22 @@ function renderMatrixRowsArabic(node, options) {
   }
   return `\\begin{${envName}}${rows.join(" \\\\\n")}\\end{${envName}}`;
 }
+function renderAccentEnglish(command, accent, base, options) {
+  const baseTex = base ? renderChainEnglish(base, options) : "";
+  const accentTex = accent ? renderChainEnglish(accent, options) : "";
+  if (accentTex === "") {
+    return baseTex;
+  }
+  return `\\${command}{${accentTex}}{${baseTex}}`;
+}
+function renderAccentArabic(command, accent, base, options) {
+  const baseTex = base ? renderChainArabic(base, options) : "";
+  const accentTex = accent ? renderChainArabic(accent, options) : "";
+  if (accentTex === "") {
+    return baseTex;
+  }
+  return `\\${command}{${accentTex}}{${baseTex}}`;
+}
 function escapeText(s) {
   return s.replace(/\\/g, "\\textbackslash{}").replace(/[{}]/g, "\\$&");
 }
@@ -1201,6 +1378,19 @@ function renderNodeEnglish(node, options) {
     const body = `\\sqrt${optionalRootIndexEnglish(node, options)}{${renderChainEnglish(node.radicand, options)}}`;
     return `${body}${latinScripts(node, options)}`;
   }
+  if (node.kind === "overset" && node.baseExpr) {
+    const body = renderAccentEnglish("overset", node.overExpr, node.baseExpr, options);
+    return `${body}${latinScripts(node, options)}`;
+  }
+  if (node.kind === "underset" && node.baseExpr) {
+    const body = renderAccentEnglish("underset", node.underExpr, node.baseExpr, options);
+    return `${body}${latinScripts(node, options)}`;
+  }
+  if (node.kind === "accent" && node.baseExpr) {
+    const cmd = accentCommandSpec(node.expr)?.englishTex ?? `\\${node.expr}`;
+    const body = `${cmd}{${renderChainEnglish(node.baseExpr, options)}}`;
+    return `${body}${latinScripts(node, options)}`;
+  }
   if (node.kind === "env") {
     return `${renderMatrixRowsEnglish(node, options)}${latinScripts(node, options)}`;
   }
@@ -1233,6 +1423,19 @@ function renderNodeArabic(node, options) {
     const content = `\\arabsqrt${optionalRootIndexArabic(node, options)}{${renderChainArabic(node.radicand, options)}}`;
     return arabicScripts(node, content, options);
   }
+  if (node.kind === "overset" && node.baseExpr) {
+    const content = renderAccentArabic("overset", node.overExpr, node.baseExpr, options);
+    return arabicScripts(node, content, options);
+  }
+  if (node.kind === "underset" && node.baseExpr) {
+    const content = renderAccentArabic("underset", node.underExpr, node.baseExpr, options);
+    return arabicScripts(node, content, options);
+  }
+  if (node.kind === "accent" && node.baseExpr) {
+    const cmd = accentCommandSpec(node.expr)?.arabicTex ?? `\\${node.expr}`;
+    const content = `${cmd}{${renderChainArabic(node.baseExpr, options)}}`;
+    return arabicScripts(node, content, options);
+  }
   if (node.kind === "env") {
     return arabicScripts(node, renderMatrixRowsArabic(node, options), options);
   }
@@ -1289,6 +1492,35 @@ function collectCaretPositions(chain) {
     if (node.radicand) {
       walkChain(node.radicand);
     }
+    if (node.kind === "overset") {
+      if (node.overExpr) {
+        walkChain(node.overExpr);
+      }
+      if (node.baseExpr) {
+        walkChain(node.baseExpr);
+      }
+    } else if (node.kind === "underset") {
+      if (node.baseExpr) {
+        walkChain(node.baseExpr);
+      }
+      if (node.underExpr) {
+        walkChain(node.underExpr);
+      }
+    } else if (node.kind === "accent") {
+      if (node.baseExpr) {
+        walkChain(node.baseExpr);
+      }
+    } else {
+      if (node.overExpr) {
+        walkChain(node.overExpr);
+      }
+      if (node.underExpr) {
+        walkChain(node.underExpr);
+      }
+      if (node.baseExpr) {
+        walkChain(node.baseExpr);
+      }
+    }
     if (node.matrixRows) {
       for (const row of node.matrixRows) {
         for (const cell of row) {
@@ -1422,6 +1654,42 @@ function findChainById(root, chainId) {
         return nested;
       }
     }
+    if (node.overExpr) {
+      if (node.overExpr.id === chainId) {
+        return {
+          chain: node.overExpr,
+          relation: { kind: "overExpr", ownerNodeId: node.id, ownerChainId: root.id }
+        };
+      }
+      const nested = findChainById(node.overExpr, chainId);
+      if (nested) {
+        return nested;
+      }
+    }
+    if (node.underExpr) {
+      if (node.underExpr.id === chainId) {
+        return {
+          chain: node.underExpr,
+          relation: { kind: "underExpr", ownerNodeId: node.id, ownerChainId: root.id }
+        };
+      }
+      const nested = findChainById(node.underExpr, chainId);
+      if (nested) {
+        return nested;
+      }
+    }
+    if (node.baseExpr) {
+      if (node.baseExpr.id === chainId) {
+        return {
+          chain: node.baseExpr,
+          relation: { kind: "baseExpr", ownerNodeId: node.id, ownerChainId: root.id }
+        };
+      }
+      const nested = findChainById(node.baseExpr, chainId);
+      if (nested) {
+        return nested;
+      }
+    }
     if (node.matrixRows) {
       for (let rowIndex = 0; rowIndex < node.matrixRows.length; rowIndex += 1) {
         const row = node.matrixRows[rowIndex];
@@ -1495,6 +1763,24 @@ function findNodeById(root, nodeId) {
         return nested;
       }
     }
+    if (node.overExpr) {
+      const nested = findNodeById(node.overExpr, nodeId);
+      if (nested) {
+        return nested;
+      }
+    }
+    if (node.underExpr) {
+      const nested = findNodeById(node.underExpr, nodeId);
+      if (nested) {
+        return nested;
+      }
+    }
+    if (node.baseExpr) {
+      const nested = findNodeById(node.baseExpr, nodeId);
+      if (nested) {
+        return nested;
+      }
+    }
     if (node.matrixRows) {
       for (const row of node.matrixRows) {
         for (const cell of row) {
@@ -1530,6 +1816,15 @@ function nodeChildChains(node) {
   if (node.radicand) {
     chains.push(node.radicand);
   }
+  if (node.overExpr) {
+    chains.push(node.overExpr);
+  }
+  if (node.underExpr) {
+    chains.push(node.underExpr);
+  }
+  if (node.baseExpr) {
+    chains.push(node.baseExpr);
+  }
   if (node.matrixRows) {
     for (const row of node.matrixRows) {
       chains.push(...row);
@@ -1900,6 +2195,91 @@ function derivativeTemplateInitialCaret(englishFrac) {
   };
 }
 
+// src/editor/limitsTemplates.ts
+var LIMITS_SERIES_TEMPLATE_IDS = /* @__PURE__ */ new Set([
+  "sum",
+  "prod",
+  "lim",
+  "max",
+  "min",
+  "sup",
+  "inf"
+]);
+function isLimitsSeriesTemplateId(commandId) {
+  return LIMITS_SERIES_TEMPLATE_IDS.has(commandId);
+}
+function syncChainIds2(english, arabic) {
+  arabic.id = english.id;
+  const limit = Math.min(english.nodes.length, arabic.nodes.length);
+  for (let index = 0; index < limit; index += 1) {
+    arabic.nodes[index].id = english.nodes[index].id;
+  }
+}
+function syncOversetIds(english, arabic) {
+  arabic.id = english.id;
+  if (english.overExpr && arabic.overExpr) {
+    syncChainIds2(english.overExpr, arabic.overExpr);
+  }
+  if (english.baseExpr && arabic.baseExpr) {
+    syncChainIds2(english.baseExpr, arabic.baseExpr);
+  }
+}
+function syncUndersetIds(english, arabic) {
+  arabic.id = english.id;
+  if (english.underExpr && arabic.underExpr) {
+    syncChainIds2(english.underExpr, arabic.underExpr);
+  }
+  if (english.baseExpr && arabic.baseExpr) {
+    syncChainIds2(english.baseExpr, arabic.baseExpr);
+  }
+}
+function buildLimitsSeriesTemplate(commandId) {
+  if (!isLimitsSeriesTemplateId(commandId)) {
+    throw new Error(`BuTeX: unsupported limits-series template id: ${commandId}`);
+  }
+  const englishOp = createAtomicCommandNode(commandId);
+  const arabicOp = createAtomicCommandNode(commandId);
+  arabicOp.id = englishOp.id;
+  const englishOverset = createOversetNode();
+  const arabicOverset = createOversetNode();
+  syncOversetIds(englishOverset, arabicOverset);
+  englishOverset.baseExpr = createEditorChain([englishOp]);
+  arabicOverset.baseExpr = createEditorChain([arabicOp]);
+  syncChainIds2(englishOverset.baseExpr, arabicOverset.baseExpr);
+  const englishUnderset = createUndersetNode();
+  const arabicUnderset = createUndersetNode();
+  syncUndersetIds(englishUnderset, arabicUnderset);
+  englishUnderset.baseExpr = createEditorChain([englishOverset]);
+  arabicUnderset.baseExpr = createEditorChain([arabicOverset]);
+  syncChainIds2(englishUnderset.baseExpr, arabicUnderset.baseExpr);
+  return { english: englishUnderset, arabic: arabicUnderset };
+}
+function buildAccentPairTemplate() {
+  const englishOverset = createOversetNode();
+  const arabicOverset = createOversetNode();
+  syncOversetIds(englishOverset, arabicOverset);
+  const englishUnderset = createUndersetNode();
+  const arabicUnderset = createUndersetNode();
+  syncUndersetIds(englishUnderset, arabicUnderset);
+  englishUnderset.baseExpr = createEditorChain([englishOverset]);
+  arabicUnderset.baseExpr = createEditorChain([arabicOverset]);
+  syncChainIds2(englishUnderset.baseExpr, arabicUnderset.baseExpr);
+  return { english: englishUnderset, arabic: arabicUnderset };
+}
+function accentPairTemplateInitialCaret(englishUnderset) {
+  const overset = englishUnderset.baseExpr?.nodes[0];
+  return {
+    chainId: overset?.baseExpr?.id ?? englishUnderset.underExpr?.id ?? "",
+    index: 0
+  };
+}
+function limitsSeriesTemplateInitialCaret(englishUnderset) {
+  return {
+    chainId: englishUnderset.underExpr?.id ?? englishUnderset.baseExpr?.id ?? "",
+    index: 0
+  };
+}
+
 // src/editor/uiLocale.ts
 var ENGLISH_COMMAND_TITLES = {
   cos: "Cosine",
@@ -1943,6 +2323,24 @@ var ENGLISH_COMMAND_TITLES = {
   quadSpace: "Large space",
   qquadSpace: "Extra-large space"
 };
+var ENGLISH_ACCENT_TITLES = {
+  vec: "Vector arrow",
+  hat: "Hat",
+  tilde: "Tilde",
+  dot: "Dot",
+  ddot: "Double dot",
+  dddot: "Triple dot",
+  bar: "Bar",
+  check: "Check",
+  breve: "Breve",
+  acute: "Acute",
+  grave: "Grave",
+  overline: "Overline",
+  underline: "Underline",
+  overleftarrow: "Over left arrow",
+  overrightarrow: "Over right arrow",
+  overleftrightarrow: "Over left-right arrow"
+};
 var ENGLISH_OPERATOR_TITLES = {
   inf: "Infinity",
   times: "Multiplication",
@@ -2016,6 +2414,10 @@ var EQUATION_EDITOR_MESSAGES = {
     insertBraces: "\u0625\u062F\u0631\u0627\u062C \u062D\u0627\u0635\u0631\u062A\u064A\u0646",
     insertFraction: "\u0625\u062F\u0631\u0627\u062C \u0643\u0633\u0631",
     insertRoot: "\u0625\u062F\u0631\u0627\u062C \u062C\u0630\u0631",
+    insertOverset: "\u0625\u062F\u0631\u0627\u062C \u0641\u0648\u0642",
+    insertUnderset: "\u0625\u062F\u0631\u0627\u062C \u062A\u062D\u062A",
+    insertAccentPair: "\u0625\u062F\u0631\u0627\u062C \u0641\u0648\u0642 \u0648\u062A\u062D\u062A",
+    insertAccents: "\u0625\u062F\u0631\u0627\u062C \u0644\u0643\u0646\u0629",
     environments: "\u0627\u0644\u0628\u064A\u0626\u0627\u062A",
     insertEnvironment: "\u0625\u062F\u0631\u0627\u062C \u0628\u064A\u0626\u0629 \u0634\u0628\u0643\u064A\u0629",
     environmentType: "\u0646\u0648\u0639 \u0627\u0644\u0628\u064A\u0626\u0629",
@@ -2123,6 +2525,10 @@ var EQUATION_EDITOR_MESSAGES = {
     insertBraces: "Insert braces",
     insertFraction: "Insert fraction",
     insertRoot: "Insert root",
+    insertOverset: "Insert overset",
+    insertUnderset: "Insert underset",
+    insertAccentPair: "Insert overset and underset",
+    insertAccents: "Insert accent",
     environments: "Environments",
     insertEnvironment: "Insert grid environment",
     environmentType: "Environment type",
@@ -2223,6 +2629,9 @@ function atomicCommandTitle(spec, locale) {
 function atomicOperatorCommandTitle(spec, locale) {
   return locale === "en" ? ENGLISH_OPERATOR_TITLES[spec.id] ?? spec.title : spec.title;
 }
+function accentCommandTitle(spec, locale) {
+  return locale === "en" ? ENGLISH_ACCENT_TITLES[spec.id] ?? spec.title : spec.title;
+}
 
 // src/editor/state.ts
 function ensureSyncEntry(session, nodeId) {
@@ -2257,7 +2666,7 @@ function syncSelectionToCaret(session) {
     session.selectedNodeId = located.relation.ownerNodeId;
     return;
   }
-  if (located.relation.kind === "inner" || located.relation.kind === "numerator" || located.relation.kind === "denominator" || located.relation.kind === "radicand" || located.relation.kind === "rootIndex" || located.relation.kind === "matrixCell") {
+  if (located.relation.kind === "inner" || located.relation.kind === "numerator" || located.relation.kind === "denominator" || located.relation.kind === "radicand" || located.relation.kind === "rootIndex" || located.relation.kind === "overExpr" || located.relation.kind === "underExpr" || located.relation.kind === "baseExpr" || located.relation.kind === "matrixCell") {
     session.selectedNodeId = located.relation.ownerNodeId;
     return;
   }
@@ -2614,6 +3023,106 @@ function moveCaretVertical(session, direction) {
     appendDebug(next, "moveCaretVertical", "sqrt-radicand-down-exit");
     return next;
   }
+  if (located.relation.kind === "overExpr" && ownerLocated && ownerNode && ownerNode.baseExpr) {
+    if (direction === "down") {
+      next.caret = {
+        chainId: ownerNode.baseExpr.id,
+        index: ownerNode.baseExpr.nodes.length
+      };
+      next.selectedStructureNodeId = null;
+      syncSelectionToCaret(next);
+      appendDebug(next, "moveCaretVertical", "overset-over->base");
+      return next;
+    }
+    next.caret = {
+      chainId: ownerLocated.chain.id,
+      index: ownerLocated.index
+    };
+    next.selectedStructureNodeId = null;
+    syncSelectionToCaret(next);
+    appendDebug(next, "moveCaretVertical", "overset-over-up-exit");
+    return next;
+  }
+  if (located.relation.kind === "baseExpr" && ownerLocated && ownerNode && ownerNode.kind === "overset" && ownerNode.overExpr) {
+    if (direction === "up") {
+      next.caret = {
+        chainId: ownerNode.overExpr.id,
+        index: ownerNode.overExpr.nodes.length
+      };
+      next.selectedStructureNodeId = null;
+      syncSelectionToCaret(next);
+      appendDebug(next, "moveCaretVertical", "overset-base->over");
+      return next;
+    }
+    next.caret = {
+      chainId: ownerLocated.chain.id,
+      index: ownerLocated.index + 1
+    };
+    next.selectedStructureNodeId = null;
+    syncSelectionToCaret(next);
+    appendDebug(next, "moveCaretVertical", "overset-base-down-exit");
+    return next;
+  }
+  if (located.relation.kind === "baseExpr" && ownerLocated && ownerNode && ownerNode.kind === "underset" && ownerNode.underExpr) {
+    if (direction === "down") {
+      next.caret = {
+        chainId: ownerNode.underExpr.id,
+        index: ownerNode.underExpr.nodes.length
+      };
+      next.selectedStructureNodeId = null;
+      syncSelectionToCaret(next);
+      appendDebug(next, "moveCaretVertical", "underset-base->under");
+      return next;
+    }
+    next.caret = {
+      chainId: ownerLocated.chain.id,
+      index: ownerLocated.index
+    };
+    next.selectedStructureNodeId = null;
+    syncSelectionToCaret(next);
+    appendDebug(next, "moveCaretVertical", "underset-base-up-exit");
+    return next;
+  }
+  if (located.relation.kind === "underExpr" && ownerLocated && ownerNode && ownerNode.baseExpr) {
+    if (direction === "up") {
+      next.caret = {
+        chainId: ownerNode.baseExpr.id,
+        index: ownerNode.baseExpr.nodes.length
+      };
+      next.selectedStructureNodeId = null;
+      syncSelectionToCaret(next);
+      appendDebug(next, "moveCaretVertical", "underset-under->base");
+      return next;
+    }
+    next.caret = {
+      chainId: ownerLocated.chain.id,
+      index: ownerLocated.index + 1
+    };
+    next.selectedStructureNodeId = null;
+    syncSelectionToCaret(next);
+    appendDebug(next, "moveCaretVertical", "underset-under-down-exit");
+    return next;
+  }
+  if (located.relation.kind === "baseExpr" && ownerLocated && ownerNode && ownerNode.kind === "accent") {
+    if (direction === "up") {
+      next.caret = {
+        chainId: ownerLocated.chain.id,
+        index: ownerLocated.index
+      };
+      next.selectedStructureNodeId = null;
+      syncSelectionToCaret(next);
+      appendDebug(next, "moveCaretVertical", "accent-base-up-exit");
+      return next;
+    }
+    next.caret = {
+      chainId: ownerLocated.chain.id,
+      index: ownerLocated.index + 1
+    };
+    next.selectedStructureNodeId = null;
+    syncSelectionToCaret(next);
+    appendDebug(next, "moveCaretVertical", "accent-base-down-exit");
+    return next;
+  }
   if (located.relation.kind === "matrixCell" && ownerLocated && ownerNode?.matrixRows) {
     const rowIndex = located.relation.rowIndex ?? 0;
     const columnIndex = located.relation.columnIndex ?? 0;
@@ -2991,6 +3500,119 @@ function insertSqrt(session) {
   appendDebug(next, "insertSqrt", "");
   return next;
 }
+function insertOverset(session) {
+  const base = replaceSelectionFirst(session);
+  const next = cloneEditorSession(base);
+  const englishNode = createOversetNode();
+  const arabicNode = createOversetNode();
+  arabicNode.id = englishNode.id;
+  if (arabicNode.overExpr && englishNode.overExpr) {
+    arabicNode.overExpr.id = englishNode.overExpr.id;
+  }
+  if (arabicNode.baseExpr && englishNode.baseExpr) {
+    arabicNode.baseExpr.id = englishNode.baseExpr.id;
+  }
+  insertMirroredNode(next, next.caret.chainId, next.caret.index, englishNode, arabicNode);
+  next.caret = {
+    chainId: englishNode.overExpr ? englishNode.overExpr.id : next.caret.chainId,
+    index: 0
+  };
+  next.selectedStructureNodeId = null;
+  syncSelectionToCaret(next);
+  appendDebug(next, "insertOverset", "");
+  return next;
+}
+function insertUnderset(session) {
+  const base = replaceSelectionFirst(session);
+  const next = cloneEditorSession(base);
+  const englishNode = createUndersetNode();
+  const arabicNode = createUndersetNode();
+  arabicNode.id = englishNode.id;
+  if (arabicNode.underExpr && englishNode.underExpr) {
+    arabicNode.underExpr.id = englishNode.underExpr.id;
+  }
+  if (arabicNode.baseExpr && englishNode.baseExpr) {
+    arabicNode.baseExpr.id = englishNode.baseExpr.id;
+  }
+  insertMirroredNode(next, next.caret.chainId, next.caret.index, englishNode, arabicNode);
+  next.caret = {
+    chainId: englishNode.underExpr ? englishNode.underExpr.id : next.caret.chainId,
+    index: 0
+  };
+  next.selectedStructureNodeId = null;
+  syncSelectionToCaret(next);
+  appendDebug(next, "insertUnderset", "");
+  return next;
+}
+function insertLimitsSeriesTemplate(session, commandId) {
+  const base = replaceSelectionFirst(session);
+  const next = cloneEditorSession(base);
+  const { english, arabic } = buildLimitsSeriesTemplate(commandId);
+  insertMirroredNode(next, next.caret.chainId, next.caret.index, english, arabic);
+  syncSubtreeRecursive(next, english, arabic);
+  next.caret = limitsSeriesTemplateInitialCaret(english);
+  next.selectedStructureNodeId = null;
+  syncSelectionToCaret(next);
+  appendDebug(next, "insertLimitsSeriesTemplate", commandId);
+  return next;
+}
+function insertAccentPair(session) {
+  const base = replaceSelectionFirst(session);
+  const next = cloneEditorSession(base);
+  const { english, arabic } = buildAccentPairTemplate();
+  insertMirroredNode(next, next.caret.chainId, next.caret.index, english, arabic);
+  syncSubtreeRecursive(next, english, arabic);
+  next.caret = accentPairTemplateInitialCaret(english);
+  next.selectedStructureNodeId = null;
+  syncSelectionToCaret(next);
+  appendDebug(next, "insertAccentPair", "");
+  return next;
+}
+function insertAccent(session, accentId) {
+  const next = cloneEditorSession(session);
+  const englishNode = createAccentNode(accentId);
+  const arabicNode = createAccentNode(accentId);
+  arabicNode.id = englishNode.id;
+  if (arabicNode.baseExpr && englishNode.baseExpr) {
+    arabicNode.baseExpr.id = englishNode.baseExpr.id;
+  }
+  if (isSelectionActive(next.selection) && next.selection) {
+    const sel = next.selection;
+    const { start, end } = normalizeSelection(sel);
+    const englishLocated = findChainById(next.englishTree, sel.chainId);
+    const arabicLocated = findChainById(next.arabicTree, sel.chainId);
+    if (englishLocated && arabicLocated && end > start) {
+      const count = end - start;
+      const englishWrapped = englishLocated.chain.nodes.splice(start, count);
+      const arabicWrapped = arabicLocated.chain.nodes.splice(start, count);
+      englishNode.baseExpr.nodes = englishWrapped;
+      arabicNode.baseExpr.nodes = arabicWrapped;
+      englishLocated.chain.nodes.splice(start, 0, englishNode);
+      arabicLocated.chain.nodes.splice(start, 0, arabicNode);
+      syncSubtreeRecursive(next, englishNode, arabicNode);
+      next.caret = {
+        chainId: englishNode.baseExpr.id,
+        index: englishWrapped.length
+      };
+      next.selection = null;
+      next.selectedStructureNodeId = null;
+      syncSelectionToCaret(next);
+      appendDebug(next, "insertAccent", `${accentId}:wrap`);
+      return next;
+    }
+  }
+  insertMirroredNode(next, next.caret.chainId, next.caret.index, englishNode, arabicNode);
+  syncSubtreeRecursive(next, englishNode, arabicNode);
+  next.caret = {
+    chainId: englishNode.baseExpr ? englishNode.baseExpr.id : next.caret.chainId,
+    index: 0
+  };
+  next.selection = null;
+  next.selectedStructureNodeId = null;
+  syncSelectionToCaret(next);
+  appendDebug(next, "insertAccent", `${accentId}:empty`);
+  return next;
+}
 function insertMatrixEnv(session, style, rows, columns) {
   return insertGridEnv(session, style, rows, columns);
 }
@@ -3238,7 +3860,7 @@ function deleteBackward(session) {
   if (!previousNode) {
     return session;
   }
-  if ((previousNode.kind === "delimiter" || previousNode.kind === "frac" || previousNode.kind === "sqrt" || previousNode.kind === "env") && next.selectedStructureNodeId !== previousNode.id) {
+  if ((previousNode.kind === "delimiter" || previousNode.kind === "frac" || previousNode.kind === "sqrt" || previousNode.kind === "overset" || previousNode.kind === "underset" || previousNode.kind === "accent" || previousNode.kind === "env") && next.selectedStructureNodeId !== previousNode.id) {
     next.selectedStructureNodeId = previousNode.id;
     next.selectedNodeId = previousNode.id;
     appendDebug(next, "deleteBackward", "selected structure");
@@ -3728,6 +4350,168 @@ function buildSqrtNodeBody(node, buildChain, side) {
   return wrap;
 }
 
+// src/editor/display/overset.ts
+var OVERSET_CSS = `
+.overset {
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+  margin: 0 2px;
+  min-width: 1.2em;
+}
+
+.overset-over {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 0.85em;
+  padding: 0 2px;
+  font-size: 0.72em;
+  line-height: 1.1;
+}
+
+.overset-base {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 1.05em;
+  padding: 0 2px;
+}
+`.trim();
+function buildOversetNodeBody(node, buildChain) {
+  const wrap = document.createElement("span");
+  wrap.className = "overset";
+  const over = document.createElement("span");
+  over.className = "overset-over";
+  if (node.overExpr) {
+    over.appendChild(buildChain(node.overExpr));
+  }
+  const base = document.createElement("span");
+  base.className = "overset-base";
+  if (node.baseExpr) {
+    base.appendChild(buildChain(node.baseExpr));
+  }
+  wrap.appendChild(over);
+  wrap.appendChild(base);
+  return wrap;
+}
+
+// src/editor/display/underset.ts
+var UNDERSET_CSS = `
+.underset {
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+  margin: 0 2px;
+  min-width: 1.2em;
+}
+
+.underset-base {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 1.05em;
+  padding: 0 2px;
+}
+
+.underset-under {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 0.85em;
+  padding: 0 2px;
+  font-size: 0.72em;
+  line-height: 1.1;
+}
+`.trim();
+function buildUndersetNodeBody(node, buildChain) {
+  const wrap = document.createElement("span");
+  wrap.className = "underset";
+  const base = document.createElement("span");
+  base.className = "underset-base";
+  if (node.baseExpr) {
+    base.appendChild(buildChain(node.baseExpr));
+  }
+  const under = document.createElement("span");
+  under.className = "underset-under";
+  if (node.underExpr) {
+    under.appendChild(buildChain(node.underExpr));
+  }
+  wrap.appendChild(base);
+  wrap.appendChild(under);
+  return wrap;
+}
+
+// src/editor/display/accent.ts
+var ACCENT_CSS = `
+.math-accent {
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  vertical-align: middle;
+  margin: 0 2px;
+  min-width: 1.1em;
+}
+
+.math-accent-chrome {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 0.7em;
+  padding: 0 2px;
+  font-size: 0.85em;
+  line-height: 1;
+  color: var(--butex-script-color, #475569);
+  user-select: none;
+}
+
+.math-accent-base {
+  display: inline-flex;
+  justify-content: center;
+  align-items: center;
+  min-height: 1.05em;
+  padding: 0 2px;
+}
+
+.math-accent--under .math-accent-chrome {
+  min-height: 0.45em;
+  border-top: 1.5px solid currentColor;
+  width: 100%;
+  font-size: 0;
+  color: var(--butex-surface-fg, #0f172a);
+}
+`.trim();
+function buildAccentNodeBody(node, buildChain) {
+  const wrap = document.createElement("span");
+  const spec = accentCommandSpec(node.expr);
+  const placement = spec?.placement ?? "over";
+  wrap.className = placement === "under" ? "math-accent math-accent--under" : "math-accent math-accent--over";
+  const chrome = document.createElement("span");
+  chrome.className = "math-accent-chrome";
+  chrome.setAttribute("aria-hidden", "true");
+  if (placement === "over") {
+    chrome.textContent = spec?.label ?? "\u02C6";
+  }
+  const base = document.createElement("span");
+  base.className = "math-accent-base";
+  if (node.baseExpr) {
+    base.appendChild(buildChain(node.baseExpr));
+  }
+  if (placement === "under") {
+    wrap.appendChild(base);
+    wrap.appendChild(chrome);
+  } else {
+    wrap.appendChild(chrome);
+    wrap.appendChild(base);
+  }
+  return wrap;
+}
+
 // src/editor/display/env.ts
 var WRAPPERS = {
   matrix: { left: "", right: "" },
@@ -4100,6 +4884,15 @@ function buildNodeBody(node, buildChain, side, digitForm = "western", uiLocale =
   if (node.kind === "sqrt") {
     return buildSqrtNodeBody(node, buildChain, side);
   }
+  if (node.kind === "overset") {
+    return buildOversetNodeBody(node, buildChain);
+  }
+  if (node.kind === "underset") {
+    return buildUndersetNodeBody(node, buildChain);
+  }
+  if (node.kind === "accent") {
+    return buildAccentNodeBody(node, buildChain);
+  }
   if (node.kind === "env") {
     return buildMatrixEnvNodeBody(node, buildChain, side);
   }
@@ -4299,6 +5092,12 @@ ${FRAC_CSS}
 
 ${SQRT_CSS}
 
+${OVERSET_CSS}
+
+${UNDERSET_CSS}
+
+${ACCENT_CSS}
+
 ${MATRIX_ENV_CSS}
 
 ${ATOMIC_COMMAND_CSS}
@@ -5018,6 +5817,26 @@ function createEditorRuntime(options) {
       applyStructural((prev) => insertSqrt(prev));
       surfaceEl.focus();
     },
+    insertOverset: () => {
+      applyStructural((prev) => insertOverset(prev));
+      surfaceEl.focus();
+    },
+    insertUnderset: () => {
+      applyStructural((prev) => insertUnderset(prev));
+      surfaceEl.focus();
+    },
+    insertLimitsSeriesTemplate: (commandId) => {
+      applyStructural((prev) => insertLimitsSeriesTemplate(prev, commandId));
+      surfaceEl.focus();
+    },
+    insertAccentPair: () => {
+      applyStructural((prev) => insertAccentPair(prev));
+      surfaceEl.focus();
+    },
+    insertAccent: (accentId) => {
+      applyStructural((prev) => insertAccent(prev, accentId));
+      surfaceEl.focus();
+    },
     insertAtomicCommand: (commandId) => {
       applyStructural((prev) => insertAtomicCommand(prev, commandId));
       surfaceEl.focus();
@@ -5659,6 +6478,29 @@ var WIDGET_CHROME_CSS = `
   padding-top: 1px;
 }
 
+.butex-widget .toolbar-accent-icon {
+  display: inline-flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  min-width: 14px;
+  font-size: 10px;
+  line-height: 1;
+  gap: 1px;
+}
+
+.butex-widget .toolbar-accent-icon--over span:first-child,
+.butex-widget .toolbar-accent-icon--under span:last-child {
+  font-size: 8px;
+  opacity: 0.85;
+}
+
+.butex-widget .toolbar-accent-icon--pair span:first-child,
+.butex-widget .toolbar-accent-icon--pair span:last-child {
+  font-size: 8px;
+  opacity: 0.85;
+}
+
 .butex-widget .matrix-command-menu {
   position: relative;
   display: inline-flex;
@@ -6400,6 +7242,7 @@ var CHARACTER_FONT_OPTIONS = [
   { id: "diwani", label: "\u062F\u064A\u0648" },
   { id: "diwaniOutline", label: "\u0638\u0644" }
 ];
+var ACCENT_COMMANDS_LIST = accentCommandsList();
 var FUNCTION_COMMANDS = atomicCommandsByCategory("function");
 var LIMITS_SERIES_COMMANDS = atomicCommandsByCategory("limits_series");
 var FUNCTION2_COMMANDS = atomicCommandsByCategory("function2");
@@ -6547,6 +7390,7 @@ var ButexEditor = forwardRef(
     const [operator2MenuOpen, setOperator2MenuOpen] = useState(false);
     const [operator3MenuOpen, setOperator3MenuOpen] = useState(false);
     const [dotMenuOpen, setDotMenuOpen] = useState(false);
+    const [accentMenuOpen, setAccentMenuOpen] = useState(false);
     const [integralMenuOpen, setIntegralMenuOpen] = useState(false);
     const [selectedDigitForm2, setSelectedDigitForm] = useState("western");
     const [selectedCharacterFont, setSelectedCharacterFont] = useState("default");
@@ -6816,7 +7660,78 @@ ${arabic || currentMessages.empty}`;
                 /* @__PURE__ */ jsx("button", { id: "insert-sqrt", className: "icon-btn", type: "button", title: messages.insertRoot, "aria-label": messages.insertRoot, onClick: () => {
                   runtimeRef.current?.insertSqrt();
                   focusSurface();
-                }, children: /* @__PURE__ */ jsx("span", { className: "toolbar-sqrt-icon", "aria-hidden": "true", children: "\u221A" }) })
+                }, children: /* @__PURE__ */ jsx("span", { className: "toolbar-sqrt-icon", "aria-hidden": "true", children: "\u221A" }) }),
+                /* @__PURE__ */ jsx("button", { id: "insert-overset", className: "icon-btn", type: "button", title: messages.insertOverset, "aria-label": messages.insertOverset, onClick: () => {
+                  runtimeRef.current?.insertOverset();
+                  focusSurface();
+                }, children: /* @__PURE__ */ jsxs("span", { className: "toolbar-accent-icon toolbar-accent-icon--over", "aria-hidden": "true", children: [
+                  /* @__PURE__ */ jsx("span", { children: "\u2217" }),
+                  /* @__PURE__ */ jsx("span", { children: "\u25A1" })
+                ] }) }),
+                /* @__PURE__ */ jsx("button", { id: "insert-underset", className: "icon-btn", type: "button", title: messages.insertUnderset, "aria-label": messages.insertUnderset, onClick: () => {
+                  runtimeRef.current?.insertUnderset();
+                  focusSurface();
+                }, children: /* @__PURE__ */ jsxs("span", { className: "toolbar-accent-icon toolbar-accent-icon--under", "aria-hidden": "true", children: [
+                  /* @__PURE__ */ jsx("span", { children: "\u25A1" }),
+                  /* @__PURE__ */ jsx("span", { children: "\u2217" })
+                ] }) }),
+                /* @__PURE__ */ jsx("button", { id: "insert-accent-pair", className: "icon-btn", type: "button", title: messages.insertAccentPair, "aria-label": messages.insertAccentPair, onClick: () => {
+                  runtimeRef.current?.insertAccentPair();
+                  focusSurface();
+                }, children: /* @__PURE__ */ jsxs("span", { className: "toolbar-accent-icon toolbar-accent-icon--pair", "aria-hidden": "true", children: [
+                  /* @__PURE__ */ jsx("span", { children: "\u2217" }),
+                  /* @__PURE__ */ jsx("span", { children: "\u25A1" }),
+                  /* @__PURE__ */ jsx("span", { children: "\u2217" })
+                ] }) }),
+                /* @__PURE__ */ jsxs(
+                  "div",
+                  {
+                    className: "function-command-menu operator-command-menu",
+                    onBlur: (event) => {
+                      const nextFocus = event.relatedTarget;
+                      if (!(nextFocus instanceof Node) || !event.currentTarget.contains(nextFocus)) {
+                        setAccentMenuOpen(false);
+                      }
+                    },
+                    children: [
+                      /* @__PURE__ */ jsx(
+                        "button",
+                        {
+                          id: "insert-accents",
+                          className: "icon-btn function-command-btn operator-command-btn",
+                          type: "button",
+                          title: messages.insertAccents,
+                          "aria-label": messages.insertAccents,
+                          "aria-haspopup": "listbox",
+                          "aria-expanded": accentMenuOpen,
+                          onClick: () => setAccentMenuOpen((open) => !open),
+                          children: /* @__PURE__ */ jsxs("span", { className: "toolbar-accent-icon toolbar-accent-icon--over", "aria-hidden": "true", children: [
+                            /* @__PURE__ */ jsx("span", { children: "\u02C6" }),
+                            /* @__PURE__ */ jsx("span", { children: "\u25A1" })
+                          ] })
+                        }
+                      ),
+                      /* @__PURE__ */ jsx("div", { className: "function-command-options operator-command-options", role: "listbox", "aria-label": messages.insertAccents, hidden: !accentMenuOpen, children: ACCENT_COMMANDS_LIST.map((command) => /* @__PURE__ */ jsx(
+                        "button",
+                        {
+                          className: "function-command-option operator-command-option",
+                          type: "button",
+                          role: "option",
+                          title: accentCommandTitle(command, uiLocale),
+                          "aria-label": accentCommandTitle(command, uiLocale),
+                          onMouseDown: (event) => event.preventDefault(),
+                          onClick: () => {
+                            runtimeRef.current?.insertAccent(command.id);
+                            setAccentMenuOpen(false);
+                            focusSurface();
+                          },
+                          children: /* @__PURE__ */ jsx("span", { className: "operator-command-label", children: command.label })
+                        },
+                        command.id
+                      )) })
+                    ]
+                  }
+                )
               ] }),
               /* @__PURE__ */ jsx("div", { className: "toolbar-group toolbar-environments", role: "group", "aria-label": messages.environments, children: /* @__PURE__ */ jsxs(
                 "div",
@@ -7144,7 +8059,7 @@ ${arabic || currentMessages.empty}`;
                           "aria-label": atomicCommandTitle(command, uiLocale),
                           onMouseDown: (event) => event.preventDefault(),
                           onClick: () => {
-                            runtimeRef.current?.insertAtomicCommand(command.id);
+                            runtimeRef.current?.insertLimitsSeriesTemplate(command.id);
                             setLimitsSeriesMenuOpen(false);
                             focusSurface();
                           },