@xmachines/docs 1.0.0-beta.16 → 1.0.0-beta.18

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

@@ -2,7 +2,7 @@
 
 # Interface: Routable
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L41)
+Defined in: [packages/play-actor/src/abstract-actor.ts:42](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L42)
 
 Optional capability: Routing support
 
@@ -24,6 +24,7 @@ function connectRouter<T extends AbstractActor & Routable>(actor: T) {
 
 ## Properties
 
-| Property                                          | Modifier   | Type                                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                          | Defined in                                                                                                                                                     |
-| ------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-currentroute"></a> `currentRoute` | `readonly` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | Current route signal Computed signal derived from state machine. Infrastructure observes to sync browser URL. Invariant: Passive Infrastructure - Infrastructure reflects route, never decides. **Example** `const watcher = new Signal.subtle.Watcher(() => { const route = actor.currentRoute.get(); console.log('Route changed:', route); }); watcher.watch(actor.currentRoute);` | [packages/play-actor/src/abstract-actor.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L58) |
+| Property                                          | Modifier   | Type                                                                                         | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                                     |
+| ------------------------------------------------- | ---------- | -------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-currentroute"></a> `currentRoute` | `readonly` | [`Computed`](../../play-signals/namespaces/Signal/classes/Computed.md)\<`string` \| `null`\> | Current route signal Computed signal derived from state machine. Infrastructure observes to sync browser URL. Invariant: Passive Infrastructure - Infrastructure reflects route, never decides. **Example** `const watcher = new Signal.subtle.Watcher(() => { const route = actor.currentRoute.get(); console.log('Route changed:', route); }); watcher.watch(actor.currentRoute);`                                                                                                | [packages/play-actor/src/abstract-actor.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L59) |
+| <a id="property-initialroute"></a> `initialRoute` | `readonly` | `string` \| `null`                                                                           | The route derived from the machine's **initial** state — fixed at construction and never changes, even after `start()` with a restored snapshot. Router bridges use this to distinguish a deep-link (browser URL differs from the initial route because the user navigated there) from a restore (browser is at the machine's default starting URL while the actor was restored to a different route from a snapshot). `null` when the machine's initial state has no `meta.route`. | [packages/play-actor/src/abstract-actor.ts:71](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L71) |

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

@@ -2,16 +2,16 @@
 
 # Interface: ViewMetadata
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:87](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L87)
+Defined in: [packages/play-actor/src/abstract-actor.ts:131](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L131)
 
 View metadata for rendering
 
-Describes the component to be rendered and the props to pass to it.
+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`                        | Name of the component to render from the catalog | [packages/play-actor/src/abstract-actor.ts:89](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L89) |
-| <a id="property-props"></a> `props`         | `Record`\<`string`, `unknown`\> | Props to pass to the component                   | [packages/play-actor/src/abstract-actor.ts:91](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L91) |
+| 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:133](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L133) |
+| <a id="property-spec"></a> `spec`           | [`PlaySpec`](PlaySpec.md) | XMachines view spec — extends `@json-render/core` Spec with `contextProps` for explicit context field exposure. | [packages/play-actor/src/abstract-actor.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L138) |

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

@@ -2,18 +2,18 @@
 
 # Interface: Viewable
 
-Defined in: [packages/play-actor/src/abstract-actor.ts:102](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L102)
+Defined in: [packages/play-actor/src/abstract-actor.ts:150](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L150)
 
 Actor capability for exposing renderable view state.
 
-`Viewable` marks actors that publish a `currentView` signal plus a component
-catalog. Renderers such as `PlayRenderer` consume this contract to resolve the
+`Viewable` marks actors that publish a `currentView` signal.
+Renderers such as `PlayRenderer` consume this contract to resolve the
 current view description into concrete UI without embedding view logic inside the
-framework adapter.
+framework adapter. Component lookup is handled by the json-render registry
+passed to PlayRenderer, not stored on the actor.
 
 ## Properties
 
-| Property                                        | Modifier   | Type                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                     | Defined in                                                                                                                                                       |
-| ----------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-catalog"></a> `catalog`         | `readonly` | `Record`\<`string`, `unknown`\>                                                                                 | Component catalog for view resolution Maps component names to actual component implementations. Used by renderers to resolve view.component to actual UI components.                                                                                                                                                                                                            | [packages/play-actor/src/abstract-actor.ts:127](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L127) |
-| <a id="property-currentview"></a> `currentView` | `readonly` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<[`ViewMetadata`](ViewMetadata.md) \| `null`\> | Current view signal State signal containing UI structure schema from meta.view. Infrastructure renders view. Invariant: Logic-Driven UI - View structure is defined by business logic, not JSX. **Example** `const watcher = new Signal.subtle.Watcher(() => { const view = actor.currentView.get(); console.log('View changed:', view); }); watcher.watch(actor.currentView);` | [packages/play-actor/src/abstract-actor.ts:119](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.16/packages/play-actor/src/abstract-actor.ts#L119) |
+| Property                                        | Modifier   | Type                                                                                                            | Description                                                                                                                                                                                                                                                                                                                                                                                                   | Defined in                                                                                                                                                       |
+| ----------------------------------------------- | ---------- | --------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-currentview"></a> `currentView` | `readonly` | [`State`](../../play-signals/namespaces/Signal/classes/State.md)\<[`ViewMetadata`](ViewMetadata.md) \| `null`\> | Current view signal State signal containing view.component and view.spec from meta.view. Infrastructure renders view. Invariant: Logic-Driven UI - View structure is defined by business logic, not JSX. **Example** `const watcher = new Signal.subtle.Watcher(() => { const view = actor.currentView.get(); console.log('View changed:', view.component, view.spec); }); watcher.watch(actor.currentView);` | [packages/play-actor/src/abstract-actor.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-actor/src/abstract-actor.ts#L167) |

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

@@ -0,0 +1,36 @@
+[Documentation](../../README.md) / @xmachines/play-dom
+
+# @xmachines/play-dom
+
+@xmachines/play-dom - Vanilla DOM renderer for XMachines Play architecture
+
+Provides a two-layer architecture:
+
+- Inner layer (dom-renderer): Pure json-render-core compatible DOM renderer.
+  Zero XMachines dependencies. Upstreamable to @json-render/dom.
+- Outer layer (PlayRenderer): XMachines wrapper. Bridges actor.currentView
+  (TC39 Signal) to the inner DOM renderer using watchSignal.
+
+Also provides connectRenderer() as a backward-compat convenience function.
+
+No framework required. Pure DOM APIs only.
+
+## Classes
+
+- [PlayRenderer](classes/PlayRenderer.md)
+
+## Interfaces
+
+- [ConnectRendererOptions](interfaces/ConnectRendererOptions.md)
+- [DomRenderContext](interfaces/DomRenderContext.md)
+- [PlayDomOptions](interfaces/PlayDomOptions.md)
+
+## Type Aliases
+
+- [DomComponentRenderer](type-aliases/DomComponentRenderer.md)
+- [DomRegistry](type-aliases/DomRegistry.md)
+
+## Functions
+
+- [connectRenderer](functions/connectRenderer.md)
+- [renderSpec](functions/renderSpec.md)

package/api/@xmachines/play-dom/classes/PlayRenderer.md

@@ -0,0 +1,83 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / PlayRenderer
+
+# Class: PlayRenderer
+
+Defined in: [PlayRenderer.ts:39](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/PlayRenderer.ts#L39)
+
+PlayRenderer connects an actor's currentView signal to the DOM renderer.
+
+Usage:
+
+```typescript
+const renderer = new PlayRenderer(container, actor, registry, { actions: { ... } });
+renderer.connect();
+
+// Controlled mode — bring your own store:
+import { createAtom } from "@xstate/store";
+import { xstateStoreStateStore } from "@json-render/xstate";
+const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
+const renderer = new PlayRenderer(container, actor, registry, { store, actions: { ... } });
+
+// Later:
+renderer.disconnect();
+```
+
+## Constructors
+
+### Constructor
+
+```ts
+new PlayRenderer(
+   container,
+   actor,
+   registry,
+   options?): PlayRenderer;
+```
+
+Defined in: [PlayRenderer.ts:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/PlayRenderer.ts#L50)
+
+#### Parameters
+
+| Parameter   | Type                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                   |
+| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `container` | `HTMLElement`                                                                                                                                                                                                                                                    | The `HTMLElement` to render into. Cleared and repopulated on every view transition.                                                                                                                                           |
+| `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 providing the `currentView` signal (must implement `Viewable`).                                                                                                                                                |
+| `registry`  | [`DomRegistry`](../type-aliases/DomRegistry.md)                                                                                                                                                                                                                  | Map of component type names to `DomComponentRenderer` functions.                                                                                                                                                              |
+| `options`   | [`PlayDomOptions`](../interfaces/PlayDomOptions.md)                                                                                                                                                                                                              | Optional configuration: `actions` map (action name → XState event type) and optional external `store` (controlled mode — when omitted, a fresh `@xstate/store` atom is created per view transition seeded from `spec.state`). |
+
+#### Returns
+
+`PlayRenderer`
+
+## Methods
+
+### connect()
+
+```ts
+connect(): void;
+```
+
+Defined in: [PlayRenderer.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/PlayRenderer.ts#L61)
+
+Start watching actor.currentView and render to container.
+Renders the initial view synchronously, then subscribes to signal changes.
+
+#### Returns
+
+`void`
+
+---
+
+### disconnect()
+
+```ts
+disconnect(): void;
+```
+
+Defined in: [PlayRenderer.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/PlayRenderer.ts#L69)
+
+Stop watching and clear the container.
+
+#### Returns
+
+`void`

package/api/@xmachines/play-dom/functions/connectRenderer.md

@@ -0,0 +1,51 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / connectRenderer
+
+# Function: connectRenderer()
+
+```ts
+function connectRenderer(options): () => void;
+```
+
+Defined in: [connect-renderer.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/connect-renderer.ts#L46)
+
+Connect a signal-driven DOM renderer to an actor's currentView signal.
+
+Subscribes to `actor.currentView` via TC39 Signals and renders `DomComponentRenderer`
+functions into the provided `container` element on every state change.
+
+- Renders the initial view immediately (synchronous)
+- Re-renders when `actor.currentView` signal changes (via microtask)
+- Clears container when view is `null` (optionally appends fallback)
+
+## Parameters
+
+| Parameter | Type                                                                | Description            |
+| --------- | ------------------------------------------------------------------- | ---------------------- |
+| `options` | [`ConnectRendererOptions`](../interfaces/ConnectRendererOptions.md) | ConnectRendererOptions |
+
+## Returns
+
+A cleanup function that stops all DOM mutations
+
+() => `void`
+
+## Example
+
+```typescript
+import { connectRenderer, type DomComponentRenderer } from "@xmachines/play-dom";
+
+const unwatch = connectRenderer({
+	actor,
+	registry: {
+		Home: (element, ctx) => {
+			const el = document.createElement("div");
+			el.textContent = element.props.title as string;
+			return el;
+		},
+	},
+	container: document.getElementById("app")!,
+});
+
+// Later: stop watching
+unwatch();
+```

package/api/@xmachines/play-dom/functions/renderSpec.md

@@ -0,0 +1,28 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / renderSpec
+
+# Function: renderSpec()
+
+```ts
+function renderSpec(spec, store, registry, send, actor, actorActions): Node | null;
+```
+
+Defined in: [dom-renderer.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/dom-renderer.ts#L26)
+
+Render a Spec tree into DOM nodes using the provided DomRegistry.
+
+## Parameters
+
+| Parameter      | Type                                                                                                                                                                                                                                                             | Description                                                               |
+| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `spec`         | `Spec`                                                                                                                                                                                                                                                           | The json-render Spec describing the UI tree                               |
+| `store`        | `StateStore`                                                                                                                                                                                                                                                     | StateStore holding the current state values                               |
+| `registry`     | [`DomRegistry`](../type-aliases/DomRegistry.md)                                                                                                                                                                                                                  | Map of element type names to DomComponentRenderer functions               |
+| `send`         | (`event`) => `void`                                                                                                                                                                                                                                              | Function to dispatch XState events from UI interactions                   |
+| `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) | Raw actor — available to DOM components for state reading, complex events |
+| `actorActions` | `Record`\<`string`, `string`\>                                                                                                                                                                                                                                   | Map of json-render action names → XState event types                      |
+
+## Returns
+
+`Node` \| `null`
+
+The root DOM node, or null if root element is invisible or unknown

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

@@ -0,0 +1,18 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / ConnectRendererOptions
+
+# Interface: ConnectRendererOptions
+
+Defined in: [types.ts:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L63)
+
+Options for connectRenderer() — backward compat API.
+
+## Properties
+
+| Property                                    | Type                                                                                                                                                                                                                                                             | Description                                                                                                                                                                                                                                                   | Defined in                                                                                                         |
+| ------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| <a id="property-actions"></a> `actions?`    | `Record`\<`string`, `string`\>                                                                                                                                                                                                                                   | Map of json-render actionName → XState event type                                                                                                                                                                                                             | [types.ts:77](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L77) |
+| <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)                                                                                                                                                                                         | [types.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L65) |
+| <a id="property-container"></a> `container` | `HTMLElement`                                                                                                                                                                                                                                                    | Container element to render into                                                                                                                                                                                                                              | [types.ts:71](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L71) |
+| <a id="property-fallback"></a> `fallback?`  | `HTMLElement` \| `null`                                                                                                                                                                                                                                          | Optional element shown when currentView is null (defaults to nothing — clears container)                                                                                                                                                                      | [types.ts:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L74) |
+| <a id="property-registry"></a> `registry`   | [`DomRegistry`](../type-aliases/DomRegistry.md)                                                                                                                                                                                                                  | Registry of component renderers — replaces old `components` map                                                                                                                                                                                               | [types.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L68) |
+| <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. When omitted, a fresh @xstate/store atom is created internally per view transition. | [types.ts:84](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L84) |

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

@@ -0,0 +1,18 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / DomRenderContext
+
+# Interface: DomRenderContext
+
+Defined in: [types.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L14)
+
+Context passed to each DomComponentRenderer when rendering an element.
+
+## Properties
+
+| Property                                              | Type                                                                                                                                                                                                                                                             | Description                                                                            | 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) | Raw actor — access from any DOM component for state reading, complex events, lifecycle | [types.ts:22](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L22) |
+| <a id="property-actoractions"></a> `actorActions`     | `Record`\<`string`, `string`\>                                                                                                                                                                                                                                   | Map of json-render action names → XState event types                                   | [types.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L24) |
+| <a id="property-renderchildren"></a> `renderChildren` | (`keys`) => `Node`[]                                                                                                                                                                                                                                             | Recursively render child elements by key                                               | [types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L26) |
+| <a id="property-send"></a> `send`                     | (`event`) => `void`                                                                                                                                                                                                                                              | Send an event to the actor                                                             | [types.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L20) |
+| <a id="property-spec"></a> `spec`                     | `Spec`                                                                                                                                                                                                                                                           | Full spec tree                                                                         | [types.ts:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L16) |
+| <a id="property-store"></a> `store`                   | `StateStore`                                                                                                                                                                                                                                                     | State store bound to spec.state                                                        | [types.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L18) |

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

@@ -0,0 +1,14 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / PlayDomOptions
+
+# Interface: PlayDomOptions
+
+Defined in: [types.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L46)
+
+Options for PlayRenderer.
+
+## Properties
+
+| Property                                 | Type                           | Description                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                         |
+| ---------------------------------------- | ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| <a id="property-actions"></a> `actions?` | `Record`\<`string`, `string`\> | Map of json-render actionName → XState event type                                                                                                                                                                                                                                                                                                                   | [types.ts:48](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L48) |
+| <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. | [types.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L57) |

package/api/@xmachines/play-dom/type-aliases/DomComponentRenderer.md

@@ -0,0 +1,23 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / DomComponentRenderer
+
+# Type Alias: DomComponentRenderer
+
+```ts
+type DomComponentRenderer = (element, ctx) => HTMLElement | Text | null;
+```
+
+Defined in: [types.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L33)
+
+Pure DOM component renderer — receives a UIElement + context and returns a DOM node.
+No framework required. Return null for unknown/unsupported elements.
+
+## Parameters
+
+| Parameter | Type                                                    |
+| --------- | ------------------------------------------------------- |
+| `element` | `UIElement`                                             |
+| `ctx`     | [`DomRenderContext`](../interfaces/DomRenderContext.md) |
+
+## Returns
+
+`HTMLElement` \| `Text` \| `null`

package/api/@xmachines/play-dom/type-aliases/DomRegistry.md

@@ -0,0 +1,11 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom](../README.md) / DomRegistry
+
+# Type Alias: DomRegistry
+
+```ts
+type DomRegistry = Record<string, DomComponentRenderer>;
+```
+
+Defined in: [types.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.18/packages/play-dom/src/types.ts#L41)
+
+Registry of component renderers keyed by element type.