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

package/api/@xmachines/play-xstate/interfaces/PlayerConfig.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayerConfig\<TMachine\>
 
-Defined in: [packages/play-xstate/src/types.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L7)
+Defined in: [packages/play-xstate/src/types.ts:7](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L7)
 
 Configuration for definePlayer()
 
@@ -16,5 +16,5 @@ Configuration for definePlayer()
 
 | Property                                 | Type                                              | Description                       | Defined in                                                                                                                                     |
 | ---------------------------------------- | ------------------------------------------------- | --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-machine"></a> `machine`  | `TMachine`                                        | XState v5 state machine           | [packages/play-xstate/src/types.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L9)   |
-| <a id="property-options"></a> `options?` | [`PlayerOptions`](PlayerOptions.md)\<`TMachine`\> | Lifecycle hooks and configuration | [packages/play-xstate/src/types.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L12) |
+| <a id="property-machine"></a> `machine`  | `TMachine`                                        | XState v5 state machine           | [packages/play-xstate/src/types.ts:9](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L9)   |
+| <a id="property-options"></a> `options?` | [`PlayerOptions`](PlayerOptions.md)\<`TMachine`\> | Lifecycle hooks and configuration | [packages/play-xstate/src/types.ts:12](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L12) |

package/api/@xmachines/play-xstate/interfaces/PlayerFactoryResumeOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayerFactoryResumeOptions\<TMachine\>
 
-Defined in: [packages/play-xstate/src/types.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L47)
+Defined in: [packages/play-xstate/src/types.ts:47](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L47)
 
 Optional restore arguments for the player factory.
 
@@ -19,4 +19,4 @@ Mirrors XState's createActor options bag while preserving the existing
 
 | Property                                   | Type                                                                              | Description                                            | Defined in                                                                                                                                     |
 | ------------------------------------------ | --------------------------------------------------------------------------------- | ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-snapshot"></a> `snapshot?` | [`SnapshotFrom`](https://www.jsdocs.io/package/xstate#SnapshotFrom)\<`TMachine`\> | Persisted XState snapshot used to restore actor state. | [packages/play-xstate/src/types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L49) |
+| <a id="property-snapshot"></a> `snapshot?` | [`SnapshotFrom`](https://www.jsdocs.io/package/xstate#SnapshotFrom)\<`TMachine`\> | Persisted XState snapshot used to restore actor state. | [packages/play-xstate/src/types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L49) |

package/api/@xmachines/play-xstate/interfaces/PlayerOptions.md

@@ -2,7 +2,7 @@
 
 # Interface: PlayerOptions\<TMachine\>
 
-Defined in: [packages/play-xstate/src/types.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L20)
+Defined in: [packages/play-xstate/src/types.ts:20](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L20)
 
 Player lifecycle hooks
 
@@ -18,8 +18,8 @@ Per CONTEXT.md: Rich set of hooks for observability
 
 | Property                                             | Type                                          | Description                      | Defined in                                                                                                                                     |
 | ---------------------------------------------------- | --------------------------------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-onerror"></a> `onError?`             | (`actor`, `error`) => `void`                  | Called on actor errors           | [packages/play-xstate/src/types.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L38) |
-| <a id="property-onstart"></a> `onStart?`             | (`actor`) => `void`                           | Called when actor starts         | [packages/play-xstate/src/types.ts:22](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L22) |
-| <a id="property-onstatechange"></a> `onStateChange?` | (`actor`, `state`) => `void`                  | Called when state signal changes | [packages/play-xstate/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L35) |
-| <a id="property-onstop"></a> `onStop?`               | (`actor`) => `void`                           | Called when actor stops          | [packages/play-xstate/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L25) |
-| <a id="property-ontransition"></a> `onTransition?`   | (`actor`, `prevState`, `nextState`) => `void` | Called on every state transition | [packages/play-xstate/src/types.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L28) |
+| <a id="property-onerror"></a> `onError?`             | (`actor`, `error`) => `void`                  | Called on actor errors           | [packages/play-xstate/src/types.ts:38](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L38) |
+| <a id="property-onstart"></a> `onStart?`             | (`actor`) => `void`                           | Called when actor starts         | [packages/play-xstate/src/types.ts:22](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L22) |
+| <a id="property-onstatechange"></a> `onStateChange?` | (`actor`, `state`) => `void`                  | Called when state signal changes | [packages/play-xstate/src/types.ts:35](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L35) |
+| <a id="property-onstop"></a> `onStop?`               | (`actor`) => `void`                           | Called when actor stops          | [packages/play-xstate/src/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L25) |
+| <a id="property-ontransition"></a> `onTransition?`   | (`actor`, `prevState`, `nextState`) => `void` | Called on every state transition | [packages/play-xstate/src/types.ts:28](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L28) |

package/api/@xmachines/play-xstate/interfaces/RouteContext.md

@@ -2,7 +2,7 @@
 
 # Interface: RouteContext
 
-Defined in: [packages/play-xstate/src/routing/types.ts:19](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L19)
+Defined in: [packages/play-xstate/src/routing/types.ts:19](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L19)
 
 Route build context from machine context.
 
@@ -18,7 +18,7 @@ must populate `params` explicitly.
 
 | Property                                   | Type                            | Description                                                                        | Defined in                                                                                                                                                     |
 | ------------------------------------------ | ------------------------------- | ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-basepath"></a> `basePath?` | `string`                        | Base path for relative routes                                                      | [packages/play-xstate/src/routing/types.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L21) |
-| <a id="property-hash"></a> `hash?`         | `string`                        | Hash fragment                                                                      | [packages/play-xstate/src/routing/types.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L27) |
-| <a id="property-params"></a> `params?`     | `Record`\<`string`, `unknown`\> | Path-only route parameters to substitute (e.g., `:userId` from `/profile/:userId`) | [packages/play-xstate/src/routing/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L23) |
-| <a id="property-query"></a> `query?`       | `Record`\<`string`, `unknown`\> | Query parameters                                                                   | [packages/play-xstate/src/routing/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L25) |
+| <a id="property-basepath"></a> `basePath?` | `string`                        | Base path for relative routes                                                      | [packages/play-xstate/src/routing/types.ts:21](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L21) |
+| <a id="property-hash"></a> `hash?`         | `string`                        | Hash fragment                                                                      | [packages/play-xstate/src/routing/types.ts:27](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L27) |
+| <a id="property-params"></a> `params?`     | `Record`\<`string`, `unknown`\> | Path-only route parameters to substitute (e.g., `:userId` from `/profile/:userId`) | [packages/play-xstate/src/routing/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L23) |
+| <a id="property-query"></a> `query?`       | `Record`\<`string`, `unknown`\> | Query parameters                                                                   | [packages/play-xstate/src/routing/types.ts:25](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L25) |

package/api/@xmachines/play-xstate/interfaces/RouteObject.md

@@ -2,7 +2,7 @@
 
 # Interface: RouteObject
 
-Defined in: [packages/play-xstate/src/routing/types.ts:1](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L1)
+Defined in: [packages/play-xstate/src/routing/types.ts:1](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L1)
 
 ## Indexable
 
@@ -14,4 +14,4 @@ Defined in: [packages/play-xstate/src/routing/types.ts:1](https://gitlab.com/xma
 
 | Property                          | Type     | Defined in                                                                                                                                                   |
 | --------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
-| <a id="property-path"></a> `path` | `string` | [packages/play-xstate/src/routing/types.ts:2](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L2) |
+| <a id="property-path"></a> `path` | `string` | [packages/play-xstate/src/routing/types.ts:2](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L2) |

package/api/@xmachines/play-xstate/type-aliases/ComposedGuard.md

@@ -6,7 +6,7 @@
 type ComposedGuard = GuardPredicate<MachineContext, EventObject, unknown, ParameterizedObject>;
 ```
 
-Defined in: [packages/play-xstate/src/guards/compose.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/guards/compose.ts#L15)
+Defined in: [packages/play-xstate/src/guards/compose.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/guards/compose.ts#L15)
 
 Narrowest public return type for guard composition helpers.
 

package/api/@xmachines/play-xstate/type-aliases/Guard.md

@@ -6,7 +6,7 @@
 type Guard<TContext, TEvent> = (args) => boolean;
 ```
 
-Defined in: [packages/play-xstate/src/guards/types.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/guards/types.ts#L13)
+Defined in: [packages/play-xstate/src/guards/types.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/guards/types.ts#L13)
 
 Standard XState guard function signature
 

package/api/@xmachines/play-xstate/type-aliases/GuardArray.md

@@ -6,7 +6,7 @@
 type GuardArray<TContext, TEvent> = Guard<TContext, TEvent>[] | string[];
 ```
 
-Defined in: [packages/play-xstate/src/guards/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/guards/types.ts#L23)
+Defined in: [packages/play-xstate/src/guards/types.ts:23](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/guards/types.ts#L23)
 
 Array of guard predicates or guard names
 

package/api/@xmachines/play-xstate/type-aliases/PlayerFactory.md

@@ -6,7 +6,7 @@
 type PlayerFactory<TMachine> = (input?, options?) => PlayerActor<TMachine>;
 ```
 
-Defined in: [packages/play-xstate/src/types.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/types.ts#L57)
+Defined in: [packages/play-xstate/src/types.ts:57](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/types.ts#L57)
 
 Factory function returned by definePlayer()
 

package/api/@xmachines/play-xstate/type-aliases/RouteMachineConfig.md

@@ -6,7 +6,7 @@
 type RouteMachineConfig = object;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:48](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L48)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:48](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L48)
 
 Minimal structural constraint for machine configs accepted by
 `formatPlayRouteTransitions`.
@@ -32,7 +32,7 @@ through the transform, so the return value remains directly usable by
 optional context?: unknown;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L49)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L49)
 
 ---
 
@@ -42,7 +42,7 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:4
 optional on?: Record<string, unknown>;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L51)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:51](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L51)
 
 ---
 
@@ -52,4 +52,4 @@ Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:5
 optional states?: Record<string, unknown>;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L50)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:50](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L50)

package/api/@xmachines/play-xstate/type-aliases/RouteMetadata.md

@@ -6,4 +6,4 @@
 type RouteMetadata = string | RouteObject;
 ```
 
-Defined in: [packages/play-xstate/src/routing/types.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/types.ts#L6)
+Defined in: [packages/play-xstate/src/routing/types.ts:6](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/types.ts#L6)

package/api/@xmachines/play-xstate/type-aliases/RouteStateNode.md

@@ -6,7 +6,7 @@
 type RouteStateNode = object;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L13)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:13](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L13)
 
 Minimal structural shape of a single XState state node as read by
 `formatPlayRouteTransitions` when crawling the machine config.
@@ -29,7 +29,7 @@ the index signature.
 optional id?: string;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L15)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:15](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L15)
 
 Optional explicit state ID (e.g. `"home"`, `"settings"`). Used as the `#id` target in `play.route` events.
 
@@ -41,7 +41,7 @@ Optional explicit state ID (e.g. `"home"`, `"settings"`). Used as the `#id` targ
 optional meta?: object;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L17)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:17](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L17)
 
 State metadata — `meta.route` marks the state as routable.
 
@@ -61,6 +61,6 @@ URL path template (e.g. `"/profile/:username"`, `"/settings/:section?"`).
 optional states?: Record<string, RouteStateNode>;
 ```
 
-Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:22](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/play-xstate/src/routing/format-play-route-transitions.ts#L22)
+Defined in: [packages/play-xstate/src/routing/format-play-route-transitions.ts:22](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/play-xstate/src/routing/format-play-route-transitions.ts#L22)
 
 Nested child states, recursively crawled for additional route declarations.

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

@@ -8,3 +8,4 @@
 - [xmCacheDir](functions/xmCacheDir.md)
 - [xmOptimizeDeps](functions/xmOptimizeDeps.md)
 - [xmResolve](functions/xmResolve.md)
+- [xmSvelteRunes](functions/xmSvelteRunes.md)

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

@@ -6,15 +6,19 @@
 function xmAliases(importMetaUrl): Record<string, string>;
 ```
 
-Defined in: [vite-aliases.ts:24](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/shared/config/vite-aliases.ts#L24)
+Defined in: [vite-aliases.ts:221](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vite-aliases.ts#L221)
 
 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`
+Maps every package to its TypeScript source entry so that `pnpm run dev`
+works without a prior `pnpm run build`. Required because `pnpm run clean`
 removes all dist/ directories — including transitive dependencies —
 leaving Vite unable to resolve package.json `exports` that point to dist/.
 
+The map is derived from the workspace layout at config-load time (see
+`buildAliases`), so adding a new package needs no edit here. A few
+special-case subpath aliases are maintained explicitly on top.
+
 Usage in a demo vite.config.ts:
 
 import { xmAliases } from "@xmachines/shared/vite-aliases";

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

@@ -6,7 +6,7 @@
 function xmCacheDir(importMetaUrl, name): string;
 ```
 
-Defined in: [vite-aliases.ts:196](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/shared/config/vite-aliases.ts#L196)
+Defined in: [vite-aliases.ts:330](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vite-aliases.ts#L330)
 
 Returns the shared Vite `cacheDir` for this workspace package.
 

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

@@ -6,7 +6,7 @@
 function xmOptimizeDeps(extra?): DepOptimizationOptions;
 ```
 
-Defined in: [vite-aliases.ts:179](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/shared/config/vite-aliases.ts#L179)
+Defined in: [vite-aliases.ts:286](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vite-aliases.ts#L286)
 
 Returns the standard Vite `optimizeDeps` config for browser test projects.
 

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

@@ -6,7 +6,7 @@
 function xmResolve(importMetaUrl, extra?): ResolveOptions & object;
 ```
 
-Defined in: [vite-aliases.ts:151](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/shared/config/vite-aliases.ts#L151)
+Defined in: [vite-aliases.ts:258](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vite-aliases.ts#L258)
 
 Full Vite `resolve` config for @xmachines/\* workspace packages.
 
@@ -14,10 +14,11 @@ 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.
+`preserveSymlinks` defaults to `false`: under pnpm every dependency is a
+symlink into the content-addressed store, and preserving symlink paths
+prevents Vite from deduplicating packages and from resolving nested
+dependencies of pre-bundled modules (vitest's own browser-mode chunks fail
+to load). Callers can still override it explicitly.
 
 Use this instead of manually setting `resolve.alias: xmAliases(...)`:
 

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

@@ -0,0 +1,33 @@
+[API](../../../../README.md) / [@xmachines/shared](../../README.md) / [vite-aliases](../README.md) / xmSvelteRunes
+
+# Function: xmSvelteRunes()
+
+```ts
+function xmSvelteRunes(): object;
+```
+
+Defined in: [vite-aliases.ts:309](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vite-aliases.ts#L309)
+
+Svelte plugin options that enforce runes mode for workspace sources only.
+
+Forcing `compilerOptions.runes` globally also applies to third-party
+`.svelte` files pulled in through Vite dependency optimization — e.g.
+`@testing-library/svelte-core`'s `wrapper-scaffold-legacy.svelte`, which is
+intentionally written in legacy syntax and fails to compile in runes mode.
+Scoping the flag with `dynamicCompileOptions` keeps the strictness for our
+own components while letting node_modules compile in their intended mode.
+
+Usage:
+
+import { svelte } from "@sveltejs/vite-plugin-svelte";
+import { xmSvelteRunes } from "@xmachines/shared/vite-aliases";
+
+export default defineConfig({ plugins: [svelte(xmSvelteRunes())] });
+
+## Returns
+
+`object`
+
+| Name                      | Type                                                    | Defined in                                                                                                                          |
+| ------------------------- | ------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `dynamicCompileOptions()` | (`data`) => \| \{ `runes`: `boolean`; \} \| `undefined` | [vite-aliases.ts:310](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vite-aliases.ts#L310) |

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

@@ -2,6 +2,11 @@
 
 # vitest
 
+## Interfaces
+
+- [XmBrowserConfigOptions](interfaces/XmBrowserConfigOptions.md)
+
 ## Functions
 
+- [defineXmBrowserConfig](functions/defineXmBrowserConfig.md)
 - [defineXmVitestConfig](functions/defineXmVitestConfig.md)

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

@@ -0,0 +1,42 @@
+[API](../../../../README.md) / [@xmachines/shared](../../README.md) / [vitest](../README.md) / defineXmBrowserConfig
+
+# Function: defineXmBrowserConfig()
+
+```ts
+function defineXmBrowserConfig(importMetaUrl, overrides, options?): UserConfig;
+```
+
+Defined in: [vitest.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vitest.ts#L167)
+
+Create a Vitest browser-mode config with XMachines workspace defaults.
+
+Composes [defineXmVitestConfig](defineXmVitestConfig.md) (so alias resolution, setup-file
+normalization/injection, and the required deep excludes all apply) and
+bakes in the browser boilerplate shared by every browser test project:
+
+- `cacheDir` from `xmCacheDir(importMetaUrl, test.name)` and
+  `resolve` from `xmResolve(importMetaUrl)` (standalone configs only).
+- `optimizeDeps` from `xmOptimizeDeps(options.optimizeDeps)`.
+- `test.include: ["test/browser/**/*.browser.test.ts"]` and
+  `test.exclude: ["**/node_modules/**", "**/dist/**"]` defaults.
+- `test.fileParallelism: false`.
+- Headless Playwright Chromium via `test.browser`.
+
+Everything in `overrides` wins over these defaults: `test.include`,
+`test.exclude`, and `test.setupFiles` replace the defaults when provided,
+and `test.browser` entries (e.g. an `api` port) are merged on top of the
+Playwright defaults. Plugins stay per-package arguments (`plugins: [vue()]`).
+
+## Parameters
+
+| Parameter       | Type                                                                | Description                                                                                                                                          |
+| --------------- | ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `importMetaUrl` | `string`                                                            | Pass `import.meta.url` from the calling config file.                                                                                                 |
+| `overrides`     | `UserConfig`                                                        | Package/project-specific Vitest config overrides. `overrides.test.name` is required — it names the project and keys the shared Vite cache directory. |
+| `options`       | [`XmBrowserConfigOptions`](../interfaces/XmBrowserConfigOptions.md) | Browser-specific knobs, see [XmBrowserConfigOptions](../interfaces/XmBrowserConfigOptions.md).                                                       |
+
+## Returns
+
+`UserConfig`
+
+Merged Vitest configuration object.

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

@@ -6,7 +6,7 @@
 function defineXmVitestConfig(importMetaUrl, overrides): UserConfig;
 ```
 
-Defined in: [vitest.ts:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.53/packages/shared/config/vitest.ts#L55)
+Defined in: [vitest.ts:64](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vitest.ts#L64)
 
 Create a Vitest config with XMachines workspace defaults.
 

package/api/@xmachines/shared/vitest/interfaces/XmBrowserConfigOptions.md

@@ -0,0 +1,16 @@
+[API](../../../../README.md) / [@xmachines/shared](../../README.md) / [vitest](../README.md) / XmBrowserConfigOptions
+
+# Interface: XmBrowserConfigOptions
+
+Defined in: [vitest.ts:117](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vitest.ts#L117)
+
+Options for [defineXmBrowserConfig](../functions/defineXmBrowserConfig.md) that live outside the plain
+Vitest config overrides.
+
+## Properties
+
+| Property                                           | Type                                     | Description                                                                                                                                                                                                                                                                                                                 | Defined in                                                                                                              |
+| -------------------------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
+| <a id="property-base"></a> `base?`                 | `UserConfig`                             | Base Vite config to layer the browser test config on top of (typically a demo's `vite.config.ts`). When set, the base is expected to provide its own `resolve`/`plugins`, so the `cacheDir` and `resolve` defaults are not applied — mirroring the previous `mergeConfig(viteConfig, ...)` pattern in demo browser configs. | [vitest.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vitest.ts#L125) |
+| <a id="property-optimizedeps"></a> `optimizeDeps?` | `string`[]                               | Extra package specifiers to pre-bundle via `xmOptimizeDeps` (e.g. `["@json-render/vue", "@json-render/vue/schema"]`). Ignored when `overrides.optimizeDeps` is set, which then replaces the default `xmOptimizeDeps()` wholesale.                                                                                           | [vitest.ts:132](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vitest.ts#L132) |
+| <a id="property-resolve"></a> `resolve?`           | `Partial`\<`ResolveOptions` & `object`\> | Extra resolve options forwarded to `xmResolve` (e.g. `conditions` or additional `alias` entries). Not applied when `base` is set — the base config owns `resolve` in that layout.                                                                                                                                           | [vitest.ts:138](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.55/packages/shared/config/vitest.ts#L138) |

package/api/README.md

@@ -16,6 +16,7 @@
 - [@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-router](@xmachines/play-tanstack-router/README.md)
 - [@xmachines/play-tanstack-solid-router](@xmachines/play-tanstack-solid-router/README.md)
 - [@xmachines/play-vue](@xmachines/play-vue/README.md)
 - [@xmachines/play-vue-router](@xmachines/play-vue-router/README.md)

package/api/llms.txt

@@ -29,6 +29,7 @@
 - [@xmachines/play-dom-router](@xmachines/play-dom-router/README.md): Vanilla DOM browser history, router, and actor↔URL synchronization
 - [@xmachines/play-signals](@xmachines/play-signals/README.md): Signal primitives used by Play actors and adapters
 - [@xmachines/play-router](@xmachines/play-router/README.md): Route extraction, route maps, and shared routing infrastructure
+- [@xmachines/play-tanstack-router](@xmachines/play-tanstack-router/README.md): Shared framework-agnostic TanStack Router bridge base
 - [@xmachines/play-xstate](@xmachines/play-xstate/README.md): XState-backed player and actor integration
 - [@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
@@ -55,7 +56,7 @@
 
 ```javascript
 import { definePlayer } from '@xmachines/play-xstate';
-import { createRouteMatcher, extractMachineRoutes } from '@xmachines/play-router';
+import { createRouteMapFromTree, extractMachineRoutes, extractRouteParams } from '@xmachines/play-router';
 import { defineRegistry } from '@json-render/react';
 import { PlayRenderer } from '@xmachines/play-react';
 
@@ -66,8 +67,8 @@ actor.start();
 const currentView = actor.currentView.get();
 const currentRoute = actor.currentRoute.get();
 const routeTree = extractMachineRoutes(machine);
-const routeMatcher = createRouteMatcher(routeTree);
-const routeMatch = routeMatcher.match(currentRoute ?? '/');
+const routeMap = createRouteMapFromTree(routeTree);
+const stateId = routeMap.getStateIdByPath(currentRoute ?? '/');
 
 const { registry } = defineRegistry(catalog, { components, actions });
 <PlayRenderer actor={actor} registry={registry} actions={{ login: 'auth.login' }} />

package/contributing/architecture.md

@@ -463,12 +463,12 @@ flowchart TD
     PE --> RSE["RouterSyncError\nPLAY_ROUTER_SYNC_FAILED"]
     PE --> UPE["URLPatternUnavailableError\nPLAY_ROUTE_MAP_URLPATTERN_UNAVAILABLE"]
     PE --> DBE["DuplicateBridgeError\nPLAY_ROUTER_DUPLICATE_BRIDGE"]
-    PE --> IEE["InvalidEventError\nPLAY_INVALID_EVENT"]
-    PE --> IME["InvalidMachineError\nPLAY_INVALID_MACHINE"]
-    PE --> MRP["MissingRouteParamError\nPLAY_ROUTE_PARAM_MISSING"]
-    PE --> MSI["MissingStateIdError\nPLAY_MISSING_STATE_ID"]
-    PE --> MQC["MissingQueryContextError\nPLAY_MISSING_QUERY_CONTEXT"]
-    PE --> IRE["InvalidRouteMetadataError\nPLAY_INVALID_ROUTE_METADATA"]
+    PE --> IEE["InvalidEventError\nPLAY_XSTATE_INVALID_EVENT"]
+    PE --> IME["InvalidMachineError\nPLAY_XSTATE_INVALID_MACHINE"]
+    PE --> MRP["MissingRouteParamError\nPLAY_XSTATE_ROUTE_PARAM_MISSING"]
+    PE --> MSI["MissingStateIdError\nPLAY_XSTATE_MISSING_STATE_ID"]
+    PE --> MQC["MissingQueryContextError\nPLAY_XSTATE_MISSING_QUERY_CONTEXT"]
+    PE --> IRE["InvalidRouteMetadataError\nPLAY_XSTATE_INVALID_ROUTE_METADATA"]
 ```
 
 Package-specific errors are exported from `./errors` subpath imports:

package/contributing/configuration.md

@@ -12,20 +12,7 @@ The monorepo itself has no application runtime that reads environment variables.
 
 ### Dev Container Variables
 
-These variables are consumed by the Docker Compose workspace defined in `.devcontainer/docker-compose.yaml`. Copy `.devcontainer/.env.sample` to `.devcontainer/.env` to override defaults locally.
-
-| Variable                      | Required | Default | Description                                                                                           |
-| ----------------------------- | -------- | ------- | ----------------------------------------------------------------------------------------------------- |
-| `OPENCODE_EXPERIMENTAL_OXFMT` | Optional | `false` | Enables experimental oxfmt integration inside the opencode AI assistant running in the dev container. |
-| `OPENCODE_PORT_MAPPING`       | Optional | `4096`  | Docker port mapping for the opencode web interface (`host_port:container_port` or just `host_port`).  |
-
-**Sample file:** `.devcontainer/.env.sample`
-
-```bash
-# .devcontainer/.env.sample
-# OPENCODE_EXPERIMENTAL_OXFMT=true
-# OPENCODE_PORT_MAPPING=4096:4096
-```
+The dev container currently defines no workspace-specific environment variables; `.devcontainer/.env` (loaded via `env_file` in `.devcontainer/compose.yaml`) is available for local overrides if a future tool needs one. Copy `.devcontainer/.env.sample` to `.devcontainer/.env` to get started.
 
 ### CI / Release Pipeline Variable
 
@@ -359,8 +346,6 @@ The only environment-specific distinction is between **local development** (dev
 
 | Config                               | Required to Work                      | Optional / Has Default        |
 | ------------------------------------ | ------------------------------------- | ----------------------------- |
-| `OPENCODE_EXPERIMENTAL_OXFMT`        | No                                    | Default: `false`              |
-| `OPENCODE_PORT_MAPPING`              | No                                    | Default: `4096`               |
 | `SEMREL_SKIP_STEPS`                  | No                                    | Default: `""` (run all steps) |
 | Root `tsconfig.json` `references`    | Yes — must list all packages          | —                             |
 | Per-package `composite: true`        | Yes — required for project references | —                             |

package/contributing/deployment.md

@@ -142,21 +142,21 @@ Tag format is `v${version}` (e.g., `v1.0.0-beta.46`).
 
 ### Prepare Phase
 
-Before any package is published, semantic-release runs the `prepareCmd` from `.releaserc.json`:
+Before any package is published, semantic-release runs a sequence of `@semantic-release/exec` prepare steps defined in `release.config.mjs`:
 
 ```bash
-npm install --prefix . @npmcli/arborist
-npm run apply-patches
+corepack enable
+pnpm install --frozen-lockfile
 node scripts/set-workspace-versions.mjs ${nextRelease.version}
-npm run build
-npm run typedoc -w @xmachines/docs -- --gitRevision v${nextRelease.version}
-npm run format -w @xmachines/docs
+pnpm run build
+pnpm --filter @xmachines/docs run typedoc --gitRevision v${nextRelease.version}
+pnpm --filter @xmachines/docs run format
 ```
 
 Step by step:
 
-1. **Install Arborist** — ensures the workspace introspection tool is available.
-2. **Apply patches** — runs `patch-package` to apply any patches in the `patches/` directory.
+1. **Enable corepack** — activates the pinned pnpm version.
+2. **Install** — `pnpm install --frozen-lockfile` installs dependencies and applies the `patches/` (pnpm `patchedDependencies`) during install, so no separate apply-patches step is needed.
 3. **Sync versions** — `scripts/set-workspace-versions.mjs` sets the same release version across every `package.json` in the workspace (root + all packages), including cross-package workspace dependency ranges.
 4. **Build** — runs `tsc --build` to produce compiled `dist/` output in all packages.
 5. **Generate API docs** — runs TypeDoc to regenerate `packages/docs/api/` at the release git revision.

package/contributing/testing.md

@@ -353,14 +353,14 @@ try {
 
 ## Contract Tests
 
-The `@xmachines/play-router` package exports a shared behavioral contract suite that all router bridge adapters must satisfy:
+The `@xmachines/play-router-shared` package exports a shared behavioral contract suite that all router bridge adapters must satisfy. It lives here (rather than in `@xmachines/play-router`) because the suite drives a real actor via `@xmachines/play-xstate` and uses the shared `authMachine` fixture from `@xmachines/play-actor-shared`, so it sits one layer above the router package and keeps `@xmachines/play-router` free of any dependency on the actor runtime:
 
 ```typescript
-// packages/play-router/test/router-bridge-contract.ts
+// packages/play-router/examples/shared/test/router-bridge-contract.ts
 export function runBridgeContractTests(opts: ContractSuiteOptions): void;
 
 // Each adapter's test file calls it:
-import { runBridgeContractTests } from "../../play-router/test/router-bridge-contract.js";
+import { runBridgeContractTests } from "@xmachines/play-router-shared/test/router-bridge-contract.js";
 
 runBridgeContractTests({
 	name: "TanStackReactRouterBridge",
@@ -380,7 +380,7 @@ The contract covers: deep-link sync on connect, router→actor navigation sync,
 **Compile-time bridge contract verification:**
 
 ```typescript
-import { assertImplementsRouterBridge } from "@xmachines/play-router/test/contract.js";
+import { assertImplementsRouterBridge } from "@xmachines/play-router-shared/test/router-bridge-contract.js";
 import { MyRouterBridge } from "../src/my-router-bridge.js";
 
 assertImplementsRouterBridge<MyRouterBridge>(); // Zero runtime cost

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.53/packages/play-dom/examples/demo/src/components/NavBar.ts#L9)
+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)
 
 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.53/packages/play-dom/examples/demo/src/components/Shell.ts#L24)
+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)
 
 Shell — DOM shell layout factory. Renders demo chrome (header + main +
 debug panel), mounts NavBar, connects DOM renderer, and wires DebugPanel.