@xmachines/docs 6.1.0 → 7.1.0

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

@@ -2,7 +2,7 @@
 
 # Class: PlayErrorBoundary
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:99](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L99)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:99](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L99)
 
 The React class component that catches a render error of a catalog component.
 
@@ -37,7 +37,7 @@ CONS-14: the class component pattern works with every React version, 18 and 19.
 new PlayErrorBoundary(props): PlayErrorBoundary;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:103](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L103)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:103](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L103)
 
 #### Parameters
 
@@ -51,12 +51,7 @@ Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:103](https://gitlab.c
 
 #### Overrides
 
-```ts
-React.Component<
-	PlayErrorBoundaryProps,
-	PlayErrorBoundaryState
->.constructor
-```
+`React.Component<PlayErrorBoundaryProps, 	PlayErrorBoundaryState>.constructor`
 
 ## Properties
 
@@ -76,7 +71,7 @@ React.Component<
 componentDidCatch(error, info): void;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:135](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L135)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:135](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L135)
 
 Catches exceptions generated in descendant components. Unhandled exceptions will cause
 the entire component tree to unmount.
@@ -94,16 +89,14 @@ the entire component tree to unmount.
 
 #### Overrides
 
-```ts
-React.Component.componentDidCatch;
-```
+`React.Component.componentDidCatch`
 
 ---
 
 ### componentDidMount()?
 
 ```ts
-optional componentDidMount(): void;
+componentDidMount?(): void;
 ```
 
 Defined in: `@types/react`
@@ -116,16 +109,14 @@ Called immediately after a component is mounted. Setting state here will trigger
 
 #### Inherited from
 
-```ts
-React.Component.componentDidMount;
-```
+`React.Component.componentDidMount`
 
 ---
 
 ### componentDidUpdate()?
 
 ```ts
-optional componentDidUpdate(
+componentDidUpdate?(
    prevProps,
    prevState,
    snapshot?
@@ -152,16 +143,14 @@ The snapshot is only present if [getSnapshotBeforeUpdate](#getsnapshotbeforeupda
 
 #### Inherited from
 
-```ts
-React.Component.componentDidUpdate;
-```
+`React.Component.componentDidUpdate`
 
 ---
 
 ### ~~componentWillMount()?~~
 
 ```ts
-optional componentWillMount(): void;
+componentWillMount?(): void;
 ```
 
 Defined in: `@types/react`
@@ -188,16 +177,14 @@ this from being invoked.
 
 #### Inherited from
 
-```ts
-React.Component.componentWillMount;
-```
+`React.Component.componentWillMount`
 
 ---
 
 ### ~~componentWillReceiveProps()?~~
 
 ```ts
-optional componentWillReceiveProps(nextProps, nextContext): void;
+componentWillReceiveProps?(nextProps, nextContext): void;
 ```
 
 Defined in: `@types/react`
@@ -234,16 +221,14 @@ this from being invoked.
 
 #### Inherited from
 
-```ts
-React.Component.componentWillReceiveProps;
-```
+`React.Component.componentWillReceiveProps`
 
 ---
 
 ### componentWillUnmount()?
 
 ```ts
-optional componentWillUnmount(): void;
+componentWillUnmount?(): void;
 ```
 
 Defined in: `@types/react`
@@ -257,16 +242,14 @@ cancelled network requests, or cleaning up any DOM elements created in `componen
 
 #### Inherited from
 
-```ts
-React.Component.componentWillUnmount;
-```
+`React.Component.componentWillUnmount`
 
 ---
 
 ### ~~componentWillUpdate()?~~
 
 ```ts
-optional componentWillUpdate(
+componentWillUpdate?(
    nextProps,
    nextState,
    nextContext
@@ -306,9 +289,7 @@ this from being invoked.
 
 #### Inherited from
 
-```ts
-React.Component.componentWillUpdate;
-```
+`React.Component.componentWillUpdate`
 
 ---
 
@@ -332,16 +313,14 @@ Defined in: `@types/react`
 
 #### Inherited from
 
-```ts
-React.Component.forceUpdate;
-```
+`React.Component.forceUpdate`
 
 ---
 
 ### getSnapshotBeforeUpdate()?
 
 ```ts
-optional getSnapshotBeforeUpdate(prevProps, prevState): any;
+getSnapshotBeforeUpdate ? (prevProps, prevState) : any;
 ```
 
 Defined in: `@types/react`
@@ -366,9 +345,7 @@ lifecycle events from running.
 
 #### Inherited from
 
-```ts
-React.Component.getSnapshotBeforeUpdate;
-```
+`React.Component.getSnapshotBeforeUpdate`
 
 ---
 
@@ -378,7 +355,7 @@ React.Component.getSnapshotBeforeUpdate;
 render(): ReactNode;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:139](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L139)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:139](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L139)
 
 #### Returns
 
@@ -386,9 +363,7 @@ Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:139](https://gitlab.c
 
 #### Overrides
 
-```ts
-React.Component.render;
-```
+`React.Component.render`
 
 ---
 
@@ -402,9 +377,9 @@ Defined in: `@types/react`
 
 #### Type Parameters
 
-| Type Parameter                                                                          |
-| --------------------------------------------------------------------------------------- |
-| `K` _extends_ keyof [`PlayErrorBoundaryState`](../interfaces/PlayErrorBoundaryState.md) |
+| Type Parameter                                                                                                        |
+| --------------------------------------------------------------------------------------------------------------------- |
+| <a id="type-parameter-k"></a> `K` _extends_ keyof [`PlayErrorBoundaryState`](../interfaces/PlayErrorBoundaryState.md) |
 
 #### Parameters
 
@@ -419,20 +394,14 @@ Defined in: `@types/react`
 
 #### Inherited from
 
-```ts
-React.Component.setState;
-```
+`React.Component.setState`
 
 ---
 
 ### shouldComponentUpdate()?
 
 ```ts
-optional shouldComponentUpdate(
-   nextProps,
-   nextState,
-   nextContext
-): boolean;
+shouldComponentUpdate ? (nextProps, nextState, nextContext) : boolean;
 ```
 
 Defined in: `@types/react`
@@ -460,16 +429,14 @@ and `componentDidUpdate` will not be called.
 
 #### Inherited from
 
-```ts
-React.Component.shouldComponentUpdate;
-```
+`React.Component.shouldComponentUpdate`
 
 ---
 
 ### ~~UNSAFE\_componentWillMount()?~~
 
 ```ts
-optional UNSAFE_componentWillMount(): void;
+UNSAFE_componentWillMount?(): void;
 ```
 
 Defined in: `@types/react`
@@ -498,16 +465,14 @@ this from being invoked.
 
 #### Inherited from
 
-```ts
-React.Component.UNSAFE_componentWillMount;
-```
+`React.Component.UNSAFE_componentWillMount`
 
 ---
 
 ### ~~UNSAFE\_componentWillReceiveProps()?~~
 
 ```ts
-optional UNSAFE_componentWillReceiveProps(nextProps, nextContext): void;
+UNSAFE_componentWillReceiveProps?(nextProps, nextContext): void;
 ```
 
 Defined in: `@types/react`
@@ -546,16 +511,14 @@ this from being invoked.
 
 #### Inherited from
 
-```ts
-React.Component.UNSAFE_componentWillReceiveProps;
-```
+`React.Component.UNSAFE_componentWillReceiveProps`
 
 ---
 
 ### ~~UNSAFE\_componentWillUpdate()?~~
 
 ```ts
-optional UNSAFE_componentWillUpdate(
+UNSAFE_componentWillUpdate?(
    nextProps,
    nextState,
    nextContext
@@ -597,9 +560,7 @@ this from being invoked.
 
 #### Inherited from
 
-```ts
-React.Component.UNSAFE_componentWillUpdate;
-```
+`React.Component.UNSAFE_componentWillUpdate`
 
 ---
 
@@ -609,7 +570,7 @@ React.Component.UNSAFE_componentWillUpdate;
 static getDerivedStateFromError(error): Pick<PlayErrorBoundaryState, "hasError" | "error">;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:108](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L108)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:108](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L108)
 
 #### Parameters
 
@@ -631,7 +592,7 @@ static getDerivedStateFromProps(props, state):
   | null;
 ```
 
-Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L126)
+Defined in: [packages/play-react/src/PlayErrorBoundary.tsx:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/PlayErrorBoundary.tsx#L126)
 
 Clears the error state after a change of `resetKey`.
 

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

@@ -14,9 +14,9 @@ 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`\> |
+| Type Parameter                                                                                                                                                     |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| <a id="type-parameter-c"></a> `C` _extends_ `Catalog`\<`SchemaDefinition`\<`SchemaType`\<`string`, `unknown`\>, `SchemaType`\<`string`, `unknown`\>\>, `unknown`\> |
 
 ## Parameters
 
@@ -27,7 +27,7 @@ When the catalog declares actions, the `actions` field is required.
 
 ## Returns
 
-`DefineRegistryResult`
+[`DefineRegistryResult`](../interfaces/DefineRegistryResult.md)
 
 ## Example
 

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

@@ -6,7 +6,7 @@
 function useActor(): AnyPlayActor;
 ```
 
-Defined in: [packages/play-react/src/useActor.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/useActor.ts#L41)
+Defined in: [packages/play-react/src/useActor.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/useActor.ts#L41)
 
 ## Returns
 

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

@@ -6,7 +6,7 @@
 function useAtomEffect(sources, callback, deps?): void;
 ```
 
-Defined in: [packages/play-react/src/useAtomEffect.ts:106](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/useAtomEffect.ts#L106)
+Defined in: [packages/play-react/src/useAtomEffect.ts:106](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/useAtomEffect.ts#L106)
 
 The React hook that subscribes to the named atoms and runs an effect callback
 
@@ -32,7 +32,7 @@ Invariant: Passive Infrastructure. React observes the atoms, and it does not con
 | ---------- | ---------------------------------------------------------------------------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `sources`  | readonly [`Readable`](../../play-atom/interfaces/Readable.md)\<`unknown`\>[] | `undefined`   | The atoms that run the effect. The list names every dependency, and the reads of the callback name none: a callback that reads a view store therefore depends on that store not, and a write of the store runs the effect never.                                                                                                                                                                                                                                                      |
 | `callback` | () => `void` \| (() => `void`)                                               | `undefined`   | The effect function. It can return a cleanup function. It runs one time on the mount, and one time for each write of a source.                                                                                                                                                                                                                                                                                                                                                        |
-| `deps`     | `DependencyList`                                                             | `[]`          | The optional dependency list, as in useEffect. On a change of one dependency, the hook removes the watcher and the computed atom, then makes them again and reads the sources from the start. The default is `[]`, which subscribes one time for each mount. Give this list when the identity of the object whose atoms you read can change during the life of the component, for example an `actor` prop. Without the list, the watcher tracks the atoms of the OLD object for ever. |
+| `deps?`    | `DependencyList`                                                             | `[]`          | The optional dependency list, as in useEffect. On a change of one dependency, the hook removes the watcher and the computed atom, then makes them again and reads the sources from the start. The default is `[]`, which subscribes one time for each mount. Give this list when the identity of the object whose atoms you read can change during the life of the component, for example an `actor` prop. Without the list, the watcher tracks the atoms of the OLD object for ever. |
 
 ## Returns
 

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

@@ -18,9 +18,9 @@ a prop uses `{ $bindState: "/path" }` or `{ $bindItem: "field" }`.
 
 ## Type Parameters
 
-| Type Parameter |
-| -------------- |
-| `T`            |
+| Type Parameter                    |
+| --------------------------------- |
+| <a id="type-parameter-t"></a> `T` |
 
 ## Parameters
 

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

@@ -6,7 +6,7 @@
 function usePlayView(): ViewContextValue;
 ```
 
-Defined in: [packages/play-react/src/ActorProvider.tsx:151](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/ActorProvider.tsx#L151)
+Defined in: [packages/play-react/src/ActorProvider.tsx:147](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/ActorProvider.tsx#L147)
 
 The hook that gives the current view spec, the handlers, and the registry.
 

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

@@ -8,8 +8,8 @@ Props for ActionProvider
 
 ## Properties
 
-| Property                                   | Type                                  | Description             | Defined in |
-| ------------------------------------------ | ------------------------------------- | ----------------------- | ---------- |
-| <a id="property-children"></a> `children`  | `ReactNode`                           | -                       | -          |
-| <a id="property-handlers"></a> `handlers?` | `Record`\<`string`, `ActionHandler`\> | Initial action handlers | -          |
-| <a id="property-navigate"></a> `navigate?` | (`path`) => `void`                    | Navigation function     | -          |
+| Property                                   | Type                                  | Description                                                                                                            | Defined in |
+| ------------------------------------------ | ------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | ---------- |
+| <a id="property-children"></a> `children`  | `ReactNode`                           | -                                                                                                                      | -          |
+| <a id="property-handlers"></a> `handlers?` | `Record`\<`string`, `ActionHandler`\> | Action handlers. The provider follows a new map on each render, and a handler that registerHandler added stays on top. | -          |
+| <a id="property-navigate"></a> `navigate?` | (`path`) => `void`                    | Navigation function                                                                                                    | -          |

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

@@ -2,13 +2,13 @@
 
 # Interface: ActorProviderProps
 
-Defined in: [packages/play-react/src/ActorProvider.tsx:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/ActorProvider.tsx#L59)
+Defined in: [packages/play-react/src/ActorProvider.tsx:52](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/ActorProvider.tsx#L52)
 
 The props of the ActorProvider component.
 
 ## Extends
 
-- [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md)\<`DefineRegistryResult`\>
+- [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md)\<[`DefineRegistryResult`](DefineRegistryResult.md)\>
 
 ## Extended by
 
@@ -16,12 +16,12 @@ The props of the ActorProvider component.
 
 ## Properties
 
-| Property                                              | Type                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Inherited from                                                                                                                                                                                | Defined in                                                                                                                                             |
-| ----------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| <a id="property-actor"></a> `actor`                   | [`ViewActor`](../../play-view/index/type-aliases/ViewActor.md) | The actor instance with the currentView atom. It requires the Viewable capability.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`actor`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-actor)                   | [packages/play-view/src/view-types.ts:224](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L224)         |
-| <a id="property-children"></a> `children`             | `ReactNode`                                                    | The child components to render inside the provider tree                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | -                                                                                                                                                                                             | [packages/play-react/src/ActorProvider.tsx:99](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/ActorProvider.tsx#L99) |
-| <a id="property-fallback"></a> `fallback?`            | `ReactNode`                                                    | The component to show when currentView is null, or when a catalog component throws. This prop is optional                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | -                                                                                                                                                                                             | [packages/play-react/src/ActorProvider.tsx:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/ActorProvider.tsx#L61) |
-| <a id="property-onerror"></a> `onError?`              | (`error`, `info`, `reset`) => `void`                           | The optional error handler. The provider calls it when a descendant throws during a render. While the error is active, the provider renders the `fallback` instead of its children. The provider clears the error on the next view emission (when `currentView` changes), so a view transition retries the render. Element-level catalog component throws are caught upstream by the per-element boundary of @json-render, and reported through `onRenderError`. This boundary is the outer net for everything else. The THIRD parameter is the reset, for a retry that the host starts — a "Retry" button of its own. It sits after `info`, and not in the second place that the four other renderers use, because `React.ErrorInfo` holds that place already and a move would break every handler that reads `info.componentStack`. The reset clears the contained error and renders again. It renders the view that the actor holds at the MOMENT OF THE CALL, so a host that keeps the callback cannot rewind the screen to the view that failed. A reset that the host calls from inside this handler does nothing, because no input changed between the two attempts, and a reset after the provider is unmounted does nothing. The five renderers hold the same three rules. **A handler that THROWS reaches no caller.** The provider contains that throw, and it writes the throw to `console.error`. This handler runs inside `componentDidCatch`, so a throw that left it would reach the boundary ABOVE this provider, and React can then unmount the complete root — which is the failure that this boundary contained. Report a failure from this handler. To ESCALATE one, raise it from a task of your own — `rethrowLater(error)` of `@xmachines/core/utils` — which reaches the global handler of the page and leaves the containment whole. The host installs `@xmachines/core` itself. The five renderers hold this one rule. | -                                                                                                                                                                                             | [packages/play-react/src/ActorProvider.tsx:97](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-react/src/ActorProvider.tsx#L97) |
-| <a id="property-onrendererror"></a> `onRenderError?`  | [`RenderErrorHandler`](../type-aliases/RenderErrorHandler.md)  | The provider calls it when one catalog component throws during a render. This handler replaces every onRenderError of defineRegistry.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`onRenderError`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-onrendererror)   | [packages/play-view/src/view-types.ts:238](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L238)         |
-| <a id="property-registryresult"></a> `registryResult` | `DefineRegistryResult`                                         | The complete result of defineRegistry(). It holds the component registry and the factory of the action handlers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`registryResult`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-registryresult) | [packages/play-view/src/view-types.ts:226](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L226)         |
-| <a id="property-store"></a> `store?`                  | `StateStore`                                                   | The optional external StateStore, which is the controlled mode. With this option, the provider ignores spec.state, and this store is the single source of truth. Without it, the provider makes a new @xstate/store atom for each view transition, with the values of spec.state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`store`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-store)                   | [packages/play-view/src/view-types.ts:233](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L233)         |
+| Property                                              | Type                                                           | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Inherited from                                                                                                                                                                                | Defined in                                                                                                                                                  |
+| ----------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-actor"></a> `actor`                   | [`ViewActor`](../../play-view/index/type-aliases/ViewActor.md) | The actor instance with the currentView atom. It requires the Viewable capability.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`actor`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-actor)                   | [packages/play-view/src/view-types.ts:219](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-view/src/view-types.ts#L219)         |
+| <a id="property-children"></a> `children`             | `ReactNode`                                                    | The child components to render inside the provider tree                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           | -                                                                                                                                                                                             | [packages/play-react/src/ActorProvider.tsx:95](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/ActorProvider.tsx#L95) |
+| <a id="property-fallback"></a> `fallback?`            | `ReactNode`                                                    | The component to show when currentView is null, or after a failure of the view. This prop is optional                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | -                                                                                                                                                                                             | [packages/play-react/src/ActorProvider.tsx:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/ActorProvider.tsx#L54) |
+| <a id="property-onerror"></a> `onError?`              | (`error`, `reset`, `info`) => `void`                           | The optional error handler. The provider calls it when a descendant throws during a render. While the error is active, the provider renders the `fallback` instead of its children. The provider clears the error on the next view emission (when `currentView` changes), so a view transition retries the render. The per-element boundary of `json-render` catches a throw of a catalog component below the root, and it reports it through `onRenderError` alone. A failure of the ROOT — its component, a prop, or its `visible` condition — leaves no view, and json-render gives it to no boundary of the host. The provider contains it as a failure of the view all the same: it shows the fallback, and it calls this handler one time. `onRenderError` also receives it, with `info.kind` `"root"`. This boundary is the outer net for everything else. The SECOND parameter is the reset, for a retry that the host starts — a "Retry" button of its own. It sits in the same place as in the four other renderers, and the `React.ErrorInfo` of the boundary comes third. The reset clears the contained error and renders again. It renders the view that the actor holds at the MOMENT OF THE CALL, so a host that keeps the callback cannot rewind the screen to the view that failed. A reset that the host calls from inside this handler does nothing, because no input changed between the two attempts, and a reset after the provider is unmounted does nothing. The five renderers hold the same three rules. **A handler that THROWS reaches no caller.** The provider contains that throw, and it writes the throw to `console.error`. This handler runs inside `componentDidCatch`, so a throw that left it would reach the boundary ABOVE this provider, and React can then unmount the complete root — which is the failure that this boundary contained. Report a failure from this handler. To ESCALATE one, raise it from a task of your own — `rethrowLater(error)` of `@xmachines/core/utils` — which reaches the global handler of the page and leaves the containment whole. The host installs `@xmachines/core` itself. The five renderers hold this one rule. | -                                                                                                                                                                                             | [packages/play-react/src/ActorProvider.tsx:93](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-react/src/ActorProvider.tsx#L93) |
+| <a id="property-onrendererror"></a> `onRenderError?`  | [`OnRenderError`](../type-aliases/OnRenderError.md)            | The renderer calls it with `(error, name, info)` for each failure that it reports: a catalog component that throws, a prop or a `visible` condition that fails, an action chain or a watch chain that fails, and a failure of the root. `info.kind` names the kind of the failure. A handler with the two parameters `(error, name)` stays valid. This handler replaces every onRenderError of defineRegistry.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`onRenderError`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-onrendererror)   | [packages/play-view/src/view-types.ts:236](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-view/src/view-types.ts#L236)         |
+| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](DefineRegistryResult.md)              | The complete result of defineRegistry(). It holds the component registry and the factory of the action handlers.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`registryResult`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-registryresult) | [packages/play-view/src/view-types.ts:221](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-view/src/view-types.ts#L221)         |
+| <a id="property-store"></a> `store?`                  | `StateStore`                                                   | The optional external StateStore, which is the controlled mode. With this option, the provider ignores spec.state, and this store is the single source of truth. Without it, the provider makes a new @xstate/store atom for each view transition, with the values of spec.state.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`BaseActorProviderProps`](../../play-view/index/interfaces/BaseActorProviderProps.md).[`store`](../../play-view/index/interfaces/BaseActorProviderProps.md#property-store)                   | [packages/play-view/src/view-types.ts:228](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-view/src/view-types.ts#L228)         |

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

@@ -20,10 +20,10 @@ const Button: ComponentFn<typeof catalog, 'Button'> = (ctx) => {
 
 ## Type Parameters
 
-| Type Parameter                                      |
-| --------------------------------------------------- |
-| `C` _extends_ `Catalog`                             |
-| `K` _extends_ keyof `InferCatalogComponents`\<`C`\> |
+| Type Parameter                                                                    |
+| --------------------------------------------------------------------------------- |
+| <a id="type-parameter-c"></a> `C` _extends_ `Catalog`                             |
+| <a id="type-parameter-k"></a> `K` _extends_ keyof `InferCatalogComponents`\<`C`\> |
 
 ## Properties
 

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

@@ -0,0 +1,15 @@
+[API](../../../README.md) / [@xmachines/play-react](../README.md) / DefineRegistryResult
+
+# Interface: DefineRegistryResult
+
+Defined in: `@xmachines/json-render-react`
+
+Result returned by defineRegistry
+
+## Properties
+
+| Property                                            | Type                                                                                   | Description                                                                                                                                   | Defined in |
+| --------------------------------------------------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ---------- |
+| <a id="property-executeaction"></a> `executeAction` | (`actionName`, `params`, `setState`, `state?`) => `Promise`\<`void`\>                  | Execute an action by name imperatively (for use outside the React tree, e.g. initial state loading).                                          | -          |
+| <a id="property-handlers"></a> `handlers`           | (`getSetState`, `getState`) => `Record`\<`string`, (`params`) => `Promise`\<`void`\>\> | Create ActionProvider-compatible handlers. Accepts getter functions so handlers always read the latest state/setState (e.g. from React refs). | -          |
+| <a id="property-registry"></a> `registry`           | `ComponentRegistry`                                                                    | Component registry for `<Renderer registry={...} />`                                                                                          | -          |