@xmachines/docs 6.1.0 → 7.0.0

package/api/@xmachines/play-view/index/interfaces/ViewSession.md

@@ -0,0 +1,155 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / ViewSession
+
+# Interface: ViewSession\<TActor\>
+
+Defined in: [packages/play-view/src/view-session.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L88)
+
+The view session of one provider.
+
+## Type Parameters
+
+| Type Parameter                                                 | Default type                                | Description                            |
+| -------------------------------------------------------------- | ------------------------------------------- | -------------------------------------- |
+| `TActor` _extends_ [`ViewActor`](../type-aliases/ViewActor.md) | [`ViewActor`](../type-aliases/ViewActor.md) | The type of the actor of the provider. |
+
+## Methods
+
+### dispose()
+
+```ts
+dispose(): void;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:142](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L142)
+
+Disconnects the session and drops its store. A later call does nothing.
+
+#### Returns
+
+`void`
+
+---
+
+### failView()
+
+```ts
+failView(error, attempt?): void;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:140](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L140)
+
+Records a failure of the root of the view that json-render reported, as a failure of
+the snapshot: the new snapshot holds the failure and no store, and a connected session
+reports it through [ViewSessionOptions.onFailure](ViewSessionOptions.md#property-onfailure). The failure stands until a
+new attempt: a new view, a new actor, a new controlled store, or a retry. A connection
+keeps it, also a second one: it makes a new attempt only when the view moved or a
+controlled store waits for its /context.
+
+The root boundary of json-render stays failed while its subtree stays mounted. The
+next attempt therefore gets a new generation, and a provider mounts a new subtree for
+it, with the same state. A root that fails again there reports again.
+
+The call does nothing for a snapshot that holds no view or a failure already, and for
+an `attempt` that is not the current snapshot: a report that arrives after the next
+snapshot belongs to an attempt that is gone.
+
+#### Parameters
+
+| Parameter  | Type                                                        | Description                                                                                                                                                                                                                                                                                                                                                                                                                            |
+| ---------- | ----------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `error`    | `unknown`                                                   | The failure of the root.                                                                                                                                                                                                                                                                                                                                                                                                               |
+| `attempt?` | [`ViewSessionSnapshot`](ViewSessionSnapshot.md)\<`TActor`\> | The snapshot that the failed render showed. Leave it out where the report arrives in the render of the current snapshot, and where the root boundary of json-render stays failed while its subtree stays mounted: a report that fails a newer snapshot shows the fallback, and the next attempt recovers from it, but a report that the session drops leaves an empty view. The four framework providers leave it out for that reason. |
+
+#### Returns
+
+`void`
+
+---
+
+### getSnapshot()
+
+```ts
+getSnapshot(): ViewSessionSnapshot<TActor>;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:98](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L98)
+
+The current snapshot. The first call resolves one time, without a write of the
+controlled store, and a later call returns the snapshot of the last resolution. A
+render may call it.
+
+In a session that no listener connects, `setInputs()` and `retry()` drop the
+snapshot, so the next call resolves again, also without a write. A provider must not
+keep the first snapshot as the final one.
+
+#### Returns
+
+[`ViewSessionSnapshot`](ViewSessionSnapshot.md)\<`TActor`\>
+
+---
+
+### retry()
+
+```ts
+retry(): void;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:115](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L115)
+
+Resolves the view that the actor holds NOW, for a retry of the host.
+
+#### Returns
+
+`void`
+
+---
+
+### setInputs()
+
+```ts
+setInputs(actor, store): void;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:113](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L113)
+
+Hands over the actor and the controlled store of the host. A change of either one
+resolves again, and a new actor also drops the store of the old one. Call it outside
+a render.
+
+#### Parameters
+
+| Parameter | Type                        |
+| --------- | --------------------------- |
+| `actor`   | `TActor`                    |
+| `store`   | `StateStore` \| `undefined` |
+
+#### Returns
+
+`void`
+
+---
+
+### subscribe()
+
+```ts
+subscribe(listener): () => void;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:107](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L107)
+
+Adds a listener of new snapshots. The first listener connects the session: it
+watches the view of the actor, and it resolves again, which writes `/context` into a
+controlled store. The last release disconnects it and keeps the store, so a
+framework that subscribes again, such as React in `<StrictMode>`, finds its state.
+
+#### Parameters
+
+| Parameter  | Type         |
+| ---------- | ------------ |
+| `listener` | () => `void` |
+
+#### Returns
+
+The release of the listener.
+
+() => `void`

package/api/@xmachines/play-view/index/interfaces/ViewSessionOptions.md

@@ -0,0 +1,12 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / ViewSessionOptions
+
+# Interface: ViewSessionOptions
+
+Defined in: [packages/play-view/src/view-session.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L68)
+
+## Properties
+
+| Property                                        | Type                     | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Defined in                                                                                                                                       |
+| ----------------------------------------------- | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| <a id="property-createstore"></a> `createStore` | (`seed`) => `StateStore` | The store factory of the framework. It receives the seed of the view.                                                                                                                                                                                                                                                                                                                                                                                                                          | [packages/play-view/src/view-session.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L70) |
+| <a id="property-onfailure"></a> `onFailure?`    | (`error`) => `void`      | Receives a failure of the resolution, and a failure of the root that [ViewSession.failView](ViewSession.md#failview) records, one time for each attempt. Leave it out when the boundary of the framework reports a failure that the provider throws under it. A failure of the resolution arrives never inside a render. A failure of the root arrives in the call of `failView`, so it arrives where the provider calls it: in the error hook of the framework, which can run inside a patch. | [packages/play-view/src/view-session.ts:80](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L80) |

package/api/@xmachines/play-view/index/interfaces/ViewSessionSnapshot.md

@@ -0,0 +1,23 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / ViewSessionSnapshot
+
+# Interface: ViewSessionSnapshot\<TActor\>
+
+Defined in: [packages/play-view/src/view-session.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L44)
+
+The result of the last resolution. A new resolution makes a new object.
+
+## Type Parameters
+
+| Type Parameter                                                 | Default type                                | Description                            |
+| -------------------------------------------------------------- | ------------------------------------------- | -------------------------------------- |
+| `TActor` _extends_ [`ViewActor`](../type-aliases/ViewActor.md) | [`ViewActor`](../type-aliases/ViewActor.md) | The type of the actor of the provider. |
+
+## Properties
+
+| Property                                      | Modifier   | Type                                   | Description                                                                                                                                                                                                                                                                                                               | Defined in                                                                                                                                       |
+| --------------------------------------------- | ---------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
+| <a id="property-actor"></a> `actor`           | `readonly` | `TActor`                               | The actor whose view this is. Between a new actor prop and its `setInputs()`, the snapshot still shows the view of the old actor. A provider that can render in that gap, such as play-react, whose session takes the prop in a layout effect, hands this actor to its descendants, so that the actor and the view agree. | [packages/play-view/src/view-session.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L51) |
+| <a id="property-failure"></a> `failure`       | `readonly` | \| \{ `error`: `unknown`; \} \| `null` | The failure of this resolution, or `null`.                                                                                                                                                                                                                                                                                | [packages/play-view/src/view-session.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L65) |
+| <a id="property-generation"></a> `generation` | `readonly` | `number`                               | The generation of the store, from the lifecycle. A provider keys its subtree on it: a new generation is a new store, and the subtree builds again.                                                                                                                                                                        | [packages/play-view/src/view-session.ts:63](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L63) |
+| <a id="property-store"></a> `store`           | `readonly` | `StateStore` \| `null`                 | The store of the view, with the guard of `/context`. It is `null` for a gap and for a failed resolution.                                                                                                                                                                                                                  | [packages/play-view/src/view-session.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L58) |
+| <a id="property-view"></a> `view`             | `readonly` | [`PlaySpec`](PlaySpec.md) \| `null`    | The view that the actor held at the resolution, or `null` for a gap.                                                                                                                                                                                                                                                      | [packages/play-view/src/view-session.ts:53](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L53) |

package/api/@xmachines/play-view/index/interfaces/ViewStoreLifecycle.md

@@ -2,17 +2,36 @@
 
 # Interface: ViewStoreLifecycle
 
-Defined in: [packages/play-view/src/view-store-lifecycle.ts:97](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L97)
+Defined in: [packages/play-view/src/view-store-lifecycle.ts:101](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L101)
 
 ## Methods
 
+### renew()
+
+```ts
+renew(): void;
+```
+
+Defined in: [packages/play-view/src/view-store-lifecycle.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L125)
+
+Gives the next resolution a new generation, and keeps the store. A provider keys its
+subtree on the generation, so the next resolution mounts a new subtree with the same
+state. The view session calls it after a failure of the root: the root boundary of
+json-render stays failed while its subtree stays mounted.
+
+#### Returns
+
+`void`
+
+---
+
 ### reset()
 
 ```ts
 reset(): void;
 ```
 
-Defined in: [packages/play-view/src/view-store-lifecycle.ts:114](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L114)
+Defined in: [packages/play-view/src/view-store-lifecycle.ts:118](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L118)
 
 Drops everything, on an unmount or a disconnect. The next resolve makes a new seed.
 
@@ -33,7 +52,7 @@ resolve(
 ): ViewStoreResolution;
 ```
 
-Defined in: [packages/play-view/src/view-store-lifecycle.ts:107](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L107)
+Defined in: [packages/play-view/src/view-store-lifecycle.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L111)
 
 Brings the store in line with an emission, and returns it with its guard.
 

package/api/@xmachines/play-view/index/interfaces/ViewStoreResolution.md

@@ -2,14 +2,15 @@
 
 # Interface: ViewStoreResolution
 
-Defined in: [packages/play-view/src/view-store-lifecycle.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L68)
+Defined in: [packages/play-view/src/view-store-lifecycle.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L65)
 
 The result of a resolve — see [ViewStoreLifecycle.resolve](ViewStoreLifecycle.md#resolve).
 
 ## Properties
 
-| Property                                          | Type         | Description                                                                                                                                                                                                                                                                       | Defined in                                                                                                                                                       |
-| ------------------------------------------------- | ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-guardedstore"></a> `guardedStore` | `StateStore` | The store to give to the children ($bindState, setState, and a chained set): a write under /context throws. There is one wrapper for each store below it, and the code caches the identity. Therefore a consumer in the style of `useSyncExternalStore` stays stable.             | [packages/play-view/src/view-store-lifecycle.ts:77](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L77) |
-| <a id="property-reseeded"></a> `reseeded`         | `boolean`    | It is true when this resolve made a new store: at the first resolve, on a change of the viewKey, in the fallback for each emission, and on a change of the actor. A provider that mounts a subtree again for each store, such as the storeKey of Vue, uses this field as its key. | [packages/play-view/src/view-store-lifecycle.ts:84](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L84) |
-| <a id="property-store"></a> `store`               | `StateStore` | The store WITHOUT the guard — the reference of the machinery for its own refresh.                                                                                                                                                                                                 | [packages/play-view/src/view-store-lifecycle.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-store-lifecycle.ts#L70) |
+| Property                                          | Type         | Description                                                                                                                                                                                                                                                                                                   | Defined in                                                                                                                                                       |
+| ------------------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-generation"></a> `generation`     | `number`     | A number that changes each time that the store of the children changes identity: a new seed, a new controlled store, or the first resolve after a reset. A provider keys its subtree on it, so that a new store also drops the state that a component keeps for itself, such as the text of an unbound input. | [packages/play-view/src/view-store-lifecycle.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L88) |
+| <a id="property-guardedstore"></a> `guardedStore` | `StateStore` | The store to give to the children ($bindState, setState, and a chained set): a write under /context throws. There is one wrapper for each store below it, and the code caches the identity. Therefore a consumer in the style of `useSyncExternalStore` stays stable.                                         | [packages/play-view/src/view-store-lifecycle.ts:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L74) |
+| <a id="property-reseeded"></a> `reseeded`         | `boolean`    | It is true when this resolve made a new store: at the first resolve, on a change of the viewKey, in the fallback for each emission, and on a change of the actor. A provider keys its subtree on [generation](#property-generation), which also covers a new controlled store.                                | [packages/play-view/src/view-store-lifecycle.ts:81](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L81) |
+| <a id="property-store"></a> `store`               | `StateStore` | The store WITHOUT the guard — the reference of the machinery for its own refresh.                                                                                                                                                                                                                             | [packages/play-view/src/view-store-lifecycle.ts:67](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L67) |

package/api/@xmachines/play-view/index/interfaces/ViewTree.md

@@ -2,7 +2,7 @@
 
 # Interface: ViewTree
 
-Defined in: [packages/play-view/src/compose-views.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L23)
+Defined in: [packages/play-view/src/compose-views.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L27)
 
 The resolved view of one active state node, and the resolved views of its children.
 
@@ -10,6 +10,6 @@ The resolved view of one active state node, and the resolved views of its childr
 
 | Property                                  | Modifier   | Type                                           | Description                                                                                                             | Defined in                                                                                                                                         |
 | ----------------------------------------- | ---------- | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-children"></a> `children` | `readonly` | readonly [`ViewTreeChild`](ViewTreeChild.md)[] | The resolved view of each active child, in the order of the machine. It is empty for a view that declares no `outlets`. | [packages/play-view/src/compose-views.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L32) |
-| <a id="property-id"></a> `id`             | `readonly` | `string`                                       | The id of the state node that declares `view`.                                                                          | [packages/play-view/src/compose-views.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L25) |
-| <a id="property-view"></a> `view`         | `readonly` | [`ViewMeta`](ViewMeta.md)                      | The `meta.view` of that state node, as the author wrote it.                                                             | [packages/play-view/src/compose-views.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L27) |
+| <a id="property-children"></a> `children` | `readonly` | readonly [`ViewTreeChild`](ViewTreeChild.md)[] | The resolved view of each active child, in the order of the machine. It is empty for a view that declares no `outlets`. | [packages/play-view/src/compose-views.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L36) |
+| <a id="property-id"></a> `id`             | `readonly` | `string`                                       | The id of the state node that declares `view`.                                                                          | [packages/play-view/src/compose-views.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L29) |
+| <a id="property-view"></a> `view`         | `readonly` | [`ViewMeta`](ViewMeta.md)                      | The `meta.view` of that state node, as the author wrote it.                                                             | [packages/play-view/src/compose-views.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L31) |

package/api/@xmachines/play-view/index/interfaces/ViewTreeChild.md

@@ -2,7 +2,7 @@
 
 # Interface: ViewTreeChild
 
-Defined in: [packages/play-view/src/compose-views.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L36)
+Defined in: [packages/play-view/src/compose-views.ts:40](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L40)
 
 One active child of a [ViewTree](ViewTree.md).
 
@@ -10,5 +10,5 @@ One active child of a [ViewTree](ViewTree.md).
 
 | Property                          | Modifier   | Type                      | Description                                                                      | Defined in                                                                                                                                         |
 | --------------------------------- | ---------- | ------------------------- | -------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-key"></a> `key`   | `readonly` | `string`                  | The key of the child in the `states` of its parent. The outlets are keyed on it. | [packages/play-view/src/compose-views.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L38) |
-| <a id="property-tree"></a> `tree` | `readonly` | [`ViewTree`](ViewTree.md) | The resolved view of the child.                                                  | [packages/play-view/src/compose-views.ts:40](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/compose-views.ts#L40) |
+| <a id="property-key"></a> `key`   | `readonly` | `string`                  | The key of the child in the `states` of its parent. The outlets are keyed on it. | [packages/play-view/src/compose-views.ts:42](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L42) |
+| <a id="property-tree"></a> `tree` | `readonly` | [`ViewTree`](ViewTree.md) | The resolved view of the child.                                                  | [packages/play-view/src/compose-views.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L44) |

package/api/@xmachines/play-view/index/interfaces/Viewable.md

@@ -2,7 +2,7 @@
 
 # Interface: Viewable
 
-Defined in: [packages/play-view/src/view-types.ts:143](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L143)
+Defined in: [packages/play-view/src/view-types.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-types.ts#L138)
 
 The actor capability that exposes a renderable view state.
 
@@ -15,4 +15,4 @@ therefore holds no view logic.
 
 | Property                                        | Modifier   | Type                                                                                                   | Description                                                                                                                                                                                               | Defined in                                                                                                                                     |
 | ----------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-currentview"></a> `currentView` | `readonly` | [`ReadonlyAtom`](../../../play-atom/interfaces/ReadonlyAtom.md)\<[`PlaySpec`](PlaySpec.md) \| `null`\> | The atom of the current view. It holds the json-render PlaySpec of the current machine state, or null when no view is active. The infrastructure renders the view. This is the Logic-Driven UI invariant. | [packages/play-view/src/view-types.ts:150](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L150) |
+| <a id="property-currentview"></a> `currentView` | `readonly` | [`ReadonlyAtom`](../../../play-atom/interfaces/ReadonlyAtom.md)\<[`PlaySpec`](PlaySpec.md) \| `null`\> | The atom of the current view. It holds the json-render PlaySpec of the current machine state, or null when no view is active. The infrastructure renders the view. This is the Logic-Driven UI invariant. | [packages/play-view/src/view-types.ts:145](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-types.ts#L145) |

package/api/@xmachines/play-view/index/type-aliases/StateUpdater.md

@@ -0,0 +1,21 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / StateUpdater
+
+# Type Alias: StateUpdater
+
+```ts
+type StateUpdater = (updater) => void;
+```
+
+Defined in: [packages/play-view/src/provider-guards.ts:194](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/provider-guards.ts#L194)
+
+The update of the state that a `defineRegistry` handler asks for.
+
+## Parameters
+
+| Parameter | Type                                        |
+| --------- | ------------------------------------------- |
+| `updater` | (`prev`) => `Record`\<`string`, `unknown`\> |
+
+## Returns
+
+`void`

package/api/@xmachines/play-view/index/type-aliases/ViewActor.md

@@ -6,7 +6,7 @@
 type ViewActor<TSnapshot, TEvent> = PlayActor<TSnapshot, TEvent> & Viewable;
 ```
 
-Defined in: [packages/play-view/src/view-types.ts:190](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/view-types.ts#L190)
+Defined in: [packages/play-view/src/view-types.ts:185](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-types.ts#L185)
 
 The actor that a view provider reads: the contract, and the view capability.
 

package/api/@xmachines/play-view/index/variables/CONTEXT_STATE_KEY.md

@@ -6,7 +6,7 @@
 const CONTEXT_STATE_KEY: "context" = "context";
 ```
 
-Defined in: [packages/play-view/src/context-projection.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-view/src/context-projection.ts#L34)
+Defined in: [packages/play-view/src/context-projection.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/context-projection.ts#L34)
 
 The reserved top-level state key of the projection.
 

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

@@ -4,7 +4,7 @@
 
 > Vue 3 renderer for the XMachines Play Architecture. It observes the actor atoms and renders the UI through `@xmachines/json-render-vue`.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-6.1.0-blue)](https://www.npmjs.com/package/@xmachines/play-vue)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-7.0.0-blue)](https://www.npmjs.com/package/@xmachines/play-vue)
 
 ---
 
@@ -29,7 +29,7 @@ pnpm add @xmachines/play-vue
 **Peer dependencies.** Install them with the package:
 
 ```bash
-pnpm add vue@^3.5.0 @xmachines/core @xmachines/play @xmachines/play-atom @xstate/store@^4.2.3 @xmachines/json-render-vue@^0.21.0-xm.2 @xmachines/json-render-core@^0.21.0-xm.2 @xmachines/json-render-xstate@^0.21.0-xm.2
+pnpm add vue@^3.5.11 @xmachines/core @xmachines/play @xmachines/play-atom @xstate/store@^4.2.3 @xmachines/json-render-vue@0.21.0-xm.6 @xmachines/json-render-core@0.21.0-xm.6 @xmachines/json-render-xstate@0.21.0-xm.6
 ```
 
 `@xstate/store` is the peer of [`@xmachines/play-atom`](../play-atom/README.md), and not of this
@@ -85,20 +85,20 @@ const registryResult = defineRegistry(myCatalog, {
 
 The composite provider. It wraps `<ActorProvider>` and `JSONUIProvider` in one component. **Use it in most applications.**
 
-| Prop                  | Type                                          | Required | Description                                                            |
-| --------------------- | --------------------------------------------- | -------- | ---------------------------------------------------------------------- |
-| `actor`               | `PlayActor & Viewable`                        | ✅       | The XMachines actor instance                                           |
-| `registryResult`      | `DefineRegistryResult`                        | ✅       | Result of `defineRegistry()`                                           |
-| `store`               | `StateStore`                                  | —        | External controlled state store (optional)                             |
-| `onRenderError`       | `RenderErrorHandler`                          | —        | Error handler for render failures                                      |
-| `onError`             | `(error: unknown, reset: () => void) => void` | —        | Error handler of the outer boundary; the second parameter is the reset |
-| `navigate`            | `(path: string) => void`                      | —        | Link navigation function                                               |
-| `validationFunctions` | `Record<string, Function>`                    | —        | Custom validation functions                                            |
-| `functions`           | `Record<string, Function>`                    | —        | Named functions for `$computed` expressions                            |
+| Prop                  | Type                                          | Required | Description                                                                |
+| --------------------- | --------------------------------------------- | -------- | -------------------------------------------------------------------------- |
+| `actor`               | `PlayActor & Viewable`                        | ✅       | The XMachines actor instance                                               |
+| `registryResult`      | `DefineRegistryResult`                        | ✅       | Result of `defineRegistry()`                                               |
+| `store`               | `StateStore`                                  | —        | External controlled state store (optional)                                 |
+| `onRenderError`       | `OnRenderError`                               | —        | The `(error, name, info)` handler of each failure that json-render reports |
+| `onError`             | `(error: unknown, reset: () => void) => void` | —        | Error handler of the outer boundary; the second parameter is the reset     |
+| `navigate`            | `(path: string) => void`                      | —        | Link navigation function                                                   |
+| `validationFunctions` | `Record<string, Function>`                    | —        | Custom validation functions                                                |
+| `functions`           | `Record<string, Function>`                    | —        | Named functions for `$computed` expressions                                |
 
 **Slots:** `default` (the rendered content), `fallback` (the content while the actor view is `null`, and while the boundary holds an error)
 
-The provider contains an error of the **render** of a descendant — the render function, the setup function, and a lifecycle hook — so that a subtree that throws cannot take the whole application down. It calls `onError`, and it renders the `fallback` slot instead of the children. The next view emission clears the error, so a view transition retries the render. A throw of a catalog component reaches the per-element boundary of `@xmachines/json-render-vue` first, and `onRenderError` reports it; this boundary is the outer net for everything else.
+The provider contains an error of the **render** of a descendant — the render function, the setup function, and a lifecycle hook — so that a subtree that throws cannot take the whole application down. It calls `onError`, and it renders the `fallback` slot instead of the children. The next view emission clears the error, so a view transition retries the render. A throw of a catalog component below the root reaches the per-element boundary of `@xmachines/json-render-vue` first, and `onRenderError` reports it. A failure of the root of the view — its component, a prop, or its `visible` condition — reaches no hook of the host, so the provider contains it as a failure of the view: it calls `onError` one time, it renders the `fallback` slot, and the next view renders again. `onRenderError` also receives it, with the kind `"root"`. This boundary is the outer net for everything else.
 
 The boundary stops a render error, so `app.config.errorHandler` does not see it. Without an `onError` prop the provider therefore writes the error to `console.error`.
 
@@ -112,6 +112,8 @@ Vue reports such an error a **second** time where the application wires no `app.
 
 **One case escapes that rule.** An ancestor `errorCaptured` hook that returns `false` stops Vue before the re-throw, so the record of the provider waits for a repeat that never comes. A second failure in the same flush can take that record. It must carry the same error value, and it must unwind out of the update job of a parent. Vue reports such a failure as a component update. The provider then holds the stale subtree on the screen, and `onError` stays silent.
 
+An event handler of a catalog component below the `Renderer` of `@xmachines/json-render-vue` is different. That renderer throws the error of such a handler again in place, so the window gets it as an `error` event. Neither this provider nor `app.config.errorHandler` sees it.
+
 #### `<PlayRenderer>`
 
 The leaf component without props. It reads the current `spec` and `registry` from the nearest `<ActorProvider>` or `<PlayUIProvider>` context, then renders them with `<Renderer>`. Put it inside one of those providers.
@@ -131,7 +133,7 @@ The low-level provider for a custom provider composition. It owns the complete a
 | `actor`          | `PlayActor & Viewable` | ✅       | The XMachines actor instance    |
 | `registryResult` | `DefineRegistryResult` | ✅       | Result of `defineRegistry()`    |
 | `store`          | `StateStore`           | —        | External controlled state store |
-| `onRenderError`  | `RenderErrorHandler`   | —        | Override render error handler   |
+| `onRenderError`  | `OnRenderError`        | —        | Override render error handler   |
 
 ---
 
@@ -141,7 +143,7 @@ The low-level provider for a custom provider composition. It owns the complete a
 
 This function is the drop-in replacement for `defineRegistry` from `@xmachines/json-render-vue`. **Always import it from `@xmachines/play-vue`** when you work with a Vue SFC, not from `@xmachines/json-render-vue`. The wrapper finds each `.vue` SFC in the `components` map, and wraps it with `h()`. A Vue composable, and also a composable that uses `inject`, then works correctly inside `<script setup>`.
 
-```typescript
+```typescript fragment
 import { defineRegistry } from "@xmachines/play-vue";
 // NOT: import { defineRegistry } from "@xmachines/json-render-vue"
 
@@ -235,6 +237,7 @@ everything from `@xmachines/play-vue`, and not from `@xmachines/json-render-vue`
 - [JSONUIProviderProps](interfaces/JSONUIProviderProps.md)
 - [PlayUIProviderProps](interfaces/PlayUIProviderProps.md)
 - [RendererProps](interfaces/RendererProps.md)
+- [RenderErrorInfo](interfaces/RenderErrorInfo.md)
 - [StateProviderProps](interfaces/StateProviderProps.md)
 - [ValidationProviderProps](interfaces/ValidationProviderProps.md)
 - [ViewContextValue](interfaces/ViewContextValue.md)
@@ -246,7 +249,9 @@ everything from `@xmachines/play-vue`, and not from `@xmachines/json-render-vue`
 - [ComponentFn](type-aliases/ComponentFn.md)
 - [ComponentsMap](type-aliases/ComponentsMap.md)
 - [DefineRegistryOptions](type-aliases/DefineRegistryOptions.md)
+- [OnRenderError](type-aliases/OnRenderError.md)
 - [RenderErrorHandler](type-aliases/RenderErrorHandler.md)
+- [RenderErrorKind](type-aliases/RenderErrorKind.md)
 
 ## Variables
 

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

@@ -6,7 +6,7 @@
 function defineRegistry<C>(catalog, options): DefineRegistryResult;
 ```
 
-Defined in: [packages/play-vue/src/define-registry.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-vue/src/define-registry.ts#L138)
+Defined in: [packages/play-vue/src/define-registry.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-vue/src/define-registry.ts#L138)
 
 Creates a component registry. It wraps each `.vue` SFC, so that the SFC works
 correctly with the render pipeline of `@xmachines/json-render-vue`.

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

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

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

@@ -16,6 +16,12 @@ Composable for two-way bound props. Returns `[value, setValue]` where:
 Designed to work with the `bindings` map that the renderer provides when
 a prop uses `{ $bindState: "/path" }` or `{ $bindItem: "field" }`.
 
+`bindingPath` can be a plain path, a ref or a getter. A registry function
+runs on each render, and it passes `bindings?.value`. The setup of a
+stateful component runs one time, so it passes a getter, such as
+`() => props.bindings?.value`: the setter then writes to the binding of
+now, also when a later spec binds the prop.
+
 ## Type Parameters
 
 | Type Parameter |
@@ -24,10 +30,10 @@ a prop uses `{ $bindState: "/path" }` or `{ $bindItem: "field" }`.
 
 ## Parameters
 
-| Parameter     | Type                    |
-| ------------- | ----------------------- |
-| `propValue`   | `T` \| `undefined`      |
-| `bindingPath` | `string` \| `undefined` |
+| Parameter     | Type                                          |
+| ------------- | --------------------------------------------- |
+| `propValue`   | `T` \| `undefined`                            |
+| `bindingPath` | `MaybeRefOrGetter`\<`string` \| `undefined`\> |
 
 ## Returns
 

package/api/@xmachines/play-vue/functions/useFieldValidation.md

@@ -8,14 +8,21 @@ function useFieldValidation(path, config?): object;
 
 Defined in: `@xmachines/json-render-vue`
 
-Composable to get validation state for a field
+Composable to get validation state for a field.
+
+`path` and `config` can be plain values, refs or getters. A plain path
+stays as it is. A getter or a ref follows its value: a new path or a new
+config of a mounted field registers it again. A component in a keyed row
+passes a getter, such as `() => props.bindings?.value`, so the field
+follows the bound path of now after a move, and a binding that a later
+spec adds.
 
 ## Parameters
 
-| Parameter | Type               |
-| --------- | ------------------ |
-| `path`    | `string`           |
-| `config?` | `ValidationConfig` |
+| Parameter | Type                                                    |
+| --------- | ------------------------------------------------------- |
+| `path`    | `MaybeRefOrGetter`\<`string` \| `undefined`\>           |
+| `config?` | `MaybeRefOrGetter`\<`ValidationConfig` \| `undefined`\> |
 
 ## Returns
 

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

@@ -6,7 +6,7 @@
 function usePlayView(): ViewContextValue;
 ```
 
-Defined in: [packages/play-vue/src/actor-provider-context.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.1.0/packages/play-vue/src/actor-provider-context.ts#L51)
+Defined in: [packages/play-vue/src/actor-provider-context.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-vue/src/actor-provider-context.ts#L51)
 
 Returns the current ViewContextValue inside an ActorProvider tree.