@farm.js/core 0.1.19 → 0.1.21

package/dist/{chunk-FVZGEVTO.mjs → chunk-5L6NBNHI.mjs}

@@ -7,7 +7,7 @@ import {
 import {
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler
-} from "./chunk-QBPKKQTD.mjs";
+} from "./chunk-W7MZXRXM.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -31,7 +31,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-V4AICMQA.mjs";
+} from "./chunk-RMIJFZU3.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-F5D4XEAS.mjs";
@@ -52,7 +52,6 @@ import {
   farmPluginMayAffectRuntimePath,
   generateClientCachePersistenceCode,
   generateFarmClientPluginEntryCode,
-  generateFarmDocsAdapterClientRuntime,
   generateFarmIntegrationProviderClientCode,
   generateFarmIntegrationProviderServerModules,
   getClientModuleHydrationPlan,
@@ -64,26 +63,30 @@ import {
   resolveFarmClientCacheAdapterEntry,
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath
-} from "./chunk-WZXN4R5Y.mjs";
+} from "./chunk-53G3OLTA.mjs";
 import {
   findRequestBoundSourceBlockers,
   generateFarmTypeArtifacts,
   parseRouteRenderingDirective,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-2ANEVVF7.mjs";
+} from "./chunk-NRS46D4L.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
 import {
   farmEnvironmentFunctionsPlugin
 } from "./chunk-ZSH2Y4LN.mjs";
+import {
+  generateFarmDocsAdapterClientRuntime,
+  getFarmDocsAdapterConfigModule
+} from "./chunk-VVBO3QH7.mjs";
 import {
   resolveFarmDocsFontAssets,
   toFarmDocsPublicFontAssets
 } from "./chunk-TVGP4BBZ.mjs";
 import {
   routeRulesToNitroRouteRules
-} from "./chunk-7WPA7GBZ.mjs";
+} from "./chunk-GHFS7RUB.mjs";
 import {
   getFarmAppDirectories
 } from "./chunk-IILNZK5G.mjs";
@@ -124,10 +127,10 @@ import {
 } from "./chunk-JLCQGPXE.mjs";
 import {
   appendMiddlewareRoutePath
-} from "./chunk-57J3Y7Y3.mjs";
+} from "./chunk-TIKNUAU7.mjs";
 import {
   APIRouteManager
-} from "./chunk-ATERBVHQ.mjs";
+} from "./chunk-CQHFU55R.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-FV45CKBC.mjs";
@@ -143,7 +146,7 @@ import {
   normalizeFarmRouteRuntimeConfig,
   resolveFarmRouteRuleRuntimeConfig,
   resolveFarmRouteRuntimeConfig
-} from "./chunk-FS7FLPOG.mjs";
+} from "./chunk-2J7W2WND.mjs";
 import {
   logger,
   toPosixPath,
@@ -1576,6 +1579,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
   ]);
   const nitroBuilderResultPromise = preloadFarmNitroBuilder();
   logger.info(`\u{1F69C} Building Farm.js application (universal) with preset: ${preset}...`);
+  const rendererBuild = options.rendererBuildLifetime ? void 0 : new AbortController();
+  const rendererBuildLifetime = options.rendererBuildLifetime ?? rendererBuild.signal;
   try {
     const routeRuntimeManifestPromise = options.routeRuntimeManifest ? Promise.resolve(options.routeRuntimeManifest) : createFarmRouteRuntimeManifest({
       config,
@@ -1658,7 +1663,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       layoutRoutes,
       routeSlots,
       isolatedClientBoundaryModules,
-      hydrationPlanCache
+      hydrationPlanCache,
+      rendererBuildLifetime
     ), "buildClientBundle");
     const buildSSRBundle = /* @__PURE__ */ __name(() => buildSSRInMemory(
       productionVite,
@@ -1672,7 +1678,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       layoutRoutes,
       routeSlots,
       isolatedClientBoundaryModules,
-      hydrationPlanCache
+      hydrationPlanCache,
+      rendererBuildLifetime
     ), "buildSSRBundle");
     let clientBuildResult;
     let ssrBuildResult;
@@ -1708,7 +1715,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
           layoutRoutes,
           routeSlots,
           isolatedClientBoundaryModules,
-          hydrationPlanCache
+          hydrationPlanCache,
+          rendererBuildLifetime
         );
       } catch (retryError) {
         if (!(retryError instanceof IncompleteClientBuildOutputError)) throw retryError;
@@ -1763,6 +1771,8 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
     }
     logger.error(`\u274C Build failed: ${error}`);
     throw error;
+  } finally {
+    rendererBuild?.abort();
   }
 }
 __name(buildUniversal, "buildUniversal");
@@ -1866,7 +1876,7 @@ function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, optio
   return { ...plan, isolatedBoundaries: [...plan.isolatedBoundaries] };
 }
 __name(getCachedClientModuleHydrationPlan, "getCachedClientModuleHydrationPlan");
-async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map()) {
+async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map(), rendererBuildLifetime) {
   const viteBuild = productionVite.build;
   const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
   const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
@@ -2114,14 +2124,16 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     config.trailingSlash,
     getIntegrationProviders(config.integrations),
     config.basePath,
-    generateClientCachePersistenceCode(resolveFarmClientCacheAdapterEntry(root, config.cache))
+    generateClientCachePersistenceCode(resolveFarmClientCacheAdapterEntry(root, config.cache)),
+    adapterOwnsDocsRuntime ? getFarmDocsAdapterConfigModule(config.docs) : void 0
   );
   await fs.writeFile(clientEntryPath, clientHydrationCode);
   const hasScopedPostcssConfig = hasProjectPostcssConfig(root);
   let postcssSearchPath;
   let tailwindVitePlugin = void 0;
   const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, root, {
-    ssr: false
+    ssr: false,
+    buildLifetime: rendererBuildLifetime
   });
   if (hasScopedPostcssConfig) {
     logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
@@ -3034,7 +3046,7 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
     secure: false
   },
   direction: {}
-}, plugins = [], renderer = REACT_RENDERER, publicRuntimeConfig = void 0, trailingSlash = false, integrationProviders = [], basePath = "/", clientCachePersistence = { imports: "", init: "" }) {
+}, plugins = [], renderer = REACT_RENDERER, publicRuntimeConfig = void 0, trailingSlash = false, integrationProviders = [], basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule) {
   const toImportPath = /* @__PURE__ */ __name((targetPath) => targetPath.replace(/\\/g, "/"), "toImportPath");
   const clientPluginEntry = generateFarmClientPluginEntryCode(
     plugins,
@@ -3107,7 +3119,10 @@ function isFarmDocsPath() {
   return false;
 }
 `;
-  const docsAdapterRuntime = generateFarmDocsAdapterClientRuntime(docsAdapterReact);
+  const docsAdapterRuntime = generateFarmDocsAdapterClientRuntime(
+    docsAdapterReact,
+    docsConfigModule
+  );
   if (clientPages.length === 0 && clientRouteSlots.length === 0 && !providerClientCode.hasProviders) {
     return `
 // Farm.js Client Runtime (no client components)
@@ -4417,7 +4432,7 @@ void hydrate();
 `.trim();
 }
 __name(generateClientHydrationEntry, "generateClientHydrationEntry");
-async function buildSSRInMemory(productionVite, config, root, routeManager, apiRouteManager, serverRenderer, preset, collectedPageRoutes, collectedLayoutRoutes, collectedRouteSlots, isolatedClientBoundaryModules, hydrationPlanCache) {
+async function buildSSRInMemory(productionVite, config, root, routeManager, apiRouteManager, serverRenderer, preset, collectedPageRoutes, collectedLayoutRoutes, collectedRouteSlots, isolatedClientBoundaryModules, hydrationPlanCache, rendererBuildLifetime) {
   const viteBuild = productionVite.build;
   const { farmPlugin } = await import("./vite.mjs");
   const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
@@ -4432,7 +4447,8 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   let postcssConfigDir;
   let tailwindVitePlugin = void 0;
   const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, root, {
-    ssr: true
+    ssr: true,
+    buildLifetime: rendererBuildLifetime
   });
   if (!hasScopedPostcssConfig) {
     postcssConfigDir = await fs.mkdtemp(path5.join(os.tmpdir(), "farm-postcss-"));
@@ -4820,7 +4836,10 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
     ...docs,
     contentDir: void 0,
     ...precompiled ? { configPath: void 0 } : {},
-    config: void 0
+    config: void 0,
+    // React elements and functions do not survive JSON. The server bundle imports the
+    // config module for those instead (see farmDocsConfigModule).
+    runtimeConfig: void 0
   };
   const nestedConfig = {
     ...docs.config,
@@ -4841,7 +4860,7 @@ function generateFarmDocsRuntimeConfigExpression(docs, precompiled = false) {
         contentDir: farmDocsBundledContentDir,
       },
     }
-  : ${JSON.stringify(docs)}`;
+  : ${JSON.stringify({ ...docs, runtimeConfig: void 0 })}`;
 }
 __name(generateFarmDocsRuntimeConfigExpression, "generateFarmDocsRuntimeConfigExpression");
 function toVirtualEntryImportSpecifier(modulePath) {
@@ -5115,6 +5134,7 @@ function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlot
   const adapterOwnsDocsRuntime = Boolean(
     isReactRenderer(config.renderer) && config.docs?.enabled && config.docs.adapter?.server && config.docs.adapter.react
   );
+  const docsConfigModulePath = adapterOwnsDocsRuntime && !hasPrecompiledDocs && config.docs.configPath && !config.docs.configPath.endsWith(".json") ? config.docs.configPath : void 0;
   const hasIsolatedClientGraphRuntime = isReactRenderer(config.renderer) && isolatedClientBoundaryModules.size > 0;
   const rendererStreamingCapabilities = getFarmRendererStreamingCapabilitiesForRuntime(
     config.renderer,
@@ -5475,7 +5495,8 @@ const isFarmDocsAPIRequest = (requestOrPathname) => {
   return pathname === apiPath || pathname.startsWith(apiPath + "/");
 };` : adapterOwnsDocsRuntime ? `import { isFarmDocsAPIRequest } from "@farm.js/core/docs";
 import { createFarmDocsRuntimeHandler as createFarmDocsAdapterRuntimeHandler } from ${JSON.stringify(config.docs.adapter.server)};
-import * as FarmDocsAdapterReact from ${JSON.stringify(config.docs.adapter.react)};` : `import { createFarmDocsAPIHandler, createFarmDocsHandler, isFarmDocsAPIRequest } from "@farm.js/core/docs";` : "";
+import * as FarmDocsAdapterReact from ${JSON.stringify(config.docs.adapter.react)};${docsConfigModulePath ? `
+import * as farmDocsConfigModule from ${toVirtualEntryImportSpecifier(docsConfigModulePath)};` : ""}` : `import { createFarmDocsAPIHandler, createFarmDocsHandler, isFarmDocsAPIRequest } from "@farm.js/core/docs";` : "";
   const docsFontImport = config.docs?.enabled && !hasPrecompiledDocs ? `import { resolveFarmLayoutFonts } from "@farm.js/core/font";` : "";
   const docsRuntimeImport = config.docs?.enabled && !hasPrecompiledDocs ? `import { existsSync as farmDocsExistsSync } from "node:fs";
 import { dirname as farmDocsDirname, join as farmDocsJoin } from "node:path";
@@ -5892,7 +5913,7 @@ globalThis.__FARM_DOCS_RUNTIME_CONFIG__ = {
 };
 const farmDocsPrecompiledRuntime = ${hasPrecompiledDocs ? `createFarmDocsPrecompiledRuntime(${JSON.stringify(farmDocsPrecompiledManifest)})` : "null"};
 const farmDocsHandler = ${config.docs?.enabled ? hasPrecompiledDocs ? "farmDocsPrecompiledRuntime.handleDocsRequest" : adapterOwnsDocsRuntime ? `createFarmDocsAdapterRuntimeHandler({
-  ...farmDocsResolvedConfig.config,
+  ${docsConfigModulePath ? "...(farmDocsConfigModule.default || farmDocsConfigModule),\n  ...farmDocsResolvedConfig.configOverrides," : "...farmDocsResolvedConfig.config,"}
   entry: farmDocsResolvedConfig.config?.entry || String(farmDocsResolvedConfig.entry || "/docs").replace(/^\\/+|\\/+$/g, "") || "docs",
   docsPath: farmDocsResolvedConfig.entry,
   contentDir: farmDocsResolvedConfig.contentDir || farmDocsResolvedConfig.config?.contentDir,
@@ -6312,13 +6333,32 @@ function createFarmDocumentStream(contentStream, prefix, suffix, onComplete) {
 }
 
 function stripFarmDocumentWrappers(markup) {
-  let output = markup.replace(/^\\s+/, "");
+  return peelFarmDocumentPrefix(markup).inner;
+}
+
+// Farm's display:contents wrappers, and the head elements React 19 hoists in front of them
+// (charset, viewport, preloads, titles) when the layout's <html> is not the render root.
+function peelFarmDocumentPrefix(markup) {
+  let inner = markup.replace(/^\\s+/, "");
+  let hoisted = "";
   const wrapper = /^<div\\b[^>]*style=["']display\\s*:\\s*contents["'][^>]*>/i;
+  const hoistable = /^(?:<(?:meta|link|base)\\b[^>]*>|<title\\b[^>]*>[\\s\\S]*?<\\/title>)/i;
   let match;
-  while ((match = wrapper.exec(output))) {
-    output = output.slice(match[0].length).replace(/^\\s+/, "");
+  while ((match = wrapper.exec(inner) || hoistable.exec(inner))) {
+    if (!/^<div/i.test(match[0])) hoisted += match[0];
+    inner = inner.slice(match[0].length).replace(/^\\s+/, "");
   }
-  return output;
+  return { inner: inner, hoisted: hoisted };
+}
+
+function restoreFarmHoistedHead(document, hoisted) {
+  if (!hoisted) return document;
+  if (/<head[\\s>]/i.test(document)) {
+    return document.replace(/<head\\b[^>]*>/i, function(open) { return open + hoisted; });
+  }
+  return document.replace(/<html\\b[^>]*>/i, function(open) {
+    return open + "<head>" + hoisted + "</head>";
+  });
 }
 
 function opensFarmFullDocument(markup) {
@@ -6328,6 +6368,7 @@ function opensFarmFullDocument(markup) {
 
 function extractFarmFullDocument(markup) {
   if (!opensFarmFullDocument(markup)) return null;
+  const hoisted = peelFarmDocumentPrefix(markup).hoisted;
   const start = markup.search(/<!doctype|<html[\\s>]/i);
   const lower = markup.toLowerCase();
   let closeIndex = lower.lastIndexOf("</html>");
@@ -6355,7 +6396,7 @@ function extractFarmFullDocument(markup) {
       return streamedTail + "</body>";
     });
   }
-  return document;
+  return restoreFarmHoistedHead(document, hoisted);
 }
 
 function ensureFarmDocumentHead(markup) {
@@ -9380,7 +9421,7 @@ export default async function farmNitroEventHandler(event) {
       else process.env[FARM_PRERENDER_ENV] = previousPrerender;
     }
   }
-  const sharpRuntimeStagePromise = imageRuntime === "node" ? stageSharpRuntime(config, root, distDir, fs) : Promise.resolve(null);
+  const sharpRuntimeStagePromise = imageRuntime === "node" ? stageSharpRuntime(config, root, distDir, fs, preset) : Promise.resolve(null);
   const [nitroBuildResult, sharpRuntimeStageResult] = await Promise.allSettled([
     nitroBuilder.build(nitroInstance),
     sharpRuntimeStagePromise
@@ -9398,7 +9439,7 @@ export default async function farmNitroEventHandler(event) {
   if (sharpRuntimeStageResult.status === "rejected") {
     throw sharpRuntimeStageResult.reason;
   }
-  const stagedSharpRuntime = sharpRuntimeStageResult.value ?? (imageRuntime === "node" ? await stageSharpRuntime(config, root, distDir, fs) : null);
+  const stagedSharpRuntime = sharpRuntimeStageResult.value ?? (imageRuntime === "node" ? await stageSharpRuntime(config, root, distDir, fs, preset) : null);
   const runtimeCopyPromise = (async () => {
     if (stagedSharpRuntime) {
       await installStagedSharpRuntime(stagedSharpRuntime, runtimeServerOutputDir, fs);
@@ -9594,7 +9635,24 @@ async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs) {
   logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${path5.relative(root, docsContentDir)}`);
 }
 __name(copyFarmDocsContentForVercel, "copyFarmDocsContentForVercel");
-async function stageSharpRuntime(config, root, distDir, fs) {
+function resolveServerFunctionPlatform(preset) {
+  return preset === "vercel" || preset === "netlify" ? { os: "linux", cpu: "x64", libc: "glibc" } : null;
+}
+__name(resolveServerFunctionPlatform, "resolveServerFunctionPlatform");
+function packageSupportsPlatform(packageJson, platform) {
+  return platformFieldAllows(packageJson.os, platform.os) && platformFieldAllows(packageJson.cpu, platform.cpu) && platformFieldAllows(packageJson.libc, platform.libc);
+}
+__name(packageSupportsPlatform, "packageSupportsPlatform");
+function platformFieldAllows(field, value) {
+  if (!Array.isArray(field)) return true;
+  const entries = field.filter((entry) => typeof entry === "string");
+  if (entries.includes(`!${value}`)) return false;
+  const allowed = entries.filter((entry) => !entry.startsWith("!"));
+  return allowed.length === 0 || allowed.includes(value);
+}
+__name(platformFieldAllows, "platformFieldAllows");
+async function stageSharpRuntime(config, root, distDir, fs, preset) {
+  const functionPlatform = resolveServerFunctionPlatform(preset);
   const projectRequire = createRequire(path5.join(root, "package.json"));
   let sharpRequire = projectRequire;
   if (!resolvePackageJson(projectRequire, "sharp")) {
@@ -9621,6 +9679,7 @@ async function stageSharpRuntime(config, root, distDir, fs) {
     const packageJsonPath = resolvePackageJson(parentRequire, packageName);
     if (!packageJsonPath) return;
     const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
+    if (functionPlatform && !packageSupportsPlatform(packageJson, functionPlatform)) return;
     const packageDir = path5.dirname(packageJsonPath);
     const targetDir = path5.join(targetNodeModules, ...packageName.split("/"));
     copiedPackages.set(packageName, String(packageJson.version || "*"));
@@ -9630,7 +9689,7 @@ async function stageSharpRuntime(config, root, distDir, fs) {
       ...packageJson.dependencies,
       ...packageJson.optionalDependencies
     };
-    await Promise.all([
+    await settleAllOrThrow([
       fs.cp(packageDir, targetDir, {
         recursive: true,
         force: true,
@@ -9681,10 +9740,18 @@ async function installStagedSharpRuntime(staged, nitroFuncDir, fs) {
   );
 }
 __name(installStagedSharpRuntime, "installStagedSharpRuntime");
+async function settleAllOrThrow(operations) {
+  const results = await Promise.allSettled(operations);
+  const failure = results.find(
+    (result) => result.status === "rejected"
+  );
+  if (failure) throw failure.reason;
+}
+__name(settleAllOrThrow, "settleAllOrThrow");
 async function mergeStagedDirectory(sourceDir, targetDir, fs) {
   await fs.mkdir(targetDir, { recursive: true });
   const entries = await fs.readdir(sourceDir, { withFileTypes: true });
-  await Promise.all(
+  await settleAllOrThrow(
     entries.map(async (entry) => {
       const sourcePath = path5.join(sourceDir, entry.name);
       const targetPath = path5.join(targetDir, entry.name);
@@ -9765,14 +9832,17 @@ async function writeNitroOutputPackage(outputDir, packageJson, fs) {
 }
 __name(writeNitroOutputPackage, "writeNitroOutputPackage");
 function resolvePackageJson(parentRequire, packageName) {
+  let metadataModule;
   for (const request of [`${packageName}/package.json`, `${packageName}/package`]) {
     try {
-      return parentRequire.resolve(request);
+      const resolved = parentRequire.resolve(request);
+      if (resolved.endsWith(".json")) return resolved;
+      metadataModule ?? (metadataModule = resolved);
     } catch {
     }
   }
   try {
-    let directory = path5.dirname(parentRequire.resolve(packageName));
+    let directory = path5.dirname(metadataModule ?? parentRequire.resolve(packageName));
     while (directory !== path5.dirname(directory)) {
       const candidate = path5.join(directory, "package.json");
       if (existsSync(candidate)) {
@@ -9879,6 +9949,7 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
   });
   pluginManager.addPlugins(config.plugins || []);
   let projectModuleServer;
+  const rendererBuild = new AbortController();
   try {
     await pluginManager.runHookParallel("init");
     config = await pluginManager.runHookSerial("config", config);
@@ -9914,7 +9985,12 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     if (productionViteResult?.status === "rejected") throw productionViteResult.reason;
     const productionVite = productionViteResult?.value;
     const createViteServer = productionVite ? productionVite.createServer : (await import("vite")).createServer;
-    projectModuleServer = await createProjectModuleServer(createViteServer, config, root);
+    projectModuleServer = await createProjectModuleServer(
+      createViteServer,
+      config,
+      root,
+      rendererBuild.signal
+    );
     const farmApp = createFarmApp(config, projectModuleServer);
     await farmApp.initialize();
     const routeManager = farmApp.getRouteManager();
@@ -9956,7 +10032,8 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
         preset,
         root,
         pluginManager,
-        productionVite
+        productionVite,
+        rendererBuildLifetime: rendererBuild.signal
       });
     } else {
       const { build: legacyViteBuild } = await import("vite");
@@ -10008,13 +10085,18 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     logger.error(`\u274C Build failed: ${error}`);
     throw error;
   } finally {
-    await projectModuleServer?.close();
+    try {
+      await projectModuleServer?.close();
+    } finally {
+      rendererBuild.abort();
+    }
   }
 }
 __name(buildWithProductionNodeEnv, "buildWithProductionNodeEnv");
-async function createProjectModuleServer(createViteServer, config, root) {
+async function createProjectModuleServer(createViteServer, config, root, buildLifetime) {
   const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, root, {
-    ssr: true
+    ssr: true,
+    buildLifetime
   });
   const viteConfig = mergeFarmViteConfig(
     {
@@ -10148,7 +10230,7 @@ function resolveLegacyPageEntry(config, root, srcDir) {
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-CVZ36JM5.mjs"),
+    import("./nitro-4LFVTT24.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(

package/dist/{chunk-A7T6345N.mjs → chunk-5UX4C5QI.mjs}

@@ -7,7 +7,7 @@ import {
   notifyHistoryChange,
   readPageState,
   subscribeHistoryChange
-} from "./chunk-RKQVJN2O.mjs";
+} from "./chunk-JIKGGIOL.mjs";
 import {
   getFarmI18nClientState
 } from "./chunk-TOVMYGYW.mjs";
@@ -49,12 +49,15 @@ function shouldBlockUnload(options) {
   }
 }
 __name(shouldBlockUnload, "shouldBlockUnload");
-function navigateViaRouter(href, basePath, replace) {
+function navigateViaRouter(href, basePath, replace, options = {}) {
   if (typeof window === "undefined") return;
   const url = applyFarmBasePath(href, basePath);
   const spaRouter = getInstalledFarmSPARouter();
   if (spaRouter) {
-    void spaRouter.navigate(url, { replace });
+    void spaRouter.navigate(url, {
+      replace,
+      ...options.scroll === void 0 ? {} : { scroll: options.scroll }
+    });
     return;
   }
   if (replace) {
@@ -85,11 +88,11 @@ function useRouter(options = {}) {
     const unsubscribe = subscribeHistoryChange(handlePopState);
     return unsubscribe;
   }, [basePath, routeMatcher]);
-  const push = /* @__PURE__ */ __name((href) => {
-    navigateViaRouter(href, basePath, false);
+  const push = /* @__PURE__ */ __name((href, navigateOptions) => {
+    navigateViaRouter(href, basePath, false, navigateOptions);
   }, "push");
-  const replace = /* @__PURE__ */ __name((href) => {
-    navigateViaRouter(href, basePath, true);
+  const replace = /* @__PURE__ */ __name((href, navigateOptions) => {
+    navigateViaRouter(href, basePath, true, navigateOptions);
   }, "replace");
   const pushState = /* @__PURE__ */ __name((pageState, href) => {
     if (typeof window === "undefined") return;

package/dist/chunk-75WGQVQA.cjs

@@ -0,0 +1,46 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); 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 _chunkS3JO3N4Hcjs = require('./chunk-S3JO3N4H.cjs');
+
+// src/docs/adapter-client.ts
+function getFarmDocsAdapterConfigModule(docs) {
+  if (!_optionalChain([docs, 'optionalAccess', _ => _.enabled]) || !_optionalChain([docs, 'access', _2 => _2.adapter, 'optionalAccess', _3 => _3.react]) || !docs.configPath) return void 0;
+  return docs.configPath.endsWith(".json") ? void 0 : docs.configPath.replace(/\\/g, "/");
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, getFarmDocsAdapterConfigModule, "getFarmDocsAdapterConfigModule");
+function generateFarmDocsAdapterClientRuntime(reactModule, configModule) {
+  if (!reactModule) {
+    return `
+async function hydrateFarmDocsAdapterRuntime() {
+  return false;
+}
+`;
+  }
+  return `
+async function hydrateFarmDocsAdapterRuntime() {
+  const runtime = window.__FARM_DOCS_ADAPTER__;
+  if (!runtime) return false;
+  const FarmDocsAdapterReact = await import(${JSON.stringify(reactModule)});
+  if (typeof FarmDocsAdapterReact.hydrateFarmDocs !== "function") {
+    throw new Error("The configured Farm docs adapter does not export hydrateFarmDocs().");
+  }
+  // The docs server flags pages whose config holds what its JSON copy cannot (icons,
+  // MDX components, callbacks); the adapter restores those from the module itself.
+  const configModule = runtime.configModule
+    ? ${configModule ? `await import(${JSON.stringify(configModule)})` : "undefined"}
+    : undefined;
+  FarmDocsAdapterReact.hydrateFarmDocs({
+    config: runtime.config || {},
+    data: runtime.data,
+    ...(configModule ? { configModule: configModule.default ?? configModule } : {}),
+  });
+  return true;
+}
+`;
+}
+_chunkS3JO3N4Hcjs.__name.call(void 0, generateFarmDocsAdapterClientRuntime, "generateFarmDocsAdapterClientRuntime");
+
+
+
+
+exports.getFarmDocsAdapterConfigModule = getFarmDocsAdapterConfigModule; exports.generateFarmDocsAdapterClientRuntime = generateFarmDocsAdapterClientRuntime;

package/dist/{chunk-AFOD3LYZ.cjs → chunk-B3WK4DTX.cjs}

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunkIAMRBF3Zcjs = require('./chunk-IAMRBF3Z.cjs');
+var _chunkN4RLRSWWcjs = require('./chunk-N4RLRSWW.cjs');
 
 
 var _chunk2CQ74SP6cjs = require('./chunk-2CQ74SP6.cjs');
@@ -24,10 +24,11 @@ var _chunk6V4TDWECcjs = require('./chunk-6V4TDWEC.cjs');
 
 
 
-var _chunkMKB2EGIRcjs = require('./chunk-MKB2EGIR.cjs');
+var _chunkSOR334EBcjs = require('./chunk-SOR334EB.cjs');
 
 
-var _chunkVQDBNVOOcjs = require('./chunk-VQDBNVOO.cjs');
+
+var _chunkBMWDEBXOcjs = require('./chunk-BMWDEBXO.cjs');
 
 
 var _chunk5QIKR7RRcjs = require('./chunk-5QIKR7RR.cjs');
@@ -152,8 +153,8 @@ var _APIRouteManager = class _APIRouteManager {
             }
           }
         }
-        const runtimeConfig = _chunkMKB2EGIRcjs.normalizeFarmRouteRuntimeConfig.call(void 0, 
-          _chunkMKB2EGIRcjs.getFarmRouteRuntimeConfig.call(void 0, routeModule),
+        const runtimeConfig = _chunkSOR334EBcjs.normalizeFarmRouteRuntimeConfig.call(void 0, 
+          _chunkSOR334EBcjs.getFarmRouteRuntimeConfig.call(void 0, routeModule),
           `API route "${routePath}"`
         );
         this.registerRouteShape(routePath, filePath, appDir);
@@ -206,7 +207,7 @@ var _APIRouteManager = class _APIRouteManager {
   async loadProgrammaticApiRoutes(appDir) {
     const candidateRoots = [path.dirname(appDir), appDir];
     const routeFiles = Array.from(
-      new Set(candidateRoots.flatMap((srcRoot) => _chunkIAMRBF3Zcjs.findProgrammaticRouteFilesInDir.call(void 0, srcRoot)))
+      new Set(candidateRoots.flatMap((srcRoot) => _chunkN4RLRSWWcjs.findProgrammaticRouteFilesInDir.call(void 0, srcRoot)))
     );
     if (routeFiles.length === 0) return;
     const { getProgrammaticRouteManifest } = await import("./routes.cjs");
@@ -251,11 +252,11 @@ var _APIRouteManager = class _APIRouteManager {
   }
   async loadModule(filePath) {
     if (this.viteServer) {
-      return await this.viteServer.ssrLoadModule(filePath);
+      return await _chunkBMWDEBXOcjs.loadFarmDevModule.call(void 0, this.viteServer, filePath);
     }
     return await import(
       /* @vite-ignore */
-      _chunkVQDBNVOOcjs.toFileModuleUrl.call(void 0, filePath)
+      _chunkBMWDEBXOcjs.toFileModuleUrl.call(void 0, filePath)
     );
   }
   addEndpoint(routePath, filePath, method, endpoint, appDir, runtimeConfig = {}) {
@@ -292,7 +293,7 @@ var _APIRouteManager = class _APIRouteManager {
   }
   addProgrammaticApiRoute(filePath, route, appDir) {
     const modulePath = _chunk6V4TDWECcjs.createProgrammaticRouteModuleId.call(void 0, filePath, "api", route.path);
-    const runtimeConfig = _chunkMKB2EGIRcjs.normalizeFarmRouteRuntimeConfig.call(void 0, route, `API route "${route.path}"`);
+    const runtimeConfig = _chunkSOR334EBcjs.normalizeFarmRouteRuntimeConfig.call(void 0, route, `API route "${route.path}"`);
     for (const [method, endpoint] of Object.entries(route.methods)) {
       if (endpoint) {
         this.addEndpoint(route.path, modulePath, method, endpoint, appDir, runtimeConfig);