@xmachines/play-tanstack-react-router 1.0.0-beta.1 → 1.0.0-beta.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-tanstack-react-router",
-  "version": "1.0.0-beta.1",
+  "version": "1.0.0-beta.3",
   "description": "TanStack React Router adapter for XMachines Play - synchronizes browser URL with actor state through passive infrastructure",
   "keywords": [
     "routing",
@@ -12,6 +12,11 @@
   ],
   "license": "MIT",
   "author": "XMachines",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
   "type": "module",
   "exports": {
     ".": {
@@ -20,6 +25,9 @@
     },
     "./package.json": "./package.json"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc --build",
     "clean": "rm -rf dist *.tsbuildinfo",
@@ -29,23 +37,20 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@tanstack/react-router": "^1.166.7",
-    "@xmachines/play-actor": "1.0.0-beta.1",
-    "@xmachines/play-router": "1.0.0-beta.1",
-    "@xmachines/play-signals": "1.0.0-beta.1",
+    "@xmachines/play-actor": "1.0.0-beta.3",
+    "@xmachines/play-router": "1.0.0-beta.3",
+    "@xmachines/play-signals": "1.0.0-beta.3",
     "xstate": "^5.28.0"
   },
   "devDependencies": {
-    "@types/node": "^25.3.3",
-    "typescript": "^5.7.0"
+    "@tanstack/react-router": "^1.167.5",
+    "@types/node": "^25.5.0",
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.166.7",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0",
     "xstate": "^5.28.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

package/.oxfmtrc.json

@@ -1,3 +0,0 @@
-{
-  "extends": ["@xmachines/shared/oxfmt"]
-}

package/.oxlintrc.json

@@ -1,3 +0,0 @@
-{
-  "extends": ["@xmachines/shared/oxlint"]
-}

package/examples/demo/README.md

@@ -1,100 +0,0 @@
-# TanStack React Router Demo
-
-React + TanStack Router demonstration of Play's actor-authoritative routing and rendering model.
-
-## What This Demonstrates
-
-- Shared auth machine reused without framework-specific business logic
-- `PlayRouterProvider` renderer-based integration with TanStack Router
-- Shell-driven rendering via `PlayRenderer` with actor-authoritative navigation
-- Non-browser invariant tests plus browser E2E coverage
-
-## Running the Demo
-
-From this directory (`packages/play-tanstack-react-router/examples/demo`):
-
-```bash
-npm install
-npm run dev
-```
-
-Open `http://localhost:3000`.
-
-## Step-by-Step Code Flow
-
-This demo uses provider-based integration centered on `PlayRouterProvider` and a route map generated from the machine:
-
-1. `src/main.tsx` mounts `<App />`.
-2. `src/App.tsx` creates/starts the actor from shared machine + catalog.
-3. `src/App.tsx` builds `routeMap` from `extractMachineRoutes(authMachine)` + `createRouteMapFromTree(routeTree)`.
-4. `PlayRouterProvider` bridges TanStack Router to the actor and renders `Shell` via `renderer(actor, router)`.
-5. `Shell` renders `PlayRenderer`, header/nav, and debug panel from actor state.
-6. Tests in `test/` and `test/browser*/` validate invariant and runtime behavior.
-
-```tsx
-// src/App.tsx (shape)
-const routeTree = extractMachineRoutes(authMachine);
-const routeMap = createRouteMapFromTree(routeTree);
-
-return (
-	<PlayRouterProvider
-		actor={actor}
-		router={router}
-		routeMap={routeMap}
-		renderer={(currentActor, currentRouter) => (
-			<Shell actor={currentActor} router={currentRouter} />
-		)}
-	/>
-);
-```
-
-```tsx
-// src/components/Login.tsx (shape)
-<button onClick={() => actor.send({ type: "auth.login", username, password })}>Login</button>
-```
-
-Shared business logic comes from the common demo machine/catalog module (`authMachine` and `catalog`), so routing decisions remain machine-driven and framework-independent.
-
-## Key Files
-
-- `src/main.tsx` - React entry point that mounts `<App />`
-- `src/App.tsx` - actor lifecycle, route-map creation, provider wiring, and `Shell` rendering
-- `src/components/` - UI components that send actor events and render state-driven views
-- `test/actor-authority.test.ts` - actor authority and guarded navigation behavior
-- `test/strict-separation.test.ts` - machine/view infrastructure separation contracts
-- `test/browser-e2e/auth-flow.browser.test.tsx` - canonical browser auth flow
-- `test/browser/` - extended browser checks for URL sync, history behavior, and route event flow
-
-## Available Scripts
-
-```bash
-npm run dev            # Start Vite dev server (http://localhost:3000)
-npm run build          # Build production assets
-npm run preview        # Preview production build locally
-npm run test           # Run Vitest suite
-npm run test:vitest    # Explicit Vitest command alias
-npm run test:browser   # Browser-focused test run (e2e browser config)
-npm run test:browser:full  # Full browser test config run
-npm run test:e2e       # Alias to test:browser
-```
-
-## Verification
-
-Run the core invariant checks referenced by this demo docs:
-
-```bash
-npm run test:vitest -- test/actor-authority.test.ts test/strict-separation.test.ts
-npm run test:browser
-```
-
-Manual sanity flow:
-
-1. Run `npm run dev` and open `http://localhost:3000`.
-2. Attempt protected navigation while logged out and confirm guard-driven behavior.
-3. Log in, then confirm route and view updates stay in sync.
-
-## Learn More
-
-- [TanStack React Router package README](../../README.md)
-- [Solid Router demo README](../../../play-solid-router/examples/demo/README.md)
-- [TanStack Solid Router demo README](../../../play-tanstack-solid-router/examples/demo/README.md)