@xmachines/docs 1.0.0-beta.9 → 1.0.0

package/api/@xmachines/play-tanstack-react-router-demo/README.md

@@ -1,126 +0,0 @@
-[Documentation](../../README.md) / @xmachines/play-tanstack-react-router-demo
-
-# TanStack React Router Demo
-
-React + TanStack Router demonstration of Play's actor-authoritative routing and rendering model.
-
-## What This Demonstrates
-
-- Shared auth machine reused without framework-specific business logic
-- `PlayRouterProvider` renderer-based integration with TanStack Router
-- Shell-driven rendering via `PlayRenderer` with actor-authoritative navigation
-- Non-browser invariant tests plus browser E2E coverage
-
-## Running the Demo
-
-From this directory (`packages/play-tanstack-react-router/examples/demo`):
-
-```bash
-npm install
-npm run dev
-```
-
-Open `http://localhost:3000`.
-
-## Step-by-Step Code Flow
-
-This demo uses provider-based integration centered on `PlayRouterProvider` and a route map generated from the machine:
-
-1. `src/main.tsx` mounts `<App />`.
-2. `src/App.tsx` creates/starts the actor from shared machine + catalog.
-3. `src/App.tsx` builds `routeMap` from `extractMachineRoutes(authMachine)` + `createRouteMapFromTree(routeTree)`.
-4. `PlayRouterProvider` bridges TanStack Router to the actor and renders `Shell` via `renderer(actor, router)`.
-5. `Shell` renders `PlayRenderer`, header/nav, and debug panel from actor state.
-6. Tests in `test/` and `test/browser*/` validate invariant and runtime behavior.
-
-```tsx
-// src/App.tsx (shape)
-const routeTree = extractMachineRoutes(authMachine);
-const routeMap = createRouteMapFromTree(routeTree);
-
-return (
-	<PlayRouterProvider
-		actor={actor}
-		router={router}
-		routeMap={routeMap}
-		renderer={(currentActor, currentRouter) => (
-			<Shell actor={currentActor} router={currentRouter} />
-		)}
-	/>
-);
-```
-
-```tsx
-// src/components/Login.tsx (shape)
-<button onClick={() => actor.send({ type: "auth.login", username })}>Login</button>
-```
-
-Shared business logic comes from the common demo machine/catalog module (`authMachine` and `catalog`), so routing decisions remain machine-driven and framework-independent.
-
-## Key Files
-
-- `src/main.tsx` - React entry point that mounts `<App />`
-- `src/App.tsx` - actor lifecycle, route-map creation, provider wiring, and `Shell` rendering
-- `src/components/` - UI components that send actor events and render state-driven views
-- `test/actor-authority.test.ts` - actor authority and guarded navigation behavior
-- `test/strict-separation.test.ts` - machine/view infrastructure separation contracts
-- `test/browser-e2e/auth-flow.browser.test.tsx` - canonical browser auth flow
-- `test/browser/` - extended browser checks for URL sync, history behavior, and route event flow
-
-## State Machine & Architecture Details
-
-The demo utilizes XMachines architectural invariants:
-
-1. **Actor Authority:** When a user navigates to a protected route, TanStack Router updates the URL. The `PlayRouterProvider` intercepts this, translates it to a `play.route` event, and sends it to the actor. The actor evaluates guards (e.g. `isAuthenticated`) and executes state transitions.
-2. **Passive Infrastructure:** The router does not execute route loaders or guards for business logic. The actor dictates whether navigation is permitted.
-3. **Signal-Only Reactivity:** The bridge leverages React's internal mechanisms combined with TanStack's `router.subscribe` to react precisely when signals update, without relying on `useEffect` synchronization inside the application codebase.
-
-## Watcher Lifecycle and Cleanup Contract
-
-This demo follows the canonical watcher lifecycle:
-
-1. `notify`
-2. `queueMicrotask`
-3. `getPending()`
-4. Read actor signals and trigger React state updates
-5. Re-arm with `watch()`/`watch(...signals)`
-
-Watcher notifications are one-shot. Cleanup is explicit and lifecycle-bound: the provider automatically triggers `bridge.disconnect()` when the component tree unmounts to prevent memory leaks and zombie subscriptions.
-
-## Adapter Boundaries
-
-The TanStack React adapter wraps TanStack's `router.navigate({ to })` and `router.subscribe` methods while delegating core synchronization policy to `RouterBridgeBase`.
-
-## Available Scripts
-
-```bash
-npm run dev            # Start Vite dev server (http://localhost:3000)
-npm run build          # Build production assets
-npm run preview        # Preview production build locally
-npm run test           # Run Vitest suite
-npm run test:vitest    # Explicit Vitest command alias
-npm run test:browser   # Browser-focused test run
-npm run test:browser:e2e # E2E-specific browser suite
-npm run test:e2e       # Alias to test:browser
-```
-
-## Verification
-
-Run the core invariant checks referenced by this demo docs:
-
-```bash
-npm run test:vitest -- test/actor-authority.test.ts test/strict-separation.test.ts
-npm run test:browser
-```
-
-Manual sanity flow:
-
-1. Run `npm run dev` and open `http://localhost:3000`.
-2. Attempt protected navigation while logged out and confirm guard-driven behavior.
-3. Log in, then confirm route and view updates stay in sync.
-
-## Learn More
-
-- [TanStack React Router package README](../play-tanstack-react-router/README.md)
-- [Solid Router demo README](../play-solid-router-demo/README.md)
-- [TanStack Solid Router demo README](../play-tanstack-solid-router-demo/README.md)

package/api/@xmachines/play-tanstack-solid-router/classes/SolidRouterBridge.md

@@ -1,343 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-tanstack-solid-router](../README.md) / SolidRouterBridge
-
-# Class: SolidRouterBridge
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:45](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L45)
-
-TanStack Solid Router integration bridge extending RouterBridgeBase
-
-Uses router.subscribe("onBeforeLoad", fn) for router→actor sync.
-This mirrors the TanStack React Router bridge pattern and uses the
-public router events API instead of the internal \_\_store.
-
-## Extends
-
-- [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md)
-
-## Constructors
-
-### Constructor
-
-```ts
-new SolidRouterBridge(
-   router,
-   actor,
-   routeMap): SolidRouterBridge;
-```
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L55)
-
-Create a TanStack Solid Router bridge
-
-#### Parameters
-
-| Parameter  | Type                                                                                                                                    | Description                                  |
-| ---------- | --------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- |
-| `router`   | [`TanStackRouterLike`](../type-aliases/TanStackRouterLike.md)                                                                           | TanStack Router instance (from createRouter) |
-| `actor`    | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`AnyActorLogic`\> & [`Routable`](../../play-actor/interfaces/Routable.md) | XMachines actor instance                     |
-| `routeMap` | [`RouteMap`](RouteMap.md)                                                                                                               | Bidirectional state ID ↔ path mapping        |
-
-#### Returns
-
-`SolidRouterBridge`
-
-#### Overrides
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`constructor`](../../play-router/classes/RouterBridgeBase.md#constructor)
-
-## Properties
-
-| Property                                                              | Modifier    | Type                                                                                                                                    | Description                                           | Inherited from                                                                                                                                                                | Defined in                                  |
-| --------------------------------------------------------------------- | ----------- | --------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------- |
-| <a id="property-actor"></a> `actor`                                   | `readonly`  | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`AnyActorLogic`\> & [`Routable`](../../play-actor/interfaces/Routable.md) | Actor with currentRoute signal and send method        | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`actor`](../../play-router/classes/RouterBridgeBase.md#property-actor)                                   | play-router/dist/router-bridge-base.d.ts:55 |
-| <a id="property-hasconnectedonce"></a> `hasConnectedOnce`             | `protected` | `boolean`                                                                                                                               | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`hasConnectedOnce`](../../play-router/classes/RouterBridgeBase.md#property-hasconnectedonce)             | play-router/dist/router-bridge-base.d.ts:61 |
-| <a id="property-isconnected"></a> `isConnected`                       | `protected` | `boolean`                                                                                                                               | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isConnected`](../../play-router/classes/RouterBridgeBase.md#property-isconnected)                       | play-router/dist/router-bridge-base.d.ts:60 |
-| <a id="property-isprocessingnavigation"></a> `isProcessingNavigation` | `protected` | `boolean`                                                                                                                               | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`isProcessingNavigation`](../../play-router/classes/RouterBridgeBase.md#property-isprocessingnavigation) | play-router/dist/router-bridge-base.d.ts:63 |
-| <a id="property-lastsyncedpath"></a> `lastSyncedPath`                 | `protected` | `string`                                                                                                                                | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`lastSyncedPath`](../../play-router/classes/RouterBridgeBase.md#property-lastsyncedpath)                 | play-router/dist/router-bridge-base.d.ts:62 |
-| <a id="property-routemap"></a> `routeMap`                             | `readonly`  | `object`                                                                                                                                | Bidirectional route map for stateId ↔ path resolution | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeMap`](../../play-router/classes/RouterBridgeBase.md#property-routemap)                             | play-router/dist/router-bridge-base.d.ts:56 |
-| `routeMap.getPathByStateId`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                       | -                                                     | -                                                                                                                                                                             | play-router/dist/router-bridge-base.d.ts:58 |
-| `routeMap.getStateIdByPath`                                           | `public`    | `string` \| `null` \| `undefined`                                                                                                       | -                                                     | -                                                                                                                                                                             | play-router/dist/router-bridge-base.d.ts:57 |
-| <a id="property-routewatcher"></a> `routeWatcher`                     | `protected` | \| [`Watcher`](../../play-signals/namespaces/Signal/namespaces/subtle/classes/Watcher.md) \| `null`                                     | -                                                     | [`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`routeWatcher`](../../play-router/classes/RouterBridgeBase.md#property-routewatcher)                     | play-router/dist/router-bridge-base.d.ts:64 |
-
-## Methods
-
-### connect()
-
-```ts
-connect(): void;
-```
-
-Defined in: play-router/dist/router-bridge-base.d.ts:81
-
-Connect the router bridge to the Actor.
-
-Sets up the TC39 Signal watcher for actor → router direction and
-starts watching router changes (framework-specific).
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`connect`](../../play-router/classes/RouterBridgeBase.md#connect)
-
----
-
-### disconnect()
-
-```ts
-disconnect(): void;
-```
-
-Defined in: play-router/dist/router-bridge-base.d.ts:87
-
-Disconnect the router bridge from the Actor.
-
-Stops signal watching and unregisters framework-specific router listener.
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`disconnect`](../../play-router/classes/RouterBridgeBase.md#disconnect)
-
----
-
-### dispose()
-
-```ts
-dispose(): void;
-```
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:120](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L120)
-
-Dispose the bridge (alias for disconnect).
-
-#### Returns
-
-`void`
-
----
-
-### extractParams()
-
-```ts
-protected extractParams(pathname, stateId): Record<string, string>;
-```
-
-Defined in: play-router/dist/router-bridge-base.d.ts:134
-
-Extract path parameters from URL using the URLPattern API.
-
-Accesses `globalThis.URLPattern` at runtime — no polyfill is imported by this
-library. If `URLPattern` is unavailable (Node.js < 24, older browsers without a
-polyfill), this method returns `{}` silently (graceful degradation — routing still
-works, params will be empty).
-
-#### Parameters
-
-| Parameter  | Type     | Description                                       |
-| ---------- | -------- | ------------------------------------------------- |
-| `pathname` | `string` | The actual URL path (e.g., '/profile/john')       |
-| `stateId`  | `string` | The matched state ID for looking up route pattern |
-
-#### Returns
-
-`Record`\<`string`, `string`\>
-
-Extracted path parameters, or empty object if URLPattern is unavailable or no match
-
-#### Inherited from
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`extractParams`](../../play-router/classes/RouterBridgeBase.md#extractparams)
-
----
-
-### extractQuery()
-
-```ts
-protected extractQuery(search): Record<string, string>;
-```
-
-Defined in: play-router/dist/router-bridge-base.d.ts:141
-
-Extract query parameters from URL search string.
-
-#### Parameters
-
-| Parameter | Type     | Description                                      |
-| --------- | -------- | ------------------------------------------------ |
-| `search`  | `string` | URL search string (e.g., '?tab=security&page=1') |
-
-#### Returns
-
-`Record`\<`string`, `string`\>
-
-Extracted query parameters or empty object
-
-#### Inherited from
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`extractQuery`](../../play-router/classes/RouterBridgeBase.md#extractquery)
-
----
-
-### getInitialRouterPath()
-
-```ts
-protected getInitialRouterPath(): string | null;
-```
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:80](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L80)
-
-Get the router's current path at connect() time for initial sync.
-
-TanStack Router exposes router.state.location.pathname synchronously,
-so we can read it here to drive the actor to the correct initial state
-when the user cold-loads on a deep-link URL.
-
-#### Returns
-
-`string` \| `null`
-
-#### Overrides
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`getInitialRouterPath`](../../play-router/classes/RouterBridgeBase.md#getinitialrouterpath)
-
----
-
-### navigateRouter()
-
-```ts
-protected navigateRouter(path): void;
-```
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:69](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L69)
-
-Navigate TanStack Solid Router to the given path.
-
-#### Parameters
-
-| Parameter | Type     |
-| --------- | -------- |
-| `path`    | `string` |
-
-#### Returns
-
-`void`
-
-#### Overrides
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`navigateRouter`](../../play-router/classes/RouterBridgeBase.md#navigaterouter)
-
----
-
-### syncActorFromRouter()
-
-```ts
-protected syncActorFromRouter(pathname, search?): void;
-```
-
-Defined in: play-router/dist/router-bridge-base.d.ts:101
-
-Sync actor state when router location changes.
-
-Sends play.route event to actor with resolved stateId, params, and query.
-Prevents circular updates via isProcessingNavigation flag.
-
-#### Parameters
-
-| Parameter  | Type     |
-| ---------- | -------- |
-| `pathname` | `string` |
-| `search?`  | `string` |
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`syncActorFromRouter`](../../play-router/classes/RouterBridgeBase.md#syncactorfromrouter)
-
----
-
-### syncRouterFromActor()
-
-```ts
-protected syncRouterFromActor(route): void;
-```
-
-Defined in: play-router/dist/router-bridge-base.d.ts:94
-
-Sync router location when actor route signal changes.
-
-Calls navigateRouter() for framework-specific navigation.
-Prevents circular updates via isProcessingNavigation flag.
-
-#### Parameters
-
-| Parameter | Type      |
-| --------- | --------- |
-| `route`   | `unknown` |
-
-#### Returns
-
-`void`
-
-#### Inherited from
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`syncRouterFromActor`](../../play-router/classes/RouterBridgeBase.md#syncrouterfromactor)
-
----
-
-### unwatchRouterChanges()
-
-```ts
-protected unwatchRouterChanges(): void;
-```
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:112](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L112)
-
-Stop watching TanStack Router changes.
-
-#### Returns
-
-`void`
-
-#### Overrides
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`unwatchRouterChanges`](../../play-router/classes/RouterBridgeBase.md#unwatchrouterchanges)
-
----
-
-### watchRouterChanges()
-
-```ts
-protected watchRouterChanges(): void;
-```
-
-Defined in: [play-tanstack-solid-router/src/solid-router-bridge.ts:98](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/solid-router-bridge.ts#L98)
-
-Subscribe to ALL navigation events via router.history.
-
-router.history.subscribe fires for PUSH, POP, BACK, FORWARD, REPLACE, and GO —
-covering both link clicks and browser back/forward button presses.
-
-The subscriber callback receives { location, action } where location is the
-new history location with pathname and search already updated.
-
-Using router.history rather than router.subscribe("onBeforeLoad") ensures
-back/forward works regardless of whether <RouterProvider> is mounted.
-
-Also registers onCleanup() so Solid automatically disconnects on unmount.
-
-#### Returns
-
-`void`
-
-#### Overrides
-
-[`RouterBridgeBase`](../../play-router/classes/RouterBridgeBase.md).[`watchRouterChanges`](../../play-router/classes/RouterBridgeBase.md#watchrouterchanges)

package/api/@xmachines/play-tanstack-solid-router/functions/PlayRouterProvider.md

@@ -1,19 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-tanstack-solid-router](../README.md) / PlayRouterProvider
-
-# Function: PlayRouterProvider()
-
-```ts
-function PlayRouterProvider(props): any;
-```
-
-Defined in: [play-tanstack-solid-router/src/play-router-provider.tsx:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-tanstack-solid-router/src/play-router-provider.tsx#L17)
-
-## Parameters
-
-| Parameter | Type                                                                  |
-| --------- | --------------------------------------------------------------------- |
-| `props`   | [`PlayRouterProviderProps`](../interfaces/PlayRouterProviderProps.md) |
-
-## Returns
-
-`any`

package/api/@xmachines/play-tanstack-solid-router-demo/README.md

@@ -1,126 +0,0 @@
-[Documentation](../../README.md) / @xmachines/play-tanstack-solid-router-demo
-
-# TanStack Solid Router Demo
-
-Solid + `@tanstack/solid-router` demonstration of the Play architecture with TanStack router integration.
-
-## What This Demonstrates
-
-- Shared auth machine reused without framework-specific business logic
-- `PlayRouterProvider` renderer-based integration with TanStack Router
-- Shell-driven rendering via `PlayRenderer` with actor-authoritative navigation
-- Object-based routing and deep location observation using TanStack's Solid primitives
-- Non-browser invariant tests plus browser E2E coverage
-
-## Running the Demo
-
-From this directory (`packages/play-tanstack-solid-router/examples/demo`):
-
-```bash
-npm install
-npm run dev
-```
-
-Open `http://localhost:5173`.
-
-## Step-by-Step Code Flow
-
-Use this order to understand the implementation:
-
-1. `src/main.tsx` bootstraps the demo app and mounts `<App />`.
-2. `src/App.tsx` sets up actor lifecycle, route mapping, and TanStack Solid router integration.
-3. Shared machine/catalog logic comes from the common demo module to keep business logic framework-agnostic.
-4. Router infrastructure stays passive: it forwards navigation intent to the actor via the `PlayRouterProvider` and reflects actor-approved route changes back to TanStack.
-5. `Shell` (inside `src/App.tsx`) renders actor-projected state (`PlayRenderer`) and emits actor events.
-6. `test/library-pattern.test.ts` plus `test/browser/` verify invariants and browser routing behavior.
-
-```tsx
-// src/main.tsx (shape)
-render(() => <App />, document.getElementById("root")!);
-```
-
-```tsx
-// src/App.tsx (shape)
-const routeTree = extractMachineRoutes(authMachine);
-const routeMap = createRouteMap(authMachine);
-
-return (
-	<PlayRouterProvider
-		actor={actor}
-		router={router}
-		routeMap={routeMap}
-		renderer={(currentActor, currentRouter) => (
-			<Shell actor={currentActor} router={currentRouter} />
-		)}
-	/>
-);
-```
-
-```tsx
-// src/components/Login.tsx (shape)
-<button onClick={() => actor.send({ type: "auth.login", username, password })}>Login</button>
-```
-
-## Key Files
-
-- `src/App.tsx` - Wires actor lifecycle, route map, TanStack router setup, and provider/renderer integration.
-- `src/main.tsx` - Vite bootstrap for the Solid TanStack demo.
-- `src/components/` - Demo views that dispatch machine events.
-- `test/library-pattern.test.ts` - Invariant and architecture checks for package behavior.
-- `test/browser/startup.browser.test.ts` - Browser startup and wiring checks.
-- `test/browser/auth-flow.browser.test.ts` - Browser auth + route-flow checks.
-
-## State Machine & Architecture Details
-
-The demo utilizes XMachines architectural invariants:
-
-1. **Actor Authority:** When a user clicks a link, TanStack Router updates the location object. The `PlayRouterProvider` intercepts this, translates it to a `play.route` event, and sends it to the actor. The actor evaluates guards and applies state transitions.
-2. **Passive Infrastructure:** The router does not execute route loaders or guards for business logic. The actor dictates whether navigation is permitted.
-3. **Signal-Only Reactivity:** The bridge leverages Solid's `createEffect` and TanStack's `router.subscribe` to effortlessly observe location changes and signal updates.
-
-## Watcher Lifecycle and Cleanup Contract
-
-This demo follows the canonical watcher lifecycle:
-
-1. `notify`
-2. `queueMicrotask`
-3. `getPending()`
-4. Read actor signals and trigger state updates
-5. Re-arm with `watch()`/`watch(...signals)`
-
-In Solid, this is largely abstracted by `createEffect` within the bridge adapter. Cleanup remains explicit: the provider executes `bridge.disconnect()` on unmount (`onCleanup`) to prevent ghost subscriptions, ensuring safe component teardown and hot module replacement.
-
-## Adapter Boundaries
-
-The TanStack Solid adapter wraps TanStack's `router.navigate({ to })` and `router.subscribe` methods while delegating core synchronization policy to `RouterBridgeBase`. This keeps complex double-dispatch logic normalized across all frameworks.
-
-## Available Scripts
-
-```bash
-npm run dev           # Start Vite dev server (default: http://localhost:5173)
-npm run build         # Build production assets
-npm run preview       # Preview production build locally
-npm run test          # Run unit/integration tests via Vitest
-npm run test:browser  # Run browser-mode tests via vitest.browser.config.ts
-```
-
-## Verification
-
-Use these checks from this directory:
-
-```bash
-npm run test
-npm run test:browser
-```
-
-Manual sanity check:
-
-1. Start with `npm run dev`.
-2. Open `http://localhost:5173`.
-3. Verify login/logout transitions and URL updates remain actor-driven, including protected route redirection.
-
-## Learn More
-
-- [TanStack Solid Router package README](../play-tanstack-solid-router/README.md)
-- [Solid Router demo README](../play-solid-router-demo/README.md)
-- [TanStack React Router demo README](../play-tanstack-react-router-demo/README.md)

package/api/@xmachines/play-vue/interfaces/PlayRendererProps.md

@@ -1,14 +0,0 @@
-[Documentation](../../../README.md) / [@xmachines/play-vue](../README.md) / PlayRendererProps
-
-# Interface: PlayRendererProps
-
-Defined in: [types.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-vue/src/types.ts#L17)
-
-Props for PlayRenderer component
-
-## Properties
-
-| Property                                      | Type                                                                                                                                    | Description                                                           | Defined in                                                                                                                                   |
-| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actor"></a> `actor`           | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`AnyActorLogic`\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability) | [types.ts:19](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-vue/src/types.ts#L19) |
-| <a id="property-components"></a> `components` | `Record`\<`string`, `Component`\>                                                                                                       | Map of component names to Vue components                              | [types.ts:22](https://gitlab.com/xmachin-es/xmachines-js/-/blob/00a28432ed57807112288436d1ae4387d9f06919/packages/play-vue/src/types.ts#L22) |