@farm.js/core 0.1.0-beta.33 → 0.1.0-beta.35

package/dist/{chunk-4TI6B4AY.mjs → chunk-HLN7NPNQ.mjs}

@@ -9,7 +9,7 @@ import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsLastModifiedManifest,
   getFarmDocsRouteTypeEntries
-} from "./chunk-NETDSCXV.mjs";
+} from "./chunk-IU42657J.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -18,7 +18,7 @@ import {
 import {
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-EL644GWT.mjs";
+} from "./chunk-7JLDC7IO.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-5NAM3OTS.mjs";
@@ -37,7 +37,7 @@ import {
   mergeFarmFontCss,
   mergeFarmViteConfig,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-DV5ZT2JO.mjs";
+} from "./chunk-S7SW4LTM.mjs";
 import {
   farmEnvironmentFunctionsPlugin
 } from "./chunk-V6WE6JSZ.mjs";
@@ -53,7 +53,7 @@ import {
   getFarmRendererComponentExtensions,
   isReactRenderer,
   loadFarmRendererVitePlugins
-} from "./chunk-5PDVNNUQ.mjs";
+} from "./chunk-BNTDKO7T.mjs";
 import {
   getFarmAppDirectories
 } from "./chunk-74YTBPTY.mjs";
@@ -99,22 +99,72 @@ import {
 } from "./chunk-CGILA3WO.mjs";
 
 // src/build/index.ts
-import path4 from "path";
+import path5 from "path";
 import { existsSync as existsSync2 } from "fs";
 
+// src/nitro/client-css-href.ts
+import path from "path";
+var FARM_CLIENT_CSS_HREF_PLACEHOLDER = "/__farm_client_css_href__";
+var FARM_CLIENT_JS_SRC_PLACEHOLDER = "/__farm_client_js_src__";
+async function hashAndCopy(sourcePath, destinationDir, hashedName) {
+  const fs = await import("fs/promises");
+  try {
+    const bytes = await fs.readFile(sourcePath);
+    if (bytes.length === 0) return null;
+    const { createHash } = await import("crypto");
+    const hash = createHash("sha256").update(bytes).digest("hex").slice(0, 8);
+    const name = hashedName(hash);
+    await fs.mkdir(destinationDir, { recursive: true });
+    await fs.writeFile(path.join(destinationDir, name), bytes);
+    return name;
+  } catch {
+    return null;
+  }
+}
+__name(hashAndCopy, "hashAndCopy");
+async function resolveHashedClientCssHref(clientOutputDir) {
+  const name = await hashAndCopy(
+    path.join(clientOutputDir, "farm-client.css"),
+    path.join(clientOutputDir, "assets"),
+    (hash) => `farm-client-h${hash}.css`
+  );
+  return name ? `/assets/${name}` : "/farm-client.css";
+}
+__name(resolveHashedClientCssHref, "resolveHashedClientCssHref");
+async function findFingerprintedClientEntry(clientOutputDir) {
+  const fs = await import("fs/promises");
+  try {
+    const entries = await fs.readdir(clientOutputDir);
+    return entries.find((name) => /^farm-client-h[0-9a-f]+\.js$/.test(name)) ?? null;
+  } catch {
+    return null;
+  }
+}
+__name(findFingerprintedClientEntry, "findFingerprintedClientEntry");
+async function resolveHashedClientJsSrc(clientOutputDir) {
+  const entryName = await findFingerprintedClientEntry(clientOutputDir);
+  if (!entryName) return "/farm-client.js";
+  const fs = await import("fs/promises");
+  const shim = `export * from "./${entryName}";
+`;
+  await fs.writeFile(path.join(clientOutputDir, "farm-client.js"), shim);
+  return `/${entryName}`;
+}
+__name(resolveHashedClientJsSrc, "resolveHashedClientJsSrc");
+
 // src/nitro/universal-build.ts
 import os from "os";
-import path3 from "path";
+import path4 from "path";
 import { constants as fsConstants, existsSync, readFileSync } from "fs";
 import { fileURLToPath } from "url";
 import { builtinModules, createRequire } from "module";
 import { isDeepStrictEqual } from "util";
 
 // src/route-runtime-manifest.ts
-import path from "path";
+import path2 from "path";
 var FARM_ROUTE_RUNTIME_MANIFEST = "route-runtime-manifest.json";
 async function createFarmRouteRuntimeManifest(options) {
-  const root = path.resolve(options.root || options.config.root || process.cwd());
+  const root = path2.resolve(options.root || options.config.root || process.cwd());
   const routes = [];
   for (const [pattern, entry] of options.routeManager.getRoutes()) {
     const routeModule = await options.routeManager.loadRouteModule(entry.modulePath);
@@ -162,7 +212,7 @@ async function createFarmRouteRuntimeManifest(options) {
 __name(createFarmRouteRuntimeManifest, "createFarmRouteRuntimeManifest");
 async function writeFarmRouteRuntimeManifest(directory, manifest) {
   const fs = await import("fs/promises");
-  const manifestPath = path.join(directory, FARM_ROUTE_RUNTIME_MANIFEST);
+  const manifestPath = path2.join(directory, FARM_ROUTE_RUNTIME_MANIFEST);
   await fs.mkdir(directory, { recursive: true });
   await fs.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `);
@@ -202,13 +252,13 @@ function normalizeManifestSource(root, modulePath) {
   const queryIndex = modulePath.indexOf("?");
   const filePath = queryIndex === -1 ? modulePath : modulePath.slice(0, queryIndex);
   const query = queryIndex === -1 ? "" : modulePath.slice(queryIndex);
-  const relativePath = path.isAbsolute(filePath) ? path.relative(root, filePath) : filePath;
+  const relativePath = path2.isAbsolute(filePath) ? path2.relative(root, filePath) : filePath;
   return `${relativePath.replace(/\\/g, "/")}${query}`;
 }
 __name(normalizeManifestSource, "normalizeManifestSource");
 
 // src/nitro/vercel-route-runtime.ts
-import path2 from "path";
+import path3 from "path";
 async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs) {
   const dynamicRoutes = manifest.routes.filter(
     (route) => route.rendering === "dynamic" && route.runtime !== "edge"
@@ -228,8 +278,8 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs) {
     group.routes.push(route);
     groups.set(key, group);
   }
-  const functionsDir = path2.join(outputDir, "functions");
-  const baseFunctionDir = path2.join(functionsDir, "__nitro.func");
+  const functionsDir = path3.join(outputDir, "functions");
+  const baseFunctionDir = path3.join(functionsDir, "__nitro.func");
   const destinations = /* @__PURE__ */ new Map();
   let groupIndex = 0;
   for (const [key, group] of groups) {
@@ -239,7 +289,7 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs) {
     }
     groupIndex += 1;
     const functionName = `__farm_runtime_${groupIndex}`;
-    const functionDir = path2.join(functionsDir, `${functionName}.func`);
+    const functionDir = path3.join(functionsDir, `${functionName}.func`);
     await fs.cp(baseFunctionDir, functionDir, { recursive: true, force: true });
     await configureVercelFunction(functionDir, group.config, fs);
     destinations.set(key, `/${functionName}`);
@@ -289,7 +339,7 @@ function farmRoutePatternToVercelSource(pattern) {
 }
 __name(farmRoutePatternToVercelSource, "farmRoutePatternToVercelSource");
 async function configureVercelFunction(functionDir, config, fs) {
-  const configPath = path2.join(functionDir, ".vc-config.json");
+  const configPath = path3.join(functionDir, ".vc-config.json");
   const current = JSON.parse(await fs.readFile(configPath, "utf8"));
   const next = {
     ...current,
@@ -338,8 +388,9 @@ function createFarmVercelImmutableAssetRoute(basePath = "/") {
   const normalizedBasePath = normalizeBasePath(basePath);
   const escapedBasePath = escapeRegex(normalizedBasePath);
   const prefix = escapedBasePath ? `/${escapedBasePath}` : "";
+  const fingerprint = "-h(?:[a-fA-F0-9]{8}|[a-fA-F0-9]{12}|[a-fA-F0-9]{16})";
   return {
-    src: `^${prefix}/(?:assets|chunks)/(?:.+/)*[^/]+-h(?:[a-fA-F0-9]{8}|[a-fA-F0-9]{12}|[a-fA-F0-9]{16})\\.(?!(?:[hH][tT][mM][lL]?)$)[^/]+$`,
+    src: `^${prefix}/(?:(?:assets|chunks)/(?:.+/)*[^/]+|farm-client)${fingerprint}\\.(?!(?:[hH][tT][mM][lL]?)$)[^/]+$`,
     headers: {
       "Cache-Control": FARM_IMMUTABLE_ASSET_CACHE_CONTROL
     },
@@ -566,7 +617,7 @@ function preloadFarmNitroRuntime() {
 }
 __name(preloadFarmNitroRuntime, "preloadFarmNitroRuntime");
 var _filename = typeof import.meta.url !== "undefined" ? fileURLToPath(import.meta.url) : "";
-var _dirname = path3.dirname(_filename);
+var _dirname = path4.dirname(_filename);
 var NODE_BUILTIN_MODULES = /* @__PURE__ */ new Set([
   ...builtinModules,
   ...builtinModules.map((moduleName) => `node:${moduleName}`)
@@ -595,14 +646,14 @@ var FARM_SSR_PACKAGE_IMPORT = "#farm-ssr-entry";
 var FARM_SSR_OUTPUT_DIR = "farm-ssr";
 var FARM_CLIENT_BUILD_TARGET = ["es2020", "edge88", "firefox78", "chrome87", "safari14"];
 function resolveNitroRuntimeDependency(root, specifier) {
-  const projectRequire = createRequire(path3.join(root, "package.json"));
+  const projectRequire = createRequire(path4.join(root, "package.json"));
   let runtimeRequire = projectRequire;
   try {
     runtimeRequire = createRequire(projectRequire.resolve("@farm.js/core"));
   } catch {
   }
   const nitroEntry = runtimeRequire.resolve("nitro");
-  return createRequire(nitroEntry).resolve(specifier).split(path3.sep).join("/");
+  return createRequire(nitroEntry).resolve(specifier).split(path4.sep).join("/");
 }
 __name(resolveNitroRuntimeDependency, "resolveNitroRuntimeDependency");
 function cloneConfigValue(value, seen = /* @__PURE__ */ new WeakMap()) {
@@ -696,7 +747,7 @@ function createMetadataImageWasmPlugin() {
         return null;
       }
       const requestPath = source.slice(0, -"?module".length);
-      const resolvedPath = path3.isAbsolute(requestPath) ? requestPath : path3.resolve(path3.dirname(importer.split("?", 1)[0]), requestPath);
+      const resolvedPath = path4.isAbsolute(requestPath) ? requestPath : path4.resolve(path4.dirname(importer.split("?", 1)[0]), requestPath);
       return `${FARM_METADATA_IMAGE_WASM_PREFIX}${resolvedPath}`;
     },
     load(id) {
@@ -722,11 +773,11 @@ function collectSSRExternalPackages(ssrBundle) {
     for (const importId of [...output.imports, ...output.dynamicImports]) {
       const normalizedImportId = importId.replace(/\\/g, "/");
       const normalizedId = normalizedImportId.replace(/^\.\//, "");
-      const resolvedRelativeId = normalizedImportId.startsWith("./") || normalizedImportId.startsWith("../") ? path3.posix.normalize(path3.posix.join(path3.posix.dirname(fileName), normalizedImportId)) : null;
+      const resolvedRelativeId = normalizedImportId.startsWith("./") || normalizedImportId.startsWith("../") ? path4.posix.normalize(path4.posix.join(path4.posix.dirname(fileName), normalizedImportId)) : null;
       if (emittedFiles.has(normalizedId) || resolvedRelativeId !== null && emittedFiles.has(resolvedRelativeId) || NODE_BUILTIN_MODULES.has(importId) || importId.startsWith("node:")) {
         continue;
       }
-      if (path3.isAbsolute(importId) || /^[A-Za-z]:[\\/]/.test(importId) || importId.startsWith("#") || importId.startsWith("\0")) {
+      if (path4.isAbsolute(importId) || /^[A-Za-z]:[\\/]/.test(importId) || importId.startsWith("#") || importId.startsWith("\0")) {
         externalPackages.add(importId);
         continue;
       }
@@ -739,15 +790,15 @@ function collectSSRExternalPackages(ssrBundle) {
 }
 __name(collectSSRExternalPackages, "collectSSRExternalPackages");
 function createExternalSSRBundlePlugin(nitroEntryPath, ssrOutputDir, ssrEntryFile) {
-  const resolvedNitroEntry = path3.resolve(nitroEntryPath);
-  const resolvedSSREntry = path3.resolve(ssrOutputDir, ssrEntryFile);
+  const resolvedNitroEntry = path4.resolve(nitroEntryPath);
+  const resolvedSSREntry = path4.resolve(ssrOutputDir, ssrEntryFile);
   return {
     name: "farm-externalize-prebuilt-ssr",
     resolveId(source, importer) {
-      if (!importer || path3.resolve(importer) !== resolvedNitroEntry) {
+      if (!importer || path4.resolve(importer) !== resolvedNitroEntry) {
         return null;
       }
-      const resolvedImport = path3.resolve(path3.dirname(importer), source);
+      const resolvedImport = path4.resolve(path4.dirname(importer), source);
       if (resolvedImport !== resolvedSSREntry) return null;
       return { id: FARM_SSR_PACKAGE_IMPORT, external: true };
     }
@@ -836,13 +887,13 @@ function resolveBuildDocsContentDir(config, root) {
   if (!config.docs?.enabled) return null;
   const configuredContentDir = config.docs.contentDir || config.docs.config.contentDir;
   if (typeof configuredContentDir === "string" && configuredContentDir.trim()) {
-    const contentDir = path3.isAbsolute(configuredContentDir) ? configuredContentDir : path3.join(root, configuredContentDir);
+    const contentDir = path4.isAbsolute(configuredContentDir) ? configuredContentDir : path4.join(root, configuredContentDir);
     return existsSync(contentDir) ? contentDir : null;
   }
   const entryDir = config.docs.config.entry || trimSlashes(config.docs.entry) || "docs";
-  const appDocsDir = path3.join(root, config.srcDir || "src", "app", entryDir);
+  const appDocsDir = path4.join(root, config.srcDir || "src", "app", entryDir);
   if (existsSync(appDocsDir)) return appDocsDir;
-  const rootDocsDir = path3.join(root, entryDir);
+  const rootDocsDir = path4.join(root, entryDir);
   return existsSync(rootDocsDir) ? rootDocsDir : null;
 }
 __name(resolveBuildDocsContentDir, "resolveBuildDocsContentDir");
@@ -860,7 +911,7 @@ function hasProjectPostcssConfig(root) {
     ".postcssrc.mjs",
     ".postcssrc.ts"
   ];
-  const projectRequire = createRequire(path3.join(root, "package.json"));
+  const projectRequire = createRequire(path4.join(root, "package.json"));
   return candidates.some((file) => {
     try {
       projectRequire.resolve(`./${file}`);
@@ -884,7 +935,7 @@ async function findFarmConfigPath(root) {
     "config.mjs"
   ];
   for (const candidate of candidates) {
-    const resolvedPath = path3.join(root, candidate);
+    const resolvedPath = path4.join(root, candidate);
     try {
       await fs.access(resolvedPath);
       return resolvedPath;
@@ -929,7 +980,7 @@ async function discoverMiddlewareRoutes(appDir) {
     if (middlewareFile) {
       discovered.push({
         path: routePath,
-        filePath: path3.join(dir, middlewareFile.name)
+        filePath: path4.join(dir, middlewareFile.name)
       });
     }
     for (const entry of entries) {
@@ -937,7 +988,7 @@ async function discoverMiddlewareRoutes(appDir) {
         continue;
       }
       const childRoutePath = routePath === "/" ? `/${entry.name}` : `${routePath}/${entry.name}`;
-      await walk(path3.join(dir, entry.name), childRoutePath, discovered);
+      await walk(path4.join(dir, entry.name), childRoutePath, discovered);
     }
   }
   __name(walk, "walk");
@@ -1002,7 +1053,7 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
     logger.info(`\u{1F4CB} Found ${pageRoutes.length} page routes`);
     const fs = await import("fs/promises");
     const layoutRoutes = [];
-    const appDir = path3.join(root, srcDir, "app");
+    const appDir = path4.join(root, srcDir, "app");
     async function findLayoutsForClient(dir, routePrefix = "/") {
       try {
         const entries = await fs.readdir(dir, { withFileTypes: true });
@@ -1010,11 +1061,11 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
           if (entry.isFile() && entry.name.match(/^layout\.(tsx?|jsx?|vue|svelte)$/)) {
             layoutRoutes.push({
               pattern: routePrefix,
-              modulePath: path3.join(dir, entry.name)
+              modulePath: path4.join(dir, entry.name)
             });
           } else if (entry.isDirectory() && !entry.name.startsWith(".") && !entry.name.startsWith("_")) {
             const childPrefix = routePrefix === "/" ? `/${entry.name}` : `${routePrefix}/${entry.name}`;
-            await findLayoutsForClient(path3.join(dir, entry.name), childPrefix);
+            await findLayoutsForClient(path4.join(dir, entry.name), childPrefix);
           }
         }
       } catch {
@@ -1029,7 +1080,7 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       layoutRoutes.push({ pattern, modulePath: entry.modulePath });
     }
     logger.info(`\u{1F4CB} Found ${pageRoutes.length} page routes and ${layoutRoutes.length} layouts`);
-    const clientOutputDir = path3.join(root, distDir, "client");
+    const clientOutputDir = path4.join(root, distDir, "client");
     const [productionViteResult] = await productionViteResultPromise;
     if (productionViteResult.status === "rejected") {
       await routeRuntimeManifestResultPromise;
@@ -1124,12 +1175,10 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       lifecyclePluginManager
     );
     const runtimeManifestPath = await writeFarmRouteRuntimeManifest(
-      path3.join(root, distDir),
+      path4.join(root, distDir),
       routeRuntimeManifest
     );
-    logger.info(`\u{1F4CB} Route runtime manifest: ${path3.relative(root, runtimeManifestPath)}`);
-    logger.success("\u2705 Build completed successfully!");
-    logger.info(`\u{1F4C1} Output directory: ${deployOutputDir}`);
+    logger.info(`\u{1F4CB} Route runtime manifest: ${path4.relative(root, runtimeManifestPath)}`);
   } catch (error) {
     if (lifecyclePluginManager) {
       await lifecyclePluginManager.runHookParallel("onError", {
@@ -1154,8 +1203,8 @@ async function writeSSRAssetsToClient(bundle, outputDir) {
       await mergeBuiltFontCss(outputDir, output.source);
       continue;
     }
-    const filePath = path3.join(outputDir, fileName);
-    await fs.mkdir(path3.dirname(filePath), { recursive: true });
+    const filePath = path4.join(outputDir, fileName);
+    await fs.mkdir(path4.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, output.source);
   }
 }
@@ -1164,8 +1213,8 @@ async function copyFarmDocsFontAssetsToClient(root, outputDir) {
   const fs = await import("fs/promises");
   await Promise.all(
     resolveFarmDocsFontAssets(root).map(async ({ sourcePath, url }) => {
-      const targetPath = path3.join(outputDir, url.replace(/^\/+/, ""));
-      await fs.mkdir(path3.dirname(targetPath), { recursive: true });
+      const targetPath = path4.join(outputDir, url.replace(/^\/+/, ""));
+      await fs.mkdir(path4.dirname(targetPath), { recursive: true });
       await fs.copyFile(sourcePath, targetPath);
     })
   );
@@ -1173,7 +1222,7 @@ async function copyFarmDocsFontAssetsToClient(root, outputDir) {
 __name(copyFarmDocsFontAssetsToClient, "copyFarmDocsFontAssetsToClient");
 async function mergeBuiltFontCss(outputDir, fontCssSource) {
   const fs = await import("fs/promises");
-  const fontCssPath = path3.join(outputDir, "farm-fonts.css");
+  const fontCssPath = path4.join(outputDir, "farm-fonts.css");
   let fontCss = fontCssSource;
   if (fontCss === void 0) {
     try {
@@ -1182,7 +1231,7 @@ async function mergeBuiltFontCss(outputDir, fontCssSource) {
       return;
     }
   }
-  const clientCssPath = path3.join(outputDir, "farm-client.css");
+  const clientCssPath = path4.join(outputDir, "farm-client.css");
   let clientCss = "";
   try {
     clientCss = await fs.readFile(clientCssPath, "utf8");
@@ -1203,7 +1252,8 @@ __name(_IncompleteClientBuildOutputError, "IncompleteClientBuildOutputError");
 var IncompleteClientBuildOutputError = _IncompleteClientBuildOutputError;
 async function validateClientBuildOutput(root, srcDir, outputDir) {
   const fs = await import("fs/promises");
-  const clientEntryPath = path3.join(outputDir, "farm-client.js");
+  const fingerprinted = await findFingerprintedClientEntry(outputDir);
+  const clientEntryPath = path4.join(outputDir, fingerprinted ?? "farm-client.js");
   let clientEntrySize = 0;
   try {
     const clientEntry = await fs.stat(clientEntryPath);
@@ -1213,8 +1263,8 @@ async function validateClientBuildOutput(root, srcDir, outputDir) {
   if (clientEntrySize === 0) {
     throw new IncompleteClientBuildOutputError("farm-client.js is missing or empty");
   }
-  const clientCssPath = path3.join(outputDir, "farm-client.css");
-  const globalsCssPath = path3.join(root, srcDir, "app", "globals.css");
+  const clientCssPath = path4.join(outputDir, "farm-client.css");
+  const globalsCssPath = path4.join(root, srcDir, "app", "globals.css");
   let expectsCss = false;
   try {
     const globalsCss = await fs.readFile(globalsCssPath, "utf8");
@@ -1345,10 +1395,10 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   logger.info(
     `\u{1F4F1} Total hydratable routes detected: ${clientPages.length} pages, ${clientLayouts.filter((layout) => layout.shouldHydrate).length} layouts, and ${clientRouteSlots.length} slots`
   );
-  const clientEntryRoot = path3.join(root, ".farm", "tmp");
+  const clientEntryRoot = path4.join(root, ".farm", "tmp");
   await fs.mkdir(clientEntryRoot, { recursive: true });
-  const clientEntryDir = await fs.mkdtemp(path3.join(clientEntryRoot, "client-entry-"));
-  const clientEntryPath = path3.join(clientEntryDir, "farm-client-entry.tsx");
+  const clientEntryDir = await fs.mkdtemp(path4.join(clientEntryRoot, "client-entry-"));
+  const clientEntryPath = path4.join(clientEntryDir, "farm-client-entry.tsx");
   const clientHydrationCode = generateClientHydrationEntry(
     clientPages,
     clientLayouts,
@@ -1374,7 +1424,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   if (hasScopedPostcssConfig) {
     logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
   } else {
-    const postcssConfigPath = path3.join(clientEntryDir, "postcss.config.cjs");
+    const postcssConfigPath = path4.join(clientEntryDir, "postcss.config.cjs");
     await fs.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
     postcssSearchPath = clientEntryDir;
     try {
@@ -1407,7 +1457,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             "farm-client": clientEntryPath
           },
           output: {
-            entryFileNames: "[name].js",
+            entryFileNames: "[name]-h[hash].js",
             chunkFileNames: "chunks/[name]-h[hash].js",
             hashCharacters: "hex",
             // Use predictable name for CSS so we can reference it in SSR HTML
@@ -1725,7 +1775,7 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
   );
   const rendererClientImports = isReactRenderer(renderer) ? `import React from "react";
 import { createRoot, hydrateRoot } from "react-dom/client";` : `import React, { createRoot, hydrateRoot } from ${JSON.stringify(renderer.client)};`;
-  const globalsCssPath = path3.join(root, srcDir, "app", "globals.css");
+  const globalsCssPath = path4.join(root, srcDir, "app", "globals.css");
   const cssImportPath = toImportPath(globalsCssPath);
   const cssImport = `import ${JSON.stringify(cssImportPath)};`;
   const layoutImportStatements = [];
@@ -2994,9 +3044,9 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
     ssr: true
   });
   if (!hasScopedPostcssConfig) {
-    postcssConfigDir = await fs.mkdtemp(path3.join(os.tmpdir(), "farm-postcss-"));
+    postcssConfigDir = await fs.mkdtemp(path4.join(os.tmpdir(), "farm-postcss-"));
     await fs.writeFile(
-      path3.join(postcssConfigDir, "postcss.config.cjs"),
+      path4.join(postcssConfigDir, "postcss.config.cjs"),
       "module.exports = { plugins: [] };\n"
     );
     try {
@@ -3074,7 +3124,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   const notFoundExtensions = getFarmRendererComponentExtensions(config.renderer);
   for (const sourceAppDir of appDirs) {
     for (const ext of notFoundExtensions) {
-      const checkPath = path3.join(sourceAppDir, `not-found${ext}`);
+      const checkPath = path4.join(sourceAppDir, `not-found${ext}`);
       try {
         await fs.access(checkPath);
         notFoundPath = checkPath;
@@ -3506,7 +3556,7 @@ import { dirname as farmDocsDirname, join as farmDocsJoin } from "node:path";
 import { fileURLToPath as farmDocsFileURLToPath } from "node:url";` : "";
   const markdownHandlerImport = config.md?.enabled ? `import { applyMarkdownNegotiationHeaders, createMarkdownMirrorResponse } from "@farm.js/core/markdown";` : "";
   const appMarkdownImport = hasMarkdownPages ? `import { createFarmMarkdownRouteModule, createFarmMarkdownSourceResponse } from "@farm.js/core/app-markdown";` : "const createFarmMarkdownSourceResponse = null;";
-  const mdxComponentsPath = typeof config.mdx?.components === "string" ? path3.isAbsolute(config.mdx.components) ? config.mdx.components : path3.join(config.root, config.mdx.components) : null;
+  const mdxComponentsPath = typeof config.mdx?.components === "string" ? path4.isAbsolute(config.mdx.components) ? config.mdx.components : path4.join(config.root, config.mdx.components) : null;
   const mdxComponentsImport = mdxComponentsPath ? `import * as FarmMdxComponentsModule from "${mdxComponentsPath.replace(/\\/g, "/")}";` : "";
   const layerConfigPaths = (config.layers || []).map((layer) => layer.configFile).filter((configFile) => Boolean(configFile)).filter((configFile) => configFile !== configModulePath);
   const layerConfigImports = layerConfigPaths.map(
@@ -3781,8 +3831,8 @@ const farmDocsHandler = ${config.docs?.enabled ? adapterOwnsDocsRuntime ? `creat
   contentDir: farmDocsResolvedConfig.contentDir || farmDocsResolvedConfig.config?.contentDir,
 }, {
   rootDir: farmDocsRuntimeRoot,
-  clientEntry: "/farm-client.js",
-  stylesheets: ["/farm-fonts.css", "/farm-client.css"],
+  clientEntry: "/__farm_client_js_src__",
+  stylesheets: ["/farm-fonts.css", "/__farm_client_css_href__"],
   resolveLayoutFonts: (pathname) =>
     resolveFarmLayoutFonts(
       getApplicableLayouts(getFarmRoutePathname(pathname)).map((layout) => layout.module),
@@ -3791,7 +3841,7 @@ const farmDocsHandler = ${config.docs?.enabled ? adapterOwnsDocsRuntime ? `creat
 })` : `createFarmDocsHandler(farmDocsResolvedConfig, {
   root: farmDocsRuntimeRoot,
   srcDir: ${JSON.stringify(config.srcDir)},
-  clientEntry: "/farm-client.js",
+  clientEntry: "/__farm_client_js_src__",
   fontAssets: ${JSON.stringify(farmDocsFontAssets)},
   resolveLayoutFonts: (pathname) =>
     resolveFarmLayoutFonts(
@@ -4134,12 +4184,12 @@ function createFarmErrorDocument(html, title) {
       '  <meta name="viewport" content="width=device-width, initial-scale=1">\\n' +
       '  <link rel="icon" href="data:,">\\n' +
       '  <title>' + escapedTitle + '</title>\\n' +
-      '  <link rel="stylesheet" href="/farm-client.css">\\n' +
+      '  <link rel="stylesheet" href="/__farm_client_css_href__">\\n' +
       renderFarmRendererHydrationScript() + '\\n' +
       '</head>\\n<body>\\n' +
       '  <div id="root">' + html + '</div>\\n' +
       '  ' + renderFarmClientBootstrapScript() + '\\n' +
-      '  <script type="module" src="/farm-client.js"></script>\\n' +
+      '  <script type="module" src="/__farm_client_js_src__"></script>\\n' +
       '</body>\\n</html>';
   }
 
@@ -4150,7 +4200,7 @@ function createFarmErrorDocument(html, title) {
       .replace(/<\\/body>/i, '</div></body>');
   }
   fullHtml = fullHtml
-    .replace(/<head([^>]*)>/i, '<head$1>\\n  <link rel="stylesheet" href="/farm-client.css">')
+    .replace(/<head([^>]*)>/i, '<head$1>\\n  <link rel="stylesheet" href="/__farm_client_css_href__">')
     .replace(/<\\/head>/i, renderFarmRendererHydrationScript() + '\\n</head>')
     .replace(/<head([^>]*)>([\\s\\S]*?)<\\/head>/i, function(match, attrs, headContent) {
       return headContent.includes("<title")
@@ -4160,7 +4210,7 @@ function createFarmErrorDocument(html, title) {
     .replace(
       /<\\/body>/i,
       '  ' + renderFarmClientBootstrapScript() + '\\n' +
-        '  <script type="module" src="/farm-client.js"></script>\\n</body>',
+        '  <script type="module" src="/__farm_client_js_src__"></script>\\n</body>',
     );
   return fullHtml.trim().startsWith("<!DOCTYPE")
     ? fullHtml
@@ -4876,8 +4926,8 @@ ${config.docs?.enabled ? `async function wrapFarmDocsResponseWithLayouts(request
     bodyMatch[0],
     "<body" + bodyMatch[1] + ">" + rootMarkup + "</body>",
   );
-  if (!html.includes('href="/farm-client.css"')) {
-    const clientStylesheet = '  <link rel="stylesheet" href="/farm-client.css">\\n';
+  if (!html.includes('href="/__farm_client_css_href__"')) {
+    const clientStylesheet = '  <link rel="stylesheet" href="/__farm_client_css_href__">\\n';
     const firstStyleIndex = html.search(/<style(?:\\s|>)/i);
     html =
       firstStyleIndex >= 0
@@ -4887,10 +4937,10 @@ ${config.docs?.enabled ? `async function wrapFarmDocsResponseWithLayouts(request
   if (!html.includes('id="__farm_route_slots_data__"')) {
     html = html.replace(/<[/]body>/i, renderFarmClientBootstrapScript() + "\\n</body>");
   }
-  if (!html.includes('src="/farm-client.js"')) {
+  if (!html.includes('src="/__farm_client_js_src__"')) {
     html = html.replace(
       /<[/]body>/i,
-      '  <script type="module" src="/farm-client.js"></script>\\n</body>',
+      '  <script type="module" src="/__farm_client_js_src__"></script>\\n</body>',
     );
   }
   if (!html.includes('window._$HY')) {
@@ -5620,8 +5670,8 @@ async function handleFarmRequestInContext(
             '  <meta name="viewport" content="width=device-width, initial-scale=1">\\n' +
             (hasFavicon ? '' : '  <link rel="icon" href="data:,">\\n') +
             '  <title>' + title + '</title>' + metaTags + '\\n' +
-            '  <link rel="stylesheet" href="/farm-client.css">\\n' +
-            '  <link rel="modulepreload" href="/farm-client.js">\\n' +
+            '  <link rel="stylesheet" href="/__farm_client_css_href__">\\n' +
+            '  <link rel="modulepreload" href="/__farm_client_js_src__">\\n' +
             renderFarmRendererHydrationScript() + '\\n' +
             '</head>\\n<body>\\n  <div id="root">';
           const streamSuffix = '</div>\\n' +
@@ -5630,7 +5680,7 @@ async function handleFarmRequestInContext(
               routeSlotPayload,
               clientPageProps
             ) + '\\n' +
-            '  <script type="module" src="/farm-client.js"></script>\\n' +
+            '  <script type="module" src="/__farm_client_js_src__"></script>\\n' +
             '</body>\\n</html>';
           const themedStreamPrefix = streamPrefix.replace(
             '<html lang="en">',
@@ -5675,7 +5725,7 @@ async function handleFarmRequestInContext(
           // Layout provides full HTML structure - inject CSS and client script
           fullHtml = html
             // Inject CSS link after opening head tag or first meta tag
-            .replace(/<head([^>]*)>/i, '<head$1>\\n  <link rel="stylesheet" href="/farm-client.css">')
+            .replace(/<head([^>]*)>/i, '<head$1>\\n  <link rel="stylesheet" href="/__farm_client_css_href__">')
             .replace(/<\\/head>/i, renderFarmRendererHydrationScript() + '\\n</head>')
             // Inject title if not present and we have one
             .replace(/<head([^>]*)>([\\s\\S]*?)<\\/head>/i, (match, attrs, headContent) => {
@@ -5696,7 +5746,7 @@ async function handleFarmRequestInContext(
                 routeSlotPayload,
                 clientPageProps
               ) + '\\n' +
-                '  <script type="module" src="/farm-client.js"></script>\\n</body>',
+                '  <script type="module" src="/__farm_client_js_src__"></script>\\n</body>',
             );
           
           // Add DOCTYPE if not present
@@ -5712,13 +5762,13 @@ async function handleFarmRequestInContext(
   <meta name="viewport" content="width=device-width, initial-scale=1">
   \${hasFavicon ? "" : '<link rel="icon" href="data:,">'}
   <title>\${title}</title>\${metaTags}
-  <link rel="stylesheet" href="/farm-client.css">
+  <link rel="stylesheet" href="/__farm_client_css_href__">
   \${renderFarmRendererHydrationScript()}
 </head>
 <body>
   <div id="root">\${html}</div>
   \${renderFarmClientBootstrapScript(pageProps.__farmCanonicalPath, routeSlotPayload, clientPageProps)}
-  <script type="module" src="/farm-client.js"></script>
+  <script type="module" src="/__farm_client_js_src__"></script>
 </body>
 </html>\`;
         }
@@ -5977,12 +6027,12 @@ async function handleFarmRequestInContext(
     let fullHtml;
     if (hasFullDocument) {
       fullHtml = html
-        .replace(/<head([^>]*)>/i, '<head$1>\\n  <link rel="stylesheet" href="/farm-client.css">')
+        .replace(/<head([^>]*)>/i, '<head$1>\\n  <link rel="stylesheet" href="/__farm_client_css_href__">')
         .replace(/<\\/head>/i, renderFarmRendererHydrationScript() + '\\n</head>')
         .replace(
           /<\\/body>/i,
           '  ' + renderFarmClientBootstrapScript() + '\\n' +
-            '  <script type="module" src="/farm-client.js"></script>\\n</body>',
+            '  <script type="module" src="/__farm_client_js_src__"></script>\\n</body>',
         );
       if (!fullHtml.trim().startsWith('<!DOCTYPE')) {
         fullHtml = '<!DOCTYPE html>\\n' + fullHtml;
@@ -5994,14 +6044,14 @@ async function handleFarmRequestInContext(
   <meta charset="UTF-8">
   <meta name="viewport" content="width=device-width, initial-scale=1.0">
   <link rel="icon" href="data:,">
-  <link rel="stylesheet" href="/farm-client.css">
+  <link rel="stylesheet" href="/__farm_client_css_href__">
   <title>404 - Page Not Found</title>
   \${renderFarmRendererHydrationScript()}
 </head>
 <body>
   <div id="root">\${html}</div>
   \${renderFarmClientBootstrapScript()}
-  <script type="module" src="/farm-client.js"></script>
+  <script type="module" src="/__farm_client_js_src__"></script>
 </body>
 </html>\`;
     }
@@ -6338,7 +6388,7 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   const isVercel = preset === "vercel" || preset === "vercel-edge";
   const isCloudflareWorker = preset === "cloudflare-module";
   const outputDir = resolveDeployOutputPath(root, config.deploy.outputDir);
-  const ssrOutputDir = path3.join(root, distDir, "ssr");
+  const ssrOutputDir = path4.join(root, distDir, "ssr");
   const imageRuntime = resolveImageRuntime(config, preset);
   const hasGeneratedMetadataImages = Array.from(routeManager.getMetadataImages().values()).some(
     (image) => image.sourceType === "module"
@@ -6407,13 +6457,26 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   }
   const scheduledTasks = mergeScheduledTasks(farmWorkflows.scheduledTasks, farmCron.scheduledTasks);
   const cloudflareCronConfig = createFarmCronCloudflareConfig(farmCron.jobs);
+  const [clientCssHref, clientJsSrc] = await Promise.all([
+    resolveHashedClientCssHref(clientOutputDir),
+    resolveHashedClientJsSrc(clientOutputDir)
+  ]);
+  for (const output of Object.values(ssrBundle)) {
+    if (output.type !== "chunk") continue;
+    if (output.code.includes(FARM_CLIENT_CSS_HREF_PLACEHOLDER)) {
+      output.code = output.code.split(FARM_CLIENT_CSS_HREF_PLACEHOLDER).join(clientCssHref);
+    }
+    if (output.code.includes(FARM_CLIENT_JS_SRC_PLACEHOLDER)) {
+      output.code = output.code.split(FARM_CLIENT_JS_SRC_PLACEHOLDER).join(clientJsSrc);
+    }
+  }
   await fs.mkdir(ssrOutputDir, { recursive: true });
   for (const [fileName, output] of Object.entries(ssrBundle)) {
-    const filePath = path3.join(ssrOutputDir, fileName);
-    await fs.mkdir(path3.dirname(filePath), { recursive: true });
+    const filePath = path4.join(ssrOutputDir, fileName);
+    await fs.mkdir(path4.dirname(filePath), { recursive: true });
     await fs.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
   }
-  const nitroEntryPath = path3.join(ssrOutputDir, "nitro-entry.mjs");
+  const nitroEntryPath = path4.join(ssrOutputDir, "nitro-entry.mjs");
   const nitroEntryCode = `
 // Farm.js Nitro Entry
 // This file adapts Farm's Web fetch handler to Nitro's event handler contract.
@@ -6478,12 +6541,12 @@ export default async function farmNitroEventHandler(event) {
 }
   `.trim();
   await fs.writeFile(nitroEntryPath, nitroEntryCode);
-  const farmNodeServerEntryPath = preset === "node-server" ? path3.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
+  const farmNodeServerEntryPath = preset === "node-server" ? path4.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
   if (farmNodeServerEntryPath) {
     await fs.writeFile(
       farmNodeServerEntryPath,
       createFarmNodeServerEntry({
-        nitroEntryFile: path3.basename(nitroEntryPath),
+        nitroEntryFile: path4.basename(nitroEntryPath),
         nodeHandlerModule: resolveNitroRuntimeDependency(root, "srvx/node"),
         server: config.server,
         websocketAdapterModule: resolveNitroRuntimeDependency(root, "crossws/adapters/node")
@@ -6517,12 +6580,12 @@ export default async function farmNitroEventHandler(event) {
     ...farmNodeServerEntryPath ? { entry: farmNodeServerEntryPath } : {},
     rootDir: root,
     srcDir: root,
-    buildDir: path3.join(root, distDir, ".nitro"),
+    buildDir: path4.join(root, distDir, ".nitro"),
     compatibilityDate: "2024-12-01",
     output: {
       dir: outputDir,
-      serverDir: path3.join(outputDir, "server"),
-      publicDir: path3.join(outputDir, "public")
+      serverDir: path4.join(outputDir, "server"),
+      publicDir: path4.join(outputDir, "public")
     },
     publicAssets: [
       {
@@ -6607,7 +6670,7 @@ export default async function farmNitroEventHandler(event) {
   if (pluginManager) {
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
-  const expectedServerDir = path3.join(outputDir, "server");
+  const expectedServerDir = path4.join(outputDir, "server");
   const customRollupKeys = Object.keys(nitroConfig.rollupConfig || {}).filter(
     (key) => key !== "external" && key !== "plugins"
   );
@@ -6623,9 +6686,9 @@ export default async function farmNitroEventHandler(event) {
     snapshotSSRRebundleOptions(nitroConfig)
   );
   const requestedBuilder = nitroConfig.builder ?? process.env.NITRO_BUILDER;
-  const canReusePrebuiltSSR = isPrebuiltSSRCandidate && nitroConfig.preset === "node-server" && (requestedBuilder === void 0 || requestedBuilder === "rollup" || requestedBuilder === "rolldown") && nitroConfig.sourceMap === false && !hasUnsupportedEsbuildOverrides && !hasLateBuildMutationConfig && !hasUnsupportedSSRRebundleOverrides && nitroConfig.rollupConfig?.external === nitroRollupExternal && !hasRollupPlugins(nitroConfig.rollupConfig?.plugins) && customRollupKeys.length === 0 && path3.resolve(nitroConfig.output?.serverDir || "") === path3.resolve(expectedServerDir) && Boolean(
+  const canReusePrebuiltSSR = isPrebuiltSSRCandidate && nitroConfig.preset === "node-server" && (requestedBuilder === void 0 || requestedBuilder === "rollup" || requestedBuilder === "rolldown") && nitroConfig.sourceMap === false && !hasUnsupportedEsbuildOverrides && !hasLateBuildMutationConfig && !hasUnsupportedSSRRebundleOverrides && nitroConfig.rollupConfig?.external === nitroRollupExternal && !hasRollupPlugins(nitroConfig.rollupConfig?.plugins) && customRollupKeys.length === 0 && path4.resolve(nitroConfig.output?.serverDir || "") === path4.resolve(expectedServerDir) && Boolean(
     nitroConfig.handlers?.some(
-      (handler) => path3.resolve(handler?.handler || "") === nitroEntryPath
+      (handler) => path4.resolve(handler?.handler || "") === nitroEntryPath
     )
   );
   const selectRolldownBuilder = canReusePrebuiltSSR && requestedBuilder === void 0 && await canUseRolldownBuilder();
@@ -6637,8 +6700,9 @@ export default async function farmNitroEventHandler(event) {
     ...configuredEsbuildOptions,
     // Function-name helpers are unsafe for provider scripts that serialize a
     // function with toString(); the helper is outside the emitted script scope.
-    keepNames: configuredEsbuildOptions.keepNames ?? !(config.docs?.enabled && config.docs.adapter?.server)
+    keepNames: config.docs?.enabled && config.docs.adapter?.server ? false : configuredEsbuildOptions.keepNames ?? true
   };
+  const prebuiltSSREsbuildOptions = config.docs?.enabled && config.docs.adapter?.server ? resolvedEsbuildOptions : configuredEsbuildOptions;
   const effectiveMinify = configuredEsbuildOptions.minify ?? shouldMinify;
   const useFarmEsbuildMinifier = effectiveMinify && nitroConfig.sourceMap === false && !hasUnsupportedEsbuildOverrides && !hasLateBuildMutationConfig;
   const esbuildChunkMinifier = useFarmEsbuildMinifier ? createEsbuildChunkMinifyPlugin(resolvedEsbuildOptions) : null;
@@ -6680,10 +6744,10 @@ export default async function farmNitroEventHandler(event) {
         });
       }
       prerenderer.hooks.hook("compiled", async () => {
-        const prerenderServerDir = path3.join(outputDir, "server");
+        const prerenderServerDir = path4.join(outputDir, "server");
         await copyPrebuiltSSRBundle(
           ssrBundle,
-          path3.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
+          path4.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
           {},
           false,
           fs
@@ -6717,20 +6781,20 @@ export default async function farmNitroEventHandler(event) {
   const copyResults = await Promise.allSettled([
     canReusePrebuiltSSR ? copyPrebuiltSSRBundle(
       ssrBundle,
-      path3.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
-      configuredEsbuildOptions,
+      path4.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
+      prebuiltSSREsbuildOptions,
       effectiveMinify,
       fs
     ) : Promise.resolve(),
-    imageRuntime === "node" ? copySharpRuntime(config, root, path3.join(outputDir, "server"), fs) : Promise.resolve(),
-    useExternalMetadataImageRuntime ? copyMetadataImageRuntime(root, path3.join(outputDir, "server"), fs) : Promise.resolve()
+    imageRuntime === "node" ? copySharpRuntime(config, root, path4.join(outputDir, "server"), fs) : Promise.resolve(),
+    useExternalMetadataImageRuntime ? copyMetadataImageRuntime(root, path4.join(outputDir, "server"), fs) : Promise.resolve()
   ]);
   const failedCopy = copyResults.find(
     (result) => result.status === "rejected"
   );
   if (failedCopy) throw failedCopy.reason;
   if (canReusePrebuiltSSR) {
-    await registerPrebuiltSSRPackageImport(path3.join(outputDir, "server"), ssrEntryFile, fs);
+    await registerPrebuiltSSRPackageImport(path4.join(outputDir, "server"), ssrEntryFile, fs);
     logger.info("\u26A1 Reused Farm's prebuilt SSR bundle for the Node output");
   }
   if (useRolldownBuilder) {
@@ -6770,8 +6834,8 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
   await fs.rm(targetDir, { recursive: true, force: true });
   await Promise.all(
     Object.entries(ssrBundle).map(async ([fileName, output]) => {
-      const targetPath = path3.join(targetDir, fileName);
-      await fs.mkdir(path3.dirname(targetPath), { recursive: true });
+      const targetPath = path4.join(targetDir, fileName);
+      await fs.mkdir(path4.dirname(targetPath), { recursive: true });
       if (output.type === "asset") {
         await fs.writeFile(targetPath, output.source);
         return;
@@ -6790,7 +6854,7 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
 }
 __name(copyPrebuiltSSRBundle, "copyPrebuiltSSRBundle");
 async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs) {
-  const packagePath = path3.join(serverDir, "package.json");
+  const packagePath = path4.join(serverDir, "package.json");
   const packageJSON = await fs.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
     if (error.code === "ENOENT") return { type: "module" };
     throw error;
@@ -6807,16 +6871,16 @@ async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs) {
 }
 __name(registerPrebuiltSSRPackageImport, "registerPrebuiltSSRPackageImport");
 async function postProcessVercelOutput(root, outputDir, fs, config, farmWorkflows, routeRuntimeManifest) {
-  const serverDir = path3.join(outputDir, "server");
-  const functionsDir = path3.join(outputDir, "functions");
-  const nitroFuncDir = path3.join(functionsDir, "__nitro.func");
-  const staticDir = path3.join(outputDir, "static");
-  const publicDir = path3.join(outputDir, "public");
+  const serverDir = path4.join(outputDir, "server");
+  const functionsDir = path4.join(outputDir, "functions");
+  const nitroFuncDir = path4.join(functionsDir, "__nitro.func");
+  const staticDir = path4.join(outputDir, "static");
+  const publicDir = path4.join(outputDir, "public");
   await fs.mkdir(nitroFuncDir, { recursive: true });
   const serverContents = await fs.readdir(serverDir);
   for (const file of serverContents) {
-    const src = path3.join(serverDir, file);
-    const dest = path3.join(nitroFuncDir, file);
+    const src = path4.join(serverDir, file);
+    const dest = path4.join(nitroFuncDir, file);
     await fs.rename(src, dest);
   }
   await fs.rmdir(serverDir);
@@ -6826,7 +6890,7 @@ async function postProcessVercelOutput(root, outputDir, fs, config, farmWorkflow
   }
   await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs);
   await copyPrismaClientForVercel(root, nitroFuncDir, fs);
-  const configPath = path3.join(outputDir, "config.json");
+  const configPath = path4.join(outputDir, "config.json");
   const configContent = await fs.readFile(configPath, "utf-8");
   const vercelConfig = JSON.parse(configContent);
   const runtimeRoutes = await createFarmVercelRouteRuntimeFunctions(
@@ -6874,27 +6938,27 @@ __name(postProcessVercelOutput, "postProcessVercelOutput");
 async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs) {
   const docsContentDir = resolveBuildDocsContentDir(config, root);
   if (!docsContentDir) return;
-  const bundledContentDir = path3.join(nitroFuncDir, "chunks", "nitro", "farm-docs-content");
+  const bundledContentDir = path4.join(nitroFuncDir, "chunks", "nitro", "farm-docs-content");
   const lastModifiedManifest = createFarmDocsLastModifiedManifest(docsContentDir, {
     fallback: "now"
   });
   await fs.rm(bundledContentDir, { recursive: true, force: true });
-  await fs.mkdir(path3.dirname(bundledContentDir), { recursive: true });
+  await fs.mkdir(path4.dirname(bundledContentDir), { recursive: true });
   await fs.cp(docsContentDir, bundledContentDir, {
     recursive: true,
     force: true
   });
   await fs.writeFile(
-    path3.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
+    path4.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
     `${JSON.stringify(lastModifiedManifest, null, 2)}
 `
   );
-  logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${path3.relative(root, docsContentDir)}`);
+  logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${path4.relative(root, docsContentDir)}`);
 }
 __name(copyFarmDocsContentForVercel, "copyFarmDocsContentForVercel");
 async function copySharpRuntime(config, root, nitroFuncDir, fs) {
   if (config.images.provider === "none") return;
-  const projectRequire = createRequire(path3.join(root, "package.json"));
+  const projectRequire = createRequire(path4.join(root, "package.json"));
   let sharpRequire = projectRequire;
   if (!resolvePackageJson(projectRequire, "sharp")) {
     try {
@@ -6904,7 +6968,7 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs) {
   }
   const copiedPackages = /* @__PURE__ */ new Map();
   const packageCopies = /* @__PURE__ */ new Map();
-  const targetNodeModules = path3.join(nitroFuncDir, "node_modules");
+  const targetNodeModules = path4.join(nitroFuncDir, "node_modules");
   function copyPackage(packageName, parentRequire) {
     const activeCopy = packageCopies.get(packageName);
     if (activeCopy) return activeCopy;
@@ -6917,10 +6981,10 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs) {
     const packageJsonPath = resolvePackageJson(parentRequire, packageName);
     if (!packageJsonPath) return;
     const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
-    const packageDir = path3.dirname(packageJsonPath);
-    const targetDir = path3.join(targetNodeModules, ...packageName.split("/"));
+    const packageDir = path4.dirname(packageJsonPath);
+    const targetDir = path4.join(targetNodeModules, ...packageName.split("/"));
     copiedPackages.set(packageName, String(packageJson.version || "*"));
-    await fs.mkdir(path3.dirname(targetDir), { recursive: true });
+    await fs.mkdir(path4.dirname(targetDir), { recursive: true });
     const packageRequire = createRequire(packageJsonPath);
     const dependencies = {
       ...packageJson.dependencies,
@@ -6945,7 +7009,7 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs) {
       "Farm image optimization requires sharp. Reinstall dependencies without omitting optional packages."
     );
   }
-  const functionPackagePath = path3.join(nitroFuncDir, "package.json");
+  const functionPackagePath = path4.join(nitroFuncDir, "package.json");
   const functionPackage = JSON.parse(await fs.readFile(functionPackagePath, "utf8"));
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
@@ -6956,7 +7020,7 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs) {
 }
 __name(copySharpRuntime, "copySharpRuntime");
 async function copyMetadataImageRuntime(root, nitroFuncDir, fs) {
-  const projectRequire = createRequire(path3.join(root, "package.json"));
+  const projectRequire = createRequire(path4.join(root, "package.json"));
   let runtimeRequire = projectRequire;
   let packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
   if (!packageJsonPath) {
@@ -6972,16 +7036,16 @@ async function copyMetadataImageRuntime(root, nitroFuncDir, fs) {
     );
   }
   const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
-  const packageDir = path3.dirname(packageJsonPath);
-  const targetDir = path3.join(nitroFuncDir, "node_modules", "@vercel", "og");
-  await fs.mkdir(path3.dirname(targetDir), { recursive: true });
+  const packageDir = path4.dirname(packageJsonPath);
+  const targetDir = path4.join(nitroFuncDir, "node_modules", "@vercel", "og");
+  await fs.mkdir(path4.dirname(targetDir), { recursive: true });
   await fs.cp(packageDir, targetDir, {
     recursive: true,
     force: true,
     dereference: true,
     mode: fsConstants.COPYFILE_FICLONE
   });
-  const functionPackagePath = path3.join(nitroFuncDir, "package.json");
+  const functionPackagePath = path4.join(nitroFuncDir, "package.json");
   const functionPackage = JSON.parse(await fs.readFile(functionPackagePath, "utf8"));
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
@@ -7002,23 +7066,23 @@ function resolvePackageJson(parentRequire, packageName) {
 }
 __name(resolvePackageJson, "resolvePackageJson");
 async function copyPrismaClientForVercel(root, nitroFuncDir, fs) {
-  const projectRequire = createRequire(path3.join(root, "package.json"));
+  const projectRequire = createRequire(path4.join(root, "package.json"));
   let prismaClientDir;
   try {
-    prismaClientDir = path3.dirname(projectRequire.resolve("@prisma/client/default.js"));
+    prismaClientDir = path4.dirname(projectRequire.resolve("@prisma/client/default.js"));
   } catch {
     return;
   }
-  const generatedClientDir = path3.join(prismaClientDir, "..", "..", ".prisma", "client");
+  const generatedClientDir = path4.join(prismaClientDir, "..", "..", ".prisma", "client");
   try {
     await fs.access(generatedClientDir);
   } catch {
     return;
   }
-  const targetNodeModules = path3.join(nitroFuncDir, "node_modules");
-  const targetPrismaScopeDir = path3.join(targetNodeModules, "@prisma");
-  const targetGeneratedDir = path3.join(targetNodeModules, ".prisma", "client");
-  const targetClientDir = path3.join(targetPrismaScopeDir, "client");
+  const targetNodeModules = path4.join(nitroFuncDir, "node_modules");
+  const targetPrismaScopeDir = path4.join(targetNodeModules, "@prisma");
+  const targetGeneratedDir = path4.join(targetNodeModules, ".prisma", "client");
+  const targetClientDir = path4.join(targetPrismaScopeDir, "client");
   await fs.mkdir(targetPrismaScopeDir, { recursive: true });
   await fs.cp(prismaClientDir, targetClientDir, {
     recursive: true,
@@ -7028,8 +7092,8 @@ async function copyPrismaClientForVercel(root, nitroFuncDir, fs) {
     recursive: true,
     force: true
   });
-  const functionPackagePath = path3.join(nitroFuncDir, "package.json");
-  const clientPackagePath = path3.join(prismaClientDir, "package.json");
+  const functionPackagePath = path4.join(nitroFuncDir, "package.json");
+  const clientPackagePath = path4.join(prismaClientDir, "package.json");
   const [functionPackageContent, clientPackageContent] = await Promise.all([
     fs.readFile(functionPackagePath, "utf-8"),
     fs.readFile(clientPackagePath, "utf-8")
@@ -7099,7 +7163,9 @@ async function buildWithProductionNodeEnv(config, options) {
       suppressLintOnLink: config.suppressLintOnLink,
       componentExtensions: config.renderer.componentExtensions,
       i18nConfig: config.i18n
-    }).catch(() => {
+    }).catch((error) => {
+      const message = error instanceof Error ? error.message : String(error);
+      logger.warn(`Route type generation failed (farm.d.ts may be stale): ${message}`);
     });
     const apiRouteManager = new APIRouteManager(
       getFarmAppDirectories(config),
@@ -7125,9 +7191,9 @@ async function buildWithProductionNodeEnv(config, options) {
     } else {
       const { build: legacyViteBuild } = await import("vite");
       logger.info("\u{1F4E6} Building client bundle...");
-      await buildClient2(legacyViteBuild, config, root, srcDir, path4.join(root, distDir, "client"));
+      await buildClient2(legacyViteBuild, config, root, srcDir, path5.join(root, distDir, "client"));
       logger.info("\u{1F4E6} Building SSR bundle...");
-      await buildSSR(legacyViteBuild, config, root, srcDir, path4.join(root, distDir, "server"));
+      await buildSSR(legacyViteBuild, config, root, srcDir, path5.join(root, distDir, "server"));
       logger.info(`\u{1F680} Building server with Nitro (preset: ${preset})...`);
       await buildNitro(
         config,
@@ -7149,7 +7215,7 @@ async function buildWithProductionNodeEnv(config, options) {
       outputDir: deployOutputDir,
       success: true
     });
-    logger.success("\u2705 Build completed successfully!");
+    logger.success(`\u2705 Build completed successfully! (preset: ${preset})`);
     logger.info(`\u{1F4C1} Output directory: ${deployOutputDir}`);
   } catch (error) {
     await pluginManager.runHookParallel("onError", {
@@ -7297,12 +7363,12 @@ async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
 }
 __name(buildSSR, "buildSSR");
 function resolveLegacyPageEntry(config, root, srcDir) {
-  const appDir = path4.join(root, srcDir, "app");
+  const appDir = path5.join(root, srcDir, "app");
   for (const extension of getFarmRendererComponentExtensions(config.renderer)) {
-    const candidate = path4.join(appDir, `page${extension}`);
+    const candidate = path5.join(appDir, `page${extension}`);
     if (existsSync2(candidate)) return candidate;
   }
-  return path4.join(appDir, "page.tsx");
+  return path5.join(appDir, "page.tsx");
 }
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
@@ -7321,18 +7387,18 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
   const outputDir = resolveDeployOutputPath(root, config.deploy.outputDir);
-  const serverOutputDir = path4.join(outputDir, "server");
-  const publicOutputDir = path4.join(outputDir, "public");
+  const serverOutputDir = path5.join(outputDir, "server");
+  const publicOutputDir = path5.join(outputDir, "public");
   const { mkdir, cp } = await import("fs/promises");
   await mkdir(serverOutputDir, { recursive: true });
   await mkdir(publicOutputDir, { recursive: true });
-  const clientDir = path4.join(root, distDir, "client");
+  const clientDir = path5.join(root, distDir, "client");
   try {
     await mkdir(publicOutputDir, { recursive: true });
     await cp(clientDir, publicOutputDir, { recursive: true });
     logger.info("\u{1F4E6} Copied client assets to public directory");
-    const manifestPath = path4.join(publicOutputDir, "farm-client-manifest.json");
-    const assetsDir = path4.join(publicOutputDir, "assets");
+    const manifestPath = path5.join(publicOutputDir, "farm-client-manifest.json");
+    const assetsDir = path5.join(publicOutputDir, "assets");
     const manifestExists = await import("fs/promises").then(
       (fs) => fs.access(manifestPath).then(() => true).catch(() => false)
     );
@@ -7348,8 +7414,8 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     logger.error(`\u274C Failed to copy client assets: ${error}`);
     throw error;
   }
-  const serverDir = path4.join(root, distDir, "server");
-  const nitroServerDir = path4.join(root, distDir, ".nitro", "server", "farm");
+  const serverDir = path5.join(root, distDir, "server");
+  const nitroServerDir = path5.join(root, distDir, ".nitro", "server", "farm");
   try {
     await mkdir(nitroServerDir, { recursive: true });
     await cp(serverDir, nitroServerDir, { recursive: true });
@@ -7358,7 +7424,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     logger.warn(`Could not copy SSR bundles: ${error}`);
   }
   const nitro = await createNitro(nitroConfig);
-  const registryPath = path4.join(root, distDir, ".nitro", "server", "farm-registry.ts");
+  const registryPath = path5.join(root, distDir, ".nitro", "server", "farm-registry.ts");
   try {
     const { farmRegistry } = await import(
       /* @vite-ignore */
@@ -7375,7 +7441,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     }
     farmRegistry.routePaths = routePaths;
     try {
-      const clientManifestPath = path4.join(root, distDir, "client", "farm-client-manifest.json");
+      const clientManifestPath = path5.join(root, distDir, "client", "farm-client-manifest.json");
       const { readFile } = await import("fs/promises");
       const manifestContent = await readFile(clientManifestPath, "utf-8");
       farmRegistry.clientManifest = JSON.parse(manifestContent);
@@ -7400,4 +7466,4 @@ __name(buildNitro, "buildNitro");
 export {
   build
 };
-//# sourceMappingURL=chunk-4TI6B4AY.mjs.map
+//# sourceMappingURL=chunk-HLN7NPNQ.mjs.map