@xmachines/docs 1.0.0-beta.46 → 1.0.0-beta.50

package/README.md

@@ -1,15 +1,143 @@
+<!-- generated-by: gsd-doc-writer -->
+
 # @xmachines/docs
 
-This package contains the generated Typedoc documentation for the `xmachines-js` monorepo.
+> Documentation, guides, RFCs, and generated API reference for XMachines.
+
+Part of the `XMachines Play monorepo`.
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Version](https://img.shields.io/badge/version-1.0.0--beta.46-blue)](https://www.npmjs.com/package/@xmachines/docs)
+
+## Overview
+
+`@xmachines/docs` is the documentation package for the XMachines Play monorepo. It ships five categories of content:
 
-The documentation is automatically built and published from the source code.
+| Location    | Contents                                                         |
+| ----------- | ---------------------------------------------------------------- |
+| `rfc/`      | Request-for-Comment specs that define the XMachines architecture |
+| `guides/`   | Concept guides, tutorials, operational docs, and architecture    |
+| `examples/` | Runnable code examples and demo application references           |
+| `api/`      | TypeDoc-generated API reference for all public packages          |
+
+## Installation
+
+```bash
+npm install @xmachines/docs
+```
 
 ## Usage
 
-You can browse the documentation online at [https://xmachin.es/docs](https://xmachin.es/docs) (once published).
+### Import the package URL
+
+The package default export is its own module URL — useful for resolving doc assets at runtime:
+
+```typescript
+import docsUrl from "@xmachines/docs";
+// docsUrl is the resolved URL of the docs package entry point
+```
+
+### Access documentation files directly
+
+All documentation directories are exposed as package exports:
+
+```typescript
+// Access RFC files
+import playRfc from "@xmachines/docs/rfc/play.md";
+
+// Access guide files
+import gettingStarted from "@xmachines/docs/guides/getting-started.md";
+
+// Access example files
+import basicExample from "@xmachines/docs/examples/basic-state-machine.md";
+
+// Access API reference
+import apiDocs from "@xmachines/docs/api/README.md";
+```
+
+## Contents
+
+### RFCs
+
+Architectural specifications that define the XMachines system:
+
+| File                               | Title   | Description                                                          |
+| ---------------------------------- | ------- | -------------------------------------------------------------------- |
+| [`rfc/play.md`](rfc/play.md)       | Play    | Universal Player Architecture — core protocol, roles, and invariants |
+| [`rfc/streams.md`](rfc/streams.md) | Streams | WHATWG Streams as integration boundary                               |
+| [`rfc/broker.md`](rfc/broker.md)   | Broker  | Event broker specification                                           |
+| [`rfc/git.md`](rfc/git.md)         | Git     | Git-compatible ID and history model                                  |
+| [`rfc/run.md`](rfc/run.md)         | Run     | Runtime execution model                                              |
+| [`rfc/browser.md`](rfc/browser.md) | Browser | Browser environment adapter                                          |
+| [`rfc/node.md`](rfc/node.md)       | Node    | Node.js environment adapter                                          |
+| [`rfc/cli.md`](rfc/cli.md)         | CLI     | Command-line interface specification                                 |
+| [`rfc/rest.md`](rfc/rest.md)       | REST    | REST adapter specification                                           |
+| [`rfc/mcp.md`](rfc/mcp.md)         | MCP     | Model Context Protocol adapter                                       |
+
+### Guides
+
+Concept guides, tutorials, and operational docs for working with XMachines:
+
+**Learning:**
+
+- **[Installation](guides/installation.md)** — Core packages, framework-specific additions, TypeScript config, ESM setup
+- **[Getting Started](guides/getting-started.md)** — `setup().createMachine()` → `definePlayer()` → `actor.start()` → TC39 Signals
+- **[Understanding State Machines](guides/state-machines.md)** — `meta.route`, `meta.view`, and why machines replace boolean flags
+- **[Understanding the Actor Model](guides/actor-model.md)** — Actor/infrastructure split, `AbstractActor`, and the reset invariant
+- **[Understanding TC39 Signals](guides/signals.md)** — Signal primitives and the five architectural invariants they enforce
+
+**Development & Operations:**
+
+- **[Architecture](guides/architecture.md)** — Package layers, data flows, key abstractions, TypeScript build graph
+- **[Development](contributing/development.md)** — Monorepo setup, build system, adding packages, code conventions
+- **[Configuration](contributing/configuration.md)** — TypeScript, linting, formatting, Vitest, CI/CD, and release configuration
+- **[Testing](contributing/testing.md)** — Vitest setup, node vs browser modes, test patterns, coverage requirements
+- **[Deployment](contributing/deployment.md)** — npm publishing, semantic-release process, GitLab CI pipeline
+
+### Examples
+
+Practical code examples demonstrating XMachines patterns:
+
+- **[Basic State Machine](examples/basic-state-machine.md)** — `setup().createMachine()` + `definePlayer()` + TC39 Signals
+- **[Traffic Light](examples/traffic-light.md)** — Multi-state machine with `meta.route` and `formatPlayRouteTransitions`
+- **[Form Validation](examples/form-validation.md)** — Typed context mutations with `setup.assign`, guards, and `$bindState`
+- **[Routing Patterns](examples/routing-patterns.md)** — `meta.route`, `play.route` events, `always` auth guards
+- **[Multi-Router Integration](examples/multi-router-integration.md)** — All 8 router adapters
+
+### API Reference
+
+TypeDoc-generated API reference for all public packages — see [`api/README.md`](api/README.md).
+
+Packages documented:
+
+- [`@xmachines/play`](../play/README.md) — Core protocols (`PlayEvent`, `PlayError`)
+- [`@xmachines/play-actor`](../play-actor/README.md) — `AbstractActor`, `Routable`, `Viewable`
+- [`@xmachines/play-signals`](../play-signals/README.md) — TC39 Signals polyfill, `watchSignal`
+- [`@xmachines/play-router`](../play-router/README.md) — `extractMachineRoutes`, `RouterBridgeBase`
+- [`@xmachines/play-xstate`](../play-xstate/README.md) — `definePlayer`, `formatPlayRouteTransitions`, `PlayerActor`
+- [`@xmachines/play-dom`](../play-dom/README.md), [`play-react`](../play-react/README.md), [`play-solid`](../play-solid/README.md), [`play-svelte`](../play-svelte/README.md), [`play-vue`](../play-vue/README.md) — View renderers
+- [`@xmachines/play-dom-router`](../play-dom-router/README.md), [`play-react-router`](../play-react-router/README.md), [`play-tanstack-react-router`](../play-tanstack-react-router/README.md), [`play-solid-router`](../play-solid-router/README.md), [`play-tanstack-solid-router`](../play-tanstack-solid-router/README.md), [`play-vue-router`](../play-vue-router/README.md), [`play-svelte-spa-router`](../play-svelte-spa-router/README.md), [`play-sveltekit-router`](../play-sveltekit-router/README.md) — Router adapters
+
+## Testing
+
+Run the docs package tests in isolation:
+
+```bash
+# From the monorepo root
+npm test -w @xmachines/docs
+
+# Or from within the package directory
+npm test
+```
+
+## Regenerating API Docs
+
+The `api/` directory is auto-generated by TypeDoc and must not be edited directly. Regenerate it from the monorepo root:
+
+```bash
+npm run docs
+```
 
-To build the documentation locally:
+## License
 
-1. Clone the `xmachines-js` monorepo.
-2. Run `npm install` in the root directory.
-3. Run `npm run docs` to generate the documentation into `packages/docs/api`.
+MIT — see [LICENSE](LICENSE).

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

@@ -1,25 +1,17 @@
 [API](../../README.md) / @xmachines/play
 
-# @xmachines/play
+<!-- generated-by: gsd-doc-writer -->
 
-**Protocol layer defining Actor ↔ Infrastructure event contracts for XMachines Play Architecture.**
+# `@xmachines/play`
 
-`@xmachines/play` is intentionally small. It provides the base event type and the base error
-class used across all adapters and actor implementations, while keeping framework and runtime
-concerns out of business logic.
+> Core protocol layer for the Universal Player Architecture — defines `PlayEvent`, `PlayError`, and architectural contracts enabling loose coupling between business logic and runtime adapters.
 
-## Overview
-
-This package exports the shared Play protocol surface. It exists to preserve strict separation between:
-
-- **Actors** (business authority)
-- **Infrastructure adapters** (routers/renderers that observe and forward)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![npm](https://img.shields.io/npm/v/@xmachines/play)](https://www.npmjs.com/package/@xmachines/play)
 
-Per [Play RFC](../../../rfc/play.md), this package supports:
+Part of the [XMachines JS monorepo](../../README.md).
 
-- **Actor Authority (INV-01):** infrastructure proposes intents, actor decides validity
-- **Strict Separation (INV-02):** protocol types are framework-agnostic
-- **Passive Infrastructure (INV-04):** adapters reflect actor decisions
+---
 
 ## Installation
 
@@ -27,84 +19,169 @@ Per [Play RFC](../../../rfc/play.md), this package supports:
 npm install @xmachines/play
 ```
 
-## API Surface
+> **Node.js `>= 22.0.0` required.** All packages are ES modules (`"type": "module"`).
+
+---
+
+## Overview
+
+`@xmachines/play` is the foundational package in the XMachines ecosystem. It defines the minimal set of types and utilities that all other `@xmachines/*` packages build upon:
+
+- **`PlayEvent<TPayload>`** — the universal event contract for Actor ↔ Infrastructure communication
+- **`PlayError`** — the typed base class for all `@xmachines/*` runtime errors
+- **`NonNullableError`** — thrown when a required value is `null` or `undefined`
+- **`assertNonNullable()`** — assertion utility that narrows `T | null | undefined` to `T`
+
+These protocols implement the architectural invariants defined in the Play RFC:
 
-This package exports:
+| #      | Invariant                  | Description                                                     |
+| ------ | -------------------------- | --------------------------------------------------------------- |
+| INV-01 | **Actor Authority**        | The Actor is the final authority; guards decide all transitions |
+| INV-02 | **Strict Separation**      | Business logic never imports UI frameworks or routing libraries |
+| INV-04 | **Passive Infrastructure** | Infrastructure observes Actor signals; it never enforces guards |
 
-| Export      | Type  | Purpose                                           |
-| ----------- | ----- | ------------------------------------------------- |
-| `PlayEvent` | type  | Minimal event shape — `{ type: string, ...rest }` |
-| `PlayError` | class | Base class for all `@xmachines/*` typed errors    |
+---
 
-### `PlayEvent`
+## Usage
+
+### `PlayEvent<TPayload>`
+
+The minimal event contract: any object with a `type: string` property. Framework-agnostic — works with XState, Robot, and any other state machine library.
 
 ```typescript
 import type { PlayEvent } from "@xmachines/play";
 
-// Flexible (default):
-const event: PlayEvent = { type: "auth.login", userId: "123" };
+// Flexible (accepts any additional fields):
+const event: PlayEvent = { type: "auth.login", userId: "user123" };
 
-// Type-safe (with generic):
-type LoginEvent = PlayEvent<{ userId: string }>;
-const login: LoginEvent = { type: "auth.login", userId: "123" };
-```
+// Type-safe (with generic payload):
+type LoginEvent = PlayEvent<{ userId: string; timestamp: number }>;
 
-### `PlayError`
+const loginEvent: LoginEvent = {
+	type: "auth.login",
+	userId: "user123",
+	timestamp: Date.now(),
+};
 
-Base class for all typed runtime errors thrown by `@xmachines/*` packages.
+// TypeScript error: missing required field
+const invalid: LoginEvent = { type: "auth.login" }; // Error!
+```
 
-Every `PlayError` carries two structured fields:
+### `PlayError`
 
-- **`scope`** — the class or module that threw (e.g. `"RouterBridgeBase"`)
-- **`code`** — a stable, machine-readable identifier (e.g. `"PLAY_ROUTER_SYNC_FAILED"`)
+Base class for all `@xmachines/*` runtime errors. Every error has a stable `scope` (throwing class/module) and `code` (machine-readable identifier). Always branch on `.code` or subclass — never on `.message`.
 
 ```typescript
 import { PlayError } from "@xmachines/play";
+import { NonNullableError } from "@xmachines/play/errors";
 
-// Catching any @xmachines/* error:
 try {
 	bridge.connect();
 } catch (err) {
-	if (err instanceof PlayError) {
+	if (err instanceof NonNullableError) {
+		// err.scope === "assertNonNullable"
+		// err.code  === "PLAY_NON_NULLABLE"
+		console.error(`Missing value: ${err.message}`);
+	} else if (err instanceof PlayError) {
+		// Any other @xmachines/* error
 		console.error(`[${err.scope}:${err.code}] ${err.message}`);
+	} else {
+		throw err;
+	}
+}
+```
+
+Extend `PlayError` in your own `@xmachines/*`-compatible packages:
+
+```typescript
+import { PlayError } from "@xmachines/play";
+
+export class MyPackageError extends PlayError {
+	constructor(message: string, options?: ErrorOptions) {
+		super("MyScope", "MY_PACKAGE_ERROR_CODE", message, options);
+		this.name = "MyPackageError";
 	}
 }
 ```
 
-Package-specific subclasses are exported from each package's `./errors` subpath:
+### `assertNonNullable(value, name?)`
+
+Assertion utility that returns `value` typed as `NonNullable<V>` or throws `NonNullableError`. Eliminates unsafe `!` non-null assertions.
 
 ```typescript
-import { RouterSyncError } from "@xmachines/play-router/errors";
-import { InvalidEventError, MissingRouteParamError } from "@xmachines/play-xstate/errors";
-import {
-	MissingCatalogError,
-	MissingComponentError,
-	RendererError,
-} from "@xmachines/play-react/errors";
-import { MissingCatalogError, MissingComponentError } from "@xmachines/play-solid/errors";
-import { VueRouterCorrectionError } from "@xmachines/play-vue-router/errors";
+import { assertNonNullable } from "@xmachines/play";
+
+// Inject + assert in one line — no intermediate variable or `!` needed:
+const actor = assertNonNullable(inject<AuthActor>("actor"), "actor");
+
+// DOM element lookup:
+const el = assertNonNullable(document.getElementById("app"), "#app");
 ```
 
-See each package's README for the full list of error classes and when they are thrown.
+---
+
+## API Summary
+
+### Exported from `@xmachines/play`
+
+| Export                | Kind       | Description                                                      |
+| --------------------- | ---------- | ---------------------------------------------------------------- |
+| `PlayEvent<TPayload>` | `type`     | Universal event contract — `{ type: string } & TPayload`         |
+| `PlayError`           | `class`    | Base class for all `@xmachines/*` typed errors                   |
+| `NonNullableError`    | `class`    | Thrown by `assertNonNullable` when a value is `null`/`undefined` |
+| `assertNonNullable`   | `function` | Asserts non-null, returns narrowed value                         |
+
+### Exported from `@xmachines/play/errors`
+
+| Export             | Kind    | Description                                               |
+| ------------------ | ------- | --------------------------------------------------------- |
+| `PlayError`        | `class` | Re-exported base error class                              |
+| `NonNullableError` | `class` | `scope: "assertNonNullable"`, `code: "PLAY_NON_NULLABLE"` |
+
+---
 
-## Architecture Notes
+## Error Codes
 
-- Keep `@xmachines/play` as the base protocol boundary.
-- Keep actor implementation details in adapter packages such as `@xmachines/play-xstate`.
-- Never match on `.message` strings — always match on `instanceof` or `.code`.
+| Code                | Class              | Thrown When                                          |
+| ------------------- | ------------------ | ---------------------------------------------------- |
+| `PLAY_NON_NULLABLE` | `NonNullableError` | `assertNonNullable()` receives `null` or `undefined` |
+
+Other `@xmachines/*` packages export their own error subclasses from their respective `./errors` subpath:
+
+| Package                      | Import path                         |
+| ---------------------------- | ----------------------------------- |
+| `@xmachines/play`            | `@xmachines/play/errors`            |
+| `@xmachines/play-router`     | `@xmachines/play-router/errors`     |
+| `@xmachines/play-xstate`     | `@xmachines/play-xstate/errors`     |
+| `@xmachines/play-react`      | `@xmachines/play-react/errors`      |
+| `@xmachines/play-solid`      | `@xmachines/play-solid/errors`      |
+| `@xmachines/play-vue-router` | `@xmachines/play-vue-router/errors` |
+
+---
+
+## Testing
+
+Run tests for this package in isolation:
+
+```bash
+npm test -w @xmachines/play
+```
+
+Or from the package directory:
+
+```bash
+npm test
+```
 
-## Related Packages
+Tests use **Vitest** and cover the `PlayError` class construction, inheritance, `cause` support, and subclassing patterns.
 
-- [@xmachines/play-actor](../play-actor/README.md)
-- [@xmachines/play-xstate](../play-xstate/README.md)
-- [@xmachines/play-router](../play-router/README.md)
+---
 
 ## License
 
-Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
+MIT © [Mikael Karon](mailto:mikael@karon.se)
 
-This work is licensed under the terms of the MIT license.  
-For a copy, see <https://opensource.org/licenses/MIT>.
+See [LICENSE](./LICENSE) for details.
 
 @xmachines/play - Core Protocol Layer
 

package/api/@xmachines/play/classes/NonNullableError.md

@@ -2,7 +2,7 @@
 
 # Class: NonNullableError
 
-Defined in: [packages/play/src/errors.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L111)
+Defined in: [packages/play/src/errors.ts:111](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L111)
 
 Thrown by [assertNonNullable](../functions/assertNonNullable.md) when a value is `null` or `undefined`.
 
@@ -35,7 +35,7 @@ try {
 new NonNullableError(message, options?): NonNullableError;
 ```
 
-Defined in: [packages/play/src/errors.ts:112](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L112)
+Defined in: [packages/play/src/errors.ts:112](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L112)
 
 #### Parameters
 
@@ -57,10 +57,10 @@ Defined in: [packages/play/src/errors.ts:112](https://gitlab.com/xmachin-es/xmac
 | Property                                                | Modifier   | Type      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       | Inherited from                                                                         | Defined in                                                                                                                         |
 | ------------------------------------------------------- | ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
 | <a id="property-cause"></a> `cause?`                    | `public`   | `unknown` | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](PlayError.md).[`cause`](PlayError.md#property-cause)                     | -                                                                                                                                  |
-| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable error identifier. Error codes follow the `PLAY_<PACKAGE>_<DESCRIPTION>` naming convention and are guaranteed stable across patch and minor releases within a major version. Never match on `.message` — always match on `.code` or the subclass.                                                                                                                                                                       | [`PlayError`](PlayError.md).[`code`](PlayError.md#property-code)                       | [packages/play/src/errors.ts:75](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L75) |
+| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable error identifier. Error codes follow the `PLAY_<PACKAGE>_<DESCRIPTION>` naming convention and are guaranteed stable across patch and minor releases within a major version. Never match on `.message` — always match on `.code` or the subclass.                                                                                                                                                                       | [`PlayError`](PlayError.md).[`code`](PlayError.md#property-code)                       | [packages/play/src/errors.ts:75](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L75) |
 | <a id="property-message"></a> `message`                 | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](PlayError.md).[`message`](PlayError.md#property-message)                 | -                                                                                                                                  |
 | <a id="property-name"></a> `name`                       | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](PlayError.md).[`name`](PlayError.md#property-name)                       | -                                                                                                                                  |
-| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or module that threw this error (e.g. `"RouterBridgeBase"`).                                                                                                                                                                                                                                                                                                                                                                            | [`PlayError`](PlayError.md).[`scope`](PlayError.md#property-scope)                     | [packages/play/src/errors.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L66) |
+| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or module that threw this error (e.g. `"RouterBridgeBase"`).                                                                                                                                                                                                                                                                                                                                                                            | [`PlayError`](PlayError.md).[`scope`](PlayError.md#property-scope)                     | [packages/play/src/errors.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L66) |
 | <a id="property-stack"></a> `stack?`                    | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | [`PlayError`](PlayError.md).[`stack`](PlayError.md#property-stack)                     | -                                                                                                                                  |
 | <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`](PlayError.md).[`stackTraceLimit`](PlayError.md#property-stacktracelimit) | -                                                                                                                                  |
 

package/api/@xmachines/play/classes/PlayError.md

@@ -2,7 +2,7 @@
 
 # Class: PlayError
 
-Defined in: [packages/play/src/errors.ts:64](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L64)
+Defined in: [packages/play/src/errors.ts:64](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L64)
 
 Base class for all typed runtime errors thrown by `@xmachines/*` packages.
 
@@ -87,7 +87,7 @@ new PlayError(
    options?): PlayError;
 ```
 
-Defined in: [packages/play/src/errors.ts:83](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L83)
+Defined in: [packages/play/src/errors.ts:83](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L83)
 
 #### Parameters
 
@@ -113,10 +113,10 @@ Error.constructor;
 | Property                                                | Modifier   | Type      | Description                                                                                                                                                                                                                                                                                                                                                                                                                                       | Inherited from          | Defined in                                                                                                                         |
 | ------------------------------------------------------- | ---------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
 | <a id="property-cause"></a> `cause?`                    | `public`   | `unknown` | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.cause`           | -                                                                                                                                  |
-| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable error identifier. Error codes follow the `PLAY_<PACKAGE>_<DESCRIPTION>` naming convention and are guaranteed stable across patch and minor releases within a major version. Never match on `.message` — always match on `.code` or the subclass.                                                                                                                                                                       | -                       | [packages/play/src/errors.ts:75](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L75) |
+| <a id="property-code"></a> `code`                       | `readonly` | `string`  | A stable, machine-readable error identifier. Error codes follow the `PLAY_<PACKAGE>_<DESCRIPTION>` naming convention and are guaranteed stable across patch and minor releases within a major version. Never match on `.message` — always match on `.code` or the subclass.                                                                                                                                                                       | -                       | [packages/play/src/errors.ts:75](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L75) |
 | <a id="property-message"></a> `message`                 | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.message`         | -                                                                                                                                  |
 | <a id="property-name"></a> `name`                       | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.name`            | -                                                                                                                                  |
-| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or module that threw this error (e.g. `"RouterBridgeBase"`).                                                                                                                                                                                                                                                                                                                                                                            | -                       | [packages/play/src/errors.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/errors.ts#L66) |
+| <a id="property-scope"></a> `scope`                     | `readonly` | `string`  | The class or module that threw this error (e.g. `"RouterBridgeBase"`).                                                                                                                                                                                                                                                                                                                                                                            | -                       | [packages/play/src/errors.ts:66](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/errors.ts#L66) |
 | <a id="property-stack"></a> `stack?`                    | `public`   | `string`  | -                                                                                                                                                                                                                                                                                                                                                                                                                                                 | `Error.stack`           | -                                                                                                                                  |
 | <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. | `Error.stackTraceLimit` | -                                                                                                                                  |
 

package/api/@xmachines/play/functions/assertNonNullable.md

@@ -6,7 +6,7 @@
 function assertNonNullable<V>(value, name?): NonNullable<V>;
 ```
 
-Defined in: [packages/play/src/utils.ts:39](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/utils.ts#L39)
+Defined in: [packages/play/src/utils.ts:39](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/utils.ts#L39)
 
 Assert that `value` is neither `null` nor `undefined`, and return it typed
 as `NonNullable<V>` — combining the guard and the narrowed value in a single

package/api/@xmachines/play/type-aliases/PlayEvent.md

@@ -6,7 +6,7 @@
 type PlayEvent<TPayload> = object & TPayload;
 ```
 
-Defined in: [packages/play/src/types.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/types.ts#L69)
+Defined in: [packages/play/src/types.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/types.ts#L69)
 
 Generic event type for Play Architecture
 
@@ -34,7 +34,7 @@ Robot, and other state machine libraries.
 
 | Name   | Type     | Defined in                                                                                                                       |
 | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| `type` | `string` | [packages/play/src/types.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.46/packages/play/src/types.ts#L70) |
+| `type` | `string` | [packages/play/src/types.ts:70](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.50/packages/play/src/types.ts#L70) |
 
 ## Type Parameters