@xmachines/docs 1.0.0-beta.31 → 1.0.0-beta.33

package/examples/@xmachines/play-solid-demo/variables/DebugPanel.md

@@ -8,4 +8,4 @@ const DebugPanel: Component<{
 }>;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/DebugPanel.tsx:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/DebugPanel.tsx#L5)
+Defined in: [packages/play-solid/examples/demo/src/components/DebugPanel.tsx:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/DebugPanel.tsx#L5)

package/examples/@xmachines/play-solid-demo/variables/Home.md

@@ -6,4 +6,4 @@
 const Home: ComponentFn<AuthCatalog, "Home">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Home.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Home.tsx#L4)
+Defined in: [packages/play-solid/examples/demo/src/components/Home.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Home.tsx#L4)

package/examples/@xmachines/play-solid-demo/variables/Login.md

@@ -6,4 +6,4 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Login.tsx:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Login.tsx#L7)
+Defined in: [packages/play-solid/examples/demo/src/components/Login.tsx:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Login.tsx#L7)

package/examples/@xmachines/play-solid-demo/variables/NavBar.md

@@ -8,4 +8,4 @@ const NavBar: Component<{
 }>;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/NavBar.tsx:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/NavBar.tsx#L28)
+Defined in: [packages/play-solid/examples/demo/src/components/NavBar.tsx:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/NavBar.tsx#L28)

package/examples/@xmachines/play-solid-demo/variables/NavBarView.md

@@ -6,7 +6,7 @@
 const NavBarView: ComponentFn<AuthCatalog, "NavBar">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/NavBar.tsx:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/NavBar.tsx#L20)
+Defined in: [packages/play-solid/examples/demo/src/components/NavBar.tsx:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/NavBar.tsx#L20)
 
 Catalog-typed NavBar component for use in defineRegistry components map.
 Receives props from spec (isAuthenticated, username) and renders a static nav.

package/examples/@xmachines/play-solid-demo/variables/Navigation.md

@@ -6,4 +6,4 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Navigation.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Navigation.tsx#L4)
+Defined in: [packages/play-solid/examples/demo/src/components/Navigation.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Navigation.tsx#L4)

package/examples/@xmachines/play-solid-demo/variables/Overview.md

@@ -6,4 +6,4 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Overview.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Overview.tsx#L4)
+Defined in: [packages/play-solid/examples/demo/src/components/Overview.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Overview.tsx#L4)

package/examples/@xmachines/play-solid-demo/variables/Profile.md

@@ -6,4 +6,4 @@
 const Profile: ComponentFn<AuthCatalog, "Profile">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Profile.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Profile.tsx#L4)
+Defined in: [packages/play-solid/examples/demo/src/components/Profile.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Profile.tsx#L4)

package/examples/@xmachines/play-solid-demo/variables/Settings.md

@@ -6,4 +6,4 @@
 const Settings: ComponentFn<AuthCatalog, "Settings">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Settings.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Settings.tsx#L4)
+Defined in: [packages/play-solid/examples/demo/src/components/Settings.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Settings.tsx#L4)

package/examples/@xmachines/play-solid-demo/variables/Shell.md

@@ -10,4 +10,4 @@ const Shell: Component<{
 }>;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Shell.tsx:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Shell.tsx#L8)
+Defined in: [packages/play-solid/examples/demo/src/components/Shell.tsx:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Shell.tsx#L8)

package/examples/@xmachines/play-solid-demo/variables/Stats.md

@@ -6,4 +6,4 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/components/Stats.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/components/Stats.tsx#L4)
+Defined in: [packages/play-solid/examples/demo/src/components/Stats.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/components/Stats.tsx#L4)

package/examples/@xmachines/play-solid-demo/variables/authCatalog.md

@@ -169,4 +169,4 @@ const authCatalog: Catalog<
 >;
 ```
 
-Defined in: [packages/play-solid/examples/demo/src/catalog.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/examples/demo/src/catalog.ts#L5)
+Defined in: [packages/play-solid/examples/demo/src/catalog.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/examples/demo/src/catalog.ts#L5)

package/examples/@xmachines/play-solid-router-demo/README.md

@@ -51,9 +51,7 @@ const routeMap = createRouteMap(authMachine);
 	actor={actor}
 	routeMap={routeMap}
 	router={{ navigate, location, params }}
-	renderer={(currentActor, currentRouter) => (
-		<Shell actor={currentActor} router={currentRouter} />
-	)}
+	renderer={(currentActor, currentRouter) => <Shell actor={currentActor} router={currentRouter} />}
 />;
 ```
 

package/examples/README.md

@@ -34,7 +34,7 @@ Complete working implementations of actor-authoritative routing with all archite
 - [@xmachines/play-solid-demo](@xmachines/play-solid-demo/README.md)
 - [@xmachines/play-svelte-demo](@xmachines/play-svelte-demo/README.md)
 - [@xmachines/play-vue-demo](@xmachines/play-vue-demo/README.md)
-  <!-- typedoc:renderer-demos:end -->
+<!-- typedoc:renderer-demos:end -->
 
 ### Router Demos
 
@@ -48,7 +48,7 @@ Complete working implementations of actor-authoritative routing with all archite
 - [@xmachines/play-tanstack-react-router-demo](@xmachines/play-tanstack-react-router-demo/README.md)
 - [@xmachines/play-tanstack-solid-router-demo](@xmachines/play-tanstack-solid-router-demo/README.md)
 - [@xmachines/play-vue-router-demo](@xmachines/play-vue-router-demo/README.md)
-  <!-- typedoc:router-demos:end -->
+<!-- typedoc:router-demos:end -->
 
 ## Running the Code Examples
 

package/examples/form-validation.md

@@ -232,8 +232,88 @@ spec: {
 - **`always` transitions**: Entry guards on states. Used for protected routes — if the guard fires, the machine redirects before the state is fully entered.
 - **Lowercase dot-separated event types**: `"auth.login"`, `"auth.logout"`, `"play.route"` — not `SCREAMING_SNAKE_CASE`.
 
+## Connecting the Renderer
+
+The machine spec above defines view structure — but nothing renders until you wire a renderer. Use `createRenderer` from `@xmachines/play-dom`:
+
+```typescript
+import { createRenderer, schema } from "@xmachines/play-dom";
+import { defineCatalog } from "@json-render/core";
+import { z } from "zod";
+import type { ComponentFn } from "@xmachines/play-dom";
+
+const catalog = defineCatalog(schema, {
+	components: {
+		Home: { props: z.object({ title: z.string() }) },
+		Login: { props: z.object({ title: z.string(), username: z.string().optional() }) },
+		Dashboard: { props: z.object({ title: z.string() }) },
+	},
+	actions: {
+		// Must declare all actions that appear in meta.view on-bindings
+		login: { params: z.object({ username: z.string() }) },
+		logout: {},
+	},
+});
+type AppCatalog = typeof catalog;
+
+// Component implementations receive typed props + emit/on helpers
+const Home: ComponentFn<AppCatalog, "Home"> = ({ props }) => {
+	const el = document.createElement("section");
+	el.textContent = props.title;
+	return el;
+};
+
+const Login: ComponentFn<AppCatalog, "Login"> = ({ props, on, ctx }) => {
+	const section = document.createElement("section");
+	const input = document.createElement("input");
+	input.value = props.username ?? "";
+	// Keep the local state store in sync as the user types
+	input.addEventListener("input", () => {
+		ctx.store.update((s) => ({ ...s, username: input.value }));
+	});
+	const button = document.createElement("button");
+	button.textContent = "Log In";
+	const submit = on("submit"); // bound to the spec's on.submit binding
+	button.addEventListener("click", () => submit.emit()); // resolves $state, calls login action
+	section.append(input, button);
+	return section;
+};
+
+const Dashboard: ComponentFn<AppCatalog, "Dashboard"> = ({ props, on }) => {
+	const section = document.createElement("section");
+	section.textContent = props.title;
+	const btn = document.createElement("button");
+	btn.textContent = "Log Out";
+	const logout = on("logout");
+	btn.addEventListener("click", () => logout.emit());
+	section.append(btn);
+	return section;
+};
+
+// createRenderer builds the factory once — call mount() when the actor is ready
+const mount = createRenderer(catalog, { Home, Login, Dashboard });
+
+const actor = createPlayer();
+actor.start();
+
+const disconnect = mount(actor, document.getElementById("app")!);
+
+// Cleanup
+window.addEventListener("beforeunload", () => {
+	disconnect();
+	actor.stop();
+});
+```
+
+**Key points:**
+
+- `actions` in `defineCatalog` must include every action name referenced in `meta.view` spec `on:` bindings. TypeScript enforces this via `CatalogHasActions`.
+- `on("submit").emit()` resolves `params` from the current state store at call time — the `$state: "/username"` in the spec is read at that moment, not at render time.
+- `ctx.store.update(fn)` is the standard write path for two-way binding. The spec's `$bindState` directive only wires the read direction (prop ← store); the write direction (store ← input) must be implemented in the component.
+
 ## Next Steps
 
 - **[Basic State Machine](basic-state-machine.md)** — Foundational concepts without a view layer
 - **[Routing Patterns](routing-patterns.md)** — Parameter routes, relative routes, and `always` auth guards
+- **[play-dom README](../../packages/play-dom/README.md)** — Full `ComponentFn`, `ActionFn`, and spec directive reference
 - **[play-router README](../api/@xmachines/play-router/README.md)** — Route extraction and tree building

package/examples/routing-patterns.md

@@ -249,20 +249,19 @@ import {
 	connectRouter,
 	createRouteMap,
 } from "@xmachines/play-dom-router";
-import { extractMachineRoutes } from "@xmachines/play-router";
 
-const routeTree = extractMachineRoutes(authMachine);
+// createRouteMap extracts meta.route declarations from the machine
 const routeMap = createRouteMap(authMachine);
 
 const history = createBrowserHistory({ window });
-const router = createRouter({ routeTree, history });
+const router = createRouter({ routeTree: authMachine, history });
 
 // connectRouter handles all bidirectional sync:
-// - actor.currentRoute → browser URL
-// - browser URL changes → play.route event to actor
+// - actor.currentRoute signal → browser URL (history.push)
+// - browser URL changes → play.route event sent to actor
 const disconnect = connectRouter({ actor, router, routeMap });
 
-// cleanup on unload
+// Cleanup on unload
 window.addEventListener("beforeunload", () => {
 	disconnect();
 	router.destroy();
@@ -271,26 +270,17 @@ window.addEventListener("beforeunload", () => {
 
 ## React Router Setup
 
-For React, use `@xmachines/play-react-router` or `@xmachines/play-tanstack-react-router` with the `PlayRouterProvider` and `createRouteMapFromTree`:
+For React, use `@xmachines/play-react-router` or `@xmachines/play-tanstack-react-router`:
 
-```typescript
-import { extractMachineRoutes } from "@xmachines/play-router";
+```tsx
 import { PlayRouterProvider, createRouteMapFromTree } from "@xmachines/play-tanstack-react-router";
+import { extractMachineRoutes } from "@xmachines/play-router";
 
 const routeTree = extractMachineRoutes(authMachine);
 const routeMap = createRouteMapFromTree(routeTree);
 
 function App() {
-  return (
-    <PlayRouterProvider
-      actor={actor}
-      router={router}
-      routeMap={routeMap}
-      renderer={(currentActor, currentRouter) => (
-        <Shell actor={currentActor} router={currentRouter} registry={registry} />
-      )}
-    />
-  );
+	return <PlayRouterProvider actor={actor} router={router} routeMap={routeMap} />;
 }
 ```
 

package/guides/getting-started.md

@@ -160,56 +160,69 @@ actor.stop();
 
 ## Step 6: Add a View Registry (Optional)
 
-Connect a renderer to map `meta.view` specs to real components. The vanilla DOM renderer uses `connectRenderer` + `defineRegistry`:
+Connect a renderer to map `meta.view` specs to real components.
 
-```typescript
-import { connectRenderer, defineRegistry } from "@xmachines/play-dom";
-import { authCatalog } from "@xmachines/play-actor-shared";
-import { Home, Login } from "./components/index.js";
+**Vanilla DOM** — use `createRenderer` (one-call pattern):
 
-const { registry } = defineRegistry(authCatalog, {
-	components: { Home, Login },
+```typescript
+import { createRenderer, schema } from "@xmachines/play-dom";
+import { defineCatalog } from "@json-render/core";
+import { z } from "zod";
+import type { ComponentFn } from "@xmachines/play-dom";
+
+const catalog = defineCatalog(schema, {
+	components: {
+		Home: { props: z.object({ title: z.string() }) },
+		Login: { props: z.object({ title: z.string() }) },
+	},
+	actions: {
+		login: { params: z.object({ username: z.string() }) },
+		logout: {},
+	},
 });
 
-const disconnectRenderer = connectRenderer({
-	actor,
-	registry,
-	container: document.getElementById("app")!,
-});
+const Home: ComponentFn<typeof catalog, "Home"> = ({ props }) => {
+	const el = document.createElement("section");
+	el.textContent = props.title;
+	return el;
+};
+const Login: ComponentFn<typeof catalog, "Login"> = ({ props, on }) => {
+	const el = document.createElement("section");
+	const btn = document.createElement("button");
+	const submit = on("submit");
+	btn.addEventListener("click", () => submit.emit());
+	el.append(btn);
+	return el;
+};
+
+// Build factory once, mount when actor + container are ready
+const mount = createRenderer(catalog, { Home, Login });
+const disconnectRenderer = mount(actor, document.getElementById("app")!);
 
-// cleanup
+// Cleanup
 window.addEventListener("beforeunload", () => {
 	disconnectRenderer();
 	actor.stop();
 });
 ```
 
-For React, use `PlayRenderer` from `@xmachines/play-react`:
+**React** — use `PlayRenderer` from `@xmachines/play-react`:
 
 ```tsx
 import { PlayRenderer, defineRegistry } from "@xmachines/play-react";
 import { authCatalog } from "@xmachines/play-actor-shared";
 import { Home, Login } from "./components/index.js";
 
-const { registry } = defineRegistry(authCatalog, {
+const registryResult = defineRegistry(authCatalog, {
 	components: { Home, Login },
 	actions: {
-		login: async () => {},
-		logout: async () => {},
+		login: async (params) => actor.send({ type: "auth.login", username: params!.username }),
+		logout: async () => actor.send({ type: "auth.logout" }),
 	},
 });
 
 function App() {
-	return (
-		<PlayRenderer
-			actor={actor}
-			registry={registry}
-			actions={{
-				login: "auth.login",
-				logout: "auth.logout",
-			}}
-		/>
-	);
+	return <PlayRenderer actor={actor} registryResult={registryResult} />;
 }
 ```
 
@@ -275,17 +288,17 @@ actor.stop();
 
 ## Glossary
 
-| Term                         | Description                                                                                  |
-| ---------------------------- | -------------------------------------------------------------------------------------------- |
-| `setup({ types })`           | XState v5 entry point — declares TypeScript types for context, events, and input             |
-| `definePlayer({ machine })`  | Creates a factory that produces `PlayerActor` instances from the machine                     |
-| `actor.start()`              | Activates the machine — always call before sending events                                    |
-| `actor.send({ type })`       | Sends an event to the machine                                                                |
-| `actor.getSnapshot()`        | Synchronous snapshot of the current state and context                                        |
-| `actor.state`                | `Signal.State<Snapshot>` — TC39 Signal for reactive state observation                        |
-| `actor.currentRoute`         | `Signal.Computed<string \| null>` — resolved URL from the active state's `meta.route`        |
-| `actor.currentView`          | `Signal.State<ViewMetadata \| null>` — current view spec from the active state's `meta.view` |
-| `formatPlayRouteTransitions` | Utility that generates `play.route` handlers from `id` + `meta.route` state pairs            |
+| Term                         | Description                                                                                            |
+| ---------------------------- | ------------------------------------------------------------------------------------------------------ |
+| `setup({ types })`           | XState v5 entry point — declares TypeScript types for context, events, and input                       |
+| `definePlayer({ machine })`  | Creates a factory that produces `PlayerActor` instances from the machine                               |
+| `actor.start()`              | Activates the machine — always call before sending events                                              |
+| `actor.send({ type })`       | Sends an event to the machine                                                                          |
+| `actor.getSnapshot()`        | Synchronous snapshot of the current state and context                                                  |
+| `actor.state`                | `Signal.State<Snapshot>` — TC39 Signal for reactive state observation                                  |
+| `actor.currentRoute`         | `Signal.Computed<string \| null>` — resolved URL from the active state's `meta.route`                  |
+| `actor.currentView`          | `Signal.State<ViewMetadata \| null>` — view spec from the active state's `meta.view`; drives renderers |
+| `formatPlayRouteTransitions` | Utility that generates `play.route` handlers from `id` + `meta.route` state pairs                      |
 
 ## Next Steps
 

package/guides/installation.md

@@ -72,12 +72,12 @@ npx tsx my-script.ts
 npm install @xmachines/play-dom @xmachines/play-dom-router @xmachines/play-router @json-render/core
 ```
 
-| Package                      | Role                                                                      |
-| ---------------------------- | ------------------------------------------------------------------------- |
-| `@xmachines/play-dom`        | `connectRenderer`, `defineRegistry`                                       |
-| `@xmachines/play-dom-router` | `connectRouter`, `createBrowserHistory`, `createRouter`, `createRouteMap` |
-| `@xmachines/play-router`     | `extractMachineRoutes`, `getRoutableRoutes`                               |
-| `@json-render/core`          | Catalog and schema definitions (`defineCatalog`)                          |
+| Package                      | Role                                                                             |
+| ---------------------------- | -------------------------------------------------------------------------------- |
+| `@xmachines/play-dom`        | `createRenderer`, `connectRenderer`, `defineRegistry`, `ComponentFn`, `ActionFn` |
+| `@xmachines/play-dom-router` | `connectRouter`, `createBrowserHistory`, `createRouter`, `createRouteMap`        |
+| `@xmachines/play-router`     | `extractMachineRoutes`, `getRoutableRoutes`, `formatPlayRouteTransitions`        |
+| `@json-render/core`          | Catalog and schema definitions (`defineCatalog`)                                 |
 
 ### React
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/docs",
-  "version": "1.0.0-beta.31",
+  "version": "1.0.0-beta.33",
   "description": "Documentation for XMachines",
   "keywords": [
     "documentation",
@@ -49,12 +49,12 @@
     "test": "vitest run"
   },
   "devDependencies": {
-    "@xmachines/shared": "1.0.0-beta.31",
-    "oxfmt": "^0.43.0",
-    "oxlint": "^1.57.0",
-    "typedoc": "^0.28.18",
+    "@xmachines/shared": "1.0.0-beta.33",
+    "oxfmt": "^0.45.0",
+    "oxlint": "^1.60.0",
+    "typedoc": "^0.28.19",
     "typedoc-plugin-llms-txt": "^0.1.2",
     "typedoc-plugin-markdown": "^4.11.0",
-    "vitest": "^4.1.2"
+    "vitest": "^4.1.4"
   }
 }

package/rfc/play.md

@@ -20,24 +20,24 @@ The reference implementation provides a modular monorepo that satisfies the arch
 ### 2.1 Roles
 
 - **The Actor (Logic Engine)**
-    - Pure, environment-agnostic logic runtime
-    - Owns state, guards, errors, and route validity
-    - Emits _Virtual Routes_ as derived intent
+  - Pure, environment-agnostic logic runtime
+  - Owns state, guards, errors, and route validity
+  - Emits _Virtual Routes_ as derived intent
 
 - **The Runtime Adapter (Infrastructure Layer)**
-    - Environment-specific adapter (Browser, Native, Server, Test Runner)
-    - Reflects Actor output into the environment
-    - Forwards environment events to the Actor without interpretation
+  - Environment-specific adapter (Browser, Native, Server, Test Runner)
+  - Reflects Actor output into the environment
+  - Forwards environment events to the Actor without interpretation
 
 - **The View**
-    - Passive consumer of Actor state
-    - No business rules or routing authority
+  - Passive consumer of Actor state
+  - No business rules or routing authority
 
 ### 2.2 Communication Medium
 
 - **Signals (TC39 Proposal)**
-    - Used exclusively for Actor ↔ Adapter communication
-    - Enables synchronous, glitch-free propagation
+  - Used exclusively for Actor ↔ Adapter communication
+  - Enables synchronous, glitch-free propagation
 
 ---
 
@@ -75,9 +75,9 @@ The reference implementation provides a modular monorepo that satisfies the arch
 - Defines **Virtual Routes** as metadata on state nodes
 - Validates all incoming navigation intents
 - On invalid intent:
-    1. Transitions to an error or fallback state
-    2. Emits a corresponding Virtual Route (e.g. `/error`, `/login`)
-    3. Forces the environment to realign with Actor state
+  1. Transitions to an error or fallback state
+  2. Emits a corresponding Virtual Route (e.g. `/error`, `/login`)
+  3. Forces the environment to realign with Actor state
 
 The Actor has zero knowledge of:
 
@@ -114,9 +114,9 @@ Wraps the TC39 Signals (Stage 1) polyfill. By isolating the reactive primitive w
 **Exports:**
 
 - `Signal` — Re-exported namespace from `signal-polyfill`:
-    - `Signal.State` — Actor output snapshot
-    - `Signal.Computed` — Lazy, pull-based derivation of routes and views
-    - `Signal.subtle.Watcher` — Synchronous observation for Runtime Adapters
+  - `Signal.State` — Actor output snapshot
+  - `Signal.Computed` — Lazy, pull-based derivation of routes and views
+  - `Signal.subtle.Watcher` — Synchronous observation for Runtime Adapters
 - `watchSignal` — Convenience function: subscribes to a single signal with a one-shot watcher lifecycle and microtask batching; returns a cleanup function
 
 #### 5.1.2 `@xmachines/play`
@@ -251,9 +251,9 @@ Provides the complete routing infrastructure: route extraction from state machin
 - `RouterBridge` — Interface: `{ connect(): void; disconnect(): void }`
 - `PlayRouteEvent` — Routing event: `{ type: 'play.route'; to: string; params?; query?; match? }`
 - `RouterBridgeBase` — Abstract base class that encapsulates common bridge logic (signal watching, route synchronization, param/query extraction). Subclasses implement only three methods:
-    - `navigateRouter(path)` — Push a path into the framework router
-    - `watchRouterChanges()` — Subscribe to framework router navigation events
-    - `unwatchRouterChanges()` — Unsubscribe from framework router events
+  - `navigateRouter(path)` — Push a path into the framework router
+  - `watchRouterChanges()` — Subscribe to framework router navigation events
+  - `unwatchRouterChanges()` — Unsubscribe from framework router events
 
 **Route Extraction Exports:**
 

package/api/@xmachines/play-dom/interfaces/DefineRegistryOptions.md

@@ -1,23 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / DefineRegistryOptions
-
-# Interface: DefineRegistryOptions\<C\>
-
-Defined in: [json-render/types.ts:144](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-dom/src/json-render/types.ts#L144)
-
-Options for `defineRegistry`.
-
-Mirrors `DefineRegistryOptions<C>` from @json-render/react, /solid, /svelte, /vue.
-`actions` accepts catalog-typed async handler functions — params are fully typed.
-
-## Type Parameters
-
-| Type Parameter          |
-| ----------------------- |
-| `C` _extends_ `Catalog` |
-
-## Properties
-
-| Property                                       | Type                                                               | Description                                                                                                                                                                                                                                                                                                                                  | Defined in                                                                                                                                   |
-| ---------------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actions"></a> `actions?`       | [`Actions`](../type-aliases/Actions.md)\<`C`\>                     | Map of catalog action name → catalog-typed async handler function. Each handler receives params typed to the action's schema (or `undefined`). Guard against undefined before accessing params: **Example** `actions: { login: async (params) => { if (!params) return; actor.send({ type: 'auth.login', username: params.username }); }, }` | [json-render/types.ts:165](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-dom/src/json-render/types.ts#L165) |
-| <a id="property-components"></a> `components?` | [`ComponentRegistry`](../type-aliases/ComponentRegistry.md)\<`C`\> | Catalog-typed component implementations.                                                                                                                                                                                                                                                                                                     | [json-render/types.ts:148](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-dom/src/json-render/types.ts#L148) |