@drghaliasri/butex 3.2.2

package/dist/document2.d.mts

@@ -0,0 +1,353 @@
+type ArabicNodeJson = {
+    node_type: string;
+    expr?: string;
+    name?: string;
+    superscript?: ChainJson | null;
+    subscript?: ChainJson | null;
+    left_delim_expr?: string;
+    right_delim_expr?: string;
+    inner_expr?: ChainJson;
+    optional_args?: ChainJson[];
+    mandatory_args?: ChainJson[];
+    opening?: string;
+    closing?: string;
+    lines?: ChainJson[];
+};
+type ChainJson = {
+    node_type: 'ChainClass';
+    chain: ArabicNodeJson[];
+};
+declare class State {
+}
+declare class BaseAstNode {
+    state: State;
+    superscript: ChainNode | null;
+    subscript: ChainNode | null;
+    nodeType: string;
+    constructor(state?: State | null);
+    latex(): string;
+    arabicLatex(): string;
+    toArabicLatex(): string;
+    /** Latin-style scripts: `^{...}` and `_{...}` for english_json rendering. */
+    latexScripts(): string;
+    /**
+     * Arabic scripts use \\prescript{sup}{sub}{content} (matches reference Python output).
+     * Call with rendered strings for sup/sub chains (may be empty strings).
+     */
+    arabicLatexScripts(sup: string, sub: string, content: string): string;
+}
+declare class ChainNode {
+    chain: BaseAstNode[];
+    constructor(chain?: BaseAstNode[]);
+    latex(): string;
+    toEnglishLatex(): string;
+    /** RTL: reverse order relative to Latin chain (see test/ref_tests.txt). */
+    arabicLatex(): string;
+    toArabicLatex(): string;
+}
+
+type MathNode = {
+    nodeType: 'MathObject';
+    mathMode: string;
+    lines: ChainNode[];
+    closing: string;
+};
+
+type Document2ParseMode = 'english' | 'arabic';
+type Document2MathOutput = 'svg' | 'chtml';
+type MathObject2Json = {
+    node_type: 'MathObject';
+    math_mode: string;
+    lines: ChainJson[];
+    closing: string;
+};
+type Document2Json = {
+    node_type: 'DocumentObject';
+    blocks: Document2BlockJson[];
+};
+type Document2BlockJson = {
+    command: string;
+    value?: string;
+    math_objects?: MathObject2Json[];
+    options?: Record<string, string>;
+    closing?: string;
+    items?: Document2ListItemJson[];
+    rows?: string[][];
+    columns?: string;
+};
+type Document2ListItemJson = {
+    value: string;
+    math_objects?: MathObject2Json[];
+    blocks?: Document2BlockJson[];
+};
+type Document2Diagnostic = {
+    code: string;
+    message: string;
+    path: string;
+};
+type TextToken2 = {
+    id: string;
+    kind: 'text';
+    text: string;
+};
+type MathToken2 = {
+    id: string;
+    kind: 'math';
+    display: boolean;
+    opening: string;
+    closing: string;
+    source: string;
+    math: MathNode | null;
+    editable: boolean;
+    reason?: string;
+    sourceOwner: 'imported-structured' | 'raw' | 'editor';
+};
+type InlineToken2 = TextToken2 | MathToken2;
+type InlineField2 = {
+    id: string;
+    tokens: InlineToken2[];
+};
+type TextBlock2 = {
+    id: string;
+    kind: 'textBlock';
+    command: '\\section' | '\\subsection' | '\\subsubsection' | '\\paragraph';
+    field: InlineField2;
+};
+type ListItem2 = {
+    id: string;
+    field: InlineField2;
+    blocks: Document2Block[];
+};
+type ListBlock2 = {
+    id: string;
+    kind: 'list';
+    command: '\\begin{itemize}' | '\\begin{enumerate}';
+    closing: '\\end{itemize}' | '\\end{enumerate}';
+    items: ListItem2[];
+};
+type TableBlock2 = {
+    id: string;
+    kind: 'table';
+    command: '\\begin{tabular}';
+    closing: '\\end{tabular}';
+    columns: string;
+    rows: InlineField2[][];
+};
+type ImageBlock2 = {
+    id: string;
+    kind: 'image';
+    command: '\\includegraphics';
+    value: string;
+    options: Record<string, string>;
+};
+type RawBlock2 = {
+    id: string;
+    kind: 'raw';
+    command: '\\raw';
+    value: string;
+};
+type Document2Block = TextBlock2 | ListBlock2 | TableBlock2 | ImageBlock2 | RawBlock2;
+type Document2Node = {
+    nodeType: 'DocumentObject';
+    blocks: Document2Block[];
+    diagnostics: Document2Diagnostic[];
+};
+type ImportDocument2Options = {
+    strict?: boolean;
+    mode?: Document2ParseMode;
+};
+type DetectedMathSpan2 = {
+    start: number;
+    end: number;
+    source: string;
+    opening: string;
+    closing: string;
+    display: boolean;
+};
+type PreviewInline2 = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'math';
+    id: string;
+    tex: string;
+    display: boolean;
+    output: Document2MathOutput;
+    editable: boolean;
+};
+type PreviewBlock2 = {
+    kind: 'heading';
+    id: string;
+    level: 1 | 2 | 3;
+    inlines: PreviewInline2[];
+} | {
+    kind: 'paragraph';
+    id: string;
+    inlines: PreviewInline2[];
+} | {
+    kind: 'list';
+    id: string;
+    ordered: boolean;
+    items: Array<{
+        id: string;
+        inlines: PreviewInline2[];
+        blocks: PreviewBlock2[];
+    }>;
+} | {
+    kind: 'table';
+    id: string;
+    rows: PreviewInline2[][][];
+} | {
+    kind: 'image';
+    id: string;
+    src: string;
+    options: Record<string, string>;
+}
+/** Preview-only: raw / unknown blocks are omitted from preview until we add proper rendering. */
+ | {
+    kind: 'omit';
+    id: string;
+};
+type MathIsland2 = {
+    id: string;
+    tex: string;
+    display: boolean;
+    output: Document2MathOutput;
+    editable: boolean;
+};
+type Document2Preview = {
+    blocks: PreviewBlock2[];
+    mathIslands: MathIsland2[];
+};
+
+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 function findFirstInlineField(document: Document2Node): InlineField2 | null;
+declare function updateTextToken(document: Document2Node, fieldId: string, tokenId: string, text: string): Document2Node;
+declare function cloneDocument2Node(document: Document2Node): Document2Node;
+declare function insertDocument2BlockAfter(document: Document2Node, afterBlockId: string | null | undefined, block: Document2Block): Document2Node;
+declare function moveDocument2BlockById(document: Document2Node, blockId: string, direction: -1 | 1): Document2Node;
+declare function removeMathTokenById(document: Document2Node, tokenId: string): Document2Node;
+declare function insertMathTokenAtCaret(document: Document2Node, fieldId: string, textTokenId: string | null, caretOffset: number, session: EditorSession, opening?: string, closing?: string): Document2Node;
+declare function insertMathToken(document: Document2Node, fieldId: string, insertIndex: number, session: EditorSession, opening?: string, closing?: string): Document2Node;
+declare function replaceMathTokenFromSession(document: Document2Node, tokenId: string, session: EditorSession, opening?: string, closing?: string): Document2Node;
+declare function addDocument2TextBlock(document: Document2Node, command?: '\\section' | '\\subsection' | '\\subsubsection' | '\\paragraph', afterBlockId?: string | null): Document2Node;
+declare function removeDocument2BlockById(document: Document2Node, blockId: string): Document2Node;
+declare function addDocument2ListBlock(document: Document2Node, ordered: boolean, afterBlockId?: string | null): Document2Node;
+declare function addDocument2TableBlock(document: Document2Node, columns?: string, rowCount?: number, colCount?: number, afterBlockId?: string | null): Document2Node;
+declare function addDocument2ImageBlock(document: Document2Node, src?: string, afterBlockId?: string | null): Document2Node;
+declare function updateDocument2ImageValue(document: Document2Node, blockId: string, value: string): Document2Node;
+declare function addDocument2ListItem(document: Document2Node, listBlockId: string): Document2Node;
+declare function removeDocument2ListItem(document: Document2Node, listBlockId: string, itemId: string): Document2Node;
+
+declare function inlineFieldLatex(field: InlineField2): string;
+declare function document2Latex(document: Document2Node): string;
+
+declare const DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH = 100;
+type Document2HistoryStacks = {
+    past: Document2Node[];
+    future: Document2Node[];
+    maxDepth: number;
+};
+declare function createDocument2History(maxDepth?: number): Document2HistoryStacks;
+declare function pushDocument2Snapshot(stacks: Document2HistoryStacks, documentBeforeEdit: Document2Node): void;
+declare function restoreDocument2Undo(stacks: Document2HistoryStacks, documentNow: Document2Node): Document2Node | null;
+declare function restoreDocument2Redo(stacks: Document2HistoryStacks, documentNow: Document2Node): Document2Node | null;
+declare function document2HistoryCanUndo(stacks: Document2HistoryStacks): boolean;
+declare function document2HistoryCanRedo(stacks: Document2HistoryStacks): boolean;
+
+declare function createInlineField2(value?: string, mathObjects?: MathObject2Json[], options?: ImportDocument2Options, path?: string, diagnostics?: Document2Diagnostic[]): InlineField2;
+declare function fromDocumentJson2(json: unknown, options?: ImportDocument2Options): Document2Node;
+declare function createEmptyDocument2(): Document2Node;
+
+declare function detectMathSpans2(value: string): DetectedMathSpan2[];
+
+type Document2MathBridgeResult = {
+    editable: true;
+    session: EditorSession;
+} | {
+    editable: false;
+    reason: string;
+};
+declare function createEmptyArabicEquationSession(): EditorSession;
+declare function mathTokenToArabicEditorSession(math: MathNode | null): Document2MathBridgeResult;
+declare function mathSourceFromArabicSession(session: EditorSession, opening?: string, closing?: string): string;
+declare function mathNodeFromArabicSession(session: EditorSession, opening?: string, closing?: string): MathNode;
+
+declare function document2Preview(document: Document2Node, output?: Document2MathOutput): Document2Preview;
+
+export { DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH, type Document2Block, type Document2BlockJson, type Document2Diagnostic, type Document2HistoryStacks, type Document2Json, type Document2MathOutput, type Document2Node, type ImageBlock2, type ImportDocument2Options, type InlineField2, type InlineToken2, type ListBlock2, type MathIsland2, type MathObject2Json, type MathToken2, type PreviewBlock2, type PreviewInline2, type RawBlock2, type TableBlock2, type TextBlock2, type TextToken2, addDocument2ImageBlock, addDocument2ListBlock, addDocument2ListItem, addDocument2TableBlock, addDocument2TextBlock, cloneDocument2Node, createDocument2History, createEmptyArabicEquationSession, createEmptyDocument2, createInlineField2, detectMathSpans2, document2HistoryCanRedo, document2HistoryCanUndo, document2Latex, document2Preview, findFirstInlineField, fromDocumentJson2, inlineFieldLatex, insertDocument2BlockAfter, insertMathToken, insertMathTokenAtCaret, mathNodeFromArabicSession, mathSourceFromArabicSession, mathTokenToArabicEditorSession, moveDocument2BlockById, pushDocument2Snapshot, removeDocument2BlockById, removeDocument2ListItem, removeMathTokenById, replaceMathTokenFromSession, restoreDocument2Redo, restoreDocument2Undo, updateDocument2ImageValue, updateTextToken };

package/dist/document2.d.ts

@@ -0,0 +1,353 @@
+type ArabicNodeJson = {
+    node_type: string;
+    expr?: string;
+    name?: string;
+    superscript?: ChainJson | null;
+    subscript?: ChainJson | null;
+    left_delim_expr?: string;
+    right_delim_expr?: string;
+    inner_expr?: ChainJson;
+    optional_args?: ChainJson[];
+    mandatory_args?: ChainJson[];
+    opening?: string;
+    closing?: string;
+    lines?: ChainJson[];
+};
+type ChainJson = {
+    node_type: 'ChainClass';
+    chain: ArabicNodeJson[];
+};
+declare class State {
+}
+declare class BaseAstNode {
+    state: State;
+    superscript: ChainNode | null;
+    subscript: ChainNode | null;
+    nodeType: string;
+    constructor(state?: State | null);
+    latex(): string;
+    arabicLatex(): string;
+    toArabicLatex(): string;
+    /** Latin-style scripts: `^{...}` and `_{...}` for english_json rendering. */
+    latexScripts(): string;
+    /**
+     * Arabic scripts use \\prescript{sup}{sub}{content} (matches reference Python output).
+     * Call with rendered strings for sup/sub chains (may be empty strings).
+     */
+    arabicLatexScripts(sup: string, sub: string, content: string): string;
+}
+declare class ChainNode {
+    chain: BaseAstNode[];
+    constructor(chain?: BaseAstNode[]);
+    latex(): string;
+    toEnglishLatex(): string;
+    /** RTL: reverse order relative to Latin chain (see test/ref_tests.txt). */
+    arabicLatex(): string;
+    toArabicLatex(): string;
+}
+
+type MathNode = {
+    nodeType: 'MathObject';
+    mathMode: string;
+    lines: ChainNode[];
+    closing: string;
+};
+
+type Document2ParseMode = 'english' | 'arabic';
+type Document2MathOutput = 'svg' | 'chtml';
+type MathObject2Json = {
+    node_type: 'MathObject';
+    math_mode: string;
+    lines: ChainJson[];
+    closing: string;
+};
+type Document2Json = {
+    node_type: 'DocumentObject';
+    blocks: Document2BlockJson[];
+};
+type Document2BlockJson = {
+    command: string;
+    value?: string;
+    math_objects?: MathObject2Json[];
+    options?: Record<string, string>;
+    closing?: string;
+    items?: Document2ListItemJson[];
+    rows?: string[][];
+    columns?: string;
+};
+type Document2ListItemJson = {
+    value: string;
+    math_objects?: MathObject2Json[];
+    blocks?: Document2BlockJson[];
+};
+type Document2Diagnostic = {
+    code: string;
+    message: string;
+    path: string;
+};
+type TextToken2 = {
+    id: string;
+    kind: 'text';
+    text: string;
+};
+type MathToken2 = {
+    id: string;
+    kind: 'math';
+    display: boolean;
+    opening: string;
+    closing: string;
+    source: string;
+    math: MathNode | null;
+    editable: boolean;
+    reason?: string;
+    sourceOwner: 'imported-structured' | 'raw' | 'editor';
+};
+type InlineToken2 = TextToken2 | MathToken2;
+type InlineField2 = {
+    id: string;
+    tokens: InlineToken2[];
+};
+type TextBlock2 = {
+    id: string;
+    kind: 'textBlock';
+    command: '\\section' | '\\subsection' | '\\subsubsection' | '\\paragraph';
+    field: InlineField2;
+};
+type ListItem2 = {
+    id: string;
+    field: InlineField2;
+    blocks: Document2Block[];
+};
+type ListBlock2 = {
+    id: string;
+    kind: 'list';
+    command: '\\begin{itemize}' | '\\begin{enumerate}';
+    closing: '\\end{itemize}' | '\\end{enumerate}';
+    items: ListItem2[];
+};
+type TableBlock2 = {
+    id: string;
+    kind: 'table';
+    command: '\\begin{tabular}';
+    closing: '\\end{tabular}';
+    columns: string;
+    rows: InlineField2[][];
+};
+type ImageBlock2 = {
+    id: string;
+    kind: 'image';
+    command: '\\includegraphics';
+    value: string;
+    options: Record<string, string>;
+};
+type RawBlock2 = {
+    id: string;
+    kind: 'raw';
+    command: '\\raw';
+    value: string;
+};
+type Document2Block = TextBlock2 | ListBlock2 | TableBlock2 | ImageBlock2 | RawBlock2;
+type Document2Node = {
+    nodeType: 'DocumentObject';
+    blocks: Document2Block[];
+    diagnostics: Document2Diagnostic[];
+};
+type ImportDocument2Options = {
+    strict?: boolean;
+    mode?: Document2ParseMode;
+};
+type DetectedMathSpan2 = {
+    start: number;
+    end: number;
+    source: string;
+    opening: string;
+    closing: string;
+    display: boolean;
+};
+type PreviewInline2 = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'math';
+    id: string;
+    tex: string;
+    display: boolean;
+    output: Document2MathOutput;
+    editable: boolean;
+};
+type PreviewBlock2 = {
+    kind: 'heading';
+    id: string;
+    level: 1 | 2 | 3;
+    inlines: PreviewInline2[];
+} | {
+    kind: 'paragraph';
+    id: string;
+    inlines: PreviewInline2[];
+} | {
+    kind: 'list';
+    id: string;
+    ordered: boolean;
+    items: Array<{
+        id: string;
+        inlines: PreviewInline2[];
+        blocks: PreviewBlock2[];
+    }>;
+} | {
+    kind: 'table';
+    id: string;
+    rows: PreviewInline2[][][];
+} | {
+    kind: 'image';
+    id: string;
+    src: string;
+    options: Record<string, string>;
+}
+/** Preview-only: raw / unknown blocks are omitted from preview until we add proper rendering. */
+ | {
+    kind: 'omit';
+    id: string;
+};
+type MathIsland2 = {
+    id: string;
+    tex: string;
+    display: boolean;
+    output: Document2MathOutput;
+    editable: boolean;
+};
+type Document2Preview = {
+    blocks: PreviewBlock2[];
+    mathIslands: MathIsland2[];
+};
+
+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 function findFirstInlineField(document: Document2Node): InlineField2 | null;
+declare function updateTextToken(document: Document2Node, fieldId: string, tokenId: string, text: string): Document2Node;
+declare function cloneDocument2Node(document: Document2Node): Document2Node;
+declare function insertDocument2BlockAfter(document: Document2Node, afterBlockId: string | null | undefined, block: Document2Block): Document2Node;
+declare function moveDocument2BlockById(document: Document2Node, blockId: string, direction: -1 | 1): Document2Node;
+declare function removeMathTokenById(document: Document2Node, tokenId: string): Document2Node;
+declare function insertMathTokenAtCaret(document: Document2Node, fieldId: string, textTokenId: string | null, caretOffset: number, session: EditorSession, opening?: string, closing?: string): Document2Node;
+declare function insertMathToken(document: Document2Node, fieldId: string, insertIndex: number, session: EditorSession, opening?: string, closing?: string): Document2Node;
+declare function replaceMathTokenFromSession(document: Document2Node, tokenId: string, session: EditorSession, opening?: string, closing?: string): Document2Node;
+declare function addDocument2TextBlock(document: Document2Node, command?: '\\section' | '\\subsection' | '\\subsubsection' | '\\paragraph', afterBlockId?: string | null): Document2Node;
+declare function removeDocument2BlockById(document: Document2Node, blockId: string): Document2Node;
+declare function addDocument2ListBlock(document: Document2Node, ordered: boolean, afterBlockId?: string | null): Document2Node;
+declare function addDocument2TableBlock(document: Document2Node, columns?: string, rowCount?: number, colCount?: number, afterBlockId?: string | null): Document2Node;
+declare function addDocument2ImageBlock(document: Document2Node, src?: string, afterBlockId?: string | null): Document2Node;
+declare function updateDocument2ImageValue(document: Document2Node, blockId: string, value: string): Document2Node;
+declare function addDocument2ListItem(document: Document2Node, listBlockId: string): Document2Node;
+declare function removeDocument2ListItem(document: Document2Node, listBlockId: string, itemId: string): Document2Node;
+
+declare function inlineFieldLatex(field: InlineField2): string;
+declare function document2Latex(document: Document2Node): string;
+
+declare const DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH = 100;
+type Document2HistoryStacks = {
+    past: Document2Node[];
+    future: Document2Node[];
+    maxDepth: number;
+};
+declare function createDocument2History(maxDepth?: number): Document2HistoryStacks;
+declare function pushDocument2Snapshot(stacks: Document2HistoryStacks, documentBeforeEdit: Document2Node): void;
+declare function restoreDocument2Undo(stacks: Document2HistoryStacks, documentNow: Document2Node): Document2Node | null;
+declare function restoreDocument2Redo(stacks: Document2HistoryStacks, documentNow: Document2Node): Document2Node | null;
+declare function document2HistoryCanUndo(stacks: Document2HistoryStacks): boolean;
+declare function document2HistoryCanRedo(stacks: Document2HistoryStacks): boolean;
+
+declare function createInlineField2(value?: string, mathObjects?: MathObject2Json[], options?: ImportDocument2Options, path?: string, diagnostics?: Document2Diagnostic[]): InlineField2;
+declare function fromDocumentJson2(json: unknown, options?: ImportDocument2Options): Document2Node;
+declare function createEmptyDocument2(): Document2Node;
+
+declare function detectMathSpans2(value: string): DetectedMathSpan2[];
+
+type Document2MathBridgeResult = {
+    editable: true;
+    session: EditorSession;
+} | {
+    editable: false;
+    reason: string;
+};
+declare function createEmptyArabicEquationSession(): EditorSession;
+declare function mathTokenToArabicEditorSession(math: MathNode | null): Document2MathBridgeResult;
+declare function mathSourceFromArabicSession(session: EditorSession, opening?: string, closing?: string): string;
+declare function mathNodeFromArabicSession(session: EditorSession, opening?: string, closing?: string): MathNode;
+
+declare function document2Preview(document: Document2Node, output?: Document2MathOutput): Document2Preview;
+
+export { DEFAULT_DOCUMENT2_HISTORY_MAX_DEPTH, type Document2Block, type Document2BlockJson, type Document2Diagnostic, type Document2HistoryStacks, type Document2Json, type Document2MathOutput, type Document2Node, type ImageBlock2, type ImportDocument2Options, type InlineField2, type InlineToken2, type ListBlock2, type MathIsland2, type MathObject2Json, type MathToken2, type PreviewBlock2, type PreviewInline2, type RawBlock2, type TableBlock2, type TextBlock2, type TextToken2, addDocument2ImageBlock, addDocument2ListBlock, addDocument2ListItem, addDocument2TableBlock, addDocument2TextBlock, cloneDocument2Node, createDocument2History, createEmptyArabicEquationSession, createEmptyDocument2, createInlineField2, detectMathSpans2, document2HistoryCanRedo, document2HistoryCanUndo, document2Latex, document2Preview, findFirstInlineField, fromDocumentJson2, inlineFieldLatex, insertDocument2BlockAfter, insertMathToken, insertMathTokenAtCaret, mathNodeFromArabicSession, mathSourceFromArabicSession, mathTokenToArabicEditorSession, moveDocument2BlockById, pushDocument2Snapshot, removeDocument2BlockById, removeDocument2ListItem, removeMathTokenById, replaceMathTokenFromSession, restoreDocument2Redo, restoreDocument2Undo, updateDocument2ImageValue, updateTextToken };