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

package/dist/{chunk-4T25YCZ5.cjs → chunk-JVBNKWLV.cjs}

@@ -4,14 +4,15 @@
 
 
 
-var _chunkX2EL3BLHcjs = require('./chunk-X2EL3BLH.cjs');
+
+var _chunk5N7QAGEAcjs = require('./chunk-5N7QAGEA.cjs');
 
 
 
 var _chunkV3UOEWCBcjs = require('./chunk-V3UOEWCB.cjs');
 
 
-var _chunkLYWAGXXWcjs = require('./chunk-LYWAGXXW.cjs');
+var _chunkVITZRYW3cjs = require('./chunk-VITZRYW3.cjs');
 
 
 
@@ -26,7 +27,7 @@ function hasFarmDocsRuntimeAdapter(docs) {
 }
 function assertFarmDocsAdapterServesNoGuardedPages(docs, options, isPathGuarded) {
   if (!isPathGuarded || !hasFarmDocsRuntimeAdapter(docs)) return;
-  const guarded = _chunkX2EL3BLHcjs.discoverFarmDocsPages.call(void 0, _chunkX2EL3BLHcjs.resolveFarmDocsContentDir.call(void 0, docs, options), docs).filter((page) => isPathGuarded(page.href) || isPathGuarded(_chunkX2EL3BLHcjs.getFarmDocsMarkdownPath.call(void 0, page.href))).map((page) => page.href);
+  const guarded = _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, docs).flatMap((root) => _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, root, options), root)).filter((page) => isPathGuarded(page.href) || isPathGuarded(_chunk5N7QAGEAcjs.getFarmDocsMarkdownPath.call(void 0, page.href))).map((page) => page.href);
   if (guarded.length === 0) return;
   throw new Error(
     `Docs pages behind a path guard (${guarded.join(", ")}) would be public: the docs adapter ${JSON.stringify(docs.adapter.id)} serves their content in llms-full.txt, search, Markdown, and MCP without running the app's guards. Move those pages out of the docs content directory, or set docs.adapter = false to use Farm's built-in docs runtime, which keeps guarded pages off anonymous surfaces.`
@@ -39,12 +40,20 @@ async function loadFarmDocsConfigModule(docs, loadModule) {
   const config = _nullishCoalesce(_optionalChain([loaded, 'optionalAccess', _4 => _4.default]), () => ( loaded));
   return config && typeof config === "object" ? config : void 0;
 }
+function getFarmDocsConfigModuleRoot(moduleConfig, entry) {
+  const { roots, ...shared } = moduleConfig;
+  const route = entry.replace(/^\/+|\/+$/g, "");
+  const own = Array.isArray(roots) ? roots.find(
+    (root) => Boolean(root) && typeof root === "object" && typeof root.entry === "string" && root.entry.replace(/^\/+|\/+$/g, "") === route
+  ) : void 0;
+  return own ? { ...shared, ...own } : shared;
+}
 function createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig) {
   return {
-    ...moduleConfig ? { ...moduleConfig, ...docs.configOverrides } : _nullishCoalesce(docs.runtimeConfig, () => ( docs.config)),
+    ...moduleConfig ? { ...getFarmDocsConfigModuleRoot(moduleConfig, docs.entry), ...docs.configOverrides } : _nullishCoalesce(docs.runtimeConfig, () => ( docs.config)),
     entry: docs.config.entry || docs.entry.replace(/^\/+|\/+$/g, "") || "docs",
     docsPath: docs.entry,
-    contentDir: _chunkX2EL3BLHcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
+    contentDir: _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, docs, options)
   };
 }
 function getFarmDocsAdapterStylesheets(options) {
@@ -56,6 +65,11 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
   }
+  if (_optionalChain([docs, 'access', _5 => _5.roots, 'optionalAccess', _6 => _6.length])) {
+    throw new Error(
+      "Several docs roots are not supported on edge deployments yet; they need a Node.js deployment target."
+    );
+  }
   const compilerEntry = docs.adapter.edgeCompiler;
   if (!compilerEntry) {
     throw new Error(
@@ -96,6 +110,27 @@ async function compileFarmDocsAdapterEdgeManifest(docs, options) {
   }
   return manifest;
 }
+async function listFarmDocsAdapterPages(docs, options) {
+  if (!hasFarmDocsRuntimeAdapter(docs)) return null;
+  const requireFromApp = _module.createRequire.call(void 0, _path2.default.join(options.root, "package.json"));
+  const serverModule = await import(
+    /* @vite-ignore */
+    _url.pathToFileURL.call(void 0, requireFromApp.resolve(docs.adapter.server)).href
+  );
+  if (typeof serverModule.listFarmDocsPages !== "function") return null;
+  const listPages = serverModule.listFarmDocsPages;
+  const pages = (await Promise.all(
+    _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, docs).map(
+      (root) => listPages(createFarmDocsAdapterRuntimeConfig(root, options), { rootDir: options.root })
+    )
+  )).flat();
+  if (!Array.isArray(pages) || pages.some((page) => typeof page !== "string" || !page.startsWith("/"))) {
+    throw new Error(
+      `Farm docs adapter ${JSON.stringify(docs.adapter.id)} listed docs pages that are not absolute paths.`
+    );
+  }
+  return [...new Set(pages)];
+}
 async function createFarmDocsAdapterHandler(docs, options) {
   if (!hasFarmDocsRuntimeAdapter(docs)) {
     throw new Error("Farm docs adapter requires server and react runtime entrypoints.");
@@ -104,26 +139,36 @@ async function createFarmDocsAdapterHandler(docs, options) {
   const serverModule = await options.loadModule(
     docs.adapter.server
   );
-  if (typeof serverModule.createFarmDocsRuntimeHandler !== "function") {
+  const multiRoot = Boolean(_optionalChain([docs, 'access', _7 => _7.roots, 'optionalAccess', _8 => _8.length]));
+  const handlerExport = multiRoot ? "createFarmDocsMultiRuntimeHandler" : "createFarmDocsRuntimeHandler";
+  if (typeof serverModule[handlerExport] !== "function") {
     const adapterId = JSON.stringify(docs.adapter.id);
     const serverEntry = JSON.stringify(docs.adapter.server);
     throw new Error(
-      `Farm docs adapter ${adapterId} does not export createFarmDocsRuntimeHandler from ${serverEntry}. Upgrade the adapter to a runtime-enabled release.`
+      `Farm docs adapter ${adapterId} does not export ${handlerExport} from ${serverEntry}. ` + (multiRoot ? "Upgrade the adapter to a release that serves several docs roots, or remove the roots." : "Upgrade the adapter to a runtime-enabled release.")
     );
   }
-  const runtimeConfig = createFarmDocsAdapterRuntimeConfig(
-    docs,
-    options,
-    await loadFarmDocsConfigModule(docs, options.loadModule)
-  );
-  return serverModule.createFarmDocsRuntimeHandler(runtimeConfig, {
+  const moduleConfig = await loadFarmDocsConfigModule(docs, options.loadModule);
+  const handlerOptions = {
     rootDir: options.root,
     clientEntry: options.clientEntry,
     stylesheets: getFarmDocsAdapterStylesheets(options),
     resolveLayoutFonts: options.resolveLayoutFonts,
     loadReactModule: () => options.loadModule(docs.adapter.react),
     ...options.registerMCPServer ? { registerMCPServer: options.registerMCPServer } : {}
-  });
+  };
+  if (multiRoot) {
+    return serverModule.createFarmDocsMultiRuntimeHandler(
+      _chunk5N7QAGEAcjs.getFarmDocsRoots.call(void 0, docs).map(
+        (root) => createFarmDocsAdapterRuntimeConfig(root, options, moduleConfig)
+      ),
+      handlerOptions
+    );
+  }
+  return serverModule.createFarmDocsRuntimeHandler(
+    createFarmDocsAdapterRuntimeConfig(docs, options, moduleConfig),
+    handlerOptions
+  );
 }
 
 // src/docs/api.ts
@@ -158,7 +203,7 @@ function omitHeadBody(response) {
   });
 }
 function normalizeAction(value) {
-  return _optionalChain([value, 'optionalAccess', _5 => _5.trim, 'call', _6 => _6(), 'access', _7 => _7.toLowerCase, 'call', _8 => _8(), 'access', _9 => _9.replace, 'call', _10 => _10(/_/g, "-")]) || void 0;
+  return _optionalChain([value, 'optionalAccess', _9 => _9.trim, 'call', _10 => _10(), 'access', _11 => _11.toLowerCase, 'call', _12 => _12(), 'access', _13 => _13.replace, 'call', _14 => _14(/_/g, "-")]) || void 0;
 }
 function getDocsTitle(docs) {
   return typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Documentation") : "Documentation";
@@ -257,25 +302,25 @@ function getDocsAPIFormat(request) {
   return normalizeAction(url.searchParams.get("format") || url.searchParams.get("type")) || getDocsAPIPathTarget(request).format;
 }
 function getDocsDescription(docs) {
-  return _optionalChain([docs, 'access', _11 => _11.config, 'access', _12 => _12.metadata, 'optionalAccess', _13 => _13.description]);
+  return _optionalChain([docs, 'access', _15 => _15.config, 'access', _16 => _16.metadata, 'optionalAccess', _17 => _17.description]);
 }
 function getLoadedDocsPages(context) {
-  return _chunkX2EL3BLHcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter((page) => !context.isPathGuarded(page.href)).map((page) => _chunkX2EL3BLHcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
+  return _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter((page) => !context.isPathGuarded(page.href)).map((page) => _chunk5N7QAGEAcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, page.slug)).filter((page) => Boolean(page));
 }
 function toDocsSourcePage(page) {
   return {
-    ..._chunkX2EL3BLHcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 function toDocsSitemapPage(page) {
   return {
-    ..._chunkX2EL3BLHcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 function toDocsLlmsPage(page) {
-  return _chunkX2EL3BLHcjs.toFarmDocsMarkdownPage.call(void 0, page);
+  return _chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page);
 }
 function getDocsLlmsOptions(context, request) {
   const configured = isRecord(context.docs.config.llmsTxt) ? context.docs.config.llmsTxt : {};
@@ -362,7 +407,7 @@ function renderAgentsDocument(context, request) {
 function buildAgentSpec(context, request) {
   const url = new URL(request.url);
   const origin = url.origin;
-  const pages = _chunkX2EL3BLHcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter(
+  const pages = _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter(
     (page) => !context.isPathGuarded(page.href)
   );
   const spec = _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).buildDocsAgentDiscoverySpec(getDocsDiscoveryOptions(context, request));
@@ -450,7 +495,7 @@ function buildPublicConfig(context) {
   };
 }
 function buildDiagnostics(context) {
-  const pages = _chunkX2EL3BLHcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
+  const pages = _chunk5N7QAGEAcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs);
   const diagnostics = _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).buildDocsDiagnostics(context.docs.config, {
     entry: context.docs.entry,
     mcp: {
@@ -500,19 +545,19 @@ async function searchDocs(context, request, query) {
     const page = sourcePageByUrl.get(pageUrl);
     return {
       ...result,
-      title: _optionalChain([page, 'optionalAccess', _14 => _14.title]) || result.content,
-      href: _optionalChain([page, 'optionalAccess', _15 => _15.url]) || pageUrl,
-      description: result.description || _optionalChain([page, 'optionalAccess', _16 => _16.description])
+      title: _optionalChain([page, 'optionalAccess', _18 => _18.title]) || result.content,
+      href: _optionalChain([page, 'optionalAccess', _19 => _19.url]) || pageUrl,
+      description: result.description || _optionalChain([page, 'optionalAccess', _20 => _20.description])
     };
   });
 }
 async function resolveAPIContext(options) {
   await _chunkV3UOEWCBcjs.loadFarmDocsEngine.call(void 0, );
   const runtimeConfig = globalThis.__FARM_DOCS_RUNTIME_CONFIG__;
-  const root = options.rootDir || options.root || _optionalChain([runtimeConfig, 'optionalAccess', _17 => _17.root]) || process.cwd();
-  const srcDir = options.srcDir || _optionalChain([runtimeConfig, 'optionalAccess', _18 => _18.srcDir]) || "src";
+  const root = options.rootDir || options.root || _optionalChain([runtimeConfig, 'optionalAccess', _21 => _21.root]) || process.cwd();
+  const srcDir = options.srcDir || _optionalChain([runtimeConfig, 'optionalAccess', _22 => _22.srcDir]) || "src";
   const canUseRuntimeDocs = options.docs === void 0 && options.config === void 0 && options.configPath === void 0 && options.entry === void 0 && options.docsPath === void 0 && options.contentDir === void 0 && options.root === void 0 && options.rootDir === void 0 && options.srcDir === void 0;
-  const docsInput = _nullishCoalesce(_nullishCoalesce(options.docs, () => ( (canUseRuntimeDocs ? _optionalChain([runtimeConfig, 'optionalAccess', _19 => _19.docs]) : void 0))), () => ( {
+  const docsInput = _nullishCoalesce(_nullishCoalesce(options.docs, () => ( (canUseRuntimeDocs ? _optionalChain([runtimeConfig, 'optionalAccess', _23 => _23.docs]) : void 0))), () => ( {
     enabled: true,
     entry: options.entry,
     docsPath: options.docsPath,
@@ -520,13 +565,13 @@ async function resolveAPIContext(options) {
     config: options.config,
     configPath: options.configPath
   }));
-  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkLYWAGXXWcjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
-  const guardedPaths = new Set(_nullishCoalesce(_optionalChain([runtimeConfig, 'optionalAccess', _20 => _20.guardedPaths]), () => ( [])));
+  const docs = isResolvedDocsConfig(docsInput) ? docsInput : await _chunkVITZRYW3cjs.resolveDocsConfig.call(void 0, docsInput, { root, srcDir });
+  const guardedPaths = new Set(_nullishCoalesce(_optionalChain([runtimeConfig, 'optionalAccess', _24 => _24.guardedPaths]), () => ( [])));
   return {
     root,
     srcDir,
     docs,
-    contentDir: _chunkX2EL3BLHcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir }),
+    contentDir: _chunk5N7QAGEAcjs.resolveFarmDocsContentDir.call(void 0, docs, { root, srcDir }),
     diagnostics: options.diagnostics === true,
     isPathGuarded: _nullishCoalesce(options.isPathGuarded, () => ( ((pathname) => guardedPaths.has(pathname))))
   };
@@ -585,12 +630,12 @@ async function handleDocsAPIGet(request, context) {
   if (format === "markdown" || url.pathname.endsWith(".md")) {
     const pathParam = url.searchParams.get("path") || url.searchParams.get("slug");
     const slug = normalizeDocsApiSlug(_nullishCoalesce(_nullishCoalesce(pathParam, () => ( pathTarget.slug)), () => ( "")), context.docs);
-    const page = _chunkX2EL3BLHcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
+    const page = _chunk5N7QAGEAcjs.loadFarmDocsPage.call(void 0, context.contentDir, context.docs, slug);
     if (!page || context.isPathGuarded(page.href)) {
       return text("Docs page not found\n", "text/plain; charset=utf-8", { status: 404 });
     }
     return text(
-      _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunkX2EL3BLHcjs.toFarmDocsMarkdownPage.call(void 0, page), {
+      _chunkV3UOEWCBcjs.docsEngine.call(void 0, ).renderDocsMarkdownDocument(_chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page), {
         origin: new URL(request.url).origin,
         llms: getDocsLlmsOptions(context, request),
         sitemap: context.docs.config.sitemap
@@ -663,4 +708,6 @@ function createFarmDocsAPIHandler(options = {}, cloudIntegration) {
 
 
 
-exports.hasFarmDocsRuntimeAdapter = hasFarmDocsRuntimeAdapter; exports.assertFarmDocsAdapterServesNoGuardedPages = assertFarmDocsAdapterServesNoGuardedPages; exports.compileFarmDocsAdapterEdgeManifest = compileFarmDocsAdapterEdgeManifest; exports.createFarmDocsAdapterHandler = createFarmDocsAdapterHandler; exports.isFarmDocsAPIRequest = isFarmDocsAPIRequest; exports.createDocsAPI = createDocsAPI; exports.createFarmDocsAPIHandler = createFarmDocsAPIHandler;
+
+
+exports.hasFarmDocsRuntimeAdapter = hasFarmDocsRuntimeAdapter; exports.assertFarmDocsAdapterServesNoGuardedPages = assertFarmDocsAdapterServesNoGuardedPages; exports.getFarmDocsConfigModuleRoot = getFarmDocsConfigModuleRoot; exports.compileFarmDocsAdapterEdgeManifest = compileFarmDocsAdapterEdgeManifest; exports.listFarmDocsAdapterPages = listFarmDocsAdapterPages; exports.createFarmDocsAdapterHandler = createFarmDocsAdapterHandler; exports.isFarmDocsAPIRequest = isFarmDocsAPIRequest; exports.createDocsAPI = createDocsAPI; exports.createFarmDocsAPIHandler = createFarmDocsAPIHandler;

package/dist/{chunk-VOZ5DI7D.mjs → chunk-JWI5PUO2.mjs}

@@ -1086,16 +1086,20 @@ import { forwardRef, useEffect, useRef as useRef3, useCallback as useCallback3 }
 // src/provider.tsx
 import { createContext, useContext } from "react";
 import { jsx } from "react/jsx-runtime";
-var FarmContext = createContext(null);
+var farmContext;
+function getFarmContext() {
+  return farmContext ?? (farmContext = createContext(null));
+}
 function FarmProvider({ children, config }) {
   const value = {
     config,
     basePath: normalizeFarmBasePath(config.basePath)
   };
+  const FarmContext = getFarmContext();
   return /* @__PURE__ */ jsx(FarmContext.Provider, { value, children });
 }
 function useOptionalFarm() {
-  return useContext(FarmContext);
+  return useContext(getFarmContext());
 }
 
 // src/client/link.tsx

package/dist/{chunk-YAXOEAND.cjs → chunk-KHXAJ2KA.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkJZMZKABScjs = require('./chunk-JZMZKABS.cjs');
+var _chunkNWUHS6GVcjs = require('./chunk-NWUHS6GV.cjs');
 
 
 var _chunkSBDWCDS6cjs = require('./chunk-SBDWCDS6.cjs');
@@ -36,7 +36,7 @@ var _chunkSNP33A33cjs = require('./chunk-SNP33A33.cjs');
 var _chunkJYNNIGQOcjs = require('./chunk-JYNNIGQO.cjs');
 
 
-var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 
 
 
@@ -111,9 +111,9 @@ var APIRouteManager = class {
       throw error;
     }
     if (process.env.FARM_VERBOSE) {
-      _chunkXN2MB4QZcjs.logger.success(`Discovered ${this.routes.size} API routes`);
+      _chunkVQJYGZNXcjs.logger.success(`Discovered ${this.routes.size} API routes`);
       for (const [routePath, route] of this.routes) {
-        _chunkXN2MB4QZcjs.logger.info(`  ${route.methods.join(", ")} ${routePath}`);
+        _chunkVQJYGZNXcjs.logger.info(`  ${route.methods.join(", ")} ${routePath}`);
       }
     }
   }
@@ -217,7 +217,7 @@ var APIRouteManager = class {
   async loadProgrammaticApiRoutes(appDir) {
     const candidateRoots = [path.dirname(appDir), appDir];
     const routeFiles = Array.from(
-      new Set(candidateRoots.flatMap((srcRoot) => _chunkJZMZKABScjs.findProgrammaticRouteFilesInDir.call(void 0, srcRoot)))
+      new Set(candidateRoots.flatMap((srcRoot) => _chunkNWUHS6GVcjs.findProgrammaticRouteFilesInDir.call(void 0, srcRoot)))
     );
     if (routeFiles.length === 0) return;
     const { getProgrammaticRouteManifest } = await import("./routes.cjs");
@@ -238,7 +238,7 @@ var APIRouteManager = class {
   }
   handleLoadError(message, loadError) {
     const error = _chunkKORZ6PREcjs.explainMissingOptionalPeer.call(void 0, loadError, message.replace(/^Error loading /, ""));
-    _chunkXN2MB4QZcjs.logger.error(`${message}: ${error}`);
+    _chunkVQJYGZNXcjs.logger.error(`${message}: ${error}`);
     if (this.throwOnLoadError || error instanceof APIRouteConflictError || error instanceof _chunkYTVSWXEZcjs.AmbiguousRouteError || error instanceof _chunkYTVSWXEZcjs.NonTerminalCatchAllRouteError) {
       throw error;
     }

package/dist/{chunk-2DEPNLXK.mjs → chunk-KMB5BMFX.mjs}

@@ -56,13 +56,13 @@ import {
 } from "./chunk-VFXE6NWR.mjs";
 import {
   resolveWorkflowsConfig
-} from "./chunk-5V4KZOZO.mjs";
+} from "./chunk-LZ4SB57H.mjs";
 import {
   resolveCronConfig
-} from "./chunk-UCQ52TJY.mjs";
+} from "./chunk-X3JNB2TB.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-BW6SCVYX.mjs";
+} from "./chunk-FSQMN2MQ.mjs";
 import {
   resolveFarmThemeConfig
 } from "./chunk-YWPNIYUP.mjs";
@@ -71,7 +71,7 @@ import {
 } from "./chunk-N77JBPLC.mjs";
 import {
   resolveIntegrationPlugins
-} from "./chunk-HHFMECFO.mjs";
+} from "./chunk-Y2G5SJFB.mjs";
 import {
   compileMiddlewareConfig
 } from "./chunk-EDPENAVO.mjs";
@@ -80,7 +80,7 @@ import {
 } from "./chunk-MU5V7XHL.mjs";
 import {
   logger
-} from "./chunk-2SVJGOAX.mjs";
+} from "./chunk-Y3N5BFRJ.mjs";
 import {
   resolveFarmServerConfig
 } from "./chunk-GFT5AHAT.mjs";
@@ -565,29 +565,35 @@ async function resolveDocsConfig(userDocs, options = {}) {
       config: { entry: "docs", docsPath: "/docs" }
     };
   }
-  const inlineDocsConfig = sanitizeDocsConfig(docsOptions.config || {});
+  const fileDocsConfig = omitDocsRoots(loadedConfig?.config);
+  const inlineRawDocsConfig = omitDocsRoots(docsOptions.config);
+  const inlineDocsConfig = sanitizeDocsConfig(inlineRawDocsConfig);
   const directDocsConfig = sanitizeDocsConfig({
     ...docsOptions,
     adapter: void 0,
     enabled: void 0,
+    prerender: void 0,
     config: void 0,
-    configPath: void 0
+    configPath: void 0,
+    roots: void 0
   });
-  const loadedDocsConfig = sanitizeDocsConfig(loadedConfig?.config || {});
+  const loadedDocsConfig = sanitizeDocsConfig(fileDocsConfig);
   const mergedDocsConfig = {
     ...loadedDocsConfig,
     ...inlineDocsConfig,
     ...directDocsConfig
   };
   const runtimeDocsConfig = {
-    ...loadedConfig?.config || {},
-    ...isRecord(docsOptions.config) ? docsOptions.config : {},
+    ...fileDocsConfig,
+    ...inlineRawDocsConfig,
     ...omitUndefined({
       ...docsOptions,
       adapter: void 0,
       enabled: void 0,
+      prerender: void 0,
       config: void 0,
-      configPath: void 0
+      configPath: void 0,
+      roots: void 0
     })
   };
   const explicitRoute = typeof docsOptions.entry === "string" ? docsOptions.entry : void 0;
@@ -601,10 +607,33 @@ async function resolveDocsConfig(userDocs, options = {}) {
     docsOptions.contentDir || mergedDocsConfig.contentDir
   );
   const contentDir = configuredContentDir || await inferDocsContentDir(root, options.srcDir || "src", docsEntry);
+  const configOverrides = { ...inlineDocsConfig, ...directDocsConfig };
+  const configFileName = loadedConfig ? path3.relative(root, loadedConfig.configPath) || loadedConfig.configPath : "the docs config";
+  const roots = await resolveDocsRoots(
+    [
+      { field: `roots in ${configFileName}`, roots: docsRootsOf(loadedConfig?.config), file: true },
+      { field: "docs.config.roots", roots: docsRootsOf(docsOptions.config) },
+      { field: "docs.roots", roots: docsOptions.roots }
+    ],
+    {
+      root,
+      srcDir: options.srcDir || "src",
+      mainEntry: entryRoute,
+      mergedDocsConfig,
+      runtimeDocsConfig,
+      configOverrides
+    }
+  );
+  if (roots.length > 0 && !(docsOptions.adapter && docsOptions.adapter.server && docsOptions.adapter.react)) {
+    throw new Error(
+      `Docs roots require a docs adapter such as @farming-labs/farmjs; Farm's built-in docs renderer serves a single docs root. Install the adapter, or remove the roots from ${configFileName} and docs.roots.`
+    );
+  }
   return {
     enabled: true,
     entry: entryRoute,
     ...docsOptions.adapter ? { adapter: docsOptions.adapter } : {},
+    ...docsOptions.prerender === true ? { prerender: true } : {},
     contentDir,
     configPath: loadedConfig?.configPath,
     config: {
@@ -619,9 +648,90 @@ async function resolveDocsConfig(userDocs, options = {}) {
       docsPath: entryRoute,
       ...contentDir ? { contentDir } : {}
     },
-    configOverrides: { ...inlineDocsConfig, ...directDocsConfig }
+    configOverrides,
+    ...roots.length > 0 ? { roots } : {}
   };
 }
+function docsRootsOf(config) {
+  return isRecord(config) ? config.roots : void 0;
+}
+function omitDocsRoots(config) {
+  if (!isRecord(config)) return {};
+  const { roots: _roots, ...rest } = config;
+  return rest;
+}
+function omitKeys(value, keys) {
+  const output = { ...value };
+  for (const key of keys) delete output[key];
+  return output;
+}
+async function resolveDocsRoots(sources, options) {
+  const declared = /* @__PURE__ */ new Map();
+  for (const source of sources) {
+    if (source.roots === void 0) continue;
+    if (!Array.isArray(source.roots)) throw new Error(`${source.field} must be an array.`);
+    const seen = /* @__PURE__ */ new Set();
+    for (const [index, rootInput] of source.roots.entries()) {
+      const field = `${source.field}[${index}].entry`;
+      if (!isRecord(rootInput) || typeof rootInput.entry !== "string" || !rootInput.entry.trim()) {
+        throw new Error(`${field} must be a route such as "/guides/docs".`);
+      }
+      const entryRoute = normalizeDocsRoute(rootInput.entry);
+      if (entryRoute === "/") {
+        throw new Error(
+          `${field} cannot be "/"; a docs root at "/" leaves no route for the others.`
+        );
+      }
+      if (entryRoute === options.mainEntry || seen.has(entryRoute)) {
+        throw new Error(
+          `${field} ${JSON.stringify(entryRoute)} is already served by another docs root.`
+        );
+      }
+      seen.add(entryRoute);
+      const { entry: _entry, ...fields } = rootInput;
+      const layers = declared.get(entryRoute) ?? { file: {}, overrides: {} };
+      if (source.file) layers.file = fields;
+      else layers.overrides = { ...layers.overrides, ...fields };
+      declared.set(entryRoute, layers);
+    }
+  }
+  const roots = [];
+  for (const [entryRoute, { file, overrides }] of declared) {
+    const docsEntry = docsRouteToEntry(entryRoute);
+    const contentDir = normalizeDocsContentDir(
+      typeof overrides.contentDir === "string" && overrides.contentDir || typeof file.contentDir === "string" && file.contentDir || void 0
+    ) || await inferDocsContentDir(options.root, options.srcDir, docsEntry);
+    const routeConfig = {
+      entry: docsEntry,
+      docsPath: entryRoute,
+      contentDir
+    };
+    const rootOverrides = sanitizeDocsConfig(overrides);
+    roots.push({
+      entry: entryRoute,
+      contentDir,
+      config: omitUndefined({
+        ...options.mergedDocsConfig,
+        ...sanitizeDocsConfig(file),
+        ...rootOverrides,
+        ...routeConfig
+      }),
+      runtimeConfig: omitUndefined({
+        ...options.runtimeDocsConfig,
+        ...file,
+        ...overrides,
+        ...routeConfig
+      }),
+      // The adapter reads the config file's own root from the config module, so the main
+      // root's overrides leave out whatever that root sets itself.
+      configOverrides: {
+        ...omitKeys(options.configOverrides, Object.keys(file)),
+        ...rootOverrides
+      }
+    });
+  }
+  return roots;
+}
 function validateRedirectConfigs(redirects, field) {
   for (const [index, redirect] of redirects.entries()) {
     validateConfigRouteSource(redirect.source, `${field}[${index}].source`);

package/dist/{chunk-M7LKA632.mjs → chunk-KU7MBLDZ.mjs}

@@ -1,6 +1,6 @@
 import {
   getFarmRouteLabel
-} from "./chunk-JJOWY3XD.mjs";
+} from "./chunk-QAIAFCRZ.mjs";
 import {
   classifyFarmAgent
 } from "./chunk-N77JBPLC.mjs";

package/dist/{chunk-WXHDVXJE.mjs → chunk-KY32FWK7.mjs}

@@ -1,6 +1,6 @@
 import {
   findProgrammaticRouteFilesInDir
-} from "./chunk-2H3FJYY6.mjs";
+} from "./chunk-FSXSQQTV.mjs";
 import {
   isFarmAPIRouteFileName
 } from "./chunk-YX6AFPXC.mjs";
@@ -36,7 +36,7 @@ import {
 } from "./chunk-TUOO6IK3.mjs";
 import {
   logger
-} from "./chunk-2SVJGOAX.mjs";
+} from "./chunk-Y3N5BFRJ.mjs";
 import {
   AmbiguousRouteError,
   NonTerminalCatchAllRouteError

package/dist/{chunk-EQWWOQTK.cjs → chunk-LEIXUFJN.cjs}

@@ -1086,16 +1086,20 @@ function createStore(initialState, extend) {
 // src/provider.tsx
 
 var _jsxruntime = require('react/jsx-runtime');
-var FarmContext = _react.createContext.call(void 0, null);
+var farmContext;
+function getFarmContext() {
+  return _nullishCoalesce(farmContext, () => ( (farmContext = _react.createContext.call(void 0, null))));
+}
 function FarmProvider({ children, config }) {
   const value = {
     config,
     basePath: _chunkD22BUQKWcjs.normalizeFarmBasePath.call(void 0, config.basePath)
   };
+  const FarmContext = getFarmContext();
   return /* @__PURE__ */ _jsxruntime.jsx.call(void 0, FarmContext.Provider, { value, children });
 }
 function useOptionalFarm() {
-  return _react.useContext.call(void 0, FarmContext);
+  return _react.useContext.call(void 0, getFarmContext());
 }
 
 // src/client/link.tsx

package/dist/{chunk-2GLQSIZD.mjs → chunk-LMFJCXDD.mjs}

@@ -1,6 +1,6 @@
 import {
   logger
-} from "./chunk-2SVJGOAX.mjs";
+} from "./chunk-Y3N5BFRJ.mjs";
 
 // src/server/dev-loopback.ts
 import net from "net";

package/dist/{chunk-IXSMFKZ2.cjs → chunk-LNM57D3H.cjs}

@@ -4,7 +4,7 @@
 var _chunkKORZ6PREcjs = require('./chunk-KORZ6PRE.cjs');
 
 
-var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 
 // src/build/tailwind.ts
 var _path = require('path'); var _path2 = _interopRequireDefault(_path);
@@ -63,11 +63,11 @@ async function loadTailwindVitePlugin(options = {}, importTailwind = () => impor
   try {
     const tailwindVite = (await importTailwind()).default;
     const plugin = options.builder ? adaptTailwindVitePlugin(tailwindVite(), options.builder) : tailwindVite();
-    if (options.announce) _chunkXN2MB4QZcjs.logger.info("\u{1F4E6} Enabled built-in Tailwind support (@tailwindcss/vite)");
+    if (options.announce) _chunkVQJYGZNXcjs.logger.info("\u{1F4E6} Enabled built-in Tailwind support (@tailwindcss/vite)");
     return plugin;
   } catch (error) {
     if (_chunkKORZ6PREcjs.isMissingPackageError.call(void 0, error, "@tailwindcss/vite")) return createMissingTailwindPlugin();
-    _chunkXN2MB4QZcjs.logger.warn(
+    _chunkVQJYGZNXcjs.logger.warn(
       `Tailwind plugin auto-enable failed${options.label ? ` ${options.label}` : ""}; continuing without it: ${error.message}`
     );
     return void 0;
@@ -87,7 +87,7 @@ function createMissingTailwindPlugin() {
       }
       warnedMissingTailwind = true;
       const file = _path2.default.relative(root, id.split("?", 1)[0]).replace(/\\/g, "/");
-      _chunkXN2MB4QZcjs.logger.warn(
+      _chunkVQJYGZNXcjs.logger.warn(
         `${file} imports Tailwind CSS, but @tailwindcss/vite is not installed; continuing without Tailwind. ${TAILWIND_VITE_INSTALL_HINT}`
       );
       return null;

package/dist/{chunk-5V4KZOZO.mjs → chunk-LZ4SB57H.mjs}

@@ -7,10 +7,10 @@ import {
 } from "./chunk-YP7YO3S3.mjs";
 import {
   toPosixPath
-} from "./chunk-2SVJGOAX.mjs";
+} from "./chunk-Y3N5BFRJ.mjs";
 import {
   searchParamsToObject
-} from "./chunk-TXK4D46O.mjs";
+} from "./chunk-H3ASZDT7.mjs";
 import {
   createFarmRequestBodyErrorResponse,
   readFarmRequestBody,

package/dist/chunk-N4AQNEXR.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});// src/client-revalidation.ts
+function attachRevalidationListeners(refresh, options = {}) {
+  if (typeof window === "undefined") return () => {
+  };
+  const onFocus = options.refetchOnWindowFocus === false ? void 0 : refresh;
+  const onOnline = options.refetchOnReconnect === false ? void 0 : refresh;
+  if (onFocus) window.addEventListener("focus", onFocus);
+  if (onOnline) window.addEventListener("online", onOnline);
+  return () => {
+    if (onFocus) window.removeEventListener("focus", onFocus);
+    if (onOnline) window.removeEventListener("online", onOnline);
+  };
+}
+
+
+
+exports.attachRevalidationListeners = attachRevalidationListeners;