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

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

@@ -22,7 +22,7 @@ npm install @xmachines/play-svelte
 
 ```svelte
 <script lang="ts">
-	import { PlayRenderer, defineRegistry } from "@xmachines/play-svelte";
+	import { PlayUIProvider, PlayRenderer, defineRegistry } from "@xmachines/play-svelte";
 	import { defineCatalog, schema } from "@json-render/core";
 	import { z } from "zod";
 	import Login from "./Login.svelte";
@@ -50,86 +50,201 @@ npm install @xmachines/play-svelte
 	});
 </script>
 
-<PlayRenderer actor={actor} {registryResult} />
+<PlayUIProvider {actor} {registryResult}>
+	<PlayRenderer />
+</PlayUIProvider>
 ```
 
+## Primary Exports
+
+- `PlayUIProvider` — batteries-included composite provider (wraps `ActorProvider` + `JSONUIProvider`); pass `actor` and `registryResult` here
+- `ActorProvider` — escape hatch primitive for direct control over actor bridging and store lifecycle
+- `PlayRenderer` — zero-prop leaf; renders inside a `PlayUIProvider` or `ActorProvider` tree
+- `getActorContext()` — Svelte equivalent of `useActor()`; access the actor from inside a component rendered in the provider tree
+- `getPlayViewContext()` — access the current view spec (`PlaySpec`) from inside the provider tree
+
 ## Re-exports
 
 This package re-exports from `@json-render/svelte`:
 
-- `defineRegistry` — wire Svelte components into the Play catalog
+- `defineRegistry` — wire Svelte components into the Play catalog (with catalog-typed action params — see below)
 - `getBoundProp` — two-way reactive binding helper for form inputs
 
-Types: `BaseComponentProps`, `ComponentFn`, `ComponentContext`
+Types: `BaseComponentProps`, `ComponentFn`, `ComponentContext`, `RenderErrorHandler`
 
 For anything else (`schema`, `Renderer`, `JsonUIProvider`, context helpers), import from `@json-render/svelte` directly.
 
-## PlayRenderer behavior
+## PlayUIProvider / PlayRenderer behavior
 
-- `PlayRenderer` watches `actor.currentView` and rerenders when the active view changes.
+- `PlayUIProvider` owns actor bridging, signal observation, and store lifecycle. `PlayRenderer` is a zero-prop leaf that renders inside the provider tree.
+- `PlayRenderer` watches `actor.currentView` (via provider context) and rerenders when the active view changes.
 - Action handlers are defined as async functions in `defineRegistry({ actions: { login: async (params) => actor.send(...) } })` and bundled in `registryResult`. There is no `actions` prop on `PlayRenderer`.
-- If you do not pass a `store`, `PlayRenderer` creates an internal `@xstate/store` atom from `view.spec.state`.
-- If you do pass a `store`, that external store wins and no internal store is created for the view.
+- If you do not pass a `store` to `PlayUIProvider`, it creates an internal `@xstate/store` atom from `view.spec.state`.
+- If you do pass a `store` to `PlayUIProvider`, that external store wins and no internal store is created for the view.
 
 ## Error handling
 
-`PlayRenderer` wraps its content in a Svelte 5 `<svelte:boundary>`. Two props control error behavior:
+The provider tree has two layers of error boundaries:
+
+### Outer boundary — `onError` and `fallback`
 
-- **`fallback`** — a Svelte snippet rendered when `currentView` is `null` (no active view) or when a catalog component throws during render.
-- **`onError`** — a callback invoked when a catalog component throws. Receives the error and a `reset` function that clears the boundary and attempts to re-render.
+Wraps the entire renderer. Triggered when the spec state or store setup throws, or when the inner boundary is not present. These props are passed to `PlayUIProvider` (or `ActorProvider`).
+
+- **`fallback`** — a Svelte snippet rendered when `currentView` is `null` or when the outer boundary catches an error.
+- **`onError`** — called when the outer boundary catches an error. Receives the error and a `reset` callback.
 
 ```svelte
-<PlayRenderer
+<PlayUIProvider
   {actor}
   {registryResult}
   fallback={errorSnippet}
   onError={(error, reset) => {
-    console.error("Render error:", error);
-    // Optionally attempt recovery:
-    // reset();
+    console.error("Outer render error:", error);
+    // reset(); // attempt recovery
+  }}
+>
+  <PlayRenderer />
+</PlayUIProvider>
+```
+
+### Inner boundary — `onRenderError`
+
+Each catalog element rendered by `@json-render/svelte` is individually wrapped in a `<svelte:boundary>`. When an element component throws, the failed component is silently removed from the DOM while the rest of the spec continues rendering. The outer `onError` / `fallback` are **not** triggered.
+
+Pass `onRenderError` to `PlayUIProvider` (or `ActorProvider`) — overrides any registry-level handler — or bake it into `defineRegistry`. `PlayRenderer` no longer accepts this prop.
+
+```svelte
+<!-- via PlayUIProvider prop -->
+<PlayUIProvider
+  {actor}
+  {registryResult}
+  onRenderError={(error, elementType) => {
+    console.warn(`<${elementType}> crashed:`, error);
+    reportToSentry(error, { component: elementType });
   }}
-/>
+>
+  <PlayRenderer />
+</PlayUIProvider>
+```
+
+```ts
+// via defineRegistry — bakes the handler into the registry
+const registryResult = defineRegistry(catalog, {
+  components: { Login, Dashboard },
+  actions: { ... },
+  onRenderError(error, elementType) {
+    myErrorReporter.capture(error, { elementType });
+  },
+});
 ```
 
-`onError` is optional. When omitted, render errors are silently caught by the boundary and `fallback` is shown if provided. The `reset` parameter follows Svelte 5's `<svelte:boundary onerror>` contract.
+When both are provided, the `PlayUIProvider` prop wins — it creates a fresh registry copy with its own handler for that render.
+
+`onRenderError` is typed as `RenderErrorHandler` and exported from `@xmachines/play-svelte`.
 
 @xmachines/play-svelte - Svelte renderer for XMachines Play architecture
 
-Provides a thin Svelte rendering layer that passively observes actor signals
-and renders UI components via @json-render/svelte. Svelte reactivity is only
-used to trigger re-renders — signals are the source of truth.
+Provides a provider/renderer split that mirrors @json-render/svelte patterns:
+
+- ActorProvider: primitive escape-hatch (owns actor lifecycle, signal subscription,
+  per-view StateStore, onRenderError injection)
+- PlayUIProvider: batteries-included composite (ActorProvider + JsonUIProvider)
+- PlayRenderer: zero-prop leaf — reads getPlayViewContext() and renders Renderer
 
-Re-exports `defineRegistry` (catalog-typed — action params are inferred from
-the catalog schema), `getBoundProp`, `BaseComponentProps`, and `ComponentFn`
-from `@json-render/svelte` so consumers import everything from
-`@xmachines/play-svelte` rather than `@json-render/svelte` directly.
+Re-exports primitives from @json-render/svelte so consumers import everything
+from @xmachines/play-svelte rather than @json-render/svelte directly.
 
 ## Interfaces
 
+- [ActorProviderProps](interfaces/ActorProviderProps.md)
 - [BaseComponentProps](interfaces/BaseComponentProps.md)
 - [ComponentContext](interfaces/ComponentContext.md)
 - [DefineRegistryOptions](interfaces/DefineRegistryOptions.md)
-- [PlayRendererProps](interfaces/PlayRendererProps.md)
+- [ViewContextValue](interfaces/ViewContextValue.md)
 
 ## Type Aliases
 
 - [ActionFn](type-aliases/ActionFn.md)
 - [Actions](type-aliases/Actions.md)
 - [ComponentFn](type-aliases/ComponentFn.md)
+- [PlayActor](type-aliases/PlayActor.md)
 - [PlayRenderer](type-aliases/PlayRenderer.md)
+- [RenderErrorHandler](type-aliases/RenderErrorHandler.md)
 - [SetState](type-aliases/SetState.md)
 
 ## Variables
 
-- [getBoundProp](variables/getBoundProp.md)
 - [PlayRenderer](variables/PlayRenderer.md)
 
 ## Functions
 
 - [defineRegistry](functions/defineRegistry.md)
+- [getActorContext](functions/getActorContext.md)
+- [getPlayViewContext](functions/getPlayViewContext.md)
+- [setActorContext](functions/setActorContext.md)
 
 ## References
 
+### ActionProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### ActorProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### getBoundProp
+
+Renames and re-exports [RenderErrorHandler](type-aliases/RenderErrorHandler.md)
+
+---
+
 ### getStateValue
 
-Renames and re-exports [getBoundProp](variables/getBoundProp.md)
+Renames and re-exports [RenderErrorHandler](type-aliases/RenderErrorHandler.md)
+
+---
+
+### JsonUIProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### JSONUIProviderProps
+
+Renames and re-exports [RenderErrorHandler](type-aliases/RenderErrorHandler.md)
+
+---
+
+### PlayUIProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### Renderer
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### StateProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### ValidationProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)
+
+---
+
+### VisibilityProvider
+
+Renames and re-exports [PlayRenderer](variables/PlayRenderer.md)

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

@@ -6,7 +6,7 @@
 function defineRegistry<C>(catalog, options): DefineRegistryResult;
 ```
 
-Defined in: [packages/play-svelte/src/define-registry.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/define-registry.ts#L125)
+Defined in: [packages/play-svelte/src/define-registry.ts:153](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/define-registry.ts#L153)
 
 Create a component registry, restoring catalog-typed `params` on action handlers.
 

package/api/@xmachines/play-svelte/functions/getActorContext.md

@@ -0,0 +1,21 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / getActorContext
+
+# Function: getActorContext()
+
+```ts
+function getActorContext(): PlayActor;
+```
+
+Defined in: [packages/play-svelte/src/actor-context.svelte.ts:37](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L37)
+
+Get the actor from the nearest ActorProvider ancestor.
+
+Renamed from useActor() to match @json-render/svelte's get\*Context() convention (D-07).
+
+## Returns
+
+[`PlayActor`](../type-aliases/PlayActor.md)
+
+## Throws
+
+if called outside <ActorProvider> or <PlayUIProvider>

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

@@ -0,0 +1,19 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / getPlayViewContext
+
+# Function: getPlayViewContext()
+
+```ts
+function getPlayViewContext(): ViewContextValue;
+```
+
+Defined in: [packages/play-svelte/src/actor-context.svelte.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L58)
+
+Get the current view context from the nearest ActorProvider ancestor.
+
+## Returns
+
+[`ViewContextValue`](../interfaces/ViewContextValue.md)
+
+## Throws
+
+if called outside <ActorProvider> or <PlayUIProvider>

package/api/@xmachines/play-svelte/functions/setActorContext.md

@@ -0,0 +1,19 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / setActorContext
+
+# Function: setActorContext()
+
+```ts
+function setActorContext(actor): void;
+```
+
+Defined in: [packages/play-svelte/src/actor-context.svelte.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L27)
+
+## Parameters
+
+| Parameter | Type                                        |
+| --------- | ------------------------------------------- |
+| `actor`   | [`PlayActor`](../type-aliases/PlayActor.md) |
+
+## Returns
+
+`void`

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

@@ -0,0 +1,40 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / ActorProviderProps
+
+# Interface: ActorProviderProps
+
+Defined in: [packages/play-svelte/src/actor-context.svelte.ts:67](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L67)
+
+Framework-agnostic base props shared by every `ActorProvider` implementation
+(React, Vue, Solid, Svelte). `TRegistry` captures the framework-specific
+`DefineRegistryResult` type; `RenderErrorHandler` is sourced from
+`@json-render/core` so no second generic is needed.
+
+Framework packages extend this with their `fallback`, `onError`, and `children` fields.
+
+## Example
+
+```ts
+import type { BaseActorProviderProps } from "@xmachines/play-actor";
+import type { DefineRegistryResult } from "@json-render/react";
+
+interface ActorProviderProps extends BaseActorProviderProps<DefineRegistryResult> {
+	fallback?: React.ReactNode;
+	children: React.ReactNode;
+}
+```
+
+## Extends
+
+- [`BaseActorProviderProps`](../../play-actor/interfaces/BaseActorProviderProps.md)\<`DefineRegistryResult`\>
+
+## 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-children"></a> `children`             | `Snippet`                                                                                                                                                                                                                                                        | -                                                                                                                                                                                                                           | -                                                                                                                                                                                   | [packages/play-svelte/src/actor-context.svelte.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L70) |
+| <a id="property-fallback"></a> `fallback?`            | `Snippet`\<\[\]\>                                                                                                                                                                                                                                                | -                                                                                                                                                                                                                           | -                                                                                                                                                                                   | [packages/play-svelte/src/actor-context.svelte.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L68) |
+| <a id="property-onerror"></a> `onError?`              | (`error`, `reset`) => `void`                                                                                                                                                                                                                                     | -                                                                                                                                                                                                                           | -                                                                                                                                                                                   | [packages/play-svelte/src/actor-context.svelte.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L69) |
+| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../../play-dom/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`                                                                                                                                                                                                                                           | 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-svelte/interfaces/DefineRegistryOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: DefineRegistryOptions\<C\>
 
-Defined in: [packages/play-svelte/src/define-registry.ts:89](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/define-registry.ts#L89)
+Defined in: [packages/play-svelte/src/define-registry.ts:92](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/define-registry.ts#L92)
 
 Options for `defineRegistry`.
 
@@ -17,7 +17,8 @@ Mirrors the upstream shape but replaces the untyped
 
 ## Properties
 
-| Property                                       | Type                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                        | Defined in                                                                                                                                                           |
-| ---------------------------------------------- | ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actions"></a> `actions?`       | [`Actions`](../type-aliases/Actions.md)\<`C`\> | Catalog-typed action handler map. Each handler receives `params` typed to the exact schema defined in the catalog action (or `undefined` if no params were provided), plus the upstream `setState` and `state` arguments. Guard against `undefined` before accessing params: **Example** `actions: { login: async (params) => { if (!params) return; actor.send({ type: "auth.login", username: params.username }); }, logout: async () => actor.send({ type: "auth.logout" }), }` | [packages/play-svelte/src/define-registry.ts:113](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/define-registry.ts#L113) |
-| <a id="property-components"></a> `components?` | `Components`\<`C`\>                            | Svelte component implementations — keyed by catalog component name.                                                                                                                                                                                                                                                                                                                                                                                                                | [packages/play-svelte/src/define-registry.ts:93](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/define-registry.ts#L93)   |
+| Property                                             | Type                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | Defined in                                                                                                                                                           |
+| ---------------------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-actions"></a> `actions?`             | [`Actions`](../type-aliases/Actions.md)\<`C`\> | Catalog-typed action handler map. Each handler receives `params` typed to the exact schema defined in the catalog action (or `undefined` if no params were provided), plus the upstream `setState` and `state` arguments. Guard against `undefined` before accessing params: **Example** `actions: { login: async (params) => { if (!params) return; actor.send({ type: "auth.login", username: params.username }); }, logout: async () => actor.send({ type: "auth.logout" }), }`                                                                                                                                                                                                                                                                                                                                                                              | [packages/play-svelte/src/define-registry.ts:116](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/define-registry.ts#L116) |
+| <a id="property-components"></a> `components?`       | `Components`\<`C`\>                            | Svelte component implementations — keyed by catalog component name.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | [packages/play-svelte/src/define-registry.ts:96](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/define-registry.ts#L96)   |
+| <a id="property-onrendererror"></a> `onRenderError?` | `any`                                          | Callback invoked when a catalog component throws during render. The error is caught by `@json-render/svelte`'s inner `<svelte:boundary>` that wraps each rendered element. When provided, this callback replaces the default `console.error(...)` fallback — the component is silently removed from the DOM and your callback receives the error and the element type name for custom error reporting or recovery logic. **Example** `const { registry, handlers } = defineRegistry(authCatalog, { components: { Login, Dashboard }, actions: { ... }, onRenderError(error, elementType) { console.warn(`Component <${elementType}> crashed:`, error); reportToSentry(error, { componentType: elementType }); }, });` **Param** The thrown value (not necessarily an `Error` instance). **Param** The catalog component name that crashed (e.g. `"Dashboard"`). | [packages/play-svelte/src/define-registry.ts:141](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/define-registry.ts#L141) |

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

@@ -0,0 +1,24 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / ViewContextValue
+
+# Interface: ViewContextValue
+
+Defined in: [packages/play-svelte/src/actor-context.svelte.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L46)
+
+Framework-agnostic base for every framework's `ViewContextValue`.
+
+Holds the three fields that are identical across React, Vue, Solid, and Svelte.
+`registry` is framework-specific (each framework has its own `ComponentRegistry`
+type) so it is typed via `TRegistry` — the same generic used in `BaseActorProviderProps`.
+
+## 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-svelte/type-aliases/PlayActor.md

@@ -0,0 +1,9 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / PlayActor
+
+# Type Alias: PlayActor
+
+```ts
+type PlayActor = AbstractActor<AnyActorLogic> & Viewable;
+```
+
+Defined in: [packages/play-svelte/src/actor-context.svelte.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte/src/actor-context.svelte.ts#L21)

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

@@ -0,0 +1,7 @@
+[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / RenderErrorHandler
+
+# Type Alias: RenderErrorHandler
+
+```ts
+type RenderErrorHandler = any;
+```

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

@@ -2,7 +2,7 @@
 
 # Class: RouteMap
 
-Defined in: [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)
+Defined in: [play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/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: [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)
+Defined in: [play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/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: [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)
+Defined in: [play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/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: [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)
+Defined in: [play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/base-route-map.ts#L174)
 
 Resolve a URL path to its mapped state ID.
 

package/api/@xmachines/play-svelte-spa-router/functions/connectRouter.md

@@ -6,7 +6,7 @@
 function connectRouter(options): () => void;
 ```
 
-Defined in: [play-svelte-spa-router/src/connect-router.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte-spa-router/src/connect-router.ts#L30)
+Defined in: [play-svelte-spa-router/src/connect-router.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte-spa-router/src/connect-router.ts#L30)
 
 Connect svelte-spa-router to actor.
 

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

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

package/api/@xmachines/play-svelte-spa-router/interfaces/ConnectRouterOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: ConnectRouterOptions
 
-Defined in: [play-svelte-spa-router/src/connect-router.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte-spa-router/src/connect-router.ts#L7)
+Defined in: [play-svelte-spa-router/src/connect-router.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte-spa-router/src/connect-router.ts#L7)
 
 @xmachines/play-svelte-spa-router
 
@@ -12,6 +12,6 @@ Svelte SPA router adapter for XMachines Play architecture.
 
 | Property                                  | Modifier   | Type                                                                                                                                                                                                                                                             | Description                                                                                                                              | Defined in                                                                                                                                                                    |
 | ----------------------------------------- | ---------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`       | `readonly` | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Routable`](../../play-actor/interfaces/Routable.md) | -                                                                                                                                        | [play-svelte-spa-router/src/connect-router.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte-spa-router/src/connect-router.ts#L8)   |
-| <a id="property-routemap"></a> `routeMap` | `readonly` | [`RouteMap`](../classes/RouteMap.md)                                                                                                                                                                                                                             | -                                                                                                                                        | [play-svelte-spa-router/src/connect-router.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte-spa-router/src/connect-router.ts#L9)   |
-| <a id="property-window"></a> `window?`    | `readonly` | [`WindowLike`](WindowLike.md)                                                                                                                                                                                                                                    | Window-like object for `hashchange` subscriptions. Defaults to the global `window`. Pass a mock in tests or a no-op in SSR environments. | [play-svelte-spa-router/src/connect-router.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte-spa-router/src/connect-router.ts#L14) |
+| <a id="property-actor"></a> `actor`       | `readonly` | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<[`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic), [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Routable`](../../play-actor/interfaces/Routable.md) | -                                                                                                                                        | [play-svelte-spa-router/src/connect-router.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte-spa-router/src/connect-router.ts#L8)   |
+| <a id="property-routemap"></a> `routeMap` | `readonly` | [`RouteMap`](../classes/RouteMap.md)                                                                                                                                                                                                                             | -                                                                                                                                        | [play-svelte-spa-router/src/connect-router.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte-spa-router/src/connect-router.ts#L9)   |
+| <a id="property-window"></a> `window?`    | `readonly` | [`WindowLike`](WindowLike.md)                                                                                                                                                                                                                                    | Window-like object for `hashchange` subscriptions. Defaults to the global `window`. Pass a mock in tests or a no-op in SSR environments. | [play-svelte-spa-router/src/connect-router.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-svelte-spa-router/src/connect-router.ts#L14) |

package/api/@xmachines/play-svelte-spa-router/interfaces/PlayRouteEvent.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayRouteEvent
 
-Defined in: [play-router/src/types.ts:223](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L223)
+Defined in: [play-router/src/types.ts:223](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L223)
 
 Enhanced routing event with parameter and query support
 
@@ -112,8 +112,8 @@ URLPatternResult for advanced use cases (debugging, pattern analysis).
 
 | Property                               | Modifier   | Type                           | Defined in                                                                                                                              |
 | -------------------------------------- | ---------- | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-match"></a> `match?`   | `readonly` | `unknown`                      | [play-router/src/types.ts:228](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L228) |
-| <a id="property-params"></a> `params?` | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:226](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L226) |
-| <a id="property-query"></a> `query?`   | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:227](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L227) |
-| <a id="property-to"></a> `to`          | `readonly` | `string`                       | [play-router/src/types.ts:225](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L225) |
-| <a id="property-type"></a> `type`      | `readonly` | `"play.route"`                 | [play-router/src/types.ts:224](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L224) |
+| <a id="property-match"></a> `match?`   | `readonly` | `unknown`                      | [play-router/src/types.ts:228](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L228) |
+| <a id="property-params"></a> `params?` | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:226](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L226) |
+| <a id="property-query"></a> `query?`   | `readonly` | `Record`\<`string`, `string`\> | [play-router/src/types.ts:227](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L227) |
+| <a id="property-to"></a> `to`          | `readonly` | `string`                       | [play-router/src/types.ts:225](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L225) |
+| <a id="property-type"></a> `type`      | `readonly` | `"play.route"`                 | [play-router/src/types.ts:224](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L224) |

package/api/@xmachines/play-svelte-spa-router/interfaces/RouteMapping.md

@@ -2,7 +2,7 @@
 
 # Interface: RouteMapping
 
-Defined in: [play-router/src/base-route-map.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/base-route-map.ts#L57)
+Defined in: [play-router/src/base-route-map.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/base-route-map.ts#L57)
 
 A single state ID ↔ path mapping entry.
 
@@ -23,5 +23,5 @@ const optionalMapping: BaseRouteMapping = { stateId: "settings", path: "/setting
 
 | Property                                | Modifier   | Type     | Description                                                                   | Defined in                                                                                                                                              |
 | --------------------------------------- | ---------- | -------- | ----------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-path"></a> `path`       | `readonly` | `string` | URL path pattern (e.g., `"/"`, `"/profile/:userId"`, `"/settings/:section?"`) | [play-router/src/base-route-map.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/base-route-map.ts#L61) |
-| <a id="property-stateid"></a> `stateId` | `readonly` | `string` | State machine state ID (e.g., `"home"`, `"#profile"`)                         | [play-router/src/base-route-map.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/base-route-map.ts#L59) |
+| <a id="property-path"></a> `path`       | `readonly` | `string` | URL path pattern (e.g., `"/"`, `"/profile/:userId"`, `"/settings/:section?"`) | [play-router/src/base-route-map.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/base-route-map.ts#L61) |
+| <a id="property-stateid"></a> `stateId` | `readonly` | `string` | State machine state ID (e.g., `"home"`, `"#profile"`)                         | [play-router/src/base-route-map.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/base-route-map.ts#L59) |

package/api/@xmachines/play-svelte-spa-router/interfaces/RouterBridge.md

@@ -2,7 +2,7 @@
 
 # Interface: RouterBridge
 
-Defined in: [play-router/src/types.ts:271](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L271)
+Defined in: [play-router/src/types.ts:271](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L271)
 
 RouterBridge interface for runtime infrastructure adapters
 
@@ -54,7 +54,7 @@ class TanStackRouterBridge implements RouterBridge {
 connect(): void | Promise<void>;
 ```
 
-Defined in: [play-router/src/types.ts:287](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L287)
+Defined in: [play-router/src/types.ts:287](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L287)
 
 Connect the router bridge to the Actor
 
@@ -83,7 +83,7 @@ await bridge.connect();
 disconnect(): void | Promise<void>;
 ```
 
-Defined in: [play-router/src/types.ts:303](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-router/src/types.ts#L303)
+Defined in: [play-router/src/types.ts:303](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-router/src/types.ts#L303)
 
 Disconnect the router bridge from the Actor