@rangojs/router 0.0.0-experimental.80 → 0.0.0-experimental.80daa23e

package/dist/browser/partial-update.d.ts

@@ -0,0 +1,75 @@
+import type { NavigationStore, NavigationClient, UpdateSubscriber, ResolvedSegment } from "./types.js";
+import type { ReactNode } from "react";
+import type { RenderSegmentsOptions } from "../segment-system.js";
+import type { BoundTransaction } from "./navigation-bridge.js";
+/**
+ * Configuration for creating a partial updater
+ */
+export interface PartialUpdateConfig {
+    store: NavigationStore;
+    client: NavigationClient;
+    onUpdate: UpdateSubscriber;
+    renderSegments: (segments: ResolvedSegment[], options?: RenderSegmentsOptions) => Promise<ReactNode> | ReactNode;
+    /** RSC version received from server (from initial payload metadata) */
+    version?: string;
+}
+/**
+ * Options that can override the pre-configured commit settings
+ */
+export interface CommitOverrides {
+    /** Override scroll behavior (e.g., disable for intercepts) */
+    scroll?: boolean;
+    /** Override replace behavior (e.g., force replace for intercepts) */
+    replace?: boolean;
+    /** Mark this as an intercept route */
+    intercept?: boolean;
+    /** Source URL where intercept was triggered from */
+    interceptSourceUrl?: string;
+}
+/**
+ * Commit context passed to partial updater for URL updates
+ * Transaction encapsulates all store mutations for atomic commit
+ */
+/**
+ * Type for the fetchPartialUpdate function
+ */
+export type PartialUpdater = (targetUrl: string, segmentIds: string[] | undefined, isRetry: boolean, signal: AbortSignal | undefined, type: BoundTransaction, options?: {
+    isAction?: boolean;
+    staleRevalidation?: boolean;
+    interceptSourceUrl?: string;
+    /** Cached segments for the target URL. When provided, these are used to build
+     * the segment map instead of the current page's segments. This ensures consistency
+     * when we send cached segment IDs to the server - if the server returns empty diff,
+     * we use the same segments we told the server we have. */
+    targetCacheSegments?: ResolvedSegment[];
+    /** Cached handle data for the target URL. When server returns empty diff and we're
+     * rendering from cache, this is passed to the UI to restore breadcrumbs etc. */
+    targetCacheHandleData?: Record<string, Record<string, unknown[]>>;
+    /** When true, we're leaving an intercept state - don't use current segment IDs
+     * as fallback and force a fresh render from server */
+    leavingIntercept?: boolean;
+}) => Promise<Promise<void>>;
+/**
+ * Create a partial updater for fetching and applying RSC partial updates
+ *
+ * This function is shared between navigation-bridge and server-action-bridge
+ * to handle partial RSC updates with HMR resilience.
+ *
+ * @param config - Partial update configuration
+ * @returns fetchPartialUpdate function
+ *
+ * @example
+ * ```typescript
+ * const fetchPartialUpdate = createPartialUpdater({
+ *   store,
+ *   client,
+ *   onUpdate: (update) => store.emit(update),
+ *   renderSegments,
+ * });
+ *
+ * await fetchPartialUpdate('/new-page');
+ * ```
+ */
+export declare function createPartialUpdater(config: PartialUpdateConfig): PartialUpdater;
+export { createPartialUpdater as default };
+//# sourceMappingURL=partial-update.d.ts.map

package/dist/browser/partial-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partial-update.d.ts","sourceRoot":"","sources":["../../src/browser/partial-update.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EAChB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAOlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,cAAc,EAAE,CACd,QAAQ,EAAE,eAAe,EAAE,EAC3B,OAAO,CAAC,EAAE,qBAAqB,KAC5B,OAAO,CAAC,SAAS,CAAC,GAAG,SAAS,CAAC;IACpC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sCAAsC;IACtC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GAAG,SAAS,EAChC,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,WAAW,GAAG,SAAS,EAC/B,IAAI,EAAE,gBAAgB,EACtB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;8DAG0D;IAC1D,mBAAmB,CAAC,EAAE,eAAe,EAAE,CAAC;IACxC;oFACgF;IAChF,qBAAqB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAClE;0DACsD;IACtD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,KACE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,mBAAmB,GAC1B,cAAc,CAigBhB;AAED,OAAO,EAAE,oBAAoB,IAAI,OAAO,EAAE,CAAC"}

package/dist/browser/partial-update.js

@@ -0,0 +1,426 @@
+import { startTransition } from "react";
+import { mergeSegmentLoaders, needsLoaderMerge, insertMissingDiffSegments, } from "./merge-segment-loaders.js";
+import { assertSegmentStructure } from "./segment-structure-assert.js";
+/**
+ * Create a partial updater for fetching and applying RSC partial updates
+ *
+ * This function is shared between navigation-bridge and server-action-bridge
+ * to handle partial RSC updates with HMR resilience.
+ *
+ * @param config - Partial update configuration
+ * @returns fetchPartialUpdate function
+ *
+ * @example
+ * ```typescript
+ * const fetchPartialUpdate = createPartialUpdater({
+ *   store,
+ *   client,
+ *   onUpdate: (update) => store.emit(update),
+ *   renderSegments,
+ * });
+ *
+ * await fetchPartialUpdate('/new-page');
+ * ```
+ */
+export function createPartialUpdater(config) {
+    const { store, client, onUpdate, renderSegments, version } = config;
+    /**
+     * Build a lookup map from current page's cached segments
+     */
+    function getCurrentSegmentMap() {
+        const currentKey = store.getHistoryKey();
+        const cached = store.getCachedSegments(currentKey);
+        const cachedSegments = cached?.segments || [];
+        const map = new Map();
+        cachedSegments.forEach((s) => map.set(s.id, s));
+        return map;
+    }
+    /**
+     * Fetch partial update and trigger UI update
+     * Returns a promise that resolves when the RSC stream is fully consumed
+     *
+     * @param tx - Transaction for committing segment state (required)
+     * @param signal - AbortSignal to check if navigation is stale (not for aborting fetch)
+     */
+    async function fetchPartialUpdate(targetUrl, segmentIds, isRetry, signal, tx, options) {
+        const { isAction = false, staleRevalidation = false, interceptSourceUrl, targetCacheSegments, targetCacheHandleData, leavingIntercept = false, } = options || {};
+        const segmentState = store.getSegmentState();
+        const url = targetUrl || window.location.href;
+        // Capture history key at start for stale revalidation consistency check
+        const historyKeyAtStart = store.getHistoryKey();
+        // When leaving intercept, don't send current segment IDs - we need fresh non-intercept segments
+        // Filter out intercept-related segments (parallel slots like @modal) from current segments
+        let segments;
+        if (leavingIntercept) {
+            // When leaving intercept, only send segments that aren't intercept-specific
+            // The server will return the non-intercept version of the route
+            const currentSegments = segmentIds ?? segmentState.currentSegmentIds;
+            // Filter out intercept-specific parallel slots (containing ".@") so the
+            // server resolves the base route instead of the modal overlay.
+            segments = currentSegments.filter((id) => !id.includes(".@"));
+            console.log(`[Browser] Leaving intercept - filtered segments: ${segments.join(", ")}`);
+        }
+        else {
+            segments = segmentIds ?? segmentState.currentSegmentIds;
+        }
+        // For intercept revalidation, use the intercept source URL as previousUrl
+        // This tells the server the route should be treated as an intercept
+        const previousUrl = interceptSourceUrl || tx.currentUrl || segmentState.currentUrl;
+        console.log(`\n[Browser] >>> NAVIGATION`);
+        console.log(`[Browser] From: ${previousUrl}`);
+        console.log(`[Browser] To: ${url}`);
+        console.log(`[Browser] Segments to send: ${segments.join(", ")}`);
+        if (interceptSourceUrl) {
+            console.log(`[Browser] Intercept context from: ${interceptSourceUrl}`);
+        }
+        // Build segment map for merging with server diff.
+        // When targetCacheSegments is provided (navigating to a cached route), use those
+        // to ensure consistency - we use the same segments we told the server we have.
+        // Otherwise fall back to current page's segments (for same-route revalidation).
+        let currentSegmentMap;
+        if (targetCacheSegments && targetCacheSegments.length > 0) {
+            currentSegmentMap = new Map();
+            targetCacheSegments.forEach((s) => currentSegmentMap.set(s.id, s));
+        }
+        else {
+            currentSegmentMap = getCurrentSegmentMap();
+        }
+        // Mark navigation as streaming (response received, now parsing RSC)
+        // The token is ended when the stream completes
+        const streamingToken = tx.startStreaming();
+        // Fetch partial payload (no abort signal - RSC doesn't support it well)
+        // Wrapped in try/catch to ensure streamingToken.end() is called if fetch throws,
+        // preventing isStreaming from being permanently stuck as true.
+        let fetchResult;
+        try {
+            fetchResult = await client.fetchPartial({
+                targetUrl: url,
+                segmentIds: segments,
+                previousUrl,
+                staleRevalidation,
+                version,
+            });
+        }
+        catch (err) {
+            streamingToken.end();
+            throw err;
+        }
+        const { payload, streamComplete: rawStreamComplete } = fetchResult;
+        console.log("payload.metadata", payload.metadata);
+        const streamComplete = rawStreamComplete.then(() => {
+            streamingToken.end();
+        });
+        if (payload.metadata?.isPartial) {
+            const { segments: newSegments, matched, diff } = payload.metadata;
+            // Check if this navigation is stale (a newer one started)
+            if (signal?.aborted) {
+                console.log(`[Browser] Ignoring stale navigation (aborted)`);
+                return streamComplete;
+            }
+            console.log(`[Browser] Partial update - matched: ${matched?.join(", ")}`);
+            console.log(`[Browser] Diff: ${diff?.join(", ")}`);
+            // Create lookup for new segments from server
+            const newSegmentMap = new Map();
+            (newSegments || []).forEach((s) => newSegmentMap.set(s.id, s));
+            // If diff is empty, nothing changed on server side.
+            // However, if we're navigating with targetCacheSegments (to a different route),
+            // we still need to render those segments since the UI is showing the old route.
+            if (!diff || diff.length === 0) {
+                const matchedIds = matched || [];
+                const existingSegments = matchedIds
+                    .map((id) => currentSegmentMap.get(id))
+                    .filter(Boolean);
+                // When navigating with cached segments to a different route, render them.
+                // targetCacheSegments being provided means we're navigating to a cached route.
+                if (targetCacheSegments && targetCacheSegments.length > 0) {
+                    console.log(`[Browser] No diff but navigating with cached segments - rendering target route`);
+                    const newTree = await renderSegments(existingSegments, {
+                        forceAwait: true,
+                    });
+                    tx.commit(matchedIds, existingSegments);
+                    // Include cachedHandleData in metadata so NavigationProvider can restore
+                    // breadcrumbs and other handle data from cache.
+                    // IMPORTANT: Remove `handles` from metadata to prevent NavigationProvider from
+                    // processing an empty handles stream, which would clear the cached breadcrumbs.
+                    // When rendering from cache with empty diff, we want to use cachedHandleData instead.
+                    const { handles: _unusedHandles, ...metadataWithoutHandles } = payload.metadata;
+                    onUpdate({
+                        root: newTree,
+                        metadata: {
+                            ...metadataWithoutHandles,
+                            cachedHandleData: targetCacheHandleData,
+                        },
+                    });
+                    console.log(`[Browser] Navigation complete (rendered from cache)\n`);
+                    return streamComplete;
+                }
+                // When leaving intercept, force re-render even with empty diff
+                // The matched segments are the non-intercept segments, which we need to render
+                // to remove the modal from the UI
+                if (leavingIntercept) {
+                    console.log(`[Browser] Leaving intercept - forcing re-render to remove modal`);
+                    const newTree = await renderSegments(existingSegments, {
+                        forceAwait: true,
+                    });
+                    tx.commit(matchedIds, existingSegments);
+                    onUpdate({
+                        root: newTree,
+                        metadata: payload.metadata,
+                    });
+                    console.log(`[Browser] Navigation complete (left intercept)\n`);
+                    return streamComplete;
+                }
+                // Same route revalidation with no changes - skip UI update
+                console.log(`[Browser] No changes - all revalidations returned false, keeping existing UI`);
+                tx.commit(matchedIds, existingSegments);
+                console.log(`[Browser] Navigation complete (no re-render)\n`);
+                return streamComplete;
+            }
+            // Build full segment list by merging:
+            // - New/changed segments from server response (diff)
+            // - Unchanged segments from current page's cache
+            const matchedIds = matched || [];
+            console.log(`[Browser] matchedIds: ${matchedIds.join(", ")}`);
+            console.log(`[Browser] currentSegmentMap keys: ${[...currentSegmentMap.keys()].join(", ")}`);
+            console.log(`[Browser] newSegmentMap keys: ${[...newSegmentMap.keys()].join(", ")}`, newSegmentMap);
+            // First pass: build segments from matched IDs
+            const matchedIdSet = new Set(matchedIds);
+            const allSegments = matchedIds
+                .map((id) => {
+                // First check server response (new/updated segments)
+                const fromServer = newSegmentMap.get(id);
+                if (fromServer) {
+                    // For partial revalidation (stale or action), merge server's new loader data
+                    // with cached loader data when server returns fewer loaders than cached
+                    const fromCache = currentSegmentMap.get(id);
+                    // Dev-mode assertion: warn if tree structure would change
+                    if (fromCache) {
+                        assertSegmentStructure(fromCache, fromServer, "partial-update");
+                    }
+                    if ((staleRevalidation || isAction) &&
+                        needsLoaderMerge(fromServer, fromCache)) {
+                        return mergeSegmentLoaders(fromServer, fromCache);
+                    }
+                    // Preserve cached structural properties to maintain consistent React tree.
+                    // The server may return different values for loading (isSSR context) and
+                    // mountPath (include scope), which change the element nesting depth
+                    // (with/without RouteContentWrapper, MountContextProvider).
+                    if (fromCache) {
+                        let merged = fromServer;
+                        // When server returns component: null for a layout segment, it means
+                        // "this segment doesn't need re-rendering" - preserve the cached component
+                        // to maintain the outlet chain and prevent React tree changes
+                        if (fromServer.component === null &&
+                            fromServer.type === "layout" &&
+                            fromCache.component != null) {
+                            merged = { ...merged, component: fromCache.component };
+                        }
+                        if (fromCache.loading !== undefined &&
+                            fromServer.loading !== fromCache.loading) {
+                            merged = { ...merged, loading: fromCache.loading };
+                        }
+                        if (fromServer.mountPath !== fromCache.mountPath) {
+                            merged = { ...merged, mountPath: fromCache.mountPath };
+                        }
+                        return merged;
+                    }
+                    return fromServer;
+                }
+                // Fall back to current page's cached segments
+                const fromCache = currentSegmentMap.get(id);
+                if (!fromCache) {
+                    console.warn(`[Browser] Missing segment: ${id}`);
+                    return fromCache;
+                }
+                // For cached segments the server decided not to re-render:
+                // - During actions: preserve loading exactly as-is to maintain tree structure.
+                //   Changing loading between renders alters the React tree
+                //   (with/without RouteContentWrapper), causing remounts that destroy
+                //   useActionState and other client state.
+                // - During navigation: preserve loading=false (suppressed boundary) but
+                //   clear truthy loading (active skeleton) to prevent suspense on cached content.
+                if (isAction) {
+                    return fromCache;
+                }
+                if (fromCache.loading !== undefined && fromCache.loading !== false) {
+                    return { ...fromCache, loading: undefined };
+                }
+                return fromCache;
+            })
+                .filter(Boolean);
+            // Insert diff segments not in matchedIds (e.g., loader segments from consolidation fetch)
+            insertMissingDiffSegments(allSegments, diff, matchedIdSet, newSegmentMap);
+            // HMR RESILIENCE: Check if we're missing any matched segments
+            // Note: allSegments may include additional diff segments, so we check matchedIds specifically
+            const allSegmentIdSet = new Set(allSegments.map((s) => s.id));
+            const missingIds = matchedIds.filter((id) => !allSegmentIdSet.has(id));
+            if (missingIds.length > 0) {
+                const missingCount = missingIds.length;
+                if (isRetry) {
+                    console.warn("Missing ids", { missingIds });
+                    throw new Error(`[Browser] Failed to fetch segments after retry. Missing: [${missingIds.join(", ")}]`);
+                }
+                if (signal?.aborted) {
+                    console.log(`[Browser] Ignoring stale navigation (aborted during HMR retry)`);
+                    return streamComplete;
+                }
+                if (isAction) {
+                    return streamComplete;
+                }
+                console.warn(`[Browser] HMR detected: Missing ${missingCount} segments. Refetching all...`);
+                // Refetch with empty segments = server sends everything
+                return fetchPartialUpdate(url, [], true, signal, tx, { isAction });
+            }
+            // INTERCEPT HANDLING: Separate intercept segments for explicit injection
+            // Intercept segments have namespace starting with "intercept:" or ID containing .@
+            // This makes the flow clearer and easier to debug
+            const isInterceptSegment = (s) => s.namespace?.startsWith("intercept:") ||
+                (s.type === "parallel" && s.id.includes(".@"));
+            const interceptSegments = allSegments.filter(isInterceptSegment);
+            const mainSegments = allSegments.filter((s) => !isInterceptSegment(s));
+            if (signal?.aborted) {
+                console.log(`[Browser] Ignoring stale navigation (aborted before render)`);
+                return streamComplete;
+            }
+            // Rebuild tree on client (await for loader data resolution)
+            // Race against abort signal to allow cancellation during loader awaiting
+            // Pass intercept segments separately for explicit handling
+            // For stale revalidation, use forceAwait to ensure no loading fallbacks
+            const renderOptions = {
+                isAction,
+                forceAwait: staleRevalidation,
+                interceptSegments: interceptSegments.length > 0 ? interceptSegments : undefined,
+            };
+            const newTree = await (signal
+                ? Promise.race([
+                    renderSegments(mainSegments, renderOptions),
+                    new Promise((_, reject) => {
+                        if (signal.aborted) {
+                            reject(new DOMException("Navigation aborted", "AbortError"));
+                        }
+                        signal.addEventListener("abort", () => {
+                            reject(new DOMException("Navigation aborted", "AbortError"));
+                        });
+                    }),
+                ])
+                : renderSegments(mainSegments, renderOptions));
+            // Final abort check before committing - another navigation may have started
+            if (signal?.aborted) {
+                console.log(`[Browser] Ignoring stale navigation (aborted before commit)`);
+                return streamComplete;
+            }
+            // Check if this is an intercept response (any slot is active)
+            // If so, disable scroll to keep the current scroll position
+            const hasActiveIntercept = payload.metadata?.slots
+                ? Object.values(payload.metadata.slots).some((slot) => slot.active)
+                : false;
+            // Track intercept context for action revalidation (only on navigation, not actions or stale revalidation)
+            if (!isAction && !staleRevalidation) {
+                if (hasActiveIntercept) {
+                    // Save the source URL for action revalidation to maintain intercept context
+                    store.setInterceptSourceUrl(segmentState.currentUrl);
+                }
+                else {
+                    // Clear intercept context when navigating to a non-intercept route
+                    store.setInterceptSourceUrl(null);
+                }
+            }
+            // Commit navigation - transaction handles all store mutations atomically
+            // For intercept responses: disable scroll, mark as intercept, include source URL
+            // Use allSegmentIds (derived from allSegments) instead of matchedIds because
+            // we may have added diff segments (like loader segments) not in the matched array
+            const allSegmentIds = allSegments.map((s) => s.id);
+            tx.commit(allSegmentIds, allSegments, hasActiveIntercept
+                ? {
+                    scroll: false,
+                    intercept: true,
+                    interceptSourceUrl: segmentState.currentUrl,
+                }
+                : undefined);
+            // For stale revalidation: verify history key hasn't changed before updating UI
+            // If user navigated away, skip UI update to avoid corrupting current view
+            if (staleRevalidation) {
+                const historyKeyNow = store.getHistoryKey();
+                if (historyKeyNow !== historyKeyAtStart) {
+                    console.log(`[Browser] Stale revalidation: history key changed (${historyKeyAtStart} -> ${historyKeyNow}), skipping UI update`);
+                    return streamComplete;
+                }
+            }
+            console.log("[partial-update] updating document");
+            // Emit update to trigger React render
+            // For stale revalidation: wait for stream to complete (loaders resolved), then update
+            // For actions: wrap in startTransition to avoid UI flickering
+            if (isAction || staleRevalidation) {
+                startTransition(() => {
+                    onUpdate({
+                        root: newTree,
+                        metadata: payload.metadata,
+                    });
+                });
+            }
+            else {
+                onUpdate({
+                    root: newTree,
+                    metadata: payload.metadata,
+                });
+            }
+            console.log(`[Browser] Navigation complete\n`);
+            return streamComplete;
+        }
+        else {
+            // Full update (fallback)
+            // Use client-side renderSegments instead of payload.root to ensure
+            // consistent component references with action revalidation.
+            // Server-rendered RSC tree has different component references than
+            // client-created tree, which causes React to remount LoaderBoundary
+            // when actions trigger revalidation.
+            console.warn(`[Browser] Full update (fallback)`);
+            const segments = payload.metadata?.segments || [];
+            // Check if this navigation is stale (a newer one started)
+            if (signal?.aborted) {
+                console.log(`[Browser] Ignoring stale navigation (aborted)`);
+                return streamComplete;
+            }
+            const segmentIds = segments.map((s) => s.id);
+            // Render on client for consistent component references
+            const newTree = await renderSegments(segments);
+            // Final abort check before committing - another navigation may have started
+            if (signal?.aborted) {
+                console.log(`[Browser] Ignoring stale navigation (aborted before commit)`);
+                return streamComplete;
+            }
+            // Commit navigation - transaction handles all store mutations atomically
+            tx.commit(segmentIds, segments);
+            // Emit update to trigger React render
+            // For stale revalidation: wait for stream to complete, then update
+            // For actions: wrap in startTransition to avoid UI flickering
+            if (staleRevalidation) {
+                await rawStreamComplete;
+                startTransition(() => {
+                    onUpdate({
+                        root: newTree,
+                        metadata: payload.metadata,
+                    });
+                });
+            }
+            else if (isAction) {
+                startTransition(async () => {
+                    onUpdate({
+                        root: newTree,
+                        metadata: payload.metadata,
+                    });
+                });
+            }
+            else {
+                onUpdate({
+                    root: newTree,
+                    metadata: payload.metadata,
+                });
+            }
+            return streamComplete;
+        }
+    }
+    return fetchPartialUpdate;
+}
+export { createPartialUpdater as default };
+//# sourceMappingURL=partial-update.js.map

package/dist/browser/partial-update.js.map

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

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

@@ -0,0 +1,86 @@
+import React, { type ForwardRefExoticComponent, type RefAttributes } from "react";
+import { type LocationStateEntry } from "./location-state.js";
+/**
+ * State value or getter function for just-in-time state resolution (legacy)
+ */
+export type StateOrGetter<T = unknown> = T | (() => T);
+/**
+ * State prop type for Link component
+ * - LocationStateEntry[]: Type-safe state entries (always lazy)
+ * - StateOrGetter: Legacy format for backwards compatibility
+ */
+export type LinkState = LocationStateEntry[] | StateOrGetter;
+/**
+ * Prefetch strategy for the Link component
+ * - "hover": Prefetch on mouse enter (uses native <link rel="prefetch">)
+ * - "viewport": Prefetch when link enters viewport (not yet implemented)
+ * - "hybrid": Hover on desktop, viewport on mobile (not yet implemented)
+ * - "none": No prefetching (default)
+ */
+export type PrefetchStrategy = "hover" | "viewport" | "hybrid" | "none";
+/**
+ * Link component props
+ */
+export interface LinkProps extends Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, "href"> {
+    /**
+     * The URL to navigate to (typically from router.reverse())
+     */
+    to: string;
+    /**
+     * Replace current history entry instead of pushing
+     */
+    replace?: boolean;
+    /**
+     * Scroll to top after navigation (default: true)
+     */
+    scroll?: boolean;
+    /**
+     * Force full document navigation instead of SPA
+     */
+    reloadDocument?: boolean;
+    /**
+     * Prefetch strategy for the link destination
+     * @default "none"
+     */
+    prefetch?: PrefetchStrategy;
+    /**
+     * State to pass to history.pushState/replaceState.
+     * Accessible via useLocationState() hook.
+     *
+     * @example
+     * ```tsx
+     * // Type-safe state with createLocationState (recommended)
+     * const ProductState = createLocationState((p: Product) => ({ name: p.name }));
+     * <Link to="/product" state={[ProductState(product)]}>View</Link>
+     *
+     * // Multiple typed states
+     * <Link to="/checkout" state={[ProductState(p), CartState(c)]}>Checkout</Link>
+     *
+     * // Legacy: static state
+     * <Link to="/product" state={{ from: "list" }}>View</Link>
+     *
+     * // Legacy: dynamic state (called at click time)
+     * <Link to="/product" state={() => ({ scrollY: window.scrollY })}>View</Link>
+     * ```
+     */
+    state?: LinkState;
+    children: React.ReactNode;
+}
+/**
+ * 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 declare const Link: ForwardRefExoticComponent<LinkProps & RefAttributes<HTMLAnchorElement>>;
+//# sourceMappingURL=Link.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Link.d.ts","sourceRoot":"","sources":["../../../src/browser/react/Link.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,EAA+C,KAAK,yBAAyB,EAAE,KAAK,aAAa,EAAE,MAAM,OAAO,CAAC;AAI/H,OAAO,EACL,KAAK,kBAAkB,EAGxB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,GAAG,OAAO,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,kBAAkB,EAAE,GAAG,aAAa,CAAC;AA4B7D;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,SACf,SAAQ,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACnE;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AA0BD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,IAAI,EAAE,yBAAyB,CAAC,SAAS,GAAG,aAAa,CAAC,iBAAiB,CAAC,CAkGvF,CAAC"}