@drghaliasri/butex 5.5.0 → 5.5.2

package/README.md

@@ -19,8 +19,8 @@ The intended editor model is **AST-first**:
 ## Rendering outputs and MVP scope
 
 - **CommonHTML (`chtml`)** and **SVG** are supported. Load the matching MathJax 4 bundle (`tex-chtml.js` vs `tex-svg.js`) and pass the same mode as `output` to `renderBuTeXMathIsland` / `mountBuTeXMathIsland`. `<ButexEditor />` and document math preview follow the loaded bundle when possible (`tex2chtml` vs `tex2svg`).
-- `\arabsqrt`: optional index + mandatory radicand (same argument shape as `\sqrt`).
-- Compatibility macros: `\arsqrt` aliases `\arabsqrt`; `\unit{...}` and `\idx{...}` are browser-side passthrough wrappers for imported/reference TeX.
+- `\arsqrt`: canonical serialized Arabic TeX command with an optional index and mandatory radicand (same argument shape as `\sqrt`).
+- Compatibility macros: MathJax accepts `\arabsqrt` as an alias of `\arsqrt`; `\unit{...}` and `\idx{...}` are browser-side passthrough wrappers for imported/reference TeX.
 - **Arabic surface parser** (`parseBuTeX`) — optional helper that maps a tiny subset of Arabic command names to MathJax-safe TeX before rendering (see below). Long-term editor state is structured AST/JSON, not this string transform alone.
 
 ## Arabic preprocessor (`parseBuTeX`)
@@ -173,6 +173,7 @@ Shipped as a separate entry so apps that do not use React never pull it in.
 - Import: `import { ButexEditor } from 'butex/react'`.
 - Peer dependencies when using this entry: `react` and `react-dom` (^18 or ^19).
 - The component wraps `Editor.createEditorRuntime` (toolbar, surface, MathJax preview strip, optional dev panels via `debug`).
+- Touch devices use a textarea-backed input bridge, so tapping the structured equation surface opens the software keyboard and supports normal text, deletion, and composed/IME input without making TeX strings the editor state.
 - Load MathJax and register BuTeX **before** relying on the preview (same timing as the GUI contract above). Equation preview in `ButexEditor` uses the same `renderBuTeXMathIsland` path as document math islands (output follows the loaded bundle: SVG when `tex2svg` is available, otherwise CHTML). Optional legacy `mountBuTeXMathTypeset` (`typesetPromise`) remains exported for hosts that still rely on it.
 - Next.js App Router: put BuTeX in a **client component** (`'use client'`).
 
@@ -253,7 +254,7 @@ const latex = document2Latex(documentNode);
 const preview = document2Preview(documentNode, 'svg');
 ```
 
-`document2Latex(doc)` emits a **complete Arabic XeLaTeX document** by default (preamble + `\begin{document}` + body + `\end{document}`). Pass `{ wrapDocument: false }` for body-only blocks. Paragraph blocks export as `\par` followed by the inline content, so prose, citations, and math are not wrapped inside `\paragraph{...}`. Optional `digitsMapping: 'arabicdigits' | 'digits'` controls eastern vs western digit font mapping in the preamble (default `'arabicdigits'`). Pass `{ twocolumn: true }` for `\documentclass[12pt,a4paper,notitlepage,twocolumn]{article}` (title block stays in-column; figures use `\columnwidth`). See [`examples/example-latex-export.tex`](examples/example-latex-export.tex) for a full sample (regenerated by the wrap vitest). Hosts can also call `getArabicXeLatexPreamble()` alone.
+`document2Latex(doc)` emits a **complete Arabic XeLaTeX document** by default (preamble + `\begin{document}` + body + `\end{document}`). Structured and editor-authored Arabic roots serialize with the canonical `\arsqrt`; the bundled preamble also accepts raw legacy `\arabsqrt` with the same optional-index signature. Pass `{ wrapDocument: false }` for body-only blocks. Paragraph blocks export as `\par` followed by the inline content, so prose, citations, and math are not wrapped inside `\paragraph{...}`. Optional `digitsMapping: 'arabicdigits' | 'digits'` controls eastern vs western digit font mapping in the preamble (default `'arabicdigits'`). Pass `{ twocolumn: true }` for `\documentclass[12pt,a4paper,notitlepage,twocolumn]{article}` (title block stays in-column; figures use `\columnwidth`). See [`examples/example-latex-export.tex`](examples/example-latex-export.tex) for a full sample (regenerated by the wrap vitest). Hosts can also call `getArabicXeLatexPreamble()` alone.
 
 Figures and tables always export as centered `figure` / `table` floats. Optional caption/label fields (checkbox-driven in the editor) emit `\caption` / `\label`. Display math stays `\[…\]` unless an equation label is enabled, then export uses `\begin{equation}…\label{…}\end{equation}`. Internal cross-refs use `\ref` / `\eqref` tokens (separate from bibliography `\cite`).
 

package/dist/document.js

@@ -227,7 +227,7 @@ var CommandNode = class extends BaseAstNode {
   arabicLatex() {
     const sup = this.superscript !== null ? this.superscript.arabicLatex() : "";
     const sub = this.subscript !== null ? this.subscript.arabicLatex() : "";
-    const arabicName = this.name === "\\sqrt" ? "\\arabsqrt" : this.name;
+    const arabicName = this.name === "\\sqrt" || this.name === "\\arabsqrt" ? "\\arsqrt" : this.name;
     const content = renderCommandCore({
       name: arabicName,
       optionalArgs: this.optionalArgs,
@@ -1898,7 +1898,7 @@ function renderNodeArabic(node, options) {
     return arabicScripts(node, content, options);
   }
   if (node.kind === "sqrt" && node.radicand) {
-    const content = `\\arabsqrt${optionalRootIndexArabic(node, options)}{${renderChainArabic(node.radicand, options)}}`;
+    const content = `\\arsqrt${optionalRootIndexArabic(node, options)}{${renderChainArabic(node.radicand, options)}}`;
     return arabicScripts(node, content, options);
   }
   if (node.kind === "overset" && node.baseExpr) {
@@ -2431,7 +2431,8 @@ ${BUTEX_FONT_FACE_CSS}
   transition: box-shadow 0.15s ease, border-color 0.15s ease;
 }
 
-.surface:focus {
+.surface:focus,
+.surface.surface--typing-focus {
   border-color: var(--butex-focus-border, rgba(13, 148, 136, 0.45));
   box-shadow: 0 0 0 3px var(--butex-focus-shadow, rgba(13, 148, 136, 0.12));
 }