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

package/dist/{chunk-JHXJBNLY.cjs → chunk-SUCDVKUB.cjs}

@@ -16,7 +16,27 @@ function searchParamsToObject(searchParams) {
   });
   return output;
 }
+var RESERVED_SEARCH_KEYS = /* @__PURE__ */ new Set([
+  "then",
+  "catch",
+  "finally",
+  "__proto__",
+  "constructor",
+  "prototype"
+]);
+function createFarmSearchParams(search) {
+  const promise = Promise.resolve(search);
+  for (const key of Object.keys(search)) {
+    if (RESERVED_SEARCH_KEYS.has(key)) continue;
+    Object.defineProperty(promise, key, {
+      value: search[key],
+      enumerable: true
+    });
+  }
+  return promise;
+}
+
 
 
 
-exports.searchParamsToObject = searchParamsToObject;
+exports.searchParamsToObject = searchParamsToObject; exports.createFarmSearchParams = createFarmSearchParams;

package/dist/{chunk-7ONZDKVY.mjs → chunk-T4EW7AAD.mjs}

@@ -4,13 +4,13 @@ import {
   _runServerFunctionForCaller,
   createServerFn,
   createServerFunctionDescriptor
-} from "./chunk-CPXDDWGL.mjs";
+} from "./chunk-AER5I65K.mjs";
 import {
   createFarmServerQueryResult
 } from "./chunk-N7XWC6BN.mjs";
 import {
   getServerActionExecutionContext
-} from "./chunk-BW6SCVYX.mjs";
+} from "./chunk-FSQMN2MQ.mjs";
 import {
   createRouteDataCacheTag,
   getFarmDataCache

package/dist/{chunk-F5LERVY3.cjs → chunk-TT66CP3P.cjs}

@@ -1,20 +1,20 @@
 "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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } async function _asyncNullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return await 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; } async function _asyncOptionalChain(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 = await fn(value); } else if (op === 'call' || op === 'optionalCall') { value = await fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkETF5C6HRcjs = require('./chunk-ETF5C6HR.cjs');
+var _chunkSJ23LJ3Ncjs = require('./chunk-SJ23LJ3N.cjs');
 
 
-var _chunkCGCJ2TJUcjs = require('./chunk-CGCJ2TJU.cjs');
+var _chunkXPMC4E2Gcjs = require('./chunk-XPMC4E2G.cjs');
 
 
-var _chunkLYWAGXXWcjs = require('./chunk-LYWAGXXW.cjs');
+var _chunkVITZRYW3cjs = require('./chunk-VITZRYW3.cjs');
 
 
 
-var _chunkDGOLAZLVcjs = require('./chunk-DGOLAZLV.cjs');
+var _chunk65Y5SIBHcjs = require('./chunk-65Y5SIBH.cjs');
 
 
-var _chunkIXSMFKZ2cjs = require('./chunk-IXSMFKZ2.cjs');
+var _chunkLNM57D3Hcjs = require('./chunk-LNM57D3H.cjs');
 
 
 var _chunkAQLHD6HZcjs = require('./chunk-AQLHD6HZ.cjs');
@@ -54,7 +54,7 @@ function pickImportTarget(entry) {
   return void 0;
 }
 async function importFromApp(root, packageName, subpath = ".") {
-  const packageDir = _chunkETF5C6HRcjs.findFarmAppPackageDir.call(void 0, root, packageName);
+  const packageDir = _chunkSJ23LJ3Ncjs.findFarmAppPackageDir.call(void 0, root, packageName);
   if (!packageDir) return void 0;
   const manifest = JSON.parse(_fs.readFileSync.call(void 0, _path2.default.join(packageDir, "package.json"), "utf8"));
   const exportsMap = manifest.exports;
@@ -81,9 +81,9 @@ async function createFarmRscViteConfig(userConfig, options) {
     importFromApp(root, "@vitejs/plugin-rsc"),
     importFromApp(root, "@vitejs/plugin-react")
   ]);
-  if (!pluginRsc || !viteRsc || !_chunkETF5C6HRcjs.findFarmAppPackageDir.call(void 0, root, "react-server-dom-webpack")) {
+  if (!pluginRsc || !viteRsc || !_chunkSJ23LJ3Ncjs.findFarmAppPackageDir.call(void 0, root, "react-server-dom-webpack")) {
     throw new Error(
-      `[Farm.js] experimental.serverComponents runs on @farm.js/plugin and the official @vitejs/plugin-rsc. Install them: ${_chunkETF5C6HRcjs.FARM_RSC_INSTALL_HINT}`
+      `[Farm.js] experimental.serverComponents runs on @farm.js/plugin and the official @vitejs/plugin-rsc. Install them: ${_chunkSJ23LJ3Ncjs.FARM_RSC_INSTALL_HINT}`
     );
   }
   const { plugins: vitePlugins = [], ...viteOptions } = _nullishCoalesce(userConfig.vite, () => ( {}));
@@ -91,15 +91,15 @@ async function createFarmRscViteConfig(userConfig, options) {
   for (const key of FARM_RSC_CONFIG_KEYS) {
     if (userConfig[key] !== void 0) rscConfig[key] = userConfig[key];
   }
-  const createReactPlugin = hasPluginNamed(vitePlugins, "vite:react") ? void 0 : await _asyncNullishCoalesce(await _asyncOptionalChain([viteReact, 'optionalAccess', async _2 => _2.default]), async () => ( (options.command === "serve" ? (await _chunkDGOLAZLVcjs.loadFarmReactPlugin.call(void 0, )).default : void 0)));
-  const tailwind = hasPluginNamed(vitePlugins, "@tailwindcss/vite") ? void 0 : await _chunkIXSMFKZ2cjs.loadTailwindVitePlugin.call(void 0, );
+  const createReactPlugin = hasPluginNamed(vitePlugins, "vite:react") ? void 0 : await _asyncNullishCoalesce(await _asyncOptionalChain([viteReact, 'optionalAccess', async _2 => _2.default]), async () => ( (options.command === "serve" ? (await _chunk65Y5SIBHcjs.loadFarmReactPlugin.call(void 0, )).default : void 0)));
+  const tailwind = hasPluginNamed(vitePlugins, "@tailwindcss/vite") ? void 0 : await _chunkLNM57D3Hcjs.loadTailwindVitePlugin.call(void 0, );
   const farmConfig = pluginRsc.defineConfig({
     ...rscConfig,
     experimental: { ...userConfig.experimental, serverComponents: true },
     port: _nullishCoalesce(options.port, () => ( _optionalChain([userConfig, 'access', _3 => _3.server, 'optionalAccess', _4 => _4.port]))),
     plugins: [
       ...options.command === "serve" && _chunkAQLHD6HZcjs.resolveFarmPlatform.call(void 0, ) === "desktop" ? [
-        _chunkDGOLAZLVcjs.farmDesktopDevGuardPlugin.call(void 0, 
+        _chunk65Y5SIBHcjs.farmDesktopDevGuardPlugin.call(void 0, 
           typeof userConfig.basePath === "string" ? userConfig.basePath : void 0
         )
       ] : [],
@@ -111,7 +111,7 @@ async function createFarmRscViteConfig(userConfig, options) {
         server: { environmentName: "rsc" },
         config: {
           preset: options.preset,
-          outputDir: options.outputDir && _chunkLYWAGXXWcjs.resolveDeployOutputPath.call(void 0, root, options.outputDir)
+          outputDir: options.outputDir && _chunkVITZRYW3cjs.resolveDeployOutputPath.call(void 0, root, options.outputDir)
         }
       })
     ]
@@ -134,7 +134,7 @@ async function createFarmRscDevServer(userConfig, options) {
   const config = await createFarmRscViteConfig(userConfig, { ...configOptions, command: "serve" });
   return createServer({
     ...config,
-    plugins: [..._nullishCoalesce(config.plugins, () => ( [])), _chunkCGCJ2TJUcjs.createFarmDevLoopbackPlugin.call(void 0, )],
+    plugins: [..._nullishCoalesce(config.plugins, () => ( [])), _chunkXPMC4E2Gcjs.createFarmDevLoopbackPlugin.call(void 0, )],
     ...host === void 0 ? {} : { server: { ...config.server, host } }
   });
 }

package/dist/{chunk-IUBDMDZZ.cjs → chunk-UQHIWZZ6.cjs}

@@ -1,7 +1,7 @@
 "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 _chunk3ATXWZPHcjs = require('./chunk-3ATXWZPH.cjs');
+var _chunkE36C43IXcjs = require('./chunk-E36C43IX.cjs');
 
 
 var _chunkSYW346ZNcjs = require('./chunk-SYW346ZN.cjs');
@@ -407,6 +407,7 @@ async function collectSSGPages(routes, loadModule, options = {}) {
   const ssgPages = [];
   const ssrRoutes = [];
   const staticCandidateRoutes = [];
+  let staticCandidateDocsPages = 0;
   for (const route of routes) {
     try {
       const mod = await loadModule(route.filePath);
@@ -453,7 +454,8 @@ async function collectSSGPages(routes, loadModule, options = {}) {
       } else {
         ssrRoutes.push(route.path);
         if (options.suggestStaticRendering !== false && analyzeStaticRouteCandidate(mod, source, { isDynamic: route.isDynamic }).candidate) {
-          staticCandidateRoutes.push(route.path);
+          if (_optionalChain([options, 'access', _41 => _41.docsAdapterRoutes, 'optionalAccess', _42 => _42.owns, 'call', _43 => _43(route.path)])) staticCandidateDocsPages += 1;
+          else staticCandidateRoutes.push(route.path);
         }
       }
     } catch (error) {
@@ -472,6 +474,11 @@ async function collectSSGPages(routes, loadModule, options = {}) {
 Add \`export const dynamic = "force-static";\` after verifying that imported code does not read cookies, headers, authentication, or other request data.`
     );
   }
+  if (staticCandidateDocsPages > 0 && !_optionalChain([options, 'access', _44 => _44.docsAdapterRoutes, 'optionalAccess', _45 => _45.prerender])) {
+    console.warn(
+      `[Farm.js] ${staticCandidateDocsPages} docs page${staticCandidateDocsPages === 1 ? " renders" : "s render"} on each request. Set \`docs.prerender: true\` in farm.config.ts to prerender docs pages on Node and serverless targets.`
+    );
+  }
   return { ssg: ssgPages, ssr: ssrRoutes };
 }
 function isSSGModule(mod) {
@@ -749,7 +756,7 @@ function fieldTsType(field) {
       case "json":
         return "unknown";
       case "enum":
-        return _optionalChain([field, 'access', _41 => _41.values, 'optionalAccess', _42 => _42.length]) ? field.values.map((value) => JSON.stringify(value)).join(" | ") : "string";
+        return _optionalChain([field, 'access', _46 => _46.values, 'optionalAccess', _47 => _47.length]) ? field.values.map((value) => JSON.stringify(value)).join(" | ") : "string";
       // id, uuid, string, text, datetime all travel as strings over JSON.
       default:
         return "string";
@@ -773,7 +780,7 @@ async function generateFarmTypeArtifacts(options) {
   const shouldGenerateApi = options.api !== false;
   const shouldGenerateEnv = options.env !== false;
   const shouldGenerateImages = options.images !== false;
-  const shouldGenerateI18n = options.i18n !== false && _optionalChain([options, 'access', _43 => _43.i18nConfig, 'optionalAccess', _44 => _44.enabled]);
+  const shouldGenerateI18n = options.i18n !== false && _optionalChain([options, 'access', _48 => _48.i18nConfig, 'optionalAccess', _49 => _49.enabled]);
   const sourceRoots = _chunk5Y2P454Ocjs.getFarmSourceRoots.call(void 0, { root, srcDir, layers: options.layers });
   const appDirs = _chunk5Y2P454Ocjs.getFarmAppDirectories.call(void 0, { root, srcDir, layers: options.layers });
   const result = {
@@ -792,7 +799,7 @@ async function generateFarmTypeArtifacts(options) {
       componentExtensions: options.componentExtensions,
       sourceRoots
     };
-    unifiedSections.push(await _chunk3ATXWZPHcjs.createRouteTypeDeclarations.call(void 0, routeOptions, unifiedTypesPath));
+    unifiedSections.push(await _chunkE36C43IXcjs.createRouteTypeDeclarations.call(void 0, routeOptions, unifiedTypesPath));
     result.routeTypesPath = unifiedTypesPath;
   } else if (shouldGenerateRoutes) {
     const routeOptions = {
@@ -806,11 +813,11 @@ async function generateFarmTypeArtifacts(options) {
     };
     if (options.check) {
       const routeTypesPath = resolveGeneratedPath(root, srcDir, options.routeTypesOutFile);
-      const content = await _chunk3ATXWZPHcjs.createRouteTypeDeclarations.call(void 0, routeOptions, routeTypesPath);
+      const content = await _chunkE36C43IXcjs.createRouteTypeDeclarations.call(void 0, routeOptions, routeTypesPath);
       checkGeneratedFile(routeTypesPath, content, result.stalePaths);
       result.routeTypesPath = routeTypesPath;
     } else {
-      result.routeTypesPath = await _chunk3ATXWZPHcjs.generateRouteTypes.call(void 0, routeOptions);
+      result.routeTypesPath = await _chunkE36C43IXcjs.generateRouteTypes.call(void 0, routeOptions);
     }
   }
   if (shouldGenerateApi) {
@@ -893,7 +900,7 @@ async function generateFarmTypeArtifacts(options) {
       });
     }
   }
-  if (shouldRefreshUnifiedTypes && _optionalChain([options, 'access', _45 => _45.i18nConfig, 'optionalAccess', _46 => _46.enabled]) && !options.i18nTypesOutFile) {
+  if (shouldRefreshUnifiedTypes && _optionalChain([options, 'access', _50 => _50.i18nConfig, 'optionalAccess', _51 => _51.enabled]) && !options.i18nTypesOutFile) {
     const { signatures } = await _chunkBBPDJGCUcjs.readFarmI18nCatalogs.call(void 0, options.i18nConfig);
     unifiedSections.push(renderFarmI18nTypes(options.i18nConfig.locales, signatures));
     result.i18nTypesPath = unifiedTypesPath;

package/dist/{chunk-LYWAGXXW.cjs → chunk-VITZRYW3.cjs}

@@ -56,13 +56,13 @@ var _chunk2HW5LWAHcjs = require('./chunk-2HW5LWAH.cjs');
 var _chunkDQJ2CIH7cjs = require('./chunk-DQJ2CIH7.cjs');
 
 
-var _chunkIQXGHGZFcjs = require('./chunk-IQXGHGZF.cjs');
+var _chunkXB24LZWIcjs = require('./chunk-XB24LZWI.cjs');
 
 
-var _chunkC7425KDGcjs = require('./chunk-C7425KDG.cjs');
+var _chunkXYL4HSVCcjs = require('./chunk-XYL4HSVC.cjs');
 
 
-var _chunk6QA2SXVHcjs = require('./chunk-6QA2SXVH.cjs');
+var _chunkFK25QSVCcjs = require('./chunk-FK25QSVC.cjs');
 
 
 var _chunkWT6RAN2Icjs = require('./chunk-WT6RAN2I.cjs');
@@ -71,7 +71,7 @@ var _chunkWT6RAN2Icjs = require('./chunk-WT6RAN2I.cjs');
 var _chunkWJFFPXCVcjs = require('./chunk-WJFFPXCV.cjs');
 
 
-var _chunkWAPQWAE6cjs = require('./chunk-WAPQWAE6.cjs');
+var _chunkCECUDGXQcjs = require('./chunk-CECUDGXQ.cjs');
 
 
 var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
@@ -80,7 +80,7 @@ var _chunk5DX3O6TTcjs = require('./chunk-5DX3O6TT.cjs');
 var _chunkLNVGXUL3cjs = require('./chunk-LNVGXUL3.cjs');
 
 
-var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 
 
 var _chunkLIFUPCXWcjs = require('./chunk-LIFUPCXW.cjs');
@@ -370,7 +370,7 @@ function resolveDeployConfig(config, overrides = {}) {
       target = detectedTarget;
       if (!warnedPlatformMismatches.has(`select:${detectedTarget}`)) {
         warnedPlatformMismatches.add(`select:${detectedTarget}`);
-        _chunkXN2MB4QZcjs.logger.info(
+        _chunkVQJYGZNXcjs.logger.info(
           `Detected ${detectedTarget} build environment; using the ${detectedTarget} preset. Set deploy.target in farm.config.ts to override.`
         );
       }
@@ -384,7 +384,7 @@ function resolveDeployConfig(config, overrides = {}) {
     const mismatchKey = `mismatch:${resolvedTarget}:${detectedTarget}`;
     if (!warnedPlatformMismatches.has(mismatchKey)) {
       warnedPlatformMismatches.add(mismatchKey);
-      _chunkXN2MB4QZcjs.logger.warn(
+      _chunkVQJYGZNXcjs.logger.warn(
         `The configured deploy target "${_nullishCoalesce(resolvedTarget, () => ( preset))}" cannot be served by ${detectedTarget}, but this build is running in a ${detectedTarget} build environment. Set deploy.target: "${detectedTarget}" in farm.config.ts to deploy there.`
       );
     }
@@ -565,29 +565,35 @@ async function resolveDocsConfig(userDocs, options = {}) {
       config: { entry: "docs", docsPath: "/docs" }
     };
   }
-  const inlineDocsConfig = sanitizeDocsConfig(docsOptions.config || {});
+  const fileDocsConfig = omitDocsRoots(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.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(_optionalChain([loadedConfig, 'optionalAccess', _24 => _24.config]) || {});
+  const loadedDocsConfig = sanitizeDocsConfig(fileDocsConfig);
   const mergedDocsConfig = {
     ...loadedDocsConfig,
     ...inlineDocsConfig,
     ...directDocsConfig
   };
   const runtimeDocsConfig = {
-    ..._optionalChain([loadedConfig, 'optionalAccess', _25 => _25.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 ? _path2.default.relative(root, loadedConfig.configPath) || loadedConfig.configPath : "the docs config";
+  const roots = await resolveDocsRoots(
+    [
+      { field: `roots in ${configFileName}`, roots: docsRootsOf(_optionalChain([loadedConfig, 'optionalAccess', _25 => _25.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: _optionalChain([loadedConfig, 'optionalAccess', _26 => _26.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 = _nullishCoalesce(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()) {
     _chunk6XQSPIN6cjs.validateConfigRouteSource.call(void 0, redirect.source, `${field}[${index}].source`);
@@ -654,12 +764,12 @@ async function resolveConfig(userConfig, mode) {
   });
   userConfig = layerResolution.config;
   if (userConfig.typescript !== void 0) {
-    _chunkXN2MB4QZcjs.logger.warn(
+    _chunkVQJYGZNXcjs.logger.warn(
       'The top-level "typescript" option is not supported and has no effect. Configure TypeScript in `tsconfig.json` and run `tsc --noEmit` separately when builds must enforce project type errors.'
     );
   }
   if (userConfig.output !== void 0) {
-    _chunkXN2MB4QZcjs.logger.warn(
+    _chunkVQJYGZNXcjs.logger.warn(
       'The top-level "output" option is not supported and has no effect. Configure `deploy.target`, `deploy.preset`, or `deploy.outputDir` for deployment output, and use route rendering configuration for static pages.'
     );
   }
@@ -682,7 +792,7 @@ async function resolveConfig(userConfig, mode) {
   const security = _chunk6JHZPB52cjs.resolveFarmSecurityConfig.call(void 0, userConfig.security);
   const securityHeader = _chunk6JHZPB52cjs.getFarmSecurityHeader.call(void 0, security);
   if (_chunk6JHZPB52cjs.farmCspBlocksFrameworkInlineScripts.call(void 0, security)) {
-    _chunkXN2MB4QZcjs.logger.warn(
+    _chunkVQJYGZNXcjs.logger.warn(
       "security.csp blocks the inline scripts Farm injects for theming and hydration. Set security.csp.nonce to true for managed dynamic nonces and prerendered hashes, or make the governing script directive allow 'unsafe-inline' without a nonce, hash, or 'strict-dynamic' source."
     );
   }
@@ -747,8 +857,8 @@ async function resolveConfig(userConfig, mode) {
     md,
     mdx,
     migrations: resolveMigrationsConfig(userConfig.migrations),
-    cron: _chunkC7425KDGcjs.resolveCronConfig.call(void 0, userConfig.cron),
-    workflows: _chunkIQXGHGZFcjs.resolveWorkflowsConfig.call(void 0, userConfig.workflows),
+    cron: _chunkXYL4HSVCcjs.resolveCronConfig.call(void 0, userConfig.cron),
+    workflows: _chunkXB24LZWIcjs.resolveWorkflowsConfig.call(void 0, userConfig.workflows),
     api,
     observability: _nullishCoalesce(userConfig.observability, () => ( false)),
     telemetry: userConfig.telemetry !== false,
@@ -772,7 +882,7 @@ async function resolveConfig(userConfig, mode) {
     agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
     desktop: _nullishCoalesce(_optionalChain([desktopSetup, 'optionalAccess', _40 => _40.desktop]), () => ( null)),
     plugins: [
-      ..._chunkWAPQWAE6cjs.resolveIntegrationPlugins.call(void 0, integrations),
+      ..._chunkCECUDGXQcjs.resolveIntegrationPlugins.call(void 0, integrations),
       ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
       ...userConfig.plugins || []
     ],
@@ -796,7 +906,7 @@ async function resolveConfig(userConfig, mode) {
     notFound: userConfig.notFound || {},
     context: userConfig.context || (() => void 0),
     server: _chunkLIFUPCXWcjs.resolveFarmServerConfig.call(void 0, userConfig.server),
-    serverActions: _chunk6QA2SXVHcjs.resolveServerActionsConfig.call(void 0, userConfig.serverActions),
+    serverActions: _chunkFK25QSVCcjs.resolveServerActionsConfig.call(void 0, userConfig.serverActions),
     security,
     deploymentId,
     distDir: userConfig.distDir || ".farm",

package/dist/{chunk-XN2MB4QZ.cjs → chunk-VQJYGZNX.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 _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 
-var _chunkJHXJBNLYcjs = require('./chunk-JHXJBNLY.cjs');
+var _chunkSUCDVKUBcjs = require('./chunk-SUCDVKUB.cjs');
 
 
 var _chunk6CTFVBATcjs = require('./chunk-6CTFVBAT.cjs');
@@ -172,11 +172,11 @@ async function fileExists(filePath) {
   }
 }
 async function globFiles(pattern, cwd) {
-  const glob = await import("fast-glob");
-  return glob.default(pattern, { cwd, absolute: false });
+  const { glob } = await import("tinyglobby");
+  return glob(pattern, { cwd, expandDirectories: false });
 }
 function parseSearchParams(searchParams) {
-  return _chunkJHXJBNLYcjs.searchParamsToObject.call(void 0, searchParams);
+  return _chunkSUCDVKUBcjs.searchParamsToObject.call(void 0, searchParams);
 }
 var logger = {
   info: (message) => console.log(`[info] ${message}`),

package/dist/{chunk-KGP76FSV.mjs → chunk-VS7EHLLW.mjs}

@@ -1,6 +1,6 @@
 import {
   MiddlewareManager
-} from "./chunk-X3HOVNHI.mjs";
+} from "./chunk-NN3MOPSI.mjs";
 import {
   matchesMiddlewarePredicate
 } from "./chunk-EDPENAVO.mjs";

package/dist/{chunk-5PKDHKQP.cjs → chunk-WFVSAT7Y.cjs}

@@ -1,8 +1,10 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkN4AQNEXRcjs = require('./chunk-N4AQNEXR.cjs');
 
 
-var _chunkWQGRD5BJcjs = require('./chunk-WQGRD5BJ.cjs');
+
+var _chunkEX6ZSN5Pcjs = require('./chunk-EX6ZSN5P.cjs');
 
 
 var _chunkI2BYNELAcjs = require('./chunk-I2BYNELA.cjs');
@@ -11,7 +13,7 @@ var _chunkI2BYNELAcjs = require('./chunk-I2BYNELA.cjs');
 var _react = require('react');
 function useServerQuery(query, input, options = {}) {
   const cache = _chunkI2BYNELAcjs.getFarmClientDataCache.call(void 0, );
-  const key = _chunkWQGRD5BJcjs.createServerQueryCallKey.call(void 0, query, input);
+  const key = _chunkEX6ZSN5Pcjs.createServerQueryCallKey.call(void 0, query, input);
   const inputRef = _react.useRef.call(void 0, input);
   const optionsRef = _react.useRef.call(void 0, options);
   const mountedKeyRef = _react.useRef.call(void 0, void 0);
@@ -33,7 +35,7 @@ function useServerQuery(query, input, options = {}) {
   const run = _react.useCallback.call(void 0, 
     (force = false) => {
       pendingInvalidationRef.current = false;
-      return _chunkWQGRD5BJcjs.fetchServerQuery.call(void 0, query, inputRef.current, {
+      return _chunkEX6ZSN5Pcjs.fetchServerQuery.call(void 0, query, inputRef.current, {
         ...optionsRef.current,
         force
       });
@@ -53,7 +55,7 @@ function useServerQuery(query, input, options = {}) {
   }, [cache, entry, key, options.enabled, run]);
   _react.useEffect.call(void 0, () => {
     if (options.enabled === false) return;
-    return _chunkWQGRD5BJcjs.attachRevalidationListeners.call(void 0, 
+    return _chunkN4AQNEXRcjs.attachRevalidationListeners.call(void 0, 
       () => {
         if (cache.isStale(key)) void run().catch(() => void 0);
       },

package/dist/{chunk-UY6HS5PF.cjs → chunk-X2AMN2WV.cjs}

@@ -2,13 +2,13 @@
 
 
 
-var _chunkL6QDME5Zcjs = require('./chunk-L6QDME5Z.cjs');
 
+var _chunkUPYIFH2Hcjs = require('./chunk-UPYIFH2H.cjs');
 
 
 
 
-var _chunkUPYIFH2Hcjs = require('./chunk-UPYIFH2H.cjs');
+var _chunkB3GZAQSCcjs = require('./chunk-B3GZAQSC.cjs');
 
 
 
@@ -27,13 +27,13 @@ var _chunkSNP33A33cjs = require('./chunk-SNP33A33.cjs');
 var _chunkJYNNIGQOcjs = require('./chunk-JYNNIGQO.cjs');
 
 
-var _chunkXN2MB4QZcjs = require('./chunk-XN2MB4QZ.cjs');
+var _chunkVQJYGZNXcjs = require('./chunk-VQJYGZNX.cjs');
 
 
 var _chunkEVIWKPJVcjs = require('./chunk-EVIWKPJV.cjs');
 
 
-var _chunkZ5MZDFX4cjs = require('./chunk-Z5MZDFX4.cjs');
+var _chunkYIHRZBD7cjs = require('./chunk-YIHRZBD7.cjs');
 
 
 var _chunkB5BBTPJQcjs = require('./chunk-B5BBTPJQ.cjs');
@@ -240,11 +240,11 @@ var MiddlewareManager = class {
         middlewareByDirectory.set(entry.location.directory, entry);
       }
     }
-    this.middleware = Array.from(middlewareByDirectory.values()).sort((left, right) => _chunkL6QDME5Zcjs.compareMiddlewareRouteLocations.call(void 0, left.location, right.location)).map((entry) => entry.middleware);
+    this.middleware = Array.from(middlewareByDirectory.values()).sort((left, right) => _chunkB3GZAQSCcjs.compareMiddlewareRouteLocations.call(void 0, left.location, right.location)).map((entry) => entry.middleware);
     if (process.env.FARM_VERBOSE && this.middleware.length > 0) {
-      _chunkXN2MB4QZcjs.logger.success(`Discovered ${this.middleware.length} middleware files`);
+      _chunkVQJYGZNXcjs.logger.success(`Discovered ${this.middleware.length} middleware files`);
       for (const mw of this.middleware) {
-        _chunkXN2MB4QZcjs.logger.info(`  ${mw.path} (${mw.handlers.length} handlers)`);
+        _chunkVQJYGZNXcjs.logger.info(`  ${mw.path} (${mw.handlers.length} handlers)`);
       }
     }
   }
@@ -267,8 +267,8 @@ var MiddlewareManager = class {
       if (entry.isDirectory() && !entry.name.startsWith(".")) {
         await this.discoverInDirectory(
           path.join(dir, entry.name),
-          _chunkL6QDME5Zcjs.appendMiddlewareRoutePath.call(void 0, routePath, entry.name),
-          _chunkL6QDME5Zcjs.appendMiddlewareDirectory.call(void 0, directory, entry.name),
+          _chunkB3GZAQSCcjs.appendMiddlewareRoutePath.call(void 0, routePath, entry.name),
+          _chunkB3GZAQSCcjs.appendMiddlewareDirectory.call(void 0, directory, entry.name),
           discovered
         );
       }
@@ -443,7 +443,7 @@ var MiddlewareManager = class {
             ...middlewareEvent,
             status: response.status
           });
-          await _chunkZ5MZDFX4cjs.sendWebResponse.call(void 0, res, response);
+          await _chunkYIHRZBD7cjs.sendWebResponse.call(void 0, res, response);
           return true;
         }
         if (ctx._handled || res.headersSent || res.writableEnded) {