flux-md 0.18.0 → 0.18.2

package/CHANGELOG.md

@@ -4,6 +4,54 @@ Notable changes to flux-md. Format based on
 [Keep a Changelog](https://keepachangelog.com/); this project aims to follow
 [Semantic Versioning](https://semver.org/).
 
+## 0.18.2 — 2026-06-29
+
+### Fixed
+
+- **Streaming O(n²) cliff on a paragraph followed by a long link-reference /
+  footnote definition run** (e.g. reference-heavy LLM output: prose, then a
+  block of `[id]: url` definitions). The paragraph stayed speculative until
+  `finalize()` — a definition is not a renderable block, so the paragraph never
+  became "the last block" and `committed_offset` stalled, re-scanning the whole
+  growing definition run on every append. A 235 KB document streamed at a
+  256-byte chunk took **~59 s**; it now takes **~20 ms**, and streaming is linear
+  in document size across all chunk sizes. A renderable block followed by a
+  definition run now commits (a definition only parses at a block boundary, so
+  the block is closed). Narrow behavior note, within the existing
+  forward-reference limitation: the single paragraph immediately before such a
+  run now commits before the later definitions, so a *forward* reference from it
+  renders literally instead of resolving at finalize — consistent with every
+  earlier paragraph, which already commits mid-stream.
+
+## 0.18.1 — 2026-06-29
+
+Performance + size pass. No API or output changes — CommonMark 652/652 and
+GFM 23/24 are byte-for-byte unchanged.
+
+### Changed
+
+- **WASM binary −9.6 KB (175.1 KB → 165.5 KB, −5.4%).** Three levers, measured:
+  a compact stable merge sort replaces the standard library's general-purpose
+  stable sort (driftsort) at the two sort sites (−7.3 KB incl. simpler escape
+  codegen); `wasm-opt` switches from `-O3` to `-Oz` (−2.3 KB) — and since the
+  Rust codegen is already `opt-level=z`, `-Oz` is a Pareto win (equal-or-slightly
+  faster parse, never slower, in a Node WASM A/B).
+- **Faster HTML escaping.** `escape_html` / `escape_attr` now scan bytes and copy
+  plain runs with one `push_str` (a memcpy) instead of decoding + re-encoding
+  every character. Output is byte-identical (only ASCII `< > & " '` are
+  rewritten). Measured **+9–23%** parse throughput on escape-heavy documents —
+  large fenced code, display math, and HTML/list-heavy content (the common
+  LLM-output shape); prose is unchanged.
+- **Fewer allocations on the render path.** Paragraphs, headings, and list items
+  render their inline content directly into the output buffer and trim in place,
+  dropping one temporary `String` + copy per block (helps the SSR / one-shot
+  `renderToString` / `parseToBlocks` path).
+- **One fewer React render per patch (default path).** `<FluxMarkdown>` fed a
+  changing value to `useDeferredValue` even when tail deferral was off (the
+  default), so React scheduled a throwaway low-priority catch-up render every
+  patch. It now feeds a stable value unless `deferTail` is set, so the default
+  path renders exactly once per patch.
+
 ## 0.18.0 — 2026-06-29
 
 ### Added

package/dist/react.js

@@ -14,6 +14,7 @@ import { CodeBlock } from "./renderers/CodeBlock.js";
 import { MathBlock } from "./renderers/Math.js";
 import { Mermaid } from "./renderers/Mermaid.js";
 import { htmlToReact } from "./html-to-react.js";
+const NO_DEFER_BLOCKS = [];
 function FluxMarkdownFromClient({
   client,
   components,
@@ -30,7 +31,7 @@ function FluxMarkdownFromClient({
   deferTail
 }) {
   const blocks = useSyncExternalStore(client.subscribe, client.getSnapshot, client.getSnapshot);
-  const deferred = useDeferredValue(blocks);
+  const deferred = useDeferredValue(deferTail ? blocks : NO_DEFER_BLOCKS);
   const rendered = deferTail ? deferred : blocks;
   const isDeferring = deferTail ? rendered !== blocks : false;
   const comps = useMemo(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flux-md",
-  "version": "0.18.0",
+  "version": "0.18.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"],