@tyndall/react

Overview

React adapter package that implements UIAdapter contracts, routing integration, and hydration helpers.

Responsibilities

• Provide React-based rendering adapter, factory, and registry
• Provide client router and navigation components
• Integrate route payload transitions and head updates
• Provide _app wrapper support and pass { Component, pageProps, routeData, routeId } to App components
• Expose RouteDataProvider and useRouteData for consuming route data maps
• Provide useBlockRouting and navigation blocker hooks for client transitions and beforeunload
• Support router.softReload() and scroll restoration during client-side transitions
• Coordinate hydration lifecycle markers and mounted-state guards for payload-driven navigation
• Guard dev runtime generation changes with controlled dispose/re-initialize flow to avoid mixed React hook dispatcher states during HMR
• Compose nested layout trees when route metadata supplies layoutFiles
• Emit server entry exports that support streaming SSR when React streaming APIs are available

Public API Highlights

• createReactAdapter
• createReactAdapterRegistry
• createRouter and RouterProvider

Development

• Build: bun run --filter @tyndall/react build
• Test (from workspace root): bun test

Documentation

• Package specification: spec.md
• Package architecture: architecture.md
• Package changes: CHANGELOG.md

Maintenance Rules

• Keep this document aligned with implemented package behavior.
• Update spec.md and architecture.md whenever package contracts or design boundaries change.
• Record user-visible package changes in CHANGELOG.md.