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

package/dist/{chunk-VIFPE5RG.cjs → chunk-JVBNKWLV.cjs}

@@ -4,14 +4,15 @@
 
 
 
-var _chunkIOUOGRDXcjs = require('./chunk-IOUOGRDX.cjs');
+
+var _chunk5N7QAGEAcjs = require('./chunk-5N7QAGEA.cjs');
 
 
 
 var _chunkV3UOEWCBcjs = require('./chunk-V3UOEWCB.cjs');
 
 
-var _chunkO3MMJPC2cjs = require('./chunk-O3MMJPC2.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 = _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, _chunkIOUOGRDXcjs.resolveFarmDocsContentDir.call(void 0, docs, options), docs).filter((page) => isPathGuarded(page.href) || isPathGuarded(_chunkIOUOGRDXcjs.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: _chunkIOUOGRDXcjs.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 _chunkIOUOGRDXcjs.discoverFarmDocsPages.call(void 0, context.contentDir, context.docs).filter((page) => !context.isPathGuarded(page.href)).map((page) => _chunkIOUOGRDXcjs.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 {
-    ..._chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 function toDocsSitemapPage(page) {
   return {
-    ..._chunkIOUOGRDXcjs.toFarmDocsMarkdownPage.call(void 0, page),
+    ..._chunk5N7QAGEAcjs.toFarmDocsMarkdownPage.call(void 0, page),
     sourcePath: page.sourcePath
   };
 }
 function toDocsLlmsPage(page) {
-  return _chunkIOUOGRDXcjs.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 = _chunkIOUOGRDXcjs.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 = _chunkIOUOGRDXcjs.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 _chunkO3MMJPC2cjs.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: _chunkIOUOGRDXcjs.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 = _chunkIOUOGRDXcjs.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(_chunkIOUOGRDXcjs.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-JF5CNHHF.mjs → chunk-KMB5BMFX.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";
@@ -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-YLNBWUVS.mjs → chunk-KU7MBLDZ.mjs}

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

package/dist/{chunk-J37KTQIA.cjs → chunk-NK2VWS7P.cjs}

@@ -13,6 +13,51 @@ var _path = require('path'); var _path2 = _interopRequireDefault(_path);
 
 // src/programmatic-routes-client.ts
 var _module = require('module');
+
+// src/browser-builtins.ts
+
+var FARM_BROWSER_BUILTIN_PREFIX = "\0farm:browser-builtin:";
+var BROWSER_IMPLEMENTATIONS = {
+  crypto: {
+    webcrypto: "globalThis.crypto",
+    subtle: "globalThis.crypto?.subtle",
+    getRandomValues: "(array) => globalThis.crypto.getRandomValues(array)",
+    randomUUID: "() => globalThis.crypto.randomUUID()"
+  }
+};
+var BROWSER_EXTERNAL_RE = /^(?:__vite-)?browser-external(?::|$)/;
+var IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/;
+async function resolveFarmBrowserBuiltin(context, source, importer, options) {
+  const resolved = await context.resolve(source, importer, { ...options, skipSelf: true });
+  if (!resolved || !BROWSER_EXTERNAL_RE.test(resolved.id)) return resolved;
+  return FARM_BROWSER_BUILTIN_PREFIX + source.replace(/^node:/, "");
+}
+function loadFarmBrowserBuiltin(id) {
+  if (!id.startsWith(FARM_BROWSER_BUILTIN_PREFIX)) return void 0;
+  const name = id.slice(FARM_BROWSER_BUILTIN_PREFIX.length);
+  const implementations = _nullishCoalesce(BROWSER_IMPLEMENTATIONS[name], () => ( {}));
+  const exports = Object.keys(_nullishCoalesce(process.getBuiltinModule(`node:${name}`), () => ( {}))).filter(
+    (key) => key !== "default" && IDENTIFIER_RE.test(key)
+  );
+  const implemented = exports.filter((key) => key in implementations);
+  return [
+    ...exports.map((key) => `export const ${key} = ${_nullishCoalesce(implementations[key], () => ( "undefined"))};`),
+    `export default { ${implemented.join(", ")} };`
+  ].join("\n");
+}
+function farmBrowserBuiltinsOptimizerPlugin() {
+  return {
+    name: "farm:browser-builtins-optimizer",
+    resolveId(source, importer, options) {
+      return _module.isBuiltin.call(void 0, source) ? resolveFarmBrowserBuiltin(this, source, importer, options) : null;
+    },
+    load(id) {
+      return _nullishCoalesce(loadFarmBrowserBuiltin(id), () => ( null));
+    }
+  };
+}
+
+// src/programmatic-routes-client.ts
 var _url = require('url');
 var SERVER_PROPS_KEYS = ["params", "search", "guard", "data"];
 function programmaticClientRouteKey(routesFile, kind, routePath) {
@@ -258,6 +303,7 @@ function isApplicationModuleId(id) {
   return MODULE_EXTENSION_RE.test(id.split("?", 1)[0]);
 }
 function isNodeBuiltinId(id) {
+  if (id.startsWith(FARM_BROWSER_BUILTIN_PREFIX)) return true;
   const external = id.indexOf("__vite-browser-external:");
   const bare = external === 0 || external === 1 ? id.slice(external + 24) : id;
   return bare.startsWith("node:") || NODE_BUILTINS.has(bare);
@@ -493,11 +539,11 @@ function compareOwners(left, right) {
   if (right.exportName === "default") return 1;
   return left.exportName < right.exportName ? -1 : left.exportName > right.exportName ? 1 : 0;
 }
-var IDENTIFIER_RE = /^[A-Za-z_$][\w$]*$/;
+var IDENTIFIER_RE2 = /^[A-Za-z_$][\w$]*$/;
 function importExport(value, local, toImportSpecifier) {
   const source = JSON.stringify(toImportSpecifier(value.file));
   if (value.exportName === "default") return `import ${local} from ${source};`;
-  const imported = IDENTIFIER_RE.test(value.exportName) ? value.exportName : JSON.stringify(value.exportName);
+  const imported = IDENTIFIER_RE2.test(value.exportName) ? value.exportName : JSON.stringify(value.exportName);
   return `import { ${imported} as ${local} } from ${source};`;
 }
 function toPosixPath(filePath) {
@@ -902,4 +948,7 @@ function transformError(id, message) {
 
 
 
-exports.programmaticClientRouteKey = programmaticClientRouteKey; exports.resolveProgrammaticClientRoutes = resolveProgrammaticClientRoutes; exports.createEvaluatedRouteGraph = createEvaluatedRouteGraph; exports.mergeProgrammaticClientRoutes = mergeProgrammaticClientRoutes; exports.generateProgrammaticClientRouteModule = generateProgrammaticClientRouteModule; exports.transformEnvironmentFunctions = transformEnvironmentFunctions; exports.farmEnvironmentFunctionsPlugin = farmEnvironmentFunctionsPlugin;
+
+
+
+exports.resolveFarmBrowserBuiltin = resolveFarmBrowserBuiltin; exports.loadFarmBrowserBuiltin = loadFarmBrowserBuiltin; exports.farmBrowserBuiltinsOptimizerPlugin = farmBrowserBuiltinsOptimizerPlugin; exports.programmaticClientRouteKey = programmaticClientRouteKey; exports.resolveProgrammaticClientRoutes = resolveProgrammaticClientRoutes; exports.createEvaluatedRouteGraph = createEvaluatedRouteGraph; exports.mergeProgrammaticClientRoutes = mergeProgrammaticClientRoutes; exports.generateProgrammaticClientRouteModule = generateProgrammaticClientRouteModule; exports.transformEnvironmentFunctions = transformEnvironmentFunctions; exports.farmEnvironmentFunctionsPlugin = farmEnvironmentFunctionsPlugin;

package/dist/{chunk-WSY2JD7O.mjs → chunk-NN3MOPSI.mjs}

@@ -33,7 +33,7 @@ import {
 } from "./chunk-2DA7CLY7.mjs";
 import {
   sendWebResponse
-} from "./chunk-IUQLRTTO.mjs";
+} from "./chunk-CO6UYM2D.mjs";
 import {
   createFarmAPIMiddlewarePathnames
 } from "./chunk-LM2YOGDK.mjs";

package/dist/{chunk-R5P4KFPM.mjs → chunk-QAIAFCRZ.mjs}

@@ -23,7 +23,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-ZF3GX4O7.mjs";
+} from "./chunk-EOSFVNXZ.mjs";
 import {
   applyFarmBasePath
 } from "./chunk-SF3JB56B.mjs";
@@ -441,14 +441,16 @@ function resolveFarmDocsRouteLabel(routePathname, docs) {
   const apiPath = normalize(docs.apiPath ?? "/api/docs");
   if (pathname === apiPath) return apiPath;
   if (pathname.startsWith(`${apiPath}/`)) return `${apiPath}/[...path]`;
-  const entry = normalize(docs.path);
-  const base = entry === "/" ? "" : entry;
   const markdown = pathname.toLowerCase().endsWith(".md");
   const page = markdown ? pathname.slice(0, -".md".length) : pathname;
-  if (page === entry || entry === "/" && page === "/index") {
-    return markdown ? getFarmMarkdownMirrorPath(entry) : entry;
+  const entries = [docs.path, ...docs.roots ?? []].map(normalize).sort((a, b) => b.length - a.length);
+  for (const entry of entries) {
+    const base = entry === "/" ? "" : entry;
+    if (page === entry || entry === "/" && page === "/index") {
+      return markdown ? getFarmMarkdownMirrorPath(entry) : entry;
+    }
+    if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   }
-  if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   return null;
 }
 function resolveFarmDocsEngineRouteLabel(routePathname, docs) {

package/dist/{chunk-75WWOZ5C.mjs → chunk-QOSDWGKT.mjs}

@@ -12,7 +12,7 @@ function farmDesktopDevGuardPlugin(basePath) {
       order: "pre",
       async handler(server) {
         if (resolveFarmPlatform() !== "desktop") return;
-        const { createFarmDesktopDevGuard } = await import("./dev-guard-4PFQNXQX.mjs");
+        const { createFarmDesktopDevGuard } = await import("./dev-guard-ONNMVQUN.mjs");
         server.middlewares.use(createFarmDesktopDevGuard(server, { basePath: basePath || "" }));
       }
     }

package/dist/{chunk-J22JD5YJ.cjs → chunk-RMPNYUGT.cjs}

@@ -23,7 +23,7 @@ var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
 
 
-var _chunkX5BCMLGPcjs = require('./chunk-X5BCMLGP.cjs');
+var _chunkAGR7VJH2cjs = require('./chunk-AGR7VJH2.cjs');
 
 
 var _chunkD22BUQKWcjs = require('./chunk-D22BUQKW.cjs');
@@ -282,7 +282,7 @@ function createFarmAppManifest(input) {
   return {
     schemaVersion: 1,
     app: app ? {
-      ...app.version ? { farm: _chunkX5BCMLGPcjs.FARM_VERSION } : {},
+      ...app.version ? { farm: _chunkAGR7VJH2cjs.FARM_VERSION } : {},
       ...app.renderer ? { renderer: input.renderer } : {},
       basePath: input.basePath,
       ...app.build ? { build: input.build } : {}
@@ -441,14 +441,16 @@ function resolveFarmDocsRouteLabel(routePathname, docs) {
   const apiPath = normalize(_nullishCoalesce(docs.apiPath, () => ( "/api/docs")));
   if (pathname === apiPath) return apiPath;
   if (pathname.startsWith(`${apiPath}/`)) return `${apiPath}/[...path]`;
-  const entry = normalize(docs.path);
-  const base = entry === "/" ? "" : entry;
   const markdown = pathname.toLowerCase().endsWith(".md");
   const page = markdown ? pathname.slice(0, -".md".length) : pathname;
-  if (page === entry || entry === "/" && page === "/index") {
-    return markdown ? _chunkWJFFPXCVcjs.getFarmMarkdownMirrorPath.call(void 0, entry) : entry;
+  const entries = [docs.path, ..._nullishCoalesce(docs.roots, () => ( []))].map(normalize).sort((a, b) => b.length - a.length);
+  for (const entry of entries) {
+    const base = entry === "/" ? "" : entry;
+    if (page === entry || entry === "/" && page === "/index") {
+      return markdown ? _chunkWJFFPXCVcjs.getFarmMarkdownMirrorPath.call(void 0, entry) : entry;
+    }
+    if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   }
-  if (page.startsWith(`${base}/`)) return `${base}/[...slug]${markdown ? ".md" : ""}`;
   return null;
 }
 function resolveFarmDocsEngineRouteLabel(routePathname, docs) {

package/dist/{chunk-XWC5NAHV.mjs → chunk-SCRC5AMM.mjs}

@@ -7,11 +7,11 @@ import {
 } from "./chunk-LMFJCXDD.mjs";
 import {
   resolveDeployOutputPath
-} from "./chunk-JF5CNHHF.mjs";
+} from "./chunk-KMB5BMFX.mjs";
 import {
   farmDesktopDevGuardPlugin,
   loadFarmReactPlugin
-} from "./chunk-75WWOZ5C.mjs";
+} from "./chunk-QOSDWGKT.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";