@xmachines/play-router 1.0.0-beta.21 → 1.0.0-beta.23

package/dist/url-pattern-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-pattern-utils.d.ts","sourceRoot":"","sources":["../src/url-pattern-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG;QAClC,QAAQ,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;SAAE,CAAC;KACzD,GAAG,IAAI,CAAC;IACT,IAAI,CAAC,KAAK,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;CAC3C,CAAC;AAEF,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,KAAK,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,KAAK,cAAc,CAAC;AAEhF;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMhD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EACxD,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAChC,QAAQ,EAAE,MAAM,GACd,CAAC,EAAE,CA2BL"}

package/dist/url-pattern-utils.js

@@ -0,0 +1,77 @@
+/**
+ * Shared URLPattern utilities — internal module, NOT exported from index.ts
+ *
+ * Provides the common URLPattern plumbing shared by:
+ * - `create-route-map.ts`
+ * - `base-route-map.ts`
+ * - `find-route.ts`
+ * - `router-bridge-base.ts`
+ *
+ * URLPattern is accessed via globalThis — consumers must load a polyfill on
+ * environments without native support (Node < 24, older browsers).
+ *
+ * @internal
+ */
+/**
+ * Retrieve the URLPattern constructor from `globalThis`, or `undefined` if
+ * it is not available (Node < 24, older browsers without a polyfill).
+ */
+export function getURLPatternCtor() {
+    return globalThis["URLPattern"];
+}
+/**
+ * Compute the bucket index key for a given path or pattern.
+ *
+ * The key is the first path segment (e.g. `"settings"` for `"/settings/:id"`).
+ * Parameterised first segments (`:lang`) fall into the `"*"` wildcard bucket.
+ * The root path `"/"` maps to the key `"/"`.
+ *
+ * @param path - URL path or route pattern string
+ */
+export function getIndexKey(path) {
+    const trimmed = path.startsWith("/") ? path.slice(1) : path;
+    if (trimmed.length === 0)
+        return "/";
+    const segment = trimmed.split("/")[0];
+    if (segment === undefined || segment.startsWith(":"))
+        return "*";
+    return segment;
+}
+/**
+ * Merge the named-segment bucket and the wildcard bucket for a given index key,
+ * preserving insertion order (by `order` field).
+ *
+ * @param patternBuckets - Map of bucket key → ordered pattern entries
+ * @param indexKey - First-segment key computed by `getIndexKey`
+ */
+export function getCandidates(patternBuckets, indexKey) {
+    const bucket = patternBuckets.get(indexKey) ?? [];
+    const wildcardBucket = patternBuckets.get("*") ?? [];
+    if (bucket.length === 0)
+        return wildcardBucket;
+    if (wildcardBucket.length === 0)
+        return bucket;
+    const merged = [];
+    let b = 0;
+    let w = 0;
+    while (b < bucket.length && w < wildcardBucket.length) {
+        if (bucket[b].order < wildcardBucket[w].order) {
+            merged.push(bucket[b]);
+            b += 1;
+        }
+        else {
+            merged.push(wildcardBucket[w]);
+            w += 1;
+        }
+    }
+    while (b < bucket.length) {
+        merged.push(bucket[b]);
+        b += 1;
+    }
+    while (w < wildcardBucket.length) {
+        merged.push(wildcardBucket[w]);
+        w += 1;
+    }
+    return merged;
+}
+//# sourceMappingURL=url-pattern-utils.js.map

package/dist/url-pattern-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-pattern-utils.js","sourceRoot":"","sources":["../src/url-pattern-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAgBH;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAChC,OAAQ,UAAsC,CAAC,YAAY,CAA+B,CAAC;AAC5F,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtC,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACjE,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAC5B,cAAgC,EAChC,QAAgB;IAEhB,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,cAAc,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAC/C,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAE/C,MAAM,MAAM,GAAQ,EAAE,CAAC;IACvB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;QACvD,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACvB,CAAC,IAAI,CAAC,CAAC;QACR,CAAC;aAAM,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,CAAC,IAAI,CAAC,CAAC;QACR,CAAC;IACF,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACvB,CAAC,IAAI,CAAC,CAAC;IACR,CAAC;IACD,OAAO,CAAC,GAAG,cAAc,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC,IAAI,CAAC,CAAC;IACR,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xmachines/play-router",
-  "version": "1.0.0-beta.21",
+  "version": "1.0.0-beta.23",
   "description": "Route tree extraction from XState v5 state machines. Part of @xmachines/play Universal Player Architecture.",
   "keywords": [
     "routing",
@@ -34,21 +34,25 @@
   },
   "scripts": {
     "build": "tsc --build",
-    "clean": "rm -rf dist *.tsbuildinfo coverage .vitest-attachments test/browser/__screenshots__",
+    "clean": "rm -rf dist *.tsbuildinfo coverage .vitest-attachments test/browser/__screenshots__ node_modules/.vite*",
+    "lint": "oxlint .",
+    "format": "oxfmt .",
     "test": "vitest",
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "@statelyai/graph": "^0.9.0",
-    "@xmachines/play": "1.0.0-beta.21",
-    "@xmachines/play-actor": "1.0.0-beta.21",
-    "@xmachines/play-signals": "1.0.0-beta.21",
+    "@statelyai/graph": "^0.10.0",
+    "@xmachines/play": "1.0.0-beta.23",
+    "@xmachines/play-actor": "1.0.0-beta.23",
+    "@xmachines/play-signals": "1.0.0-beta.23",
     "quick-lru": "^7.0.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
-    "@xmachines/play-xstate": "1.0.0-beta.21",
-    "@xmachines/shared": "1.0.0-beta.21",
+    "@xmachines/play-xstate": "1.0.0-beta.23",
+    "@xmachines/shared": "1.0.0-beta.23",
+    "oxfmt": "^0.43.0",
+    "oxlint": "^1.57.0",
     "typescript": "^5.9.3 || ^6.0.2",
     "urlpattern-polyfill": "^10.1.0",
     "vitest": "^4.1.2",

package/dist/connect-router.d.ts

@@ -1,56 +0,0 @@
-import type { AbstractActor, Routable } from "@xmachines/play-actor";
-import type { AnyActorLogic } from "xstate";
-import type { VanillaRouter } from "./create-router.js";
-import type { RouteMap } from "./create-route-map.js";
-export interface ConnectRouterOptions {
-    actor: AbstractActor<AnyActorLogic> & Routable;
-    router: VanillaRouter;
-    routeMap: RouteMap;
-}
-/**
- * Connect vanilla router to actor (pure browser integration).
- *
- * This is the LOW-LEVEL API for maximum control. No JSX, no rendering,
- * just actor ↔ router synchronization.
- *
- * Use this when:
- * - You want manual control over rendering
- * - Using non-JSX framework (jQuery, Alpine, HTMX, etc.)
- * - Building custom integration
- *
- * For JSX frameworks, use framework adapters instead:
- * - @xmachines/play-react (React components)
- * - Future: @xmachines/play-preact, @xmachines/play-solid, @xmachines/play-vue
- *
- * Architecture:
- * - Subscribes to history changes → sends play.route to actor
- * - Watches actor.currentRoute signal → updates browser URL
- * - Prevents circular updates (history change triggers actor, actor triggers history)
- * - Returns cleanup function
- *
- * Usage:
- * ```typescript
- * import { createBrowserHistory, createRouter, connectRouter } from '@xmachines/play-router';
- *
- * const history = createBrowserHistory({ window });
- * const router = createRouter({ routeTree, history });
- *
- * // Connect router to actor
- * const disconnect = connectRouter({ actor, router, routeMap });
- *
- * // User handles rendering (vanilla JS)
- * const watcher = new Signal.subtle.Watcher(() => {
- *   queueMicrotask(() => {
- *     const view = actor.currentView.get();
- *     document.getElementById('app').innerHTML = render(view);
- *   });
- * });
- * watcher.watch(actor.currentView);
- *
- * // Later: cleanup
- * disconnect();
- * watcher.unwatch(actor.currentView);
- * ```
- */
-export declare function connectRouter(options: ConnectRouterOptions): () => void;
-//# sourceMappingURL=connect-router.d.ts.map

package/dist/connect-router.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect-router.d.ts","sourceRoot":"","sources":["../src/connect-router.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAGtD,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,QAAQ,CAAC;IAC/C,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,EAAE,QAAQ,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAqEvE"}

package/dist/connect-router.js

@@ -1,109 +0,0 @@
-import { watchSignal } from "@xmachines/play-signals";
-import { buildPlayRouteEvent } from "./router-sync.js";
-/**
- * Connect vanilla router to actor (pure browser integration).
- *
- * This is the LOW-LEVEL API for maximum control. No JSX, no rendering,
- * just actor ↔ router synchronization.
- *
- * Use this when:
- * - You want manual control over rendering
- * - Using non-JSX framework (jQuery, Alpine, HTMX, etc.)
- * - Building custom integration
- *
- * For JSX frameworks, use framework adapters instead:
- * - @xmachines/play-react (React components)
- * - Future: @xmachines/play-preact, @xmachines/play-solid, @xmachines/play-vue
- *
- * Architecture:
- * - Subscribes to history changes → sends play.route to actor
- * - Watches actor.currentRoute signal → updates browser URL
- * - Prevents circular updates (history change triggers actor, actor triggers history)
- * - Returns cleanup function
- *
- * Usage:
- * ```typescript
- * import { createBrowserHistory, createRouter, connectRouter } from '@xmachines/play-router';
- *
- * const history = createBrowserHistory({ window });
- * const router = createRouter({ routeTree, history });
- *
- * // Connect router to actor
- * const disconnect = connectRouter({ actor, router, routeMap });
- *
- * // User handles rendering (vanilla JS)
- * const watcher = new Signal.subtle.Watcher(() => {
- *   queueMicrotask(() => {
- *     const view = actor.currentView.get();
- *     document.getElementById('app').innerHTML = render(view);
- *   });
- * });
- * watcher.watch(actor.currentView);
- *
- * // Later: cleanup
- * disconnect();
- * watcher.unwatch(actor.currentView);
- * ```
- */
-export function connectRouter(options) {
-    const { actor, router, routeMap } = options;
-    const { history } = router;
-    // Prevent circular updates — single navigation-processing guard.
-    // Matches RouterBridgeBase.isProcessingNavigation pattern.
-    // Reduces race-condition surface from 2³=8 flag combinations to 2.
-    let isProcessingNavigation = false;
-    // Subscribe to history changes (browser navigation)
-    const unsubscribeHistory = history.subscribe((location) => {
-        if (isProcessingNavigation)
-            return;
-        const nextRoute = buildPlayRouteEvent({
-            pathname: location.pathname,
-            search: location.search,
-            resolve: (pathname) => routeMap.resolve(pathname),
-        });
-        if (nextRoute) {
-            isProcessingNavigation = true;
-            actor.send(nextRoute.event);
-            // Check immediately if actor redirected (always-guard)
-            // XState processes events synchronously, so snapshot is already updated
-            const newActorRoute = actor.currentRoute.get();
-            if (newActorRoute && newActorRoute !== nextRoute.pathname) {
-                // Actor redirected - update URL
-                history.replace(newActorRoute);
-            }
-            // Clear flag synchronously to prevent race conditions
-            isProcessingNavigation = false;
-        }
-    });
-    // Watch actor's currentRoute signal (actor-driven navigation)
-    const unwatchRoute = watchSignal(actor.currentRoute, (route) => {
-        if (isProcessingNavigation)
-            return;
-        const currentPath = history.location.pathname;
-        if (route && route !== currentPath) {
-            isProcessingNavigation = true;
-            history.push(route);
-            isProcessingNavigation = false;
-        }
-    });
-    // Sync initial URL to actor
-    // ONLY send route event if URL doesn't match actor's initial state
-    const initialPath = history.location.pathname;
-    const initialActorRoute = actor.currentRoute.get();
-    if (initialPath !== initialActorRoute) {
-        const nextRoute = buildPlayRouteEvent({
-            pathname: initialPath,
-            search: history.location.search,
-            resolve: (pathname) => routeMap.resolve(pathname),
-        });
-        if (nextRoute) {
-            actor.send(nextRoute.event);
-        }
-    }
-    // Return cleanup
-    return () => {
-        unsubscribeHistory();
-        unwatchRoute();
-    };
-}
-//# sourceMappingURL=connect-router.js.map

package/dist/connect-router.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"connect-router.js","sourceRoot":"","sources":["../src/connect-router.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAKtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAQvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,aAAa,CAAC,OAA6B;IAC1D,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;IAE3B,iEAAiE;IACjE,2DAA2D;IAC3D,mEAAmE;IACnE,IAAI,sBAAsB,GAAG,KAAK,CAAC;IAEnC,oDAAoD;IACpD,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE,EAAE;QACzD,IAAI,sBAAsB;YAAE,OAAO;QAEnC,MAAM,SAAS,GAAG,mBAAmB,CAAC;YACrC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,SAAS,EAAE,CAAC;YACf,sBAAsB,GAAG,IAAI,CAAC;YAE9B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YAE5B,uDAAuD;YACvD,wEAAwE;YACxE,MAAM,aAAa,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;YAC/C,IAAI,aAAa,IAAI,aAAa,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC;gBAC3D,gCAAgC;gBAChC,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAChC,CAAC;YAED,sDAAsD;YACtD,sBAAsB,GAAG,KAAK,CAAC;QAChC,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,8DAA8D;IAC9D,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;QAC9D,IAAI,sBAAsB;YAAE,OAAO;QAEnC,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC9C,IAAI,KAAK,IAAI,KAAK,KAAK,WAAW,EAAE,CAAC;YACpC,sBAAsB,GAAG,IAAI,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpB,sBAAsB,GAAG,KAAK,CAAC;QAChC,CAAC;IACF,CAAC,CAAC,CAAC;IAEH,4BAA4B;IAC5B,mEAAmE;IACnE,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;IAC9C,MAAM,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC;IAEnD,IAAI,WAAW,KAAK,iBAAiB,EAAE,CAAC;QACvC,MAAM,SAAS,GAAG,mBAAmB,CAAC;YACrC,QAAQ,EAAE,WAAW;YACrB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM;YAC/B,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;SACjD,CAAC,CAAC;QACH,IAAI,SAAS,EAAE,CAAC;YACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,CAAC;IACF,CAAC;IAED,iBAAiB;IACjB,OAAO,GAAG,EAAE;QACX,kBAAkB,EAAE,CAAC;QACrB,YAAY,EAAE,CAAC;IAChB,CAAC,CAAC;AACH,CAAC"}

package/dist/create-browser-history.d.ts

@@ -1,101 +0,0 @@
-export interface BrowserHistory {
-    /**
-     * Get current location state
-     */
-    readonly location: {
-        pathname: string;
-        search: string;
-        hash: string;
-        state: unknown;
-    };
-    /**
-     * Push new URL to history
-     */
-    push(path: string, state?: unknown): void;
-    /**
-     * Replace current URL in history
-     */
-    replace(path: string, state?: unknown): void;
-    /**
-     * Go back/forward
-     */
-    go(delta: number): void;
-    back(): void;
-    forward(): void;
-    /**
-     * Subscribe to history changes
-     * Returns unsubscribe function
-     */
-    subscribe(listener: (location: BrowserHistory["location"]) => void): () => void;
-    /**
-     * Create href from path
-     */
-    createHref(path: string): string;
-    /**
-     * Cleanup.
-     *
-     * Safe to call more than once. When multiple wrappers share the same
-     * `window.history`, the original methods are restored only after the last
-     * wrapper is destroyed.
-     */
-    destroy(): void;
-}
-/**
- * Minimal window interface for createBrowserHistory
- *
- * Structural interface covering only the properties actually used.
- * Accepts Window, JSDOM window, or any compatible test double.
- * Avoids coupling to `Window & typeof globalThis` which varies across environments.
- *
- * @public
- */
-export interface BrowserWindow {
-    history: {
-        readonly state: unknown;
-        pushState(state: unknown, title: string, url?: string | null): void;
-        replaceState(state: unknown, title: string, url?: string | null): void;
-        go(delta: number): void;
-        back(): void;
-        forward(): void;
-    };
-    location: {
-        readonly pathname: string;
-        readonly search: string;
-        readonly hash: string;
-    };
-    addEventListener(type: "popstate", listener: () => void): void;
-    removeEventListener(type: "popstate", listener: () => void): void;
-}
-/**
- * Create browser history that wraps window.history
- *
- * Aligned with TanStack Router's history interface for API parallelism.
- *
- * Architecture:
- * - Patches window.history.pushState/replaceState to detect changes
- * - Listens to popstate for browser back/forward
- * - Provides subscribe() for listeners (like PlayRouterProvider)
- * - Testable (accepts window object)
- *
- * Usage:
- * ```typescript
- * const history = createBrowserHistory({ window });
- *
- * const unsubscribe = history.subscribe((location) => {
- *   console.log('URL changed:', location.pathname);
- * });
- *
- * history.push('/new-path');
- *
- * // Later:
- * unsubscribe();
- * history.destroy();
- * ```
- *
- * `destroy()` is idempotent and cooperates with other wrappers created for the
- * same `window` instance.
- */
-export declare function createBrowserHistory(options: {
-    window: BrowserWindow;
-}): BrowserHistory;
-//# sourceMappingURL=create-browser-history.d.ts.map

package/dist/create-browser-history.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"create-browser-history.d.ts","sourceRoot":"","sources":["../src/create-browser-history.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,cAAc;IAC9B;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,OAAO,CAAC;KACf,CAAC;IAEF;;OAEG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE1C;;OAEG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,IAAI,IAAI,CAAC;IACb,OAAO,IAAI,IAAI,CAAC;IAEhB;;;OAGG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IAEhF;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEjC;;;;;;OAMG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,aAAa;IAC7B,OAAO,EAAE;QACR,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;QACxB,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;QACpE,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;QACvE,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,IAAI,IAAI,IAAI,CAAC;QACb,OAAO,IAAI,IAAI,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE;QACT,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,gBAAgB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;IAC/D,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAClE;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GAAG,cAAc,CA8EvF"}

package/dist/create-browser-history.js

@@ -1,120 +0,0 @@
-const historyPatchStates = new WeakMap();
-/**
- * Create browser history that wraps window.history
- *
- * Aligned with TanStack Router's history interface for API parallelism.
- *
- * Architecture:
- * - Patches window.history.pushState/replaceState to detect changes
- * - Listens to popstate for browser back/forward
- * - Provides subscribe() for listeners (like PlayRouterProvider)
- * - Testable (accepts window object)
- *
- * Usage:
- * ```typescript
- * const history = createBrowserHistory({ window });
- *
- * const unsubscribe = history.subscribe((location) => {
- *   console.log('URL changed:', location.pathname);
- * });
- *
- * history.push('/new-path');
- *
- * // Later:
- * unsubscribe();
- * history.destroy();
- * ```
- *
- * `destroy()` is idempotent and cooperates with other wrappers created for the
- * same `window` instance.
- */
-export function createBrowserHistory(options) {
-    const win = options.window;
-    const listeners = new Set();
-    const patchState = getOrCreatePatchState(win);
-    let destroyed = false;
-    function getLocation() {
-        return {
-            pathname: win.location.pathname,
-            search: win.location.search,
-            hash: win.location.hash,
-            state: win.history.state,
-        };
-    }
-    function notify() {
-        const location = getLocation();
-        listeners.forEach((listener) => listener(location));
-    }
-    patchState.wrappers.add(notify);
-    // Listen to popstate
-    const popstateHandler = () => notify();
-    win.addEventListener("popstate", popstateHandler);
-    return {
-        get location() {
-            return getLocation();
-        },
-        push(path, state) {
-            win.history.pushState(state, "", path);
-        },
-        replace(path, state) {
-            win.history.replaceState(state, "", path);
-        },
-        go(delta) {
-            win.history.go(delta);
-        },
-        back() {
-            win.history.back();
-        },
-        forward() {
-            win.history.forward();
-        },
-        subscribe(listener) {
-            listeners.add(listener);
-            return () => listeners.delete(listener);
-        },
-        createHref(path) {
-            return path;
-        },
-        destroy() {
-            if (destroyed) {
-                return;
-            }
-            destroyed = true;
-            patchState.wrappers.delete(notify);
-            patchState.refCount -= 1;
-            win.removeEventListener("popstate", popstateHandler);
-            listeners.clear();
-            if (patchState.refCount === 0) {
-                win.history.pushState = patchState.originalPushState;
-                win.history.replaceState = patchState.originalReplaceState;
-                historyPatchStates.delete(win.history);
-            }
-        },
-    };
-}
-function getOrCreatePatchState(win) {
-    const existing = historyPatchStates.get(win.history);
-    if (existing) {
-        existing.refCount += 1;
-        return existing;
-    }
-    const originalPushState = win.history.pushState.bind(win.history);
-    const originalReplaceState = win.history.replaceState.bind(win.history);
-    const patchState = {
-        originalPushState,
-        originalReplaceState,
-        wrappers: new Set(),
-        refCount: 1,
-    };
-    win.history.pushState = function (state, title, url) {
-        patchState.originalPushState(state, title, url);
-        patchState.wrappers.forEach((notify) => notify());
-    };
-    win.history.replaceState = function (state, title, url) {
-        patchState.originalReplaceState(state, title, url);
-        patchState.wrappers.forEach((notify) => notify());
-    };
-    historyPatchStates.set(win.history, patchState);
-    return patchState;
-}
-//# sourceMappingURL=create-browser-history.js.map

package/dist/create-browser-history.js.map

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

package/dist/create-router.d.ts

@@ -1,73 +0,0 @@
-import type { RouteTree } from "./types.js";
-import type { BrowserHistory } from "./create-browser-history.js";
-export interface VanillaRouter {
-    /**
-     * History instance
-     */
-    readonly history: BrowserHistory;
-    /**
-     * Route tree (for structure reference)
-     */
-    readonly routeTree: RouteTree;
-    /**
-     * Cleanup
-     */
-    destroy(): void;
-}
-/**
- * Create vanilla router for framework-agnostic routing.
- *
- * Architecture:
- * - Just wraps history and routeTree
- * - Does NOT embed routeMap (providers need it as prop)
- * - Framework-agnostic history management only
- *
- * Why no routeMap:
- * - Router doesn't know about state IDs (that's Play-specific)
- * - RouteMap is the bridge between router and actor
- * - Provider receives routeMap as prop to do path → state ID resolution
- *
- * Usage (parallel to TanStack mode):
- * ```typescript
- * // Both modes: identical setup
- * const routeTree = extractMachineRoutes(machine);
- * const routeMap = createRouteMap(routeTree);
- * const history = createBrowserHistory({ window });
- *
- * // Vanilla router
- * const router = createRouter({ routeTree, history });
- *
- * // Provider needs routeMap as prop (router doesn't have it)
- * <PlayRouterProvider
- *   actor={actor}
- *   router={router}
- *   routeMap={routeMap}  // ← Must pass separately
- *   renderer={(currentActor, currentRouter) => {
- *     void currentRouter;
- *     return <Renderer actor={currentActor} components={components} />;
- *   }}
- * />
- * ```
- *
- * Compare to TanStack mode:
- * ```typescript
- * // TanStack router (external library)
- * const router = TanStackCreateRouter({ routeTree, history });
- *
- * // Provider needs routeMap as prop (same as vanilla!)
- * <PlayRouterProvider
- *   actor={actor}
- *   router={router}
- *   routeMap={routeMap}  // ← Must pass separately
- *   renderer={(currentActor, currentRouter) => {
- *     void currentRouter;
- *     return <Renderer actor={currentActor} components={components} />;
- *   }}
- * />
- * ```
- */
-export declare function createRouter(options: {
-    routeTree: RouteTree;
-    history: BrowserHistory;
-}): VanillaRouter;
-//# sourceMappingURL=create-router.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"create-router.d.ts","sourceRoot":"","sources":["../src/create-router.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,MAAM,WAAW,aAAa;IAC7B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;IAEjC;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B;;OAEG;IACH,OAAO,IAAI,IAAI,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,cAAc,CAAC;CACxB,GAAG,aAAa,CAWhB"}