@farm.js/core 0.1.51-beta.0 → 0.1.51-beta.2

package/dist/{chunk-SO3T6T4I.cjs → chunk-DTU4PX7V.cjs}

@@ -15,13 +15,14 @@ var _chunkVZY7MAVScjs = require('./chunk-VZY7MAVS.cjs');
 var _chunkVM57CK74cjs = require('./chunk-VM57CK74.cjs');
 
 
+var _chunk7FVVQEVLcjs = require('./chunk-7FVVQEVL.cjs');
 
 
 
-var _chunkVIFPE5RGcjs = require('./chunk-VIFPE5RG.cjs');
 
 
 
+var _chunkGNJIYJMScjs = require('./chunk-GNJIYJMS.cjs');
 
 
 
@@ -29,7 +30,11 @@ var _chunkVIFPE5RGcjs = require('./chunk-VIFPE5RG.cjs');
 
 
 
-var _chunkIOUOGRDXcjs = require('./chunk-IOUOGRDX.cjs');
+
+
+
+
+var _chunk5N7QAGEAcjs = require('./chunk-5N7QAGEA.cjs');
 
 
 
@@ -37,7 +42,7 @@ var _chunkIOUOGRDXcjs = require('./chunk-IOUOGRDX.cjs');
 var _chunkDZZHTMWMcjs = require('./chunk-DZZHTMWM.cjs');
 
 
-var _chunkVO6NLTV4cjs = require('./chunk-VO6NLTV4.cjs');
+var _chunkQXPSWMUDcjs = require('./chunk-QXPSWMUD.cjs');
 
 
 var _chunkBRWIVOV4cjs = require('./chunk-BRWIVOV4.cjs');
@@ -52,7 +57,7 @@ var _chunkV3UOEWCBcjs = require('./chunk-V3UOEWCB.cjs');
 
 
 
-var _chunkO3MMJPC2cjs = require('./chunk-O3MMJPC2.cjs');
+var _chunkNPQLMP7Mcjs = require('./chunk-NPQLMP7M.cjs');
 
 
 
@@ -84,7 +89,7 @@ var _chunkO3MMJPC2cjs = require('./chunk-O3MMJPC2.cjs');
 
 
 
-var _chunkF42U3R4Fcjs = require('./chunk-F42U3R4F.cjs');
+var _chunkWZW6LEHMcjs = require('./chunk-WZW6LEHM.cjs');
 
 
 var _chunkLNM57D3Hcjs = require('./chunk-LNM57D3H.cjs');
@@ -95,7 +100,7 @@ var _chunk3EEET2Q5cjs = require('./chunk-3EEET2Q5.cjs');
 
 
 
-var _chunkY7TLL65Bcjs = require('./chunk-Y7TLL65B.cjs');
+var _chunkUQHIWZZ6cjs = require('./chunk-UQHIWZZ6.cjs');
 
 
 
@@ -122,7 +127,7 @@ var _chunkSGBNF56Scjs = require('./chunk-SGBNF56S.cjs');
 
 
 
-var _chunkJ22JD5YJcjs = require('./chunk-J22JD5YJ.cjs');
+var _chunkJ3LBO2O4cjs = require('./chunk-J3LBO2O4.cjs');
 
 
 
@@ -130,7 +135,7 @@ var _chunkJ22JD5YJcjs = require('./chunk-J22JD5YJ.cjs');
 var _chunkSBABQKPTcjs = require('./chunk-SBABQKPT.cjs');
 
 
-var _chunkJ37KTQIAcjs = require('./chunk-J37KTQIA.cjs');
+var _chunkNK2VWS7Pcjs = require('./chunk-NK2VWS7P.cjs');
 
 
 var _chunkJATTVAHAcjs = require('./chunk-JATTVAHA.cjs');
@@ -193,7 +198,7 @@ var _chunkJMYXO572cjs = require('./chunk-JMYXO572.cjs');
 
 
 
-var _chunkWAPQWAE6cjs = require('./chunk-WAPQWAE6.cjs');
+var _chunkCECUDGXQcjs = require('./chunk-CECUDGXQ.cjs');
 
 
 var _chunkPFV2KPDZcjs = require('./chunk-PFV2KPDZ.cjs');
@@ -231,7 +236,7 @@ var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkX5BCMLGPcjs = require('./chunk-X5BCMLGP.cjs');
+var _chunkGUJTVM36cjs = require('./chunk-GUJTVM36.cjs');
 
 
 var _chunkE552H232cjs = require('./chunk-E552H232.cjs');
@@ -338,7 +343,7 @@ function getDocsTitle(docs) {
   return typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Documentation") : "Documentation";
 }
 function loadPages(contentDir, docs) {
-  return _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, contentDir, docs).map((page) => _chunkIOUOGRDXcjs.loadFarmDocsPage.call(void 0, contentDir, docs, page.slug)).filter((page) => Boolean(page)).sort((a, b) => a.href.localeCompare(b.href));
+  return _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, contentDir, docs).map((page) => _chunk5N7QAGEAcjs.loadFarmDocsPage.call(void 0, contentDir, docs, page.slug)).filter((page) => Boolean(page)).sort((a, b) => a.href.localeCompare(b.href));
 }
 function findSocialImagePath(html) {
   const match = /<meta\s+property=["']og:image["']\s+content=["']([^"']+)["']/i.exec(html) || /<meta\s+content=["']([^"']+)["']\s+property=["']og:image["']/i.exec(html);
@@ -356,14 +361,14 @@ async function addHandlerRoute(routes, pathname, handler, absolutePaths) {
   return response;
 }
 async function compileFarmDocsManifest(docs, options) {
-  const contentDir = _chunkIOUOGRDXcjs.resolveFarmDocsContentDir.call(void 0, docs, options);
+  const contentDir = _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, docs, options);
   const pages = loadPages(contentDir, docs);
   const absolutePaths = [
     _path2.default.resolve(options.root),
     _path2.default.resolve(contentDir),
     docs.configPath || ""
   ];
-  const handler = _chunkIOUOGRDXcjs.createFarmDocsHandler.call(void 0, docs, {
+  const handler = _chunk5N7QAGEAcjs.createFarmDocsHandler.call(void 0, docs, {
     root: options.root,
     srcDir: options.srcDir,
     clientEntry: options.clientEntry,
@@ -372,7 +377,7 @@ async function compileFarmDocsManifest(docs, options) {
     globalStylesheetHref: options.globalStylesheetHref,
     isPathGuarded: options.isPathGuarded
   });
-  const apiHandler = _chunkVIFPE5RGcjs.createFarmDocsAPIHandler.call(void 0, {
+  const apiHandler = _chunkGNJIYJMScjs.createFarmDocsAPIHandler.call(void 0, {
     rootDir: options.root,
     srcDir: options.srcDir,
     docs,
@@ -383,7 +388,7 @@ async function compileFarmDocsManifest(docs, options) {
   const apiMarkdown = {};
   for (const page of pages) {
     const htmlResponse = await addHandlerRoute(routes, page.href, handler, absolutePaths);
-    const markdownPath = _chunkIOUOGRDXcjs.getFarmDocsMarkdownPath.call(void 0, page.href);
+    const markdownPath = _chunk5N7QAGEAcjs.getFarmDocsMarkdownPath.call(void 0, page.href);
     await addHandlerRoute(routes, markdownPath, handler, absolutePaths);
     if (htmlResponse) {
       const socialImagePath = findSocialImagePath(await htmlResponse.text());
@@ -467,7 +472,7 @@ async function compileFarmDocsManifest(docs, options) {
       post: await compileResponse(postResponse, absolutePaths),
       search: {
         pages: publicPages.map((page) => ({
-          ..._chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page),
+          ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
           sourcePath: `farm-docs:${page.slug || "index"}`
         })),
         search: _nullishCoalesce(searchConfig, () => ( true)),
@@ -645,7 +650,7 @@ async function createFarmRouteRuntimeManifest(options) {
   const routes = [];
   for (const [pattern, entry] of options.routeManager.getRoutes()) {
     const routeModule = await options.routeManager.loadRouteModule(entry.modulePath);
-    const rendering = await _chunkY7TLL65Bcjs.resolveRouteRenderingConfigFromFile.call(void 0, routeModule, entry.modulePath);
+    const rendering = await _chunkUQHIWZZ6cjs.resolveRouteRenderingConfigFromFile.call(void 0, routeModule, entry.modulePath);
     const runtimeConfig = await options.routeManager.resolveRouteRuntimeConfig(pattern);
     routes.push({
       kind: "page",
@@ -1685,15 +1690,14 @@ function createServerChunkMinifyPlugin(options) {
 function trimSlashes(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
-function resolveBuildDocsContentDir(config, root) {
-  if (!_optionalChain([config, 'access', _48 => _48.docs, 'optionalAccess', _49 => _49.enabled])) return null;
-  const configuredContentDir = config.docs.contentDir || config.docs.config.contentDir;
+function resolveBuildDocsContentDir(docs, root, srcDir) {
+  const configuredContentDir = docs.contentDir || docs.config.contentDir;
   if (typeof configuredContentDir === "string" && configuredContentDir.trim()) {
     const contentDir = _path2.default.isAbsolute(configuredContentDir) ? configuredContentDir : _path2.default.join(root, configuredContentDir);
     return _fs.existsSync.call(void 0, contentDir) ? contentDir : null;
   }
-  const entryDir = config.docs.config.entry || trimSlashes(config.docs.entry) || "docs";
-  const appDocsDir = _path2.default.join(root, config.srcDir || "src", "app", entryDir);
+  const entryDir = docs.config.entry || trimSlashes(docs.entry) || "docs";
+  const appDocsDir = _path2.default.join(root, srcDir || "src", "app", entryDir);
   if (_fs.existsSync.call(void 0, appDocsDir)) return appDocsDir;
   const rootDocsDir = _path2.default.join(root, entryDir);
   return _fs.existsSync.call(void 0, rootDocsDir) ? rootDocsDir : null;
@@ -1746,7 +1750,7 @@ async function findFarmConfigPath(root) {
 }
 function hasFarmServerRuntimePlugins(config) {
   return (config.plugins || []).some((plugin) => {
-    if (_chunkWAPQWAE6cjs.getFarmIntegrationPluginServerRuntime.call(void 0, plugin) === false) return false;
+    if (_chunkCECUDGXQcjs.getFarmIntegrationPluginServerRuntime.call(void 0, plugin) === false) return false;
     return Boolean(
       plugin.setup || plugin.init || plugin.ready || plugin.shutdown || plugin.runtime || plugin.router || plugin.render || plugin.beforeRouteMatch || plugin.afterRouteMatch || plugin.beforeRender || plugin.afterRender || plugin.onError || plugin.transformHTML
     );
@@ -1757,7 +1761,9 @@ function hasFarmPluginRoutes(config) {
 }
 function farmServerRuntimePluginsMayHandlePath(config, pathname) {
   return (config.plugins || []).some(
-    (plugin) => _chunkWAPQWAE6cjs.getFarmIntegrationPluginServerRuntime.call(void 0, plugin) !== false && _chunk47JV57DAcjs.farmPluginMayAffectRuntimePath.call(void 0, plugin, pathname)
+    (plugin) => _chunkCECUDGXQcjs.getFarmIntegrationPluginServerRuntime.call(void 0, plugin) !== false && // Mobile session tokens change only bearer requests and cookie-clearing responses, which a
+    // prerendered file never answers or sends; its endpoints live under /__farm/.
+    plugin.name !== _chunk7FVVQEVLcjs.FARM_MOBILE_SESSION_PLUGIN && _chunk47JV57DAcjs.farmPluginMayAffectRuntimePath.call(void 0, plugin, pathname)
   );
 }
 async function discoverMiddlewareRoutes(appDir) {
@@ -1803,7 +1809,7 @@ async function discoverMiddlewareRoutes(appDir) {
   return Array.from(routes.values()).sort(_chunkB3GZAQSCcjs.compareMiddlewareRouteLocations).map(({ path: routePath, filePath }) => ({ path: routePath, filePath }));
 }
 function assertFarmDocsRuntimeSupported(config, preset) {
-  if (!_optionalChain([config, 'access', _50 => _50.docs, 'optionalAccess', _51 => _51.enabled]) || !_optionalChain([config, 'access', _52 => _52.docs, 'access', _53 => _53.adapter, 'optionalAccess', _54 => _54.server]) || _chunkE552H232cjs.getFarmPresetRuntime.call(void 0, preset) !== "edge" || Boolean(config.docs.adapter.edgeCompiler)) {
+  if (!_optionalChain([config, 'access', _48 => _48.docs, 'optionalAccess', _49 => _49.enabled]) || !_optionalChain([config, 'access', _50 => _50.docs, 'access', _51 => _51.adapter, 'optionalAccess', _52 => _52.server]) || _chunkE552H232cjs.getFarmPresetRuntime.call(void 0, preset) !== "edge" || Boolean(config.docs.adapter.edgeCompiler)) {
     return;
   }
   throw new Error(
@@ -1816,7 +1822,7 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
   assertFarmDocsRuntimeSupported(config, preset);
   const srcDir = config.srcDir || "src";
   const distDir = config.distDir || ".farm";
-  const deployOutputDir = _chunkO3MMJPC2cjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
+  const deployOutputDir = _chunkNPQLMP7Mcjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
   const lifecyclePluginManager = options.pluginManager;
   const productionViteResultPromise = Promise.allSettled([
     Promise.resolve(_nullishCoalesce(options.productionVite, () => ( _chunkMF3IA2AWcjs.loadFarmProductionVite.call(void 0, ))))
@@ -2027,7 +2033,7 @@ ${islandsErrors.map((error) => `  - ${error}`).join("\n")}`
     _chunkVQJYGZNXcjs.logger.error(`\u274C Build failed: ${error}`);
     throw error;
   } finally {
-    _optionalChain([rendererBuild, 'optionalAccess', _55 => _55.abort, 'call', _56 => _56()]);
+    _optionalChain([rendererBuild, 'optionalAccess', _53 => _53.abort, 'call', _54 => _54()]);
   }
 }
 async function writeSSRAssetsToClient(bundle, outputDir) {
@@ -2072,7 +2078,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, _chunkF42U3R4Fcjs.mergeFarmFontCss.call(void 0, clientCss, normalizedFontCss));
+  await fs4.writeFile(clientCssPath, _chunkWZW6LEHMcjs.mergeFarmFontCss.call(void 0, clientCss, normalizedFontCss));
 }
 var IncompleteClientBuildOutputError = class extends Error {
   constructor(detail) {
@@ -2118,7 +2124,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 = _chunkF42U3R4Fcjs.getClientModuleHydrationPlan.call(void 0, modulePath, root, mode, options);
+    plan = _chunkWZW6LEHMcjs.getClientModuleHydrationPlan.call(void 0, modulePath, root, mode, options);
     cache.set(key, plan);
   }
   return { ...plan, isolatedBoundaries: [...plan.isolatedBoundaries] };
@@ -2135,31 +2141,31 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   });
   pluginManager.addPlugins(config.plugins || []);
   const clientPages = [];
-  const integrationProviders = _chunkWAPQWAE6cjs.getIntegrationProviders.call(void 0, config.integrations).filter(
+  const integrationProviders = _chunkCECUDGXQcjs.getIntegrationProviders.call(void 0, config.integrations).filter(
     (provider) => provider.component || provider.type === "clerk"
   );
   const unsupportedIntegrationProvider = integrationProviders.find(
     (provider) => provider.supportsIsolatedHydration !== true
   );
-  if (_optionalChain([config, 'access', _57 => _57.experimental, 'optionalAccess', _58 => _58.isolatedClientHydration]) === "enabled" && _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _59 => _59.experimental, 'optionalAccess', _60 => _60.serverComponents])) !== "rsc" && unsupportedIntegrationProvider) {
+  if (_optionalChain([config, 'access', _55 => _55.experimental, 'optionalAccess', _56 => _56.isolatedClientHydration]) === "enabled" && _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _57 => _57.experimental, 'optionalAccess', _58 => _58.serverComponents])) !== "rsc" && unsupportedIntegrationProvider) {
     _chunkVQJYGZNXcjs.logger.warn(
       `[Farm.js] isolated hydration kept route-wide because integration provider "${unsupportedIntegrationProvider.name}" does not declare supportsIsolatedHydration: true.`
     );
   }
-  const isolatedMode = _chunkF42U3R4Fcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
-    _optionalChain([config, 'access', _61 => _61.experimental, 'optionalAccess', _62 => _62.isolatedClientHydration]),
+  const isolatedMode = _chunkWZW6LEHMcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
+    _optionalChain([config, 'access', _59 => _59.experimental, 'optionalAccess', _60 => _60.isolatedClientHydration]),
     {
-      serverComponents: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _63 => _63.experimental, 'optionalAccess', _64 => _64.serverComponents])) === "rsc",
+      serverComponents: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _61 => _61.experimental, 'optionalAccess', _62 => _62.serverComponents])) === "rsc",
       hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
     }
   );
-  const planOptions = _chunkF42U3R4Fcjs.getFarmClientHydrationPlanOptions.call(void 0, 
+  const planOptions = _chunkWZW6LEHMcjs.getFarmClientHydrationPlanOptions.call(void 0, 
     config.renderer,
     Boolean(unsupportedIntegrationProvider)
   );
   const pagePlanOptions = {
     ...planOptions,
-    serverOwners: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _65 => _65.experimental, 'optionalAccess', _66 => _66.serverComponents])) === "islands"
+    serverOwners: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _63 => _63.experimental, 'optionalAccess', _64 => _64.serverComponents])) === "islands"
   };
   const layoutPlanOptions = {
     ...planOptions,
@@ -2213,15 +2219,18 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   const layoutAppliesToRoute = _chunk76GHW3WIcjs.routeBoundaryCoversDirectory;
   const routeDirectory = (route) => _nullishCoalesce(route.directory, () => ( route.pattern));
   const adapterOwnsDocsRuntime = Boolean(
-    _chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) && _optionalChain([config, 'access', _67 => _67.docs, 'optionalAccess', _68 => _68.enabled]) && _optionalChain([config, 'access', _69 => _69.docs, 'access', _70 => _70.adapter, 'optionalAccess', _71 => _71.server]) && config.docs.adapter.react
+    _chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) && _optionalChain([config, 'access', _65 => _65.docs, 'optionalAccess', _66 => _66.enabled]) && _optionalChain([config, 'access', _67 => _67.docs, 'access', _68 => _68.adapter, 'optionalAccess', _69 => _69.server]) && config.docs.adapter.react
   );
-  const adapterDocsEntry = _optionalChain([config, 'access', _72 => _72.docs, 'optionalAccess', _73 => _73.enabled]) ? `/${config.docs.entry || "docs"}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/" : null;
-  const isAdapterDocsRoute = (routePattern) => Boolean(
-    adapterOwnsDocsRuntime && adapterDocsEntry && (adapterDocsEntry === "/" || routePattern === adapterDocsEntry || routePattern.startsWith(`${adapterDocsEntry}/`))
+  const docsEntries = _optionalChain([config, 'access', _70 => _70.docs, 'optionalAccess', _71 => _71.enabled]) ? _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, config.docs).map(
+    (docsRoot) => `/${docsRoot.entry || "docs"}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/"
+  ) : [];
+  const adapterDocsEntry = _nullishCoalesce(docsEntries[0], () => ( null));
+  const isAdapterDocsRoute = (routePattern) => adapterOwnsDocsRuntime && docsEntries.some(
+    (docsEntry) => docsEntry === "/" || routePattern === docsEntry || routePattern.startsWith(`${docsEntry}/`)
   );
-  const syntheticDocsEntry = _optionalChain([config, 'access', _74 => _74.docs, 'optionalAccess', _75 => _75.enabled]) && !adapterOwnsDocsRuntime ? adapterDocsEntry : null;
+  const syntheticDocsEntry = _optionalChain([config, 'access', _72 => _72.docs, 'optionalAccess', _73 => _73.enabled]) && !adapterOwnsDocsRuntime ? adapterDocsEntry : null;
   const syntheticDocsPatterns = syntheticDocsEntry ? syntheticDocsEntry === "/" ? ["/", "/[...slug]"] : [syntheticDocsEntry, `${syntheticDocsEntry}/[...slug]`] : [];
-  const markdownPagePlan = _chunkF42U3R4Fcjs.createMarkdownPageHydrationPlanner.call(void 0, 
+  const markdownPagePlan = _chunkWZW6LEHMcjs.createMarkdownPageHydrationPlanner.call(void 0, 
     _chunk2HW5LWAHcjs.resolveFarmMdxComponentsModulePath.call(void 0, _chunk2HW5LWAHcjs.resolveMdxConfig.call(void 0, config.mdx), root),
     root,
     isolatedMode,
@@ -2237,7 +2246,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       pagePlanOptions
     )
   }));
-  _chunkF42U3R4Fcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
+  _chunkWZW6LEHMcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
     clientLayouts.map((layout) => ({
       pattern: layout.pattern,
       depth: layout.pattern.split("/").filter(Boolean).length,
@@ -2267,9 +2276,9 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     layoutAppliesToRoute
   );
   for (const layout of clientLayouts) {
-    const matchesBuiltRoute = pageRoutes.some((route) => layoutAppliesToRoute(layout.pattern, routeDirectory(route))) || Boolean(adapterDocsEntry && layoutAppliesToRoute(layout.pattern, adapterDocsEntry));
+    const matchesBuiltRoute = pageRoutes.some((route) => layoutAppliesToRoute(layout.pattern, routeDirectory(route))) || docsEntries.some((docsEntry) => layoutAppliesToRoute(layout.pattern, docsEntry));
     if (matchesBuiltRoute && layout.suppressedAsyncHydration) {
-      _chunkVQJYGZNXcjs.logger.warn(`\u26A0\uFE0F  ${_chunkF42U3R4Fcjs.describeSuppressedAsyncHydration.call(void 0, layout.pattern, layout.fallbackReason)}`);
+      _chunkVQJYGZNXcjs.logger.warn(`\u26A0\uFE0F  ${_chunkWZW6LEHMcjs.describeSuppressedAsyncHydration.call(void 0, layout.pattern, layout.fallbackReason)}`);
     }
   }
   if (isolatedMode === "analyze") {
@@ -2293,7 +2302,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       );
       if (metadata.suppressedAsyncHydration) {
         _chunkVQJYGZNXcjs.logger.warn(
-          `\u26A0\uFE0F  ${_chunkF42U3R4Fcjs.describeSuppressedAsyncHydration.call(void 0, route.pattern, metadata.fallbackReason)}`
+          `\u26A0\uFE0F  ${_chunkWZW6LEHMcjs.describeSuppressedAsyncHydration.call(void 0, route.pattern, metadata.fallbackReason)}`
         );
       }
       if (metadata.shouldHydrate || metadata.hasIsolatedClientBoundaries || applicableClientLayouts.length > 0) {
@@ -2318,7 +2327,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.
-          ..._chunkF42U3R4Fcjs.usesFarmServerTree.call(void 0, metadata) && applicableClientLayouts.some((layout) => layout.shouldHydrate) ? { serverTree: true } : {}
+          ..._chunkWZW6LEHMcjs.usesFarmServerTree.call(void 0, metadata) && applicableClientLayouts.some((layout) => layout.shouldHydrate) ? { serverTree: true } : {}
         });
         _chunkVQJYGZNXcjs.logger.info(`\u{1F4F1} Found hydratable route: ${route.pattern} -> ${route.modulePath}`);
       }
@@ -2354,7 +2363,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   }
   const clientRouteSlots = routeSlots.filter((slot) => {
     try {
-      return _chunkF42U3R4Fcjs.getClientModuleMetadata.call(void 0, slot.modulePath, root).shouldHydrate;
+      return _chunkWZW6LEHMcjs.getClientModuleMetadata.call(void 0, slot.modulePath, root).shouldHydrate;
     } catch (error) {
       _chunkVQJYGZNXcjs.logger.warn(`\u26A0\uFE0F  Could not inspect route slot ${slot.modulePath}: ${error}`);
       return false;
@@ -2375,18 +2384,18 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     srcDir,
     adapterOwnsDocsRuntime ? false : _chunkDZZHTMWMcjs.isFarmDocsSearchEnabled.call(void 0, config.docs),
     adapterOwnsDocsRuntime ? void 0 : _chunkDZZHTMWMcjs.resolveFarmDocsSearchClientModule.call(void 0, root),
-    _optionalChain([config, 'access', _76 => _76.docs, 'optionalAccess', _77 => _77.enabled]) ? config.docs.entry : void 0,
-    adapterOwnsDocsRuntime ? _optionalChain([config, 'access', _78 => _78.docs, 'access', _79 => _79.adapter, 'optionalAccess', _80 => _80.react]) : void 0,
+    _optionalChain([config, 'access', _74 => _74.docs, 'optionalAccess', _75 => _75.enabled]) ? _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, config.docs).map((docsRoot) => docsRoot.entry) : void 0,
+    adapterOwnsDocsRuntime ? _optionalChain([config, 'access', _76 => _76.docs, 'access', _77 => _77.adapter, 'optionalAccess', _78 => _78.react]) : void 0,
     config.i18n,
     config.plugins,
     config.renderer,
     config.publicRuntimeConfig,
     config.trailingSlash,
-    _chunkWAPQWAE6cjs.getIntegrationProviders.call(void 0, config.integrations),
+    _chunkCECUDGXQcjs.getIntegrationProviders.call(void 0, config.integrations),
     config.basePath,
-    _chunkF42U3R4Fcjs.generateClientCachePersistenceCode.call(void 0, _chunkF42U3R4Fcjs.resolveFarmClientCacheAdapterEntry.call(void 0, root, config.cache)),
+    _chunkWZW6LEHMcjs.generateClientCachePersistenceCode.call(void 0, _chunkWZW6LEHMcjs.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', _81 => _81.experimental, 'optionalAccess', _82 => _82.serverComponents])) === "islands"
+    _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _79 => _79.experimental, 'optionalAccess', _80 => _80.serverComponents])) === "islands"
   );
   await fs4.writeFile(clientEntryPath, clientHydrationCode);
   const hasScopedPostcssConfig = hasProjectPostcssConfig(root);
@@ -2423,7 +2432,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         outDir: outputDir,
         emptyOutDir: true,
         // Never public: see resolveFarmClientSourcemap.
-        sourcemap: resolveFarmClientSourcemap(_optionalChain([config, 'access', _83 => _83.vite, 'optionalAccess', _84 => _84.build, 'optionalAccess', _85 => _85.sourcemap])),
+        sourcemap: resolveFarmClientSourcemap(_optionalChain([config, 'access', _81 => _81.vite, 'optionalAccess', _82 => _82.build, 'optionalAccess', _83 => _83.sourcemap])),
         assetsInlineLimit: 0,
         cssCodeSplit: false,
         // Bundle all CSS into one file
@@ -2437,34 +2446,15 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             hashCharacters: "hex",
             // Use predictable name for CSS so we can reference it in SSR HTML
             assetFileNames: (assetInfo) => {
-              if (_optionalChain([assetInfo, 'access', _86 => _86.name, 'optionalAccess', _87 => _87.endsWith, 'call', _88 => _88(".css")])) {
+              if (_optionalChain([assetInfo, 'access', _84 => _84.name, 'optionalAccess', _85 => _85.endsWith, 'call', _86 => _86(".css")])) {
                 return "farm-client.css";
               }
               return "assets/[name]-h[hash][extname]";
             }
           },
-          // Externalize Node.js built-ins and server-side modules for client build
+          // A browser cannot load a Node builtin: farmServerOnlyEntriesPlugin
+          // resolves one to Farm's browser module for it instead.
           external: (id) => {
-            if (id.startsWith("node:") || [
-              "path",
-              "url",
-              "fs",
-              "fs/promises",
-              "os",
-              "crypto",
-              "http",
-              "https",
-              "net",
-              "stream",
-              "util",
-              "events",
-              "child_process",
-              "module",
-              "tty",
-              "dns"
-            ].includes(id)) {
-              return true;
-            }
             if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node")) {
               return true;
             }
@@ -2473,7 +2463,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         }
       },
       plugins: [
-        _chunkF42U3R4Fcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
+        _chunkWZW6LEHMcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
         createFarmPrivateClientSourcemapsPlugin({
           outDir: _path2.default.join(_path2.default.dirname(outputDir), FARM_CLIENT_SOURCEMAPS_DIR)
         }),
@@ -2498,7 +2488,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
         farmServerOnlyEntriesPlugin(),
-        _chunkF42U3R4Fcjs.farmDocsClientConfigPlugin.call(void 0, 
+        _chunkWZW6LEHMcjs.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
@@ -2552,7 +2542,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
           { ...config, isolatedClientBoundaryModules, programmaticClientRoutes },
           pluginManager
         ),
-        _chunkJ37KTQIAcjs.farmEnvironmentFunctionsPlugin.call(void 0, config)
+        _chunkNK2VWS7Pcjs.farmEnvironmentFunctionsPlugin.call(void 0, config)
       ],
       mode: "production",
       css: postcssSearchPath ? {
@@ -2560,7 +2550,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       } : void 0,
       // Ensure React is bundled for client
       resolve: {
-        alias: _chunkF42U3R4Fcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
+        alias: _chunkWZW6LEHMcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
         dedupe: [...config.renderer.dedupe || []]
       },
       // Optimize dependencies - exclude server-side code from client bundle
@@ -2573,7 +2563,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         ]
       }
     };
-    await viteBuild(_chunkF42U3R4Fcjs.mergeFarmProductionViteConfig.call(void 0, clientViteConfig, config.vite));
+    await viteBuild(_chunkWZW6LEHMcjs.mergeFarmProductionViteConfig.call(void 0, clientViteConfig, config.vite));
     await mergeBuiltFontCss(outputDir);
     await validateClientBuildOutput(root, srcDir, outputDir);
   } finally {
@@ -2660,21 +2650,24 @@ 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
+${streamNavigations ? `// 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) {
+// The marker carries the random token the server sent in the F-Flush header, so page content
+// cannot forge a boundary; a response without a valid token is all shell.
+async function readFarmNavigationStream(body, flushToken) {
   const reader = body.getReader();
   const decoder = new TextDecoder();
+  const marker = typeof flushToken === "string" && /^[0-9a-f]{32}$/.test(flushToken)
+    ? "<!--farm-flush:" + flushToken + "-->"
+    : "";
   let text = "";
   let done = false;
   const next = async function() {
     for (;;) {
-      const at = text.indexOf(FARM_FLUSH_MARKER);
+      const at = marker ? text.indexOf(marker) : -1;
       if (at !== -1) {
         const flush = text.slice(0, at);
-        text = text.slice(at + FARM_FLUSH_MARKER.length);
+        text = text.slice(at + marker.length);
         return flush;
       }
       if (done) {
@@ -3248,7 +3241,7 @@ ${streamNavigations ? `  // A streamed navigation swaps in the page's shell; its
         }
       };
 ${streamNavigations ? `      if (streamShell && response.body) {
-        const streamed = await readFarmNavigationStream(response.body);
+        const streamed = await readFarmNavigationStream(response.body, response.headers.get("F-Flush"));
         if (!streamed.next) {
           store(streamed.shell);
           return streamed.shell;
@@ -3456,7 +3449,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 = _chunkF42U3R4Fcjs.generateFarmClientPluginEntryCode.call(void 0, 
+  const clientPluginEntry = _chunkWZW6LEHMcjs.generateFarmClientPluginEntryCode.call(void 0, 
     plugins,
     root,
     srcDir,
@@ -3467,7 +3460,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(_chunkVQJYGZNXcjs.toPosixPath.call(void 0, appSetupPath))};
 __farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot } from ${JSON.stringify(renderer.client)};`;
-  const providerClientCode = _chunkF42U3R4Fcjs.generateFarmIntegrationProviderClientCode.call(void 0, 
+  const providerClientCode = _chunkWZW6LEHMcjs.generateFarmIntegrationProviderClientCode.call(void 0, 
     integrationProviders,
     root,
     _nullishCoalesce(renderer.componentExtensions, () => ( []))
@@ -3527,8 +3520,18 @@ function isFarmLocaleDocumentChange() {
   return false;
 }
 `;
-  const docsNavigationRuntime = docsEntryPath ? `
-const farmDocsEntryPath = ${JSON.stringify(docsEntryPath)};
+  const docsEntryPaths = typeof docsEntryPath === "string" ? [docsEntryPath] : _nullishCoalesce(docsEntryPath, () => ( []));
+  const docsNavigationRuntime = docsEntryPaths.length > 1 ? `
+const farmDocsEntryPaths = ${JSON.stringify(docsEntryPaths)};
+function isFarmDocsPath(pathname) {
+  const routePathname = getFarmRoutePathname(pathname);
+  const normalizedPath = routePathname.length > 1 ? routePathname.replace(/\\/+$/, "") : routePathname;
+  return farmDocsEntryPaths.some(
+    (entryPath) => normalizedPath === entryPath || normalizedPath.startsWith(entryPath + "/"),
+  );
+}
+` : docsEntryPaths[0] ? `
+const farmDocsEntryPath = ${JSON.stringify(docsEntryPaths[0])};
 function isFarmDocsPath(pathname) {
   const routePathname = getFarmRoutePathname(pathname);
   const normalizedPath = routePathname.length > 1 ? routePathname.replace(/\\/+$/, "") : routePathname;
@@ -4001,7 +4004,7 @@ function hasHydratableLayout(pathname) {
   });
 }
 
-${_chunkF42U3R4Fcjs.FARM_LAYOUT_ELEMENT_CLIENT_SOURCE}
+${_chunkWZW6LEHMcjs.FARM_LAYOUT_ELEMENT_CLIENT_SOURCE}
 // Wrap a page element with applicable layouts
 function wrapWithLayouts(pageElement, pathname, params) {
   const layouts = getApplicableLayouts(pathname);
@@ -4036,7 +4039,7 @@ function createLayoutPageBoundary(route, pageElement, serverHtml) {
   return React.createElement("div", props, pageElement);
 }
 let farmLastRouteState = null;
-${hasServerTreeLayouts && islandValues && isolatedHydrationEnabled ? `${_chunkF42U3R4Fcjs.FARM_SERVER_TREE_LAYOUT_CLIENT_SOURCE}
+${hasServerTreeLayouts && islandValues && isolatedHydrationEnabled ? `${_chunkWZW6LEHMcjs.FARM_SERVER_TREE_LAYOUT_CLIENT_SOURCE}
 function farmTreeLayoutsOf(pathname) {
   return getApplicableLayouts(pathname).filter(function(layout) {
     return layout.serverTree === true;
@@ -5262,7 +5265,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 = _chunkF42U3R4Fcjs.resolveFarmNotFoundComponentPath.call(void 0, config, appDirs);
+  const notFoundPath = _chunkWZW6LEHMcjs.resolveFarmNotFoundComponentPath.call(void 0, config, appDirs);
   if (notFoundPath) _chunkVQJYGZNXcjs.logger.info(`\u{1F4CB} Found custom 404 page: ${notFoundPath}`);
   layoutRoutes.sort((a, b) => {
     const depthA = a.pattern.split("/").filter(Boolean).length;
@@ -5279,13 +5282,13 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   const hasServerRuntimeIntegrations = configuredIntegrationValues.some(
     (integration) => typeof integration === "object" && integration !== null && (!("serverRuntime" in integration) || integration.serverRuntime !== false)
   );
-  const hasIntegrationProviders = _chunkWAPQWAE6cjs.getIntegrationProviders.call(void 0, config.integrations).some(
+  const hasIntegrationProviders = _chunkCECUDGXQcjs.getIntegrationProviders.call(void 0, config.integrations).some(
     (provider) => provider.component || provider.type === "clerk"
   );
   const hasObservabilityHandler = !!config.observability && typeof config.observability === "object" && "onEvent" in config.observability;
-  const hasMdxComponentConfig = Boolean(_optionalChain([config, 'access', _89 => _89.mdx, 'optionalAccess', _90 => _90.components]));
+  const hasMdxComponentConfig = Boolean(_optionalChain([config, 'access', _87 => _87.mdx, 'optionalAccess', _88 => _88.components]));
   const hasMiddlewareConfig = _chunk76GHW3WIcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
-  const hasRouteContextConfig = _chunkO3MMJPC2cjs.hasCustomFarmRouteContext.call(void 0, config);
+  const hasRouteContextConfig = _chunkNPQLMP7Mcjs.hasCustomFarmRouteContext.call(void 0, config);
   const hasServerRuntimePlugins = hasFarmServerRuntimePlugins(config);
   const hasPluginRoutes = hasFarmPluginRoutes(config);
   const hasServerCacheConfig = hasFarmServerCacheConfig(config.cache);
@@ -5295,18 +5298,18 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   const hasConfiguredRuntimePlugins = Boolean(
     hasRuntimeConfigModule && (config.plugins || []).length > 0
   );
-  if (_chunkVIFPE5RGcjs.hasFarmDocsRuntimeAdapter.call(void 0, config.docs)) {
+  if (_chunkGNJIYJMScjs.hasFarmDocsRuntimeAdapter.call(void 0, config.docs)) {
     const adapterGuardedPaths = new Set(getFarmDocsGuardedPaths(config, middlewareRoutes));
-    _chunkVIFPE5RGcjs.assertFarmDocsAdapterServesNoGuardedPages.call(void 0, 
+    _chunkGNJIYJMScjs.assertFarmDocsAdapterServesNoGuardedPages.call(void 0, 
       config.docs,
       { root, srcDir: config.srcDir },
       (pathname) => adapterGuardedPaths.has(pathname)
     );
   }
   const farmDocsCspNonceMarker = _chunk6JHZPB52cjs.createFarmCspNonce.call(void 0, config.security);
-  const farmDocsPrecompiledManifest = _optionalChain([config, 'access', _91 => _91.docs, 'optionalAccess', _92 => _92.enabled]) && _chunkE552H232cjs.getFarmPresetRuntime.call(void 0, preset) === "edge" ? await _chunkHNAISJFDcjs._runWithFarmCspNonce.call(void 0, 
+  const farmDocsPrecompiledManifest = _optionalChain([config, 'access', _89 => _89.docs, 'optionalAccess', _90 => _90.enabled]) && _chunkE552H232cjs.getFarmPresetRuntime.call(void 0, preset) === "edge" ? await _chunkHNAISJFDcjs._runWithFarmCspNonce.call(void 0, 
     farmDocsCspNonceMarker,
-    async () => _optionalChain([config, 'access', _93 => _93.docs, 'access', _94 => _94.adapter, 'optionalAccess', _95 => _95.server]) ? await _chunkVIFPE5RGcjs.compileFarmDocsAdapterEdgeManifest.call(void 0, config.docs, {
+    async () => _optionalChain([config, 'access', _91 => _91.docs, 'access', _92 => _92.adapter, 'optionalAccess', _93 => _93.server]) ? await _chunkGNJIYJMScjs.compileFarmDocsAdapterEdgeManifest.call(void 0, config.docs, {
       root,
       srcDir: config.srcDir,
       clientEntry: FARM_CLIENT_JS_SRC_PLACEHOLDER,
@@ -5415,7 +5418,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         // Adapters can render provider scripts by serializing function source.
         // keepNames injects helper calls into those functions; after Nitro
         // minifies the server chunk the helper is no longer in script scope.
-        keepNames: !(_optionalChain([config, 'access', _96 => _96.docs, 'optionalAccess', _97 => _97.enabled]) && _optionalChain([config, 'access', _98 => _98.docs, 'access', _99 => _99.adapter, 'optionalAccess', _100 => _100.server])),
+        keepNames: !(_optionalChain([config, 'access', _94 => _94.docs, 'optionalAccess', _95 => _95.enabled]) && _optionalChain([config, 'access', _96 => _96.docs, 'access', _97 => _97.adapter, 'optionalAccess', _98 => _98.server])),
         jsxDev: false
       },
       // SSR configuration to externalize problematic modules
@@ -5465,10 +5468,10 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       define: {
         __FARM_API_BASE_URL__: JSON.stringify(config.api.baseURL),
         __FARM_ENV__: JSON.stringify(_chunk3EIPOTZVcjs.createBundledEnv.call(void 0, config.env)),
-        __FARM_PUBLIC_ENV__: JSON.stringify(_optionalChain([config, 'access', _101 => _101.env, 'optionalAccess', _102 => _102.public]) || {})
+        __FARM_PUBLIC_ENV__: JSON.stringify(_optionalChain([config, 'access', _99 => _99.env, 'optionalAccess', _100 => _100.public]) || {})
       },
       plugins: [
-        _chunkF42U3R4Fcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
+        _chunkWZW6LEHMcjs.createFarmThemeCssPlugin.call(void 0, config.theme, config.basePath),
         ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
         ...rendererVitePlugins,
         ...config.vite.plugins || [],
@@ -5482,7 +5485,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         { ...createReactProductionModePlugin(), enforce: "pre" },
         farmServerOnlyEntriesPlugin(),
         farmPlugin({ ...config, isolatedClientBoundaryModules }, pluginManager),
-        _chunkJ37KTQIAcjs.farmEnvironmentFunctionsPlugin.call(void 0, config),
+        _chunkNK2VWS7Pcjs.farmEnvironmentFunctionsPlugin.call(void 0, config),
         ...hasRuntimeConfigModule ? [
           farmStripPlatformConfigPlugin(
             [
@@ -5529,7 +5532,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       resolve: {
         alias: [
           ...shouldAliasReactServerToWebBuild(config.renderer, preset) ? [createFarmReactWebServerAlias(hasReactDomEdgeServerBuild(root))] : [],
-          ...Object.entries(_chunkF42U3R4Fcjs.createFarmSourceAlias.call(void 0, root, config.srcDir)).map(
+          ...Object.entries(_chunkWZW6LEHMcjs.createFarmSourceAlias.call(void 0, root, config.srcDir)).map(
             ([find, replacement]) => ({ find, replacement })
           )
         ],
@@ -5537,7 +5540,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         dedupe: [...config.renderer.dedupe || []]
       }
     };
-    await viteBuild(_chunkF42U3R4Fcjs.mergeFarmProductionViteConfig.call(void 0, serverViteConfig, config.vite));
+    await viteBuild(_chunkWZW6LEHMcjs.mergeFarmProductionViteConfig.call(void 0, serverViteConfig, config.vite));
   } finally {
     if (postcssConfigDir) {
       try {
@@ -5573,33 +5576,56 @@ function readFarmPageLastModified(pageRoutes) {
   return lastModified;
 }
 function getFarmDocsGuardedPaths(config, middlewareRoutes) {
-  if (!_optionalChain([config, 'access', _103 => _103.docs, 'optionalAccess', _104 => _104.enabled])) return [];
-  const contentDir = _chunkIOUOGRDXcjs.resolveFarmDocsContentDir.call(void 0, config.docs, {
-    root: config.root,
-    srcDir: config.srcDir
-  });
+  if (!_optionalChain([config, 'access', _101 => _101.docs, 'optionalAccess', _102 => _102.enabled])) return [];
+  const options = { root: config.root, srcDir: config.srcDir };
   const guards = {
     config: { middleware: config.middleware, integrations: config.integrations },
     middlewareRoutes
   };
-  return _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, contentDir, config.docs).flatMap((page) => [page.href, _chunkIOUOGRDXcjs.getFarmDocsMarkdownPath.call(void 0, page.href)]).filter((pathname) => _chunk76GHW3WIcjs.farmPathGuardCoversPage.call(void 0, guards, pathname));
+  return _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, config.docs).flatMap(
+    (docsRoot) => _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, docsRoot, options), docsRoot)
+  ).flatMap((page) => [page.href, _chunk5N7QAGEAcjs.getFarmDocsMarkdownPath.call(void 0, page.href)]).filter((pathname) => _chunk76GHW3WIcjs.farmPathGuardCoversPage.call(void 0, guards, pathname));
 }
 function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
-  const llmsTxt = _optionalChain([agent, 'optionalAccess', _105 => _105.llmsTxt]);
+  const llmsTxt = _optionalChain([agent, 'optionalAccess', _103 => _103.llmsTxt]);
   const ownedByFile = (kind) => applicationMetadataRoutes.some(
     (metadata) => metadata.kind === kind && metadata.pattern === "/"
   );
   return [
-    ..._optionalChain([llmsTxt, 'optionalAccess', _106 => _106.enabled]) || ownedByFile("llms") ? ["/llms.txt"] : [],
-    ..._optionalChain([llmsTxt, 'optionalAccess', _107 => _107.enabled]) && llmsTxt.full || ownedByFile("llms-full") ? ["/llms-full.txt"] : [],
-    ..._optionalChain([agent, 'optionalAccess', _108 => _108.sitemap, 'optionalAccess', _109 => _109.enabled]) || ownedByFile("sitemap") ? ["/sitemap.xml"] : [],
-    ..._optionalChain([agent, 'optionalAccess', _110 => _110.crawlers, 'optionalAccess', _111 => _111.enabled]) || ownedByFile("robots") ? ["/robots.txt"] : []
+    ..._optionalChain([llmsTxt, 'optionalAccess', _104 => _104.enabled]) || ownedByFile("llms") ? ["/llms.txt"] : [],
+    ..._optionalChain([llmsTxt, 'optionalAccess', _105 => _105.enabled]) && llmsTxt.full || ownedByFile("llms-full") ? ["/llms-full.txt"] : [],
+    ..._optionalChain([agent, 'optionalAccess', _106 => _106.sitemap, 'optionalAccess', _107 => _107.enabled]) || ownedByFile("sitemap") ? ["/sitemap.xml"] : [],
+    ..._optionalChain([agent, 'optionalAccess', _108 => _108.crawlers, 'optionalAccess', _109 => _109.enabled]) || ownedByFile("robots") ? ["/robots.txt"] : []
   ];
 }
+function generateFarmDocsAdapterHandlerArguments(docs, docsConfigModulePath) {
+  const runtimeConfig = (root) => `{
+  ${docsConfigModulePath ? `...getFarmDocsConfigModuleRoot(farmDocsConfigModule.default || farmDocsConfigModule, ${root}.entry),
+  ...${root}.configOverrides,` : `...${root}.config,`}
+  entry: ${root}.config?.entry || String(${root}.entry || "/docs").replace(/^\\/+|\\/+$/g, "") || "docs",
+  docsPath: ${root}.entry,
+  contentDir: ${root}.contentDir || ${root}.config?.contentDir,
+}`;
+  if (_optionalChain([docs, 'optionalAccess', _110 => _110.roots, 'optionalAccess', _111 => _111.length])) {
+    return {
+      factory: "createFarmDocsAdapterMultiRuntimeHandler",
+      config: `[farmDocsResolvedConfig, ...farmDocsResolvedConfig.roots].map((farmDocsRoot) => (${runtimeConfig("farmDocsRoot")}))`
+    };
+  }
+  return {
+    factory: "createFarmDocsAdapterRuntimeHandler",
+    config: runtimeConfig("farmDocsResolvedConfig")
+  };
+}
 function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
   if (!docs.enabled) return "null";
-  const baseConfig = {
+  const serializableDocs = _optionalChain([docs, 'access', _112 => _112.roots, 'optionalAccess', _113 => _113.length]) ? {
     ...docs,
+    // React elements and functions do not survive JSON; see runtimeConfig below.
+    roots: docs.roots.map((docsRoot) => ({ ...docsRoot, runtimeConfig: void 0 }))
+  } : docs;
+  const baseConfig = {
+    ...serializableDocs,
     contentDir: void 0,
     ...precompiled ? { configPath: void 0 } : {},
     config: void 0,
@@ -5617,7 +5643,7 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
       config: nestedConfig
     });
   }
-  return `farmDocsBundledContentDir
+  const expression = `farmDocsBundledContentDir
   ? {
       ...${JSON.stringify(baseConfig)},
       contentDir: farmDocsBundledContentDir,
@@ -5626,13 +5652,25 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
         contentDir: farmDocsBundledContentDir,
       },
     }
-  : ${JSON.stringify({ ...docs, runtimeConfig: void 0 })}`;
+  : ${JSON.stringify({ ...serializableDocs, runtimeConfig: void 0 })}`;
+  if (!_optionalChain([docs, 'access', _114 => _114.roots, 'optionalAccess', _115 => _115.length])) return expression;
+  return `((farmDocs) => ({
+  ...farmDocs,
+  roots: farmDocs.roots.map((farmDocsRoot, index) => {
+    const contentDir = farmDocsBundledRootsDir
+      ? farmDocsJoin(farmDocsBundledRootsDir, String(index))
+      : null;
+    return contentDir && farmDocsExistsSync(contentDir)
+      ? { ...farmDocsRoot, contentDir, config: { ...farmDocsRoot.config, contentDir } }
+      : farmDocsRoot;
+  }),
+}))(${expression})`;
 }
 function toVirtualEntryImportSpecifier(modulePath) {
   return JSON.stringify(modulePath.replace(/\\/g, "/"));
 }
 function generateNativeAuthIntegrationSource(auth) {
-  if (_optionalChain([auth, 'optionalAccess', _112 => _112.enabled]) !== true) {
+  if (_optionalChain([auth, 'optionalAccess', _116 => _116.enabled]) !== true) {
     return { importSource: "", registerSource: "" };
   }
   return {
@@ -5925,23 +5963,29 @@ if (typeof ReactDOMServer.configureApp !== "function") {
 ReactDOMServer.configureApp(__farmAppSetup);`;
 }
 function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlots, errorRoutes, metadataImageRoutes, applicationMetadataRoutes, middlewareRoutes, redirectRoutes, configuredRewriteRoutes, configuredHeaderRoutes, openAPIReference, notFoundPath, instrumentationPath, config, farmDocsPrecompiledManifest, configModulePath, hasServerRuntimeIntegrations, hasRuntimeIntegrationConfig, hasConfiguredRuntimePlugins, hasServerRuntimePlugins, preset, i18nCatalogs, isolatedClientBoundaryModules, hydrationPlanCache) {
-  const farmIslandsMode = _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _113 => _113.experimental, 'optionalAccess', _114 => _114.serverComponents])) === "islands";
+  const farmIslandsMode = _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _117 => _117.experimental, 'optionalAccess', _118 => _118.serverComponents])) === "islands";
   const hasCompressionRuntime = config.compress && _chunkOCS3PSYRcjs.resolveFarmInstrumentationRuntime.call(void 0, preset) === "nodejs";
-  const servesAgentRobotsTxt = Boolean(_optionalChain([config, 'access', _115 => _115.agent, 'optionalAccess', _116 => _116.crawlers, 'optionalAccess', _117 => _117.enabled])) && !applicationMetadataRoutes.some(
+  const servesAgentRobotsTxt = Boolean(_optionalChain([config, 'access', _119 => _119.agent, 'optionalAccess', _120 => _120.crawlers, 'optionalAccess', _121 => _121.enabled])) && !applicationMetadataRoutes.some(
     (metadata) => metadata.kind === "robots" && metadata.pattern === "/"
   );
-  const servesAgentSitemap = Boolean(_optionalChain([config, 'access', _118 => _118.agent, 'optionalAccess', _119 => _119.sitemap, 'optionalAccess', _120 => _120.enabled])) && !applicationMetadataRoutes.some(
+  const servesAgentSitemap = Boolean(_optionalChain([config, 'access', _122 => _122.agent, 'optionalAccess', _123 => _123.sitemap, 'optionalAccess', _124 => _124.enabled])) && !applicationMetadataRoutes.some(
     (metadata) => metadata.kind === "sitemap" && metadata.pattern === "/"
   );
-  const servesDefaultMCP = _optionalChain([config, 'access', _121 => _121.agent, 'optionalAccess', _122 => _122.mcp]) === true && !_chunkSBABQKPTcjs.farmConfigMountsMCP.call(void 0, config) && !apiRoutes.some((route) => route.path === "/api/mcp");
-  const servesAiCatalog = _optionalChain([config, 'access', _123 => _123.agent, 'optionalAccess', _124 => _124.aiCatalog]) !== false;
+  const servesDefaultMCP = _optionalChain([config, 'access', _125 => _125.agent, 'optionalAccess', _126 => _126.mcp]) === true && !_chunkSBABQKPTcjs.farmConfigMountsMCP.call(void 0, config) && !apiRoutes.some((route) => route.path === "/api/mcp");
+  const servesAiCatalog = _optionalChain([config, 'access', _127 => _127.agent, 'optionalAccess', _128 => _128.aiCatalog]) !== false;
   const hasPluginRuntime = hasRuntimeIntegrationConfig || hasServerRuntimePlugins;
   const hasInfraAnalyticsRuntime = config.analytics !== false && _chunkOCS3PSYRcjs.resolveFarmInstrumentationRuntime.call(void 0, preset) === "nodejs";
   const hasPrecompiledDocs = Boolean(farmDocsPrecompiledManifest);
   const adapterOwnsDocsRuntime = Boolean(
-    _chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) && _optionalChain([config, 'access', _125 => _125.docs, 'optionalAccess', _126 => _126.enabled]) && _optionalChain([config, 'access', _127 => _127.docs, 'access', _128 => _128.adapter, 'optionalAccess', _129 => _129.server]) && config.docs.adapter.react
+    _chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) && _optionalChain([config, 'access', _129 => _129.docs, 'optionalAccess', _130 => _130.enabled]) && _optionalChain([config, 'access', _131 => _131.docs, 'access', _132 => _132.adapter, 'optionalAccess', _133 => _133.server]) && config.docs.adapter.react
   );
+  if (_optionalChain([config, 'access', _134 => _134.docs, 'optionalAccess', _135 => _135.enabled]) && _optionalChain([config, 'access', _136 => _136.docs, 'access', _137 => _137.roots, 'optionalAccess', _138 => _138.length]) && !adapterOwnsDocsRuntime) {
+    throw new Error(
+      "Several docs roots need the docs adapter, which serves the React renderer only; Farm's built-in docs renderer serves a single docs root."
+    );
+  }
   const docsConfigModulePath = adapterOwnsDocsRuntime && !hasPrecompiledDocs && config.docs.configPath && !config.docs.configPath.endsWith(".json") ? config.docs.configPath : void 0;
+  const adapterHandler = generateFarmDocsAdapterHandlerArguments(config.docs, docsConfigModulePath);
   const hasIsolatedClientGraphRuntime = _chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) && isolatedClientBoundaryModules.size > 0;
   const rendererStreamingCapabilities = _chunkRD623KW4cjs.getFarmRendererStreamingCapabilitiesForRuntime.call(void 0, 
     config.renderer,
@@ -5985,8 +6029,8 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
     (image) => image.sourceType === "module"
   );
   const hasMiddlewareRuntime = middlewareRoutes.length > 0 || _chunk76GHW3WIcjs.hasFarmMiddlewareConfig.call(void 0, config.middleware);
-  const farmDocsFontAssets = _optionalChain([config, 'access', _130 => _130.docs, 'optionalAccess', _131 => _131.enabled]) ? _chunkERMUL73Lcjs.toFarmDocsPublicFontAssets.call(void 0, _chunkERMUL73Lcjs.resolveFarmDocsFontAssets.call(void 0, config.root)) : [];
-  const integrationProviders = _chunkWAPQWAE6cjs.getIntegrationProviders.call(void 0, config.integrations);
+  const farmDocsFontAssets = _optionalChain([config, 'access', _139 => _139.docs, 'optionalAccess', _140 => _140.enabled]) ? _chunkERMUL73Lcjs.toFarmDocsPublicFontAssets.call(void 0, _chunkERMUL73Lcjs.resolveFarmDocsFontAssets.call(void 0, config.root)) : [];
+  const integrationProviders = _chunkCECUDGXQcjs.getIntegrationProviders.call(void 0, config.integrations);
   const renderedIntegrationProviders = integrationProviders.filter(
     (provider) => provider.component || provider.type === "clerk"
   );
@@ -5995,16 +6039,16 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       `Integration provider components are not supported by the "${config.renderer.name}" renderer.`
     );
   }
-  const providerServerModules = _chunkF42U3R4Fcjs.generateFarmIntegrationProviderServerModules.call(void 0, 
+  const providerServerModules = _chunkWZW6LEHMcjs.generateFarmIntegrationProviderServerModules.call(void 0, 
     renderedIntegrationProviders,
     config.root,
     _nullishCoalesce(config.renderer.componentExtensions, () => ( []))
   );
   const resolvedIntegrationProviderFallback = Object.fromEntries(
     Object.entries(config.integrations).flatMap(([name, integration]) => {
-      const configuredProviders = _optionalChain([integration, 'optionalAccess', _132 => _132.providers]);
+      const configuredProviders = _optionalChain([integration, 'optionalAccess', _141 => _141.providers]);
       const providers = Array.isArray(configuredProviders) ? configuredProviders : [];
-      if (providers.some((provider) => typeof _optionalChain([provider, 'optionalAccess', _133 => _133.component]) === "function")) {
+      if (providers.some((provider) => typeof _optionalChain([provider, 'optionalAccess', _142 => _142.component]) === "function")) {
         throw new Error(
           `Integration provider components in production must use an importable component reference, for example component: { module: "@/components/provider" }.`
         );
@@ -6015,20 +6059,20 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   const unsupportedIntegrationProvider = renderedIntegrationProviders.find(
     (provider) => provider.supportsIsolatedHydration !== true
   );
-  const isolatedHydrationMode = _chunkF42U3R4Fcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
-    _optionalChain([config, 'access', _134 => _134.experimental, 'optionalAccess', _135 => _135.isolatedClientHydration]),
+  const isolatedHydrationMode = _chunkWZW6LEHMcjs.resolveFarmIsolatedClientHydrationMode.call(void 0, 
+    _optionalChain([config, 'access', _143 => _143.experimental, 'optionalAccess', _144 => _144.isolatedClientHydration]),
     {
-      serverComponents: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _136 => _136.experimental, 'optionalAccess', _137 => _137.serverComponents])) === "rsc",
+      serverComponents: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _145 => _145.experimental, 'optionalAccess', _146 => _146.serverComponents])) === "rsc",
       hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
     }
   );
-  const hydrationPlanOptions = _chunkF42U3R4Fcjs.getFarmClientHydrationPlanOptions.call(void 0, 
+  const hydrationPlanOptions = _chunkWZW6LEHMcjs.getFarmClientHydrationPlanOptions.call(void 0, 
     config.renderer,
     Boolean(unsupportedIntegrationProvider)
   );
   const pageHydrationPlanOptions = {
     ...hydrationPlanOptions,
-    serverOwners: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _138 => _138.experimental, 'optionalAccess', _139 => _139.serverComponents])) === "islands"
+    serverOwners: _chunkBPNOYILCcjs.resolveFarmServerComponentsMode.call(void 0, _optionalChain([config, 'access', _147 => _147.experimental, 'optionalAccess', _148 => _148.serverComponents])) === "islands"
   };
   const layoutHydrationPlans = layoutRoutes.map((layout) => ({
     ...layout,
@@ -6040,7 +6084,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       { ...hydrationPlanOptions, serverTreeLayouts: pageHydrationPlanOptions.serverOwners }
     )
   }));
-  const markdownPagePlan = _chunkF42U3R4Fcjs.createMarkdownPageHydrationPlanner.call(void 0, 
+  const markdownPagePlan = _chunkWZW6LEHMcjs.createMarkdownPageHydrationPlanner.call(void 0, 
     _chunk2HW5LWAHcjs.resolveFarmMdxComponentsModulePath.call(void 0, _chunk2HW5LWAHcjs.resolveMdxConfig.call(void 0, config.mdx), config.root),
     config.root,
     isolatedHydrationMode,
@@ -6058,7 +6102,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       )
     ])
   );
-  _chunkF42U3R4Fcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
+  _chunkWZW6LEHMcjs.enforceFarmIsolatedHydrationRouteBudget.call(void 0, 
     layoutHydrationPlans.map((layout) => ({
       pattern: layout.pattern,
       depth: layout.pattern.split("/").filter(Boolean).length,
@@ -6087,7 +6131,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
     apiRegistrations.push(`
   {
     path: ${JSON.stringify(route.path)},
-    methods: ${JSON.stringify(route.methods.filter((method) => !_optionalChain([route, 'access', _140 => _140.pluginMethods, 'optionalAccess', _141 => _141.includes, 'call', _142 => _142(method)])))},
+    methods: ${JSON.stringify(route.methods.filter((method) => !_optionalChain([route, 'access', _149 => _149.pluginMethods, 'optionalAccess', _150 => _150.includes, 'call', _151 => _151(method)])))},
     endpoints: ${varName},
   }`);
   });
@@ -6124,7 +6168,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
       `import * as ${varName} from ${toVirtualEntryImportSpecifier(route.modulePath)};`
     );
     const clientMetadata = pageHydrationPlans.get(route.modulePath);
-    const renderingDirective = _chunkY7TLL65Bcjs.readRouteRenderingDirectiveFromFile.call(void 0, route.modulePath);
+    const renderingDirective = _chunkUQHIWZZ6cjs.readRouteRenderingDirectiveFromFile.call(void 0, route.modulePath);
     pageRegistrations.push(`
   {
     pattern: ${JSON.stringify(route.pattern)},${route.directory ? `
@@ -6132,7 +6176,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
     module: ${varName},
     shouldHydrate: ${JSON.stringify(clientMetadata.shouldHydrate)},${clientMetadata.shouldHydrate ? `
     clientModule: ${JSON.stringify(_chunkVQJYGZNXcjs.toViteModuleId.call(void 0, route.modulePath, config.root))},` : ""}
-    islandStrategy: ${JSON.stringify(clientMetadata.islandStrategy)},${_chunkF42U3R4Fcjs.usesFarmServerTree.call(void 0, clientMetadata) ? "\n    serverTree: true," : ""}${renderingDirective ? `
+    islandStrategy: ${JSON.stringify(clientMetadata.islandStrategy)},${_chunkWZW6LEHMcjs.usesFarmServerTree.call(void 0, clientMetadata) ? "\n    serverTree: true," : ""}${renderingDirective ? `
     rendering: ${JSON.stringify(renderingDirective)},` : ""}
     ${route.source !== void 0 ? `markdownSource: {
       source: ${JSON.stringify(route.source)},
@@ -6338,6 +6382,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   resolveFarmInstrumentationRuntime,
   resolveFarmPreviewDeployment,
   resolveFarmWebRequestOrigin,
+  fetchFarmExternalRewrite,
   runWithFarmRequestSpan,
   createFarmSearchParams,
   searchParamsToObject,
@@ -6362,25 +6407,25 @@ ${FARM_SEGMENT_NAVIGATION_SERVER_RUNTIME}` : ""}`;
   const infraAnalyticsImport = hasInfraAnalyticsRuntime ? `import { ${hasPluginRuntime ? "createFarmInfraAnalyticsPlugin" : "createFarmInfraAnalyticsRecorder"} } from "@farm.js/core/internal/infra-analytics-runtime";` : "";
   const compressionRuntimeImport = hasCompressionRuntime ? `import { compressFarmResponse${hasPluginRuntime ? ", createCompressionPlugin" : ""} } from "@farm.js/core/internal/compression-runtime";` : "";
   const i18nServerImport = config.i18n.enabled ? `import { _runWithFarmI18nRequest, _setDefaultFarmI18nRuntime, createFarmI18nRuntime, getFarmI18nClientSnapshot } from "@farm.js/core/i18n/server";` : "";
-  const docsHandlerImport = _optionalChain([config, 'access', _143 => _143.docs, 'optionalAccess', _144 => _144.enabled]) ? hasPrecompiledDocs ? `import { createFarmDocsPrecompiledRuntime } from "@farm.js/core/internal/docs-precompiled-runtime";
+  const docsHandlerImport = _optionalChain([config, 'access', _152 => _152.docs, 'optionalAccess', _153 => _153.enabled]) ? hasPrecompiledDocs ? `import { createFarmDocsPrecompiledRuntime } from "@farm.js/core/internal/docs-precompiled-runtime";
 const isFarmDocsAPIRequest = (requestOrPathname) => {
   const pathname = typeof requestOrPathname === "string"
     ? requestOrPathname
     : new URL(requestOrPathname.url).pathname;
-  const apiPath = ${JSON.stringify(_optionalChain([farmDocsPrecompiledManifest, 'optionalAccess', _145 => _145.apiPath]) || "/api/docs")};
+  const apiPath = ${JSON.stringify(_optionalChain([farmDocsPrecompiledManifest, 'optionalAccess', _154 => _154.apiPath]) || "/api/docs")};
   return pathname === apiPath || pathname.startsWith(apiPath + "/");
-};` : adapterOwnsDocsRuntime ? `import { isFarmDocsAPIRequest } from "@farm.js/core/docs";
-import { createFarmDocsRuntimeHandler as createFarmDocsAdapterRuntimeHandler } from ${JSON.stringify(config.docs.adapter.server)};
+};` : adapterOwnsDocsRuntime ? `import { ${docsConfigModulePath ? "getFarmDocsConfigModuleRoot, " : ""}isFarmDocsAPIRequest } from "@farm.js/core/docs";
+import { ${_optionalChain([config, 'access', _155 => _155.docs, 'access', _156 => _156.roots, 'optionalAccess', _157 => _157.length]) ? "createFarmDocsMultiRuntimeHandler as createFarmDocsAdapterMultiRuntimeHandler" : "createFarmDocsRuntimeHandler as createFarmDocsAdapterRuntimeHandler"} } from ${JSON.stringify(config.docs.adapter.server)};
 import * as FarmDocsAdapterReact from ${JSON.stringify(config.docs.adapter.react)};${docsConfigModulePath ? `
 import * as farmDocsConfigModule from ${toVirtualEntryImportSpecifier(docsConfigModulePath)};` : ""}` : `import { createFarmDocsAPIHandler, createFarmDocsHandler, isFarmDocsAPIRequest } from "@farm.js/core/docs";` : "";
-  const docsFontImport = _optionalChain([config, 'access', _146 => _146.docs, 'optionalAccess', _147 => _147.enabled]) && !hasPrecompiledDocs ? `import { resolveFarmLayoutFonts } from "@farm.js/core/font";` : "";
-  const docsRuntimeImport = _optionalChain([config, 'access', _148 => _148.docs, 'optionalAccess', _149 => _149.enabled]) && !hasPrecompiledDocs ? `import { existsSync as farmDocsExistsSync } from "node:fs";
+  const docsFontImport = _optionalChain([config, 'access', _158 => _158.docs, 'optionalAccess', _159 => _159.enabled]) && !hasPrecompiledDocs ? `import { resolveFarmLayoutFonts } from "@farm.js/core/font";` : "";
+  const docsRuntimeImport = _optionalChain([config, 'access', _160 => _160.docs, 'optionalAccess', _161 => _161.enabled]) && !hasPrecompiledDocs ? `import { existsSync as farmDocsExistsSync } from "node:fs";
 import { dirname as farmDocsDirname, join as farmDocsJoin } from "node:path";
 import { fileURLToPath as farmDocsFileURLToPath } from "node:url";` : "";
-  const markdownHandlerImport = _optionalChain([config, 'access', _150 => _150.md, 'optionalAccess', _151 => _151.enabled]) ? `import { applyMarkdownNegotiationHeaders, createMarkdownMirrorResponse, getFarmMarkdownAlternatePath } from "@farm.js/core/markdown";` : "";
+  const markdownHandlerImport = _optionalChain([config, 'access', _162 => _162.md, 'optionalAccess', _163 => _163.enabled]) ? `import { applyMarkdownNegotiationHeaders, createMarkdownMirrorResponse, getFarmMarkdownAlternatePath } from "@farm.js/core/markdown";` : "";
   const appMarkdownImport = hasMarkdownPages ? `import { FARM_MARKDOWN_ANONYMOUS_CLIENT_ADDRESS, createFarmMarkdownRouteModule, createFarmMarkdownSourceResponse, isFarmMarkdownPublicSourceResponse } from "@farm.js/core/internal/app-markdown-runtime";` : "const createFarmMarkdownSourceResponse = null;\nconst isFarmMarkdownPublicSourceResponse = null;";
   const markdownErrorImport = `import { FARM_MARKDOWN_CONTENT_TYPE, FARM_MARKDOWN_PAGE_CHECK_HEADER, _isFarmMarkdownPageCheck, createFarmMarkdownErrorBody, farmRequestWantsMarkdown } from "@farm.js/core/markdown";`;
-  const mdxComponentsPath = typeof _optionalChain([config, 'access', _152 => _152.mdx, 'optionalAccess', _153 => _153.components]) === "string" ? _path2.default.isAbsolute(config.mdx.components) ? config.mdx.components : _path2.default.join(config.root, config.mdx.components) : null;
+  const mdxComponentsPath = typeof _optionalChain([config, 'access', _164 => _164.mdx, 'optionalAccess', _165 => _165.components]) === "string" ? _path2.default.isAbsolute(config.mdx.components) ? config.mdx.components : _path2.default.join(config.root, config.mdx.components) : null;
   const mdxComponentsImport = mdxComponentsPath ? `import * as FarmMdxComponentsModule from ${toVirtualEntryImportSpecifier(mdxComponentsPath)};` : "";
   const layerConfigPaths = (config.layers || []).map((layer) => layer.configFile).filter((configFile) => Boolean(configFile)).filter((configFile) => configFile !== configModulePath);
   const layerConfigImports = layerConfigPaths.map(
@@ -6399,14 +6444,18 @@ import { fileURLToPath as farmDocsFileURLToPath } from "node:url";` : "";
   const instrumentationImport = instrumentationPath ? `import * as FarmInstrumentationModule from ${toVirtualEntryImportSpecifier(instrumentationPath)};` : "";
   const nativeAuth = generateNativeAuthIntegrationSource(config.auth);
   const nativeMCP = _chunkVM57CK74cjs.generateNativeMCPPluginSource.call(void 0, config.mcp);
+  const mobileSession = (config.plugins || []).some(
+    (plugin) => _optionalChain([plugin, 'optionalAccess', _166 => _166.name]) === _chunk7FVVQEVLcjs.FARM_MOBILE_SESSION_PLUGIN
+  );
   const integrationImports = `
 ${configModulePath ? `import * as FarmUserConfigModule from ${toVirtualEntryImportSpecifier(configModulePath)};` : ""}
 ${layerConfigImports}
 ${integrationRuntimeImport}
 ${nativeAuth.importSource}
 ${nativeMCP.importSource}
+${mobileSession ? `import { createFarmMobileSessionPlugin as __farmCreateMobileSessionPlugin } from "@farm.js/core/internal/production-runtime";` : ""}
 `;
-  const imageRuntime = _chunkF42U3R4Fcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
+  const imageRuntime = _chunkWZW6LEHMcjs.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 ? `
@@ -6585,7 +6634,7 @@ const farmResolvedRuntimeConfig = Object.assign({}, ...farmRuntimeConfigs);
 
 function FarmDefault404Page() {
   return React.createElement(React.Fragment, null,
-    React.createElement("style", null, ${JSON.stringify(_chunkF42U3R4Fcjs.DEFAULT_NOT_FOUND_STYLES)}),
+    React.createElement("style", null, ${JSON.stringify(_chunkWZW6LEHMcjs.DEFAULT_NOT_FOUND_STYLES)}),
     React.createElement("main", {
       className: "farm-default-not-found",
       "aria-labelledby": "farm-default-not-found-title",
@@ -6685,6 +6734,10 @@ const configuredPlugins = [
   ${hasCompressionRuntime && hasPluginRuntime ? "createCompressionPlugin()," : ""}
   ${hasRuntimeIntegrationConfig ? "...resolveIntegrationPlugins(serverRuntimeIntegrations)," : ""}
   ${nativeMCP.pluginSource}
+  ${mobileSession ? `__farmCreateMobileSessionPlugin({
+    basePath: ${JSON.stringify(config.basePath)},
+    integrations: () => serverRuntimeIntegrations,
+  }),` : ""}
   ${hasConfiguredRuntimePlugins ? `...farmRuntimeConfigs.flatMap((runtimeConfig) =>
     Array.isArray(runtimeConfig.plugins) ? runtimeConfig.plugins : [],
   ),` : ""}
@@ -6718,14 +6771,14 @@ const farmImageHandler = ${imageRuntime === "none" ? "null" : imageRuntime === "
   onError(error) { console.error("[Farm Image]", error); },
 })`};
 const farmMarkdownConfig = ${JSON.stringify(config.md)};
-const farmLlmsTxtConfig = ${JSON.stringify(_nullishCoalesce(_optionalChain([config, 'access', _154 => _154.agent, 'optionalAccess', _155 => _155.llmsTxt]), () => ( { enabled: false, include: [], exclude: [] })))};
-${_optionalChain([config, 'access', _156 => _156.agent, 'optionalAccess', _157 => _157.llmsTxt, 'optionalAccess', _158 => _158.enabled]) ? "const farmLlmsFullRenderer = createFarmLlmsFullRenderer({ revalidate: farmLlmsTxtConfig.revalidate });\n" : ""}${servesAgentRobotsTxt ? `const farmAgentCrawlers = ${JSON.stringify(config.agent.crawlers)};` : ""}
+const farmLlmsTxtConfig = ${JSON.stringify(_nullishCoalesce(_optionalChain([config, 'access', _167 => _167.agent, 'optionalAccess', _168 => _168.llmsTxt]), () => ( { enabled: false, include: [], exclude: [] })))};
+${_optionalChain([config, 'access', _169 => _169.agent, 'optionalAccess', _170 => _170.llmsTxt, 'optionalAccess', _171 => _171.enabled]) ? "const farmLlmsFullRenderer = createFarmLlmsFullRenderer({ revalidate: farmLlmsTxtConfig.revalidate });\n" : ""}${servesAgentRobotsTxt ? `const farmAgentCrawlers = ${JSON.stringify(config.agent.crawlers)};` : ""}
 const farmMdxConfig = ${JSON.stringify({
     ...config.mdx,
-    components: typeof _optionalChain([config, 'access', _159 => _159.mdx, 'optionalAccess', _160 => _160.components]) === "string" ? config.mdx.components : void 0
+    components: typeof _optionalChain([config, 'access', _172 => _172.mdx, 'optionalAccess', _173 => _173.components]) === "string" ? config.mdx.components : void 0
   })};
 const configuredFarmMdxComponents = farmUserConfig?.mdx?.components;
-${_optionalChain([config, 'access', _161 => _161.agent, 'optionalAccess', _162 => _162.noindexPreviews]) ? `// agent.noindexPreviews: the runtime environment decides, falling back to the
+${_optionalChain([config, 'access', _174 => _174.agent, 'optionalAccess', _175 => _175.noindexPreviews]) ? `// agent.noindexPreviews: the runtime environment decides, falling back to the
 // environment this was built in, since Netlify exposes its deploy context only
 // to the build.
 const farmNoindexPreview = resolveFarmPreviewDeployment(
@@ -6776,7 +6829,7 @@ export const farmProductionLifecycle = createFarmProductionLifecycle({
 });
 const farmI18nRuntime = ${config.i18n.enabled ? `createFarmI18nRuntime(farmI18nConfig, ${JSON.stringify(i18nCatalogs)})` : "null"};
 ${config.i18n.enabled ? "_setDefaultFarmI18nRuntime(farmI18nRuntime);" : ""}
-const farmDocsBundledContentDir = ${_optionalChain([config, 'access', _163 => _163.docs, 'optionalAccess', _164 => _164.enabled]) && !hasPrecompiledDocs ? `(() => {
+const farmDocsBundledContentDir = ${_optionalChain([config, 'access', _176 => _176.docs, 'optionalAccess', _177 => _177.enabled]) && !hasPrecompiledDocs ? `(() => {
   try {
     const currentDir = farmDocsDirname(farmDocsFileURLToPath(import.meta.url));
     const candidates = [
@@ -6788,7 +6841,20 @@ const farmDocsBundledContentDir = ${_optionalChain([config, 'access', _163 => _1
   } catch {
     return null;
   }
-})()` : "null"};
+})()` : "null"};${_optionalChain([config, 'access', _178 => _178.docs, 'optionalAccess', _179 => _179.enabled]) && !hasPrecompiledDocs && _optionalChain([config, 'access', _180 => _180.docs, 'access', _181 => _181.roots, 'optionalAccess', _182 => _182.length]) ? `
+const farmDocsBundledRootsDir = (() => {
+  try {
+    const currentDir = farmDocsDirname(farmDocsFileURLToPath(import.meta.url));
+    const candidates = [
+      farmDocsJoin(currentDir, "farm-docs-roots"),
+      farmDocsJoin(currentDir, "..", "farm-docs-roots"),
+      farmDocsJoin(currentDir, "..", "..", "farm-docs-roots"),
+    ];
+    return candidates.find((candidate) => farmDocsExistsSync(candidate)) || null;
+  } catch {
+    return null;
+  }
+})();` : ""}
 const farmDocsResolvedConfig = ${generateFarmDocsRuntimeConfigExpression(config.docs, hasPrecompiledDocs)};
 const farmDocsRuntimeRoot = ${hasPrecompiledDocs ? '"."' : `farmDocsBundledContentDir || ${JSON.stringify(config.root)}`};
 // Docs pages a path-specific guard covers, decided at build time. The docs API and the
@@ -6826,12 +6892,7 @@ const farmDocsModulePreloadPaths = farmDocsModulePreloads
       ),
     }
   : undefined;
-const farmDocsHandler = ${_optionalChain([config, 'access', _165 => _165.docs, 'optionalAccess', _166 => _166.enabled]) ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleDocsRequest" : adapterOwnsDocsRuntime ? `createFarmDocsAdapterRuntimeHandler({
-  ${docsConfigModulePath ? "...(farmDocsConfigModule.default || farmDocsConfigModule),\n  ...farmDocsResolvedConfig.configOverrides," : "...farmDocsResolvedConfig.config,"}
-  entry: farmDocsResolvedConfig.config?.entry || String(farmDocsResolvedConfig.entry || "/docs").replace(/^\\/+|\\/+$/g, "") || "docs",
-  docsPath: farmDocsResolvedConfig.entry,
-  contentDir: farmDocsResolvedConfig.contentDir || farmDocsResolvedConfig.config?.contentDir,
-}, {
+const farmDocsHandler = ${_optionalChain([config, 'access', _183 => _183.docs, 'optionalAccess', _184 => _184.enabled]) ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleDocsRequest" : adapterOwnsDocsRuntime ? `${adapterHandler.factory}(${adapterHandler.config}, {
   rootDir: farmDocsRuntimeRoot,
   // A production build's content cannot change, so the adapter reads its
   // navigation once instead of scanning the content directory per request.
@@ -6864,7 +6925,7 @@ const farmDocsHandler = ${_optionalChain([config, 'access', _165 => _165.docs, '
   globalStylesheetHref: ${JSON.stringify(FARM_CLIENT_CSS_HREF_PLACEHOLDER)},
   isPathGuarded: isFarmDocsPathGuarded,
 })` : "null"};
-const farmDocsAPIHandler = ${_optionalChain([config, 'access', _167 => _167.docs, 'optionalAccess', _168 => _168.enabled]) ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleAPIRequest" : adapterOwnsDocsRuntime ? "null" : `createFarmDocsAPIHandler({ rootDir: farmDocsRuntimeRoot, srcDir: ${JSON.stringify(config.srcDir)}, docs: farmDocsResolvedConfig, isPathGuarded: isFarmDocsPathGuarded })` : "null"};
+const farmDocsAPIHandler = ${_optionalChain([config, 'access', _185 => _185.docs, 'optionalAccess', _186 => _186.enabled]) ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleAPIRequest" : adapterOwnsDocsRuntime ? "null" : `createFarmDocsAPIHandler({ rootDir: farmDocsRuntimeRoot, srcDir: ${JSON.stringify(config.srcDir)}, docs: farmDocsResolvedConfig, isPathGuarded: isFarmDocsPathGuarded })` : "null"};
 
 // API routes bundled at build time
 const apiRoutes = ${apiRoutes.length > 0 ? "mergePluginAPIRoutes(" : ""}[${apiRegistrations.join(",")}
@@ -6889,12 +6950,12 @@ function fetchFarmInnerRequest(request, context) {
 }
 const farmLocalAPIBasePath = ${JSON.stringify(_chunkB5BBTPJQcjs.resolveFarmAPIServerBasePath.call(void 0, config.api))};
 const farmOpenAPIReference = ${JSON.stringify(openAPIReference)};
-${_optionalChain([config, 'access', _169 => _169.agent, 'optionalAccess', _170 => _170.apiCatalog]) ? `const farmApiCatalogInput = ${JSON.stringify(_chunkJ22JD5YJcjs.resolveFarmApiCatalogInput.call(void 0, config))};
-` : ""}${_optionalChain([config, 'access', _171 => _171.agent, 'optionalAccess', _172 => _172.manifest]) !== false ? `const farmAppManifestInput = ${JSON.stringify(
-    _chunkJ22JD5YJcjs.resolveFarmAppManifestInput.call(void 0, config, {
+${_optionalChain([config, 'access', _187 => _187.agent, 'optionalAccess', _188 => _188.apiCatalog]) ? `const farmApiCatalogInput = ${JSON.stringify(_chunkJ3LBO2O4cjs.resolveFarmApiCatalogInput.call(void 0, config))};
+` : ""}${_optionalChain([config, 'access', _189 => _189.agent, 'optionalAccess', _190 => _190.manifest]) !== false ? `const farmAppManifestInput = ${JSON.stringify(
+    _chunkJ3LBO2O4cjs.resolveFarmAppManifestInput.call(void 0, config, {
       build: config.deploymentId,
-      packages: _chunkF42U3R4Fcjs.resolveFarmAppPackages.call(void 0, config.root),
-      webmcpTools: config.plugins.some(({ name }) => name === "farm:webmcp") ? _chunkF42U3R4Fcjs.collectFarmWebMCPTools.call(void 0, config.root, config.srcDir) : []
+      packages: _chunkWZW6LEHMcjs.resolveFarmAppPackages.call(void 0, config.root),
+      webmcpTools: config.plugins.some(({ name }) => name === "farm:webmcp") ? _chunkWZW6LEHMcjs.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.
@@ -7036,10 +7097,22 @@ function escapeFarmHtmlAttribute(value) {
     .replace(/>/g, "&gt;");
 }
 
-async function renderFarmElement(ReactDOMServer, element, routeKey, flushMarkers = false) {
-  // Written after each React flush in a streamed navigation (flushMarkers): the browser swaps in
+// A streamed navigation's flush marker token: 128 random bits, hex.
+function createFarmFlushToken() {
+  const bytes = new Uint8Array(16);
+  globalThis.crypto.getRandomValues(bytes);
+  let token = "";
+  for (const byte of bytes) token += byte.toString(16).padStart(2, "0");
+  return token;
+}
+
+async function renderFarmElement(ReactDOMServer, element, routeKey, flushToken = "") {
+  // Written after each React flush in a streamed navigation (flushToken): 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-->";
+  // The token is random per response and reaches the browser in the F-Flush header, so page
+  // content cannot forge a boundary.
+  const flushMarkers = Boolean(flushToken);
+  const FARM_FLUSH_MARKER = flushMarkers ? "<!--farm-flush:" + flushToken + "-->" : "";
   // 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);
@@ -8060,7 +8133,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), _chunkX5BCMLGPcjs.FARM_VERSION)
+    _chunkSBABQKPTcjs.createFarmDefaultMCPServer.call(void 0, readFarmAppPackageIdentity(config.root), _chunkGUJTVM36cjs.FARM_VERSION)
   )};
 let farmDefaultMCPRouteFree;
 function getFarmDefaultMCPServer() {
@@ -8360,7 +8433,7 @@ function hasLocalRequestRoute(request, routePathname) {
   if (${imageRuntime === "none" ? "false" : `pathname === ${JSON.stringify(config.images.path)}`}) {
     return true;
   }
-  ${_optionalChain([config, 'access', _173 => _173.docs, 'optionalAccess', _174 => _174.enabled]) ? `const docsPath = normalizeRuntimePath(farmDocsResolvedConfig?.entry || "/docs");
+  ${_optionalChain([config, 'access', _191 => _191.docs, 'optionalAccess', _192 => _192.enabled]) ? `const docsPath = normalizeRuntimePath(farmDocsResolvedConfig?.entry || "/docs");
   if (
     isFarmDocsAPIRequest(pathname) ||
     docsPath === "/" ||
@@ -8386,7 +8459,7 @@ function getFarmPluginRequestOptions(request) {
       route: { ...route, pattern: normalizeRuntimePath(farmOpenAPIReference.route) },
     };
   }
-  const isDocsAPIRequest = ${_optionalChain([config, 'access', _175 => _175.docs, 'optionalAccess', _176 => _176.enabled]) ? "isFarmDocsAPIRequest(pathname)" : "false"};
+  const isDocsAPIRequest = ${_optionalChain([config, 'access', _193 => _193.docs, 'optionalAccess', _194 => _194.enabled]) ? "isFarmDocsAPIRequest(pathname)" : "false"};
   const integrationMatch = ${hasServerRuntimeIntegrations ? `matchIntegrationRoute(serverRuntimeIntegrations, {
     pathname,
     method: request.method,
@@ -8470,7 +8543,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(
-    _chunkJ22JD5YJcjs.listFarmBuiltInRoutePaths.call(void 0, {
+    _chunkJ3LBO2O4cjs.listFarmBuiltInRoutePaths.call(void 0, {
       agent: {
         ...config.agent,
         aiCatalog: servesAiCatalog,
@@ -8481,9 +8554,9 @@ const farmBuiltInRoutePaths = new Set(${JSON.stringify(
       openapi: openAPIReference
     })
   )});
-${_optionalChain([config, 'access', _177 => _177.docs, 'optionalAccess', _178 => _178.enabled]) ? `const farmDocsRouteLabelInput = {
+${_optionalChain([config, 'access', _195 => _195.docs, 'optionalAccess', _196 => _196.enabled]) ? `const farmDocsRouteLabelInput = {
   path: normalizeRuntimePath(farmDocsResolvedConfig?.entry || "/docs"),
-  apiPath: ${JSON.stringify(_optionalChain([farmDocsPrecompiledManifest, 'optionalAccess', _179 => _179.apiPath]) || "/api/docs")},
+  apiPath: ${JSON.stringify(_optionalChain([farmDocsPrecompiledManifest, 'optionalAccess', _197 => _197.apiPath]) || "/api/docs")},${_optionalChain([config, 'access', _198 => _198.docs, 'access', _199 => _199.roots, 'optionalAccess', _200 => _200.length]) ? "\n  roots: farmDocsResolvedConfig.roots.map((farmDocsRoot) => farmDocsRoot.entry)," : ""}
 };
 ` : ""}// The request's route payload, for a handler that learns what answered while it handles.
 const farmRouteLabelSlot = Symbol("farm.route.label.slot");
@@ -8498,11 +8571,11 @@ function labelFarmRequestOptions(options) {
     setFarmRouteLabel(options.route, mcpLabel);
     return options;
   }
-  ${_optionalChain([config, 'access', _180 => _180.docs, 'optionalAccess', _181 => _181.enabled]) ? `if (options.kind === "docs") {
+  ${_optionalChain([config, 'access', _201 => _201.docs, 'optionalAccess', _202 => _202.enabled]) ? `if (options.kind === "docs") {
     setFarmRouteLabel(options.route, resolveFarmDocsRouteLabel(routePathname, farmDocsRouteLabelInput));
     return options;
   }` : ""}
-  ${_optionalChain([config, 'access', _182 => _182.md, 'optionalAccess', _183 => _183.enabled]) || hasMarkdownPages ? `const markdownLabel = resolveFarmMarkdownRouteLabel(
+  ${_optionalChain([config, 'access', _203 => _203.md, 'optionalAccess', _204 => _204.enabled]) || hasMarkdownPages ? `const markdownLabel = resolveFarmMarkdownRouteLabel(
     routePathname,
     (page) => matchPageRoute(page)?.route.pattern,
   );
@@ -8537,7 +8610,7 @@ function getApplicableLayouts(pathname, directory) {
   return applicable;
 }
 
-${_optionalChain([config, 'access', _184 => _184.docs, 'optionalAccess', _185 => _185.enabled]) ? `async function wrapFarmDocsResponseWithLayouts(request, response) {
+${_optionalChain([config, 'access', _205 => _205.docs, 'optionalAccess', _206 => _206.enabled]) ? `async function wrapFarmDocsResponseWithLayouts(request, response) {
   if (request.method === "HEAD") return response;
   if (response.headers.get("x-farm-docs-adapter")) return response;
 
@@ -8645,7 +8718,7 @@ ${_optionalChain([config, 'access', _184 => _184.docs, 'optionalAccess', _185 =>
 
 // Shells keep their own LRU so query-string variants never evict app cache entries.
 const pprShellCache = getFarmDataCache().pprShellCache;
-const experimentalPPREnabled = ${JSON.stringify(_optionalChain([config, 'access', _186 => _186.experimental, 'optionalAccess', _187 => _187.ppr]) === true)};
+const experimentalPPREnabled = ${JSON.stringify(_optionalChain([config, 'access', _207 => _207.experimental, 'optionalAccess', _208 => _208.ppr]) === true)};
 
 function resolveRouteRenderingView(route) {
   // The same merge development uses: baked directive config under the
@@ -8777,7 +8850,7 @@ async function handleFarmRequest(request, adapterContext) {
     },
     { redirect: !isFarmLocalAPIPathname(requestUrl.pathname) }
   )` : "handleFarmRequestInContext(request, null, false, Date.now(), adapterContext, requestUrl)"};
-  ${_optionalChain([config, 'access', _188 => _188.md, 'optionalAccess', _189 => _189.enabled]) ? `const pathname = getFarmRoutePathname(requestUrl.pathname);
+  ${_optionalChain([config, 'access', _209 => _209.md, 'optionalAccess', _210 => _210.enabled]) ? `const pathname = getFarmRoutePathname(requestUrl.pathname);
   if (matchPageRoute(pathname)) {
     // The Link header advertises the public .md URL, like the head alternate.
     return applyMarkdownNegotiationHeaders(response, {
@@ -8858,7 +8931,7 @@ async function resolveFarmRequestInContext(
       if (rewriteDestination) {
         let rewrittenRequest = createRewrittenRequest(request, rewriteDestination);
         if (new URL(rewrittenRequest.url).origin !== url.origin) {
-          return globalThis.fetch(rewrittenRequest);
+          return fetchFarmExternalRewrite(rewrittenRequest);
         }
         if (farmPluginRuntime) {
           // Plugin guards ran on the requested URL. Re-run only runtime.before
@@ -8987,7 +9060,7 @@ ${hasServerRuntimeIntegrations ? `
   }
   ` : ""}
 
-  ${_optionalChain([config, 'access', _190 => _190.docs, 'optionalAccess', _191 => _191.enabled]) ? `
+  ${_optionalChain([config, 'access', _211 => _211.docs, 'optionalAccess', _212 => _212.enabled]) ? `
   // Docs responses are served after app middleware so route guards and
   // middleware headers apply to the docs engine like any other page content.
   // An app's own llms.txt, llms-full.txt, sitemap.xml, and robots.txt take
@@ -9055,7 +9128,7 @@ ${hasServerRuntimeIntegrations ? `
   }
   ` : ""}
 
-  ${_optionalChain([config, 'access', _192 => _192.md, 'optionalAccess', _193 => _193.enabled]) ? `
+  ${_optionalChain([config, 'access', _213 => _213.md, 'optionalAccess', _214 => _214.enabled]) ? `
   if (farmMarkdownConfig?.enabled) {
     const markdownResponse = await createMarkdownMirrorResponse({
       // The mirror helper only reads metadata and creates its own GET request.
@@ -9154,11 +9227,11 @@ ${hasServerRuntimeIntegrations ? `
     return applyProductionMiddlewareHeaders(applicationMetadataResponse, middlewareHeaders);
   }
   ` : ""}
-  ${_optionalChain([config, 'access', _194 => _194.agent, 'optionalAccess', _195 => _195.manifest]) !== false ? `
+  ${_optionalChain([config, 'access', _215 => _215.agent, 'optionalAccess', _216 => _216.manifest]) !== false ? `
   // 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(_chunkJ22JD5YJcjs.FARM_APP_MANIFEST_PATH)}, ${JSON.stringify(_chunkJ22JD5YJcjs.FARM_APP_MANIFEST_LEGACY_PATH)}].includes(
+    [${JSON.stringify(_chunkJ3LBO2O4cjs.FARM_APP_MANIFEST_PATH)}, ${JSON.stringify(_chunkJ3LBO2O4cjs.FARM_APP_MANIFEST_LEGACY_PATH)}].includes(
       normalizeRuntimePath(routePathname),
     )
   ) {
@@ -9168,9 +9241,9 @@ ${hasServerRuntimeIntegrations ? `
     );
   }
   ` : ""}
-  ${_optionalChain([config, 'access', _196 => _196.agent, 'optionalAccess', _197 => _197.apiCatalog]) ? `
+  ${_optionalChain([config, 'access', _217 => _217.agent, 'optionalAccess', _218 => _218.apiCatalog]) ? `
   // agent.apiCatalog: list the OpenAPI and MCP surfaces at the RFC 9727 path.
-  if (normalizeRuntimePath(routePathname) === ${JSON.stringify(_chunkJ22JD5YJcjs.FARM_API_CATALOG_PATH)}) {
+  if (normalizeRuntimePath(routePathname) === ${JSON.stringify(_chunkJ3LBO2O4cjs.FARM_API_CATALOG_PATH)}) {
     return applyProductionMiddlewareHeaders(
       createFarmApiCatalogResponse(request.method, farmApiCatalogInput, request),
       middlewareHeaders,
@@ -9195,11 +9268,11 @@ ${hasServerRuntimeIntegrations ? `
     );
   }
   ` : ""}
-  ${_optionalChain([config, 'access', _198 => _198.agent, 'optionalAccess', _199 => _199.llmsTxt, 'optionalAccess', _200 => _200.enabled]) ? `
+  ${_optionalChain([config, 'access', _219 => _219.agent, 'optionalAccess', _220 => _220.llmsTxt, 'optionalAccess', _221 => _221.enabled]) ? `
   // agent.llmsTxt with no llms.ts or llms-full.ts: serve the generated files.
   const farmGeneratedLlmsKind = normalizeRuntimePath(routePathname) === "/llms.txt"
     ? "llms"
-    : ${_optionalChain([config, 'access', _201 => _201.agent, 'optionalAccess', _202 => _202.llmsTxt, 'optionalAccess', _203 => _203.full]) ? `normalizeRuntimePath(routePathname) === "/llms-full.txt" ? "llms-full" : ` : ""}null;
+    : ${_optionalChain([config, 'access', _222 => _222.agent, 'optionalAccess', _223 => _223.llmsTxt, 'optionalAccess', _224 => _224.full]) ? `normalizeRuntimePath(routePathname) === "/llms-full.txt" ? "llms-full" : ` : ""}null;
   if (farmGeneratedLlmsKind) {
     const llmsContext = createFarmLlmsTxtContext(request, farmGeneratedLlmsKind === "llms-full");
     const llmsOrigin = new URL(request.url).origin;
@@ -9234,7 +9307,7 @@ ${hasServerRuntimeIntegrations ? `
   }
   ` : ""}
 
-  ${_optionalChain([config, 'access', _204 => _204.docs, 'optionalAccess', _205 => _205.enabled]) ? `if (farmDocsAPIHandler && isFarmDocsAPIRequest(pathname)) {
+  ${_optionalChain([config, 'access', _225 => _225.docs, 'optionalAccess', _226 => _226.enabled]) ? `if (farmDocsAPIHandler && isFarmDocsAPIRequest(pathname)) {
     const docsAPIResponse = await farmDocsAPIHandler(cloneFarmRequestWithContext(request));
     if (docsAPIResponse) {
       return applyProductionMiddlewareHeaders(
@@ -9577,10 +9650,13 @@ ${hasServerRuntimeIntegrations ? `
           !route.shouldHydrate &&
           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;
+        // shows the page before its Suspense content arrives (FARM_FLUSH_MARKER). The marker
+        // carries a random token sent in the F-Flush header: page content cannot forge one.
+        const farmFlushToken = request.headers.get("f-stream") === "flush"
+          ? createFarmFlushToken()
+          : "";` : `const farmLayoutKeyOf = null;
         const farmPayloadOnlyNavigation = false;
-        const farmFlushMarkers = false;`}
+        const farmFlushToken = "";`}
         const renderPageElement = async () => {
             // First, render the page content
             let pageElement;
@@ -9702,7 +9778,7 @@ ${hasServerRuntimeIntegrations ? `
           }
 
           wrappedElement = wrapWithFarmIntegrationProviders(wrappedElement);
-          return renderFarmElement(ReactDOMServer, wrappedElement, route.pattern, farmFlushMarkers);
+          return renderFarmElement(ReactDOMServer, wrappedElement, route.pattern, farmFlushToken);
         };
         const renderedPage = ${hasMiddlewareRuntime ? `await _runWithMiddlewareData(middlewareData, () =>
           _runWithMiddlewareContext(middlewareContext, renderPageElement)
@@ -9770,7 +9846,7 @@ ${hasServerRuntimeIntegrations ? `
             );
           }
         }
-        ${_optionalChain([config, 'access', _206 => _206.md, 'optionalAccess', _207 => _207.enabled]) ? `
+        ${_optionalChain([config, 'access', _227 => _227.md, 'optionalAccess', _228 => _228.enabled]) ? `
         // Advertise the Markdown mirror in the head as well as the Link header,
         // using the public path the .md request will be resolved against.
         mergedMetadata = addMetadataMarkdownAlternate(
@@ -9789,7 +9865,7 @@ ${hasServerRuntimeIntegrations ? `
           emitFarmEvent({ type: "cache.bypass", route: pathname, reason: "request-read" });
         }
 
-        const renderedMetadata = renderMetadataHead(mergedMetadata, { pathname, jsonLd: ${JSON.stringify(_nullishCoalesce(_optionalChain([config, 'access', _208 => _208.agent, 'optionalAccess', _209 => _209.jsonLd]), () => ( false)))} });
+        const renderedMetadata = renderMetadataHead(mergedMetadata, { pathname, jsonLd: ${JSON.stringify(_nullishCoalesce(_optionalChain([config, 'access', _229 => _229.agent, 'optionalAccess', _230 => _230.jsonLd]), () => ( false)))} });
         const title = renderedMetadata.title;
         const metaTags = renderedMetadata.tags;
         const hasFavicon = renderedMetadata.hasFavicon;
@@ -10009,7 +10085,11 @@ ${hasServerRuntimeIntegrations ? `
               );
           return applyProductionMiddlewareHeaders(farmOwnedResponse(streamedDocument, {
             status: pageStatus,
-            headers: { ...responseHeaders, "x-farm-preload-streaming": "1" },
+            headers: {
+              ...responseHeaders,
+              "x-farm-preload-streaming": "1",
+              ...(farmFlushToken ? { "F-Flush": farmFlushToken } : {}),
+            },
           }), middlewareHeaders);
         }
 
@@ -10479,11 +10559,11 @@ ${generatePreloadResponseRuntimeSource()}
 export async function fetch(request, context) {${imageRuntime === "none" ? "" : `
   // The image optimizer's fetch of a local source is not a loopback visitor.
   context = _withFarmImageSourceClientAddress(request, context);`}
-  ${_optionalChain([config, 'access', _210 => _210.agent, 'optionalAccess', _211 => _211.noindexPreviews]) ? "const response = await" : "return"} _runWithAPIRequestRuntime({
+  ${_optionalChain([config, 'access', _231 => _231.agent, 'optionalAccess', _232 => _232.noindexPreviews]) ? "const response = await" : "return"} _runWithAPIRequestRuntime({
     basePath: farmLocalAPIBasePath,
     dispatch: async (localRequest) =>
       (await handleAPIRequest(localRequest)) ?? Response.json({ error: "Not Found" }, { status: 404 }),
-  }, () => handleFarmFetch(request, context));${_optionalChain([config, 'access', _212 => _212.agent, 'optionalAccess', _213 => _213.noindexPreviews]) ? `
+  }, () => handleFarmFetch(request, context));${_optionalChain([config, 'access', _233 => _233.agent, 'optionalAccess', _234 => _234.noindexPreviews]) ? `
   // Keep every response of a preview deployment out of search indexes.
   return farmNoindexPreview ? applyFarmPreviewRobotsTag(response) : response;` : ""}
 }
@@ -10676,11 +10756,11 @@ function getPhysicalPrerenderBypassReason(options) {
   }
   if (_chunk76GHW3WIcjs.appMiddlewareMayHandlePath.call(void 0, middlewareRoutes, pathname)) return "app middleware";
   if (_chunk76GHW3WIcjs.configMiddlewareMayHandlePath.call(void 0, config.middleware, pathname)) return "configured middleware";
-  if (_chunkO3MMJPC2cjs.hasCustomFarmRouteContext.call(void 0, config)) return "request context";
+  if (_chunkNPQLMP7Mcjs.hasCustomFarmRouteContext.call(void 0, config)) return "request context";
   if (farmServerRuntimePluginsMayHandlePath(config, pathname)) return "server runtime plugin";
   const manifestEntry = getManifestPageEntry(routeRuntimeManifest, pathname);
-  if (_optionalChain([manifestEntry, 'optionalAccess', _214 => _214.rendering]) === "dynamic") return "dynamic runtime manifest";
-  if (manifestEntry && (manifestEntry.runtime !== "auto" || Boolean(_optionalChain([manifestEntry, 'access', _215 => _215.regions, 'optionalAccess', _216 => _216.length])) || manifestEntry.maxDuration !== void 0)) {
+  if (_optionalChain([manifestEntry, 'optionalAccess', _235 => _235.rendering]) === "dynamic") return "dynamic runtime manifest";
+  if (manifestEntry && (manifestEntry.runtime !== "auto" || Boolean(_optionalChain([manifestEntry, 'access', _236 => _236.regions, 'optionalAccess', _237 => _237.length])) || manifestEntry.maxDuration !== void 0)) {
     return "route runtime controls";
   }
   const routeRule = getEffectiveRouteRule(config, pathname);
@@ -10692,11 +10772,34 @@ function getPhysicalPrerenderBypassReason(options) {
   }
   return void 0;
 }
+async function getFarmDocsPrerenderPages(config, root, preset) {
+  if (!_optionalChain([config, 'access', _238 => _238.docs, 'optionalAccess', _239 => _239.enabled]) || !config.docs.prerender) return [];
+  if (!_chunkRD623KW4cjs.isReactRenderer.call(void 0, config.renderer) || !_chunkGNJIYJMScjs.hasFarmDocsRuntimeAdapter.call(void 0, config.docs)) {
+    _chunkVQJYGZNXcjs.logger.warn(
+      "docs.prerender needs a docs adapter such as @farming-labs/farmjs; Farm's built-in docs renderer keeps rendering docs pages on request."
+    );
+    return [];
+  }
+  if (_chunkE552H232cjs.getFarmPresetRuntime.call(void 0, preset) === "edge") {
+    _chunkVQJYGZNXcjs.logger.info(
+      `\u21AA Keeping docs pages in the edge docs snapshot: docs.prerender writes static files on Node and serverless targets, not "${preset}".`
+    );
+    return [];
+  }
+  const pages = await _chunkGNJIYJMScjs.listFarmDocsAdapterPages.call(void 0, config.docs, { root, srcDir: config.srcDir });
+  if (!pages) {
+    _chunkVQJYGZNXcjs.logger.warn(
+      `The docs adapter ${JSON.stringify(config.docs.adapter.id)} does not list its pages for prerendering; upgrade it to prerender docs pages. They render on request until then.`
+    );
+    return [];
+  }
+  return pages;
+}
 function hasFarmNitroCacheRouteRule(routeRules) {
   return Object.values(routeRules || {}).some((rule) => {
-    const swr = _optionalChain([rule, 'optionalAccess', _217 => _217.swr]);
-    const cache = _optionalChain([rule, 'optionalAccess', _218 => _218.cache]);
-    const headers = _optionalChain([rule, 'optionalAccess', _219 => _219.headers]);
+    const swr = _optionalChain([rule, 'optionalAccess', _240 => _240.swr]);
+    const cache = _optionalChain([rule, 'optionalAccess', _241 => _241.cache]);
+    const headers = _optionalChain([rule, 'optionalAccess', _242 => _242.headers]);
     return swr !== void 0 && swr !== false || cache !== void 0 && cache !== false || !!headers && typeof headers === "object" && Object.keys(headers).length > 0;
   });
 }
@@ -10709,10 +10812,10 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const nitroBuilder = nitroBuilderResult.value;
   const isVercel = preset === "vercel" || preset === "vercel-edge";
   const isCloudflareWorker = preset === "cloudflare-module";
-  const outputDir = _chunkO3MMJPC2cjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
+  const outputDir = _chunkNPQLMP7Mcjs.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 = _chunkF42U3R4Fcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
+  const imageRuntime = _chunkWZW6LEHMcjs.resolveFarmImageServerRuntime.call(void 0, config.images, preset);
   const hasGeneratedMetadataImages = Array.from(routeManager.getMetadataImages().values()).some(
     (image) => image.sourceType === "module"
   );
@@ -10733,12 +10836,19 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const ssgCollectionPromise = routeManager.collectSSGPages();
   const middlewareRoutesPromise = discoverMiddlewareRoutes(_chunk5Y2P454Ocjs.getFarmAppDirectories.call(void 0, config));
   const configuredResponseRoutesPromise = Promise.all([config.redirects(), config.rewrites()]);
+  const docsPrerenderPagesPromise = getFarmDocsPrerenderPages(config, root, preset);
   const farmWorkflows = await _chunkXB24LZWIcjs.prepareFarmWorkflowsForNitro.call(void 0, config);
   const farmCron = await _chunkXYL4HSVCcjs.prepareFarmCronForNitro.call(void 0, config);
-  const [{ ssg: ssgPages }, middlewareRoutes, [configuredRedirects, configuredRewrites]] = await Promise.all([
+  const [
+    { ssg: ssgPages },
+    middlewareRoutes,
+    [configuredRedirects, configuredRewrites],
+    docsPrerenderPages
+  ] = await Promise.all([
     ssgCollectionPromise,
     middlewareRoutesPromise,
-    configuredResponseRoutesPromise
+    configuredResponseRoutesPromise,
+    docsPrerenderPagesPromise
   ]);
   const redirectSources = [
     ...routeManager.getRedirects().map((route) => route.source),
@@ -10747,7 +10857,7 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const rewriteSources = configuredRewrites.map((route) => route.source);
   const prerenderRoutes = [];
   const skippedPrerenderRoutes = [];
-  const middlewareRoutesWithConfig = ssgPages.length > 0 ? await Promise.all(
+  const middlewareRoutesWithConfig = ssgPages.length > 0 || docsPrerenderPages.length > 0 ? await Promise.all(
     middlewareRoutes.map(async (route) => ({
       ...route,
       config: await readMiddlewareFileConfig(route.filePath)
@@ -10770,6 +10880,26 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
     }
     prerenderRoutes.push(page.urlPath);
   }
+  const docsRouteRuntimeManifest = {
+    ...routeRuntimeManifest,
+    routes: routeRuntimeManifest.routes.filter((entry) => entry.kind !== "page")
+  };
+  for (const pathname of docsPrerenderPages) {
+    if (prerenderRoutes.includes(pathname)) continue;
+    const reason = getPhysicalPrerenderBypassReason({
+      config,
+      middlewareRoutes: middlewareRoutesWithConfig,
+      routeRuntimeManifest: docsRouteRuntimeManifest,
+      redirectSources,
+      rewriteSources,
+      pathname
+    });
+    if (reason) {
+      skippedPrerenderRoutes.push({ pathname, reason });
+      continue;
+    }
+    prerenderRoutes.push(pathname);
+  }
   for (const skipped of skippedPrerenderRoutes) {
     _chunkVQJYGZNXcjs.logger.info(`\u21AA Keeping SSG route ${skipped.pathname} server-handled (${skipped.reason})`);
   }
@@ -11195,20 +11325,20 @@ function toFarmNodeResponse(request, response) {
     snapshotSSRRebundleOptions(nitroConfig)
   );
   const requestedBuilder = _nullishCoalesce(nitroConfig.builder, () => ( process.env.NITRO_BUILDER));
-  const canReusePrebuiltSSR = isPrebuiltSSRCandidate && nitroConfig.preset === "node-server" && (requestedBuilder === void 0 || requestedBuilder === "rollup" || requestedBuilder === "rolldown") && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig && !hasUnsupportedSSRRebundleOverrides && _optionalChain([nitroConfig, 'access', _220 => _220.rollupConfig, 'optionalAccess', _221 => _221.external]) === nitroRollupExternal && !hasRollupPlugins(_optionalChain([nitroConfig, 'access', _222 => _222.rollupConfig, 'optionalAccess', _223 => _223.plugins])) && customRollupKeys.length === 0 && _path2.default.resolve(_optionalChain([nitroConfig, 'access', _224 => _224.output, 'optionalAccess', _225 => _225.serverDir]) || "") === _path2.default.resolve(expectedServerDir) && Boolean(
-    _optionalChain([nitroConfig, 'access', _226 => _226.handlers, 'optionalAccess', _227 => _227.some, 'call', _228 => _228(
-      (handler) => _path2.default.resolve(_optionalChain([handler, 'optionalAccess', _229 => _229.handler]) || "") === nitroEntryPath
+  const canReusePrebuiltSSR = isPrebuiltSSRCandidate && nitroConfig.preset === "node-server" && (requestedBuilder === void 0 || requestedBuilder === "rollup" || requestedBuilder === "rolldown") && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig && !hasUnsupportedSSRRebundleOverrides && _optionalChain([nitroConfig, 'access', _243 => _243.rollupConfig, 'optionalAccess', _244 => _244.external]) === nitroRollupExternal && !hasRollupPlugins(_optionalChain([nitroConfig, 'access', _245 => _245.rollupConfig, 'optionalAccess', _246 => _246.plugins])) && customRollupKeys.length === 0 && _path2.default.resolve(_optionalChain([nitroConfig, 'access', _247 => _247.output, 'optionalAccess', _248 => _248.serverDir]) || "") === _path2.default.resolve(expectedServerDir) && Boolean(
+    _optionalChain([nitroConfig, 'access', _249 => _249.handlers, 'optionalAccess', _250 => _250.some, 'call', _251 => _251(
+      (handler) => _path2.default.resolve(_optionalChain([handler, 'optionalAccess', _252 => _252.handler]) || "") === nitroEntryPath
     )])
   );
   const selectRolldownBuilder = canReusePrebuiltSSR && requestedBuilder === void 0 && await canUseRolldownBuilder();
   if (selectRolldownBuilder) nitroConfig.builder = "rolldown";
   const useRolldownBuilder = canReusePrebuiltSSR && (_nullishCoalesce(nitroConfig.builder, () => ( process.env.NITRO_BUILDER))) === "rolldown";
   const shouldMinify = nitroConfig.minify !== false;
-  const keepServerNames = !(_optionalChain([config, 'access', _230 => _230.docs, 'optionalAccess', _231 => _231.enabled]) && _optionalChain([config, 'access', _232 => _232.docs, 'access', _233 => _233.adapter, 'optionalAccess', _234 => _234.server]));
+  const keepServerNames = !(_optionalChain([config, 'access', _253 => _253.docs, 'optionalAccess', _254 => _254.enabled]) && _optionalChain([config, 'access', _255 => _255.docs, 'access', _256 => _256.adapter, 'optionalAccess', _257 => _257.server]));
   const useFarmServerMinifier = shouldMinify && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig;
   const serverChunkMinifier = useFarmServerMinifier ? createServerChunkMinifyPlugin({ keepNames: keepServerNames, target: "esnext" }) : null;
   if (canReusePrebuiltSSR) {
-    const configuredRollupPlugins = _optionalChain([nitroConfig, 'access', _235 => _235.rollupConfig, 'optionalAccess', _236 => _236.plugins]);
+    const configuredRollupPlugins = _optionalChain([nitroConfig, 'access', _258 => _258.rollupConfig, 'optionalAccess', _259 => _259.plugins]);
     nitroConfig.rollupConfig = {
       ...nitroConfig.rollupConfig,
       plugins: [
@@ -11219,9 +11349,9 @@ function toFarmNodeResponse(request, response) {
   }
   nitroConfig.minify = useFarmServerMinifier ? false : shouldMinify;
   const nitroInstance = await nitroBuilder.createNitro(nitroConfig);
-  if (_optionalChain([config, 'access', _237 => _237.md, 'optionalAccess', _238 => _238.enabled])) {
+  if (_optionalChain([config, 'access', _260 => _260.md, 'optionalAccess', _261 => _261.enabled])) {
     nitroInstance.hooks.hook("prerender:generate", (route) => {
-      if (!route.contents || !_optionalChain([route, 'access', _239 => _239.contentType, 'optionalAccess', _240 => _240.toLowerCase, 'call', _241 => _241(), 'access', _242 => _242.includes, 'call', _243 => _243("html")])) return;
+      if (!route.contents || !_optionalChain([route, 'access', _262 => _262.contentType, 'optionalAccess', _263 => _263.toLowerCase, 'call', _264 => _264(), 'access', _265 => _265.includes, 'call', _266 => _266("html")])) return;
       const alternatePath = _chunkWJFFPXCVcjs.getFarmMarkdownAlternatePath.call(void 0, config.md, route.route);
       if (!alternatePath) return;
       const routeRule = nitroInstance.options.routeRules[route.route] || {};
@@ -11242,7 +11372,7 @@ function toFarmNodeResponse(request, response) {
   }
   if (config.security.csp && config.security.csp.nonce) {
     nitroInstance.hooks.hook("prerender:generate", async (route) => {
-      if (!route.contents || !_optionalChain([route, 'access', _244 => _244.contentType, 'optionalAccess', _245 => _245.toLowerCase, 'call', _246 => _246(), 'access', _247 => _247.includes, 'call', _248 => _248("html")])) return;
+      if (!route.contents || !_optionalChain([route, 'access', _267 => _267.contentType, 'optionalAccess', _268 => _268.toLowerCase, 'call', _269 => _269(), 'access', _270 => _270.includes, 'call', _271 => _271("html")])) return;
       const staticCsp = await _chunk6JHZPB52cjs.applyFarmCspHashesToHtml.call(void 0, route.contents, config.security);
       if (!staticCsp) return;
       route.contents = staticCsp.html;
@@ -11317,13 +11447,13 @@ function toFarmNodeResponse(request, response) {
   }
   if (prerenderRoutes.length > 0) {
     _chunkVQJYGZNXcjs.logger.info(`\u{1F4C4} Pre-rendering ${prerenderRoutes.length} SSG page(s)`);
-    const previousPrerender = process.env[_chunkVO6NLTV4cjs.FARM_PRERENDER_ENV];
-    process.env[_chunkVO6NLTV4cjs.FARM_PRERENDER_ENV] = "1";
+    const previousPrerender = process.env[_chunkQXPSWMUDcjs.FARM_PRERENDER_ENV];
+    process.env[_chunkQXPSWMUDcjs.FARM_PRERENDER_ENV] = "1";
     try {
       await nitroBuilder.prerender(nitroInstance);
     } finally {
-      if (previousPrerender === void 0) delete process.env[_chunkVO6NLTV4cjs.FARM_PRERENDER_ENV];
-      else process.env[_chunkVO6NLTV4cjs.FARM_PRERENDER_ENV] = previousPrerender;
+      if (previousPrerender === void 0) delete process.env[_chunkQXPSWMUDcjs.FARM_PRERENDER_ENV];
+      else process.env[_chunkQXPSWMUDcjs.FARM_PRERENDER_ENV] = previousPrerender;
     }
   }
   const sharpRuntimeStagePromise = imageRuntime === "node" ? stageSharpRuntime(config, root, distDir, fs4, preset) : Promise.resolve(null);
@@ -11448,7 +11578,7 @@ async function moveVercelOutputPath(src, dest, fs4) {
     await fs4.rename(src, dest);
     return;
   } catch (error) {
-    const code = _optionalChain([error, 'optionalAccess', _249 => _249.code]);
+    const code = _optionalChain([error, 'optionalAccess', _272 => _272.code]);
     if (code !== "EPERM" && code !== "EACCES" && code !== "EXDEV" && code !== "ENOTEMPTY") {
       throw error;
     }
@@ -11474,7 +11604,7 @@ async function postProcessVercelOutput(root, outputDir, fs4, config, farmWorkflo
   try {
     await moveVercelOutputPath(publicDir, staticDir, fs4);
   } catch (error) {
-    if (_optionalChain([error, 'optionalAccess', _250 => _250.code]) !== "ENOENT") throw error;
+    if (_optionalChain([error, 'optionalAccess', _273 => _273.code]) !== "ENOENT") throw error;
   }
   await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs4);
   await copyPrismaClientForVercel(root, nitroFuncDir, fs4);
@@ -11503,10 +11633,29 @@ async function postProcessVercelOutput(root, outputDir, fs4, config, farmWorkflo
   _chunkVQJYGZNXcjs.logger.info("\u2705 Post-processed Vercel output for Build Output API v3");
 }
 async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs4) {
-  const docsContentDir = resolveBuildDocsContentDir(config, root);
+  if (!_optionalChain([config, 'access', _274 => _274.docs, 'optionalAccess', _275 => _275.enabled])) return;
+  const [mainRoot, ...extraRoots] = _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, config.docs);
+  await copyFarmDocsRootContent(
+    mainRoot,
+    root,
+    config.srcDir,
+    _path2.default.join(nitroFuncDir, "farm-docs-content"),
+    fs4
+  );
+  for (const [index, docsRoot] of extraRoots.entries()) {
+    await copyFarmDocsRootContent(
+      docsRoot,
+      root,
+      config.srcDir,
+      _path2.default.join(nitroFuncDir, "farm-docs-roots", String(index)),
+      fs4
+    );
+  }
+}
+async function copyFarmDocsRootContent(docs, root, srcDir, bundledContentDir, fs4) {
+  const docsContentDir = resolveBuildDocsContentDir(docs, root, srcDir);
   if (!docsContentDir) return;
-  const bundledContentDir = _path2.default.join(nitroFuncDir, "farm-docs-content");
-  const lastModifiedManifest = _chunkIOUOGRDXcjs.createFarmDocsLastModifiedManifest.call(void 0, docsContentDir, {
+  const lastModifiedManifest = _chunk5N7QAGEAcjs.createFarmDocsLastModifiedManifest.call(void 0, docsContentDir, {
     fallback: "now"
   });
   await fs4.rm(bundledContentDir, { recursive: true, force: true });
@@ -11516,7 +11665,7 @@ async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs4) {
     force: true
   });
   await fs4.writeFile(
-    _path2.default.join(bundledContentDir, _chunkIOUOGRDXcjs.FARM_DOCS_LAST_MODIFIED_MANIFEST),
+    _path2.default.join(bundledContentDir, _chunk5N7QAGEAcjs.FARM_DOCS_LAST_MODIFIED_MANIFEST),
     `${JSON.stringify(lastModifiedManifest, null, 2)}
 `
   );
@@ -11587,7 +11736,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. ${_chunkF42U3R4Fcjs.SHARP_INSTALL_HINT}`);
+      throw new Error(`Farm image optimization requires sharp. ${_chunkWZW6LEHMcjs.SHARP_INSTALL_HINT}`);
     }
   } catch (error) {
     await fs4.rm(stageDir, { recursive: true, force: true });
@@ -11817,7 +11966,7 @@ function createBuildTargetBaseline(config) {
     preset,
     distDir,
     outputDir,
-    outputWasDerived: outputDir === _chunkO3MMJPC2cjs.getDefaultDeployOutputDir.call(void 0, config.deploy.target, preset, distDir)
+    outputWasDerived: outputDir === _chunkNPQLMP7Mcjs.getDefaultDeployOutputDir.call(void 0, config.deploy.target, preset, distDir)
   };
 }
 function resolveBuildTargets(config, options, baseline) {
@@ -11826,8 +11975,8 @@ function resolveBuildTargets(config, options, baseline) {
   const distDir = config.distDir || ".farm";
   const outputWasReplaced = config.deploy.outputDir !== baseline.outputDir;
   const shouldRefreshDerivedOutput = baseline.outputWasDerived && !outputWasReplaced && (preset !== baseline.preset || distDir !== baseline.distDir);
-  const deployTarget = preset === config.deploy.preset ? config.deploy.target : _chunkO3MMJPC2cjs.getDeployTargetForPreset.call(void 0, preset);
-  const outputDir = shouldRefreshDerivedOutput ? _chunkO3MMJPC2cjs.getDefaultDeployOutputDir.call(void 0, deployTarget, preset, distDir) : config.deploy.outputDir;
+  const deployTarget = preset === config.deploy.preset ? config.deploy.target : _chunkNPQLMP7Mcjs.getDeployTargetForPreset.call(void 0, preset);
+  const outputDir = shouldRefreshDerivedOutput ? _chunkNPQLMP7Mcjs.getDefaultDeployOutputDir.call(void 0, deployTarget, preset, distDir) : config.deploy.outputDir;
   return {
     root,
     preset,
@@ -11835,7 +11984,7 @@ function resolveBuildTargets(config, options, baseline) {
     distDir,
     deployTarget,
     outputDir,
-    deployOutputDir: _chunkO3MMJPC2cjs.resolveDeployOutputPath.call(void 0, root, outputDir)
+    deployOutputDir: _chunkNPQLMP7Mcjs.resolveDeployOutputPath.call(void 0, root, outputDir)
   };
 }
 async function buildWithProductionNodeEnv(inputConfig, options) {
@@ -11872,12 +12021,12 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     };
     config = {
       ...config,
-      images: _chunkF42U3R4Fcjs.resolveFarmImageProviderForRuntime.call(void 0, config.images, {
+      images: _chunkWZW6LEHMcjs.resolveFarmImageProviderForRuntime.call(void 0, config.images, {
         root: targets.root,
         preset: targets.preset
       })
     };
-    if (_optionalChain([config, 'access', _251 => _251.docs, 'optionalAccess', _252 => _252.enabled])) await _chunkV3UOEWCBcjs.loadFarmDocsEngine.call(void 0, );
+    if (_optionalChain([config, 'access', _276 => _276.docs, 'optionalAccess', _277 => _277.enabled])) await _chunkV3UOEWCBcjs.loadFarmDocsEngine.call(void 0, );
     pluginManager.updateContext({ config });
     const { root, preset, srcDir, distDir, deployOutputDir } = targets;
     _chunkVQJYGZNXcjs.logger.info(`\u{1F69C} Building Farm.js application with preset: ${preset}...`);
@@ -11891,8 +12040,8 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     });
     _chunkVQJYGZNXcjs.logger.info("\u{1F50D} Discovering routes and API endpoints...");
     const productionViteResult = productionViteResultPromise ? (await productionViteResultPromise)[0] : void 0;
-    if (_optionalChain([productionViteResult, 'optionalAccess', _253 => _253.status]) === "rejected") throw productionViteResult.reason;
-    const productionVite = _optionalChain([productionViteResult, 'optionalAccess', _254 => _254.value]);
+    if (_optionalChain([productionViteResult, 'optionalAccess', _278 => _278.status]) === "rejected") throw productionViteResult.reason;
+    const productionVite = _optionalChain([productionViteResult, 'optionalAccess', _279 => _279.value]);
     const createViteServer = productionVite ? productionVite.createServer : (await import("vite")).createServer;
     projectModuleServer = await createProjectModuleServer(
       createViteServer,
@@ -11900,18 +12049,18 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
       root,
       rendererBuild.signal
     );
-    const farmApp = _chunkF42U3R4Fcjs.createFarmApp.call(void 0, config, projectModuleServer);
+    const farmApp = _chunkWZW6LEHMcjs.createFarmApp.call(void 0, config, projectModuleServer);
     await farmApp.initialize();
     const routeManager = farmApp.getRouteManager();
     const serverRenderer = farmApp.getServerRenderer();
-    const typeArtifacts = _chunkY7TLL65Bcjs.generateFarmTypeArtifacts.call(void 0, {
+    const typeArtifacts = _chunkUQHIWZZ6cjs.generateFarmTypeArtifacts.call(void 0, {
       root,
       srcDir,
       layers: config.layers,
       plugins: config.plugins,
       extraRoutes: [
-        ..._optionalChain([config, 'access', _255 => _255.openapi, 'optionalAccess', _256 => _256.enabled]) && config.openapi.route ? [config.openapi.route] : [],
-        ..._chunkIOUOGRDXcjs.getFarmDocsRouteTypeEntries.call(void 0, config.docs)
+        ..._optionalChain([config, 'access', _280 => _280.openapi, 'optionalAccess', _281 => _281.enabled]) && config.openapi.route ? [config.openapi.route] : [],
+        ..._chunk5N7QAGEAcjs.getFarmDocsRouteTypeEntries.call(void 0, config.docs)
       ],
       suppressLintOnLink: config.suppressLintOnLink,
       componentExtensions: config.renderer.componentExtensions,
@@ -11995,7 +12144,7 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     throw error;
   } finally {
     try {
-      await _optionalChain([projectModuleServer, 'optionalAccess', _257 => _257.close, 'call', _258 => _258()]);
+      await _optionalChain([projectModuleServer, 'optionalAccess', _282 => _282.close, 'call', _283 => _283()]);
     } finally {
       rendererBuild.abort();
     }
@@ -12006,7 +12155,7 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
     ssr: true,
     buildLifetime
   });
-  const viteConfig = _chunkF42U3R4Fcjs.mergeFarmViteConfig.call(void 0, 
+  const viteConfig = _chunkWZW6LEHMcjs.mergeFarmViteConfig.call(void 0, 
     {
       root,
       appType: "custom",
@@ -12018,19 +12167,19 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
       },
       plugins: [
         ...rendererVitePlugins,
-        _chunkF42U3R4Fcjs.farmFontImportsPlugin.call(void 0, {
+        _chunkWZW6LEHMcjs.farmFontImportsPlugin.call(void 0, {
           root,
           basePath: config.basePath,
           publicDir: config.publicDir
         }),
-        _chunkJ37KTQIAcjs.farmEnvironmentFunctionsPlugin.call(void 0, )
+        _chunkNK2VWS7Pcjs.farmEnvironmentFunctionsPlugin.call(void 0, )
       ],
       server: {
         middlewareMode: true,
         hmr: false
       },
       resolve: {
-        alias: _chunkF42U3R4Fcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
+        alias: _chunkWZW6LEHMcjs.createFarmSourceAlias.call(void 0, root, config.srcDir),
         dedupe: [...config.renderer.dedupe || []]
       },
       optimizeDeps: {
@@ -12063,10 +12212,10 @@ async function createProjectModuleServer(createViteServer, config, root, buildLi
       noDiscovery: true
     },
     // An app or plugin that brings its own SSR environment keeps it.
-    environments: _optionalChain([viteConfig, 'access', _259 => _259.environments, 'optionalAccess', _260 => _260.ssr, 'optionalAccess', _261 => _261.dev, 'optionalAccess', _262 => _262.createEnvironment]) ? viteConfig.environments : {
+    environments: _optionalChain([viteConfig, 'access', _284 => _284.environments, 'optionalAccess', _285 => _285.ssr, 'optionalAccess', _286 => _286.dev, 'optionalAccess', _287 => _287.createEnvironment]) ? viteConfig.environments : {
       ...viteConfig.environments,
       ssr: {
-        ..._optionalChain([viteConfig, 'access', _263 => _263.environments, 'optionalAccess', _264 => _264.ssr]),
+        ..._optionalChain([viteConfig, 'access', _288 => _288.environments, 'optionalAccess', _289 => _289.ssr]),
         ...await createFarmProjectModuleSsrEnvironment()
       }
     }
@@ -12094,7 +12243,7 @@ async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
       farmI18nClientBridgePlugin(),
       farmServerOnlyEntriesPlugin(),
       farmPlugin(config, pluginManager),
-      _chunkJ37KTQIAcjs.farmEnvironmentFunctionsPlugin.call(void 0, config)
+      _chunkNK2VWS7Pcjs.farmEnvironmentFunctionsPlugin.call(void 0, config)
     ],
     mode: "production"
   });
@@ -12122,12 +12271,12 @@ async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
     define: {
       __FARM_API_BASE_URL__: JSON.stringify(config.api.baseURL),
       __FARM_ENV__: JSON.stringify(_chunk3EIPOTZVcjs.createBundledEnv.call(void 0, config.env)),
-      __FARM_PUBLIC_ENV__: JSON.stringify(_optionalChain([config, 'access', _265 => _265.env, 'optionalAccess', _266 => _266.public]) || {})
+      __FARM_PUBLIC_ENV__: JSON.stringify(_optionalChain([config, 'access', _290 => _290.env, 'optionalAccess', _291 => _291.public]) || {})
     },
     plugins: [
       farmI18nClientBridgePlugin(),
       farmPlugin(config, pluginManager),
-      _chunkJ37KTQIAcjs.farmEnvironmentFunctionsPlugin.call(void 0, config)
+      _chunkNK2VWS7Pcjs.farmEnvironmentFunctionsPlugin.call(void 0, config)
     ],
     mode: "production"
   });
@@ -12155,7 +12304,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
   if (pluginManager) {
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
-  const outputDir = _chunkO3MMJPC2cjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
+  const outputDir = _chunkNPQLMP7Mcjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir);
   const serverOutputDir = _path2.default.join(outputDir, "server");
   const publicOutputDir = _path2.default.join(outputDir, "public");
   const { mkdir, cp } = await import("fs/promises");
@@ -12226,7 +12375,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
       root,
       preset,
       distDir,
-      outputDir: _chunkO3MMJPC2cjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir)
+      outputDir: _chunkNPQLMP7Mcjs.resolveDeployOutputPath.call(void 0, root, config.deploy.outputDir)
     });
   }
 }