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

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.32/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.32/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.32/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.32/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.32/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.32/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.32/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.32/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:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/PlayRenderer.tsx#L74)
 
 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/README.md

@@ -168,8 +168,8 @@ routeMap.getPathByStateId(stateId: string): string | null
 **Constructor Parameters:**
 
 - `mappings` - Array of `{ stateId, path }` entries:
-    - `stateId` — State machine state ID (e.g., `'#profile'`)
-    - `path` — SolidJS Router path pattern (e.g., `'/profile/:userId'`)
+  - `stateId` — State machine state ID (e.g., `'#profile'`)
+  - `path` — SolidJS Router path pattern (e.g., `'/profile/:userId'`)
 
 **Methods:**
 

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.32/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.32/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.32/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.32/packages/play-router/src/base-route-map.ts#L174)
 
 Resolve a URL path to its mapped state ID.
 

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

@@ -2,7 +2,7 @@
 
 # Class: SolidRouterBridge
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L55)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L55)
 
 SolidJS Router integration bridge extending RouterBridgeBase
 
@@ -31,7 +31,7 @@ new SolidRouterBridge(
    routeMap): SolidRouterBridge;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:76](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L76)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:76](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L76)
 
 Create a SolidJS Router bridge
 
@@ -59,15 +59,15 @@ Create a SolidJS Router bridge
 
 | Property                                                              | Modifier    | Type                                                                                                                                                                                                                                                  | Default value | Description                                                                                                                                                                                      | Inherited from                                                                                                                                                                | Defined in                                                                                                                                                                 |
 | --------------------------------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                                   | `readonly`  | [`AbstractActor`](../interfaces/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Routable`](../../play-actor/interfaces/Routable.md) | `undefined`   | A `Routable` actor exposing `currentRoute` and `send`.                                                                                                                                           | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`actor`](../../play-router/classes/RouterBridgeBase.md#property-actor)                                   | [packages/play-router/src/router-bridge-base.ts:99](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L99)   |
-| <a id="property-hasconnectedonce"></a> `hasConnectedOnce`             | `protected` | `boolean`                                                                                                                                                                                                                                             | `false`       | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`hasConnectedOnce`](../../play-router/classes/RouterBridgeBase.md#property-hasconnectedonce)             | [packages/play-router/src/router-bridge-base.ts:87](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L87)   |
-| <a id="property-isconnected"></a> `isConnected`                       | `protected` | `boolean`                                                                                                                                                                                                                                             | `false`       | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isConnected`](../../play-router/classes/RouterBridgeBase.md#property-isconnected)                       | [packages/play-router/src/router-bridge-base.ts:86](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L86)   |
-| <a id="property-isprocessingnavigation"></a> `isProcessingNavigation` | `protected` | `boolean`                                                                                                                                                                                                                                             | `false`       | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isProcessingNavigation`](../../play-router/classes/RouterBridgeBase.md#property-isprocessingnavigation) | [packages/play-router/src/router-bridge-base.ts:89](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L89)   |
-| <a id="property-lastsyncedpath"></a> `lastSyncedPath`                 | `protected` | `string` \| `null`                                                                                                                                                                                                                                    | `null`        | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`lastSyncedPath`](../../play-router/classes/RouterBridgeBase.md#property-lastsyncedpath)                 | [packages/play-router/src/router-bridge-base.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L88)   |
-| <a id="property-routemap"></a> `routeMap`                             | `readonly`  | `object`                                                                                                                                                                                                                                              | `undefined`   | Bidirectional route map for `stateId ↔ path` resolution. Provide `getStateIdByPath` and `getPathByStateId`. Framework adapters typically wrap the result of `createRouteMap()` or an equivalent. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeMap`](../../play-router/classes/RouterBridgeBase.md#property-routemap)                             | [packages/play-router/src/router-bridge-base.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L100) |
-| `routeMap.getPathByStateId`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                                                                                                                                     | `undefined`   | -                                                                                                                                                                                                | -                                                                                                                                                                             | [packages/play-router/src/router-bridge-base.ts:102](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L102) |
-| `routeMap.getStateIdByPath`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                                                                                                                                     | `undefined`   | -                                                                                                                                                                                                | -                                                                                                                                                                             | [packages/play-router/src/router-bridge-base.ts:101](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L101) |
-| <a id="property-routewatcher"></a> `routeWatcher`                     | `protected` | \| [`RouteWatcherHandle`](../../play-router/interfaces/RouteWatcherHandle.md) \| `null`                                                                                                                                                               | `null`        | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeWatcher`](../../play-router/classes/RouterBridgeBase.md#property-routewatcher)                     | [packages/play-router/src/router-bridge-base.ts:90](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L90)   |
+| <a id="property-actor"></a> `actor`                                   | `readonly`  | [`AbstractActor`](../interfaces/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Routable`](../../play-actor/interfaces/Routable.md) | `undefined`   | A `Routable` actor exposing `currentRoute` and `send`.                                                                                                                                           | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`actor`](../../play-router/classes/RouterBridgeBase.md#property-actor)                                   | [packages/play-router/src/router-bridge-base.ts:99](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L99)   |
+| <a id="property-hasconnectedonce"></a> `hasConnectedOnce`             | `protected` | `boolean`                                                                                                                                                                                                                                             | `false`       | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`hasConnectedOnce`](../../play-router/classes/RouterBridgeBase.md#property-hasconnectedonce)             | [packages/play-router/src/router-bridge-base.ts:87](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L87)   |
+| <a id="property-isconnected"></a> `isConnected`                       | `protected` | `boolean`                                                                                                                                                                                                                                             | `false`       | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isConnected`](../../play-router/classes/RouterBridgeBase.md#property-isconnected)                       | [packages/play-router/src/router-bridge-base.ts:86](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L86)   |
+| <a id="property-isprocessingnavigation"></a> `isProcessingNavigation` | `protected` | `boolean`                                                                                                                                                                                                                                             | `false`       | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isProcessingNavigation`](../../play-router/classes/RouterBridgeBase.md#property-isprocessingnavigation) | [packages/play-router/src/router-bridge-base.ts:89](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L89)   |
+| <a id="property-lastsyncedpath"></a> `lastSyncedPath`                 | `protected` | `string` \| `null`                                                                                                                                                                                                                                    | `null`        | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`lastSyncedPath`](../../play-router/classes/RouterBridgeBase.md#property-lastsyncedpath)                 | [packages/play-router/src/router-bridge-base.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L88)   |
+| <a id="property-routemap"></a> `routeMap`                             | `readonly`  | `object`                                                                                                                                                                                                                                              | `undefined`   | Bidirectional route map for `stateId ↔ path` resolution. Provide `getStateIdByPath` and `getPathByStateId`. Framework adapters typically wrap the result of `createRouteMap()` or an equivalent. | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeMap`](../../play-router/classes/RouterBridgeBase.md#property-routemap)                             | [packages/play-router/src/router-bridge-base.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L100) |
+| `routeMap.getPathByStateId`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                                                                                                                                     | `undefined`   | -                                                                                                                                                                                                | -                                                                                                                                                                             | [packages/play-router/src/router-bridge-base.ts:102](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L102) |
+| `routeMap.getStateIdByPath`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                                                                                                                                     | `undefined`   | -                                                                                                                                                                                                | -                                                                                                                                                                             | [packages/play-router/src/router-bridge-base.ts:101](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L101) |
+| <a id="property-routewatcher"></a> `routeWatcher`                     | `protected` | \| [`RouteWatcherHandle`](../../play-router/interfaces/RouteWatcherHandle.md) \| `null`                                                                                                                                                               | `null`        | -                                                                                                                                                                                                | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeWatcher`](../../play-router/classes/RouterBridgeBase.md#property-routewatcher)                     | [packages/play-router/src/router-bridge-base.ts:90](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L90)   |
 
 ## Methods
 
@@ -77,7 +77,7 @@ Create a SolidJS Router bridge
 connect(): void;
 ```
 
-Defined in: [packages/play-router/src/router-bridge-base.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L126)
+Defined in: [packages/play-router/src/router-bridge-base.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L126)
 
 Connect the router bridge to the Actor.
 
@@ -109,7 +109,7 @@ Adapters that need custom initial-sync behavior should override
 disconnect(): void;
 ```
 
-Defined in: [packages/play-router/src/router-bridge-base.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L209)
+Defined in: [packages/play-router/src/router-bridge-base.ts:214](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L214)
 
 Disconnect the router bridge from the Actor.
 
@@ -131,7 +131,7 @@ Stops signal watching and unregisters framework-specific router listener.
 dispose(): void;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:188](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L188)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:188](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L188)
 
 Dispose the bridge (alias for disconnect).
 
@@ -153,7 +153,7 @@ onCleanup(() => bridge.dispose());
 protected extractParams(pathname, stateId): Record<string, string>;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:105](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L105)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:105](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L105)
 
 Extract path parameters using Solid's pre-parsed `useParams()` values.
 
@@ -190,7 +190,7 @@ Normalized path parameters with undefined/empty values filtered out
 protected extractQuery(search): Record<string, string>;
 ```
 
-Defined in: [packages/play-router/src/router-bridge-base.ts:355](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L355)
+Defined in: [packages/play-router/src/router-bridge-base.ts:359](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L359)
 
 Extract query parameters from URL search string.
 
@@ -218,7 +218,7 @@ Extracted query parameters or empty object
 protected getInitialRouterPath(): string | null;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:127](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L127)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:127](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L127)
 
 Get the current router pathname for initial URL -> actor sync on connect.
 
@@ -238,7 +238,7 @@ Get the current router pathname for initial URL -> actor sync on connect.
 protected getInitialRouterSearch(): string | undefined;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L138)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L138)
 
 Return the initial URL search string for query-param forwarding on `connect()`.
 
@@ -262,7 +262,7 @@ params) returns `undefined` so `syncActorFromRouter` produces `query: {}`.
 protected navigateRouter(path): void;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:120](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L120)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:120](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L120)
 
 Navigate SolidJS Router to the given path.
 
@@ -288,7 +288,7 @@ Navigate SolidJS Router to the given path.
 protected resolveNavigationPath(route): string | null;
 ```
 
-Defined in: [packages/play-router/src/router-bridge-base.ts:340](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L340)
+Defined in: [packages/play-router/src/router-bridge-base.ts:344](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L344)
 
 Resolve an actor route value to a concrete URL path for navigation.
 
@@ -327,7 +327,7 @@ Concrete URL path, or `null` if navigation should be skipped
 protected syncActorFromRouter(pathname, search?): void;
 ```
 
-Defined in: [packages/play-router/src/router-bridge-base.ts:260](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L260)
+Defined in: [packages/play-router/src/router-bridge-base.ts:264](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L264)
 
 Sync actor state when router location changes.
 
@@ -357,7 +357,7 @@ Prevents circular updates via isProcessingNavigation flag.
 protected syncRouterFromActor(route): void;
 ```
 
-Defined in: [packages/play-router/src/router-bridge-base.ts:240](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/router-bridge-base.ts#L240)
+Defined in: [packages/play-router/src/router-bridge-base.ts:244](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/router-bridge-base.ts#L244)
 
 Sync router location when actor route signal changes.
 
@@ -390,7 +390,7 @@ suppressed as circular echoes.
 protected unwatchRouterChanges(): void;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:175](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L175)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:175](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L175)
 
 Stop watching SolidJS Router changes.
 
@@ -414,7 +414,7 @@ cleanup path — component unmount does NOT trigger this automatically.
 protected watchRouterChanges(): void;
 ```
 
-Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:153](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/solid-router-bridge.ts#L153)
+Defined in: [packages/play-solid-router/src/solid-router-bridge.ts:153](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/solid-router-bridge.ts#L153)
 
 Subscribe to SolidJS Router location changes using createEffect.
 

package/api/@xmachines/play-solid-router/functions/PlayRouterProvider.md

@@ -6,7 +6,34 @@
 function PlayRouterProvider<TActor>(props): any;
 ```
 
-Defined in: [packages/play-solid-router/src/play-router-provider.tsx:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid-router/src/play-router-provider.tsx#L41)
+Defined in: [packages/play-solid-router/src/play-router-provider.tsx:76](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid-router/src/play-router-provider.tsx#L76)
+
+Connects a `PlayerActor` to Solid Router, keeping actor state and browser URL
+in sync bidirectionally.
+
+The bridge is created synchronously at component evaluation time (Solid's
+execution model) and torn down via `onCleanup` when the component is disposed.
+Unlike React, prop stability is not a concern — Solid's `props` accessor is
+already reactive and the bridge is created once per component instance.
+
+The `router` prop must be obtained from Solid Router hooks in the parent component:
+
+```tsx
+function AppShell() {
+	const navigate = useNavigate();
+	const location = useLocation();
+	const params = useParams();
+
+	return (
+		<PlayRouterProvider
+			actor={actor}
+			routeMap={routeMap}
+			router={{ navigate, location, params }}
+			renderer={(a) => <PlayRenderer actor={a} registry={registry} />}
+		/>
+	);
+}
+```
 
 ## Type Parameters
 

package/api/@xmachines/play-solid-router/functions/createRouteMap.md

@@ -6,7 +6,7 @@
 function createRouteMap(machine): RouteMap;
 ```
 
-Defined in: [packages/play-router/src/create-route-map-from-machine.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-router/src/create-route-map-from-machine.ts#L26)
+Defined in: [packages/play-router/src/create-route-map-from-machine.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/create-route-map-from-machine.ts#L26)
 
 Create a `BaseRouteMap` from an XState state machine.