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

package/rfc/play.md

@@ -156,13 +156,8 @@ export interface PlaySpec extends Spec {
 	contextProps?: string[];
 }
 
-export interface ViewMetadata {
-	component: string;
-	spec: PlaySpec;
-}
-
 export interface Viewable {
-	readonly currentView: Signal.State<ViewMetadata | null>;
+	readonly currentView: Signal.State<PlaySpec | null>;
 }
 
 // The Base Protocol — minimal contract
@@ -231,7 +226,7 @@ class PlayerActor<TMachine extends AnyStateMachine>
 {
 	public state: Signal.State<AnyMachineSnapshot>;
 	public currentRoute: Signal.Computed<string | null>;
-	public currentView: Signal.State<ViewMetadata | null>;
+	public currentView: Signal.State<PlaySpec | null>;
 	public readonly initialRoute: string | null;
 }
 ```
@@ -317,27 +312,44 @@ Each view renderer provides a `PlayRenderer` component that passively observes t
 **`@xmachines/play-react` exports (representative):**
 
 ```ts
-// Main component
-export const PlayRenderer: React.FC<PlayRendererProps> = ({
-  actor,     // AbstractActor & Viewable
-  registry,  // ComponentRegistry from defineRegistry()
-  store?,    // Optional external StateStore (controlled mode)
-  fallback?, // Shown when currentView is null
-  actions?,  // Map of action names → XState event type strings
-}) => { /* ... */ };
+// Batteries-included composite — standard entry point
+// Props: actor, registryResult, store?, fallback?, onError?, onRenderError?,
+//        validationFunctions?, navigate?, functions?
+export { PlayUIProvider } from "./PlayUIProvider";
+export type { PlayUIProviderProps } from "./PlayUIProvider";
+
+// Escape-hatch primitive — owns actor lifecycle, signal bridge, ViewContext
+// Props: actor, registryResult, store?, fallback?, onError?, onRenderError?, children (required)
+export { ActorProvider } from "./ActorProvider";
+export type { ActorProviderProps } from "./ActorProvider";
+
+// Zero-prop leaf — reads usePlayView() from ActorProvider tree; renders <Renderer spec={...} />
+// Must be rendered inside <ActorProvider> or <PlayUIProvider>
+export const PlayRenderer: React.FC = () => {
+	/* ... */
+};
 
 // Hooks
-export { useSignalEffect } from './useSignalEffect';
-export { useActor } from './useActor';
+export { usePlayView } from "./ActorProvider"; // returns ViewContextValue | null
+export { useSignalEffect } from "./useSignalEffect";
+export { useActor } from "./useActor";
 
 // Error handling
-export { PlayErrorBoundary } from './PlayErrorBoundary';
+export { PlayErrorBoundary } from "./PlayErrorBoundary";
 
 // Re-exports from @json-render/react
-export { defineRegistry, useStateBinding, useBoundProp } from '@json-render/react';
+export {
+	defineRegistry,
+	JSONUIProvider,
+	StateProvider,
+	ActionProvider,
+	VisibilityProvider,
+	ValidationProvider,
+	Renderer,
+} from "@json-render/react";
 ```
 
-**Design Rationale:** The original design passed `components: ComponentMap<TCatalog>` and `catalog: Catalog` directly to `PlayRenderer`. The implementation replaced these with a single `registry` (from `defineRegistry`), which bakes catalog validation into the registry at definition time. This eliminates runtime catalog lookups and provides better TypeScript inference.
+**Design Rationale:** `PlayRenderer` is now a **zero-prop leaf component** — it reads view context from the enclosing `ActorProvider` via `usePlayView()`. All mount-time concerns (actor bridging, signal subscription, store lifecycle, `onRenderError` injection) are centralised in `ActorProvider`. `PlayUIProvider` is the batteries-included composite that wraps `ActorProvider` + `JSONUIProvider` with a handler bridge. This mirrors the provider/renderer split in `@json-render/*` and makes the separation of concerns explicit.
 
 ### 5.5 Schema Layer (External)
 
@@ -383,11 +395,17 @@ export const machine = setup({
 		overview: {
 			meta: {
 				route: "/dashboard",
-				view: {
-					type: "Dashboard",
-					props: { title: "Q4 Performance" },
-					children: [{ type: "Metric", props: { value: 100, label: "Sales" } }],
-				},
+				view: typedSpec<DashboardCtx>({
+					root: "root",
+					elements: {
+						root: {
+							type: "Dashboard",
+							props: { title: "Q4 Performance" },
+							children: ["metric"],
+						},
+						metric: { type: "Metric", props: { value: 100, label: "Sales" } },
+					},
+				}),
 			},
 		},
 	},
@@ -404,7 +422,7 @@ Binds Logic to a View Renderer and Router Adapter.
 ```tsx
 import { createDashboard, machine } from "./features/dashboard/player";
 import { catalog } from "./catalog";
-import { PlayRenderer, defineRegistry } from "@xmachines/play-react";
+import { PlayUIProvider, PlayRenderer, defineRegistry } from "@xmachines/play-react";
 import { TanStackReactRouterBridge } from "@xmachines/play-tanstack-react-router";
 import { extractMachineRoutes, createRouteMap } from "@xmachines/play-router";
 
@@ -412,13 +430,18 @@ import { extractMachineRoutes, createRouteMap } from "@xmachines/play-router";
 const actor = createDashboard();
 
 // 2. Define component implementations (type-checked against catalog)
-const registry = defineRegistry(catalog, {
-	Dashboard: ({ props, children }) => <div className="p-4">{children}</div>,
-	Metric: ({ props }) => (
-		<span>
-			{props.label}: {props.value}
-		</span>
-	),
+const registryResult = defineRegistry(catalog, {
+	components: {
+		Dashboard: ({ props, children }) => <div className="p-4">{children}</div>,
+		Metric: ({ props }) => (
+			<span>
+				{props.label}: {props.value}
+			</span>
+		),
+	},
+	actions: {
+		submit: async () => actor.send({ type: "form.submit" }),
+	},
 });
 
 // 3. Build route map from machine definition
@@ -429,9 +452,13 @@ const routeMap = createRouteMap(routeTree);
 const bridge = new TanStackReactRouterBridge(tanstackRouter, actor, routeMap);
 bridge.connect();
 
-// 5. Render
+// 5. Render — PlayUIProvider is the batteries-included composite; PlayRenderer is the zero-prop leaf
 function App() {
-	return <PlayRenderer actor={actor} registry={registry} actions={{ submit: "form.submit" }} />;
+	return (
+		<PlayUIProvider actor={actor} registryResult={registryResult}>
+			<PlayRenderer />
+		</PlayUIProvider>
+	);
 }
 ```
 

package/api/@xmachines/play-actor/interfaces/ViewMetadata.md

@@ -1,17 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-actor](../README.md) / ViewMetadata
-
-# Interface: ViewMetadata
-
-Defined in: [packages/play-actor/src/abstract-actor.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-actor/src/abstract-actor.ts#L100)
-
-View metadata for rendering.
-
-Describes the component to be rendered and the json-render Spec to use.
-Used by PlayRenderer to dynamically render UI based on actor state.
-
-## Properties
-
-| Property                                    | Type                      | Description                                                                                                                                                                                                                                | Defined in                                                                                                                                                       |
-| ------------------------------------------- | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-component"></a> `component` | `string`                  | Root element type name (for diagnostics and component resolution)                                                                                                                                                                          | [packages/play-actor/src/abstract-actor.ts:102](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-actor/src/abstract-actor.ts#L102) |
-| <a id="property-spec"></a> `spec`           | [`PlaySpec`](PlaySpec.md) | XMachines view spec — extends `@json-render/core` Spec with `contextProps` for explicit context field exposure. Use `typedSpec<TContext>(...)` at the definition site to validate `contextProps` entries against the machine context type. | [packages/play-actor/src/abstract-actor.ts:110](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-actor/src/abstract-actor.ts#L110) |

package/api/@xmachines/play-dom/interfaces/DefineRegistryOptions.md

@@ -1,23 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / DefineRegistryOptions
-
-# Interface: DefineRegistryOptions\<C\>
-
-Defined in: [json-render/types.ts:144](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-dom/src/json-render/types.ts#L144)
-
-Options for `defineRegistry`.
-
-Mirrors `DefineRegistryOptions<C>` from @json-render/react, /solid, /svelte, /vue.
-`actions` accepts catalog-typed async handler functions — params are fully typed.
-
-## Type Parameters
-
-| Type Parameter          |
-| ----------------------- |
-| `C` _extends_ `Catalog` |
-
-## Properties
-
-| Property                                       | Type                                                               | Description                                                                                                                                                                                                                                                                                                                                  | Defined in                                                                                                                                   |
-| ---------------------------------------------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actions"></a> `actions?`       | [`Actions`](../type-aliases/Actions.md)\<`C`\>                     | Map of catalog action name → catalog-typed async handler function. Each handler receives params typed to the action's schema (or `undefined`). Guard against undefined before accessing params: **Example** `actions: { login: async (params) => { if (!params) return; actor.send({ type: 'auth.login', username: params.username }); }, }` | [json-render/types.ts:165](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-dom/src/json-render/types.ts#L165) |
-| <a id="property-components"></a> `components?` | [`ComponentRegistry`](../type-aliases/ComponentRegistry.md)\<`C`\> | Catalog-typed component implementations.                                                                                                                                                                                                                                                                                                     | [json-render/types.ts:148](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-dom/src/json-render/types.ts#L148) |

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

@@ -1,23 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps\<TLogic\>
-
-Defined in: [packages/play-react/src/types.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-react/src/types.ts#L27)
-
-Props for PlayRenderer component
-
-## Type Parameters
-
-| Type Parameter                                                                           | Default type                                                          | Description                                                                     |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | The XState actor logic type. Defaults to `AnyActorLogic` for non-generic usage. |
-
-## Properties
-
-| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                       | Defined in                                                                                                                                   |
-| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                             | [packages/play-react/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-react/src/types.ts#L29) |
-| <a id="property-fallback"></a> `fallback?`            | `ReactNode`                                                                                                                                                                                         | Optional component shown when currentView is null                                                                                                                                                                                 | [packages/play-react/src/types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-react/src/types.ts#L60) |
-| <a id="property-onerror"></a> `onError?`              | (`error`, `info`) => `void`                                                                                                                                                                         | Optional callback invoked when a catalog component throws during render.                                                                                                                                                          | [packages/play-react/src/types.ts:72](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-react/src/types.ts#L72) |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() in @json-render/react. Contains both the component registry and the action handlers factory. Action handlers are real async functions dispatching to the actor (not string-mapped event types). | [packages/play-react/src/types.ts:48](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-react/src/types.ts#L48) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | Optional external StateStore (controlled mode).                                                                                                                                                                                   | [packages/play-react/src/types.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-react/src/types.ts#L57) |

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

@@ -1,23 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-solid](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps\<TLogic\>
-
-Defined in: [packages/play-solid/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/types.ts#L26)
-
-Props for PlayRenderer component
-
-## Type Parameters
-
-| Type Parameter                                                                           | Default type                                                          | Description                                                                     |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | The XState actor logic type. Defaults to `AnyActorLogic` for non-generic usage. |
-
-## Properties
-
-| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                   |
-| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/types.ts#L28) |
-| <a id="property-fallback"></a> `fallback?`            | `any`                                                                                                                                                                                               | Optional element shown when currentView is null or a component throws                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/types.ts#L38) |
-| <a id="property-onerror"></a> `onError?`              | (`error`) => `void`                                                                                                                                                                                 | Optional callback invoked when a catalog component throws during render.                                                                                                                                                                                                                                                                                            | [packages/play-solid/src/types.ts:45](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/types.ts#L45) |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() in @json-render/solid. Contains both the component registry and the action handlers factory. Action handlers are real async functions dispatching to the actor (not string-mapped event types).                                                                                                                                   | [packages/play-solid/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/types.ts#L35) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-solid/src/types.ts:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-solid/src/types.ts#L54) |

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

@@ -1,21 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps\<TLogic\>
-
-Defined in: [packages/play-svelte/src/types.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/types.ts#L13)
-
-## Type Parameters
-
-| Type Parameter                                                                           | Default type                                                          |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) |
-
-## Properties
-
-| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                  | Defined in                                                                                                                                     |
-| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | -                                                                                                                                                                                                                                            | [packages/play-svelte/src/types.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/types.ts#L14) |
-| <a id="property-fallback"></a> `fallback?`            | `Snippet`\<\[\]\>                                                                                                                                                                                   | Svelte snippet rendered when currentView is null (no active view). Also shown when a catalog component throws during render.                                                                                                                 | [packages/play-svelte/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/types.ts#L29) |
-| <a id="property-onerror"></a> `onError?`              | (`error`, `reset`) => `void`                                                                                                                                                                        | Called when a catalog component throws during render. Receives the thrown error and a `reset` function that clears the boundary and attempts to re-render. Matches Svelte 5's `<svelte:boundary onerror>` signature.                         | [packages/play-svelte/src/types.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/types.ts#L36) |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() — contains component registry and action handlers. Action handlers are async functions that dispatch to the actor (not string-mapped event type stubs). Replaces the old `registry` + `actions` prop pair. | [packages/play-svelte/src/types.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/types.ts#L21) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | -                                                                                                                                                                                                                                            | [packages/play-svelte/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-svelte/src/types.ts#L23) |

package/api/@xmachines/play-svelte/variables/getBoundProp.md

@@ -1,7 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-svelte](../README.md) / getBoundProp
-
-# Variable: getBoundProp
-
-```ts
-getBoundProp: any;
-```

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

@@ -1,21 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps\<TLogic\>
-
-Defined in: [packages/play-vue/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/types.ts#L23)
-
-Props for PlayRenderer component
-
-## Type Parameters
-
-| Type Parameter                                                                           | Default type                                                          | Description                                                                     |
-| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
-| `TLogic` _extends_ [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | [`AnyActorLogic`](https://www.jsdocs.io/package/xstate#AnyActorLogic) | The XState actor logic type. Defaults to `AnyActorLogic` for non-generic usage. |
-
-## Properties
-
-| Property                                              | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                               |
-| ----------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                                                                               | [packages/play-vue/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/types.ts#L25) |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                                                                                                                                                              | Full result from defineRegistry() in @json-render/vue. Contains both the component registry and the action handlers factory. Action handlers are real async functions dispatching to the actor (not string-mapped event types).                                                                                                                                     | [packages/play-vue/src/types.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/types.ts#L32) |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-vue/src/types.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.32/packages/play-vue/src/types.ts#L41) |