@farm.js/core 0.1.48 → 0.1.49

package/dist/{chunk-VDLF2DJA.cjs → chunk-AIHD6VME.cjs}

@@ -37,7 +37,7 @@ var _chunkEVCQX243cjs = require('./chunk-EVCQX243.cjs');
 var _chunkEQMTJBB7cjs = require('./chunk-EQMTJBB7.cjs');
 
 
-var _chunkHUL4LTC6cjs = require('./chunk-HUL4LTC6.cjs');
+var _chunkHTLCLOXQcjs = require('./chunk-HTLCLOXQ.cjs');
 
 
 var _chunkBRWIVOV4cjs = require('./chunk-BRWIVOV4.cjs');
@@ -84,7 +84,7 @@ var _chunkKZT2VHRQcjs = require('./chunk-KZT2VHRQ.cjs');
 
 
 
-var _chunkYSPMY4B7cjs = require('./chunk-YSPMY4B7.cjs');
+var _chunkC5S457CKcjs = require('./chunk-C5S457CK.cjs');
 
 
 var _chunkIXSMFKZ2cjs = require('./chunk-IXSMFKZ2.cjs');
@@ -108,7 +108,7 @@ var _chunkZSIGEHSEcjs = require('./chunk-ZSIGEHSE.cjs');
 
 
 
-var _chunkC2R5RVLAcjs = require('./chunk-C2R5RVLA.cjs');
+var _chunkVCKGOXFIcjs = require('./chunk-VCKGOXFI.cjs');
 
 
 var _chunk47JV57DAcjs = require('./chunk-47JV57DA.cjs');
@@ -119,7 +119,7 @@ var _chunk47JV57DAcjs = require('./chunk-47JV57DA.cjs');
 
 
 
-var _chunkZGS3ZDF7cjs = require('./chunk-ZGS3ZDF7.cjs');
+var _chunkNPPT4RWFcjs = require('./chunk-NPPT4RWF.cjs');
 
 
 
@@ -231,7 +231,7 @@ var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkJLS6ZLFMcjs = require('./chunk-JLS6ZLFM.cjs');
+var _chunkJ5VCA45Kcjs = require('./chunk-J5VCA45K.cjs');
 
 
 var _chunkE552H232cjs = require('./chunk-E552H232.cjs');
@@ -1993,7 +1993,7 @@ async function mergeBuiltFontCss(outputDir, fontCssSource) {
   }
   const normalizedFontCss = typeof fontCss === "string" ? fontCss : Buffer.from(fontCss).toString("utf8");
   await fs4.writeFile(fontCssPath, normalizedFontCss);
-  await fs4.writeFile(clientCssPath, _chunkYSPMY4B7cjs.mergeFarmFontCss.call(void 0, clientCss, normalizedFontCss));
+  await fs4.writeFile(clientCssPath, _chunkC5S457CKcjs.mergeFarmFontCss.call(void 0, clientCss, normalizedFontCss));
 }
 var IncompleteClientBuildOutputError = class extends Error {
   constructor(detail) {
@@ -2039,7 +2039,7 @@ function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, optio
   const key = `${_path2.default.resolve(root)}\0${mode}\0${options.asyncOwnerIslands === true}\0${options.serverOwners === true}\0${options.serverTreeLayouts === true}\0${_path2.default.resolve(modulePath)}`;
   let plan = cache.get(key);
   if (!plan) {
-    plan = _chunkYSPMY4B7cjs.getClientModuleHydrationPlan.call(void 0, modulePath, root, mode, options);
+    plan = _chunkC5S457CKcjs.getClientModuleHydrationPlan.call(void 0, modulePath, root, mode, options);
     cache.set(key, plan);
   }
   return { ...plan, isolatedBoundaries: [...plan.isolatedBoundaries] };
@@ -2067,14 +2067,14 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       `[Farm.js] isolated hydration kept route-wide because integration provider "${unsupportedIntegrationProvider.name}" does not declare supportsIsolatedHydration: true.`
     );
   }
-  const isolatedMode = _chunkYSPMY4B7cjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
+  const isolatedMode = _chunkC5S457CKcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
     _optionalChain([config, 'access', _47 => _47.experimental, 'optionalAccess', _48 => _48.isolatedClientHydration]),
     {
       serverComponents: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _49 => _49.experimental, 'optionalAccess', _50 => _50.serverComponents])) === "rsc",
       hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
     }
   );
-  const planOptions = _chunkYSPMY4B7cjs.getFarmClientHydrationPlanOptions.call(void 0, 
+  const planOptions = _chunkC5S457CKcjs.getFarmClientHydrationPlanOptions.call(void 0, 
     config.renderer,
     Boolean(unsupportedIntegrationProvider)
   );
@@ -2131,7 +2131,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       };
     }
   });
-  const layoutAppliesToRoute = _chunkC2R5RVLAcjs.routeBoundaryCoversDirectory;
+  const layoutAppliesToRoute = _chunkVCKGOXFIcjs.routeBoundaryCoversDirectory;
   const routeDirectory = (route) => _nullishCoalesce(route.directory, () => ( route.pattern));
   const adapterOwnsDocsRuntime = Boolean(
     _chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) && _optionalChain([config, 'access', _53 => _53.docs, 'optionalAccess', _54 => _54.enabled]) && _optionalChain([config, 'access', _55 => _55.docs, 'access', _56 => _56.adapter, 'optionalAccess', _57 => _57.server]) && config.docs.adapter.react
@@ -2142,7 +2142,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   );
   const syntheticDocsEntry = _optionalChain([config, 'access', _60 => _60.docs, 'optionalAccess', _61 => _61.enabled]) && !adapterOwnsDocsRuntime ? adapterDocsEntry : null;
   const syntheticDocsPatterns = syntheticDocsEntry ? syntheticDocsEntry === "/" ? ["/", "/[...slug]"] : [syntheticDocsEntry, `${syntheticDocsEntry}/[...slug]`] : [];
-  const markdownPagePlan = _chunkYSPMY4B7cjs.createMarkdownPageHydrationPlanner.call(void 0, 
+  const markdownPagePlan = _chunkC5S457CKcjs.createMarkdownPageHydrationPlanner.call(void 0, 
     _chunk2HW5LWAHcjs.resolveFarmMdxComponentsModulePath.call(void 0, _chunk2HW5LWAHcjs.resolveMdxConfig.call(void 0, config.mdx), root),
     root,
     isolatedMode,
@@ -2158,7 +2158,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       pagePlanOptions
     )
   }));
-  _chunkYSPMY4B7cjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
+  _chunkC5S457CKcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
     clientLayouts.map((layout) => ({
       pattern: layout.pattern,
       depth: layout.pattern.split("/").filter(Boolean).length,
@@ -2167,7 +2167,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     [
       ...routePlans.map(({ route, metadata }) => ({
         pattern: routeDirectory(route),
-        depth: _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, routeDirectory(route)),
+        depth: _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, routeDirectory(route)),
         metadata
       })),
       ...syntheticDocsPatterns.map((pattern) => ({
@@ -2190,7 +2190,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   for (const layout of clientLayouts) {
     const matchesBuiltRoute = pageRoutes.some((route) => layoutAppliesToRoute(layout.pattern, routeDirectory(route))) || Boolean(adapterDocsEntry && layoutAppliesToRoute(layout.pattern, adapterDocsEntry));
     if (matchesBuiltRoute && layout.suppressedAsyncHydration) {
-      _chunkXN2MB4QZcjs.logger.warn(`\u26A0\uFE0F  ${_chunkYSPMY4B7cjs.describeSuppressedAsyncHydration.call(void 0, layout.pattern, layout.fallbackReason)}`);
+      _chunkXN2MB4QZcjs.logger.warn(`\u26A0\uFE0F  ${_chunkC5S457CKcjs.describeSuppressedAsyncHydration.call(void 0, layout.pattern, layout.fallbackReason)}`);
     }
   }
   if (isolatedMode === "analyze") {
@@ -2214,7 +2214,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       );
       if (metadata.suppressedAsyncHydration) {
         _chunkXN2MB4QZcjs.logger.warn(
-          `\u26A0\uFE0F  ${_chunkYSPMY4B7cjs.describeSuppressedAsyncHydration.call(void 0, route.pattern, metadata.fallbackReason)}`
+          `\u26A0\uFE0F  ${_chunkC5S457CKcjs.describeSuppressedAsyncHydration.call(void 0, route.pattern, metadata.fallbackReason)}`
         );
       }
       if (metadata.shouldHydrate || metadata.hasIsolatedClientBoundaries || applicableClientLayouts.length > 0) {
@@ -2239,7 +2239,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             ...applicableClientLayouts.filter((layout) => layout.hasIsolatedClientBoundaries || layout.serverTreeLayout).flatMap((layout) => layout.isolatedBoundaries)
           ],
           // The server renders a server tree only below a hydrating layout.
-          ..._chunkYSPMY4B7cjs.usesFarmServerTree.call(void 0, metadata) && applicableClientLayouts.some((layout) => layout.shouldHydrate) ? { serverTree: true } : {}
+          ..._chunkC5S457CKcjs.usesFarmServerTree.call(void 0, metadata) && applicableClientLayouts.some((layout) => layout.shouldHydrate) ? { serverTree: true } : {}
         });
         _chunkXN2MB4QZcjs.logger.info(`\u{1F4F1} Found hydratable route: ${route.pattern} -> ${route.modulePath}`);
       }
@@ -2275,7 +2275,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   }
   const clientRouteSlots = routeSlots.filter((slot) => {
     try {
-      return _chunkYSPMY4B7cjs.getClientModuleMetadata.call(void 0, slot.modulePath, root).shouldHydrate;
+      return _chunkC5S457CKcjs.getClientModuleMetadata.call(void 0, slot.modulePath, root).shouldHydrate;
     } catch (error) {
       _chunkXN2MB4QZcjs.logger.warn(`\u26A0\uFE0F  Could not inspect route slot ${slot.modulePath}: ${error}`);
       return false;
@@ -2305,7 +2305,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     config.trailingSlash,
     _chunkN25RPPO5cjs.getIntegrationProviders.call(void 0, config.integrations),
     config.basePath,
-    _chunkYSPMY4B7cjs.generateClientCachePersistenceCode.call(void 0, _chunkYSPMY4B7cjs.resolveFarmClientCacheAdapterEntry.call(void 0, root, config.cache)),
+    _chunkC5S457CKcjs.generateClientCachePersistenceCode.call(void 0, _chunkC5S457CKcjs.resolveFarmClientCacheAdapterEntry.call(void 0, root, config.cache)),
     adapterOwnsDocsRuntime ? _chunkSM2SYWARcjs.getFarmDocsAdapterConfigModule.call(void 0, config.docs) : void 0,
     _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _67 => _67.experimental, 'optionalAccess', _68 => _68.serverComponents])) === "islands"
   );
@@ -2394,7 +2394,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         }
       },
       plugins: [
-        _chunkYSPMY4B7cjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
+        _chunkC5S457CKcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
         createFarmPrivateClientSourcemapsPlugin({
           outDir: _path2.default.join(_path2.default.dirname(outputDir), FARM_CLIENT_SOURCEMAPS_DIR)
         }),
@@ -2419,7 +2419,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
         farmServerOnlyEntriesPlugin(),
-        _chunkYSPMY4B7cjs.farmDocsClientConfigPlugin.call(void 0, 
+        _chunkC5S457CKcjs.farmDocsClientConfigPlugin.call(void 0, 
           adapterOwnsDocsRuntime ? _chunkSM2SYWARcjs.getFarmDocsAdapterConfigModule.call(void 0, config.docs) : void 0
         ),
         // Plugin to redirect @farm.js/core imports to client-only exports
@@ -2481,7 +2481,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       } : void 0,
       // Ensure React is bundled for client
       resolve: {
-        alias: _chunkYSPMY4B7cjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
+        alias: _chunkC5S457CKcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
         dedupe: [...config.renderer.dedupe || []]
       },
       // Optimize dependencies - exclude server-side code from client bundle
@@ -2494,7 +2494,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         ]
       }
     };
-    await viteBuild(_chunkYSPMY4B7cjs.mergeFarmProductionViteConfig.call(void 0, clientViteConfig, config.vite));
+    await viteBuild(_chunkC5S457CKcjs.mergeFarmProductionViteConfig.call(void 0, clientViteConfig, config.vite));
     await mergeBuiltFontCss(outputDir);
     await validateClientBuildOutput(root, srcDir, outputDir);
   } finally {
@@ -2513,7 +2513,7 @@ function toBakedMarkdownSourcePath(root, filePath) {
   }
   return relative.split(_path2.default.sep).join("/");
 }
-function generateUniversalRouterStateRuntime() {
+function generateUniversalRouterStateRuntime(streamNavigations = false) {
   return `
 const FARM_PAGE_STATE_KEY = "__farmPageState";
 const FARM_HISTORY_INDEX_KEY = "__farmHistoryIndex";
@@ -2581,6 +2581,46 @@ async function fetchFarmNavigationDocument(url, headers, recover = true, signal)
   return response;
 }
 
+${streamNavigations ? `const FARM_FLUSH_MARKER = "<!--farm-flush-->";
+
+// Reads a streamed navigation (F-Stream) up to the end of React's shell. \`next\` then resolves
+// with each later flush as it ends, and null at the end; a document without a marker is all shell.
+async function readFarmNavigationStream(body) {
+  const reader = body.getReader();
+  const decoder = new TextDecoder();
+  let text = "";
+  let done = false;
+  const next = async function() {
+    for (;;) {
+      const at = text.indexOf(FARM_FLUSH_MARKER);
+      if (at !== -1) {
+        const flush = text.slice(0, at);
+        text = text.slice(at + FARM_FLUSH_MARKER.length);
+        return flush;
+      }
+      if (done) {
+        const flush = text;
+        text = "";
+        return flush ? flush : null;
+      }
+      const result = await reader.read();
+      if (result.done) {
+        done = true;
+        text += decoder.decode();
+      } else {
+        text += decoder.decode(result.value, { stream: true });
+      }
+    }
+  };
+  const shell = await next();
+  if (done && !text) return { shell: shell || "" };
+  return {
+    shell: shell,
+    next: next,
+    cancel: function() { reader.cancel().catch(function() {}); },
+  };
+}` : ""}
+
 function clearFarmPrefetchCacheOnDeploymentMismatch(router, error) {
   if (error?.name === "FarmDeploymentMismatchError") {
     router.clearCache();
@@ -2784,9 +2824,35 @@ function interpolateRedirectDestination(destination, params) {
 }
 `.trim();
 }
-function generateUniversalRouterStateProperties() {
+function generateUniversalRouterStateProperties(streamNavigations = false) {
   return `
-  blockers: new Set(),
+${streamNavigations ? `  // A streamed navigation swaps in the page's shell; its Suspense content follows flush by flush.
+  navigationStream: null,
+  streamingNavigation: null,
+  takeNavigationStream: function(html) {
+    const stream = this.navigationStream;
+    this.navigationStream = null;
+    if (!stream) return;
+    if (stream.html !== html) {
+      stream.cancel();
+      return;
+    }
+    this.streamingNavigation = stream;
+    void streamFarmNavigation(
+      stream,
+      document.getElementById("root") || document.body,
+      () => this.streamingNavigation === stream,
+    );
+  },
+  stopNavigationStream: function() {
+    this.navigationStream?.cancel();
+    this.streamingNavigation?.cancel();
+    this.navigationStream = null;
+    this.streamingNavigation = null;
+  },
+` : `  takeNavigationStream: function() {},
+  stopNavigationStream: function() {},
+`}  blockers: new Set(),
   unloadBlockers: new Map(),
   navigationListeners: new Set(),
   navigationState: IDLE_NAVIGATION_STATE,
@@ -3080,6 +3146,11 @@ function generateUniversalRouterStateProperties() {
     // Only speculative requests have shared ownership. Ordinary navigations
     // keep their own abort signal and cannot cancel another caller's work.
     const record = recover ? null : { valid: true, deploymentId, promise: null };
+    // A navigation (not a prefetch) streams when the router supports it: the page goes in as
+    // soon as its shell arrives, and its Suspense content follows (takeNavigationStream). A page
+    // whose layouts hydrate, or one rendered in this page's React root, arrives whole.
+    const streamShell = ${streamNavigations ? `recover && !interceptFrom && !partialHeaders["F-Render"] &&
+      !hasHydratableLayout(new URL(url, window.location.href).pathname)` : "false"};
     const request = async () => {
       const response = await fetchFarmNavigationDocument(url, {
         "Accept": "text/html",
@@ -3088,13 +3159,28 @@ function generateUniversalRouterStateProperties() {
         // layouts it shows.
         ...getFarmIslandValueHeaders(),
         ...partialHeaders,
+        ...(streamShell ? { "F-Stream": "flush" } : {}),
       }, recover, signal);
       if (!response.ok) throw new Error("Failed to fetch page");
-      const html = await response.text();
-      if (cacheResult && !signal?.aborted && generation === this.prefetchGeneration &&
-          deploymentId === window.__FARM_DEPLOYMENT_ID__ && (!record || record.valid)) {
-        this.storePrefetchedHtml(cacheKey, html);
+      const store = (html) => {
+        if (cacheResult && !signal?.aborted && generation === this.prefetchGeneration &&
+            deploymentId === window.__FARM_DEPLOYMENT_ID__ && (!record || record.valid)) {
+          this.storePrefetchedHtml(cacheKey, html);
+        }
+      };
+${streamNavigations ? `      if (streamShell && response.body) {
+        const streamed = await readFarmNavigationStream(response.body);
+        if (!streamed.next) {
+          store(streamed.shell);
+          return streamed.shell;
+        }
+        this.stopNavigationStream();
+        this.navigationStream = { html: streamed.shell, next: streamed.next, cancel: streamed.cancel, store };
+        return streamed.shell;
       }
+` : ""}
+      const html = await response.text();
+      store(html);
       return html;
     };
     if (!record) return request();
@@ -3283,7 +3369,7 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
   direction: {}
 }, plugins = [], renderer = _chunkRD623KW4cjs.REACT_RENDERER, publicRuntimeConfig = void 0, trailingSlash = false, integrationProviders = [], basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule, islandValues = false) {
   const toImportPath = (targetPath) => targetPath.replace(/\\/g, "/");
-  const clientPluginEntry = _chunkYSPMY4B7cjs.generateFarmClientPluginEntryCode.call(void 0, 
+  const clientPluginEntry = _chunkC5S457CKcjs.generateFarmClientPluginEntryCode.call(void 0, 
     plugins,
     root,
     srcDir,
@@ -3294,7 +3380,7 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
 import { createRoot, hydrateRoot } from "react-dom/client";` : appSetupPath ? `import React, { createRoot, hydrateRoot, configureApp as __farmConfigureApp } from ${JSON.stringify(renderer.client)};
 import __farmAppSetup from ${JSON.stringify(_chunkXN2MB4QZcjs.toPosixPath.call(void 0, appSetupPath))};
 __farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot } from ${JSON.stringify(renderer.client)};`;
-  const providerClientCode = _chunkYSPMY4B7cjs.generateFarmIntegrationProviderClientCode.call(void 0, 
+  const providerClientCode = _chunkC5S457CKcjs.generateFarmIntegrationProviderClientCode.call(void 0, 
     integrationProviders,
     root,
     _nullishCoalesce(renderer.componentExtensions, () => ( []))
@@ -3304,18 +3390,18 @@ __farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot
   const layoutImportStatements = [];
   const layoutRegistrations = [];
   const hydratingLayoutPatterns = layoutRoutes.filter((layout) => layout.shouldHydrate).map((layout) => layout.pattern);
-  const treeLayoutPatterns = islandValues ? _chunkC2R5RVLAcjs.getFarmServerTreeLayoutPatterns.call(void 0, layoutRoutes) : /* @__PURE__ */ new Set();
+  const treeLayoutPatterns = islandValues ? _chunkVCKGOXFIcjs.getFarmServerTreeLayoutPatterns.call(void 0, layoutRoutes) : /* @__PURE__ */ new Set();
   layoutRoutes.forEach((layout, index) => {
     const relativePath = toImportPath(layout.modulePath);
     const treeLayout = treeLayoutPatterns.has(layout.pattern);
     const rendersOnClient = treeLayout || !layout.hasIsolatedClientBoundaries && hydratingLayoutPatterns.some(
-      (pattern) => _chunkC2R5RVLAcjs.layoutsCanCoverSamePage.call(void 0, layout.pattern, pattern)
+      (pattern) => _chunkVCKGOXFIcjs.layoutsCanCoverSamePage.call(void 0, layout.pattern, pattern)
     );
     if (rendersOnClient && !treeLayout) {
       layoutImportStatements.push(`import Layout${index} from "${relativePath}";`);
     }
-    const groupScope = _chunkC2R5RVLAcjs.getRouteGroupScope.call(void 0, layout.pattern);
-    const groupFields = groupScope ? `, urlPattern: ${JSON.stringify(_chunkC2R5RVLAcjs.stripRouteGroups.call(void 0, layout.pattern))}, groupScope: ${JSON.stringify(groupScope)}` : "";
+    const groupScope = _chunkVCKGOXFIcjs.getRouteGroupScope.call(void 0, layout.pattern);
+    const groupFields = groupScope ? `, urlPattern: ${JSON.stringify(_chunkVCKGOXFIcjs.stripRouteGroups.call(void 0, layout.pattern))}, groupScope: ${JSON.stringify(groupScope)}` : "";
     layoutRegistrations.push(
       `  { pattern: ${JSON.stringify(layout.pattern)}${groupFields}, Component: ${rendersOnClient ? treeLayout ? `getFarmTreeLayoutComponent(${JSON.stringify(layout.pattern)})` : `Layout${index}` : "null"}, shouldHydrate: ${JSON.stringify(layout.shouldHydrate)}, islandStrategy: ${JSON.stringify(layout.islandStrategy)}${treeLayout ? ", serverTree: true" : ""} }`
     );
@@ -3819,7 +3905,7 @@ function hasHydratableLayout(pathname) {
   });
 }
 
-${_chunkYSPMY4B7cjs.FARM_LAYOUT_ELEMENT_CLIENT_SOURCE}
+${_chunkC5S457CKcjs.FARM_LAYOUT_ELEMENT_CLIENT_SOURCE}
 // Wrap a page element with applicable layouts
 function wrapWithLayouts(pageElement, pathname, params) {
   const layouts = getApplicableLayouts(pathname);
@@ -3854,7 +3940,7 @@ function createLayoutPageBoundary(route, pageElement, serverHtml) {
   return React.createElement("div", props, pageElement);
 }
 let farmLastRouteState = null;
-${hasServerTreeLayouts && islandValues && isolatedHydrationEnabled ? `${_chunkYSPMY4B7cjs.FARM_SERVER_TREE_LAYOUT_CLIENT_SOURCE}
+${hasServerTreeLayouts && islandValues && isolatedHydrationEnabled ? `${_chunkC5S457CKcjs.FARM_SERVER_TREE_LAYOUT_CLIENT_SOURCE}
 function farmTreeLayoutsOf(pathname) {
   return getApplicableLayouts(pathname).filter(function(layout) {
     return layout.serverTree === true;
@@ -4172,7 +4258,7 @@ let currentPathname = null;
 let isHydrated = false;
 let pendingPageHydrationController = null;
 
-${generateUniversalRouterStateRuntime()}
+${generateUniversalRouterStateRuntime(islandValues)}
 
 function cancelPendingPageHydration() {
   pendingPageHydrationController?.abort();
@@ -4360,6 +4446,55 @@ function activateNavigationScripts(root) {
   }
 }
 
+${islandValues ? `// Adds the flushes after a streamed navigation's shell: React's staged Suspense content and the
+// scripts that reveal it. In islands mode, the islands React reveals hydrate as they appear, and
+// the ones it removes (a replaced fallback) are released.
+async function streamFarmNavigation(stream, root, isCurrent) {
+  let html = stream.html;
+  let streaming = true;
+  ${isolatedHydrationEnabled ? `const removed = new Set();
+  let queued = false;
+  const run = function() {
+    queued = false;
+    if (!isCurrent()) return observer.disconnect();
+    for (const node of removed) if (!node.isConnected) disposeFarmIsolatedClientBoundaries(node);
+    removed.clear();
+    if (!streaming && !root.querySelector('div[hidden][id^="S:"]')) observer.disconnect();
+    hydrateFarmIsolatedClientBoundaries(root).catch(function(error) {
+      console.error("[Farm.js] Hydrating streamed islands failed:", error);
+    });
+  };
+  const observer = new MutationObserver(function(records) {
+    for (const record of records) for (const node of record.removedNodes) removed.add(node);
+    if (queued) return;
+    queued = true;
+    queueMicrotask(run);
+  });
+  observer.observe(root, { childList: true, subtree: true });` : "const observer = { disconnect: function() {} };"}
+  try {
+    for (let flush = await stream.next(); flush !== null; flush = await stream.next()) {
+      if (!isCurrent()) return stream.cancel();
+      html += flush;
+      const parsed = new DOMParser().parseFromString('<div id="root">' + flush, "text/html");
+      const fragment = document.createDocumentFragment();
+      for (const node of Array.from(parsed.getElementById("root").childNodes)) fragment.appendChild(node);
+      activateNavigationScripts(fragment);
+      root.appendChild(fragment);
+    }
+  } catch (error) {
+    streaming = false;
+    if (!isCurrent()) return observer.disconnect();
+    console.error("[Farm.js] A streamed navigation failed:", error);
+    ${isolatedHydrationEnabled ? "farmIsolatedHydrationRuntime.endStream?.(root);\n    if (!queued) run();" : ""}
+    return;
+  }
+  // A cancelled stream ends early: keep its partial document out of the cache.
+  if (!isCurrent()) return observer.disconnect();
+  streaming = false;
+  stream.store(html);
+  ${isolatedHydrationEnabled ? "farmIsolatedHydrationRuntime.endStream?.(root);\n  if (!queued) run();" : ""}
+}` : ""}
+
 function replaceSharedLayoutBoundary(currentRoot, nextRoot, refresh = false) {
   const currentPatterns = getLayoutPatterns(currentRoot);
   const nextPatterns = getLayoutPatterns(nextRoot);
@@ -4402,7 +4537,7 @@ function replaceSharedLayoutBoundary(currentRoot, nextRoot, refresh = false) {
 
 // SPA Router
 const spaRouter = {
-${generateUniversalRouterStateProperties()}
+${generateUniversalRouterStateProperties(islandValues)}
   prefetchCache: new Map(),
 ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and say when this page renders the
   // next one in its own React root; the server leaves out what the browser keeps or rebuilds.
@@ -4414,7 +4549,7 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
       ...(reactRoot && reactRootContainer === root ? { "F-Render": "tree" } : {}),
     };
   },
-` : ""}  
+` : ""}
   navigate: async function(href, options = {}) {
     const url = new URL(href, window.location.href);
     if (isFarmBlockedNavigationURL(url)) return;
@@ -4467,6 +4602,7 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
 
     // A route transition invalidates any trigger waiting on the previous DOM boundary.
     cancelPendingPageHydration();
+    this.stopNavigationStream();
     this.saveScrollPosition(window.location.pathname + window.location.search);
     const navigation = this.startNavigation(from, url, action);
     // A refresh keeps the islands still on the page (islands mode).
@@ -4591,6 +4727,7 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
         if (!this.isCurrentNavigation(navigation, clientNavigation)) return;
         await this.runViewTransition(options.viewTransition, async () => {
           if (!this.isCurrentNavigation(navigation, clientNavigation)) return;
+          let swappedHtml = html;
           let swapped = await this.swapContent(
             html,
             url.pathname + url.search,
@@ -4610,6 +4747,7 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
               false,
             );
             if (!this.isCurrentNavigation(navigation, clientNavigation)) return;
+            swappedHtml = documentHtml;
             swapped = await this.swapContent(
               documentHtml,
               url.pathname + url.search,
@@ -4621,6 +4759,7 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
           if (!swapped || swapped === "segment-mismatch") {
             throw new Error("Farm could not swap the target document");
           }
+          this.takeNavigationStream(swappedHtml);
           this.writeHistoryEntry(action, url.pathname + url.search, options.state, url);
           currentPathname = pathname;
           this.currentPath = to;
@@ -5027,7 +5166,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   }
   const middlewareRoutes = await discoverMiddlewareRoutes(appDirs);
   const instrumentationPath = _chunkBRWIVOV4cjs.resolveFarmInstrumentationFile.call(void 0, root, config.srcDir || "src");
-  const notFoundPath = _chunkYSPMY4B7cjs.resolveFarmNotFoundComponentPath.call(void 0, config, appDirs);
+  const notFoundPath = _chunkC5S457CKcjs.resolveFarmNotFoundComponentPath.call(void 0, config, appDirs);
   if (notFoundPath) _chunkXN2MB4QZcjs.logger.info(`\u{1F4CB} Found custom 404 page: ${notFoundPath}`);
   layoutRoutes.sort((a, b) => {
     const depthA = a.pattern.split("/").filter(Boolean).length;
@@ -5049,7 +5188,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   );
   const hasObservabilityHandler = !!config.observability && typeof config.observability === "object" && "onEvent" in config.observability;
   const hasMdxComponentConfig = Boolean(_optionalChain([config, 'access', _75 => _75.mdx, 'optionalAccess', _76 => _76.components]));
-  const hasMiddlewareConfig = _chunkC2R5RVLAcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
+  const hasMiddlewareConfig = _chunkVCKGOXFIcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
   const hasRouteContextConfig = _chunkKZT2VHRQcjs.hasCustomFarmRouteContext.call(void 0, config);
   const hasServerRuntimePlugins = hasFarmServerRuntimePlugins(config);
   const hasPluginRoutes = hasFarmPluginRoutes(config);
@@ -5233,7 +5372,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         __FARM_PUBLIC_ENV__: JSON.stringify(_optionalChain([config, 'access', _87 => _87.env, 'optionalAccess', _88 => _88.public]) || {})
       },
       plugins: [
-        _chunkYSPMY4B7cjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
+        _chunkC5S457CKcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
         ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
@@ -5294,7 +5433,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       resolve: {
         alias: [
           ...shouldAliasReactServerToWebBuild(config.renderer, preset) ? [createFarmReactWebServerAlias(hasReactDomEdgeServerBuild(root))] : [],
-          ...Object.entries(_chunkYSPMY4B7cjs.createFarmSourceAlias.call(void 0, root, config.srcDir)).map(
+          ...Object.entries(_chunkC5S457CKcjs.createFarmSourceAlias.call(void 0, root, config.srcDir)).map(
             ([find, replacement]) => ({ find, replacement })
           )
         ],
@@ -5302,7 +5441,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         dedupe: [...config.renderer.dedupe || []]
       }
     };
-    await viteBuild(_chunkYSPMY4B7cjs.mergeFarmProductionViteConfig.call(void 0, serverViteConfig, config.vite));
+    await viteBuild(_chunkC5S457CKcjs.mergeFarmProductionViteConfig.call(void 0, serverViteConfig, config.vite));
   } finally {
     if (postcssConfigDir) {
       try {
@@ -5347,7 +5486,7 @@ function getFarmDocsGuardedPaths(config, middlewareRoutes) {
     config: { middleware: config.middleware, integrations: config.integrations },
     middlewareRoutes
   };
-  return _chunkEVCQX243cjs.discoverFarmDocsPages.call(void 0, contentDir, config.docs).flatMap((page) => [page.href, _chunkEVCQX243cjs.getFarmDocsMarkdownPath.call(void 0, page.href)]).filter((pathname) => _chunkC2R5RVLAcjs.farmPathGuardCoversPage.call(void 0, guards, pathname));
+  return _chunkEVCQX243cjs.discoverFarmDocsPages.call(void 0, contentDir, config.docs).flatMap((page) => [page.href, _chunkEVCQX243cjs.getFarmDocsMarkdownPath.call(void 0, page.href)]).filter((pathname) => _chunkVCKGOXFIcjs.farmPathGuardCoversPage.call(void 0, guards, pathname));
 }
 function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
   const llmsTxt = _optionalChain([agent, 'optionalAccess', _91 => _91.llmsTxt]);
@@ -5749,7 +5888,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   const hasGeneratedMetadataImages = metadataImageRoutes.some(
     (image) => image.sourceType === "module"
   );
-  const hasMiddlewareRuntime = middlewareRoutes.length > 0 || _chunkC2R5RVLAcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
+  const hasMiddlewareRuntime = middlewareRoutes.length > 0 || _chunkVCKGOXFIcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
   const farmDocsFontAssets = _optionalChain([config, 'access', _116 => _116.docs, 'optionalAccess', _117 => _117.enabled]) ? _chunkERMUL73Lcjs.toFarmDocsPublicFontAssets.call(void 0, _chunkERMUL73Lcjs.resolveFarmDocsFontAssets.call(void 0, config.root)) : [];
   const integrationProviders = _chunkN25RPPO5cjs.getIntegrationProviders.call(void 0, config.integrations);
   const renderedIntegrationProviders = integrationProviders.filter(
@@ -5760,7 +5899,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       `Integration provider components are not supported by the "${config.renderer.name}" renderer.`
     );
   }
-  const providerServerModules = _chunkYSPMY4B7cjs.generateFarmIntegrationProviderServerModules.call(void 0, 
+  const providerServerModules = _chunkC5S457CKcjs.generateFarmIntegrationProviderServerModules.call(void 0, 
     renderedIntegrationProviders,
     config.root,
     _nullishCoalesce(config.renderer.componentExtensions, () => ( []))
@@ -5780,14 +5919,14 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   const unsupportedIntegrationProvider = renderedIntegrationProviders.find(
     (provider) => provider.supportsIsolatedHydration !== true
   );
-  const isolatedHydrationMode = _chunkYSPMY4B7cjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
+  const isolatedHydrationMode = _chunkC5S457CKcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
     _optionalChain([config, 'access', _120 => _120.experimental, 'optionalAccess', _121 => _121.isolatedClientHydration]),
     {
       serverComponents: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _122 => _122.experimental, 'optionalAccess', _123 => _123.serverComponents])) === "rsc",
       hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
     }
   );
-  const hydrationPlanOptions = _chunkYSPMY4B7cjs.getFarmClientHydrationPlanOptions.call(void 0, 
+  const hydrationPlanOptions = _chunkC5S457CKcjs.getFarmClientHydrationPlanOptions.call(void 0, 
     config.renderer,
     Boolean(unsupportedIntegrationProvider)
   );
@@ -5805,7 +5944,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       { ...hydrationPlanOptions, serverTreeLayouts: pageHydrationPlanOptions.serverOwners }
     )
   }));
-  const markdownPagePlan = _chunkYSPMY4B7cjs.createMarkdownPageHydrationPlanner.call(void 0, 
+  const markdownPagePlan = _chunkC5S457CKcjs.createMarkdownPageHydrationPlanner.call(void 0, 
     _chunk2HW5LWAHcjs.resolveFarmMdxComponentsModulePath.call(void 0, _chunk2HW5LWAHcjs.resolveMdxConfig.call(void 0, config.mdx), config.root),
     config.root,
     isolatedHydrationMode,
@@ -5823,7 +5962,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       )
     ])
   );
-  _chunkYSPMY4B7cjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
+  _chunkC5S457CKcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
     layoutHydrationPlans.map((layout) => ({
       pattern: layout.pattern,
       depth: layout.pattern.split("/").filter(Boolean).length,
@@ -5832,10 +5971,10 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
     pageRoutes.map((route) => ({
       // Compared by directory so a grouped layout applies only inside its group.
       pattern: _nullishCoalesce(route.directory, () => ( route.pattern)),
-      depth: _chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, _nullishCoalesce(route.directory, () => ( route.pattern))),
+      depth: _chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, _nullishCoalesce(route.directory, () => ( route.pattern))),
       metadata: pageHydrationPlans.get(route.modulePath)
     })),
-    _chunkC2R5RVLAcjs.routeBoundaryCoversDirectory
+    _chunkVCKGOXFIcjs.routeBoundaryCoversDirectory
   );
   const providerServerImports = [
     providerServerModules.hasClerkProvider ? `import { ClerkProvider as FarmClerkProvider } from "@clerk/react";` : "",
@@ -5897,7 +6036,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
     module: ${varName},
     shouldHydrate: ${JSON.stringify(clientMetadata.shouldHydrate)},${clientMetadata.shouldHydrate ? `
     clientModule: ${JSON.stringify(_chunkXN2MB4QZcjs.toViteModuleId.call(void 0, route.modulePath, config.root))},` : ""}
-    islandStrategy: ${JSON.stringify(clientMetadata.islandStrategy)},${_chunkYSPMY4B7cjs.usesFarmServerTree.call(void 0, clientMetadata) ? "\n    serverTree: true," : ""}${renderingDirective ? `
+    islandStrategy: ${JSON.stringify(clientMetadata.islandStrategy)},${_chunkC5S457CKcjs.usesFarmServerTree.call(void 0, clientMetadata) ? "\n    serverTree: true," : ""}${renderingDirective ? `
     rendering: ${JSON.stringify(renderingDirective)},` : ""}
     ${route.source !== void 0 ? `markdownSource: {
       source: ${JSON.stringify(route.source)},
@@ -5907,7 +6046,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   });
   const layoutImports = [];
   const layoutRegistrations = [];
-  const treeLayoutPatterns = farmIslandsMode ? _chunkC2R5RVLAcjs.getFarmServerTreeLayoutPatterns.call(void 0, 
+  const treeLayoutPatterns = farmIslandsMode ? _chunkVCKGOXFIcjs.getFarmServerTreeLayoutPatterns.call(void 0, 
     layoutHydrationPlans.map((layout) => ({
       pattern: layout.pattern,
       shouldHydrate: layout.hydration.shouldHydrate,
@@ -5961,12 +6100,12 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
     errorImports.push(
       `import * as ${varName} from ${toVirtualEntryImportSpecifier(errorRoute.modulePath)};`
     );
-    const groupScope = _chunkC2R5RVLAcjs.getRouteGroupScope.call(void 0, errorRoute.pattern);
+    const groupScope = _chunkVCKGOXFIcjs.getRouteGroupScope.call(void 0, errorRoute.pattern);
     errorRegistrations.push(`
   {
-    pattern: ${JSON.stringify(_chunkC2R5RVLAcjs.stripRouteGroups.call(void 0, errorRoute.pattern))},${groupScope ? `
+    pattern: ${JSON.stringify(_chunkVCKGOXFIcjs.stripRouteGroups.call(void 0, errorRoute.pattern))},${groupScope ? `
     groupScope: ${JSON.stringify(groupScope)},
-    directoryDepth: ${_chunkC2R5RVLAcjs.getRouteDirectoryDepth.call(void 0, errorRoute.pattern)},` : ""}
+    directoryDepth: ${_chunkVCKGOXFIcjs.getRouteDirectoryDepth.call(void 0, errorRoute.pattern)},` : ""}
     module: ${varName},
   }`);
   });
@@ -6170,7 +6309,7 @@ ${integrationRuntimeImport}
 ${nativeAuth.importSource}
 ${nativeMCP.importSource}
 `;
-  const imageRuntime = _chunkYSPMY4B7cjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
+  const imageRuntime = _chunkC5S457CKcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
   const imageRuntimeImport = imageRuntime === "none" ? "" : `import { _withFarmImageSourceClientAddress, createCloudflareImageTransformer, createFarmImageHandler } from "@farm.js/core/image/server";`;
   const imageNodeRuntimeImport = imageRuntime === "node" ? `import { createNodeImageFetcher, createNodeImageUrlValidator, createSharpImageTransformer } from "@farm.js/core/image/sharp";` : "";
   const apiHandlerCode = apiRoutes.length > 0 ? `
@@ -6349,7 +6488,7 @@ const farmResolvedRuntimeConfig = Object.assign({}, ...farmRuntimeConfigs);
 
 function FarmDefault404Page() {
   return React.createElement(React.Fragment, null,
-    React.createElement("style", null, ${JSON.stringify(_chunkYSPMY4B7cjs.DEFAULT_NOT_FOUND_STYLES)}),
+    React.createElement("style", null, ${JSON.stringify(_chunkC5S457CKcjs.DEFAULT_NOT_FOUND_STYLES)}),
     React.createElement("main", {
       className: "farm-default-not-found",
       "aria-labelledby": "farm-default-not-found-title",
@@ -6652,12 +6791,12 @@ function fetchFarmInnerRequest(request, context) {
 }
 const farmLocalAPIBasePath = ${JSON.stringify(_chunkB5BBTPJQcjs.resolveFarmAPIServerBasePath.call(void 0, config.api))};
 const farmOpenAPIReference = ${JSON.stringify(openAPIReference)};
-${_optionalChain([config, 'access', _155 => _155.agent, 'optionalAccess', _156 => _156.apiCatalog]) ? `const farmApiCatalogInput = ${JSON.stringify(_chunkZGS3ZDF7cjs.resolveFarmApiCatalogInput.call(void 0, config))};
+${_optionalChain([config, 'access', _155 => _155.agent, 'optionalAccess', _156 => _156.apiCatalog]) ? `const farmApiCatalogInput = ${JSON.stringify(_chunkNPPT4RWFcjs.resolveFarmApiCatalogInput.call(void 0, config))};
 ` : ""}${_optionalChain([config, 'access', _157 => _157.agent, 'optionalAccess', _158 => _158.manifest]) !== false ? `const farmAppManifestInput = ${JSON.stringify(
-    _chunkZGS3ZDF7cjs.resolveFarmAppManifestInput.call(void 0, config, {
+    _chunkNPPT4RWFcjs.resolveFarmAppManifestInput.call(void 0, config, {
       build: config.deploymentId,
-      packages: _chunkYSPMY4B7cjs.resolveFarmAppPackages.call(void 0, config.root),
-      webmcpTools: config.plugins.some(({ name }) => name === "farm:webmcp") ? _chunkYSPMY4B7cjs.collectFarmWebMCPTools.call(void 0, config.root, config.srcDir) : []
+      packages: _chunkC5S457CKcjs.resolveFarmAppPackages.call(void 0, config.root),
+      webmcpTools: config.plugins.some(({ name }) => name === "farm:webmcp") ? _chunkC5S457CKcjs.collectFarmWebMCPTools.call(void 0, config.root, config.srcDir) : []
     })
   )};
 ${servesDefaultMCP ? "farmAppManifestInput.defaultMCP = getFarmDefaultMCPServer;\n" : ""}// A guard written for an MCP server's path keeps its tools out of the public view.
@@ -6799,11 +6938,16 @@ function escapeFarmHtmlAttribute(value) {
     .replace(/>/g, "&gt;");
 }
 
-async function renderFarmElement(ReactDOMServer, element, routeKey) {
+async function renderFarmElement(ReactDOMServer, element, routeKey, flushMarkers = false) {
+  // Written after each React flush in a streamed navigation (flushMarkers): the browser swaps in
+  // the shell, then adds each Suspense boundary as soon as the flush that completed it ends.
+  const FARM_FLUSH_MARKER = "<!--farm-flush-->";
   // Islands mode: each render writes its islands' values itself, so a request that renders twice
   // (notFound(), or a synchronous attempt that suspends and streams) still sends them.
   if (typeof farmIslandsRender === "function") element = farmIslandsRender(element);
   const streamErrors = [];
+  // A browser that leaves the page cancels the stream: React's abort errors are not failures.
+  let cancelled = false;
   const syncHtml = renderFarmElementSync(ReactDOMServer, element, routeKey);
   if (syncHtml !== undefined) return { html: syncHtml, shellHtml: syncHtml, streamErrors };
   let encoder;
@@ -6841,7 +6985,7 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
         // request handler must still receive them to map the response status,
         // but they should not produce a misleading SSR failure log.
         streamErrors.push(error);
-        if (isFarmRedirectError(error) || isFarmNotFoundError(error)) return;
+        if (cancelled || isFarmRedirectError(error) || isFarmNotFoundError(error)) return;
         console.error("[Farm SSR stream]", error);
       },
     });
@@ -6888,13 +7032,33 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
     }
 
     let replayFirstChunk = true;
+    let pendingRead = null;
+    // A flush is the chunks React has queued when a task boundary passes.
+    const drainFlush = async function(controller, waitForFirst) {
+      for (let first = waitForFirst; ; first = false) {
+        const read = pendingRead || (pendingRead = reader.read());
+        const result = first
+          ? await read
+          : await Promise.race([read, new Promise(function(resolve) { setTimeout(resolve, 0); })]);
+        if (!result) break;
+        pendingRead = null;
+        if (result.done) {
+          controller.close();
+          return;
+        }
+        controller.enqueue(normalizeChunk(result.value));
+      }
+      controller.enqueue(normalizeChunk(FARM_FLUSH_MARKER));
+    };
     const replayStream = new ReadableStream({
       pull(controller) {
         if (replayFirstChunk) {
           replayFirstChunk = false;
           controller.enqueue(firstChunk);
+          if (flushMarkers) return drainFlush(controller, false);
           return;
         }
+        if (flushMarkers) return drainFlush(controller, true);
         return reader.read().then(
           function(result) {
             if (result.done) controller.close();
@@ -6906,6 +7070,7 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
         );
       },
       cancel(reason) {
+        cancelled = true;
         return reader.cancel(reason);
       },
     });
@@ -6930,6 +7095,7 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
     let settleComplete;
     let rejectComplete;
     const chunks = [];
+    let unflushed = false;
     const decision = new Promise(function(resolve, reject) {
       settleDecision = resolve;
       rejectDecision = reject;
@@ -6952,8 +7118,15 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
         const normalized = normalizeChunk(chunk);
         if (streamStarted) streamController.enqueue(normalized);
         else chunks.push(normalized);
+        unflushed = true;
         return true;
       },
+      // React calls this after each flush.
+      flush() {
+        if (!flushMarkers || !streamStarted || streamClosed || !unflushed) return;
+        unflushed = false;
+        streamController.enqueue(normalizeChunk(FARM_FLUSH_MARKER));
+      },
       end() {
         if (streamClosed) return;
         streamClosed = true;
@@ -6982,6 +7155,9 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
                   streamController = controller;
                 },
                 cancel(reason) {
+                  // React writes its abort instructions: the stream no longer takes them.
+                  cancelled = true;
+                  streamClosed = true;
                   if (pipeableStream && typeof pipeableStream.abort === "function") {
                     pipeableStream.abort(reason);
                   }
@@ -7001,7 +7177,7 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
       onError(error) {
         // Same control-flow guard as the readable-stream path above.
         streamErrors.push(error);
-        if (isFarmRedirectError(error) || isFarmNotFoundError(error)) return;
+        if (cancelled || isFarmRedirectError(error) || isFarmNotFoundError(error)) return;
         console.error("[Farm SSR stream]", error);
       },
     });
@@ -7022,6 +7198,11 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
 
     streamStarted = true;
     for (const chunk of chunks) streamController.enqueue(chunk);
+    // What React wrote while its shell was ready is the shell; Suspense content follows.
+    if (flushMarkers && unflushed) {
+      unflushed = false;
+      streamController.enqueue(normalizeChunk(FARM_FLUSH_MARKER));
+    }
     if (streamClosed) streamController.close();
     return {
       stream,
@@ -7203,7 +7384,7 @@ function peelFarmDocumentPrefix(markup) {
   let inner = markup.replace(/^\\s+/, "");
   let hoisted = "";
   const wrapper = /^<div\\b[^>]*style=["']display\\s*:\\s*contents;?\\s*["'][^>]*>/i;
-  const hoistable = /${_chunkC2R5RVLAcjs.HOISTED_HEAD_ELEMENT.source}/i;
+  const hoistable = /${_chunkVCKGOXFIcjs.HOISTED_HEAD_ELEMENT.source}/i;
   let match;
   while ((match = wrapper.exec(inner) || hoistable.exec(inner))) {
     if (!/^<div/i.test(match[0])) hoisted += match[0];
@@ -7734,7 +7915,7 @@ function createFarmAgentRobotsResponse(request) {
 // a route guard.
 const farmAgentGuardedPages = new Set(${JSON.stringify(
     pageRoutes.map((route) => route.pattern).filter(
-      (pattern) => !pattern.includes("[") && _chunkC2R5RVLAcjs.farmPathGuardCoversPage.call(void 0, 
+      (pattern) => !pattern.includes("[") && _chunkVCKGOXFIcjs.farmPathGuardCoversPage.call(void 0, 
         {
           config: { middleware: config.middleware, integrations: config.integrations },
           middlewareRoutes
@@ -7781,7 +7962,7 @@ ${servesDefaultMCP ? `// agent.mcp: the default read-only MCP server at /mcp, as
 // aside for a page route that answers /mcp and for any MCP server published or
 // registered at runtime, such as the docs engine's.
 const farmDefaultMCPServer = ${JSON.stringify(
-    _chunkSBABQKPTcjs.createFarmDefaultMCPServer.call(void 0, readFarmAppPackageIdentity(config.root), _chunkJLS6ZLFMcjs.FARM_VERSION)
+    _chunkSBABQKPTcjs.createFarmDefaultMCPServer.call(void 0, readFarmAppPackageIdentity(config.root), _chunkJ5VCA45Kcjs.FARM_VERSION)
   )};
 let farmDefaultMCPRouteFree;
 function getFarmDefaultMCPServer() {
@@ -8191,7 +8372,7 @@ ${hasInfraAnalyticsRuntime ? `
 // endpoints, Markdown mirrors, and docs pages have no app route pattern, so they are
 // labeled here; route.pattern keeps meaning the matched app route for plugins.
 const farmBuiltInRoutePaths = new Set(${JSON.stringify(
-    _chunkZGS3ZDF7cjs.listFarmBuiltInRoutePaths.call(void 0, {
+    _chunkNPPT4RWFcjs.listFarmBuiltInRoutePaths.call(void 0, {
       agent: {
         ...config.agent,
         aiCatalog: servesAiCatalog,
@@ -8879,7 +9060,7 @@ ${hasServerRuntimeIntegrations ? `
   // agent.manifest: /.well-known/farmjs.json (and 0.1.34's /.well-known/farmjs), the app's
   // public manifest, the same document for every request.
   if (
-    [${JSON.stringify(_chunkZGS3ZDF7cjs.FARM_APP_MANIFEST_PATH)}, ${JSON.stringify(_chunkZGS3ZDF7cjs.FARM_APP_MANIFEST_LEGACY_PATH)}].includes(
+    [${JSON.stringify(_chunkNPPT4RWFcjs.FARM_APP_MANIFEST_PATH)}, ${JSON.stringify(_chunkNPPT4RWFcjs.FARM_APP_MANIFEST_LEGACY_PATH)}].includes(
       normalizeRuntimePath(routePathname),
     )
   ) {
@@ -8891,7 +9072,7 @@ ${hasServerRuntimeIntegrations ? `
   ` : ""}
   ${_optionalChain([config, 'access', _182 => _182.agent, 'optionalAccess', _183 => _183.apiCatalog]) ? `
   // agent.apiCatalog: list the OpenAPI and MCP surfaces at the RFC 9727 path.
-  if (normalizeRuntimePath(routePathname) === ${JSON.stringify(_chunkZGS3ZDF7cjs.FARM_API_CATALOG_PATH)}) {
+  if (normalizeRuntimePath(routePathname) === ${JSON.stringify(_chunkNPPT4RWFcjs.FARM_API_CATALOG_PATH)}) {
     return applyProductionMiddlewareHeaders(
       createFarmApiCatalogResponse(request.method, farmApiCatalogInput, request),
       middlewareHeaders,
@@ -9296,8 +9477,12 @@ ${hasServerRuntimeIntegrations ? `
           shouldHydrateLayout &&
           route.serverTree === true &&
           !route.shouldHydrate &&
-          request.headers.get("f-render") === "tree";` : `const farmLayoutKeyOf = null;
-        const farmPayloadOnlyNavigation = false;`}
+          request.headers.get("f-render") === "tree";
+        // A navigation the browser streams marks where each React flush ends, so the browser
+        // shows the page before its Suspense content arrives (FARM_FLUSH_MARKER).
+        const farmFlushMarkers = request.headers.get("f-stream") === "flush";` : `const farmLayoutKeyOf = null;
+        const farmPayloadOnlyNavigation = false;
+        const farmFlushMarkers = false;`}
         const renderPageElement = async () => {
             // First, render the page content
             let pageElement;
@@ -9419,7 +9604,7 @@ ${hasServerRuntimeIntegrations ? `
           }
 
           wrappedElement = wrapWithFarmIntegrationProviders(wrappedElement);
-          return renderFarmElement(ReactDOMServer, wrappedElement, route.pattern);
+          return renderFarmElement(ReactDOMServer, wrappedElement, route.pattern, farmFlushMarkers);
         };
         const renderedPage = ${hasMiddlewareRuntime ? `await _runWithMiddlewareData(middlewareData, () =>
           _runWithMiddlewareContext(middlewareContext, renderPageElement)
@@ -9542,7 +9727,7 @@ ${hasServerRuntimeIntegrations ? `
         // gets HTML without them.
         responseHeaders["Vary"] = farmSharedCacheableRoute
           ? "F-Layouts"
-          : "F-Values, F-Layouts, F-Render";` : ""}
+          : "F-Values, F-Layouts, F-Render, F-Stream";` : ""}
         let html = renderedPage.html;
         
         // Check if the layout already rendered a full HTML document
@@ -10391,8 +10576,8 @@ function getPhysicalPrerenderBypassReason(options) {
   if (rewriteSources.some((source) => middlewarePatternMatches(source, pathname))) {
     return "rewrite";
   }
-  if (_chunkC2R5RVLAcjs.appMiddlewareMayHandlePath.call(void 0, middlewareRoutes, pathname)) return "app middleware";
-  if (_chunkC2R5RVLAcjs.configMiddlewareMayHandlePath.call(void 0, config.middleware, pathname)) return "configured middleware";
+  if (_chunkVCKGOXFIcjs.appMiddlewareMayHandlePath.call(void 0, middlewareRoutes, pathname)) return "app middleware";
+  if (_chunkVCKGOXFIcjs.configMiddlewareMayHandlePath.call(void 0, config.middleware, pathname)) return "configured middleware";
   if (_chunkKZT2VHRQcjs.hasCustomFarmRouteContext.call(void 0, config)) return "request context";
   if (farmServerRuntimePluginsMayHandlePath(config, pathname)) return "server runtime plugin";
   const manifestEntry = getManifestPageEntry(routeRuntimeManifest, pathname);
@@ -10429,7 +10614,7 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const outputDir = _chunkKZT2VHRQcjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
   const runtimeServerOutputDir = isVercel ? _path2.default.join(outputDir, "functions", "__nitro.func") : _path2.default.join(outputDir, "server");
   const ssrOutputDir = _path2.default.join(root, distDir, "ssr");
-  const imageRuntime = _chunkYSPMY4B7cjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
+  const imageRuntime = _chunkC5S457CKcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
   const hasGeneratedMetadataImages = Array.from(routeManager.getMetadataImages().values()).some(
     (image) => image.sourceType === "module"
   );
@@ -11028,13 +11213,13 @@ function toFarmNodeResponse(request, response) {
   }
   if (prerenderRoutes.length > 0) {
     _chunkXN2MB4QZcjs.logger.info(`\u{1F4C4} Pre-rendering ${prerenderRoutes.length} SSG page(s)`);
-    const previousPrerender = process.env[_chunkHUL4LTC6cjs.FARM_PRERENDER_ENV];
-    process.env[_chunkHUL4LTC6cjs.FARM_PRERENDER_ENV] = "1";
+    const previousPrerender = process.env[_chunkHTLCLOXQcjs.FARM_PRERENDER_ENV];
+    process.env[_chunkHTLCLOXQcjs.FARM_PRERENDER_ENV] = "1";
     try {
       await nitroBuilder.prerender(nitroInstance);
     } finally {
-      if (previousPrerender === void 0) delete process.env[_chunkHUL4LTC6cjs.FARM_PRERENDER_ENV];
-      else process.env[_chunkHUL4LTC6cjs.FARM_PRERENDER_ENV] = previousPrerender;
+      if (previousPrerender === void 0) delete process.env[_chunkHTLCLOXQcjs.FARM_PRERENDER_ENV];
+      else process.env[_chunkHTLCLOXQcjs.FARM_PRERENDER_ENV] = previousPrerender;
     }
   }
   const sharpRuntimeStagePromise = imageRuntime === "node" ? stageSharpRuntime(config, root, distDir, fs4, preset) : Promise.resolve(null);
@@ -11298,7 +11483,7 @@ async function stageSharpRuntime(config, root, distDir, fs4, preset) {
   try {
     await copyPackage("sharp", sharpRequire);
     if (!copiedPackages.has("sharp")) {
-      throw new Error(`Farm image optimization requires sharp. ${_chunkYSPMY4B7cjs.SHARP_INSTALL_HINT}`);
+      throw new Error(`Farm image optimization requires sharp. ${_chunkC5S457CKcjs.SHARP_INSTALL_HINT}`);
     }
   } catch (error) {
     await fs4.rm(stageDir, { recursive: true, force: true });
@@ -11583,7 +11768,7 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     };
     config = {
       ...config,
-      images: _chunkYSPMY4B7cjs.resolveFarmImageProviderForRuntime.call(void 0, config.images, {
+      images: _chunkC5S457CKcjs.resolveFarmImageProviderForRuntime.call(void 0, config.images, {
         root: targets.root,
         preset: targets.preset
       })
@@ -11611,7 +11796,7 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
       root,
       rendererBuild.signal
     );
-    const farmApp = _chunkYSPMY4B7cjs.createFarmApp.call(void 0, config, projectModuleServer);
+    const farmApp = _chunkC5S457CKcjs.createFarmApp.call(void 0, config, projectModuleServer);
     await farmApp.initialize();
     const routeManager = farmApp.getRouteManager();
     const serverRenderer = farmApp.getServerRenderer();
@@ -11717,7 +11902,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
     ssr: true,
     buildLifetime
   });
-  const viteConfig = _chunkYSPMY4B7cjs.mergeFarmViteConfig.call(void 0, 
+  const viteConfig = _chunkC5S457CKcjs.mergeFarmViteConfig.call(void 0, 
     {
       root,
       appType: "custom",
@@ -11729,7 +11914,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
       },
       plugins: [
         ...rendererVitePlugins,
-        _chunkYSPMY4B7cjs.farmFontImportsPlugin.call(void 0, {
+        _chunkC5S457CKcjs.farmFontImportsPlugin.call(void 0, {
           root,
           basePath: config.basePath,
           publicDir: config.publicDir
@@ -11741,7 +11926,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
         hmr: false
       },
       resolve: {
-        alias: _chunkYSPMY4B7cjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
+        alias: _chunkC5S457CKcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
         dedupe: [...config.renderer.dedupe || []]
       },
       optimizeDeps: {