@xmachines/docs 7.1.0 → 7.3.0

package/contributing/deployment.md

@@ -20,34 +20,35 @@ The root `package.json` is marked `"private": true` and is **never published** t
 
 ## Published Packages
 
-The release is in **trains**, each released on its own: `core`, `play` and `docs`. A train publishes every package under its paths that is not private, at the version of the train's release (`release.config.mjs`, `trains`):
-
-| Package                                                                                           | Directory                             | Train  |
-| ------------------------------------------------------------------------------------------------- | ------------------------------------- | ------ |
-| [`@xmachines/core`](../api/@xmachines/core/README.md)                                             | `packages/core`                       | `core` |
-| [`@xmachines/play`](../api/@xmachines/play/README.md)                                             | `packages/play`                       | `play` |
-| [`@xmachines/play-actor`](../api/@xmachines/play-actor/README.md)                                 | `packages/play-actor`                 | `play` |
-| [`@xmachines/play-atom`](../api/@xmachines/play-atom/README.md)                                   | `packages/play-atom`                  | `play` |
-| [`@xmachines/play-dom`](../api/@xmachines/play-dom/README.md)                                     | `packages/play-dom`                   | `play` |
-| [`@xmachines/play-dom-router`](../api/@xmachines/play-dom-router/README.md)                       | `packages/play-dom-router`            | `play` |
-| [`@xmachines/play-pattern`](../api/@xmachines/play-pattern/README.md)                             | `packages/play-pattern`               | `play` |
-| [`@xmachines/play-react`](../api/@xmachines/play-react/README.md)                                 | `packages/play-react`                 | `play` |
-| [`@xmachines/play-react-router`](../api/@xmachines/play-react-router/README.md)                   | `packages/play-react-router`          | `play` |
-| [`@xmachines/play-router`](../api/@xmachines/play-router/README.md)                               | `packages/play-router`                | `play` |
-| [`@xmachines/play-solid`](../api/@xmachines/play-solid/README.md)                                 | `packages/play-solid`                 | `play` |
-| [`@xmachines/play-solid-router`](../api/@xmachines/play-solid-router/README.md)                   | `packages/play-solid-router`          | `play` |
-| [`@xmachines/play-svelte`](../api/@xmachines/play-svelte/README.md)                               | `packages/play-svelte`                | `play` |
-| [`@xmachines/play-svelte-spa-router`](../api/@xmachines/play-svelte-spa-router/README.md)         | `packages/play-svelte-spa-router`     | `play` |
-| [`@xmachines/play-sveltekit-router`](../api/@xmachines/play-sveltekit-router/README.md)           | `packages/play-sveltekit-router`      | `play` |
-| [`@xmachines/play-tanstack-react-router`](../api/@xmachines/play-tanstack-react-router/README.md) | `packages/play-tanstack-react-router` | `play` |
-| [`@xmachines/play-tanstack-router`](../api/@xmachines/play-tanstack-router/README.md)             | `packages/play-tanstack-router`       | `play` |
-| [`@xmachines/play-tanstack-solid-router`](../api/@xmachines/play-tanstack-solid-router/README.md) | `packages/play-tanstack-solid-router` | `play` |
-| [`@xmachines/play-url`](../api/@xmachines/play-url/README.md)                                     | `packages/play-url`                   | `play` |
-| [`@xmachines/play-view`](../api/@xmachines/play-view/README.md)                                   | `packages/play-view`                  | `play` |
-| [`@xmachines/play-vue`](../api/@xmachines/play-vue/README.md)                                     | `packages/play-vue`                   | `play` |
-| [`@xmachines/play-vue-router`](../api/@xmachines/play-vue-router/README.md)                       | `packages/play-vue-router`            | `play` |
-| [`@xmachines/play-xstate`](../api/@xmachines/play-xstate/README.md)                               | `packages/play-xstate`                | `play` |
-| [`@xmachines/docs`](../README.md)                                                                 | `packages/docs`                       | `docs` |
+The release is in **trains**, each released on its own: `core`, `play`, `runtime` and `docs`. A train publishes every package under its paths that is not private, at the version of the train's release (`release.config.mjs`, `trains`):
+
+| Package                                                                                           | Directory                             | Train     |
+| ------------------------------------------------------------------------------------------------- | ------------------------------------- | --------- |
+| [`@xmachines/core`](../api/@xmachines/core/README.md)                                             | `packages/core`                       | `core`    |
+| [`@xmachines/play`](../api/@xmachines/play/README.md)                                             | `packages/play`                       | `play`    |
+| [`@xmachines/play-actor`](../api/@xmachines/play-actor/README.md)                                 | `packages/play-actor`                 | `play`    |
+| [`@xmachines/play-atom`](../api/@xmachines/play-atom/README.md)                                   | `packages/play-atom`                  | `play`    |
+| [`@xmachines/play-dom`](../api/@xmachines/play-dom/README.md)                                     | `packages/play-dom`                   | `play`    |
+| [`@xmachines/play-dom-router`](../api/@xmachines/play-dom-router/README.md)                       | `packages/play-dom-router`            | `play`    |
+| [`@xmachines/play-pattern`](../api/@xmachines/play-pattern/README.md)                             | `packages/play-pattern`               | `play`    |
+| [`@xmachines/play-react`](../api/@xmachines/play-react/README.md)                                 | `packages/play-react`                 | `play`    |
+| [`@xmachines/play-react-router`](../api/@xmachines/play-react-router/README.md)                   | `packages/play-react-router`          | `play`    |
+| [`@xmachines/play-router`](../api/@xmachines/play-router/README.md)                               | `packages/play-router`                | `play`    |
+| [`@xmachines/play-solid`](../api/@xmachines/play-solid/README.md)                                 | `packages/play-solid`                 | `play`    |
+| [`@xmachines/play-solid-router`](../api/@xmachines/play-solid-router/README.md)                   | `packages/play-solid-router`          | `play`    |
+| [`@xmachines/play-svelte`](../api/@xmachines/play-svelte/README.md)                               | `packages/play-svelte`                | `play`    |
+| [`@xmachines/play-svelte-spa-router`](../api/@xmachines/play-svelte-spa-router/README.md)         | `packages/play-svelte-spa-router`     | `play`    |
+| [`@xmachines/play-sveltekit-router`](../api/@xmachines/play-sveltekit-router/README.md)           | `packages/play-sveltekit-router`      | `play`    |
+| [`@xmachines/play-tanstack-react-router`](../api/@xmachines/play-tanstack-react-router/README.md) | `packages/play-tanstack-react-router` | `play`    |
+| [`@xmachines/play-tanstack-router`](../api/@xmachines/play-tanstack-router/README.md)             | `packages/play-tanstack-router`       | `play`    |
+| [`@xmachines/play-tanstack-solid-router`](../api/@xmachines/play-tanstack-solid-router/README.md) | `packages/play-tanstack-solid-router` | `play`    |
+| [`@xmachines/play-url`](../api/@xmachines/play-url/README.md)                                     | `packages/play-url`                   | `play`    |
+| [`@xmachines/play-view`](../api/@xmachines/play-view/README.md)                                   | `packages/play-view`                  | `play`    |
+| [`@xmachines/play-vue`](../api/@xmachines/play-vue/README.md)                                     | `packages/play-vue`                   | `play`    |
+| [`@xmachines/play-vue-router`](../api/@xmachines/play-vue-router/README.md)                       | `packages/play-vue-router`            | `play`    |
+| [`@xmachines/play-xstate`](../api/@xmachines/play-xstate/README.md)                               | `packages/play-xstate`                | `play`    |
+| [`@xmachines/runtime-wasi`](../api/@xmachines/runtime-wasi/README.md)                             | `packages/runtime-wasi`               | `runtime` |
+| [`@xmachines/docs`](../README.md)                                                                 | `packages/docs`                       | `docs`    |
 
 Every package of `packages/play-*` that is not private is on the `play` train. [`@xmachines/shared`](../api/@xmachines/shared/README.md) is private: it holds the configs every package is built with, and no train publishes it.
 
@@ -67,11 +68,14 @@ Pipeline runs are triggered by `.gitlab-ci.yml` under the following conditions:
 | --------------------------------------------------------- | -------------------------------------------------- |
 | Push to `main` / `next` / `rc` / `beta` / `alpha` / `pre` | Full pipeline; the release jobs wait to be started |
 | Merge request                                             | Full pipeline, no release job                      |
+| The trigger of a release of xmachines-rs                  | `runtime-wasi-bump` alone, which opens the bump    |
 | Web / API / trigger / parent pipeline                     | Full pipeline                                      |
 | A release tag, `<train>-v<version>`                       | `publish-release` alone, which publishes the train |
 
 No rule admits another tag, so pushing one runs nothing.
 
+The tag pipeline of a release of xmachines-rs triggers a pipeline of this project on `main`, with the variables `RUNTIME_VERSION` and `RUNTIME_RELEASE_TYPE`. That pipeline is of the source `pipeline`, and it runs `runtime-wasi-bump` and no other job: each job starts its rules with `.bump-rules`. The job commits the new pin of [`@xmachines/runtime-wasi`](../api/@xmachines/runtime-wasi/README.md) on a branch, and pushes it with the push options that open its merge request. See [the README of the package](../api/@xmachines/runtime-wasi/README.md#how-a-bump-arrives).
+
 The pipeline includes two reusable CI components, both pinned in `.gitlab-ci.yml` — which is the version to trust, rather than a number repeated here:
 
 - **`to-be-continuous/node/gitlab-ci-node`** — handles install, lint, build, test, and audit
@@ -119,7 +123,7 @@ To run the same check on your machine, run `pnpm run docs` and then `pnpm run te
 
 ### Release Job Detail
 
-The `semantic-release` job is the job of the `to-be-continuous/semantic-release` component, with its own rules: manual on every release branch, and a `resource_group` that runs one release at a time. One click releases every train: the job runs semantic-release once for each train that the pipeline's input `release-trains` names, all three by default, in the order of the trains of `release.config.mjs`: `core`, then `play`, then `docs`, whatever order they were ticked in. A train with no commit that releases it releases nothing, and the next one runs. A run that fails stops the job; retry it, and each train it released already has nothing left to release. To release some trains alone, tick them in the multi-select `release-trains` of **Run pipeline**, or set `RELEASE_TRAINS` as you start the job, as `docs`: the input is the default of the global variable `RELEASE_TRAINS`, which a CI/CD variable overrides, as a to-be-continuous component maps its inputs. A name of no train fails the job.
+The `semantic-release` job is the job of the `to-be-continuous/semantic-release` component, with its own rules: manual on every release branch, and a `resource_group` that runs one release at a time. One click releases every train: the job runs semantic-release once for each train that the pipeline's input `release-trains` names, all of them by default, in the order of the trains of `release.config.mjs`: `core`, then `play`, then `runtime`, then `docs`, whatever order they were ticked in. A train with no commit that releases it releases nothing, and the next one runs. A run that fails stops the job; retry it, and each train it released already has nothing left to release. To release some trains alone, tick them in the multi-select `release-trains` of **Run pipeline**, or set `RELEASE_TRAINS` as you start the job, as `docs`: the input is the default of the global variable `RELEASE_TRAINS`, which a CI/CD variable overrides, as a to-be-continuous component maps its inputs. A name of no train fails the job.
 
 The component turns `release.config.mjs` into `.releaserc.json`, of `RELEASE_TRAIN=docs`, whose run names every plugin of the others' runs too, and installs semantic-release and each plugin that the config names, globally. The config is therefore literals: it imports no plugin, and holds no top-level await. The job then removes `.releaserc.json`, so each run reads `release.config.mjs` of its own train.
 
@@ -165,6 +169,8 @@ The channel becomes the npm dist-tag verbatim, which is why none of them contain
 
 The tag format of a train is `<train>-v${version}`. Every train continued from 7.0.0, the last release of one version for everything: `core-v7.0.0`, `play-v7.0.0` and `docs-v7.0.0` name its commit.
 
+The `runtime` train continues from 1.1.0, the last release of [`@xmachines/runtime-wasi`](../api/@xmachines/runtime-wasi/README.md) of xmachines-rs. The tag `runtime-v1.1.0` names the commit of `main` before the first commit of the package in this repository. That tag is a boundary, and it released nothing here: its push carried `-o ci.skip`, so its pipeline did not publish 1.1.0 a second time.
+
 #### `next` after a release of `main`
 
 `main` stays on XState 5 and merges into `next`. **After each release on `main`, merge `main` into `next`**, by a merge request from `main` to `next`, kept unsquashed, that keeps `main` (its source branch is never deleted).
@@ -177,18 +183,19 @@ A commit counts for a train when it changes a file under the train's paths, or o
 
 - `core`: `packages/core`.
 - `play`: `packages/play` and `packages/play-*`, the demos too.
-- `docs`: `packages/docs`, and every file of `core` and of `play`: the reference documents them, so a release of either is a release of `docs`. Release `docs` last.
+- `runtime`: `packages/runtime-wasi`.
+- `docs`: `packages/docs`, and every file of `core`, of `play` and of `runtime`: the reference documents them, so a release of any of them is a release of `docs`. Release `docs` last.
 
 The files every package is built with count for every train: the root `package.json`, `pnpm-lock.yaml`, `pnpm-workspace.yaml`, `tsconfig.json`, `vite.config.ts`, and `packages/shared`.
 
-Release the trains in order: `core`, then `play`, then `docs`. `play` depends on `core`, and `dependencies: "fail"` of the config fails a run of `play` while `core` has commits that would release and are not released: its publish would pin `core`'s last release, without what those commits changed. The job runs them in that order; one of the input `play` alone fails so. `docs` depends on both by the `dependsOn` of its train, as its package depends on neither, and fails so too: its reference would show their old version badges until its next release.
+Release the trains in order: `core`, then `play`, then `runtime`, then `docs`. `play` depends on `core`, and `dependencies: "fail"` of the config fails a run of `play` while `core` has commits that would release and are not released: its publish would pin `core`'s last release, without what those commits changed. The job runs them in that order; one of the input `play` alone fails so. `docs` depends on the other three by the `dependsOn` of its train, as its package depends on none of them, and fails so too: its reference would show their old version badges until its next release.
 
 ### Branch Phase
 
 The job of a train runs these plugins, in this order:
 
 1. **The analyzer and the notes generator**, each wrapped by an entry of `@wtf/semantic-release-trains` (`wrap`), which gives it the train's commits alone. Each entry of the trains plugin also checks the trains: no file on two of them, and the trains the train depends on released. `type!:` is a breaking change, by `parserOpts` at the root of the config.
-2. **`@semantic-release/changelog`** writes the train's changelog, the `CHANGELOG.md` of its first path: `packages/core/CHANGELOG.md`, `packages/play/CHANGELOG.md`, `packages/docs/CHANGELOG.md`. The root `CHANGELOG.md` holds the history up to 7.0.0.
+2. **`@semantic-release/changelog`** writes the train's changelog, the `CHANGELOG.md` of its first path: `packages/core/CHANGELOG.md`, `packages/play/CHANGELOG.md`, `packages/runtime-wasi/CHANGELOG.md`, `packages/docs/CHANGELOG.md`. The root `CHANGELOG.md` holds the history up to 7.0.0.
 3. **`@wtf/semantic-release-replace`** writes the version into the badge of each README of the train, by the `badge` template at the root of the config: a RegExp of the badge of shields.io, its version written as `shields` escapes it. `tests/readme-badges.test.ts` holds the template to every badge of the READMEs.
 4. **Of `docs` alone**, the reference: `corepack enable`, `pnpm install --frozen-lockfile`, `pnpm run build`, TypeDoc at the revision `docs-v${nextRelease.version}`, and `oxfmt` of the docs package, each a `@semantic-release/exec` step. Then an entry of `@wtf/semantic-release-trains` of `generated: true` stages the trees TypeDoc writes, deletions too: the git plugin stages what `git ls-files -m -o` reports, which never reports a deletion, so a page of an export that was renamed or removed would stay in git for ever.
 5. **`@semantic-release/git`** commits the changelog, the READMEs of the train, and of `docs` the reference (`packages/docs/api/**`, `packages/docs/examples/@xmachines/**` and the demo lists of `packages/docs/examples/README.md`), as:
@@ -247,7 +254,7 @@ What it costs:
 
 To publish packages, a maintainer must:
 
-1. Have push access to a release-eligible branch (`main`, `next`, `rc`, `beta`, `alpha`, `pre`). `GITLAB_TOKEN` is a protected variable, so each of these branches is protected, and a new release branch must be too. The tags of the trains (`core-v*`, `play-v*`, `docs-v*`) are protected, so the tag's pipeline gets the token for the GitLab release.
+1. Have push access to a release-eligible branch (`main`, `next`, `rc`, `beta`, `alpha`, `pre`). `GITLAB_TOKEN` is a protected variable, so each of these branches is protected, and a new release branch must be too. The tags of the trains (`core-v*`, `play-v*`, `runtime-v*`, `docs-v*`) are protected, so the tag's pipeline gets the token for the GitLab release.
 2. Ensure the GitLab project CI/CD variables include the required tokens.
 
 ---

package/contributing/development.md

@@ -226,7 +226,7 @@ Packages are grouped into dependency layers as defined in the root `tsconfig.jso
 
 | Layer | Packages                                                                         | Depends on         |
 | ----- | -------------------------------------------------------------------------------- | ------------------ |
-| 0     | `core`, `docs`, `play-atom`, `shared`                                            | External libs only |
+| 0     | `core`, `docs`, `play-atom`, `runtime-wasi`, `shared`                            | External libs only |
 | 1     | `play`, `play-actor`, `play-pattern`                                             | Layer 0            |
 | 2     | `play-url`, `play-view`                                                          | Layers 0–1         |
 | 3     | `play-dom`, `play-react`, `play-router`, `play-solid`, `play-svelte`, `play-vue` | Layers 0–2         |
@@ -542,7 +542,7 @@ Release branches are managed by the project maintainers:
 | `alpha` | Pre-release alpha channel |
 | `pre`   | Pre-release channel       |
 
-**Do not** manually version packages or create release branches — semantic-release owns the version of each train (`core`, `play`, `docs`), and a release is cut by starting the manual CI job of the train.
+**Do not** manually version packages or create release branches — semantic-release owns the version of each train (`core`, `play`, `runtime`, `docs`), and a release is cut by starting the manual CI job of the train.
 
 ---
 

package/examples/@xmachines/play-dom-gallery-demo/functions/createConfirmDialog.md

@@ -6,7 +6,7 @@
 function createConfirmDialog(confirm): Promise<boolean>;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/ConfirmDialog.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/ConfirmDialog.ts#L18)
+Defined in: [packages/play-dom/examples/gallery/src/components/ConfirmDialog.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/ConfirmDialog.ts#L18)
 
 ConfirmDialog — the gallery's `onConfirm` implementation.
 

package/examples/@xmachines/play-dom-gallery-demo/functions/createDebugPanel.md

@@ -6,7 +6,7 @@
 function createDebugPanel(actor, container, inspector): () => void;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/DebugPanel.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/DebugPanel.ts#L17)
+Defined in: [packages/play-dom/examples/gallery/src/components/DebugPanel.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/DebugPanel.ts#L17)
 
 DebugPanel — live debug footer factory. Appends the footer to `container`,
 shows the current state value, renders the button that opens the Stately

package/examples/@xmachines/play-dom-gallery-demo/functions/initApp.md

@@ -6,7 +6,7 @@
 function initApp(container): () => void;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/App.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/App.ts#L33)
+Defined in: [packages/play-dom/examples/gallery/src/App.ts:33](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/App.ts#L33)
 
 Mount the gallery into `container` and return a cleanup function that stops
 whatever actor is live and empties the container.

package/examples/@xmachines/play-dom-gallery-demo/functions/initShell.md

@@ -6,7 +6,7 @@
 function initShell(container, options): () => void;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Shell.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L35)
+Defined in: [packages/play-dom/examples/gallery/src/components/Shell.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L35)
 
 Shell — DOM shell layout factory.
 

package/examples/@xmachines/play-dom-gallery-demo/interfaces/GalleryMachineEntry.md

@@ -2,12 +2,12 @@
 
 # Interface: GalleryMachineEntry
 
-Defined in: [packages/play-dom/examples/gallery/src/machines.ts:85](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L85)
+Defined in: [packages/play-dom/examples/gallery/src/machines.ts:85](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L85)
 
 ## Properties
 
 | Property                                            | Type                                                 | Description                                                                                                                              | Defined in                                                                                                                                                                    |
 | --------------------------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-createruntime"></a> `createRuntime` | (`inspect`) => [`GalleryRuntime`](GalleryRuntime.md) | Create a fresh, STARTED actor and its registry for one selection. The caller owns the runtime and must stop the actor when done with it. | [packages/play-dom/examples/gallery/src/machines.ts:93](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L93) |
-| <a id="property-label"></a> `label`                 | `string`                                             | Picker button label and machine-view title.                                                                                              | [packages/play-dom/examples/gallery/src/machines.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L88) |
-| <a id="property-slug"></a> `slug`                   | [`GallerySlug`](../type-aliases/GallerySlug.md)      | -                                                                                                                                        | [packages/play-dom/examples/gallery/src/machines.ts:86](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L86) |
+| <a id="property-createruntime"></a> `createRuntime` | (`inspect`) => [`GalleryRuntime`](GalleryRuntime.md) | Create a fresh, STARTED actor and its registry for one selection. The caller owns the runtime and must stop the actor when done with it. | [packages/play-dom/examples/gallery/src/machines.ts:93](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L93) |
+| <a id="property-label"></a> `label`                 | `string`                                             | Picker button label and machine-view title.                                                                                              | [packages/play-dom/examples/gallery/src/machines.ts:88](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L88) |
+| <a id="property-slug"></a> `slug`                   | [`GallerySlug`](../type-aliases/GallerySlug.md)      | -                                                                                                                                        | [packages/play-dom/examples/gallery/src/machines.ts:86](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L86) |

package/examples/@xmachines/play-dom-gallery-demo/interfaces/GalleryRuntime.md

@@ -2,7 +2,7 @@
 
 # Interface: GalleryRuntime
 
-Defined in: [packages/play-dom/examples/gallery/src/machines.ts:80](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L80)
+Defined in: [packages/play-dom/examples/gallery/src/machines.ts:80](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L80)
 
 One live selection: the started actor plus its registry.
 
@@ -10,5 +10,5 @@ One live selection: the started actor plus its registry.
 
 | Property                                              | Type                                                                                             | Defined in                                                                                                                                                                    |
 | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`GalleryActor`](../type-aliases/GalleryActor.md)                                                | [packages/play-dom/examples/gallery/src/machines.ts:81](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L81) |
-| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](../../../../api/@xmachines/play-dom/interfaces/DefineRegistryResult.md) | [packages/play-dom/examples/gallery/src/machines.ts:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L82) |
+| <a id="property-actor"></a> `actor`                   | [`GalleryActor`](../type-aliases/GalleryActor.md)                                                | [packages/play-dom/examples/gallery/src/machines.ts:81](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L81) |
+| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](../../../../api/@xmachines/play-dom/interfaces/DefineRegistryResult.md) | [packages/play-dom/examples/gallery/src/machines.ts:82](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L82) |

package/examples/@xmachines/play-dom-gallery-demo/interfaces/ShellOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: ShellOptions
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Shell.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L8)
+Defined in: [packages/play-dom/examples/gallery/src/components/Shell.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L8)
 
 What the shell needs to render one live machine.
 
@@ -10,9 +10,9 @@ What the shell needs to render one live machine.
 
 | Property                                              | Type                                                                                             | Description                                                                      | Defined in                                                                                                                                                                                    |
 | ----------------------------------------------------- | ------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`                   | [`GalleryActor`](../type-aliases/GalleryActor.md)                                                | -                                                                                | [packages/play-dom/examples/gallery/src/components/Shell.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L9)   |
-| <a id="property-inspector"></a> `inspector`           | `DemoInspector`                                                                                  | Stately inspector controller — wires the DebugPanel inspector button.            | [packages/play-dom/examples/gallery/src/components/Shell.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L14) |
-| <a id="property-nav"></a> `nav?`                      | `Node`                                                                                           | Extra header content — the gallery passes its "Back to gallery" button.          | [packages/play-dom/examples/gallery/src/components/Shell.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L18) |
-| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](../../../../api/@xmachines/play-dom/interfaces/DefineRegistryResult.md) | -                                                                                | [packages/play-dom/examples/gallery/src/components/Shell.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L12) |
-| <a id="property-router"></a> `router?`                | `unknown`                                                                                        | Bridged router instance — accepted for prop parity with router demos but unused. | [packages/play-dom/examples/gallery/src/components/Shell.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L11) |
-| <a id="property-title"></a> `title?`                  | `string`                                                                                         | Header title override — the gallery passes the machine label.                    | [packages/play-dom/examples/gallery/src/components/Shell.ts:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L16) |
+| <a id="property-actor"></a> `actor`                   | [`GalleryActor`](../type-aliases/GalleryActor.md)                                                | -                                                                                | [packages/play-dom/examples/gallery/src/components/Shell.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L9)   |
+| <a id="property-inspector"></a> `inspector`           | `DemoInspector`                                                                                  | Stately inspector controller — wires the DebugPanel inspector button.            | [packages/play-dom/examples/gallery/src/components/Shell.ts:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L14) |
+| <a id="property-nav"></a> `nav?`                      | `Node`                                                                                           | Extra header content — the gallery passes its "Back to gallery" button.          | [packages/play-dom/examples/gallery/src/components/Shell.ts:18](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L18) |
+| <a id="property-registryresult"></a> `registryResult` | [`DefineRegistryResult`](../../../../api/@xmachines/play-dom/interfaces/DefineRegistryResult.md) | -                                                                                | [packages/play-dom/examples/gallery/src/components/Shell.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L12) |
+| <a id="property-router"></a> `router?`                | `unknown`                                                                                        | Bridged router instance — accepted for prop parity with router demos but unused. | [packages/play-dom/examples/gallery/src/components/Shell.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L11) |
+| <a id="property-title"></a> `title?`                  | `string`                                                                                         | Header title override — the gallery passes the machine label.                    | [packages/play-dom/examples/gallery/src/components/Shell.ts:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Shell.ts#L16) |

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/AuthCatalog.md

@@ -6,4 +6,4 @@
 type AuthCatalog = typeof authCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L47)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L47)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/DonutCatalog.md

@@ -6,4 +6,4 @@
 type DonutCatalog = typeof donutCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L41)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:41](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L41)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/FetchCatalog.md

@@ -6,4 +6,4 @@
 type FetchCatalog = typeof fetchCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L23)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L23)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/FlightCatalog.md

@@ -6,4 +6,4 @@
 type FlightCatalog = typeof flightCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L44)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:44](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L44)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/GalleryActor.md

@@ -15,6 +15,6 @@ type GalleryActor =
 	| AuthActor;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/machines.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L57)
+Defined in: [packages/play-dom/examples/gallery/src/machines.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L57)
 
 Any of the nine machine actors — what the gallery Shell and DebugPanel accept.

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/GallerySlug.md

@@ -15,4 +15,4 @@ type GallerySlug =
 	| "auth";
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/machines.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/machines.ts#L68)
+Defined in: [packages/play-dom/examples/gallery/src/machines.ts:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/machines.ts#L68)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/KitCatalog.md

@@ -6,7 +6,7 @@
 type KitCatalog = FetchCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L57)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L57)
 
 The catalog the shared component KIT is typed against.
 

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/StopwatchCatalog.md

@@ -6,4 +6,4 @@
 type StopwatchCatalog = typeof stopwatchCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L26)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L26)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/TemperatureCatalog.md

@@ -6,4 +6,4 @@
 type TemperatureCatalog = typeof temperatureCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L32)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L32)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/TicTacToeCatalog.md

@@ -6,4 +6,4 @@
 type TicTacToeCatalog = typeof ticTacToeCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L29)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L29)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/TodoMvcCatalog.md

@@ -6,4 +6,4 @@
 type TodoMvcCatalog = typeof todoMvcCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L35)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L35)

package/examples/@xmachines/play-dom-gallery-demo/type-aliases/TriviaCatalog.md

@@ -6,4 +6,4 @@
 type TriviaCatalog = typeof triviaCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L38)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L38)

package/examples/@xmachines/play-dom-gallery-demo/variables/Button.md

@@ -6,7 +6,7 @@
 const Button: ComponentFn<KitCatalog, "Button">;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Button.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Button.ts#L8)
+Defined in: [packages/play-dom/examples/gallery/src/components/Button.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Button.ts#L8)
 
 Button — emits `press`; the spec's `on.press` binding decides what happens
 (a host action sending a machine event, or a built-in like setState).

package/examples/@xmachines/play-dom-gallery-demo/variables/Field.md

@@ -6,7 +6,7 @@
 const Field: ComponentFn<KitCatalog, "Field">;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Field.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Field.ts#L26)
+Defined in: [packages/play-dom/examples/gallery/src/components/Field.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Field.ts#L26)
 
 Field — labelled input with two-way $bindState binding and declarative
 validation checks.

package/examples/@xmachines/play-dom-gallery-demo/variables/Page.md

@@ -6,7 +6,7 @@
 const Page: ComponentFn<KitCatalog, "Page">;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Page.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Page.ts#L12)
+Defined in: [packages/play-dom/examples/gallery/src/components/Page.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Page.ts#L12)
 
 Page — the root of every view.
 

package/examples/@xmachines/play-dom-gallery-demo/variables/Panel.md

@@ -6,7 +6,7 @@
 const Panel: ComponentFn<KitCatalog, "Panel">;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Panel.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Panel.ts#L11)
+Defined in: [packages/play-dom/examples/gallery/src/components/Panel.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Panel.ts#L11)
 
 Panel — generic container leaf.
 

package/examples/@xmachines/play-dom-gallery-demo/variables/Text.md

@@ -6,7 +6,7 @@
 const Text: ComponentFn<KitCatalog, "Text">;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/components/Text.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/components/Text.ts#L11)
+Defined in: [packages/play-dom/examples/gallery/src/components/Text.ts:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/components/Text.ts#L11)
 
 Text — one paragraph of live text.
 

package/examples/@xmachines/play-dom-gallery-demo/variables/authCatalog.md

@@ -121,6 +121,6 @@ const authCatalog: Catalog<{
 }>;
 ```
 
-Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.1.0/packages/play-dom/examples/gallery/src/catalogs.ts#L46)
+Defined in: [packages/play-dom/examples/gallery/src/catalogs.ts:46](https://gitlab.com/xmachin-es/xmachines-js/-/blob/docs-v7.3.0/packages/play-dom/examples/gallery/src/catalogs.ts#L46)
 
 Built catalogs, one per machine — router demos import theirs from here.