@ai-matrx/rich-content 0.2.162 → 0.2.163

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Changelog
 
-## 0.2.162
+## 0.2.163
 ### Unreleased
 
 - **THE RENDER RATCHET** (`display/chat-markdown/block-registry/render-ratchet.ts`; Arman, 2026-10-14: "once you go forward, you do not go back"). `BlockRenderer` keeps, per mounted block, the furthest render stage it drew (text → loader → generic → component) and a backward frame mid-stream (a bridge declining a half-arrived item, a mid-string parse, an emptied/retracted frame, a late row) keeps the last good decision on screen instead of swapping the component for its loader and back (each swap was an unmount + remount). It lets go when the block settles (the final value is the truth), when a different block takes the slot, or mid-stream only after `RATCHET_RELEASE_MIN_FRAMES` (120) distinct frames AND `RATCHET_RELEASE_MIN_MS` (8 s). Consumer action: none.

package/dist/display/chat-markdown/block-registry/BlockRenderer.js

@@ -302,6 +302,7 @@ const BlockRendererGated = ({
   const settledBlock = !isStreamActive || inputBlock.isStreamingBlock === false;
   const ratcheted = suppressLoadingGate ? { state: ratchetRef.current, decision: frameDecision } : advanceRatchet(ratchetRef.current, frameDecision, {
     settled: settledBlock,
+    messageEnded: !isStreamActive,
     now: Date.now()
   });
   ratchetRef.current = ratcheted.state;

package/dist/display/chat-markdown/block-registry/render-ratchet.d.ts

@@ -64,13 +64,18 @@ export declare const EMPTY_RATCHET: RatchetState;
 export interface RatchetInput {
     /** The block settled: its own stream closed, or the message stream ended. */
     settled: boolean;
+    /**
+     * The MESSAGE stream is over. An emptied block while the message still streams is a
+     * retraction or a re-split, never a final value — even when its frame says "complete".
+     */
+    messageEnded?: boolean;
     /** Wall clock (ms). */
     now: number;
 }
 /**
  * One frame through the ratchet: the state to keep and the decision to draw.
  */
-export declare function advanceRatchet(state: RatchetState, next: BlockRenderDecision, { settled, now }: RatchetInput): {
+export declare function advanceRatchet(state: RatchetState, next: BlockRenderDecision, { settled, now, messageEnded }: RatchetInput): {
     state: RatchetState;
     decision: BlockRenderDecision;
 };

package/dist/display/chat-markdown/block-registry/render-ratchet.js

@@ -39,17 +39,17 @@ function accept(next, stage, content) {
     disagreeSince: null
   };
 }
-function advanceRatchet(state, next, { settled, now }) {
+function advanceRatchet(state, next, { settled, now, messageEnded = false }) {
   const stage = renderStageOf(next);
   const content = contentOf(next);
   const take = () => {
     const accepted = accept(next, stage, content);
     return { state: accepted, decision: next };
   };
-  if (!state.held || settled) return take();
-  if (!content.trim() && state.heldContent.trim()) {
+  if (state.held && !messageEnded && !content.trim() && state.heldContent.trim()) {
     return { state: { ...state, lastContent: content }, decision: state.held };
   }
+  if (!state.held || settled) return take();
   if (!continues(state.heldContent, content)) return take();
   if (stage >= state.heldStage) return take();
   const isNewFrame = content !== state.lastContent;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/rich-content",
-  "version": "0.2.162",
+  "version": "0.2.163",
   "description": "The AI Matrx formatted-text engine: the one markdown renderer, streaming markdown, the block splitter and renderer, the generic blocks, <RichContent> levels, the rich-document action registry and menus, copy, and the selection toolbar — as portable React.",
   "type": "module",
   "license": "MIT",
@@ -130,21 +130,21 @@
     "unist-util-visit": "^5.1.0",
     "unist-util-visit-parents": "^6.0.2",
     "yaml": "^2.9.1",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/api": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/agents": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/icons": "latest",
-    "@ai-matrx/agents": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/kit": "latest",
-    "@ai-matrx/diff": "latest"
+    "@ai-matrx/icons": "latest"
   },
   "peerDependencies": {
     "react": ">=19.0.0",
@@ -205,5 +205,5 @@
     "verify:modules-tarball": "node ./scripts/verify-modules-tarball.mjs",
     "verify:tarball": "node ./scripts/verify-tarball.mjs"
   },
-  "gitHead": "3260b81ccf1721d1a6a0ba08b238fdfa7d609ba5"
+  "gitHead": "bd8cc634aca9fe3503e752a2ae4167d8cbc68460"
 }