@rangojs/router 0.0.0-experimental.2 → 0.0.0-experimental.21

package/dist/browser/react/Link.js

@@ -0,0 +1,128 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { forwardRef, useCallback, useContext, useRef } from "react";
+import { NavigationStoreContext } from "./context.js";
+import { LinkContext } from "./use-link-status.js";
+import { isLocationStateEntry, resolveLocationStateEntries, } from "./location-state.js";
+// Track prefetched URLs to avoid duplicate <link> elements
+const prefetchedUrls = new Set();
+/**
+ * Inject a <link rel="prefetch"> element into the document head
+ * for the given URL with RSC partial request parameters.
+ */
+function prefetchUrl(url, segmentIds) {
+    if (prefetchedUrls.has(url))
+        return;
+    prefetchedUrls.add(url);
+    // Build RSC partial URL with segment IDs
+    const targetUrl = new URL(url, window.location.origin);
+    targetUrl.searchParams.set("_rsc_partial", "true");
+    if (segmentIds.length > 0) {
+        targetUrl.searchParams.set("_rsc_segments", segmentIds.join(","));
+    }
+    // Inject <link rel="prefetch"> into head
+    const link = document.createElement("link");
+    link.rel = "prefetch";
+    link.href = targetUrl.toString();
+    link.as = "fetch";
+    document.head.appendChild(link);
+}
+/**
+ * Check if URL is external (different origin)
+ */
+function isExternalUrl(href) {
+    // Protocol-relative URLs
+    if (href.startsWith("//"))
+        return true;
+    // Absolute URLs
+    if (href.startsWith("http://") || href.startsWith("https://")) {
+        try {
+            return new URL(href).origin !== window.location.origin;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Special protocols (mailto, tel, etc.)
+    if (/^[a-z][a-z0-9+.-]*:/i.test(href)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Type-safe Link component for SPA navigation
+ *
+ * Works with router.reverse() for type-safe URLs:
+ * ```tsx
+ * <Link to={router.reverse("shop.products.detail", { slug: "my-product" })}>
+ *   View Product
+ * </Link>
+ * ```
+ *
+ * Also supports regular URLs:
+ * ```tsx
+ * <Link to="/about">About</Link>
+ * <Link to="https://example.com">External</Link>
+ * ```
+ */
+export const Link = forwardRef(function Link({ to, replace = false, scroll = true, reloadDocument = false, prefetch = "none", state, children, onClick, ...props }, ref) {
+    const ctx = useContext(NavigationStoreContext);
+    const isExternal = isExternalUrl(to);
+    // Use ref to always get the latest state/getter without adding to useCallback deps
+    // This enables just-in-time state resolution without causing re-renders
+    const stateRef = useRef(state);
+    stateRef.current = state;
+    const handleClick = useCallback((e) => {
+        // Call user's onClick handler first
+        onClick?.(e);
+        // If user prevented default, respect that
+        if (e.defaultPrevented)
+            return;
+        // External links - let browser handle normally
+        if (isExternal)
+            return;
+        // Force document navigation if requested
+        if (reloadDocument)
+            return;
+        // Allow modifier keys for opening in new tab/window
+        if (e.metaKey || e.ctrlKey || e.shiftKey || e.altKey)
+            return;
+        // Check for download attribute
+        if (e.currentTarget.hasAttribute("download"))
+            return;
+        // Check for target attribute
+        const target = e.currentTarget.target;
+        if (target && target !== "_self")
+            return;
+        // Prevent default and use SPA navigation
+        e.preventDefault();
+        // Stop propagation to prevent link-interceptor from also handling this
+        e.stopPropagation();
+        if (ctx?.navigate) {
+            // Resolve state just-in-time based on format
+            let resolvedState;
+            const currentState = stateRef.current;
+            if (Array.isArray(currentState) && currentState.length > 0 && isLocationStateEntry(currentState[0])) {
+                // Type-safe LocationStateEntry[] - resolve each entry into keyed object
+                resolvedState = resolveLocationStateEntries(currentState);
+            }
+            else if (typeof currentState === "function") {
+                // Legacy getter function
+                resolvedState = currentState();
+            }
+            else {
+                // Legacy static value
+                resolvedState = currentState;
+            }
+            ctx.navigate(to, { replace, scroll, state: resolvedState });
+        }
+    }, [to, isExternal, reloadDocument, replace, scroll, ctx, onClick]);
+    const handleMouseEnter = useCallback(() => {
+        if (prefetch === "hover" && !isExternal && ctx?.store) {
+            const segmentState = ctx.store.getSegmentState();
+            prefetchUrl(to, segmentState.currentSegmentIds);
+        }
+    }, [prefetch, to, isExternal, ctx]);
+    return (_jsx("a", { ref: ref, href: to, onClick: handleClick, onMouseEnter: handleMouseEnter, "data-link-component": true, "data-external": isExternal ? "" : undefined, "data-scroll": scroll === false ? "false" : undefined, "data-replace": replace ? "true" : undefined, ...props, children: _jsx(LinkContext.Provider, { value: to, children: children }) }));
+});
+//# sourceMappingURL=Link.js.map

package/dist/browser/react/Link.js.map

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

package/dist/browser/react/NavigationProvider.d.ts

@@ -0,0 +1,63 @@
+import { type ReactNode } from "react";
+import type { NavigationStore, RscPayload, NavigationBridge } from "../types.js";
+import type { EventController } from "../event-controller.js";
+import type { ResolvedThemeConfig, Theme } from "../../theme/types.js";
+/**
+ * Props for NavigationProvider
+ */
+export interface NavigationProviderProps {
+    /**
+     * Navigation store instance (for cache/segment management)
+     */
+    store: NavigationStore;
+    /**
+     * Event controller instance (for navigation/action state)
+     */
+    eventController: EventController;
+    /**
+     * Initial RSC payload from server
+     */
+    initialPayload: RscPayload;
+    /**
+     * Navigation bridge for handling navigation
+     */
+    bridge: NavigationBridge;
+    /**
+     * Theme configuration (null if theme not enabled)
+     * When provided, wraps content in ThemeProvider
+     */
+    themeConfig?: ResolvedThemeConfig | null;
+    /**
+     * Initial theme from server (from cookie)
+     * Only used when themeConfig is provided
+     */
+    initialTheme?: Theme;
+    /**
+     * Whether connection warmup is enabled.
+     * When true, keeps TLS alive by sending HEAD requests after idle periods.
+     */
+    warmupEnabled?: boolean;
+}
+/**
+ * Navigation provider component
+ *
+ * Provides navigation context to the component tree and handles:
+ * - Providing stable store and event controller references (never re-renders consumers)
+ * - Subscribing to UI updates to re-render the tree
+ * - Providing navigate/refresh methods (delegated to bridge)
+ *
+ * State subscriptions happen via useNavigation hook (via event controller), not via context.
+ * This means context consumers don't re-render on state changes.
+ *
+ * @example
+ * ```tsx
+ * <NavigationProvider
+ *   store={store}
+ *   eventController={eventController}
+ *   initialPayload={payload}
+ *   bridge={navigationBridge}
+ * />
+ * ```
+ */
+export declare function NavigationProvider({ store, eventController, initialPayload, bridge, themeConfig, initialTheme, warmupEnabled, }: NavigationProviderProps): ReactNode;
+//# sourceMappingURL=NavigationProvider.d.ts.map

package/dist/browser/react/NavigationProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationProvider.d.ts","sourceRoot":"","sources":["../../../src/browser/react/NavigationProvider.tsx"],"names":[],"mappings":"AAEA,OAAc,EAMZ,KAAK,SAAS,EACf,MAAM,OAAO,CAAC;AAKf,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EAEV,gBAAgB,EACjB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AA+DvE;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,KAAK,EAAE,eAAe,CAAC;IAEvB;;OAEG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;OAEG;IACH,cAAc,EAAE,UAAU,CAAC;IAE3B;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAEzC;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,EACjC,KAAK,EACL,eAAe,EACf,cAAc,EACd,MAAM,EACN,WAAW,EACX,YAAY,EACZ,aAAa,GACd,EAAE,uBAAuB,GAAG,SAAS,CA0LrC"}

package/dist/browser/react/NavigationProvider.js

@@ -0,0 +1,216 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useState, useEffect, useCallback, useMemo, use, } from "react";
+import { NavigationStoreContext, } from "./context.js";
+import { RootErrorBoundary } from "../../root-error-boundary.js";
+import { ThemeProvider } from "../../theme/ThemeProvider.js";
+/**
+ * Process handles from an async generator, updating the event controller
+ * and cache as data streams in.
+ *
+ * This handles:
+ * 1. Consuming the async generator and calling setHandleData on each yield
+ * 2. Stopping early if user navigates away (historyKey changes)
+ * 3. Cleaning up stale data when generator yields nothing
+ * 4. Updating the cache after processing completes (if still on same page)
+ */
+async function processHandles(handlesGenerator, opts) {
+    const { eventController, store, matched, isPartial, historyKey } = opts;
+    let yieldCount = 0;
+    for await (const handleData of handlesGenerator) {
+        // Check if user navigated away before each update.
+        // This prevents handle data from cancelled navigations polluting
+        // the current route's breadcrumbs (e.g., quick popstate after clicking a link).
+        if (historyKey !== store.getHistoryKey()) {
+            console.log("[NavigationProvider] Stopping handle processing - user navigated away");
+            return;
+        }
+        yieldCount++;
+        eventController.setHandleData(handleData, matched, isPartial);
+    }
+    // Check again before final updates
+    if (historyKey !== store.getHistoryKey()) {
+        return;
+    }
+    // For partial updates where the generator yielded nothing (cached handlers),
+    // we still need to update the segment order to clean up stale handle data.
+    // This happens when navigating away from a route - the handlers for the new
+    // route might not push any breadcrumbs, but we still need to remove the old ones.
+    if (yieldCount === 0 && matched) {
+        eventController.setHandleData({}, matched, true);
+    }
+    // After handles processing completes, update the cache's handleData.
+    // This fixes a race condition where commit() caches stale handleData before
+    // the async handles processing completes.
+    // Only update if we're still on the same page (historyKey matches).
+    if (historyKey === store.getHistoryKey()) {
+        const finalHandleData = eventController.getHandleState().data;
+        store.updateCacheHandleData(historyKey, finalHandleData);
+    }
+}
+/**
+ * Navigation provider component
+ *
+ * Provides navigation context to the component tree and handles:
+ * - Providing stable store and event controller references (never re-renders consumers)
+ * - Subscribing to UI updates to re-render the tree
+ * - Providing navigate/refresh methods (delegated to bridge)
+ *
+ * State subscriptions happen via useNavigation hook (via event controller), not via context.
+ * This means context consumers don't re-render on state changes.
+ *
+ * @example
+ * ```tsx
+ * <NavigationProvider
+ *   store={store}
+ *   eventController={eventController}
+ *   initialPayload={payload}
+ *   bridge={navigationBridge}
+ * />
+ * ```
+ */
+export function NavigationProvider({ store, eventController, initialPayload, bridge, themeConfig, initialTheme, warmupEnabled, }) {
+    // Track current payload for rendering (this triggers re-renders)
+    const [payload, setPayload] = useState(initialPayload);
+    /**
+     * Navigate to a URL (delegates to bridge)
+     */
+    const navigate = useCallback(async (url, options) => {
+        await bridge.navigate(url, options);
+    }, []);
+    /**
+     * Refresh current route (delegates to bridge)
+     */
+    const refresh = useCallback(async () => {
+        await bridge.refresh();
+    }, []);
+    // Context value is stable (store, eventController, navigate, refresh never change)
+    const contextValue = useMemo(() => ({
+        store,
+        eventController,
+        navigate,
+        refresh,
+    }), []);
+    // Connection warmup: keep TLS alive after idle periods.
+    // After 60s of no user interaction, marks connection as "cold".
+    // On next interaction or visibility change, sends a HEAD request to warm TLS
+    // before the user actually clicks a link.
+    useEffect(() => {
+        if (!warmupEnabled)
+            return;
+        const IDLE_TIMEOUT = 60000;
+        const DEBOUNCE_DELAY = 150;
+        let idleTimer;
+        let debounceTimer;
+        let isCold = false;
+        let warmupListenersAttached = false;
+        function sendWarmup() {
+            isCold = false;
+            fetch("/?_rsc_warmup", { method: "HEAD" }).catch(() => { });
+        }
+        function triggerWarmup() {
+            if (!isCold)
+                return;
+            clearTimeout(debounceTimer);
+            debounceTimer = setTimeout(() => {
+                sendWarmup();
+                detachWarmupListeners();
+                resetIdleTimer();
+            }, DEBOUNCE_DELAY);
+        }
+        function onVisibilityChange() {
+            if (document.visibilityState === "visible" && isCold) {
+                triggerWarmup();
+            }
+        }
+        function attachWarmupListeners() {
+            if (warmupListenersAttached)
+                return;
+            warmupListenersAttached = true;
+            document.addEventListener("visibilitychange", onVisibilityChange);
+            document.addEventListener("mousemove", triggerWarmup, { once: true });
+            document.addEventListener("touchstart", triggerWarmup, { once: true });
+        }
+        function detachWarmupListeners() {
+            warmupListenersAttached = false;
+            document.removeEventListener("visibilitychange", onVisibilityChange);
+            document.removeEventListener("mousemove", triggerWarmup);
+            document.removeEventListener("touchstart", triggerWarmup);
+        }
+        function markCold() {
+            isCold = true;
+            attachWarmupListeners();
+        }
+        function resetIdleTimer() {
+            clearTimeout(idleTimer);
+            isCold = false;
+            idleTimer = setTimeout(markCold, IDLE_TIMEOUT);
+        }
+        // Activity events that reset the idle timer
+        const activityEvents = ["mousemove", "keydown", "touchstart", "scroll"];
+        const activityOptions = { passive: true };
+        for (const event of activityEvents) {
+            document.addEventListener(event, resetIdleTimer, activityOptions);
+        }
+        resetIdleTimer();
+        return () => {
+            clearTimeout(idleTimer);
+            clearTimeout(debounceTimer);
+            detachWarmupListeners();
+            for (const event of activityEvents) {
+                document.removeEventListener(event, resetIdleTimer);
+            }
+        };
+    }, [warmupEnabled]);
+    // Subscribe to UI updates (for re-rendering the tree)
+    useEffect(() => {
+        const unsubscribe = store.onUpdate((update) => {
+            setPayload({
+                root: update.root,
+                metadata: update.metadata,
+            });
+            // Update handle data progressively as it streams in
+            if (update.metadata.handles) {
+                // Capture historyKey now - by the time async processing completes,
+                // the user might have navigated elsewhere
+                const historyKey = store.getHistoryKey();
+                processHandles(update.metadata.handles, {
+                    eventController,
+                    store,
+                    matched: update.metadata.matched,
+                    isPartial: update.metadata.isPartial,
+                    historyKey,
+                }).catch((err) => console.error("[NavigationProvider] Error consuming handles:", err));
+            }
+            else if (update.metadata.cachedHandleData) {
+                // For back/forward navigation from cache, restore the cached handleData
+                // This restores breadcrumbs to the exact state they were when the page was cached
+                eventController.setHandleData(update.metadata.cachedHandleData, update.metadata.matched, false // full replace - restore entire cached state
+                );
+            }
+            else if (update.metadata.matched) {
+                // For cached navigations without handleData, update segmentOrder to clean up stale data
+                eventController.setHandleData({}, // Empty data - all existing data not in matched will be cleaned up
+                update.metadata.matched, true // partial update - will clean up segments not in matched
+                );
+            }
+        });
+        return unsubscribe;
+    }, []);
+    // Handle promise case - use() will suspend until resolved
+    const root = payload.root instanceof Promise ? use(payload.root) : payload.root;
+    // Wrap content in RootErrorBoundary to catch:
+    // 1. Errors from NetworkErrorThrower (rendered during network failures)
+    // 2. Client component errors that occur before/outside the segment tree's error boundary
+    // 3. Errors during promise resolution or navigation state updates
+    // This acts as a safety net - the segment tree has its own RootErrorBoundary that
+    // catches most errors, but this outer boundary catches anything that slips through.
+    // Build the content tree
+    let content = _jsx(RootErrorBoundary, { children: root });
+    // Wrap with ThemeProvider when theme is enabled
+    if (themeConfig) {
+        content = (_jsx(ThemeProvider, { config: themeConfig, initialTheme: initialTheme, children: content }));
+    }
+    return (_jsx(NavigationStoreContext.Provider, { value: contextValue, children: content }));
+}
+//# sourceMappingURL=NavigationProvider.js.map

package/dist/browser/react/NavigationProvider.js.map

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

package/dist/browser/react/ScrollRestoration.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Props for ScrollRestoration component
+ */
+export interface ScrollRestorationProps {
+    /**
+     * Custom function to determine the scroll restoration key.
+     * By default, uses a unique key per history entry (location.key).
+     *
+     * Return location.pathname to restore scroll based on path
+     * (useful for keeping scroll position on the same page).
+     *
+     * @example
+     * ```tsx
+     * // Restore based on pathname (same URL = same scroll)
+     * <ScrollRestoration
+     *   getKey={(location) => location.pathname}
+     * />
+     *
+     * // Restore based on unique history entry (default)
+     * <ScrollRestoration
+     *   getKey={(location) => location.key}
+     * />
+     * ```
+     */
+    getKey?: (location: {
+        pathname: string;
+        search: string;
+        hash: string;
+        key: string;
+    }) => string;
+}
+/**
+ * ScrollRestoration component
+ *
+ * Enables scroll position restoration across navigations:
+ * - Saves scroll positions to sessionStorage
+ * - Restores scroll on back/forward navigation
+ * - Scrolls to top on new navigation
+ * - Supports hash link scrolling
+ *
+ * Should be rendered once in your app, typically in the root layout.
+ *
+ * @example
+ * ```tsx
+ * // In your root layout
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <ScrollRestoration />
+ *         {children}
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export declare function ScrollRestoration({ getKey }: ScrollRestorationProps): null;
+/**
+ * Hook to initialize scroll restoration
+ *
+ * Alternative to the ScrollRestoration component for more control.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   useScrollRestoration();
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export declare function useScrollRestoration(options?: {
+    getKey?: ScrollRestorationProps["getKey"];
+}): void;
+//# sourceMappingURL=ScrollRestoration.d.ts.map

package/dist/browser/react/ScrollRestoration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollRestoration.d.ts","sourceRoot":"","sources":["../../../src/browser/react/ScrollRestoration.tsx"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,KAAK,MAAM,CAAC;CACd;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,MAAM,EAAE,EAAE,sBAAsB,QAQnE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IAC7C,MAAM,CAAC,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;CAC3C,GAAG,IAAI,CAKP"}

package/dist/browser/react/ScrollRestoration.js

@@ -0,0 +1,57 @@
+"use client";
+import { useEffect } from "react";
+import { initScrollRestoration } from "../scroll-restoration.js";
+/**
+ * ScrollRestoration component
+ *
+ * Enables scroll position restoration across navigations:
+ * - Saves scroll positions to sessionStorage
+ * - Restores scroll on back/forward navigation
+ * - Scrolls to top on new navigation
+ * - Supports hash link scrolling
+ *
+ * Should be rendered once in your app, typically in the root layout.
+ *
+ * @example
+ * ```tsx
+ * // In your root layout
+ * export default function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>
+ *         <ScrollRestoration />
+ *         {children}
+ *       </body>
+ *     </html>
+ *   );
+ * }
+ * ```
+ */
+export function ScrollRestoration({ getKey }) {
+    useEffect(() => {
+        const cleanup = initScrollRestoration({ getKey });
+        return cleanup;
+    }, [getKey]);
+    // This component doesn't render anything
+    return null;
+}
+/**
+ * Hook to initialize scroll restoration
+ *
+ * Alternative to the ScrollRestoration component for more control.
+ *
+ * @example
+ * ```tsx
+ * function App() {
+ *   useScrollRestoration();
+ *   return <div>...</div>;
+ * }
+ * ```
+ */
+export function useScrollRestoration(options) {
+    useEffect(() => {
+        const cleanup = initScrollRestoration({ getKey: options?.getKey });
+        return cleanup;
+    }, [options?.getKey]);
+}
+//# sourceMappingURL=ScrollRestoration.js.map

package/dist/browser/react/ScrollRestoration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScrollRestoration.js","sourceRoot":"","sources":["../../../src/browser/react/ScrollRestoration.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAkCjE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAE,MAAM,EAA0B;IAClE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAClD,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;IAEb,yCAAyC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAEpC;IACC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,qBAAqB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC;IACjB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/browser/react/context.d.ts

@@ -0,0 +1,46 @@
+import { type Context } from "react";
+import type { NavigationStore, NavigateOptions } from "../types.js";
+import type { EventController } from "../event-controller.js";
+/**
+ * Navigation context value provided by NavigationProvider
+ *
+ * This context provides a STABLE reference to the store, event controller, and methods.
+ * The store itself never changes, so context consumers don't re-render
+ * when navigation state changes.
+ *
+ * Components subscribe to state changes via eventController.subscribe() in useNavigation.
+ */
+export interface NavigationStoreContextValue {
+    /**
+     * The navigation store instance (stable reference)
+     * Used for cache/segment management
+     */
+    store: NavigationStore;
+    /**
+     * The event controller instance (stable reference)
+     * Used for navigation/action state
+     */
+    eventController: EventController;
+    /**
+     * Navigate to a new URL
+     *
+     * @param url - The URL to navigate to
+     * @param options - Navigation options (replace, scroll)
+     * @returns Promise that resolves when navigation is complete
+     */
+    navigate: (url: string, options?: NavigateOptions) => Promise<void>;
+    /**
+     * Refresh the current route
+     *
+     * @returns Promise that resolves when refresh is complete
+     */
+    refresh: () => Promise<void>;
+}
+/**
+ * React context for navigation store
+ *
+ * Provides stable reference to the store - does NOT re-render on state changes.
+ * Use useNavigation hook for reactive state access.
+ */
+export declare const NavigationStoreContext: Context<NavigationStoreContextValue | null>;
+//# sourceMappingURL=context.d.ts.map

package/dist/browser/react/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/browser/react/context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;GAQG;AACH,MAAM,WAAW,2BAA2B;IAC1C;;;OAGG;IACH,KAAK,EAAE,eAAe,CAAC;IAEvB;;;OAGG;IACH,eAAe,EAAE,eAAe,CAAC;IAEjC;;;;;;OAMG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;OAIG;IACH,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAAO,CAAC,2BAA2B,GAAG,IAAI,CACtB,CAAC"}

package/dist/browser/react/context.js

@@ -0,0 +1,10 @@
+"use client";
+import { createContext } from "react";
+/**
+ * React context for navigation store
+ *
+ * Provides stable reference to the store - does NOT re-render on state changes.
+ * Use useNavigation hook for reactive state access.
+ */
+export const NavigationStoreContext = createContext(null);
+//# sourceMappingURL=context.js.map

package/dist/browser/react/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/browser/react/context.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAgB,MAAM,OAAO,CAAC;AA2CpD;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GACjC,aAAa,CAAqC,IAAI,CAAC,CAAC"}

package/dist/browser/react/index.d.ts

@@ -0,0 +1,11 @@
+export { useNavigation, type NavigationMethods, type NavigationValue, } from "./use-navigation.js";
+export { useAction, type TrackedActionState } from "./use-action.js";
+export { useSegments, initSegmentsSync, type SegmentsState } from "./use-segments.js";
+export { useHandle, initHandleDataSync } from "./use-handle.js";
+export { useClientCache, type ClientCacheControls, } from "./use-client-cache.js";
+export { NavigationProvider, type NavigationProviderProps, } from "./NavigationProvider.js";
+export { NavigationStoreContext, type NavigationStoreContextValue, } from "./context.js";
+export { Link, type LinkProps, type PrefetchStrategy, } from "./Link.js";
+export { useLinkStatus, type LinkStatus } from "./use-link-status.js";
+export { ScrollRestoration, useScrollRestoration, type ScrollRestorationProps, } from "./ScrollRestoration.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/browser/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/browser/react/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,aAAa,EACb,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,SAAS,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGrE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGtF,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGhE,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,kBAAkB,EAClB,KAAK,uBAAuB,GAC7B,MAAM,yBAAyB,CAAC;AAGjC,OAAO,EACL,sBAAsB,EACtB,KAAK,2BAA2B,GACjC,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,IAAI,EACJ,KAAK,SAAS,EACd,KAAK,gBAAgB,GACtB,MAAM,WAAW,CAAC;AAGnB,OAAO,EAAE,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGtE,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,sBAAsB,GAC5B,MAAM,wBAAwB,CAAC"}