@farm.js/core 0.1.48 → 0.1.50

package/dist/{chunk-NE33FRQ5.mjs → chunk-WVBUXNBX.mjs}

@@ -1,6 +1,3 @@
-import {
-  loadFarmProductionVite
-} from "./chunk-PSUYE5HR.mjs";
 import {
   FARM_DESKTOP_ENV_MODULE_FILE,
   FARM_DESKTOP_ENV_MODULE_SOURCE,
@@ -10,6 +7,9 @@ import {
   createFarmNodeServerEntry,
   withProductionNodeEnv
 } from "./chunk-VU3MYZPO.mjs";
+import {
+  loadFarmProductionVite
+} from "./chunk-PSUYE5HR.mjs";
 import {
   generateNativeMCPPluginSource
 } from "./chunk-KQH2COEJ.mjs";
@@ -18,7 +18,7 @@ import {
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler,
   hasFarmDocsRuntimeAdapter
-} from "./chunk-QFQDRJKJ.mjs";
+} from "./chunk-76R5GJER.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -29,7 +29,7 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-GXSMF7UR.mjs";
+} from "./chunk-KO2NWUKN.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -37,7 +37,7 @@ import {
 } from "./chunk-WB6XES4V.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-N6SIQJEJ.mjs";
+} from "./chunk-M7LKA632.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-N35YPV4N.mjs";
@@ -52,7 +52,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-VJXLUTBM.mjs";
+} from "./chunk-2DEPNLXK.mjs";
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
@@ -84,7 +84,7 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath,
   usesFarmServerTree
-} from "./chunk-TQWGOQ7O.mjs";
+} from "./chunk-IWJKJDNW.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-XLLVWLWO.mjs";
@@ -95,7 +95,7 @@ import {
   generateFarmTypeArtifacts,
   readRouteRenderingDirectiveFromFile,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-HNAUK3SC.mjs";
+} from "./chunk-SHJJM6OG.mjs";
 import {
   HOISTED_HEAD_ELEMENT,
   appMiddlewareMayHandlePath,
@@ -108,10 +108,13 @@ import {
   layoutsCanCoverSamePage,
   routeBoundaryCoversDirectory,
   stripRouteGroups
-} from "./chunk-NIPKC4DA.mjs";
+} from "./chunk-ZIBIE7AH.mjs";
 import {
   farmPluginMayAffectRuntimePath
 } from "./chunk-UUMKLGUU.mjs";
+import {
+  isFarmPreviewDeploymentEnvironment
+} from "./chunk-CSLUBKGG.mjs";
 import {
   FARM_API_CATALOG_PATH,
   FARM_APP_MANIFEST_LEGACY_PATH,
@@ -119,18 +122,18 @@ import {
   listFarmBuiltInRoutePaths,
   resolveFarmApiCatalogInput,
   resolveFarmAppManifestInput
-} from "./chunk-NRFUVDTH.mjs";
+} from "./chunk-JJOWY3XD.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   createFarmDefaultMCPServer,
   farmConfigMountsMCP
 } from "./chunk-KRRZJ77U.mjs";
-import {
-  isFarmPreviewDeploymentEnvironment
-} from "./chunk-CSLUBKGG.mjs";
 import {
   farmEnvironmentFunctionsPlugin
 } from "./chunk-C5JXCUKR.mjs";
+import {
+  isFarmMarkdownPageFile
+} from "./chunk-GW4YUIHW.mjs";
 import {
   generateFarmDocsAdapterClientRuntime,
   getFarmDocsAdapterConfigModule
@@ -164,10 +167,14 @@ import {
 import {
   getFarmAppDirectories
 } from "./chunk-52Y3C3HG.mjs";
+import {
+  resolveFarmMdxComponentsModulePath,
+  resolveMdxConfig
+} from "./chunk-UIJOLBUL.mjs";
 import {
   applyFarmWorkflowVercelCrons,
   prepareFarmWorkflowsForNitro
-} from "./chunk-ATHPRVP2.mjs";
+} from "./chunk-5V4KZOZO.mjs";
 import {
   applyFarmCronVercelCrons,
   createFarmCronCloudflareConfig,
@@ -176,14 +183,7 @@ import {
 } from "./chunk-UCQ52TJY.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-JOHXK4BB.mjs";
-import {
-  isFarmMarkdownPageFile
-} from "./chunk-GW4YUIHW.mjs";
-import {
-  resolveFarmMdxComponentsModulePath,
-  resolveMdxConfig
-} from "./chunk-UIJOLBUL.mjs";
+} from "./chunk-BW6SCVYX.mjs";
 import {
   getFarmMarkdownAlternatePath
 } from "./chunk-N77JBPLC.mjs";
@@ -193,7 +193,7 @@ import {
 import {
   getFarmIntegrationPluginServerRuntime,
   getIntegrationProviders
-} from "./chunk-NW2BKDVT.mjs";
+} from "./chunk-HHFMECFO.mjs";
 import {
   FARM_INTEGRATION_API_BASE_PATH_KEY
 } from "./chunk-F6TLUMH7.mjs";
@@ -204,7 +204,7 @@ import {
 } from "./chunk-4HBKBHVP.mjs";
 import {
   APIRouteManager
-} from "./chunk-ALD2WMLA.mjs";
+} from "./chunk-WXHDVXJE.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-DU4VHHPJ.mjs";
@@ -231,7 +231,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-HRLYO2XJ.mjs";
+} from "./chunk-2VCC3GVC.mjs";
 import {
   getFarmPresetRuntime
 } from "./chunk-UAQD67HM.mjs";
@@ -954,7 +954,7 @@ export default async function farmNetlifyHandler(request, context) {
 // src/build/strip-platform-config.ts
 import { realpathSync } from "fs";
 import path8 from "path";
-var PLATFORM_CONFIG_KEYS = /* @__PURE__ */ new Set(["desktop"]);
+var PLATFORM_CONFIG_KEYS = /* @__PURE__ */ new Set(["desktop", "mobile"]);
 var CONFIG_FACTORIES = /* @__PURE__ */ new Set(["defineConfig", "defineFarmConfig"]);
 function isConfigObject(node) {
   return node?.type === "ObjectExpression";
@@ -989,23 +989,33 @@ function collectConfigObjects(node, found) {
   }
 }
 function stripPlatformConfigSource(code, parse) {
-  if (!code.includes("desktop")) return null;
+  if (!code.includes("desktop") && !code.includes("mobile")) return null;
   const objects = [];
   collectConfigObjects(parse(code), objects);
   const removals = [];
   for (const object of objects) {
     const properties = object.properties;
-    properties.forEach((property, index) => {
+    const removed = properties.map((property) => {
       const name = propertyName(property);
-      if (!name || !PLATFORM_CONFIG_KEYS.has(name)) return;
-      if (index < properties.length - 1)
-        removals.push([property.start, properties[index + 1].start]);
-      else if (index > 0) removals.push([properties[index - 1].end, property.end]);
-      else {
-        const trailingComma = /^\s*,/.exec(code.slice(property.end));
-        removals.push([property.start, property.end + (trailingComma?.[0].length ?? 0)]);
-      }
+      return !!name && PLATFORM_CONFIG_KEYS.has(name);
     });
+    for (let first = 0; first < properties.length; first++) {
+      if (!removed[first]) continue;
+      let last = first;
+      while (last + 1 < properties.length && removed[last + 1]) last++;
+      if (last < properties.length - 1) {
+        removals.push([properties[first].start, properties[last + 1].start]);
+      } else if (first > 0) {
+        removals.push([properties[first - 1].end, properties[last].end]);
+      } else {
+        const trailingComma = /^\s*,/.exec(code.slice(properties[last].end));
+        removals.push([
+          properties[first].start,
+          properties[last].end + (trailingComma?.[0].length ?? 0)
+        ]);
+      }
+      first = last;
+    }
   }
   if (removals.length === 0) return null;
   removals.sort((left, right) => right[0] - left[0]);
@@ -2044,7 +2054,7 @@ function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, optio
 async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map(), rendererBuildLifetime, programmaticClientRoutes) {
   const viteBuild = productionVite.build;
   const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin-4KYXV7BB.mjs");
+  const { PluginManager: PluginManager2 } = await import("./plugin-53SY5YBS.mjs");
   const fs4 = await import("fs/promises");
   const pluginManager = new PluginManager2({
     config,
@@ -2510,7 +2520,7 @@ function toBakedMarkdownSourcePath(root, filePath) {
   }
   return relative.split(path10.sep).join("/");
 }
-function generateUniversalRouterStateRuntime() {
+function generateUniversalRouterStateRuntime(streamNavigations = false) {
   return `
 const FARM_PAGE_STATE_KEY = "__farmPageState";
 const FARM_HISTORY_INDEX_KEY = "__farmHistoryIndex";
@@ -2578,6 +2588,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();
@@ -2781,9 +2831,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,
@@ -3077,6 +3153,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",
@@ -3085,13 +3166,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();
@@ -3372,7 +3468,7 @@ function isFarmDocsPath() {
 // Farm.js Client Runtime (no client components)
 ${cssImport}
 ${layoutImports}
-import { createClientCancellation, createClientPluginManager, getFarmIslandValueHeaders, getHashTargetElement, installChunkErrorRecovery, isFarmBlockedNavigationURL, isFarmExternalNavigationURL, reconcileFarmDocumentHead, setFarmBasePath, setFarmTrailingSlashPreference, stripFarmBasePath } from "@farm.js/core/internal/client-runtime";
+import { createClientCancellation, createClientPluginManager, getFarmIslandValueHeaders, getHashTargetElement, installChunkErrorRecovery, isFarmBlockedNavigationURL, isFarmExternalNavigationURL, reconcileFarmDocumentHead, runFarmNavigationDelegates, setFarmBasePath, setFarmTrailingSlashPreference, stripFarmBasePath } from "@farm.js/core/internal/client-runtime";
 import { createFarmDeploymentMismatchError, createFarmDeploymentRequestHeaders, isFarmDeploymentMismatchResponse } from "@farm.js/core/deployment";
 ${clientPluginEntry.imports}
 ${clientCachePersistence.imports}
@@ -3437,6 +3533,15 @@ ${generateUniversalRouterStateProperties()}
       if (action === "pop") this.revertBlockedPopState(from);
       return;
     }
+    // A refresh re-renders the page on screen; only a move to another page is offered.
+    if (
+      action !== "pop" &&
+      !(options.refresh && to === from) &&
+      (await runFarmNavigationDelegates({ url: url.href, from, to, action }))
+    ) {
+      this.cancelActiveNavigation();
+      return;
+    }
     if (action === "pop") {
       this.currentHistoryIndex = readHistoryIndex(options.popState);
       this.currentHistoryState = options.popState;
@@ -3737,7 +3842,7 @@ ${layoutImports}
 ${rendererClientImports}
 ${isolatedHydrationImport}
 ${providerClientCode.imports}
-import { createClientCancellation, createClientPluginManager, getFarmIslandValueHeaders, getHashTargetElement, installChunkErrorRecovery, isFarmBlockedNavigationURL, isFarmExternalNavigationURL, reconcileFarmDocumentHead, scheduleFarmIslandHydration, searchParamsToObject, setFarmBasePath, setFarmTrailingSlashPreference, stripFarmBasePath } from "@farm.js/core/internal/client-runtime";
+import { createClientCancellation, createClientPluginManager, getFarmIslandValueHeaders, getHashTargetElement, installChunkErrorRecovery, isFarmBlockedNavigationURL, isFarmExternalNavigationURL, reconcileFarmDocumentHead, runFarmNavigationDelegates, scheduleFarmIslandHydration, searchParamsToObject, setFarmBasePath, setFarmTrailingSlashPreference, stripFarmBasePath } from "@farm.js/core/internal/client-runtime";
 import { createFarmDeploymentMismatchError, createFarmDeploymentRequestHeaders, isFarmDeploymentMismatchResponse } from "@farm.js/core/deployment";
 import { createFarmRouter, isFarmRouteActive, matchFarmRoute } from "@farm.js/core/router";
 ${clientPluginEntry.imports}
@@ -4169,7 +4274,7 @@ let currentPathname = null;
 let isHydrated = false;
 let pendingPageHydrationController = null;
 
-${generateUniversalRouterStateRuntime()}
+${generateUniversalRouterStateRuntime(islandValues)}
 
 function cancelPendingPageHydration() {
   pendingPageHydrationController?.abort();
@@ -4357,6 +4462,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);
@@ -4399,7 +4553,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.
@@ -4411,7 +4565,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;
@@ -4457,6 +4611,15 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
       if (action === "pop") this.revertBlockedPopState(from);
       return;
     }
+    // A refresh re-renders the page on screen; only a move to another page is offered.
+    if (
+      action !== "pop" &&
+      !(options.refresh && to === from) &&
+      (await runFarmNavigationDelegates({ url: url.href, from, to, action }))
+    ) {
+      this.cancelActiveNavigation();
+      return;
+    }
     if (action === "pop") {
       this.currentHistoryIndex = readHistoryIndex(options.popState);
       this.currentHistoryState = options.popState;
@@ -4464,6 +4627,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).
@@ -4588,6 +4752,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,
@@ -4607,6 +4772,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,
@@ -4618,6 +4784,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;
@@ -4907,7 +5074,7 @@ void hydrate();
 async function buildSSRInMemory(productionVite, config, root, routeManager, apiRouteManager, serverRenderer, preset, collectedPageRoutes, collectedLayoutRoutes, collectedRouteSlots, isolatedClientBoundaryModules, hydrationPlanCache, rendererBuildLifetime) {
   const viteBuild = productionVite.build;
   const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin-4KYXV7BB.mjs");
+  const { PluginManager: PluginManager2 } = await import("./plugin-53SY5YBS.mjs");
   const fs4 = await import("fs/promises");
   const pluginManager = new PluginManager2({
     config,
@@ -6796,11 +6963,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;
@@ -6838,7 +7010,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);
       },
     });
@@ -6885,13 +7057,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();
@@ -6903,6 +7095,7 @@ async function renderFarmElement(ReactDOMServer, element, routeKey) {
         );
       },
       cancel(reason) {
+        cancelled = true;
         return reader.cancel(reason);
       },
     });
@@ -6927,6 +7120,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;
@@ -6949,8 +7143,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;
@@ -6979,6 +7180,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);
                   }
@@ -6998,7 +7202,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);
       },
     });
@@ -7019,6 +7223,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,
@@ -9293,8 +9502,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;
@@ -9416,7 +9629,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)
@@ -9539,7 +9752,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
@@ -11782,7 +11995,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
 }
 async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
   const { farmI18nClientBridgePlugin, farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin-4KYXV7BB.mjs");
+  const { PluginManager: PluginManager2 } = await import("./plugin-53SY5YBS.mjs");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -11809,7 +12022,7 @@ async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
 }
 async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
   const { farmI18nClientBridgePlugin, farmPlugin } = await import("./vite.mjs");
-  const { PluginManager: PluginManager2 } = await import("./plugin-4KYXV7BB.mjs");
+  const { PluginManager: PluginManager2 } = await import("./plugin-53SY5YBS.mjs");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -11850,7 +12063,7 @@ function resolveLegacyPageEntry(config, root, srcDir) {
 }
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-UT2J5A5D.mjs"),
+    import("./nitro-2Q5NVY7L.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(