@xmachines/docs 1.0.0-beta.34 → 1.0.0-beta.36

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

@@ -140,7 +140,7 @@ What the shared Vitest layer provides automatically:
 - Shared setup injection (`config/vitest.setup.ts`) unless already present
 - Node setup injection (`config/vitest.node.setup.ts`) for non-browser projects
 - Runtime preflight:
-  - Node.js runtime/version check (`>=22`) in node setup
+    - Node.js runtime/version check (`>=22`) in node setup
 - DOM matcher extension via `@testing-library/jest-dom/vitest`
 
 ### Vitest Setup Injection Rules
@@ -190,9 +190,9 @@ import { foo } from "./bar"; // ❌ Wrong
 - **Plugins:** TypeScript, Unicorn, Import
 - **Categories:** Correctness (error), Suspicious (warn), Performance (warn)
 - **Key Rules:**
-  - Circular dependency detection (`import/no-cycle`)
-  - Unused variables (allow `_` prefix)
-  - TypeScript-specific checks
+    - Circular dependency detection (`import/no-cycle`)
+    - Unused variables (allow `_` prefix)
+    - TypeScript-specific checks
 
 ### Oxfmt (`config/oxfmt.json`)
 
@@ -206,14 +206,14 @@ import { foo } from "./bar"; // ❌ Wrong
 - **Helper API:** `defineXmVitestConfig(importMetaUrl, overrides)` merges shared defaults with package-specific Vitest config
 - **Auto-aliasing:** `resolve.alias` is wired to `xmAliases(importMetaUrl)` so workspace packages resolve to source
 - **Cross-runtime setup (`config/vitest.setup.ts`):**
-  - extends `expect` with `@testing-library/jest-dom/vitest`
+    - extends `expect` with `@testing-library/jest-dom/vitest`
 - **URLPattern setup (`config/vitest.urlpattern.setup.ts`):**
-  - loads `urlpattern-polyfill` — opt-in per package via `setupFiles: ["@xmachines/shared/vitest-urlpattern-setup"]`
-  - required for packages exercising URLPattern-based route matching (play-router and adapters)
-  - mirrors what consumers must do in production on Node < 24 or older browsers
+    - loads `urlpattern-polyfill` — opt-in per package via `setupFiles: ["@xmachines/shared/vitest-urlpattern-setup"]`
+    - required for packages exercising URLPattern-based route matching (play-router and adapters)
+    - mirrors what consumers must do in production on Node < 24 or older browsers
 - **Node-only setup (`config/vitest.node.setup.ts`):**
-  - asserts Node runtime (`process.release.name === "node"`)
-  - enforces Node version `>=22`
+    - asserts Node runtime (`process.release.name === "node"`)
+    - enforces Node version `>=22`
 - **Browser behavior:** Browser projects do not receive node-only setup injection
 - **Override model:** Package-level config still controls test environment, includes/excludes, plugins, coverage, and browser provider
 
@@ -228,22 +228,22 @@ import { foo } from "./bar"; // ❌ Wrong
 ### Vite Alias Troubleshooting
 
 - **`[xmAliases] Could not find workspace root`**
-  - Ensure `xmAliases` receives `import.meta.url` from the calling config file.
-  - Ensure the config file lives somewhere under the monorepo root.
+    - Ensure `xmAliases` receives `import.meta.url` from the calling config file.
+    - Ensure the config file lives somewhere under the monorepo root.
 - **Workspace package import resolves to missing `dist/` files**
-  - Ensure config includes `resolve.alias: xmAliases(import.meta.url)`.
-  - Re-run after cleaning caches when lockfile/deps changed.
+    - Ensure config includes `resolve.alias: xmAliases(import.meta.url)`.
+    - Re-run after cleaning caches when lockfile/deps changed.
 
 ### Vitest Troubleshooting
 
 - **`URLPattern is unavailable after setup`**
-  - Ensure `test.setupFiles` is not replacing shared setup unexpectedly.
-  - Ensure config is created via `defineXmVitestConfig(...)`.
+    - Ensure `test.setupFiles` is not replacing shared setup unexpectedly.
+    - Ensure config is created via `defineXmVitestConfig(...)`.
 - **`Node runtime is required for this Vitest configuration`**
-  - This indicates node-only setup loaded in a browser project.
-  - Set `test.browser.enabled: true` in that project config.
+    - This indicates node-only setup loaded in a browser project.
+    - Set `test.browser.enabled: true` in that project config.
 - **Workspace import resolution failures (e.g. `@xmachines/play-signals`)**
-  - Confirm config uses `defineXmVitestConfig(import.meta.url, ...)` so aliases are injected.
+    - Confirm config uses `defineXmVitestConfig(import.meta.url, ...)` so aliases are injected.
 
 ## TypeScript Composite Build System
 
@@ -311,31 +311,31 @@ When creating a new package:
 
 1. **Add to root tsconfig.json references:**
 
-   ```json
-   {
-   	"references": [{ "path": "./packages/your-new-package" }]
-   }
-   ```
+    ```json
+    {
+    	"references": [{ "path": "./packages/your-new-package" }]
+    }
+    ```
 
 2. **Enable composite in package tsconfig.json:**
 
-   ```json
-   {
-   	"extends": "@xmachines/shared/tsconfig",
-   	"compilerOptions": {
-   		"composite": true,
-   		"rootDir": "./src",
-   		"outDir": "./dist"
-   	}
-   }
-   ```
+    ```json
+    {
+    	"extends": "@xmachines/shared/tsconfig",
+    	"compilerOptions": {
+    		"composite": true,
+    		"rootDir": "./src",
+    		"outDir": "./dist"
+    	}
+    }
+    ```
 
 3. **Declare dependencies (if any):**
-   ```json
-   {
-   	"references": [{ "path": "../dependency-package" }]
-   }
-   ```
+    ```json
+    {
+    	"references": [{ "path": "../dependency-package" }]
+    }
+    ```
 
 ### IDE Benefits
 
@@ -355,14 +355,14 @@ To add a new shared configuration (e.g., for Jest, Vitest, etc.):
 
 1. Create `config/<tool>.json` (or `.js`, `.ts` as appropriate)
 2. Add exports to `package.json` exports field:
-   ```json
-   {
-   	"exports": {
-   		"./<tool>": "./config/<tool>.json",
-   		"./config/<tool>.json": "./config/<tool>.json"
-   	}
-   }
-   ```
+    ```json
+    {
+    	"exports": {
+    		"./<tool>": "./config/<tool>.json",
+    		"./config/<tool>.json": "./config/<tool>.json"
+    	}
+    }
+    ```
 3. Document in this README with usage examples
 4. Note whether the tool supports package exports or requires relative paths
 
@@ -373,7 +373,7 @@ Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
 This work is licensed under the terms of the MIT license.  
 For a copy, see <https://opensource.org/licenses/MIT>.
 
-## Functions
+## Modules
 
-- [defineXmVitestConfig](functions/defineXmVitestConfig.md)
-- [xmAliases](functions/xmAliases.md)
+- [vite-aliases](vite-aliases/README.md)
+- [vitest](vitest/README.md)

package/api/@xmachines/shared/vite-aliases/README.md

@@ -0,0 +1,10 @@
+[Documentation](../../../README.md) / [@xmachines/shared](../README.md) / vite-aliases
+
+# vite-aliases
+
+## Functions
+
+- [xmAliases](functions/xmAliases.md)
+- [xmCacheDir](functions/xmCacheDir.md)
+- [xmOptimizeDeps](functions/xmOptimizeDeps.md)
+- [xmResolve](functions/xmResolve.md)

package/api/@xmachines/shared/vite-aliases/functions/xmAliases.md

@@ -0,0 +1,34 @@
+[Documentation](../../../../README.md) / [@xmachines/shared](../../README.md) / [vite-aliases](../README.md) / xmAliases
+
+# Function: xmAliases()
+
+```ts
+function xmAliases(importMetaUrl): Record<string, string>;
+```
+
+Defined in: [vite-aliases.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/shared/config/vite-aliases.ts#L24)
+
+Vite resolve.alias entries for all @xmachines/\* workspace packages.
+
+Maps every package to its TypeScript source entry so that `npm run dev`
+works without a prior `npm run build`. Required because `npm run clean`
+removes all dist/ directories — including transitive dependencies —
+leaving Vite unable to resolve package.json `exports` that point to dist/.
+
+Usage in a demo vite.config.ts:
+
+import { xmAliases } from "@xmachines/shared/vite-aliases";
+
+export default defineConfig({
+resolve: { alias: xmAliases(import.meta.url) },
+});
+
+## Parameters
+
+| Parameter       | Type     | Description                                                                                                                    |
+| --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
+| `importMetaUrl` | `string` | Pass `import.meta.url` from the calling config file. Used to locate the workspace root (the directory containing `packages/`). |
+
+## Returns
+
+`Record`\<`string`, `string`\>

package/api/@xmachines/shared/vite-aliases/functions/xmCacheDir.md

@@ -0,0 +1,27 @@
+[Documentation](../../../../README.md) / [@xmachines/shared](../../README.md) / [vite-aliases](../README.md) / xmCacheDir
+
+# Function: xmCacheDir()
+
+```ts
+function xmCacheDir(importMetaUrl, name): string;
+```
+
+Defined in: [vite-aliases.ts:196](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/shared/config/vite-aliases.ts#L196)
+
+Returns the shared Vite `cacheDir` for this workspace package.
+
+All browser test projects use a single cache under `<workspace-root>/node_modules/.vite/`
+keyed by the project name. This means the dep optimizer runs once per project
+across the whole workspace rather than once per local `node_modules/.vite/` directory,
+and a lockfile change only triggers one rebuild per project — not one per local cache.
+
+## Parameters
+
+| Parameter       | Type     | Description                                          |
+| --------------- | -------- | ---------------------------------------------------- |
+| `importMetaUrl` | `string` | Pass `import.meta.url` from the calling config file. |
+| `name`          | `string` | Unique project name (matches `test.name`).           |
+
+## Returns
+
+`string`

package/api/@xmachines/shared/vite-aliases/functions/xmOptimizeDeps.md

@@ -0,0 +1,30 @@
+[Documentation](../../../../README.md) / [@xmachines/shared](../../README.md) / [vite-aliases](../README.md) / xmOptimizeDeps
+
+# Function: xmOptimizeDeps()
+
+```ts
+function xmOptimizeDeps(extra?): DepOptimizationOptions;
+```
+
+Defined in: [vite-aliases.ts:179](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/shared/config/vite-aliases.ts#L179)
+
+Returns the standard Vite `optimizeDeps` config for browser test projects.
+
+Tells Vite's dep optimizer which packages to pre-bundle at startup rather than
+discovering them lazily at runtime. Without this, adding or changing dependencies
+(e.g. a lockfile change) causes Vite to re-optimize mid-run, producing the
+"Re-optimizing dependencies because lockfile has changed" warnings that slow down
+and occasionally destabilise browser test runs.
+
+Pass `extra` to include framework-specific packages (e.g. `["@json-render/vue/schema"]`).
+The base set (`@json-render/core`) is always included.
+
+## Parameters
+
+| Parameter | Type       | Default value | Description                                                       |
+| --------- | ---------- | ------------- | ----------------------------------------------------------------- |
+| `extra`   | `string`[] | `[]`          | Additional package specifiers to pre-bundle (framework-specific). |
+
+## Returns
+
+`DepOptimizationOptions`

package/api/@xmachines/shared/vite-aliases/functions/xmResolve.md

@@ -0,0 +1,41 @@
+[Documentation](../../../../README.md) / [@xmachines/shared](../../README.md) / [vite-aliases](../README.md) / xmResolve
+
+# Function: xmResolve()
+
+```ts
+function xmResolve(importMetaUrl, extra?): ResolveOptions & object;
+```
+
+Defined in: [vite-aliases.ts:151](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/shared/config/vite-aliases.ts#L151)
+
+Full Vite `resolve` config for @xmachines/\* workspace packages.
+
+Combines `xmAliases` with `conditions: ["source"]` so Vite resolves every
+`@xmachines/*` package to its TypeScript source via the `"source"` export
+condition — without requiring a prior `npm run build`.
+
+`preserveSymlinks` defaults to `true` because these configs run inside a linked
+monorepo. Keeping symlinked workspace packages stable avoids Vite dep optimizer
+churn caused by the same package being observed through both symlinked and
+real paths. Callers can still override it explicitly.
+
+Use this instead of manually setting `resolve.alias: xmAliases(...)`:
+
+```ts
+import { xmResolve } from "@xmachines/shared/vite-aliases";
+
+export default defineConfig({
+	resolve: xmResolve(import.meta.url),
+});
+```
+
+## Parameters
+
+| Parameter       | Type                                     | Description                                          |
+| --------------- | ---------------------------------------- | ---------------------------------------------------- |
+| `importMetaUrl` | `string`                                 | Pass `import.meta.url` from the calling config file. |
+| `extra?`        | `Partial`\<`ResolveOptions` & `object`\> | -                                                    |
+
+## Returns
+
+`ResolveOptions` & `object`

package/api/@xmachines/shared/vitest/README.md

@@ -0,0 +1,7 @@
+[Documentation](../../../README.md) / [@xmachines/shared](../README.md) / vitest
+
+# vitest
+
+## Functions
+
+- [defineXmVitestConfig](functions/defineXmVitestConfig.md)

package/api/@xmachines/shared/vitest/functions/defineXmVitestConfig.md

@@ -0,0 +1,34 @@
+[Documentation](../../../../README.md) / [@xmachines/shared](../../README.md) / [vitest](../README.md) / defineXmVitestConfig
+
+# Function: defineXmVitestConfig()
+
+```ts
+function defineXmVitestConfig(importMetaUrl, overrides): UserConfig;
+```
+
+Defined in: [vitest.ts:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/shared/config/vitest.ts#L55)
+
+Create a Vitest config with XMachines workspace defaults.
+
+What this applies automatically:
+
+- `resolve.alias` from `xmAliases(importMetaUrl)` so `@xmachines/*` imports
+  resolve to source in local/dev test runs.
+- `config/vitest.setup.ts` when missing.
+- `config/vitest.node.setup.ts` for non-browser projects when missing.
+
+Setup injection is additive and preserves caller-provided ordering after
+required shared setup files.
+
+## Parameters
+
+| Parameter       | Type         | Description                                          |
+| --------------- | ------------ | ---------------------------------------------------- |
+| `importMetaUrl` | `string`     | Pass `import.meta.url` from the calling config file. |
+| `overrides`     | `UserConfig` | Package/project-specific Vitest config overrides.    |
+
+## Returns
+
+`UserConfig`
+
+Merged Vitest configuration object.

package/api/llms.txt

@@ -54,8 +54,8 @@
 ## Quick Reference
 
 ```javascript
-import { definePlayer, formatPlayRouteTransitions } from '@xmachines/play-xstate';
-import { extractMachineRoutes } from '@xmachines/play-router';
+import { definePlayer } from '@xmachines/play-xstate';
+import { createRouteMap, extractMachineRoutes } from '@xmachines/play-router';
 import { defineRegistry } from '@json-render/react';
 import { PlayRenderer } from '@xmachines/play-react';
 
@@ -66,6 +66,8 @@ actor.start();
 const currentView = actor.currentView.get();
 const currentRoute = actor.currentRoute.get();
 const routeTree = extractMachineRoutes(machine);
+const routeMatcher = createRouteMap(routeTree);
+const routeMatch = routeMatcher.match(currentRoute ?? '/');
 
 const { registry } = defineRegistry(catalog, { components, actions });
 <PlayRenderer actor={actor} registry={registry} actions={{ login: 'auth.login' }} />

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

@@ -144,8 +144,8 @@ Expected result: library-pattern invariant tests pass and the browser renderer s
 
 ## Learn More
 
-- [Play DOM package README](../../README.md)
-- [Play DOM Router demo README](../../../play-dom-router/examples/demo/README.md)
+- [Play DOM](../../README.md)
+- [Play DOM Router](../../../play-dom-router/examples/demo)
 
 ## Type Aliases
 

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

@@ -6,10 +6,11 @@
 function createNavBar(actor, container): () => void;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/NavBar.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/NavBar.ts#L15)
+Defined in: [play-dom/examples/demo/src/components/NavBar.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/play-dom/examples/demo/src/components/NavBar.ts#L9)
 
-Create and mount a reactive NavBar into the given container element.
-Returns a cleanup function to stop watching.
+NavBar — App-shell navigation factory. Mounts a reactive nav into
+`container`, observes actor.state via watchSignal, and updates button
+visibility based on auth state. Returns a disconnect function.
 
 ## Parameters
 

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

@@ -6,7 +6,11 @@
 function initShell(actor, appElement): () => void;
 ```
 
-Defined in: [play-dom/examples/demo/src/shell.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/shell.ts#L35)
+Defined in: [play-dom/examples/demo/src/components/Shell.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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.
+Returns a disconnect function.
 
 ## Parameters
 

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.34/packages/play-dom/examples/demo/src/catalog.ts#L6)
+Defined in: [play-dom/examples/demo/src/catalog.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/play-dom/examples/demo/src/catalog.ts#L6)

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

@@ -6,4 +6,7 @@
 const About: ComponentFn<AuthCatalog, "About">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/About.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/About.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/About.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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,4 +6,7 @@
 const Contact: ComponentFn<AuthCatalog, "Contact">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Contact.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Contact.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Contact.ts:8](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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,4 +6,8 @@
 const Dashboard: ComponentFn<AuthCatalog, "Dashboard">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Dashboard.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Dashboard.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Dashboard.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+button emits 'logout' action.

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

@@ -6,4 +6,8 @@
 const Home: ComponentFn<AuthCatalog, "Home">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Home.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Home.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Home.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+props.

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

@@ -6,4 +6,8 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Login.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Login.ts#L7)
+Defined in: [play-dom/examples/demo/src/components/Login.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+$bindState; emits 'submit' on form submit.

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

@@ -6,4 +6,11 @@
 const NavBarView: ComponentFn<AuthCatalog, "NavBar">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/NavBarView.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/NavBarView.ts#L13)
+Defined in: [play-dom/examples/demo/src/components/NavBarView.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/play-dom/examples/demo/src/components/NavBarView.ts#L12)
+
+NavBarView — Catalog-typed NavBar component for DOM renderer.
+
+Receives props from spec (isAuthenticated, username) and renders a static nav element.
+Used in the defineRegistry components map.
+
+The actor-driven NavBar (createNavBar) is mounted at the shell level.

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

@@ -6,4 +6,8 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Navigation.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Navigation.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Navigation.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+status from props.

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

@@ -6,4 +6,8 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Overview.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Overview.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Overview.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+/dashboard/overview. Logout and goToStats buttons emit actions.

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

@@ -6,4 +6,8 @@
 const Profile: ComponentFn<AuthCatalog, "Profile">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Profile.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Profile.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Profile.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+filled into props.

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

@@ -6,4 +6,8 @@
 const Settings: ComponentFn<AuthCatalog, "Settings">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Settings.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Settings.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Settings.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+from props.

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

@@ -6,4 +6,8 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [play-dom/examples/demo/src/components/Stats.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.34/packages/play-dom/examples/demo/src/components/Stats.ts#L4)
+Defined in: [play-dom/examples/demo/src/components/Stats.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/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
+/dashboard/stats. goToOverview button emits action.

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.34/packages/play-dom/examples/demo/src/catalog.ts#L5)
+Defined in: [play-dom/examples/demo/src/catalog.ts:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.36/packages/play-dom/examples/demo/src/catalog.ts#L5)