@farm.js/core 0.1.50 → 0.1.51-beta.1

package/dist/{chunk-WVBUXNBX.mjs → chunk-5A5GAZ75.mjs}

@@ -1,3 +1,6 @@
+import {
+  loadFarmProductionVite
+} from "./chunk-PSUYE5HR.mjs";
 import {
   FARM_DESKTOP_ENV_MODULE_FILE,
   FARM_DESKTOP_ENV_MODULE_SOURCE,
@@ -7,9 +10,6 @@ import {
   createFarmNodeServerEntry,
   withProductionNodeEnv
 } from "./chunk-VU3MYZPO.mjs";
-import {
-  loadFarmProductionVite
-} from "./chunk-PSUYE5HR.mjs";
 import {
   generateNativeMCPPluginSource
 } from "./chunk-KQH2COEJ.mjs";
@@ -17,27 +17,29 @@ import {
   assertFarmDocsAdapterServesNoGuardedPages,
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler,
-  hasFarmDocsRuntimeAdapter
-} from "./chunk-76R5GJER.mjs";
+  hasFarmDocsRuntimeAdapter,
+  listFarmDocsAdapterPages
+} from "./chunk-I3EFXUAR.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
   createFarmDocsLastModifiedManifest,
   discoverFarmDocsPages,
   getFarmDocsMarkdownPath,
+  getFarmDocsRoots,
   getFarmDocsRouteTypeEntries,
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-KO2NWUKN.mjs";
+} from "./chunk-EIMK7D2D.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
   resolveFarmDocsSearchClientModule
-} from "./chunk-WB6XES4V.mjs";
+} from "./chunk-ALEUMLJN.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-M7LKA632.mjs";
+} from "./chunk-KU7MBLDZ.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-N35YPV4N.mjs";
@@ -52,7 +54,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-2DEPNLXK.mjs";
+} from "./chunk-KMB5BMFX.mjs";
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
@@ -84,10 +86,10 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath,
   usesFarmServerTree
-} from "./chunk-IWJKJDNW.mjs";
+} from "./chunk-EWC76P5D.mjs";
 import {
   loadTailwindVitePlugin
-} from "./chunk-XLLVWLWO.mjs";
+} from "./chunk-PIHKO25G.mjs";
 import {
   PluginManager
 } from "./chunk-GHNW564E.mjs";
@@ -95,7 +97,7 @@ import {
   generateFarmTypeArtifacts,
   readRouteRenderingDirectiveFromFile,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-SHJJM6OG.mjs";
+} from "./chunk-CZ35L6PL.mjs";
 import {
   HOISTED_HEAD_ELEMENT,
   appMiddlewareMayHandlePath,
@@ -108,7 +110,7 @@ import {
   layoutsCanCoverSamePage,
   routeBoundaryCoversDirectory,
   stripRouteGroups
-} from "./chunk-ZIBIE7AH.mjs";
+} from "./chunk-7UPCJDB5.mjs";
 import {
   farmPluginMayAffectRuntimePath
 } from "./chunk-UUMKLGUU.mjs";
@@ -122,7 +124,7 @@ import {
   listFarmBuiltInRoutePaths,
   resolveFarmApiCatalogInput,
   resolveFarmAppManifestInput
-} from "./chunk-JJOWY3XD.mjs";
+} from "./chunk-QAIAFCRZ.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   createFarmDefaultMCPServer,
@@ -130,7 +132,7 @@ import {
 } from "./chunk-KRRZJ77U.mjs";
 import {
   farmEnvironmentFunctionsPlugin
-} from "./chunk-C5JXCUKR.mjs";
+} from "./chunk-ZQ5BDNKW.mjs";
 import {
   isFarmMarkdownPageFile
 } from "./chunk-GW4YUIHW.mjs";
@@ -174,16 +176,16 @@ import {
 import {
   applyFarmWorkflowVercelCrons,
   prepareFarmWorkflowsForNitro
-} from "./chunk-5V4KZOZO.mjs";
+} from "./chunk-LZ4SB57H.mjs";
 import {
   applyFarmCronVercelCrons,
   createFarmCronCloudflareConfig,
   mergeScheduledTasks,
   prepareFarmCronForNitro
-} from "./chunk-UCQ52TJY.mjs";
+} from "./chunk-X3JNB2TB.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-BW6SCVYX.mjs";
+} from "./chunk-FSQMN2MQ.mjs";
 import {
   getFarmMarkdownAlternatePath
 } from "./chunk-N77JBPLC.mjs";
@@ -193,7 +195,7 @@ import {
 import {
   getFarmIntegrationPluginServerRuntime,
   getIntegrationProviders
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   FARM_INTEGRATION_API_BASE_PATH_KEY
 } from "./chunk-F6TLUMH7.mjs";
@@ -201,10 +203,10 @@ import {
   appendMiddlewareDirectory,
   appendMiddlewareRoutePath,
   compareMiddlewareRouteLocations
-} from "./chunk-4HBKBHVP.mjs";
+} from "./chunk-5ENW27SL.mjs";
 import {
   APIRouteManager
-} from "./chunk-WXHDVXJE.mjs";
+} from "./chunk-KY32FWK7.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-DU4VHHPJ.mjs";
@@ -224,14 +226,14 @@ import {
   logger,
   toPosixPath,
   toViteModuleId
-} from "./chunk-2SVJGOAX.mjs";
+} from "./chunk-Y3N5BFRJ.mjs";
 import {
   resolveFarmAPIServerBasePath,
   resolveFarmAPIServerRoutePath
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-2VCC3GVC.mjs";
+} from "./chunk-EOSFVNXZ.mjs";
 import {
   getFarmPresetRuntime
 } from "./chunk-UAQD67HM.mjs";
@@ -1080,6 +1082,75 @@ function createFarmPrivateClientSourcemapsPlugin(options) {
   };
 }
 
+// src/middleware/static-config.ts
+function literalMatcher(node) {
+  if (!node) return void 0;
+  if (node.type === "Literal" && typeof node.value === "string") return node.value;
+  if (node.type === "Literal" && node.regex)
+    return new RegExp(node.regex.pattern, node.regex.flags);
+  if (node.type === "TemplateLiteral" && node.expressions.length === 0) {
+    return node.quasis[0]?.value?.cooked ?? void 0;
+  }
+  return void 0;
+}
+function literalMatchers(node) {
+  const values = node.type === "ArrayExpression" ? node.elements : [node];
+  const matchers = [];
+  for (const value of values) {
+    const matcher = literalMatcher(value);
+    if (matcher === void 0) return void 0;
+    matchers.push(matcher);
+  }
+  return matchers;
+}
+function unwrap(node) {
+  while (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression") {
+    node = node.expression;
+  }
+  return node;
+}
+function readStaticMiddlewareConfig(program) {
+  let found = null;
+  for (const statement of program.body) {
+    if (statement.type === "ExportNamedDeclaration" && !statement.declaration) {
+      if (statement.specifiers.some((specifier) => specifier.exported?.name === "config")) {
+        return "unknown";
+      }
+      continue;
+    }
+    const declaration = statement.type === "ExportNamedDeclaration" ? statement.declaration : null;
+    if (!declaration || declaration.type !== "VariableDeclaration") continue;
+    for (const declarator of declaration.declarations) {
+      if (declarator.id?.type !== "Identifier" || declarator.id.name !== "config") continue;
+      if (declaration.kind !== "const" || !declarator.init) return "unknown";
+      const init = unwrap(declarator.init);
+      if (init.type !== "ObjectExpression") return "unknown";
+      const config = {};
+      for (const property of init.properties) {
+        if (property.type !== "Property" || property.computed) return "unknown";
+        const key = property.key?.name ?? property.key?.value;
+        if (key !== "matcher" && key !== "exclude") continue;
+        const matchers = literalMatchers(unwrap(property.value));
+        if (!matchers) return "unknown";
+        if (key === "matcher") config.matcher = matchers;
+        else config.exclude = matchers;
+      }
+      found = config;
+    }
+  }
+  return found;
+}
+async function readMiddlewareFileConfig(filePath) {
+  try {
+    const [{ readFile }, vite] = await Promise.all([import("fs/promises"), import("vite")]);
+    const parsed = vite.parseSync(filePath, await readFile(filePath, "utf8"));
+    if (parsed.errors?.length) return "unknown";
+    return readStaticMiddlewareConfig(parsed.program);
+  } catch {
+    return "unknown";
+  }
+}
+
 // src/nitro/universal-build.ts
 function preloadFarmNitroBuilder() {
   return import("nitro/builder").then(
@@ -1613,15 +1684,14 @@ function createServerChunkMinifyPlugin(options) {
 function trimSlashes(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
-function resolveBuildDocsContentDir(config, root) {
-  if (!config.docs?.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 = path10.isAbsolute(configuredContentDir) ? configuredContentDir : path10.join(root, configuredContentDir);
     return existsSync2(contentDir) ? contentDir : null;
   }
-  const entryDir = config.docs.config.entry || trimSlashes(config.docs.entry) || "docs";
-  const appDocsDir = path10.join(root, config.srcDir || "src", "app", entryDir);
+  const entryDir = docs.config.entry || trimSlashes(docs.entry) || "docs";
+  const appDocsDir = path10.join(root, srcDir || "src", "app", entryDir);
   if (existsSync2(appDocsDir)) return appDocsDir;
   const rootDocsDir = path10.join(root, entryDir);
   return existsSync2(rootDocsDir) ? rootDocsDir : null;
@@ -2143,9 +2213,12 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   const adapterOwnsDocsRuntime = Boolean(
     isReactRenderer(config.renderer) && config.docs?.enabled && config.docs.adapter?.server && config.docs.adapter.react
   );
-  const adapterDocsEntry = config.docs?.enabled ? `/${config.docs.entry || "docs"}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/" : null;
-  const isAdapterDocsRoute = (routePattern) => Boolean(
-    adapterOwnsDocsRuntime && adapterDocsEntry && (adapterDocsEntry === "/" || routePattern === adapterDocsEntry || routePattern.startsWith(`${adapterDocsEntry}/`))
+  const docsEntries = config.docs?.enabled ? getFarmDocsRoots(config.docs).map(
+    (docsRoot) => `/${docsRoot.entry || "docs"}`.replace(/\/+/g, "/").replace(/\/$/, "") || "/"
+  ) : [];
+  const adapterDocsEntry = docsEntries[0] ?? null;
+  const isAdapterDocsRoute = (routePattern) => adapterOwnsDocsRuntime && docsEntries.some(
+    (docsEntry) => docsEntry === "/" || routePattern === docsEntry || routePattern.startsWith(`${docsEntry}/`)
   );
   const syntheticDocsEntry = config.docs?.enabled && !adapterOwnsDocsRuntime ? adapterDocsEntry : null;
   const syntheticDocsPatterns = syntheticDocsEntry ? syntheticDocsEntry === "/" ? ["/", "/[...slug]"] : [syntheticDocsEntry, `${syntheticDocsEntry}/[...slug]`] : [];
@@ -2195,7 +2268,7 @@ 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) {
       logger.warn(`\u26A0\uFE0F  ${describeSuppressedAsyncHydration(layout.pattern, layout.fallbackReason)}`);
     }
@@ -2303,7 +2376,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     srcDir,
     adapterOwnsDocsRuntime ? false : isFarmDocsSearchEnabled(config.docs),
     adapterOwnsDocsRuntime ? void 0 : resolveFarmDocsSearchClientModule(root),
-    config.docs?.enabled ? config.docs.entry : void 0,
+    config.docs?.enabled ? getFarmDocsRoots(config.docs).map((docsRoot) => docsRoot.entry) : void 0,
     adapterOwnsDocsRuntime ? config.docs.adapter?.react : void 0,
     config.i18n,
     config.plugins,
@@ -2371,28 +2444,9 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
               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;
             }
@@ -3355,6 +3409,14 @@ function countFarmKeptLayouts(request, layouts, params) {
   // browser's chain starts at the next layout.
   return keys.length > 1 ? 1 + getSharedLayoutPrefixLength(chain, keys.slice(1)) : 0;
 }
+`;
+var FARM_DOCUMENT_PARSED_RUNTIME = `function farmDocumentParsed() {
+  if (document.readyState !== "loading") return Promise.resolve();
+  return new Promise(function(resolve) {
+    document.addEventListener("DOMContentLoaded", function() { resolve(); }, { once: true });
+  });
+}
+
 `;
 function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlots, root, srcDir, docsSearchEnabled, docsSearchModuleId, docsEntryPath, docsAdapterReact, i18nConfig = {
   enabled: false,
@@ -3447,8 +3509,18 @@ function isFarmLocaleDocumentChange() {
   return false;
 }
 `;
-  const docsNavigationRuntime = docsEntryPath ? `
-const farmDocsEntryPath = ${JSON.stringify(docsEntryPath)};
+  const docsEntryPaths = typeof docsEntryPath === "string" ? [docsEntryPath] : 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;
@@ -3715,7 +3787,7 @@ void farmClientRuntime.start();
 spaRouter.initializeHistory();
 window.__FARM_SPA_ROUTER__ = spaRouter;
 
-${islandValues ? "void farmDocumentParsed().then(hydrateFarmDocsAdapterRuntime);" : "void hydrateFarmDocsAdapterRuntime();"}
+${islandValues ? `${FARM_DOCUMENT_PARSED_RUNTIME}void farmDocumentParsed().then(hydrateFarmDocsAdapterRuntime);` : "void hydrateFarmDocsAdapterRuntime();"}
 
 window.addEventListener("beforeunload", function(event) {
   if (spaRouter.shouldBlockUnload()) {
@@ -3842,7 +3914,7 @@ ${layoutImports}
 ${rendererClientImports}
 ${isolatedHydrationImport}
 ${providerClientCode.imports}
-import { createClientCancellation, createClientPluginManager, getFarmIslandValueHeaders, getHashTargetElement, installChunkErrorRecovery, isFarmBlockedNavigationURL, isFarmExternalNavigationURL, reconcileFarmDocumentHead, runFarmNavigationDelegates, scheduleFarmIslandHydration, searchParamsToObject, setFarmBasePath, setFarmTrailingSlashPreference, stripFarmBasePath } from "@farm.js/core/internal/client-runtime";
+import { createClientCancellation, createClientPluginManager, getFarmIslandValueHeaders, getHashTargetElement, installChunkErrorRecovery, isFarmBlockedNavigationURL, isFarmExternalNavigationURL, reconcileFarmDocumentHead, runFarmNavigationDelegates, scheduleFarmIslandHydration, createFarmSearchParams, searchParamsToObject, setFarmBasePath, setFarmTrailingSlashPreference, stripFarmBasePath } from "@farm.js/core/internal/client-runtime";
 import { createFarmDeploymentMismatchError, createFarmDeploymentRequestHeaders, isFarmDeploymentMismatchResponse } from "@farm.js/core/deployment";
 import { createFarmRouter, isFarmRouteActive, matchFarmRoute } from "@farm.js/core/router";
 ${clientPluginEntry.imports}
@@ -4029,7 +4101,7 @@ async function createMatchedHydrationRoute(matched, pathname, searchParams, serv
       if (!serverProps || serverProps.__farmRoutePropsResolved !== true) return null;
       const props = {
         ...reviveServerPageProps(serverProps),
-        searchParams: Promise.resolve(serverProps.search ?? searchParams),
+        searchParams: createFarmSearchParams(serverProps.search ?? searchParams),
       };
       pageElement = React.createElement(Component, props);
     } else if (typeof Component === "function" && Component.constructor && Component.constructor.name === "AsyncFunction") {
@@ -4044,7 +4116,7 @@ async function createMatchedHydrationRoute(matched, pathname, searchParams, serv
       const props = {
         ...reviveServerPageProps(serverProps),
         params: params,
-        searchParams: Promise.resolve(searchParams),
+        searchParams: createFarmSearchParams(searchParams),
       };
       pageElement = React.createElement(Component, props);
     }
@@ -4290,16 +4362,7 @@ function resetReactRoot() {
   isHydrated = false;
 }
 
-${islandValues ? `// Islands mode starts the client while the body streams (an async entry): a page of islands
-// hydrates them as they arrive; anything else waits for the whole document.
-function farmDocumentParsed() {
-  if (document.readyState !== "loading") return Promise.resolve();
-  return new Promise(function(resolve) {
-    document.addEventListener("DOMContentLoaded", function() { resolve(); }, { once: true });
-  });
-}
-
-` : ""}// Hydrate client components
+${islandValues ? FARM_DOCUMENT_PARSED_RUNTIME : ""}// Hydrate client components
 async function hydrate() {
   await window.__FARM_PPR_REFRESH_PROMISE__;
   // A PPR refresh that is still retrying must not replace DOM once hydration starts.
@@ -4703,7 +4766,7 @@ ${islandValues ? `  // Islands mode: navigations name the layouts on screen, and
         if (!this.isCurrentNavigation(navigation, clientNavigation)) return;
         const params = matched.params;
         const searchParams = searchParamsToObject(url.searchParams);
-        const props = { params: params, searchParams: Promise.resolve(searchParams) };
+        const props = { params: params, searchParams: createFarmSearchParams(searchParams) };
         let pageElement = React.createElement(Component, props);
         if (hasHydratableLayout(pathname)) {
           pageElement = createLayoutPageBoundary(matched.route, pageElement);
@@ -5240,7 +5303,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       srcDir: config.srcDir,
       clientEntry: FARM_CLIENT_JS_SRC_PLACEHOLDER,
       fontStylesheetHref: "/farm-fonts.css",
-      globalStylesheetHref: "/assets/globals.css"
+      globalStylesheetHref: FARM_CLIENT_CSS_HREF_PLACEHOLDER
     }) : await (async () => {
       const guardedPaths = new Set(getFarmDocsGuardedPaths(config, middlewareRoutes));
       return compileFarmDocsManifest(config.docs, {
@@ -5249,7 +5312,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         clientEntry: FARM_CLIENT_JS_SRC_PLACEHOLDER,
         fontAssets: toFarmDocsPublicFontAssets(resolveFarmDocsFontAssets(root)),
         fontStylesheetHref: "/farm-fonts.css",
-        globalStylesheetHref: "/assets/globals.css",
+        globalStylesheetHref: FARM_CLIENT_CSS_HREF_PLACEHOLDER,
         isPathGuarded: (pathname) => guardedPaths.has(pathname)
       });
     })()
@@ -5503,15 +5566,14 @@ function readFarmPageLastModified(pageRoutes) {
 }
 function getFarmDocsGuardedPaths(config, middlewareRoutes) {
   if (!config.docs?.enabled) return [];
-  const contentDir = resolveFarmDocsContentDir(config.docs, {
-    root: config.root,
-    srcDir: config.srcDir
-  });
+  const options = { root: config.root, srcDir: config.srcDir };
   const guards = {
     config: { middleware: config.middleware, integrations: config.integrations },
     middlewareRoutes
   };
-  return discoverFarmDocsPages(contentDir, config.docs).flatMap((page) => [page.href, getFarmDocsMarkdownPath(page.href)]).filter((pathname) => farmPathGuardCoversPage(guards, pathname));
+  return getFarmDocsRoots(config.docs).flatMap(
+    (docsRoot) => discoverFarmDocsPages(resolveFarmDocsContentDir(docsRoot, options), docsRoot)
+  ).flatMap((page) => [page.href, getFarmDocsMarkdownPath(page.href)]).filter((pathname) => farmPathGuardCoversPage(guards, pathname));
 }
 function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
   const llmsTxt = agent?.llmsTxt;
@@ -5525,10 +5587,34 @@ function getFarmAppOwnedDocsEnginePaths(agent, applicationMetadataRoutes) {
     ...agent?.crawlers?.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 (docs?.roots?.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 = docs.roots?.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,
@@ -5546,7 +5632,7 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
       config: nestedConfig
     });
   }
-  return `farmDocsBundledContentDir
+  const expression = `farmDocsBundledContentDir
   ? {
       ...${JSON.stringify(baseConfig)},
       contentDir: farmDocsBundledContentDir,
@@ -5555,7 +5641,19 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
         contentDir: farmDocsBundledContentDir,
       },
     }
-  : ${JSON.stringify({ ...docs, runtimeConfig: void 0 })}`;
+  : ${JSON.stringify({ ...serializableDocs, runtimeConfig: void 0 })}`;
+  if (!docs.roots?.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, "/"));
@@ -5870,7 +5968,13 @@ function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlot
   const adapterOwnsDocsRuntime = Boolean(
     isReactRenderer(config.renderer) && config.docs?.enabled && config.docs.adapter?.server && config.docs.adapter.react
   );
+  if (config.docs?.enabled && config.docs.roots?.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 = isReactRenderer(config.renderer) && isolatedClientBoundaryModules.size > 0;
   const rendererStreamingCapabilities = getFarmRendererStreamingCapabilitiesForRuntime(
     config.renderer,
@@ -6267,7 +6371,9 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   resolveFarmInstrumentationRuntime,
   resolveFarmPreviewDeployment,
   resolveFarmWebRequestOrigin,
+  fetchFarmExternalRewrite,
   runWithFarmRequestSpan,
+  createFarmSearchParams,
   searchParamsToObject,
   setFarmBasePath,
   setFarmTrailingSlashPreference,
@@ -6297,8 +6403,8 @@ const isFarmDocsAPIRequest = (requestOrPathname) => {
     : new URL(requestOrPathname.url).pathname;
   const apiPath = ${JSON.stringify(farmDocsPrecompiledManifest?.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 { ${config.docs.roots?.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 = config.docs?.enabled && !hasPrecompiledDocs ? `import { resolveFarmLayoutFonts } from "@farm.js/core/font";` : "";
@@ -6716,7 +6822,20 @@ const farmDocsBundledContentDir = ${config.docs?.enabled && !hasPrecompiledDocs
   } catch {
     return null;
   }
-})()` : "null"};
+})()` : "null"};${config.docs?.enabled && !hasPrecompiledDocs && config.docs.roots?.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
@@ -6754,12 +6873,7 @@ const farmDocsModulePreloadPaths = farmDocsModulePreloads
       ),
     }
   : undefined;
-const farmDocsHandler = ${config.docs?.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 = ${config.docs?.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.
@@ -6788,7 +6902,8 @@ const farmDocsHandler = ${config.docs?.enabled ? hasPrecompiledDocs ? "farmDocsP
       getApplicableLayouts(getFarmRoutePathname(pathname)).map((layout) => layout.module),
     ),
   fontStylesheetHref: "/farm-fonts.css",
-  globalStylesheetHref: "/assets/globals.css",
+  // The client stylesheet carries globals.css under a content-hashed name.
+  globalStylesheetHref: ${JSON.stringify(FARM_CLIENT_CSS_HREF_PLACEHOLDER)},
   isPathGuarded: isFarmDocsPathGuarded,
 })` : "null"};
 const farmDocsAPIHandler = ${config.docs?.enabled ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleAPIRequest" : adapterOwnsDocsRuntime ? "null" : `createFarmDocsAPIHandler({ rootDir: farmDocsRuntimeRoot, srcDir: ${JSON.stringify(config.srcDir)}, docs: farmDocsResolvedConfig, isPathGuarded: isFarmDocsPathGuarded })` : "null"};
@@ -7853,7 +7968,7 @@ async function handleMetadataImageRequest(request, routePathname) {
     const searchParams = searchParamsToObject(url.searchParams);
     const props = {
       params: match.params,
-      searchParams: Promise.resolve(searchParams),
+      searchParams: createFarmSearchParams(searchParams),
       path: match.pagePath,
     };
     const value = typeof imageModule.default === "function"
@@ -8410,7 +8525,7 @@ const farmBuiltInRoutePaths = new Set(${JSON.stringify(
   )});
 ${config.docs?.enabled ? `const farmDocsRouteLabelInput = {
   path: normalizeRuntimePath(farmDocsResolvedConfig?.entry || "/docs"),
-  apiPath: ${JSON.stringify(farmDocsPrecompiledManifest?.apiPath || "/api/docs")},
+  apiPath: ${JSON.stringify(farmDocsPrecompiledManifest?.apiPath || "/api/docs")},${config.docs.roots?.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");
@@ -8785,7 +8900,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
@@ -9317,7 +9432,7 @@ ${hasServerRuntimeIntegrations ? `
         const rawPageProps = withFarmRouteContext(
           {
             params,
-            searchParams: Promise.resolve(searchParamsObj),
+            searchParams: createFarmSearchParams(searchParamsObj),
             path: pathname,
             ...(middlewareData?.size ? { middleware: { data: middlewareData } } : {}),
           },
@@ -9358,7 +9473,7 @@ ${hasServerRuntimeIntegrations ? `
                 ...rawPageProps,
                 params: parsedParams,
                 search: parsedSearch,
-                searchParams: Promise.resolve(parsedSearch),
+                searchParams: createFarmSearchParams(parsedSearch),
               };
             })();
           if (
@@ -9377,7 +9492,7 @@ ${hasServerRuntimeIntegrations ? `
           const routeStateProps = {
             ...rawPageProps,
             search: searchParamsObj,
-            searchParams: Promise.resolve(searchParamsObj),
+            searchParams: createFarmSearchParams(searchParamsObj),
             error: routeStateError,
           };
           if (isFarmNotFoundError(routeStateError) && routeComponents?.notFound) {
@@ -9406,7 +9521,7 @@ ${hasServerRuntimeIntegrations ? `
             const rawSlotProps = withFarmRouteContext(
               {
                 params: slot.params,
-                searchParams: Promise.resolve(searchParamsObj),
+                searchParams: createFarmSearchParams(searchParamsObj),
                 path: pathname,
                 ...(middlewareData?.size ? { middleware: { data: middlewareData } } : {}),
               },
@@ -9433,7 +9548,7 @@ ${hasServerRuntimeIntegrations ? `
                   search: slotSchemas.search?.parse
                     ? slotSchemas.search.parse(searchParamsObj)
                     : searchParamsObj,
-                  searchParams: Promise.resolve(
+                  searchParams: createFarmSearchParams(
                     slotSchemas.search?.parse
                       ? slotSchemas.search.parse(searchParamsObj)
                       : searchParamsObj,
@@ -10097,7 +10212,7 @@ ${hasServerRuntimeIntegrations ? `
             reset: function() {},
             params,
             search: searchParamsObj,
-            searchParams: Promise.resolve(searchParamsObj),
+            searchParams: createFarmSearchParams(searchParamsObj),
             path: pathname,
             ...(middlewareData?.size ? { middleware: { data: middlewareData } } : {}),
           });
@@ -10619,6 +10734,29 @@ function getPhysicalPrerenderBypassReason(options) {
   }
   return void 0;
 }
+async function getFarmDocsPrerenderPages(config, root, preset) {
+  if (!config.docs?.enabled || !config.docs.prerender) return [];
+  if (!isReactRenderer(config.renderer) || !hasFarmDocsRuntimeAdapter(config.docs)) {
+    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 (getFarmPresetRuntime(preset) === "edge") {
+    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 listFarmDocsAdapterPages(config.docs, { root, srcDir: config.srcDir });
+  if (!pages) {
+    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 = rule?.swr;
@@ -10660,12 +10798,19 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const ssgCollectionPromise = routeManager.collectSSGPages();
   const middlewareRoutesPromise = discoverMiddlewareRoutes(getFarmAppDirectories(config));
   const configuredResponseRoutesPromise = Promise.all([config.redirects(), config.rewrites()]);
+  const docsPrerenderPagesPromise = getFarmDocsPrerenderPages(config, root, preset);
   const farmWorkflows = await prepareFarmWorkflowsForNitro(config);
   const farmCron = await prepareFarmCronForNitro(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),
@@ -10674,12 +10819,18 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const rewriteSources = configuredRewrites.map((route) => route.source);
   const prerenderRoutes = [];
   const skippedPrerenderRoutes = [];
+  const middlewareRoutesWithConfig = ssgPages.length > 0 || docsPrerenderPages.length > 0 ? await Promise.all(
+    middlewareRoutes.map(async (route) => ({
+      ...route,
+      config: await readMiddlewareFileConfig(route.filePath)
+    }))
+  ) : middlewareRoutes;
   for (const page of ssgPages) {
     if (page.revalidate !== void 0) continue;
     if (prerenderRoutes.includes(page.urlPath)) continue;
     const reason = getPhysicalPrerenderBypassReason({
       config,
-      middlewareRoutes,
+      middlewareRoutes: middlewareRoutesWithConfig,
       routeRuntimeManifest,
       redirectSources,
       rewriteSources,
@@ -10691,6 +10842,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) {
     logger.info(`\u21AA Keeping SSG route ${skipped.pathname} server-handled (${skipped.reason})`);
   }
@@ -11424,9 +11595,28 @@ async function postProcessVercelOutput(root, outputDir, fs4, config, farmWorkflo
   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 (!config.docs?.enabled) return;
+  const [mainRoot, ...extraRoots] = getFarmDocsRoots(config.docs);
+  await copyFarmDocsRootContent(
+    mainRoot,
+    root,
+    config.srcDir,
+    path10.join(nitroFuncDir, "farm-docs-content"),
+    fs4
+  );
+  for (const [index, docsRoot] of extraRoots.entries()) {
+    await copyFarmDocsRootContent(
+      docsRoot,
+      root,
+      config.srcDir,
+      path10.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 = path10.join(nitroFuncDir, "farm-docs-content");
   const lastModifiedManifest = createFarmDocsLastModifiedManifest(docsContentDir, {
     fallback: "now"
   });
@@ -12063,7 +12253,7 @@ function resolveLegacyPageEntry(config, root, srcDir) {
 }
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-2Q5NVY7L.mjs"),
+    import("./nitro-R444AF3O.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(