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

package/dist/index.cjs

@@ -70,7 +70,8 @@ function resolveFarmRenderer(renderer) {
     dedupe: [...resolved.dedupe || []],
     optimizeDeps: [...resolved.optimizeDeps || []],
     buildConcurrency: resolved.buildConcurrency || "parallel",
-    capabilities: getFarmRendererCapabilities(resolved)
+    capabilities: getFarmRendererCapabilities(resolved),
+    options: resolved.options ? { ...resolved.options } : void 0
   };
 }
 async function readFarmRendererWebStream(stream) {
@@ -92,7 +93,7 @@ function resolveFarmRendererModule(root, specifier) {
   return requireFromApp.resolve(specifier);
 }
 async function loadFarmRendererVitePlugins(renderer, root, options = {}) {
-  if (isReactRenderer(renderer)) return [];
+  if (renderer.vite === REACT_RENDERER.vite) return [];
   const modulePath = resolveFarmRendererModule(root, renderer.vite);
   const rendererModule = await import((0, import_node_url.pathToFileURL)(modulePath).href);
   if (typeof rendererModule.createFarmRendererPlugin !== "function") {
@@ -100,7 +101,10 @@ async function loadFarmRendererVitePlugins(renderer, root, options = {}) {
       `Renderer \`${renderer.name}\` module ${renderer.vite} must export createFarmRendererPlugin().`
     );
   }
-  const created = await rendererModule.createFarmRendererPlugin(options);
+  const created = await rendererModule.createFarmRendererPlugin({
+    ...options,
+    rendererOptions: renderer.options
+  });
   if (!created) return [];
   return Array.isArray(created) ? [...created] : [created];
 }
@@ -787,13 +791,13 @@ function defineIntegrationAPI(api3) {
 }
 function operation(method, pathOrOptions, maybeOptions = {}) {
   const hasExplicitPath = typeof pathOrOptions === "string";
-  const path37 = hasExplicitPath ? pathOrOptions : "";
+  const path38 = hasExplicitPath ? pathOrOptions : "";
   const options = hasExplicitPath ? maybeOptions : {
     ...maybeOptions,
     ...pathOrOptions
   };
   return defineIntegrationAPIOperation({
-    path: path37,
+    path: path38,
     method,
     __pathless: !hasExplicitPath,
     ...options
@@ -805,26 +809,26 @@ function get(pathOrOptions, maybeOptions = {}) {
 function isOperation(value) {
   return !!value && typeof value === "object" && value.kind === "farm-integration-api-operation";
 }
-function bindRoutePath(path37, api3) {
+function bindRoutePath(path38, api3) {
   const entries = Object.entries(api3).map(([key, value]) => {
     if (isOperation(value)) {
       return [
         key,
         {
           ...value,
-          path: path37,
+          path: path38,
           __pathless: false
         }
       ];
     }
     if (value && typeof value === "object") {
-      return [key, bindRoutePath(path37, value)];
+      return [key, bindRoutePath(path38, value)];
     }
     return [key, value];
   });
   return Object.fromEntries(entries);
 }
-function route(path37, definitionOrOperation, ...operations) {
+function route(path38, definitionOrOperation, ...operations) {
   if (isOperation(definitionOrOperation)) {
     const allOperations = [definitionOrOperation, ...operations];
     return Object.fromEntries(
@@ -832,13 +836,13 @@ function route(path37, definitionOrOperation, ...operations) {
         operation2.method.toLowerCase(),
         {
           ...operation2,
-          path: path37,
+          path: path38,
           __pathless: false
         }
       ])
     );
   }
-  return bindRoutePath(path37, definitionOrOperation);
+  return bindRoutePath(path38, definitionOrOperation);
 }
 function normalizeRouteSegment(segment) {
   if (!segment) {
@@ -859,8 +863,8 @@ function normalizeRouteSegment(segment) {
 function camelCaseRouteSegment(segment) {
   return segment.replace(/-([a-zA-Z0-9])/g, (_match, value) => value.toUpperCase());
 }
-function getRouteClientSegments(path37) {
-  const segments = path37.split("/").filter(Boolean);
+function getRouteClientSegments(path38) {
+  const segments = path38.split("/").filter(Boolean);
   if (segments.length === 0) {
     return ["index"];
   }
@@ -1239,11 +1243,11 @@ function resolveFarmServerHealthConfig(config) {
   return Object.freeze({ enabled: true, livenessPath, readinessPath });
 }
 function normalizeHealthPath(value, optionName) {
-  const path37 = value.trim();
-  if (!path37.startsWith("/") || path37.includes("?") || path37.includes("#") || path37.includes("*")) {
+  const path38 = value.trim();
+  if (!path38.startsWith("/") || path38.includes("?") || path38.includes("#") || path38.includes("*")) {
     throw new TypeError(`${optionName} must be an absolute pathname without a query or wildcard`);
   }
-  return path37.length > 1 ? path37.replace(/\/+$/, "") || "/" : path37;
+  return path38.length > 1 ? path38.replace(/\/+$/, "") || "/" : path38;
 }
 function parseBodySizeLimit(value, optionName = "bodySizeLimit") {
   if (typeof value === "number") {
@@ -1584,9 +1588,9 @@ function getFarmIntegrationPluginOwner(plugin) {
   const value = plugin[FARM_INTEGRATION_PLUGIN_OWNER];
   return value && typeof value === "object" ? value : void 0;
 }
-function defineTypedIntegrationRoute(method, path37, input) {
+function defineTypedIntegrationRoute(method, path38, input) {
   return {
-    path: path37,
+    path: path38,
     method,
     middleware: input.middleware,
     before: input.before,
@@ -1596,7 +1600,7 @@ function defineTypedIntegrationRoute(method, path37, input) {
     input: normalizeIntegrationRouteInputSchemas(input),
     handler: input.handler,
     __operation: defineIntegrationAPIOperation({
-      path: path37,
+      path: path38,
       method,
       bodyFormat: input.bodyFormat,
       responseFormat: input.responseFormat,
@@ -1608,58 +1612,58 @@ function defineTypedIntegrationRoute(method, path37, input) {
 }
 function createIntegrationRouteFactory() {
   return {
-    get(path37, input) {
+    get(path38, input) {
       return defineTypedIntegrationRoute(
         "GET",
-        path37,
+        path38,
         input
       );
     },
-    post(path37, input) {
+    post(path38, input) {
       return defineTypedIntegrationRoute(
         "POST",
-        path37,
+        path38,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    query(path37, input) {
-      return defineTypedIntegrationRoute("QUERY", path37, {
+    query(path38, input) {
+      return defineTypedIntegrationRoute("QUERY", path38, {
         bodyFormat: "json",
         ...input
       });
     },
-    put(path37, input) {
+    put(path38, input) {
       return defineTypedIntegrationRoute(
         "PUT",
-        path37,
+        path38,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    patch(path37, input) {
-      return defineTypedIntegrationRoute("PATCH", path37, {
+    patch(path38, input) {
+      return defineTypedIntegrationRoute("PATCH", path38, {
         bodyFormat: "json",
         ...input
       });
     },
-    delete(path37, input) {
-      return defineTypedIntegrationRoute("DELETE", path37, {
+    delete(path38, input) {
+      return defineTypedIntegrationRoute("DELETE", path38, {
         bodyFormat: "json",
         ...input
       });
     },
-    options(path37, input) {
-      return defineTypedIntegrationRoute("OPTIONS", path37, input);
+    options(path38, input) {
+      return defineTypedIntegrationRoute("OPTIONS", path38, input);
     },
-    head(path37, input) {
+    head(path38, input) {
       return defineTypedIntegrationRoute(
         "HEAD",
-        path37,
+        path38,
         input
       );
     }
@@ -2006,8 +2010,8 @@ async function parseIntegrationConfigSchema(integration, schema, value) {
 function createIntegrationConfigValidationError(integration, error) {
   const issues = Array.isArray(error.issues) && error.issues.length > 0 ? error.issues.map((issue) => {
     const normalizedPath = normalizeIntegrationValidationPath(issue.path);
-    const path37 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
-    return `${path37}${issue.message || "Invalid config"}`;
+    const path38 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
+    return `${path38}${issue.message || "Invalid config"}`;
   }).join("; ") : error.message || "Invalid config";
   return new Error(`Integration "${integration.type}" config validation failed: ${issues}`);
 }
@@ -2716,8 +2720,8 @@ function normalizeIntegrationValidationIssues(source, error) {
     }
   ];
 }
-function normalizeIntegrationValidationPath(path37) {
-  return (path37 || []).map((segment) => {
+function normalizeIntegrationValidationPath(path38) {
+  return (path38 || []).map((segment) => {
     const key = typeof segment === "object" && segment !== null && "key" in segment ? segment.key : segment;
     return typeof key === "symbol" ? key.description || key.toString() : key;
   });
@@ -3992,20 +3996,20 @@ async function prepareFarmWorkflowsForNitro(config) {
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
   const fs13 = await import("fs/promises");
-  const path37 = await import("path");
-  const generatedDir = path37.join(root, distDir, ".nitro", "farm-workflows");
+  const path38 = await import("path");
+  const generatedDir = path38.join(root, distDir, ".nitro", "farm-workflows");
   await fs13.mkdir(generatedDir, { recursive: true });
   const tasks = {};
   const scheduledTasks = createScheduledTasks(workflows);
   for (const workflow of workflows) {
-    const wrapperPath = path37.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
+    const wrapperPath = path38.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
     await fs13.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
     tasks[workflow.id] = {
       handler: wrapperPath,
       description: workflow.description || `Farm workflow ${workflow.id}`
     };
   }
-  const handlerPath = path37.join(generatedDir, "http-handler.mjs");
+  const handlerPath = path38.join(generatedDir, "http-handler.mjs");
   await fs13.writeFile(
     handlerPath,
     createNitroWorkflowHTTPHandler(
@@ -4015,7 +4019,7 @@ async function prepareFarmWorkflowsForNitro(config) {
     ),
     "utf8"
   );
-  const manifestPath = path37.join(generatedDir, "manifest.json");
+  const manifestPath = path38.join(generatedDir, "manifest.json");
   await fs13.writeFile(
     manifestPath,
     JSON.stringify(
@@ -4098,10 +4102,10 @@ function resolveWorkflowDefinition(module2) {
 }
 async function findWorkflowFiles(root, dirs) {
   const fs13 = await import("fs/promises");
-  const path37 = await import("path");
+  const path38 = await import("path");
   const files = [];
   for (const dir of dirs) {
-    const absoluteDir = path37.isAbsolute(dir) ? dir : path37.join(root, dir);
+    const absoluteDir = path38.isAbsolute(dir) ? dir : path38.join(root, dir);
     if (!await pathExists(absoluteDir)) continue;
     await walkWorkflowDir(absoluteDir, files);
   }
@@ -4109,10 +4113,10 @@ async function findWorkflowFiles(root, dirs) {
 }
 async function walkWorkflowDir(dir, files) {
   const fs13 = await import("fs/promises");
-  const path37 = await import("path");
+  const path38 = await import("path");
   const entries = await fs13.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const filePath = path37.join(dir, entry.name);
+    const filePath = path38.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
       await walkWorkflowDir(filePath, files);
@@ -4132,12 +4136,12 @@ function isWorkflowFile(fileName) {
 }
 async function loadWorkflowModule(filePath, root) {
   const fs13 = await import("fs/promises");
-  const path37 = await import("path");
+  const path38 = await import("path");
   const { pathToFileURL: pathToFileURL9 } = await import("url");
   const { build: build3 } = await import("esbuild");
-  const outDir = path37.join(root, ".farm", ".workflow-loader");
+  const outDir = path38.join(root, ".farm", ".workflow-loader");
   await fs13.mkdir(outDir, { recursive: true });
-  const outfile = path37.join(
+  const outfile = path38.join(
     outDir,
     `workflow-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
   );
@@ -4432,9 +4436,9 @@ async function prepareFarmCronForNitro(config) {
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
   const fs13 = await import("fs/promises");
-  const path37 = await import("path");
-  const manifestPath = path37.join(root, distDir, FARM_CRON_MANIFEST);
-  const generatedDir = path37.join(root, distDir, ".nitro", "farm-cron");
+  const path38 = await import("path");
+  const manifestPath = path38.join(root, distDir, FARM_CRON_MANIFEST);
+  const generatedDir = path38.join(root, distDir, ".nitro", "farm-cron");
   if (!cron.enabled) {
     await Promise.all([
       fs13.rm(manifestPath, { force: true }),
@@ -4451,7 +4455,7 @@ async function prepareFarmCronForNitro(config) {
   const tasks = {};
   for (const job of cron.jobs) {
     const taskName = getFarmCronTaskName(job.name);
-    const wrapperPath = path37.join(generatedDir, `${safeFileName2(job.name)}.mjs`);
+    const wrapperPath = path38.join(generatedDir, `${safeFileName2(job.name)}.mjs`);
     await fs13.writeFile(wrapperPath, createNitroCronTaskWrapper(job, cron.secretEnv), "utf8");
     tasks[taskName] = {
       handler: wrapperPath,
@@ -4459,7 +4463,7 @@ async function prepareFarmCronForNitro(config) {
     };
   }
   const manifest = createFarmCronManifest(cron);
-  await fs13.mkdir(path37.dirname(manifestPath), { recursive: true });
+  await fs13.mkdir(path38.dirname(manifestPath), { recursive: true });
   await fs13.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
   return {
@@ -4561,7 +4565,7 @@ function normalizeCronJob(name2, job) {
   if (!job || typeof job !== "object" || Array.isArray(job)) {
     throw new TypeError(`Farm cron ${JSON.stringify(name2)} must be a configuration object.`);
   }
-  const path37 = normalizeCronPath(name2, job.path);
+  const path38 = normalizeCronPath(name2, job.path);
   const rawSchedule = Array.isArray(job.schedule) ? job.schedule : [job.schedule];
   const schedule = [...new Set(rawSchedule.map((value) => normalizeCronExpression(name2, value)))];
   if (schedule.length === 0) {
@@ -4570,7 +4574,7 @@ function normalizeCronJob(name2, job) {
   return {
     name: name2,
     schedule,
-    path: path37,
+    path: path38,
     description: job.description?.trim() || void 0
   };
 }
@@ -4578,13 +4582,13 @@ function normalizeCronPath(name2, value) {
   if (typeof value !== "string" || !value.trim().startsWith("/")) {
     throw new TypeError(`Farm cron ${JSON.stringify(name2)} path must start with "/".`);
   }
-  const path37 = value.trim();
-  if (path37.startsWith("//") || path37.includes("?") || path37.includes("#")) {
+  const path38 = value.trim();
+  if (path38.startsWith("//") || path38.includes("?") || path38.includes("#")) {
     throw new TypeError(
       `Farm cron ${JSON.stringify(name2)} path must be an application pathname without a host, query, or hash.`
     );
   }
-  return path37.length > 1 ? path37.replace(/\/+$/, "") : path37;
+  return path38.length > 1 ? path38.replace(/\/+$/, "") : path38;
 }
 function normalizeCronExpression(name2, value) {
   if (typeof value !== "string") {
@@ -6096,7 +6100,7 @@ var init_server_action_security = __esm({
 
 // src/image-config.ts
 function resolveFarmImageConfig(config) {
-  const path37 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
+  const path38 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
   const deviceSizes = normalizeIntegerList(
     config?.deviceSizes ?? DEFAULT_FARM_IMAGE_DEVICE_SIZES,
     "images.deviceSizes"
@@ -6124,7 +6128,7 @@ function resolveFarmImageConfig(config) {
   );
   return Object.freeze({
     provider: config?.provider ?? "auto",
-    path: path37,
+    path: path38,
     domains: Object.freeze([
       ...new Set(
         (config?.domains ?? []).map((domain) => domain.trim().toLowerCase()).filter(Boolean)
@@ -6163,11 +6167,11 @@ function getPublicFarmImageConfig(config) {
   };
 }
 function normalizeImagePath(value) {
-  const path37 = value.trim().replace(/\/+$/, "") || "/";
-  if (!path37.startsWith("/") || path37.includes("?") || path37.includes("#")) {
+  const path38 = value.trim().replace(/\/+$/, "") || "/";
+  if (!path38.startsWith("/") || path38.includes("?") || path38.includes("#")) {
     throw new TypeError("images.path must be an absolute pathname without a query or hash");
   }
-  return path37;
+  return path38;
 }
 function normalizeIntegerList(values, name2, max) {
   if (values.length === 0) {
@@ -8283,7 +8287,7 @@ function getProgrammaticRouteSearchClientOptions2(search) {
   if (search.temporary?.length) options.temporary = [...search.temporary];
   return Object.keys(options).length > 0 ? options : void 0;
 }
-function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path37, routePath) {
+function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path38, routePath) {
   const schema = getProgrammaticRouteSearchSchema(searchConfig);
   const search = parseProgrammaticSchema(schema, rawSearch, "search", routePath);
   const options = getProgrammaticRouteSearchOptions(searchConfig);
@@ -8292,7 +8296,7 @@ function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path37, routePa
     schema,
     rawSearch,
     parsedSearch: search,
-    path: path37
+    path: path38
   });
   return { search, canonicalPath };
 }
@@ -8371,8 +8375,8 @@ function normalizeComparableValue(value) {
   }
   return value;
 }
-function createRoute(path37, options) {
-  return routesBuilder.page(path37, options);
+function createRoute(path38, options) {
+  return routesBuilder.page(path38, options);
 }
 function isProgrammaticRoutesFileName2(fileName) {
   const normalized = fileName.replace(/\\/g, "/");
@@ -8462,7 +8466,7 @@ function createRouteModuleFromProgrammaticPage(route2, rendererRuntime) {
     mod.__farmRouteData = route2.data;
     mod.__farmRouteParsesProps = true;
     mod.__farmResolveRouteProps = (props) => resolveProgrammaticRouteProps(route2, props);
-    mod.__farmResolveRouteCanonicalPath = (rawSearch, path37) => resolveProgrammaticRouteSearch(route2.search, rawSearch, path37, route2.path).canonicalPath;
+    mod.__farmResolveRouteCanonicalPath = (rawSearch, path38) => resolveProgrammaticRouteSearch(route2.search, rawSearch, path38, route2.path).canonicalPath;
   }
   if (route2.pending || route2.error || route2.notFound) {
     mod.__farmRouteComponents = {
@@ -8898,25 +8902,25 @@ var init_routes = __esm({
     ];
     __name(defineRoutes, "defineRoutes");
     routesBuilder = {
-      page(path37, options) {
+      page(path38, options) {
         return normalizeProgrammaticRoute({
           kind: "page",
-          path: path37,
+          path: path38,
           ...options
         });
       },
-      layout(path37, options) {
+      layout(path38, options) {
         return normalizeProgrammaticRoute({
           kind: "layout",
-          path: path37,
+          path: path38,
           ...options
         });
       },
-      api(path37, options) {
+      api(path38, options) {
         const { render, runtime, regions, maxDuration, ...methods } = options;
         return normalizeProgrammaticRoute({
           kind: "api",
-          path: path37,
+          path: path38,
           render,
           runtime,
           regions,
@@ -12054,8 +12058,8 @@ function createFarmDeploymentMismatchError(response, clientDeploymentId) {
     getFarmResponseDeploymentId(response) || "unknown"
   );
 }
-function createFarmDeploymentCookie(deploymentId, path37 = "/", secure = false) {
-  const normalizedPath = path37.startsWith("/") ? path37 : `/${path37}`;
+function createFarmDeploymentCookie(deploymentId, path38 = "/", secure = false) {
+  const normalizedPath = path38.startsWith("/") ? path38 : `/${path38}`;
   return [
     `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,
     `Path=${normalizedPath}`,
@@ -14912,7 +14916,7 @@ var init_server3 = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.33";
+    version = "0.1.0-beta.34";
   }
 });
 
@@ -17302,14 +17306,14 @@ function normalizeFarmAPIConfig(config) {
   };
 }
 function normalizeFarmAPIBasePath(value) {
-  const path37 = value.trim();
-  if (!path37) {
+  const path38 = value.trim();
+  if (!path38) {
     throw new Error("Farm api.basePath cannot be empty.");
   }
-  if (path37.includes("?") || path37.includes("#")) {
+  if (path38.includes("?") || path38.includes("#")) {
     throw new Error("Farm api.basePath cannot contain a query string or hash.");
   }
-  const normalized = `/${path37.replace(/^\/+|\/+$/g, "")}`;
+  const normalized = `/${path38.replace(/^\/+|\/+$/g, "")}`;
   return normalized === "/" ? "/" : normalized;
 }
 function getFarmAPIBaseURL() {
@@ -18228,15 +18232,15 @@ function isEndpointFailure(value) {
   return value instanceof EndpointFailure;
 }
 function createEndpoint(pathOrOptions, optionsOrHandler, maybeHandler) {
-  let path37;
+  let path38;
   let options;
   let handler;
   if (typeof pathOrOptions === "string") {
-    path37 = pathOrOptions;
+    path38 = pathOrOptions;
     options = optionsOrHandler;
     handler = maybeHandler;
   } else {
-    path37 = "";
+    path38 = "";
     options = pathOrOptions;
     handler = optionsOrHandler;
   }
@@ -18263,13 +18267,13 @@ function createEndpoint(pathOrOptions, optionsOrHandler, maybeHandler) {
     ...betterCallOptions
   } = options;
   const endpoint2 = (0, import_better_call.createEndpoint)(
-    path37 || "/__farm_auto_path__",
+    path38 || "/__farm_auto_path__",
     betterCallOptions,
     wrappedHandler
   );
-  endpoint2.__path = path37 || void 0;
+  endpoint2.__path = path38 || void 0;
   endpoint2.__method = options.method || "GET";
-  endpoint2.__autoPath = !path37;
+  endpoint2.__autoPath = !path38;
   endpoint2.__handler = wrappedHandler;
   endpoint2.__farmInvoke = (ctx) => runEndpointMiddleware(middleware2, ctx, handler, error, options.invalidates);
   endpoint2.__middleware = middleware2;
@@ -20013,11 +20017,11 @@ var init_type_generator = __esm({
           routeGroups.get(key).push(route2);
         }
         const nestedStructure = {};
-        for (const [path37, routeList] of routeGroups) {
+        for (const [path38, routeList] of routeGroups) {
           const route2 = routeList[0];
           const importPath = this.getRouteImportPath(route2, options.outFile);
           const routeName = this.pathToRouteName(route2.path);
-          const cleanPath = path37 === "/api" ? "" : path37.replace(/^\/api\//, "");
+          const cleanPath = path38 === "/api" ? "" : path38.replace(/^\/api\//, "");
           const parts = cleanPath ? cleanPath.split("/") : [];
           const allMethods = routeList.flatMap((r) => r.methods);
           for (const method of allMethods) {
@@ -20076,8 +20080,8 @@ ${typeExports}
         const relativeImport = (0, import_path7.relative)((0, import_path7.dirname)(outFile), route2.filePath).replace(/\\/g, "/").replace(/\.(ts|tsx|js|jsx)$/, "");
         return relativeImport.startsWith(".") ? relativeImport : `./${relativeImport}`;
       }
-      pathToRouteName(path37) {
-        return (path37 === "/api" ? "root" : path37.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
+      pathToRouteName(path38) {
+        return (path38 === "/api" ? "root" : path38.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
       }
       structureToTypeString(obj, indent) {
         const spaces = "  ".repeat(indent);
@@ -20097,15 +20101,15 @@ ${typeExports}
       toTypePropertyKey(key) {
         return /^[$A-Z_][0-9A-Z_$]*$/i.test(key) ? key : JSON.stringify(key);
       }
-      getBaseExportName(path37) {
-        const cleanPath = path37.replace(/^\/api\//, "");
+      getBaseExportName(path38) {
+        const cleanPath = path38.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return "api";
         }
         return cleanPath;
       }
-      getExportName(path37, method) {
-        const cleanPath = path37.replace(/^\/api\//, "");
+      getExportName(path38, method) {
+        const cleanPath = path38.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return method.toLowerCase();
         }
@@ -24378,7 +24382,8 @@ function resolveDeployOutputPath(root, outputDir) {
 function resolveDeployConfig(config, overrides = {}) {
   const deploy = config.deploy || {};
   const distDir = config.distDir || ".farm";
-  const target = normalizeDeployTarget(overrides.target || deploy.target);
+  const overrideTarget = normalizeDeployTarget(overrides.target);
+  const target = overrideTarget ? overrideTarget : overrides.preset ? getDeployTargetForPreset(overrides.preset) : normalizeDeployTarget(deploy.target);
   const preset = overrides.preset || deploy.preset || config.preset || getPresetForDeployTarget(target) || "node-server";
   const resolvedTarget = target || getDeployTargetForPreset(preset);
   const platformOutput = resolvedTarget === "vercel" ? deploy.vercel?.outputDirectory : resolvedTarget === "cloudflare" ? deploy.cloudflare?.outputDir : resolvedTarget === "netlify" ? deploy.netlify?.outputDir : void 0;
@@ -24410,6 +24415,14 @@ function normalizeDocsContentDir(value) {
   const normalized = value.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\/+$/, "");
   return normalized || void 0;
 }
+async function inferDocsContentDir(root, srcDir, entry) {
+  const { existsSync: existsSync20 } = await import("fs");
+  const contentDir = import_path9.default.resolve(root, srcDir, "app", entry);
+  if (!existsSync20(contentDir)) return void 0;
+  const relativeContentDir = import_path9.default.relative(root, contentDir);
+  if (relativeContentDir.startsWith("..") || import_path9.default.isAbsolute(relativeContentDir)) return void 0;
+  return normalizeDocsContentDir(relativeContentDir);
+}
 function isRecord3(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -24561,7 +24574,10 @@ async function resolveDocsConfig(userDocs, options = {}) {
     configuredDocsPath || explicitRoute || (configuredEntry ? `/${configuredEntry}` : void 0)
   );
   const docsEntry = explicitRoute && explicitRoute.startsWith("/") ? docsRouteToEntry(explicitRoute) : docsRouteToEntry(configuredEntry || entryRoute);
-  const contentDir = normalizeDocsContentDir(docsOptions.contentDir || mergedDocsConfig.contentDir);
+  const configuredContentDir = normalizeDocsContentDir(
+    docsOptions.contentDir || mergedDocsConfig.contentDir
+  );
+  const contentDir = configuredContentDir || await inferDocsContentDir(root, options.srcDir || "src", docsEntry);
   return {
     enabled: true,
     entry: entryRoute,
@@ -24784,6 +24800,7 @@ var init_config4 = __esm({
     __name(normalizeDocsRoute, "normalizeDocsRoute");
     __name(docsRouteToEntry, "docsRouteToEntry");
     __name(normalizeDocsContentDir, "normalizeDocsContentDir");
+    __name(inferDocsContentDir, "inferDocsContentDir");
     __name(isRecord3, "isRecord");
     __name(cloneSerializable, "cloneSerializable");
     __name(sanitizeDocsConfig, "sanitizeDocsConfig");
@@ -25561,8 +25578,8 @@ var init_generator = __esm({
           }
           routeGroups.get(key).push(route2);
         }
-        for (const [path37, routeList] of routeGroups) {
-          const openAPIPath = this.convertToOpenAPIPath(path37);
+        for (const [path38, routeList] of routeGroups) {
+          const openAPIPath = this.convertToOpenAPIPath(path38);
           spec.paths[openAPIPath] = {};
           for (const route2 of routeList) {
             for (const method of route2.methods) {
@@ -25582,8 +25599,8 @@ var init_generator = __esm({
       /**
        * Convert Farm.js API path to OpenAPI path format
        */
-      convertToOpenAPIPath(path37) {
-        return path37.replace(/^\/api/, "");
+      convertToOpenAPIPath(path38) {
+        return path38.replace(/^\/api/, "");
       }
       /**
        * Extract request body schema from endpoint
@@ -25745,8 +25762,8 @@ var init_generator = __esm({
       /**
        * Generate operation summary
        */
-      generateSummary(path37, method) {
-        const cleanPath = path37.replace(/^\/api\//, "");
+      generateSummary(path38, method) {
+        const cleanPath = path38.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         const lastPart = pathParts[pathParts.length - 1];
         const action = method === "GET" ? "Get" : method === "QUERY" ? "Query" : method === "POST" ? "Create" : method === "PUT" ? "Update" : method === "DELETE" ? "Delete" : method === "PATCH" ? "Update" : method;
@@ -25755,22 +25772,22 @@ var init_generator = __esm({
       /**
        * Generate operation description
        */
-      generateDescription(path37, method) {
-        const cleanPath = path37.replace(/^\/api\//, "");
+      generateDescription(path38, method) {
+        const cleanPath = path38.replace(/^\/api\//, "");
         return `${method} ${cleanPath} endpoint`;
       }
       /**
        * Generate operation ID
        */
-      generateOperationId(path37, method) {
-        const cleanPath = path37.replace(/^\/api\//, "").replace(/\//g, "_");
+      generateOperationId(path38, method) {
+        const cleanPath = path38.replace(/^\/api\//, "").replace(/\//g, "_");
         return `${method.toLowerCase()}_${cleanPath}`;
       }
       /**
        * Generate tags for grouping operations
        */
-      generateTags(path37) {
-        const cleanPath = path37.replace(/^\/api\//, "");
+      generateTags(path38) {
+        const cleanPath = path38.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         if (pathParts.length > 1) {
           return [pathParts[0]];
@@ -25783,8 +25800,8 @@ var init_generator = __esm({
       async generateSpecFile(routes, outputPath) {
         const spec = await this.generateSpec(routes);
         const fs13 = require("fs");
-        const path37 = require("path");
-        const dir = path37.dirname(outputPath);
+        const path38 = require("path");
+        const dir = path38.dirname(outputPath);
         if (!fs13.existsSync(dir)) {
           fs13.mkdirSync(dir, { recursive: true });
         }
@@ -32826,13 +32843,13 @@ async function createNitroConfig(config, routeManager, apiRouteManager, serverRe
   const root = config.root || process.cwd();
   const srcDir = config.srcDir || "src";
   const distDir = ".farm";
-  const nitroBuildDir = import_path13.default.join(root, distDir, ".nitro");
-  const outputDir = import_path13.default.join(root, distDir, ".output");
-  const serverDir = import_path13.default.join(nitroBuildDir, "server");
+  const nitroBuildDir = import_path14.default.join(root, distDir, ".nitro");
+  const outputDir = import_path14.default.join(root, distDir, ".output");
+  const serverDir = import_path14.default.join(nitroBuildDir, "server");
   const { mkdir: mkdir2, writeFile } = await import("fs/promises");
   await mkdir2(serverDir, { recursive: true });
-  await mkdir2(import_path13.default.join(serverDir, "api"), { recursive: true });
-  await mkdir2(import_path13.default.join(serverDir, "routes"), { recursive: true });
+  await mkdir2(import_path14.default.join(serverDir, "api"), { recursive: true });
+  await mkdir2(import_path14.default.join(serverDir, "routes"), { recursive: true });
   const farmWorkflows = await prepareFarmWorkflowsForNitro({
     ...config,
     distDir
@@ -32843,13 +32860,13 @@ async function createNitroConfig(config, routeManager, apiRouteManager, serverRe
   });
   const scheduledTasks = mergeScheduledTasks(farmWorkflows.scheduledTasks, farmCron.scheduledTasks);
   const cloudflareCronConfig = createFarmCronCloudflareConfig(farmCron.jobs);
-  const registryFile = import_path13.default.join(serverDir, "farm-registry.ts");
+  const registryFile = import_path14.default.join(serverDir, "farm-registry.ts");
   const routePaths = {};
   for (const [pattern, entry] of routeManager.getRoutes()) {
     const bundledPath = entry.modulePath.replace(/.*\/src\/app\//, "").replace(/\.(tsx?|jsx?)$/, ".js");
     routePaths[pattern] = bundledPath;
   }
-  const clientManifestPath = import_path13.default.join(root, distDir, "client", "farm-client-manifest.json");
+  const clientManifestPath = import_path14.default.join(root, distDir, "client", "farm-client-manifest.json");
   await writeFile(
     registryFile,
     `
@@ -32873,8 +32890,8 @@ export const farmRegistry: {
 `,
     "utf-8"
   );
-  const apiHandlerFile = import_path13.default.join(serverDir, "api", "[...].ts");
-  await mkdir2(import_path13.default.dirname(apiHandlerFile), { recursive: true });
+  const apiHandlerFile = import_path14.default.join(serverDir, "api", "[...].ts");
+  await mkdir2(import_path14.default.dirname(apiHandlerFile), { recursive: true });
   await writeFile(
     apiHandlerFile,
     `
@@ -33018,8 +33035,8 @@ export default defineEventHandler(async (event: H3Event) => {
 `,
     "utf-8"
   );
-  const ssrHandlerFile = import_path13.default.join(serverDir, "routes", "[...].ts");
-  await mkdir2(import_path13.default.dirname(ssrHandlerFile), { recursive: true });
+  const ssrHandlerFile = import_path14.default.join(serverDir, "routes", "[...].ts");
+  await mkdir2(import_path14.default.dirname(ssrHandlerFile), { recursive: true });
   await writeFile(
     ssrHandlerFile,
     `
@@ -33386,16 +33403,16 @@ export default defineEventHandler(async (event: H3Event) => {
       // from creating its own .output directory inside .nitro
       dir: outputDir,
       // .farm/.output
-      serverDir: import_path13.default.join(outputDir, "server"),
+      serverDir: import_path14.default.join(outputDir, "server"),
       // .farm/.output/server
-      publicDir: import_path13.default.join(outputDir, "public")
+      publicDir: import_path14.default.join(outputDir, "public")
       // .farm/.output/public
     },
     // Use Nitro hooks to populate the runtime registry
     // This allows us to pass complex objects (route managers, renderers) at runtime
     hooks: {
       "build:before": /* @__PURE__ */ __name(async (nitro) => {
-        const registryPath = import_path13.default.join(serverDir, "farm-registry.ts");
+        const registryPath = import_path14.default.join(serverDir, "farm-registry.ts");
         const { farmRegistry } = await import(
           /* @vite-ignore */
           registryPath
@@ -33407,7 +33424,7 @@ export default defineEventHandler(async (event: H3Event) => {
         }
         farmRegistry.routePaths = routePaths2;
         try {
-          const clientManifestPath2 = import_path13.default.join(
+          const clientManifestPath2 = import_path14.default.join(
             root,
             distDir,
             "client",
@@ -33447,12 +33464,12 @@ export default defineEventHandler(async (event: H3Event) => {
     publicAssets: [
       {
         baseURL: "/",
-        dir: import_path13.default.join(root, "public")
+        dir: import_path14.default.join(root, "public")
       },
       // Include client build assets
       {
         baseURL: "/",
-        dir: import_path13.default.join(root, distDir, "client")
+        dir: import_path14.default.join(root, distDir, "client")
       }
     ],
     // Build configuration
@@ -33486,11 +33503,11 @@ export default defineEventHandler(async (event: H3Event) => {
 function getNitroPreset(preset) {
   return preset || "node-server";
 }
-var import_path13;
+var import_path14;
 var init_nitro = __esm({
   "src/nitro/index.ts"() {
     "use strict";
-    import_path13 = __toESM(require("path"));
+    import_path14 = __toESM(require("path"));
     init_workflows();
     init_cron();
     init_route_rules();
@@ -35212,8 +35229,8 @@ function createAPIClient(options = {}) {
   const inflightState = /* @__PURE__ */ new Map();
   const routeMeta = /* @__PURE__ */ new WeakMap();
   let requestCounter = 0;
-  const fetchClient = /* @__PURE__ */ __name(async (path37, requestOptions = {}) => {
-    const url = resolveFarmAPIRequestURL(path37, baseURL);
+  const fetchClient = /* @__PURE__ */ __name(async (path38, requestOptions = {}) => {
+    const url = resolveFarmAPIRequestURL(path38, baseURL);
     if (requestOptions.query) {
       Object.entries(requestOptions.query).forEach(([key, value]) => {
         if (value !== void 0 && value !== null) {
@@ -35248,7 +35265,7 @@ function createAPIClient(options = {}) {
     }
     return { response, data };
   }, "fetchClient");
-  const request = /* @__PURE__ */ __name(async (path37, method, input = {}, clientOptions) => {
+  const request = /* @__PURE__ */ __name(async (path38, method, input = {}, clientOptions) => {
     const methodUpper = method.toUpperCase();
     const requestId = `${Date.now()}-${++requestCounter}`;
     const cacheOptions = clientOptions?.cache ? {
@@ -35257,7 +35274,7 @@ function createAPIClient(options = {}) {
     } : void 0;
     const configuredCacheKey = clientOptions?.key ?? cacheOptions?.key;
     const cacheKey = normalizeFarmClientCacheKey(
-      configuredCacheKey ?? buildCacheKey(methodUpper, path37, input, baseURL, options.headers)
+      configuredCacheKey ?? buildCacheKey(methodUpper, path38, input, baseURL, options.headers)
     );
     const now2 = Date.now();
     const emitStatus = /* @__PURE__ */ __name((phase, payload) => {
@@ -35346,13 +35363,13 @@ function createAPIClient(options = {}) {
             requestId,
             method: methodUpper,
             key: cacheKey,
-            path: path37,
+            path: path38,
             input,
             attempt,
             timestamp: Date.now()
           });
           try {
-            const { response, data } = await fetchClient(path37, {
+            const { response, data } = await fetchClient(path38, {
               ...input,
               method: methodUpper
             });
@@ -35361,7 +35378,7 @@ function createAPIClient(options = {}) {
               requestId,
               method: methodUpper,
               key: cacheKey,
-              path: path37,
+              path: path38,
               input,
               attempt,
               timestamp: Date.now(),
@@ -35384,7 +35401,7 @@ function createAPIClient(options = {}) {
               requestId,
               method: methodUpper,
               key: cacheKey,
-              path: path37,
+              path: path38,
               input,
               attempt,
               timestamp: Date.now(),
@@ -35489,17 +35506,17 @@ function createAPIClient(options = {}) {
   );
 }
 __name(createAPIClient, "createAPIClient");
-function createNestedProxy(path37, client, routeMeta, baseURL, sameOrigin, rootAliases) {
+function createNestedProxy(path38, client, routeMeta, baseURL, sameOrigin, rootAliases) {
   const target = /* @__PURE__ */ __name(() => {
   }, "target");
   const proxy = new Proxy(target, {
     // When accessing a property (api.hello)
     get(_target, prop) {
       if (prop === FARM_API_ROUTE_REF_SYMBOL) {
-        return path37.length > 0;
+        return path38.length > 0;
       }
       if (prop === FARM_API_ROUTE_META_SYMBOL) {
-        const metadata = resolveRouteMeta({ path: path37, baseURL });
+        const metadata = resolveRouteMeta({ path: path38, baseURL });
         const requestURL = resolveFarmAPIRequestURL(metadata.routePath, baseURL);
         return Object.freeze({
           path: `${requestURL.pathname}${requestURL.search}${requestURL.hash}`,
@@ -35508,14 +35525,14 @@ function createNestedProxy(path37, client, routeMeta, baseURL, sameOrigin, rootA
           sameOrigin
         });
       }
-      if (path37.length === 0 && typeof prop === "string" && rootAliases && prop in rootAliases) {
+      if (path38.length === 0 && typeof prop === "string" && rootAliases && prop in rootAliases) {
         return rootAliases[prop];
       }
       if (typeof prop !== "string") {
         return Reflect.get(_target, prop);
       }
       return createNestedProxy(
-        [...path37, prop],
+        [...path38, prop],
         client,
         routeMeta,
         baseURL,
@@ -35525,21 +35542,21 @@ function createNestedProxy(path37, client, routeMeta, baseURL, sameOrigin, rootA
     },
     // When calling as a function
     apply(_target, _thisArg, args) {
-      const lastPart = path37[path37.length - 1];
+      const lastPart = path38[path38.length - 1];
       const httpMethods = ["get", "head", "query", "post", "put", "delete", "patch", "options"];
       if (httpMethods.includes(lastPart)) {
-        const routePath = "/api/" + path37.slice(0, -1).join("/");
+        const routePath = "/api/" + path38.slice(0, -1).join("/");
         const method = lastPart.toUpperCase();
         const [options, clientOptions] = args;
         return client(routePath, method, options, clientOptions);
       } else {
-        const routePath = "/api/" + path37.join("/");
+        const routePath = "/api/" + path38.join("/");
         const [options, clientOptions] = args;
         return client(routePath, options?.method || "GET", options, clientOptions);
       }
     }
   });
-  routeMeta.set(proxy, { path: [...path37], baseURL });
+  routeMeta.set(proxy, { path: [...path38], baseURL });
   return proxy;
 }
 __name(createNestedProxy, "createNestedProxy");
@@ -35579,7 +35596,7 @@ function createServerAPIClient(endpoints, options = {}) {
   return endpoints;
 }
 __name(createServerAPIClient, "createServerAPIClient");
-function buildCacheKey(method, path37, input, baseURL, defaultHeaders) {
+function buildCacheKey(method, path38, input, baseURL, defaultHeaders) {
   const keyInput = input && typeof input === "object" ? {
     query: input.query,
     body: input.body,
@@ -35588,7 +35605,7 @@ function buildCacheKey(method, path37, input, baseURL, defaultHeaders) {
       contentEncoding: getHeader(input.headers, "content-encoding") ?? getHeader(defaultHeaders, "content-encoding")
     } : {}
   } : input;
-  const url = resolveFarmAPIRequestURL(path37, baseURL);
+  const url = resolveFarmAPIRequestURL(path38, baseURL);
   return `${method}:${url.origin}${url.pathname}:${stableStringify(keyInput ?? {})}`;
 }
 __name(buildCacheKey, "buildCacheKey");
@@ -35836,7 +35853,7 @@ function farmApiPlugin(options = {}) {
     configureServer(server) {
       const discoverFileRoutes = /* @__PURE__ */ __name(async (apiDir) => {
         const fs13 = await import("fs");
-        const path37 = await import("path");
+        const path38 = await import("path");
         if (!fs13.existsSync(apiDir)) {
           log("No api directory found");
           return;
@@ -35846,7 +35863,7 @@ function farmApiPlugin(options = {}) {
           if (!fs13.existsSync(dir)) return files;
           const entries = fs13.readdirSync(dir, { withFileTypes: true });
           for (const entry of entries) {
-            const fullPath = path37.join(dir, entry.name);
+            const fullPath = path38.join(dir, entry.name);
             if (entry.isDirectory()) {
               files.push(...findRouteFiles(fullPath));
             } else if (entry.name === "route.ts" || entry.name === "route.tsx" || entry.name === "route.js") {
@@ -35859,7 +35876,7 @@ function farmApiPlugin(options = {}) {
         apiRoutesCache.clear();
         for (const filePath of routeFiles) {
           try {
-            const relativePath2 = path37.relative(apiDir, path37.dirname(filePath));
+            const relativePath2 = path38.relative(apiDir, path38.dirname(filePath));
             const routePath = "/api/" + (relativePath2 === "." ? "" : relativePath2.replace(/\\/g, "/"));
             const routeModule = await server.ssrLoadModule(filePath);
             const endpoints = {};
@@ -35886,11 +35903,11 @@ function farmApiPlugin(options = {}) {
       }, "discoverFileRoutes");
       const discoverRootRoutes = /* @__PURE__ */ __name(async () => {
         const fs13 = await import("fs");
-        const path37 = await import("path");
+        const path38 = await import("path");
         const routesFiles = [
-          path37.join(server.config.root, srcDir, "routes.ts"),
-          path37.join(server.config.root, srcDir, "routes.tsx"),
-          path37.join(server.config.root, srcDir, "routes.js")
+          path38.join(server.config.root, srcDir, "routes.ts"),
+          path38.join(server.config.root, srcDir, "routes.tsx"),
+          path38.join(server.config.root, srcDir, "routes.js")
         ];
         for (const routesFile of routesFiles) {
           if (fs13.existsSync(routesFile)) {
@@ -35913,8 +35930,8 @@ function farmApiPlugin(options = {}) {
         }
       }, "discoverRootRoutes");
       const discoverProgrammaticRoutes = /* @__PURE__ */ __name(async () => {
-        const path37 = await import("path");
-        const srcRoot = path37.join(server.config.root, srcDir);
+        const path38 = await import("path");
+        const srcRoot = path38.join(server.config.root, srcDir);
         const routeFiles = findProgrammaticRouteFilesInDir(srcRoot);
         if (routeFiles.length === 0) return;
         const { getProgrammaticRouteManifest: getProgrammaticRouteManifest2 } = await Promise.resolve().then(() => (init_routes(), routes_exports));
@@ -35940,8 +35957,8 @@ function farmApiPlugin(options = {}) {
         }
       }, "discoverProgrammaticRoutes");
       const initializeDiscovery = /* @__PURE__ */ __name(async () => {
-        const path37 = await import("path");
-        const apiDir = path37.join(server.config.root, srcDir, "api");
+        const path38 = await import("path");
+        const apiDir = path38.join(server.config.root, srcDir, "api");
         log(`Discovering API routes in: ${apiDir}`);
         await discoverFileRoutes(apiDir);
         await discoverRootRoutes();
@@ -36110,9 +36127,9 @@ function farmApiPlugin(options = {}) {
           }
         } else {
           try {
-            const path37 = await import("path");
-            const apiDir = path37.join(server.config.root, srcDir, "api");
-            const relativePath2 = path37.relative(apiDir, path37.dirname(file));
+            const path38 = await import("path");
+            const apiDir = path38.join(server.config.root, srcDir, "api");
+            const relativePath2 = path38.relative(apiDir, path38.dirname(file));
             const routePath = "/api/" + (relativePath2 === "." ? "" : relativePath2.replace(/\\/g, "/"));
             const routeModule = await server.ssrLoadModule(file);
             const endpoints = {};
@@ -36553,8 +36570,8 @@ var _MiddlewareChainImpl = class _MiddlewareChainImpl {
   /**
    * Set the base path for this middleware chain (called by manager when loading)
    */
-  setBasePath(path37) {
-    this.basePath = path37 === "/" ? "/" : path37.endsWith("/") ? path37.slice(0, -1) : path37;
+  setBasePath(path38) {
+    this.basePath = path38 === "/" ? "/" : path38.endsWith("/") ? path38.slice(0, -1) : path38;
   }
   use(fn) {
     this.handlers.push(fn);
@@ -37569,12 +37586,12 @@ function isFarmRouteActive(pattern, pathname, options = {}) {
 __name(isFarmRouteActive, "isFarmRouteActive");
 function normalizeRouteInput(input, index) {
   const route2 = typeof input === "string" ? { path: input } : input;
-  const path37 = normalizePathname3(route2.path);
-  const segments = parseRoutePattern(path37);
+  const path38 = normalizePathname3(route2.path);
+  const segments = parseRoutePattern(path38);
   return {
     route: {
       ...route2,
-      path: path37
+      path: path38
     },
     segments,
     score: scoreSegments(segments),
@@ -38626,7 +38643,7 @@ init_generate_route_types();
 
 // src/build/index.ts
 init_config4();
-var import_path14 = __toESM(require("path"));
+var import_path15 = __toESM(require("path"));
 var import_node_fs13 = require("fs");
 init_utils();
 init_app();
@@ -38635,9 +38652,61 @@ init_layers();
 
 // src/nitro/universal-build.ts
 init_config4();
+
+// src/nitro/client-css-href.ts
+var import_path10 = __toESM(require("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 fs13 = await import("fs/promises");
+  try {
+    const bytes = await fs13.readFile(sourcePath);
+    if (bytes.length === 0) return null;
+    const { createHash: createHash5 } = await import("crypto");
+    const hash = createHash5("sha256").update(bytes).digest("hex").slice(0, 8);
+    const name2 = hashedName(hash);
+    await fs13.mkdir(destinationDir, { recursive: true });
+    await fs13.writeFile(import_path10.default.join(destinationDir, name2), bytes);
+    return name2;
+  } catch {
+    return null;
+  }
+}
+__name(hashAndCopy, "hashAndCopy");
+async function resolveHashedClientCssHref(clientOutputDir) {
+  const name2 = await hashAndCopy(
+    import_path10.default.join(clientOutputDir, "farm-client.css"),
+    import_path10.default.join(clientOutputDir, "assets"),
+    (hash) => `farm-client-h${hash}.css`
+  );
+  return name2 ? `/assets/${name2}` : "/farm-client.css";
+}
+__name(resolveHashedClientCssHref, "resolveHashedClientCssHref");
+async function findFingerprintedClientEntry(clientOutputDir) {
+  const fs13 = await import("fs/promises");
+  try {
+    const entries = await fs13.readdir(clientOutputDir);
+    return entries.find((name2) => /^farm-client-h[0-9a-f]+\.js$/.test(name2)) ?? null;
+  } catch {
+    return null;
+  }
+}
+__name(findFingerprintedClientEntry, "findFingerprintedClientEntry");
+async function resolveHashedClientJsSrc(clientOutputDir) {
+  const entryName = await findFingerprintedClientEntry(clientOutputDir);
+  if (!entryName) return "/farm-client.js";
+  const fs13 = await import("fs/promises");
+  const shim = `export * from "./${entryName}";
+`;
+  await fs13.writeFile(import_path10.default.join(clientOutputDir, "farm-client.js"), shim);
+  return `/${entryName}`;
+}
+__name(resolveHashedClientJsSrc, "resolveHashedClientJsSrc");
+
+// src/nitro/universal-build.ts
 init_client_plugin_build();
 var import_os = __toESM(require("os"));
-var import_path12 = __toESM(require("path"));
+var import_path13 = __toESM(require("path"));
 var import_fs5 = require("fs");
 var import_url3 = require("url");
 var import_module3 = require("module");
@@ -38655,13 +38724,13 @@ init_search_client();
 init_fonts();
 
 // src/route-runtime-manifest.ts
-var import_path10 = __toESM(require("path"));
+var import_path11 = __toESM(require("path"));
 init_deployment();
 init_route_runtime();
 init_ssg();
 var FARM_ROUTE_RUNTIME_MANIFEST = "route-runtime-manifest.json";
 async function createFarmRouteRuntimeManifest(options) {
-  const root = import_path10.default.resolve(options.root || options.config.root || process.cwd());
+  const root = import_path11.default.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);
@@ -38709,7 +38778,7 @@ async function createFarmRouteRuntimeManifest(options) {
 __name(createFarmRouteRuntimeManifest, "createFarmRouteRuntimeManifest");
 async function writeFarmRouteRuntimeManifest(directory, manifest) {
   const fs13 = await import("fs/promises");
-  const manifestPath = import_path10.default.join(directory, FARM_ROUTE_RUNTIME_MANIFEST);
+  const manifestPath = import_path11.default.join(directory, FARM_ROUTE_RUNTIME_MANIFEST);
   await fs13.mkdir(directory, { recursive: true });
   await fs13.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `);
@@ -38749,13 +38818,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 relativePath2 = import_path10.default.isAbsolute(filePath) ? import_path10.default.relative(root, filePath) : filePath;
+  const relativePath2 = import_path11.default.isAbsolute(filePath) ? import_path11.default.relative(root, filePath) : filePath;
   return `${relativePath2.replace(/\\/g, "/")}${query}`;
 }
 __name(normalizeManifestSource, "normalizeManifestSource");
 
 // src/nitro/vercel-route-runtime.ts
-var import_path11 = __toESM(require("path"));
+var import_path12 = __toESM(require("path"));
 init_route_runtime();
 async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs13) {
   const dynamicRoutes = manifest.routes.filter(
@@ -38776,8 +38845,8 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs13)
     group.routes.push(route2);
     groups.set(key, group);
   }
-  const functionsDir = import_path11.default.join(outputDir, "functions");
-  const baseFunctionDir = import_path11.default.join(functionsDir, "__nitro.func");
+  const functionsDir = import_path12.default.join(outputDir, "functions");
+  const baseFunctionDir = import_path12.default.join(functionsDir, "__nitro.func");
   const destinations = /* @__PURE__ */ new Map();
   let groupIndex = 0;
   for (const [key, group] of groups) {
@@ -38787,7 +38856,7 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs13)
     }
     groupIndex += 1;
     const functionName = `__farm_runtime_${groupIndex}`;
-    const functionDir = import_path11.default.join(functionsDir, `${functionName}.func`);
+    const functionDir = import_path12.default.join(functionsDir, `${functionName}.func`);
     await fs13.cp(baseFunctionDir, functionDir, { recursive: true, force: true });
     await configureVercelFunction(functionDir, group.config, fs13);
     destinations.set(key, `/${functionName}`);
@@ -38837,7 +38906,7 @@ function farmRoutePatternToVercelSource(pattern) {
 }
 __name(farmRoutePatternToVercelSource, "farmRoutePatternToVercelSource");
 async function configureVercelFunction(functionDir, config, fs13) {
-  const configPath = import_path11.default.join(functionDir, ".vc-config.json");
+  const configPath = import_path12.default.join(functionDir, ".vc-config.json");
   const current = JSON.parse(await fs13.readFile(configPath, "utf8"));
   const next = {
     ...current,
@@ -38886,8 +38955,9 @@ function createFarmVercelImmutableAssetRoute(basePath = "/") {
   const normalizedBasePath = normalizeBasePath3(basePath);
   const escapedBasePath = escapeRegex2(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
     },
@@ -39209,7 +39279,7 @@ function preloadFarmNitroRuntime() {
 }
 __name(preloadFarmNitroRuntime, "preloadFarmNitroRuntime");
 var _filename = typeof import_meta.url !== "undefined" ? (0, import_url3.fileURLToPath)(import_meta.url) : "";
-var _dirname = import_path12.default.dirname(_filename);
+var _dirname = import_path13.default.dirname(_filename);
 var NODE_BUILTIN_MODULES = /* @__PURE__ */ new Set([
   ...import_module3.builtinModules,
   ...import_module3.builtinModules.map((moduleName) => `node:${moduleName}`)
@@ -39238,14 +39308,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 = (0, import_module3.createRequire)(import_path12.default.join(root, "package.json"));
+  const projectRequire = (0, import_module3.createRequire)(import_path13.default.join(root, "package.json"));
   let runtimeRequire = projectRequire;
   try {
     runtimeRequire = (0, import_module3.createRequire)(projectRequire.resolve("@farm.js/core"));
   } catch {
   }
   const nitroEntry = runtimeRequire.resolve("nitro");
-  return (0, import_module3.createRequire)(nitroEntry).resolve(specifier).split(import_path12.default.sep).join("/");
+  return (0, import_module3.createRequire)(nitroEntry).resolve(specifier).split(import_path13.default.sep).join("/");
 }
 __name(resolveNitroRuntimeDependency, "resolveNitroRuntimeDependency");
 function cloneConfigValue(value, seen = /* @__PURE__ */ new WeakMap()) {
@@ -39339,7 +39409,7 @@ function createMetadataImageWasmPlugin() {
         return null;
       }
       const requestPath = source.slice(0, -"?module".length);
-      const resolvedPath = import_path12.default.isAbsolute(requestPath) ? requestPath : import_path12.default.resolve(import_path12.default.dirname(importer.split("?", 1)[0]), requestPath);
+      const resolvedPath = import_path13.default.isAbsolute(requestPath) ? requestPath : import_path13.default.resolve(import_path13.default.dirname(importer.split("?", 1)[0]), requestPath);
       return `${FARM_METADATA_IMAGE_WASM_PREFIX}${resolvedPath}`;
     },
     load(id) {
@@ -39365,11 +39435,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("../") ? import_path12.default.posix.normalize(import_path12.default.posix.join(import_path12.default.posix.dirname(fileName), normalizedImportId)) : null;
+      const resolvedRelativeId = normalizedImportId.startsWith("./") || normalizedImportId.startsWith("../") ? import_path13.default.posix.normalize(import_path13.default.posix.join(import_path13.default.posix.dirname(fileName), normalizedImportId)) : null;
       if (emittedFiles.has(normalizedId) || resolvedRelativeId !== null && emittedFiles.has(resolvedRelativeId) || NODE_BUILTIN_MODULES.has(importId) || importId.startsWith("node:")) {
         continue;
       }
-      if (import_path12.default.isAbsolute(importId) || /^[A-Za-z]:[\\/]/.test(importId) || importId.startsWith("#") || importId.startsWith("\0")) {
+      if (import_path13.default.isAbsolute(importId) || /^[A-Za-z]:[\\/]/.test(importId) || importId.startsWith("#") || importId.startsWith("\0")) {
         externalPackages.add(importId);
         continue;
       }
@@ -39382,15 +39452,15 @@ function collectSSRExternalPackages(ssrBundle) {
 }
 __name(collectSSRExternalPackages, "collectSSRExternalPackages");
 function createExternalSSRBundlePlugin(nitroEntryPath, ssrOutputDir, ssrEntryFile) {
-  const resolvedNitroEntry = import_path12.default.resolve(nitroEntryPath);
-  const resolvedSSREntry = import_path12.default.resolve(ssrOutputDir, ssrEntryFile);
+  const resolvedNitroEntry = import_path13.default.resolve(nitroEntryPath);
+  const resolvedSSREntry = import_path13.default.resolve(ssrOutputDir, ssrEntryFile);
   return {
     name: "farm-externalize-prebuilt-ssr",
     resolveId(source, importer) {
-      if (!importer || import_path12.default.resolve(importer) !== resolvedNitroEntry) {
+      if (!importer || import_path13.default.resolve(importer) !== resolvedNitroEntry) {
         return null;
       }
-      const resolvedImport = import_path12.default.resolve(import_path12.default.dirname(importer), source);
+      const resolvedImport = import_path13.default.resolve(import_path13.default.dirname(importer), source);
       if (resolvedImport !== resolvedSSREntry) return null;
       return { id: FARM_SSR_PACKAGE_IMPORT, external: true };
     }
@@ -39479,13 +39549,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 = import_path12.default.isAbsolute(configuredContentDir) ? configuredContentDir : import_path12.default.join(root, configuredContentDir);
+    const contentDir = import_path13.default.isAbsolute(configuredContentDir) ? configuredContentDir : import_path13.default.join(root, configuredContentDir);
     return (0, import_fs5.existsSync)(contentDir) ? contentDir : null;
   }
   const entryDir = config.docs.config.entry || trimSlashes3(config.docs.entry) || "docs";
-  const appDocsDir = import_path12.default.join(root, config.srcDir || "src", "app", entryDir);
+  const appDocsDir = import_path13.default.join(root, config.srcDir || "src", "app", entryDir);
   if ((0, import_fs5.existsSync)(appDocsDir)) return appDocsDir;
-  const rootDocsDir = import_path12.default.join(root, entryDir);
+  const rootDocsDir = import_path13.default.join(root, entryDir);
   return (0, import_fs5.existsSync)(rootDocsDir) ? rootDocsDir : null;
 }
 __name(resolveBuildDocsContentDir, "resolveBuildDocsContentDir");
@@ -39503,7 +39573,7 @@ function hasProjectPostcssConfig(root) {
     ".postcssrc.mjs",
     ".postcssrc.ts"
   ];
-  const projectRequire = (0, import_module3.createRequire)(import_path12.default.join(root, "package.json"));
+  const projectRequire = (0, import_module3.createRequire)(import_path13.default.join(root, "package.json"));
   return candidates.some((file) => {
     try {
       projectRequire.resolve(`./${file}`);
@@ -39527,7 +39597,7 @@ async function findFarmConfigPath(root) {
     "config.mjs"
   ];
   for (const candidate of candidates) {
-    const resolvedPath = import_path12.default.join(root, candidate);
+    const resolvedPath = import_path13.default.join(root, candidate);
     try {
       await fs13.access(resolvedPath);
       return resolvedPath;
@@ -39572,7 +39642,7 @@ async function discoverMiddlewareRoutes(appDir) {
     if (middlewareFile) {
       discovered.push({
         path: routePath,
-        filePath: import_path12.default.join(dir, middlewareFile.name)
+        filePath: import_path13.default.join(dir, middlewareFile.name)
       });
     }
     for (const entry of entries) {
@@ -39580,7 +39650,7 @@ async function discoverMiddlewareRoutes(appDir) {
         continue;
       }
       const childRoutePath = routePath === "/" ? `/${entry.name}` : `${routePath}/${entry.name}`;
-      await walk(import_path12.default.join(dir, entry.name), childRoutePath, discovered);
+      await walk(import_path13.default.join(dir, entry.name), childRoutePath, discovered);
     }
   }
   __name(walk, "walk");
@@ -39645,7 +39715,7 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
     logger.info(`\u{1F4CB} Found ${pageRoutes.length} page routes`);
     const fs13 = await import("fs/promises");
     const layoutRoutes = [];
-    const appDir = import_path12.default.join(root, srcDir, "app");
+    const appDir = import_path13.default.join(root, srcDir, "app");
     async function findLayoutsForClient(dir, routePrefix = "/") {
       try {
         const entries = await fs13.readdir(dir, { withFileTypes: true });
@@ -39653,11 +39723,11 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
           if (entry.isFile() && entry.name.match(/^layout\.(tsx?|jsx?|vue|svelte)$/)) {
             layoutRoutes.push({
               pattern: routePrefix,
-              modulePath: import_path12.default.join(dir, entry.name)
+              modulePath: import_path13.default.join(dir, entry.name)
             });
           } else if (entry.isDirectory() && !entry.name.startsWith(".") && !entry.name.startsWith("_")) {
             const childPrefix = routePrefix === "/" ? `/${entry.name}` : `${routePrefix}/${entry.name}`;
-            await findLayoutsForClient(import_path12.default.join(dir, entry.name), childPrefix);
+            await findLayoutsForClient(import_path13.default.join(dir, entry.name), childPrefix);
           }
         }
       } catch {
@@ -39672,7 +39742,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 = import_path12.default.join(root, distDir, "client");
+    const clientOutputDir = import_path13.default.join(root, distDir, "client");
     const [productionViteResult] = await productionViteResultPromise;
     if (productionViteResult.status === "rejected") {
       await routeRuntimeManifestResultPromise;
@@ -39767,12 +39837,10 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       lifecyclePluginManager
     );
     const runtimeManifestPath = await writeFarmRouteRuntimeManifest(
-      import_path12.default.join(root, distDir),
+      import_path13.default.join(root, distDir),
       routeRuntimeManifest
     );
-    logger.info(`\u{1F4CB} Route runtime manifest: ${import_path12.default.relative(root, runtimeManifestPath)}`);
-    logger.success("\u2705 Build completed successfully!");
-    logger.info(`\u{1F4C1} Output directory: ${deployOutputDir}`);
+    logger.info(`\u{1F4CB} Route runtime manifest: ${import_path13.default.relative(root, runtimeManifestPath)}`);
   } catch (error) {
     if (lifecyclePluginManager) {
       await lifecyclePluginManager.runHookParallel("onError", {
@@ -39797,8 +39865,8 @@ async function writeSSRAssetsToClient(bundle, outputDir) {
       await mergeBuiltFontCss(outputDir, output.source);
       continue;
     }
-    const filePath = import_path12.default.join(outputDir, fileName);
-    await fs13.mkdir(import_path12.default.dirname(filePath), { recursive: true });
+    const filePath = import_path13.default.join(outputDir, fileName);
+    await fs13.mkdir(import_path13.default.dirname(filePath), { recursive: true });
     await fs13.writeFile(filePath, output.source);
   }
 }
@@ -39807,8 +39875,8 @@ async function copyFarmDocsFontAssetsToClient(root, outputDir) {
   const fs13 = await import("fs/promises");
   await Promise.all(
     resolveFarmDocsFontAssets(root).map(async ({ sourcePath, url }) => {
-      const targetPath = import_path12.default.join(outputDir, url.replace(/^\/+/, ""));
-      await fs13.mkdir(import_path12.default.dirname(targetPath), { recursive: true });
+      const targetPath = import_path13.default.join(outputDir, url.replace(/^\/+/, ""));
+      await fs13.mkdir(import_path13.default.dirname(targetPath), { recursive: true });
       await fs13.copyFile(sourcePath, targetPath);
     })
   );
@@ -39816,7 +39884,7 @@ async function copyFarmDocsFontAssetsToClient(root, outputDir) {
 __name(copyFarmDocsFontAssetsToClient, "copyFarmDocsFontAssetsToClient");
 async function mergeBuiltFontCss(outputDir, fontCssSource) {
   const fs13 = await import("fs/promises");
-  const fontCssPath = import_path12.default.join(outputDir, "farm-fonts.css");
+  const fontCssPath = import_path13.default.join(outputDir, "farm-fonts.css");
   let fontCss = fontCssSource;
   if (fontCss === void 0) {
     try {
@@ -39825,7 +39893,7 @@ async function mergeBuiltFontCss(outputDir, fontCssSource) {
       return;
     }
   }
-  const clientCssPath = import_path12.default.join(outputDir, "farm-client.css");
+  const clientCssPath = import_path13.default.join(outputDir, "farm-client.css");
   let clientCss = "";
   try {
     clientCss = await fs13.readFile(clientCssPath, "utf8");
@@ -39846,7 +39914,8 @@ __name(_IncompleteClientBuildOutputError, "IncompleteClientBuildOutputError");
 var IncompleteClientBuildOutputError = _IncompleteClientBuildOutputError;
 async function validateClientBuildOutput(root, srcDir, outputDir) {
   const fs13 = await import("fs/promises");
-  const clientEntryPath = import_path12.default.join(outputDir, "farm-client.js");
+  const fingerprinted = await findFingerprintedClientEntry(outputDir);
+  const clientEntryPath = import_path13.default.join(outputDir, fingerprinted ?? "farm-client.js");
   let clientEntrySize = 0;
   try {
     const clientEntry = await fs13.stat(clientEntryPath);
@@ -39856,8 +39925,8 @@ async function validateClientBuildOutput(root, srcDir, outputDir) {
   if (clientEntrySize === 0) {
     throw new IncompleteClientBuildOutputError("farm-client.js is missing or empty");
   }
-  const clientCssPath = import_path12.default.join(outputDir, "farm-client.css");
-  const globalsCssPath = import_path12.default.join(root, srcDir, "app", "globals.css");
+  const clientCssPath = import_path13.default.join(outputDir, "farm-client.css");
+  const globalsCssPath = import_path13.default.join(root, srcDir, "app", "globals.css");
   let expectsCss = false;
   try {
     const globalsCss = await fs13.readFile(globalsCssPath, "utf8");
@@ -39988,10 +40057,10 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   logger.info(
     `\u{1F4F1} Total hydratable routes detected: ${clientPages.length} pages, ${clientLayouts.filter((layout2) => layout2.shouldHydrate).length} layouts, and ${clientRouteSlots.length} slots`
   );
-  const clientEntryRoot = import_path12.default.join(root, ".farm", "tmp");
+  const clientEntryRoot = import_path13.default.join(root, ".farm", "tmp");
   await fs13.mkdir(clientEntryRoot, { recursive: true });
-  const clientEntryDir = await fs13.mkdtemp(import_path12.default.join(clientEntryRoot, "client-entry-"));
-  const clientEntryPath = import_path12.default.join(clientEntryDir, "farm-client-entry.tsx");
+  const clientEntryDir = await fs13.mkdtemp(import_path13.default.join(clientEntryRoot, "client-entry-"));
+  const clientEntryPath = import_path13.default.join(clientEntryDir, "farm-client-entry.tsx");
   const clientHydrationCode = generateClientHydrationEntry(
     clientPages,
     clientLayouts,
@@ -40017,7 +40086,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   if (hasScopedPostcssConfig) {
     logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
   } else {
-    const postcssConfigPath = import_path12.default.join(clientEntryDir, "postcss.config.cjs");
+    const postcssConfigPath = import_path13.default.join(clientEntryDir, "postcss.config.cjs");
     await fs13.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
     postcssSearchPath = clientEntryDir;
     try {
@@ -40050,7 +40119,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
@@ -40368,7 +40437,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 = import_path12.default.join(root, srcDir, "app", "globals.css");
+  const globalsCssPath = import_path13.default.join(root, srcDir, "app", "globals.css");
   const cssImportPath = toImportPath(globalsCssPath);
   const cssImport = `import ${JSON.stringify(cssImportPath)};`;
   const layoutImportStatements = [];
@@ -41637,9 +41706,9 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
     ssr: true
   });
   if (!hasScopedPostcssConfig) {
-    postcssConfigDir = await fs13.mkdtemp(import_path12.default.join(import_os.default.tmpdir(), "farm-postcss-"));
+    postcssConfigDir = await fs13.mkdtemp(import_path13.default.join(import_os.default.tmpdir(), "farm-postcss-"));
     await fs13.writeFile(
-      import_path12.default.join(postcssConfigDir, "postcss.config.cjs"),
+      import_path13.default.join(postcssConfigDir, "postcss.config.cjs"),
       "module.exports = { plugins: [] };\n"
     );
     try {
@@ -41717,7 +41786,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 = import_path12.default.join(sourceAppDir, `not-found${ext}`);
+      const checkPath = import_path13.default.join(sourceAppDir, `not-found${ext}`);
       try {
         await fs13.access(checkPath);
         notFoundPath = checkPath;
@@ -42149,7 +42218,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" ? import_path12.default.isAbsolute(config.mdx.components) ? config.mdx.components : import_path12.default.join(config.root, config.mdx.components) : null;
+  const mdxComponentsPath = typeof config.mdx?.components === "string" ? import_path13.default.isAbsolute(config.mdx.components) ? config.mdx.components : import_path13.default.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(
@@ -42424,8 +42493,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),
@@ -42434,7 +42503,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(
@@ -42777,12 +42846,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>';
   }
 
@@ -42793,7 +42862,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")
@@ -42803,7 +42872,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
@@ -43519,8 +43588,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
@@ -43530,10 +43599,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')) {
@@ -44263,8 +44332,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' +
@@ -44273,7 +44342,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">',
@@ -44318,7 +44387,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) => {
@@ -44339,7 +44408,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
@@ -44355,13 +44424,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>\`;
         }
@@ -44620,12 +44689,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;
@@ -44637,14 +44706,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>\`;
     }
@@ -44981,7 +45050,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 = import_path12.default.join(root, distDir, "ssr");
+  const ssrOutputDir = import_path13.default.join(root, distDir, "ssr");
   const imageRuntime = resolveImageRuntime(config, preset);
   const hasGeneratedMetadataImages = Array.from(routeManager.getMetadataImages().values()).some(
     (image) => image.sourceType === "module"
@@ -45050,13 +45119,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 fs13.mkdir(ssrOutputDir, { recursive: true });
   for (const [fileName, output] of Object.entries(ssrBundle)) {
-    const filePath = import_path12.default.join(ssrOutputDir, fileName);
-    await fs13.mkdir(import_path12.default.dirname(filePath), { recursive: true });
+    const filePath = import_path13.default.join(ssrOutputDir, fileName);
+    await fs13.mkdir(import_path13.default.dirname(filePath), { recursive: true });
     await fs13.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
   }
-  const nitroEntryPath = import_path12.default.join(ssrOutputDir, "nitro-entry.mjs");
+  const nitroEntryPath = import_path13.default.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.
@@ -45121,12 +45203,12 @@ export default async function farmNitroEventHandler(event) {
 }
   `.trim();
   await fs13.writeFile(nitroEntryPath, nitroEntryCode);
-  const farmNodeServerEntryPath = preset === "node-server" ? import_path12.default.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
+  const farmNodeServerEntryPath = preset === "node-server" ? import_path13.default.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
   if (farmNodeServerEntryPath) {
     await fs13.writeFile(
       farmNodeServerEntryPath,
       createFarmNodeServerEntry({
-        nitroEntryFile: import_path12.default.basename(nitroEntryPath),
+        nitroEntryFile: import_path13.default.basename(nitroEntryPath),
         nodeHandlerModule: resolveNitroRuntimeDependency(root, "srvx/node"),
         server: config.server,
         websocketAdapterModule: resolveNitroRuntimeDependency(root, "crossws/adapters/node")
@@ -45160,12 +45242,12 @@ export default async function farmNitroEventHandler(event) {
     ...farmNodeServerEntryPath ? { entry: farmNodeServerEntryPath } : {},
     rootDir: root,
     srcDir: root,
-    buildDir: import_path12.default.join(root, distDir, ".nitro"),
+    buildDir: import_path13.default.join(root, distDir, ".nitro"),
     compatibilityDate: "2024-12-01",
     output: {
       dir: outputDir,
-      serverDir: import_path12.default.join(outputDir, "server"),
-      publicDir: import_path12.default.join(outputDir, "public")
+      serverDir: import_path13.default.join(outputDir, "server"),
+      publicDir: import_path13.default.join(outputDir, "public")
     },
     publicAssets: [
       {
@@ -45250,7 +45332,7 @@ export default async function farmNitroEventHandler(event) {
   if (pluginManager) {
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
-  const expectedServerDir = import_path12.default.join(outputDir, "server");
+  const expectedServerDir = import_path13.default.join(outputDir, "server");
   const customRollupKeys = Object.keys(nitroConfig.rollupConfig || {}).filter(
     (key) => key !== "external" && key !== "plugins"
   );
@@ -45266,9 +45348,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 && import_path12.default.resolve(nitroConfig.output?.serverDir || "") === import_path12.default.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 && import_path13.default.resolve(nitroConfig.output?.serverDir || "") === import_path13.default.resolve(expectedServerDir) && Boolean(
     nitroConfig.handlers?.some(
-      (handler) => import_path12.default.resolve(handler?.handler || "") === nitroEntryPath
+      (handler) => import_path13.default.resolve(handler?.handler || "") === nitroEntryPath
     )
   );
   const selectRolldownBuilder = canReusePrebuiltSSR && requestedBuilder === void 0 && await canUseRolldownBuilder();
@@ -45280,8 +45362,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;
@@ -45323,10 +45406,10 @@ export default async function farmNitroEventHandler(event) {
         });
       }
       prerenderer.hooks.hook("compiled", async () => {
-        const prerenderServerDir = import_path12.default.join(outputDir, "server");
+        const prerenderServerDir = import_path13.default.join(outputDir, "server");
         await copyPrebuiltSSRBundle(
           ssrBundle,
-          import_path12.default.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
+          import_path13.default.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
           {},
           false,
           fs13
@@ -45360,20 +45443,20 @@ export default async function farmNitroEventHandler(event) {
   const copyResults = await Promise.allSettled([
     canReusePrebuiltSSR ? copyPrebuiltSSRBundle(
       ssrBundle,
-      import_path12.default.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
-      configuredEsbuildOptions,
+      import_path13.default.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
+      prebuiltSSREsbuildOptions,
       effectiveMinify,
       fs13
     ) : Promise.resolve(),
-    imageRuntime === "node" ? copySharpRuntime(config, root, import_path12.default.join(outputDir, "server"), fs13) : Promise.resolve(),
-    useExternalMetadataImageRuntime ? copyMetadataImageRuntime(root, import_path12.default.join(outputDir, "server"), fs13) : Promise.resolve()
+    imageRuntime === "node" ? copySharpRuntime(config, root, import_path13.default.join(outputDir, "server"), fs13) : Promise.resolve(),
+    useExternalMetadataImageRuntime ? copyMetadataImageRuntime(root, import_path13.default.join(outputDir, "server"), fs13) : Promise.resolve()
   ]);
   const failedCopy = copyResults.find(
     (result) => result.status === "rejected"
   );
   if (failedCopy) throw failedCopy.reason;
   if (canReusePrebuiltSSR) {
-    await registerPrebuiltSSRPackageImport(import_path12.default.join(outputDir, "server"), ssrEntryFile, fs13);
+    await registerPrebuiltSSRPackageImport(import_path13.default.join(outputDir, "server"), ssrEntryFile, fs13);
     logger.info("\u26A1 Reused Farm's prebuilt SSR bundle for the Node output");
   }
   if (useRolldownBuilder) {
@@ -45413,8 +45496,8 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
   await fs13.rm(targetDir, { recursive: true, force: true });
   await Promise.all(
     Object.entries(ssrBundle).map(async ([fileName, output]) => {
-      const targetPath = import_path12.default.join(targetDir, fileName);
-      await fs13.mkdir(import_path12.default.dirname(targetPath), { recursive: true });
+      const targetPath = import_path13.default.join(targetDir, fileName);
+      await fs13.mkdir(import_path13.default.dirname(targetPath), { recursive: true });
       if (output.type === "asset") {
         await fs13.writeFile(targetPath, output.source);
         return;
@@ -45433,7 +45516,7 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
 }
 __name(copyPrebuiltSSRBundle, "copyPrebuiltSSRBundle");
 async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs13) {
-  const packagePath = import_path12.default.join(serverDir, "package.json");
+  const packagePath = import_path13.default.join(serverDir, "package.json");
   const packageJSON = await fs13.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
     if (error.code === "ENOENT") return { type: "module" };
     throw error;
@@ -45450,16 +45533,16 @@ async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs13) {
 }
 __name(registerPrebuiltSSRPackageImport, "registerPrebuiltSSRPackageImport");
 async function postProcessVercelOutput(root, outputDir, fs13, config, farmWorkflows, routeRuntimeManifest) {
-  const serverDir = import_path12.default.join(outputDir, "server");
-  const functionsDir = import_path12.default.join(outputDir, "functions");
-  const nitroFuncDir = import_path12.default.join(functionsDir, "__nitro.func");
-  const staticDir = import_path12.default.join(outputDir, "static");
-  const publicDir = import_path12.default.join(outputDir, "public");
+  const serverDir = import_path13.default.join(outputDir, "server");
+  const functionsDir = import_path13.default.join(outputDir, "functions");
+  const nitroFuncDir = import_path13.default.join(functionsDir, "__nitro.func");
+  const staticDir = import_path13.default.join(outputDir, "static");
+  const publicDir = import_path13.default.join(outputDir, "public");
   await fs13.mkdir(nitroFuncDir, { recursive: true });
   const serverContents = await fs13.readdir(serverDir);
   for (const file of serverContents) {
-    const src = import_path12.default.join(serverDir, file);
-    const dest = import_path12.default.join(nitroFuncDir, file);
+    const src = import_path13.default.join(serverDir, file);
+    const dest = import_path13.default.join(nitroFuncDir, file);
     await fs13.rename(src, dest);
   }
   await fs13.rmdir(serverDir);
@@ -45469,7 +45552,7 @@ async function postProcessVercelOutput(root, outputDir, fs13, config, farmWorkfl
   }
   await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs13);
   await copyPrismaClientForVercel(root, nitroFuncDir, fs13);
-  const configPath = import_path12.default.join(outputDir, "config.json");
+  const configPath = import_path13.default.join(outputDir, "config.json");
   const configContent = await fs13.readFile(configPath, "utf-8");
   const vercelConfig = JSON.parse(configContent);
   const runtimeRoutes = await createFarmVercelRouteRuntimeFunctions(
@@ -45517,27 +45600,27 @@ __name(postProcessVercelOutput, "postProcessVercelOutput");
 async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs13) {
   const docsContentDir = resolveBuildDocsContentDir(config, root);
   if (!docsContentDir) return;
-  const bundledContentDir = import_path12.default.join(nitroFuncDir, "chunks", "nitro", "farm-docs-content");
+  const bundledContentDir = import_path13.default.join(nitroFuncDir, "chunks", "nitro", "farm-docs-content");
   const lastModifiedManifest = createFarmDocsLastModifiedManifest(docsContentDir, {
     fallback: "now"
   });
   await fs13.rm(bundledContentDir, { recursive: true, force: true });
-  await fs13.mkdir(import_path12.default.dirname(bundledContentDir), { recursive: true });
+  await fs13.mkdir(import_path13.default.dirname(bundledContentDir), { recursive: true });
   await fs13.cp(docsContentDir, bundledContentDir, {
     recursive: true,
     force: true
   });
   await fs13.writeFile(
-    import_path12.default.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
+    import_path13.default.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
     `${JSON.stringify(lastModifiedManifest, null, 2)}
 `
   );
-  logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${import_path12.default.relative(root, docsContentDir)}`);
+  logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${import_path13.default.relative(root, docsContentDir)}`);
 }
 __name(copyFarmDocsContentForVercel, "copyFarmDocsContentForVercel");
 async function copySharpRuntime(config, root, nitroFuncDir, fs13) {
   if (config.images.provider === "none") return;
-  const projectRequire = (0, import_module3.createRequire)(import_path12.default.join(root, "package.json"));
+  const projectRequire = (0, import_module3.createRequire)(import_path13.default.join(root, "package.json"));
   let sharpRequire = projectRequire;
   if (!resolvePackageJson(projectRequire, "sharp")) {
     try {
@@ -45547,7 +45630,7 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs13) {
   }
   const copiedPackages = /* @__PURE__ */ new Map();
   const packageCopies = /* @__PURE__ */ new Map();
-  const targetNodeModules = import_path12.default.join(nitroFuncDir, "node_modules");
+  const targetNodeModules = import_path13.default.join(nitroFuncDir, "node_modules");
   function copyPackage(packageName, parentRequire) {
     const activeCopy = packageCopies.get(packageName);
     if (activeCopy) return activeCopy;
@@ -45560,10 +45643,10 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs13) {
     const packageJsonPath = resolvePackageJson(parentRequire, packageName);
     if (!packageJsonPath) return;
     const packageJson = JSON.parse(await fs13.readFile(packageJsonPath, "utf8"));
-    const packageDir = import_path12.default.dirname(packageJsonPath);
-    const targetDir = import_path12.default.join(targetNodeModules, ...packageName.split("/"));
+    const packageDir = import_path13.default.dirname(packageJsonPath);
+    const targetDir = import_path13.default.join(targetNodeModules, ...packageName.split("/"));
     copiedPackages.set(packageName, String(packageJson.version || "*"));
-    await fs13.mkdir(import_path12.default.dirname(targetDir), { recursive: true });
+    await fs13.mkdir(import_path13.default.dirname(targetDir), { recursive: true });
     const packageRequire = (0, import_module3.createRequire)(packageJsonPath);
     const dependencies = {
       ...packageJson.dependencies,
@@ -45588,7 +45671,7 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs13) {
       "Farm image optimization requires sharp. Reinstall dependencies without omitting optional packages."
     );
   }
-  const functionPackagePath = import_path12.default.join(nitroFuncDir, "package.json");
+  const functionPackagePath = import_path13.default.join(nitroFuncDir, "package.json");
   const functionPackage = JSON.parse(await fs13.readFile(functionPackagePath, "utf8"));
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
@@ -45599,7 +45682,7 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs13) {
 }
 __name(copySharpRuntime, "copySharpRuntime");
 async function copyMetadataImageRuntime(root, nitroFuncDir, fs13) {
-  const projectRequire = (0, import_module3.createRequire)(import_path12.default.join(root, "package.json"));
+  const projectRequire = (0, import_module3.createRequire)(import_path13.default.join(root, "package.json"));
   let runtimeRequire = projectRequire;
   let packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
   if (!packageJsonPath) {
@@ -45615,16 +45698,16 @@ async function copyMetadataImageRuntime(root, nitroFuncDir, fs13) {
     );
   }
   const packageJson = JSON.parse(await fs13.readFile(packageJsonPath, "utf8"));
-  const packageDir = import_path12.default.dirname(packageJsonPath);
-  const targetDir = import_path12.default.join(nitroFuncDir, "node_modules", "@vercel", "og");
-  await fs13.mkdir(import_path12.default.dirname(targetDir), { recursive: true });
+  const packageDir = import_path13.default.dirname(packageJsonPath);
+  const targetDir = import_path13.default.join(nitroFuncDir, "node_modules", "@vercel", "og");
+  await fs13.mkdir(import_path13.default.dirname(targetDir), { recursive: true });
   await fs13.cp(packageDir, targetDir, {
     recursive: true,
     force: true,
     dereference: true,
     mode: import_fs5.constants.COPYFILE_FICLONE
   });
-  const functionPackagePath = import_path12.default.join(nitroFuncDir, "package.json");
+  const functionPackagePath = import_path13.default.join(nitroFuncDir, "package.json");
   const functionPackage = JSON.parse(await fs13.readFile(functionPackagePath, "utf8"));
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
@@ -45645,23 +45728,23 @@ function resolvePackageJson(parentRequire, packageName) {
 }
 __name(resolvePackageJson, "resolvePackageJson");
 async function copyPrismaClientForVercel(root, nitroFuncDir, fs13) {
-  const projectRequire = (0, import_module3.createRequire)(import_path12.default.join(root, "package.json"));
+  const projectRequire = (0, import_module3.createRequire)(import_path13.default.join(root, "package.json"));
   let prismaClientDir;
   try {
-    prismaClientDir = import_path12.default.dirname(projectRequire.resolve("@prisma/client/default.js"));
+    prismaClientDir = import_path13.default.dirname(projectRequire.resolve("@prisma/client/default.js"));
   } catch {
     return;
   }
-  const generatedClientDir = import_path12.default.join(prismaClientDir, "..", "..", ".prisma", "client");
+  const generatedClientDir = import_path13.default.join(prismaClientDir, "..", "..", ".prisma", "client");
   try {
     await fs13.access(generatedClientDir);
   } catch {
     return;
   }
-  const targetNodeModules = import_path12.default.join(nitroFuncDir, "node_modules");
-  const targetPrismaScopeDir = import_path12.default.join(targetNodeModules, "@prisma");
-  const targetGeneratedDir = import_path12.default.join(targetNodeModules, ".prisma", "client");
-  const targetClientDir = import_path12.default.join(targetPrismaScopeDir, "client");
+  const targetNodeModules = import_path13.default.join(nitroFuncDir, "node_modules");
+  const targetPrismaScopeDir = import_path13.default.join(targetNodeModules, "@prisma");
+  const targetGeneratedDir = import_path13.default.join(targetNodeModules, ".prisma", "client");
+  const targetClientDir = import_path13.default.join(targetPrismaScopeDir, "client");
   await fs13.mkdir(targetPrismaScopeDir, { recursive: true });
   await fs13.cp(prismaClientDir, targetClientDir, {
     recursive: true,
@@ -45671,8 +45754,8 @@ async function copyPrismaClientForVercel(root, nitroFuncDir, fs13) {
     recursive: true,
     force: true
   });
-  const functionPackagePath = import_path12.default.join(nitroFuncDir, "package.json");
-  const clientPackagePath = import_path12.default.join(prismaClientDir, "package.json");
+  const functionPackagePath = import_path13.default.join(nitroFuncDir, "package.json");
+  const clientPackagePath = import_path13.default.join(prismaClientDir, "package.json");
   const [functionPackageContent, clientPackageContent] = await Promise.all([
     fs13.readFile(functionPackagePath, "utf-8"),
     fs13.readFile(clientPackagePath, "utf-8")
@@ -45787,7 +45870,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),
@@ -45813,9 +45898,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, import_path14.default.join(root, distDir, "client"));
+      await buildClient2(legacyViteBuild, config, root, srcDir, import_path15.default.join(root, distDir, "client"));
       logger.info("\u{1F4E6} Building SSR bundle...");
-      await buildSSR(legacyViteBuild, config, root, srcDir, import_path14.default.join(root, distDir, "server"));
+      await buildSSR(legacyViteBuild, config, root, srcDir, import_path15.default.join(root, distDir, "server"));
       logger.info(`\u{1F680} Building server with Nitro (preset: ${preset})...`);
       await buildNitro(
         config,
@@ -45837,7 +45922,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", {
@@ -45985,12 +46070,12 @@ async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
 }
 __name(buildSSR, "buildSSR");
 function resolveLegacyPageEntry(config, root, srcDir) {
-  const appDir = import_path14.default.join(root, srcDir, "app");
+  const appDir = import_path15.default.join(root, srcDir, "app");
   for (const extension of getFarmRendererComponentExtensions(config.renderer)) {
-    const candidate = import_path14.default.join(appDir, `page${extension}`);
+    const candidate = import_path15.default.join(appDir, `page${extension}`);
     if ((0, import_node_fs13.existsSync)(candidate)) return candidate;
   }
-  return import_path14.default.join(appDir, "page.tsx");
+  return import_path15.default.join(appDir, "page.tsx");
 }
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
@@ -46009,18 +46094,18 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     nitroConfig = await pluginManager.runHookSerial("beforeNitroBuild", nitroConfig);
   }
   const outputDir = resolveDeployOutputPath(root, config.deploy.outputDir);
-  const serverOutputDir = import_path14.default.join(outputDir, "server");
-  const publicOutputDir = import_path14.default.join(outputDir, "public");
+  const serverOutputDir = import_path15.default.join(outputDir, "server");
+  const publicOutputDir = import_path15.default.join(outputDir, "public");
   const { mkdir: mkdir2, cp } = await import("fs/promises");
   await mkdir2(serverOutputDir, { recursive: true });
   await mkdir2(publicOutputDir, { recursive: true });
-  const clientDir = import_path14.default.join(root, distDir, "client");
+  const clientDir = import_path15.default.join(root, distDir, "client");
   try {
     await mkdir2(publicOutputDir, { recursive: true });
     await cp(clientDir, publicOutputDir, { recursive: true });
     logger.info("\u{1F4E6} Copied client assets to public directory");
-    const manifestPath = import_path14.default.join(publicOutputDir, "farm-client-manifest.json");
-    const assetsDir = import_path14.default.join(publicOutputDir, "assets");
+    const manifestPath = import_path15.default.join(publicOutputDir, "farm-client-manifest.json");
+    const assetsDir = import_path15.default.join(publicOutputDir, "assets");
     const manifestExists = await import("fs/promises").then(
       (fs13) => fs13.access(manifestPath).then(() => true).catch(() => false)
     );
@@ -46036,8 +46121,8 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     logger.error(`\u274C Failed to copy client assets: ${error}`);
     throw error;
   }
-  const serverDir = import_path14.default.join(root, distDir, "server");
-  const nitroServerDir = import_path14.default.join(root, distDir, ".nitro", "server", "farm");
+  const serverDir = import_path15.default.join(root, distDir, "server");
+  const nitroServerDir = import_path15.default.join(root, distDir, ".nitro", "server", "farm");
   try {
     await mkdir2(nitroServerDir, { recursive: true });
     await cp(serverDir, nitroServerDir, { recursive: true });
@@ -46046,7 +46131,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     logger.warn(`Could not copy SSR bundles: ${error}`);
   }
   const nitro = await createNitro(nitroConfig);
-  const registryPath = import_path14.default.join(root, distDir, ".nitro", "server", "farm-registry.ts");
+  const registryPath = import_path15.default.join(root, distDir, ".nitro", "server", "farm-registry.ts");
   try {
     const { farmRegistry } = await import(
       /* @vite-ignore */
@@ -46063,7 +46148,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     }
     farmRegistry.routePaths = routePaths;
     try {
-      const clientManifestPath = import_path14.default.join(root, distDir, "client", "farm-client-manifest.json");
+      const clientManifestPath = import_path15.default.join(root, distDir, "client", "farm-client-manifest.json");
       const { readFile: readFile7 } = await import("fs/promises");
       const manifestContent = await readFile7(clientManifestPath, "utf-8");
       farmRegistry.clientManifest = JSON.parse(manifestContent);
@@ -47373,14 +47458,14 @@ var _SPARouter = class _SPARouter {
   /**
    * Fetch page data from cache or server
    */
-  async fetchPageData(path37, recover = true, interceptFrom, fresh = false) {
-    const cacheKey = getPageDataCacheKey(path37, interceptFrom);
+  async fetchPageData(path38, recover = true, interceptFrom, fresh = false) {
+    const cacheKey = getPageDataCacheKey(path38, interceptFrom);
     const cached = fresh ? void 0 : this.cache.get(cacheKey);
     if (cached && Date.now() - cached.timestamp < this.options.cacheMaxAge) {
       return cached.data;
     }
     const activeLayoutChain = getActiveLayoutChainHeader();
-    const response = await fetch(`/__farm/page-data?path=${encodeURIComponent(path37)}`, {
+    const response = await fetch(`/__farm/page-data?path=${encodeURIComponent(path38)}`, {
       headers: createFarmDeploymentRequestHeaders(this.options.deploymentId, {
         Accept: "application/x-farm-deferred+json, application/json",
         "X-Farm-SPA": "1",
@@ -47395,7 +47480,7 @@ var _SPARouter = class _SPARouter {
       );
       dispatchDeploymentMismatch(error);
       if (recover) {
-        window.location.assign(path37);
+        window.location.assign(path38);
       }
       throw error;
     }
@@ -47414,16 +47499,16 @@ var _SPARouter = class _SPARouter {
    */
   async handlePopState(event) {
     if (document.documentElement.dataset.farmDocsRuntime === "true") return;
-    const path37 = window.location.pathname + window.location.search;
+    const path38 = window.location.pathname + window.location.search;
     if (await this.shouldBlockNavigation({
-      from: event.state?.path || path37,
-      to: path37,
+      from: event.state?.path || path38,
+      to: path38,
       action: "pop"
     })) {
       return;
     }
     this.startNavigation({
-      from: event.state?.path || path37,
+      from: event.state?.path || path38,
       to: createNavigationLocation(new URL(window.location.href)),
       action: "pop"
     });
@@ -47435,7 +47520,7 @@ var _SPARouter = class _SPARouter {
         action: "pop"
       });
       const interceptFrom = typeof event.state?.[FARM_INTERCEPT_FROM_KEY] === "string" ? event.state[FARM_INTERCEPT_FROM_KEY] : void 0;
-      const pageData = await this.fetchPageData(path37, true, interceptFrom);
+      const pageData = await this.fetchPageData(path38, true, interceptFrom);
       if (clientNavigation) {
         await this.clientPlugins?.markNavigationLoaded(clientNavigation, pageData);
       }
@@ -47466,8 +47551,8 @@ var _SPARouter = class _SPARouter {
   /**
    * Check if URL is cached
    */
-  isCached(path37, interceptFrom) {
-    const cached = this.cache.get(getPageDataCacheKey(path37, interceptFrom));
+  isCached(path38, interceptFrom) {
+    const cached = this.cache.get(getPageDataCacheKey(path38, interceptFrom));
     return cached !== void 0 && Date.now() - cached.timestamp < this.options.cacheMaxAge;
   }
   /**
@@ -47521,15 +47606,15 @@ var _SPARouter = class _SPARouter {
   /**
    * Save scroll position for a path
    */
-  saveScrollPosition(path37) {
+  saveScrollPosition(path38) {
     try {
       sessionStorage.setItem(
-        `farm-scroll-${path37}`,
+        `farm-scroll-${path38}`,
         JSON.stringify({ x: window.scrollX, y: window.scrollY })
       );
       for (const [key, element] of this.scrollElements) {
         sessionStorage.setItem(
-          getScrollElementStorageKey(path37, key),
+          getScrollElementStorageKey(path38, key),
           JSON.stringify({ x: element.scrollLeft, y: element.scrollTop })
         );
       }
@@ -47539,22 +47624,22 @@ var _SPARouter = class _SPARouter {
   /**
    * Restore scroll position for a path
    */
-  restoreScrollPosition(path37) {
+  restoreScrollPosition(path38) {
     try {
-      const saved = sessionStorage.getItem(`farm-scroll-${path37}`);
+      const saved = sessionStorage.getItem(`farm-scroll-${path38}`);
       if (saved) {
         const { x, y } = JSON.parse(saved);
         setTimeout(() => window.scrollTo(x, y), 0);
       }
       for (const [key, element] of this.scrollElements) {
-        this.restoreScrollElement(path37, key, element);
+        this.restoreScrollElement(path38, key, element);
       }
     } catch {
     }
   }
-  restoreScrollElement(path37, key, element) {
+  restoreScrollElement(path38, key, element) {
     try {
-      const saved = sessionStorage.getItem(getScrollElementStorageKey(path37, key));
+      const saved = sessionStorage.getItem(getScrollElementStorageKey(path38, key));
       if (!saved) return;
       const { x, y } = JSON.parse(saved);
       setTimeout(() => {
@@ -47623,11 +47708,11 @@ function readPageState() {
   return state[FARM_PAGE_STATE_KEY] ?? null;
 }
 __name(readPageState, "readPageState");
-function createHistoryState(path37, pageState, currentState, interceptFrom) {
+function createHistoryState(path38, pageState, currentState, interceptFrom) {
   const base = currentState && typeof currentState === "object" ? { ...currentState } : {};
   const nextState = {
     ...base,
-    path: path37,
+    path: path38,
     [FARM_PAGE_STATE_KEY]: pageState
   };
   if (interceptFrom === null) {
@@ -47638,9 +47723,9 @@ function createHistoryState(path37, pageState, currentState, interceptFrom) {
   return nextState;
 }
 __name(createHistoryState, "createHistoryState");
-function getPageDataCacheKey(path37, interceptFrom) {
-  return interceptFrom ? `${path37}
-intercept:${interceptFrom}` : path37;
+function getPageDataCacheKey(path38, interceptFrom) {
+  return interceptFrom ? `${path38}
+intercept:${interceptFrom}` : path38;
 }
 __name(getPageDataCacheKey, "getPageDataCacheKey");
 function createNavigationLocation(url) {
@@ -47652,8 +47737,8 @@ function createNavigationLocation(url) {
   };
 }
 __name(createNavigationLocation, "createNavigationLocation");
-function getScrollElementStorageKey(path37, key) {
-  return `farm-scroll-${path37}:${key}`;
+function getScrollElementStorageKey(path38, key) {
+  return `farm-scroll-${path38}:${key}`;
 }
 __name(getScrollElementStorageKey, "getScrollElementStorageKey");
 
@@ -48414,10 +48499,10 @@ var _DefaultFarmRuntimeErrorOverlay = class _DefaultFarmRuntimeErrorOverlay {
     container.replaceChildren();
     const source = this.document.createElement("div");
     source.className = "farm-default-error__source";
-    const path37 = this.document.createElement("p");
-    path37.className = "farm-default-error__source-path";
-    path37.textContent = formatSourcePath(sourceFrame);
-    source.appendChild(path37);
+    const path38 = this.document.createElement("p");
+    path38.className = "farm-default-error__source-path";
+    path38.textContent = formatSourcePath(sourceFrame);
+    source.appendChild(path38);
     const pre = this.document.createElement("pre");
     pre.className = "farm-default-error__source-code";
     pre.tabIndex = 0;
@@ -48646,7 +48731,7 @@ function normalizeSourceLine(value) {
   return value.trim().replace(/\s+/g, " ");
 }
 __name(normalizeSourceLine, "normalizeSourceLine");
-function createSourceFrame2(source, path37, line, column) {
+function createSourceFrame2(source, path38, line, column) {
   const lines = source.split(/\r?\n/);
   if (line < 1 || line > lines.length) return void 0;
   const start = Math.max(1, line - 2);
@@ -48659,7 +48744,7 @@ function createSourceFrame2(source, path37, line, column) {
       highlight: number === line
     });
   }
-  return { path: path37, line, column, lines: frameLines };
+  return { path: path38, line, column, lines: frameLines };
 }
 __name(createSourceFrame2, "createSourceFrame");
 function formatDisplaySourceUrl(url, clientWindow) {