@xmachines/docs 1.0.0-beta.55 → 1.0.0-beta.57

package/contributing/testing.md

@@ -24,7 +24,7 @@ All packages extend the shared Vitest configuration helper `defineXmVitestConfig
 Before running any tests, ensure all dependencies are installed:
 
 ```bash
-npm ci
+pnpm install --frozen-lockfile
 ```
 
 ## Running Tests
@@ -32,7 +32,7 @@ npm ci
 ### Full test suite (Node environments)
 
 ```bash
-npm test
+pnpm test
 ```
 
 Runs `vitest run` across all 30 package-level projects defined in the root `vitest.config.ts`. Uses the `forks` pool (up to 4 workers) with process-level isolation between test files.
@@ -40,7 +40,7 @@ Runs `vitest run` across all 30 package-level projects defined in the root `vite
 ### Watch mode (development)
 
 ```bash
-npm run test:watch
+pnpm run test:watch
 ```
 
 Runs `vitest` in interactive watch mode. Re-runs affected tests on file change.
@@ -48,7 +48,7 @@ Runs `vitest` in interactive watch mode. Re-runs affected tests on file change.
 ### Browser tests (Playwright / Chromium)
 
 ```bash
-npm run test:browser
+pnpm run test:browser
 ```
 
 Runs `vitest run --config vitest.browser.config.ts`. Launches all browser-mode projects using headless Chromium via Playwright. Includes both package-level browser unit tests and full demo-app integration flows. The browser global setup (`vitest.browser.global-setup.ts`) raises `process.setMaxListeners` to 32 before workers spawn to prevent false-positive `MaxListenersExceededWarning` with multiple parallel browser projects.
@@ -56,20 +56,20 @@ Runs `vitest run --config vitest.browser.config.ts`. Launches all browser-mode p
 ### With coverage
 
 ```bash
-npm run test:coverage
+pnpm run test:coverage
 ```
 
 Produces coverage output in `text`, `html`, and `json-summary` formats.
 
 ```bash
-npm run coverage:report   # HTML report
-npm run coverage:summary  # JSON summary only
+pnpm run coverage:report   # HTML report
+pnpm run coverage:summary  # JSON summary only
 ```
 
 ### Verify TypeScript test graph compiles
 
 ```bash
-npm run test:build
+pnpm run test:build
 ```
 
 Runs `tsc --build tsconfig.test.json`. This validates that all test TypeScript files across the monorepo type-check correctly without running the tests themselves. Also compiles `.typecheck.ts` files in `src/` directories.
@@ -79,11 +79,11 @@ Runs `tsc --build tsconfig.test.json`. This validates that all test TypeScript f
 From the monorepo root:
 
 ```bash
-npm test -w packages/play
-npm run test:coverage -w packages/play-react
+pnpm --filter @xmachines/play test
+pnpm --filter @xmachines/play-react run test:coverage
 ```
 
-Or from within a package directory, run `npx vitest run` directly after building the workspace.
+Or from within a package directory, run `pnpm exec vitest run` directly after building the workspace.
 
 ## Test File Organization
 
@@ -110,7 +110,7 @@ packages/<name>/
 | `.spec.ts`                               | Protocol enforcement tests; compile-time type safety tests; used in core packages (`play`, `play-actor`, `play-signals`, `play-xstate`) |
 | `.test.ts`                               | Unit, integration, and behavioral tests; used across all packages                                                                       |
 | `.browser.test.ts` / `.browser.test.tsx` | Playwright browser environment tests; excluded from standard `vitest.config.ts`, only run via `vitest.browser.config.ts`                |
-| `.typecheck.ts` (in `src/`)              | Compile-time-only type assertion files; not Vitest test files; validated by `npm run test:build`                                        |
+| `.typecheck.ts` (in `src/`)              | Compile-time-only type assertion files; not Vitest test files; validated by `pnpm run test:build`                                       |
 | `router-bridge-contract.ts`              | Shared contract test runner; not a test file itself; imported by adapter test files                                                     |
 
 ### Test environments
@@ -330,7 +330,7 @@ const actorNotAny: AssertFalse<IsAny<typeof actor>> = false;
 void actorNotAny;
 ```
 
-These files are validated by `npm run test:build` (`tsc --build tsconfig.test.json`) — never executed by Vitest.
+These files are validated by `pnpm run test:build` (`tsc --build tsconfig.test.json`) — never executed by Vitest.
 
 ### Error testing
 
@@ -422,7 +422,7 @@ Tests run in GitLab CI using the `to-be-continuous/node` pipeline component (ver
 **CI test command** (from `.gitlab-ci.yml`):
 
 ```bash
-npm run test:coverage -- \
+pnpm run test:coverage -- \
   --coverage.reporter=text \
   --coverage.reporter=cobertura \
   --coverage.reportsDirectory=reports/coverage \
@@ -438,7 +438,7 @@ npm run test:coverage -- \
 
 Coverage and test results are always uploaded (`when: always`) so failures are visible even when the job itself fails.
 
-The `npm run format:check` and `npm run lint` commands enforce code style and are run separately from tests (via the `lint-enabled: true` input to the pipeline component).
+The `pnpm run format:check` and `pnpm run lint` commands enforce code style and are run separately from tests (via the `lint-enabled: true` input to the pipeline component).
 
 ## Test Types Reference
 

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

@@ -19,11 +19,11 @@ Vanilla DOM renderer demo for [`@xmachines/play-dom`](../../../api/@xmachines/pl
 From the repository root:
 
 ```bash
-npm install
-npm run dev -w @xmachines/play-dom-demo
+pnpm install
+pnpm --filter @xmachines/play-dom-demo run dev
 ```
 
-Then open `http://localhost:5173`.
+Then open `http://localhost:3000`.
 
 ## Step-by-Step Code Flow
 
@@ -132,21 +132,21 @@ Watcher notifications are one-shot. Cleanup is explicit: `disconnectNavBar()`, `
 
 These commands are defined in `package.json`:
 
-| Command                                            | Description                      |
-| -------------------------------------------------- | -------------------------------- |
-| `npm run dev -w @xmachines/play-dom-demo`          | Start Vite dev server            |
-| `npm run build -w @xmachines/play-dom-demo`        | Build production bundle          |
-| `npm run preview -w @xmachines/play-dom-demo`      | Preview built bundle             |
-| `npm run test -w @xmachines/play-dom-demo`         | Run Vitest test suite            |
-| `npm run test:browser -w @xmachines/play-dom-demo` | Run browser-focused Vitest suite |
+| Command                                                   | Description                                    |
+| --------------------------------------------------------- | ---------------------------------------------- |
+| `pnpm --filter @xmachines/play-dom-demo run dev`          | Start Vite dev server (http://localhost:3000/) |
+| `pnpm --filter @xmachines/play-dom-demo run build`        | Build production bundle                        |
+| `pnpm --filter @xmachines/play-dom-demo run preview`      | Preview built bundle                           |
+| `pnpm --filter @xmachines/play-dom-demo run test`         | Run Vitest test suite                          |
+| `pnpm --filter @xmachines/play-dom-demo run test:browser` | Run browser-focused Vitest suite               |
 
 ## Verification
 
 Use these checks to validate README claims against the current demo implementation:
 
 ```bash
-npm run test -w @xmachines/play-dom-demo
-npm run test:browser -w @xmachines/play-dom-demo
+pnpm --filter @xmachines/play-dom-demo run test
+pnpm --filter @xmachines/play-dom-demo run test:browser
 ```
 
 Expected result: library-pattern invariant tests pass and the browser renderer suite completes.

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

@@ -6,7 +6,7 @@
 function createNavBar(actor, container): () => void;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/NavBar.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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

@@ -6,7 +6,7 @@
 function initShell(actor, appElement): () => void;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Shell.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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.

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

@@ -6,4 +6,4 @@
 type AuthCatalog = typeof authCatalog;
 ```
 
-Defined in: [play-dom/examples/demo/src/catalog.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/About.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Contact.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Dashboard.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Home.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Login.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/NavBarView.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Navigation.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Overview.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Profile.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Settings.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/components/Stats.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/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: [play-dom/examples/demo/src/catalog.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/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.0.0-beta.57/packages/play-dom/examples/demo/src/catalog.ts#L5)

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

@@ -19,11 +19,11 @@ Pure TypeScript integration demo for [`@xmachines/play-dom-router`](../../../api
 From the repository root:
 
 ```bash
-npm install
-npm run dev -w @xmachines/play-dom-router-demo
+pnpm install
+pnpm --filter @xmachines/play-dom-router-demo run dev
 ```
 
-Then open `http://localhost:5174`.
+Then open `http://localhost:3005`.
 
 ## Step-by-Step Code Flow
 
@@ -119,21 +119,21 @@ Watcher notifications are one-shot, so re-arm is mandatory. Router/shell teardow
 
 These commands are defined in `package.json`:
 
-| Command                                                   | Description                      |
-| --------------------------------------------------------- | -------------------------------- |
-| `npm run dev -w @xmachines/play-dom-router-demo`          | Start Vite dev server            |
-| `npm run build -w @xmachines/play-dom-router-demo`        | Build production bundle          |
-| `npm run preview -w @xmachines/play-dom-router-demo`      | Preview built bundle             |
-| `npm run test -w @xmachines/play-dom-router-demo`         | Run Vitest test suite            |
-| `npm run test:browser -w @xmachines/play-dom-router-demo` | Run browser-focused Vitest suite |
+| Command                                                          | Description                                    |
+| ---------------------------------------------------------------- | ---------------------------------------------- |
+| `pnpm --filter @xmachines/play-dom-router-demo run dev`          | Start Vite dev server (http://localhost:3005/) |
+| `pnpm --filter @xmachines/play-dom-router-demo run build`        | Build production bundle                        |
+| `pnpm --filter @xmachines/play-dom-router-demo run preview`      | Preview built bundle                           |
+| `pnpm --filter @xmachines/play-dom-router-demo run test`         | Run Vitest test suite                          |
+| `pnpm --filter @xmachines/play-dom-router-demo run test:browser` | Run browser-focused Vitest suite               |
 
 ## Verification
 
 Use these checks to validate README claims against the current demo implementation:
 
 ```bash
-npm run test -w @xmachines/play-dom-router-demo
-npm run test:browser -w @xmachines/play-dom-router-demo
+pnpm --filter @xmachines/play-dom-router-demo run test
+pnpm --filter @xmachines/play-dom-router-demo run test:browser
 ```
 
 Expected result: tests pass, including startup rendering and the full browser auth flow in `test/browser/`.

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

@@ -19,11 +19,11 @@ React renderer demo for [`@xmachines/play-react`](../../../api/@xmachines/play-r
 From the repository root:
 
 ```bash
-npm install
-npm run dev -w @xmachines/play-react-demo
+pnpm install
+pnpm --filter @xmachines/play-react-demo run dev
 ```
 
-Then open `http://localhost:5173`.
+Then open `http://localhost:3001`.
 
 ## Step-by-Step Code Flow
 
@@ -103,7 +103,7 @@ export function App() {
 
 - `src/main.tsx` - React entry point that mounts `<App />`
 - `src/App.tsx` - actor lifecycle, registry construction, and `PlayUIProvider` + `PlayRenderer` composition
-- `src/catalog.ts` - catalog definition using `defineCatalog` from `@json-render/core` with `@json-render/react/schema`
+- `src/catalog.ts` - catalog definition using `defineCatalog` from `@xmachines/json-render-core` with `@xmachines/json-render-react/schema`
 - `src/components/` - demo view components bound to catalog component keys (Home, Login, Dashboard, Profile, etc.)
 - `test/library-pattern.test.ts` - architecture boundary and invariant assertions
 - `test/browser/renderer-demo.browser.test.tsx` - browser-mode renderer coverage
@@ -136,21 +136,21 @@ Watcher notifications are one-shot. Cleanup is explicit: `actor.stop()` is calle
 
 These commands are defined in `package.json`:
 
-| Command                                              | Description                      |
-| ---------------------------------------------------- | -------------------------------- |
-| `npm run dev -w @xmachines/play-react-demo`          | Start Vite dev server            |
-| `npm run build -w @xmachines/play-react-demo`        | Build production bundle          |
-| `npm run preview -w @xmachines/play-react-demo`      | Preview built bundle             |
-| `npm run test -w @xmachines/play-react-demo`         | Run Vitest test suite            |
-| `npm run test:browser -w @xmachines/play-react-demo` | Run browser-focused Vitest suite |
+| Command                                                     | Description                                    |
+| ----------------------------------------------------------- | ---------------------------------------------- |
+| `pnpm --filter @xmachines/play-react-demo run dev`          | Start Vite dev server (http://localhost:3001/) |
+| `pnpm --filter @xmachines/play-react-demo run build`        | Build production bundle                        |
+| `pnpm --filter @xmachines/play-react-demo run preview`      | Preview built bundle                           |
+| `pnpm --filter @xmachines/play-react-demo run test`         | Run Vitest test suite                          |
+| `pnpm --filter @xmachines/play-react-demo run test:browser` | Run browser-focused Vitest suite               |
 
 ## Verification
 
 Use these checks to validate README claims against the current demo implementation:
 
 ```bash
-npm run test -w @xmachines/play-react-demo
-npm run test:browser -w @xmachines/play-react-demo
+pnpm --filter @xmachines/play-react-demo run test
+pnpm --filter @xmachines/play-react-demo run test:browser
 ```
 
 Expected result: library-pattern invariant tests pass and the browser renderer suite completes.

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-beta.55/packages/play-react/examples/demo/src/App.tsx#L68)
+Defined in: [packages/play-react/examples/demo/src/App.tsx:68](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/App.tsx#L68)
 
 ## 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-beta.55/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.0.0-beta.57/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-beta.55/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.0.0-beta.57/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-beta.55/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.0.0-beta.57/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-beta.55/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.0.0-beta.57/packages/play-react/examples/demo/src/components/Dashboard.tsx#L12)
 
 Dashboard — Protected authenticated home
 

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

@@ -8,7 +8,7 @@ const DebugPanel: FC<{
 }>;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/DebugPanel.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/DebugPanel.tsx#L11)
+Defined in: [packages/play-react/examples/demo/src/components/DebugPanel.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/DebugPanel.tsx#L11)
 
 DebugPanel — Live debug footer. Observes actor.state and actor.currentRoute
 via useSignalEffect and displays current state value, can-logout status,

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

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

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

@@ -6,7 +6,7 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Login.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Login.tsx#L14)
+Defined in: [packages/play-react/examples/demo/src/components/Login.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Login.tsx#L14)
 
 Login — Authentication form
 

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

@@ -8,7 +8,7 @@ const NavBar: FC<{
 }>;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/NavBar.tsx:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/NavBar.tsx#L12)
+Defined in: [packages/play-react/examples/demo/src/components/NavBar.tsx:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/NavBar.tsx#L12)
 
 NavBar — App-shell navigation component.
 

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

@@ -6,7 +6,7 @@
 const NavBarView: ComponentFn<AuthCatalog, "NavBar">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/NavBarView.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/NavBarView.tsx#L11)
+Defined in: [packages/play-react/examples/demo/src/components/NavBarView.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/NavBarView.tsx#L11)
 
 NavBarView — Catalog-typed NavBar for use in defineRegistry components map.
 

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

@@ -6,7 +6,7 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Navigation.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Navigation.tsx#L10)
+Defined in: [packages/play-react/examples/demo/src/components/Navigation.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Navigation.tsx#L10)
 
 Navigation - Status display component
 

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

@@ -6,7 +6,7 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Overview.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Overview.tsx#L10)
+Defined in: [packages/play-react/examples/demo/src/components/Overview.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Overview.tsx#L10)
 
 Overview - Dashboard overview child route component
 

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

@@ -6,7 +6,7 @@
 const Profile: ComponentFn<AuthCatalog, "Profile">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Profile.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Profile.tsx#L11)
+Defined in: [packages/play-react/examples/demo/src/components/Profile.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Profile.tsx#L11)
 
 Profile — Protected user profile page
 

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

@@ -6,7 +6,7 @@
 const Settings: ComponentFn<AuthCatalog, "Settings">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Settings.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Settings.tsx#L11)
+Defined in: [packages/play-react/examples/demo/src/components/Settings.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Settings.tsx#L11)
 
 Settings — Protected settings page
 

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

@@ -10,7 +10,7 @@ const Shell: FC<{
 }>;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Shell.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Shell.tsx#L14)
+Defined in: [packages/play-react/examples/demo/src/components/Shell.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Shell.tsx#L14)
 
 Demo Shell layout component.
 

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

@@ -6,7 +6,7 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [packages/play-react/examples/demo/src/components/Stats.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-react/examples/demo/src/components/Stats.tsx#L10)
+Defined in: [packages/play-react/examples/demo/src/components/Stats.tsx:10](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.57/packages/play-react/examples/demo/src/components/Stats.tsx#L10)
 
 Stats - Dashboard stats child route component
 

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

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