@barocss/math-editor 0.4.0 → 0.6.1

package/VALIDATION.md

@@ -1,5 +1,188 @@
 # Validation report
 
+## Readability, geometry and navigation — release preparation, 2026-09-14
+
+This candidate includes a configurable editing minimum, line clearance for
+scripts, fraction descendant sizing, nested fence/radical fixes, token/structure
+movement and selection, and visual text-popup zoom. The learning and styling
+guides now recommend a 26px editing base for complex fractions, with a separate
+preview/export size and an optional 16px nested minimum.
+
+- Core regression checks: 1,743 unit tests passed; core and demo type checks passed.
+- Focused browser checks: minimum-size editing, nested fences, script radicals,
+  keyboard movement/selection, and visual popup zoom. Detailed scope and limits
+  are recorded in the source-only records below.
+- English/Korean site guidance explains the larger editing size. Public keyboard
+  help now documents Ctrl/Option movement and selection and the matrix column
+  deletion shortcut change.
+- Historical full rendering and continuous-editing results below were obtained
+  before this candidate. They are not a fresh all-suite pass for the new size
+  policy. Exact curves/spacing and broader browser/platform QA remain open.
+- This section records preparation, not npm publication or site deployment.
+
+Source evidence: `test/rendering/STATUS.md`, `test/rendering/READABILITY.md`,
+`test/editing/TOKEN-NAVIGATION.md`, and
+`packages/math-editor-text/test/VISUAL-ZOOM.md` in the repository.
+
+## Learning and keyboard help — workspace, 2026-09-13
+
+- EDIT-035: **4 results / 40 checkpoints passed**: five model-checked tutorial exercises, wrong-answer/reset/close behavior, unchanged playground, toolbar help, Korean labels, and F1 lifecycle on React block/native block/native inline. [Evidence](../../output/playwright/editing-scenarios/2026-09-13T12-33-34-456Z/REPORT.md).
+- EDIT-019: **17 targets / 549 checkpoints passed**, including F1/Escape before the full continuous editing and host persistence chain. [Evidence](../../output/playwright/editing-scenarios/2026-09-13T12-31-33-614Z/REPORT.md).
+- Core: **1,736 tests / 43 files**, core/demo type checks, package build and site build passed.
+- Rendering: **330 PASS / 0 DIFF / 0 ERROR**, source stable. [Gallery](../../output/playwright/rendering-audit/2026-09-13T12-31-34-393Z/GALLERY.html). The new styles target help and the tutorial; mathematical geometry thresholds are unchanged.
+
+The first toolbar-help check exposed native selection collapse after closing help; selection restoration now passes immediate wrapping and continued input. A separate toolbar now uses explicit `onHelp` ownership instead of guessing a target field. The tutorial's LaTeX readout is not an extra live status region. English semantic locale-key checks pass.
+
+The consolidated CI entry point now includes the learning suite. These are local Chromium/macOS results. Actual OS F1/Fn routing, screen readers and system clipboard exchange remain unverified. No npm/site publication was performed.
+
+## Supported-notation editing milestone — workspace, 2026-09-13
+
+The bounded milestone in [the roadmap](ROADMAP.md) passed its local gate. This is a workspace result; no package version or publication status changed.
+
+- Core: **1,736 tests in 43 files**, strict core and browser-fixture type checks, and package build passed.
+- Editing: **113 cases / 4,311 checkpoints** across 11 suites. All suites used identical source fingerprints, which still matched the candidate after execution.
+- Rendering: **91 formulas / 330 PASS, 0 DIFF, 0 ERROR**. Existing thresholds were retained. Rendering sources matched the editing candidate. Twenty-one direct-shortcut cases also compare actual edited output with KaTeX.
+- Main site/docs production build passed. The repository-owned runner and CI workflow use `node scripts/check-math-editor.mjs`. Workflow YAML and runner syntax passed; remote GitHub Actions execution is not claimed.
+
+| Suite | Cases | Checkpoints | Result |
+| --- | ---: | ---: | --- |
+| EDIT-006 | 3 | 2766 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-56-52-074Z/REPORT.md) |
+| EDIT-007 | 4 | 76 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-57-55-776Z/REPORT.md) |
+| EDIT-013 | 2 | 10 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-58-09-267Z/REPORT.md) |
+| EDIT-016 | 2 | 28 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-58-21-145Z/REPORT.md) |
+| EDIT-018 | 8 | 60 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-58-33-699Z/REPORT.md) |
+| EDIT-018-options | 5 | 30 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-58-46-765Z/REPORT.md) |
+| EDIT-017-narrow | 3 | 12 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-58-58-829Z/REPORT.md) |
+| EDIT-029 | 3 | 156 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-59-12-733Z/REPORT.md) |
+| EDIT-034 | 3 | 131 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-59-30-658Z/REPORT.md) |
+| EDIT-033 | 63 | 510 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T11-59-45-550Z/REPORT.md) |
+| EDIT-019 | 17 | 532 | [PASS](../../output/playwright/editing-scenarios/2026-09-13T12-00-17-841Z/REPORT.md) |
+
+[Consolidated evidence](../../output/playwright/math-editor-milestone/2026-09-13/REPORT.md) · [Rendering gallery](../../output/playwright/rendering-audit/2026-09-13T12-01-09-133Z/GALLERY.html)
+
+Corrections include forward structure deletion, joining the following line, preferred vertical column retention, malformed clipboard rejection, multiline-paste rejection in React single-line fields, consistent Shift+Enter behavior and horizontal scrolling inside narrow inline hosts. English and Korean include the new invalid-clipboard message.
+
+Clipboard checks use controlled ClipboardEvents/DataTransfer. Read-only is toggled without pointer blur to isolate the host state transition; clicking outside may intentionally apply a draft first. Editor.js data is checked after re-enabling because it cannot save while read-only. Its demo has no host Undo integration. Svelte option updates use its action API; the framework sample also covers actual Svelte mount/unmount.
+
+Scope is desktop Chromium 152 on macOS with KaTeX 0.16.28. Safari, Firefox, Windows, real OS IME/clipboard, touch, screen readers, TinyMCE iframe and an installed WordPress admin are separate validation work. Geometry uses selected anchors and screenshot review, not complete pixel equality.
+
+## Held arrow navigation — workspace validation, 2026-09-13
+
+- React and native DOM now read the live input selection before keydown handling. Delayed selection events no longer leave token/slot boundary checks one key repeat behind.
+- EDIT-034: 3 renderer/mode targets passed 131 checkpoints with repeated keydown and one final keyup. Both horizontal directions, fraction slots, held Shift selection, collapse, continued input and Undo are covered.
+- EDIT-033: 63 cases / 510 checkpoints passed, including 21 actual edited-output comparisons with KaTeX.
+- EDIT-019: all 17 standalone/integration targets passed 499 continuous editing checkpoints.
+- Core: 1,677 tests / 42 files, type checking and package build passed. Evidence is linked from the source-only editing test README. This change is not published yet.
+
+## Selection shortcuts — workspace validation, 2026-09-13
+
+- Core: 1,677 tests / 42 files passed; type checking passed.
+- EDIT-033: 63 cases / 510 checkpoints passed in Chromium. React block and native DOM block/inline each cover keyboard, native input and dragged selections, seven wrapping keys, continued typing and Undo/Redo.
+- Geometry: 91 formulas / 330 combinations passed after fixing fraction term sizing and spacing. The same thresholds apply.
+- Twenty-one keyboard cases also compare the actual edited output with KaTeX using the existing font-size and vertical-position thresholds.
+- EDIT-019: all 17 standalone/integration targets passed 499 continuous editing checkpoints after the layout correction.
+- Browser artifacts and measured rendering limits remain in the source-only editing/rendering ledgers. OS IME, other browser engines and the previously excluded host configurations remain separate work.
+
+## 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 +550,253 @@ 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.
+
+## Text editor integrations — 2026-09-13
+
+- Source-range tests: 31 passing cases (`packages/math-editor-text/test/ranges.test.ts`).
+- macOS Chromium browser adapters: 52 passing checkpoints across CodeMirror 6, CodeMirror 5, and Monaco. Includes nested root editing, display Enter, read-only changes, conflicting source, unsupported syntax, code exclusion, and Korean popup labels.
+- VS Code 1.103.1 Extension Host: four command-opening checks and eight Webview Apply/Cancel/Undo/Redo checks across Markdown and LaTeX. A disposable copy uses a test-only DOM input driver; no test driver ships in the VSIX.
+- Evidence: `output/playwright/math-text/`. Browser script: `apps/math-text-demo/test/editing.browser.js`. VS Code runner: `pnpm --filter barocss-math-editor test:extension`.
+- Remaining coverage: Firefox/Safari, Windows/Linux shortcuts, screen readers, VS Code web/remote hosts, and custom Markdown/TeX dialect resolvers.
+
+## Direct source completion and example guides — 2026-09-13
+
+- Shared source unit coverage: 37 passing checks, including range detection, fraction/root argument positions, rectangular matrices, symbol aliases, canonical export spellings and localized completion labels.
+- Browser source completion: 42 checks across CodeMirror 5, CodeMirror 6 and Monaco. Covers command-only replacement, focus retention, one-step Undo/Redo, forward argument navigation, scrolling, explicit catalog opening, incomplete source, read-only state and visual-popup fallback.
+- Additional source layout checks: 9 across the three hosts, covering indexed roots, reverse argument navigation, KaTeX preview placement and composition-event suspension. Synthetic composition events test gating; this is not a complete OS IME certification.
+- Existing visual-popup browser suite: 52 checkpoints still pass.
+- Example guides: 12 pages, including all nine document editors, with installation instructions and links checked against rendered HTML documentation.
+- Text packages, main site and integration site build successfully. Main and integration bundles retain existing large-chunk warnings.
+- Scripts: `apps/math-text-demo/test/source.browser.js`, `source-layout.browser.js`, `example-guides.browser.js`. Evidence is under `output/playwright/math-text/`.
+- This does not establish Firefox/Safari, Windows/Linux, screen-reader or VS Code source-completion support. No npm or site publication was performed for this change.

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/caret-geometry.js

@@ -21,7 +21,7 @@ export function renderedCaretGeometry(surface) {
             ? affinity === 'forward'
                 ? candidates.at(-1)
                 : candidates[0]
-            : candidates.find((item) => item.querySelector('.me-input')) ?? candidates[0];
+            : (candidates.find((item) => item.querySelector('.me-input')) ?? candidates[0]);
         const mirror = run?.querySelector('.me-measure');
         if (!run || !mirror)
             return;

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/help.d.ts

@@ -0,0 +1,5 @@
+import { type MathLocale } from '../i18n.js';
+/** Route a toolbar request to its owning field, including fields inside an iframe. */
+export declare function requestMathHelp(control: HTMLElement): void;
+/** Shared help UI. It does not execute model commands or read the clipboard. */
+export declare function attachMathHelp(root: HTMLElement, locale: () => MathLocale): () => void;