@tyndall/react 0.0.1

package/README.md

@@ -0,0 +1,32 @@
+# @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
+- 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](./spec.md)
+- Package architecture: [architecture.md](./architecture.md)
+- Package changes: [CHANGELOG.md](./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.

package/dist/adapter.d.ts

@@ -0,0 +1,16 @@
+import type { HmrIntegration, RouteGraph, UIAdapter, UIAdapterEntryContext, UIAdapterRenderContext, UIAdapterRenderResult } from "@tyndall/core";
+export interface ReactAdapterOptions {
+    name?: string;
+    createClientEntry?: (ctx: UIAdapterEntryContext) => string;
+    createServerEntry?: (ctx: UIAdapterEntryContext) => string;
+    renderToHtml?: (ctx: UIAdapterRenderContext) => Promise<UIAdapterRenderResult> | UIAdapterRenderResult;
+    render?: (ctx: UIAdapterRenderContext) => Promise<unknown> | unknown;
+    getHead?: UIAdapter["getHead"];
+    hmrIntegration?: HmrIntegration;
+    routeGraph?: RouteGraph;
+    nestedLayouts?: boolean;
+    rootDir?: string;
+    routeRoot?: string;
+}
+export declare const createReactAdapter: (options?: ReactAdapterOptions) => UIAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EACd,UAAU,EACV,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,eAAe,CAAC;AAIvB,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC3D,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAC3D,YAAY,CAAC,EAAE,CACb,GAAG,EAAE,sBAAsB,KACxB,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;IAC5D,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAizBD,eAAO,MAAM,kBAAkB,GAAI,UAAS,mBAAwB,KAAG,SAQrE,CAAC"}