@matrajs/mcp 1.0.0 → 1.0.1

package/docs/benchmarks-full.md

@@ -9,10 +9,10 @@ minified, gzipped:
 
 | | minified | gzipped |
 |---|---|---|
-| **Matra** | 92.2 kB | **30 kB** |
+| **Matra** | 94.6 kB | **31 kB** |
 | Tiptap 3.30 | 370.5 kB | 117.2 kB |
 
-**3.9× smaller.** Matra has no runtime dependencies; Tiptap brings ProseMirror,
+**3.8× smaller.** Matra has no runtime dependencies; Tiptap brings ProseMirror,
 which is 51 packages in `node_modules`. The figure was 25 kB at 0.16; 1.0
 spent 3.6 kB on the engine doing more — attributes one extension adds to
 another's nodes, paste and drop hooks, files and text dropped from outside,

package/docs/changelog.md

@@ -2,6 +2,51 @@
 
 All packages share one version number and are released together.
 
+## 1.0.1 — 2026-09-05
+
+Three bugs a person meets in the first minute, found by driving every
+extension through the built package in every framework, and the harness that
+found them.
+
+**The caret stays put through a change of structure.** Select a word, press
+the heading button, press bold: the word is bold. Press Tab in a list item:
+the caret is still in the word it was in. Both failed, because a structural
+change — a paragraph made a heading, blocks wrapped in a list or a quote, an
+item nested or lifted, a block split — was a plain replacement whose position
+map sent every position inside it to the end. A replace step can now carry
+the finer story (`[start, oldSize, newSize]` triples over the tokens that
+actually moved), `Transform.rebuild` writes it from the runs of content an
+operation keeps in place, and every structural operation in the engine uses
+it. Carets, markers, decorations and collaborators' positions all follow.
+The JSON is backwards compatible: a 1.0.0 client applies the same
+replacement and maps the old, coarser way.
+
+**The list button works.** Toggling a bullet, ordered or task list off did
+nothing at all: there was no wrapper to lift a paragraph out of, so the
+command was refused. Turning two selected paragraphs into a list made one
+item holding both. The three toggles now share one command: outside a list
+the selected blocks become a list, one item each; in a list of that kind the
+selected items leave it, one level out when nested and out to plain blocks at
+the top; in a list of another kind the list changes kind where it stands.
+Shift-Tab on a top-level item leaves the list the same way.
+
+**What is drawn on an element is what the document says.** A node
+decoration — the focus class, a search highlight — whose whole range an edit
+replaced was forgotten by the renderer's comparison, so the element it was
+drawn on was patched and kept its class: after `setContent` two paragraphs
+could both claim the caret. The renderer now remembers what it drew on each
+element and inside it, and compares against that.
+
+**`pnpm exercise`.** Every extension the package exports, built into one
+editor and driven the way a person drives it — every command run, every
+input rule typed, paste pasted, menus waited for — against the built package
+in a DOM. The install matrix runs the same file inside each of the five
+framework apps, so a framework proves three things at once: the package
+installs, every extension works in it, and the binding relays what happened.
+CI runs both.
+
+**Bundle.** The starter kit is 31 kB gzipped, from 30. The budget is 32.
+
 ## 1.0.0 — 2026-09-04
 
 The engine got faster everywhere it was measured, thirty-six extensions

package/docs/contributing.md

@@ -25,6 +25,9 @@ pnpm build       # tsup, all packages
 
 CI runs those plus `pnpm size`, `pnpm bench:check`, `pnpm links`,
 `pnpm wiring`, `pnpm packaging`, `pnpm facts --check` and, in its own job,
+`pnpm exercise` — every extension driven through the built package: every
+command run, every input rule typed, paste pasted, in a DOM.
+
 `pnpm install:matrix` — every package packed and installed with plain npm
 into a fresh React, Vue, Svelte, Solid and vanilla Vite app, built and run.
 Running the first four locally catches almost everything. Run the benchmark

package/docs/engine.md

@@ -49,7 +49,7 @@ honest:
 | Phase | Layer | Lines | gz | Status |
 |---|---|---|---|---|
 | 1 | keymap, input rules, history, list commands | ~1,700 | 21 kB | **done** |
-| 2 | model — nodes, marks, fragments, schema, content expressions, DOM parse/serialize | ~3,500 | 30 kB | **done** |
+| 2 | model — nodes, marks, fragments, schema, content expressions, DOM parse/serialize | ~3,500 | 31 kB | **done** |
 | 3 | transform — steps, position mapping, rebasing | ~2,200 | 19 kB | **done** |
 | 4 | state — transactions, selection, plugins | ~1,000 | 9 kB | **done** |
 | 5 | view — contenteditable, IME, selection sync | ~6,000 | 59 kB | **done** |
@@ -177,9 +177,26 @@ user is the last row: an app ships a fraction of what it did, because nothing
 is pulled in that the editor does not use.
 
 Extensions have landed since, so that last number is not today's. The current
-figure is whatever `pnpm size` prints — **30 kB** for the starter kit as of
+figure is whatever `pnpm size` prints — **31 kB** for the starter kit as of
 1.0 — and it is checked in CI rather than quoted from here.
 
+## What 1.0.1 changed underneath
+
+- **A replace step can say what it kept.** `ReplaceStep` takes optional
+  `ranges` — `[start, oldSize, newSize]` triples over the old document — and
+  its map tells that story instead of treating the whole range as gone.
+  `Transform.rebuild(from, to, content, kept)` derives the triples from the
+  runs of content an operation leaves in place. Retyping a block, wrapping,
+  lifting, splitting, nesting and un-nesting list items all go through it,
+  which is why a caret now survives every one of them.
+- **Lists are one command.** `toggleList` in `list-commands.ts` wraps blocks
+  one item each, takes items out of a top-level list, outdents from a nested
+  one, and changes a list's kind in place.
+- **The renderer remembers what it drew.** Two weak maps — node decorations
+  written onto an element, decorations drawn inside a content element — are
+  what a patch is compared against, rather than last render's set mapped
+  through the edit, which loses a decoration whose range the edit replaced.
+
 ## What 1.0 changed underneath
 
 Measured first, then changed; the numbers are in BENCHMARKS.md. The shape of

package/docs/readme.md

@@ -442,6 +442,7 @@ pnpm bench:check # the performance ratchet, against the recorded baseline
 pnpm links       # no dead internal links on the site
 pnpm packaging   # every built package imports and requires (run after build)
 pnpm wiring      # every script on the site finds the markup it asks for
+pnpm exercise        # drive every extension through the built package in a DOM: every command, rule and paste
 pnpm install:matrix  # pack every package, npm-install it into fresh Vite apps for each framework, build and run them
 pnpm facts       # the counts the site prints — tests, adversarial tests, extensions
 ```
@@ -454,7 +455,7 @@ mapping, editor state and the editable view are written from scratch, with
 package is installed with plain npm into a fresh React, Vue, Svelte, Solid
 and vanilla Vite app and built there before a release (`pnpm install:matrix`).
 
-An app on the starter kit bundles **30 kB gzipped**, because nothing arrives
+An app on the starter kit bundles **31 kB gzipped**, because nothing arrives
 that the editor does not use — seventy-nine extensions ship in the package
 and none of them is in the bundle until it is in the array. The whole ladder,
 from an empty extension array upwards, is measured by `pnpm size` and checked
@@ -547,7 +548,7 @@ what the numbers are not.
 
 | | Matra | Tiptap | Lexical | Slate |
 |---|---|---|---|---|
-| Bundle, gzipped | **30 kB** | 117 kB | ~35 kB | ~50 kB |
+| Bundle, gzipped | **31 kB** | 117 kB | ~35 kB | ~50 kB |
 | Runtime dependencies | **0** | 51 packages | few | several |
 | Engine types in your code | **none** | ProseMirror | Lexical | Slate |
 | Command types | **inferred** | module augmentation | manual | manual |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@matrajs/mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "The Matra documentation as a Model Context Protocol server, so any AI tool can read it. Zero dependencies.",
   "license": "MIT",
   "author": "Nahim Hossain Shohan",