@farm.js/core 0.1.51-beta.3 → 0.1.61

package/dist/chunk-GAO7MS5O.mjs

@@ -1,1010 +0,0 @@
-import {
-  resolveFarmAuthConfig,
-  resolveFarmAuthIntegration,
-  resolveFarmDevIndicatorsConfig,
-  resolveFarmServerComponentsMode,
-  setFarmProjectSourceDir
-} from "./chunk-PAKCHVUS.mjs";
-import {
-  normalizeRouteRules,
-  routeRulesToHeaders,
-  routeRulesToRedirects
-} from "./chunk-X3XUZWRB.mjs";
-import {
-  assertPluginDependencies
-} from "./chunk-XR2ZIBQK.mjs";
-import {
-  resolveFarmDevtoolsConfig
-} from "./chunk-CU5SYTJG.mjs";
-import {
-  isReactRenderer,
-  resolveFarmRenderer
-} from "./chunk-ES2LD2YD.mjs";
-import {
-  resolveFarmAgentCrawlers,
-  resolveFarmAgentSitemap,
-  resolveFarmNoindexPreviews,
-  resolveFarmPerformanceConfig
-} from "./chunk-LDNSSHEG.mjs";
-import {
-  resolveFarmAppManifestConfig
-} from "./chunk-2WZTGPK6.mjs";
-import {
-  resolveFarmLlmsTxtConfig
-} from "./chunk-YAJTD3ZG.mjs";
-import {
-  farmCspBlocksFrameworkInlineScripts,
-  getFarmSecurityHeader,
-  resolveFarmSecurityConfig
-} from "./chunk-22W4FNTG.mjs";
-import {
-  resolveFarmImageConfig
-} from "./chunk-2NGZFOKG.mjs";
-import {
-  resolveEnv,
-  setEnv
-} from "./chunk-N33DLJBC.mjs";
-import {
-  loadFarmConfigFile,
-  resolveFarmLayers
-} from "./chunk-52Y3C3HG.mjs";
-import {
-  resolveMdxConfig
-} from "./chunk-UIJOLBUL.mjs";
-import {
-  bundleNodeModule
-} from "./chunk-VFXE6NWR.mjs";
-import {
-  resolveWorkflowsConfig
-} from "./chunk-LZ4SB57H.mjs";
-import {
-  resolveCronConfig
-} from "./chunk-X3JNB2TB.mjs";
-import {
-  resolveServerActionsConfig
-} from "./chunk-FSQMN2MQ.mjs";
-import {
-  resolveFarmThemeConfig
-} from "./chunk-YWPNIYUP.mjs";
-import {
-  resolveMarkdownConfig
-} from "./chunk-LPDKG6RA.mjs";
-import {
-  resolveIntegrationPlugins
-} from "./chunk-Y2G5SJFB.mjs";
-import {
-  compileMiddlewareConfig
-} from "./chunk-EDPENAVO.mjs";
-import {
-  resolveFarmI18nConfig
-} from "./chunk-MU5V7XHL.mjs";
-import {
-  logger
-} from "./chunk-Y3N5BFRJ.mjs";
-import {
-  resolveFarmServerConfig
-} from "./chunk-GFT5AHAT.mjs";
-import {
-  resolveFarmAPIConfig
-} from "./chunk-BLD5GVCG.mjs";
-import {
-  normalizeFarmDeploymentId
-} from "./chunk-UAQD67HM.mjs";
-import {
-  validateConfigRouteSource
-} from "./chunk-ONG4RDW3.mjs";
-import {
-  isFarmRedirectStatus
-} from "./chunk-JNYFXL7X.mjs";
-import {
-  normalizeFarmConfigBasePath
-} from "./chunk-SF3JB56B.mjs";
-
-// src/mcp-config.ts
-import { createRequire } from "module";
-import path from "path";
-import { pathToFileURL } from "url";
-function resolveFarmMCPConfig(input) {
-  if (input === false || input === void 0) return { enabled: false };
-  if (!input || typeof input !== "object" || Array.isArray(input)) {
-    throw new TypeError("mcp must be a configuration object or false.");
-  }
-  return { ...input, enabled: input.enabled !== false };
-}
-async function resolveFarmMCPPlugin(config, options) {
-  if (!config.enabled) return void 0;
-  const root = path.resolve(options.root);
-  let modulePath;
-  try {
-    const resolveFromApp = createRequire(path.join(root, "package.json"));
-    modulePath = resolveFromApp.resolve("@farm.js/mcp/internal");
-  } catch {
-    throw new Error(
-      "The `mcp` config requires @farm.js/mcp. Install it with `pnpm add @farm.js/mcp` and try again."
-    );
-  }
-  const runtime = await import(
-    /* @vite-ignore */
-    pathToFileURL(modulePath).href
-  );
-  if (typeof runtime.createFarmMCPPlugin !== "function") {
-    throw new Error(
-      "The installed @farm.js/mcp package is incompatible with this version of @farm.js/core."
-    );
-  }
-  return runtime.createFarmMCPPlugin(config);
-}
-
-// src/config.ts
-import path3 from "path";
-
-// src/agent-config.ts
-var DEFAULT_JSON_LD = { type: "WebSite" };
-function resolveFarmAgentConfig(input, context = {}) {
-  const jsonLd = input?.jsonLd;
-  return {
-    jsonLd: jsonLd === void 0 ? { ...DEFAULT_JSON_LD } : !jsonLd ? false : jsonLd === true ? {} : jsonLd,
-    noindexPreviews: resolveFarmNoindexPreviews(input?.noindexPreviews),
-    // The docs engine answers /llms.txt with its own pages; a default here would replace it.
-    // llms-full.txt renders every listed page, so it stays opt-in.
-    llmsTxt: resolveFarmLlmsTxtConfig(input?.llmsTxt ?? (context.docs ? false : { full: false })),
-    // Same rule as llms.txt: the docs engine answers /sitemap.xml with its own pages.
-    sitemap: resolveFarmAgentSitemap(input?.sitemap ?? !context.docs),
-    crawlers: resolveFarmAgentCrawlers(input?.crawlers),
-    apiCatalog: resolveFarmAgentBoolean(input?.apiCatalog, "apiCatalog", false),
-    aiCatalog: resolveFarmAgentBoolean(input?.aiCatalog, "aiCatalog", true),
-    manifest: resolveFarmAppManifestConfig(input?.manifest),
-    // Same rule as llms.txt: the docs engine serves its own MCP server at /mcp.
-    mcp: resolveFarmAgentBoolean(input?.mcp, "mcp", !context.docs)
-  };
-}
-function resolveFarmAgentBoolean(input, key, fallback) {
-  if (input === void 0) return fallback;
-  if (typeof input !== "boolean") throw new TypeError(`agent.${key} must be a boolean.`);
-  return input;
-}
-
-// src/docs/framework-detect.ts
-import { readFile } from "fs/promises";
-import { createRequire as createRequire2 } from "module";
-import path2 from "path";
-import { pathToFileURL as pathToFileURL2 } from "url";
-var FRAMEWORK_PACKAGE = "@farming-labs/farmjs";
-var FRAMEWORK_CONFIG_ENTRY = "@farming-labs/farmjs/config";
-var SUPPORTED_ADAPTER_PROTOCOL = 1;
-async function frameworkDeclaredByApp(root) {
-  try {
-    const raw = await readFile(path2.join(root, "package.json"), "utf8");
-    const manifest = JSON.parse(raw);
-    for (const field of ["dependencies", "devDependencies", "peerDependencies"]) {
-      const section = manifest[field];
-      if (section && typeof section === "object" && FRAMEWORK_PACKAGE in section) {
-        return true;
-      }
-    }
-  } catch {
-  }
-  return false;
-}
-var emittedNotices = /* @__PURE__ */ new Set();
-function noticeOnce(key, emit, message) {
-  if (emittedNotices.has(key)) return;
-  emittedNotices.add(key);
-  emit(message);
-}
-function docsWantsFrameworkDetection(docs) {
-  if (docs === true) return true;
-  if (!docs || typeof docs !== "object") return false;
-  if (docs.enabled === false) return false;
-  if (docs.adapter !== void 0) return false;
-  return true;
-}
-function isSupportedAdapterDescriptor(value) {
-  if (!value || typeof value !== "object") return false;
-  const descriptor = value;
-  return descriptor.protocol === SUPPORTED_ADAPTER_PROTOCOL && typeof descriptor.server === "string" && descriptor.server.length > 0 && typeof descriptor.react === "string" && descriptor.react.length > 0;
-}
-async function applyFarmDocsFrameworkAutoDetection(userConfig, options) {
-  if (!docsWantsFrameworkDetection(userConfig.docs)) return userConfig;
-  const log = options.log ?? ((message) => console.log(message));
-  const warn = options.warn ?? ((message) => console.warn(message));
-  const root = path2.resolve(options.root || process.cwd());
-  if (!await frameworkDeclaredByApp(root)) {
-    noticeOnce(
-      "embedded-fallback",
-      warn,
-      `[farm] docs is served by the embedded renderer, which is being replaced by the ${FRAMEWORK_PACKAGE} docs framework. Install ${FRAMEWORK_PACKAGE} (with @farming-labs/docs and @farming-labs/theme) to migrate now, or set docs.adapter = false to keep the embedded renderer and silence this notice.`
-    );
-    return userConfig;
-  }
-  let configEntryPath;
-  try {
-    const requireFromApp = createRequire2(path2.join(root, "package.json"));
-    configEntryPath = requireFromApp.resolve(FRAMEWORK_CONFIG_ENTRY);
-  } catch {
-    noticeOnce(
-      "declared-not-installed",
-      warn,
-      `[farm] ${FRAMEWORK_PACKAGE} is declared in package.json but could not be resolved; keeping the embedded docs renderer. Run your package manager's install to enable docs delegation.`
-    );
-    return userConfig;
-  }
-  try {
-    const frameworkConfig = await import(
-      /* @vite-ignore */
-      pathToFileURL2(configEntryPath).href
-    );
-    const withDocs = frameworkConfig?.withDocs;
-    if (typeof withDocs !== "function") {
-      noticeOnce(
-        "missing-withdocs",
-        warn,
-        `[farm] ${FRAMEWORK_CONFIG_ENTRY} does not export withDocs(); keeping the embedded docs renderer.`
-      );
-      return userConfig;
-    }
-    const applied = withDocs(userConfig);
-    const adapter = applied?.docs?.adapter;
-    if (!isSupportedAdapterDescriptor(adapter)) {
-      noticeOnce(
-        "unsupported-descriptor",
-        warn,
-        `[farm] The installed ${FRAMEWORK_PACKAGE} release publishes a docs adapter this Farm version cannot drive (need protocol ${SUPPORTED_ADAPTER_PROTOCOL}); keeping the embedded docs renderer. Upgrading @farm.js/core usually resolves this.`
-      );
-      return userConfig;
-    }
-    noticeOnce(
-      "delegated",
-      log,
-      `[farm] docs: delegated to ${FRAMEWORK_PACKAGE} (detected in this app). Set docs.adapter = false to keep the embedded renderer.`
-    );
-    return applied;
-  } catch (error) {
-    const message = error instanceof Error ? error.message : String(error);
-    noticeOnce(
-      "detect-failed",
-      warn,
-      `[farm] Failed to load ${FRAMEWORK_CONFIG_ENTRY} (${message}); keeping the embedded docs renderer.`
-    );
-    return userConfig;
-  }
-}
-
-// src/config.ts
-var FARM_RESOLVED_CUSTOM_CONTEXT = /* @__PURE__ */ Symbol.for("farm.resolvedCustomContext");
-function resolveSchemaConfig(config) {
-  if (config === void 0) return {};
-  if (!config || typeof config !== "object" || Array.isArray(config)) {
-    throw new TypeError("`schema` in farm.config must be an object.");
-  }
-  for (const key of ["allowExtend", "allowForeignKeys"]) {
-    const entries = config[key];
-    if (entries === void 0) continue;
-    if (!entries || typeof entries !== "object" || Array.isArray(entries)) {
-      throw new TypeError(
-        `\`schema.${key}\` must map a plugin's migrate name to a list of model or table names.`
-      );
-    }
-    for (const [owner, tables] of Object.entries(entries)) {
-      if (!Array.isArray(tables) || tables.some((table) => typeof table !== "string")) {
-        throw new TypeError(
-          `\`schema.${key}.${owner}\` must be a list of model or table names, such as ["user"].`
-        );
-      }
-    }
-  }
-  return config;
-}
-function hasCustomFarmRouteContext(config) {
-  return config[FARM_RESOLVED_CUSTOM_CONTEXT] === true;
-}
-function isResolvedFarmConfig(config) {
-  return Object.prototype.hasOwnProperty.call(config, FARM_RESOLVED_CUSTOM_CONTEXT);
-}
-function normalizeDeployTarget(target) {
-  if (!target) return void 0;
-  if (target === "cloudflare-pages" || target === "cloudflare_pages") return "cloudflare";
-  if (target === "node-server" || target === "nitro") return "node";
-  return target;
-}
-function getPresetForDeployTarget(target) {
-  switch (normalizeDeployTarget(target)) {
-    case "vercel":
-      return "vercel";
-    case "cloudflare":
-      return "cloudflare-pages";
-    case "netlify":
-      return "netlify";
-    case "node":
-      return "node-server";
-    default:
-      return void 0;
-  }
-}
-function getDeployTargetForPreset(preset) {
-  if (!preset) return void 0;
-  if (preset === "vercel" || preset === "vercel-edge") return "vercel";
-  if (preset === "cloudflare" || preset === "cloudflare-pages" || preset === "cloudflare-module") {
-    return "cloudflare";
-  }
-  if (preset === "netlify" || preset === "netlify-edge") return "netlify";
-  if (preset === "node-server") return "node";
-  return void 0;
-}
-var NETLIFY_INTERNAL_FUNCTIONS_DIR = ".netlify/functions-internal";
-function getDefaultDeployOutputDir(target, preset, distDir) {
-  const normalizedTarget = normalizeDeployTarget(target) || getDeployTargetForPreset(preset);
-  if (normalizedTarget === "vercel") return ".vercel/output";
-  if (normalizedTarget === "netlify" && (!preset || preset === "netlify")) {
-    return NETLIFY_INTERNAL_FUNCTIONS_DIR;
-  }
-  return `${distDir}/.output`;
-}
-function resolveDeployOutputPath(root, outputDir) {
-  return path3.isAbsolute(outputDir) ? outputDir : path3.join(root, outputDir);
-}
-var PLATFORM_BUILD_ENV_TARGETS = [
-  ["VERCEL", "vercel"],
-  ["NETLIFY", "netlify"],
-  ["CF_PAGES", "cloudflare"]
-];
-function detectPlatformDeployTarget(env = process.env) {
-  for (const [key, target] of PLATFORM_BUILD_ENV_TARGETS) {
-    const value = env[key]?.trim().toLowerCase();
-    if (value === "1" || value === "true") return target;
-  }
-  return void 0;
-}
-var warnedPlatformMismatches = /* @__PURE__ */ new Set();
-function resolveDeployConfig(config, overrides = {}) {
-  const deploy = config.deploy || {};
-  const distDir = config.distDir || ".farm";
-  const overrideTarget = normalizeDeployTarget(overrides.target);
-  let target = overrideTarget ? overrideTarget : overrides.preset ? getDeployTargetForPreset(overrides.preset) : normalizeDeployTarget(deploy.target);
-  const detectedTarget = detectPlatformDeployTarget(overrides.env);
-  if (detectedTarget) {
-    const hasExplicitSelection = Boolean(
-      target || overrides.preset || deploy.preset || config.preset
-    );
-    if (!hasExplicitSelection) {
-      target = detectedTarget;
-      if (!warnedPlatformMismatches.has(`select:${detectedTarget}`)) {
-        warnedPlatformMismatches.add(`select:${detectedTarget}`);
-        logger.info(
-          `Detected ${detectedTarget} build environment; using the ${detectedTarget} preset. Set deploy.target in farm.config.ts to override.`
-        );
-      }
-    }
-  }
-  const configuredPreset = deploy.preset || config.preset;
-  const overrideTargetPreset = overrideTarget && getDeployTargetForPreset(configuredPreset) !== overrideTarget ? getPresetForDeployTarget(overrideTarget) : void 0;
-  const preset = overrides.preset || overrideTargetPreset || configuredPreset || getPresetForDeployTarget(target) || "node-server";
-  const resolvedTarget = target || getDeployTargetForPreset(preset);
-  if (detectedTarget && resolvedTarget !== detectedTarget) {
-    const mismatchKey = `mismatch:${resolvedTarget}:${detectedTarget}`;
-    if (!warnedPlatformMismatches.has(mismatchKey)) {
-      warnedPlatformMismatches.add(mismatchKey);
-      logger.warn(
-        `The configured deploy target "${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.`
-      );
-    }
-  }
-  const platformOutput = resolvedTarget === "vercel" ? deploy.vercel?.outputDirectory : resolvedTarget === "cloudflare" ? deploy.cloudflare?.outputDir : resolvedTarget === "netlify" ? deploy.netlify?.outputDir : void 0;
-  const outputDir = overrides.outputDir || deploy.outputDir || deploy.output || platformOutput || getDefaultDeployOutputDir(resolvedTarget, preset, distDir);
-  return {
-    ...deploy,
-    target: resolvedTarget,
-    preset,
-    outputDir
-  };
-}
-function resolveMigrationsConfig(migrations) {
-  if (!migrations) return { commands: [] };
-  if (Array.isArray(migrations)) return { commands: migrations };
-  return { commands: migrations.commands || [] };
-}
-var DOCS_CONFIG_FILENAMES = [
-  "docs.config.ts",
-  "docs.config.tsx",
-  "docs.config.mts",
-  "docs.config.cts",
-  "docs.config.js",
-  "docs.config.jsx",
-  "docs.config.mjs",
-  "docs.config.cjs",
-  "docs.json"
-];
-function normalizeDocsRoute(value, fallback = "/docs") {
-  const raw = (value || fallback).trim();
-  if (!raw || raw === "/") return "/";
-  const normalized = raw.replace(/\\/g, "/").replace(/\/+/g, "/").replace(/^\/?/, "/").replace(/\/+$/, "");
-  return normalized || "/";
-}
-function docsRouteToEntry(route) {
-  const entry = route.replace(/^\/+/, "").replace(/\/+$/, "");
-  return entry || "docs";
-}
-function normalizeDocsContentDir(value) {
-  if (!value) return void 0;
-  const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
-  return normalized || void 0;
-}
-async function inferDocsContentDir(root, srcDir, entry) {
-  const { existsSync } = await import("fs");
-  const contentDir = path3.resolve(root, srcDir, "app", entry);
-  if (!existsSync(contentDir)) return void 0;
-  const relativeContentDir = path3.relative(root, contentDir);
-  if (relativeContentDir.startsWith("..") || path3.isAbsolute(relativeContentDir)) return void 0;
-  return normalizeDocsContentDir(relativeContentDir);
-}
-function isRecord(value) {
-  return !!value && typeof value === "object" && !Array.isArray(value);
-}
-function cloneSerializable(value, seen = /* @__PURE__ */ new WeakSet()) {
-  if (value === null) return null;
-  const valueType = typeof value;
-  if (valueType === "string" || valueType === "number" || valueType === "boolean") {
-    return value;
-  }
-  if (valueType === "undefined" || valueType === "function" || valueType === "symbol") {
-    return void 0;
-  }
-  if (Array.isArray(value)) {
-    return value.map((item) => cloneSerializable(item, seen)).filter((item) => item !== void 0);
-  }
-  if (value instanceof Date) {
-    return value.toISOString();
-  }
-  if (isRecord(value)) {
-    if (seen.has(value)) return void 0;
-    seen.add(value);
-    const output = {};
-    for (const [key, nestedValue] of Object.entries(value)) {
-      const clonedValue = cloneSerializable(nestedValue, seen);
-      if (clonedValue !== void 0) {
-        output[key] = clonedValue;
-      }
-    }
-    return output;
-  }
-  return void 0;
-}
-function omitUndefined(value) {
-  return Object.fromEntries(
-    Object.entries(value).filter(([, entry]) => entry !== void 0)
-  );
-}
-function sanitizeDocsConfig(config) {
-  return cloneSerializable(config) || {};
-}
-async function findDocsConfigPath(rootDir, configPath) {
-  const { existsSync } = await import("fs");
-  const root = path3.resolve(rootDir || process.cwd());
-  if (configPath) {
-    const resolvedPath = path3.isAbsolute(configPath) ? configPath : path3.join(root, configPath);
-    if (!existsSync(resolvedPath)) {
-      throw new Error(`Could not find docs config at ${configPath}.`);
-    }
-    return path3.resolve(resolvedPath);
-  }
-  for (const filename of DOCS_CONFIG_FILENAMES) {
-    const resolvedPath = path3.join(root, filename);
-    if (existsSync(resolvedPath)) {
-      return resolvedPath;
-    }
-  }
-  return void 0;
-}
-async function loadDocsConfig(rootDir, configPath) {
-  const fs = await import("fs/promises");
-  const { pathToFileURL: pathToFileURL3 } = await import("url");
-  const root = path3.resolve(rootDir || process.cwd());
-  const resolvedPath = await findDocsConfigPath(root, configPath);
-  if (!resolvedPath) return void 0;
-  try {
-    if (resolvedPath.endsWith(".json")) {
-      const content = await fs.readFile(resolvedPath, "utf8");
-      return { config: JSON.parse(content), configPath: resolvedPath };
-    }
-    const configCacheDir = path3.join(root, ".farm", ".config-loader");
-    await fs.mkdir(configCacheDir, { recursive: true });
-    const modulePath = path3.join(
-      configCacheDir,
-      `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
-    );
-    await bundleNodeModule({
-      root,
-      entry: resolvedPath,
-      outfile: modulePath,
-      target: `node${process.versions.node.split(".")[0]}`,
-      externalPackages: true
-    });
-    const moduleUrl = pathToFileURL3(modulePath).href + `?t=${Date.now()}`;
-    let importedConfig;
-    try {
-      importedConfig = await import(
-        /* @vite-ignore */
-        moduleUrl
-      );
-    } finally {
-      await fs.unlink(modulePath).catch(() => void 0);
-    }
-    return {
-      config: importedConfig.default || importedConfig,
-      configPath: resolvedPath
-    };
-  } catch (error) {
-    const relativePath = path3.relative(root, resolvedPath) || resolvedPath;
-    const message = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to load docs config from ${relativePath}: ${message}`);
-  }
-}
-async function resolveDocsConfig(userDocs, options = {}) {
-  const root = options.root || process.cwd();
-  if (userDocs === false) {
-    return {
-      enabled: false,
-      entry: "/docs",
-      config: { entry: "docs", docsPath: "/docs" }
-    };
-  }
-  const docsOptions = isRecord(userDocs) ? userDocs : {};
-  if (docsOptions.enabled === false) {
-    return {
-      enabled: false,
-      entry: "/docs",
-      config: { entry: "docs", docsPath: "/docs" }
-    };
-  }
-  const loadedConfig = await loadDocsConfig(root, docsOptions.configPath);
-  const hasExplicitDocsConfig = userDocs === true || isRecord(userDocs);
-  if (!hasExplicitDocsConfig && !loadedConfig) {
-    return {
-      enabled: false,
-      entry: "/docs",
-      config: { entry: "docs", docsPath: "/docs" }
-    };
-  }
-  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,
-    roots: void 0
-  });
-  const loadedDocsConfig = sanitizeDocsConfig(fileDocsConfig);
-  const mergedDocsConfig = {
-    ...loadedDocsConfig,
-    ...inlineDocsConfig,
-    ...directDocsConfig
-  };
-  const runtimeDocsConfig = {
-    ...fileDocsConfig,
-    ...inlineRawDocsConfig,
-    ...omitUndefined({
-      ...docsOptions,
-      adapter: void 0,
-      enabled: void 0,
-      prerender: void 0,
-      config: void 0,
-      configPath: void 0,
-      roots: void 0
-    })
-  };
-  const explicitRoute = typeof docsOptions.entry === "string" ? docsOptions.entry : void 0;
-  const configuredDocsPath = typeof mergedDocsConfig.docsPath === "string" ? mergedDocsConfig.docsPath : void 0;
-  const configuredEntry = typeof mergedDocsConfig.entry === "string" ? mergedDocsConfig.entry : void 0;
-  const entryRoute = normalizeDocsRoute(
-    configuredDocsPath || explicitRoute || (configuredEntry ? `/${configuredEntry}` : void 0)
-  );
-  const docsEntry = explicitRoute && explicitRoute.startsWith("/") ? docsRouteToEntry(explicitRoute) : docsRouteToEntry(configuredEntry || entryRoute);
-  const configuredContentDir = normalizeDocsContentDir(
-    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: {
-      ...mergedDocsConfig,
-      entry: docsEntry,
-      docsPath: entryRoute,
-      ...contentDir ? { contentDir } : {}
-    },
-    runtimeConfig: {
-      ...runtimeDocsConfig,
-      entry: docsEntry,
-      docsPath: entryRoute,
-      ...contentDir ? { contentDir } : {}
-    },
-    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`);
-    if (redirect.statusCode !== void 0 && !isFarmRedirectStatus(redirect.statusCode)) {
-      throw new RangeError(
-        `${field}[${index}].statusCode must be one of 301, 302, 303, 307, or 308.`
-      );
-    }
-  }
-  return redirects;
-}
-function validateMiddlewareConfig(middleware) {
-  for (const entry of Array.isArray(middleware) ? middleware : middleware ? [middleware] : []) {
-    compileMiddlewareConfig({ matcher: entry.matcher, exclude: entry.exclude });
-  }
-  return middleware;
-}
-function validateConfigRouteSources(routes, field) {
-  for (const [index, route] of routes.entries()) {
-    validateConfigRouteSource(route.source, `${field}[${index}].source`);
-  }
-  return routes;
-}
-async function resolveConfig(userConfig, mode) {
-  resolveFarmServerComponentsMode(userConfig.experimental?.serverComponents);
-  const projectRoot = userConfig.root || process.cwd();
-  const layerResolution = await resolveFarmLayers(userConfig, {
-    root: projectRoot,
-    mode
-  });
-  userConfig = layerResolution.config;
-  if (userConfig.typescript !== void 0) {
-    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) {
-    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.'
-    );
-  }
-  if (isReactRenderer(resolveFarmRenderer(userConfig.renderer))) {
-    userConfig = await applyFarmDocsFrameworkAutoDetection(userConfig, {
-      root: userConfig.root || projectRoot
-    });
-  }
-  const redirects = validateRedirectConfigs(
-    typeof userConfig.redirects === "function" ? await userConfig.redirects() : userConfig.redirects || [],
-    "redirects"
-  );
-  const rewrites = typeof userConfig.rewrites === "function" ? await userConfig.rewrites() : userConfig.rewrites || [];
-  validateConfigRouteSources(rewrites, "rewrites");
-  const headers = typeof userConfig.headers === "function" ? await userConfig.headers() : userConfig.headers || [];
-  validateConfigRouteSources(headers, "headers");
-  const routeRules = normalizeRouteRules(userConfig.routeRules);
-  const routeRuleRedirects = routeRulesToRedirects(routeRules);
-  const routeRuleHeaders = routeRulesToHeaders(routeRules);
-  const security = resolveFarmSecurityConfig(userConfig.security);
-  const securityHeader = getFarmSecurityHeader(security);
-  if (farmCspBlocksFrameworkInlineScripts(security)) {
-    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."
-    );
-  }
-  const root = userConfig.root || process.cwd();
-  const desktopSetup = await globalThis[/* @__PURE__ */ Symbol.for("@farm.js/core/desktop-setup")]?.(userConfig, root, mode);
-  if (desktopSetup) userConfig = desktopSetup.userConfig;
-  const deploy = resolveDeployConfig(userConfig, desktopSetup?.deploy);
-  const srcDir = userConfig.srcDir || "src";
-  setFarmProjectSourceDir(root, srcDir);
-  const docs = await resolveDocsConfig(userConfig.docs, { root, srcDir });
-  const md = resolveMarkdownConfig(userConfig.md);
-  const mdx = resolveMdxConfig(userConfig.mdx);
-  const env = resolveEnv(userConfig.env, process.env);
-  setEnv(env);
-  const api = await resolveFarmAPIConfig(userConfig.api, { root, mode, env });
-  const auth = resolveFarmAuthConfig(userConfig.auth);
-  const mcp = resolveFarmMCPConfig(userConfig.mcp);
-  if (auth.enabled && userConfig.integrations?.auth) {
-    throw new Error(
-      "Choose either the top-level `auth` config or `integrations.auth`; they cannot both own the auth route."
-    );
-  }
-  const nativeAuthIntegration = await resolveFarmAuthIntegration(auth, {
-    root,
-    mode
-  });
-  const nativeMCPPlugin = await resolveFarmMCPPlugin(mcp, { root });
-  if (nativeMCPPlugin && userConfig.plugins?.some((plugin) => plugin?.name === "farm:api-mcp")) {
-    throw new Error(
-      "Choose either the top-level `mcp` config or `apiMcp()` in `plugins`; they configure the same MCP transport."
-    );
-  }
-  const integrations = nativeAuthIntegration ? { ...userConfig.integrations, auth: nativeAuthIntegration } : userConfig.integrations || {};
-  const generateBuildId = userConfig.generateBuildId || (() => `build-${Date.now()}`);
-  const deploymentId = normalizeFarmDeploymentId(
-    userConfig.deploymentId || process.env.FARM_DEPLOYMENT_ID || process.env.VERCEL_GIT_COMMIT_SHA || process.env.CF_PAGES_COMMIT_SHA || (mode === "production" ? await generateBuildId() : "development")
-  );
-  const basePath = normalizeFarmConfigBasePath(userConfig.basePath);
-  const mobileSessionPlugin = userConfig.mobile !== void 0 && userConfig.mobile !== null ? (await import("./session-IGEDQ5PY.mjs")).createFarmMobileSessionPlugin({
-    basePath,
-    integrations: () => integrations
-  }) : null;
-  const openapi = {
-    enabled: false,
-    route: "/docs/reference",
-    specRoute: "/openapi.json",
-    title: "API Documentation",
-    description: "Auto-generated API documentation",
-    version: "1.0.0",
-    ...userConfig.openapi
-  };
-  if (openapi.route !== void 0) validateConfigRouteSource(openapi.route, "openapi.route");
-  if (openapi.specRoute) validateConfigRouteSource(openapi.specRoute, "openapi.specRoute");
-  const resolved = {
-    [FARM_RESOLVED_CUSTOM_CONTEXT]: typeof userConfig.context === "function",
-    root,
-    srcDir,
-    extends: userConfig.extends || [],
-    layers: layerResolution.layers,
-    outDir: userConfig.outDir || "dist",
-    basePath,
-    renderer: resolveFarmRenderer(userConfig.renderer),
-    preset: deploy.preset || "node-server",
-    deploy,
-    docs,
-    md,
-    mdx,
-    migrations: resolveMigrationsConfig(userConfig.migrations),
-    cron: resolveCronConfig(userConfig.cron),
-    workflows: resolveWorkflowsConfig(userConfig.workflows),
-    api,
-    observability: userConfig.observability ?? false,
-    telemetry: userConfig.telemetry !== false,
-    analytics: userConfig.analytics !== false,
-    devtools: resolveFarmDevtoolsConfig(userConfig.devtools, mode),
-    storage: userConfig.storage || {},
-    schema: resolveSchemaConfig(userConfig.schema),
-    cache: userConfig.cache || {},
-    auth,
-    mcp,
-    suppressLintOnLink: userConfig.suppressLintOnLink ?? false,
-    experimental: {
-      serverComponents: false,
-      serverActions: false,
-      // Islands mode hydrates client components as islands (RFC 0003); an app can still pick
-      // isolatedClientHydration itself.
-      isolatedClientHydration: resolveFarmServerComponentsMode(userConfig.experimental?.serverComponents) === "islands" ? "enabled" : "off",
-      ppr: false,
-      ...userConfig.experimental
-    },
-    agent: resolveFarmAgentConfig(userConfig.agent, { docs: docs.enabled }),
-    desktop: desktopSetup?.desktop ?? null,
-    ...userConfig.mobile !== void 0 ? { mobileClient: true } : {},
-    plugins: [
-      ...mobileSessionPlugin ? [mobileSessionPlugin] : [],
-      ...resolveIntegrationPlugins(integrations),
-      ...nativeMCPPlugin ? [nativeMCPPlugin] : [],
-      ...userConfig.plugins || []
-    ],
-    integrations,
-    trailingSlash: userConfig.trailingSlash ?? false,
-    redirects: () => [...redirects, ...routeRuleRedirects],
-    rewrites: () => rewrites,
-    headers: () => [
-      ...headers,
-      ...routeRuleHeaders,
-      ...securityHeader ? [{ source: "/*", headers: [securityHeader] }] : []
-    ],
-    routeRules,
-    images: resolveFarmImageConfig(userConfig.images),
-    performance: resolveFarmPerformanceConfig(userConfig.performance),
-    theme: resolveFarmThemeConfig(userConfig.theme, basePath),
-    publicDir: userConfig.publicDir || "public",
-    i18n: resolveFarmI18nConfig(userConfig.i18n, { root, mode, basePath }),
-    openapi,
-    middleware: validateMiddlewareConfig(userConfig.middleware) || {},
-    notFound: userConfig.notFound || {},
-    context: userConfig.context || (() => void 0),
-    server: resolveFarmServerConfig(userConfig.server),
-    serverActions: resolveServerActionsConfig(userConfig.serverActions),
-    security,
-    deploymentId,
-    distDir: userConfig.distDir || ".farm",
-    generateBuildId,
-    compress: userConfig.compress ?? true,
-    devIndicators: resolveFarmDevIndicatorsConfig(userConfig.devIndicators, mode),
-    serverRuntimeConfig: userConfig.serverRuntimeConfig || {},
-    publicRuntimeConfig: userConfig.publicRuntimeConfig || {},
-    env,
-    vite: typeof userConfig.vite === "function" ? userConfig.vite({}) : userConfig.vite || {}
-  };
-  assertPluginDependencies(resolved.plugins, resolved.integrations);
-  return resolved;
-}
-function formatConfigLoadError(error) {
-  if (error && (typeof error === "object" || typeof error === "function")) {
-    for (const property of ["message", "stack", "name"]) {
-      try {
-        const value = Reflect.get(error, property);
-        if (typeof value === "string" && value) return value;
-      } catch {
-      }
-    }
-  }
-  try {
-    return String(error);
-  } catch {
-    return "Unknown config loader error";
-  }
-}
-async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "production" ? "production" : "development", loadEnvironment) {
-  const { existsSync } = await import("fs");
-  const loadEnv = loadEnvironment || (await import("vite")).loadEnv;
-  const root = rootDir || process.cwd();
-  const loadedEnv = loadEnv(mode, root, "");
-  for (const [key, value] of Object.entries(loadedEnv)) {
-    if (process.env[key] === void 0) {
-      process.env[key] = value;
-    }
-  }
-  if (configPath) {
-    const explicitPath = path3.resolve(
-      path3.isAbsolute(configPath) ? configPath : path3.join(root, configPath)
-    );
-    if (!existsSync(explicitPath)) {
-      throw new Error(`Config file not found at ${configPath} (resolved to ${explicitPath}).`);
-    }
-  }
-  const searchPaths = [
-    configPath,
-    "farm.config.ts",
-    "farm.config.mts",
-    "farm.config.js",
-    "farm.config.mjs",
-    "config.ts",
-    "config.mts",
-    "config.js",
-    "config.mjs"
-  ].filter(Boolean);
-  for (const relativePath of searchPaths) {
-    try {
-      const absolutePath = path3.isAbsolute(relativePath) ? relativePath : path3.join(root, relativePath);
-      const normalizedPath = path3.resolve(absolutePath);
-      if (!existsSync(normalizedPath)) {
-        continue;
-      }
-      const loadedConfig = await loadFarmConfigFile(normalizedPath, { root });
-      return loadedConfig.root === void 0 ? { ...loadedConfig, root } : loadedConfig;
-    } catch (error) {
-      const configError = new Error(
-        `Failed to load config from ${relativePath}: ${formatConfigLoadError(error)}`
-      );
-      configError.cause = error;
-      throw configError;
-    }
-  }
-  return void 0;
-}
-
-export {
-  resolveFarmMCPConfig,
-  resolveFarmMCPPlugin,
-  hasCustomFarmRouteContext,
-  isResolvedFarmConfig,
-  normalizeDeployTarget,
-  getPresetForDeployTarget,
-  getDeployTargetForPreset,
-  getDefaultDeployOutputDir,
-  resolveDeployOutputPath,
-  resolveDeployConfig,
-  resolveMigrationsConfig,
-  resolveDocsConfig,
-  resolveConfig,
-  loadConfig
-};