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

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

@@ -17,19 +17,21 @@ import {
   assertFarmDocsAdapterServesNoGuardedPages,
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler,
-  hasFarmDocsRuntimeAdapter
-} from "./chunk-3HA7PP72.mjs";
+  hasFarmDocsRuntimeAdapter,
+  listFarmDocsAdapterPages
+} from "./chunk-I3EFXUAR.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
   createFarmDocsLastModifiedManifest,
   discoverFarmDocsPages,
   getFarmDocsMarkdownPath,
+  getFarmDocsRoots,
   getFarmDocsRouteTypeEntries,
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-4GJJ65RB.mjs";
+} from "./chunk-EIMK7D2D.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -37,7 +39,7 @@ import {
 } from "./chunk-ALEUMLJN.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-YLNBWUVS.mjs";
+} from "./chunk-KU7MBLDZ.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-N35YPV4N.mjs";
@@ -52,7 +54,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-JF5CNHHF.mjs";
+} from "./chunk-KMB5BMFX.mjs";
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
@@ -84,7 +86,7 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath,
   usesFarmServerTree
-} from "./chunk-S5ZA2T2W.mjs";
+} from "./chunk-EWC76P5D.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";
@@ -95,7 +97,7 @@ import {
   generateFarmTypeArtifacts,
   readRouteRenderingDirectiveFromFile,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-WVX3BUNJ.mjs";
+} from "./chunk-CZ35L6PL.mjs";
 import {
   HOISTED_HEAD_ELEMENT,
   appMiddlewareMayHandlePath,
@@ -122,7 +124,7 @@ import {
   listFarmBuiltInRoutePaths,
   resolveFarmApiCatalogInput,
   resolveFarmAppManifestInput
-} from "./chunk-R5P4KFPM.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";
@@ -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";
@@ -231,7 +233,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-EOSFVNXZ.mjs";
 import {
   getFarmPresetRuntime
 } from "./chunk-UAQD67HM.mjs";
@@ -1682,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;
@@ -2212,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]`] : [];
@@ -2264,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)}`);
     }
@@ -2372,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,
@@ -2440,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;
             }
@@ -3524,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;
@@ -5571,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;
@@ -5593,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,
@@ -5614,7 +5632,7 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
       config: nestedConfig
     });
   }
-  return `farmDocsBundledContentDir
+  const expression = `farmDocsBundledContentDir
   ? {
       ...${JSON.stringify(baseConfig)},
       contentDir: farmDocsBundledContentDir,
@@ -5623,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, "/"));
@@ -5938,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,
@@ -6335,6 +6371,7 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   resolveFarmInstrumentationRuntime,
   resolveFarmPreviewDeployment,
   resolveFarmWebRequestOrigin,
+  fetchFarmExternalRewrite,
   runWithFarmRequestSpan,
   createFarmSearchParams,
   searchParamsToObject,
@@ -6366,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";` : "";
@@ -6785,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
@@ -6823,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.
@@ -8480,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");
@@ -8855,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
@@ -10689,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;
@@ -10730,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),
@@ -10744,7 +10819,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)
@@ -10767,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})`);
   }
@@ -11500,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"
   });

package/dist/{chunk-PDJSL7PL.cjs → chunk-5IONBVJY.cjs}

@@ -40,7 +40,7 @@ var _chunkJYNNIGQOcjs = require('./chunk-JYNNIGQO.cjs');
 var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 
 
-var _chunkZ5MZDFX4cjs = require('./chunk-Z5MZDFX4.cjs');
+var _chunkYIHRZBD7cjs = require('./chunk-YIHRZBD7.cjs');
 
 
 
@@ -457,11 +457,11 @@ function farmApiPlugin(options = {}) {
             const response = await apiRouterHandler(request);
             const duration = Date.now() - startTime;
             logResponse(method, currentPathname, response.status, duration);
-            await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+            await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response);
           } catch (error) {
             const bodyErrorResponse = _chunkLIFUPCXWcjs.createFarmRequestBodyErrorResponse.call(void 0, error);
             if (bodyErrorResponse) {
-              await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, bodyErrorResponse);
+              await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, bodyErrorResponse);
               return;
             }
             const duration = Date.now() - startTime;

package/dist/{chunk-IOUOGRDX.cjs → chunk-5N7QAGEA.cjs}

@@ -651,16 +651,34 @@ function resolveFarmDocsContentDir(docs, options) {
   if (_fs.existsSync.call(void 0, appDocsDir)) return appDocsDir;
   return _path2.default.join(root, entryDir);
 }
+function getFarmDocsRoots(docs) {
+  return [
+    docs,
+    ...(_nullishCoalesce(docs.roots, () => ( []))).map((root) => ({
+      ...docs,
+      entry: root.entry,
+      contentDir: root.contentDir,
+      config: root.config,
+      runtimeConfig: root.runtimeConfig,
+      configOverrides: root.configOverrides,
+      roots: void 0
+    }))
+  ];
+}
 function getFarmDocsRouteTypeEntries(docs) {
   if (!_optionalChain([docs, 'optionalAccess', _44 => _44.enabled])) return [];
-  const entry = normalizeEntry2(docs.entry);
-  if (entry === "/") return ["/", "/[...docs]"];
-  return [entry, `${entry}/[...docs]`];
+  return getFarmDocsRoots(docs).flatMap((root) => {
+    const entry = normalizeEntry2(root.entry);
+    if (entry === "/") return ["/", "/[...docs]"];
+    return [entry, `${entry}/[...docs]`];
+  });
 }
 function getFarmDocsDocumentNavigationMatchers(docs) {
   if (!_optionalChain([docs, 'optionalAccess', _45 => _45.enabled])) return [];
-  const entry = normalizeEntry2(docs.entry);
-  return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
+  return getFarmDocsRoots(docs).map((root) => {
+    const entry = normalizeEntry2(root.entry);
+    return entry === "/" ? "/(.*)" : `${entry}(.*)`;
+  });
 }
 function getRequestSlug(docs, request) {
   const pathname = new URL(request.url).pathname;
@@ -1928,4 +1946,5 @@ function createFarmDocsHandler(docs, options) {
 
 
 
-exports.FARM_DOCS_LAST_MODIFIED_MANIFEST = FARM_DOCS_LAST_MODIFIED_MANIFEST; exports.createFarmDocsLastModifiedManifest = createFarmDocsLastModifiedManifest; exports.isFarmDocsRequest = isFarmDocsRequest; exports.resolveFarmDocsContentDir = resolveFarmDocsContentDir; exports.getFarmDocsRouteTypeEntries = getFarmDocsRouteTypeEntries; exports.getFarmDocsDocumentNavigationMatchers = getFarmDocsDocumentNavigationMatchers; exports.loadFarmDocsPage = loadFarmDocsPage; exports.getFarmDocsMarkdownPath = getFarmDocsMarkdownPath; exports.discoverFarmDocsPages = discoverFarmDocsPages; exports.toFarmDocsMarkdownPage = toFarmDocsMarkdownPage; exports.createFarmDocsHandler = createFarmDocsHandler;
+
+exports.FARM_DOCS_LAST_MODIFIED_MANIFEST = FARM_DOCS_LAST_MODIFIED_MANIFEST; exports.createFarmDocsLastModifiedManifest = createFarmDocsLastModifiedManifest; exports.isFarmDocsRequest = isFarmDocsRequest; exports.resolveFarmDocsContentDir = resolveFarmDocsContentDir; exports.getFarmDocsRoots = getFarmDocsRoots; exports.getFarmDocsRouteTypeEntries = getFarmDocsRouteTypeEntries; exports.getFarmDocsDocumentNavigationMatchers = getFarmDocsDocumentNavigationMatchers; exports.loadFarmDocsPage = loadFarmDocsPage; exports.getFarmDocsMarkdownPath = getFarmDocsMarkdownPath; exports.discoverFarmDocsPages = discoverFarmDocsPages; exports.toFarmDocsMarkdownPage = toFarmDocsMarkdownPage; exports.createFarmDocsHandler = createFarmDocsHandler;

package/dist/{chunk-DGOLAZLV.cjs → chunk-65Y5SIBH.cjs}

@@ -15,7 +15,7 @@ function farmDesktopDevGuardPlugin(basePath) {
       order: "pre",
       async handler(server) {
         if (_chunkAQLHD6HZcjs.resolveFarmPlatform.call(void 0, ) !== "desktop") return;
-        const { createFarmDesktopDevGuard } = await import("./dev-guard-YLO5DE3H.cjs");
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-2UW2KERP.cjs");
         server.middlewares.use(createFarmDesktopDevGuard(server, { basePath: basePath || "" }));
       }
     }

package/dist/{chunk-QI5AQMEE.mjs → chunk-72NBDVWQ.mjs}

@@ -40,7 +40,7 @@ import {
 } from "./chunk-Y3N5BFRJ.mjs";
 import {
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   createFarmRequestBodyErrorResponse,
   readNodeRequestBody,

package/dist/{chunk-X5BCMLGP.cjs → chunk-AGR7VJH2.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.51-beta.0";
+var version = "0.1.51-beta.1";
 
 // src/version.ts
 var FARM_VERSION = version;

package/dist/{chunk-OD6WM3I7.mjs → chunk-AV26KHTG.mjs}

@@ -29,7 +29,7 @@ import {
 } from "./chunk-F3N52U7S.mjs";
 import {
   getIntegrationSchemas
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 
 // src/schema-dependencies.ts
 function collectSchemaDependencies(owners) {