@xmachines/docs 1.0.0-beta.15 → 1.0.0-beta.17

package/api/@xmachines/play-react/classes/PlayErrorBoundary.md

@@ -2,7 +2,7 @@
 
 # Class: PlayErrorBoundary
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L49)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L50)
 
 React class component error boundary for catching catalog component render errors.
 
@@ -32,7 +32,7 @@ Per CONS-14: Class component pattern works with all React versions (18 and 19).
 new PlayErrorBoundary(props): PlayErrorBoundary;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L53)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L54)
 
 #### Parameters
 
@@ -55,13 +55,13 @@ React.Component<
 
 ## Properties
 
-| Property                                         | Modifier   | Type               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Inherited from                | Defined in                               |
-| ------------------------------------------------ | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | ---------------------------------------- |
-| <a id="property-context"></a> `context`          | `public`   | `unknown`          | If using React Context, re-declare this in your class to be the `React.ContextType` of your `static contextType`. Should be used with type annotation or static contextType. **Example** `static contextType = MyContext // For TS pre-3.7: context!: React.ContextType<typeof MyContext> // For TS 3.7 and above: declare context: React.ContextType<typeof MyContext>` **See** [React Docs](https://react.dev/reference/react/Component#context)                                         | `React.Component.context`     | node_modules/@types/react/index.d.ts:955 |
-| <a id="property-props"></a> `props`              | `readonly` | `Readonly`\<`P`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.props`       | node_modules/@types/react/index.d.ts:979 |
-| <a id="property-state"></a> `state`              | `public`   | `Readonly`\<`S`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.state`       | node_modules/@types/react/index.d.ts:980 |
-| <a id="property-contexttype"></a> `contextType?` | `static`   | `Context`\<`any`\> | If set, `this.context` will be set at runtime to the current value of the given Context. **Example** `type MyContext = number const Ctx = React.createContext<MyContext>(0) class Foo extends React.Component { static contextType = Ctx context!: React.ContextType<typeof Ctx> render () { return <>My context's value: {this.context}</>; } }` **See** [https://react.dev/reference/react/Component#static-contexttype](https://react.dev/reference/react/Component#static-contexttype) | `React.Component.contextType` | node_modules/@types/react/index.d.ts:931 |
-| <a id="property-proptypes"></a> ~~`propTypes?`~~ | `static`   | `any`              | Ignored by React. **Deprecated** Only kept in types for backwards compatibility. Will be removed in a future major release.                                                                                                                                                                                                                                                                                                                                                                | `React.Component.propTypes`   | node_modules/@types/react/index.d.ts:937 |
+| Property                                         | Modifier   | Type               | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Inherited from                | Defined in |
+| ------------------------------------------------ | ---------- | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------- | ---------- |
+| <a id="property-context"></a> `context`          | `public`   | `unknown`          | If using React Context, re-declare this in your class to be the `React.ContextType` of your `static contextType`. Should be used with type annotation or static contextType. **Example** `static contextType = MyContext // For TS pre-3.7: context!: React.ContextType<typeof MyContext> // For TS 3.7 and above: declare context: React.ContextType<typeof MyContext>` **See** [React Docs](https://react.dev/reference/react/Component#context)                                         | `React.Component.context`     | -          |
+| <a id="property-props"></a> `props`              | `readonly` | `Readonly`\<`P`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.props`       | -          |
+| <a id="property-state"></a> `state`              | `public`   | `Readonly`\<`S`\>  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          | `React.Component.state`       | -          |
+| <a id="property-contexttype"></a> `contextType?` | `static`   | `Context`\<`any`\> | If set, `this.context` will be set at runtime to the current value of the given Context. **Example** `type MyContext = number const Ctx = React.createContext<MyContext>(0) class Foo extends React.Component { static contextType = Ctx context!: React.ContextType<typeof Ctx> render () { return <>My context's value: {this.context}</>; } }` **See** [https://react.dev/reference/react/Component#static-contexttype](https://react.dev/reference/react/Component#static-contexttype) | `React.Component.contextType` | -          |
+| <a id="property-proptypes"></a> ~~`propTypes?`~~ | `static`   | `any`              | Ignored by React. **Deprecated** Only kept in types for backwards compatibility. Will be removed in a future major release.                                                                                                                                                                                                                                                                                                                                                                | `React.Component.propTypes`   | -          |
 
 ## Methods
 
@@ -71,7 +71,7 @@ React.Component<
 componentDidCatch(error, info): void;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:62](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L62)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L63)
 
 Catches exceptions generated in descendant components. Unhandled exceptions will cause
 the entire component tree to unmount.
@@ -101,8 +101,6 @@ React.Component.componentDidCatch;
 optional componentDidMount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1198
-
 Called immediately after a component is mounted. Setting state here will trigger re-rendering.
 
 #### Returns
@@ -126,8 +124,6 @@ optional componentDidUpdate(
    snapshot?): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1261
-
 Called immediately after updating occurs. Not called for the initial render.
 
 The snapshot is only present if [getSnapshotBeforeUpdate](#getsnapshotbeforeupdate) is present and returns non-null.
@@ -158,8 +154,6 @@ React.Component.componentDidUpdate;
 optional componentWillMount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1277
-
 Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
 
@@ -194,8 +188,6 @@ React.Component.componentWillMount;
 optional componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1308
-
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
 props if you only want to handle changes.
@@ -240,8 +232,6 @@ React.Component.componentWillReceiveProps;
 optional componentWillUnmount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1214
-
 Called immediately before a component is destroyed. Perform any necessary cleanup in this method, such as
 cancelled network requests, or cleaning up any DOM elements created in `componentDidMount`.
 
@@ -266,8 +256,6 @@ optional componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1340
-
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
 Note: You cannot call [Component.setState](#setstate) here.
@@ -311,8 +299,6 @@ React.Component.componentWillUpdate;
 forceUpdate(callback?): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:976
-
 #### Parameters
 
 | Parameter   | Type         |
@@ -337,8 +323,6 @@ React.Component.forceUpdate;
 optional getSnapshotBeforeUpdate(prevProps, prevState): any;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1255
-
 Runs before React applies the result of [render](https://www.jsdocs.io/package/@types/react#Component.render) to the document, and
 returns an object to be given to [componentDidUpdate](#componentdidupdate). Useful for saving
 things such as scroll position before [render](https://www.jsdocs.io/package/@types/react#Component.render) causes changes to it.
@@ -371,7 +355,7 @@ React.Component.getSnapshotBeforeUpdate;
 render(): ReactNode;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:67](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L67)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L70)
 
 #### Returns
 
@@ -391,8 +375,6 @@ React.Component.render;
 setState<K>(state, callback?): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:971
-
 #### Type Parameters
 
 | Type Parameter                                                                          |
@@ -427,8 +409,6 @@ optional shouldComponentUpdate(
    nextContext): boolean;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1209
-
 Called to determine whether the change in props and state should trigger a re-render.
 
 `Component` always returns true.
@@ -464,8 +444,6 @@ React.Component.shouldComponentUpdate;
 optional UNSAFE_componentWillMount(): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1292
-
 Called immediately before mounting occurs, and before [Component.render](https://www.jsdocs.io/package/@types/react#Component.render).
 Avoid introducing any side-effects or subscriptions in this method.
 
@@ -502,8 +480,6 @@ React.Component.UNSAFE_componentWillMount;
 optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1326
-
 Called when the component may be receiving new props.
 React may call this even if props have not changed, so be sure to compare new and existing
 props if you only want to handle changes.
@@ -553,8 +529,6 @@ optional UNSAFE_componentWillUpdate(
    nextContext): void;
 ```
 
-Defined in: node_modules/@types/react/index.d.ts:1356
-
 Called immediately before rendering when new props or state is received. Not called for the initial render.
 
 Note: You cannot call [Component.setState](#setstate) here.
@@ -600,7 +574,7 @@ React.Component.UNSAFE_componentWillUpdate;
 static getDerivedStateFromError(error): PlayErrorBoundaryState;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L58)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L59)
 
 #### Parameters
 

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

@@ -0,0 +1,47 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / defineRegistry
+
+# Function: defineRegistry()
+
+```ts
+function defineRegistry<C>(_catalog, options): DefineRegistryResult;
+```
+
+Create a registry from a catalog with components and/or actions.
+
+When the catalog declares actions, the `actions` field is required.
+
+## Type Parameters
+
+| Type Parameter                                                                                                                       |
+| ------------------------------------------------------------------------------------------------------------------------------------ |
+| `C` _extends_ `Catalog`\<`SchemaDefinition`\<`SchemaType`\<`string`, `unknown`\>, `SchemaType`\<`string`, `unknown`\>\>, `unknown`\> |
+
+## Parameters
+
+| Parameter  | Type                           |
+| ---------- | ------------------------------ |
+| `_catalog` | `C`                            |
+| `options`  | `DefineRegistryOptions`\<`C`\> |
+
+## Returns
+
+`DefineRegistryResult`
+
+## Example
+
+```tsx
+// Components only (catalog has no actions)
+const { registry } = defineRegistry(catalog, {
+  components: {
+    Card: ({ props, children }) => (
+      <div className="card">{props.title}{children}</div>
+    ),
+  },
+});
+
+// Both (catalog declares actions)
+const { registry, handlers, executeAction } = defineRegistry(catalog, {
+  components: { ... },
+  actions: { ... },
+});
+```

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

@@ -0,0 +1,13 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / useActor
+
+# Function: useActor()
+
+```ts
+function useActor(): PlayActor;
+```
+
+Defined in: [packages/play-react/src/useActor.ts:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/useActor.ts#L30)
+
+## Returns
+
+[`PlayActor`](../type-aliases/PlayActor.md)

package/api/@xmachines/play-react/functions/useSignalEffect.md

@@ -6,7 +6,7 @@
 function useSignalEffect(callback): void;
 ```
 
-Defined in: [packages/play-react/src/useSignalEffect.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/useSignalEffect.ts#L65)
+Defined in: [packages/play-react/src/useSignalEffect.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/useSignalEffect.ts#L65)
 
 React hook that subscribes to signal changes and runs effect callback
 

package/api/@xmachines/play-react/functions/useStateBinding.md

@@ -0,0 +1,32 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / useStateBinding
+
+# ~~Function: useStateBinding()~~
+
+```ts
+function useStateBinding<T>(path): [T | undefined, (value) => void];
+```
+
+Hook to get and set a value from the state model (like useState).
+
+## Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+
+## Parameters
+
+| Parameter | Type     |
+| --------- | -------- |
+| `path`    | `string` |
+
+## Returns
+
+\[`T` \| `undefined`, (`value`) => `void`\]
+
+## Deprecated
+
+Use useBoundProp with `$bindState` expressions instead.
+`useStateBinding` takes a raw state path string, while `useBoundProp` works
+with the renderer's `bindings` map and supports both `$bindState` and
+`$bindItem` expressions.

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

@@ -0,0 +1,35 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / ComponentContext
+
+# Interface: ComponentContext\<C, K\>
+
+Context passed to component render functions
+
+## Example
+
+```ts
+const Button: ComponentFn<typeof catalog, 'Button'> = (ctx) => {
+  return <button onClick={() => ctx.emit("press")}>{ctx.props.label}</button>
+}
+```
+
+## Extends
+
+- `BaseComponentProps`\<`InferComponentProps`\<`C`, `K`\>\>
+
+## Type Parameters
+
+| Type Parameter                                      |
+| --------------------------------------------------- |
+| `C` _extends_ `Catalog`                             |
+| `K` _extends_ keyof `InferCatalogComponents`\<`C`\> |
+
+## Properties
+
+| Property                                   | Type                           | Description                                                                                                                      | Inherited from                | Defined in |
+| ------------------------------------------ | ------------------------------ | -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------- | ---------- |
+| <a id="property-bindings"></a> `bindings?` | `Record`\<`string`, `string`\> | Two-way binding paths resolved from `$bindState` / `$bindItem` expressions. Maps prop name → absolute state path for write-back. | `BaseComponentProps.bindings` | -          |
+| <a id="property-children"></a> `children?` | `ReactNode`                    | -                                                                                                                                | `BaseComponentProps.children` | -          |
+| <a id="property-emit"></a> `emit`          | (`event`) => `void`            | Simple event emitter (shorthand). Fires the event and returns void.                                                              | `BaseComponentProps.emit`     | -          |
+| <a id="property-loading"></a> `loading?`   | `boolean`                      | -                                                                                                                                | `BaseComponentProps.loading`  | -          |
+| <a id="property-on"></a> `on`              | (`event`) => `EventHandle`     | Get an event handle with metadata. Use when you need shouldPreventDefault or bound checks.                                       | `BaseComponentProps.on`       | -          |
+| <a id="property-props"></a> `props`        | `InferComponentProps`          | -                                                                                                                                | `BaseComponentProps.props`    | -          |

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

@@ -2,7 +2,7 @@
 
 # Interface: PlayErrorBoundaryProps
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L14)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L15)
 
 Props for PlayErrorBoundary
 
@@ -10,6 +10,6 @@ Props for PlayErrorBoundary
 
 | Property                                   | Type                        | Description                                                                             | Defined in                                                                                                                                                             |
 | ------------------------------------------ | --------------------------- | --------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-children"></a> `children`  | `ReactNode`                 | Child components to render                                                              | [packages/play-react/src/PlayErrorBoundary.tsx:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L18) |
-| <a id="property-fallback"></a> `fallback?` | `ReactNode`                 | Fallback UI to render when a child component throws. Defaults to null.                  | [packages/play-react/src/PlayErrorBoundary.tsx:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L16) |
-| <a id="property-onerror"></a> `onError?`   | (`error`, `info`) => `void` | Optional error handler callback — forwards errors to observability tools (Sentry, etc.) | [packages/play-react/src/PlayErrorBoundary.tsx:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L20) |
+| <a id="property-children"></a> `children`  | `ReactNode`                 | Child components to render                                                              | [packages/play-react/src/PlayErrorBoundary.tsx:19](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L19) |
+| <a id="property-fallback"></a> `fallback?` | `ReactNode`                 | Fallback UI to render when a child component throws. Defaults to null.                  | [packages/play-react/src/PlayErrorBoundary.tsx:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L17) |
+| <a id="property-onerror"></a> `onError?`   | (`error`, `info`) => `void` | Optional error handler callback — forwards errors to observability tools (Sentry, etc.) | [packages/play-react/src/PlayErrorBoundary.tsx:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L21) |

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

@@ -2,7 +2,7 @@
 
 # Interface: PlayErrorBoundaryState
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L28)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L29)
 
 Internal state shape for PlayErrorBoundary
 
@@ -10,5 +10,5 @@ Internal state shape for PlayErrorBoundary
 
 | Property                                  | Type              | Defined in                                                                                                                                                             |
 | ----------------------------------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-error"></a> `error`       | `Error` \| `null` | [packages/play-react/src/PlayErrorBoundary.tsx:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L30) |
-| <a id="property-haserror"></a> `hasError` | `boolean`         | [packages/play-react/src/PlayErrorBoundary.tsx:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayErrorBoundary.tsx#L29) |
+| <a id="property-error"></a> `error`       | `Error` \| `null` | [packages/play-react/src/PlayErrorBoundary.tsx:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L31) |
+| <a id="property-haserror"></a> `hasError` | `boolean`         | [packages/play-react/src/PlayErrorBoundary.tsx:30](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayErrorBoundary.tsx#L30) |

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

@@ -1,15 +1,23 @@
 [Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayRendererProps
 
-# Interface: PlayRendererProps
+# Interface: PlayRendererProps\<TLogic\>
 
-Defined in: [packages/play-react/src/types.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/types.ts#L18)
+Defined in: [packages/play-react/src/types.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/types.ts#L31)
 
 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. When a specific machine type is provided, the `actions` values are constrained to the event type strings that the machine actually accepts. |
+
 ## 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)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability) | [packages/play-react/src/types.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/types.ts#L20) |
-| <a id="property-components"></a> `components` | `Record`\<`string`, `React.ElementType`\>                                                                                                                                                     | Map of component names to React components                            | [packages/play-react/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/types.ts#L23) |
-| <a id="property-fallback"></a> `fallback?`    | `ReactNode`                                                                                                                                                                                   | Optional component shown when currentView is null                     | [packages/play-react/src/types.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/types.ts#L26) |
+| Property                                   | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                   |
+| ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-actions"></a> `actions?`   | `object`                                                                                                                                                                                            | Maps json-render action names to XState event type strings. Values are constrained to `EventFromLogic<TLogic>["type"]` — passing a non-existent event type string is a compile error when TLogic is specified.                                                                                                      | [packages/play-react/src/types.ts:56](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/types.ts#L56) |
+| <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:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/types.ts#L33) |
+| <a id="property-fallback"></a> `fallback?` | `ReactNode`                                                                                                                                                                                         | Optional component shown when currentView is null                                                                                                                                                                                                                                                                   | [packages/play-react/src/types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/types.ts#L49) |
+| <a id="property-registry"></a> `registry`  | `ComponentRegistry`                                                                                                                                                                                 | ComponentRegistry from defineRegistry() in @json-render/react                                                                                                                                                                                                                                                       | [packages/play-react/src/types.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/types.ts#L36) |
+| <a id="property-store"></a> `store?`       | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and the store is the single source of truth for UI state. When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-react/src/types.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/types.ts#L46) |

package/api/@xmachines/play-react/type-aliases/ComponentFn.md

@@ -0,0 +1,34 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / ComponentFn
+
+# Type Alias: ComponentFn\<C, K\>
+
+```ts
+type ComponentFn<C, K> = (ctx) => ReactNode;
+```
+
+Component render function type for React
+
+## Type Parameters
+
+| Type Parameter                                      |
+| --------------------------------------------------- |
+| `C` _extends_ `Catalog`                             |
+| `K` _extends_ keyof `InferCatalogComponents`\<`C`\> |
+
+## Parameters
+
+| Parameter | Type                                                                |
+| --------- | ------------------------------------------------------------------- |
+| `ctx`     | [`ComponentContext`](../interfaces/ComponentContext.md)\<`C`, `K`\> |
+
+## Returns
+
+`ReactNode`
+
+## Example
+
+```ts
+const Button: ComponentFn<typeof catalog, 'Button'> = ({ props, emit }) => (
+  <button onClick={() => emit("press")}>{props.label}</button>
+);
+```

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

@@ -0,0 +1,9 @@
+[Documentation](../../../README.md) / [@xmachines/play-react](../README.md) / PlayActor
+
+# Type Alias: PlayActor
+
+```ts
+type PlayActor = AbstractActor<AnyActorLogic>;
+```
+
+Defined in: [packages/play-react/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/useActor.ts#L26)

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

@@ -6,16 +6,20 @@
 const PlayRenderer: React.FC<PlayRendererProps>;
 ```
 
-Defined in: [packages/play-react/src/PlayRenderer.tsx:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.15/packages/play-react/src/PlayRenderer.tsx#L61)
+Defined in: [packages/play-react/src/PlayRenderer.tsx:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.17/packages/play-react/src/PlayRenderer.tsx#L65)
 
 Main renderer component that subscribes to actor signals and renders UI
+via @json-render/react Renderer.
 
-Architecture (per RESEARCH.md Pattern 1):
+Architecture:
 
 - Subscribes to actor.currentView signal via useSignalEffect
-- Dynamically renders catalog components based on view.component string
-- Forwards user events to actor via actor.send()
-- React state only for triggering renders, NOT business logic
+- Renders view.spec via StateProvider → ActionProvider → VisibilityProvider → Renderer
+- Routes action names to actor.send() via the `actions` prop mapping
+- State store: uses external `store` prop if provided (controlled mode); otherwise
+  creates a fresh @xstate/store atom per view transition seeded from spec.state.
+  The atom resets automatically when the actor transitions to a new view, mirroring
+  the actor's currentView lifecycle.
 
 Invariant: Actor Authority - Actor decides all state transitions via guards.
 Invariant: Passive Infrastructure - Component observes signals and sends events.
@@ -25,20 +29,18 @@ Invariant: Signal-Only Reactivity - Business logic state lives in actor signals.
 
 ```typescript
 import { PlayRenderer } from "@xmachines/play-react";
-import { definePlayer } from "@xmachines/play-xstate";
+import { defineRegistry } from "@json-render/react";
 
-const actor = definePlayer({ machine, catalog })();
-actor.start();
+const { registry } = defineRegistry(catalog, { components: { ... } });
 
-const components = {
-  Dashboard: ({ userId, send }) => <div>User: {userId}</div>,
-  LoginForm: ({ error, send }) => <form onSubmit={(e) => {
-    e.preventDefault();
-    send({ type: "intent", name: "login.submit", payload: {...} });
-  }}>...</form>
-};
+// Uncontrolled — fresh atom created per view, seeded from spec.state:
+<PlayRenderer actor={actor} registry={registry} actions={{ login: "auth.login" }} />
 
-<PlayRenderer actor={actor} components={components} />
+// Controlled — caller provides and owns the store:
+import { createAtom } from "@xstate/store";
+import { xstateStoreStateStore } from "@json-render/xstate";
+const store = xstateStoreStateStore({ atom: createAtom({ username: "" }) });
+<PlayRenderer actor={actor} registry={registry} store={store} actions={{ login: "auth.login" }} />
 ```
 
 ## Param
@@ -48,17 +50,3 @@ Component props
 ## Returns
 
 React element rendering current view from actor
-
-## Remarks
-
-**Component lookup:** Dynamically looks up component from `components` map
-using `view.component` string from actor.currentView signal.
-
-**Event forwarding:** Injects `send` function as prop to components. Components
-call `send(event)` to forward intents to actor. Actor guards decide validity.
-
-**Error handling:** If component not found in catalog, logs error and shows
-fallback. This indicates missing component registration, not runtime error.
-
-**CRITICAL:** Never call actor.send() during render - only in event handlers.
-Calling send during render causes infinite render loops.