@farm.js/core 0.1.21 → 0.1.23

package/dist/{chunk-PUCUVI7K.mjs → chunk-72VJRKJD.mjs}

@@ -6,7 +6,7 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteConflictError
-} from "./chunk-CQHFU55R.mjs";
+} from "./chunk-WNUBR4CA.mjs";
 import {
   findProgrammaticRouteFilesInDir
 } from "./chunk-YOYF2E4U.mjs";

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

@@ -7,7 +7,7 @@ import {
 import {
   compileFarmDocsAdapterEdgeManifest,
   createFarmDocsAPIHandler
-} from "./chunk-W7MZXRXM.mjs";
+} from "./chunk-YGMK6ESJ.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -17,7 +17,7 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-HSDL2AUR.mjs";
+} from "./chunk-47H7VENP.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -26,15 +26,18 @@ import {
 import {
   FARM_PRERENDER_ENV
 } from "./chunk-6VEHUKZ2.mjs";
+import {
+  loadFarmDocsEngine
+} from "./chunk-2VQKKQ6D.mjs";
 import {
   getDefaultDeployOutputDir,
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-RMIJFZU3.mjs";
+} from "./chunk-BDJNP7AQ.mjs";
 import {
   resolveFarmInstrumentationFile
-} from "./chunk-F5D4XEAS.mjs";
+} from "./chunk-ZZSRYEYU.mjs";
 import {
   resolveFarmInstrumentationRuntime
 } from "./chunk-H77NVNJ2.mjs";
@@ -42,6 +45,7 @@ import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
   PluginManager,
+  SHARP_INSTALL_HINT,
   createFarmApp,
   createFarmSourceAlias,
   createFarmThemeCssPlugin,
@@ -57,19 +61,21 @@ import {
   getClientModuleHydrationPlan,
   getClientModuleMetadata,
   getFarmClientHydrationPlanOptions,
+  loadTailwindVitePlugin,
   mergeFarmFontCss,
   mergeFarmProductionViteConfig,
   mergeFarmViteConfig,
   resolveFarmClientCacheAdapterEntry,
+  resolveFarmImageProviderForRuntime,
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath
-} from "./chunk-53G3OLTA.mjs";
+} from "./chunk-VPY755R2.mjs";
 import {
   findRequestBoundSourceBlockers,
   generateFarmTypeArtifacts,
   parseRouteRenderingDirective,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-NRS46D4L.mjs";
+} from "./chunk-VVJCWBIE.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
@@ -89,15 +95,16 @@ import {
 } from "./chunk-GHFS7RUB.mjs";
 import {
   getFarmAppDirectories
-} from "./chunk-IILNZK5G.mjs";
+} from "./chunk-JHWOVJ3M.mjs";
 import {
   REACT_RENDERER,
   getFarmRendererCapabilities,
   getFarmRendererComponentExtensions,
   getFarmRendererStreamingCapabilitiesForRuntime,
   isReactRenderer,
-  loadFarmRendererVitePlugins
-} from "./chunk-OLYK7EAK.mjs";
+  loadFarmRendererVitePlugins,
+  resolveFarmRendererAppSetup
+} from "./chunk-DAATZTKJ.mjs";
 import {
   applyFarmCspHashesToHtml
 } from "./chunk-7BC6GAL7.mjs";
@@ -120,7 +127,7 @@ import {
 import {
   applyFarmWorkflowVercelCrons,
   prepareFarmWorkflowsForNitro
-} from "./chunk-EGJDUF4Q.mjs";
+} from "./chunk-3ATMYLLJ.mjs";
 import {
   getFarmIntegrationPluginServerRuntime,
   getIntegrationProviders
@@ -130,10 +137,13 @@ import {
 } from "./chunk-TIKNUAU7.mjs";
 import {
   APIRouteManager
-} from "./chunk-CQHFU55R.mjs";
+} from "./chunk-WNUBR4CA.mjs";
 import {
   readFarmI18nCatalogs
 } from "./chunk-FV45CKBC.mjs";
+import {
+  VERCEL_OG_INSTALL_HINT
+} from "./chunk-YOZYCI6Z.mjs";
 import {
   resolveFarmAPIServerBasePath,
   resolveFarmAPIServerRoutePath
@@ -954,52 +964,6 @@ export default {};
 }
 __name(createFarmNodeServerEntry, "createFarmNodeServerEntry");
 
-// src/build/vite-plugin-compat.ts
-function adaptTailwindVitePlugin(pluginOption, builder) {
-  if (builder !== "rolldown") return pluginOption;
-  return adaptPluginOption(pluginOption);
-}
-__name(adaptTailwindVitePlugin, "adaptTailwindVitePlugin");
-function adaptPluginOption(pluginOption) {
-  if (Array.isArray(pluginOption)) return pluginOption.map(adaptPluginOption);
-  if (!pluginOption || typeof pluginOption !== "object") return pluginOption;
-  const plugin = pluginOption;
-  if (!plugin.name?.startsWith("@tailwindcss/vite:generate:")) return pluginOption;
-  if (isVitePluginHook(plugin.transform)) {
-    return {
-      ...plugin,
-      transform: withVite5TransformContext(plugin.transform)
-    };
-  }
-  if (plugin.transform && typeof plugin.transform === "object" && "handler" in plugin.transform && isVitePluginHook(plugin.transform.handler)) {
-    return {
-      ...plugin,
-      transform: {
-        ...plugin.transform,
-        handler: withVite5TransformContext(plugin.transform.handler)
-      }
-    };
-  }
-  return pluginOption;
-}
-__name(adaptPluginOption, "adaptPluginOption");
-function isVitePluginHook(value) {
-  return typeof value === "function";
-}
-__name(isVitePluginHook, "isVitePluginHook");
-function withVite5TransformContext(handler) {
-  return function(...args) {
-    const context = new Proxy(this, {
-      get(target, property, receiver) {
-        if (property === "environment") return void 0;
-        return Reflect.get(target, property, receiver);
-      }
-    });
-    return handler.apply(context, args);
-  };
-}
-__name(withVite5TransformContext, "withVite5TransformContext");
-
 // src/nitro/universal-build.ts
 function preloadFarmNitroBuilder() {
   return import("nitro/builder").then(
@@ -1117,6 +1081,9 @@ var NITRO_EXTERNAL_MODULES = /* @__PURE__ */ new Set([
   "fsevents",
   "esbuild",
   "lightningcss",
+  "rolldown",
+  "rolldown/experimental",
+  "rolldown/utils",
   "rollup",
   "vite",
   "nitro",
@@ -1357,69 +1324,70 @@ function hasFarmRuntimeConfigModule(config, configModulePath) {
   return Boolean(configModulePath || (config.layers || []).some((layer) => layer.configFile));
 }
 __name(hasFarmRuntimeConfigModule, "hasFarmRuntimeConfigModule");
-function createEsbuildTransformOptions(configuredEsbuildOptions, minify, defaultTarget) {
-  const {
-    include: _include,
-    exclude: _exclude,
-    sourceMap: _sourceMap,
-    loaders: _loaders,
-    ...configuredTransformOptions
-  } = configuredEsbuildOptions;
-  const configuredTarget = Array.isArray(configuredTransformOptions.target) ? configuredTransformOptions.target.filter(
-    (target) => typeof target === "string"
-  ) : configuredTransformOptions.target;
-  const transformTarget = Array.isArray(configuredTarget) && configuredTarget.length === 0 ? defaultTarget : configuredTarget ?? defaultTarget;
-  const transformSupported = configuredTransformOptions.supported ? Object.fromEntries(
-    Object.entries(configuredTransformOptions.supported).filter(
-      (entry) => typeof entry[1] === "boolean"
-    )
-  ) : void 0;
-  return {
-    ...configuredTransformOptions,
-    format: "esm",
-    target: transformTarget,
-    loader: "js",
-    sourcemap: false,
-    minify,
-    keepNames: configuredTransformOptions.keepNames ?? true,
-    legalComments: configuredTransformOptions.legalComments ?? "none",
-    supported: transformSupported
-  };
+async function minifyFarmServerChunk(code, fileName, options) {
+  const rolldownUtils = await import("rolldown/utils");
+  const keepNames = { function: options.keepNames, class: options.keepNames };
+  const result = await rolldownUtils.minify(fileName, code, {
+    module: true,
+    compress: { target: options.target, keepNames },
+    mangle: { keepNames },
+    codegen: { legalComments: "none", asciiOnly: true },
+    sourcemap: false
+  });
+  if (result.errors.length > 0) {
+    throw new Error(`Failed to minify ${fileName}: ${result.errors[0].message}`);
+  }
+  return restoreLiteralModuleSpecifiers(result.code, fileName, rolldownUtils);
+}
+__name(minifyFarmServerChunk, "minifyFarmServerChunk");
+function restoreLiteralModuleSpecifiers(code, fileName, { parseSync, Visitor }) {
+  if (!code.includes("import(`") && !code.includes("require(`")) return code;
+  const parsed = parseSync(fileName, code, { lang: "js", sourceType: "module" });
+  if (parsed.errors.length > 0) {
+    throw new Error(`Failed to minify ${fileName}: ${parsed.errors[0].message}`);
+  }
+  const replacements = [];
+  const restore = /* @__PURE__ */ __name((node) => {
+    if (node?.type !== "TemplateLiteral") return;
+    const template = node;
+    const value = template.quasis[0]?.value.cooked;
+    if (template.expressions.length > 0 || typeof value !== "string") return;
+    const text = JSON.stringify(value).replace(
+      /[\u007f-￿]/g,
+      (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`
+    );
+    replacements.push({ start: template.start, end: template.end, text });
+  }, "restore");
+  new Visitor({
+    ImportExpression(node) {
+      restore(node.source);
+    },
+    CallExpression(node) {
+      if (node.callee.type === "Identifier" && node.callee.name === "require" && node.arguments.length === 1) {
+        restore(node.arguments[0]);
+      }
+    }
+  }).visit(parsed.program);
+  let restored = "";
+  let offset = 0;
+  for (const { start, end, text } of replacements.sort((a, b) => a.start - b.start)) {
+    restored += code.slice(offset, start) + text;
+    offset = end;
+  }
+  return restored + code.slice(offset);
 }
-__name(createEsbuildTransformOptions, "createEsbuildTransformOptions");
-function createEsbuildChunkMinifyPlugin(configuredEsbuildOptions) {
-  const configuredTransformOptions = createEsbuildTransformOptions(
-    configuredEsbuildOptions,
-    true,
-    "esnext"
-  );
-  const transformOptions = {
-    format: "esm",
-    target: configuredTransformOptions.target,
-    loader: "js",
-    sourcemap: false,
-    minify: true,
-    keepNames: configuredTransformOptions.keepNames,
-    legalComments: configuredTransformOptions.legalComments,
-    charset: configuredTransformOptions.charset
-  };
+__name(restoreLiteralModuleSpecifiers, "restoreLiteralModuleSpecifiers");
+function createServerChunkMinifyPlugin(options) {
   return {
-    name: "farm-esbuild-minify",
+    name: "farm-server-chunk-minify",
     async renderChunk(code, chunk) {
-      const { transform } = await import("esbuild");
-      const result = await transform(code, {
-        ...transformOptions,
-        sourcefile: chunk.fileName
-      });
-      if (!result.code) return null;
-      return {
-        code: result.code,
-        map: result.map || null
-      };
+      const minified = await minifyFarmServerChunk(code, chunk.fileName, options);
+      if (!minified) return null;
+      return { code: minified, map: null };
     }
   };
 }
-__name(createEsbuildChunkMinifyPlugin, "createEsbuildChunkMinifyPlugin");
+__name(createServerChunkMinifyPlugin, "createServerChunkMinifyPlugin");
 function trimSlashes(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
@@ -2141,15 +2109,10 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     const postcssConfigPath = path5.join(clientEntryDir, "postcss.config.cjs");
     await fs.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
     postcssSearchPath = clientEntryDir;
-    try {
-      const tailwindVite = (await import("@tailwindcss/vite")).default;
-      tailwindVitePlugin = adaptTailwindVitePlugin(tailwindVite(), productionVite.builder);
-      logger.info("\u{1F4E6} Enabled built-in Tailwind support (@tailwindcss/vite)");
-    } catch (error) {
-      logger.warn(
-        `Tailwind plugin auto-enable failed; continuing without it: ${error.message}`
-      );
-    }
+    tailwindVitePlugin = await loadTailwindVitePlugin({
+      builder: productionVite.builder,
+      announce: true
+    });
   }
   try {
     const clientViteConfig = {
@@ -2237,7 +2200,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
             if (id.includes("/api/") && id.includes("/route")) {
               return { id: "\0empty-api-route", external: false };
             }
-            if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node") || id === "nitro" || id === "vite" || id === "esbuild" || id === "rollup" || id.startsWith("nitro/") || id.includes("node-pre-gyp") || id.includes("nf3")) {
+            if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node") || id === "nitro" || id === "vite" || id === "esbuild" || id === "rolldown" || id.startsWith("rolldown/") || id === "rollup" || id.startsWith("nitro/") || id.includes("node-pre-gyp") || id.includes("nf3")) {
               return { id: "\0empty-module", external: false };
             }
             return null;
@@ -3054,8 +3017,11 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
     srcDir,
     publicRuntimeConfig
   );
+  const appSetupPath = resolveFarmRendererAppSetup(root, renderer);
   const rendererClientImports = isReactRenderer(renderer) ? `import React from "react";
-import { createRoot, hydrateRoot } from "react-dom/client";` : `import React, { createRoot, hydrateRoot } from ${JSON.stringify(renderer.client)};`;
+import { createRoot, hydrateRoot } from "react-dom/client";` : appSetupPath ? `import React, { createRoot, hydrateRoot, configureApp as __farmConfigureApp } from ${JSON.stringify(renderer.client)};
+import __farmAppSetup from ${JSON.stringify(toPosixPath(appSetupPath))};
+__farmConfigureApp(__farmAppSetup);` : `import React, { createRoot, hydrateRoot } from ${JSON.stringify(renderer.client)};`;
   const providerClientCode = generateFarmIntegrationProviderClientCode(
     integrationProviders,
     root,
@@ -4434,7 +4400,7 @@ void hydrate();
 __name(generateClientHydrationEntry, "generateClientHydrationEntry");
 async function buildSSRInMemory(productionVite, config, root, routeManager, apiRouteManager, serverRenderer, preset, collectedPageRoutes, collectedLayoutRoutes, collectedRouteSlots, isolatedClientBoundaryModules, hydrationPlanCache, rendererBuildLifetime) {
   const viteBuild = productionVite.build;
-  const { farmPlugin } = await import("./vite.mjs");
+  const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
   const { PluginManager: PluginManager2 } = await import("./plugin.mjs");
   const fs = await import("fs/promises");
   const pluginManager = new PluginManager2({
@@ -4456,14 +4422,10 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       path5.join(postcssConfigDir, "postcss.config.cjs"),
       "module.exports = { plugins: [] };\n"
     );
-    try {
-      const tailwindVite = (await import("@tailwindcss/vite")).default;
-      tailwindVitePlugin = adaptTailwindVitePlugin(tailwindVite(), productionVite.builder);
-    } catch (error) {
-      logger.warn(
-        `Tailwind plugin auto-enable failed for SSR; continuing without it: ${error.message}`
-      );
-    }
+    tailwindVitePlugin = await loadTailwindVitePlugin({
+      builder: productionVite.builder,
+      label: "for SSR"
+    });
   }
   let ssrBundle;
   let ssrEntryFile;
@@ -4494,6 +4456,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
       modulePath: entry.modulePath
     });
   }
+  assertMetadataImageRuntimeInstalled(root, metadataImageRoutes);
   const applicationMetadataRoutes = Array.from(
     routeManager.getMetadataRoutes().values(),
     (entry) => ({
@@ -4537,7 +4500,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   const appDirs = getFarmAppDirectories(config);
   let openAPIReference = null;
   if (config.openapi.enabled && config.openapi.route) {
-    const { OpenAPIManager, renderOpenAPIReferenceHTML } = await import("./manager-NPG43N46.mjs");
+    const { OpenAPIManager, renderOpenAPIReferenceHTML } = await import("./manager-RT733VRK.mjs");
     const openAPIManager = new OpenAPIManager(appDirs, config.openapi, {
       mode: "production",
       apiBaseURL: config.api.baseURL
@@ -4698,6 +4661,9 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
           ...useExternalMetadataImageRuntime ? ["@vercel/og"] : [],
           "esbuild",
           "lightningcss",
+          "rolldown",
+          "rolldown/experimental",
+          "rolldown/utils",
           "rollup",
           "@rollup/rollup-darwin-arm64",
           "@rollup/rollup-darwin-x64",
@@ -4753,6 +4719,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
             };
           }
         },
+        farmServerOnlyEntriesPlugin(),
         farmPlugin({ ...config, isolatedClientBoundaryModules }, pluginManager),
         farmEnvironmentFunctionsPlugin(),
         {
@@ -5123,6 +5090,17 @@ async function applyFarmPreloadBudget(response, pathname, request) {
 `.trim();
 }
 __name(generatePreloadResponseRuntimeSource, "generatePreloadResponseRuntimeSource");
+function generateFarmRendererAppSetupServerCode(config) {
+  const appSetupPath = resolveFarmRendererAppSetup(config.root || process.cwd(), config.renderer);
+  if (!appSetupPath) return "";
+  return `
+import __farmAppSetup from ${JSON.stringify(toPosixPath(appSetupPath))};
+if (typeof ReactDOMServer.configureApp !== "function") {
+  throw new Error(${JSON.stringify(`Renderer \`${config.renderer.name}\` does not support \`appSetup\`: its server module must export configureApp().`)});
+}
+ReactDOMServer.configureApp(__farmAppSetup);`;
+}
+__name(generateFarmRendererAppSetupServerCode, "generateFarmRendererAppSetupServerCode");
 function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlots, errorRoutes, metadataImageRoutes, applicationMetadataRoutes, middlewareRoutes, redirectRoutes, configuredRewriteRoutes, configuredHeaderRoutes, openAPIReference, notFoundPath, instrumentationPath, config, farmDocsPrecompiledManifest, configModulePath, hasServerRuntimeIntegrations, hasRuntimeIntegrationConfig, hasConfiguredRuntimePlugins, hasServerRuntimePlugins, preset, i18nCatalogs, isolatedClientBoundaryModules, hydrationPlanCache) {
   const hasCompressionRuntime = config.compress && resolveFarmInstrumentationRuntime(preset) === "nodejs";
   const servesAgentRobotsTxt = Boolean(config.agent?.crawlers?.enabled) && !applicationMetadataRoutes.some(
@@ -5141,7 +5119,7 @@ function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlot
     getFarmPresetRuntime(preset)
   );
   const rendererServerImports = isReactRenderer(config.renderer) ? `import * as React from "react";
-import * as ReactDOMServer from "react-dom/server";${hasIsolatedClientGraphRuntime ? '\nimport { isolateFarmServerPageGraph, wrapFarmIsolatedClientGraph } from "@farm.js/core/internal/isolated-boundary";' : ""}` : `import React, * as ReactDOMServer from ${JSON.stringify(config.renderer.server)};`;
+import * as ReactDOMServer from "react-dom/server";${hasIsolatedClientGraphRuntime ? '\nimport { isolateFarmServerPageGraph, wrapFarmIsolatedClientGraph } from "@farm.js/core/internal/isolated-boundary";' : ""}` : `import React, * as ReactDOMServer from ${JSON.stringify(config.renderer.server)};${generateFarmRendererAppSetupServerCode(config)}`;
   const routeClientGraphServerRuntime = hasIsolatedClientGraphRuntime ? `function wrapFarmRouteClientGraph(element) {
   return wrapFarmIsolatedClientGraph(React, element);
 }
@@ -9316,16 +9294,9 @@ export default async function farmNitroEventHandler(event) {
   if (selectRolldownBuilder) nitroConfig.builder = "rolldown";
   const useRolldownBuilder = canReusePrebuiltSSR && (nitroConfig.builder ?? process.env.NITRO_BUILDER) === "rolldown";
   const shouldMinify = nitroConfig.minify !== false;
-  const configuredEsbuildOptions = {};
-  const resolvedEsbuildOptions = {
-    // Function-name helpers are unsafe for provider scripts that serialize a
-    // function with toString(); the helper is outside the emitted script scope.
-    keepNames: !(config.docs?.enabled && config.docs.adapter?.server),
-    legalComments: "none"
-  };
-  const prebuiltSSREsbuildOptions = config.docs?.enabled && config.docs.adapter?.server ? resolvedEsbuildOptions : configuredEsbuildOptions;
-  const useFarmEsbuildMinifier = shouldMinify && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig;
-  const esbuildChunkMinifier = useFarmEsbuildMinifier ? createEsbuildChunkMinifyPlugin(resolvedEsbuildOptions) : null;
+  const keepServerNames = !(config.docs?.enabled && config.docs.adapter?.server);
+  const useFarmServerMinifier = shouldMinify && nitroConfig.sourcemap === false && !hasCustomOxcOptions && !hasLateBuildMutationConfig;
+  const serverChunkMinifier = useFarmServerMinifier ? createServerChunkMinifyPlugin({ keepNames: keepServerNames, target: "esnext" }) : null;
   if (canReusePrebuiltSSR) {
     const configuredRollupPlugins = nitroConfig.rollupConfig?.plugins;
     nitroConfig.rollupConfig = {
@@ -9336,7 +9307,7 @@ export default async function farmNitroEventHandler(event) {
       ]
     };
   }
-  nitroConfig.minify = useFarmEsbuildMinifier ? false : shouldMinify;
+  nitroConfig.minify = useFarmServerMinifier ? false : shouldMinify;
   const nitroInstance = await nitroBuilder.createNitro(nitroConfig);
   if (config.security.csp && config.security.csp.nonce) {
     nitroInstance.hooks.hook("prerender:generate", async (route) => {
@@ -9386,26 +9357,25 @@ export default async function farmNitroEventHandler(event) {
         await copyPrebuiltSSRBundle(
           ssrBundle,
           path5.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
-          {},
-          false,
+          null,
           fs
         );
         await registerPrebuiltSSRPackageImport(prerenderServerDir, ssrEntryFile, fs);
       });
     });
   }
-  if (esbuildChunkMinifier || useRolldownBuilder) {
+  if (serverChunkMinifier || useRolldownBuilder) {
     nitroInstance.hooks.hook("rollup:before", (_nitro, rollupConfig) => {
       if (useRolldownBuilder) {
         const rolldownConfig = rollupConfig;
         delete rolldownConfig.inject;
         delete rolldownConfig.jsx;
       }
-      if (esbuildChunkMinifier) {
+      if (serverChunkMinifier) {
         const configuredPlugins = rollupConfig.plugins;
         rollupConfig.plugins = [
           ...Array.isArray(configuredPlugins) ? configuredPlugins : configuredPlugins ? [configuredPlugins] : [],
-          esbuildChunkMinifier
+          serverChunkMinifier
         ];
       }
     });
@@ -9452,8 +9422,7 @@ export default async function farmNitroEventHandler(event) {
     canReusePrebuiltSSR ? copyPrebuiltSSRBundle(
       ssrBundle,
       path5.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
-      prebuiltSSREsbuildOptions,
-      shouldMinify,
+      shouldMinify ? { keepNames: keepServerNames, target: "node18" } : null,
       fs
     ) : Promise.resolve(),
     runtimeCopyPromise
@@ -9497,23 +9466,7 @@ function resolveFarmNitroOutputConfig(preset, outputDir) {
   };
 }
 __name(resolveFarmNitroOutputConfig, "resolveFarmNitroOutputConfig");
-async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOptions, minify, fs) {
-  const {
-    include: _include,
-    exclude: _exclude,
-    sourceMap: _sourceMap,
-    loaders: _loaders,
-    ...configuredTransformOptions
-  } = configuredEsbuildOptions;
-  const hasConfiguredTransforms = Object.keys(configuredTransformOptions).some(
-    (option) => option !== "minify"
-  );
-  const transformOptions = createEsbuildTransformOptions(
-    configuredEsbuildOptions,
-    minify,
-    "node18"
-  );
-  const transform = minify || hasConfiguredTransforms ? (await import("esbuild")).transform : null;
+async function copyPrebuiltSSRBundle(ssrBundle, targetDir, minifyOptions, fs) {
   await fs.rm(targetDir, { recursive: true, force: true });
   await Promise.all(
     Object.entries(ssrBundle).map(async ([fileName, output]) => {
@@ -9523,14 +9476,7 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
         await fs.writeFile(targetPath, output.source);
         return;
       }
-      let code = output.code;
-      if (transform) {
-        const result = await transform(code, {
-          ...transformOptions,
-          sourcefile: fileName
-        });
-        code = result.code;
-      }
+      const code = minifyOptions ? await minifyFarmServerChunk(output.code, fileName, minifyOptions) : output.code;
       await fs.writeFile(targetPath, code);
     })
   );
@@ -9705,9 +9651,7 @@ async function stageSharpRuntime(config, root, distDir, fs, preset) {
   try {
     await copyPackage("sharp", sharpRequire);
     if (!copiedPackages.has("sharp")) {
-      throw new Error(
-        "Farm image optimization requires sharp. Reinstall dependencies without omitting optional packages."
-      );
+      throw new Error(`Farm image optimization requires sharp. ${SHARP_INSTALL_HINT}`);
     }
   } catch (error) {
     await fs.rm(stageDir, { recursive: true, force: true });
@@ -9779,20 +9723,31 @@ async function mergeStagedDirectory(sourceDir, targetDir, fs) {
   );
 }
 __name(mergeStagedDirectory, "mergeStagedDirectory");
-async function copyMetadataImageRuntime(root, nitroFuncDir, fs) {
+function assertMetadataImageRuntimeInstalled(root, metadataImageRoutes) {
+  const generated = metadataImageRoutes.find((image) => image.sourceType === "module");
+  if (!generated || resolveMetadataImageRuntimePackageJson(root)) return;
+  const file = generated.modulePath ? toPosixPath(path5.relative(root, generated.modulePath)) : "";
+  throw new Error(
+    `${file || "A generated metadata image"} renders with @vercel/og, which is not installed. ${VERCEL_OG_INSTALL_HINT}`
+  );
+}
+__name(assertMetadataImageRuntimeInstalled, "assertMetadataImageRuntimeInstalled");
+function resolveMetadataImageRuntimePackageJson(root) {
   const projectRequire = createRequire(path5.join(root, "package.json"));
-  let runtimeRequire = projectRequire;
-  let packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
-  if (!packageJsonPath) {
-    try {
-      runtimeRequire = createRequire(projectRequire.resolve("@farm.js/core"));
-      packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
-    } catch {
-    }
+  const packageJsonPath = resolvePackageJson(projectRequire, "@vercel/og");
+  if (packageJsonPath) return packageJsonPath;
+  try {
+    return resolvePackageJson(createRequire(projectRequire.resolve("@farm.js/core")), "@vercel/og");
+  } catch {
+    return null;
   }
+}
+__name(resolveMetadataImageRuntimePackageJson, "resolveMetadataImageRuntimePackageJson");
+async function copyMetadataImageRuntime(root, nitroFuncDir, fs) {
+  const packageJsonPath = resolveMetadataImageRuntimePackageJson(root);
   if (!packageJsonPath) {
     throw new Error(
-      "Generated metadata images require @vercel/og. Reinstall @farm.js/core with production dependencies."
+      `The server output imports @vercel/og, which is not installed. ${VERCEL_OG_INSTALL_HINT}`
     );
   }
   const packageJson = JSON.parse(await fs.readFile(packageJsonPath, "utf8"));
@@ -9969,6 +9924,14 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
         outputDir: targets.outputDir
       }
     };
+    config = {
+      ...config,
+      images: resolveFarmImageProviderForRuntime(config.images, {
+        root: targets.root,
+        preset: targets.preset
+      })
+    };
+    if (config.docs?.enabled) await loadFarmDocsEngine();
     pluginManager.updateContext({ config });
     const { root, preset, srcDir, distDir, deployOutputDir } = targets;
     logger.info(`\u{1F69C} Building Farm.js application with preset: ${preset}...`);
@@ -10230,7 +10193,7 @@ function resolveLegacyPageEntry(config, root, srcDir) {
 __name(resolveLegacyPageEntry, "resolveLegacyPageEntry");
 async function buildNitro(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, pluginManager) {
   const [{ createNitroConfig }, { createNitro, build: nitroBuild }] = await Promise.all([
-    import("./nitro-4LFVTT24.mjs"),
+    import("./nitro-ZKLGOTVY.mjs"),
     import("nitro/builder")
   ]);
   let nitroConfig = await createNitroConfig(