@xmachines/docs 1.0.0 → 1.1.0

package/contributing/configuration.md

@@ -1,5 +1,3 @@
-<!-- generated-by: gsd-doc-writer -->
-
 # Configuration
 
 This document describes every configuration file, environment variable, and per-package override used by the `xmachines-js` monorepo.
@@ -133,7 +131,6 @@ The root config extends the shared base (`@xmachines/shared/oxlint`) and adds wo
 export default defineConfig({
 	extends: [sharedConfig],
 	ignorePatterns: [
-		".planning",
 		".opencode",
 		"node_modules",
 		"dist",
@@ -185,7 +182,6 @@ export default defineConfig({
 	...sharedConfig,
 	ignorePatterns: [
 		...(sharedConfig.ignorePatterns ?? []),
-		".planning",
 		".opencode",
 		".agents",
 		".githuman",
@@ -295,7 +291,7 @@ Provides two helpers used in all `vitest.config.ts` and `vite.config.ts` files:
 - **`xmAliases(import.meta.url)`** — returns a `Record<string, string>` mapping every `@xmachines/*` package to its TypeScript source entry. Enables tests and dev servers to run without a prior `pnpm run build`.
 - **`xmResolve(import.meta.url)`** — returns a full Vite `resolve` config with `xmAliases` plus `preserveSymlinks: true` and `conditions: ["source"]`.
 - **`xmCacheDir(import.meta.url, name)`** — returns a shared Vite cache path under `node_modules/.vite/<name>` to prevent redundant dep optimizer runs across projects.
-- **`xmOptimizeDeps(extra?)`** — returns a standard `optimizeDeps.include` list; pass framework-specific extras to pre-bundle them at startup.
+- **`xmOptimizeDeps(include?)`** — returns an `optimizeDeps.include` list holding exactly the specifiers passed in. Nothing is pre-bundled by default, and every entry has to be a package the calling project declares: pnpm gives each package its own `node_modules`, so Vite cannot resolve an undeclared specifier — it warns on stderr and carries on, which reads as a failure in a passing job.
 
 ### Release — `release.config.mjs`
 
@@ -306,11 +302,15 @@ Defines the release branches and plugin chain used by the GitLab CI semantic-rel
 
 **Release branches:**
 
-| Branch   | Channel   | Pre-release |
-| -------- | --------- | ----------- |
-| `main`   | (default) | No          |
-| `pre/rc` | `pre/rc`  | `rc`        |
-| `beta`   | `beta`    | `true`      |
+| Branch  | Channel   | Pre-release |
+| ------- | --------- | ----------- |
+| `main`  | (default) | No          |
+| `rc`    | `rc`      | `rc`        |
+| `beta`  | `beta`    | `true`      |
+| `alpha` | `alpha`   | `alpha`     |
+| `pre`   | `pre`     | `pre`       |
+
+Only `main` is a protected branch today. That works because `GITLAB_TOKEN` — which the release needs, since `CI_JOB_TOKEN` can push neither the release commit nor the tag — is an _unprotected_ group variable and so reaches every one of these refs. If it is ever made protected, each of these branches has to be protected too, or the release fails in verify-conditions with `EGITNOPERMISSION` rather than at the registry.
 
 **Tag format:** `v${version}`
 

package/contributing/deployment.md

@@ -1,5 +1,3 @@
-<!-- generated-by: gsd-doc-writer -->
-
 # Deployment
 
 This document describes how `@xmachines/xmachines-js` packages are built, versioned, and published to npm. All releases are automated through [semantic-release](https://semantic-release.gitbook.io/) running inside a GitLab CI pipeline. No manual `npm publish` commands are required for normal releases.
@@ -10,11 +8,11 @@ This document describes how `@xmachines/xmachines-js` packages are built, versio
 
 All `@xmachines/*` packages are published to the **public npm registry** (`registry.npmjs.org`). Every package uses `"publishConfig": { "access": "public" }` so scoped packages are accessible without an npm org subscription. See the [Published Packages](#published-packages) table for the full list.
 
-| Target          | Config File                                                            | Purpose                                                |
-| --------------- | ---------------------------------------------------------------------- | ------------------------------------------------------ |
-| npm registry    | `.releaserc.json` (per-package `@semantic-release/npm` plugin entries) | Publish all public packages                            |
-| GitLab Releases | `.releaserc.json` (`@semantic-release/gitlab` plugin)                  | Attach tarball artifacts to the GitLab release tag     |
-| GitLab CI       | `.gitlab-ci.yml`                                                       | Trigger builds, tests, and releases on push / MR / tag |
+| Target          | Config File                                                               | Purpose                                                |
+| --------------- | ------------------------------------------------------------------------- | ------------------------------------------------------ |
+| npm registry    | `release.config.mjs` (npm plugin entries derived from the workspace scan) | Publish all public packages                            |
+| GitLab Releases | `release.config.mjs` (`@semantic-release/gitlab` plugin)                  | Attach tarball artifacts to the GitLab release tag     |
+| GitLab CI       | `.gitlab-ci.yml`                                                          | Trigger builds, tests, and releases on push / MR / tag |
 
 The root `package.json` is marked `"private": true` and is **never published** to npm.
 
@@ -22,7 +20,7 @@ The root `package.json` is marked `"private": true` and is **never published** t
 
 ## Published Packages
 
-The following packages are published on every release (derived from `.releaserc.json`):
+The following packages are published on every release (derived from the workspace scan in `release.config.mjs` — every non-private package that is not a demo):
 
 | Package                                                                                           | Directory                             |
 | ------------------------------------------------------------------------------------------------- | ------------------------------------- |
@@ -59,16 +57,18 @@ Each published package includes only the directories listed in its `files` field
 
 Pipeline runs are triggered by `.gitlab-ci.yml` under the following conditions:
 
-| Trigger                                       | Pipeline runs                                 |
-| --------------------------------------------- | --------------------------------------------- |
-| Push to `main` / `master` / `beta` / `pre/rc` | Full pipeline including release               |
-| Merge request                                 | Full pipeline (release job skipped or manual) |
-| Tag push (`$CI_COMMIT_TAG`)                   | Full pipeline                                 |
+| Trigger                                          | Pipeline runs                                      |
+| ------------------------------------------------ | -------------------------------------------------- |
+| Push to `main` / `rc` / `beta` / `alpha` / `pre` | Full pipeline; the release job waits to be started |
+| Merge request                                    | Full pipeline, no release job                      |
+| Web / API / trigger / parent pipeline            | Full pipeline                                      |
+
+No rule admits a tag pipeline, so pushing a tag runs nothing.
 
-The pipeline includes two reusable CI components:
+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@5.1.2`** — handles install, lint, build, test, and audit
-- **`to-be-continuous/semantic-release/gitlab-ci-semrel@4.1.0`** — runs `semantic-release` on eligible branches
+- **`to-be-continuous/node/gitlab-ci-node`** — handles install, lint, build, test, and audit
+- **`to-be-continuous/semantic-release/gitlab-ci-semrel`** — runs `semantic-release` on eligible branches
 
 The `node-build` job runs with:
 
@@ -116,7 +116,7 @@ node scripts/release-pack-smoke.mjs
 
 `scripts/release-pack-smoke.mjs`:
 
-1. Reads `.releaserc.json` to find all `@semantic-release/npm` plugin entries where `npmPublish` is not `false`.
+1. Reads `release.config.mjs` to find all `@semantic-release/npm` plugin entries where `npmPublish` is not `false`.
 2. For each publishable package: runs `npm pack --json` in the package directory.
 3. Creates a temporary directory, runs `npm init -y`, and installs the local tarball with `--ignore-scripts`.
 4. Asserts the install succeeds — any missing files, broken exports, or pack-time errors surface here.
@@ -130,13 +130,17 @@ This smoke test runs **before** the actual publish so packaging problems are cau
 
 ### Branch Model
 
-Releases are driven by commit history on protected branches:
+Releases are driven by commit history on the release branches:
+
+| Branch  | Channel          | Tag format       | Behaviour                     |
+| ------- | ---------------- | ---------------- | ----------------------------- |
+| `main`  | stable (default) | `v1.2.3`         | Full production release       |
+| `rc`    | `rc`             | `v1.2.3-rc.N`    | Release candidate pre-release |
+| `beta`  | `beta`           | `v1.2.3-beta.N`  | Beta pre-release              |
+| `alpha` | `alpha`          | `v1.2.3-alpha.N` | Alpha pre-release             |
+| `pre`   | `pre`            | `v1.2.3-pre.N`   | Pre-release                   |
 
-| Branch   | Channel          | Tag format      | Behaviour                     |
-| -------- | ---------------- | --------------- | ----------------------------- |
-| `main`   | stable (default) | `v1.2.3`        | Full production release       |
-| `beta`   | `beta`           | `v1.2.3-beta.N` | Beta pre-release              |
-| `pre/rc` | `pre/rc`         | `v1.2.3-rc.N`   | Release candidate pre-release |
+The channel becomes the npm dist-tag verbatim, which is why none of them contains a slash: npm reads a slash in a version selector as a GitHub shorthand, so such a tag cannot be installed.
 
 Tag format is `v${version}` (e.g., `v1.0.0-beta.46`).
 
@@ -169,10 +173,11 @@ Each publishable package is published in sequence via individual `@semantic-rele
 - `pkgRoot` — the package directory relative to the workspace root
 - `tarballDir` — `dist/releases/` where the packed `.tgz` is saved
 
-Example (from `.releaserc.json`):
+Example (from `release.config.mjs`, where these entries are generated rather than
+hand-written):
 
-```json
-["@semantic-release/npm", { "pkgRoot": "packages/play", "tarballDir": "dist/releases" }]
+```js
+["@semantic-release/npm", { pkgRoot: "packages/play", tarballDir: "dist/releases" }];
 ```
 
 ### Post-Release Phase
@@ -217,14 +222,14 @@ This means packages always depend on the exact same version of sibling packages
 | Variable                    | Source                                  | Purpose                                                                         |
 | --------------------------- | --------------------------------------- | ------------------------------------------------------------------------------- |
 | `NPM_ID_TOKEN`              | GitLab CI OIDC (auto-generated per job) | Authenticates `semantic-release` to npm registry via OIDC token exchange        |
-| `GL_TOKEN` / `GITLAB_TOKEN` | GitLab CI protected variable            | Authenticates `@semantic-release/gitlab` for release creation and git push back |
+| `GL_TOKEN` / `GITLAB_TOKEN` | GitLab CI group variable (unprotected)  | Authenticates `@semantic-release/gitlab` for release creation and git push back |
 | `CI_JOB_TOKEN`              | GitLab CI built-in                      | Used by the `to-be-continuous` components for GitLab API calls                  |
 
 **No static npm token is committed to the repository.** The `NPM_ID_TOKEN` is a short-lived OIDC token generated for each CI job with audience `npm:registry.npmjs.org`.
 
 To publish packages, a maintainer must:
 
-1. Have push access to a release-eligible branch (`main`, `beta`, `pre/rc`).
+1. Have push access to a release-eligible branch (`main`, `rc`, `beta`, `alpha`, `pre`). Only `main` is protected; see the branch model above for what changes if `GITLAB_TOKEN` is ever made a protected variable.
 2. Ensure the GitLab project CI/CD variables include the required tokens.
 
 ---
@@ -267,6 +272,22 @@ There is no automated rollback mechanism. To revert a release:
 
 ---
 
+## Recovering a Failed Release
+
+If the job dies partway (e.g. one package's trusted publisher isn't set up), some packages are published, the git tag is created, and the rest are missing. To finish the release:
+
+1. **Delete the release tag.** semantic-release creates the tag _before_ publishing, so a re-run while it exists is a no-op ([semantic-release#3178](https://github.com/semantic-release/semantic-release/issues/3178)):
+    ```bash
+    glab api --method DELETE "projects/xmachin-es%2Fxmachines-js/repository/tags/vX.Y.Z"
+    ```
+2. **Re-run the `semantic-release` job.**
+
+The config detects a staged-but-untagged version (a recovery re-run) and automatically demotes any package already on npm at that version to pack-only — re-packing it for the release assets but **not** re-publishing it — so the re-run publishes only what's missing, with no manual input. `SEMREL_SKIP_STEPS` (a regex matched against release step IDs) remains available as a manual override to force-skip specific steps.
+
+> First fix the underlying cause before re-running — e.g. configure the missing trusted publisher — otherwise the same packages fail again.
+
+---
+
 ## Local Release Dry-Run (Manual)
 
 To preview what semantic-release would do without publishing:

package/contributing/development.md

@@ -1,5 +1,3 @@
-<!-- generated-by: gsd-doc-writer -->
-
 # Development
 
 This guide covers everything you need to set up a local development environment, understand the build system, and contribute code to the XMachines JS monorepo.
@@ -9,6 +7,7 @@ This guide covers everything you need to set up a local development environment,
 - [Local Setup](#local-setup)
 - [Monorepo Structure](#monorepo-structure)
 - [Build Commands](#build-commands)
+- [Updating Dependencies](#updating-dependencies)
 - [TypeScript Composite Build System](#typescript-composite-build-system)
 - [Code Style](#code-style)
 - [Branch Conventions](#branch-conventions)
@@ -132,8 +131,7 @@ All commands are run from the **repository root** unless otherwise noted.
 | `pnpm run test:watch`                      | Re-run tests on file changes (interactive)                            |
 | `pnpm run test:browser`                    | Run Playwright browser tests                                          |
 | `pnpm run test:coverage`                   | Run tests with V8 coverage reporting                                  |
-| `pnpm run coverage:report`                 | Run tests and write an HTML coverage report                           |
-| `pnpm run coverage:summary`                | Run tests and write a JSON summary report                             |
+| `pnpm run test:browser:coverage`           | Run browser tests with coverage reporting                             |
 | `pnpm run test:build`                      | Type-check test files without running them (`tsconfig.test.json`)     |
 | `pnpm run lint`                            | Lint all packages with oxlint                                         |
 | `pnpm run lint:fix`                        | Auto-fix lint issues                                                  |
@@ -143,6 +141,45 @@ All commands are run from the **repository root** unless otherwise noted.
 
 ---
 
+## Updating Dependencies
+
+Every dependency is declared with the same range in every manifest that uses it, and a test fails if two disagree — `pnpm update` should move a package everywhere at once, not leave one package a minor behind.
+
+```bash
+pnpm update -r            # move within the declared ranges
+pnpm update -r --latest   # move the ranges themselves
+```
+
+`pnpm update -r` alone will not move a `0.x` dependency past its current minor: a caret on a `0.x` version means `>=0.58.0 <0.59.0`, because minors are where a pre-1.0 package is allowed to break. `oxfmt` sat six minors behind that way while `pnpm outdated` reported it on every pipeline. Use `--latest` for those, and read what changed.
+
+Two dependencies are pinned on purpose and must not be swept up:
+
+| Dependency   | Constraint                           | Why                                                                                                 |
+| ------------ | ------------------------------------ | --------------------------------------------------------------------------------------------------- |
+| `playwright` | exact, equal to `PLAYWRIGHT_VERSION` | The browsers are baked into the CI image; the browser job fails on any mismatch                     |
+| `typescript` | `^5.9.3 \|\| ^6.0.3`                 | TypeScript 7 ships no programmatic compiler API, which TypeDoc and `@vue/compiler-sfc` both require |
+
+New versions also wait out pnpm's `minimumReleaseAge` (24 hours) before they can be installed at all.
+
+### Peer ranges are wider than what CI installs
+
+`peerDependencies` and `devDependencies` say different things about the same package, so the one-range rule does not apply across them and the test exempts peers.
+
+A peer range is a contract with the consumer: _bring your own React, anything in this range works_. It is deliberately wide, because the application owns that dependency — narrowing it forces consumers to upgrade in lockstep, or leaves two copies of a framework in their bundle. A dev range is what this repository installs to compile and test, and is concrete because CI needs one resolution.
+
+So `react: ^18.0.0 || ^19.0.0` as a peer alongside `react: ^19.2.5` as a dev dependency is the correct pairing, not drift.
+
+What that costs is worth stating plainly: **CI only ever exercises the dev version.** Two peers currently claim support across a major boundary that nothing here tests:
+
+| Package               | Peer range             | Tested against |
+| --------------------- | ---------------------- | -------------- |
+| `react` / `react-dom` | `^18.0.0 \|\| ^19.0.0` | 19.x           |
+| `vue-router`          | `^4.0.0 \|\| ^5.0.0`   | 5.x            |
+
+React 18 and vue-router 4 are supported by intent — nothing known depends on 19-only or 5-only behaviour — but neither is installed by any job, so a regression there would surface as a consumer's bug report rather than a red pipeline. Narrowing either range to what is tested would be a breaking change for consumers and needs a major release; adding a floor-install job would close the gap instead. Until one of those happens, treat the lower major as untested.
+
+---
+
 ## TypeScript Composite Build System
 
 The monorepo uses **TypeScript project references** for correct build-order management. No manual sequencing or separate build scripts are needed.
@@ -375,13 +412,15 @@ refactor/route-map-extraction
 
 Release branches are managed by the project maintainers:
 
-| Branch   | Purpose                   |
-| -------- | ------------------------- |
-| `main`   | Stable releases           |
-| `beta`   | Pre-release beta channel  |
-| `pre/rc` | Release candidate channel |
+| Branch  | Purpose                   |
+| ------- | ------------------------- |
+| `main`  | Stable releases           |
+| `rc`    | Release candidate channel |
+| `beta`  | Pre-release beta channel  |
+| `alpha` | Pre-release alpha channel |
+| `pre`   | Pre-release channel       |
 
-**Do not** manually version packages or create release branches — releases are automated via semantic-release triggered by CI.
+**Do not** manually version packages or create release branches — semantic-release owns the version, and a release is cut by starting its manual CI job.
 
 ---
 
@@ -451,13 +490,13 @@ feat(play-react): add PlayRenderer suspense boundary
 
 The GitLab CI pipeline runs automatically on merge requests, pushes to `main`, and git tags.
 
-| Job                | Command                               | Artifacts                              |
-| ------------------ | ------------------------------------- | -------------------------------------- |
-| Build              | `pnpm run build`                      | —                                      |
-| Test with coverage | `vitest run --coverage`               | JUnit XML, Cobertura coverage report   |
-| Lint               | `oxlint .`                            | —                                      |
-| Audit              | `pnpm audit --audit-level=high`       | —                                      |
-| Semantic release   | (automated on `main`/`beta`/`pre/rc`) | CHANGELOG, npm publish, GitLab release |
+| Job                | Command                                          | Artifacts                              |
+| ------------------ | ------------------------------------------------ | -------------------------------------- |
+| Build              | `pnpm run build`                                 | —                                      |
+| Test with coverage | `vitest run --coverage`                          | JUnit XML, Cobertura coverage report   |
+| Lint               | `oxlint .`                                       | —                                      |
+| Audit              | `pnpm audit --audit-level=high`                  | —                                      |
+| Semantic release   | (manual job on `main`/`rc`/`beta`/`alpha`/`pre`) | CHANGELOG, npm publish, GitLab release |
 
 ---
 

package/contributing/testing.md

@@ -1,5 +1,3 @@
-<!-- generated-by: gsd-doc-writer -->
-
 # Testing
 
 This document describes the test framework, conventions, and CI integration for the XMachines JS monorepo.
@@ -62,10 +60,20 @@ pnpm run test:coverage
 Produces coverage output in `text`, `html`, and `json-summary` formats.
 
 ```bash
-pnpm run coverage:report   # HTML report
-pnpm run coverage:summary  # JSON summary only
+pnpm run test:browser:coverage   # browser suite, with coverage
 ```
 
+Root-level coverage thresholds (regression gate):
+
+| Metric     | Threshold |
+| ---------- | --------- |
+| Lines      | 80%       |
+| Functions  | 80%       |
+| Statements | 80%       |
+| Branches   | 75%       |
+
+Individual packages may enforce higher per-package thresholds in their own `vitest.config.ts`.
+
 ### Verify TypeScript test graph compiles
 
 ```bash

package/examples/@xmachines/play-dom-demo/README.md

@@ -1,11 +1,11 @@
 [Examples](../../README.md) / @xmachines/play-dom-demo
 
-<!-- generated-by: gsd-doc-writer -->
-
 # @xmachines/play-dom-demo
 
 Vanilla DOM renderer demo for [`@xmachines/play-dom`](../../../api/@xmachines/play-dom/README.md) — actor + `createPlayUI` without a router.
 
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ## What This Demonstrates
 
 - Shared auth machine reused without framework-specific business logic

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

@@ -6,7 +6,7 @@
 function createNavBar(actor, container): () => void;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/NavBar.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/NavBar.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/NavBar.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/NavBar.ts#L9)
 
 NavBar — App-shell navigation factory. Mounts a reactive nav into
 `container`, observes actor.state via watchSignal, and updates button

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

@@ -3,10 +3,10 @@
 # Function: initShell()
 
 ```ts
-function initShell(actor, appElement): () => void;
+function initShell(actor, appElement, inspector): () => void;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Shell.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Shell.ts#L24)
+Defined in: [packages/play-dom/examples/demo/src/components/Shell.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Shell.ts#L24)
 
 Shell — DOM shell layout factory. Renders demo chrome (header + main +
 debug panel), mounts NavBar, connects DOM renderer, and wires DebugPanel.
@@ -14,10 +14,11 @@ Returns a disconnect function.
 
 ## Parameters
 
-| Parameter    | Type          |
-| ------------ | ------------- |
-| `actor`      | `AuthActor`   |
-| `appElement` | `HTMLElement` |
+| Parameter    | Type            |
+| ------------ | --------------- |
+| `actor`      | `AuthActor`     |
+| `appElement` | `HTMLElement`   |
+| `inspector`  | `DemoInspector` |
 
 ## Returns
 

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

@@ -6,4 +6,4 @@
 type AuthCatalog = typeof authCatalog;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/catalog.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/catalog.ts#L6)
+Defined in: [packages/play-dom/examples/demo/src/catalog.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/catalog.ts#L6)

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

@@ -6,7 +6,7 @@
 const About: ComponentFn<AuthCatalog, "About">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/About.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/About.ts#L8)
+Defined in: [packages/play-dom/examples/demo/src/components/About.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/About.ts#L8)
 
 About — Public information page. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'About'>). Renders static content from props.

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

@@ -6,7 +6,7 @@
 const Contact: ComponentFn<AuthCatalog, "Contact">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Contact.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Contact.ts#L8)
+Defined in: [packages/play-dom/examples/demo/src/components/Contact.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Contact.ts#L8)
 
 Contact — Public contact page. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Contact'>). Renders static content from props.

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

@@ -6,7 +6,7 @@
 const Dashboard: ComponentFn<AuthCatalog, "Dashboard">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Dashboard.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Dashboard.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Dashboard.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Dashboard.ts#L9)
 
 Dashboard — Protected authenticated home. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Dashboard'>). Renders welcome message; logout

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

@@ -6,7 +6,7 @@
 const Home: ComponentFn<AuthCatalog, "Home">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Home.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Home.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Home.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Home.ts#L9)
 
 Home — Public landing page. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Home'>). Renders static welcome content from

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

@@ -6,7 +6,7 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Login.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Login.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Login.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Login.ts#L9)
 
 Login — Authentication form. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Login'>). Binds username input to ctx.store via

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

@@ -6,7 +6,7 @@
 const NavBarView: ComponentFn<AuthCatalog, "NavBar">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/NavBarView.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/NavBarView.ts#L12)
+Defined in: [packages/play-dom/examples/demo/src/components/NavBarView.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/NavBarView.ts#L12)
 
 NavBarView — Catalog-typed NavBar component for DOM renderer.
 

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

@@ -6,7 +6,7 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Navigation.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Navigation.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Navigation.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Navigation.ts#L9)
 
 Navigation — Navigation status display. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Navigation'>). Renders current path and auth

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

@@ -6,7 +6,7 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Overview.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Overview.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Overview.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Overview.ts#L9)
 
 Overview — Dashboard overview child route. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Overview'>). Relative route resolves to

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

@@ -6,7 +6,7 @@
 const Profile: ComponentFn<AuthCatalog, "Profile">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Profile.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Profile.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Profile.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Profile.ts#L9)
 
 Profile — Protected user profile page. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Profile'>). Renders username from route params

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

@@ -6,7 +6,7 @@
 const Settings: ComponentFn<AuthCatalog, "Settings">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Settings.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Settings.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Settings.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Settings.ts#L9)
 
 Settings — Protected settings page. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Settings'>). Renders active section and username

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

@@ -6,7 +6,7 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/components/Stats.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/components/Stats.ts#L9)
+Defined in: [packages/play-dom/examples/demo/src/components/Stats.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/components/Stats.ts#L9)
 
 Stats — Dashboard stats child route. Catalog-typed DOM component
 (ComponentFn<AuthCatalog, 'Stats'>). Relative route resolves to

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

@@ -169,4 +169,4 @@ const authCatalog: Catalog<
 >;
 ```
 
-Defined in: [packages/play-dom/examples/demo/src/catalog.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-dom/examples/demo/src/catalog.ts#L5)
+Defined in: [packages/play-dom/examples/demo/src/catalog.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-dom/examples/demo/src/catalog.ts#L5)

package/examples/@xmachines/play-dom-router-demo/README.md

@@ -1,11 +1,11 @@
 [Examples](../../README.md) / @xmachines/play-dom-router-demo
 
-<!-- generated-by: gsd-doc-writer -->
-
 # @xmachines/play-dom-router-demo
 
 Pure TypeScript integration demo for [`@xmachines/play-dom-router`](../../../api/@xmachines/play-dom-router/README.md) — actor-authoritative routing with the Browser History API and no framework.
 
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ## What This Demonstrates
 
 - Shared auth machine reused without framework-specific business logic

package/examples/@xmachines/play-react-demo/README.md

@@ -1,11 +1,11 @@
 [Examples](../../README.md) / @xmachines/play-react-demo
 
-<!-- generated-by: gsd-doc-writer -->
-
 # @xmachines/play-react-demo
 
 React renderer demo for [`@xmachines/play-react`](../../../api/@xmachines/play-react/README.md) — actor + `PlayRenderer` without a router.
 
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
 ## What This Demonstrates
 
 - Shared auth machine reused without framework-specific business logic

package/examples/@xmachines/play-react-demo/functions/App.md

@@ -6,7 +6,7 @@
 function App(): Element;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/App.tsx:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/examples/demo/src/App.tsx#L68)
+Defined in: [packages/play-react/examples/demo/src/App.tsx:72](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-react/examples/demo/src/App.tsx#L72)
 
 ## Returns
 

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

@@ -6,4 +6,4 @@
 type AuthCatalog = typeof authCatalog;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/catalog.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/examples/demo/src/catalog.ts#L6)
+Defined in: [packages/play-react/examples/demo/src/catalog.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-react/examples/demo/src/catalog.ts#L6)

package/examples/@xmachines/play-react-demo/variables/About.md

@@ -6,7 +6,7 @@
 const About: ComponentFn<AuthCatalog, "About">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/About.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/examples/demo/src/components/About.tsx#L10)
+Defined in: [packages/play-react/examples/demo/src/components/About.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-react/examples/demo/src/components/About.tsx#L10)
 
 About — Public information page
 

package/examples/@xmachines/play-react-demo/variables/Contact.md

@@ -6,7 +6,7 @@
 const Contact: ComponentFn<AuthCatalog, "Contact">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Contact.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/examples/demo/src/components/Contact.tsx#L10)
+Defined in: [packages/play-react/examples/demo/src/components/Contact.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-react/examples/demo/src/components/Contact.tsx#L10)
 
 Contact — Public contact page
 

package/examples/@xmachines/play-react-demo/variables/Dashboard.md

@@ -6,7 +6,7 @@
 const Dashboard: ComponentFn<AuthCatalog, "Dashboard">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Dashboard.tsx:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0/packages/play-react/examples/demo/src/components/Dashboard.tsx#L12)
+Defined in: [packages/play-react/examples/demo/src/components/Dashboard.tsx:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.1.0/packages/play-react/examples/demo/src/components/Dashboard.tsx#L12)
 
 Dashboard — Protected authenticated home