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

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

@@ -0,0 +1,30 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / ActorProviderProps
+
+# Interface: ActorProviderProps
+
+Defined in: [packages/play-solid/src/ActorProvider.tsx:83](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L83)
+
+Props for ActorProvider — the escape hatch primitive.
+
+For batteries-included usage, prefer PlayUIProvider which wraps ActorProvider
+with JSONUIProvider and all required sub-providers.
+
+## Extends
+
+- [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md)\<[`DefineRegistryResult`](DefineRegistryResult.md)\>
+
+## Extended by
+
+- [`PlayUIProviderProps`](PlayUIProviderProps.md)
+
+## Properties
+
+| Property                                              | Type                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                 | Inherited from                                                                                                                                                                      | Defined in                                                                                                                                                       |
+| ----------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability).                                                                                                                                                      | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`actor`](../../play-actor/interfaces/BaseActorProviderProps.md#property-actor)                   | [packages/play-actor/src/abstract-actor.ts:154](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L154) |
+| <a id="property-children"></a> `children`             | `any`                                                                                                                                                                                                                                                            | Children — required; must include <PlayRenderer /> (or use PlayUIProvider shorthand)                                                                                                                                        | -                                                                                                                                                                                   | [packages/play-solid/src/ActorProvider.tsx:91](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L91)   |
+| <a id="property-fallback"></a> `fallback?`            | `any`                                                                                                                                                                                                                                                            | Optional fallback element shown when currentView is null or ErrorBoundary catches                                                                                                                                           | -                                                                                                                                                                                   | [packages/play-solid/src/ActorProvider.tsx:85](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L85)   |
+| <a id="property-onerror"></a> `onError?`              | (`error`) => `void`                                                                                                                                                                                                                                              | Optional callback invoked when SolidJS ErrorBoundary catches an error                                                                                                                                                       | -                                                                                                                                                                                   | [packages/play-solid/src/ActorProvider.tsx:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L88)   |
+| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                                                                                    | Called when an individual catalog component throws during render. Takes precedence over any onRenderError set via defineRegistry.                                                                                           | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`onRenderError`](../../play-actor/interfaces/BaseActorProviderProps.md#property-onrendererror)   | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L167) |
+| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](DefineRegistryResult.md)                                                                                                                                                                                                                | Full result from defineRegistry() — contains the component registry and action handlers factory.                                                                                                                            | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`registryResult`](../../play-actor/interfaces/BaseActorProviderProps.md#property-registryresult) | [packages/play-actor/src/abstract-actor.ts:156](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L156) |
+| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                                                                                     | Optional external StateStore (controlled mode). When provided, spec.state is ignored and this store is the single source of truth. When omitted, a fresh @xstate/store atom is created per view transition from spec.state. | [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md).[`store`](../../play-actor/interfaces/BaseActorProviderProps.md#property-store)                   | [packages/play-actor/src/abstract-actor.ts:162](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L162) |

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

@@ -0,0 +1,15 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / DefineRegistryResult
+
+# Interface: DefineRegistryResult
+
+Defined in: `@json-render/solid`
+
+Result returned by defineRegistry
+
+## Properties
+
+| Property                                            | Type                                                                                   | Description                                                                                                                                         | Defined in |
+| --------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| <a id="property-executeaction"></a> `executeAction` | (`actionName`, `params`, `setState`, `state?`) => `Promise`\<`void`\>                  | Execute an action by name imperatively (for use outside the Solid tree, e.g. initial state loading).                                                | -          |
+| <a id="property-handlers"></a> `handlers`           | (`getSetState`, `getState`) => `Record`\<`string`, (`params`) => `Promise`\<`void`\>\> | Create ActionProvider-compatible handlers. Accepts getter functions so handlers always read the latest state/setState (e.g. from refs or closures). | -          |
+| <a id="property-registry"></a> `registry`           | [`ComponentRegistry`](../type-aliases/ComponentRegistry.md)                            | Component registry for `<Renderer registry={...} />`                                                                                                | -          |

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

@@ -0,0 +1,21 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / JSONUIProviderProps
+
+# Interface: JSONUIProviderProps
+
+Defined in: `@json-render/solid`
+
+Props for JSONUIProvider
+
+## Properties
+
+| Property                                                         | Type                                                        | Description                                                                                      | Defined in |
+| ---------------------------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ---------- |
+| <a id="property-children"></a> `children`                        | `any`                                                       | -                                                                                                | -          |
+| <a id="property-functions"></a> `functions?`                     | `Record`\<`string`, `ComputedFunction`\>                    | Named functions for `$computed` expressions in props                                             | -          |
+| <a id="property-handlers"></a> `handlers?`                       | `Record`\<`string`, (`params`) => `unknown`\>               | Action handlers                                                                                  | -          |
+| <a id="property-initialstate"></a> `initialState?`               | `Record`\<`string`, `unknown`\>                             | Initial state model (uncontrolled mode)                                                          | -          |
+| <a id="property-navigate"></a> `navigate?`                       | (`path`) => `void`                                          | Navigation function                                                                              | -          |
+| <a id="property-onstatechange"></a> `onStateChange?`             | (`changes`) => `void`                                       | Callback when state changes (uncontrolled mode)                                                  | -          |
+| <a id="property-registry"></a> `registry`                        | [`ComponentRegistry`](../type-aliases/ComponentRegistry.md) | Component registry                                                                               | -          |
+| <a id="property-store"></a> `store?`                             | `StateStore`                                                | External store (controlled mode). When provided, `initialState` and `onStateChange` are ignored. | -          |
+| <a id="property-validationfunctions"></a> `validationFunctions?` | `Record`\<`string`, (`value`, `args?`) => `boolean`\>       | Custom validation functions                                                                      | -          |

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

@@ -0,0 +1,26 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / PlayUIProviderProps
+
+# Interface: PlayUIProviderProps
+
+Defined in: [packages/play-solid/src/PlayUIProvider.tsx:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/PlayUIProvider.tsx#L36)
+
+Props for PlayUIProvider — all ActorProvider props plus JSONUIProvider's forwarded props.
+
+## Extends
+
+- [`ActorProviderProps`](ActorProviderProps.md).`Partial`\<`JSONUIForwardedProps`\>
+
+## Properties
+
+| Property                                                         | Type                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                 | Inherited from                                                                                                               | Defined in                                                                                                                                                       |
+| ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-actor"></a> `actor`                              | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability).                                                                                                                                                      | [`ActorProviderProps`](ActorProviderProps.md).[`actor`](ActorProviderProps.md#property-actor)                                | [packages/play-actor/src/abstract-actor.ts:154](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L154) |
+| <a id="property-children"></a> `children`                        | `any`                                                                                                                                                                                                                                                            | Children — required; must include <PlayRenderer /> (or use PlayUIProvider shorthand)                                                                                                                                        | [`ActorProviderProps`](ActorProviderProps.md).[`children`](ActorProviderProps.md#property-children)                          | [packages/play-solid/src/ActorProvider.tsx:91](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L91)   |
+| <a id="property-fallback"></a> `fallback?`                       | `any`                                                                                                                                                                                                                                                            | Optional fallback element shown when currentView is null or ErrorBoundary catches                                                                                                                                           | [`ActorProviderProps`](ActorProviderProps.md).[`fallback`](ActorProviderProps.md#property-fallback)                          | [packages/play-solid/src/ActorProvider.tsx:85](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L85)   |
+| <a id="property-functions"></a> `functions?`                     | `Record`\<`string`, `ComputedFunction`\>                                                                                                                                                                                                                         | Named functions for `$computed` expressions in props                                                                                                                                                                        | [`JSONUIProviderProps`](JSONUIProviderProps.md).[`functions`](JSONUIProviderProps.md#property-functions)                     | -                                                                                                                                                                |
+| <a id="property-navigate"></a> `navigate?`                       | (`path`) => `void`                                                                                                                                                                                                                                               | Navigation function                                                                                                                                                                                                         | [`JSONUIProviderProps`](JSONUIProviderProps.md).[`navigate`](JSONUIProviderProps.md#property-navigate)                       | -                                                                                                                                                                |
+| <a id="property-onerror"></a> `onError?`                         | (`error`) => `void`                                                                                                                                                                                                                                              | Optional callback invoked when SolidJS ErrorBoundary catches an error                                                                                                                                                       | [`ActorProviderProps`](ActorProviderProps.md).[`onError`](ActorProviderProps.md#property-onerror)                            | [packages/play-solid/src/ActorProvider.tsx:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L88)   |
+| <a id="property-onrendererror"></a> `onRenderError?`             | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)                                                                                                                                                                                                    | Called when an individual catalog component throws during render. Takes precedence over any onRenderError set via defineRegistry.                                                                                           | [`ActorProviderProps`](ActorProviderProps.md).[`onRenderError`](ActorProviderProps.md#property-onrendererror)                | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L167) |
+| <a id="property-registryresult"></a> `registryResult`            | [`DefineRegistryResult`](DefineRegistryResult.md)                                                                                                                                                                                                                | Full result from defineRegistry() — contains the component registry and action handlers factory.                                                                                                                            | [`ActorProviderProps`](ActorProviderProps.md).[`registryResult`](ActorProviderProps.md#property-registryresult)              | [packages/play-actor/src/abstract-actor.ts:156](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L156) |
+| <a id="property-store"></a> `store?`                             | `StateStore`                                                                                                                                                                                                                                                     | Optional external StateStore (controlled mode). When provided, spec.state is ignored and this store is the single source of truth. When omitted, a fresh @xstate/store atom is created per view transition from spec.state. | [`ActorProviderProps`](ActorProviderProps.md).[`store`](ActorProviderProps.md#property-store)                                | [packages/play-actor/src/abstract-actor.ts:162](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L162) |
+| <a id="property-validationfunctions"></a> `validationFunctions?` | `Record`\<`string`, (`value`, `args?`) => `boolean`\>                                                                                                                                                                                                            | Custom validation functions                                                                                                                                                                                                 | [`JSONUIProviderProps`](JSONUIProviderProps.md).[`validationFunctions`](JSONUIProviderProps.md#property-validationfunctions) | -                                                                                                                                                                |

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

@@ -0,0 +1,17 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / RendererProps
+
+# Interface: RendererProps
+
+Defined in: `@json-render/solid`
+
+Props for the Renderer component
+
+## Properties
+
+| Property                                             | Type                                                        | Description                                                     | Defined in |
+| ---------------------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------- | ---------- |
+| <a id="property-fallback"></a> `fallback?`           | `ComponentRenderer`\<`Record`\<`string`, `unknown`\>\>      | Fallback component for unknown types                            | -          |
+| <a id="property-loading"></a> `loading?`             | `boolean`                                                   | Whether the spec is currently loading/streaming                 | -          |
+| <a id="property-onrendererror"></a> `onRenderError?` | `any`                                                       | Callback for element render errors caught by the inner boundary | -          |
+| <a id="property-registry"></a> `registry`            | [`ComponentRegistry`](../type-aliases/ComponentRegistry.md) | Component registry                                              | -          |
+| <a id="property-spec"></a> `spec`                    | `Spec` \| `null`                                            | The UI spec to render                                           | -          |

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

@@ -0,0 +1,13 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / StateProviderProps
+
+# Interface: StateProviderProps
+
+Defined in: `@json-render/solid`
+
+## Properties
+
+| Property                                             | Type                  | Defined in |
+| ---------------------------------------------------- | --------------------- | ---------- |
+| <a id="property-initialstate"></a> `initialState?`   | `StateModel`          | -          |
+| <a id="property-onstatechange"></a> `onStateChange?` | (`changes`) => `void` | -          |
+| <a id="property-store"></a> `store?`                 | `StateStore`          | -          |

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

@@ -0,0 +1,11 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / ValidationProviderProps
+
+# Interface: ValidationProviderProps
+
+Defined in: `@json-render/solid`
+
+## Properties
+
+| Property                                                 | Type                                       | Defined in |
+| -------------------------------------------------------- | ------------------------------------------ | ---------- |
+| <a id="property-customfunctions"></a> `customFunctions?` | `Record`\<`string`, `ValidationFunction`\> | -          |

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

@@ -0,0 +1,21 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / ViewContextValue
+
+# Interface: ViewContextValue
+
+Defined in: [packages/play-solid/src/ActorProvider.tsx:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L50)
+
+Value provided by ActorProvider's ViewContext.
+Access via usePlayView() inside the ActorProvider tree.
+
+## Extends
+
+- [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md)\<[`ComponentRegistry`](../type-aliases/ComponentRegistry.md)\>
+
+## Properties
+
+| Property                                  | Type                                                        | Description                                                                                               | Inherited from                                                                                                                                                    | Defined in                                                                                                                                                       |
+| ----------------------------------------- | ----------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-handlers"></a> `handlers` | `Record`\<`string`, `ActionHandler`\>                       | Action handlers resolved against the live StateStore.                                                     | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`handlers`](../../play-actor/interfaces/BaseViewContextValue.md#property-handlers) | [packages/play-actor/src/abstract-actor.ts:122](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L122) |
+| <a id="property-registry"></a> `registry` | [`ComponentRegistry`](../type-aliases/ComponentRegistry.md) | Component registry from registryResult.registry.                                                          | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`registry`](../../play-actor/interfaces/BaseViewContextValue.md#property-registry) | [packages/play-actor/src/abstract-actor.ts:124](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L124) |
+| <a id="property-spec"></a> `spec`         | [`PlaySpec`](../../play-actor/interfaces/PlaySpec.md)       | The current PlaySpec to render.                                                                           | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`spec`](../../play-actor/interfaces/BaseViewContextValue.md#property-spec)         | [packages/play-actor/src/abstract-actor.ts:120](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L120) |
+| <a id="property-store"></a> `store`       | `StateStore`                                                | The active StateStore — pass to JSONUIProvider/JsonUIProvider as `store` to share state across providers. | [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md).[`store`](../../play-actor/interfaces/BaseViewContextValue.md#property-store)       | [packages/play-actor/src/abstract-actor.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-actor/src/abstract-actor.ts#L126) |

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

@@ -0,0 +1,17 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / ComponentRegistry
+
+# Type Alias: ComponentRegistry
+
+```ts
+type ComponentRegistry = Record<string, ComponentRenderer<any>> & object;
+```
+
+Defined in: `@json-render/solid`
+
+Registry of component renderers
+
+## Type Declaration
+
+| Name             | Type                 | Defined in |
+| ---------------- | -------------------- | ---------- |
+| `onRenderError?` | `RenderErrorHandler` | -          |

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.33/packages/play-solid/src/useActor.ts#L26)
+Defined in: [packages/play-solid/src/useActor.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/useActor.ts#L27)

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

@@ -6,9 +6,10 @@
 type RenderErrorHandler = (error, elementType) => void;
 ```
 
-Defined in: `@json-render/solid`
+Defined in: `@json-render/core`
 
-Registry of component renderers
+Callback invoked when an individual catalog component throws during render.
+Implemented by each framework renderer's error boundary / error capture mechanism.
 
 ## Parameters
 

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

@@ -0,0 +1,21 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / SetState
+
+# Type Alias: SetState
+
+```ts
+type SetState = (updater) => void;
+```
+
+Defined in: `@json-render/solid`
+
+State setter function for updating application state
+
+## Parameters
+
+| Parameter | Type                                        |
+| --------- | ------------------------------------------- |
+| `updater` | (`prev`) => `Record`\<`string`, `unknown`\> |
+
+## Returns
+
+`void`

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

@@ -0,0 +1,9 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / VisibilityProviderProps
+
+# Type Alias: VisibilityProviderProps
+
+```ts
+type VisibilityProviderProps = ParentProps;
+```
+
+Defined in: `@json-render/solid`

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

@@ -0,0 +1,13 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / ActorContext
+
+# Variable: ActorContext
+
+```ts
+const ActorContext: Context<PlayActor | null>;
+```
+
+Defined in: [packages/play-solid/src/useActor.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/useActor.ts#L34)
+
+SolidJS context for the actor — exported so consumers can use ActorContext.Provider
+directly as an escape hatch (per D-11). The smart ActorProvider component takes
+the name "ActorProvider" and is the recommended entry point.

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

@@ -0,0 +1,27 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / ActorProvider
+
+# Variable: ActorProvider
+
+```ts
+const ActorProvider: Component<ActorProviderProps>;
+```
+
+Defined in: [packages/play-solid/src/ActorProvider.tsx:153](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/ActorProvider.tsx#L153)
+
+Smart ActorProvider component — owns actor bridging, signal subscription,
+StateStore lifecycle, handler resolution, and error boundary.
+
+Per D-11: Replaces the old raw alias `ActorProvider = ActorContext.Provider`.
+Consumers who previously used `<ActorProvider value={actor}>` should now use
+`<ActorContext.Provider value={actor}>` for raw provider access, or migrate to
+this smart component / PlayUIProvider.
+
+## Example
+
+```tsx
+import { ActorProvider, PlayRenderer } from "@xmachines/play-solid";
+
+<ActorProvider actor={myActor} registryResult={registryResult}>
+	<PlayRenderer />
+</ActorProvider>;
+```

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

@@ -3,25 +3,12 @@
 # Variable: PlayRenderer
 
 ```ts
-const PlayRenderer: Component<PlayRendererProps>;
+const PlayRenderer: Component;
 ```
 
-Defined in: [packages/play-solid/src/PlayRenderer.tsx:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/packages/play-solid/src/PlayRenderer.tsx#L74)
+Defined in: [packages/play-solid/src/PlayRenderer.tsx:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/PlayRenderer.tsx#L27)
 
-Main renderer component that subscribes to actor signals and renders UI
+Zero-prop leaf renderer. Must be placed inside an ActorProvider or PlayUIProvider tree.
 
-Architecture:
-
-- Subscribes to actor.currentView signal via TC39 Signal.subtle.Watcher
-- 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.
-- Wraps the render path in a SolidJS `ErrorBoundary` to contain catalog component
-  render failures. The `fallback` prop is shown on error; `onError` is called for
-  observability forwarding (Sentry, Datadog, etc.).
-
-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.
+Reads ViewContextValue (spec, handlers, registry) from the enclosing provider
+via usePlayView() and renders the spec via @json-render/solid's Renderer.

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

@@ -0,0 +1,26 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / PlayUIProvider
+
+# Variable: PlayUIProvider
+
+```ts
+const PlayUIProvider: Component<PlayUIProviderProps>;
+```
+
+Defined in: [packages/play-solid/src/PlayUIProvider.tsx:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.35/packages/play-solid/src/PlayUIProvider.tsx#L82)
+
+Batteries-included composite provider: ActorProvider + JSONUIProvider.
+
+Provides the full JSON render context stack:
+
+- ActorContext (actor instance via ActorProvider)
+- ViewContext (spec, handlers, registry via ActorProvider)
+- StateProvider + ActionProvider + VisibilityProvider + ValidationProvider (via JSONUIProvider)
+- ConfirmDialogManager (via JSONUIProvider)
+
+## Example
+
+```tsx
+<PlayUIProvider actor={myActor} registryResult={registryResult} navigate={navigate}>
+	<PlayRenderer />
+</PlayUIProvider>
+```

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,11 +2,11 @@
 
 # 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.33/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.35/packages/play-router/src/base-route-map.ts#L100)
 
 Shared bidirectional route map base class.
 
-All framework adapter `RouteMap` classes extend this — they add no logic of their
+All framework adapters use this class as their route map — they add no logic of their
 own and inherit the full public API from here.
 
 **Lookup strategy:**
@@ -25,9 +25,9 @@ own and inherit the full public API from here.
 ## Example
 
 ```typescript
-import { BaseRouteMap } from "@xmachines/play-router";
+import { RouteMap } from "@xmachines/play-router";
 
-const map = new BaseRouteMap([
+const map = new RouteMap([
 	{ stateId: "home", path: "/" },
 	{ stateId: "profile", path: "/profile/:userId" },
 	{ stateId: "settings", path: "/settings/:section?" },
@@ -47,10 +47,10 @@ map.getPathByStateId("missing"); // null
 ### Constructor
 
 ```ts
-new RouteMap(mappings, options?): BaseRouteMap;
+new RouteMap(mappings, options?): RouteMap;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.33/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.35/packages/play-router/src/base-route-map.ts#L125)
 
 Build a route map from an array of state ID ↔ path mappings.
 
@@ -68,7 +68,7 @@ buckets for efficient candidate selection.
 
 #### Returns
 
-`BaseRouteMap`
+`RouteMap`
 
 ## Methods
 
@@ -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.33/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.35/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.33/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.35/packages/play-router/src/base-route-map.ts#L174)
 
 Resolve a URL path to its mapped state ID.