@xmachines/docs 1.0.0-beta.25 → 1.0.0-beta.26

package/api/@xmachines/play-signals/namespaces/Signal/classes/State.md

@@ -2,6 +2,8 @@
 
 # Class: State\<T\>
 
+Defined in: `signal-polyfill`
+
 ## Type Parameters
 
 | Type Parameter |
@@ -16,6 +18,8 @@
 new State<T>(initialValue, options?): State<T>;
 ```
 
+Defined in: `signal-polyfill`
+
 #### Parameters
 
 | Parameter      | Type                                         |
@@ -41,6 +45,8 @@ new State<T>(initialValue, options?): State<T>;
 get(): T;
 ```
 
+Defined in: `signal-polyfill`
+
 #### Returns
 
 `T`
@@ -53,6 +59,8 @@ get(): T;
 set(newValue): void;
 ```
 
+Defined in: `signal-polyfill`
+
 #### Parameters
 
 | Parameter  | Type |

package/api/@xmachines/play-signals/namespaces/Signal/interfaces/Options.md

@@ -2,6 +2,8 @@
 
 # Interface: Options\<T\>
 
+Defined in: `signal-polyfill`
+
 ## Type Parameters
 
 | Type Parameter |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/classes/Watcher.md

@@ -2,6 +2,8 @@
 
 # Class: Watcher
 
+Defined in: `signal-polyfill`
+
 ## Constructors
 
 ### Constructor
@@ -10,6 +12,8 @@
 new Watcher(notify): Watcher;
 ```
 
+Defined in: `signal-polyfill`
+
 #### Parameters
 
 | Parameter | Type               |
@@ -34,6 +38,8 @@ new Watcher(notify): Watcher;
 getPending(): Computed<any>[];
 ```
 
+Defined in: `signal-polyfill`
+
 #### Returns
 
 [`Computed`](../../../classes/Computed.md)\<`any`\>[]
@@ -46,6 +52,8 @@ getPending(): Computed<any>[];
 unwatch(...signals): void;
 ```
 
+Defined in: `signal-polyfill`
+
 #### Parameters
 
 | Parameter    | Type                   |
@@ -64,6 +72,8 @@ unwatch(...signals): void;
 watch(...signals): void;
 ```
 
+Defined in: `signal-polyfill`
+
 #### Parameters
 
 | Parameter    | Type                   |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/functions/currentComputed.md

@@ -6,6 +6,8 @@
 function currentComputed(): Computed<any> | undefined;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Returns
 
 [`Computed`](../../../classes/Computed.md)\<`any`\> \| `undefined`

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/functions/hasSinks.md

@@ -6,6 +6,8 @@
 function hasSinks(signal): boolean;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type        |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/functions/hasSources.md

@@ -6,6 +6,8 @@
 function hasSources(signal): boolean;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type      |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/functions/introspectSinks.md

@@ -6,6 +6,8 @@
 function introspectSinks(signal): AnySink[];
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type        |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/functions/introspectSources.md

@@ -6,6 +6,8 @@
 function introspectSources(sink): AnySignal<any>[];
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type      |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/functions/untrack.md

@@ -6,6 +6,8 @@
 function untrack<T>(cb): T;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Type Parameters
 
 | Type Parameter |

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/variables/unwatched.md

@@ -5,3 +5,5 @@
 ```ts
 const unwatched: unique symbol;
 ```
+
+Defined in: `signal-polyfill`

package/api/@xmachines/play-signals/namespaces/Signal/namespaces/subtle/variables/watched.md

@@ -5,3 +5,5 @@
 ```ts
 const watched: unique symbol;
 ```
+
+Defined in: `signal-polyfill`

package/api/@xmachines/play-signals/namespaces/Signal/variables/isComputed.md

@@ -6,6 +6,8 @@
 isComputed: (s) => boolean;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type  |

package/api/@xmachines/play-signals/namespaces/Signal/variables/isState.md

@@ -6,6 +6,8 @@
 isState: (s) => boolean;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type  |

package/api/@xmachines/play-signals/namespaces/Signal/variables/isWatcher.md

@@ -6,6 +6,8 @@
 isWatcher: (s) => boolean;
 ```
 
+Defined in: `signal-polyfill`
+
 ## Parameters
 
 | Parameter | Type  |

package/api/@xmachines/play-signals/type-aliases/WatcherNotify.md

@@ -6,7 +6,7 @@
 type WatcherNotify = () => void;
 ```
 
-Defined in: [packages/play-signals/src/types.ts:139](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-signals/src/types.ts#L139)
+Defined in: [packages/play-signals/src/types.ts:139](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-signals/src/types.ts#L139)
 
 Notification callback for Signal.subtle.Watcher
 

package/api/@xmachines/play-solid/README.md

@@ -94,8 +94,8 @@ const machine = setup({
 		context: {} as {
 			isAuthenticated: boolean;
 			username: string | null;
-			routeParams: Record<string, string>;
-			queryParams: Record<string, string>;
+			params: Record<string, string>;
+			query: Record<string, string>;
 		},
 		events: {} as
 			| { type: "auth.login"; username: string }
@@ -106,7 +106,7 @@ const machine = setup({
 	formatPlayRouteTransitions({
 		id: "app",
 		initial: "login",
-		context: { isAuthenticated: false, username: null, routeParams: {}, queryParams: {} },
+		context: { isAuthenticated: false, username: null, params: {}, query: {} },
 		states: {
 			login: {
 				id: "login",
@@ -259,7 +259,7 @@ When using `formatPlayRouteTransitions`, URL path parameters flow automatically
 
 ```ts
 // spec: { section: undefined, user: "alice" }
-// After play.route to /settings/profile → context.routeParams = { section: "profile" }
+// After play.route to /settings/profile → context.params = { section: "profile" }
 // Component receives: { section: "profile", user: "alice" }
 ```
 

package/api/@xmachines/play-solid/functions/defineRegistry.md

@@ -6,6 +6,8 @@
 function defineRegistry<C>(_catalog, options): DefineRegistryResult;
 ```
 
+Defined in: `@json-render/solid`
+
 Create a registry from a catalog with components and/or actions.
 
 When the catalog declares actions, the `actions` field is required.

package/api/@xmachines/play-solid/functions/useActor.md

@@ -6,7 +6,7 @@
 function useActor(): PlayActor;
 ```
 
-Defined in: [packages/play-solid/src/useActor.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/useActor.ts#L49)
+Defined in: [packages/play-solid/src/useActor.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/useActor.ts#L49)
 
 ## Returns
 

package/api/@xmachines/play-solid/functions/useStateBinding.md

@@ -6,6 +6,8 @@
 function useStateBinding<T>(path): [Accessor<T | undefined>, (value) => void];
 ```
 
+Defined in: `@json-render/solid`
+
 ## Type Parameters
 
 | Type Parameter |

package/api/@xmachines/play-solid/interfaces/ComponentContext.md

@@ -2,6 +2,8 @@
 
 # Interface: ComponentContext\<C, K\>
 
+Defined in: `@json-render/solid`
+
 Context passed to component render functions
 
 ## Example

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

@@ -2,7 +2,7 @@
 
 # Interface: PlayRendererProps\<TLogic\>
 
-Defined in: [packages/play-solid/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L29)
+Defined in: [packages/play-solid/src/types.ts:29](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L29)
 
 Props for PlayRenderer component
 
@@ -16,9 +16,9 @@ Props for PlayRenderer component
 
 | Property                                   | Type                                                                                                                                                                                                | Description                                                                                                                                                                                                                                                                                                                                                         | Defined in                                                                                                                                   |
 | ------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
-| <a id="property-actions"></a> `actions?`   | `object`                                                                                                                                                                                            | Optional mapping of json-render action names to XState event type strings. Values are constrained to `EventFromLogic<TLogic>["type"]` — passing a non-existent event type string is a compile error when TLogic is specified.                                                                                                                                       | [packages/play-solid/src/types.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L65) |
-| <a id="property-actor"></a> `actor`        | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L31) |
-| <a id="property-fallback"></a> `fallback?` | `any`                                                                                                                                                                                               | Optional element shown when currentView is null or a component throws                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:37](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L37) |
-| <a id="property-onerror"></a> `onError?`   | (`error`) => `void`                                                                                                                                                                                 | Optional callback invoked when a catalog component throws during render. Receives the thrown error — use to forward to Sentry, Datadog, etc.                                                                                                                                                                                                                        | [packages/play-solid/src/types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L49) |
-| <a id="property-registry"></a> `registry`  | `ComponentRegistry`                                                                                                                                                                                 | Component registry from @json-render/solid defineRegistry()                                                                                                                                                                                                                                                                                                         | [packages/play-solid/src/types.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L34) |
-| <a id="property-store"></a> `store?`       | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-solid/src/types.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/types.ts#L58) |
+| <a id="property-actions"></a> `actions?`   | `object`                                                                                                                                                                                            | Optional mapping of json-render action names to XState event type strings. Values are constrained to `EventFromLogic<TLogic>["type"]` — passing a non-existent event type string is a compile error when TLogic is specified.                                                                                                                                       | [packages/play-solid/src/types.ts:65](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L65) |
+| <a id="property-actor"></a> `actor`        | [`AbstractActor`](../../play-actor/classes/AbstractActor.md)\<`TLogic`, [`EventObject`](https://www.jsdocs.io/package/xstate#EventObject)\> & [`Viewable`](../../play-actor/interfaces/Viewable.md) | Actor instance with currentView signal (requires Viewable capability)                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:31](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L31) |
+| <a id="property-fallback"></a> `fallback?` | `any`                                                                                                                                                                                               | Optional element shown when currentView is null or a component throws                                                                                                                                                                                                                                                                                               | [packages/play-solid/src/types.ts:37](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L37) |
+| <a id="property-onerror"></a> `onError?`   | (`error`) => `void`                                                                                                                                                                                 | Optional callback invoked when a catalog component throws during render. Receives the thrown error — use to forward to Sentry, Datadog, etc.                                                                                                                                                                                                                        | [packages/play-solid/src/types.ts:49](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L49) |
+| <a id="property-registry"></a> `registry`  | `ComponentRegistry`                                                                                                                                                                                 | Component registry from @json-render/solid defineRegistry()                                                                                                                                                                                                                                                                                                         | [packages/play-solid/src/types.ts:34](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L34) |
+| <a id="property-store"></a> `store?`       | `StateStore`                                                                                                                                                                                        | Optional external StateStore (e.g. from `xstateStoreStateStore` in @json-render/xstate). When provided, PlayRenderer operates in controlled mode — spec.state is ignored and this store is the single source of truth for UI state (form values, etc.). When omitted, a fresh @xstate/store atom is created internally per view transition, seeded from spec.state. | [packages/play-solid/src/types.ts:58](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/types.ts#L58) |

package/api/@xmachines/play-solid/type-aliases/ComponentFn.md

@@ -6,6 +6,8 @@
 type ComponentFn<C, K> = (ctx) => JSX.Element;
 ```
 
+Defined in: `@json-render/solid`
+
 Component render function type for Solid
 
 ## Type Parameters

package/api/@xmachines/play-solid/type-aliases/PlayActor.md

@@ -6,4 +6,4 @@
 type PlayActor = AbstractActor<AnyActorLogic>;
 ```
 
-Defined in: [packages/play-solid/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/useActor.ts#L26)
+Defined in: [packages/play-solid/src/useActor.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/useActor.ts#L26)

package/api/@xmachines/play-solid/variables/PlayRenderer.md

@@ -6,7 +6,7 @@
 const PlayRenderer: Component<PlayRendererProps>;
 ```
 
-Defined in: [packages/play-solid/src/PlayRenderer.tsx:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid/src/PlayRenderer.tsx#L55)
+Defined in: [packages/play-solid/src/PlayRenderer.tsx:55](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-solid/src/PlayRenderer.tsx#L55)
 
 Main renderer component that subscribes to actor signals and renders UI
 

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

@@ -128,7 +128,7 @@ class SolidRouterBridge {
 
 **Methods:**
 
-- `connect()` - Start bidirectional synchronization.
+- `connect()` - Start bidirectional synchronization. Both `location.pathname` and `location.search` are forwarded to the actor on first connect, so users arriving on `/profile?tab=posts` have `query: { tab: "posts" }` in the initial `play.route` event.
 - `disconnect()` - Stop synchronization and cleanup bridge resources.
 - `dispose()` - Alias of `disconnect()`.
 
@@ -139,7 +139,7 @@ class SolidRouterBridge {
 - Uses `RouterBridgeBase` TC39 watcher lifecycle for actor→router synchronization
 - Updates SolidJS Router via `navigate(path)` when actor state changes
 - Uses `createEffect(on(...))` to watch `location.pathname` signal
-- Sends `play.route` events to actor when user navigates
+- Sends `play.route` events to actor when user navigates, using Solid's pre-parsed `useParams()` for path parameter extraction (no URLPattern polyfill required)
 - Prevents circular updates with path tracking and processing flags
 
 ### `RouteMap`

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

@@ -2,7 +2,7 @@
 
 # Class: RouteMap
 
-Defined in: [packages/play-solid-router/src/route-map.ts:26](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-solid-router/src/route-map.ts#L26)
+Defined in: [packages/play-router/src/base-route-map.ts:100](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/base-route-map.ts#L100)
 
 Shared bidirectional route map base class.
 
@@ -14,7 +14,8 @@ own and inherit the full public API from here.
 - Static paths (no `:param`) → O(1) `Map` lookup
 - Dynamic paths → O(k) bucket-indexed scan using `URLPattern`, where `k` is the number
   of routes sharing the same first path segment
-- Results are cached after the first match
+- Results are cached after the first match in an LRU cache (default 500 entries,
+  configurable via the `cacheSize` constructor option)
 
 **Pattern syntax** (`:param` / `:param?`):
 
@@ -41,19 +42,15 @@ map.getPathByStateId("profile"); // "/profile/:userId"
 map.getPathByStateId("missing"); // null
 ```
 
-## Extends
-
-- [`BaseRouteMap`](../../play-router/classes/BaseRouteMap.md)
-
 ## Constructors
 
 ### Constructor
 
 ```ts
-new RouteMap(mappings): RouteMap;
+new RouteMap(mappings, options?): BaseRouteMap;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:118](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-router/src/base-route-map.ts#L118)
+Defined in: [packages/play-router/src/base-route-map.ts:125](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/base-route-map.ts#L125)
 
 Build a route map from an array of state ID ↔ path mappings.
 
@@ -63,17 +60,15 @@ buckets for efficient candidate selection.
 
 #### Parameters
 
-| Parameter  | Type                                                                     | Description                                                                                                       |
-| ---------- | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- |
-| `mappings` | [`BaseRouteMapping`](../../play-router/interfaces/BaseRouteMapping.md)[] | Array of `{ stateId, path }` entries. Order determines priority when multiple patterns could match the same path. |
+| Parameter            | Type                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                  |
+| -------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `mappings`           | [`RouteMapping`](../interfaces/RouteMapping.md)[] | Array of `{ stateId, path }` entries. Order determines priority when multiple patterns could match the same path.                                                                                                                                                                                                                                                                                            |
+| `options`            | \{ `cacheSize?`: `number`; \}                     | Optional configuration. `options.cacheSize`: Maximum number of resolved parameterized path lookups to cache. Defaults to `500`. Increase for applications with many unique parameterized URL values (e.g. user profile pages with thousands of distinct IDs). After eviction the path falls back to the O(k) bucket pattern scan — correct but slower. Minimum effective value is `1` (QuickLRU constraint). |
+| `options.cacheSize?` | `number`                                          | -                                                                                                                                                                                                                                                                                                                                                                                                            |
 
 #### Returns
 
-`RouteMap`
-
-#### Inherited from
-
-[`BaseRouteMap`](../../play-router/classes/BaseRouteMap.md).[`constructor`](../../play-router/classes/BaseRouteMap.md#constructor)
+`BaseRouteMap`
 
 ## Methods
 
@@ -83,7 +78,7 @@ buckets for efficient candidate selection.
 getPathByStateId(stateId): string | null;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:202](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-router/src/base-route-map.ts#L202)
+Defined in: [packages/play-router/src/base-route-map.ts:209](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/base-route-map.ts#L209)
 
 Look up the path pattern registered for a state ID.
 
@@ -106,10 +101,6 @@ map.getPathByStateId("profile"); // "/profile/:userId"
 map.getPathByStateId("missing"); // null
 ```
 
-#### Inherited from
-
-[`BaseRouteMap`](../../play-router/classes/BaseRouteMap.md).[`getPathByStateId`](../../play-router/classes/BaseRouteMap.md#getpathbystateid)
-
 ---
 
 ### getStateIdByPath()
@@ -118,7 +109,7 @@ map.getPathByStateId("missing"); // null
 getStateIdByPath(path): string | null;
 ```
 
-Defined in: [packages/play-router/src/base-route-map.ts:167](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.25/packages/play-router/src/base-route-map.ts#L167)
+Defined in: [packages/play-router/src/base-route-map.ts:174](https://gitlab.com/xmachin-es/xmachines-js/-/blob/v1.0.0-beta.26/packages/play-router/src/base-route-map.ts#L174)
 
 Resolve a URL path to its mapped state ID.
 
@@ -144,7 +135,3 @@ The mapped state ID, or `null` if no route matches
 map.getStateIdByPath("/profile/123"); // "profile"
 map.getStateIdByPath("/unknown"); // null
 ```
-
-#### Inherited from
-
-[`BaseRouteMap`](../../play-router/classes/BaseRouteMap.md).[`getStateIdByPath`](../../play-router/classes/BaseRouteMap.md#getstateidbypath)