@xmachines/docs 6.0.0 → 7.0.0

package/api/@xmachines/play-view/errors/classes/ViewElementKeyCollisionError.md

@@ -0,0 +1,181 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [errors](../README.md) / ViewElementKeyCollisionError
+
+# Class: ViewElementKeyCollisionError
+
+Defined in: [packages/play-view/src/errors.ts:115](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/errors.ts#L115)
+
+Two views of one composition hold an element with the same key.
+
+The keys of the outermost view carry no prefix, and each key of a child view gets the
+id of its state and a `/` as a prefix. A key of the outer view such as `"page/root"`
+therefore equals the key of the element `root` of the child state `page`. One of the
+two elements then has no place in the flat spec, and an outlet can point back to its
+own layout, so the derivation refuses the composition. The actor reports the error
+through its `onError` option and keeps the last good view.
+
+## Extends
+
+- [`PlayError`](../../../play/errors/classes/PlayError.md)
+
+## Constructors
+
+### Constructor
+
+```ts
+new ViewElementKeyCollisionError(stateId, key): ViewElementKeyCollisionError;
+```
+
+Defined in: [packages/play-view/src/errors.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/errors.ts#L125)
+
+#### Parameters
+
+| Parameter | Type     | Description                                                      |
+| --------- | -------- | ---------------------------------------------------------------- |
+| `stateId` | `string` | The id of the state node whose view declares the second element. |
+| `key`     | `string` | The key of the element in the composed spec.                     |
+
+#### Returns
+
+`ViewElementKeyCollisionError`
+
+#### Overrides
+
+[`PlayError`](../../../play/errors/classes/PlayError.md).[`constructor`](../../../play/errors/classes/PlayError.md#constructor)
+
+## Properties
+
+| Property                                                | Modifier   | Type      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       | Inherited from                                                                                                                                   | Defined in                                                                                                                             |
+| ------------------------------------------------------- | ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-cause"></a> `cause?`                    | `public`   | `unknown` | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](../../../play/errors/classes/PlayError.md).[`cause`](../../../play/errors/classes/PlayError.md#property-cause)                     | -                                                                                                                                      |
+| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable identifier of the error. An error code follows the naming convention `<PACKAGE>_<DESCRIPTION>`, and a Play package writes `PLAY_<PACKAGE>_<DESCRIPTION>`. A code stays the same across each patch release and each minor release of one major version. Never match on `.message`. Always match on `.code`, or on the subclass.                                                                                         | [`PlayError`](../../../play/errors/classes/PlayError.md).[`code`](../../../play/errors/classes/PlayError.md#property-code)                       | [packages/core/src/errors.ts:56](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/core/src/errors.ts#L56)             |
+| <a id="property-key"></a> `key`                         | `readonly` | `string`  | The key of the element in the composed spec.                                                                                                                                                                                                                                                                                                                                                                                                      | -                                                                                                                                                | [packages/play-view/src/errors.ts:119](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/errors.ts#L119) |
+| <a id="property-message"></a> `message`                 | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](../../../play/errors/classes/PlayError.md).[`message`](../../../play/errors/classes/PlayError.md#property-message)                 | -                                                                                                                                      |
+| <a id="property-name"></a> `name`                       | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](../../../play/errors/classes/PlayError.md).[`name`](../../../play/errors/classes/PlayError.md#property-name)                       | -                                                                                                                                      |
+| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or the module that threw this error, for example `"asDisposable"`.                                                                                                                                                                                                                                                                                                                                                                      | [`PlayError`](../../../play/errors/classes/PlayError.md).[`scope`](../../../play/errors/classes/PlayError.md#property-scope)                     | [packages/core/src/errors.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/core/src/errors.ts#L46)             |
+| <a id="property-stack"></a> `stack?`                    | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](../../../play/errors/classes/PlayError.md).[`stack`](../../../play/errors/classes/PlayError.md#property-stack)                     | -                                                                                                                                      |
+| <a id="property-stateid"></a> `stateId`                 | `readonly` | `string`  | The id of the state node whose view declares the second element.                                                                                                                                                                                                                                                                                                                                                                                  | -                                                                                                                                                | [packages/play-view/src/errors.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/errors.ts#L117) |
+| <a id="property-stacktracelimit"></a> `stackTraceLimit` | `static`   | `number`  | The `Error.stackTraceLimit` property specifies the number of stack frames collected by a stack trace (whether generated by `new Error().stack` or `Error.captureStackTrace(obj)`). The default value is `10` but may be set to any valid JavaScript number. Changes will affect any stack trace captured _after_ the value has been changed. If set to a non-number value, or set to a negative number, stack traces will not capture any frames. | [`PlayError`](../../../play/errors/classes/PlayError.md).[`stackTraceLimit`](../../../play/errors/classes/PlayError.md#property-stacktracelimit) | -                                                                                                                                      |
+
+## Methods
+
+### captureStackTrace()
+
+```ts
+static captureStackTrace(targetObject, constructorOpt?): void;
+```
+
+Defined in: `@types/node`
+
+Creates a `.stack` property on `targetObject`, which when accessed returns
+a string representing the location in the code at which
+`Error.captureStackTrace()` was called.
+
+```js
+const myObject = {};
+Error.captureStackTrace(myObject);
+myObject.stack; // Similar to `new Error().stack`
+```
+
+The first line of the trace will be prefixed with
+`${myObject.name}: ${myObject.message}`.
+
+The optional `constructorOpt` argument accepts a function. If given, all frames
+above `constructorOpt`, including `constructorOpt`, will be omitted from the
+generated stack trace.
+
+The `constructorOpt` argument is useful for hiding implementation
+details of error generation from the user. For instance:
+
+```js
+function a() {
+	b();
+}
+
+function b() {
+	c();
+}
+
+function c() {
+	// Create an error without stack trace to avoid calculating the stack trace twice.
+	const { stackTraceLimit } = Error;
+	Error.stackTraceLimit = 0;
+	const error = new Error();
+	Error.stackTraceLimit = stackTraceLimit;
+
+	// Capture the stack trace above function b
+	Error.captureStackTrace(error, b); // Neither function c, nor b is included in the stack trace
+	throw error;
+}
+
+a();
+```
+
+#### Parameters
+
+| Parameter         | Type       |
+| ----------------- | ---------- |
+| `targetObject`    | `object`   |
+| `constructorOpt?` | `Function` |
+
+#### Returns
+
+`void`
+
+#### Inherited from
+
+[`PlayError`](../../../play/errors/classes/PlayError.md).[`captureStackTrace`](../../../play/errors/classes/PlayError.md#capturestacktrace)
+
+---
+
+### isError()
+
+```ts
+static isError(error): error is Error;
+```
+
+Defined in: `typescript`
+
+Indicates whether the argument provided is a built-in Error instance or not.
+
+#### Parameters
+
+| Parameter | Type      |
+| --------- | --------- |
+| `error`   | `unknown` |
+
+#### Returns
+
+`error is Error`
+
+#### Inherited from
+
+[`PlayError`](../../../play/errors/classes/PlayError.md).[`isError`](../../../play/errors/classes/PlayError.md#iserror)
+
+---
+
+### prepareStackTrace()
+
+```ts
+static prepareStackTrace(err, stackTraces): any;
+```
+
+Defined in: `@types/node`
+
+#### Parameters
+
+| Parameter     | Type         |
+| ------------- | ------------ |
+| `err`         | `Error`      |
+| `stackTraces` | `CallSite`[] |
+
+#### Returns
+
+`any`
+
+#### See
+
+https://v8.dev/docs/stack-trace-api#customizing-stack-traces
+
+#### Inherited from
+
+[`PlayError`](../../../play/errors/classes/PlayError.md).[`prepareStackTrace`](../../../play/errors/classes/PlayError.md#preparestacktrace)

package/api/@xmachines/play-view/index/README.md

@@ -22,18 +22,26 @@ package never, and json-render never.
 
 - [BaseActorProviderProps](interfaces/BaseActorProviderProps.md)
 - [BaseViewContextValue](interfaces/BaseViewContextValue.md)
-- [FailureLatch](interfaces/FailureLatch.md)
+- [ComposedView](interfaces/ComposedView.md)
+- [HandlerFactory](interfaces/HandlerFactory.md)
 - [PlaySpec](interfaces/PlaySpec.md)
 - [ReportGuard](interfaces/ReportGuard.md)
 - [ReportGuardMessages](interfaces/ReportGuardMessages.md)
 - [ResolveViewStoreOptions](interfaces/ResolveViewStoreOptions.md)
 - [Viewable](interfaces/Viewable.md)
-- [ViewInputs](interfaces/ViewInputs.md)
+- [ViewMeta](interfaces/ViewMeta.md)
+- [ViewOutlet](interfaces/ViewOutlet.md)
+- [ViewSession](interfaces/ViewSession.md)
+- [ViewSessionOptions](interfaces/ViewSessionOptions.md)
+- [ViewSessionSnapshot](interfaces/ViewSessionSnapshot.md)
 - [ViewStoreLifecycle](interfaces/ViewStoreLifecycle.md)
 - [ViewStoreResolution](interfaces/ViewStoreResolution.md)
+- [ViewTree](interfaces/ViewTree.md)
+- [ViewTreeChild](interfaces/ViewTreeChild.md)
 
 ## Type Aliases
 
+- [StateUpdater](type-aliases/StateUpdater.md)
 - [ViewActor](type-aliases/ViewActor.md)
 
 ## Variables
@@ -43,13 +51,17 @@ package never, and json-render never.
 ## Functions
 
 - [attachRenderErrorHandler](functions/attachRenderErrorHandler.md)
+- [bindStoreHandlers](functions/bindStoreHandlers.md)
 - [composePlayState](functions/composePlayState.md)
-- [createFailureLatch](functions/createFailureLatch.md)
+- [composeViews](functions/composeViews.md)
+- [createActorProxy](functions/createActorProxy.md)
+- [createRenderErrorBinding](functions/createRenderErrorBinding.md)
 - [createReportGuard](functions/createReportGuard.md)
+- [createViewSession](functions/createViewSession.md)
 - [createViewStoreLifecycle](functions/createViewStoreLifecycle.md)
+- [forwardRenderError](functions/forwardRenderError.md)
 - [guardContextWrites](functions/guardContextWrites.md)
 - [refreshContextSubtree](functions/refreshContextSubtree.md)
 - [reuseComposedState](functions/reuseComposedState.md)
-- [sameViewInputs](functions/sameViewInputs.md)
 - [toAtomState](functions/toAtomState.md)
 - [typedSpec](functions/typedSpec.md)

package/api/@xmachines/play-view/index/functions/attachRenderErrorHandler.md

@@ -6,7 +6,7 @@
 function attachRenderErrorHandler<TRegistry>(registry, handler): TRegistry;
 ```
 
-Defined in: [packages/play-view/src/provider-guards.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/provider-guards.ts#L68)
+Defined in: [packages/play-view/src/provider-guards.ts:78](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/provider-guards.ts#L78)
 
 Copies a component registry, and puts an `onRenderError` handler into the copy.
 
@@ -16,10 +16,11 @@ injection for every framework renderer). The handler therefore replaces each
 handler of the `defineRegistry` level, and it does not appear in an enumeration of
 the component entries of the registry.
 
-The function never changes the registry of the caller: it returns a shallow copy.
-Therefore a caller that needs a handler for each instance, such as an
-`onRenderError` prop of `ActorProvider`, can share one result of `defineRegistry`
-between the providers in a safe way.
+The function never changes the registry of the caller: it returns the copy of
+`withRenderErrorHandler`, which keeps the slot metadata of the registry. Therefore a
+caller that needs a handler for each instance, such as an `onRenderError` prop of
+`ActorProvider`, can share one result of `defineRegistry` between the providers in a
+safe way.
 
 ## Type Parameters
 
@@ -29,10 +30,10 @@ between the providers in a safe way.
 
 ## Parameters
 
-| Parameter  | Type                                                                         | Description                                                                                          |
-| ---------- | ---------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
-| `registry` | `TRegistry`                                                                  | The component registry from `defineRegistry().registry`.                                             |
-| `handler`  | [`RenderErrorHandler`](../../../play-dom/type-aliases/RenderErrorHandler.md) | The renderer calls it with `(error, componentName)` when a catalog component throws during a render. |
+| Parameter  | Type                                                               | Description                                                                                                                                                    |
+| ---------- | ------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `registry` | `TRegistry`                                                        | The component registry from `defineRegistry().registry`.                                                                                                       |
+| `handler`  | [`OnRenderError`](../../../play-dom/type-aliases/OnRenderError.md) | The renderer calls it with `(error, name, info)` for each failure that it reports. `info.kind` names the kind of the failure, such as `"element"` or `"root"`. |
 
 ## Returns
 

package/api/@xmachines/play-view/index/functions/bindStoreHandlers.md

@@ -0,0 +1,34 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / bindStoreHandlers
+
+# Function: bindStoreHandlers()
+
+```ts
+function bindStoreHandlers<THandlers>(registryResult, getStore): THandlers;
+```
+
+Defined in: [packages/play-view/src/provider-guards.ts:218](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/provider-guards.ts#L218)
+
+Builds the action handlers of a registry against a state store.
+
+A handler reads the state and writes it through two getters, and each getter reads the
+store at the moment of the call. A provider whose store changes identity therefore
+passes a getter that returns the current store, and the handlers stay valid.
+
+## Type Parameters
+
+| Type Parameter |
+| -------------- |
+| `THandlers`    |
+
+## Parameters
+
+| Parameter        | Type                                                               | Description                                                                                                               |
+| ---------------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------- |
+| `registryResult` | [`HandlerFactory`](../interfaces/HandlerFactory.md)\<`THandlers`\> | The result of `defineRegistry` of the framework.                                                                          |
+| `getStore`       | () => `Pick`\<`StateStore`, `"getSnapshot"` \| `"update"`\>        | Returns the store that the handlers read and write: a `StateStore`, or the value of a `useStateStore()` of the framework. |
+
+## Returns
+
+`THandlers`
+
+The handlers of the registry.

package/api/@xmachines/play-view/index/functions/composePlayState.md

@@ -6,7 +6,7 @@
 function composePlayState(authoredState, slice): Record<string, unknown> | undefined;
 ```
 
-Defined in: [packages/play-view/src/context-projection.ts:203](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/context-projection.ts#L203)
+Defined in: [packages/play-view/src/context-projection.ts:207](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/context-projection.ts#L207)
 
 Composes the effective state of a view: the authored `spec.state` and the
 `/context` slice.

package/api/@xmachines/play-view/index/functions/composeViews.md

@@ -0,0 +1,41 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / composeViews
+
+# Function: composeViews()
+
+```ts
+function composeViews(tree): ComposedView;
+```
+
+Defined in: [packages/play-view/src/compose-views.ts:173](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/compose-views.ts#L173)
+
+Grafts the views of a [ViewTree](../interfaces/ViewTree.md) into one flat spec.
+
+Each child view goes into the outlet of its key, or into the `"*"` outlet. A child
+with neither outlet stays off the screen. The child root lands at the END of the
+`children` or of the named slot of the outlet element, after the elements that the
+parent put there itself, and the children of a parallel state land in the order of
+the machine.
+
+The function makes a NEW object on each call. A caller that emits the composed view
+on each snapshot keeps one result for each tree, so that `elements` and `viewParts`
+keep their identity: play-xstate keeps one for each tree of each machine.
+
+## Parameters
+
+| Parameter | Type                                    | Description                                                        |
+| --------- | --------------------------------------- | ------------------------------------------------------------------ |
+| `tree`    | [`ViewTree`](../interfaces/ViewTree.md) | The resolved views, from the outermost view that declares outlets. |
+
+## Returns
+
+[`ComposedView`](../interfaces/ComposedView.md)
+
+The static half of the composed view.
+
+## Throws
+
+When an outlet names an element that its view does not hold.
+
+## Throws
+
+When two views of the composition hold an element with the same key.

package/api/@xmachines/play-view/index/functions/createActorProxy.md

@@ -0,0 +1,39 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / createActorProxy
+
+# Function: createActorProxy()
+
+```ts
+function createActorProxy<TActor>(getActor): TActor;
+```
+
+Defined in: [packages/play-view/src/actor-proxy.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/actor-proxy.ts#L32)
+
+Makes a proxy that behaves like the current actor.
+
+- A read, a write, a definition (`Object.defineProperty`), a delete, and a membership
+  test (`in`) reach the current actor.
+- An enumeration (`Object.keys`, a spread) lists the own keys of the current actor.
+- `instanceof` answers with the prototype of the current actor.
+- `Object.preventExtensions` and `Object.freeze` throw a `TypeError`. The proxy stands
+  for each actor of the props in turn, so it cannot promise a fixed set of keys.
+- A method comes back bound to the current actor, so `this` and a private field work
+  as in a direct call. The proxy keeps one bound method for each actor and method, so
+  a repeated read returns the SAME function (`actor.send === actor.send`).
+
+## Type Parameters
+
+| Type Parameter              |
+| --------------------------- |
+| `TActor` _extends_ `object` |
+
+## Parameters
+
+| Parameter  | Type           | Description                                                        |
+| ---------- | -------------- | ------------------------------------------------------------------ |
+| `getActor` | () => `TActor` | Returns the actor of the props. The proxy calls it at each access. |
+
+## Returns
+
+`TActor`
+
+The proxy.

package/api/@xmachines/play-view/index/functions/createRenderErrorBinding.md

@@ -0,0 +1,35 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / createRenderErrorBinding
+
+# Function: createRenderErrorBinding()
+
+```ts
+function createRenderErrorBinding<TResult>(): (result, handler, onRootFailure?) => TResult;
+```
+
+Defined in: [packages/play-view/src/provider-guards.ts:160](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/provider-guards.ts#L160)
+
+Makes a binding of an `onRenderError` handler to a registry result, for one provider.
+
+A provider calls the binding on each render with the registry result, the handler of
+that render, and the containment of a failure of the root. The binding returns:
+
+- the registry result itself, when it receives neither a handler nor a containment;
+- else one copy for each registry. The copy gives each report to
+  [forwardRenderError](forwardRenderError.md), with the LATEST handler, and it gives a failure of the
+  root to the LATEST containment. A host that passes a new inline function on each
+  render therefore keeps one registry identity, and the renderer below resolves no
+  element again for it.
+
+The copy comes from [attachRenderErrorHandler](attachRenderErrorHandler.md), so it keeps the slot metadata.
+
+## Type Parameters
+
+| Type Parameter               | Description                                           |
+| ---------------------------- | ----------------------------------------------------- |
+| `TResult` _extends_ `object` | The result type of `defineRegistry` of the framework. |
+
+## Returns
+
+The binding of one provider.
+
+(`result`, `handler`, `onRootFailure?`) => `TResult`

package/api/@xmachines/play-view/index/functions/createReportGuard.md

@@ -6,7 +6,7 @@
 function createReportGuard(messages): ReportGuard;
 ```
 
-Defined in: [packages/play-view/src/failure-latch.ts:134](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/failure-latch.ts#L134)
+Defined in: [packages/play-view/src/report-guard.ts:98](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/report-guard.ts#L98)
 
 Makes a [ReportGuard](../interfaces/ReportGuard.md).
 

package/api/@xmachines/play-view/index/functions/createViewSession.md

@@ -0,0 +1,29 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / createViewSession
+
+# Function: createViewSession()
+
+```ts
+function createViewSession<TActor>(actor, store, options): ViewSession<TActor>;
+```
+
+Defined in: [packages/play-view/src/view-session.ts:152](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-session.ts#L152)
+
+Makes a view session.
+
+## Type Parameters
+
+| Type Parameter                                                 |
+| -------------------------------------------------------------- |
+| `TActor` _extends_ [`ViewActor`](../type-aliases/ViewActor.md) |
+
+## Parameters
+
+| Parameter | Type                                                        | Description                                                    |
+| --------- | ----------------------------------------------------------- | -------------------------------------------------------------- |
+| `actor`   | `TActor`                                                    | The actor of the provider.                                     |
+| `store`   | `StateStore` \| `undefined`                                 | The controlled store of the host, or `undefined`.              |
+| `options` | [`ViewSessionOptions`](../interfaces/ViewSessionOptions.md) | See [ViewSessionOptions](../interfaces/ViewSessionOptions.md). |
+
+## Returns
+
+[`ViewSession`](../interfaces/ViewSession.md)\<`TActor`\>

package/api/@xmachines/play-view/index/functions/createViewStoreLifecycle.md

@@ -6,7 +6,7 @@
 function createViewStoreLifecycle(createStore): ViewStoreLifecycle;
 ```
 
-Defined in: [packages/play-view/src/view-store-lifecycle.ts:94](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/view-store-lifecycle.ts#L94)
+Defined in: [packages/play-view/src/view-store-lifecycle.ts:135](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-store-lifecycle.ts#L135)
 
 Creates a coordinator of the lifecycle.
 

package/api/@xmachines/play-view/index/functions/forwardRenderError.md

@@ -0,0 +1,45 @@
+[API](../../../../README.md) / [@xmachines/play-view](../../README.md) / [index](../README.md) / forwardRenderError
+
+# Function: forwardRenderError()
+
+```ts
+function forwardRenderError(handler, registry, error, name, info): boolean;
+```
+
+Defined in: [packages/play-view/src/provider-guards.ts:116](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/provider-guards.ts#L116)
+
+Gives one report of json-render to the handler of the host, and tells the caller
+whether the report is a failure of the root.
+
+The five providers hold one rule for a report, and this function holds it for them:
+
+- The report goes to `handler`, the `onRenderError` of the host. Without it, the
+  report goes to the handler that `defineRegistry` put on `registry`. Without that one
+  too, the report goes to the one `[json-render]` console line of core. `info` goes
+  through without a change, and a handler that throws gives its error to `reportError`.
+- A failure of the ROOT (`info.kind` `"root"`) leaves no view on the screen, and the
+  provider contains it as a failure of the view: it shows its fallback, and it calls its
+  `onError`. The function therefore writes no console line for such a report. The
+  containment reports the failure to `onError`, or writes its own line, and a second
+  line would report one failure two times. A handler of the host still receives it.
+- A component can call the handler itself, at the context of the renderer, with the two
+  arguments `(error, name)`. Such a call is no failure of the root. It reaches the
+  handler with the info `{ kind: "element", type: name }`, because the handler of the
+  host declares a required `info`. Without a handler, it goes to one `console.error`
+  line, as the component writes when the context holds no handler.
+
+## Parameters
+
+| Parameter  | Type                                                                                   | Description                                                                 |
+| ---------- | -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| `handler`  | \| [`OnRenderError`](../../../play-dom/type-aliases/OnRenderError.md) \| `undefined`   | The `onRenderError` of the host, or `undefined`.                            |
+| `registry` | `object`                                                                               | The registry of the caller, which can hold the handler of `defineRegistry`. |
+| `error`    | `unknown`                                                                              | The value that failed.                                                      |
+| `name`     | `string`                                                                               | The name of the report: the element type, or the action name of a chain.    |
+| `info`     | \| [`RenderErrorInfo`](../../../play-dom/interfaces/RenderErrorInfo.md) \| `undefined` | The info of the report, or `undefined` for a call of a component.           |
+
+## Returns
+
+`boolean`
+
+`true` for a failure of the root, which the caller contains.

package/api/@xmachines/play-view/index/functions/guardContextWrites.md

@@ -6,7 +6,7 @@
 function guardContextWrites(store): StateStore;
 ```
 
-Defined in: [packages/play-view/src/context-projection.ts:132](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/context-projection.ts#L132)
+Defined in: [packages/play-view/src/context-projection.ts:136](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/context-projection.ts#L136)
 
 ## Parameters
 

package/api/@xmachines/play-view/index/functions/refreshContextSubtree.md

@@ -6,7 +6,7 @@
 function refreshContextSubtree(store, view): void;
 ```
 
-Defined in: [packages/play-view/src/context-projection.ts:185](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/context-projection.ts#L185)
+Defined in: [packages/play-view/src/context-projection.ts:189](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/context-projection.ts#L189)
 
 Refreshes the `/context` subtree of a live store from the composed state of a
 derived view. An emission with the same `viewKey` means that only the projection

package/api/@xmachines/play-view/index/functions/reuseComposedState.md

@@ -6,7 +6,7 @@
 function reuseComposedState(prev, next): PlaySpec | null;
 ```
 
-Defined in: [packages/play-view/src/context-projection.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/context-projection.ts#L68)
+Defined in: [packages/play-view/src/context-projection.ts:72](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/context-projection.ts#L72)
 
 Reuses the composed `state` of the previous emission, or the complete previous
 spec, when the value of the projection did not change.

package/api/@xmachines/play-view/index/functions/toAtomState.md

@@ -6,7 +6,7 @@
 function toAtomState(state): Record<string, unknown>;
 ```
 
-Defined in: [packages/play-view/src/provider-guards.ts:39](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/provider-guards.ts#L39)
+Defined in: [packages/play-view/src/provider-guards.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/provider-guards.ts#L47)
 
 Converts the `state` field of a spec into a plain object for `createAtom`, in a safe way.
 

package/api/@xmachines/play-view/index/functions/typedSpec.md

@@ -3,22 +3,22 @@
 # Function: typedSpec()
 
 ```ts
-function typedSpec(spec): PlaySpec;
+function typedSpec(spec): ViewMeta;
 ```
 
-Defined in: [packages/play-view/src/view-types.ts:76](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-view/src/view-types.ts#L76)
+Defined in: [packages/play-view/src/view-types.ts:126](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v7.0.0/packages/play-view/src/view-types.ts#L126)
 
-The identity helper gives a view spec literal the type `PlaySpec` at the
+The identity helper gives a view spec literal the type [ViewMeta](../interfaces/ViewMeta.md) at the
 definition site. The compiler therefore checks the spec, and the IDE completes it.
 
 The XState `meta` field has the type `Record<string, unknown>`. TypeScript
 therefore infers no spec shape from the context. `typedSpec(...)` is the
-mechanism that starts the check where you write the spec. The parameter holds no
-`viewKey`: the derivation stamps that field, and it overwrites a value from an
-author without a notice. Therefore the compiler refuses a `viewKey` here.
+mechanism that starts the check where you write the spec. `ViewMeta` holds no
+`viewKey` and no `viewParts`: the derivation stamps those fields, and it overwrites
+a value from an author without a notice. Therefore the compiler refuses them here.
 
 The check of an excess property works on an inline object literal only. For a
-spec in a variable, or for a spec from a spread, write `satisfies PlaySpec` at
+spec in a variable, or for a spec from a spread, write `satisfies ViewMeta` at
 the literal instead.
 
 At run time this function does nothing: it returns the spec object without a
@@ -26,13 +26,13 @@ change.
 
 ## Parameters
 
-| Parameter | Type                                                           |
-| --------- | -------------------------------------------------------------- |
-| `spec`    | `Omit`\<[`PlaySpec`](../interfaces/PlaySpec.md), `"viewKey"`\> |
+| Parameter | Type                                    |
+| --------- | --------------------------------------- |
+| `spec`    | [`ViewMeta`](../interfaces/ViewMeta.md) |
 
 ## Returns
 
-[`PlaySpec`](../interfaces/PlaySpec.md)
+[`ViewMeta`](../interfaces/ViewMeta.md)
 
 ## Example