@xmachines/docs 1.0.0-beta.26 → 1.0.0-beta.28

package/api/@xmachines/play-dom-router/interfaces/RouterBridge.md

@@ -2,7 +2,7 @@
 
 # Interface: RouterBridge
 
-Defined in: [play-router/src/types.ts:271](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/types.ts#L271)
+Defined in: [play-router/src/types.ts:271](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-router/src/types.ts#L271)
 
 RouterBridge interface for runtime infrastructure adapters
 
@@ -54,7 +54,7 @@ class TanStackRouterBridge implements RouterBridge {
 connect(): void | Promise<void>;
 ```
 
-Defined in: [play-router/src/types.ts:287](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/types.ts#L287)
+Defined in: [play-router/src/types.ts:287](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-router/src/types.ts#L287)
 
 Connect the router bridge to the Actor
 
@@ -83,7 +83,7 @@ await bridge.connect();
 disconnect(): void | Promise<void>;
 ```
 
-Defined in: [play-router/src/types.ts:303](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/types.ts#L303)
+Defined in: [play-router/src/types.ts:303](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-router/src/types.ts#L303)
 
 Disconnect the router bridge from the Actor
 

package/api/@xmachines/play-dom-router/interfaces/VanillaRouter.md

@@ -2,14 +2,14 @@
 
 # Interface: VanillaRouter
 
-Defined in: [play-dom-router/src/create-router.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-dom-router/src/create-router.ts#L4)
+Defined in: [play-dom-router/src/create-router.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom-router/src/create-router.ts#L4)
 
 ## Properties
 
 | Property                                    | Modifier   | Type                                                     | Description                          | Defined in                                                                                                                                                    |
 | ------------------------------------------- | ---------- | -------------------------------------------------------- | ------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-history"></a> `history`     | `readonly` | [`BrowserHistory`](BrowserHistory.md)                    | History instance                     | [play-dom-router/src/create-router.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-dom-router/src/create-router.ts#L8)   |
-| <a id="property-routetree"></a> `routeTree` | `readonly` | [`RouteTree`](../../play-router/interfaces/RouteTree.md) | Route tree (for structure reference) | [play-dom-router/src/create-router.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-dom-router/src/create-router.ts#L13) |
+| <a id="property-history"></a> `history`     | `readonly` | [`BrowserHistory`](BrowserHistory.md)                    | History instance                     | [play-dom-router/src/create-router.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom-router/src/create-router.ts#L8)   |
+| <a id="property-routetree"></a> `routeTree` | `readonly` | [`RouteTree`](../../play-router/interfaces/RouteTree.md) | Route tree (for structure reference) | [play-dom-router/src/create-router.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom-router/src/create-router.ts#L13) |
 
 ## Methods
 
@@ -19,7 +19,7 @@ Defined in: [play-dom-router/src/create-router.ts:4](https://gitlab.com/xmachin-
 destroy(): void;
 ```
 
-Defined in: [play-dom-router/src/create-router.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-dom-router/src/create-router.ts#L18)
+Defined in: [play-dom-router/src/create-router.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom-router/src/create-router.ts#L18)
 
 Cleanup
 

package/api/@xmachines/play-dom-router/type-aliases/RoutableActor.md

@@ -6,4 +6,4 @@
 type RoutableActor = AbstractActor<AnyActorLogic> & Routable & Viewable;
 ```
 
-Defined in: [play-dom-router/src/types.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-dom-router/src/types.ts#L9)
+Defined in: [play-dom-router/src/types.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom-router/src/types.ts#L9)

package/api/@xmachines/play-dom-router-demo/README.md

@@ -1,19 +1,16 @@
 [Documentation](../../README.md) / @xmachines/play-dom-router-demo
 
-# Vanilla JavaScript Router Demo
+# Vanilla DOM Router Demo
 
-Pure JavaScript integration proving Play Architecture works without any framework.
+Pure TypeScript integration demo for `@xmachines/play-dom-router` — actor-authoritative routing with the Browser History API and no framework.
 
 ## What This Demonstrates
 
-This demo uses **no framework** - just vanilla JavaScript with the Browser History API and DOM manipulation. It proves that Play Architecture's universal abstractions work at the lowest level, making framework integrations simpler by comparison.
-
-## Key Features
-
-- **Zero Framework Dependencies**: Pure JavaScript and DOM
-- **Browser History API**: Direct integration with `window.history`
-- **Same Auth Machine**: Identical authentication logic as React/Vue/SolidJS demos
-- **Reference Implementation**: This demo serves as the visual reference for all framework demos
+- Shared auth machine reused without framework-specific business logic
+- `connectRouter` + `createBrowserHistory` wiring actor ↔ browser History API
+- Shell-driven DOM rendering via `connectRenderer` with actor-authoritative navigation
+- Manual TC39 Signal watcher lifecycle — the mechanism that framework adapters abstract
+- Non-browser invariant tests plus browser E2E coverage
 
 ## Running the Demo
 
@@ -21,24 +18,24 @@ From the repository root:
 
 ```bash
 npm install
-npm run dev -w packages/play-dom-router/examples/demo
+npm run dev -w @xmachines/play-dom-router-demo
 ```
 
-Visit `http://localhost:5174`.
+Then open `http://localhost:5174`.
 
 ## Step-by-Step Code Flow
 
-Use this order to understand the demo implementation:
+Use this order to understand the implementation:
 
-1. `src/main.ts` creates the actor from the shared machine/catalog and starts it.
-2. `src/router.ts` extracts machine routes, builds browser-history routing primitives, and connects actor <-> router sync.
-3. `src/shell.ts` subscribes to actor signals and renders state-projected DOM views.
-4. Navigation and auth interactions dispatch actor events (`play.route`, `auth.login`, `auth.logout`) rather than mutating URL/state directly.
-5. Browser tests in `test/browser/` validate startup rendering and the auth route flow end-to-end.
+1. `src/main.ts` creates the actor from the shared machine and starts it.
+2. `initRouter(actor)` from `src/router.ts` extracts route metadata, creates a browser history wrapper, instantiates a router, and calls `connectRouter` to wire bidirectional actor ↔ URL sync.
+3. `initShell(actor, app)` from `src/shell.ts` builds the DOM scaffold and sets up the `connectRenderer` loop for view switching.
+4. Navigation buttons and links dispatch `play.route`, `auth.login`, and `auth.logout` events directly to the actor — no URL mutations from the shell.
+5. Browser tests in `test/browser/` validate startup rendering and the full auth route flow.
 
 ```ts
 // src/main.ts (shape)
-const actor = createActorFromSharedMachine();
+const actor = createPlayer();
 actor.start();
 
 const cleanupRouter = initRouter(actor);
@@ -50,45 +47,52 @@ if (app) {
 
 ```ts
 // src/router.ts (shape)
-import { createBrowserHistory, createRouter, connectRouter } from "@xmachines/play-dom-router";
-import { extractMachineRoutes, createRouteMap } from "@xmachines/play-router";
-
-const routeTree = extractMachineRoutes(machine);
-const routeMap = createRouteMap(routeTree);
-const history = createBrowserHistory({ window });
-const router = createRouter({ routeTree, history });
-const disconnect = connectRouter({ actor, router, routeMap });
+export function initRouter(actor) {
+	const routeTree = extractMachineRoutes(authMachine);
+	const routeMap = createRouteMap(authMachine);
+	const history = createBrowserHistory({ window });
+	const router = createRouter({ routeTree, history });
+	const disconnect = connectRouter({ actor, router, routeMap });
+
+	return () => {
+		disconnect();
+		router.destroy();
+	};
+}
 ```
 
 ```ts
 // src/shell.ts (shape)
-actor.currentView.watch(() => {
-	renderView(actor.currentView.get());
+const disconnectRenderer = connectRenderer({ actor, registry, container: viewContent });
+
+const unwatchState = watchSignal(actor.state, () => {
+	navLogin.hidden = snapshot.context.isAuthenticated;
+	navLogout.hidden = !snapshot.context.isAuthenticated;
 });
 
-loginButton.onclick = () => actor.send({ type: "auth.login", username, password });
-logoutButton.onclick = () => actor.send({ type: "auth.logout" });
+navLogin.addEventListener("click", () => actor.send({ type: "play.route", to: "#login" }));
 ```
 
 ## Key Files
 
 - `src/main.ts` - actor startup, router initialization, and shell bootstrap
 - `src/router.ts` - `createBrowserHistory`, `createRouter`, and `connectRouter` wiring
-- `src/shell.ts` - DOM rendering and reactive watcher loop for state-driven updates
+- `src/shell.ts` - DOM scaffold, `DomRegistry` construction, `connectRenderer`, and reactive watcher loop
+- `test/library-pattern.test.ts` - architecture boundary and invariant assertions
 - `test/browser/startup.browser.test.ts` - startup rendering assertion for public home + login action
-- `test/browser/auth-flow.browser.test.ts` - login -> dashboard -> profile -> logout browser flow
+- `test/browser/auth-flow.browser.test.ts` - login → dashboard → profile → logout browser flow
 
 ## State Machine & Architecture Details
 
 The demo utilizes XMachines architectural invariants at the lowest level:
 
-1. **Actor Authority:** Intercepting browser `popstate` events or link clicks dispatches a `play.route` event to the actor. The actor processes the request against the current state, ensuring any auth logic is correctly applied.
-2. **Passive Infrastructure:** The router simply updates `window.history` and the DOM solely renders HTML text based on what `actor.currentView.get()` yields.
-3. **Signal-Only Reactivity:** The integration registers manual `Signal.subtle.Watcher` observers that manually trigger DOM reconciliation, illustrating the underlying mechanism abstraction used by framework adapters.
+1. **Actor Authority:** Intercepting browser `popstate` events or navigation button clicks dispatches a `play.route` event to the actor. The actor processes the request against the current state, ensuring any auth logic is correctly applied.
+2. **Passive Infrastructure:** The router simply updates `window.history` and the DOM solely renders HTML based on what `actor.currentView` yields. Neither holds business state.
+3. **Signal-Only Reactivity:** The integration registers `watchSignal` observers that trigger DOM reconciliation, illustrating the underlying mechanism that framework adapters abstract.
 
 ## Watcher Lifecycle and Cleanup Contract
 
-Even in the vanilla demo, watcher handling follows the same canonical lifecycle:
+Even in the vanilla demo, watcher handling follows the canonical lifecycle:
 
 1. `notify`
 2. `queueMicrotask`
@@ -96,46 +100,37 @@ Even in the vanilla demo, watcher handling follows the same canonical lifecycle:
 4. Read actor signals and project DOM state
 5. Re-arm with `watch()`/`watch(...signals)`
 
-Watcher notifications are one-shot, so re-arm is mandatory. Router/shell teardown must explicitly call cleanup (`disconnect`/`unwatch`) and not rely on GC-only behavior. In vanilla JS, this means retaining the cleanup functions and calling them during hot-module replacement or app unmount.
+Watcher notifications are one-shot, so re-arm is mandatory. Router/shell teardown must explicitly call cleanup (`disconnect`/`unwatch`) and not rely on GC-only behavior. In vanilla TypeScript, this means retaining cleanup functions and calling them on `beforeunload` or during hot-module replacement.
 
 ## Adapter Boundaries
 
-`connectRouter` and browser-history wiring (from `@xmachines/play-dom-router`) are passive infrastructure. Actor logic remains authoritative for route validity, and shared synchronization policy stays in `RouterBridgeBase` for framework bridges.
-
-## Why Vanilla?
-
-Vanilla JavaScript is the foundation:
-
-- **Universal Patterns**: If it works in vanilla, frameworks are just convenience layers
-- **No Magic**: Every interaction is explicit - great for learning
-- **Performance Baseline**: Shows the minimal overhead of Play Architecture
-
-This demo proves frameworks aren't required for Play Architecture to work.
+`connectRouter` and browser-history wiring (from `@xmachines/play-dom-router`) are passive infrastructure. Actor logic remains authoritative for route validity, and shared synchronization policy stays in `RouterBridgeBase` for framework bridges. This demo proves frameworks are not required for Play Architecture to work.
 
 ## Available Scripts
 
 These commands are defined in `package.json`:
 
-| Command                                                          | Description                      |
-| ---------------------------------------------------------------- | -------------------------------- |
-| `npm run dev -w packages/play-dom-router/examples/demo`          | Start Vite dev server            |
-| `npm run build -w packages/play-dom-router/examples/demo`        | Build production bundle          |
-| `npm run preview -w packages/play-dom-router/examples/demo`      | Preview built bundle             |
-| `npm run test -w packages/play-dom-router/examples/demo`         | Run Vitest test suite            |
-| `npm run test:browser -w packages/play-dom-router/examples/demo` | Run browser-focused Vitest suite |
+| Command                                                   | Description                      |
+| --------------------------------------------------------- | -------------------------------- |
+| `npm run dev -w @xmachines/play-dom-router-demo`          | Start Vite dev server            |
+| `npm run build -w @xmachines/play-dom-router-demo`        | Build production bundle          |
+| `npm run preview -w @xmachines/play-dom-router-demo`      | Preview built bundle             |
+| `npm run test -w @xmachines/play-dom-router-demo`         | Run Vitest test suite            |
+| `npm run test:browser -w @xmachines/play-dom-router-demo` | Run browser-focused Vitest suite |
 
 ## Verification
 
-Validate the operational behavior with package-local tests:
+Use these checks to validate README claims against the current demo implementation:
 
 ```bash
-npm run test -w packages/play-dom-router/examples/demo
-npm run test:browser -w packages/play-dom-router/examples/demo
+npm run test -w @xmachines/play-dom-router-demo
+npm run test:browser -w @xmachines/play-dom-router-demo
 ```
 
 Expected result: tests pass, including startup rendering and the full browser auth flow in `test/browser/`.
 
 ## Learn More
 
-- **[Play DOM Router package README](../play-dom-router/README.md)** - `createBrowserHistory`, `createRouter`, `connectRouter` APIs
-- **[Play Router package README](../play-router/README.md)** - Route extraction and abstract routing infrastructure
+- [Play DOM Router package README](../play-dom-router/README.md)
+- [Play DOM demo README](../play-dom-demo/README.md)
+- [Play Router package README](../play-router/README.md)

package/api/@xmachines/play-react/classes/PlayErrorBoundary.md

@@ -2,7 +2,7 @@
 
 # Class: PlayErrorBoundary
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L53)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L53)
 
 React class component error boundary for catching catalog component render errors.
 
@@ -36,7 +36,7 @@ Per CONS-14: Class component pattern works with all React versions (18 and 19).
 new PlayErrorBoundary(props): PlayErrorBoundary;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L57)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L57)
 
 #### Parameters
 
@@ -75,7 +75,7 @@ React.Component<
 componentDidCatch(error, info): void;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L66)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L66)
 
 Catches exceptions generated in descendant components. Unhandled exceptions will cause
 the entire component tree to unmount.
@@ -105,8 +105,6 @@ React.Component.componentDidCatch;
 optional componentDidMount(): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately after a component is mounted. Setting state here will trigger re-rendering.
 
 #### Returns
@@ -130,8 +128,6 @@ optional componentDidUpdate(
    snapshot?): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately after updating occurs. Not called for the initial render.
 
 The snapshot is only present if [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate) is present and returns non-null.
@@ -162,8 +158,6 @@ React.Component.componentDidUpdate;
 optional componentWillMount(): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
 
@@ -198,8 +192,6 @@ React.Component.componentWillMount;
 optional componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: `@types/react`
-
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
 props if you only want to handle changes.
@@ -244,8 +236,6 @@ React.Component.componentWillReceiveProps;
 optional componentWillUnmount(): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as
 cancelled network requests, or cleaning up any DOM elements created in `componentDidMount`.
 
@@ -270,8 +260,6 @@ optional componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
 Note: You cannot call [Component.setState](#setstate) here.
@@ -315,8 +303,6 @@ React.Component.componentWillUpdate;
 forceUpdate(callback?): void;
 ```
 
-Defined in: `@types/react`
-
 #### Parameters
 
 | Parameter   | Type         |
@@ -341,8 +327,6 @@ React.Component.forceUpdate;
 optional getSnapshotBeforeUpdate(prevProps, prevState): any;
 ```
 
-Defined in: `@types/react`
-
 Runs before React applies the result of [render](https://www.jsdocs.io/package/@types/react#Component.render) to the document, and
 returns an object to be given to [componentDidUpdate](#componentdidupdate). Useful for saving
 things such as scroll position before [render](https://www.jsdocs.io/package/@types/react#Component.render) causes changes to it.
@@ -375,7 +359,7 @@ React.Component.getSnapshotBeforeUpdate;
 render(): ReactNode;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L70)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L70)
 
 #### Returns
 
@@ -395,8 +379,6 @@ React.Component.render;
 setState<K>(state, callback?): void;
 ```
 
-Defined in: `@types/react`
-
 #### Type Parameters
 
 | Type Parameter                                                                          |
@@ -431,8 +413,6 @@ optional shouldComponentUpdate(
    nextContext): boolean;
 ```
 
-Defined in: `@types/react`
-
 Called to determine whether the change in props and state should trigger a re-render.
 
 `Component` always returns true.
@@ -468,8 +448,6 @@ React.Component.shouldComponentUpdate;
 optional UNSAFE_componentWillMount(): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
 
@@ -506,8 +484,6 @@ React.Component.UNSAFE_componentWillMount;
 optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: `@types/react`
-
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
 props if you only want to handle changes.
@@ -557,8 +533,6 @@ optional UNSAFE_componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: `@types/react`
-
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
 Note: You cannot call [Component.setState](#setstate) here.
@@ -604,7 +578,7 @@ React.Component.UNSAFE_componentWillUpdate;
 static getDerivedStateFromError(error): PlayErrorBoundaryState;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L62)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L62)
 
 #### Parameters
 

package/api/@xmachines/play-react/functions/defineRegistry.md

@@ -6,8 +6,6 @@
 function defineRegistry<C>(_catalog, options): DefineRegistryResult;
 ```
 
-Defined in: `@json-render/react`
-
 Create a registry from a catalog with components and/or actions.
 
 When the catalog declares actions, the `actions` field is required.

package/api/@xmachines/play-react/functions/useActor.md

@@ -6,7 +6,7 @@
 function useActor(): PlayActor;
 ```
 
-Defined in: [packages/play-react/src/useActor.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/useActor.ts#L30)
+Defined in: [packages/play-react/src/useActor.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/useActor.ts#L30)
 
 ## Returns
 

package/api/@xmachines/play-react/functions/useBoundProp.md

@@ -6,8 +6,6 @@
 function useBoundProp<T>(propValue, bindingPath): [T | undefined, (value) => void];
 ```
 
-Defined in: `@json-render/react`
-
 Hook for two-way bound props. Returns `[value, setValue]` where:
 
 - `value` is the already-resolved prop value (passed through from render props)

package/api/@xmachines/play-react/functions/useSignalEffect.md

@@ -6,7 +6,7 @@
 function useSignalEffect(callback): void;
 ```
 
-Defined in: [packages/play-react/src/useSignalEffect.ts:71](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/useSignalEffect.ts#L71)
+Defined in: [packages/play-react/src/useSignalEffect.ts:71](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/useSignalEffect.ts#L71)
 
 React hook that subscribes to signal changes and runs effect callback
 

package/api/@xmachines/play-react/functions/useStateBinding.md

@@ -6,8 +6,6 @@
 function useStateBinding<T>(path): [T | undefined, (value) => void];
 ```
 
-Defined in: `@json-render/react`
-
 Hook to get and set a value from the state model (like useState).
 
 ## Type Parameters

package/api/@xmachines/play-react/interfaces/ComponentContext.md

@@ -2,8 +2,6 @@
 
 # Interface: ComponentContext\<C, K\>
 
-Defined in: `@json-render/react`
-
 Context passed to component render functions
 
 ## Example

package/api/@xmachines/play-react/interfaces/PlayErrorBoundaryProps.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayErrorBoundaryProps
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L14)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L14)
 
 Props for PlayErrorBoundary
 
@@ -10,6 +10,6 @@ Props for PlayErrorBoundary
 
 | Property                                   | Type                        | Description                                                                             | Defined in                                                                                                                                                             |
 | ------------------------------------------ | --------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-children"></a> `children`  | `ReactNode`                 | Child components to render                                                              | [packages/play-react/src/PlayErrorBoundary.tsx:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L18) |
-| <a id="property-fallback"></a> `fallback?` | `ReactNode`                 | Fallback UI to render when a child component throws. Defaults to null.                  | [packages/play-react/src/PlayErrorBoundary.tsx:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L16) |
-| <a id="property-onerror"></a> `onError?`   | (`error`, `info`) => `void` | Optional error handler callback — forwards errors to observability tools (Sentry, etc.) | [packages/play-react/src/PlayErrorBoundary.tsx:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L20) |
+| <a id="property-children"></a> `children`  | `ReactNode`                 | Child components to render                                                              | [packages/play-react/src/PlayErrorBoundary.tsx:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L18) |
+| <a id="property-fallback"></a> `fallback?` | `ReactNode`                 | Fallback UI to render when a child component throws. Defaults to null.                  | [packages/play-react/src/PlayErrorBoundary.tsx:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L16) |
+| <a id="property-onerror"></a> `onError?`   | (`error`, `info`) => `void` | Optional error handler callback — forwards errors to observability tools (Sentry, etc.) | [packages/play-react/src/PlayErrorBoundary.tsx:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L20) |

package/api/@xmachines/play-react/interfaces/PlayErrorBoundaryState.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayErrorBoundaryState
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L28)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L28)
 
 Internal state shape for PlayErrorBoundary
 
@@ -10,5 +10,5 @@ Internal state shape for PlayErrorBoundary
 
 | Property                                  | Type              | Defined in                                                                                                                                                             |
 | ----------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-error"></a> `error`       | `Error` \| `null` | [packages/play-react/src/PlayErrorBoundary.tsx:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L30) |
-| <a id="property-haserror"></a> `hasError` | `boolean`         | [packages/play-react/src/PlayErrorBoundary.tsx:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayErrorBoundary.tsx#L29) |
+| <a id="property-error"></a> `error`       | `Error` \| `null` | [packages/play-react/src/PlayErrorBoundary.tsx:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L30) |
+| <a id="property-haserror"></a> `hasError` | `boolean`         | [packages/play-react/src/PlayErrorBoundary.tsx:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayErrorBoundary.tsx#L29) |

package/api/@xmachines/play-react/interfaces/PlayRendererProps.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayRendererProps\<TLogic\>
 
-Defined in: [packages/play-react/src/types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L33)
+Defined in: [packages/play-react/src/types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L33)
 
 Props for PlayRenderer component
 
@@ -16,9 +16,9 @@ Props for PlayRenderer component
 
 | Property                                   | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                   |
 | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actions"></a> `actions?`   | `object`                                                                                                                                                                                            | Maps json-render action names to XState event type strings. Values are constrained to `EventFromLogic<TLogic>["type"]` — passing a non-existent event type string is a compile error when TLogic is specified.                                                                                                      | [packages/play-react/src/types.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L70) |
-| <a id="property-actor"></a> `actor`        | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                               | [packages/play-react/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L35) |
-| <a id="property-fallback"></a> `fallback?` | `ReactNode`                                                                                                                                                                                         | Optional component shown when currentView is null                                                                                                                                                                                                                                                                   | [packages/play-react/src/types.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L51) |
-| <a id="property-onerror"></a> `onError?`   | (`error`, `info`) => `void`                                                                                                                                                                         | Optional callback invoked when a catalog component throws during render. Receives the error and React ErrorInfo — use to forward to Sentry, Datadog, etc.                                                                                                                                                           | [packages/play-react/src/types.ts:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L63) |
-| <a id="property-registry"></a> `registry`  | `ComponentRegistry`                                                                                                                                                                                 | ComponentRegistry from defineRegistry() in @json-render/react                                                                                                                                                                                                                                                       | [packages/play-react/src/types.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L38) |
-| <a id="property-store"></a> `store?`       | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and the store is the single source of truth for UI state. When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-react/src/types.ts:48](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/types.ts#L48) |
+| <a id="property-actions"></a> `actions?`   | `object`                                                                                                                                                                                            | Maps json-render action names to XState event type strings. Values are constrained to `EventFromLogic<TLogic>["type"]` — passing a non-existent event type string is a compile error when TLogic is specified.                                                                                                      | [packages/play-react/src/types.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L70) |
+| <a id="property-actor"></a> `actor`        | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                               | [packages/play-react/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L35) |
+| <a id="property-fallback"></a> `fallback?` | `ReactNode`                                                                                                                                                                                         | Optional component shown when currentView is null                                                                                                                                                                                                                                                                   | [packages/play-react/src/types.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L51) |
+| <a id="property-onerror"></a> `onError?`   | (`error`, `info`) => `void`                                                                                                                                                                         | Optional callback invoked when a catalog component throws during render. Receives the error and React ErrorInfo — use to forward to Sentry, Datadog, etc.                                                                                                                                                           | [packages/play-react/src/types.ts:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L63) |
+| <a id="property-registry"></a> `registry`  | `ComponentRegistry`                                                                                                                                                                                 | ComponentRegistry from defineRegistry() in @json-render/react                                                                                                                                                                                                                                                       | [packages/play-react/src/types.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L38) |
+| <a id="property-store"></a> `store?`       | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and the store is the single source of truth for UI state. When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-react/src/types.ts:48](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/types.ts#L48) |

package/api/@xmachines/play-react/type-aliases/ComponentFn.md

@@ -6,8 +6,6 @@
 type ComponentFn<C, K> = (ctx) => ReactNode;
 ```
 
-Defined in: `@json-render/react`
-
 Component render function type for React
 
 ## Type Parameters

package/api/@xmachines/play-react/type-aliases/PlayActor.md

@@ -6,4 +6,4 @@
 type PlayActor = AbstractActor<AnyActorLogic>;
 ```
 
-Defined in: [packages/play-react/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/useActor.ts#L26)
+Defined in: [packages/play-react/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/useActor.ts#L26)

package/api/@xmachines/play-react/variables/PlayRenderer.md

@@ -6,7 +6,7 @@
 const PlayRenderer: React.FC<PlayRendererProps>;
 ```
 
-Defined in: [packages/play-react/src/PlayRenderer.tsx:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-react/src/PlayRenderer.tsx#L65)
+Defined in: [packages/play-react/src/PlayRenderer.tsx:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/src/PlayRenderer.tsx#L65)
 
 Main renderer component that subscribes to actor signals and renders UI
 via @json-render/react Renderer.