@farm.js/core 0.1.21 → 0.1.23

package/dist/{chunk-53G3OLTA.mjs → chunk-VPY755R2.mjs}

@@ -6,7 +6,7 @@ import {
   parseRouteSlotFile,
   resolveRouteRenderingConfig,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-NRS46D4L.mjs";
+} from "./chunk-VVJCWBIE.mjs";
 import {
   collectSchemaExtensions,
   declareSchemaTables,
@@ -30,7 +30,7 @@ import {
 } from "./chunk-BOYNDCZL.mjs";
 import {
   createFarmMetadataImageResponse
-} from "./chunk-HLCDYJY7.mjs";
+} from "./chunk-YQVSHTMR.mjs";
 import {
   createFarmImageHandler
 } from "./chunk-F6XEGFHO.mjs";
@@ -74,7 +74,7 @@ import {
   getFarmAppDirectories,
   getFarmLayerAliases,
   getFarmSourceRoots
-} from "./chunk-IILNZK5G.mjs";
+} from "./chunk-JHWOVJ3M.mjs";
 import {
   REACT_RENDERER,
   assertFarmRendererStreamingRuntime,
@@ -86,8 +86,9 @@ import {
   readFarmRendererWebStream,
   resolveFarmComponentExtensions,
   resolveFarmRenderer,
+  resolveFarmRendererAppSetup,
   resolveFarmRendererModule
-} from "./chunk-OLYK7EAK.mjs";
+} from "./chunk-DAATZTKJ.mjs";
 import {
   FARM_PREVIEW_ROBOTS_TAG,
   addFarmCspNonceToScriptTags,
@@ -143,7 +144,7 @@ import {
 } from "./chunk-OFEY6KHO.mjs";
 import {
   resolveWorkflowsConfig
-} from "./chunk-EGJDUF4Q.mjs";
+} from "./chunk-3ATMYLLJ.mjs";
 import {
   initStorage
 } from "./chunk-UWPLULNK.mjs";
@@ -181,7 +182,7 @@ import {
 } from "./chunk-IOEH4VWN.mjs";
 import {
   APIRouteManager
-} from "./chunk-CQHFU55R.mjs";
+} from "./chunk-WNUBR4CA.mjs";
 import {
   findProgrammaticRouteFiles,
   loadProgrammaticRouteManifests
@@ -192,6 +193,12 @@ import {
   createFarmI18nRuntime,
   getFarmI18nClientSnapshot
 } from "./chunk-JNGIWIY6.mjs";
+import {
+  VERCEL_OG_INSTALL_HINT,
+  formatOptionalPeerInstallHint,
+  isMissingPackageError,
+  isOptionalPeerInstalled
+} from "./chunk-YOZYCI6Z.mjs";
 import {
   isFarmAPIPathname
 } from "./chunk-XP777LRD.mjs";
@@ -264,7 +271,7 @@ import {
 } from "./chunk-Z2RZJZIZ.mjs";
 import {
   FARM_VERSION
-} from "./chunk-PKO4FCTL.mjs";
+} from "./chunk-EHUZ2MKO.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -1439,9 +1446,22 @@ function resolveImportedModule(importerPath, specifier, root) {
   }
   const aliased = resolveProjectAliasSourcePath(specifier, root);
   if (aliased) return { path: aliased, local: true };
-  return { path: resolvePackageModuleSourcePath(importerPath, specifier, root), local: false };
+  const packagePath = resolvePackageModuleSourcePath(importerPath, specifier, root);
+  if (!packagePath) warnUnresolvedAliasImport(importerPath, specifier, root);
+  return { path: packagePath, local: false };
 }
 __name(resolveImportedModule, "resolveImportedModule");
+var warnedUnresolvedAliasImports = /* @__PURE__ */ new Set();
+var ALIAS_IMPORT = /^(?:@\/|~\/|#)/;
+function warnUnresolvedAliasImport(importerPath, specifier, root) {
+  if (!ALIAS_IMPORT.test(specifier) || warnedUnresolvedAliasImports.has(specifier)) return;
+  warnedUnresolvedAliasImports.add(specifier);
+  const importer = root ? path.relative(root, importerPath) : importerPath;
+  logger.warn(
+    `Could not resolve "${specifier}" (imported by ${importer}) while checking which pages need client JavaScript. If it holds client components, they will not hydrate. Map the alias in tsconfig.json "paths" or package.json "imports".`
+  );
+}
+__name(warnUnresolvedAliasImport, "warnUnresolvedAliasImport");
 var projectImportAliasCache = /* @__PURE__ */ new Map();
 var PROJECT_ALIAS_FILES = ["tsconfig.json", "jsconfig.json", "package.json"];
 function resolveProjectAliasSourcePath(specifier, root) {
@@ -4833,6 +4853,29 @@ var _ServerRenderer = class _ServerRenderer {
     );
     this.rendererRuntime = runtime;
     this.routeManager.setRendererRuntime?.(this.rendererRuntime);
+    await this.applyRendererAppSetup();
+  }
+  /**
+   * Pass the app's renderer setup module (`renderer.appSetup`) to the renderer. In development
+   * the module runner returns the cached module until the file changes, so an edit is
+   * re-applied on the next request without restarting.
+   */
+  async applyRendererAppSetup() {
+    const appSetupPath = resolveFarmRendererAppSetup(
+      this.config.root || process.cwd(),
+      this.config.renderer
+    );
+    if (!appSetupPath) return;
+    const configureApp = this.rendererRuntime.configureApp;
+    if (typeof configureApp !== "function") {
+      throw new Error(
+        `Renderer \`${this.config.renderer.name}\` does not support \`appSetup\`: its server module must export configureApp().`
+      );
+    }
+    const setupModule = this.viteServer ? await loadFarmDevModule(this.viteServer, appSetupPath) : await import(pathToFileURL2(appSetupPath).href);
+    if (setupModule === this.appliedAppSetupModule) return;
+    this.appliedAppSetupModule = setupModule;
+    configureApp(setupModule.default);
   }
   createPageBoundary(pageElement, options) {
     return this.rendererRuntime.createElement(
@@ -4949,6 +4992,7 @@ var _ServerRenderer = class _ServerRenderer {
    */
   async renderNavigationFragment(input) {
     await this.initialize();
+    if (this.viteServer) await this.applyRendererAppSetup();
     setFarmBasePath(this.config.basePath);
     setFarmTrailingSlashPreference(this.config.trailingSlash);
     let element = this.rendererRuntime.createElement(input.PageComponent, input.pageProps);
@@ -5274,6 +5318,7 @@ var _ServerRenderer = class _ServerRenderer {
   }
   async renderPage(req, res) {
     await this.initialize();
+    if (this.viteServer) await this.applyRendererAppSetup();
     setFarmBasePath(this.config.basePath);
     setFarmTrailingSlashPreference(this.config.trailingSlash);
     const cspNonce = createFarmCspNonce(this.security);
@@ -7377,6 +7422,121 @@ function createFarmApp(config, viteServer) {
 }
 __name(createFarmApp, "createFarmApp");
 
+// src/build/tailwind.ts
+import path11 from "path";
+
+// 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/build/tailwind.ts
+var TAILWIND_CSS_IMPORT = /@import\s+["']tailwindcss["']/;
+var TAILWIND_VITE_INSTALL_HINT = formatOptionalPeerInstallHint(
+  "@tailwindcss/vite",
+  "enable built-in Tailwind CSS support",
+  { dev: true }
+);
+var warnedMissingTailwind = false;
+async function loadTailwindVitePlugin(options = {}, importTailwind = () => import("@tailwindcss/vite")) {
+  try {
+    const tailwindVite = (await importTailwind()).default;
+    const plugin = options.builder ? adaptTailwindVitePlugin(tailwindVite(), options.builder) : tailwindVite();
+    if (options.announce) logger.info("\u{1F4E6} Enabled built-in Tailwind support (@tailwindcss/vite)");
+    return plugin;
+  } catch (error) {
+    if (isMissingPackageError(error, "@tailwindcss/vite")) return createMissingTailwindPlugin();
+    logger.warn(
+      `Tailwind plugin auto-enable failed${options.label ? ` ${options.label}` : ""}; continuing without it: ${error.message}`
+    );
+    return void 0;
+  }
+}
+__name(loadTailwindVitePlugin, "loadTailwindVitePlugin");
+function createMissingTailwindPlugin() {
+  let root = process.cwd();
+  return {
+    name: "farm:tailwind-missing",
+    enforce: "pre",
+    configResolved(config) {
+      root = config.root;
+    },
+    transform(code, id) {
+      if (warnedMissingTailwind || !/\.css(?:\?.*)?$/.test(id) || !TAILWIND_CSS_IMPORT.test(code)) {
+        return null;
+      }
+      warnedMissingTailwind = true;
+      const file = path11.relative(root, id.split("?", 1)[0]).replace(/\\/g, "/");
+      logger.warn(
+        `${file} imports Tailwind CSS, but @tailwindcss/vite is not installed; continuing without Tailwind. ${TAILWIND_VITE_INSTALL_HINT}`
+      );
+      return null;
+    }
+  };
+}
+__name(createMissingTailwindPlugin, "createMissingTailwindPlugin");
+
+// src/image-runtime.ts
+var SHARP_INSTALL_HINT = formatOptionalPeerInstallHint("sharp", "optimize images");
+var CLOUDFLARE_IMAGE_PRESETS = /* @__PURE__ */ new Set(["cloudflare", "cloudflare-pages", "cloudflare-module"]);
+function resolveFarmImageProviderForRuntime(images, options) {
+  const provider = images?.provider ?? "auto";
+  if (provider === "none") return images;
+  const usesSharp = options.dev ? true : provider === "node" || provider === "auto" && !CLOUDFLARE_IMAGE_PRESETS.has(options.preset || "");
+  if (!usesSharp || isOptionalPeerInstalled(options.root, "sharp")) return images;
+  if (provider === "node") {
+    throw new Error(
+      `images.provider "node" optimizes images with sharp, which is not installed. ${SHARP_INSTALL_HINT}`
+    );
+  }
+  logger.info(
+    `Image optimization is off because sharp is not installed; images use their original URLs. ${SHARP_INSTALL_HINT}, or set images.provider to "none".`
+  );
+  return Object.freeze({ ...images, provider: "none" });
+}
+__name(resolveFarmImageProviderForRuntime, "resolveFarmImageProviderForRuntime");
+
 // src/schema-step-types.ts
 function validateSchemaSteps(owner, schema, steps) {
   if (steps === void 0) return;
@@ -7463,8 +7623,8 @@ __name(validateSchemaSteps, "validateSchemaSteps");
 var _FarmPluginOptionsError = class _FarmPluginOptionsError extends TypeError {
   constructor(issues) {
     const lines = issues.map((issue) => {
-      const path17 = formatIssuePath(issue.path);
-      return `  - ${path17 ? `${path17}: ` : ""}${issue.message}`;
+      const path18 = formatIssuePath(issue.path);
+      return `  - ${path18 ? `${path18}: ` : ""}${issue.message}`;
     });
     super(`Invalid plugin options:
 ${lines.join("\n")}`);
@@ -7474,9 +7634,9 @@ ${lines.join("\n")}`);
 };
 __name(_FarmPluginOptionsError, "FarmPluginOptionsError");
 var FarmPluginOptionsError = _FarmPluginOptionsError;
-function formatIssuePath(path17) {
-  if (!path17?.length) return "";
-  return path17.map((segment) => {
+function formatIssuePath(path18) {
+  if (!path18?.length) return "";
+  return path18.map((segment) => {
     const key = typeof segment === "object" && segment !== null ? segment.key : segment;
     return typeof key === "symbol" ? key.toString() : String(key);
   }).join(".");
@@ -7712,23 +7872,23 @@ var _PluginManager = class _PluginManager {
             `Farm plugin "${plugin.name}" runtime.endpoints must contain endpoint objects`
           );
         }
-        const path17 = normalizeFarmPluginRuntimeEndpointPath(
+        const path18 = normalizeFarmPluginRuntimeEndpointPath(
           endpoint.path,
           `Farm plugin "${plugin.name}" runtime endpoint`
         );
         if (typeof endpoint.handler !== "function") {
           throw new TypeError(
-            `Farm plugin "${plugin.name}" runtime endpoint ${path17} requires a handler`
+            `Farm plugin "${plugin.name}" runtime endpoint ${path18} requires a handler`
           );
         }
-        const owner = owners.get(path17);
+        const owner = owners.get(path18);
         if (owner) {
           throw new Error(
-            `Farm plugin runtime endpoint ${path17} from "${plugin.name}" conflicts with "${owner}"`
+            `Farm plugin runtime endpoint ${path18} from "${plugin.name}" conflicts with "${owner}"`
           );
         }
-        owners.set(path17, plugin.name);
-        endpoints.push({ plugin, endpoint, path: path17 });
+        owners.set(path18, plugin.name);
+        endpoints.push({ plugin, endpoint, path: path18 });
       }
     }
     this.runtimeEndpoints = endpoints;
@@ -8402,7 +8562,7 @@ __name(declarePluginSchema, "declarePluginSchema");
 
 // src/client-plugin-build.ts
 import fs6 from "fs";
-import path11 from "path";
+import path12 from "path";
 var CLIENT_KEYS = [
   "public",
   "setup",
@@ -8416,9 +8576,9 @@ var HYDRATION_KEYS = ["before", "after"];
 var NAVIGATION_KEYS = ["before", "loaded", "resolved", "rendered", "error"];
 var APP_CLIENT_EXTENSIONS = ["ts", "tsx", "js", "jsx", "mts", "mjs"];
 function resolveFarmAppClientEntry(root = process.cwd(), srcDir = "src") {
-  const sourceRoot = path11.resolve(root, srcDir);
+  const sourceRoot = path12.resolve(root, srcDir);
   for (const extension of APP_CLIENT_EXTENSIONS) {
-    const candidate = path11.join(sourceRoot, `client.${extension}`);
+    const candidate = path12.join(sourceRoot, `client.${extension}`);
     if (fs6.existsSync(candidate) && fs6.statSync(candidate).isFile()) return candidate;
   }
   return void 0;
@@ -8672,7 +8832,7 @@ __name(isArrayIndex, "isArrayIndex");
 
 // src/client-cache-persistence-build.ts
 import fs7 from "fs";
-import path12 from "path";
+import path13 from "path";
 var ADAPTER_EXTENSIONS = ["ts", "tsx", "js", "jsx", "mts", "mjs"];
 function resolveFarmClientCacheAdapterEntry(root, cache) {
   const client = cache?.client;
@@ -8683,7 +8843,7 @@ function resolveFarmClientCacheAdapterEntry(root, cache) {
       'cache.client.adapter must be a module path string, for example "./src/cache-adapter".'
     );
   }
-  const resolved = path12.resolve(root, adapter);
+  const resolved = path13.resolve(root, adapter);
   const found = resolveAdapterFile(resolved);
   if (!found) {
     throw new Error(
@@ -8785,12 +8945,12 @@ function createFarmLayoutElement(Component, pattern, children, params) {
 
 // src/vite.ts
 import * as fs9 from "fs";
-import * as path16 from "path";
+import * as path17 from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 
 // src/dev-static.ts
 import * as fs8 from "fs";
-import * as path13 from "path";
+import * as path14 from "path";
 function shouldBypassFarmRouterForDottedPath(pathname, routeManager, baseDirs, generatedPaths = []) {
   if (!pathname.includes(".") || pathname.endsWith(".html")) return false;
   const matchesAppRoute = Boolean(
@@ -8837,9 +8997,9 @@ function devServableFileExists(pathname, baseDirs) {
   if (!relativePathname) return false;
   for (const baseDir of baseDirs) {
     if (typeof baseDir !== "string" || baseDir.length === 0) continue;
-    const resolvedBase = path13.resolve(baseDir);
-    const candidate = path13.resolve(resolvedBase, relativePathname);
-    if (!candidate.startsWith(resolvedBase + path13.sep)) continue;
+    const resolvedBase = path14.resolve(baseDir);
+    const candidate = path14.resolve(resolvedBase, relativePathname);
+    if (!candidate.startsWith(resolvedBase + path14.sep)) continue;
     try {
       if (fs8.existsSync(candidate) && fs8.statSync(candidate).isFile()) {
         return true;
@@ -8986,7 +9146,7 @@ __name(formatClientBoundaryWarning, "formatClientBoundaryWarning");
 
 // src/image-vite.ts
 import { readFile as readFile3 } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 import { imageSize as imageSize2 } from "image-size";
 var FARM_IMAGE_ID_PREFIX = "\0farm:image:";
 var STATIC_IMAGE_RE = /\.(?:avif|gif|jpe?g|png|webp)$/i;
@@ -9054,7 +9214,7 @@ async function createBlurDataURL(bytes) {
 __name(createBlurDataURL, "createBlurDataURL");
 
 // src/server/vite-config.ts
-import path15 from "path";
+import path16 from "path";
 var FARM_CLIENT_ENTRY_PATTERN = "**/{page,layout,loading,error,not-found,default}.{js,jsx,ts,tsx}";
 var FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE = [
   "react",
@@ -9078,9 +9238,9 @@ function getFarmClientOptimizeDepsInclude(renderer) {
 }
 __name(getFarmClientOptimizeDepsInclude, "getFarmClientOptimizeDepsInclude");
 function createFarmClientOptimizeDepsEntries(projectRoot, appDirectories) {
-  const resolvedProjectRoot = path15.resolve(projectRoot);
+  const resolvedProjectRoot = path16.resolve(projectRoot);
   return appDirectories.map((appDirectory) => {
-    const relativeAppDirectory = path15.relative(resolvedProjectRoot, path15.resolve(appDirectory)).replace(/\\/g, "/");
+    const relativeAppDirectory = path16.relative(resolvedProjectRoot, path16.resolve(appDirectory)).replace(/\\/g, "/");
     const prefix = relativeAppDirectory || ".";
     return `${prefix}/${FARM_CLIENT_ENTRY_PATTERN}`;
   });
@@ -9104,7 +9264,7 @@ function createFarmClientOptimizeDepsConfig(entries, renderer) {
 __name(createFarmClientOptimizeDepsConfig, "createFarmClientOptimizeDepsConfig");
 function createFarmSourceAlias(projectRoot, srcDir = "src") {
   return {
-    "@": path15.resolve(projectRoot, srcDir)
+    "@": path16.resolve(projectRoot, srcDir)
   };
 }
 __name(createFarmSourceAlias, "createFarmSourceAlias");
@@ -9300,6 +9460,7 @@ function reportOpenAPIDevGenerationResult(spec, output = logger) {
 __name(reportOpenAPIDevGenerationResult, "reportOpenAPIDevGenerationResult");
 
 // src/vite.ts
+var SERVER_FN_TRANSFORM_PLUGIN = "@farm.js/plugin/rsc:server-fn-actions";
 function farmLlmsTxtGeneratedPaths(config) {
   const llms = resolveFarmLlmsTxtConfig(config.agent?.llmsTxt);
   if (!llms.enabled) return [];
@@ -9345,7 +9506,7 @@ function loadFarmDocsSearchDevRuntime() {
 }
 __name(loadFarmDocsSearchDevRuntime, "loadFarmDocsSearchDevRuntime");
 function loadFarmOpenAPIDevRuntime() {
-  return import("./manager-NPG43N46.mjs");
+  return import("./manager-RT733VRK.mjs");
 }
 __name(loadFarmOpenAPIDevRuntime, "loadFarmOpenAPIDevRuntime");
 function loadFarmWorkflowsDevRuntime() {
@@ -9353,7 +9514,7 @@ function loadFarmWorkflowsDevRuntime() {
 }
 __name(loadFarmWorkflowsDevRuntime, "loadFarmWorkflowsDevRuntime");
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-MTB5SA2B.mjs");
+  return import("./devtools-OY4SNU3P.mjs");
 }
 __name(loadFarmDevtoolsSnapshotRuntime, "loadFarmDevtoolsSnapshotRuntime");
 function loadFarmDevtoolsUIRuntime() {
@@ -9383,14 +9544,29 @@ function farmI18nClientBridgePlugin() {
 __name(farmI18nClientBridgePlugin, "farmI18nClientBridgePlugin");
 var FARM_SERVER_ONLY_ENTRIES = /* @__PURE__ */ new Set(["@farm.js/core/og"]);
 function farmServerOnlyEntriesPlugin() {
+  let root = process.cwd();
+  let vercelOgInstalled = false;
   return {
     name: "farm:server-only-entries",
     enforce: "pre",
+    configResolved(config) {
+      root = config.root;
+    },
     resolveId(id, importer, options) {
-      if (options?.ssr || !FARM_SERVER_ONLY_ENTRIES.has(id)) return null;
-      this.error(
-        `${id} is server-only and cannot be imported into client code${importer ? ` (imported by ${importer})` : ""}. Use it from an API route or another server module.`
-      );
+      if (!FARM_SERVER_ONLY_ENTRIES.has(id)) return null;
+      const importedBy = importer ? ` (imported by ${importer})` : "";
+      if (!options?.ssr) {
+        this.error(
+          `${id} is server-only and cannot be imported into client code${importedBy}. Use it from an API route or another server module.`
+        );
+      }
+      vercelOgInstalled || (vercelOgInstalled = isOptionalPeerInstalled(root, "@vercel/og"));
+      if (!vercelOgInstalled) {
+        this.error(
+          `${id} needs @vercel/og, which is not installed${importedBy}. ${VERCEL_OG_INSTALL_HINT}`
+        );
+      }
+      return null;
     }
   };
 }
@@ -9761,7 +9937,7 @@ function fileContainsProgrammaticPageRoute(file) {
 __name(fileContainsProgrammaticPageRoute, "fileContainsProgrammaticPageRoute");
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path16.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path17.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -9781,7 +9957,7 @@ function rewriteEarlySsrRelativeImports(options) {
     const suffixIndex = source.value.search(/[?#]/);
     const sourcePath = suffixIndex === -1 ? source.value : source.value.slice(0, suffixIndex);
     const suffix = suffixIndex === -1 ? "" : source.value.slice(suffixIndex);
-    const resolvedPath = path16.resolve(path16.dirname(cleanId), sourcePath);
+    const resolvedPath = path17.resolve(path17.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -9941,6 +10117,7 @@ function farmPlugin(options = {}, initialPluginManager) {
     publicDir: options.publicDir
   });
   let farmApp;
+  let serverFnTransformActive = false;
   let server;
   let apiRouteManager;
   let openAPIManager = null;
@@ -9979,7 +10156,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...layerRoots.length ? {
           server: {
             fs: {
-              allow: [path16.resolve(options.root || process.cwd()), ...layerRoots]
+              allow: [path17.resolve(options.root || process.cwd()), ...layerRoots]
             }
           }
         } : {}
@@ -9989,6 +10166,14 @@ function farmPlugin(options = {}, initialPluginManager) {
       if (typeof fontImports.configResolved === "function") {
         await fontImports.configResolved.call(this, config);
       }
+      serverFnTransformActive = config.plugins.some(
+        (plugin) => plugin.name === SERVER_FN_TRANSFORM_PLUGIN
+      );
+      if (options.experimental?.serverActions === true && !serverFnTransformActive) {
+        logger.warn(
+          "experimental.serverActions has no effect without @farm.js/plugin/rsc in the Vite plugins. Server functions stay server-only, and importing one from client code is a build error."
+        );
+      }
     },
     async configureServer(viteServer) {
       if (typeof fontImports.configureServer === "function") {
@@ -10022,6 +10207,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }
       const apiServerBasePath = resolveFarmAPIServerBasePath(farmConfig.api);
       const serverConfig = resolveFarmServerConfig(farmConfig.server);
+      globalThis.__FARM_IMAGE_CONFIG__ = getPublicFarmImageConfig(farmConfig.images);
       let imageHandler = null;
       if (farmConfig.images.provider !== "none") {
         const { createNodeImageFetcher, createNodeImageUrlValidator, createSharpImageTransformer } = await import("./image/sharp.mjs");
@@ -10040,7 +10226,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path16.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path17.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
           farmConfig.i18n.locales.map(
@@ -10055,7 +10241,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path16.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path17.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -10096,7 +10282,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path16.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path17.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -10235,7 +10421,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       await apiRouteManager.discoverRoutes();
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs9.existsSync(path16.isAbsolute(dir) ? dir : path16.join(farmConfig.root, dir))
+        (dir) => fs9.existsSync(path17.isAbsolute(dir) ? dir : path17.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler, discoverFarmWorkflows } = await loadFarmWorkflowsDevRuntime();
@@ -11688,7 +11874,7 @@ export const manifest = getManifest();
     async transform(code, id, transformOptions) {
       if (!transformOptions?.ssr) {
         const currentConfig = farmApp?.getConfig() ?? options;
-        if (currentConfig.experimental?.serverActions !== true) {
+        if (currentConfig.experimental?.serverActions !== true || !serverFnTransformActive) {
           const violation = findClientServerFnViolation(code, id);
           if (violation) {
             this.error(formatServerFnBoundaryError(violation, id));
@@ -11742,7 +11928,7 @@ export const manifest = getManifest();
         const root = currentConfig.root || server?.config.root || process.cwd();
         const cleanId = id.split("?", 1)[0];
         const selectedIsolatedModules = options.isolatedClientBoundaryModules ?? farmApp?.getRouteManager().getIsolatedClientBoundaryModules(root);
-        const selectedForIsolatedHydration = selectedIsolatedModules?.has(path16.resolve(cleanId)) === true;
+        const selectedForIsolatedHydration = selectedIsolatedModules?.has(path17.resolve(cleanId)) === true;
         if (isReactRenderer(resolveFarmRenderer(currentConfig.renderer)) && selectedForIsolatedHydration && isIsolatableClientBoundarySource(clientBoundarySource)) {
           isolatedModuleReference = toViteModuleId(cleanId, root);
           const transformedBoundary = transformIsolatedClientBoundaryModule({
@@ -11833,8 +12019,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path16.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path16.join(outDir, "client");
+        const outDir = path17.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path17.join(outDir, "client");
         for (const page of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page.urlPath, "http://farm.static"));
@@ -11886,8 +12072,8 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page.urlPath === "/" ? path16.join(clientDir, "index.html") : path16.join(clientDir, page.urlPath + ".html");
-              fs9.mkdirSync(path16.dirname(outputPath), { recursive: true });
+              const outputPath = page.urlPath === "/" ? path17.join(clientDir, "index.html") : path17.join(clientDir, page.urlPath + ".html");
+              fs9.mkdirSync(path17.dirname(outputPath), { recursive: true });
               fs9.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page.revalidate ? ` (revalidate: ${page.revalidate}s)` : "";
               logger.success(`  \u2713 ${page.urlPath}${revalidateInfo}`);
@@ -11896,7 +12082,7 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path16.join(outDir, "__ssg_manifest.json");
+        const manifestPath = path17.join(outDir, "__ssg_manifest.json");
         fs9.writeFileSync(
           manifestPath,
           JSON.stringify(
@@ -11940,9 +12126,9 @@ if (import.meta.hot) {
         server2.ws.send({ type: "full-reload", path: "*" });
         return [];
       }
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path16.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path17.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path16.basename(file)}`);
+        logUpdate("PAGE", `updated ${path17.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -12073,10 +12259,10 @@ function createPageDataMiddlewareRequest(req, target) {
 __name(createPageDataMiddlewareRequest, "createPageDataMiddlewareRequest");
 function resolveDevelopmentRoot(farmRoot, viteRoot) {
   if (!farmRoot) return viteRoot;
-  if (path16.resolve(farmRoot) === path16.resolve(viteRoot)) return farmRoot;
+  if (path17.resolve(farmRoot) === path17.resolve(viteRoot)) return farmRoot;
   try {
     if (fs9.realpathSync(farmRoot) === fs9.realpathSync(viteRoot)) {
-      return path16.resolve(viteRoot);
+      return path17.resolve(viteRoot);
     }
   } catch {
   }
@@ -12436,8 +12622,11 @@ function generateClientCode(integrationProviders = [], documentNavigationMatcher
     srcDir,
     publicRuntimeConfig
   );
+  const appSetupPath = resolveFarmRendererAppSetup(root, renderer);
   const rendererClientImports = isReactRenderer(renderer) ? `import React from 'react'
-import { hydrateRoot, createRoot } from 'react-dom/client'` : `import React, { hydrateRoot, createRoot } from ${JSON.stringify(renderer.client)}`;
+import { hydrateRoot, createRoot } from 'react-dom/client'` : appSetupPath ? `import React, { hydrateRoot, createRoot, configureApp as __farmConfigureApp } from ${JSON.stringify(renderer.client)}
+import __farmAppSetup from ${JSON.stringify(toViteModuleId(appSetupPath, root))}
+__farmConfigureApp(__farmAppSetup)` : `import React, { hydrateRoot, createRoot } from ${JSON.stringify(renderer.client)}`;
   const isolatedHydrationImport = isolatedHydrationEnabled ? `import { createFarmIsolatedHydrationRuntime, createFarmServerPageBoundary, wrapFarmIsolatedClientGraph } from '@farm.js/core/internal/isolated-boundary'` : "";
   const docsAdapterImportBlock = generateFarmDocsAdapterClientRuntime(
     docsAdapterReact,
@@ -13994,10 +14183,10 @@ function generateClientManifest(bundle) {
 }
 __name(generateClientManifest, "generateClientManifest");
 async function defineConfig(config = {}) {
-  const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const appRoot = path16.resolve(config.root || process.cwd());
+  const tailwindVitePlugin = await loadTailwindVitePlugin();
+  const appRoot = path17.resolve(config.root || process.cwd());
   if (config.extends?.length) {
-    const { config: layeredConfig } = await import("./layers-CJKSJGLN.mjs").then(
+    const { config: layeredConfig } = await import("./layers-BRQF5ETU.mjs").then(
       ({ resolveFarmLayers }) => resolveFarmLayers(config, {
         root: appRoot,
         mode: process.env.NODE_ENV === "production" ? "production" : "development"
@@ -14006,6 +14195,7 @@ async function defineConfig(config = {}) {
     config = layeredConfig;
   }
   config.renderer = resolveFarmRenderer(config.renderer);
+  config.images = resolveFarmImageProviderForRuntime(config.images, { root: appRoot, dev: true });
   const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, appRoot, {
     ssr: true
   });
@@ -14135,7 +14325,7 @@ async function defineConfig(config = {}) {
   return {
     plugins: [
       createFarmThemeCssPlugin(config.theme, config.basePath),
-      tailwindcss(),
+      tailwindVitePlugin,
       ...rendererVitePlugins,
       viteBrowserExternalPlugin,
       farmI18nClientBridgePlugin(),
@@ -14231,6 +14421,9 @@ export {
   createFarmApp,
   FarmPluginOptionsError,
   farmPluginMayAffectRuntimePath,
+  loadTailwindVitePlugin,
+  SHARP_INSTALL_HINT,
+  resolveFarmImageProviderForRuntime,
   generateFarmClientPluginEntryCode,
   resolveFarmClientCacheAdapterEntry,
   generateClientCachePersistenceCode,