@xmachines/docs 1.0.0-beta.28 → 1.0.0-beta.30

package/api/README.md

@@ -1,63 +1,23 @@
-# XMachines API Reference
-
-Generated API documentation for the XMachines JavaScript/TypeScript packages.
-
-## Start Here
-
-- For actor contracts, start with [@xmachines/play-actor](@xmachines/play-actor/README.md).
-- For player creation from XState machines, start with [@xmachines/play-xstate](@xmachines/play-xstate/README.md).
-- For route extraction and shared URL synchronization logic, start with [@xmachines/play-router](@xmachines/play-router/README.md).
-- For rendering, choose one of [@xmachines/play-react](@xmachines/play-react/README.md), [@xmachines/play-solid](@xmachines/play-solid/README.md), [@xmachines/play-svelte](@xmachines/play-svelte/README.md), or [@xmachines/play-vue](@xmachines/play-vue/README.md).
-- For framework router integration, choose the matching adapter package such as [@xmachines/play-react-router](@xmachines/play-react-router/README.md), [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md), [@xmachines/play-sveltekit-router](@xmachines/play-sveltekit-router/README.md), or [@xmachines/play-svelte-spa-router](@xmachines/play-svelte-spa-router/README.md).
-
-## Key Concepts
-
-- [Viewable](@xmachines/play-actor/interfaces/Viewable.md) actors expose `currentView` and a component catalog for renderer packages.
-- [Routable](@xmachines/play-actor/interfaces/Routable.md) actors expose `currentRoute` and route-oriented events for router adapters.
-- Router adapters are passive infrastructure: they synchronize URLs with actor state but do not own business rules.
-
-## Package Roles
-
-- `Core runtime`: [@xmachines/play](@xmachines/play/README.md), [@xmachines/play-actor](@xmachines/play-actor/README.md), [@xmachines/play-signals](@xmachines/play-signals/README.md), [@xmachines/play-router](@xmachines/play-router/README.md), and [@xmachines/play-xstate](@xmachines/play-xstate/README.md)
-- `Rendering`: [@xmachines/play-react](@xmachines/play-react/README.md), [@xmachines/play-solid](@xmachines/play-solid/README.md), [@xmachines/play-svelte](@xmachines/play-svelte/README.md), and [@xmachines/play-vue](@xmachines/play-vue/README.md)
-- `Router adapters`: [@xmachines/play-react-router](@xmachines/play-react-router/README.md), [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md), [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md), [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md), [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md), [@xmachines/play-sveltekit-router](@xmachines/play-sveltekit-router/README.md), and [@xmachines/play-svelte-spa-router](@xmachines/play-svelte-spa-router/README.md)
-- `Shared tooling`: [@xmachines/shared](@xmachines/shared/README.md)
-
-## Notes
-
-- Demo packages are included in the generated package index below, but most implementation questions should start with the core runtime and adapter packages above.
-- A useful reading order is usually: [@xmachines/play-actor](@xmachines/play-actor/README.md) -> [@xmachines/play-xstate](@xmachines/play-xstate/README.md) -> [@xmachines/play-router](@xmachines/play-router/README.md) -> framework renderer/adapter.
+# Documentation
 
 ## Packages
 
 - [@xmachines/play](@xmachines/play/README.md)
 - [@xmachines/play-actor](@xmachines/play-actor/README.md)
-- [@xmachines/play-actor-shared](@xmachines/play-actor-shared/README.md)
 - [@xmachines/play-dom](@xmachines/play-dom/README.md)
-- [@xmachines/play-dom-demo](@xmachines/play-dom-demo/README.md)
 - [@xmachines/play-dom-router](@xmachines/play-dom-router/README.md)
-- [@xmachines/play-dom-router-demo](@xmachines/play-dom-router-demo/README.md)
 - [@xmachines/play-react](@xmachines/play-react/README.md)
-- [@xmachines/play-react-demo](@xmachines/play-react-demo/README.md)
 - [@xmachines/play-react-router](@xmachines/play-react-router/README.md)
-- [@xmachines/play-react-router-demo](@xmachines/play-react-router-demo/README.md)
 - [@xmachines/play-router](@xmachines/play-router/README.md)
 - [@xmachines/play-signals](@xmachines/play-signals/README.md)
 - [@xmachines/play-solid](@xmachines/play-solid/README.md)
-- [@xmachines/play-solid-demo](@xmachines/play-solid-demo/README.md)
 - [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md)
-- [@xmachines/play-solid-router-demo](@xmachines/play-solid-router-demo/README.md)
 - [@xmachines/play-svelte](@xmachines/play-svelte/README.md)
-- [@xmachines/play-svelte-demo](@xmachines/play-svelte-demo/README.md)
 - [@xmachines/play-svelte-spa-router](@xmachines/play-svelte-spa-router/README.md)
 - [@xmachines/play-sveltekit-router](@xmachines/play-sveltekit-router/README.md)
 - [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md)
-- [@xmachines/play-tanstack-react-router-demo](@xmachines/play-tanstack-react-router-demo/README.md)
 - [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md)
-- [@xmachines/play-tanstack-solid-router-demo](@xmachines/play-tanstack-solid-router-demo/README.md)
 - [@xmachines/play-vue](@xmachines/play-vue/README.md)
-- [@xmachines/play-vue-demo](@xmachines/play-vue-demo/README.md)
 - [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md)
-- [@xmachines/play-vue-router-demo](@xmachines/play-vue-router-demo/README.md)
 - [@xmachines/play-xstate](@xmachines/play-xstate/README.md)
 - [@xmachines/shared](@xmachines/shared/README.md)

package/api/llms.txt

@@ -33,11 +33,14 @@
 - [@xmachines/play-react](@xmachines/play-react/README.md): React renderer for Viewable actors
 - [@xmachines/play-solid](@xmachines/play-solid/README.md): Solid renderer for Viewable actors
 - [@xmachines/play-vue](@xmachines/play-vue/README.md): Vue renderer for Viewable actors
+- [@xmachines/play-svelte](@xmachines/play-svelte/README.md): Svelte renderer for Viewable actors
 - [@xmachines/play-react-router](@xmachines/play-react-router/README.md): React Router bridge and provider for actor-driven navigation
 - [@xmachines/play-tanstack-react-router](@xmachines/play-tanstack-react-router/README.md): TanStack React Router bridge and provider
 - [@xmachines/play-solid-router](@xmachines/play-solid-router/README.md): Solid Router bridge and provider
 - [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md): TanStack Solid Router bridge and provider
 - [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md): Vue Router bridge and provider
+- [@xmachines/play-sveltekit-router](@xmachines/play-sveltekit-router/README.md): SvelteKit router adapter for actor-driven navigation
+- [@xmachines/play-svelte-spa-router](@xmachines/play-svelte-spa-router/README.md): Svelte SPA router adapter for actor-driven navigation
 - [@xmachines/shared](@xmachines/shared/README.md): Shared TypeScript, oxlint, and formatting configuration
 
 ## Notes For LLMs
@@ -56,21 +59,14 @@ import { extractMachineRoutes } from '@xmachines/play-router';
 import { defineRegistry } from '@json-render/react';
 import { PlayRenderer } from '@xmachines/play-react';
 
-// Define a player from a machine
 const createPlayer = definePlayer({ machine });
 const actor = createPlayer();
 actor.start();
 
-// `Viewable` actors expose renderable view metadata
-const currentView = actor.currentView.get(); // { component, spec }
-
-// `Routable` actors expose route state for adapters to observe
+const currentView = actor.currentView.get();
 const currentRoute = actor.currentRoute.get();
-
-// Extract route metadata for a framework adapter
 const routeTree = extractMachineRoutes(machine);
 
-// Wire components to catalog and render
 const { registry } = defineRegistry(catalog, { components, actions });
 <PlayRenderer actor={actor} registry={registry} actions={{ login: 'auth.login' }} />
 ```

package/{api → examples}/@xmachines/play-dom-demo/README.md

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

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

@@ -0,0 +1,20 @@
+[Documentation](../../../README.md) / [@xmachines/play-dom-demo](../README.md) / initShell
+
+# Function: initShell()
+
+```ts
+function initShell(actor, appElement): () => void;
+```
+
+Defined in: [shell.ts:32](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/shell.ts#L32)
+
+## Parameters
+
+| Parameter    | Type          |
+| ------------ | ------------- |
+| `actor`      | `AuthActor`   |
+| `appElement` | `HTMLElement` |
+
+## Returns
+
+() => `void`

package/{api → examples}/@xmachines/play-dom-demo/variables/About.md

@@ -6,4 +6,4 @@
 const About: ComponentFn<AuthCatalog, "About">;
 ```
 
-Defined in: [components/About.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/About.ts#L4)
+Defined in: [components/About.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/About.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Contact.md

@@ -6,4 +6,4 @@
 const Contact: ComponentFn<AuthCatalog, "Contact">;
 ```
 
-Defined in: [components/Contact.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Contact.ts#L4)
+Defined in: [components/Contact.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Contact.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Dashboard.md

@@ -6,4 +6,4 @@
 const Dashboard: ComponentFn<AuthCatalog, "Dashboard">;
 ```
 
-Defined in: [components/Dashboard.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Dashboard.ts#L4)
+Defined in: [components/Dashboard.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Dashboard.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Home.md

@@ -6,4 +6,4 @@
 const Home: ComponentFn<AuthCatalog, "Home">;
 ```
 
-Defined in: [components/Home.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Home.ts#L4)
+Defined in: [components/Home.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Home.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Login.md

@@ -6,4 +6,4 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [components/Login.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Login.ts#L4)
+Defined in: [components/Login.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Login.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Navigation.md

@@ -6,4 +6,4 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [components/Navigation.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Navigation.ts#L4)
+Defined in: [components/Navigation.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Navigation.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Overview.md

@@ -6,4 +6,4 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [components/Overview.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Overview.ts#L4)
+Defined in: [components/Overview.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Overview.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Profile.md

@@ -6,4 +6,4 @@
 const Profile: ComponentFn<AuthCatalog, "Profile">;
 ```
 
-Defined in: [components/Profile.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Profile.ts#L4)
+Defined in: [components/Profile.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Profile.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Settings.md

@@ -6,4 +6,4 @@
 const Settings: ComponentFn<AuthCatalog, "Settings">;
 ```
 
-Defined in: [components/Settings.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Settings.ts#L4)
+Defined in: [components/Settings.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Settings.ts#L4)

package/{api → examples}/@xmachines/play-dom-demo/variables/Stats.md

@@ -6,4 +6,4 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [components/Stats.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-dom/examples/demo/src/components/Stats.ts#L4)
+Defined in: [components/Stats.ts:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-dom/examples/demo/src/components/Stats.ts#L4)

package/{api → examples}/@xmachines/play-dom-router-demo/README.md

@@ -131,6 +131,6 @@ Expected result: tests pass, including startup rendering and the full browser au
 
 ## Learn More
 
-- [Play DOM Router package README](../play-dom-router/README.md)
-- [Play DOM demo README](../play-dom-demo/README.md)
-- [Play Router package README](../play-router/README.md)
+- [Play DOM Router package README](../../README.md)
+- [Play DOM demo README](../../../play-dom/examples/demo/README.md)
+- [Play Router package README](../../../play-router/README.md)

package/{api → examples}/@xmachines/play-react-demo/README.md

@@ -149,8 +149,8 @@ Expected result: library-pattern invariant tests pass and the browser renderer s
 
 ## Learn More
 
-- [React package README](../play-react/README.md)
-- [React Router demo README](../play-react-router-demo/README.md)
+- [React package README](../../README.md)
+- [React Router demo README](../../../play-react-router/examples/demo/README.md)
 
 ## Variables
 

package/{api → examples}/@xmachines/play-react-demo/functions/App.md

@@ -6,7 +6,7 @@
 function App(): Element;
 ```
 
-Defined in: [App.tsx:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/App.tsx#L54)
+Defined in: [App.tsx:54](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/App.tsx#L54)
 
 ## Returns
 

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

@@ -0,0 +1,20 @@
+[Documentation](../../../README.md) / [@xmachines/play-react-demo](../README.md) / DebugPanel
+
+# Function: DebugPanel()
+
+```ts
+function DebugPanel(__namedParameters): Element;
+```
+
+Defined in: [components/DebugPanel.tsx:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/DebugPanel.tsx#L5)
+
+## Parameters
+
+| Parameter                 | Type                        |
+| ------------------------- | --------------------------- |
+| `__namedParameters`       | \{ `actor`: `AuthActor`; \} |
+| `__namedParameters.actor` | `AuthActor`                 |
+
+## Returns
+
+`Element`

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

@@ -0,0 +1,20 @@
+[Documentation](../../../README.md) / [@xmachines/play-react-demo](../README.md) / HeaderNav
+
+# Function: HeaderNav()
+
+```ts
+function HeaderNav(__namedParameters): Element;
+```
+
+Defined in: [components/HeaderNav.tsx:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/HeaderNav.tsx#L13)
+
+## Parameters
+
+| Parameter                 | Type                        |
+| ------------------------- | --------------------------- |
+| `__namedParameters`       | \{ `actor`: `AuthActor`; \} |
+| `__namedParameters.actor` | `AuthActor`                 |
+
+## Returns
+
+`Element`

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

@@ -0,0 +1,22 @@
+[Documentation](../../../README.md) / [@xmachines/play-react-demo](../README.md) / Shell
+
+# Function: Shell()
+
+```ts
+function Shell(__namedParameters): Element;
+```
+
+Defined in: [components/Shell.tsx:14](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Shell.tsx#L14)
+
+## Parameters
+
+| Parameter                    | Type                                                                               | Description                                                                      |
+| ---------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `__namedParameters`          | \{ `actor`: `AuthActor`; `registry`: `ComponentRegistry`; `router?`: `unknown`; \} | -                                                                                |
+| `__namedParameters.actor`    | `AuthActor`                                                                        | -                                                                                |
+| `__namedParameters.registry` | `ComponentRegistry`                                                                | -                                                                                |
+| `__namedParameters.router?`  | `unknown`                                                                          | Bridged router instance — accepted for prop parity with router demos but unused. |
+
+## Returns
+
+`Element`

package/{api → examples}/@xmachines/play-react-demo/variables/About.md

@@ -6,4 +6,4 @@
 const About: ComponentFn<AuthCatalog, "About">;
 ```
 
-Defined in: [components/About.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/About.tsx#L11)
+Defined in: [components/About.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/About.tsx#L11)

package/{api → examples}/@xmachines/play-react-demo/variables/Contact.md

@@ -6,4 +6,4 @@
 const Contact: ComponentFn<AuthCatalog, "Contact">;
 ```
 
-Defined in: [components/Contact.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Contact.tsx#L11)
+Defined in: [components/Contact.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Contact.tsx#L11)

package/{api → examples}/@xmachines/play-react-demo/variables/Dashboard.md

@@ -6,4 +6,4 @@
 const Dashboard: ComponentFn<AuthCatalog, "Dashboard">;
 ```
 
-Defined in: [components/Dashboard.tsx:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Dashboard.tsx#L15)
+Defined in: [components/Dashboard.tsx:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Dashboard.tsx#L15)

package/{api → examples}/@xmachines/play-react-demo/variables/Home.md

@@ -6,4 +6,4 @@
 const Home: ComponentFn<AuthCatalog, "Home">;
 ```
 
-Defined in: [components/Home.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Home.tsx#L11)
+Defined in: [components/Home.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Home.tsx#L11)

package/{api → examples}/@xmachines/play-react-demo/variables/Login.md

@@ -6,4 +6,4 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [components/Login.tsx:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Login.tsx#L16)
+Defined in: [components/Login.tsx:16](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Login.tsx#L16)

package/{api → examples}/@xmachines/play-react-demo/variables/Navigation.md

@@ -6,4 +6,4 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [components/Navigation.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Navigation.tsx#L11)
+Defined in: [components/Navigation.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Navigation.tsx#L11)

package/{api → examples}/@xmachines/play-react-demo/variables/Overview.md

@@ -6,4 +6,4 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [components/Overview.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Overview.tsx#L11)
+Defined in: [components/Overview.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Overview.tsx#L11)

package/{api → examples}/@xmachines/play-react-demo/variables/Profile.md

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

package/{api → examples}/@xmachines/play-react-demo/variables/Settings.md

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

package/{api → examples}/@xmachines/play-react-demo/variables/Stats.md

@@ -6,4 +6,4 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [components/Stats.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-react/examples/demo/src/components/Stats.tsx#L11)
+Defined in: [components/Stats.tsx:11](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-react/examples/demo/src/components/Stats.tsx#L11)

package/{api → examples}/@xmachines/play-react-router-demo/README.md

@@ -143,5 +143,5 @@ Expected result: tests pass for startup and auth-flow browser scenarios.
 
 ## Learn More
 
-- [React Router package README](../play-react-router/README.md)
-- [React package README](../play-react/README.md)
+- [React Router package README](../../README.md)
+- [React package README](../../../play-react/README.md)

package/{api → examples}/@xmachines/play-solid-demo/README.md

@@ -2,7 +2,7 @@
 
 # SolidJS Demo
 
-SolidJS renderer demo for `@xmachines/play-solid` — actor + `PlayRenderer` without a router.
+Solid renderer demo for `@xmachines/play-solid` — actor + `PlayRenderer` without a router.
 
 ## What This Demonstrates
 
@@ -135,8 +135,8 @@ Expected result: library-pattern invariant tests pass and the browser renderer s
 
 ## Learn More
 
-- [SolidJS package README](../play-solid/README.md)
-- [Solid Router demo README](../play-solid-router-demo/README.md)
+- [SolidJS package README](../../README.md)
+- [Solid Router demo README](../../../play-solid-router/examples/demo/README.md)
 
 ## Variables
 

package/{api → examples}/@xmachines/play-solid-demo/functions/App.md

@@ -6,7 +6,7 @@
 function App(): Element;
 ```
 
-Defined in: [App.tsx:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/App.tsx#L55)
+Defined in: [App.tsx:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/App.tsx#L55)
 
 ## Returns
 

package/examples/@xmachines/play-solid-demo/functions/DebugPanel.md

@@ -0,0 +1,20 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid-demo](../README.md) / DebugPanel
+
+# Function: DebugPanel()
+
+```ts
+function DebugPanel(props): Element;
+```
+
+Defined in: [components/DebugPanel.tsx:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/DebugPanel.tsx#L5)
+
+## Parameters
+
+| Parameter     | Type                        |
+| ------------- | --------------------------- |
+| `props`       | \{ `actor`: `AuthActor`; \} |
+| `props.actor` | `AuthActor`                 |
+
+## Returns
+
+`Element`

package/examples/@xmachines/play-solid-demo/functions/HeaderNav.md

@@ -0,0 +1,20 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid-demo](../README.md) / HeaderNav
+
+# Function: HeaderNav()
+
+```ts
+function HeaderNav(props): Element;
+```
+
+Defined in: [components/HeaderNav.tsx:5](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/HeaderNav.tsx#L5)
+
+## Parameters
+
+| Parameter     | Type                        |
+| ------------- | --------------------------- |
+| `props`       | \{ `actor`: `AuthActor`; \} |
+| `props.actor` | `AuthActor`                 |
+
+## Returns
+
+`Element`

package/examples/@xmachines/play-solid-demo/functions/Shell.md

@@ -0,0 +1,22 @@
+[Documentation](../../../README.md) / [@xmachines/play-solid-demo](../README.md) / Shell
+
+# Function: Shell()
+
+```ts
+function Shell(props): Element;
+```
+
+Defined in: [components/Shell.tsx:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Shell.tsx#L7)
+
+## Parameters
+
+| Parameter        | Type                                                                               | Description                                                                      |
+| ---------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------- |
+| `props`          | \{ `actor`: `AuthActor`; `registry`: `ComponentRegistry`; `router?`: `unknown`; \} | -                                                                                |
+| `props.actor`    | `AuthActor`                                                                        | -                                                                                |
+| `props.registry` | `ComponentRegistry`                                                                | -                                                                                |
+| `props.router?`  | `unknown`                                                                          | Bridged router instance — accepted for prop parity with router demos but unused. |
+
+## Returns
+
+`Element`

package/{api → examples}/@xmachines/play-solid-demo/variables/About.md

@@ -6,4 +6,4 @@
 const About: ComponentFn<AuthCatalog, "About">;
 ```
 
-Defined in: [components/About.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/About.tsx#L4)
+Defined in: [components/About.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/About.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Contact.md

@@ -6,4 +6,4 @@
 const Contact: ComponentFn<AuthCatalog, "Contact">;
 ```
 
-Defined in: [components/Contact.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Contact.tsx#L4)
+Defined in: [components/Contact.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Contact.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Dashboard.md

@@ -6,4 +6,4 @@
 const Dashboard: ComponentFn<AuthCatalog, "Dashboard">;
 ```
 
-Defined in: [components/Dashboard.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Dashboard.tsx#L4)
+Defined in: [components/Dashboard.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Dashboard.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Home.md

@@ -6,4 +6,4 @@
 const Home: ComponentFn<AuthCatalog, "Home">;
 ```
 
-Defined in: [components/Home.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Home.tsx#L4)
+Defined in: [components/Home.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Home.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Login.md

@@ -6,4 +6,4 @@
 const Login: ComponentFn<AuthCatalog, "Login">;
 ```
 
-Defined in: [components/Login.tsx:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Login.tsx#L7)
+Defined in: [components/Login.tsx:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Login.tsx#L7)

package/{api → examples}/@xmachines/play-solid-demo/variables/Navigation.md

@@ -6,4 +6,4 @@
 const Navigation: ComponentFn<AuthCatalog, "Navigation">;
 ```
 
-Defined in: [components/Navigation.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Navigation.tsx#L4)
+Defined in: [components/Navigation.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Navigation.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Overview.md

@@ -6,4 +6,4 @@
 const Overview: ComponentFn<AuthCatalog, "Overview">;
 ```
 
-Defined in: [components/Overview.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Overview.tsx#L4)
+Defined in: [components/Overview.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Overview.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Profile.md

@@ -6,4 +6,4 @@
 const Profile: ComponentFn<AuthCatalog, "Profile">;
 ```
 
-Defined in: [components/Profile.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Profile.tsx#L4)
+Defined in: [components/Profile.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Profile.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Settings.md

@@ -6,4 +6,4 @@
 const Settings: ComponentFn<AuthCatalog, "Settings">;
 ```
 
-Defined in: [components/Settings.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Settings.tsx#L4)
+Defined in: [components/Settings.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Settings.tsx#L4)

package/{api → examples}/@xmachines/play-solid-demo/variables/Stats.md

@@ -6,4 +6,4 @@
 const Stats: ComponentFn<AuthCatalog, "Stats">;
 ```
 
-Defined in: [components/Stats.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.28/packages/play-solid/examples/demo/src/components/Stats.tsx#L4)
+Defined in: [components/Stats.tsx:4](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.30/packages/play-solid/examples/demo/src/components/Stats.tsx#L4)

package/{api → examples}/@xmachines/play-solid-router-demo/README.md

@@ -119,6 +119,6 @@ Expected result: library-pattern invariant tests and the browser shared-demo sui
 
 ## Learn More
 
-- [Solid Router package README](../play-solid-router/README.md)
-- [SolidJS package README](../play-solid/README.md)
-- [TanStack Solid Router demo README](../play-tanstack-solid-router-demo/README.md)
+- [Solid Router package README](../../README.md)
+- [SolidJS package README](../../../play-solid/README.md)
+- [TanStack Solid Router demo README](../../../play-tanstack-solid-router/examples/demo/README.md)

package/{api → examples}/@xmachines/play-svelte-demo/README.md

@@ -124,4 +124,4 @@ Expected result: library-pattern invariant tests pass and the browser renderer s
 
 ## Learn More
 
-- [Svelte package README](../play-svelte/README.md)
+- [Svelte package README](../../README.md)