@farm.js/core 0.1.21 → 0.1.22

package/dist/{app-D_6nTit-.d.mts → app-0e-oTC_R.d.mts}

@@ -315,9 +315,16 @@ declare class ServerRenderer {
     private i18nRuntime?;
     private viteServer?;
     private rendererRuntime;
+    private appliedAppSetupModule;
     private security;
     constructor(config: Required<FarmConfig>, routeManager: RouteManager, i18nRuntime?: FarmI18nRuntime, viteServer?: ViteDevServer);
     initialize(): Promise<void>;
+    /**
+     * 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.
+     */
+    private applyRendererAppSetup;
     private createPageBoundary;
     private devGlobalStylesheetHref;
     private devGlobalStylesheetLink;

package/dist/{app-DAyPE-gr.d.ts → app-B7qKw8Ny.d.ts}

@@ -315,9 +315,16 @@ declare class ServerRenderer {
     private i18nRuntime?;
     private viteServer?;
     private rendererRuntime;
+    private appliedAppSetupModule;
     private security;
     constructor(config: Required<FarmConfig>, routeManager: RouteManager, i18nRuntime?: FarmI18nRuntime, viteServer?: ViteDevServer);
     initialize(): Promise<void>;
+    /**
+     * 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.
+     */
+    private applyRendererAppSetup;
     private createPageBoundary;
     private devGlobalStylesheetHref;
     private devGlobalStylesheetLink;

package/dist/{chunk-Q2TUENW2.cjs → chunk-2HCEC2YO.cjs}

@@ -1,5 +1,5 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true});// package.json
-var version = "0.1.21";
+var version = "0.1.22";
 
 // src/version.ts
 var FARM_VERSION = version;

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

@@ -6,7 +6,7 @@ import {
   parseRouteSlotFile,
   resolveRouteRenderingConfig,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-NRS46D4L.mjs";
+} from "./chunk-GKT4ONKN.mjs";
 import {
   collectSchemaExtensions,
   declareSchemaTables,
@@ -86,8 +86,9 @@ import {
   readFarmRendererWebStream,
   resolveFarmComponentExtensions,
   resolveFarmRenderer,
+  resolveFarmRendererAppSetup,
   resolveFarmRendererModule
-} from "./chunk-OLYK7EAK.mjs";
+} from "./chunk-DAATZTKJ.mjs";
 import {
   FARM_PREVIEW_ROBOTS_TAG,
   addFarmCspNonceToScriptTags,
@@ -264,7 +265,7 @@ import {
 } from "./chunk-Z2RZJZIZ.mjs";
 import {
   FARM_VERSION
-} from "./chunk-PKO4FCTL.mjs";
+} from "./chunk-X2ZUD4GI.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -1439,9 +1440,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 +4847,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 +4986,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 +5312,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 +7416,115 @@ function createFarmApp(config, viteServer) {
 }
 __name(createFarmApp, "createFarmApp");
 
+// src/build/tailwind.ts
+import path11 from "path";
+
+// src/optional-peer.ts
+function isMissingPackageError(error, packageName) {
+  if (!error || typeof error !== "object") return false;
+  const { code, message } = error;
+  if (code !== "ERR_MODULE_NOT_FOUND" && code !== "MODULE_NOT_FOUND") return false;
+  if (typeof message !== "string") return false;
+  return message.includes(`'${packageName}'`) || message.includes(`"${packageName}"`);
+}
+__name(isMissingPackageError, "isMissingPackageError");
+function formatOptionalPeerInstallHint(packageName, purpose, options = {}) {
+  return `Install "${packageName}" to ${purpose}: pnpm add ${options.dev ? "-D " : ""}${packageName}`;
+}
+__name(formatOptionalPeerInstallHint, "formatOptionalPeerInstallHint");
+
+// 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/schema-step-types.ts
 function validateSchemaSteps(owner, schema, steps) {
   if (steps === void 0) return;
@@ -7463,8 +7611,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 +7622,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 +7860,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 +8550,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 +8564,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 +8820,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 +8831,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 +8933,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 +8985,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 +9134,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 +9202,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 +9226,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 +9252,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 +9448,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 [];
@@ -9353,7 +9502,7 @@ function loadFarmWorkflowsDevRuntime() {
 }
 __name(loadFarmWorkflowsDevRuntime, "loadFarmWorkflowsDevRuntime");
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-MTB5SA2B.mjs");
+  return import("./devtools-EZ5ORGAK.mjs");
 }
 __name(loadFarmDevtoolsSnapshotRuntime, "loadFarmDevtoolsSnapshotRuntime");
 function loadFarmDevtoolsUIRuntime() {
@@ -9761,7 +9910,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 +9930,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 +10090,7 @@ function farmPlugin(options = {}, initialPluginManager) {
     publicDir: options.publicDir
   });
   let farmApp;
+  let serverFnTransformActive = false;
   let server;
   let apiRouteManager;
   let openAPIManager = null;
@@ -9979,7 +10129,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 +10139,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") {
@@ -10040,7 +10198,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 +10213,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 +10254,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 +10393,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 +11846,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 +11900,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 +11991,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 +12044,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 +12054,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 +12098,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 +12231,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 +12594,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,8 +14155,8 @@ 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(
       ({ resolveFarmLayers }) => resolveFarmLayers(config, {
@@ -14135,7 +14296,7 @@ async function defineConfig(config = {}) {
   return {
     plugins: [
       createFarmThemeCssPlugin(config.theme, config.basePath),
-      tailwindcss(),
+      tailwindVitePlugin,
       ...rendererVitePlugins,
       viteBrowserExternalPlugin,
       farmI18nClientBridgePlugin(),
@@ -14231,6 +14392,7 @@ export {
   createFarmApp,
   FarmPluginOptionsError,
   farmPluginMayAffectRuntimePath,
+  loadTailwindVitePlugin,
   generateFarmClientPluginEntryCode,
   resolveFarmClientCacheAdapterEntry,
   generateClientCachePersistenceCode,

package/dist/{chunk-OLYK7EAK.mjs → chunk-DAATZTKJ.mjs}

@@ -3,6 +3,7 @@ import {
 } from "./chunk-LPEX4YW6.mjs";
 
 // src/renderer.ts
+import fs from "fs";
 import { createRequire } from "module";
 import path from "path";
 import { pathToFileURL } from "url";
@@ -128,6 +129,9 @@ function resolveFarmRenderer(renderer) {
       throw new TypeError(`Farm renderer \`${field}\` must be a non-empty string.`);
     }
   }
+  if (resolved.appSetup !== void 0 && (typeof resolved.appSetup !== "string" || resolved.appSetup.trim().length === 0)) {
+    throw new TypeError("Farm renderer `appSetup` must be a non-empty module path.");
+  }
   return {
     ...resolved,
     componentExtensions: [...resolved.componentExtensions || []],
@@ -155,6 +159,15 @@ function isReactRenderer(renderer) {
   return !renderer || renderer.name === "react";
 }
 __name(isReactRenderer, "isReactRenderer");
+function resolveFarmRendererAppSetup(root, renderer) {
+  if (!renderer.appSetup) return null;
+  const filePath = path.resolve(root, renderer.appSetup);
+  if (!fs.existsSync(filePath)) {
+    throw new Error(`Renderer \`${renderer.name}\` app setup module was not found: ${filePath}`);
+  }
+  return filePath;
+}
+__name(resolveFarmRendererAppSetup, "resolveFarmRendererAppSetup");
 function resolveFarmRendererModule(root, specifier) {
   const requireFromApp = createRequire(path.join(path.resolve(root), "package.json"));
   return requireFromApp.resolve(specifier);
@@ -201,6 +214,7 @@ export {
   resolveFarmRenderer,
   readFarmRendererWebStream,
   isReactRenderer,
+  resolveFarmRendererAppSetup,
   resolveFarmRendererModule,
   loadFarmRendererVitePlugins
 };