@xmachines/play-solid-router 1.0.0-beta.1 → 1.0.0-beta.11

package/README.md

@@ -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
 
@@ -142,35 +142,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 +182,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
@@ -479,7 +484,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 +608,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 +635,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/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

@@ -55,7 +55,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 +63,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 +78,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;IAarD,OAAO,CAAC,QAAQ,CAAC,aAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAb1B;;;;;;;;;;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;IAcpC;;;;OAIG;IACH,SAAS,CAAC,oBAAoB,IAAI,IAAI;IAItC;;;;;;;OAOG;IACH,OAAO,IAAI,IAAI;CAGf"}

package/dist/solid-router-bridge.js

@@ -56,7 +56,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 +67,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.
      *
@@ -85,12 +91,9 @@ export 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.
      */
     unwatchRouterChanges() {
-        // Solid auto-cleans createEffect on component unmount
-        // Set flag to prevent any pending operations
-        this.isProcessingNavigation = true;
+        // Solid auto-cleans createEffect on component unmount.
     }
     /**
      * 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,EAAE,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAK1D;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,gBAAgB;IAapC;IACA;IAblB;;;;;;;;;;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,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;;;;OAIG;IACO,oBAAoB;QAC7B,uDAAuD;IACxD,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.1",
+  "version": "1.0.0-beta.11",
   "description": "SolidJS Router adapter for XMachines Universal Player Architecture",
   "license": "MIT",
   "author": "XMachines Contributors",
@@ -11,7 +11,8 @@
   },
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "type": "module",
   "main": "./dist/index.js",
@@ -22,30 +23,35 @@
       "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 node_modules/.vite node_modules/.vite-temp",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@xmachines/play": "1.0.0-beta.1",
-    "@xmachines/play-actor": "1.0.0-beta.1",
-    "@xmachines/play-router": "1.0.0-beta.1",
-    "@xmachines/play-signals": "1.0.0-beta.1"
+    "@xmachines/play": "1.0.0-beta.11",
+    "@xmachines/play-actor": "1.0.0-beta.11",
+    "@xmachines/play-router": "1.0.0-beta.11",
+    "@xmachines/play-signals": "1.0.0-beta.11"
   },
   "devDependencies": {
-    "@solidjs/router": "^0.15.4",
-    "@solidjs/testing-library": "^0.8.0",
-    "solid-js": "^1.8.0"
+    "@solidjs/router": "^0.13.0",
+    "@solidjs/testing-library": "^0.8.10",
+    "@xmachines/shared": "1.0.0-beta.11",
+    "jsdom": "^29.0.1",
+    "solid-js": "^1.9.11",
+    "vite-plugin-solid": "^2.11.11",
+    "vitest": "^4.1.0",
+    "xstate": "^5.28.0"
   },
   "peerDependencies": {
-    "@solidjs/router": "^0.15.4",
+    "@solidjs/router": "^0.13.0",
     "solid-js": "^1.8.0"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }