@cmj/juice 0.4.0 → 0.6.0

package/dist/client/Link.d.ts

@@ -0,0 +1,74 @@
+import { type AnchorHTMLAttributes, type ReactNode, type CSSProperties, type Ref } from 'react';
+/**
+ * Prefetch strategy for the `<Link>` component.
+ *
+ * - `'hover'` — Prefetch when the user hovers or focuses the link. *(default)*
+ * - `'viewport'` — Prefetch when the link scrolls into the viewport.
+ * - `'none'` — No automatic prefetching.
+ */
+export type PrefetchStrategy = 'hover' | 'viewport' | 'none';
+/**
+ * Props for the `<Link>` component.
+ *
+ * Extends all standard `<a>` HTML attributes so you can pass
+ * `target`, `rel`, `aria-*`, `data-*`, etc. directly.
+ */
+export interface LinkProps extends Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> {
+    /** The URL to navigate to. Required. */
+    href: string;
+    /**
+     * Prefetch strategy.
+     * @default 'hover'
+     */
+    prefetch?: PrefetchStrategy;
+    /**
+     * Replace the current history entry instead of pushing a new one.
+     * @default false
+     */
+    replace?: boolean;
+    /**
+     * Scroll to the top after navigation.
+     * @default true
+     */
+    scroll?: boolean;
+    /**
+     * CSS class name applied when the link's `href` matches the
+     * current pathname.
+     */
+    activeClassName?: string;
+    /**
+     * Inline styles applied when the link's `href` matches the
+     * current pathname.
+     */
+    activeStyle?: CSSProperties;
+    /** React ref forwarded to the underlying `<a>` element. */
+    ref?: Ref<HTMLAnchorElement>;
+    children?: ReactNode;
+}
+/**
+ * Client-side navigation link for Juice SPA apps.
+ *
+ * Renders a standard `<a>` tag that works with or without JavaScript.
+ * When the Navigation API is available and `initNavigation()` has been
+ * called, clicking this link fetches an RSC payload instead of causing
+ * a full page reload.
+ *
+ * @example
+ * ```tsx
+ * import { Link } from '@cmj/juice/client';
+ *
+ * // Basic usage
+ * <Link href="/about">About</Link>
+ *
+ * // Viewport prefetching
+ * <Link href="/products" prefetch="viewport">Products</Link>
+ *
+ * // Active link styling
+ * <Link href="/blog" activeClassName="nav-active">Blog</Link>
+ *
+ * // Replace history entry
+ * <Link href="/login" replace>Log in</Link>
+ * ```
+ */
+export declare function Link(props: LinkProps): ReactNode;
+//# sourceMappingURL=Link.d.ts.map

package/dist/client/Link.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../src/client/Link.ts"],"names":[],"mappings":"AAOA,OAAO,EAKL,KAAK,oBAAoB,EACzB,KAAK,SAAS,EACd,KAAK,aAAa,EAClB,KAAK,GAAG,EACT,MAAM,OAAO,CAAC;AAYf;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,MAAM,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACtF,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAE5B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC;IAE5B,2DAA2D;IAC3D,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAE7B,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAmBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,CAmHhD"}

package/dist/client/Link.js

@@ -0,0 +1,132 @@
+// ── juice/client — <Link> component ───────────────────────────────
+// Declarative SPA navigation for Juice. Renders a standard `<a>` tag
+// with built-in RSC prefetching and active-state detection.
+//
+// Progressive enhancement: works as a normal link without JS.
+// ──────────────────────────────────────────────────────────────────
+import { createElement, useRef, useEffect, useSyncExternalStore, } from 'react';
+import { prefetchRSC, isSameOrigin, _subscribeToPathname, _getPathnameSnapshot, _getServerPathnameSnapshot, } from './nav.js';
+// ── Helpers ───────────────────────────────────────────────────────
+/**
+ * Check if a pathname matches the link's href.
+ * Exact match — `/about` matches `/about`, not `/about/team`.
+ */
+function isActive(href, pathname) {
+    try {
+        const url = new URL(href, 'http://n');
+        return url.pathname === pathname;
+    }
+    catch {
+        return href === pathname;
+    }
+}
+// ── Component ─────────────────────────────────────────────────────
+/**
+ * Client-side navigation link for Juice SPA apps.
+ *
+ * Renders a standard `<a>` tag that works with or without JavaScript.
+ * When the Navigation API is available and `initNavigation()` has been
+ * called, clicking this link fetches an RSC payload instead of causing
+ * a full page reload.
+ *
+ * @example
+ * ```tsx
+ * import { Link } from '@cmj/juice/client';
+ *
+ * // Basic usage
+ * <Link href="/about">About</Link>
+ *
+ * // Viewport prefetching
+ * <Link href="/products" prefetch="viewport">Products</Link>
+ *
+ * // Active link styling
+ * <Link href="/blog" activeClassName="nav-active">Blog</Link>
+ *
+ * // Replace history entry
+ * <Link href="/login" replace>Log in</Link>
+ * ```
+ */
+export function Link(props) {
+    const { href, prefetch = 'hover', replace = false, scroll, activeClassName, activeStyle, className, style, children, onPointerEnter, onFocus, ref: externalRef, ...rest } = props;
+    const internalRef = useRef(null);
+    // Merge refs
+    const setRef = (el) => {
+        internalRef.current = el;
+        if (typeof externalRef === 'function') {
+            externalRef(el);
+        }
+        else if (externalRef && typeof externalRef === 'object') {
+            externalRef.current = el;
+        }
+    };
+    // ── Active state ──────────────────────────────────────────────
+    const pathname = useSyncExternalStore(_subscribeToPathname, _getPathnameSnapshot, _getServerPathnameSnapshot);
+    const active = isActive(href, pathname);
+    // ── Viewport prefetching ──────────────────────────────────────
+    useEffect(() => {
+        if (prefetch !== 'viewport')
+            return;
+        const el = internalRef.current;
+        if (!el)
+            return;
+        if (!('IntersectionObserver' in globalThis))
+            return;
+        const observer = new IntersectionObserver((entries) => {
+            for (const entry of entries) {
+                if (entry.isIntersecting) {
+                    const resolvedUrl = new URL(href, location.href).href;
+                    prefetchRSC(resolvedUrl);
+                    observer.unobserve(entry.target);
+                }
+            }
+        }, { rootMargin: '200px' });
+        observer.observe(el);
+        return () => observer.disconnect();
+    }, [href, prefetch]);
+    // ── Hover/focus prefetching ───────────────────────────────────
+    const handlePointerEnter = (e) => {
+        if (prefetch === 'hover' && isSameOrigin(href)) {
+            prefetchRSC(new URL(href, location.href).href);
+        }
+        onPointerEnter?.(e);
+    };
+    const handleFocus = (e) => {
+        if (prefetch === 'hover' && isSameOrigin(href)) {
+            prefetchRSC(new URL(href, location.href).href);
+        }
+        onFocus?.(e);
+    };
+    // ── Merge class names ─────────────────────────────────────────
+    const resolvedClassName = active && activeClassName
+        ? className
+            ? `${className} ${activeClassName}`
+            : activeClassName
+        : className;
+    // ── Merge styles ──────────────────────────────────────────────
+    const resolvedStyle = active && activeStyle
+        ? style
+            ? { ...style, ...activeStyle }
+            : activeStyle
+        : style;
+    // ── Build anchor props ────────────────────────────────────────
+    const anchorProps = {
+        ...rest,
+        href,
+        ref: setRef,
+        className: resolvedClassName,
+        style: resolvedStyle,
+        onPointerEnter: handlePointerEnter,
+        onFocus: handleFocus,
+        'data-active': active || undefined,
+    };
+    // Signal prefetch strategy to the DOM for IntersectionObserver
+    if (prefetch === 'viewport') {
+        anchorProps['data-prefetch'] = '';
+    }
+    // Signal replace intent
+    if (replace) {
+        anchorProps['data-replace'] = '';
+    }
+    return createElement('a', anchorProps, children);
+}
+//# sourceMappingURL=Link.js.map

package/dist/client/Link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Link.js","sourceRoot":"","sources":["../../src/client/Link.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,qEAAqE;AACrE,4DAA4D;AAC5D,EAAE;AACF,8DAA8D;AAC9D,qEAAqE;AAErE,OAAO,EACL,aAAa,EACb,MAAM,EACN,SAAS,EACT,oBAAoB,GAKrB,MAAM,OAAO,CAAC;AAEf,OAAO,EACL,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AA2DlB,qEAAqE;AAErE;;;GAGG;AACH,SAAS,QAAQ,CAAC,IAAY,EAAE,QAAgB;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACtC,OAAO,GAAG,CAAC,QAAQ,KAAK,QAAQ,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,KAAK,QAAQ,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,qEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,IAAI,CAAC,KAAgB;IACnC,MAAM,EACJ,IAAI,EACJ,QAAQ,GAAG,OAAO,EAClB,OAAO,GAAG,KAAK,EACf,MAAM,EACN,eAAe,EACf,WAAW,EACX,SAAS,EACT,KAAK,EACL,QAAQ,EACR,cAAc,EACd,OAAO,EACP,GAAG,EAAE,WAAW,EAChB,GAAG,IAAI,EACR,GAAG,KAAK,CAAC;IAEV,MAAM,WAAW,GAAG,MAAM,CAAoB,IAAI,CAAC,CAAC;IAEpD,aAAa;IACb,MAAM,MAAM,GAAG,CAAC,EAA4B,EAAE,EAAE;QAC7C,WAAmB,CAAC,OAAO,GAAG,EAAE,CAAC;QAClC,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;YACtC,WAAW,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACzD,WAAmB,CAAC,OAAO,GAAG,EAAE,CAAC;QACpC,CAAC;IACH,CAAC,CAAC;IAEF,iEAAiE;IACjE,MAAM,QAAQ,GAAG,oBAAoB,CACnC,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,CAC3B,CAAC;IAEF,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAExC,iEAAiE;IACjE,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,QAAQ,KAAK,UAAU;YAAE,OAAO;QAEpC,MAAM,EAAE,GAAG,WAAW,CAAC,OAAO,CAAC;QAC/B,IAAI,CAAC,EAAE;YAAE,OAAO;QAChB,IAAI,CAAC,CAAC,sBAAsB,IAAI,UAAU,CAAC;YAAE,OAAO;QAEpD,MAAM,QAAQ,GAAG,IAAI,oBAAoB,CACvC,CAAC,OAAO,EAAE,EAAE;YACV,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC;oBACzB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;oBACtD,WAAW,CAAC,WAAW,CAAC,CAAC;oBACzB,QAAQ,CAAC,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;QACH,CAAC,EACD,EAAE,UAAU,EAAE,OAAO,EAAE,CACxB,CAAC;QAEF,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACrB,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IAErB,iEAAiE;IACjE,MAAM,kBAAkB,GAAG,CAAC,CAAM,EAAE,EAAE;QACpC,IAAI,QAAQ,KAAK,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,cAAc,EAAE,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,CAAM,EAAE,EAAE;QAC7B,IAAI,QAAQ,KAAK,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YAC/C,WAAW,CAAC,IAAI,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACf,CAAC,CAAC;IAEF,iEAAiE;IACjE,MAAM,iBAAiB,GAAG,MAAM,IAAI,eAAe;QACjD,CAAC,CAAC,SAAS;YACT,CAAC,CAAC,GAAG,SAAS,IAAI,eAAe,EAAE;YACnC,CAAC,CAAC,eAAe;QACnB,CAAC,CAAC,SAAS,CAAC;IAEd,iEAAiE;IACjE,MAAM,aAAa,GAAG,MAAM,IAAI,WAAW;QACzC,CAAC,CAAC,KAAK;YACL,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,WAAW,EAAE;YAC9B,CAAC,CAAC,WAAW;QACf,CAAC,CAAC,KAAK,CAAC;IAEV,iEAAiE;IACjE,MAAM,WAAW,GAA4B;QAC3C,GAAG,IAAI;QACP,IAAI;QACJ,GAAG,EAAE,MAAM;QACX,SAAS,EAAE,iBAAiB;QAC5B,KAAK,EAAE,aAAa;QACpB,cAAc,EAAE,kBAAkB;QAClC,OAAO,EAAE,WAAW;QACpB,aAAa,EAAE,MAAM,IAAI,SAAS;KACnC,CAAC;IAEF,+DAA+D;IAC/D,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;QAC5B,WAAW,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;IAED,wBAAwB;IACxB,IAAI,OAAO,EAAE,CAAC;QACZ,WAAW,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC;IACnC,CAAC;IAED,OAAO,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC"}

package/dist/client/client.d.ts

@@ -1,4 +1,5 @@
 import { type ReactNode } from 'react';
+export { RSC_CONTENT_TYPE, prefetchRSC, isSameOrigin, _subscribeToPathname, _getPathnameSnapshot, _getServerPathnameSnapshot, } from './nav.js';
 /**
  * Callback to update the React root with a new RSC payload.
  * Set by `initNavigation()`.
@@ -53,5 +54,4 @@ export interface NavigationOptions {
  * ```
  */
 export declare function initNavigation(setPage: PageSetter, options?: NavigationOptions): () => void;
-export {};
 //# sourceMappingURL=client.d.ts.map

package/dist/client/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AASxD;;;GAGG;AACH,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAoGD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,IAAI,CAmFZ"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client/client.ts"],"names":[],"mappings":"AASA,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAWxD,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AAElB;;;GAGG;AACH,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;OAGG;IACH,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChE;AAuED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,UAAU,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,IAAI,CA+EZ"}

package/dist/client/client.js

@@ -8,24 +8,9 @@
 // ────────────────────────────────────────────────────────────────────
 import { startTransition } from 'react';
 import { createFromFetch } from 'react-server-dom-webpack/client.browser';
-/**
- * The RSC content type used for payload negotiation.
- * Must match the server's `RSC_CONTENT_TYPE` in `rsc.ts`.
- */
-const RSC_CONTENT_TYPE = 'text/x-component';
-// ── Prefetch cache ────────────────────────────────────────────────
-const prefetchCache = new Map();
-function prefetchRSC(url) {
-    if (prefetchCache.has(url))
-        return;
-    const promise = fetch(url, {
-        headers: { 'Accept': RSC_CONTENT_TYPE },
-        priority: 'low',
-    });
-    prefetchCache.set(url, promise);
-    // Expire after 30 seconds to avoid stale data
-    setTimeout(() => prefetchCache.delete(url), 30_000);
-}
+import { RSC_CONTENT_TYPE, prefetchRSC, _consumePrefetch, isSameOrigin, } from './nav.js';
+// Re-export shared utilities for backward compatibility
+export { RSC_CONTENT_TYPE, prefetchRSC, isSameOrigin, _subscribeToPathname, _getPathnameSnapshot, _getServerPathnameSnapshot, } from './nav.js';
 // ── Prefetch observer ─────────────────────────────────────────────
 function setupPrefetching() {
     // Prefetch on hover (desktop) and focus (keyboard nav)
@@ -80,16 +65,6 @@ function setupPrefetching() {
         }).observe(document.body, { childList: true, subtree: true });
     }
 }
-// ── Helpers ───────────────────────────────────────────────────────
-function isSameOrigin(href) {
-    try {
-        const url = new URL(href, location.href);
-        return url.origin === location.origin;
-    }
-    catch {
-        return false;
-    }
-}
 // ── View Transitions wrapper ──────────────────────────────────────
 function withViewTransition(enabled, fn) {
     if (enabled && 'startViewTransition' in document) {
@@ -166,15 +141,12 @@ export function initNavigation(setPage, options = {}) {
             scroll: 'after-transition',
             async handler() {
                 const url = event.destination.url;
-                // Use prefetched response if available
-                const fetchPromise = prefetchCache.has(url)
-                    ? prefetchCache.get(url)
-                    : fetch(url, {
+                // Use prefetched response if available, otherwise fetch
+                const fetchPromise = _consumePrefetch(url)
+                    ?? fetch(url, {
                         headers: { 'Accept': RSC_CONTENT_TYPE },
                         signal: event.signal,
                     });
-                // Clear the prefetch cache entry
-                prefetchCache.delete(url);
                 // Decode the RSC payload
                 const rscPayload = createFromFetch(fetchPromise, {
                     callServer,

package/dist/client/client.js.map

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

package/dist/client/hooks.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Return type of `useRouter()`.
+ */
+export interface Router {
+    /** The current pathname (reactive — re-renders on navigation). */
+    pathname: string;
+    /**
+     * Navigate to a URL, pushing a new history entry.
+     *
+     * @param url - The URL to navigate to.
+     *
+     * @example
+     * ```ts
+     * const router = useRouter();
+     * router.push('/product/42');
+     * ```
+     */
+    push: (url: string) => void;
+    /**
+     * Navigate to a URL, replacing the current history entry.
+     *
+     * @param url - The URL to navigate to.
+     *
+     * @example
+     * ```ts
+     * const router = useRouter();
+     * router.replace('/login');
+     * ```
+     */
+    replace: (url: string) => void;
+    /**
+     * Prefetch an RSC payload for a URL. Idempotent — duplicate
+     * calls for the same URL are no-ops until the cache expires.
+     *
+     * @param url - The URL to prefetch.
+     *
+     * @example
+     * ```ts
+     * const router = useRouter();
+     * router.prefetch('/dashboard');
+     * ```
+     */
+    prefetch: (url: string) => void;
+    /**
+     * Go back in history. Equivalent to `history.back()`.
+     */
+    back: () => void;
+    /**
+     * Go forward in history. Equivalent to `history.forward()`.
+     */
+    forward: () => void;
+}
+/**
+ * Programmatic navigation hook for Juice SPA apps.
+ *
+ * Returns a stable `Router` object with `push`, `replace`, `prefetch`,
+ * `back`, `forward`, and a reactive `pathname`.
+ *
+ * Uses the Navigation API when available. Falls back to `location.assign`
+ * when the Navigation API is absent (MPA mode — full page reload).
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useRouter } from '@cmj/juice/client';
+ *
+ * function SearchBar() {
+ *   const router = useRouter();
+ *
+ *   function handleSubmit(e: FormEvent) {
+ *     e.preventDefault();
+ *     const q = new FormData(e.currentTarget).get('q');
+ *     router.push(`/search?q=${encodeURIComponent(q)}`);
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="q" />
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export declare function useRouter(): Router;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/client/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;;;;;;OAUG;IACH,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE5B;;;;;;;;;;OAUG;IACH,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/B;;;;;;;;;;;OAWG;IACH,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAEhC;;OAEG;IACH,IAAI,EAAE,MAAM,IAAI,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAgDlC"}

package/dist/client/hooks.js

@@ -0,0 +1,82 @@
+// ── juice/client — useRouter hook ─────────────────────────────────
+// Programmatic navigation for Juice SPA apps. Uses the Navigation API
+// under the hood — the existing `initNavigation()` interceptor handles
+// RSC payload fetching automatically.
+//
+// ~500 bytes minified. Zero dependencies beyond React 19.
+// ──────────────────────────────────────────────────────────────────
+import { useSyncExternalStore, useCallback, useMemo } from 'react';
+import { prefetchRSC, _subscribeToPathname, _getPathnameSnapshot, _getServerPathnameSnapshot, } from './nav.js';
+// ── Hook ──────────────────────────────────────────────────────────
+/**
+ * Programmatic navigation hook for Juice SPA apps.
+ *
+ * Returns a stable `Router` object with `push`, `replace`, `prefetch`,
+ * `back`, `forward`, and a reactive `pathname`.
+ *
+ * Uses the Navigation API when available. Falls back to `location.assign`
+ * when the Navigation API is absent (MPA mode — full page reload).
+ *
+ * @example
+ * ```tsx
+ * 'use client';
+ * import { useRouter } from '@cmj/juice/client';
+ *
+ * function SearchBar() {
+ *   const router = useRouter();
+ *
+ *   function handleSubmit(e: FormEvent) {
+ *     e.preventDefault();
+ *     const q = new FormData(e.currentTarget).get('q');
+ *     router.push(`/search?q=${encodeURIComponent(q)}`);
+ *   }
+ *
+ *   return (
+ *     <form onSubmit={handleSubmit}>
+ *       <input name="q" />
+ *     </form>
+ *   );
+ * }
+ * ```
+ */
+export function useRouter() {
+    const pathname = useSyncExternalStore(_subscribeToPathname, _getPathnameSnapshot, _getServerPathnameSnapshot);
+    const push = useCallback((url) => {
+        if ('navigation' in globalThis) {
+            globalThis.navigation.navigate(url, { history: 'push' });
+        }
+        else {
+            globalThis.location.assign(url);
+        }
+    }, []);
+    const replace = useCallback((url) => {
+        if ('navigation' in globalThis) {
+            globalThis.navigation.navigate(url, { history: 'replace' });
+        }
+        else {
+            globalThis.location.replace(url);
+        }
+    }, []);
+    const prefetch = useCallback((url) => {
+        const resolved = new URL(url, globalThis.location?.href ?? 'http://localhost').href;
+        prefetchRSC(resolved);
+    }, []);
+    const back = useCallback(() => {
+        if ('navigation' in globalThis) {
+            globalThis.navigation.back();
+        }
+        else {
+            globalThis.history?.back();
+        }
+    }, []);
+    const forward = useCallback(() => {
+        if ('navigation' in globalThis) {
+            globalThis.navigation.forward();
+        }
+        else {
+            globalThis.history?.forward();
+        }
+    }, []);
+    return useMemo(() => ({ pathname, push, replace, prefetch, back, forward }), [pathname, push, replace, prefetch, back, forward]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/client/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/client/hooks.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,sEAAsE;AACtE,uEAAuE;AACvE,sCAAsC;AACtC,EAAE;AACF,0DAA0D;AAC1D,qEAAqE;AAErE,OAAO,EAAE,oBAAoB,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC;AAEnE,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,GAC3B,MAAM,UAAU,CAAC;AA8DlB,qEAAqE;AAErE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,QAAQ,GAAG,oBAAoB,CACnC,oBAAoB,EACpB,oBAAoB,EACpB,0BAA0B,CAC3B,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,GAAW,EAAE,EAAE;QACvC,IAAI,YAAY,IAAI,UAAU,EAAE,CAAC;YAC9B,UAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClC,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,GAAW,EAAE,EAAE;QAC1C,IAAI,YAAY,IAAI,UAAU,EAAE,CAAC;YAC9B,UAAkB,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QACvE,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,GAAW,EAAE,EAAE;QAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,IAAI,kBAAkB,CAAC,CAAC,IAAI,CAAC;QACpF,WAAW,CAAC,QAAQ,CAAC,CAAC;IACxB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,EAAE;QAC5B,IAAI,YAAY,IAAI,UAAU,EAAE,CAAC;YAC9B,UAAkB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,IAAI,YAAY,IAAI,UAAU,EAAE,CAAC;YAC9B,UAAkB,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;QAC3C,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QAChC,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAC5D,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CACnD,CAAC;AACJ,CAAC"}

package/dist/client/index.d.ts

@@ -1,2 +1,4 @@
-export { initNavigation, type NavigationOptions } from './client.js';
+export { initNavigation, prefetchRSC, type NavigationOptions } from './client.js';
+export { Link, type LinkProps, type PrefetchStrategy } from './Link.js';
+export { useRouter, type Router } from './hooks.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,IAAI,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -1,3 +1,5 @@
 // ── juice/client barrel export ────────────────────────────────────
-export { initNavigation } from './client.js';
+export { initNavigation, prefetchRSC } from './client.js';
+export { Link } from './Link.js';
+export { useRouter } from './hooks.js';
 //# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAA0B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,OAAO,EAAE,cAAc,EAAE,WAAW,EAA0B,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,IAAI,EAAyC,MAAM,WAAW,CAAC;AACxE,OAAO,EAAE,SAAS,EAAe,MAAM,YAAY,CAAC"}

package/dist/client/nav.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The RSC content type used for payload negotiation.
+ * Must match the server's `RSC_CONTENT_TYPE` in `rsc.ts`.
+ */
+export declare const RSC_CONTENT_TYPE = "text/x-component";
+/**
+ * Prefetch an RSC payload for a given URL. Idempotent — duplicate
+ * calls for the same URL are no-ops until the cache entry expires.
+ *
+ * Used internally by `initNavigation()` and exported for use by
+ * `<Link prefetch="hover">` and `useRouter().prefetch()`.
+ */
+export declare function prefetchRSC(url: string): void;
+/**
+ * Get a prefetched response from the cache, if available.
+ * Removes the entry from cache (one-time read).
+ * @internal
+ */
+export declare function _consumePrefetch(url: string): Promise<Response> | undefined;
+/** @internal */
+export declare function isSameOrigin(href: string): boolean;
+/**
+ * Subscribe to pathname changes via the Navigation API.
+ * Returns an unsubscribe function.
+ *
+ * For use with React's `useSyncExternalStore`.
+ * @internal
+ */
+export declare function _subscribeToPathname(callback: () => void): () => void;
+/**
+ * Get the current pathname snapshot for `useSyncExternalStore`.
+ * @internal
+ */
+export declare function _getPathnameSnapshot(): string;
+/**
+ * Server snapshot for SSR — always returns '/'.
+ * @internal
+ */
+export declare function _getServerPathnameSnapshot(): string;
+//# sourceMappingURL=nav.d.ts.map

package/dist/client/nav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav.d.ts","sourceRoot":"","sources":["../../src/client/nav.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,qBAAqB,CAAC;AAMnD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAY7C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,SAAS,CAM3E;AAID,gBAAgB;AAChB,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAOlD;AAID;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAUrE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}