@xmachines/docs 5.0.2 → 6.0.0

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

@@ -4,17 +4,16 @@
 
 The atom primitives for XMachines. They give the Play Architecture fine-grained reactive state. The primitives propagate state without a glitch and without a subscription of the consumer.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-5.0.2-blue)](https://www.npmjs.com/package/@xmachines/play-atom)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-6.0.0-blue)](https://www.npmjs.com/package/@xmachines/play-atom)
 
 ## Installation
 
 ```bash
-pnpm add @xmachines/play-atom @xmachines/play @xstate/store
+pnpm add @xmachines/play-atom @xstate/store
 ```
 
-**Peer dependencies.** Install them with the package:
+**Peer dependency.** Install it with the package:
 
-- [`@xmachines/play`](../play/README.md) — the core protocol. This package reads `asCleanup` and `Cleanup` from it.
 - `@xstate/store` `^4.2.3` — the atom engine.
 
 Install ONE copy of `@xstate/store` — see [One instance](#one-instance).
@@ -109,7 +108,7 @@ count.set(3); // → logs "count changed: 3" once, from a microtask
 cleanup();
 ```
 
-The cleanup function is idempotent. A second call is safe, and it does not throw. It is also a `Disposable`, so `using cleanup = watchAtom(...)` releases it at the end of the scope.
+The cleanup function is idempotent. A second call is safe, and it does not throw. It is a plain function. To release it at the end of a scope, publish it with `asDisposable` of [`@xmachines/core/utils`](../core/README.md): `using cleanup = asDisposable(watchAtom(...))`.
 
 ### `atom.subscribe` — synchronous observation
 
@@ -120,6 +119,18 @@ const subscription = count.subscribe((value) => console.log(value));
 subscription.unsubscribe();
 ```
 
+The subscription is the plain `{ unsubscribe }` of the engine. To hold it with `using`, publish it with `asDisposable` of [`@xmachines/core/utils`](../core/README.md):
+
+```typescript
+import { asDisposable } from "@xmachines/core/utils";
+
+{
+	const plain = count.subscribe((value) => console.log(value));
+	using subscription = asDisposable(plain, () => plain.unsubscribe());
+	count.set(1);
+} // the scope calls unsubscribe()
+```
+
 ### Custom equality
 
 `createAtom` accepts a `compare` option. It controls when an atom notifies its dependents. The default is `Object.is`.
@@ -145,25 +156,24 @@ This package therefore declares `@xstate/store` as a peer dependency. A renderer
 
 ## API Summary
 
-| Export                             | Kind      | Description                                                                                   |
-| ---------------------------------- | --------- | --------------------------------------------------------------------------------------------- |
-| `createAtom(value, options?)`      | function  | The writable atom                                                                             |
-| `createAtom(fn, options?)`         | function  | The computed atom                                                                             |
-| `createWritableAtom(value, opts?)` | function  | The writable atom, with one signature, for a generic value type                               |
-| `createAsyncAtom(fn, options?)`    | function  | The computed atom of a promise. It holds an `AsyncAtomState`. `fn` reads an `AbortSignal`     |
-| `watchAtom(atom, onValue)`         | function  | The coalesced subscription helper. It returns a `Cleanup`                                     |
-| `Atom<T>`                          | interface | The writable atom (`.get()`, `.set()`, `.subscribe()`)                                        |
-| `ReadonlyAtom<T>`                  | interface | The computed atom (`.get()`, `.subscribe()`)                                                  |
-| `Readable<T>`                      | interface | The read side of either one (`.get()`, `.subscribe()`)                                        |
-| `BaseAtom<T>`                      | interface | The common base of both kinds                                                                 |
-| `AnyAtom`                          | type      | An atom of an unknown value type                                                              |
-| `AtomOptions<T>`                   | interface | The options object of `createAtom` (`compare?`)                                               |
-| `AtomObserver<T>`                  | interface | The observer of `subscribe`, in the object form                                               |
-| `AtomSubscription`                 | interface | The release that `subscribe` returns                                                          |
-| `AsyncAtomState<TData>`            | type      | The state of `createAsyncAtom`: `pending`, `done`, or `error`                                 |
-| `AsyncAtomOptions`                 | interface | What `createAsyncAtom` hands its getter: the `signal` that aborts a stale run                 |
-| `CreateAtom`                       | interface | The two call signatures of `createAtom`                                                       |
-| `Cleanup`                          | type      | The release that `watchAtom` returns, re-exported from [`@xmachines/play`](../play/README.md) |
+| Export                             | Kind      | Description                                                                               |
+| ---------------------------------- | --------- | ----------------------------------------------------------------------------------------- |
+| `createAtom(value, options?)`      | function  | The writable atom                                                                         |
+| `createAtom(fn, options?)`         | function  | The computed atom                                                                         |
+| `createWritableAtom(value, opts?)` | function  | The writable atom, with one signature, for a generic value type                           |
+| `createAsyncAtom(fn, options?)`    | function  | The computed atom of a promise. It holds an `AsyncAtomState`. `fn` reads an `AbortSignal` |
+| `watchAtom(atom, onValue)`         | function  | The coalesced subscription helper. It returns a plain release                             |
+| `Atom<T>`                          | interface | The writable atom (`.get()`, `.set()`, `.subscribe()`)                                    |
+| `ReadonlyAtom<T>`                  | interface | The computed atom (`.get()`, `.subscribe()`)                                              |
+| `Readable<T>`                      | interface | The read side of either one (`.get()`, `.subscribe()`)                                    |
+| `BaseAtom<T>`                      | interface | The common base of both kinds                                                             |
+| `AnyAtom`                          | type      | An atom of an unknown value type                                                          |
+| `AtomOptions<T>`                   | interface | The options object of `createAtom` (`compare?`)                                           |
+| `AtomObserver<T>`                  | interface | The observer of `subscribe`, in the object form                                           |
+| `AtomSubscription`                 | interface | The release that `subscribe` returns                                                      |
+| `AsyncAtomState<TData>`            | type      | The state of `createAsyncAtom`: `pending`, `done`, or `error`                             |
+| `AsyncAtomOptions`                 | interface | What `createAsyncAtom` hands its getter: the `signal` that aborts a stale run             |
+| `CreateAtom`                       | interface | The two call signatures of `createAtom`                                                   |
 
 The observer types carry the `Atom` prefix on purpose: `xstate` declares `Observer` and `Subscription` too, so a plain name here would put two declarations of one name in one file. `Subscribable` stays out of the surface for the same reason.
 
@@ -268,7 +278,6 @@ updates never.
 
 - [AnyAtom](type-aliases/AnyAtom.md)
 - [AsyncAtomState](type-aliases/AsyncAtomState.md)
-- [Cleanup](type-aliases/Cleanup.md)
 
 ## Variables
 

package/api/@xmachines/play-atom/functions/watchAtom.md

@@ -3,10 +3,10 @@
 # Function: watchAtom()
 
 ```ts
-function watchAtom<T>(atom, onValue): Cleanup;
+function watchAtom<T>(atom, onValue): () => void;
 ```
 
-Defined in: [play-atom/src/watch-atom.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/watch-atom.ts#L58)
+Defined in: [watch-atom.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/watch-atom.ts#L57)
 
 Subscribes to one atom, and coalesces the notifications into one microtask.
 
@@ -37,12 +37,12 @@ and the microtask queue drains never. That is the loop of the caller, and this
 function bounds it not. A write of the SAME value ends the sequence by itself,
 because an atom notifies for a value that it holds already never.
 
-The return is a [Cleanup](../type-aliases/Cleanup.md): a function, and a `Disposable`. A caller that keeps
-the release in a field and runs it from a teardown keeps that code. A caller inside
-one scope writes `using` and writes no teardown:
+The return is a plain function. A caller that keeps the release in a field runs it
+from a teardown. A caller inside one scope publishes it with `asDisposable` of
+`@xmachines/core/utils`, writes `using`, and writes no teardown:
 
 ```ts
-using stop = watchAtom(count, render);
+using stop = asDisposable(watchAtom(count, render));
 ```
 
 ## Type Parameters
@@ -60,10 +60,10 @@ using stop = watchAtom(count, render);
 
 ## Returns
 
-[`Cleanup`](../type-aliases/Cleanup.md)
-
 The release. It removes the subscription.
 
+() => `void`
+
 ## Example
 
 ```typescript

package/api/@xmachines/play-atom/interfaces/AsyncAtomOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: AsyncAtomOptions
 
-Defined in: [play-atom/src/types.ts:168](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L168)
+Defined in: [types.ts:168](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L168)
 
 What `createAsyncAtom` gives its getter
 
@@ -11,6 +11,6 @@ stale answer reaches the atom never. Pass it to `fetch`, and the request stops w
 
 ## Properties
 
-| Property                              | Modifier   | Type          | Description                                                  | Defined in                                                                                                                  |
-| ------------------------------------- | ---------- | ------------- | ------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-signal"></a> `signal` | `readonly` | `AbortSignal` | Aborted when the atom derives again before this run settles. | [play-atom/src/types.ts:170](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L170) |
+| Property                              | Modifier   | Type          | Description                                                  | Defined in                                                                                                    |
+| ------------------------------------- | ---------- | ------------- | ------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------- |
+| <a id="property-signal"></a> `signal` | `readonly` | `AbortSignal` | Aborted when the atom derives again before this run settles. | [types.ts:170](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L170) |

package/api/@xmachines/play-atom/interfaces/Atom.md

@@ -2,7 +2,7 @@
 
 # Interface: Atom\<T\>
 
-Defined in: [play-atom/src/types.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L117)
+Defined in: [types.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L117)
 
 The writable atom. It holds one reactive value
 
@@ -40,7 +40,7 @@ name.set((previous) => previous.toUpperCase()); // "BOB"
 get(): T;
 ```
 
-Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L59)
+Defined in: [types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L59)
 
 #### Returns
 
@@ -60,7 +60,7 @@ Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-
 set(fn): void;
 ```
 
-Defined in: [play-atom/src/types.ts:119](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L119)
+Defined in: [types.ts:119](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L119)
 
 Sets the value of the atom from the previous value.
 
@@ -80,7 +80,7 @@ Sets the value of the atom from the previous value.
 set(value): void;
 ```
 
-Defined in: [play-atom/src/types.ts:121](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L121)
+Defined in: [types.ts:121](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L121)
 
 Sets the value of the atom.
 
@@ -104,7 +104,7 @@ Sets the value of the atom.
 subscribe(observer): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L60)
+Defined in: [types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L60)
 
 ##### Parameters
 
@@ -130,7 +130,7 @@ subscribe(
 ): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L61)
+Defined in: [types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L61)
 
 ##### Parameters
 

package/api/@xmachines/play-atom/interfaces/AtomObserver.md

@@ -2,7 +2,7 @@
 
 # Interface: AtomObserver\<T\>
 
-Defined in: [play-atom/src/types.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L34)
+Defined in: [types.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L34)
 
 The observer of an atom, in the object form
 
@@ -18,8 +18,8 @@ consumers that adapt an atom to an observable.
 
 ## Properties
 
-| Property                                   | Type                | Defined in                                                                                                                |
-| ------------------------------------------ | ------------------- | ------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-complete"></a> `complete?` | () => `void`        | [play-atom/src/types.ts:37](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L37) |
-| <a id="property-error"></a> `error?`       | (`error`) => `void` | [play-atom/src/types.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L36) |
-| <a id="property-next"></a> `next?`         | (`value`) => `void` | [play-atom/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L35) |
+| Property                                   | Type                | Defined in                                                                                                  |
+| ------------------------------------------ | ------------------- | ----------------------------------------------------------------------------------------------------------- |
+| <a id="property-complete"></a> `complete?` | () => `void`        | [types.ts:37](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L37) |
+| <a id="property-error"></a> `error?`       | (`error`) => `void` | [types.ts:36](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L36) |
+| <a id="property-next"></a> `next?`         | (`value`) => `void` | [types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L35) |

package/api/@xmachines/play-atom/interfaces/AtomOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: AtomOptions\<T\>
 
-Defined in: [play-atom/src/types.ts:147](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L147)
+Defined in: [types.ts:147](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L147)
 
 The options of `createAtom`
 
@@ -28,6 +28,6 @@ const point = createAtom(
 
 ## Properties
 
-| Property                                 | Type                              | Defined in                                                                                                                  |
-| ---------------------------------------- | --------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-compare"></a> `compare?` | (`previous`, `next`) => `boolean` | [play-atom/src/types.ts:148](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L148) |
+| Property                                 | Type                              | Defined in                                                                                                    |
+| ---------------------------------------- | --------------------------------- | ------------------------------------------------------------------------------------------------------------- |
+| <a id="property-compare"></a> `compare?` | (`previous`, `next`) => `boolean` | [types.ts:148](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L148) |

package/api/@xmachines/play-atom/interfaces/AtomSubscription.md

@@ -2,7 +2,7 @@
 
 # Interface: AtomSubscription
 
-Defined in: [play-atom/src/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L23)
+Defined in: [types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L23)
 
 The release of one subscription
 
@@ -16,7 +16,7 @@ The release of one subscription
 unsubscribe(): void;
 ```
 
-Defined in: [play-atom/src/types.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L24)
+Defined in: [types.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L24)
 
 #### Returns
 

package/api/@xmachines/play-atom/interfaces/BaseAtom.md

@@ -2,7 +2,7 @@
 
 # Interface: BaseAtom\<T\>
 
-Defined in: [play-atom/src/types.ts:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L74)
+Defined in: [types.ts:74](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L74)
 
 The common base of a writable atom and a computed atom
 
@@ -32,7 +32,7 @@ both kinds.
 get(): T;
 ```
 
-Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L59)
+Defined in: [types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L59)
 
 #### Returns
 
@@ -52,7 +52,7 @@ Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-
 subscribe(observer): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L60)
+Defined in: [types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L60)
 
 ##### Parameters
 
@@ -78,7 +78,7 @@ subscribe(
 ): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L61)
+Defined in: [types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L61)
 
 ##### Parameters
 

package/api/@xmachines/play-atom/interfaces/CreateAtom.md

@@ -2,7 +2,7 @@
 
 # Interface: CreateAtom()
 
-Defined in: [play-atom/src/create-atom.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/create-atom.ts#L33)
+Defined in: [create-atom.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/create-atom.ts#L33)
 
 The two forms of `createAtom`
 
@@ -22,7 +22,7 @@ because `get` tracked the edge already.
 CreateAtom<T>(getValue, options?): ReadonlyAtom<T>;
 ```
 
-Defined in: [play-atom/src/create-atom.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/create-atom.ts#L34)
+Defined in: [create-atom.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/create-atom.ts#L34)
 
 The two forms of `createAtom`
 
@@ -59,7 +59,7 @@ because `get` tracked the edge already.
 CreateAtom<T>(initialValue, options?): Atom<T>;
 ```
 
-Defined in: [play-atom/src/create-atom.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/create-atom.ts#L35)
+Defined in: [create-atom.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/create-atom.ts#L35)
 
 The two forms of `createAtom`
 

package/api/@xmachines/play-atom/interfaces/Readable.md

@@ -2,7 +2,7 @@
 
 # Interface: Readable\<T\>
 
-Defined in: [play-atom/src/types.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L58)
+Defined in: [types.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L58)
 
 The read side of an atom
 
@@ -40,7 +40,7 @@ show(createAtom("ready")); // "ready"
 get(): T;
 ```
 
-Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L59)
+Defined in: [types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L59)
 
 #### Returns
 
@@ -56,7 +56,7 @@ Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-
 subscribe(observer): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L60)
+Defined in: [types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L60)
 
 ##### Parameters
 
@@ -78,7 +78,7 @@ subscribe(
 ): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L61)
+Defined in: [types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L61)
 
 ##### Parameters
 

package/api/@xmachines/play-atom/interfaces/ReadonlyAtom.md

@@ -2,7 +2,7 @@
 
 # Interface: ReadonlyAtom\<T\>
 
-Defined in: [play-atom/src/types.ts:97](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L97)
+Defined in: [types.ts:97](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L97)
 
 The computed atom. It evaluates late, and it memoizes the result
 
@@ -43,7 +43,7 @@ console.log(doubled.get()); // 10 (from the memory, with no new computation)
 get(): T;
 ```
 
-Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L59)
+Defined in: [types.ts:59](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L59)
 
 #### Returns
 
@@ -63,7 +63,7 @@ Defined in: [play-atom/src/types.ts:59](https://gitlab.com/xmachin-es/xmachines-
 subscribe(observer): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L60)
+Defined in: [types.ts:60](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L60)
 
 ##### Parameters
 
@@ -89,7 +89,7 @@ subscribe(
 ): AtomSubscription;
 ```
 
-Defined in: [play-atom/src/types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L61)
+Defined in: [types.ts:61](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L61)
 
 ##### Parameters
 

package/api/@xmachines/play-atom/type-aliases/AnyAtom.md

@@ -6,7 +6,7 @@
 type AnyAtom = BaseAtom<unknown>;
 ```
 
-Defined in: [play-atom/src/types.ts:129](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L129)
+Defined in: [types.ts:129](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L129)
 
 An atom of an unknown value type
 

package/api/@xmachines/play-atom/type-aliases/AsyncAtomState.md

@@ -17,7 +17,7 @@ type AsyncAtomState<TData, TError> =
 	  };
 ```
 
-Defined in: [play-atom/src/types.ts:157](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/types.ts#L157)
+Defined in: [types.ts:157](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/types.ts#L157)
 
 The state of an atom that reads a promise
 

package/api/@xmachines/play-atom/variables/createAsyncAtom.md

@@ -7,7 +7,7 @@ const createAsyncAtom: <T>(getValue, options?) => ReadonlyAtom<AsyncAtomState<T>
 	createEngineAsyncAtom;
 ```
 
-Defined in: [play-atom/src/create-atom.ts:64](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/create-atom.ts#L64)
+Defined in: [create-atom.ts:64](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/create-atom.ts#L64)
 
 Builds a read-only atom that holds the state of a promise
 

package/api/@xmachines/play-atom/variables/createAtom.md

@@ -6,7 +6,7 @@
 const createAtom: CreateAtom = createEngineAtom;
 ```
 
-Defined in: [play-atom/src/create-atom.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/create-atom.ts#L47)
+Defined in: [create-atom.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/create-atom.ts#L47)
 
 Builds a writable atom from a value, and a computed atom from a function
 

package/api/@xmachines/play-atom/variables/createWritableAtom.md

@@ -6,7 +6,7 @@
 const createWritableAtom: <T>(initialValue, options?) => Atom<T> = createAtom;
 ```
 
-Defined in: [play-atom/src/create-writable-atom.ts:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v5.0.2/packages/play-atom/src/create-writable-atom.ts#L50)
+Defined in: [create-writable-atom.ts:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v6.0.0/packages/play-atom/src/create-writable-atom.ts#L50)
 
 Builds a WRITABLE atom, and never a computed one.
 

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

@@ -4,7 +4,7 @@
 
 Vanilla DOM renderer for XMachines Play architecture with atom-driven rendering.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-5.0.2-blue)](https://www.npmjs.com/package/@xmachines/play-dom)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Version](https://img.shields.io/badge/version-6.0.0-blue)](https://www.npmjs.com/package/@xmachines/play-dom)
 
 ## Installation
 
@@ -15,9 +15,11 @@ pnpm add @xmachines/play-dom
 **Peer dependencies:**
 
 ```bash
-pnpm add @xmachines/play @xmachines/play-atom @xstate/store @xmachines/json-render-core @xmachines/json-render-dom @xmachines/json-render-xstate
+pnpm add @xmachines/core @xmachines/play @xmachines/play-atom @xstate/store @xmachines/json-render-core @xmachines/json-render-dom @xmachines/json-render-xstate
 ```
 
+[`@xmachines/play`](../play/README.md) is the peer of [`@xmachines/play-view`](../play-view/README.md), which this package depends on. Install ONE copy of it.
+
 `@xstate/store` is the peer of [`@xmachines/play-atom`](../play-atom/README.md), and not of this
 package: this package reads the atom through [`@xmachines/play-atom`](../play-atom/README.md) and
 imports the engine in no source file. Install ONE copy of it.
@@ -302,15 +304,15 @@ The four framework renderers contain a failed render always, because an error bo
 a framework is not an option that a caller turns off. This change puts play-dom on the
 same rule.
 
-**To escalate a failure, raise it from a task of your own:**
+**To escalate a failure, raise it from a task of your own.** The example imports `rethrowLater` from [`@xmachines/core/utils`](../core/README.md). Install that package next to this one, because your code imports it and a package manager such as pnpm does not let your code import a package that it does not declare:
 
 ```typescript
+import { rethrowLater } from "@xmachines/core/utils";
+
 const mount = createPlayUI(registryResult, {
 	onError: (err) => {
 		reportToSentry(err);
-		queueMicrotask(() => {
-			throw err; // the page keeps its own global handler
-		});
+		rethrowLater(err); // the page keeps its own global handler
 	},
 });
 ```
@@ -367,35 +369,33 @@ const Home: ComponentFn<typeof catalog, "Home"> = ({ ctx }) => {
 
 ### XMachines Layer
 
-| Export                                   | Kind     | Description                                                                          |
-| ---------------------------------------- | -------- | ------------------------------------------------------------------------------------ |
-| `createRenderer(catalog, components)`    | function | The one-call factory. Its `mount` hands a `Cleanup` back                             |
-| `createPlayUI(registryResult, options?)` | function | The complete factory. It returns a `MountFn`                                         |
-| `PlayRenderer`                           | class    | The renderer class, with a `connect()` and `disconnect()` lifecycle                  |
-| `defineRegistry(catalog, options)`       | function | Build a catalog-typed `DomRegistry` with typed handlers                              |
-| `renderSpec(...)`                        | function | The pure low-level Spec → DOM renderer                                               |
-| `schema`                                 | const    | The `@xmachines/json-render-dom` schema — pass to `defineCatalog()`                  |
-| `asCleanup`, `Cleanup`                   | —        | The release a mount returns, re-exported from [`@xmachines/play`](../play/README.md) |
+| Export                                   | Kind     | Description                                                         |
+| ---------------------------------------- | -------- | ------------------------------------------------------------------- |
+| `createRenderer(catalog, components)`    | function | The one-call factory. Its `mount` hands a plain release back        |
+| `createPlayUI(registryResult, options?)` | function | The complete factory. It returns a `MountFn`                        |
+| `PlayRenderer`                           | class    | The renderer class, with a `connect()` and `disconnect()` lifecycle |
+| `defineRegistry(catalog, options)`       | function | Build a catalog-typed `DomRegistry` with typed handlers             |
+| `renderSpec(...)`                        | function | The pure low-level Spec → DOM renderer                              |
+| `schema`                                 | const    | The `@xmachines/json-render-dom` schema — pass to `defineCatalog()` |
 
 ### Key Types
 
-| Type                     | Description                                                                                                   |
-| ------------------------ | ------------------------------------------------------------------------------------------------------------- |
-| `ComponentFn<C, K>`      | Catalog-typed component function — returns `HTMLElement \| Text \| null`                                      |
-| `ComponentContext<C, K>` | The context of each component: `props`, `children`, `emit`, `on`, `bindings`, and `ctx`                       |
-| `ActionFn<C, K>`         | Catalog-typed action function — receives `(params, setState, state)`                                          |
-| `EventHandle`            | The handle that `on(eventName)` returns. It has `emit()`, `shouldPreventDefault`, and `bound`                 |
-| `SetState`               | State updater: `(prev => next) => void`                                                                       |
-| `DefineRegistryResult`   | The result of `defineRegistry`. It has `registry`, `handlers`, and `executeAction`                            |
-| `PlayDomOptions`         | Options for `PlayRenderer` — extends `UIProviderOptions`, adds `fallback` and `onError`                       |
-| `CreatePlayUIOptions`    | Options for `createPlayUI` — extends `UIProviderOptions`, adds `fallback` and `onError`                       |
-| `MountOptions`           | Per-mount options for `MountFn`: `store`, `loading`                                                           |
-| `MountFn`                | The mount: `(actor, container, options?) → Cleanup`. `createPlayUI` returns one, and a consumer may write one |
-| `UIProviderOptions`      | Shared options: `functions`, `validationFunctions`, `navigate`, `onRenderError`                               |
-| `BaseComponentProps<P>`  | Catalog-agnostic component props for shared component libraries                                               |
-| `DomRegistry`            | Raw registry type: `Record<string, DomComponentRenderer>`                                                     |
-| `DomSchema`              | Type of the `schema` export                                                                                   |
-| `Cleanup`                | The release of a mount, re-exported from [`@xmachines/play`](../play/README.md)                               |
+| Type                     | Description                                                                                                      |
+| ------------------------ | ---------------------------------------------------------------------------------------------------------------- |
+| `ComponentFn<C, K>`      | Catalog-typed component function — returns `HTMLElement \| Text \| null`                                         |
+| `ComponentContext<C, K>` | The context of each component: `props`, `children`, `emit`, `on`, `bindings`, and `ctx`                          |
+| `ActionFn<C, K>`         | Catalog-typed action function — receives `(params, setState, state)`                                             |
+| `EventHandle`            | The handle that `on(eventName)` returns. It has `emit()`, `shouldPreventDefault`, and `bound`                    |
+| `SetState`               | State updater: `(prev => next) => void`                                                                          |
+| `DefineRegistryResult`   | The result of `defineRegistry`. It has `registry`, `handlers`, and `executeAction`                               |
+| `PlayDomOptions`         | Options for `PlayRenderer` — extends `UIProviderOptions`, adds `fallback` and `onError`                          |
+| `CreatePlayUIOptions`    | Options for `createPlayUI` — extends `UIProviderOptions`, adds `fallback` and `onError`                          |
+| `MountOptions`           | Per-mount options for `MountFn`: `store`, `loading`                                                              |
+| `MountFn`                | The mount: `(actor, container, options?) → () => void`. `createPlayUI` returns one, and a consumer may write one |
+| `UIProviderOptions`      | Shared options: `functions`, `validationFunctions`, `navigate`, `onRenderError`                                  |
+| `BaseComponentProps<P>`  | Catalog-agnostic component props for shared component libraries                                                  |
+| `DomRegistry`            | Raw registry type: `Record<string, DomComponentRenderer>`                                                        |
+| `DomSchema`              | Type of the `schema` export                                                                                      |
 
 ## Rendering Behavior
 
@@ -455,7 +455,6 @@ The public API has two layers:
 - [Actions](type-aliases/Actions.md)
 - [BaseComponentProps](type-aliases/BaseComponentProps.md)
 - [CatalogHasActions](type-aliases/CatalogHasActions.md)
-- [Cleanup](type-aliases/Cleanup.md)
 - [ComponentFn](type-aliases/ComponentFn.md)
 - [ComponentRegistry](type-aliases/ComponentRegistry.md)
 - [ConfirmHandler](type-aliases/ConfirmHandler.md)
@@ -473,7 +472,6 @@ The public API has two layers:
 
 ## Functions
 
-- [asCleanup](functions/asCleanup.md)
 - [createPlayUI](functions/createPlayUI.md)
 - [createRenderer](functions/createRenderer.md)
 - [createValidationRegistry](functions/createValidationRegistry.md)