fix(website,stream-adapter): the streaming examples render nothing in dev

[blove]

A claims-verification pass over docs/streaming/ — the least-verified section in the corpus (zero entries in the docs-guard roster, against 42 for grid). It turned up a live rendering bug and five false or misleading claims.

The bug: both streaming examples are blank in dev

ChatGrid and PartialRowGrid each held their row model in useMemo and disposed it from a useEffect cleanup. StrictMode rehearses an unmount in dev, the memo hands the same instance back to the remount, and the grid throws and renders nothing:

RowLayoutControllerError: A disposed row-layout controller cannot change its columns.

That is the #382 blank-grid failure, shipped on three docs pages — element-streams, parsers and api-reference embed the chat grid; index and partial-streams embed the partial-row grid. useDisposeOnUnmount exists for exactly this, and five other files in the repo already use it. These two were missed.

Why nothing caught it

• The dev-mode Playwright gate loads the homepage and /docs/grid/grouping only. It never reaches a streaming page.
• Each example's existing demo.test.tsx renders without StrictMode. A production build does not rehearse effects, so the bug is invisible there.

Added a StrictMode twin for each example. Both were mutation-tested: reverting the fix makes each fail with the exact disposed-controller error, and I restored the fix afterward.

Claims corrected, each checked against the source

Page	Claim	Reality
index.mdx	a partial stream "never adds a row at all"	It adds exactly one, when given createRow — as the same page described ten lines later
partial-streams.mdx	createRow snippet targets rowId: "msg-1" while claiming to show msg-2	msg-1 is the seeded row; the snippet demonstrated a path that can never fire
partial-streams.mdx	onIssue framed as the without-createRow case	It fires either way — the connector reports, then builds
api-reference.mdx	TransactionBatcher row lists its methods	Omitted subscribeError, a public member
parse-partial-stream.ts JSDoc	fills out "each top-level array element"	The implementation throws unless the root is an object

That TransactionBatcher table leads with a Type header — precisely the shape the docs guard's member-table detector cannot see, which is how the omission survived.

Also documented two load-bearing but unstated behaviors: batched calls are appended, not merged (two updates for one row become two entries in one transaction), and createRow receives the changes accumulated across the frame.

Not changed

index.mdx teaches createLocalRowModel({ rows: [], columns }) while both examples pass getRowId. I probed it — the taught form compiles, getRowId is genuinely optional under the id convention. No defect.

Verification

Rebased onto origin/main after #462 merged. pnpm typecheck, pnpm lint (1 pre-existing unrelated warning) and api:check clean; website 556 tests + stream-adapter 48 tests pass.

Note for reviewers: a bare npx vitest run --root packages/stream-adapter shows 2 failures — that is the known stale-dist trap. The package's own pnpm test, which builds deps first, is green.

🤖 Generated with Claude Code

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
pretable	Ignored		Aug 17, 2026 3:50am

[github-actions]

Vercel preview ready

Preview: https://pretable-hu86wbmkr-cacheplane.vercel.app
Commit: 5c1297aa10596b026bd14ea341376a7ad9d8bf96

_{Updated automatically by the deploy-preview job.}