@drghaliasri/butex 3.2.2

package/dist/index.d.mts

@@ -0,0 +1,1430 @@
+/**
+ * Styles for Arabic RTL radical rendering via double horizontal reflection.
+ * Inject once per document (e.g. append a `<style>` tag).
+ */
+declare const BUTEX_CHROME_CSS: string;
+
+/**
+ * Minimal typings for MathJax internals used by BuTeX.
+ */
+interface GlobalMathJax {
+    _: {
+        input: {
+            tex: TexModule;
+        };
+        output?: {
+            svg?: SvgOutputModule;
+        };
+    };
+    config?: {
+        tex?: {
+            packages?: unknown;
+        };
+    };
+    startup?: {
+        output?: {
+            factory?: unknown;
+        };
+    };
+}
+/**
+ * Minimal shape of MathJax's SVG output internals that the BuTeX SVG text
+ * wrapper swaps into. Everything is optional/loose because we only reach in to
+ * replace the `mtext` wrapper class.
+ */
+interface SvgOutputModule {
+    WrapperFactory?: {
+        SvgWrapperFactory?: unknown;
+    };
+    Wrappers?: {
+        SvgWrappers?: Record<string, unknown>;
+        mtext?: {
+            SvgMtext?: unknown;
+        };
+    };
+}
+interface TexModule {
+    Configuration: {
+        Configuration: {
+            create(name: string, config: Record<string, unknown>): unknown;
+        };
+        ConfigurationHandler: {
+            set(name: string, configuration: unknown): void;
+        };
+    };
+    HandlerTypes: {
+        HandlerType: {
+            MACRO: string;
+        };
+        ConfigurationType: {
+            HANDLER: string;
+        };
+    };
+    TokenMap: {
+        CommandMap: new (name: string, mapping: Record<string, ParseMethod>) => unknown;
+    };
+    NodeUtil: {
+        default: {
+            setAttribute(node: unknown, attr: string, value: unknown): void;
+        };
+    };
+}
+type ParseMethod = (parser: TexParserLike, name: string, ...rest: unknown[]) => void;
+interface TexParserLike {
+    stack: {
+        env: Record<string, unknown>;
+    };
+    configuration: unknown;
+    GetBrackets(name: string): string;
+    GetArgument(name: string): string;
+    create(kind: string, ...args: unknown[]): unknown;
+    Push(node: unknown): void;
+}
+
+/** Public configuration package id — must appear in `tex.packages`. */
+declare const BUTEX_TEX_PACKAGE = "butex-arabic-math";
+/**
+ * Registers the `\arabsqrt` TeX extension with MathJax.
+ *
+ * Call **once**, synchronously, inside `MathJax.startup.ready()` **before**
+ * `MathJax.startup.defaultReady()`, after TeX input code has loaded (see README).
+ */
+declare function registerBuTeX(mathJax: GlobalMathJax): void;
+
+declare const BUTEX_EDITOR_CSS: string;
+/**
+ * Injects BuTeX editor surface styles into `document.head` if not already present.
+ * Browser-only; no-op if `document` is undefined (Node).
+ */
+declare function injectBuTeXEditorStyles(doc?: Document): void;
+
+type EditorSide = 'english' | 'arabic';
+type EditorNodeKind = 'char' | 'number' | 'operator' | 'delimiter' | 'frac' | 'sqrt' | 'env' | 'atomicCommand' | 'atomicOperatorCommand';
+type MatrixEnvStyle = 'matrix' | 'pmatrix' | 'bmatrix' | 'Bmatrix' | 'vmatrix' | 'Vmatrix';
+type GridEnvName = MatrixEnvStyle | 'array' | 'aligned';
+type EnvColumnAlignment = 'l' | 'c' | 'r';
+type CharacterFontId = 'default' | 'takween' | 'diwani' | 'diwaniOutline';
+type DigitFormId = 'western' | 'arabicIndic' | 'persianIndic';
+type EditorSyncState = 'synced' | 'diverged';
+type EditorChain = {
+    id: string;
+    nodes: EditorNode[];
+};
+type EditorNode = {
+    id: string;
+    kind: EditorNodeKind;
+    expr: string;
+    characterFont?: CharacterFontId;
+    superscript: EditorChain | null;
+    subscript: EditorChain | null;
+    leftDelimExpr: string;
+    rightDelimExpr: string;
+    innerExpr: EditorChain | null;
+    numerator: EditorChain | null;
+    denominator: EditorChain | null;
+    radicand: EditorChain | null;
+    rootIndex: EditorChain | null;
+    envName: GridEnvName | null;
+    matrixStyle: MatrixEnvStyle | null;
+    matrixRows: EditorChain[][] | null;
+    columnAlignments: EnvColumnAlignment[] | null;
+};
+type EditorCaret = {
+    chainId: string;
+    index: number;
+};
+type EditorSelectionRange = {
+    chainId: string;
+    anchorIndex: number;
+    focusIndex: number;
+};
+type EditorSyncMap = Record<string, {
+    expr: EditorSyncState;
+}>;
+type EditorDebugEntry = {
+    timestamp: string;
+    command: string;
+    activeSide: EditorSide;
+    englishLatex: string;
+    arabicLatex: string;
+    renderOk: boolean;
+    renderError: string | null;
+    note: string;
+};
+type EditorSession = {
+    englishTree: EditorChain;
+    arabicTree: EditorChain;
+    activeSide: EditorSide;
+    /** When true, each typed letter/digit inserts a new char/number leaf; when false, merge into adjacent same-kind leaves. */
+    splitLeafTyping: boolean;
+    /** One-shot: when true, the next insertChar/insertNumber bypasses leaf-merge (used by Space in merge mode). */
+    forceSplitNextLeaf: boolean;
+    /** When true and active side is Arabic, merged number typing prepends digits (RTL-style); still mirrored on EN/AR. */
+    arabicReverseNumberTyping: boolean;
+    /** Font applied to newly typed char nodes. */
+    currentCharacterFont: CharacterFontId;
+    /** Digit glyph form used for editor display and LaTeX preview output. */
+    currentDigitForm: DigitFormId;
+    caret: EditorCaret;
+    /** Whole-node range selection inside a single chain (anchor==focus means no selection). */
+    selection: EditorSelectionRange | null;
+    selectedNodeId: string | null;
+    selectedStructureNodeId: string | null;
+    sync: EditorSyncMap;
+    debugLog: EditorDebugEntry[];
+};
+
+declare const ATOMIC_COMMANDS: {
+    readonly cos: {
+        readonly id: "cos";
+        readonly category: "function";
+        readonly englishTex: "\\cos";
+        readonly arabicTex: "\\arcos";
+        readonly arabicLabel: "جتا";
+        readonly title: "جيب التمام";
+    };
+    readonly sin: {
+        readonly id: "sin";
+        readonly category: "function";
+        readonly englishTex: "\\sin";
+        readonly arabicTex: "\\arsin";
+        readonly arabicLabel: "جا";
+        readonly title: "جيب";
+    };
+    readonly tan: {
+        readonly id: "tan";
+        readonly category: "function";
+        readonly englishTex: "\\tan";
+        readonly arabicTex: "\\artan";
+        readonly arabicLabel: "ظا";
+        readonly title: "ظل";
+    };
+    readonly cot: {
+        readonly id: "cot";
+        readonly category: "function";
+        readonly englishTex: "\\cot";
+        readonly arabicTex: "\\arcot";
+        readonly arabicLabel: "ظتا";
+        readonly title: "ظل تمام";
+    };
+    readonly sec: {
+        readonly id: "sec";
+        readonly category: "function";
+        readonly englishTex: "\\sec";
+        readonly arabicTex: "\\arsec";
+        readonly arabicLabel: "قا";
+        readonly title: "قاطع";
+    };
+    readonly csc: {
+        readonly id: "csc";
+        readonly category: "function";
+        readonly englishTex: "\\csc";
+        readonly arabicTex: "\\arcsc";
+        readonly arabicLabel: "قتا";
+        readonly title: "قاطع تمام";
+    };
+    readonly arccos: {
+        readonly id: "arccos";
+        readonly category: "function";
+        readonly englishTex: "\\arccos";
+        readonly arabicTex: "\\aracos";
+        readonly arabicLabel: "قجتا";
+        readonly title: "قاطع جيب التمام";
+    };
+    readonly arcsin: {
+        readonly id: "arcsin";
+        readonly category: "function";
+        readonly englishTex: "\\arcsin";
+        readonly arabicTex: "\\arasin";
+        readonly arabicLabel: "قجا";
+        readonly title: "قاطع جيب";
+    };
+    readonly arctan: {
+        readonly id: "arctan";
+        readonly category: "function";
+        readonly englishTex: "\\arctan";
+        readonly arabicTex: "\\aratan";
+        readonly arabicLabel: "قظا";
+        readonly title: "قاطع ظل";
+    };
+    readonly arccot: {
+        readonly id: "arccot";
+        readonly category: "function";
+        readonly englishTex: "\\arccot";
+        readonly arabicTex: "\\aracot";
+        readonly arabicLabel: "قظتا";
+        readonly title: "قاطع ظل التمام";
+    };
+    readonly arcsec: {
+        readonly id: "arcsec";
+        readonly category: "function";
+        readonly englishTex: "\\arcsec";
+        readonly arabicTex: "\\arasec";
+        readonly arabicLabel: "ققا";
+        readonly title: "قاطع القاطع";
+    };
+    readonly arccsc: {
+        readonly id: "arccsc";
+        readonly category: "function";
+        readonly englishTex: "\\arccsc";
+        readonly arabicTex: "\\aracsc";
+        readonly arabicLabel: "ققتا";
+        readonly title: "قاطع القاطع التمام";
+    };
+    readonly cosh: {
+        readonly id: "cosh";
+        readonly category: "function";
+        readonly englishTex: "\\cosh";
+        readonly arabicTex: "\\arcosh";
+        readonly arabicLabel: "جتزا";
+        readonly title: "جيب التمام الزائد";
+    };
+    readonly sinh: {
+        readonly id: "sinh";
+        readonly category: "function";
+        readonly englishTex: "\\sinh";
+        readonly arabicTex: "\\arsinh";
+        readonly arabicLabel: "جزا";
+        readonly title: "جيب الزائد";
+    };
+    readonly tanh: {
+        readonly id: "tanh";
+        readonly category: "function";
+        readonly englishTex: "\\tanh";
+        readonly arabicTex: "\\artanh";
+        readonly arabicLabel: "ظزا";
+        readonly title: "ظل الزائد";
+    };
+    readonly coth: {
+        readonly id: "coth";
+        readonly category: "function";
+        readonly englishTex: "\\coth";
+        readonly arabicTex: "\\arcoth";
+        readonly arabicLabel: "ظتزا";
+        readonly title: "ظل تمام الزائد";
+    };
+    readonly sum: {
+        readonly id: "sum";
+        readonly category: "limits_series";
+        readonly englishTex: "\\sum";
+        readonly arabicTex: "\\arsum";
+        readonly arabicLabel: "مجـــ";
+        readonly title: "مجموع";
+    };
+    readonly prod: {
+        readonly id: "prod";
+        readonly category: "limits_series";
+        readonly englishTex: "\\prod";
+        readonly arabicTex: "\\arprod";
+        readonly arabicLabel: "جـــد";
+        readonly title: "جداء";
+    };
+    readonly lim: {
+        readonly id: "lim";
+        readonly category: "limits_series";
+        readonly englishTex: "\\lim";
+        readonly arabicTex: "\\arlim";
+        readonly arabicLabel: "نـــــها";
+        readonly title: "حد";
+    };
+    readonly max: {
+        readonly id: "max";
+        readonly category: "limits_series";
+        readonly englishTex: "\\max";
+        readonly arabicTex: "\\armax";
+        readonly arabicLabel: "أكبر";
+        readonly title: "أكبر";
+    };
+    readonly min: {
+        readonly id: "min";
+        readonly category: "limits_series";
+        readonly englishTex: "\\min";
+        readonly arabicTex: "\\armin";
+        readonly arabicLabel: "أصغر";
+        readonly title: "أصغر";
+    };
+    readonly sup: {
+        readonly id: "sup";
+        readonly category: "limits_series";
+        readonly englishTex: "\\sup";
+        readonly arabicTex: "\\arsup";
+        readonly arabicLabel: "أعلى";
+        readonly title: "أعلى";
+    };
+    readonly inf: {
+        readonly id: "inf";
+        readonly category: "limits_series";
+        readonly englishTex: "\\inf";
+        readonly arabicTex: "\\arinf";
+        readonly arabicLabel: "أدنى";
+        readonly title: "أدنى";
+    };
+    readonly pi: {
+        readonly id: "pi";
+        readonly category: "function2";
+        readonly englishTex: "\\pi";
+        readonly arabicTex: "\\arpi";
+        readonly arabicLabel: "ط";
+        readonly title: "نسبة الدائرة";
+    };
+    readonly exp: {
+        readonly id: "exp";
+        readonly category: "function2";
+        readonly englishTex: "\\exp";
+        readonly arabicTex: "\\arexp";
+        readonly arabicLabel: "هـ";
+        readonly title: "أسية";
+    };
+    readonly ln: {
+        readonly id: "ln";
+        readonly category: "function2";
+        readonly englishTex: "\\ln";
+        readonly arabicTex: "\\arln";
+        readonly arabicRenderTex: "\\prescript{}{\\arexp}{\\arlog}";
+        readonly arabicLabel: "لو";
+        readonly title: "لوغاريتم طبيعي";
+    };
+    readonly log: {
+        readonly id: "log";
+        readonly category: "function2";
+        readonly englishTex: "\\log";
+        readonly arabicTex: "\\arlog";
+        readonly arabicLabel: "لو";
+        readonly title: "لوغاريتم";
+    };
+    readonly det: {
+        readonly id: "det";
+        readonly category: "function2";
+        readonly englishTex: "\\det";
+        readonly arabicTex: "\\ardet";
+        readonly arabicLabel: "محدد";
+        readonly title: "محدد";
+    };
+    readonly N: {
+        readonly id: "N";
+        readonly category: "groups";
+        readonly englishTex: "\\mathbb{N}";
+        readonly arabicTex: "\\arabN";
+        readonly arabicLabel: "ط";
+        readonly title: "أعداد طبيعية";
+    };
+    readonly Z: {
+        readonly id: "Z";
+        readonly category: "groups";
+        readonly englishTex: "\\mathbb{Z}";
+        readonly arabicTex: "\\arabZ";
+        readonly arabicLabel: "ص";
+        readonly title: "أعداد صحيحة";
+    };
+    readonly Q: {
+        readonly id: "Q";
+        readonly category: "groups";
+        readonly englishTex: "\\mathbb{Q}";
+        readonly arabicTex: "\\arabQ";
+        readonly arabicLabel: "ن";
+        readonly title: "أعداد نسبية";
+    };
+    readonly R: {
+        readonly id: "R";
+        readonly category: "groups";
+        readonly englishTex: "\\mathbb{R}";
+        readonly arabicTex: "\\arabR";
+        readonly arabicLabel: "ح";
+        readonly title: "أعداد حقيقية";
+    };
+    readonly C: {
+        readonly id: "C";
+        readonly category: "groups";
+        readonly englishTex: "\\mathbb{C}";
+        readonly arabicTex: "\\arabC";
+        readonly arabicLabel: "ع";
+        readonly title: "أعداد عُقدية";
+    };
+    readonly H: {
+        readonly id: "H";
+        readonly category: "groups";
+        readonly englishTex: "\\mathbb{H}";
+        readonly arabicTex: "\\arabH";
+        readonly arabicLabel: "ر";
+        readonly title: "أعداد رباعية";
+    };
+    readonly negThinSpace: {
+        readonly id: "negThinSpace";
+        readonly category: "spacing";
+        readonly englishTex: "\\!";
+        readonly arabicTex: "\\!";
+        readonly arabicLabel: "";
+        readonly title: "فراغ سالب رفيع";
+        readonly spacing: {
+            readonly direction: "negative";
+            readonly level: 1;
+        };
+    };
+    readonly mediumSpace: {
+        readonly id: "mediumSpace";
+        readonly category: "spacing";
+        readonly englishTex: "\\:";
+        readonly arabicTex: "\\:";
+        readonly arabicLabel: "";
+        readonly title: "فراغ متوسط";
+        readonly spacing: {
+            readonly direction: "positive";
+            readonly level: 1;
+        };
+    };
+    readonly thickSpace: {
+        readonly id: "thickSpace";
+        readonly category: "spacing";
+        readonly englishTex: "\\;";
+        readonly arabicTex: "\\;";
+        readonly arabicLabel: "";
+        readonly title: "فراغ عريض";
+        readonly spacing: {
+            readonly direction: "positive";
+            readonly level: 2;
+        };
+    };
+    readonly quadSpace: {
+        readonly id: "quadSpace";
+        readonly category: "spacing";
+        readonly englishTex: "\\quad";
+        readonly arabicTex: "\\quad";
+        readonly arabicLabel: "";
+        readonly title: "فراغ كبير";
+        readonly spacing: {
+            readonly direction: "positive";
+            readonly level: 3;
+        };
+    };
+    readonly qquadSpace: {
+        readonly id: "qquadSpace";
+        readonly category: "spacing";
+        readonly englishTex: "\\qquad";
+        readonly arabicTex: "\\qquad";
+        readonly arabicLabel: "";
+        readonly title: "فراغ كبير جدا";
+        readonly spacing: {
+            readonly direction: "positive";
+            readonly level: 4;
+        };
+    };
+};
+type AtomicCommandId = keyof typeof ATOMIC_COMMANDS;
+type AtomicCommandCategory = 'function' | 'function2' | 'limits_series' | 'groups' | 'spacing';
+type SpacingDirection = 'positive' | 'negative';
+type AtomicCommandSpec = (typeof ATOMIC_COMMANDS)[AtomicCommandId] & {
+    arabicRenderTex?: string;
+};
+type SpacingCommandSpec = AtomicCommandSpec & {
+    category: 'spacing';
+    spacing: {
+        direction: SpacingDirection;
+        level: 1 | 2 | 3 | 4;
+    };
+};
+declare function atomicCommandsByCategory(category: AtomicCommandCategory): AtomicCommandSpec[];
+declare function isSpacingCommandSpec(spec: AtomicCommandSpec | null): spec is SpacingCommandSpec;
+declare function atomicCommandSpec(id: string): AtomicCommandSpec | null;
+
+declare const ATOMIC_OPERATOR_COMMANDS: {
+    readonly inf: {
+        readonly id: "inf";
+        readonly category: "operators1";
+        readonly Tex: "\\infty";
+        readonly mirror: true;
+        readonly Label: "∞";
+        readonly title: "اللانهاية";
+        readonly svg_path: null;
+    };
+    readonly times: {
+        readonly id: "times";
+        readonly category: "operators1";
+        readonly Tex: "\\times";
+        readonly mirror: false;
+        readonly Label: "×";
+        readonly title: "ضرب";
+        readonly svg_path: null;
+    };
+    readonly div: {
+        readonly id: "div";
+        readonly category: "operators1";
+        readonly Tex: "\\div";
+        readonly mirror: false;
+        readonly Label: "÷";
+        readonly title: "قسمة";
+        readonly svg_path: null;
+    };
+    readonly pm: {
+        readonly id: "pm";
+        readonly category: "operators1";
+        readonly Tex: "\\pm";
+        readonly mirror: false;
+        readonly Label: "±";
+        readonly title: "زائد أو ناقص";
+        readonly svg_path: null;
+    };
+    readonly mp: {
+        readonly id: "mp";
+        readonly category: "operators1";
+        readonly Tex: "\\mp";
+        readonly mirror: false;
+        readonly Label: "∓";
+        readonly title: "ناقص أو زائد";
+        readonly svg_path: null;
+    };
+    readonly neq: {
+        readonly id: "neq";
+        readonly category: "operators1";
+        readonly Tex: "\\neq";
+        readonly mirror: false;
+        readonly Label: "≠";
+        readonly title: "لا يساوي";
+        readonly svg_path: null;
+    };
+    readonly approx: {
+        readonly id: "approx";
+        readonly category: "operators1";
+        readonly Tex: "\\approx";
+        readonly mirror: false;
+        readonly Label: "≈";
+        readonly title: "تقريبا يساوي";
+        readonly svg_path: null;
+    };
+    readonly sim: {
+        readonly id: "sim";
+        readonly category: "operators1";
+        readonly Tex: "\\sim";
+        readonly mirror: false;
+        readonly Label: "∼";
+        readonly title: "مشابه";
+        readonly svg_path: null;
+    };
+    readonly mid: {
+        readonly id: "mid";
+        readonly category: "operators1";
+        readonly Tex: "\\mid";
+        readonly mirror: false;
+        readonly Label: "∣";
+        readonly title: "يقسم";
+        readonly svg_path: null;
+    };
+    readonly leq: {
+        readonly id: "leq";
+        readonly category: "operators1";
+        readonly Tex: "\\leq";
+        readonly mirror: true;
+        readonly Label: "≤";
+        readonly title: "أصغر من أو يساوي";
+        readonly svg_path: null;
+    };
+    readonly geq: {
+        readonly id: "geq";
+        readonly category: "operators1";
+        readonly Tex: "\\geq";
+        readonly mirror: true;
+        readonly Label: "≥";
+        readonly title: "أكبر من أو يساوي";
+        readonly svg_path: null;
+    };
+    readonly propto: {
+        readonly id: "propto";
+        readonly category: "operators2";
+        readonly Tex: "\\propto";
+        readonly mirror: true;
+        readonly Label: "∝";
+        readonly title: "يتناسب مع";
+        readonly svg_path: null;
+    };
+    readonly in: {
+        readonly id: "in";
+        readonly category: "operators2";
+        readonly Tex: "\\in";
+        readonly mirror: true;
+        readonly Label: "∈";
+        readonly title: "ينتمي إلى";
+        readonly svg_path: null;
+    };
+    readonly notin: {
+        readonly id: "notin";
+        readonly category: "operators2";
+        readonly Tex: "\\notin";
+        readonly mirror: false;
+        readonly Label: "∉";
+        readonly title: "لا ينتمي إلى";
+        readonly svg_path: null;
+    };
+    readonly subset: {
+        readonly id: "subset";
+        readonly category: "operators2";
+        readonly Tex: "\\subset";
+        readonly mirror: true;
+        readonly Label: "⊂";
+        readonly title: "مجموعة جزئية من";
+        readonly svg_path: null;
+    };
+    readonly supset: {
+        readonly id: "supset";
+        readonly category: "operators2";
+        readonly Tex: "\\supset";
+        readonly mirror: true;
+        readonly Label: "⊃";
+        readonly title: "مجموعة شاملة لـ";
+        readonly svg_path: null;
+    };
+    readonly subseteq: {
+        readonly id: "subseteq";
+        readonly category: "operators2";
+        readonly Tex: "\\subseteq";
+        readonly mirror: true;
+        readonly Label: "⊆";
+        readonly title: "مجموعة جزئية أو تساوي";
+        readonly svg_path: null;
+    };
+    readonly supseteq: {
+        readonly id: "supseteq";
+        readonly category: "operators2";
+        readonly Tex: "\\supseteq";
+        readonly mirror: true;
+        readonly Label: "⊇";
+        readonly title: "مجموعة شاملة أو تساوي";
+        readonly svg_path: null;
+    };
+    readonly cap: {
+        readonly id: "cap";
+        readonly category: "operators2";
+        readonly Tex: "\\cap";
+        readonly mirror: false;
+        readonly Label: "∩";
+        readonly title: "تقاطع";
+        readonly svg_path: null;
+    };
+    readonly cup: {
+        readonly id: "cup";
+        readonly category: "operators2";
+        readonly Tex: "\\cup";
+        readonly mirror: false;
+        readonly Label: "∪";
+        readonly title: "اتحاد";
+        readonly svg_path: null;
+    };
+    readonly emptyset: {
+        readonly id: "emptyset";
+        readonly category: "operators2";
+        readonly Tex: "\\emptyset";
+        readonly mirror: false;
+        readonly Label: "∅";
+        readonly title: "المجموعة الخالية";
+        readonly svg_path: null;
+    };
+    readonly nsubseteq: {
+        readonly id: "nsubseteq";
+        readonly category: "operators2";
+        readonly Tex: "\\nsubseteq";
+        readonly mirror: true;
+        readonly Label: "⊈";
+        readonly title: "ليست مجموعة جزئية أو تساوي";
+        readonly svg_path: null;
+    };
+    readonly nsupseteq: {
+        readonly id: "nsupseteq";
+        readonly category: "operators2";
+        readonly Tex: "\\nsupseteq";
+        readonly mirror: true;
+        readonly Label: "⊉";
+        readonly title: "ليست مجموعة شاملة أو تساوي";
+        readonly svg_path: null;
+    };
+    readonly ldots: {
+        readonly id: "ldots";
+        readonly category: "dots";
+        readonly Tex: "\\ldots";
+        readonly mirror: false;
+        readonly Label: "…";
+        readonly title: "نقاط أفقية";
+        readonly svg_path: null;
+    };
+    readonly cdot: {
+        readonly id: "cdot";
+        readonly category: "dots";
+        readonly Tex: "\\cdot";
+        readonly mirror: false;
+        readonly Label: "·";
+        readonly title: "نقطة ضرب";
+        readonly svg_path: null;
+    };
+    readonly cdots: {
+        readonly id: "cdots";
+        readonly category: "dots";
+        readonly Tex: "\\cdots";
+        readonly mirror: false;
+        readonly Label: "⋯";
+        readonly title: "نقاط وسطية أفقية";
+        readonly svg_path: null;
+    };
+    readonly vdots: {
+        readonly id: "vdots";
+        readonly category: "dots";
+        readonly Tex: "\\vdots";
+        readonly mirror: false;
+        readonly Label: "⋮";
+        readonly title: "نقاط عمودية";
+        readonly svg_path: null;
+    };
+    readonly ddots: {
+        readonly id: "ddots";
+        readonly category: "dots";
+        readonly Tex: "\\ddots";
+        readonly mirror: true;
+        readonly displayMirror: false;
+        readonly Label: "⋱";
+        readonly title: "نقاط قطرية";
+        readonly svg_path: null;
+    };
+    readonly leftrightarrowDouble: {
+        readonly id: "leftrightarrowDouble";
+        readonly category: "operators3";
+        readonly Tex: "\\Leftrightarrow";
+        readonly mirror: false;
+        readonly Label: "⇔";
+        readonly title: "يكافئ";
+        readonly svg_path: null;
+    };
+    readonly rightleftharpoons: {
+        readonly id: "rightleftharpoons";
+        readonly category: "operators3";
+        readonly Tex: "\\rightleftharpoons";
+        readonly mirror: true;
+        readonly Label: "⇌";
+        readonly title: "اتزان";
+        readonly svg_path: null;
+    };
+    readonly leftarrow: {
+        readonly id: "leftarrow";
+        readonly category: "operators3";
+        readonly Tex: "\\leftarrow";
+        readonly mirror: true;
+        readonly Label: "←";
+        readonly title: "سهم إلى اليسار";
+        readonly svg_path: null;
+    };
+    readonly rightarrow: {
+        readonly id: "rightarrow";
+        readonly category: "operators3";
+        readonly Tex: "\\rightarrow";
+        readonly mirror: true;
+        readonly Label: "→";
+        readonly title: "سهم إلى اليمين";
+        readonly svg_path: null;
+    };
+    readonly leftarrowDouble: {
+        readonly id: "leftarrowDouble";
+        readonly category: "operators3";
+        readonly Tex: "\\Leftarrow";
+        readonly mirror: true;
+        readonly Label: "⇐";
+        readonly title: "سهم مزدوج إلى اليسار";
+        readonly svg_path: null;
+    };
+    readonly rightarrowDouble: {
+        readonly id: "rightarrowDouble";
+        readonly category: "operators3";
+        readonly Tex: "\\Rightarrow";
+        readonly mirror: true;
+        readonly Label: "⇒";
+        readonly title: "سهم مزدوج إلى اليمين";
+        readonly svg_path: null;
+    };
+    readonly leftharpoonup: {
+        readonly id: "leftharpoonup";
+        readonly category: "operators3";
+        readonly Tex: "\\leftharpoonup";
+        readonly mirror: true;
+        readonly Label: "↼";
+        readonly title: "سهم خطافي علوي إلى اليسار";
+        readonly svg_path: null;
+    };
+    readonly rightharpoonup: {
+        readonly id: "rightharpoonup";
+        readonly category: "operators3";
+        readonly Tex: "\\rightharpoonup";
+        readonly mirror: true;
+        readonly Label: "⇀";
+        readonly title: "سهم خطافي علوي إلى اليمين";
+        readonly svg_path: null;
+    };
+    readonly leftharpoondown: {
+        readonly id: "leftharpoondown";
+        readonly category: "operators3";
+        readonly Tex: "\\leftharpoondown";
+        readonly mirror: true;
+        readonly Label: "↽";
+        readonly title: "سهم خطافي سفلي إلى اليسار";
+        readonly svg_path: null;
+    };
+    readonly rightharpoondown: {
+        readonly id: "rightharpoondown";
+        readonly category: "operators3";
+        readonly Tex: "\\rightharpoondown";
+        readonly mirror: true;
+        readonly Label: "⇁";
+        readonly title: "سهم خطافي سفلي إلى اليمين";
+        readonly svg_path: null;
+    };
+    readonly int: {
+        readonly id: "int";
+        readonly category: "integrals";
+        readonly Tex: "\\int";
+        readonly mirror: true;
+        readonly Label: "∫";
+        readonly title: "تكامل";
+        readonly svg_path: null;
+    };
+    readonly iint: {
+        readonly id: "iint";
+        readonly category: "integrals";
+        readonly Tex: "\\iint";
+        readonly mirror: true;
+        readonly Label: "∬";
+        readonly title: "تكامل مزدوج";
+        readonly svg_path: null;
+    };
+    readonly iiint: {
+        readonly id: "iiint";
+        readonly category: "integrals";
+        readonly Tex: "\\iiint";
+        readonly mirror: true;
+        readonly Label: "∭";
+        readonly title: "تكامل ثلاثي";
+        readonly svg_path: null;
+    };
+    readonly iiiint: {
+        readonly id: "iiiint";
+        readonly category: "integrals";
+        readonly Tex: "\\iiiint";
+        readonly mirror: true;
+        readonly Label: "⨌";
+        readonly title: "تكامل رباعي";
+        readonly svg_path: null;
+    };
+    readonly oint: {
+        readonly id: "oint";
+        readonly category: "integrals";
+        readonly Tex: "\\oint";
+        readonly mirror: true;
+        readonly Label: "∮";
+        readonly title: "تكامل مغلق";
+        readonly svg_path: null;
+    };
+    readonly oiint: {
+        readonly id: "oiint";
+        readonly category: "integrals";
+        readonly Tex: "\\oiint";
+        readonly mirror: true;
+        readonly Label: "∯";
+        readonly title: "تكامل سطحي مغلق";
+        readonly svg_path: null;
+    };
+    readonly oiiint: {
+        readonly id: "oiiint";
+        readonly category: "integrals";
+        readonly Tex: "\\oiiint";
+        readonly mirror: true;
+        readonly Label: "∰";
+        readonly title: "تكامل حجمي مغلق";
+        readonly svg_path: null;
+    };
+};
+type AtomicOperatorCommandId = keyof typeof ATOMIC_OPERATOR_COMMANDS;
+type AtomicOperatorCommandCategory = 'operators1' | 'operators2' | 'operators3' | 'dots' | 'integrals';
+type AtomicOperatorCommandSpec = (typeof ATOMIC_OPERATOR_COMMANDS)[AtomicOperatorCommandId] & {
+    displayMirror?: boolean;
+};
+declare function shouldMirrorOperatorDisplay(command: AtomicOperatorCommandSpec | null | undefined): boolean;
+declare function mirrorBuTeXOperatorsInTex(tex: string): string;
+declare function atomicOperatorCommandsByCategory(category: AtomicOperatorCommandCategory): AtomicOperatorCommandSpec[];
+declare function atomicOperatorCommandSpec(id: string): AtomicOperatorCommandSpec | null;
+
+declare function createEditorChain(nodes?: EditorNode[]): EditorChain;
+declare function createEditorNode(kind: EditorNode['kind'], expr: string): EditorNode;
+declare function createDelimiterNode(leftDelimExpr: string, rightDelimExpr: string): EditorNode;
+declare function createFracNode(): EditorNode;
+declare function createSqrtNode(): EditorNode;
+declare function createMatrixEnvNode(style: MatrixEnvStyle, rows: number, columns: number): EditorNode;
+declare function createGridEnvNode(envName: GridEnvName, rows: number, columns: number, columnAlignments?: EnvColumnAlignment[]): EditorNode;
+declare function createAtomicCommandNode(commandId: AtomicCommandId): EditorNode;
+declare function createAtomicOperatorCommandNode(commandId: AtomicOperatorCommandId): EditorNode;
+declare function cloneEditorSession(session: EditorSession): EditorSession;
+declare function buildInitialSyncMap(englishTree: EditorChain, arabicTree: EditorChain): EditorSession['sync'];
+declare function createEditorSession(englishTree: EditorChain, arabicTree: EditorChain, activeSide?: EditorSide): EditorSession;
+
+type RenderOptions = {
+    digitForm?: DigitFormId;
+};
+declare function renderChainEnglish(chain: EditorChain, options?: RenderOptions): string;
+declare function renderChainArabic(chain: EditorChain, options?: RenderOptions): string;
+declare function renderEnglishLatexFromSession(session: EditorSession): string;
+declare function renderArabicLatexFromSession(session: EditorSession): string;
+
+/**
+ * Depth-first preorder of all caret slots: for each chain, slot 0, then each node's
+ * nested chains (inner → superscript → subscript), then slot after that node, etc.
+ * Horizontal moves step through this order without skipping positions.
+ */
+declare function collectCaretPositions(chain: EditorChain): EditorCaret[];
+declare function caretStep(root: EditorChain, caret: EditorCaret, delta: -1 | 1): EditorCaret;
+
+/**
+ * Single source of truth for child chains of a node.
+ * Future node kinds (commands, env, math objects) extend this helper and
+ * everything downstream (caret traversal mirroring, copy/paste, selection)
+ * keeps working. Today's children: innerExpr / numerator / denominator / rootIndex / radicand / matrix cells / superscript / subscript.
+ */
+declare function nodeChildChains(node: EditorNode): EditorChain[];
+/** Lower/higher slot indices regardless of anchor/focus order. */
+declare function normalizeSelection(sel: EditorSelectionRange): {
+    start: number;
+    end: number;
+};
+/** A selection is active only when it actually spans at least one node. */
+declare function isSelectionActive(sel: EditorSelectionRange | null): boolean;
+declare function clearSelection(session: EditorSession): EditorSession;
+/**
+ * Extend the selection by one slot inside the same chain.
+ * Initializes from the current caret when no selection exists.
+ * Clamps focus to [0, chain.nodes.length]; collapses selection when it shrinks
+ * back to its anchor.
+ */
+declare function extendSelectionByStep(session: EditorSession, delta: -1 | 1): EditorSession;
+/**
+ * Mouse-driven selection setter.
+ *  - role 'anchor': starts a fresh selection at slotIndex (collapsed).
+ *  - role 'focus':  updates focus on the existing selection. Cross-chain
+ *                   focus moves are ignored (drag stays inside one chain).
+ */
+declare function setSelectionFromMouse(session: EditorSession, chainId: string, slotIndex: number, role: 'anchor' | 'focus'): EditorSession;
+/** Ids of whole nodes covered by the current selection in the active tree. */
+declare function coveredNodeIds(session: EditorSession): string[];
+
+/** MIME used for the structured BuTeX clipboard fragment. */
+declare const BUTEX_FRAGMENT_MIME = "application/x-butex-fragment+json";
+type EditorFragment = {
+    version: 1;
+    source: 'butex-editor';
+    english: EditorNode[];
+    arabic: EditorNode[];
+};
+/**
+ * Build a fragment from the active selection by deep-cloning the covered nodes
+ * from BOTH english and arabic trees (mirrored by node id at matching index).
+ * Returns null when the selection is collapsed or invalid.
+ */
+declare function serializeSelection(session: EditorSession): EditorFragment | null;
+/**
+ * Re-id every node and nested chain in both sides of the fragment so they no
+ * longer collide with the live tree. Keeps the EN/AR mirror invariant
+ * (matching ids index-by-index, including in nested child chains).
+ */
+declare function regenerateFragmentIds(fragment: EditorFragment): EditorFragment;
+/** Best-effort parse of a clipboard payload. Returns null when shape is wrong. */
+declare function deserializeFragment(payload: string): EditorFragment | null;
+/** Plain-text rendering of the fragment for cross-app clipboard fallback. */
+declare function fragmentToPlainText(fragment: EditorFragment, side: EditorSide): string;
+
+/** Maximum number of editable states kept in the past stack (oldest drops first). */
+declare const DEFAULT_UNDO_HISTORY_MAX_DEPTH = 100;
+type UndoRedoStacks = {
+    past: EditorSession[];
+    future: EditorSession[];
+    maxDepth: number;
+};
+declare function createUndoRedoStacks(maxDepth?: number): UndoRedoStacks;
+/**
+ * Records the session **before** a user edit so it can be restored later.
+ * Clears the redo branch (standard editor semantics).
+ */
+declare function pushUndoRedoSnapshot(stacks: UndoRedoStacks, sessionBeforeEdit: EditorSession): void;
+/** Restore the previous editable state, or null if there is nothing to undo. */
+declare function restoreUndo(stacks: UndoRedoStacks, sessionNow: EditorSession): EditorSession | null;
+/** Restore the next state after an undo, or null if there is nothing to redo. */
+declare function restoreRedo(stacks: UndoRedoStacks, sessionNow: EditorSession): EditorSession | null;
+declare function undoRedoCanUndo(stacks: UndoRedoStacks): boolean;
+declare function undoRedoCanRedo(stacks: UndoRedoStacks): boolean;
+
+type ParentRelationKind = 'root' | 'superscript' | 'subscript' | 'inner' | 'numerator' | 'denominator' | 'radicand' | 'rootIndex' | 'matrixCell';
+type ParentRelation = {
+    kind: ParentRelationKind;
+    ownerNodeId: string | null;
+    ownerChainId: string | null;
+    rowIndex?: number;
+    columnIndex?: number;
+};
+type LocatedChain = {
+    chain: EditorChain;
+    relation: ParentRelation;
+};
+type LocatedNode = {
+    node: EditorNode;
+    chain: EditorChain;
+    index: number;
+};
+declare function findChainById(root: EditorChain, chainId: string): LocatedChain | null;
+declare function findNodeById(root: EditorChain, nodeId: string): LocatedNode | null;
+declare function activeTreeKey(side: EditorSide): 'englishTree' | 'arabicTree';
+declare function passiveTreeKey(side: EditorSide): 'englishTree' | 'arabicTree';
+
+/** Keep highlighted node aligned with caret (keyboard + programmatic caret moves). */
+declare function syncSelectionToCaret(session: EditorSession): void;
+declare function switchSide(session: EditorSession): EditorSession;
+declare function setSplitLeafTyping(session: EditorSession, enabled: boolean): EditorSession;
+declare function setArabicReverseNumberTyping(session: EditorSession, enabled: boolean): EditorSession;
+declare function setCaret(session: EditorSession, chainId: string, index: number): EditorSession;
+declare function moveCaret(session: EditorSession, delta: -1 | 1): EditorSession;
+declare function horizontalCaretDelta(session: EditorSession, direction: 'left' | 'right'): -1 | 1;
+declare function moveCaretHorizontal(session: EditorSession, direction: 'left' | 'right'): EditorSession;
+declare function moveCaretVertical(session: EditorSession, direction: 'up' | 'down'): EditorSession;
+/** One-shot: forces the next insertChar/insertNumber to start a new leaf instead of merging. No-op in split mode. */
+declare function breakLeafTyping(session: EditorSession): EditorSession;
+declare function setCurrentCharacterFont(session: EditorSession, fontId: CharacterFontId): EditorSession;
+declare function toggleTakweenCharacterFont(session: EditorSession): EditorSession;
+declare function setCurrentDigitForm(session: EditorSession, digitForm: DigitFormId): EditorSession;
+declare function insertChar(session: EditorSession, expr: string): EditorSession;
+declare function insertNumber(session: EditorSession, expr: string): EditorSession;
+declare function insertOperator(session: EditorSession, expr: string): EditorSession;
+declare function insertAtomicCommand(session: EditorSession, commandId: AtomicCommandId): EditorSession;
+declare function insertAtomicOperatorCommand(session: EditorSession, commandId: AtomicOperatorCommandId): EditorSession;
+declare function insertDelimiterPair(session: EditorSession, leftDelimExpr: string, rightDelimExpr: string): EditorSession;
+declare function insertFraction(session: EditorSession): EditorSession;
+declare function insertSqrt(session: EditorSession): EditorSession;
+declare function insertMatrixEnv(session: EditorSession, style: MatrixEnvStyle, rows: number, columns: number): EditorSession;
+declare function insertArrayEnv(session: EditorSession, rows: number, columns: number, columnAlignments?: EnvColumnAlignment[]): EditorSession;
+declare function insertAlignedEnv(session: EditorSession, rows: number, columns: number): EditorSession;
+declare function setMatrixEnvStyle(session: EditorSession, style: MatrixEnvStyle): EditorSession;
+declare function setArrayColumnAlignment(session: EditorSession, columnIndex: number, alignment: EnvColumnAlignment): EditorSession;
+declare function addMatrixRow(session: EditorSession): EditorSession;
+declare function removeMatrixRow(session: EditorSession): EditorSession;
+declare function addMatrixColumn(session: EditorSession): EditorSession;
+declare function removeMatrixColumn(session: EditorSession): EditorSession;
+declare function addSup(session: EditorSession): EditorSession;
+declare function addSub(session: EditorSession): EditorSession;
+declare function removeSup(session: EditorSession): EditorSession;
+declare function removeSub(session: EditorSession): EditorSession;
+declare function selectNode(session: EditorSession, nodeId: string | null): EditorSession;
+declare function deleteStructure(session: EditorSession): EditorSession;
+declare function deleteBackward(session: EditorSession): EditorSession;
+declare function deleteForward(session: EditorSession): EditorSession;
+declare function setExpr(session: EditorSession, nodeId: string, expr: string): EditorSession;
+declare function createStarterSession(): EditorSession;
+declare function syncStateSummary(session: EditorSession): string;
+declare function setRenderError(session: EditorSession, message: string | null): EditorSession;
+declare function activeSideLabel(side: EditorSide): string;
+/** Read-only: build a fragment from the active selection (or null when collapsed). */
+declare function copySelection(session: EditorSession): EditorFragment | null;
+/** Cut: removes the selection and returns both the cleaned session and the fragment. */
+declare function cutSelection(session: EditorSession): {
+    session: EditorSession;
+    fragment: EditorFragment | null;
+};
+/**
+ * Insert a structured fragment at the caret in the active chain. The fragment
+ * is re-id'd so it can't collide with the live tree, mirrored EN/AR ids are
+ * preserved, and sync entries are populated for every nested node.
+ */
+declare function pasteFragment(session: EditorSession, fragment: EditorFragment): EditorSession;
+/**
+ * Plain-text fallback paste. Each character is dispatched through the existing
+ * typing path so split/merge mode and selection-replace behave the same as
+ * keyboard input. Whitespace is silently skipped in this MVP.
+ */
+declare function pasteText(session: EditorSession, text: string): EditorSession;
+
+type BuildChain$1 = (chain: EditorChain) => HTMLElement;
+declare function buildNodeScripts(node: EditorNode, buildChain: BuildChain$1): HTMLElement | null;
+
+declare const DELIMITER_CSS: string;
+
+declare const FRAC_CSS: string;
+
+declare const SQRT_CSS: string;
+
+declare const MATRIX_ENV_CSS: string;
+
+declare const ATOMIC_COMMAND_CSS: string;
+
+declare const ATOMIC_OPERATOR_COMMAND_CSS: string;
+
+type BuildChain = (chain: EditorChain) => HTMLElement;
+declare function buildNodeBody(node: EditorNode, buildChain: BuildChain, side: EditorSide, digitForm?: DigitFormId): HTMLElement;
+
+declare function formatDigits(value: string, digitForm?: DigitFormId): string;
+
+type RuntimeButtonElements = {
+    undoBtn?: HTMLButtonElement | null;
+    redoBtn?: HTMLButtonElement | null;
+    copyBtn?: HTMLButtonElement | null;
+    cutBtn?: HTMLButtonElement | null;
+    splitTypingBtn?: HTMLButtonElement | null;
+    characterFontBtn?: HTMLButtonElement | null;
+    digitFormBtn?: HTMLButtonElement | null;
+};
+type EditorRuntimeOptions = {
+    surfaceEl: HTMLElement;
+    initialSession?: EditorSession;
+    buttonElements?: RuntimeButtonElements;
+    outsidePointerIgnoreSelectors?: string[];
+    onSessionChange?: (session: EditorSession) => void;
+};
+type EditorRuntimeApi = {
+    render: () => void;
+    destroy: () => void;
+    getSession: () => EditorSession;
+    setSession: (next: EditorSession) => void;
+    performUndo: () => void;
+    performRedo: () => void;
+    performCopy: () => Promise<void>;
+    performCut: () => Promise<void>;
+    performPaste: () => Promise<void>;
+    toggleSide: () => void;
+    toggleSplitLeafTyping: () => void;
+    toggleArabicReverseNumberTyping: () => void;
+    toggleTakweenCharacterFont: () => void;
+    setCurrentCharacterFont: (fontId: CharacterFontId) => void;
+    setCurrentDigitForm: (digitForm: DigitFormId) => void;
+    insertDelimiterByKind: (kind: 'paren' | 'bracket' | 'brace') => void;
+    insertFraction: () => void;
+    insertMatrixEnv: (style: MatrixEnvStyle, rows: number, columns: number) => void;
+    insertArrayEnv: (rows: number, columns: number) => void;
+    insertAlignedEnv: (rows: number, columns: number) => void;
+    insertSqrt: () => void;
+    insertAtomicCommand: (commandId: AtomicCommandId) => void;
+    insertAtomicOperatorCommand: (commandId: AtomicOperatorCommandId) => void;
+    addSup: () => void;
+    addSub: () => void;
+    removeSup: () => void;
+    removeSub: () => void;
+    setMatrixEnvStyle: (style: MatrixEnvStyle) => void;
+    setArrayColumnAlignment: (columnIndex: number, alignment: EnvColumnAlignment) => void;
+    addMatrixRow: () => void;
+    removeMatrixRow: () => void;
+    addMatrixColumn: () => void;
+    removeMatrixColumn: () => void;
+    deleteStructure: () => void;
+};
+declare function createEditorRuntime(options: EditorRuntimeOptions): EditorRuntimeApi;
+declare function runtimeStatusText(session: EditorSession): {
+    activeSide: string;
+    sync: string;
+};
+
+declare const index_ATOMIC_COMMANDS: typeof ATOMIC_COMMANDS;
+declare const index_ATOMIC_COMMAND_CSS: typeof ATOMIC_COMMAND_CSS;
+declare const index_ATOMIC_OPERATOR_COMMANDS: typeof ATOMIC_OPERATOR_COMMANDS;
+declare const index_ATOMIC_OPERATOR_COMMAND_CSS: typeof ATOMIC_OPERATOR_COMMAND_CSS;
+type index_AtomicCommandCategory = AtomicCommandCategory;
+type index_AtomicCommandId = AtomicCommandId;
+type index_AtomicCommandSpec = AtomicCommandSpec;
+type index_AtomicOperatorCommandCategory = AtomicOperatorCommandCategory;
+type index_AtomicOperatorCommandId = AtomicOperatorCommandId;
+type index_AtomicOperatorCommandSpec = AtomicOperatorCommandSpec;
+declare const index_BUTEX_EDITOR_CSS: typeof BUTEX_EDITOR_CSS;
+declare const index_BUTEX_FRAGMENT_MIME: typeof BUTEX_FRAGMENT_MIME;
+type index_CharacterFontId = CharacterFontId;
+declare const index_DEFAULT_UNDO_HISTORY_MAX_DEPTH: typeof DEFAULT_UNDO_HISTORY_MAX_DEPTH;
+declare const index_DELIMITER_CSS: typeof DELIMITER_CSS;
+type index_DigitFormId = DigitFormId;
+type index_EditorCaret = EditorCaret;
+type index_EditorChain = EditorChain;
+type index_EditorDebugEntry = EditorDebugEntry;
+type index_EditorFragment = EditorFragment;
+type index_EditorNode = EditorNode;
+type index_EditorNodeKind = EditorNodeKind;
+type index_EditorRuntimeApi = EditorRuntimeApi;
+type index_EditorRuntimeOptions = EditorRuntimeOptions;
+type index_EditorSelectionRange = EditorSelectionRange;
+type index_EditorSession = EditorSession;
+type index_EditorSide = EditorSide;
+type index_EditorSyncMap = EditorSyncMap;
+type index_EditorSyncState = EditorSyncState;
+type index_EnvColumnAlignment = EnvColumnAlignment;
+declare const index_FRAC_CSS: typeof FRAC_CSS;
+type index_GridEnvName = GridEnvName;
+declare const index_MATRIX_ENV_CSS: typeof MATRIX_ENV_CSS;
+type index_MatrixEnvStyle = MatrixEnvStyle;
+declare const index_SQRT_CSS: typeof SQRT_CSS;
+type index_SpacingCommandSpec = SpacingCommandSpec;
+type index_SpacingDirection = SpacingDirection;
+type index_UndoRedoStacks = UndoRedoStacks;
+declare const index_activeSideLabel: typeof activeSideLabel;
+declare const index_activeTreeKey: typeof activeTreeKey;
+declare const index_addMatrixColumn: typeof addMatrixColumn;
+declare const index_addMatrixRow: typeof addMatrixRow;
+declare const index_addSub: typeof addSub;
+declare const index_addSup: typeof addSup;
+declare const index_atomicCommandSpec: typeof atomicCommandSpec;
+declare const index_atomicCommandsByCategory: typeof atomicCommandsByCategory;
+declare const index_atomicOperatorCommandSpec: typeof atomicOperatorCommandSpec;
+declare const index_atomicOperatorCommandsByCategory: typeof atomicOperatorCommandsByCategory;
+declare const index_breakLeafTyping: typeof breakLeafTyping;
+declare const index_buildInitialSyncMap: typeof buildInitialSyncMap;
+declare const index_buildNodeBody: typeof buildNodeBody;
+declare const index_buildNodeScripts: typeof buildNodeScripts;
+declare const index_caretStep: typeof caretStep;
+declare const index_clearSelection: typeof clearSelection;
+declare const index_cloneEditorSession: typeof cloneEditorSession;
+declare const index_collectCaretPositions: typeof collectCaretPositions;
+declare const index_copySelection: typeof copySelection;
+declare const index_coveredNodeIds: typeof coveredNodeIds;
+declare const index_createAtomicCommandNode: typeof createAtomicCommandNode;
+declare const index_createAtomicOperatorCommandNode: typeof createAtomicOperatorCommandNode;
+declare const index_createDelimiterNode: typeof createDelimiterNode;
+declare const index_createEditorChain: typeof createEditorChain;
+declare const index_createEditorNode: typeof createEditorNode;
+declare const index_createEditorRuntime: typeof createEditorRuntime;
+declare const index_createEditorSession: typeof createEditorSession;
+declare const index_createFracNode: typeof createFracNode;
+declare const index_createGridEnvNode: typeof createGridEnvNode;
+declare const index_createMatrixEnvNode: typeof createMatrixEnvNode;
+declare const index_createSqrtNode: typeof createSqrtNode;
+declare const index_createStarterSession: typeof createStarterSession;
+declare const index_createUndoRedoStacks: typeof createUndoRedoStacks;
+declare const index_cutSelection: typeof cutSelection;
+declare const index_deleteBackward: typeof deleteBackward;
+declare const index_deleteForward: typeof deleteForward;
+declare const index_deleteStructure: typeof deleteStructure;
+declare const index_deserializeFragment: typeof deserializeFragment;
+declare const index_extendSelectionByStep: typeof extendSelectionByStep;
+declare const index_findChainById: typeof findChainById;
+declare const index_findNodeById: typeof findNodeById;
+declare const index_formatDigits: typeof formatDigits;
+declare const index_fragmentToPlainText: typeof fragmentToPlainText;
+declare const index_horizontalCaretDelta: typeof horizontalCaretDelta;
+declare const index_injectBuTeXEditorStyles: typeof injectBuTeXEditorStyles;
+declare const index_insertAlignedEnv: typeof insertAlignedEnv;
+declare const index_insertArrayEnv: typeof insertArrayEnv;
+declare const index_insertAtomicCommand: typeof insertAtomicCommand;
+declare const index_insertAtomicOperatorCommand: typeof insertAtomicOperatorCommand;
+declare const index_insertChar: typeof insertChar;
+declare const index_insertDelimiterPair: typeof insertDelimiterPair;
+declare const index_insertFraction: typeof insertFraction;
+declare const index_insertMatrixEnv: typeof insertMatrixEnv;
+declare const index_insertNumber: typeof insertNumber;
+declare const index_insertOperator: typeof insertOperator;
+declare const index_insertSqrt: typeof insertSqrt;
+declare const index_isSelectionActive: typeof isSelectionActive;
+declare const index_isSpacingCommandSpec: typeof isSpacingCommandSpec;
+declare const index_mirrorBuTeXOperatorsInTex: typeof mirrorBuTeXOperatorsInTex;
+declare const index_moveCaret: typeof moveCaret;
+declare const index_moveCaretHorizontal: typeof moveCaretHorizontal;
+declare const index_moveCaretVertical: typeof moveCaretVertical;
+declare const index_nodeChildChains: typeof nodeChildChains;
+declare const index_normalizeSelection: typeof normalizeSelection;
+declare const index_passiveTreeKey: typeof passiveTreeKey;
+declare const index_pasteFragment: typeof pasteFragment;
+declare const index_pasteText: typeof pasteText;
+declare const index_pushUndoRedoSnapshot: typeof pushUndoRedoSnapshot;
+declare const index_regenerateFragmentIds: typeof regenerateFragmentIds;
+declare const index_removeMatrixColumn: typeof removeMatrixColumn;
+declare const index_removeMatrixRow: typeof removeMatrixRow;
+declare const index_removeSub: typeof removeSub;
+declare const index_removeSup: typeof removeSup;
+declare const index_renderArabicLatexFromSession: typeof renderArabicLatexFromSession;
+declare const index_renderChainArabic: typeof renderChainArabic;
+declare const index_renderChainEnglish: typeof renderChainEnglish;
+declare const index_renderEnglishLatexFromSession: typeof renderEnglishLatexFromSession;
+declare const index_restoreRedo: typeof restoreRedo;
+declare const index_restoreUndo: typeof restoreUndo;
+declare const index_runtimeStatusText: typeof runtimeStatusText;
+declare const index_selectNode: typeof selectNode;
+declare const index_serializeSelection: typeof serializeSelection;
+declare const index_setArabicReverseNumberTyping: typeof setArabicReverseNumberTyping;
+declare const index_setArrayColumnAlignment: typeof setArrayColumnAlignment;
+declare const index_setCaret: typeof setCaret;
+declare const index_setCurrentCharacterFont: typeof setCurrentCharacterFont;
+declare const index_setCurrentDigitForm: typeof setCurrentDigitForm;
+declare const index_setExpr: typeof setExpr;
+declare const index_setMatrixEnvStyle: typeof setMatrixEnvStyle;
+declare const index_setRenderError: typeof setRenderError;
+declare const index_setSelectionFromMouse: typeof setSelectionFromMouse;
+declare const index_setSplitLeafTyping: typeof setSplitLeafTyping;
+declare const index_shouldMirrorOperatorDisplay: typeof shouldMirrorOperatorDisplay;
+declare const index_switchSide: typeof switchSide;
+declare const index_syncSelectionToCaret: typeof syncSelectionToCaret;
+declare const index_syncStateSummary: typeof syncStateSummary;
+declare const index_toggleTakweenCharacterFont: typeof toggleTakweenCharacterFont;
+declare const index_undoRedoCanRedo: typeof undoRedoCanRedo;
+declare const index_undoRedoCanUndo: typeof undoRedoCanUndo;
+declare namespace index {
+  export { index_ATOMIC_COMMANDS as ATOMIC_COMMANDS, index_ATOMIC_COMMAND_CSS as ATOMIC_COMMAND_CSS, index_ATOMIC_OPERATOR_COMMANDS as ATOMIC_OPERATOR_COMMANDS, index_ATOMIC_OPERATOR_COMMAND_CSS as ATOMIC_OPERATOR_COMMAND_CSS, type index_AtomicCommandCategory as AtomicCommandCategory, type index_AtomicCommandId as AtomicCommandId, type index_AtomicCommandSpec as AtomicCommandSpec, type index_AtomicOperatorCommandCategory as AtomicOperatorCommandCategory, type index_AtomicOperatorCommandId as AtomicOperatorCommandId, type index_AtomicOperatorCommandSpec as AtomicOperatorCommandSpec, index_BUTEX_EDITOR_CSS as BUTEX_EDITOR_CSS, index_BUTEX_FRAGMENT_MIME as BUTEX_FRAGMENT_MIME, type index_CharacterFontId as CharacterFontId, index_DEFAULT_UNDO_HISTORY_MAX_DEPTH as DEFAULT_UNDO_HISTORY_MAX_DEPTH, index_DELIMITER_CSS as DELIMITER_CSS, type index_DigitFormId as DigitFormId, type index_EditorCaret as EditorCaret, type index_EditorChain as EditorChain, type index_EditorDebugEntry as EditorDebugEntry, type index_EditorFragment as EditorFragment, type index_EditorNode as EditorNode, type index_EditorNodeKind as EditorNodeKind, type index_EditorRuntimeApi as EditorRuntimeApi, type index_EditorRuntimeOptions as EditorRuntimeOptions, type index_EditorSelectionRange as EditorSelectionRange, type index_EditorSession as EditorSession, type index_EditorSide as EditorSide, type index_EditorSyncMap as EditorSyncMap, type index_EditorSyncState as EditorSyncState, type index_EnvColumnAlignment as EnvColumnAlignment, index_FRAC_CSS as FRAC_CSS, type index_GridEnvName as GridEnvName, index_MATRIX_ENV_CSS as MATRIX_ENV_CSS, type index_MatrixEnvStyle as MatrixEnvStyle, index_SQRT_CSS as SQRT_CSS, type index_SpacingCommandSpec as SpacingCommandSpec, type index_SpacingDirection as SpacingDirection, type index_UndoRedoStacks as UndoRedoStacks, index_activeSideLabel as activeSideLabel, index_activeTreeKey as activeTreeKey, index_addMatrixColumn as addMatrixColumn, index_addMatrixRow as addMatrixRow, index_addSub as addSub, index_addSup as addSup, index_atomicCommandSpec as atomicCommandSpec, index_atomicCommandsByCategory as atomicCommandsByCategory, index_atomicOperatorCommandSpec as atomicOperatorCommandSpec, index_atomicOperatorCommandsByCategory as atomicOperatorCommandsByCategory, index_breakLeafTyping as breakLeafTyping, index_buildInitialSyncMap as buildInitialSyncMap, index_buildNodeBody as buildNodeBody, index_buildNodeScripts as buildNodeScripts, index_caretStep as caretStep, index_clearSelection as clearSelection, index_cloneEditorSession as cloneEditorSession, index_collectCaretPositions as collectCaretPositions, index_copySelection as copySelection, index_coveredNodeIds as coveredNodeIds, index_createAtomicCommandNode as createAtomicCommandNode, index_createAtomicOperatorCommandNode as createAtomicOperatorCommandNode, index_createDelimiterNode as createDelimiterNode, index_createEditorChain as createEditorChain, index_createEditorNode as createEditorNode, index_createEditorRuntime as createEditorRuntime, index_createEditorSession as createEditorSession, index_createFracNode as createFracNode, index_createGridEnvNode as createGridEnvNode, index_createMatrixEnvNode as createMatrixEnvNode, index_createSqrtNode as createSqrtNode, index_createStarterSession as createStarterSession, index_createUndoRedoStacks as createUndoRedoStacks, index_cutSelection as cutSelection, index_deleteBackward as deleteBackward, index_deleteForward as deleteForward, index_deleteStructure as deleteStructure, index_deserializeFragment as deserializeFragment, index_extendSelectionByStep as extendSelectionByStep, index_findChainById as findChainById, index_findNodeById as findNodeById, index_formatDigits as formatDigits, index_fragmentToPlainText as fragmentToPlainText, index_horizontalCaretDelta as horizontalCaretDelta, index_injectBuTeXEditorStyles as injectBuTeXEditorStyles, index_insertAlignedEnv as insertAlignedEnv, index_insertArrayEnv as insertArrayEnv, index_insertAtomicCommand as insertAtomicCommand, index_insertAtomicOperatorCommand as insertAtomicOperatorCommand, index_insertChar as insertChar, index_insertDelimiterPair as insertDelimiterPair, index_insertFraction as insertFraction, index_insertMatrixEnv as insertMatrixEnv, index_insertNumber as insertNumber, index_insertOperator as insertOperator, index_insertSqrt as insertSqrt, index_isSelectionActive as isSelectionActive, index_isSpacingCommandSpec as isSpacingCommandSpec, index_mirrorBuTeXOperatorsInTex as mirrorBuTeXOperatorsInTex, index_moveCaret as moveCaret, index_moveCaretHorizontal as moveCaretHorizontal, index_moveCaretVertical as moveCaretVertical, index_nodeChildChains as nodeChildChains, index_normalizeSelection as normalizeSelection, index_passiveTreeKey as passiveTreeKey, index_pasteFragment as pasteFragment, index_pasteText as pasteText, index_pushUndoRedoSnapshot as pushUndoRedoSnapshot, index_regenerateFragmentIds as regenerateFragmentIds, index_removeMatrixColumn as removeMatrixColumn, index_removeMatrixRow as removeMatrixRow, index_removeSub as removeSub, index_removeSup as removeSup, index_renderArabicLatexFromSession as renderArabicLatexFromSession, index_renderChainArabic as renderChainArabic, index_renderChainEnglish as renderChainEnglish, index_renderEnglishLatexFromSession as renderEnglishLatexFromSession, index_restoreRedo as restoreRedo, index_restoreUndo as restoreUndo, index_runtimeStatusText as runtimeStatusText, index_selectNode as selectNode, index_serializeSelection as serializeSelection, index_setArabicReverseNumberTyping as setArabicReverseNumberTyping, index_setArrayColumnAlignment as setArrayColumnAlignment, index_setCaret as setCaret, index_setCurrentCharacterFont as setCurrentCharacterFont, index_setCurrentDigitForm as setCurrentDigitForm, index_setExpr as setExpr, index_setMatrixEnvStyle as setMatrixEnvStyle, index_setRenderError as setRenderError, index_setSelectionFromMouse as setSelectionFromMouse, index_setSplitLeafTyping as setSplitLeafTyping, index_shouldMirrorOperatorDisplay as shouldMirrorOperatorDisplay, index_switchSide as switchSide, index_syncSelectionToCaret as syncSelectionToCaret, index_syncStateSummary as syncStateSummary, index_toggleTakweenCharacterFont as toggleTakweenCharacterFont, index_undoRedoCanRedo as undoRedoCanRedo, index_undoRedoCanUndo as undoRedoCanUndo };
+}
+
+/**
+ * Typed error from {@link parseBuTeX} when known Arabic commands are malformed.
+ */
+declare class BuTeXParserError extends Error {
+    readonly offset: number;
+    constructor(message: string, offset: number);
+}
+
+/** MVP Arabic surface commands mapped by normalized parser dispatch */
+declare const CMD_ROOT_AR = "\u062C\u0630\u0631";
+declare const CMD_FRAC_AR = "\u0643\u0633\u0631";
+declare const CMD_COS_AR = "\u062C\u062A\u0627";
+
+/**
+ * Wrap a literal segment if it consists only of Arabic script letters (no digits/Latin/backslash).
+ * Used for bare identifiers like `س` inside `{...}`.
+ */
+declare function wrapArabicLiteralSegment(segment: string): string;
+
+/**
+ * Normalize Arabic-friendly BuTeX surface syntax to MathJax-compatible TeX.
+ * Pure string transform — no MathJax dependency.
+ */
+declare function parseBuTeX(input: string): string;
+
+declare function patchBuTeXSvgMath(root: ParentNode): void;
+
+type BuTeXMathOutput = 'chtml' | 'svg';
+type RenderBuTeXMathIslandOptions = {
+    display?: boolean;
+    mirrorOperators?: boolean;
+    output?: BuTeXMathOutput;
+};
+type RenderBuTeXMathTypesetOptions = {
+    display?: boolean;
+    mirrorOperators?: boolean;
+};
+declare function patchBuTeXSvgMathAfterLayout(root: ParentNode): void;
+/** Convert delimited source text to `\(...\)` / `\[...\]` form. */
+declare function normalizePreviewMathForMathJax(tex: string): string;
+/** Normalize delimited TeX for direct MathJax island conversion. */
+declare function normalizeBuTeXMathInput(tex: string, output?: BuTeXMathOutput): {
+    tex: string;
+    display: boolean;
+};
+declare function renderBuTeXMathIsland(tex: string, options?: RenderBuTeXMathIslandOptions): Promise<HTMLElement>;
+declare function mountBuTeXMathIsland(host: HTMLElement, tex: string, options?: RenderBuTeXMathIslandOptions): Promise<void>;
+/**
+ * Render via MathJax's document typesetter (`typesetPromise`).
+ * Use for equation-editor preview of raw AST TeX (display `\[...\]` by default).
+ */
+declare function mountBuTeXMathTypeset(host: HTMLElement, tex: string, options?: RenderBuTeXMathTypesetOptions): Promise<void>;
+/** @deprecated Use normalizeBuTeXMathInput instead. */
+declare function mathJaxInputFromPreviewTex(tex: string): {
+    tex: string;
+    display: boolean;
+};
+
+/**
+ * Swap MathJax's SVG `mtext` wrapper for the BuTeX-aware one. Call once, after
+ * the SVG output jax exists (e.g. after `MathJax.startup.defaultReady()`).
+ * No-op if SVG output internals are missing or already patched.
+ */
+declare function registerBuTeXSvgTextWrapper(mathJax: GlobalMathJax): void;
+
+/**
+ * Injects BuTeX CommonHTML styles into `document.head` if not already present.
+ * Browser-only; no-op if `document` is undefined (Node).
+ */
+declare function injectBuTeXStyles(doc?: Document): void;
+
+export { BUTEX_CHROME_CSS, BUTEX_EDITOR_CSS, BUTEX_TEX_PACKAGE, type BuTeXMathOutput, BuTeXParserError, CMD_COS_AR, CMD_FRAC_AR, CMD_ROOT_AR, index as Editor, type RenderBuTeXMathIslandOptions, type RenderBuTeXMathTypesetOptions, injectBuTeXEditorStyles, injectBuTeXStyles, mathJaxInputFromPreviewTex, mirrorBuTeXOperatorsInTex, mountBuTeXMathIsland, mountBuTeXMathTypeset, normalizeBuTeXMathInput, normalizePreviewMathForMathJax, parseBuTeX, patchBuTeXSvgMath, patchBuTeXSvgMathAfterLayout, registerBuTeX, registerBuTeXSvgTextWrapper, renderBuTeXMathIsland, wrapArabicLiteralSegment };