flux-md 0.20.1 → 0.20.3

package/dist/client.d.ts

@@ -158,6 +158,10 @@ export declare class FluxClient {
      *   order, after the store updates) — for side effects like lazily
      *   highlighting a finished code block or analytics. A committed block never
      *   re-fires; the streaming tail does not (subscribe for live tail updates).
+     *   NOTE: this is a PARSER-commit hook — the block carries the parser's raw
+     *   id. During a setContent divergence swap the rendered view may show that
+     *   block under a different id (an adopted old id, or a namespaced one), so
+     *   correlate with rendered blocks via subscribe()+getSnapshot(), not this id.
      * @param options.coalesce opt-in (default `false`): collapse multiple
      *   intra-frame patch notifications into ONE `requestAnimationFrame`-scheduled
      *   flush to subscribers, so a React `useSyncExternalStore` consumer renders at
@@ -289,8 +293,11 @@ export declare class FluxClient {
      *   - identical committed block (html + kind + open + speculative) → the OLD
      *     block object, so its id and reference survive the swap and the block
      *     never re-renders (blocksEqual / the DOM keyed reconcile hold);
-     *   - changed committed block → the new block, its id offset into this
-     *     generation's namespace (adopted old ids and raw new ids could collide);
+     *   - changed committed block → the new block CARRYING THE OLD BLOCK'S id, so
+     *     the same keyed component re-renders in place and its state (pagination,
+     *     expansion…) survives the swap; only a NET-NEW position (past the old
+     *     document's end) takes a namespace-offset id, where a raw parser id
+     *     could genuinely collide with a retained old id;
      *   - still-open block over old content → the old block (never a shrinking
      *     partial where complete content was already on screen); past the old
      *     document's end the live tail streams in as-is;

package/dist/client.js

@@ -262,6 +262,10 @@ class FluxClient {
    *   order, after the store updates) — for side effects like lazily
    *   highlighting a finished code block or analytics. A committed block never
    *   re-fires; the streaming tail does not (subscribe for live tail updates).
+   *   NOTE: this is a PARSER-commit hook — the block carries the parser's raw
+   *   id. During a setContent divergence swap the rendered view may show that
+   *   block under a different id (an adopted old id, or a namespaced one), so
+   *   correlate with rendered blocks via subscribe()+getSnapshot(), not this id.
    * @param options.coalesce opt-in (default `false`): collapse multiple
    *   intra-frame patch notifications into ONE `requestAnimationFrame`-scheduled
    *   flush to subscribers, so a React `useSyncExternalStore` consumer renders at
@@ -416,6 +420,9 @@ class FluxClient {
   setContent(content, opts) {
     if (content !== this.lastContent) {
       if (!this.contentDone && content.startsWith(this.lastContent)) {
+        if (this.lastContent === "" && content.length > 0 && this.getSnapshot().length > 0) {
+          this.softReset(this.getSnapshot());
+        }
         this.append(content.slice(this.lastContent.length));
       } else {
         const displayed = this.getSnapshot();
@@ -544,8 +551,11 @@ class FluxClient {
    *   - identical committed block (html + kind + open + speculative) → the OLD
    *     block object, so its id and reference survive the swap and the block
    *     never re-renders (blocksEqual / the DOM keyed reconcile hold);
-   *   - changed committed block → the new block, its id offset into this
-   *     generation's namespace (adopted old ids and raw new ids could collide);
+   *   - changed committed block → the new block CARRYING THE OLD BLOCK'S id, so
+   *     the same keyed component re-renders in place and its state (pagination,
+   *     expansion…) survives the swap; only a NET-NEW position (past the old
+   *     document's end) takes a namespace-offset id, where a raw parser id
+   *     could genuinely collide with a retained old id;
    *   - still-open block over old content → the old block (never a shrinking
    *     partial where complete content was already on screen); past the old
    *     document's end the live tail streams in as-is;
@@ -583,6 +593,8 @@ class FluxClient {
           view[i] = ob;
           continue;
         }
+        view[i] = { ...nb, id: ob.id };
+        continue;
       }
       view[i] = { ...nb, id: this.idNamespace + nb.id };
     }

package/package.json

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