@xmachines/docs 1.0.0-beta.11 → 1.0.0-beta.13

package/api/@xmachines/play-xstate/type-aliases/RouteMachineConfig.md

@@ -6,7 +6,7 @@
 type RouteMachineConfig = object;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L29)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L29)
 
 ## Indexable
 
@@ -22,7 +22,7 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:2
 optional context?: unknown;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L30)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L30)
 
 ---
 
@@ -32,7 +32,7 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:3
 optional on?: Record<string, unknown>;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L32)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L32)
 
 ---
 
@@ -42,4 +42,4 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:3
 optional states?: Record<string, unknown>;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L31)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L31)

package/api/@xmachines/play-xstate/type-aliases/RouteStateNode.md

@@ -6,7 +6,7 @@
 type RouteStateNode = object;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L13)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L13)
 
 ## Indexable
 
@@ -22,7 +22,7 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:1
 optional id?: string;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L14)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L14)
 
 ---
 
@@ -32,7 +32,7 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:1
 optional meta?: object;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L15)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L15)
 
 #### route?
 
@@ -48,4 +48,4 @@ optional route?: string;
 optional states?: Record<string, RouteStateNode>;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/routing/format-play-route-transitions.ts#L18)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/routing/format-play-route-transitions.ts#L18)

package/api/@xmachines/play-xstate/type-aliases/ValidationResult.md

@@ -14,4 +14,4 @@ type ValidationResult =
 	  };
 ```
 
-Defined in: [packages/play-xstate/src/catalog/validate-props.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/catalog/validate-props.ts#L11)
+Defined in: [packages/play-xstate/src/catalog/validate-props.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/catalog/validate-props.ts#L11)

package/api/@xmachines/play-xstate/type-aliases/ViewMergeContext.md

@@ -6,7 +6,7 @@
 type ViewMergeContext = object;
 ```
 
-Defined in: [packages/play-xstate/src/catalog/validate-props.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/catalog/validate-props.ts#L5)
+Defined in: [packages/play-xstate/src/catalog/validate-props.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/catalog/validate-props.ts#L5)
 
 ## Indexable
 
@@ -22,7 +22,7 @@ Defined in: [packages/play-xstate/src/catalog/validate-props.ts:5](https://gitla
 optional queryParams?: Record<string, unknown>;
 ```
 
-Defined in: [packages/play-xstate/src/catalog/validate-props.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/catalog/validate-props.ts#L7)
+Defined in: [packages/play-xstate/src/catalog/validate-props.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/catalog/validate-props.ts#L7)
 
 ---
 
@@ -32,4 +32,4 @@ Defined in: [packages/play-xstate/src/catalog/validate-props.ts:7](https://gitla
 optional routeParams?: Record<string, unknown>;
 ```
 
-Defined in: [packages/play-xstate/src/catalog/validate-props.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/play-xstate/src/catalog/validate-props.ts#L6)
+Defined in: [packages/play-xstate/src/catalog/validate-props.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/play-xstate/src/catalog/validate-props.ts#L6)

package/api/@xmachines/shared/functions/defineXmVitestConfig.md

@@ -6,7 +6,7 @@
 function defineXmVitestConfig(importMetaUrl, overrides): object;
 ```
 
-Defined in: [src/index.ts:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/shared/src/index.ts#L10)
+Defined in: [src/index.ts:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/shared/src/index.ts#L10)
 
 Create a Vitest config with XMachines workspace defaults.
 
@@ -26,4 +26,4 @@ render it under `@xmachines/shared` instead of nested module pages.
 
 | Name   | Type  | Defined in                                                                                                                                             |
 | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| `test` | `any` | [config/vitest.ts:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/shared/config/vitest.ts#L82) |
+| `test` | `any` | [config/vitest.ts:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/shared/config/vitest.ts#L82) |

package/api/@xmachines/shared/functions/xmAliases.md

@@ -6,7 +6,7 @@
 function xmAliases(importMetaUrl): Record<string, string>;
 ```
 
-Defined in: [src/index.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/8aa0643f9736fab0deae2851a2d403008d4412ed/packages/shared/src/index.ts#L20)
+Defined in: [src/index.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/dc729bb39810dbc25648ddd9203782369c467996/packages/shared/src/index.ts#L20)
 
 Build Vite/Vitest alias entries for all `@xmachines/*` workspace packages.
 

package/api/README.md

@@ -1,4 +1,32 @@
-# Documentation
+# XMachines API Reference
+
+Generated API documentation for the XMachines JavaScript/TypeScript packages.
+
+## Start Here
+
+- For actor contracts, start with [@xmachines/play-actor](@xmachines/play-actor/README.md).
+- For player creation from XState machines, start with [@xmachines/play-xstate](@xmachines/play-xstate/README.md).
+- For route extraction and shared URL synchronization logic, start with [@xmachines/play-router](@xmachines/play-router/README.md).
+- For rendering, choose one of [@xmachines/play-react](@xmachines/play-react/README.md), [@xmachines/play-solid](@xmachines/play-solid/README.md), or [@xmachines/play-vue](@xmachines/play-vue/README.md).
+- For framework router integration, choose the matching adapter package such as [@xmachines/play-react-router](@xmachines/play-react-router/README.md) or [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md).
+
+## Key Concepts
+
+- [Viewable](@xmachines/play-actor/interfaces/Viewable.md) actors expose `currentView` and a component catalog for renderer packages.
+- [Routable](@xmachines/play-actor/interfaces/Routable.md) actors expose `currentRoute` and route-oriented events for router adapters.
+- Router adapters are passive infrastructure: they synchronize URLs with actor state but do not own business rules.
+
+## Package Roles
+
+- `Core runtime`: [@xmachines/play](@xmachines/play/README.md), [@xmachines/play-actor](@xmachines/play-actor/README.md), [@xmachines/play-catalog](@xmachines/play-catalog/README.md), [@xmachines/play-signals](@xmachines/play-signals/README.md), [@xmachines/play-router](@xmachines/play-router/README.md), and [@xmachines/play-xstate](@xmachines/play-xstate/README.md)
+- `Rendering`: [@xmachines/play-react](@xmachines/play-react/README.md), [@xmachines/play-solid](@xmachines/play-solid/README.md), and [@xmachines/play-vue](@xmachines/play-vue/README.md)
+- `Router adapters`: [@xmachines/play-react-router](@xmachines/play-react-router/README.md), [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md), [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md), and [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md)
+- `Shared tooling`: [@xmachines/shared](@xmachines/shared/README.md)
+
+## Notes
+
+- Demo packages are included in the generated package index below, but most implementation questions should start with the core runtime and adapter packages above.
+- A useful reading order is usually: [@xmachines/play-actor](@xmachines/play-actor/README.md) -> [@xmachines/play-xstate](@xmachines/play-xstate/README.md) -> [@xmachines/play-router](@xmachines/play-router/README.md) -> framework renderer/adapter.
 
 ## Packages
 

package/api/llms.txt

@@ -1,26 +1,69 @@
-# 
+# XMachines JavaScript/TypeScript API Docs
 
-> Documentation for XMachines
+> Stream-first, deterministic state machine runtime, rendering, and router adapter packages for JavaScript and TypeScript.
+
+- Core actor, routing, rendering, and catalog packages
+- Framework adapters for React, Solid, Vue, and router integrations
+- Generated API reference tuned for package discovery and implementation guidance
+
+## Start Here
+
+- Defining players from machines: start with [@xmachines/play-xstate](@xmachines/play-xstate/README.md).
+- Understanding actor contracts: read [@xmachines/play-actor](@xmachines/play-actor/README.md) for [Viewable](@xmachines/play-actor/interfaces/Viewable.md) and [Routable](@xmachines/play-actor/interfaces/Routable.md).
+- [Viewable](@xmachines/play-actor/interfaces/Viewable.md) is the rendering contract: actors expose `currentView` plus a component catalog so rendering packages can resolve UI without owning application state.
+- [Routable](@xmachines/play-actor/interfaces/Routable.md) is the routing contract: actors expose `currentRoute` plus route-oriented event handling, while adapters translate browser or router changes into actor events.
+- Rendering actor-driven UI: use [@xmachines/play-react](@xmachines/play-react/README.md), [@xmachines/play-solid](@xmachines/play-solid/README.md), or [@xmachines/play-vue](@xmachines/play-vue/README.md).
+- Synchronizing URLs with actor state: use [@xmachines/play-router](@xmachines/play-router/README.md) plus a framework-specific router adapter.
+
+## Package Roles
+
+- `Core runtime`: [@xmachines/play](@xmachines/play/README.md), [@xmachines/play-actor](@xmachines/play-actor/README.md), [@xmachines/play-catalog](@xmachines/play-catalog/README.md), [@xmachines/play-signals](@xmachines/play-signals/README.md), [@xmachines/play-router](@xmachines/play-router/README.md), and [@xmachines/play-xstate](@xmachines/play-xstate/README.md).
+- `Rendering`: [@xmachines/play-react](@xmachines/play-react/README.md), [@xmachines/play-solid](@xmachines/play-solid/README.md), and [@xmachines/play-vue](@xmachines/play-vue/README.md).
+- `Router adapters`: [@xmachines/play-react-router](@xmachines/play-react-router/README.md), [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md), [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md), [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md), and [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md), all built on top of [Routable](@xmachines/play-actor/interfaces/Routable.md) actors and shared route metadata.
+- `Shared tooling`: [@xmachines/shared](@xmachines/shared/README.md) for shared config and workspace-level support files.
 
 ## API
-- [@xmachines/play](@xmachines/play/README.md): @xmachines/play module
-- [@xmachines/play-actor](@xmachines/play-actor/README.md): @xmachines/play-actor module
-- [@xmachines/play-catalog](@xmachines/play-catalog/README.md): @xmachines/play-catalog module
-- [@xmachines/play-react](@xmachines/play-react/README.md): @xmachines/play-react module
-- [@xmachines/play-react-router](@xmachines/play-react-router/README.md): @xmachines/play-react-router module
-- [@xmachines/play-react-router-demo](@xmachines/play-react-router-demo/README.md): @xmachines/play-react-router-demo module
-- [@xmachines/play-router](@xmachines/play-router/README.md): @xmachines/play-router module
-- [@xmachines/play-router-demo](@xmachines/play-router-demo/README.md): @xmachines/play-router-demo module
-- [@xmachines/play-signals](@xmachines/play-signals/README.md): @xmachines/play-signals module
-- [@xmachines/play-solid](@xmachines/play-solid/README.md): @xmachines/play-solid module
-- [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md): @xmachines/play-solid-router module
-- [@xmachines/play-solid-router-demo](@xmachines/play-solid-router-demo/README.md): @xmachines/play-solid-router-demo module
-- [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md): @xmachines/play-tanstack-react-router module
-- [@xmachines/play-tanstack-react-router-demo](@xmachines/play-tanstack-react-router-demo/README.md): @xmachines/play-tanstack-react-router-demo module
-- [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md): @xmachines/play-tanstack-solid-router module
-- [@xmachines/play-tanstack-solid-router-demo](@xmachines/play-tanstack-solid-router-demo/README.md): @xmachines/play-tanstack-solid-router-demo module
-- [@xmachines/play-vue](@xmachines/play-vue/README.md): @xmachines/play-vue module
-- [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md): @xmachines/play-vue-router module
-- [@xmachines/play-vue-router-demo](@xmachines/play-vue-router-demo/README.md): @xmachines/play-vue-router-demo module
-- [@xmachines/play-xstate](@xmachines/play-xstate/README.md): @xmachines/play-xstate module
-- [@xmachines/shared](@xmachines/shared/README.md): @xmachines/shared module
+- [@xmachines/play](@xmachines/play/README.md): Core Play types and runtime contracts
+- [@xmachines/play-actor](@xmachines/play-actor/README.md): Abstract actor base class plus Routable and Viewable capabilities
+- [@xmachines/play-catalog](@xmachines/play-catalog/README.md): Catalog schemas and typed component registration
+- [@xmachines/play-signals](@xmachines/play-signals/README.md): Signal primitives used by Play actors and adapters
+- [@xmachines/play-router](@xmachines/play-router/README.md): Route extraction, route maps, and shared routing infrastructure
+- [@xmachines/play-xstate](@xmachines/play-xstate/README.md): XState-backed player and actor integration
+- [@xmachines/play-react](@xmachines/play-react/README.md): React renderer for Viewable actors
+- [@xmachines/play-solid](@xmachines/play-solid/README.md): Solid renderer for Viewable actors
+- [@xmachines/play-vue](@xmachines/play-vue/README.md): Vue renderer for Viewable actors
+- [@xmachines/play-react-router](@xmachines/play-react-router/README.md): React Router bridge and provider for actor-driven navigation
+- [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md): TanStack React Router bridge and provider
+- [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md): Solid Router bridge and provider
+- [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md): TanStack Solid Router bridge and provider
+- [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md): Vue Router bridge and provider
+- [@xmachines/shared](@xmachines/shared/README.md): Shared TypeScript, oxlint, and formatting configuration
+
+## Notes For LLMs
+
+- Prefer the core packages before the demo apps; demos are intentionally excluded from this file.
+- For implementation questions, usually read in this order: [@xmachines/play-actor](@xmachines/play-actor/README.md) -> [@xmachines/play-xstate](@xmachines/play-xstate/README.md) -> [@xmachines/play-router](@xmachines/play-router/README.md) -> framework renderer/adapter.
+- [Routable](@xmachines/play-actor/interfaces/Routable.md) is the key abstraction for URL synchronization: router adapters observe and update actor route state but do not own navigation policy.
+- Router adapter packages are passive infrastructure; business logic stays in the actor and machine layers.
+- Rendering packages consume the [Viewable](@xmachines/play-actor/interfaces/Viewable.md) contract and component catalogs rather than owning application state.
+
+## Quick Reference
+
+```javascript
+import { definePlayer } from '@xmachines/play-xstate';
+import { extractMachineRoutes } from '@xmachines/play-router';
+
+// Define a player from a machine and catalog
+const createPlayer = definePlayer({ machine, catalog });
+const actor = createPlayer();
+actor.start();
+
+// `Viewable` actors expose renderable view metadata
+const currentView = actor.currentView.get();
+
+// `Routable` actors expose route state for adapters to observe
+const currentRoute = actor.currentRoute.get();
+
+// Extract route metadata for a framework adapter
+const routeTree = extractMachineRoutes(machine);
+```

package/examples/README.md

@@ -27,9 +27,9 @@ See complete working implementations demonstrating all architectural invariants:
 
 Complete working applications demonstrating all 5 architectural invariants:
 
-- **[React + TanStack Router Demo](../../packages/play-tanstack-react-router/examples/demo-app/)** - Canonical reference implementation showing all 5 invariants, comprehensive routing, authentication guards, and browser tests
-- **[Vue Router Demo](../../packages/play-vue-router/examples/demo/)** - Vue Composition API integration with same auth patterns
-- **[SolidJS Router Demo](../../packages/play-solidjs-router/examples/demo/)** - Solid signals integration demonstrating framework independence
+- **[React + TanStack Router Demo](../api/@xmachines/play-tanstack-react-router-demo/README.md)** - Canonical reference implementation showing all 5 invariants, comprehensive routing, authentication guards, and browser tests
+- **[Vue Router Demo](../api/@xmachines/play-vue-router-demo/README.md)** - Vue Composition API integration with same auth patterns
+- **[SolidJS Router Demo](../api/@xmachines/play-solid-router-demo/README.md)** - Solid signals integration demonstrating framework independence
 
 ## Running Examples
 

package/examples/multi-router-integration.md

@@ -265,13 +265,13 @@ All three modes preserve the 5 architectural invariants:
 
 - **[Routing Patterns](./routing-patterns.md)** - Learn play.route events with parameters
 - **[Integration Example](./src/integration-example.ts)** - Complete authentication flow
-- **[React + TanStack Router Demo](../../packages/play-tanstack-react-router/examples/demo-app/)** - Production example using TanStack mode
-- **[Vue Router Demo](../../packages/play-vue-router/examples/demo/)** - Vue Composition API integration
-- **[SolidJS Router Demo](../../packages/play-solidjs-router/examples/demo/)** - Solid signals integration
+- **[React + TanStack Router Demo](../api/@xmachines/play-tanstack-react-router-demo/README.md)** - Production example using TanStack mode
+- **[Vue Router Demo](../api/@xmachines/play-vue-router-demo/README.md)** - Vue Composition API integration
+- **[SolidJS Router Demo](../api/@xmachines/play-solid-router-demo/README.md)** - Solid signals integration
 
 ## Learn More
 
-- [play-tanstack-router README](../../packages/play-tanstack-react-router/README.md) - TanStack integration details
-- [play-react README](../../packages/play-react/README.md) - React renderer documentation
-- [play-router README](../../packages/play-router/README.md) - Framework-agnostic routing
+- [play-tanstack-router README](../api/@xmachines/play-tanstack-react-router/README.md) - TanStack integration details
+- [play-react README](../api/@xmachines/play-react/README.md) - React renderer documentation
+- [play-router README](../api/@xmachines/play-router/README.md) - Framework-agnostic routing
 - [RFC Play v1](https://gitlab.com/xmachin-es/rfc/-/blob/main/src/play-v1.md) - Complete specification

package/examples/routing-patterns.md

@@ -251,10 +251,10 @@ This demonstrates **Actor Authority (INV-01)** — the state machine controls na
 
 - **[Multi-Router Integration](./multi-router-integration.md)** - Learn about renderer prop pattern
 - **[Integration Example](./src/integration-example.ts)** - See complete authentication flow with all patterns
-- **[React + TanStack Router Demo](../../packages/play-tanstack-react-router/examples/demo-app/)** - Production example with all 5 architectural invariants
+- **[React + TanStack Router Demo](../api/@xmachines/play-tanstack-react-router-demo/README.md)** - Production example with all 5 architectural invariants
 
 ## Learn More
 
 - [XState Routes Documentation](https://stately.ai/docs/routes) - Official Stately routing patterns
 - [RFC Play v1](https://gitlab.com/xmachin-es/rfc/-/blob/main/src/play-v1.md) - Complete architectural specification
-- [play-router README](../../packages/play-router/README.md) - Route extraction and tree building
+- [play-router README](../api/@xmachines/play-router/README.md) - Route extraction and tree building

package/guides/README.md

@@ -4,25 +4,24 @@ Entry points for current XMachines Play architecture and package documentation.
 
 ## Start Here
 
-- [Root README](../../README.md) - Monorepo overview and architecture invariants
 - [Examples Index](../examples/README.md) - Runnable and conceptual usage patterns
 
 ## Router Adapter Guides
 
 Use these READMEs for the current RouterBridge-first integrations:
 
-- [@xmachines/play-router](../../packages/play-router/README.md) - Route extraction, route maps, and `RouterBridgeBase`
-- [@xmachines/play-tanstack-react-router](../../packages/play-tanstack-react-router/README.md) - TanStack React adapter
-- [@xmachines/play-react-router](../../packages/play-react-router/README.md) - `react-router` v7 data-router adapter
-- [@xmachines/play-tanstack-solid-router](../../packages/play-tanstack-solid-router/README.md) - TanStack Solid adapter
-- [@xmachines/play-solid-router](../../packages/play-solid-router/README.md) - SolidJS Router adapter
-- [@xmachines/play-vue-router](../../packages/play-vue-router/README.md) - Vue Router adapter
+- [@xmachines/play-router](../api/@xmachines/play-router/README.md) - Route extraction, route maps, and `RouterBridgeBase`
+- [@xmachines/play-tanstack-react-router](../api/@xmachines/play-tanstack-react-router/README.md) - TanStack React adapter
+- [@xmachines/play-react-router](../api/@xmachines/play-react-router/README.md) - `react-router` v7 data-router adapter
+- [@xmachines/play-tanstack-solid-router](../api/@xmachines/play-tanstack-solid-router/README.md) - TanStack Solid adapter
+- [@xmachines/play-solid-router](../api/@xmachines/play-solid-router/README.md) - SolidJS Router adapter
+- [@xmachines/play-vue-router](../api/@xmachines/play-vue-router/README.md) - Vue Router adapter
 
 ## Core Runtime Guides
 
-- [@xmachines/play-xstate](../../packages/play-xstate/README.md) - `definePlayer`, routing transitions, and actor lifecycle
-- [@xmachines/play-react](../../packages/play-react/README.md) - React rendering from actor-driven view state
-- [@xmachines/play-catalog](../../packages/play-catalog/README.md) - Catalog and schema contracts
+- [@xmachines/play-xstate](../api/@xmachines/play-xstate/README.md) - `definePlayer`, routing transitions, and actor lifecycle
+- [@xmachines/play-react](../api/@xmachines/play-react/README.md) - React rendering from actor-driven view state
+- [@xmachines/play-catalog](../api/@xmachines/play-catalog/README.md) - Catalog and schema contracts
 
 ## API Reference
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/docs",
-  "version": "1.0.0-beta.11",
+  "version": "1.0.0-beta.13",
   "description": "Documentation for XMachines",
   "keywords": [
     "documentation",
@@ -46,7 +46,7 @@
     "typedoc": "typedoc"
   },
   "devDependencies": {
-    "@xmachines/shared": "1.0.0-beta.11",
+    "@xmachines/shared": "1.0.0-beta.13",
     "typedoc": "^0.28.17",
     "typedoc-plugin-llms-txt": "^0.1.2",
     "typedoc-plugin-markdown": "^4.11.0"