[codeBelt]

Public API changes

History and persistence status can change without a store mutation. Add typed useHistoryStatus and usePersistStatus hooks, backed by observable utility handles, so React controls stay current. Preserve explicit history pause state through undo/redo.

Simplify the beta API for 0.8.0: persistence cleanup is dispose(), explicit save(), clear(), and rehydrate() operations reject on failure, getVersion is internal, and hydration preparation is exported only from /react/server. Persistence transforms infer their value type from the selected property key.

Update React and Next.js examples, reorganize hooks and internal types by ownership, and preserve existing runtime behavior during the structural cleanup. Refresh the README and Docusaurus documentation, correct persistence/collection/SSR examples, and generate the full machine-readable reference from the source docs.

The minor Changeset targets 0.8.0. Breaking changes and migration examples are documented in website/docs/UPGRADING_0_8.md.

Validation

• 534 core/React source tests passed.
• 111 packed React compatibility tests and 177 Compiler tests passed.
• 94 browser tests passed; 8 existing clipboard skips.
• 12 Next.js tests and 14 package-boundary checks passed with Compiler off/on.
• Library, React/Next.js example, and Docusaurus builds passed.
• TypeScript and scoped lint passed; updated documentation examples passed strict typechecks and collection persistence round-trip/error checks.

CI must pass before merging. The separate Fumadocs prototype is excluded.