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

package/api/@xmachines/play-router/interfaces/WindowLike.md

@@ -2,7 +2,7 @@
 
 # Interface: WindowLike
 
-Defined in: [types.ts:324](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/types.ts#L324)
+Defined in: [types.ts:324](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/types.ts#L324)
 
 Minimal window interface required by adapters that subscribe to DOM events
 (e.g. `hashchange`). Injectable for SSR and testing — pass a mock instead of
@@ -30,7 +30,7 @@ connectRouter({ actor, routeMap, window: mockWin });
 addEventListener(type, listener): void;
 ```
 
-Defined in: [types.ts:325](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/types.ts#L325)
+Defined in: [types.ts:325](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/types.ts#L325)
 
 #### Parameters
 
@@ -51,7 +51,7 @@ Defined in: [types.ts:325](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.
 removeEventListener(type, listener): void;
 ```
 
-Defined in: [types.ts:326](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/types.ts#L326)
+Defined in: [types.ts:326](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/types.ts#L326)
 
 #### Parameters
 

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

@@ -6,7 +6,7 @@
 type MachineGraph = Graph<MachineNodeData, MachineEdgeData>;
 ```
 
-Defined in: [machine-to-graph.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/machine-to-graph.ts#L17)
+Defined in: [machine-to-graph.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/machine-to-graph.ts#L17)
 
 Typed @statelyai/graph Graph representing a state machine.
 Provides hierarchy queries, traversal algorithms, and reachability checks.

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

@@ -6,6 +6,6 @@
 type RouteMetadata = string | RouteObject;
 ```
 
-Defined in: [types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/types.ts#L49)
+Defined in: [types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/types.ts#L49)
 
 Route metadata from state machine `meta.route` field.

package/api/@xmachines/play-signals/functions/watchSignal.md

@@ -6,7 +6,7 @@
 function watchSignal<T>(signal, onValue): () => void;
 ```
 
-Defined in: [packages/play-signals/src/watch-signal.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/watch-signal.ts#L21)
+Defined in: [packages/play-signals/src/watch-signal.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/watch-signal.ts#L21)
 
 Subscribe to a single signal using the canonical one-shot watcher lifecycle.
 

package/api/@xmachines/play-signals/interfaces/ComputedOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: ComputedOptions\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:84](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L84)
+Defined in: [packages/play-signals/src/types.ts:84](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L84)
 
 Options for creating Signal.Computed
 
@@ -31,4 +31,4 @@ const options: ComputedOptions<string> = {
 
 | Property                               | Type                    | Description                              | Defined in                                                                                                                                       |
 | -------------------------------------- | ----------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for memoization | [packages/play-signals/src/types.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L88) |
+| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for memoization | [packages/play-signals/src/types.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L88) |

package/api/@xmachines/play-signals/interfaces/SignalComputed.md

@@ -2,7 +2,7 @@
 
 # Interface: SignalComputed\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L111)
+Defined in: [packages/play-signals/src/types.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L111)
 
 Lazily-evaluated, memoized computed signal
 
@@ -38,7 +38,7 @@ console.log(doubled.get()); // 10 (memoized, not recomputed)
 get(): T;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L117)
+Defined in: [packages/play-signals/src/types.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L117)
 
 Read computed value (recalculates only if dependencies changed)
 

package/api/@xmachines/play-signals/interfaces/SignalOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: SignalOptions\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L26)
+Defined in: [packages/play-signals/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L26)
 
 Options for creating Signal.State
 
@@ -32,4 +32,4 @@ const count = new Signal.State(0, options);
 
 | Property                               | Type                    | Description                                               | Defined in                                                                                                                                       |
 | -------------------------------------- | ----------------------- | --------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
-| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for determining if value changed | [packages/play-signals/src/types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L33) |
+| <a id="property-equals"></a> `equals?` | (`a`, `b`) => `boolean` | Custom equality function for determining if value changed | [packages/play-signals/src/types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L33) |

package/api/@xmachines/play-signals/interfaces/SignalState.md

@@ -2,7 +2,7 @@
 
 # Interface: SignalState\<T\>
 
-Defined in: [packages/play-signals/src/types.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L53)
+Defined in: [packages/play-signals/src/types.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L53)
 
 Writable state signal holding a single reactive value
 
@@ -35,7 +35,7 @@ console.log(name.get()); // 'Bob'
 get(): T;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L59)
+Defined in: [packages/play-signals/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L59)
 
 Read current value and track as dependency
 
@@ -53,7 +53,7 @@ Current value of the signal
 set(value): void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L66)
+Defined in: [packages/play-signals/src/types.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L66)
 
 Write new value and notify watchers if changed
 

package/api/@xmachines/play-signals/interfaces/SignalWatcher.md

@@ -2,7 +2,7 @@
 
 # Interface: SignalWatcher
 
-Defined in: [packages/play-signals/src/types.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L167)
+Defined in: [packages/play-signals/src/types.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L167)
 
 Watcher for observing signal changes and scheduling effects
 
@@ -40,7 +40,7 @@ getPending(): (
   | SignalComputed<unknown>)[];
 ```
 
-Defined in: [packages/play-signals/src/types.ts:187](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L187)
+Defined in: [packages/play-signals/src/types.ts:187](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L187)
 
 Get signals that changed since last check
 
@@ -60,7 +60,7 @@ Array of signals that have pending updates
 unwatch(signal): void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:180](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L180)
+Defined in: [packages/play-signals/src/types.ts:180](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L180)
 
 Stop watching a signal
 
@@ -82,7 +82,7 @@ Stop watching a signal
 watch(signal): void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:173](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L173)
+Defined in: [packages/play-signals/src/types.ts:173](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L173)
 
 Start watching a signal for changes
 

package/api/@xmachines/play-signals/type-aliases/WatcherNotify.md

@@ -6,7 +6,7 @@
 type WatcherNotify = () => void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:139](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-signals/src/types.ts#L139)
+Defined in: [packages/play-signals/src/types.ts:139](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-signals/src/types.ts#L139)
 
 Notification callback for Signal.subtle.Watcher
 

package/api/@xmachines/play-solid/README.md

@@ -38,7 +38,7 @@ without muting console output.
 - `PlayRenderer` — main renderer component
 - `useActor` — hook for accessing the actor inside a `PlayRenderer` tree
 - `defineRegistry` — re-exported from `@json-render/solid`
-- `useStateBinding` — re-exported from `@json-render/solid`
+- `useBoundProp` — re-exported from `@json-render/solid`
 - `ComponentFn` (type) — re-exported from `@json-render/solid`
 - `ComponentContext` (type) — re-exported from `@json-render/solid`
 - `PlayRendererProps` (type)
@@ -83,9 +83,17 @@ const Dashboard: ComponentFn<typeof catalog, "Dashboard"> = ({ props }) => (
 );
 
 // 3. Build registry
-const { registry } = defineRegistry(catalog, {
+const registryResult = defineRegistry(catalog, {
 	components: { Login, Dashboard },
-	actions: { login: async () => {}, logout: async () => {} },
+	actions: {
+		login: async (params) => {
+			if (!params) return;
+			actor.send({ type: "auth.login", username: params.username });
+		},
+		logout: async (params) => {
+			actor.send({ type: "auth.logout" });
+		},
+	},
 });
 
 // 4. Define machine with view metadata
@@ -160,13 +168,7 @@ const actor = createPlayer();
 actor.start();
 
 function App() {
-	return (
-		<PlayRenderer
-			actor={actor}
-			registry={registry}
-			actions={{ login: "auth.login", logout: "auth.logout" }}
-		/>
-	);
+	return <PlayRenderer actor={actor} registryResult={registryResult} />;
 }
 ```
 
@@ -179,8 +181,7 @@ Main component. Subscribes to `actor.currentView` and renders the spec.
 ```tsx
 <PlayRenderer
 	actor={actor}
-	registry={registry}
-	actions={{ login: "auth.login" }}
+	registryResult={registryResult}
 	store={myStore}
 	fallback={<p>Loading…</p>}
 />
@@ -188,21 +189,11 @@ Main component. Subscribes to `actor.currentView` and renders the spec.
 
 **`actor`** — A `PlayerActor` (or any `AbstractActor & Viewable`). Provides the `currentView` signal.
 
-**`registry`** — Built with `defineRegistry(catalog, { components, actions })` from `@xmachines/play-solid`.
+**`registryResult`** — The full `DefineRegistryResult` returned by `defineRegistry(catalog, { components, actions })` from `@xmachines/play-solid`.
 
 `defineRegistry` also accepts `onRenderError(error, elementType)`, which receives errors
 caught by `@json-render/solid`'s inner element boundary before the default logger is used.
 
-**`actions`** — Maps json-render action names (from spec `on` bindings) to XState event type strings. Type-checked against `EventFromLogic<TLogic>["type"]` when `TLogic` is specified:
-
-```tsx
-<PlayRenderer<typeof machine>
-	actor={actor}
-	registry={registry}
-	actions={{ login: "auth.login", logout: "auth.logout" }}
-/>
-```
-
 **`store`** (optional) — Controls per-view UI state (`$state` bindings, form values):
 
 - **Omitted (uncontrolled, default):** A fresh `@xstate/store` atom is created per view transition, seeded from `view.spec.state`.
@@ -215,16 +206,24 @@ import type { StateStore } from "@json-render/core";
 
 const store: StateStore = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
 
-<PlayRenderer actor={actor} registry={registry} store={store} actions={{ login: "auth.login" }} />;
+<PlayRenderer actor={actor} registryResult={registryResult} store={store} />;
 ```
 
 **Inner render errors** — You can intercept catalog component render failures without
 overriding the outer Solid error boundary:
 
 ```tsx
-const { registry } = defineRegistry(catalog, {
+const registryResult = defineRegistry(catalog, {
 	components: { Login, Dashboard },
-	actions: { login: async () => {}, logout: async () => {} },
+	actions: {
+		login: async (params) => {
+			if (!params) return;
+			actor.send({ type: "auth.login", username: params.username });
+		},
+		logout: async (params) => {
+			actor.send({ type: "auth.logout" });
+		},
+	},
 	onRenderError(error, elementType) {
 		reportExpectedRenderError(error, elementType);
 	},
@@ -272,7 +271,7 @@ Priority: **route param fills `undefined` slots; explicit non-`undefined` spec p
 - SolidJS signals are only used to trigger re-renders — not for business logic
 - `actor.currentView` (TC39 Signal) is bridged into a SolidJS `createSignal` inside `PlayRenderer`
 - Per-view UI state lives in an `@xstate/store` atom, not in SolidJS reactive state
-- `@json-render/solid` drives rendering; `PlayRenderer` is the signal bridge — import `defineRegistry`, `ComponentFn`, `ComponentContext`, and `useStateBinding` from `@xmachines/play-solid`
+- `@json-render/solid` drives rendering; `PlayRenderer` is the signal bridge — import `defineRegistry`, `ComponentFn`, `ComponentContext`, and `useBoundProp` from `@xmachines/play-solid`
 
 @xmachines/play-solid - SolidJS renderer for XMachines Play architecture
 
@@ -280,7 +279,7 @@ Provides a thin SolidJS rendering layer that passively observes actor signals
 and renders UI components via @json-render/solid. SolidJS reactivity is only
 used to trigger re-renders — signals are the source of truth.
 
-Re-exports `defineRegistry`, `useStateBinding`, `ComponentFn`, and
+Re-exports `defineRegistry`, `useBoundProp`, `ComponentFn`, and
 `ComponentContext` from `@json-render/solid` so consumers import everything
 from `@xmachines/play-solid` rather than `@json-render/solid` directly.
 
@@ -302,4 +301,4 @@ from `@xmachines/play-solid` rather than `@json-render/solid` directly.
 
 - [defineRegistry](functions/defineRegistry.md)
 - [useActor](functions/useActor.md)
-- [useStateBinding](functions/useStateBinding.md)
+- [useBoundProp](functions/useBoundProp.md)

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

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

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

@@ -0,0 +1,45 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / useBoundProp
+
+# Function: useBoundProp()
+
+```ts
+function useBoundProp<T>(propValue, bindingPath): [T | undefined, (value) => void];
+```
+
+Defined in: `@json-render/solid`
+
+Hook for two-way bound props. Returns `[value, setValue]` where:
+
+- `value` is the already-resolved prop value (passed through from render props)
+- `setValue` writes back to the bound state path (no-op if not bound)
+
+Designed to work with the `bindings` map that the renderer provides when
+a prop uses `{ $bindState: "/path" }` or `{ $bindItem: "field" }`.
+
+## Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+## Parameters
+
+| Parameter     | Type                    |
+| ------------- | ----------------------- |
+| `propValue`   | `T` \| `undefined`      |
+| `bindingPath` | `string` \| `undefined` |
+
+## Returns
+
+\[`T` \| `undefined`, (`value`) => `void`\]
+
+## Example
+
+```tsx
+import { useBoundProp } from "@json-render/solid";
+
+const Input: ComponentRenderer = (ctx) => {
+	const [value, setValue] = useBoundProp<string>(ctx.props.value, ctx.bindings?.value);
+	return <input value={value ?? ""} onInput={(e) => setValue(e.target.value)} />;
+};
+```

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

@@ -2,23 +2,22 @@
 
 # Interface: PlayRendererProps\<TLogic\>
 
-Defined in: [packages/play-solid/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L29)
+Defined in: [packages/play-solid/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/types.ts#L26)
 
 Props for PlayRenderer component
 
 ## Type Parameters
 
-| Type Parameter                                                                           | Default type                                                          | Description                                                                                                                                                                                                                 |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | The XState actor logic type. Defaults to `AnyActorLogic` for non-generic usage. When a specific machine type is provided, the `actions` values are constrained to the event type strings that the machine actually accepts. |
+| Type Parameter                                                                           | Default type                                                          | Description                                                                     |
+| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
+| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | The XState actor logic type. Defaults to `AnyActorLogic` for non-generic usage. |
 
 ## Properties
 
-| Property                                   | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                   |
-| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actions"></a> `actions?`   | `object`                                                                                                                                                                                            | Optional mapping of 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-solid/src/types.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L65) |
-| <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-solid/src/types.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L31) |
-| <a id="property-fallback"></a> `fallback?` | `any`                                                                                                                                                                                               | Optional element shown when currentView is null or a component throws                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:37](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L37) |
-| <a id="property-onerror"></a> `onError?`   | (`error`) => `void`                                                                                                                                                                                 | Optional callback invoked when a catalog component throws during render. Receives the thrown error — use to forward to Sentry, Datadog, etc.                                                                                                                                                                                                                        | [packages/play-solid/src/types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L49) |
-| <a id="property-registry"></a> `registry`  | `ComponentRegistry`                                                                                                                                                                                 | Component registry from @json-render/solid defineRegistry()                                                                                                                                                                                                                                                                                                         | [packages/play-solid/src/types.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L34) |
-| <a id="property-store"></a> `store?`       | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-solid/src/types.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/types.ts#L58) |
+| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                   |
+| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| <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-solid/src/types.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/types.ts#L28) |
+| <a id="property-fallback"></a> `fallback?`            | `any`                                                                                                                                                                                               | Optional element shown when currentView is null or a component throws                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/types.ts#L38) |
+| <a id="property-onerror"></a> `onError?`              | (`error`) => `void`                                                                                                                                                                                 | Optional callback invoked when a catalog component throws during render.                                                                                                                                                                                                                                                                                            | [packages/play-solid/src/types.ts:45](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/types.ts#L45) |
+| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() in @json-render/solid. Contains both the component registry and the action handlers factory. Action handlers are real async functions dispatching to the actor (not string-mapped event types).                                                                                                                                   | [packages/play-solid/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/types.ts#L35) |
+| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-solid/src/types.ts:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/types.ts#L54) |

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

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

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

@@ -6,15 +6,15 @@
 const PlayRenderer: Component<PlayRendererProps>;
 ```
 
-Defined in: [packages/play-solid/src/PlayRenderer.tsx:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/src/PlayRenderer.tsx#L55)
+Defined in: [packages/play-solid/src/PlayRenderer.tsx:75](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-solid/src/PlayRenderer.tsx#L75)
 
 Main renderer component that subscribes to actor signals and renders UI
 
-Architecture (per XMachines Play patterns):
+Architecture:
 
 - Subscribes to actor.currentView signal via TC39 Signal.subtle.Watcher
-- Renders view.spec via @json-render/solid Renderer backed by the registry
-- Routes actions to actor.send() via ActionProvider handlers
+- Renders view.spec via StateProvider → PlayRendererInner (with ActionProvider + handlers)
+- Routes actions to actor.send() via registryResult.handlers() — real async functions
 - SolidJS signal only for triggering renders, NOT business logic
 - State store: uses external `store` prop if provided (controlled mode); otherwise
   creates a fresh @xstate/store atom per view transition seeded from spec.state.
@@ -25,24 +25,3 @@ Architecture (per XMachines Play patterns):
 Invariant: Actor Authority - Actor decides all state transitions via guards.
 Invariant: Passive Infrastructure - Component observes signals and sends events.
 Invariant: Signal-Only Reactivity - Business logic state lives in actor signals.
-
-## Example
-
-```typescript
-import { PlayRenderer } from "@xmachines/play-solid";
-import { defineRegistry } from "@json-render/solid";
-
-const { registry } = defineRegistry(catalog, { components: { ... } });
-
-// Uncontrolled — fresh atom per view, seeded from spec.state:
-<PlayRenderer actor={actor} registry={registry} actions={{ login: "auth.login" }} />
-
-// Controlled — caller provides and owns the store:
-import { createAtom } from "@xstate/store";
-import { xstateStoreStateStore } from "@json-render/xstate";
-const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
-<PlayRenderer actor={actor} registry={registry} store={store} actions={{ login: "auth.login" }} />
-
-// With observability hook:
-<PlayRenderer actor={actor} registry={registry} onError={(err) => Sentry.captureException(err)} />
-```

package/api/@xmachines/play-solid-router/classes/RouteMap.md

@@ -2,7 +2,7 @@
 
 # Class: RouteMap
 
-Defined in: [packages/play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/base-route-map.ts#L100)
+Defined in: [packages/play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/base-route-map.ts#L100)
 
 Shared bidirectional route map base class.
 
@@ -50,7 +50,7 @@ map.getPathByStateId("missing"); // null
 new RouteMap(mappings, options?): BaseRouteMap;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/base-route-map.ts#L125)
+Defined in: [packages/play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/base-route-map.ts#L125)
 
 Build a route map from an array of state ID ↔ path mappings.
 
@@ -78,7 +78,7 @@ buckets for efficient candidate selection.
 getPathByStateId(stateId): string | null;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/base-route-map.ts#L209)
+Defined in: [packages/play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/base-route-map.ts#L209)
 
 Look up the path pattern registered for a state ID.
 
@@ -109,7 +109,7 @@ map.getPathByStateId("missing"); // null
 getStateIdByPath(path): string | null;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/base-route-map.ts#L174)
+Defined in: [packages/play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.31/packages/play-router/src/base-route-map.ts#L174)
 
 Resolve a URL path to its mapped state ID.