@barocss/math-editor 0.4.0 → 0.5.0

package/VALIDATION.md

@@ -1,5 +1,105 @@
 # Validation report
 
+## Inline fence transformation suggestions — workspace, 2026-09-09
+
+Core: **584 tests in 36 files passed**. Core type checking and the main site/docs
+build passed. `fence-suggestions-check.js` passed in Chromium for rich React and
+all nine host demos, including menu reopening, keyboard acceptance, cancellation,
+retained caret, continued typing and separate Undo entries. Editor.js is a block
+host; this run does not claim an inline placement for that adapter.
+
+`fence-context-check.js` passed all eight bracket choices through the optional
+footer in the same ten editor views. `fence-inline-options-check.js` passed in a
+native inline iframe with toolbar and footer disabled, including nearest nested
+fence targeting, ko/en switching, unchanged document on locale changes, retained
+input focus/caret, continued typing and teardown.
+
+Existing root conversion suggestions were rerun in React and Quill and passed.
+`fence-rendering-check.js` verifies the exported source after changing a bracket
+around a fraction. The editor and KaTeX screenshots were visually inspected:
+`output/playwright/fence-transform-editor.png` and
+`output/playwright/fence-transform-katex.png`. This uses the existing delimiter
+renderer and does not claim pixel-identical layout.
+
+See EDIT-029 through EDIT-032 for acceptance criteria. This is local Chromium
+workspace evidence, not a release, real OS IME or cross-browser certification.
+
+## Contextual radical tools — workspace, 2026-09-09
+
+Core: **570 tests passed in 35 files**. Type checking and the main documentation/demo build passed.
+
+`context-tools-check.js` passed in local Chromium for rich React and all nine
+host examples: Tiptap, ProseMirror, Lexical, Editor.js, TinyMCE, CKEditor, Quill,
+Slate and Gutenberg. It covers query-independent discovery, retained tools after
+suggestion dismissal, F6/Escape focus, conversion, selected index editing, a
+non-square-index explanation, radicand retention, Undo, leaving a radical and
+hiding tools during model range selection.
+
+`context-tools-options-check.js` passed for nearest nested targeting, native DOM
+inside an iframe, owner-document keyboard focus, dynamic `contextTools`, en/ko
+labels, synthetic composition guards, outside blur, teardown, and dynamic Web
+Component `context-tools` attributes. Synthetic events do not certify OS IME.
+
+The footer was visually inspected separately from the suggestion popup. Evidence
+is in `output/playwright/context-tools-footer.png` and the two browser fixtures.
+EDIT-021 through EDIT-028 record acceptance criteria and remaining checks: native
+Tab order, document equality across locale changes, individual framework-wrapper
+option smoke tests, and broader browsers/platforms. The new footer currently
+covers square/indexed roots. Other structure families remain roadmap work.
+These are workspace-source checks; no package or site was published.
+
+## Fractional scripts and empty-slot deletion — workspace, 2026-09-09
+
+Core: 568 tests passed in 35 files; type checking and formatting passed. The
+main documentation/demo build passed. `empty-slot-deletion-check.js` passed
+16 real-key checks across React/native DOM: Delete and Backspace from empty
+root, fraction, exponent and root-index slots, retained content, focus and Undo.
+Grid cells and populated rows are protected by the added core tests.
+
+`rendering-regression-check.js` passed 12 Chromium comparisons: three formulas,
+two base sizes and two renderers. Fraction terms matched KaTeX font sizes;
+vertical offset differences were at most 0.109em against a 0.25em threshold.
+Horizontal gap, active-input size and focus assertions passed. Matching-size
+editor/KaTeX screenshots were visually inspected for the indexed-root power
+and simple fractional power. Full pixel identity is not claimed.
+
+Local evidence: `output/playwright/math-rendering-regression-evidence.json`
+records metrics and source SHA-256 values. Screenshot pairs use the paths in
+[Rendering checks](RENDERING-TESTS.md). This is workspace-source evidence, not
+packed-release, all-host, cross-browser or full notation certification.
+
+See [Editing scenarios](EDITING-SCENARIOS.md) for stable scenario IDs, acceptance criteria, coverage gaps and per-run reporting.
+
+
+## Radical conversion suggestions — workspace, 2026-09-09
+
+Core tests: 558 passed in 34 files; type checking passed. Ten added cases cover
+nested radicands, retained node IDs, selected index `2`, safe reverse conversion,
+non-square and structured indices, nearest-root targeting, stale targets, empty
+slots, localization, literal text and Undo/Redo.
+
+`root-transform-check.js` passed in Chromium for rich React and Quill's native
+DOM field. It checks pointer and arrow/Enter acceptance, selected index editing,
+radicand preservation, reverse conversion, and rejection of index `3` conversion.
+The generated LaTeX and KaTeX preview match; editor/KaTeX radical screenshots
+were inspected. This does not certify every browser or every host adapter.
+
+## Selection suggestion navigation — workspace, 2026-09-09
+
+`apps/math-integrations/tests/selection-suggestions-check.js` passed in Chromium
+for rich React and all nine host integrations. The check covers Shift+arrow
+ranges, Up/Down navigation, the Alt+Down alias, Enter wrapping the selected
+characters, retained input focus after wrapping, and native mouse-drag selection.
+No page errors were reported. Core tests: 548 passed; core type check passed.
+`selection-collapse-check.js` also passed for React horizontal caret recovery,
+fraction boundaries and resumed typing. `tinymce-inline-check.js` passed for
+inline and classic iframe hosts, including vertical caret recovery after Escape
+dismisses the wrapping menu, Apply/Cancel, serialization and Undo/Redo.
+
+A visible wrapping menu now owns vertical arrows. Left/Right still collapses
+a model selection to its ordered edge. This replaces the Alt-only menu
+navigation policy in the historical selection-collapse record below.
+
 ## Styling and themes — workspace, 2026-09-09
 
 Release browser regression: all 385 existing Chromium cases passed across the
@@ -367,3 +467,234 @@ Core unit regression: **548 tests**. Shared integrations: **52 tests**. Core, in
 - Quill composition and typing regression fixtures pass, including read-only recovery, host history and matrix-cell entry.
 
 This is local Chromium evidence. OS IME, Safari/Firefox, installed WordPress and cross-application system clipboard checks were not repeated. No new mathematical grammar or numerical behavior is introduced. Release artifacts prepared before these changes require regeneration; nothing was published by this work.
+
+
+## EDIT-019 continuous editing — workspace, 2026-09-10
+
+- Run: `2026-09-09T17-47-53-597Z`; source fingerprint remained stable.
+- Evidence: [report](../../output/playwright/editing-scenarios/2026-09-09T17-47-53-597Z/REPORT.md), [checkpoints and source hashes](../../output/playwright/editing-scenarios/2026-09-09T17-47-53-597Z/report.json).
+- Command: `pnpm --filter @barocss/math-editor test:editing`.
+- Environment: Chromium 152 / macOS, English locale, workspace source.
+- **React standalone block: PASS, 28 checkpoints. Quill in-place block: PASS, 29 checkpoints.**
+- Real key input creates `fraction(indexedRoot(3, ab), 2) + matrix(1, 2; 3, 4)`;
+  an explicit tree assertion checks content and nesting. The last cell becomes
+  `456789` in a second uninterrupted typing chain.
+- Both surfaces pass two five-step Undo/Redo chains, retained typing focus,
+  empty-root Delete/Undo/Redo and unchanged retained content. Each first history
+  step is compared with its recorded structural checkpoint.
+- Quill draft operations leave host data unchanged. Apply is one host Undo step;
+  Redo restores it. Save, page reload, Restore and reopen preserve the Delta and
+  formula structure. The restored matrix remains editable; Cancel preserves the
+  saved document. React has no host persistence lifecycle, so that part is N/A.
+- The runner fails on either scenario failure or a changed source fingerprint.
+  It stores the executed fixture, failure screenshots, diagnostics and final data.
+- No runtime library changes were required. Earlier fixture failures exposed OS
+  `End` assumptions and selection of the wrong saved block; the final fixture
+  verifies caret offsets with arrows and reopens the uniquely identified formula.
+- Not covered: other hosts, Quill inline mode, real OS IME/clipboard,
+  Firefox/WebKit, touch, accessibility and performance budgets. No release-wide
+  pass or new rendering pass is claimed.
+
+
+## EDIT-019 Quill inline extension — workspace, 2026-09-10
+
+- Run: `2026-09-09T22-30-59-017Z`; source fingerprint remained stable.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T22-30-59-017Z/REPORT.md) and
+  [checkpoints](../../output/playwright/editing-scenarios/2026-09-09T22-30-59-017Z/report.json).
+- **React block: PASS (28 checkpoints); Quill block: PASS (29); Quill inline: PASS (30).**
+- The unchanged continuous editing chain runs in all three targets. Renderer and
+  mode are recorded separately, including artifact names and the failure summary.
+- Quill inline commits with Enter from the outer boundary. No extra formula line
+  or host paragraph appears; prose is unchanged by math editing.
+- Apply/host Undo/Redo, Save/reload/Restore, re-edit and Cancel preserve the
+  inline formula. A later Right-arrow exit returns focus to Quill; typing `q`
+  inserts exactly one character immediately after that formula. Host Undo
+  restores the committed Delta, including formula data.
+- Runtime library code was unchanged. The runner and scenario documentation were
+  extended; no npm publication or new rendering audit was required.
+- Other hosts, standalone inline adapters, OS IME/clipboard, Firefox/WebKit,
+  touch, accessibility and performance remain outside this run.
+
+
+## EDIT-019 Tiptap and ProseMirror — workspace, 2026-09-10
+
+- Run: `2026-09-09T22-39-51-097Z`, stable source fingerprint.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T22-39-51-097Z/REPORT.md) and
+  [checkpoints and hashes](../../output/playwright/editing-scenarios/2026-09-09T22-39-51-097Z/report.json).
+- **7 targets PASS / 205 checkpoints:** React block (28), Quill block/inline
+  (29/30), Tiptap block/inline (29/30), ProseMirror block/inline (29/30).
+- Chromium 152 on macOS, English UI, workspace source. The extended runner hashes
+  both newly covered plugin sources and package metadata.
+- Each target passes the existing continuous formula chain. Integrated hosts
+  additionally check Apply/host Undo/Redo, Save/reload/Restore, re-edit/Cancel,
+  retained formula data and unchanged prose/container structure. Inline targets
+  check Enter commit, right-boundary exit, exact prose position and host Undo.
+- Initial integrated run `2026-09-09T22-36-38-459Z`: six PASS, Tiptap inline FAIL.
+  A quick prose edit after Restore shared the restored document's history event;
+  Undo removed both. The sample now brackets `setContent` with `closeHistory`
+  transactions, keeping the replacement and subsequent typing separate.
+- Corrected run `2026-09-09T22-38-26-544Z`: seven PASS. The final run above repeats
+  all seven targets with the final runner documentation and source hashes.
+- Integration-demo TypeScript and production build pass. Existing large-chunk
+  build warnings remain. Test source formatting passes. Core/plugin runtime
+  code was unchanged; the fix belongs to the Tiptap demo's restoration callback.
+- Remaining: Lexical, Editor.js, TinyMCE, CKEditor, Slate and Gutenberg; native OS
+  IME/clipboard, other browser engines, touch, accessibility and performance.
+
+
+## EDIT-019 Lexical — workspace, 2026-09-10
+
+- Run: `2026-09-09T23-08-15-353Z`, stable source fingerprint.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T23-08-15-353Z/REPORT.md) and
+  [checkpoints and hashes](../../output/playwright/editing-scenarios/2026-09-09T23-08-15-353Z/report.json).
+- **9 targets PASS / 264 checkpoints:** React block (28), Quill block/inline
+  (29/30), Tiptap block/inline (29/30), ProseMirror block/inline (29/30),
+  Lexical block/inline (29/30).
+- Chromium 152 on macOS, English UI, workspace source. Fingerprints now include
+  the Lexical plugin source and package metadata.
+- Lexical passes the full nested editing and two history chains, Apply as one
+  host Undo event, Redo, Save/reload/Restore, re-edit and Cancel. Inline also
+  passes Enter commit without a new paragraph, right-boundary exit, focus return,
+  typing immediately after the formula and host Undo.
+- Host checks read Lexical serialized state and retain container boundaries and
+  formula atoms. Drafts must not change saved host state. Restoration must match
+  the complete saved JSON; math rendering alone is not the persistence check.
+- The initial run `2026-09-09T23-06-35-494Z` reached Save/Restore in both Lexical
+  modes but used an incorrect locator for reopening. Lexical uses a mounted
+  `.bme-lexical-node` widget; `data-barocss-math` belongs to its HTML export.
+  The fixture now locates its live widget. No product code change was needed.
+- Runner formatting passes. This change only extends tests and documentation;
+  no new build, package publication or rendering audit was required.
+- Next: Editor.js, TinyMCE, CKEditor, Slate and Gutenberg. Native OS IME/clipboard,
+  other browser engines, touch, accessibility and performance remain outside this run.
+
+
+## EDIT-019 Editor.js — workspace, 2026-09-10
+
+- Run: `2026-09-09T23-25-26-845Z`, stable source fingerprint.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T23-25-26-845Z/REPORT.md) and
+  [checkpoints and hashes](../../output/playwright/editing-scenarios/2026-09-09T23-25-26-845Z/report.json).
+- **10 targets PASS / 293 checkpoints:** React block (28), Quill/Tiptap/
+  ProseMirror/Lexical block and inline (29/30 each), Editor.js block (29).
+- Chromium 152 on macOS, English UI, workspace source. Fingerprints include
+  Editor.js plugin source and package metadata.
+- Editor.js passes nested fraction/root/matrix editing, suggestion selection,
+  two uninterrupted formula Undo/Redo chains, empty-root deletion/restoration,
+  Apply, Save/reload/Restore, re-edit and Cancel. Draft checks confirm saved host
+  data stays unchanged until Apply; prose blocks and block order remain intact.
+- Async `save()` comparisons exclude only the generated `time` field. Block IDs,
+  saved model data, paragraph data and version remain in persistence assertions.
+- **Editor.js host Undo/Redo is not covered:** the demo has no document history
+  integration. The runner records this limitation in `hostHistory`; it retains
+  the mandatory host Undo/Redo assertions for other configured hosts. Editor.js
+  inline mode is outside the block tool's contract.
+- Test-source formatting passes. Only the runner, fixture and documentation
+  changed; no runtime fix, build, publication or new rendering audit was needed.
+- Next: TinyMCE, CKEditor, Slate and Gutenberg. Native OS IME/clipboard, other
+  browser engines, touch, accessibility and performance remain separate work.
+
+
+## EDIT-019 TinyMCE — workspace, 2026-09-10
+
+- Run: `2026-09-09T23-39-57-339Z`, stable source fingerprint.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T23-39-57-339Z/REPORT.md) and
+  [checkpoints and hashes](../../output/playwright/editing-scenarios/2026-09-09T23-39-57-339Z/report.json).
+- **12 targets PASS / 352 checkpoints:** React block (28), Quill/Tiptap/
+  ProseMirror/Lexical/TinyMCE block and inline (29/30 each), Editor.js block (29).
+- Chromium 152 on macOS, English UI, workspace source. TinyMCE 8.9.0 uses
+  `inline: true` for its host. Both math modes are covered; classic iframe mode
+  is not covered by this run. Fingerprints include TinyMCE source and metadata.
+- TinyMCE passes the sustained fraction/root/matrix chain, formula history,
+  draft isolation, one host Undo/Redo for Apply, Save/reload/Restore, re-edit and
+  Cancel. Inline also passes Enter commit, right-boundary exit, focus return,
+  typing immediately after the formula and host Undo.
+- The fixture applies and reopens an empty atom before the chain because TinyMCE
+  inserts on Apply. This exposed a real bug: the empty preview renderer returned
+  no visible content, leaving no click target. The adapter now shows the existing
+  localized empty-formula message and skips the renderer for empty LaTeX.
+  Serialized content stays empty; the test checks the label does not leak into HTML.
+- HTML comparisons retain the complete serialized document. A detached parser
+  reads prose and element boundaries for caret checks. Live locators exclude
+  TinyMCE's `.mce-offscreen-selection` clone inside the editable body.
+- Diagnostic run `2026-09-09T23-38-20-112Z` confirmed that a reported prose Undo
+  failure was in the fixture: saved and actual HTML were identical, but building
+  the expected prose result had mutated the saved units array. The fixture now
+  copies that array. No timing wait or product history change is used to pass it.
+- TinyMCE package TypeScript, two unit tests, build and changed-source formatting
+  pass. Package-local build also exposed a metafile path check using the wrong
+  working directory. The build now sets esbuild's working directory to the repo
+  root; the normal package build command succeeds with its dependency checks intact.
+- Patch changeset: `.changeset/tiny-math-empty-preview.md`. No package was published.
+- Remaining: CKEditor, Slate, Gutenberg, TinyMCE iframe mode, native OS
+  IME/clipboard and other browser/input environments. Editor.js document history
+  remains unverified because its demo has no host history integration.
+
+
+## EDIT-019 CKEditor — workspace, 2026-09-10
+
+- Run: `2026-09-09T23-44-59-263Z`, stable source fingerprint.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T23-44-59-263Z/REPORT.md) and
+  [checkpoints and hashes](../../output/playwright/editing-scenarios/2026-09-09T23-44-59-263Z/report.json).
+- **14 targets PASS / 411 checkpoints:** React block (28), Quill/Tiptap/
+  ProseMirror/Lexical/TinyMCE/CKEditor block and inline (29/30 each),
+  Editor.js block (29).
+- Chromium 152 on macOS, English UI, workspace source. CKEditor 48.5.0 uses the
+  local ClassicEditor demo. Fingerprints include CKEditor plugin source and
+  package metadata. This run does not cover other CKEditor builds or collaboration.
+- CKEditor passes the sustained fraction/root/matrix chain, keyboard suggestion
+  selection, two formula Undo/Redo chains, empty-root deletion/restoration,
+  unchanged host data during drafts, Apply as one host Undo event and host Redo.
+- Save/reload/Restore retains the complete serialized HTML and editable math
+  structure. Re-edit and Cancel leave that HTML unchanged. Inline also passes
+  Enter commit without another paragraph, Right-arrow exit, focus return,
+  prose input immediately after the formula and host Undo.
+- The fixture reuses the detached HTML parser for prose/container checks and
+  copies parsed units when constructing expectations. Full saved-state equality
+  remains required for history and persistence checks.
+- Test-source formatting passes. Only tests and documentation changed in this
+  extension; no runtime fix, additional build or package publication was needed.
+- Next: Slate and Gutenberg. TinyMCE iframe hosts, other CKEditor builds,
+  native OS IME/clipboard and other browser/input environments remain separate
+  targets. Editor.js document history is still outside its demo's configuration.
+
+
+## EDIT-019 all integration demos — workspace, 2026-09-10
+
+- Run: `2026-09-09T23-55-26-302Z`, stable source fingerprint.
+- [Report](../../output/playwright/editing-scenarios/2026-09-09T23-55-26-302Z/REPORT.md) and
+  [checkpoints and hashes](../../output/playwright/editing-scenarios/2026-09-09T23-55-26-302Z/report.json).
+- **17 targets PASS / 499 checkpoints**, covering all nine integration demos
+  plus standalone React block. Chromium 152 on macOS, English UI, workspace source.
+
+| Editor | Tested math modes | Checkpoints | Host Undo/Redo |
+| --- | --- | ---: | --- |
+| React standalone | Block | 28 | Not applicable |
+| Quill | Block + inline | 59 | PASS |
+| Tiptap | Block + inline | 59 | PASS |
+| ProseMirror | Block + inline | 59 | PASS |
+| Lexical | Block + inline | 59 | PASS |
+| Editor.js | Block | 29 | Not configured; unverified |
+| TinyMCE | Block + inline, inline host | 59 | PASS |
+| CKEditor | Block + inline, ClassicEditor | 59 | PASS |
+| Slate | Block + inline | 59 | PASS |
+| Gutenberg | Block, standalone provider | 29 | PASS |
+
+- Slate passes the sustained nested editing chain, two formula Undo/Redo chains,
+  Apply as one host history event, Save/reload/Restore, re-edit and Cancel.
+  Inline also passes Enter commit, Right-arrow exit, host focus, exact prose
+  insertion position and host Undo. Comparisons retain the saved descendant
+  array and formula objects; prose checks also preserve paragraph boundaries.
+- Gutenberg passes the same block chain and provider host Undo/Redo. Full saved
+  HTML equality includes WordPress comments and encoded math data. A separate
+  detached DOM comparison checks prose and block order; comments are not prose.
+- Both new hosts keep saved document data unchanged while editing a draft.
+  Restore reproduces the full saved state and reopens the same editable model.
+- Fingerprints now include Slate and Gutenberg source/package metadata, as well
+  as the previously covered hosts, core, shared helpers, demos and test runner.
+- Formatting passes. This extension changed only tests and documentation; no
+  runtime fix, new build or publication was needed.
+- This run covers local demo configurations. It does not replace the separate
+  WordPress admin/plugin ZIP checks. TinyMCE iframe, other CKEditor builds,
+  collaboration, native OS IME/clipboard, Firefox/WebKit, touch, accessibility
+  and performance remain separate targets. Editor.js/Gutenberg are block tools;
+  no inline mode is claimed for them.

package/dist/context-tools.d.ts

@@ -0,0 +1,21 @@
+import { type MathState, type MathStructure } from './model.js';
+/** The closest supported wrapper owns the footer, even when roots and fences are nested. */
+export declare function structureEditingContext(state: MathState): {
+    fence: MathStructure;
+    root?: undefined;
+} | {
+    root: {
+        id: string;
+        kind: "root" | "indexedRoot";
+        target: "root" | "indexedRoot";
+        canTransform: boolean;
+        indexCaret: {
+            id: string;
+            start: number;
+            end: number;
+        } | undefined;
+    } | undefined;
+    fence?: undefined;
+} | undefined;
+/** Reject an action if focus has moved to a different wrapper since it was displayed. */
+export declare function changeContextFence(state: MathState, id: string, kind: string): MathState;

package/dist/context-tools.js

@@ -0,0 +1,37 @@
+import { documentRows, isLiteralText, } from './model.js';
+import { fences } from './fences.js';
+import { rootEditingContext } from './root-transform.js';
+import { setMathPresentation } from './presentation.js';
+/** The closest supported wrapper owns the footer, even when roots and fences are nested. */
+export function structureEditingContext(state) {
+    if (isLiteralText(state.document, state.caret.id))
+        return;
+    const visit = (row, parent) => {
+        for (const node of row.children) {
+            if (node.type === 'text') {
+                if (node.id === state.caret.id)
+                    return parent;
+            }
+            else {
+                const target = fences(node) || ['root', 'indexedRoot'].includes(node.type) ? node : parent;
+                for (const slot of node.slots) {
+                    const found = visit(slot, target);
+                    if (found)
+                        return found;
+                }
+            }
+        }
+    };
+    const node = documentRows(state.document)
+        .map((row) => visit(row))
+        .find(Boolean);
+    if (!node)
+        return;
+    return fences(node) ? { fence: node } : { root: rootEditingContext(state) };
+}
+/** Reject an action if focus has moved to a different wrapper since it was displayed. */
+export function changeContextFence(state, id, kind) {
+    return structureEditingContext(state)?.fence?.id === id
+        ? setMathPresentation(state, id, { fence: kind })
+        : state;
+}

package/dist/dom/context-keyboard.d.ts

@@ -0,0 +1,2 @@
+/** Keep focus in the same document (including iframe hosts). Arrow keys only browse; Enter applies. */
+export declare function focusContextAction(host: HTMLElement, key: string): boolean;

package/dist/dom/context-keyboard.js

@@ -0,0 +1,22 @@
+/** Keep focus in the same document (including iframe hosts). Arrow keys only browse; Enter applies. */
+export function focusContextAction(host, key) {
+    const buttons = Array.from(host.querySelectorAll('button:not(:disabled)'));
+    if (!buttons.length)
+        return false;
+    const index = buttons.indexOf(host.ownerDocument.activeElement);
+    let next;
+    if (key === 'F6')
+        next = buttons.find((button) => button.getAttribute('aria-pressed') === 'true') ?? buttons[0];
+    else if (key === 'ArrowRight')
+        next = buttons[(index + 1) % buttons.length];
+    else if (key === 'ArrowLeft')
+        next = buttons[(index - 1 + buttons.length) % buttons.length];
+    else if (key === 'Home')
+        next = buttons[0];
+    else if (key === 'End')
+        next = buttons[buttons.length - 1];
+    if (!next)
+        return false;
+    next.focus({ preventScroll: true });
+    return true;
+}

package/dist/dom/menu-position.d.ts

@@ -4,6 +4,9 @@ interface MenuRect {
     right: number;
     bottom: number;
 }
+/** Follow layout and visual viewport changes, including ancestor transforms that
+ * do not produce window resize or element ResizeObserver notifications. */
+export declare function followMathMenuPosition(anchor: HTMLElement, position: () => void, ignoreScrollWithin?: HTMLElement): () => void;
 /** Choose a scrollable vertical gap without covering host controls in the same column. */
 export declare function mathMenuPlacement(bounds: MenuRect, anchor: MenuRect, width: number, desiredHeight: number, preferredHeight: number, avoid?: readonly MenuRect[]): {
     left: number;

package/dist/dom/menu-position.js

@@ -1,3 +1,41 @@
+/** Follow layout and visual viewport changes, including ancestor transforms that
+ * do not produce window resize or element ResizeObserver notifications. */
+export function followMathMenuPosition(anchor, position, ignoreScrollWithin) {
+    const win = anchor.ownerDocument.defaultView;
+    let frame = 0;
+    const schedule = () => {
+        if (!frame)
+            frame = win.requestAnimationFrame(() => {
+                frame = 0;
+                position();
+            });
+    };
+    const scroll = (event) => {
+        if (event.target &&
+            'nodeType' in event.target &&
+            ignoreScrollWithin?.contains(event.target))
+            return;
+        schedule();
+    };
+    const changes = new MutationObserver(schedule);
+    for (let element = anchor; element; element = element.parentElement)
+        changes.observe(element, { attributes: true, attributeFilter: ['style', 'class'] });
+    const resize = typeof ResizeObserver === 'undefined' ? undefined : new ResizeObserver(schedule);
+    resize?.observe(anchor);
+    win.addEventListener('resize', schedule);
+    win.addEventListener('scroll', scroll, true);
+    win.visualViewport?.addEventListener('resize', schedule);
+    win.visualViewport?.addEventListener('scroll', schedule);
+    return () => {
+        changes.disconnect();
+        resize?.disconnect();
+        win.cancelAnimationFrame(frame);
+        win.removeEventListener('resize', schedule);
+        win.removeEventListener('scroll', scroll, true);
+        win.visualViewport?.removeEventListener('resize', schedule);
+        win.visualViewport?.removeEventListener('scroll', schedule);
+    };
+}
 /** Fixed menus escape ordinary scrolling text areas. Transforms and containment
  * establish a local containing block, so overflow at that block and above still clips. */
 function establishesFixedContainingBlock(style) {
@@ -68,7 +106,13 @@ export function mathMenuPlacement(bounds, anchor, width, desiredHeight, preferre
 /** Position a fixed portal in viewport coordinates, including transformed modal hosts. */
 export function positionMathMenu(menu, anchor, maxHeight, avoidElements = []) {
     const win = menu.ownerDocument.defaultView;
-    const bounds = { left: 8, top: 8, right: win.innerWidth - 8, bottom: win.innerHeight - 8 };
+    const viewport = win.visualViewport;
+    const bounds = {
+        left: (viewport?.offsetLeft ?? 0) + 8,
+        top: (viewport?.offsetTop ?? 0) + 8,
+        right: (viewport?.offsetLeft ?? 0) + (viewport?.width ?? win.innerWidth) - 8,
+        bottom: (viewport?.offsetTop ?? 0) + (viewport?.height ?? win.innerHeight) - 8,
+    };
     let contained = false;
     for (let parent = menu.parentElement; parent; parent = parent.parentElement) {
         const style = win.getComputedStyle(parent);

package/dist/dom.d.ts

@@ -17,6 +17,8 @@ export interface DOMMathEditorOptions {
     mode?: MathEditorMode;
     toolbar?: boolean | readonly StructureKind[];
     toolbarMaxItems?: number;
+    /** Show contextual structure actions below the editing surface. Defaults to true. */
+    contextTools?: boolean;
     showLineNumbers?: boolean;
     onChange?: (document: MathDocument, latex: string) => void;
     /** Final DOM/caret notification, including focus and selection-only updates. */