@xmachines/play-router 1.0.0-beta.43 → 1.0.0-beta.44

package/README.md

@@ -124,7 +124,7 @@ Open http://localhost:5174/ and explore:
 ```typescript
 // Extract routes from machine
 const routeTree = extractMachineRoutes(authMachine);
-const routeMatcher = createRouteMap(routeTree);
+const routeMatcher = createRouteMatcher(routeTree);
 
 // Actor → URL sync
 const watcher = new Signal.subtle.Watcher(() => {
@@ -195,7 +195,7 @@ That final step distinguishes:
 - **deep-link:** browser URL differs from the machine's initial route, so router wins and the actor receives `play.route`
 - **restore:** browser URL is still at the machine's initial route while the actor was restored elsewhere, so actor wins and the bridge pushes the actor route back into the router
 
-Actor-originated router sync also keeps `isProcessingNavigation` set until the next microtask. That short window intentionally suppresses synchronous router callbacks that echo the same navigation back into the actor.
+Actor-originated router sync suppresses router echoes via `lastSyncedPath`. `syncRouterFromActor` resolves the concrete path and stores it before calling the adapter's navigation method; when the router callback fires with that same path, `syncActorFromRouter` short-circuits at `sanitized === lastSyncedPath` and sends no event.
 
 ## Diagnostics
 
@@ -291,14 +291,14 @@ const successors = getSuccessors(tree.graph!, "myMachine.home");
 - `eventType: string` — event type triggering this transition
 - `guardType?: string` — guard name/description (if transition is guarded)
 
-### createRouteMapFromMachine() / createRouteMapFromTree()
+### createRouteMap() / createRouteMapFromTree()
 
 Both build a `BaseRouteMap` using `node.fullPath` (absolute resolved paths) for browser URL matching.
 
 ```typescript
 // Single-call form — preferred for XState machines:
-import { createRouteMapFromMachine } from "@xmachines/play-router";
-const routeMap = createRouteMapFromMachine(machine);
+import { createRouteMap } from "@xmachines/play-router";
+const routeMap = createRouteMap(machine);
 
 // Two-step form — used by framework adapter packages:
 import { extractMachineRoutes, createRouteMapFromTree } from "@xmachines/play-router";
@@ -306,7 +306,7 @@ const routeTree = extractMachineRoutes(machine);
 const routeMap = createRouteMapFromTree(routeTree);
 ```
 
-Both forms produce identical results. `createRouteMapFromTree` is exposed for framework adapters (React Router, TanStack Router) that need to hold the `RouteTree` separately for other purposes (e.g. graph queries).
+Both forms produce identical `RouteMap` results. `createRouteMapFromTree` is exposed for framework adapters (React Router, TanStack Router) that already hold the `RouteTree` separately for other purposes (e.g. graph queries). `createRouteMatcher(routeTree)` is the distinct API for URL-pattern matching that returns a `RouteMatcher`, not a `RouteMap`.
 
 **`node.path` vs `node.fullPath`:** Every `RouteNode` carries both fields. `path` is the raw `meta.route` segment as declared in the machine — it may be relative (e.g. `"overview"`). `fullPath` is the resolved absolute path (e.g. `"/dashboard/overview"`). Route maps always use `fullPath`. Only use `path` if you specifically need the declared segment.
 

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

@@ -6,7 +6,7 @@
  *
  * Algorithm: O(1) exact match via Map, then bucket-based O(k) pattern match
  * where k = routes in the first-segment bucket (typically << total routes).
- * Uses URLPattern for parameterized route matching (same engine as createRouteMap).
+ * Uses URLPattern for parameterized route matching (same engine as createRouteMatcher).
  */
 /**
  * A single state ID ↔ path mapping entry.

package/dist/base-route-map.js

@@ -6,7 +6,7 @@
  *
  * Algorithm: O(1) exact match via Map, then bucket-based O(k) pattern match
  * where k = routes in the first-segment bucket (typically << total routes).
- * Uses URLPattern for parameterized route matching (same engine as createRouteMap).
+ * Uses URLPattern for parameterized route matching (same engine as createRouteMatcher).
  */
 import QuickLRU from "quick-lru";
 import { getURLPatternCtor, getIndexKey, getCandidates, } from "./url-pattern-utils.js";

package/dist/create-route-map-from-tree.d.ts

@@ -1,31 +1,33 @@
 import type { RouteTree } from "./types.js";
 import { RouteMap } from "./base-route-map.js";
+import type { RouteMapOptions } from "./create-route-map.js";
 /**
  * Create a `RouteMap` from a `RouteTree` node structure.
  *
  * Used by framework-router adapters (React Router, TanStack Router) that pass a
  * `RouteTree` produced by `extractMachineRoutes()` rather than calling
- * `createRouteMapFromMachine()` directly.
+ * `createRouteMap()` directly.
  *
  * Traverses all nodes collecting `{ stateId: node.id, path: node.fullPath }` pairs.
  * `node.fullPath` is always the absolute resolved path (e.g. `"/dashboard/overview"`),
  * which is what `RouteMap` needs for browser URL matching. This matches the
- * behaviour of `createRouteMapFromMachine`, which also uses `node.fullPath`.
+ * behaviour of `createRouteMap(machine)`, which also uses `node.fullPath`.
  *
  * @param routeTree - A `RouteTree` as returned by `extractMachineRoutes()`.
+ * @param options - Optional configuration (e.g. `{ cacheSize }` to override the LRU cache size).
  * @returns A `RouteMap` for use with any `RouterBridgeBase`-based adapter.
  *
  * @example
  * ```typescript
  * // Preferred — single call for XState machines:
- * import { createRouteMapFromMachine } from '@xmachines/play-router';
- * const routeMap = createRouteMapFromMachine(machine);
+ * import { createRouteMap } from '@xmachines/play-router';
+ * const routeMap = createRouteMap(machine); // takes AnyStateMachine
  *
- * // Equivalent two-step form used by framework adapters:
+ * // Two-step form used by framework adapters that work with route trees:
  * import { extractMachineRoutes, createRouteMapFromTree } from '@xmachines/play-router';
  * const routeTree = extractMachineRoutes(machine);
  * const routeMap = createRouteMapFromTree(routeTree); // uses node.fullPath (absolute)
  * ```
  */
-export declare function createRouteMapFromTree(routeTree: RouteTree): RouteMap;
+export declare function createRouteMapFromTree(routeTree: RouteTree, options?: RouteMapOptions): RouteMap;
 //# sourceMappingURL=create-route-map-from-tree.d.ts.map

package/dist/create-route-map-from-tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create-route-map-from-tree.d.ts","sourceRoot":"","sources":["../src/create-route-map-from-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,GAAG,QAAQ,CAcrE"}
+{"version":3,"file":"create-route-map-from-tree.d.ts","sourceRoot":"","sources":["../src/create-route-map-from-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAchG"}

package/dist/create-route-map-from-tree.js

@@ -4,29 +4,30 @@ import { RouteMap } from "./base-route-map.js";
  *
  * Used by framework-router adapters (React Router, TanStack Router) that pass a
  * `RouteTree` produced by `extractMachineRoutes()` rather than calling
- * `createRouteMapFromMachine()` directly.
+ * `createRouteMap()` directly.
  *
  * Traverses all nodes collecting `{ stateId: node.id, path: node.fullPath }` pairs.
  * `node.fullPath` is always the absolute resolved path (e.g. `"/dashboard/overview"`),
  * which is what `RouteMap` needs for browser URL matching. This matches the
- * behaviour of `createRouteMapFromMachine`, which also uses `node.fullPath`.
+ * behaviour of `createRouteMap(machine)`, which also uses `node.fullPath`.
  *
  * @param routeTree - A `RouteTree` as returned by `extractMachineRoutes()`.
+ * @param options - Optional configuration (e.g. `{ cacheSize }` to override the LRU cache size).
  * @returns A `RouteMap` for use with any `RouterBridgeBase`-based adapter.
  *
  * @example
  * ```typescript
  * // Preferred — single call for XState machines:
- * import { createRouteMapFromMachine } from '@xmachines/play-router';
- * const routeMap = createRouteMapFromMachine(machine);
+ * import { createRouteMap } from '@xmachines/play-router';
+ * const routeMap = createRouteMap(machine); // takes AnyStateMachine
  *
- * // Equivalent two-step form used by framework adapters:
+ * // Two-step form used by framework adapters that work with route trees:
  * import { extractMachineRoutes, createRouteMapFromTree } from '@xmachines/play-router';
  * const routeTree = extractMachineRoutes(machine);
  * const routeMap = createRouteMapFromTree(routeTree); // uses node.fullPath (absolute)
  * ```
  */
-export function createRouteMapFromTree(routeTree) {
+export function createRouteMapFromTree(routeTree, options) {
     const routes = [];
     function traverse(node) {
         if (node.id && node.fullPath) {
@@ -37,6 +38,6 @@ export function createRouteMapFromTree(routeTree) {
         }
     }
     traverse(routeTree.root);
-    return new RouteMap(routes);
+    return new RouteMap(routes, options);
 }
 //# sourceMappingURL=create-route-map-from-tree.js.map

package/dist/create-route-map-from-tree.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-route-map-from-tree.js","sourceRoot":"","sources":["../src/create-route-map-from-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAoB;IAC1D,MAAM,MAAM,GAA6C,EAAE,CAAC;IAE5D,SAAS,QAAQ,CAAC,IAAe;QAChC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;IAED,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"create-route-map-from-tree.js","sourceRoot":"","sources":["../src/create-route-map-from-tree.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAG/C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,sBAAsB,CAAC,SAAoB,EAAE,OAAyB;IACrF,MAAM,MAAM,GAA6C,EAAE,CAAC;IAE5D,SAAS,QAAQ,CAAC,IAAe;QAChC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;IAED,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACtC,CAAC"}

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

@@ -1,66 +1,42 @@
-import type { RouteTree } from "./types.js";
+import type { AnyStateMachine } from "xstate";
+import { RouteMap } from "./base-route-map.js";
 /**
- * URL route matcher interface returned by `createRouteMap()`.
- *
- * Matches incoming URL paths to state IDs (with `#` prefix) and extracts
- * route parameters. Used by `RouterBridgeBase` to translate router navigation
- * events into `play.route` actor events.
- *
- * @see {@link createRouteMap} for the factory function
- * @see {@link RouteMap} for direct state ID ↔ path lookups without params extraction
+ * Options for `createRouteMap` and `createRouteMapFromTree`.
  */
-export interface RouteMatcher {
+export interface RouteMapOptions {
     /**
-     * Match a URL path to a state ID and params.
-     *
-     * @param path - URL pathname (e.g., "/settings/account")
-     * @returns Object with `to` (state ID with # prefix) and `params`
+     * Maximum number of resolved parameterized path lookups to cache.
      *
-     * Example:
-     * ```typescript
-     * const { to, params } = routeMatcher.match('/settings/account');
-     * // { to: "#settings", params: { section: "account" } }
+     * `RouteMap.getStateIdByPath()` resolves parameterized patterns (e.g.
+     * `/profile/:userId`) via URLPattern on every call. Frequently visited
+     * paths are cached in an LRU so subsequent lookups are O(1).
      *
-     * if (to) {
-     *   actor.send({ type: 'play.route', to, params });
-     * }
-     * ```
+     * Increase this value for applications with large parameterized route sets
+     * or high navigation frequency. Default: `500`.
      */
-    match(path: string): {
-        to: string | null;
-        params: Record<string, string>;
-    };
+    cacheSize?: number;
 }
 /**
- * Create a route matcher from a RouteTree for efficient path lookups.
+ * Create a `RouteMap` from an XState state machine.
  *
- * Architecture:
- * - Pure function - no side effects
- * - O(1) lookups for exact matches via Map
- * - O(k) bucket-indexed pattern matching with URLPattern, where k = routes in the
- *   first-segment bucket (typically << total routes)
- * - Returns formatted state IDs (with # prefix)
- * - Extracts params from matched patterns
+ * Extracts all routable states (those with `meta.route`) and builds a bidirectional
+ * path ↔ stateId lookup structure. The returned map is used by `RouterBridgeBase`
+ * subclasses to translate browser URL changes into `play.route` actor events and
+ * vice-versa.
  *
- * **URLPattern requirement:** Dynamic route pattern matching requires `URLPattern`
- * to be available on `globalThis`. On Node.js < 24 and older browsers, load a polyfill
- * before calling this function:
- * ```typescript
- * import "urlpattern-polyfill"; // before importing @xmachines/play-router
- * ```
- * If `URLPattern` is unavailable, a `URLPatternUnavailableError` is thrown.
- * Static (exact) routes are unaffected by URLPattern availability.
+ * @param machine - XState v5 state machine with `meta.route` annotations on states.
+ * @param options - Optional configuration. Pass `{ cacheSize }` to override the
+ *   default LRU cache size for parameterized path lookups.
+ * @returns A `RouteMap` for passing to any `RouterBridgeBase`-based adapter.
  *
- * Usage:
+ * @example
  * ```typescript
- * const routeTree = extractMachineRoutes(machine);
- * const routeMatcher = createRouteMap(routeTree);
+ * import { createRouteMap } from '@xmachines/play-router';
+ * import { connectRouter } from '@xmachines/play-dom-router';
  *
- * const { to, params } = routeMatcher.match('/settings/account');
- * if (to) {
- *   actor.send({ type: 'play.route', to, params });
- * }
+ * const routeMap = createRouteMap(myMachine);
+ * const disconnect = connectRouter({ actor, router, routeMap });
  * ```
  */
-export declare function createRouteMap(routeTree: RouteTree): RouteMatcher;
+export declare function createRouteMap(machine: AnyStateMachine, options?: RouteMapOptions): RouteMap;
 //# sourceMappingURL=create-route-map.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"create-route-map.d.ts","sourceRoot":"","sources":["../src/create-route-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AASvD;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CAuDjE"}
+{"version":3,"file":"create-route-map.d.ts","sourceRoot":"","sources":["../src/create-route-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;;;;;;;;OASG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,QAAQ,CAU5F"}

package/dist/create-route-map.js

@@ -1,83 +1,34 @@
-import { URLPatternUnavailableError, InvalidRoutePatternError } from "./errors.js";
-import { getURLPatternCtor, getIndexKey, getCandidates, } from "./url-pattern-utils.js";
+import { extractMachineRoutes } from "./extract-routes.js";
+import { getRoutableRoutes } from "./query.js";
+import { RouteMap } from "./base-route-map.js";
 /**
- * Create a route matcher from a RouteTree for efficient path lookups.
+ * Create a `RouteMap` from an XState state machine.
  *
- * Architecture:
- * - Pure function - no side effects
- * - O(1) lookups for exact matches via Map
- * - O(k) bucket-indexed pattern matching with URLPattern, where k = routes in the
- *   first-segment bucket (typically << total routes)
- * - Returns formatted state IDs (with # prefix)
- * - Extracts params from matched patterns
+ * Extracts all routable states (those with `meta.route`) and builds a bidirectional
+ * path ↔ stateId lookup structure. The returned map is used by `RouterBridgeBase`
+ * subclasses to translate browser URL changes into `play.route` actor events and
+ * vice-versa.
  *
- * **URLPattern requirement:** Dynamic route pattern matching requires `URLPattern`
- * to be available on `globalThis`. On Node.js < 24 and older browsers, load a polyfill
- * before calling this function:
- * ```typescript
- * import "urlpattern-polyfill"; // before importing @xmachines/play-router
- * ```
- * If `URLPattern` is unavailable, a `URLPatternUnavailableError` is thrown.
- * Static (exact) routes are unaffected by URLPattern availability.
+ * @param machine - XState v5 state machine with `meta.route` annotations on states.
+ * @param options - Optional configuration. Pass `{ cacheSize }` to override the
+ *   default LRU cache size for parameterized path lookups.
+ * @returns A `RouteMap` for passing to any `RouterBridgeBase`-based adapter.
  *
- * Usage:
+ * @example
  * ```typescript
- * const routeTree = extractMachineRoutes(machine);
- * const routeMatcher = createRouteMap(routeTree);
+ * import { createRouteMap } from '@xmachines/play-router';
+ * import { connectRouter } from '@xmachines/play-dom-router';
  *
- * const { to, params } = routeMatcher.match('/settings/account');
- * if (to) {
- *   actor.send({ type: 'play.route', to, params });
- * }
+ * const routeMap = createRouteMap(myMachine);
+ * const disconnect = connectRouter({ actor, router, routeMap });
  * ```
  */
-export function createRouteMap(routeTree) {
-    // Build bucket-indexed pattern matchers for routes with dynamic segments
-    const patternBuckets = new Map();
-    let patternOrder = 0;
-    const URLPatternCtor = getURLPatternCtor();
-    function collectPatterns(node) {
-        if (node.routable && node.pattern) {
-            if (!URLPatternCtor) {
-                throw new URLPatternUnavailableError();
-            }
-            try {
-                const urlPattern = new URLPatternCtor({ pathname: node.pattern });
-                const bucketKey = getIndexKey(node.pattern);
-                const bucket = patternBuckets.get(bucketKey) ?? [];
-                bucket.push({ pattern: urlPattern, node, order: patternOrder++ });
-                patternBuckets.set(bucketKey, bucket);
-            }
-            catch (err) {
-                throw new InvalidRoutePatternError(node.pattern, { cause: err });
-            }
-        }
-        for (const child of node.children) {
-            collectPatterns(child);
-        }
-    }
-    collectPatterns(routeTree.root);
-    return {
-        match(path) {
-            // O(1) exact match via routeTree.byPath Map (unchanged)
-            const exactMatch = routeTree.byPath.get(path);
-            if (exactMatch?.routable) {
-                return { to: `#${exactMatch.id}`, params: {} };
-            }
-            // Bucket-indexed pattern match: only scan candidates for this path's first segment
-            const candidates = getCandidates(patternBuckets, getIndexKey(path));
-            for (const { pattern, node } of candidates) {
-                const match = pattern.exec({ pathname: path });
-                if (match) {
-                    const params = {};
-                    if (match.pathname.groups) {
-                        Object.assign(params, match.pathname.groups);
-                    }
-                    return { to: `#${node.id}`, params };
-                }
-            }
-            return { to: null, params: {} };
-        },
-    };
+export function createRouteMap(machine, options) {
+    const routeTree = extractMachineRoutes(machine);
+    const routes = getRoutableRoutes(routeTree);
+    return new RouteMap(routes.map((node) => ({
+        stateId: node.stateId,
+        path: node.fullPath,
+    })), options);
 }
 //# sourceMappingURL=create-route-map.js.map

package/dist/create-route-map.js.map

@@ -1 +1 @@
-{"version":3,"file":"create-route-map.js","sourceRoot":"","sources":["../src/create-route-map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAEN,iBAAiB,EACjB,WAAW,EACX,aAAa,GACb,MAAM,wBAAwB,CAAC;AAmChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,cAAc,CAAC,SAAoB;IAClD,yEAAyE;IACzE,MAAM,cAAc,GAAG,IAAI,GAAG,EAG3B,CAAC;IACJ,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,SAAS,eAAe,CAAC,IAAe;QACvC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,MAAM,IAAI,0BAA0B,EAAE,CAAC;YACxC,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;gBAClE,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,CAAC;QACF,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,eAAe,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACF,CAAC;IAED,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhC,OAAO;QACN,KAAK,CAAC,IAAY;YACjB,wDAAwD;YACxD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,UAAU,EAAE,QAAQ,EAAE,CAAC;gBAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAChD,CAAC;YAED,mFAAmF;YACnF,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YACpE,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,MAAM,GAA2B,EAAE,CAAC;oBAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;wBAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC9C,CAAC;oBACD,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;gBACtC,CAAC;YACF,CAAC;YAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACjC,CAAC;KACD,CAAC;AACH,CAAC"}
+{"version":3,"file":"create-route-map.js","sourceRoot":"","sources":["../src/create-route-map.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAmB/C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,cAAc,CAAC,OAAwB,EAAE,OAAyB;IACjF,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,IAAI,QAAQ,CAClB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,QAAQ;KACnB,CAAC,CAAC,EACH,OAAO,CACP,CAAC;AACH,CAAC"}

package/dist/create-route-matcher.d.ts

@@ -0,0 +1,66 @@
+import type { RouteTree } from "./types.js";
+/**
+ * URL route matcher interface returned by `createRouteMatcher()`.
+ *
+ * Matches incoming URL paths to state IDs (with `#` prefix) and extracts
+ * route parameters. Used by `RouterBridgeBase` to translate router navigation
+ * events into `play.route` actor events.
+ *
+ * @see {@link createRouteMatcher} for the factory function
+ * @see {@link RouteMap} for direct state ID ↔ path lookups without params extraction
+ */
+export interface RouteMatcher {
+    /**
+     * Match a URL path to a state ID and params.
+     *
+     * @param path - URL pathname (e.g., "/settings/account")
+     * @returns Object with `to` (state ID with # prefix) and `params`
+     *
+     * Example:
+     * ```typescript
+     * const { to, params } = routeMatcher.match('/settings/account');
+     * // { to: "#settings", params: { section: "account" } }
+     *
+     * if (to) {
+     *   actor.send({ type: 'play.route', to, params });
+     * }
+     * ```
+     */
+    match(path: string): {
+        to: string | null;
+        params: Record<string, string>;
+    };
+}
+/**
+ * Create a URL pattern matcher from a RouteTree for efficient path lookups.
+ *
+ * Architecture:
+ * - Pure function - no side effects
+ * - O(1) lookups for exact matches via Map
+ * - O(k) bucket-indexed pattern matching with URLPattern, where k = routes in the
+ *   first-segment bucket (typically << total routes)
+ * - Returns formatted state IDs (with # prefix)
+ * - Extracts params from matched patterns
+ *
+ * **URLPattern requirement:** Dynamic route pattern matching requires `URLPattern`
+ * to be available on `globalThis`. On Node.js < 24 and older browsers, load a polyfill
+ * before calling this function:
+ * ```typescript
+ * import "urlpattern-polyfill"; // before importing @xmachines/play-router
+ * ```
+ * If `URLPattern` is unavailable, a `URLPatternUnavailableError` is thrown.
+ * Static (exact) routes are unaffected by URLPattern availability.
+ *
+ * Usage:
+ * ```typescript
+ * const routeTree = extractMachineRoutes(machine);
+ * const routeMatcher = createRouteMatcher(routeTree);
+ *
+ * const { to, params } = routeMatcher.match('/settings/account');
+ * if (to) {
+ *   actor.send({ type: 'play.route', to, params });
+ * }
+ * ```
+ */
+export declare function createRouteMatcher(routeTree: RouteTree): RouteMatcher;
+//# sourceMappingURL=create-route-matcher.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-route-matcher.d.ts","sourceRoot":"","sources":["../src/create-route-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAa,MAAM,YAAY,CAAC;AASvD;;;;;;;;;GASG;AACH,MAAM,WAAW,YAAY;IAC5B;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG;QACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,YAAY,CAuDrE"}

package/dist/create-route-matcher.js

@@ -0,0 +1,83 @@
+import { URLPatternUnavailableError, InvalidRoutePatternError } from "./errors.js";
+import { getURLPatternCtor, getIndexKey, getCandidates, } from "./url-pattern-utils.js";
+/**
+ * Create a URL pattern matcher from a RouteTree for efficient path lookups.
+ *
+ * Architecture:
+ * - Pure function - no side effects
+ * - O(1) lookups for exact matches via Map
+ * - O(k) bucket-indexed pattern matching with URLPattern, where k = routes in the
+ *   first-segment bucket (typically << total routes)
+ * - Returns formatted state IDs (with # prefix)
+ * - Extracts params from matched patterns
+ *
+ * **URLPattern requirement:** Dynamic route pattern matching requires `URLPattern`
+ * to be available on `globalThis`. On Node.js < 24 and older browsers, load a polyfill
+ * before calling this function:
+ * ```typescript
+ * import "urlpattern-polyfill"; // before importing @xmachines/play-router
+ * ```
+ * If `URLPattern` is unavailable, a `URLPatternUnavailableError` is thrown.
+ * Static (exact) routes are unaffected by URLPattern availability.
+ *
+ * Usage:
+ * ```typescript
+ * const routeTree = extractMachineRoutes(machine);
+ * const routeMatcher = createRouteMatcher(routeTree);
+ *
+ * const { to, params } = routeMatcher.match('/settings/account');
+ * if (to) {
+ *   actor.send({ type: 'play.route', to, params });
+ * }
+ * ```
+ */
+export function createRouteMatcher(routeTree) {
+    // Build bucket-indexed pattern matchers for routes with dynamic segments
+    const patternBuckets = new Map();
+    let patternOrder = 0;
+    const URLPatternCtor = getURLPatternCtor();
+    function collectPatterns(node) {
+        if (node.routable && node.pattern) {
+            if (!URLPatternCtor) {
+                throw new URLPatternUnavailableError();
+            }
+            try {
+                const urlPattern = new URLPatternCtor({ pathname: node.pattern });
+                const bucketKey = getIndexKey(node.pattern);
+                const bucket = patternBuckets.get(bucketKey) ?? [];
+                bucket.push({ pattern: urlPattern, node, order: patternOrder++ });
+                patternBuckets.set(bucketKey, bucket);
+            }
+            catch (err) {
+                throw new InvalidRoutePatternError(node.pattern, { cause: err });
+            }
+        }
+        for (const child of node.children) {
+            collectPatterns(child);
+        }
+    }
+    collectPatterns(routeTree.root);
+    return {
+        match(path) {
+            // O(1) exact match via routeTree.byPath Map (unchanged)
+            const exactMatch = routeTree.byPath.get(path);
+            if (exactMatch?.routable) {
+                return { to: `#${exactMatch.id}`, params: {} };
+            }
+            // Bucket-indexed pattern match: only scan candidates for this path's first segment
+            const candidates = getCandidates(patternBuckets, getIndexKey(path));
+            for (const { pattern, node } of candidates) {
+                const match = pattern.exec({ pathname: path });
+                if (match) {
+                    const params = {};
+                    if (match.pathname.groups) {
+                        Object.assign(params, match.pathname.groups);
+                    }
+                    return { to: `#${node.id}`, params };
+                }
+            }
+            return { to: null, params: {} };
+        },
+    };
+}
+//# sourceMappingURL=create-route-matcher.js.map

package/dist/create-route-matcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-route-matcher.js","sourceRoot":"","sources":["../src/create-route-matcher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAEN,iBAAiB,EACjB,WAAW,EACX,aAAa,GACb,MAAM,wBAAwB,CAAC;AAmChC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACtD,yEAAyE;IACzE,MAAM,cAAc,GAAG,IAAI,GAAG,EAG3B,CAAC;IACJ,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,SAAS,eAAe,CAAC,IAAe;QACvC,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACnC,IAAI,CAAC,cAAc,EAAE,CAAC;gBACrB,MAAM,IAAI,0BAA0B,EAAE,CAAC;YACxC,CAAC;YACD,IAAI,CAAC;gBACJ,MAAM,UAAU,GAAG,IAAI,cAAc,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;gBAClE,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAC5C,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,CAAC,CAAC;gBAClE,cAAc,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YACvC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACd,MAAM,IAAI,wBAAwB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;YAClE,CAAC;QACF,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnC,eAAe,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACF,CAAC;IAED,eAAe,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhC,OAAO;QACN,KAAK,CAAC,IAAY;YACjB,wDAAwD;YACxD,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,UAAU,EAAE,QAAQ,EAAE,CAAC;gBAC1B,OAAO,EAAE,EAAE,EAAE,IAAI,UAAU,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YAChD,CAAC;YAED,mFAAmF;YACnF,MAAM,UAAU,GAAG,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;YACpE,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,UAAU,EAAE,CAAC;gBAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC/C,IAAI,KAAK,EAAE,CAAC;oBACX,MAAM,MAAM,GAA2B,EAAE,CAAC;oBAC1C,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;wBAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;oBAC9C,CAAC;oBACD,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;gBACtC,CAAC;YACF,CAAC;YAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACjC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -24,7 +24,38 @@ export declare class RouterSyncError extends PlayError {
     constructor(message: string, options?: ErrorOptions);
 }
 /**
- * Thrown by `createRouteMap()` when the `URLPattern` API is not available in the
+ * Thrown by `RouterBridgeBase.connect()` when a second bridge tries to connect
+ * to an actor that already has an active bridge connection.
+ *
+ * One actor may only be connected to one router bridge at a time. Two bridges
+ * sharing the same actor would both receive and process every router navigation
+ * event, sending duplicate `play.route` events to the actor and producing
+ * conflicting echo-suppression state via `lastSyncedPath`.
+ *
+ * **How to fix:** Call `bridge.disconnect()` on the first bridge before
+ * connecting a second one, or ensure only one `connectRouter()` call is active
+ * per actor at any given time.
+ *
+ * **Error code:** `PLAY_ROUTER_DUPLICATE_BRIDGE`
+ *
+ * @example
+ * ```typescript
+ * import { DuplicateBridgeError } from "@xmachines/play-router/errors";
+ *
+ * try {
+ *   bridge.connect();
+ * } catch (err) {
+ *   if (err instanceof DuplicateBridgeError) {
+ *     console.error("Actor already has an active router bridge — disconnect first.");
+ *   }
+ * }
+ * ```
+ */
+export declare class DuplicateBridgeError extends PlayError {
+    constructor();
+}
+/**
+ * Thrown by `createRouteMatcher()` when the `URLPattern` API is not available in the
  * current runtime environment and no polyfill has been loaded.
  *
  * **How to fix:** Load `urlpattern-polyfill` at your application entry point, before
@@ -44,7 +75,7 @@ export declare class URLPatternUnavailableError extends PlayError {
     constructor();
 }
 /**
- * Thrown by `createRouteMap()` when a route pattern string cannot be compiled by
+ * Thrown by `createRouteMatcher()` when a route pattern string cannot be compiled by
  * `URLPattern`. The `pattern` field contains the rejected string; `cause` wraps the
  * original `URLPattern` constructor error.
  *
@@ -59,7 +90,7 @@ export declare class URLPatternUnavailableError extends PlayError {
  * import { InvalidRoutePatternError } from "@xmachines/play-router/errors";
  *
  * try {
- *   const routeMatcher = createRouteMap(tree);
+ *   const routeMatcher = createRouteMatcher(tree);
  * } catch (err) {
  *   if (err instanceof InvalidRoutePatternError) {
  *     console.error(`Bad route pattern: "${err.pattern}"`, err.cause);

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAInD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;;CASxD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IACjD,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;CAS3B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IACjD,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;CAS3B;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IACrD,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE;CAWhC;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;IACnD,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE;CAWnE;AAED,qBAAa,wBAAyB,SAAQ,SAAS;IACtD,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAUnD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,SAAS;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAInD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,oBAAqB,SAAQ,SAAS;;CAUlD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;;CASxD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IACjD,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;CAS3B;AAED;;;;;GAKG;AACH,qBAAa,mBAAoB,SAAQ,SAAS;IACjD,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM;CAS3B;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,SAAS;IACrD,mEAAmE;IACnE,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;gBAElB,UAAU,EAAE,MAAM,EAAE;CAWhC;AAED;;;;;GAKG;AACH,qBAAa,qBAAsB,SAAQ,SAAS;IACnD,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE;CAWnE;AAED,qBAAa,wBAAyB,SAAQ,SAAS;IACtD,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAUnD"}

package/dist/errors.js

@@ -27,7 +27,42 @@ export class RouterSyncError extends PlayError {
     }
 }
 /**
- * Thrown by `createRouteMap()` when the `URLPattern` API is not available in the
+ * Thrown by `RouterBridgeBase.connect()` when a second bridge tries to connect
+ * to an actor that already has an active bridge connection.
+ *
+ * One actor may only be connected to one router bridge at a time. Two bridges
+ * sharing the same actor would both receive and process every router navigation
+ * event, sending duplicate `play.route` events to the actor and producing
+ * conflicting echo-suppression state via `lastSyncedPath`.
+ *
+ * **How to fix:** Call `bridge.disconnect()` on the first bridge before
+ * connecting a second one, or ensure only one `connectRouter()` call is active
+ * per actor at any given time.
+ *
+ * **Error code:** `PLAY_ROUTER_DUPLICATE_BRIDGE`
+ *
+ * @example
+ * ```typescript
+ * import { DuplicateBridgeError } from "@xmachines/play-router/errors";
+ *
+ * try {
+ *   bridge.connect();
+ * } catch (err) {
+ *   if (err instanceof DuplicateBridgeError) {
+ *     console.error("Actor already has an active router bridge — disconnect first.");
+ *   }
+ * }
+ * ```
+ */
+export class DuplicateBridgeError extends PlayError {
+    constructor() {
+        super("RouterBridgeBase", "PLAY_ROUTER_DUPLICATE_BRIDGE", "An actor can only be connected to one router bridge at a time. " +
+            "Call disconnect() on the existing bridge before connecting a new one.");
+        this.name = "DuplicateBridgeError";
+    }
+}
+/**
+ * Thrown by `createRouteMatcher()` when the `URLPattern` API is not available in the
  * current runtime environment and no polyfill has been loaded.
  *
  * **How to fix:** Load `urlpattern-polyfill` at your application entry point, before
@@ -50,7 +85,7 @@ export class URLPatternUnavailableError extends PlayError {
     }
 }
 /**
- * Thrown by `createRouteMap()` when a route pattern string cannot be compiled by
+ * Thrown by `createRouteMatcher()` when a route pattern string cannot be compiled by
  * `URLPattern`. The `pattern` field contains the rejected string; `cause` wraps the
  * original `URLPattern` constructor error.
  *
@@ -65,7 +100,7 @@ export class URLPatternUnavailableError extends PlayError {
  * import { InvalidRoutePatternError } from "@xmachines/play-router/errors";
  *
  * try {
- *   const routeMatcher = createRouteMap(tree);
+ *   const routeMatcher = createRouteMatcher(tree);
  * } catch (err) {
  *   if (err instanceof InvalidRoutePatternError) {
  *     console.error(`Bad route pattern: "${err.pattern}"`, err.cause);

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,OAAO,eAAgB,SAAQ,SAAS;IAC7C,YAAY,OAAe,EAAE,OAAsB;QAClD,KAAK,CAAC,kBAAkB,EAAE,yBAAyB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACvE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,0BAA2B,SAAQ,SAAS;IACxD;QACC,KAAK,CACJ,UAAU,EACV,uCAAuC,EACvC,6IAA6I,CAC7I,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC1C,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACjD,8CAA8C;IACrC,OAAO,CAAS;IAEzB,YAAY,OAAe;QAC1B,KAAK,CACJ,UAAU,EACV,uBAAuB,EACvB,8BAA8B,OAAO,sCAAsC,CAC3E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,OAAO,mBAAoB,SAAQ,SAAS;IACjD,sDAAsD;IAC7C,OAAO,CAAS;IAEzB,YAAY,OAAe;QAC1B,KAAK,CACJ,UAAU,EACV,6BAA6B,EAC7B,2CAA2C,OAAO,EAAE,CACpD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD;AAED;;;;GAIG;AACH,MAAM,OAAO,uBAAwB,SAAQ,SAAS;IACrD,mEAAmE;IAC1D,UAAU,CAAW;IAE9B,YAAY,UAAoB;QAC/B,KAAK,CACJ,UAAU,EACV,2BAA2B,EAC3B,oCAAoC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YAC9D,kDAAkD;YAClD,6FAA6F,CAC9F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC9B,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,OAAO,qBAAsB,SAAQ,SAAS;IACnD,0CAA0C;IACjC,SAAS,CAAS;IAC3B,sDAAsD;IAC7C,MAAM,CAAS;IAExB,YAAY,SAAiB,EAAE,MAAc,EAAE,UAAoB;QAClE,KAAK,CACJ,gBAAgB,EAChB,+BAA+B,EAC/B,8BAA8B,SAAS,cAAc,MAAM,KAAK;YAC/D,oBAAoB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC7C,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACtB,CAAC;CACD;AAED,MAAM,OAAO,wBAAyB,SAAQ,SAAS;IACtD,yEAAyE;IAChE,OAAO,CAAS;IAEzB,YAAY,OAAe,EAAE,OAAsB;QAClD,KAAK,CACJ,UAAU,EACV,gCAAgC,EAChC,2BAA2B,OAAO,GAAG,EACrC,OAAO,CACP,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;CACD"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -9,9 +9,10 @@ export { getNavigableRoutes, getRoutableRoutes, routeExists, getTransitionReacha
 export { machineToGraph } from "./machine-to-graph.js";
 export type { MachineGraph } from "./machine-to-graph.js";
 export type { RouteInfo, RouteNode, RouteTree, RouteObject, RouteMetadata, PlayRouteEvent, RouterBridge, MachineNodeData, MachineEdgeData, WindowLike, LocationLike, } from "./types.js";
-export { createRouteMap, type RouteMatcher } from "./create-route-map.js";
+export { createRouteMatcher, type RouteMatcher } from "./create-route-matcher.js";
 export { RouteMap, type RouteMapping, type RouteMapping as BaseRouteMapping, } from "./base-route-map.js";
-export { createRouteMapFromMachine } from "./create-route-map-from-machine.js";
+export { createRouteMap } from "./create-route-map.js";
+export type { RouteMapOptions } from "./create-route-map.js";
 export { createRouteMapFromTree } from "./create-route-map-from-tree.js";
 export { findRouteById, findRouteByPath } from "./find-route.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,YAAY,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAI1E,OAAO,EACN,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,gBAAgB,GACrC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAGlE,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,UAAU,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,YAAY,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACZ,eAAe,EACf,eAAe,EACf,UAAU,EACV,YAAY,GACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAIlF,OAAO,EACN,QAAQ,EACR,KAAK,YAAY,EACjB,KAAK,YAAY,IAAI,gBAAgB,GACrC,MAAM,qBAAqB,CAAC;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,YAAY,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -9,14 +9,14 @@ export { extractMachineRoutes } from "./extract-routes.js";
 export { getNavigableRoutes, getRoutableRoutes, routeExists, getTransitionReachableRoutes, isRouteReachable, } from "./query.js";
 // Graph adapter — converts XState machines to @statelyai/graph Graph
 export { machineToGraph } from "./machine-to-graph.js";
-// URL-pattern-based matcher (createRouteMap / RouteMatcher interface)
-export { createRouteMap } from "./create-route-map.js";
+// URL-pattern-based matcher (createRouteMatcher / RouteMatcher interface)
+export { createRouteMatcher } from "./create-route-matcher.js";
 // Shared bidirectional route mapping base class.
 // RouteMapping is exported directly; BaseRouteMapping kept as alias for compatibility.
 export { RouteMap, } from "./base-route-map.js";
 // Factories: create a RouteMap from a machine or a route tree.
 // All RouterBridgeBase adapters use these instead of rolling their own factories.
-export { createRouteMapFromMachine } from "./create-route-map-from-machine.js";
+export { createRouteMap } from "./create-route-map.js";
 export { createRouteMapFromTree } from "./create-route-map-from-tree.js";
 // Route lookup helpers — matchesPattern is private within find-route.ts
 export { findRouteById, findRouteByPath } from "./find-route.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,iGAAiG;AACjG,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,6BAA6B;AAC7B,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiBvD,sEAAsE;AACtE,OAAO,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAC;AAE1E,iDAAiD;AACjD,uFAAuF;AACvF,OAAO,EACN,QAAQ,GAGR,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,kFAAkF;AAClF,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,wEAAwE;AACxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAG3D,iGAAiG;AACjG,OAAO,EACN,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GAClB,MAAM,kBAAkB,CAAC;AAG1B,6BAA6B;AAC7B,OAAO,EACN,mBAAmB,EACnB,mBAAmB,EACnB,qBAAqB,GACrB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EACN,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EACX,4BAA4B,EAC5B,gBAAgB,GAChB,MAAM,YAAY,CAAC;AAEpB,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAiBvD,0EAA0E;AAC1E,OAAO,EAAE,kBAAkB,EAAqB,MAAM,2BAA2B,CAAC;AAElF,iDAAiD;AACjD,uFAAuF;AACvF,OAAO,EACN,QAAQ,GAGR,MAAM,qBAAqB,CAAC;AAE7B,+DAA+D;AAC/D,kFAAkF;AAClF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,wEAAwE;AACxE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

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

@@ -3,8 +3,9 @@
  *
  * Captures the 90% identical logic from all existing router bridges:
  * - TC39 Signal watcher for actor → router direction
- * - isProcessingNavigation flag for circular update prevention
- * - syncRouterFromActor / syncActorFromRouter with URL parameter extraction
+ * - `lastSyncedPath` for echo suppression in the actor→router direction
+ * - `isProcessingNavigation` flag for guard-redirect loop prevention in `syncActorFromRouter` only
+ * - `syncRouterFromActor` / `syncActorFromRouter` with URL parameter extraction
  * - connect / disconnect lifecycle matching the RouterBridge protocol
  *
  * Subclasses implement only the 3 framework-specific abstract methods:
@@ -78,13 +79,23 @@ export declare abstract class RouterBridgeBase implements RouterBridge {
     protected isConnected: boolean;
     protected hasConnectedOnce: boolean;
     protected lastSyncedPath: string | null;
+    /**
+     * Guards `syncActorFromRouter` against re-entrant calls triggered by the
+     * actor's own guard redirects (router→actor send → signal fires → actor→router
+     * push → another syncActorFromRouter before the first one returns).
+     *
+     * NOT used for actor→router echo suppression — that is handled exclusively by
+     * `lastSyncedPath`, which is updated before `navigateRouter()` is called so
+     * any router callback for the same path short-circuits at the
+     * `sanitized === lastSyncedPath` check in `syncActorFromRouter`.
+     */
     protected isProcessingNavigation: boolean;
     protected routeWatcher: RouteWatcherHandle | null;
     /**
      * @param actor    - A `Routable` actor exposing `currentRoute` and `send`.
      * @param routeMap - Bidirectional route map for `stateId ↔ path` resolution.
      *   Provide `getStateIdByPath` and `getPathByStateId`. Framework adapters
-     *   typically wrap the result of `createRouteMap()` or an equivalent.
+     *   typically wrap the result of `createRouteMap(machine)` or an equivalent.
      */
     constructor(actor: AbstractActor<AnyActorLogic> & Routable, routeMap: {
         getStateIdByPath(path: string): string | null | undefined;
@@ -115,11 +126,15 @@ export declare abstract class RouterBridgeBase implements RouterBridge {
      * Sync router location when actor route signal changes.
      *
      * Calls navigateRouter() for framework-specific navigation.
-     * Prevents circular updates via isProcessingNavigation flag.
      *
-     * `lastSyncedPath` is updated before `navigateRouter()` and the processing flag is
-     * released in a microtask so synchronous router callbacks triggered by navigation are
-     * suppressed as circular echoes.
+     * Echo suppression — preventing the router's own callback from re-driving the
+     * actor — is handled entirely by `lastSyncedPath`: it is set to `route` before
+     * `navigateRouter()` is called, so any `syncActorFromRouter` invocation for the
+     * same path short-circuits at the `sanitized === lastSyncedPath` check and sends
+     * no event regardless of whether the callback fires synchronously or asynchronously.
+     *
+     * `isProcessingNavigation` is NOT set here — it is only used inside
+     * `syncActorFromRouter` to guard against re-entrant guard-redirect loops.
      */
     protected syncRouterFromActor(route: string | null | unknown): void;
     /**

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

@@ -1 +1 @@
-{"version":3,"file":"router-bridge-base.d.ts","sourceRoot":"","sources":["../src/router-bridge-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router-bridge-base.d.ts","sourceRoot":"","sources":["../src/router-bridge-base.ts"],"names":[],"mappings":"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"}

package/dist/router-bridge-base.js

@@ -3,8 +3,9 @@
  *
  * Captures the 90% identical logic from all existing router bridges:
  * - TC39 Signal watcher for actor → router direction
- * - isProcessingNavigation flag for circular update prevention
- * - syncRouterFromActor / syncActorFromRouter with URL parameter extraction
+ * - `lastSyncedPath` for echo suppression in the actor→router direction
+ * - `isProcessingNavigation` flag for guard-redirect loop prevention in `syncActorFromRouter` only
+ * - `syncRouterFromActor` / `syncActorFromRouter` with URL parameter extraction
  * - connect / disconnect lifecycle matching the RouterBridge protocol
  *
  * Subclasses implement only the 3 framework-specific abstract methods:
@@ -41,9 +42,19 @@
  * @see [Play RFC](../../docs/rfc/play.md) - Invariant INV-04
  */
 import { Signal, watchSignal } from "@xmachines/play-signals";
-import { RouterSyncError } from "./errors.js";
+import { DuplicateBridgeError, RouterSyncError } from "./errors.js";
 import { buildPlayRouteEvent, extractQuery, extractRouteParams, matchRouteMap, sanitizePathname, } from "./router-sync.js";
 import { URLPatternUnavailableError } from "./errors.js";
+/**
+ * Module-level registry of actors that currently have an active bridge connection.
+ *
+ * Keyed on the actor instance (WeakMap — no reference retention). Used to detect and
+ * reject duplicate `connect()` calls for the same actor, which would produce duplicate
+ * `play.route` events and conflicting `lastSyncedPath` echo-suppression state.
+ *
+ * @internal
+ */
+const activeBridges = new WeakMap();
 /** Strip leading '#' for normalized stateId comparison. */
 function normalizeId(id) {
     return id.startsWith("#") ? id.slice(1) : id;
@@ -62,13 +73,23 @@ export class RouterBridgeBase {
     isConnected = false;
     hasConnectedOnce = false;
     lastSyncedPath = null;
+    /**
+     * Guards `syncActorFromRouter` against re-entrant calls triggered by the
+     * actor's own guard redirects (router→actor send → signal fires → actor→router
+     * push → another syncActorFromRouter before the first one returns).
+     *
+     * NOT used for actor→router echo suppression — that is handled exclusively by
+     * `lastSyncedPath`, which is updated before `navigateRouter()` is called so
+     * any router callback for the same path short-circuits at the
+     * `sanitized === lastSyncedPath` check in `syncActorFromRouter`.
+     */
     isProcessingNavigation = false;
     routeWatcher = null;
     /**
      * @param actor    - A `Routable` actor exposing `currentRoute` and `send`.
      * @param routeMap - Bidirectional route map for `stateId ↔ path` resolution.
      *   Provide `getStateIdByPath` and `getPathByStateId`. Framework adapters
-     *   typically wrap the result of `createRouteMap()` or an equivalent.
+     *   typically wrap the result of `createRouteMap(machine)` or an equivalent.
      */
     constructor(actor, routeMap) {
         this.actor = actor;
@@ -96,6 +117,14 @@ export class RouterBridgeBase {
         if (this.isConnected) {
             return;
         }
+        // Enforce single-bridge-per-actor: two connected bridges for the same actor
+        // would both receive every router navigation event, sending duplicate play.route
+        // events and producing conflicting lastSyncedPath echo-suppression state.
+        const existingBridge = activeBridges.get(this.actor);
+        if (existingBridge !== undefined && existingBridge !== this) {
+            throw new DuplicateBridgeError();
+        }
+        activeBridges.set(this.actor, this);
         this.isConnected = true;
         this.hasConnectedOnce = true;
         // Set up TC39 Signal watcher for actor → router direction
@@ -186,17 +215,27 @@ export class RouterBridgeBase {
         }
         this.isProcessingNavigation = false;
         this.isConnected = false;
+        // Release the actor slot so a new bridge can connect to the same actor.
+        // Only clear if this bridge is the currently registered one — a second bridge
+        // that was rejected at connect() time must not evict the legitimate bridge.
+        if (activeBridges.get(this.actor) === this) {
+            activeBridges.delete(this.actor);
+        }
     }
     // ── Sync methods (protected, overridable if subclass needs custom behavior) ──
     /**
      * Sync router location when actor route signal changes.
      *
      * Calls navigateRouter() for framework-specific navigation.
-     * Prevents circular updates via isProcessingNavigation flag.
      *
-     * `lastSyncedPath` is updated before `navigateRouter()` and the processing flag is
-     * released in a microtask so synchronous router callbacks triggered by navigation are
-     * suppressed as circular echoes.
+     * Echo suppression — preventing the router's own callback from re-driving the
+     * actor — is handled entirely by `lastSyncedPath`: it is set to `route` before
+     * `navigateRouter()` is called, so any `syncActorFromRouter` invocation for the
+     * same path short-circuits at the `sanitized === lastSyncedPath` check and sends
+     * no event regardless of whether the callback fires synchronously or asynchronously.
+     *
+     * `isProcessingNavigation` is NOT set here — it is only used inside
+     * `syncActorFromRouter` to guard against re-entrant guard-redirect loops.
      */
     syncRouterFromActor(route) {
         if (this.hasConnectedOnce && !this.isConnected)
@@ -205,14 +244,18 @@ export class RouterBridgeBase {
             return;
         if (route === this.lastSyncedPath)
             return;
-        if (this.isProcessingNavigation)
-            return;
-        this.lastSyncedPath = route;
-        this.isProcessingNavigation = true;
+        // Resolve the raw actor route (stateId or concrete path) to the concrete URL
+        // path that will actually be pushed. lastSyncedPath must store the concrete
+        // path so that the router callback (which fires with the concrete path) matches
+        // and short-circuits in syncActorFromRouter. Storing the raw stateId (e.g.
+        // "#home") would cause a mismatch against the sanitized path ("/") in the watcher.
+        //
+        // When resolveNavigationPath returns null (parameterized pattern, unknown id)
+        // navigateRouter will skip the push — set lastSyncedPath to route as before so
+        // the dedup guard still fires correctly on the next identical signal value.
+        const resolved = this.resolveNavigationPath(route);
+        this.lastSyncedPath = resolved ?? route;
         this.navigateRouter(route);
-        queueMicrotask(() => {
-            this.isProcessingNavigation = false;
-        });
     }
     /**
      * Sync actor state when router location changes.

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

@@ -1 +1 @@
-{"version":3,"file":"router-bridge-base.js","sourceRoot":"","sources":["../src/router-bridge-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"router-bridge-base.js","sourceRoot":"","sources":["../src/router-bridge-base.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -78,7 +78,7 @@ export interface RouteNode {
     /**
      * The fully resolved absolute path from the root (e.g. `"/dashboard/overview"`).
      * Always use `fullPath` for browser URL matching and route map construction.
-     * `createRouteMapFromTree` and `createRouteMapFromMachine` both use this field.
+     * `createRouteMapFromTree` and `createRouteMap` both use this field.
      */
     fullPath: string;
     /** Route pattern with parameters (e.g., /profile/:userId) if path contains params */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-router",
-  "version": "1.0.0-beta.43",
+  "version": "1.0.0-beta.44",
   "description": "Route tree extraction from XState v5 state machines. Part of @xmachines/play Universal Player Architecture.",
   "keywords": [
     "routing",
@@ -47,15 +47,15 @@
   },
   "dependencies": {
     "@statelyai/graph": "^0.11.0",
-    "@xmachines/play": "1.0.0-beta.43",
-    "@xmachines/play-actor": "1.0.0-beta.43",
-    "@xmachines/play-signals": "1.0.0-beta.43",
+    "@xmachines/play": "1.0.0-beta.44",
+    "@xmachines/play-actor": "1.0.0-beta.44",
+    "@xmachines/play-signals": "1.0.0-beta.44",
     "quick-lru": "^7.3.0"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@xmachines/play-xstate": "1.0.0-beta.43",
-    "@xmachines/shared": "1.0.0-beta.43",
+    "@xmachines/play-xstate": "1.0.0-beta.44",
+    "@xmachines/shared": "1.0.0-beta.44",
     "oxfmt": "^0.45.0",
     "oxlint": "^1.60.0",
     "typescript": "^5.9.3 || ^6.0.3",

package/dist/create-route-map-from-machine.d.ts

@@ -1,24 +0,0 @@
-import type { AnyStateMachine } from "xstate";
-import { RouteMap } from "./base-route-map.js";
-/**
- * Create a `RouteMap` from an XState state machine.
- *
- * Extracts all routable states (those with `meta.route`) and builds a bidirectional
- * path ↔ stateId lookup structure. The returned map is used by `RouterBridgeBase`
- * subclasses to translate browser URL changes into `play.route` actor events and
- * vice-versa.
- *
- * @param machine - XState v5 state machine with `meta.route` annotations on states.
- * @returns A `RouteMap` for passing to any `RouterBridgeBase`-based adapter.
- *
- * @example
- * ```typescript
- * import { createRouteMapFromMachine } from '@xmachines/play-router';
- * import { connectRouter } from '@xmachines/play-dom-router';
- *
- * const routeMap = createRouteMapFromMachine(myMachine);
- * const disconnect = connectRouter({ actor, router, routeMap });
- * ```
- */
-export declare function createRouteMapFromMachine(machine: AnyStateMachine): RouteMap;
-//# sourceMappingURL=create-route-map-from-machine.d.ts.map

package/dist/create-route-map-from-machine.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-route-map-from-machine.d.ts","sourceRoot":"","sources":["../src/create-route-map-from-machine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAG9C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CAS5E"}

package/dist/create-route-map-from-machine.js

@@ -1,32 +0,0 @@
-import { extractMachineRoutes } from "./extract-routes.js";
-import { getRoutableRoutes } from "./query.js";
-import { RouteMap } from "./base-route-map.js";
-/**
- * Create a `RouteMap` from an XState state machine.
- *
- * Extracts all routable states (those with `meta.route`) and builds a bidirectional
- * path ↔ stateId lookup structure. The returned map is used by `RouterBridgeBase`
- * subclasses to translate browser URL changes into `play.route` actor events and
- * vice-versa.
- *
- * @param machine - XState v5 state machine with `meta.route` annotations on states.
- * @returns A `RouteMap` for passing to any `RouterBridgeBase`-based adapter.
- *
- * @example
- * ```typescript
- * import { createRouteMapFromMachine } from '@xmachines/play-router';
- * import { connectRouter } from '@xmachines/play-dom-router';
- *
- * const routeMap = createRouteMapFromMachine(myMachine);
- * const disconnect = connectRouter({ actor, router, routeMap });
- * ```
- */
-export function createRouteMapFromMachine(machine) {
-    const routeTree = extractMachineRoutes(machine);
-    const routes = getRoutableRoutes(routeTree);
-    return new RouteMap(routes.map((node) => ({
-        stateId: node.stateId,
-        path: node.fullPath,
-    })));
-}
-//# sourceMappingURL=create-route-map-from-machine.js.map

package/dist/create-route-map-from-machine.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-route-map-from-machine.js","sourceRoot":"","sources":["../src/create-route-map-from-machine.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAwB;IACjE,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5C,OAAO,IAAI,QAAQ,CAClB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,QAAQ;KACnB,CAAC,CAAC,CACH,CAAC;AACH,CAAC"}