brookmd 0.23.0 → 0.23.2

package/CHANGELOG.md

@@ -4,6 +4,30 @@ Notable changes to brookmd (formerly `flux-md`). Format based on
 [Keep a Changelog](https://keepachangelog.com/); this project aims to follow
 [Semantic Versioning](https://semver.org/).
 
+## 0.23.2 — 2026-07-22
+
+### Fixed
+
+- **Streaming/one-shot parity: non-ASCII whitespace no longer blanks a line.**
+  The streaming premature-commit guard tested "previous line non-blank" with
+  Unicode-aware trimming, so a line consisting only of form feed (U+000C),
+  vertical tab (U+000B), NBSP, or other non-ASCII whitespace was treated as a
+  blank line. A paragraph opened by such a line could be committed early and a
+  later lazy continuation could never merge back — the streamed output
+  permanently diverged from the one-shot parse (nightly parity-fuzz catch,
+  input `\x0c\n-- - @`). The guard now uses the CommonMark blank-line
+  definition (ASCII space/tab only), matching the one-shot path; regression
+  tests pin the artifact and variants across chunk splits.
+
+## 0.23.1 — 2026-07-21
+
+### Changed
+
+- Documentation only: the README now covers wire delta mode (the 0.23.0
+  headline) — measured numbers, the automatic worker↔client behavior, and the
+  raw-boundary opt-in — plus refreshed platform-status notes across the
+  repository. No code changes; behavior identical to 0.23.0.
+
 ## 0.23.0 — 2026-07-21
 
 ### Added

package/README.md

@@ -4,7 +4,7 @@ Zero-dep streaming markdown for the browser. Rust→WASM core, one Web Worker pe
 
 Drop in a streaming-aware renderer — **React, Vue, Svelte, Solid, a framework-agnostic `<brook-markdown>` Web Component, or the vanilla DOM mount** — wire each LLM stream to a `BrookClient`, and the markdown renders incrementally off the main thread, block by block, with stable identities so unchanged blocks never re-reconcile.
 
-Parsing runs entirely **off the main thread** — each stream gets its own pooled Web Worker, so many concurrent LLM responses render without contending for the UI thread. On each token the parser re-parses only the **active tail**, not the whole document, and heavy renderers (syntax highlighting, math, mermaid) are **deferred until a block closes**. The result is low retained memory and a main thread that stays responsive while streaming. See [the live demo](https://md.hsingh.app/).
+Parsing runs entirely **off the main thread** — each stream gets its own pooled Web Worker, so many concurrent LLM responses render without contending for the UI thread. On each token the parser re-parses only the **active tail**, not the whole document; patches cross the worker boundary as **verified splices** (not full re-sends, so emitted bytes stay O(n) even for one giant growing block); and heavy renderers (syntax highlighting, math, mermaid) are **deferred until a block closes**. The result is low retained memory and a main thread that stays responsive while streaming. See [the live demo](https://md.hsingh.app/).
 
 > **Beyond the browser:** the same Rust core also powers experimental React
 > Native, Swift (iOS/macOS), Kotlin/Android, Flutter, and C-ABI bindings —
@@ -1044,6 +1044,26 @@ Headline numbers are not durable across machines, but the curve is: chunk size
 shouldn't change the order of magnitude for any shape. If you hit one that does,
 file an issue with the input and chunking — that's the next bench scenario.
 
+### Wire delta mode (automatic)
+
+Parse work was already O(n), but until 0.23.0 the **bytes crossing the
+worker→main-thread boundary** were not: every append re-emitted the open
+block's full HTML, O(n²/chunk) total for one block that grows across many
+chunks (a long streaming list, a big code fence). Since 0.23.0 the parser
+emits **verified splices** instead — `{keep, append}` deltas against the
+block's previous emit, established by byte comparison so reconstruction is
+byte-exact by construction — and the client reassembles full blocks before
+anything else sees them. Zero API change; `Block.html` is always complete.
+
+Measured at a 200 KB document in 256-byte chunks, a streaming list's total
+patch traffic drops from **119.6 MB to 0.78 MB (153× less, 2.8× faster
+end-to-end)**; an unclosed code fence from **80.1 MB to 0.58 MB (137×, 4.9×
+faster)**. Fast-committing prose is unchanged. Emitted bytes are now gated
+linear in CI alongside the parse-work counters. Raw-boundary consumers (the
+WASM `BrookParser`, native bindings, C ABI) keep byte-identical v1 wire by
+default and can opt in with `setWireDelta(true)` — see
+[`WIRE.md` §11](https://github.com/siinghd/brookmd/blob/main/crates/brookmd-core/WIRE.md).
+
 ## Security
 
 brookmd is XSS-safe by default — its HTML output is meant to be injected via

package/dist/wasm/README.md

@@ -52,15 +52,24 @@ entirely:
 
 ```toml
 [dependencies]
-brookmd-core = { version = "0.20", default-features = false }
+brookmd-core = { version = "0.23", default-features = false }
 ```
 
 ## Wire format
 
 Blocks and patches serialize to a stable, language-agnostic JSON wire format —
-see [WIRE.md](WIRE.md) (wire contract v1.1.0). Native consumers can produce the
+see [WIRE.md](WIRE.md) (wire contract v1.2.0). Native consumers can produce the
 same bytes as the WASM/JS boundary via `wire::patch_to_json` / `wire::blocks_to_json`.
 
+Contract v1.2.0 adds the opt-in **wire delta mode**
+(`StreamParser::set_wire_delta`): active blocks re-emitted across appends
+serialize as verified `html_delta` splices against their previous emit instead
+of full `html`, making total emitted bytes O(n) for a block that grows across
+many appends (WIRE.md §11). Off by default — the default wire stays
+byte-identical to v1.1.0. A consumer that enables it reconstructs
+`prev[..keep] + append` per patch; the npm and React Native packages do this
+transparently.
+
 ## Links
 
 - npm package: <https://www.npmjs.com/package/brookmd>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brookmd",
-  "version": "0.23.0",
+  "version": "0.23.2",
   "description": "Zero-dep streaming markdown for the browser. Rust→WASM core, Web Worker per stream, incremental parse with speculative closure.",
   "type": "module",
   "sideEffects": ["./dist/worker.js", "./dist/styles.css"],