@buzola/router 0.0.1

package/dist/define/define-routes.d.ts

@@ -0,0 +1,34 @@
+import type { RouteComponent, RouteConfig, RouteGuard, RouteNode, StandardSchema } from '../engine/types';
+export interface DefineRouteOptions {
+    /** Schema for validating search params. */
+    searchSchema?: StandardSchema;
+    /** Guard function called before entering this route. */
+    beforeEnter?: RouteGuard;
+}
+/**
+ * Define route-level configuration for a route file.
+ * Used in file-based routing: `export const route = defineRoute({ ... })`.
+ */
+export declare function defineRoute(options: DefineRouteOptions): DefineRouteOptions;
+export interface RouteDefinitionOptions {
+    component?: RouteComponent;
+    searchSchema?: StandardSchema;
+    beforeEnter?: RouteGuard;
+}
+export type RouteBuilderFn = (route: (path: string, options: RouteDefinitionOptions | RouteComponent, children?: RouteConfig[]) => RouteConfig) => RouteConfig[];
+/**
+ * Declarative route definition builder.
+ *
+ * @example
+ * ```ts
+ * const routeTree = defineRoutes(route => [
+ *   route('/', { component: Home }),
+ *   route('/users', { component: UsersLayout }, [
+ *     route('/', { component: UsersList }),
+ *     route('/:userId', { component: UserDetail }),
+ *   ]),
+ * ]);
+ * ```
+ */
+export declare function defineRoutes(builder: RouteBuilderFn): RouteNode[];
+//# sourceMappingURL=define-routes.d.ts.map

package/dist/define/define-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-routes.d.ts","sourceRoot":"","sources":["../../src/define/define-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAIzG,MAAM,WAAW,kBAAkB;IAClC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,wDAAwD;IACxD,WAAW,CAAC,EAAE,UAAU,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,kBAAkB,CAE3E;AAaD,MAAM,WAAW,sBAAsB;IACtC,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,WAAW,CAAC,EAAE,UAAU,CAAA;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,CAC5B,KAAK,EAAE,CACN,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,sBAAsB,GAAG,cAAc,EAChD,QAAQ,CAAC,EAAE,WAAW,EAAE,KACpB,WAAW,KACZ,WAAW,EAAE,CAAA;AAElB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,cAAc,GAAG,SAAS,EAAE,CA2BjE"}

package/dist/define/define-routes.js

@@ -0,0 +1,53 @@
+import { buildRouteTree } from '../engine/route-tree';
+/**
+ * Define route-level configuration for a route file.
+ * Used in file-based routing: `export const route = defineRoute({ ... })`.
+ */
+export function defineRoute(options) {
+    return options;
+}
+function isRouteComponent(value) {
+    if (typeof value === 'function')
+        return true;
+    // Check for known option keys to distinguish from component objects (e.g. React.lazy)
+    if (typeof value === 'object' && value !== null) {
+        return !('component' in value || 'searchSchema' in value || 'beforeEnter' in value);
+    }
+    return false;
+}
+/**
+ * Declarative route definition builder.
+ *
+ * @example
+ * ```ts
+ * const routeTree = defineRoutes(route => [
+ *   route('/', { component: Home }),
+ *   route('/users', { component: UsersLayout }, [
+ *     route('/', { component: UsersList }),
+ *     route('/:userId', { component: UserDetail }),
+ *   ]),
+ * ]);
+ * ```
+ */
+export function defineRoutes(builder) {
+    function route(path, options, children) {
+        // If options is a component directly (function or lazy), wrap it
+        const opts = isRouteComponent(options)
+            ? { component: options }
+            : options;
+        const isIndex = path === '/' || path === '';
+        const hasChildren = children != null && children.length > 0;
+        return {
+            path,
+            component: opts.component,
+            searchSchema: opts.searchSchema,
+            beforeEnter: opts.beforeEnter,
+            children,
+            isIndex: isIndex && !hasChildren,
+            isLayout: hasChildren,
+        };
+    }
+    const configs = builder(route);
+    return buildRouteTree(configs);
+}
+//# sourceMappingURL=define-routes.js.map

package/dist/define/define-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-routes.js","sourceRoot":"","sources":["../../src/define/define-routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAYrD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACtD,OAAO,OAAO,CAAA;AACf,CAAC;AAED,SAAS,gBAAgB,CAAC,KAA8C;IACvE,IAAI,OAAO,KAAK,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IAC5C,sFAAsF;IACtF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACjD,OAAO,CAAC,CAAC,WAAW,IAAI,KAAK,IAAI,cAAc,IAAI,KAAK,IAAI,aAAa,IAAI,KAAK,CAAC,CAAA;IACpF,CAAC;IACD,OAAO,KAAK,CAAA;AACb,CAAC;AAkBD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,OAAuB;IACnD,SAAS,KAAK,CACb,IAAY,EACZ,OAAgD,EAChD,QAAwB;QAExB,iEAAiE;QACjE,MAAM,IAAI,GAA2B,gBAAgB,CAAC,OAAO,CAAC;YAC7D,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE;YACxB,CAAC,CAAC,OAAO,CAAA;QAEV,MAAM,OAAO,GAAG,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,EAAE,CAAA;QAC3C,MAAM,WAAW,GAAG,QAAQ,IAAI,IAAI,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAA;QAE3D,OAAO;YACN,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,QAAQ;YACR,OAAO,EAAE,OAAO,IAAI,CAAC,WAAW;YAChC,QAAQ,EAAE,WAAW;SACrB,CAAA;IACF,CAAC;IAED,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IAC9B,OAAO,cAAc,CAAC,OAAO,CAAC,CAAA;AAC/B,CAAC"}

package/dist/engine/matcher.d.ts

@@ -0,0 +1,8 @@
+import type { RouteMatch, RouteNode } from './types';
+/**
+ * Match a URL against the route tree.
+ * Returns an array of RouteMatch from root layout to leaf page, or null if no match.
+ * Performs depth-first matching.
+ */
+export declare function matchRoutes(nodes: RouteNode[], url: URL): RouteMatch[] | null;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/engine/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/engine/matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEpD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,GAAG,GAAG,UAAU,EAAE,GAAG,IAAI,CAS7E"}

package/dist/engine/matcher.js

@@ -0,0 +1,79 @@
+/**
+ * Match a URL against the route tree.
+ * Returns an array of RouteMatch from root layout to leaf page, or null if no match.
+ * Performs depth-first matching.
+ */
+export function matchRoutes(nodes, url) {
+    const pathname = url.pathname;
+    for (const node of nodes) {
+        const result = matchNode(node, pathname);
+        if (result)
+            return result;
+    }
+    return null;
+}
+function matchNode(node, pathname) {
+    // Layout nodes: try to match children, prepend self if any child matches
+    if (node.isLayout && !node.isIndex) {
+        for (const child of node.children) {
+            const childMatch = matchNode(child, pathname);
+            if (childMatch) {
+                // Layout is part of the match chain
+                const layoutMatch = {
+                    node,
+                    params: extractLayoutParams(node, pathname),
+                    pathname,
+                };
+                return [layoutMatch, ...childMatch];
+            }
+        }
+        return null;
+    }
+    // Leaf/index nodes: try to match the URLPattern
+    if (node.pattern) {
+        const result = node.pattern.exec({ pathname });
+        if (result) {
+            const params = extractParamsFromResult(result);
+            const match = { node, params, pathname };
+            // If this node has children (e.g., a page with nested routes), try them too
+            if (node.children.length > 0) {
+                for (const child of node.children) {
+                    const childMatch = matchNode(child, pathname);
+                    if (childMatch) {
+                        return [match, ...childMatch];
+                    }
+                }
+            }
+            return [match];
+        }
+    }
+    return null;
+}
+/**
+ * Extract params from a URLPattern exec result.
+ */
+function extractParamsFromResult(result) {
+    const params = {};
+    const groups = result.pathname.groups;
+    for (const [key, value] of Object.entries(groups)) {
+        // Skip unnamed groups (numeric keys from wildcards/optionals)
+        if (value !== undefined && !/^\d+$/.test(key)) {
+            params[key] = value;
+        }
+    }
+    return params;
+}
+/**
+ * Extract params from a layout node using its prefix URLPattern.
+ * Falls back to empty params if no prefix pattern is available.
+ */
+function extractLayoutParams(node, pathname) {
+    if (node.prefixPattern) {
+        const result = node.prefixPattern.exec({ pathname });
+        if (result) {
+            return extractParamsFromResult(result);
+        }
+    }
+    return {};
+}
+//# sourceMappingURL=matcher.js.map

package/dist/engine/matcher.js.map

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

package/dist/engine/navigation-adapter.d.ts

@@ -0,0 +1,13 @@
+import type { NavigationAdapter } from './types';
+/**
+ * Create a NavigationAdapter that delegates to the browser's Navigation API.
+ */
+export declare function createBrowserNavigationAdapter(): NavigationAdapter;
+export interface MemoryNavigationAdapterOptions {
+    initialURL?: string;
+}
+/**
+ * Create an in-memory NavigationAdapter for testing.
+ */
+export declare function createMemoryNavigationAdapter(options?: MemoryNavigationAdapterOptions): NavigationAdapter;
+//# sourceMappingURL=navigation-adapter.d.ts.map

package/dist/engine/navigation-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation-adapter.d.ts","sourceRoot":"","sources":["../../src/engine/navigation-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAwC,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAItF;;GAEG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAwElE;AAID,MAAM,WAAW,8BAA8B;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAOD;;GAEG;AACH,wBAAgB,6BAA6B,CAC5C,OAAO,GAAE,8BAAmC,GAC1C,iBAAiB,CA6FnB"}

package/dist/engine/navigation-adapter.js

@@ -0,0 +1,156 @@
+// ─── Browser adapter ────────────────────────────────────────────────────────
+/**
+ * Create a NavigationAdapter that delegates to the browser's Navigation API.
+ */
+export function createBrowserNavigationAdapter() {
+    const nav = window.navigation;
+    if (!nav) {
+        throw new Error('Navigation API is not available. Buzola requires a browser that supports the Navigation API.');
+    }
+    const listeners = new Set();
+    let pendingViewTransition = false;
+    const nativeHandler = (event) => {
+        const viewTransition = pendingViewTransition;
+        pendingViewTransition = false;
+        const buzolaEvent = {
+            destination: { url: event.destination.url },
+            canIntercept: event.canIntercept,
+            navigationType: event.navigationType,
+            userInitiated: event.userInitiated,
+            viewTransition,
+            intercept(options) {
+                event.intercept({
+                    handler: options.handler,
+                    scroll: options.scroll,
+                });
+            },
+        };
+        for (const listener of listeners) {
+            listener(buzolaEvent);
+        }
+    };
+    return {
+        getCurrentURL() {
+            return new URL(nav.currentEntry.url);
+        },
+        navigate(url, options) {
+            if (options?.viewTransition) {
+                pendingViewTransition = true;
+            }
+            nav.navigate(url, {
+                history: options?.replace ? 'replace' : 'push',
+                state: options?.state,
+            });
+        },
+        back() {
+            nav.back();
+        },
+        forward() {
+            nav.forward();
+        },
+        addEventListener(_type, handler) {
+            // Lazily register the native handler when the first listener is added
+            const wasEmpty = listeners.size === 0;
+            listeners.add(handler);
+            if (wasEmpty) {
+                nav.addEventListener('navigate', nativeHandler);
+            }
+        },
+        removeEventListener(_type, handler) {
+            listeners.delete(handler);
+            // Clean up the native handler when all listeners are removed
+            if (listeners.size === 0) {
+                nav.removeEventListener('navigate', nativeHandler);
+            }
+        },
+        getState() {
+            return nav.currentEntry?.getState?.();
+        },
+    };
+}
+/**
+ * Create an in-memory NavigationAdapter for testing.
+ */
+export function createMemoryNavigationAdapter(options = {}) {
+    const { initialURL = 'http://localhost/' } = options;
+    const entries = [{ url: initialURL }];
+    let currentIndex = 0;
+    const listeners = new Set();
+    function emitNavigateEvent(url, navigationType, commitNavigation, viewTransition) {
+        let intercepted = false;
+        let interceptHandler;
+        const event = {
+            destination: { url },
+            canIntercept: true,
+            navigationType,
+            userInitiated: false,
+            viewTransition,
+            intercept(options) {
+                intercepted = true;
+                interceptHandler = options.handler;
+            },
+        };
+        for (const listener of listeners) {
+            listener(event);
+        }
+        if (intercepted && interceptHandler) {
+            // Run the handler and only commit navigation state on success.
+            void interceptHandler().then(() => {
+                commitNavigation();
+            }, (error) => {
+                // Guard aborts are expected — rethrow unexpected errors
+                if (error instanceof Error && error.name === 'NavigationAbortedError')
+                    return;
+                throw error;
+            });
+        }
+        else {
+            // No interception — commit immediately
+            commitNavigation();
+        }
+    }
+    return {
+        getCurrentURL() {
+            return new URL(entries[currentIndex].url);
+        },
+        navigate(url, options) {
+            const resolved = new URL(url, entries[currentIndex].url).href;
+            const type = options?.replace ? 'replace' : 'push';
+            emitNavigateEvent(resolved, type, () => {
+                if (options?.replace) {
+                    entries[currentIndex] = { url: resolved, state: options.state };
+                }
+                else {
+                    // Remove any forward entries
+                    entries.length = currentIndex + 1;
+                    entries.push({ url: resolved, state: options?.state });
+                    currentIndex++;
+                }
+            }, options?.viewTransition);
+        },
+        back() {
+            if (currentIndex > 0) {
+                emitNavigateEvent(entries[currentIndex - 1].url, 'traverse', () => {
+                    currentIndex--;
+                });
+            }
+        },
+        forward() {
+            if (currentIndex < entries.length - 1) {
+                emitNavigateEvent(entries[currentIndex + 1].url, 'traverse', () => {
+                    currentIndex++;
+                });
+            }
+        },
+        addEventListener(_type, handler) {
+            listeners.add(handler);
+        },
+        removeEventListener(_type, handler) {
+            listeners.delete(handler);
+        },
+        getState() {
+            return entries[currentIndex].state;
+        },
+    };
+}
+//# sourceMappingURL=navigation-adapter.js.map

package/dist/engine/navigation-adapter.js.map

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

package/dist/engine/route-tree.d.ts

@@ -0,0 +1,21 @@
+import type { RouteComponent, RouteConfig, RouteGuard, RouteNode, StandardSchema } from './types';
+export interface CreateRouteNodeOptions {
+    path: string;
+    fullPath: string;
+    component?: RouteComponent;
+    searchSchema?: StandardSchema;
+    beforeEnter?: RouteGuard;
+    children?: RouteNode[];
+    parent?: RouteNode;
+    isLayout?: boolean;
+    isIndex?: boolean;
+}
+/**
+ * Create a route node with a compiled URLPattern.
+ */
+export declare function createRouteNode(options: CreateRouteNodeOptions): RouteNode;
+/**
+ * Build a route tree from an array of RouteConfig.
+ */
+export declare function buildRouteTree(configs: RouteConfig[], parentPath?: string): RouteNode[];
+//# sourceMappingURL=route-tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"route-tree.d.ts","sourceRoot":"","sources":["../../src/engine/route-tree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAqBjG,MAAM,WAAW,sBAAsB;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,EAAE,SAAS,EAAE,CAAA;IACtB,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,SAAS,CAgD1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,UAAU,SAAK,GAAG,SAAS,EAAE,CAEnF"}

package/dist/engine/route-tree.js

@@ -0,0 +1,95 @@
+/**
+ * Normalize a path segment — ensure it starts with "/" and strip trailing slashes.
+ */
+function normalizePath(path) {
+    if (path === '' || path === '/')
+        return '/';
+    const p = path.startsWith('/') ? path : `/${path}`;
+    return p.endsWith('/') ? p.slice(0, -1) : p;
+}
+/**
+ * Join two path segments.
+ */
+function joinPaths(parent, child) {
+    if (child === '/')
+        return parent === '/' ? '/' : parent;
+    const base = parent === '/' ? '' : parent;
+    const segment = child.startsWith('/') ? child : `/${child}`;
+    return base + segment;
+}
+/**
+ * Create a route node with a compiled URLPattern.
+ */
+export function createRouteNode(options) {
+    const { path, fullPath, component, searchSchema, beforeEnter, children = [], parent, isLayout = false, isIndex = false, } = options;
+    // Build the pattern — layouts get a prefix pattern for param extraction,
+    // index and leaf routes get an exact pattern for matching.
+    let pattern;
+    let prefixPattern;
+    if (!isLayout || isIndex) {
+        pattern = new URLPattern({ pathname: fullPath === '' ? '/' : fullPath });
+    }
+    if (isLayout && !isIndex) {
+        // Layouts get a prefix pattern that matches any path starting with their fullPath.
+        // The {/.*}? suffix optionally matches a trailing slash and anything after.
+        const prefix = fullPath === '' || fullPath === '/' ? '/' : fullPath;
+        prefixPattern = new URLPattern({ pathname: prefix === '/' ? '/{.*}?' : `${prefix}{/.*}?` });
+    }
+    const node = {
+        id: `route:${fullPath || '/'}${isLayout ? ':layout' : ''}`,
+        path: normalizePath(path),
+        fullPath: normalizePath(fullPath),
+        pattern,
+        prefixPattern,
+        component,
+        searchSchema,
+        beforeEnter,
+        children,
+        parent,
+        isLayout,
+        isIndex,
+    };
+    // Set parent reference on children
+    for (const child of node.children) {
+        child.parent = node;
+    }
+    return node;
+}
+/**
+ * Build a route tree from an array of RouteConfig.
+ */
+export function buildRouteTree(configs, parentPath = '') {
+    return buildRouteNodes(configs, parentPath);
+}
+function buildRouteNodes(configs, parentPath) {
+    const nodes = [];
+    for (const config of configs) {
+        const segment = config.isPathlessGroup ? '' : config.path;
+        const hasChildren = config.children != null && config.children.length > 0;
+        const isLayout = config.isLayout ?? hasChildren;
+        const isIndex = config.isIndex ?? (!isLayout && (config.path === '/' || config.path === ''));
+        let fullPath;
+        if (isIndex) {
+            fullPath = parentPath || '/';
+        }
+        else {
+            fullPath = joinPaths(parentPath || '/', segment);
+        }
+        const children = config.children
+            ? buildRouteNodes(config.children, config.isPathlessGroup ? parentPath : fullPath)
+            : [];
+        const node = createRouteNode({
+            path: segment,
+            fullPath,
+            component: config.component,
+            searchSchema: config.searchSchema,
+            beforeEnter: config.beforeEnter,
+            children,
+            isLayout,
+            isIndex,
+        });
+        nodes.push(node);
+    }
+    return nodes;
+}
+//# sourceMappingURL=route-tree.js.map

package/dist/engine/route-tree.js.map

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

package/dist/engine/router.d.ts

@@ -0,0 +1,162 @@
+import type { BlockerFn, NavigateOptions, NavigationAdapter, RouteNode, RouterState } from './types';
+/**
+ * Thrown when a route guard prevents navigation.
+ */
+export declare class NavigationAbortedError extends Error {
+    constructor();
+}
+export type RouterSubscriber = (state: RouterState) => void;
+export interface RouterOptions {
+    /** Route tree nodes. */
+    routes: RouteNode[];
+    /** Navigation adapter (browser or memory). */
+    adapter: NavigationAdapter;
+    /** Enable View Transitions API for navigations. */
+    viewTransitions?: boolean;
+    /**
+     * Base path prefix for all routes (e.g., "/app").
+     * Routes are defined without the base path; the router prepends it
+     * for navigation and strips it for matching.
+     */
+    basePath?: string;
+    /**
+     * Callback that returns fallback values for persistent parameters.
+     * Used when a persistent param is not explicitly provided and not present in the current URL.
+     */
+    persistentParams?: () => Record<string, string>;
+    /**
+     * Page registry mapping page IDs to route patterns.
+     * Generated by the Vite plugin.
+     */
+    pageRegistry?: Record<string, string>;
+    /**
+     * Number of previously visited URLs to keep cached per page component.
+     * When navigating back to a cached URL, stale data is shown immediately
+     * while a background reload runs (SWR).
+     * Set to 0 to always re-fetch on URL change (default).
+     */
+    loaderCacheSize?: number;
+}
+/**
+ * Central Router orchestrator.
+ * Intercepts all navigations via the Navigation API and manages route matching.
+ */
+export declare class Router {
+    private routes;
+    private adapter;
+    private viewTransitions;
+    private readonly _basePath;
+    private readonly persistentParamsFn?;
+    private readonly pageRegistry;
+    private subscribers;
+    private invalidationListeners;
+    private state;
+    private navigationId;
+    private currentAbortController?;
+    private stopFn;
+    private blockers;
+    private pendingScrollBehavior;
+    private readonly _loaderCacheSize;
+    constructor(options: RouterOptions);
+    /**
+     * The configured base path (e.g., "/app"). Empty string if none.
+     */
+    get basePath(): string;
+    /**
+     * Number of previously visited URLs to keep cached per page component.
+     */
+    get loaderCacheSize(): number;
+    /**
+     * Get the current router state.
+     */
+    getState(): RouterState;
+    /**
+     * Subscribe to state changes. Returns an unsubscribe function.
+     */
+    subscribe(subscriber: RouterSubscriber): () => void;
+    /**
+     * Start intercepting navigations.
+     * Call this once when the router is initialized.
+     */
+    start(): () => void;
+    /**
+     * Navigate programmatically.
+     * The `to` path should not include the base path — it is prepended automatically.
+     */
+    navigate(to: string, options?: NavigateOptions): void;
+    /**
+     * Navigate to a page by its page ID.
+     * Looks up the route pattern from the page registry and builds the URL.
+     */
+    navigateToPage(pageId: string, params?: Record<string, string>, options?: NavigateOptions): void;
+    /**
+     * Build a URL path for a page ID with the given params.
+     * Path params are substituted into the route pattern; extra params become query string.
+     */
+    buildPagePath(pageId: string, params?: Record<string, string>): string;
+    /**
+     * Go back in history.
+     */
+    back(): void;
+    /**
+     * Go forward in history.
+     */
+    forward(): void;
+    /**
+     * Build a URL from a path pattern and params.
+     * The returned path includes the base path prefix.
+     */
+    buildPath(pattern: string, params?: Record<string, string>): string;
+    /**
+     * Strip the base path prefix from a pathname.
+     * Returns the pathname relative to the base path.
+     */
+    stripBasePath(pathname: string): string;
+    /**
+     * Resolve params for a route pattern by merging:
+     * 1. Explicitly provided params (highest priority)
+     * 2. Current URL match params
+     * 3. persistentParams() callback (fallback)
+     *
+     * Only fills params that are present in the target pattern.
+     */
+    resolveParams(pattern: string, explicitParams?: Record<string, string>): Record<string, string>;
+    /**
+     * Extract parameter names from a route pattern.
+     */
+    private extractParamNames;
+    /**
+     * Get merged params from all current route matches.
+     */
+    private getCurrentParams;
+    /**
+     * Trigger all registered invalidation listeners.
+     * Used to re-run page loaders in the background.
+     */
+    invalidateAll(): void;
+    /**
+     * Register an invalidation listener. Returns an unsubscribe function.
+     */
+    onInvalidate(listener: () => void): () => void;
+    /**
+     * Register a navigation blocker.
+     * The blocker function is called before each navigation.
+     * It must return a Promise that resolves to `true` to allow or `false` to block.
+     * Returns an unsubscribe function.
+     */
+    addBlocker(fn: BlockerFn): () => void;
+    /**
+     * Dispose the router — clear all subscribers and reset state.
+     */
+    dispose(): void;
+    /**
+     * Update the route tree (for HMR).
+     */
+    updateRoutes(routes: RouteNode[]): void;
+    /**
+     * Create a URL with basePath stripped for route matching.
+     */
+    private createMatchUrl;
+    private setState;
+}
+//# sourceMappingURL=router.d.ts.map