@xmachines/play-solid-router 1.0.0-beta.2 → 1.0.0-beta.20

package/README.md

@@ -8,7 +8,7 @@ SolidJS Router adapter using `RouterBridgeBase` for consistent actor↔router sy
 
 `@xmachines/play-solid-router` provides seamless integration between SolidJS Router and XMachines state machines. Built on Solid's reactive primitives, it enables zero-adaptation signals synchronization.
 
-Per [RFC Play v1](https://gitlab.com/xmachin-es/rfc/-/blob/main/src/play-v1.md), this package implements:
+Per [Play RFC](../docs/rfc/play.md), this package implements:
 
 - **Actor Authority (INV-01):** State machine controls navigation, router reflects decisions
 - **Passive Infrastructure (INV-04):** Router observes `actor.currentRoute` signal
@@ -36,12 +36,12 @@ npm install @solidjs/router@^0.13.0 solid-js@^1.8.0 @xmachines/play-solid-router
 
 **Peer dependencies:**
 
-- `@solidjs/router` ^0.13.0 - SolidJS Router library
-- `solid-js` ^1.8.0 - SolidJS runtime
-- `@xmachines/play-solid` - Solid renderer (`PlayRenderer`)
-- `@xmachines/play-actor` - Actor base
-- `@xmachines/play-router` - Route extraction
-- `@xmachines/play-signals` - TC39 Signals polyfill
+- `@solidjs/router` ^0.13.0 — SolidJS Router library
+- `solid-js` ^1.8.0 — SolidJS runtime
+- `@xmachines/play-solid` — Solid renderer (`PlayRenderer`)
+- `@xmachines/play-actor` — Actor base
+- `@xmachines/play-router` — Route extraction
+- `@xmachines/play-signals` — TC39 Signals primitives
 
 ## Quick Start
 
@@ -130,6 +130,8 @@ class SolidRouterBridge {
 - `disconnect()` - Stop synchronization and cleanup bridge resources.
 - `dispose()` - Alias of `disconnect()`.
 
+`connect()` creates a Solid-owned router watcher, and `disconnect()`/`dispose()` tears it down immediately. Do not rely on owner unmount alone if you need the bridge to stop processing router updates earlier.
+
 **Internal Behavior:**
 
 - Uses `RouterBridgeBase` TC39 watcher lifecycle for actor→router synchronization
@@ -142,35 +144,39 @@ class SolidRouterBridge {
 
 Bidirectional mapping between XMachines state IDs and SolidJS Router paths with pattern matching support.
 
-**Type Signature:**
+`RouteMap` extends `BaseRouteMap` from `@xmachines/play-router`, inheriting bucket-indexed
+bidirectional route matching. No routing logic lives in the adapter itself.
 
 ```typescript
 interface RouteMapping {
-	stateId: string;
-	path: string;
+	readonly stateId: string;
+	readonly path: string;
 }
 
-class RouteMap {
-	constructor(mappings: RouteMapping[]);
-	getPath(stateId: string, params?: Record<string, string>): string | undefined;
-	getStateIdByPath(path: string): string | undefined;
-}
+// RouteMap is a thin subclass of BaseRouteMap — no extra methods
+class RouteMap extends BaseRouteMap {}
+
+// Inherited API:
+routeMap.getStateIdByPath(path: string): string | null
+routeMap.getPathByStateId(stateId: string): string | null
 ```
 
+`getStateIdByPath` and `getPathByStateId` both return `null` (not `undefined`) for misses.
+
 **Constructor Parameters:**
 
-- `mappings` - Array of mapping objects with:
-    - `stateId` - State machine state ID (e.g., `'#profile'`)
-    - `path` - SolidJS Router path pattern (e.g., `'/profile/:userId'`)
+- `mappings` - Array of `{ stateId, path }` entries:
+    - `stateId` — State machine state ID (e.g., `'#profile'`)
+    - `path` — SolidJS Router path pattern (e.g., `'/profile/:userId'`)
 
 **Methods:**
 
-- `getPath(stateId, params?)` - Find path from state ID, optionally substitute params
-- `getStateIdByPath(path)` - Find state ID from path with pattern matching (supports `:param` and `:param?` syntax)
+- `getPathByStateId(stateId)` — Find path pattern from state ID
+- `getStateIdByPath(path)` — Find state ID from path with pattern matching (supports `:param` and `:param?` syntax)
 
 **Pattern Matching:**
 
-Uses URLPattern API for robust dynamic route matching:
+Uses bucket-indexed RegExp matching for dynamic routes:
 
 ```typescript
 const routeMap = new RouteMap([{ stateId: "#settings", path: "/settings/:section?" }]);
@@ -178,6 +184,7 @@ const routeMap = new RouteMap([{ stateId: "#settings", path: "/settings/:section
 routeMap.getStateIdByPath("/settings"); // '#settings'
 routeMap.getStateIdByPath("/settings/account"); // '#settings'
 routeMap.getStateIdByPath("/settings/privacy"); // '#settings'
+routeMap.getStateIdByPath("/other"); // null
 ```
 
 ## Examples
@@ -186,8 +193,20 @@ routeMap.getStateIdByPath("/settings/privacy"); // '#settings'
 
 ```typescript
 import { Router, Route } from '@solidjs/router';
-import { createSignal } from 'solid-js';
-import { defineCatalog } from '@xmachines/play-catalog';
+import { defineCatalog } from "@json-render/core";
+import { schema } from "@json-render/react/schema";
+import { defineRegistry } from "@xmachines/play-solid";
+import { z } from "zod";
+
+// Catalog and registry
+const appCatalog = defineCatalog(schema, {
+  components: {
+    Home: { props: z.object({}) },
+    About: { props: z.object({}) },
+    Contact: { props: z.object({}) },
+  },
+});
+const registry = defineRegistry(appCatalog, { components: { Home, About, Contact } });
 
 // State machine with 3 states
 const appMachine = setup({
@@ -210,12 +229,6 @@ const appMachine = setup({
   }
 });
 
-const catalog = defineCatalog({
-  Home,
-  About,
-  Contact,
-});
-
 // Component setup
 function App() {
   const navigate = useNavigate();
@@ -224,7 +237,7 @@ function App() {
 
   const routeMap = createRouteMap(appMachine);
 
-  const createPlayer = definePlayer({ machine: appMachine, catalog });
+  const createPlayer = definePlayer({ machine: appMachine, catalog: appCatalog });
   const actor = createPlayer();
   actor.start();
   const bridge = new SolidRouterBridge(navigate, location, params, actor, routeMap);
@@ -246,7 +259,18 @@ function App() {
 ```typescript
 // State machine with parameter routes
 import { formatPlayRouteTransitions } from "@xmachines/play-xstate";
-import { defineCatalog } from "@xmachines/play-catalog";
+import { defineCatalog } from "@json-render/core";
+import { schema } from "@json-render/react/schema";
+import { defineRegistry } from "@xmachines/play-solid";
+import { z } from "zod";
+
+const appCatalog = defineCatalog(schema, {
+  components: {
+    Profile: { props: z.object({ userId: z.string() }) },
+    Settings: { props: z.object({ section: z.string().optional() }) },
+  },
+});
+const registry = defineRegistry(appCatalog, { components: { Profile, Settings } });
 
 const machineConfig = {
   id: 'app',
@@ -274,11 +298,6 @@ const appMachine = setup({
   }
 }).createMachine(formatPlayRouteTransitions(machineConfig));
 
-const catalog = defineCatalog({
-  Profile,
-  Settings,
-});
-
 // Router with dynamic routes
 function App() {
   const navigate = useNavigate();
@@ -287,7 +306,7 @@ function App() {
 
   const routeMap = createRouteMap(appMachine);
 
-  const createPlayer = definePlayer({ machine: appMachine, catalog });
+  const createPlayer = definePlayer({ machine: appMachine, catalog: appCatalog });
   const actor = createPlayer();
   actor.start();
   const bridge = new SolidRouterBridge(navigate, location, params, actor, routeMap);
@@ -328,7 +347,17 @@ function ProfileButton(props: { userId: string }) {
 ```typescript
 // State machine with query param handling
 import { formatPlayRouteTransitions } from "@xmachines/play-xstate";
-import { defineCatalog } from "@xmachines/play-catalog";
+import { defineCatalog } from "@json-render/core";
+import { schema } from "@json-render/react/schema";
+import { defineRegistry } from "@xmachines/play-solid";
+import { z } from "zod";
+
+const searchCatalog = defineCatalog(schema, {
+  components: {
+    Search: { props: z.object({ query: z.string().optional() }) },
+  },
+});
+const registry = defineRegistry(searchCatalog, { components: { Search } });
 
 const machineConfig = {
   context: { query: '', filters: {} },
@@ -349,11 +378,7 @@ const searchMachine = setup({
   }
 }).createMachine(formatPlayRouteTransitions(machineConfig));
 
-const catalog = defineCatalog({
-  Search,
-});
-
-const player = definePlayer({ machine: searchMachine, catalog });
+const player = definePlayer({ machine: searchMachine, catalog: searchCatalog });
 
 // Component sends query params
 function SearchBar(props) {
@@ -387,7 +412,19 @@ function SearchBar(props) {
 
 ```typescript
 // State machine with auth guards
-import { defineCatalog } from "@xmachines/play-catalog";
+import { defineCatalog } from "@json-render/core";
+import { schema } from "@json-render/react/schema";
+import { defineRegistry } from "@xmachines/play-solid";
+import { z } from "zod";
+
+const authCatalog = defineCatalog(schema, {
+	components: {
+		Home: { props: z.object({}) },
+		Login: { props: z.object({ title: z.string() }) },
+		Dashboard: { props: z.object({ username: z.string() }) },
+	},
+});
+const registry = defineRegistry(authCatalog, { components: { Home, Login, Dashboard } });
 
 const authMachine = setup({
 	types: {
@@ -420,13 +457,7 @@ const authMachine = setup({
 	},
 });
 
-const catalog = defineCatalog({
-	Home,
-	Login,
-	Dashboard,
-});
-
-const player = definePlayer({ machine: authMachine, catalog });
+const player = definePlayer({ machine: authMachine, catalog: authCatalog });
 ```
 
 **Guard behavior:**
@@ -479,7 +510,7 @@ function App() {
 2. `actor.currentRoute` signal updates
 3. `createEffect(on(...))` fires with new route value
 4. Bridge extracts state ID from signal
-5. Bridge looks up path via `routeMap.getPath(stateId, params)`
+5. Bridge looks up path via `routeMap.getPathByStateId(stateId)`
 6. Bridge calls `navigate(path)`
 7. SolidJS Router updates URL and renders component
 
@@ -603,15 +634,11 @@ function App() {
 
 ### Pattern Matching for Dynamic Routes
 
-**URLPattern API integration:**
+**Bucket-indexed matching via `BaseRouteMap`:**
 
-```typescript
-private matchesPattern(path: string, pattern: string): boolean {
-  // Use URLPattern for robust matching
-  const urlPattern = new URLPattern({ pathname: pattern });
-  return urlPattern.test({ pathname: path });
-}
-```
+Routes are grouped by their first path segment into buckets. On each lookup only the
+relevant bucket (plus the wildcard `*` bucket for `:param`-first routes) is scanned —
+typically far fewer than all registered routes.
 
 **Supported syntax:**
 
@@ -634,4 +661,7 @@ routeMap.getStateIdByPath("/settings/privacy"); // '#settings'
 
 ## License
 
-MIT
+Copyright (c) 2016 [Mikael Karon](mailto:mikael@karon.se). All rights reserved.
+
+This work is licensed under the terms of the MIT license.  
+For a copy, see <https://opensource.org/licenses/MIT>.

package/dist/play-router-provider.d.ts

@@ -2,6 +2,7 @@ import { type JSX } from "solid-js";
 import type { AbstractActor, Routable, Viewable } from "@xmachines/play-actor";
 import type { AnyActorLogic } from "xstate";
 import type { RouteMap } from "./route-map.js";
+/** Minimum actor shape accepted by PlayRouterProvider. */
 export type RoutableActor = AbstractActor<AnyActorLogic> & Routable & Viewable;
 export type SolidRouterHooks = {
     navigate: ((path: string) => void) | ((path: string, ...args: unknown[]) => unknown);
@@ -11,11 +12,12 @@ export type SolidRouterHooks = {
     };
     params: Record<string, string | undefined>;
 };
-export interface PlayRouterProviderProps {
-    actor: RoutableActor;
+export interface PlayRouterProviderProps<TActor extends RoutableActor = RoutableActor> {
+    actor: TActor;
     routeMap: RouteMap;
     router: SolidRouterHooks;
-    renderer: (actor: RoutableActor, router: SolidRouterHooks) => JSX.Element;
+    /** Renderer callback receives the same concrete actor type that was passed in. */
+    renderer: (actor: TActor, router: SolidRouterHooks) => JSX.Element;
 }
-export declare function PlayRouterProvider(props: PlayRouterProviderProps): any;
+export declare function PlayRouterProvider<TActor extends RoutableActor>(props: PlayRouterProviderProps<TActor>): any;
 //# sourceMappingURL=play-router-provider.d.ts.map

package/dist/play-router-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"play-router-provider.d.ts","sourceRoot":"","sources":["../src/play-router-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC/E,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACrF,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,uBAAuB;IACvC,KAAK,EAAE,aAAa,CAAC;IACrB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,KAAK,GAAG,CAAC,OAAO,CAAC;CAC1E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,uBAAuB,OAehE"}
+{"version":3,"file":"play-router-provider.d.ts","sourceRoot":"","sources":["../src/play-router-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,0DAA0D;AAC1D,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/E,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,CAAC;IACrF,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC3C,CAAC;AAEF,MAAM,WAAW,uBAAuB,CAAC,MAAM,SAAS,aAAa,GAAG,aAAa;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,gBAAgB,CAAC;IACzB,kFAAkF;IAClF,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,KAAK,GAAG,CAAC,OAAO,CAAC;CACnE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,SAAS,aAAa,EAC9D,KAAK,EAAE,uBAAuB,CAAC,MAAM,CAAC,OAgBtC"}

package/dist/play-router-provider.jsx.map

@@ -1 +1 @@
-{"version":3,"file":"play-router-provider.jsx","sourceRoot":"","sources":["../src/play-router-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,UAAU,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAiB7D,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAChE,MAAM,MAAM,GAAG,IAAI,iBAAiB,CACnC,KAAK,CAAC,MAAM,CAAC,QAAQ,EACrB,KAAK,CAAC,MAAM,CAAC,QAAQ,EACrB,KAAK,CAAC,MAAM,CAAC,MAAM,EACnB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,QAAQ,CACd,CAAC;IACF,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjB,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,CAAC,UAAU,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;AACzD,CAAC"}
+{"version":3,"file":"play-router-provider.jsx","sourceRoot":"","sources":["../src/play-router-provider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,UAAU,CAAC;AAG/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAoB7D,MAAM,UAAU,kBAAkB,CACjC,KAAsC;IAEtC,MAAM,MAAM,GAAG,IAAI,iBAAiB,CACnC,KAAK,CAAC,MAAM,CAAC,QAAQ,EACrB,KAAK,CAAC,MAAM,CAAC,QAAQ,EACrB,KAAK,CAAC,MAAM,CAAC,MAAM,EACnB,KAAK,CAAC,KAAK,EACX,KAAK,CAAC,QAAQ,CACd,CAAC;IACF,MAAM,CAAC,OAAO,EAAE,CAAC;IAEjB,SAAS,CAAC,GAAG,EAAE;QACd,MAAM,CAAC,UAAU,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;AACzD,CAAC"}

package/dist/route-map.d.ts

@@ -1,75 +1,27 @@
 /**
- * RouteMap for bidirectional state ID ↔ path mapping
+ * Bidirectional route mapper for SolidJS Router.
  *
- * Provides efficient lookup between XMachines state IDs and SolidJS Router paths.
- * Supports pattern matching for dynamic routes with parameters.
+ * Extends {@link BaseRouteMap} from `@xmachines/play-router` — all matching logic
+ * lives there. This class exists to provide a SolidJS Router-specific type name
+ * and to allow future adapter-specific extensions without breaking the shared base.
+ *
+ * **Inherited API:**
+ * - `getStateIdByPath(path): string | null` — path → state ID
+ * - `getPathByStateId(stateId): string | null` — state ID → path pattern
+ *
+ * @extends BaseRouteMap
+ *
+ * @example
+ * ```typescript
+ * import { createRouteMap } from "@xmachines/play-solid-router";
+ *
+ * const routeMap = createRouteMap(machine);
+ *
+ * routeMap.getStateIdByPath("/profile/123");  // "profile"
+ * routeMap.getPathByStateId("#settings");     // "/settings/:section?"
+ * ```
  */
-import type { RouteMapping } from "./types.js";
-export declare class RouteMap {
-    private stateToPath;
-    private pathToState;
-    /**
-     * Create a RouteMap with bidirectional mappings
-     *
-     * @param mappings - Array of state ID to path mappings
-     *
-     * @example
-     * ```typescript
-     * const routeMap = new RouteMap([
-     *   { stateId: '#home', path: '/' },
-     *   { stateId: '#profile', path: '/profile/:userId' },
-     *   { stateId: '#settings', path: '/settings/:section?' }
-     * ]);
-     * ```
-     */
-    constructor(mappings: RouteMapping[]);
-    /**
-     * Get path pattern for a state ID
-     *
-     * @param stateId - XMachines state ID (e.g., '#profile')
-     * @returns Path pattern or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * routeMap.getPath('#profile'); // '/profile/:userId'
-     * ```
-     */
-    getPath(stateId: string): string | undefined;
-    /**
-     * Get state ID for a path, with pattern matching support
-     *
-     * Performs exact match first, then fuzzy pattern matching for dynamic routes.
-     * Supports both required (:param) and optional (:param?) parameters.
-     *
-     * @param path - Actual URL path (e.g., '/profile/123')
-     * @returns State ID or undefined if no match found
-     *
-     * @example
-     * ```typescript
-     * routeMap.getStateIdByPath('/profile/123');  // '#profile'
-     * routeMap.getStateIdByPath('/settings');      // '#settings'
-     * routeMap.getStateIdByPath('/settings/account'); // '#settings'
-     * ```
-     */
-    getStateIdByPath(path: string): string | undefined;
-    /**
-     * Check if a path matches a pattern
-     *
-     * Supports:
-     * - Required parameters: :param
-     * - Optional parameters: :param?
-     *
-     * @param path - Actual URL path
-     * @param pattern - Route pattern with :param syntax
-     * @returns true if path matches pattern
-     *
-     * @example
-     * ```typescript
-     * matchesPattern('/profile/123', '/profile/:userId');  // true
-     * matchesPattern('/settings', '/settings/:section?');  // true
-     * matchesPattern('/settings/account', '/settings/:section?'); // true
-     * ```
-     */
-    private matchesPattern;
+import { BaseRouteMap } from "@xmachines/play-router";
+export declare class RouteMap extends BaseRouteMap {
 }
 //# sourceMappingURL=route-map.d.ts.map

package/dist/route-map.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"route-map.d.ts","sourceRoot":"","sources":["../src/route-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,qBAAa,QAAQ;IACpB,OAAO,CAAC,WAAW,CAA6B;IAChD,OAAO,CAAC,WAAW,CAA6B;IAEhD;;;;;;;;;;;;;OAaG;gBACS,QAAQ,EAAE,YAAY,EAAE;IAOpC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAmBlD;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,cAAc;CAetB"}
+{"version":3,"file":"route-map.d.ts","sourceRoot":"","sources":["../src/route-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,qBAAa,QAAS,SAAQ,YAAY;CAAG"}

package/dist/route-map.js

@@ -1,107 +1,27 @@
 /**
- * RouteMap for bidirectional state ID ↔ path mapping
+ * Bidirectional route mapper for SolidJS Router.
  *
- * Provides efficient lookup between XMachines state IDs and SolidJS Router paths.
- * Supports pattern matching for dynamic routes with parameters.
+ * Extends {@link BaseRouteMap} from `@xmachines/play-router` — all matching logic
+ * lives there. This class exists to provide a SolidJS Router-specific type name
+ * and to allow future adapter-specific extensions without breaking the shared base.
+ *
+ * **Inherited API:**
+ * - `getStateIdByPath(path): string | null` — path → state ID
+ * - `getPathByStateId(stateId): string | null` — state ID → path pattern
+ *
+ * @extends BaseRouteMap
+ *
+ * @example
+ * ```typescript
+ * import { createRouteMap } from "@xmachines/play-solid-router";
+ *
+ * const routeMap = createRouteMap(machine);
+ *
+ * routeMap.getStateIdByPath("/profile/123");  // "profile"
+ * routeMap.getPathByStateId("#settings");     // "/settings/:section?"
+ * ```
  */
-export class RouteMap {
-    stateToPath = new Map();
-    pathToState = new Map();
-    /**
-     * Create a RouteMap with bidirectional mappings
-     *
-     * @param mappings - Array of state ID to path mappings
-     *
-     * @example
-     * ```typescript
-     * const routeMap = new RouteMap([
-     *   { stateId: '#home', path: '/' },
-     *   { stateId: '#profile', path: '/profile/:userId' },
-     *   { stateId: '#settings', path: '/settings/:section?' }
-     * ]);
-     * ```
-     */
-    constructor(mappings) {
-        mappings.forEach(({ stateId, path }) => {
-            this.stateToPath.set(stateId, path);
-            this.pathToState.set(path, stateId);
-        });
-    }
-    /**
-     * Get path pattern for a state ID
-     *
-     * @param stateId - XMachines state ID (e.g., '#profile')
-     * @returns Path pattern or undefined if not found
-     *
-     * @example
-     * ```typescript
-     * routeMap.getPath('#profile'); // '/profile/:userId'
-     * ```
-     */
-    getPath(stateId) {
-        return this.stateToPath.get(stateId);
-    }
-    /**
-     * Get state ID for a path, with pattern matching support
-     *
-     * Performs exact match first, then fuzzy pattern matching for dynamic routes.
-     * Supports both required (:param) and optional (:param?) parameters.
-     *
-     * @param path - Actual URL path (e.g., '/profile/123')
-     * @returns State ID or undefined if no match found
-     *
-     * @example
-     * ```typescript
-     * routeMap.getStateIdByPath('/profile/123');  // '#profile'
-     * routeMap.getStateIdByPath('/settings');      // '#settings'
-     * routeMap.getStateIdByPath('/settings/account'); // '#settings'
-     * ```
-     */
-    getStateIdByPath(path) {
-        // Strip query string and hash fragment for matching
-        const cleanPath = path.split("?")[0].split("#")[0];
-        // Direct lookup first (exact match)
-        if (this.pathToState.has(cleanPath)) {
-            return this.pathToState.get(cleanPath);
-        }
-        // Fuzzy match for dynamic routes
-        for (const [pattern, stateId] of this.pathToState) {
-            if (this.matchesPattern(cleanPath, pattern)) {
-                return stateId;
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Check if a path matches a pattern
-     *
-     * Supports:
-     * - Required parameters: :param
-     * - Optional parameters: :param?
-     *
-     * @param path - Actual URL path
-     * @param pattern - Route pattern with :param syntax
-     * @returns true if path matches pattern
-     *
-     * @example
-     * ```typescript
-     * matchesPattern('/profile/123', '/profile/:userId');  // true
-     * matchesPattern('/settings', '/settings/:section?');  // true
-     * matchesPattern('/settings/account', '/settings/:section?'); // true
-     * ```
-     */
-    matchesPattern(path, pattern) {
-        // Convert route pattern to regex
-        // Process replacements in correct order: optional params first, then required
-        let regexPattern = pattern
-            // Replace /:param? with optional segment (matches both /value and nothing)
-            .replace(/\/:(\w+)\?/g, "(?:/([^/]+))?")
-            // Replace /:param with required segment
-            .replace(/\/:(\w+)/g, "/([^/]+)");
-        // Add anchors for exact match
-        regexPattern = "^" + regexPattern + "$";
-        const regex = new RegExp(regexPattern);
-        return regex.test(path);
-    }
+import { BaseRouteMap } from "@xmachines/play-router";
+export class RouteMap extends BaseRouteMap {
 }
 //# sourceMappingURL=route-map.js.map

package/dist/route-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"route-map.js","sourceRoot":"","sources":["../src/route-map.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,OAAO,QAAQ;IACZ,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEhD;;;;;;;;;;;;;OAaG;IACH,YAAY,QAAwB;QACnC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE;YACtC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;;;;;;;OAUG;IACH,OAAO,CAAC,OAAe;QACtB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CAAC,IAAY;QAC5B,oDAAoD;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnD,oCAAoC;QACpC,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,CAAC;QAED,iCAAiC;QACjC,KAAK,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnD,IAAI,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,CAAC;gBAC7C,OAAO,OAAO,CAAC;YAChB,CAAC;QACF,CAAC;QAED,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACK,cAAc,CAAC,IAAY,EAAE,OAAe;QACnD,iCAAiC;QACjC,8EAA8E;QAC9E,IAAI,YAAY,GAAG,OAAO;YACzB,2EAA2E;aAC1E,OAAO,CAAC,aAAa,EAAE,eAAe,CAAC;YACxC,wCAAwC;aACvC,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;QAEnC,8BAA8B;QAC9B,YAAY,GAAG,GAAG,GAAG,YAAY,GAAG,GAAG,CAAC;QAExC,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;CACD"}
+{"version":3,"file":"route-map.js","sourceRoot":"","sources":["../src/route-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,MAAM,OAAO,QAAS,SAAQ,YAAY;CAAG"}

package/dist/solid-router-bridge.d.ts

@@ -44,6 +44,7 @@ import type { RouteMap } from "./route-map.js";
 export declare class SolidRouterBridge extends RouterBridgeBase {
     private readonly solidNavigate;
     private readonly location;
+    private disposeRouterWatcher;
     /**
      * Create a SolidJS Router bridge
      *
@@ -55,7 +56,7 @@ export declare class SolidRouterBridge extends RouterBridgeBase {
      * @param actor - XMachines actor instance
      * @param routeMap - Bidirectional state ID ↔ path mapping
      */
-    constructor(solidNavigate: ((path: string) => void) | ((path: string, ...args: unknown[]) => unknown), location: {
+    constructor(solidNavigate: (path: string, ...args: unknown[]) => unknown, location: {
         pathname: string;
         search: string;
     }, _params: Record<string, string | undefined>, actor: AbstractActor<AnyActorLogic> & Routable, routeMap: RouteMap);
@@ -63,6 +64,10 @@ export declare class SolidRouterBridge extends RouterBridgeBase {
      * Navigate SolidJS Router to the given path.
      */
     protected navigateRouter(path: string): void;
+    /**
+     * Get the current router pathname for initial URL -> actor sync on connect.
+     */
+    protected getInitialRouterPath(): string | null;
     /**
      * Subscribe to SolidJS Router location changes using createEffect.
      *
@@ -74,7 +79,6 @@ export declare class SolidRouterBridge extends RouterBridgeBase {
      * Stop watching SolidJS Router changes.
      *
      * Solid auto-cleans createEffect subscriptions when component unmounts.
-     * This sets the processing flag to prevent pending operations.
      */
     protected unwatchRouterChanges(): void;
     /**

package/dist/solid-router-bridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"solid-router-bridge.d.ts","sourceRoot":"","sources":["../src/solid-router-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IAarD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAG9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAf1B;;;;;;;;;;OAUG;gBAEe,aAAa,EAC3B,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GACxB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,EACjC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,EAC9C,QAAQ,EAAE,QAAQ;IAQnB;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5C;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAcpC;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAMtC;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAGf"}
+{"version":3,"file":"solid-router-bridge.d.ts","sourceRoot":"","sources":["../src/solid-router-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,gBAAgB;IAerD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAf1B,OAAO,CAAC,oBAAoB,CAA6B;IAEzD;;;;;;;;;;OAUG;gBAEe,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,EAC5D,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAC/D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC3C,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,EAC9C,QAAQ,EAAE,QAAQ;IAQnB;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;cACgB,oBAAoB,IAAI,MAAM,GAAG,IAAI;IAIxD;;;;;OAKG;IACH,SAAS,CAAC,kBAAkB,IAAI,IAAI;IAepC;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAKtC;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAGf"}

package/dist/solid-router-bridge.js

@@ -30,7 +30,7 @@
  * }
  * ```
  */
-import { createEffect, on } from "solid-js";
+import { createEffect, createRoot, on } from "solid-js";
 import { RouterBridgeBase } from "@xmachines/play-router";
 /**
  * SolidJS Router integration bridge extending RouterBridgeBase
@@ -42,6 +42,7 @@ import { RouterBridgeBase } from "@xmachines/play-router";
 export class SolidRouterBridge extends RouterBridgeBase {
     solidNavigate;
     location;
+    disposeRouterWatcher = null;
     /**
      * Create a SolidJS Router bridge
      *
@@ -56,7 +57,7 @@ export class SolidRouterBridge extends RouterBridgeBase {
     constructor(solidNavigate, location, _params, actor, routeMap) {
         super(actor, {
             getStateIdByPath: (path) => routeMap.getStateIdByPath(path),
-            getPathByStateId: (id) => routeMap.getPath(id),
+            getPathByStateId: (id) => routeMap.getPathByStateId(id),
         });
         this.solidNavigate = solidNavigate;
         this.location = location;
@@ -67,6 +68,12 @@ export class SolidRouterBridge extends RouterBridgeBase {
     navigateRouter(path) {
         this.solidNavigate(path);
     }
+    /**
+     * Get the current router pathname for initial URL -> actor sync on connect.
+     */
+    getInitialRouterPath() {
+        return this.location.pathname ?? null;
+    }
     /**
      * Subscribe to SolidJS Router location changes using createEffect.
      *
@@ -74,23 +81,22 @@ export class SolidRouterBridge extends RouterBridgeBase {
      * Solid auto-cleans createEffect subscriptions on component unmount.
      */
     watchRouterChanges() {
-        // MUST be called inside Solid reactive owner (component or createRoot)
-        // createEffect in watchRouterChanges() relies on Solid's reactive system
-        createEffect(on(() => this.location.pathname, (pathname) => {
-            const search = this.location.search ?? "";
-            this.syncActorFromRouter(pathname, search);
-        }));
+        this.disposeRouterWatcher = createRoot((dispose) => {
+            createEffect(on(() => this.location.pathname, (pathname) => {
+                const search = this.location.search ?? "";
+                this.syncActorFromRouter(pathname, search);
+            }));
+            return dispose;
+        });
     }
     /**
      * Stop watching SolidJS Router changes.
      *
      * Solid auto-cleans createEffect subscriptions when component unmounts.
-     * This sets the processing flag to prevent pending operations.
      */
     unwatchRouterChanges() {
-        // Solid auto-cleans createEffect on component unmount
-        // Set flag to prevent any pending operations
-        this.isProcessingNavigation = true;
+        this.disposeRouterWatcher?.();
+        this.disposeRouterWatcher = null;
     }
     /**
      * Dispose the bridge (alias for disconnect).

package/dist/solid-router-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"solid-router-bridge.js","sourceRoot":"","sources":["../src/solid-router-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IAapC;IAGA;IAflB;;;;;;;;;;OAUG;IACH,YACkB,aAEiC,EACjC,QAA8C,EAC/D,OAA2C,EAC3C,KAA8C,EAC9C,QAAkB;QAElB,KAAK,CAAC,KAAK,EAAE;YACZ,gBAAgB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACnE,gBAAgB,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;SACtD,CAAC,CAAC;QAXc,kBAAa,GAAb,aAAa,CAEoB;QACjC,aAAQ,GAAR,QAAQ,CAAsC;IAShE,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,IAAY;QACpC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;;;;OAKG;IACO,kBAAkB;QAC3B,uEAAuE;QACvE,yEAAyE;QACzE,YAAY,CACX,EAAE,CACD,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAC5B,CAAC,QAAgB,EAAE,EAAE;YACpB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC5C,CAAC,CACD,CACD,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACO,oBAAoB;QAC7B,sDAAsD;QACtD,6CAA6C;QAC7C,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,OAAO;QACN,IAAI,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;CACD"}
+{"version":3,"file":"solid-router-bridge.js","sourceRoot":"","sources":["../src/solid-router-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IAepC;IACA;IAfV,oBAAoB,GAAwB,IAAI,CAAC;IAEzD;;;;;;;;;;OAUG;IACH,YACkB,aAA4D,EAC5D,QAA8C,EAC/D,OAA2C,EAC3C,KAA8C,EAC9C,QAAkB;QAElB,KAAK,CAAC,KAAK,EAAE;YACZ,gBAAgB,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC;YACnE,gBAAgB,EAAE,CAAC,EAAU,EAAE,EAAE,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;SAC/D,CAAC,CAAC;QATc,kBAAa,GAAb,aAAa,CAA+C;QAC5D,aAAQ,GAAR,QAAQ,CAAsC;IAShE,CAAC;IAED;;OAEG;IACO,cAAc,CAAC,IAAY;QACpC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACgB,oBAAoB;QACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,IAAI,IAAI,CAAC;IACvC,CAAC;IAED;;;;;OAKG;IACO,kBAAkB;QAC3B,IAAI,CAAC,oBAAoB,GAAG,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE;YAClD,YAAY,CACX,EAAE,CACD,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAC5B,CAAC,QAAgB,EAAE,EAAE;gBACpB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC1C,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC,CACD,CACD,CAAC;YACF,OAAO,OAAO,CAAC;QAChB,CAAC,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACO,oBAAoB;QAC7B,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC9B,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAClC,CAAC;IAED;;;;;;;OAOG;IACH,OAAO;QACN,IAAI,CAAC,UAAU,EAAE,CAAC;IACnB,CAAC;CACD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-solid-router",
-  "version": "1.0.0-beta.2",
+  "version": "1.0.0-beta.20",
   "description": "SolidJS Router adapter for XMachines Universal Player Architecture",
   "license": "MIT",
   "author": "XMachines Contributors",
@@ -19,34 +19,40 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "tsc --build",
-    "test": "vitest run",
+    "test": "vitest",
     "test:watch": "vitest",
-    "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist *.tsbuildinfo",
+    "clean": "rm -rf dist *.tsbuildinfo coverage",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@xmachines/play": "1.0.0-beta.2",
-    "@xmachines/play-actor": "1.0.0-beta.2",
-    "@xmachines/play-router": "1.0.0-beta.2",
-    "@xmachines/play-signals": "1.0.0-beta.2"
+    "@xmachines/play": "1.0.0-beta.20",
+    "@xmachines/play-actor": "1.0.0-beta.20",
+    "@xmachines/play-router": "1.0.0-beta.20",
+    "@xmachines/play-signals": "1.0.0-beta.20"
   },
   "devDependencies": {
-    "@solidjs/router": "^0.15.4",
-    "@solidjs/testing-library": "^0.8.0",
-    "solid-js": "^1.8.0"
+    "@solidjs/router": "^0.16.1",
+    "@solidjs/testing-library": "^0.8.10",
+    "@xmachines/play-xstate": "1.0.0-beta.20",
+    "@xmachines/shared": "1.0.0-beta.20",
+    "jsdom": "^29.0.1",
+    "solid-js": "^1.9.12",
+    "vite-plugin-solid": "^2.11.11",
+    "vitest": "^4.1.2",
+    "xstate": "^5.30.0"
   },
   "peerDependencies": {
-    "@solidjs/router": "^0.15.4",
+    "@solidjs/router": "^0.16.1",
     "solid-js": "^1.8.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }