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

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

@@ -41,7 +41,12 @@ without muting console output.
 - `useBoundProp` — re-exported from `@json-render/vue`
 - `ComponentFn` (type) — re-exported from `@json-render/vue`
 - `ComponentContext` (type) — re-exported from `@json-render/vue`
-- `PlayRendererProps` (type)
+- `ActorProvider` — escape hatch primitive (owns actor bridging, signal bridge, store lifecycle)
+- `PlayUIProvider` — batteries-included composite (wraps `ActorProvider` + `JSONUIProvider`)
+- `getPlayViewContext` — composable for accessing the current view spec inside a provider tree
+- `RenderErrorHandler` (type) — inner per-element error callback signature
+- `ActorProviderProps` (type)
+- `ViewContextValue` (type)
 - `PlayActor` (type)
 
 ## Quick Start
@@ -133,12 +138,9 @@ export const machine = setup({
 				meta: {
 					route: "/login",
 					view: {
-						component: "Login",
-						spec: {
-							root: "root",
-							elements: {
-								root: { type: "Login", props: { title: "Sign In" }, children: [] },
-							},
+						root: "root",
+						elements: {
+							root: { type: "Login", props: { title: "Sign In" }, children: [] },
 						},
 					},
 				},
@@ -148,12 +150,9 @@ export const machine = setup({
 				meta: {
 					route: "/dashboard",
 					view: {
-						component: "Dashboard",
-						spec: {
-							root: "root",
-							elements: {
-								root: { type: "Dashboard", props: { username: "" }, children: [] },
-							},
+						root: "root",
+						elements: {
+							root: { type: "Dashboard", props: { username: "" }, children: [] },
 						},
 					},
 				},
@@ -179,7 +178,7 @@ export const machine = setup({
 <!-- App.vue -->
 <script setup lang="ts">
 import { definePlayer } from "@xmachines/play-xstate";
-import { PlayRenderer } from "@xmachines/play-vue";
+import { PlayUIProvider, PlayRenderer } from "@xmachines/play-vue";
 import { machine } from "./machine.js";
 import { registryResult } from "./registry.js";
 
@@ -189,27 +188,34 @@ actor.start();
 </script>
 
 <template>
-	<PlayRenderer :actor="actor" :registryResult="registryResult" />
+	<PlayUIProvider :actor="actor" :registryResult="registryResult">
+		<PlayRenderer />
+	</PlayUIProvider>
 </template>
 ```
 
 ## API Reference
 
-### `PlayRenderer`
+### `PlayUIProvider`
 
-Main Vue component. Subscribes to `actor.currentView` and renders the spec.
+Batteries-included composite provider. Wraps `ActorProvider` + `JSONUIProvider`. Pass `actor` and `registryResult` here, then place `<PlayRenderer />` inside as a zero-prop child.
 
 ```vue
-<PlayRenderer :actor="actor" :registryResult="registryResult" :store="myStore" />
+<PlayUIProvider
+	:actor="actor"
+	:registryResult="registryResult"
+	:store="myStore"
+	:onRenderError="(error, elementType) => console.warn(`<${elementType}> crashed:`, error)"
+>
+	<template #fallback><p>Something went wrong.</p></template>
+	<PlayRenderer />
+</PlayUIProvider>
 ```
 
 **`actor`** — A `PlayerActor` (or any `AbstractActor & Viewable`). Provides the `currentView` signal.
 
 **`registryResult`** — The full `DefineRegistryResult` returned by `defineRegistry(catalog, { components, actions })` from `@xmachines/play-vue`. Pass `.vue` SFCs directly — they are auto-wrapped via `h(SFC, ctx)` so `useBoundProp` and other composables work inside `<script setup>`.
 
-`defineRegistry` also accepts `onRenderError(error, elementType)`, which receives errors
-caught by `@json-render/vue`'s inner element boundary before the default logger is used.
-
 **`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`.
@@ -223,30 +229,86 @@ import type { StateStore } from "@json-render/core";
 const store: StateStore = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
 ```
 
-**Inner render errors** — You can intercept catalog component render failures without
-overriding the outer Vue error boundary:
+```vue
+<PlayUIProvider :actor="actor" :registryResult="registryResult" :store="store">
+	<PlayRenderer />
+</PlayUIProvider>
+```
+
+**`onRenderError`** — Called when an individual catalog component throws during render. Caught by `@json-render/vue`'s inner per-element error boundary — the failed component is silently removed while the rest of the spec continues rendering. When both `onRenderError` on `PlayUIProvider` and on `defineRegistry` are set, the prop wins.
+
+---
+
+### `ActorProvider`
+
+Escape hatch primitive. Owns actor bridging, signal bridge, and store lifecycle. Use this when you need direct control over the provider layer.
+
+```vue
+<ActorProvider :actor="actor" :registryResult="registryResult" :onRenderError="handleError">
+	<!-- your own JSONUIProvider + PlayRenderer tree -->
+</ActorProvider>
+```
+
+---
+
+### `PlayRenderer`
+
+Zero-prop leaf component. Must be rendered inside a `PlayUIProvider` (or `ActorProvider`) tree. Subscribes to `actor.currentView` via context and renders the current spec.
+
+```vue
+<PlayUIProvider :actor="actor" :registryResult="registryResult">
+	<PlayRenderer />
+</PlayUIProvider>
+```
+
+`PlayRenderer` accepts no props — all configuration (`actor`, `registryResult`, `store`, `fallback`, `onRenderError`) is provided by the enclosing `PlayUIProvider` or `ActorProvider`.
+
+## Error handling
+
+The provider tree has two layers of error boundaries:
+
+### Outer boundary — `fallback` slot
+
+Vue's `onErrorCaptured` wraps the entire renderer. Triggered when the spec or store setup throws, or when the inner boundary is not present. Use Vue's built-in `onErrorCaptured` in a parent component for observability.
+
+```vue
+<PlayUIProvider :actor="actor" :registryResult="registryResult">
+	<template #fallback>
+		<p>Something went wrong.</p>
+	</template>
+	<PlayRenderer />
+</PlayUIProvider>
+```
+
+### Inner boundary — `onRenderError`
+
+Each catalog element is individually wrapped in an error boundary by `@json-render/vue`. When a component throws, it is silently removed while the rest of the spec continues rendering. The outer boundary is **not** triggered.
+
+Pass `onRenderError` to `PlayUIProvider` (or `ActorProvider`) — overrides any registry-level handler — or bake it into `defineRegistry`:
+
+```vue
+<!-- via PlayUIProvider prop -->
+<PlayUIProvider
+	:actor="actor"
+	:registryResult="registryResult"
+	:onRenderError="(error, elementType) => console.warn(`<${elementType}> crashed:`, error)"
+>
+	<PlayRenderer />
+</PlayUIProvider>
+```
 
 ```ts
-export const registryResult = defineRegistry(catalog, {
+// via defineRegistry — bakes the handler into the registry
+const registryResult = defineRegistry(catalog, {
 	components: { Login: LoginSFC, Dashboard: DashboardSFC },
-	actions: {
-		login: async (params) => {
-			if (!params) return;
-			actor.send({ type: "auth.login", username: params.username });
-		},
-		logout: async (params) => {
-			actor.send({ type: "auth.logout" });
-		},
-	},
+	actions: { login: async (params) => { ... }, logout: async () => { ... } },
 	onRenderError(error, elementType) {
 		reportExpectedRenderError(error, elementType);
 	},
 });
 ```
 
-```vue
-<PlayRenderer :actor="actor" :registryResult="registryResult" :store="store" />
-```
+`onRenderError` is typed as `RenderErrorHandler` and exported from `@xmachines/play-vue`.
 
 ---
 
@@ -262,7 +324,7 @@ const actor = useActor();
 actor.send({ type: "auth.logout" });
 ```
 
-Throws `"useActor() must be called inside <PlayRenderer>"` if called outside the tree.
+Throws `NonNullableError: "useActor() must be called inside <ActorProvider> (or <PlayUIProvider>)"` if called outside the tree.
 
 ---
 
@@ -295,13 +357,22 @@ and renders UI components via @json-render/vue. Vue reactivity is only used
 to trigger re-renders — signals are the source of truth.
 
 Re-exports `defineRegistry` (SFC-aware — auto-wraps `.vue` SFCs via `h()`),
-`useBoundProp`, `ComponentFn`, and `ComponentContext` so consumers import
-everything from `@xmachines/play-vue` rather than `@json-render/vue` directly.
+`useBoundProp`, `ComponentFn`, `ComponentContext`, and all json-render providers
+so consumers import everything from `@xmachines/play-vue` rather than
+`@json-render/vue` directly.
 
 ## Interfaces
 
+- [ActionProviderProps](interfaces/ActionProviderProps.md)
+- [ActorProviderProps](interfaces/ActorProviderProps.md)
 - [ComponentContext](interfaces/ComponentContext.md)
-- [PlayRendererProps](interfaces/PlayRendererProps.md)
+- [DefineRegistryResult](interfaces/DefineRegistryResult.md)
+- [JSONUIProviderProps](interfaces/JSONUIProviderProps.md)
+- [PlayUIProviderProps](interfaces/PlayUIProviderProps.md)
+- [RendererProps](interfaces/RendererProps.md)
+- [StateProviderProps](interfaces/StateProviderProps.md)
+- [ValidationProviderProps](interfaces/ValidationProviderProps.md)
+- [ViewContextValue](interfaces/ViewContextValue.md)
 
 ## Type Aliases
 
@@ -310,13 +381,39 @@ everything from `@xmachines/play-vue` rather than `@json-render/vue` directly.
 - [ComponentsMap](type-aliases/ComponentsMap.md)
 - [DefineRegistryOptions](type-aliases/DefineRegistryOptions.md)
 - [PlayActor](type-aliases/PlayActor.md)
+- [RenderErrorHandler](type-aliases/RenderErrorHandler.md)
 
 ## Variables
 
+- [ActionProvider](variables/ActionProvider.md)
+- [JSONUIProvider](variables/JSONUIProvider.md)
 - [PlayRenderer](variables/PlayRenderer.md)
+- [Renderer](variables/Renderer.md)
+- [StateProvider](variables/StateProvider.md)
+- [ValidationProvider](variables/ValidationProvider.md)
+- [VisibilityProvider](variables/VisibilityProvider.md)
 
 ## Functions
 
 - [defineRegistry](functions/defineRegistry.md)
+- [getPlayViewContext](functions/getPlayViewContext.md)
 - [useActor](functions/useActor.md)
 - [useBoundProp](functions/useBoundProp.md)
+
+## References
+
+### ActorProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### PlayUIProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### RenderErrorHandler
+
+Re-exports [RenderErrorHandler](type-aliases/RenderErrorHandler.md)

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

@@ -6,7 +6,7 @@
 function defineRegistry<C>(catalog, options): DefineRegistryResult;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:122](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/define-registry.ts#L122)
+Defined in: [packages/play-vue/src/define-registry.ts:122](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/define-registry.ts#L122)
 
 Create a component registry, automatically wrapping `.vue` SFCs so they work
 correctly with `@json-render/vue`'s rendering pipeline.
@@ -29,4 +29,4 @@ Drop-in replacement for `defineRegistry` from `@json-render/vue`. Import from
 
 ## Returns
 
-`DefineRegistryResult`
+[`DefineRegistryResult`](../interfaces/DefineRegistryResult.md)

package/api/@xmachines/play-vue/functions/getPlayViewContext.md

@@ -0,0 +1,28 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / getPlayViewContext
+
+# Function: getPlayViewContext()
+
+```ts
+function getPlayViewContext(): ViewContextValue;
+```
+
+Defined in: [packages/play-vue/src/actor-provider-context.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/actor-provider-context.ts#L44)
+
+Access the current ViewContextValue from inside an ActorProvider tree.
+
+## Returns
+
+[`ViewContextValue`](../interfaces/ViewContextValue.md)
+
+## Throws
+
+If called outside an <ActorProvider> (or <PlayUIProvider>) tree
+
+## Example
+
+```typescript
+import { getPlayViewContext } from "@xmachines/play-vue";
+
+const view = getPlayViewContext();
+// view.spec, view.handlers, view.registry
+```

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

@@ -6,7 +6,7 @@
 function useActor(): PlayActor;
 ```
 
-Defined in: [packages/play-vue/src/useActor.ts:43](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/useActor.ts#L43)
+Defined in: [packages/play-vue/src/useActor.ts:43](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/useActor.ts#L43)
 
 ## Returns
 

package/api/@xmachines/play-vue/interfaces/ActionProviderProps.md

@@ -0,0 +1,12 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ActionProviderProps
+
+# Interface: ActionProviderProps
+
+Defined in: `@json-render/vue`
+
+## Properties
+
+| Property                                   | Type                                  | Defined in |
+| ------------------------------------------ | ------------------------------------- | ---------- |
+| <a id="property-handlers"></a> `handlers?` | `Record`\<`string`, `ActionHandler`\> | -          |
+| <a id="property-navigate"></a> `navigate?` | (`path`) => `void`                    | -          |

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

@@ -0,0 +1,25 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ActorProviderProps
+
+# Interface: ActorProviderProps
+
+Defined in: [packages/play-vue/src/types.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/types.ts#L14)
+
+Props for the ActorProvider component.
+Extracted to types.ts so TypeScript can re-export without the vue-shim limitation.
+
+## 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.34/packages/play-actor/src/abstract-actor.ts#L154) |
+| <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.34/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.34/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.34/packages/play-actor/src/abstract-actor.ts#L162) |

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

@@ -0,0 +1,15 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / DefineRegistryResult
+
+# Interface: DefineRegistryResult
+
+Defined in: `@json-render/vue`
+
+Result returned by defineRegistry
+
+## Properties
+
+| Property                                            | Type                                                                                   | Defined in |
+| --------------------------------------------------- | -------------------------------------------------------------------------------------- | ---------- |
+| <a id="property-executeaction"></a> `executeAction` | (`actionName`, `params`, `setState`, `state?`) => `Promise`\<`void`\>                  | -          |
+| <a id="property-handlers"></a> `handlers`           | (`getSetState`, `getState`) => `Record`\<`string`, (`params`) => `Promise`\<`void`\>\> | -          |
+| <a id="property-registry"></a> `registry`           | `ComponentRegistry`                                                                    | -          |

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

@@ -0,0 +1,20 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / JSONUIProviderProps
+
+# Interface: JSONUIProviderProps
+
+Defined in: `@json-render/vue`
+
+Props for JSONUIProvider
+
+## Properties
+
+| Property                                                         | Type                                                  | Description                                          | Defined in |
+| ---------------------------------------------------------------- | ----------------------------------------------------- | ---------------------------------------------------- | ---------- |
+| <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`\>         | -                                                    | -          |
+| <a id="property-initialstate"></a> `initialState?`               | `Record`\<`string`, `unknown`\>                       | -                                                    | -          |
+| <a id="property-navigate"></a> `navigate?`                       | (`path`) => `void`                                    | -                                                    | -          |
+| <a id="property-onstatechange"></a> `onStateChange?`             | (`changes`) => `void`                                 | -                                                    | -          |
+| <a id="property-registry"></a> `registry`                        | `ComponentRegistry`                                   | -                                                    | -          |
+| <a id="property-store"></a> `store?`                             | `StateStore`                                          | -                                                    | -          |
+| <a id="property-validationfunctions"></a> `validationFunctions?` | `Record`\<`string`, (`value`, `args?`) => `boolean`\> | -                                                    | -          |

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

@@ -0,0 +1,24 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayUIProviderProps
+
+# Interface: PlayUIProviderProps
+
+Defined in: [packages/play-vue/src/types.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/types.ts#L21)
+
+Props for the ActorProvider component.
+Extracted to types.ts so TypeScript can re-export without the vue-shim limitation.
+
+## Extends
+
+- [`ActorProviderProps`](ActorProviderProps.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).                                                                                                                                                      | [`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.34/packages/play-actor/src/abstract-actor.ts#L154) |
+| <a id="property-functions"></a> `functions?`                     | `Record`\<`string`, (`args?`, `state?`) => `unknown`\>                                                                                                                                                                                                           | Named functions for $computed expressions in props                                                                                                                                                                          | -                                                                                                               | [packages/play-vue/src/types.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/types.ts#L27)                         |
+| <a id="property-navigate"></a> `navigate?`                       | (`path`) => `void`                                                                                                                                                                                                                                               | Navigate function forwarded to JSONUIProvider for link resolution                                                                                                                                                           | -                                                                                                               | [packages/play-vue/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/types.ts#L23)                         |
+| <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.34/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.34/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.34/packages/play-actor/src/abstract-actor.ts#L162) |
+| <a id="property-validationfunctions"></a> `validationFunctions?` | `Record`\<`string`, (`value`, `args?`) => `boolean`\>                                                                                                                                                                                                            | Validation functions forwarded to JSONUIProvider                                                                                                                                                                            | -                                                                                                               | [packages/play-vue/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/types.ts#L25)                         |

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

@@ -0,0 +1,17 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / RendererProps
+
+# Interface: RendererProps
+
+Defined in: `@json-render/vue`
+
+Props for the Renderer component
+
+## Properties
+
+| Property                                             | Type                | Description                                                     | Defined in |
+| ---------------------------------------------------- | ------------------- | --------------------------------------------------------------- | ---------- |
+| <a id="property-fallback"></a> `fallback?`           | `Component`         | -                                                               | -          |
+| <a id="property-loading"></a> `loading?`             | `boolean`           | -                                                               | -          |
+| <a id="property-onrendererror"></a> `onRenderError?` | `any`               | Callback for element render errors caught by the inner boundary | -          |
+| <a id="property-registry"></a> `registry`            | `ComponentRegistry` | -                                                               | -          |
+| <a id="property-spec"></a> `spec`                    | `Spec` \| `null`    | -                                                               | -          |

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

@@ -0,0 +1,15 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / StateProviderProps
+
+# Interface: StateProviderProps
+
+Defined in: `@json-render/vue`
+
+Props for StateProvider
+
+## Properties
+
+| Property                                             | Type                  | Description                                                                                                                                                                                   | Defined in |
+| ---------------------------------------------------- | --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| <a id="property-initialstate"></a> `initialState?`   | `StateModel`          | Initial state model (used only in uncontrolled mode)                                                                                                                                          | -          |
+| <a id="property-onstatechange"></a> `onStateChange?` | (`changes`) => `void` | Callback when state changes (used only in uncontrolled mode). Called once per `set` or `update` with all changed entries.                                                                     | -          |
+| <a id="property-store"></a> `store?`                 | `StateStore`          | External store that owns the state. When provided, the provider operates in **controlled mode** — `initialState` and `onStateChange` are ignored and the store is the single source of truth. | -          |

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

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

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

@@ -0,0 +1,21 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / ViewContextValue
+
+# Interface: ViewContextValue
+
+Defined in: [packages/play-vue/src/actor-provider-context.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/actor-provider-context.ts#L21)
+
+Context value provided by ActorProvider and consumed by PlayRenderer (zero-prop leaf).
+Accessible via getPlayViewContext() inside any ActorProvider/PlayUIProvider tree.
+
+## Extends
+
+- [`BaseViewContextValue`](../../play-actor/interfaces/BaseViewContextValue.md)\<`ComponentRegistry`\>
+
+## 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.34/packages/play-actor/src/abstract-actor.ts#L122) |
+| <a id="property-registry"></a> `registry` | `ComponentRegistry`                                   | 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.34/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.34/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.34/packages/play-actor/src/abstract-actor.ts#L126) |

package/api/@xmachines/play-vue/type-aliases/ComponentEntry.md

@@ -6,7 +6,7 @@
 type ComponentEntry<C, K> = ComponentFn<C, K> | Component;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:96](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/define-registry.ts#L96)
+Defined in: [packages/play-vue/src/define-registry.ts:96](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/define-registry.ts#L96)
 
 ## Type Parameters
 

package/api/@xmachines/play-vue/type-aliases/ComponentsMap.md

@@ -6,7 +6,7 @@
 type ComponentsMap<C> = { [K in keyof InferCatalogComponents<C>]?: ComponentEntry<C, K> };
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/define-registry.ts#L100)
+Defined in: [packages/play-vue/src/define-registry.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/define-registry.ts#L100)
 
 ## Type Parameters
 

package/api/@xmachines/play-vue/type-aliases/DefineRegistryOptions.md

@@ -7,13 +7,13 @@ type DefineRegistryOptions<C> = Omit<Parameters<typeof defineRegistryBase>[1], "
 	object;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:104](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/define-registry.ts#L104)
+Defined in: [packages/play-vue/src/define-registry.ts:104](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/define-registry.ts#L104)
 
 ## Type Declaration
 
 | Name          | Type                                       | Defined in                                                                                                                                                     |
 | ------------- | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `components?` | [`ComponentsMap`](ComponentsMap.md)\<`C`\> | [packages/play-vue/src/define-registry.ts:108](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/define-registry.ts#L108) |
+| `components?` | [`ComponentsMap`](ComponentsMap.md)\<`C`\> | [packages/play-vue/src/define-registry.ts:108](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-vue/src/define-registry.ts#L108) |
 
 ## Type Parameters
 

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

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

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

@@ -0,0 +1,23 @@
+[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / RenderErrorHandler
+
+# Type Alias: RenderErrorHandler
+
+```ts
+type RenderErrorHandler = (error, elementType) => void;
+```
+
+Defined in: `@json-render/core`
+
+Callback invoked when an individual catalog component throws during render.
+Implemented by each framework renderer's error boundary / error capture mechanism.
+
+## Parameters
+
+| Parameter     | Type      |
+| ------------- | --------- |
+| `error`       | `unknown` |
+| `elementType` | `string`  |
+
+## Returns
+
+`void`