@farm.js/core 0.1.0-beta.22 → 0.1.0-beta.24

package/dist/internal/build-runtime.cjs

@@ -283,11 +283,11 @@ function resolveFarmServerHealthConfig(config) {
   return Object.freeze({ enabled: true, livenessPath, readinessPath });
 }
 function normalizeHealthPath(value, optionName) {
-  const path31 = value.trim();
-  if (!path31.startsWith("/") || path31.includes("?") || path31.includes("#") || path31.includes("*")) {
+  const path32 = value.trim();
+  if (!path32.startsWith("/") || path32.includes("?") || path32.includes("#") || path32.includes("*")) {
     throw new TypeError(`${optionName} must be an absolute pathname without a query or wildcard`);
   }
-  return path31.length > 1 ? path31.replace(/\/+$/, "") || "/" : path31;
+  return path32.length > 1 ? path32.replace(/\/+$/, "") || "/" : path32;
 }
 function parseBodySizeLimit(value, optionName = "bodySizeLimit") {
   if (typeof value === "number") {
@@ -384,7 +384,7 @@ async function readNodeRequestBody(request, limit) {
     request.resume?.();
     throw error;
   }
-  return await new Promise((resolve6, reject) => {
+  return await new Promise((resolve7, reject) => {
     const chunks = [];
     let total = 0;
     let settled = false;
@@ -413,7 +413,7 @@ async function readNodeRequestBody(request, limit) {
       if (settled) return;
       settled = true;
       cleanup();
-      resolve6(Buffer.concat(chunks, total));
+      resolve7(Buffer.concat(chunks, total));
     }, "onEnd");
     const onError = /* @__PURE__ */ __name((error) => rejectOnce(error), "onError");
     request.on("data", onData);
@@ -1086,9 +1086,9 @@ function getFarmIntegrationPluginOwner(plugin) {
   const value = plugin[FARM_INTEGRATION_PLUGIN_OWNER];
   return value && typeof value === "object" ? value : void 0;
 }
-function defineTypedIntegrationRoute(method, path31, input) {
+function defineTypedIntegrationRoute(method, path32, input) {
   return {
-    path: path31,
+    path: path32,
     method,
     middleware: input.middleware,
     before: input.before,
@@ -1098,7 +1098,7 @@ function defineTypedIntegrationRoute(method, path31, input) {
     input: normalizeIntegrationRouteInputSchemas(input),
     handler: input.handler,
     __operation: defineIntegrationAPIOperation({
-      path: path31,
+      path: path32,
       method,
       bodyFormat: input.bodyFormat,
       responseFormat: input.responseFormat,
@@ -1110,52 +1110,52 @@ function defineTypedIntegrationRoute(method, path31, input) {
 }
 function createIntegrationRouteFactory() {
   return {
-    get(path31, input) {
+    get(path32, input) {
       return defineTypedIntegrationRoute(
         "GET",
-        path31,
+        path32,
         input
       );
     },
-    post(path31, input) {
+    post(path32, input) {
       return defineTypedIntegrationRoute(
         "POST",
-        path31,
+        path32,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    put(path31, input) {
+    put(path32, input) {
       return defineTypedIntegrationRoute(
         "PUT",
-        path31,
+        path32,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    patch(path31, input) {
-      return defineTypedIntegrationRoute("PATCH", path31, {
+    patch(path32, input) {
+      return defineTypedIntegrationRoute("PATCH", path32, {
         bodyFormat: "json",
         ...input
       });
     },
-    delete(path31, input) {
-      return defineTypedIntegrationRoute("DELETE", path31, {
+    delete(path32, input) {
+      return defineTypedIntegrationRoute("DELETE", path32, {
         bodyFormat: "json",
         ...input
       });
     },
-    options(path31, input) {
-      return defineTypedIntegrationRoute("OPTIONS", path31, input);
+    options(path32, input) {
+      return defineTypedIntegrationRoute("OPTIONS", path32, input);
     },
-    head(path31, input) {
+    head(path32, input) {
       return defineTypedIntegrationRoute(
         "HEAD",
-        path31,
+        path32,
         input
       );
     }
@@ -1429,8 +1429,8 @@ async function parseIntegrationConfigSchema(integration, schema, value) {
 function createIntegrationConfigValidationError(integration, error) {
   const issues = Array.isArray(error.issues) && error.issues.length > 0 ? error.issues.map((issue) => {
     const normalizedPath = normalizeIntegrationValidationPath(issue.path);
-    const path31 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
-    return `${path31}${issue.message || "Invalid config"}`;
+    const path32 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
+    return `${path32}${issue.message || "Invalid config"}`;
   }).join("; ") : error.message || "Invalid config";
   return new Error(`Integration "${integration.type}" config validation failed: ${issues}`);
 }
@@ -2127,8 +2127,8 @@ function normalizeIntegrationValidationIssues(source, error) {
     }
   ];
 }
-function normalizeIntegrationValidationPath(path31) {
-  return (path31 || []).map((segment) => {
+function normalizeIntegrationValidationPath(path32) {
+  return (path32 || []).map((segment) => {
     const key = typeof segment === "object" && segment !== null && "key" in segment ? segment.key : segment;
     return typeof key === "symbol" ? key.description || key.toString() : key;
   });
@@ -3341,22 +3341,22 @@ async function prepareFarmWorkflowsForNitro(config) {
   }
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
-  const fs8 = await import("fs/promises");
-  const path31 = await import("path");
-  const generatedDir = path31.join(root, distDir, ".nitro", "farm-workflows");
-  await fs8.mkdir(generatedDir, { recursive: true });
+  const fs9 = await import("fs/promises");
+  const path32 = await import("path");
+  const generatedDir = path32.join(root, distDir, ".nitro", "farm-workflows");
+  await fs9.mkdir(generatedDir, { recursive: true });
   const tasks = {};
   const scheduledTasks = createScheduledTasks(workflows);
   for (const workflow of workflows) {
-    const wrapperPath = path31.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
-    await fs8.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
+    const wrapperPath = path32.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
+    await fs9.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
     tasks[workflow.id] = {
       handler: wrapperPath,
       description: workflow.description || `Farm workflow ${workflow.id}`
     };
   }
-  const handlerPath = path31.join(generatedDir, "http-handler.mjs");
-  await fs8.writeFile(
+  const handlerPath = path32.join(generatedDir, "http-handler.mjs");
+  await fs9.writeFile(
     handlerPath,
     createNitroWorkflowHTTPHandler(
       workflowConfig,
@@ -3365,8 +3365,8 @@ async function prepareFarmWorkflowsForNitro(config) {
     ),
     "utf8"
   );
-  const manifestPath = path31.join(generatedDir, "manifest.json");
-  await fs8.writeFile(
+  const manifestPath = path32.join(generatedDir, "manifest.json");
+  await fs9.writeFile(
     manifestPath,
     JSON.stringify(
       {
@@ -3447,22 +3447,22 @@ function resolveWorkflowDefinition(module2) {
   return null;
 }
 async function findWorkflowFiles(root, dirs) {
-  const fs8 = await import("fs/promises");
-  const path31 = await import("path");
+  const fs9 = await import("fs/promises");
+  const path32 = await import("path");
   const files = [];
   for (const dir of dirs) {
-    const absoluteDir = path31.isAbsolute(dir) ? dir : path31.join(root, dir);
+    const absoluteDir = path32.isAbsolute(dir) ? dir : path32.join(root, dir);
     if (!await pathExists(absoluteDir)) continue;
     await walkWorkflowDir(absoluteDir, files);
   }
   return files.sort();
 }
 async function walkWorkflowDir(dir, files) {
-  const fs8 = await import("fs/promises");
-  const path31 = await import("path");
-  const entries = await fs8.readdir(dir, { withFileTypes: true });
+  const fs9 = await import("fs/promises");
+  const path32 = await import("path");
+  const entries = await fs9.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const filePath = path31.join(dir, entry.name);
+    const filePath = path32.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
       await walkWorkflowDir(filePath, files);
@@ -3474,20 +3474,20 @@ async function walkWorkflowDir(dir, files) {
   }
 }
 async function pathExists(filePath) {
-  const fs8 = await import("fs/promises");
-  return fs8.access(filePath).then(() => true).catch(() => false);
+  const fs9 = await import("fs/promises");
+  return fs9.access(filePath).then(() => true).catch(() => false);
 }
 function isWorkflowFile(fileName) {
   return /\.(?:ts|tsx|js|jsx|mjs|cjs)$/.test(fileName) && !/\.d\.[cm]?ts$/.test(fileName);
 }
 async function loadWorkflowModule(filePath, root) {
-  const fs8 = await import("fs/promises");
-  const path31 = await import("path");
+  const fs9 = await import("fs/promises");
+  const path32 = await import("path");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const { build: build2 } = await import("esbuild");
-  const outDir = path31.join(root, ".farm", ".workflow-loader");
-  await fs8.mkdir(outDir, { recursive: true });
-  const outfile = path31.join(
+  const outDir = path32.join(root, ".farm", ".workflow-loader");
+  await fs9.mkdir(outDir, { recursive: true });
+  const outfile = path32.join(
     outDir,
     `workflow-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
   );
@@ -3511,7 +3511,7 @@ async function loadWorkflowModule(filePath, root) {
       `${pathToFileURL5(outfile).href}?t=${Date.now()}`
     );
   } finally {
-    await fs8.unlink(outfile).catch(() => void 0);
+    await fs9.unlink(outfile).catch(() => void 0);
   }
 }
 function workflowIdFromFile(root, filePath) {
@@ -3781,14 +3781,14 @@ async function prepareFarmCronForNitro(config) {
   const cron = isResolvedCronConfig(config.cron) ? config.cron : resolveCronConfig(config.cron);
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
-  const fs8 = await import("fs/promises");
-  const path31 = await import("path");
-  const manifestPath = path31.join(root, distDir, FARM_CRON_MANIFEST);
-  const generatedDir = path31.join(root, distDir, ".nitro", "farm-cron");
+  const fs9 = await import("fs/promises");
+  const path32 = await import("path");
+  const manifestPath = path32.join(root, distDir, FARM_CRON_MANIFEST);
+  const generatedDir = path32.join(root, distDir, ".nitro", "farm-cron");
   if (!cron.enabled) {
     await Promise.all([
-      fs8.rm(manifestPath, { force: true }),
-      fs8.rm(generatedDir, { recursive: true, force: true })
+      fs9.rm(manifestPath, { force: true }),
+      fs9.rm(generatedDir, { recursive: true, force: true })
     ]);
     return {
       jobs: [],
@@ -3796,21 +3796,21 @@ async function prepareFarmCronForNitro(config) {
       scheduledTasks: {}
     };
   }
-  await fs8.rm(generatedDir, { recursive: true, force: true });
-  await fs8.mkdir(generatedDir, { recursive: true });
+  await fs9.rm(generatedDir, { recursive: true, force: true });
+  await fs9.mkdir(generatedDir, { recursive: true });
   const tasks = {};
   for (const job of cron.jobs) {
     const taskName = getFarmCronTaskName(job.name);
-    const wrapperPath = path31.join(generatedDir, `${safeFileName2(job.name)}.mjs`);
-    await fs8.writeFile(wrapperPath, createNitroCronTaskWrapper(job, cron.secretEnv), "utf8");
+    const wrapperPath = path32.join(generatedDir, `${safeFileName2(job.name)}.mjs`);
+    await fs9.writeFile(wrapperPath, createNitroCronTaskWrapper(job, cron.secretEnv), "utf8");
     tasks[taskName] = {
       handler: wrapperPath,
       description: job.description || `Farm cron ${job.name}`
     };
   }
   const manifest = createFarmCronManifest(cron);
-  await fs8.mkdir(path31.dirname(manifestPath), { recursive: true });
-  await fs8.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+  await fs9.mkdir(path32.dirname(manifestPath), { recursive: true });
+  await fs9.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `, "utf8");
   return {
     jobs: cron.jobs,
@@ -3891,7 +3891,7 @@ function normalizeCronJob(name, job) {
   if (!job || typeof job !== "object" || Array.isArray(job)) {
     throw new TypeError(`Farm cron ${JSON.stringify(name)} must be a configuration object.`);
   }
-  const path31 = normalizeCronPath(name, job.path);
+  const path32 = normalizeCronPath(name, job.path);
   const rawSchedule = Array.isArray(job.schedule) ? job.schedule : [job.schedule];
   const schedule = [...new Set(rawSchedule.map((value) => normalizeCronExpression(name, value)))];
   if (schedule.length === 0) {
@@ -3900,7 +3900,7 @@ function normalizeCronJob(name, job) {
   return {
     name,
     schedule,
-    path: path31,
+    path: path32,
     description: job.description?.trim() || void 0
   };
 }
@@ -3908,13 +3908,13 @@ function normalizeCronPath(name, value) {
   if (typeof value !== "string" || !value.trim().startsWith("/")) {
     throw new TypeError(`Farm cron ${JSON.stringify(name)} path must start with "/".`);
   }
-  const path31 = value.trim();
-  if (path31.startsWith("//") || path31.includes("?") || path31.includes("#")) {
+  const path32 = value.trim();
+  if (path32.startsWith("//") || path32.includes("?") || path32.includes("#")) {
     throw new TypeError(
       `Farm cron ${JSON.stringify(name)} path must be an application pathname without a host, query, or hash.`
     );
   }
-  return path31.length > 1 ? path31.replace(/\/+$/, "") : path31;
+  return path32.length > 1 ? path32.replace(/\/+$/, "") : path32;
 }
 function normalizeCronExpression(name, value) {
   if (typeof value !== "string") {
@@ -5298,8 +5298,8 @@ function createFarmDeploymentMismatchResponse(mismatch) {
     }
   );
 }
-function createFarmDeploymentCookie(deploymentId, path31 = "/", secure = false) {
-  const normalizedPath = path31.startsWith("/") ? path31 : `/${path31}`;
+function createFarmDeploymentCookie(deploymentId, path32 = "/", secure = false) {
+  const normalizedPath = path32.startsWith("/") ? path32 : `/${path32}`;
   return [
     `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,
     `Path=${normalizedPath}`,
@@ -5371,7 +5371,7 @@ var init_devtools_config = __esm({
 
 // src/image-config.ts
 function resolveFarmImageConfig(config) {
-  const path31 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
+  const path32 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
   const deviceSizes = normalizeIntegerList(
     config?.deviceSizes ?? DEFAULT_FARM_IMAGE_DEVICE_SIZES,
     "images.deviceSizes"
@@ -5399,7 +5399,7 @@ function resolveFarmImageConfig(config) {
   );
   return Object.freeze({
     provider: config?.provider ?? "auto",
-    path: path31,
+    path: path32,
     domains: Object.freeze([
       ...new Set(
         (config?.domains ?? []).map((domain) => domain.trim().toLowerCase()).filter(Boolean)
@@ -5438,11 +5438,11 @@ function getPublicFarmImageConfig(config) {
   };
 }
 function normalizeImagePath(value) {
-  const path31 = value.trim().replace(/\/+$/, "") || "/";
-  if (!path31.startsWith("/") || path31.includes("?") || path31.includes("#")) {
+  const path32 = value.trim().replace(/\/+$/, "") || "/";
+  if (!path32.startsWith("/") || path32.includes("?") || path32.includes("#")) {
     throw new TypeError("images.path must be an absolute pathname without a query or hash");
   }
-  return path31;
+  return path32;
 }
 function normalizeIntegerList(values, name, max) {
   if (values.length === 0) {
@@ -5920,6 +5920,52 @@ var init_security = __esm({
   }
 });
 
+// src/theme/config.ts
+function resolveFarmThemeConfig(config, basePath = "/") {
+  if (config && "enabled" in config) {
+    return config;
+  }
+  if (!config) {
+    return {
+      enabled: false,
+      default: "system",
+      storageKey: DEFAULT_FARM_THEME_STORAGE_KEY,
+      cookiePath: normalizeCookiePath(basePath)
+    };
+  }
+  const storageKey = config.storageKey?.trim() || DEFAULT_FARM_THEME_STORAGE_KEY;
+  if (!STORAGE_KEY_PATTERN.test(storageKey)) {
+    throw new Error(
+      "theme.storageKey may only contain letters, numbers, dots, underscores, and hyphens."
+    );
+  }
+  const defaultTheme = config.default ?? "system";
+  if (defaultTheme !== "light" && defaultTheme !== "dark" && defaultTheme !== "system") {
+    throw new Error('theme.default must be "light", "dark", or "system".');
+  }
+  return {
+    enabled: true,
+    default: defaultTheme,
+    storageKey,
+    cookiePath: normalizeCookiePath(basePath)
+  };
+}
+function normalizeCookiePath(basePath) {
+  const normalized = `/${basePath}`.replace(/\/{2,}/g, "/");
+  if (normalized === "/") return normalized;
+  return normalized.replace(/\/$/, "");
+}
+var DEFAULT_FARM_THEME_STORAGE_KEY, STORAGE_KEY_PATTERN;
+var init_config2 = __esm({
+  "src/theme/config.ts"() {
+    "use strict";
+    DEFAULT_FARM_THEME_STORAGE_KEY = "farm-theme";
+    STORAGE_KEY_PATTERN = /^[A-Za-z0-9._-]+$/;
+    __name(resolveFarmThemeConfig, "resolveFarmThemeConfig");
+    __name(normalizeCookiePath, "normalizeCookiePath");
+  }
+});
+
 // src/config-entry.ts
 var init_config_entry = __esm({
   "src/config-entry.ts"() {
@@ -6040,37 +6086,37 @@ function sanitizeDocsConfig(config) {
   return cloneSerializable(config) || {};
 }
 async function findDocsConfigPath(rootDir, configPath) {
-  const { existsSync: existsSync17 } = await import("fs");
+  const { existsSync: existsSync18 } = await import("fs");
   const root = import_path2.default.resolve(rootDir || process.cwd());
   if (configPath) {
     const resolvedPath = import_path2.default.isAbsolute(configPath) ? configPath : import_path2.default.join(root, configPath);
-    if (!existsSync17(resolvedPath)) {
+    if (!existsSync18(resolvedPath)) {
       throw new Error(`Could not find docs config at ${configPath}.`);
     }
     return import_path2.default.resolve(resolvedPath);
   }
   for (const filename of DOCS_CONFIG_FILENAMES) {
     const resolvedPath = import_path2.default.join(root, filename);
-    if (existsSync17(resolvedPath)) {
+    if (existsSync18(resolvedPath)) {
       return resolvedPath;
     }
   }
   return void 0;
 }
 async function loadDocsConfig(rootDir, configPath) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const root = import_path2.default.resolve(rootDir || process.cwd());
   const resolvedPath = await findDocsConfigPath(root, configPath);
   if (!resolvedPath) return void 0;
   try {
     if (resolvedPath.endsWith(".json")) {
-      const content = await fs8.readFile(resolvedPath, "utf8");
+      const content = await fs9.readFile(resolvedPath, "utf8");
       return { config: JSON.parse(content), configPath: resolvedPath };
     }
     const { build: build2 } = await import("esbuild");
     const configCacheDir = import_path2.default.join(root, ".farm", ".config-loader");
-    await fs8.mkdir(configCacheDir, { recursive: true });
+    await fs9.mkdir(configCacheDir, { recursive: true });
     const modulePath = import_path2.default.join(
       configCacheDir,
       `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
@@ -6096,7 +6142,7 @@ async function loadDocsConfig(rootDir, configPath) {
         moduleUrl
       );
     } finally {
-      await fs8.unlink(modulePath).catch(() => void 0);
+      await fs9.unlink(modulePath).catch(() => void 0);
     }
     return {
       config: importedConfig.default || importedConfig,
@@ -6246,6 +6292,7 @@ async function resolveConfig(userConfig, mode) {
     routeRules,
     images: resolveFarmImageConfig(userConfig.images),
     performance: resolveFarmPerformanceConfig(userConfig.performance),
+    theme: resolveFarmThemeConfig(userConfig.theme, userConfig.basePath || "/"),
     publicDir: userConfig.publicDir || "public",
     i18n: resolveFarmI18nConfig(userConfig.i18n, { root, mode }),
     openapi: {
@@ -6286,7 +6333,7 @@ async function resolveConfig(userConfig, mode) {
   return resolved;
 }
 async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "production" ? "production" : "development", loadEnvironment) {
-  const { existsSync: existsSync17 } = await import("fs");
+  const { existsSync: existsSync18 } = await import("fs");
   const loadEnv = loadEnvironment || (await import("vite")).loadEnv;
   const root = rootDir || process.cwd();
   const loadedEnv = loadEnv(mode, root, "");
@@ -6310,7 +6357,7 @@ async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "
     try {
       const absolutePath = relativePath2.startsWith("/") ? relativePath2 : import_path2.default.join(root, relativePath2);
       const normalizedPath = import_path2.default.resolve(absolutePath);
-      if (!existsSync17(normalizedPath)) {
+      if (!existsSync18(normalizedPath)) {
         continue;
       }
       const loadedConfig = await loadFarmConfigFile(normalizedPath, { root });
@@ -6323,7 +6370,7 @@ async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "
   return void 0;
 }
 var import_path2, FARM_RESOLVED_CUSTOM_CONTEXT, DOCS_CONFIG_FILENAMES;
-var init_config2 = __esm({
+var init_config3 = __esm({
   "src/config.ts"() {
     "use strict";
     init_integrations();
@@ -6344,6 +6391,7 @@ var init_config2 = __esm({
     init_auth_config();
     init_preload();
     init_security();
+    init_config2();
     init_config_entry();
     FARM_RESOLVED_CUSTOM_CONTEXT = /* @__PURE__ */ Symbol.for("farm.resolvedCustomContext");
     __name(hasCustomFarmRouteContext, "hasCustomFarmRouteContext");
@@ -6486,8 +6534,8 @@ function toViteModuleId(filePath, root) {
 }
 async function fileExists(filePath) {
   try {
-    const fs8 = await import("fs/promises");
-    await fs8.access(filePath);
+    const fs9 = await import("fs/promises");
+    await fs9.access(filePath);
     return true;
   } catch {
     return false;
@@ -7356,7 +7404,7 @@ function normalizePositiveDuration(value, fallback, name) {
   return Math.floor(value);
 }
 function delay(ms) {
-  return new Promise((resolve6) => setTimeout(resolve6, ms));
+  return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
 function normalizeCacheOptionsTags(options) {
   const tags = /* @__PURE__ */ new Set();
@@ -7916,7 +7964,7 @@ function getProgrammaticRouteSearchClientOptions(search) {
   if (search.temporary?.length) options.temporary = [...search.temporary];
   return Object.keys(options).length > 0 ? options : void 0;
 }
-function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path31, routePath) {
+function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path32, routePath) {
   const schema = getProgrammaticRouteSearchSchema(searchConfig);
   const search = parseProgrammaticSchema(schema, rawSearch, "search", routePath);
   const options = getProgrammaticRouteSearchOptions(searchConfig);
@@ -7925,7 +7973,7 @@ function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path31, routePa
     schema,
     rawSearch,
     parsedSearch: search,
-    path: path31
+    path: path32
   });
   return { search, canonicalPath };
 }
@@ -8092,7 +8140,7 @@ function createRouteModuleFromProgrammaticPage(route) {
     mod.__farmRouteData = route.data;
     mod.__farmRouteParsesProps = true;
     mod.__farmResolveRouteProps = (props) => resolveProgrammaticRouteProps(route, props);
-    mod.__farmResolveRouteCanonicalPath = (rawSearch, path31) => resolveProgrammaticRouteSearch(route.search, rawSearch, path31, route.path).canonicalPath;
+    mod.__farmResolveRouteCanonicalPath = (rawSearch, path32) => resolveProgrammaticRouteSearch(route.search, rawSearch, path32, route.path).canonicalPath;
   }
   if (route.pending || route.error || route.notFound) {
     mod.__farmRouteComponents = {
@@ -8490,25 +8538,25 @@ var init_routes = __esm({
     ];
     __name(defineRoutes, "defineRoutes");
     routesBuilder = {
-      page(path31, options) {
+      page(path32, options) {
         return normalizeProgrammaticRoute({
           kind: "page",
-          path: path31,
+          path: path32,
           ...options
         });
       },
-      layout(path31, options) {
+      layout(path32, options) {
         return normalizeProgrammaticRoute({
           kind: "layout",
-          path: path31,
+          path: path32,
           ...options
         });
       },
-      api(path31, options) {
+      api(path32, options) {
         const { render, runtime, regions, maxDuration, ...methods } = options;
         return normalizeProgrammaticRoute({
           kind: "api",
-          path: path31,
+          path: path32,
           render,
           runtime,
           regions,
@@ -8878,6 +8926,35 @@ function getIslandStrategyExport(content) {
 function stripUseClientDirective(content) {
   return content.replace(/^\s*(["'])use client\1\s*;?\s*/, "");
 }
+function hasAsyncDefaultExport(content) {
+  if (!content) return false;
+  const tokens = tokenizeModuleSource(content);
+  for (let index = 0; index < tokens.length - 2; index++) {
+    const token = tokens[index];
+    if (token.kind !== "identifier" || token.value !== "export") continue;
+    if (tokens[index - 1]?.value === ".") continue;
+    if (tokens[index + 1]?.value !== "default") continue;
+    const exported = tokens[index + 2];
+    if (exported.kind === "identifier" && exported.value === "async") {
+      return true;
+    }
+    if (exported.kind === "identifier" && !["function", "class"].includes(exported.value) && tokens[index + 3]?.value !== "(" && isAsyncLocalDeclaration(tokens, exported.value)) {
+      return true;
+    }
+  }
+  return false;
+}
+function isAsyncLocalDeclaration(tokens, name) {
+  for (let index = 0; index < tokens.length - 2; index++) {
+    if (tokens[index].value === "async" && tokens[index + 1]?.value === "function" && tokens[index + 2]?.value === name) {
+      return true;
+    }
+    if (tokens[index].value === name && tokens[index + 1]?.value === "=" && tokens[index + 2]?.value === "async") {
+      return true;
+    }
+  }
+  return false;
+}
 function parseClientModuleMetadata(content, inspectIslandExport) {
   if (!content) {
     return {
@@ -8931,6 +9008,14 @@ function inspectClientModuleMetadata(resolvedPath, root, visited, inspectIslandE
     }
   }
   const shouldHydrate = parsed.hasHydrateExport || importsClientBoundary;
+  if (shouldHydrate && hasAsyncDefaultExport(content)) {
+    return {
+      isClientComponent: false,
+      shouldHydrate: false,
+      islandStrategy: null,
+      suppressedAsyncHydration: true
+    };
+  }
   return {
     isClientComponent: false,
     shouldHydrate,
@@ -9231,6 +9316,8 @@ var init_client_component = __esm({
     __name(isIslandExportStart, "isIslandExportStart");
     __name(getIslandStrategyExport, "getIslandStrategyExport");
     __name(stripUseClientDirective, "stripUseClientDirective");
+    __name(hasAsyncDefaultExport, "hasAsyncDefaultExport");
+    __name(isAsyncLocalDeclaration, "isAsyncLocalDeclaration");
     __name(parseClientModuleMetadata, "parseClientModuleMetadata");
     __name(getClientModuleMetadata, "getClientModuleMetadata");
     __name(inspectClientModuleMetadata, "inspectClientModuleMetadata");
@@ -9791,6 +9878,7 @@ var init_route_manager = __esm({
             shouldHydrate: metadata.shouldHydrate,
             isClientComponent: metadata.isClientComponent,
             islandStrategy: metadata.islandStrategy,
+            suppressedAsyncHydration: metadata.suppressedAsyncHydration,
             search: getProgrammaticRouteSearchClientOptions(programmaticPage?.search),
             segments: entry.route.segments.map((seg) => ({
               segment: seg.segment,
@@ -10442,6 +10530,15 @@ function createWebRequestFromFarmRequest(req) {
 async function _runWithCurrentRequest(request, fn) {
   return requestStore.run(request, fn);
 }
+function getCurrentRequest() {
+  const request = requestStore.getStore();
+  if (!request) {
+    throw new Error(
+      "No current request is available. getCurrentRequest() can only be used during server rendering."
+    );
+  }
+  return request;
+}
 var import_node_async_hooks2, REQUEST_STORAGE_KEY, requestStore;
 var init_request = __esm({
   "src/server/request.ts"() {
@@ -10454,6 +10551,7 @@ var init_request = __esm({
     _setCurrentRequestResolver(() => requestStore.getStore());
     __name(createWebRequestFromFarmRequest, "createWebRequestFromFarmRequest");
     __name(_runWithCurrentRequest, "_runWithCurrentRequest");
+    __name(getCurrentRequest, "getCurrentRequest");
   }
 });
 
@@ -12961,12 +13059,158 @@ body {
   }
 });
 
+// src/theme/server-runtime.ts
+function createFarmThemeDocumentParts(input, basePath = "/", serverTheme) {
+  const config = resolveFarmThemeConfig(input, basePath);
+  if (!config.enabled) return { attributes: "", head: "" };
+  const hydrationTheme = serverTheme ?? config.default;
+  const initialTheme = hydrationTheme === "system" ? "light" : hydrationTheme;
+  const script = createFarmThemeBootstrapScript(config, hydrationTheme);
+  return {
+    attributes: ` data-theme="${initialTheme}"`,
+    head: `<style id="${THEME_STYLE_ID}">:root[data-theme="light"]{color-scheme:light}:root[data-theme="dark"]{color-scheme:dark}</style><script id="${THEME_SCRIPT_ID}">${script}</script>`
+  };
+}
+function createFarmThemeBootstrapScript(config, serverTheme = config.default) {
+  return `(function(config,serverTheme){
+var isTheme=function(value){return value==="light"||value==="dark"||value==="system";};
+var decode=function(value){try{return decodeURIComponent(value);}catch(_error){return value;}};
+var readCookie=function(){var entries=document.cookie.split(";");for(var index=0;index<entries.length;index++){var entry=entries[index];var separator=entry.indexOf("=");if(separator<0)continue;if(decode(entry.slice(0,separator).trim())===config.storageKey)return decode(entry.slice(separator+1).trim());}};
+var media=window.matchMedia("(prefers-color-scheme: dark)");
+var resolveTheme=function(theme){return theme==="system"?(media.matches?"dark":"light"):theme;};
+var storedTheme=readCookie();
+var preference=isTheme(storedTheme)?storedTheme:config.default;
+var serverSnapshot={theme:serverTheme,resolvedTheme:serverTheme==="system"?undefined:serverTheme,mounted:false};
+var apply=function(){var resolvedTheme=resolveTheme(preference);document.documentElement.dataset.theme=resolvedTheme;var snapshot={theme:preference,resolvedTheme:resolvedTheme,mounted:true};if(window.__FARM_THEME__)window.__FARM_THEME__.snapshot=snapshot;return snapshot;};
+var emit=function(){var snapshot=apply();window.dispatchEvent(new CustomEvent("farm:themechange",{detail:snapshot}));};
+var persist=function(theme){var secure=window.location.protocol==="https:"?"; Secure":"";document.cookie=encodeURIComponent(config.storageKey)+"="+encodeURIComponent(theme)+"; Path="+config.cookiePath+"; Max-Age=31536000; SameSite=Lax"+secure;try{localStorage.setItem(config.storageKey,theme);}catch(_error){}};
+var setTheme=function(theme){if(!isTheme(theme))throw new TypeError("Unknown FARMJS theme: "+String(theme));preference=theme;persist(theme);emit();};
+var initialSnapshot={theme:preference,resolvedTheme:resolveTheme(preference),mounted:true};
+window.__FARM_THEME__={config:config,serverSnapshot:serverSnapshot,snapshot:initialSnapshot,setTheme:setTheme};
+document.documentElement.dataset.theme=initialSnapshot.resolvedTheme;
+var handleSystemChange=function(){if(preference==="system")emit();};
+if(typeof media.addEventListener==="function")media.addEventListener("change",handleSystemChange);else if(typeof media.addListener==="function")media.addListener(handleSystemChange);
+window.addEventListener("storage",function(event){if(event.key!==config.storageKey||!isTheme(event.newValue))return;preference=event.newValue;persist(preference);emit();});
+})(${serializeInlineValue(config)},${serializeInlineValue(serverTheme)});`;
+}
+function serializeInlineValue(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+var THEME_SCRIPT_ID, THEME_STYLE_ID;
+var init_server_runtime = __esm({
+  "src/theme/server-runtime.ts"() {
+    "use strict";
+    init_config2();
+    THEME_SCRIPT_ID = "farm-theme-script";
+    THEME_STYLE_ID = "farm-theme-style";
+    __name(createFarmThemeDocumentParts, "createFarmThemeDocumentParts");
+    __name(createFarmThemeBootstrapScript, "createFarmThemeBootstrapScript");
+    __name(serializeInlineValue, "serializeInlineValue");
+  }
+});
+
+// src/theme/bridge.ts
+function _setFarmThemeServerSnapshotResolver(resolver) {
+  globalThis[FARM_THEME_SERVER_SNAPSHOT_RESOLVER] = resolver;
+}
+var FALLBACK_SERVER_SNAPSHOT, FARM_THEME_SERVER_SNAPSHOT_RESOLVER;
+var init_bridge2 = __esm({
+  "src/theme/bridge.ts"() {
+    "use strict";
+    FALLBACK_SERVER_SNAPSHOT = Object.freeze({
+      theme: "system",
+      resolvedTheme: void 0,
+      mounted: false
+    });
+    FARM_THEME_SERVER_SNAPSHOT_RESOLVER = /* @__PURE__ */ Symbol.for("farm.js.theme.server-snapshot-resolver");
+    __name(_setFarmThemeServerSnapshotResolver, "_setFarmThemeServerSnapshotResolver");
+  }
+});
+
+// src/theme/server.ts
+function _setDefaultFarmThemeConfig(config, basePath = "/") {
+  defaultThemeConfig = resolveFarmThemeConfig(config, basePath);
+}
+function getTheme(request = getCurrentRequest()) {
+  return readFarmThemePreference(request, defaultThemeConfig);
+}
+function getThemeSnapshot(request = getCurrentRequest()) {
+  const theme = readFarmThemePreference(request, defaultThemeConfig);
+  return {
+    theme,
+    resolvedTheme: theme === "system" ? void 0 : theme,
+    mounted: false
+  };
+}
+function readFarmThemePreference(request, config) {
+  if (!config.enabled) return config.default;
+  const stored = readCookie3(request.headers.get("cookie"), config.storageKey);
+  return isFarmThemePreference(stored) ? stored : config.default;
+}
+function readCookie3(cookieHeader, name) {
+  if (!cookieHeader) return void 0;
+  for (const entry of cookieHeader.split(";")) {
+    const separator = entry.indexOf("=");
+    if (separator < 0) continue;
+    const key = decodeCookieValue(entry.slice(0, separator).trim());
+    if (key !== name) continue;
+    return decodeCookieValue(entry.slice(separator + 1).trim());
+  }
+  return void 0;
+}
+function decodeCookieValue(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+function isFarmThemePreference(value) {
+  return value === "light" || value === "dark" || value === "system";
+}
+var defaultThemeConfig;
+var init_server3 = __esm({
+  "src/theme/server.ts"() {
+    "use strict";
+    init_request();
+    init_bridge2();
+    init_config2();
+    defaultThemeConfig = resolveFarmThemeConfig(void 0);
+    __name(_setDefaultFarmThemeConfig, "_setDefaultFarmThemeConfig");
+    __name(getTheme, "getTheme");
+    __name(getThemeSnapshot, "getThemeSnapshot");
+    __name(readFarmThemePreference, "readFarmThemePreference");
+    __name(readCookie3, "readCookie");
+    __name(decodeCookieValue, "decodeCookieValue");
+    __name(isFarmThemePreference, "isFarmThemePreference");
+    _setFarmThemeServerSnapshotResolver(() => {
+      try {
+        return getThemeSnapshot();
+      } catch {
+        const theme = defaultThemeConfig.default;
+        return {
+          theme,
+          resolvedTheme: theme === "system" ? void 0 : theme,
+          mounted: false
+        };
+      }
+    });
+  }
+});
+
 // src/server/renderer.ts
+function warnSuppressedAsyncHydrationOnce(modulePath) {
+  if (warnedSuppressedAsyncHydrationModules.has(modulePath)) return;
+  warnedSuppressedAsyncHydrationModules.add(modulePath);
+  logger.warn(
+    `${modulePath} is an async server component that imports client components. React cannot hydrate async components in the browser, so this route stays server-rendered and its client imports are not interactive. Move the interactive UI into a "use client" child rendered by a synchronous page, or enable experimental server components support.`
+  );
+}
 function hasRequestHeader(req, name) {
   const value = req.headers[name.toLowerCase()];
   return Array.isArray(value) ? value.length > 0 : Boolean(value);
 }
-function serializeInlineValue(value) {
+function serializeInlineValue2(value) {
   return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
 function escapeHtmlAttribute2(value) {
@@ -13053,7 +13297,7 @@ function createDocumentFooter(options) {
 }
 function createDeferredHydrationScript(records) {
   if (records.length === 0) return "";
-  return `<script>window.__FARM_DEFERRED_DATA__=${serializeInlineValue(
+  return `<script>window.__FARM_DEFERRED_DATA__=${serializeInlineValue2(
     snapshotDeferredData(records)
   )};</script>`;
 }
@@ -13116,7 +13360,7 @@ function createRouteStateProps(input) {
     context: input.pluginExposedContext.size > 0 ? { data: input.pluginExposedContext } : void 0
   };
 }
-var import_react5, import_server2, fs2, path11, import_stream, cachedClerkProvider, importRuntimeModule, _FarmRouteErrorBoundary, FarmRouteErrorBoundary, _ServerRenderer, ServerRenderer;
+var import_react5, import_server2, fs2, path11, import_stream, cachedClerkProvider, importRuntimeModule, warnedSuppressedAsyncHydrationModules, _FarmRouteErrorBoundary, FarmRouteErrorBoundary, _ServerRenderer, ServerRenderer;
 var init_renderer = __esm({
   "src/server/renderer.ts"() {
     "use strict";
@@ -13146,10 +13390,14 @@ var init_renderer = __esm({
     init_font_vite();
     init_metadata_image();
     init_not_found();
+    init_server_runtime();
+    init_server3();
     cachedClerkProvider = null;
     importRuntimeModule = new Function("specifier", "return import(specifier);");
+    warnedSuppressedAsyncHydrationModules = /* @__PURE__ */ new Set();
+    __name(warnSuppressedAsyncHydrationOnce, "warnSuppressedAsyncHydrationOnce");
     __name(hasRequestHeader, "hasRequestHeader");
-    __name(serializeInlineValue, "serializeInlineValue");
+    __name(serializeInlineValue2, "serializeInlineValue");
     __name(escapeHtmlAttribute2, "escapeHtmlAttribute");
     __name(appendResponseHeader, "appendResponseHeader");
     __name(appendResponseVary, "appendResponseVary");
@@ -13668,6 +13916,9 @@ var init_renderer = __esm({
             })
           );
           const shouldHydrate = moduleMetadata.shouldHydrate;
+          if (moduleMetadata.suppressedAsyncHydration) {
+            warnSuppressedAsyncHydrationOnce(route.modulePath);
+          }
           const layoutHydrationMetadata = layouts.map((layout2) => {
             const manifestEntry = routeManifest.layouts.find(
               (entry) => entry.pattern === layout2.pattern
@@ -14165,7 +14416,7 @@ var init_renderer = __esm({
         }
       }
       async renderWithSSR(element, req, res, clearMiddlewareData, options = {}) {
-        return new Promise((resolve6, reject) => {
+        return new Promise((resolve7, reject) => {
           const streamStartTime = Date.now();
           const observabilityRoute = options.observabilityRoute || req.__FARM_ROUTE__ || req.url || "/";
           const deploymentId = this.getDeploymentId();
@@ -14237,9 +14488,9 @@ var init_renderer = __esm({
             slots: routeSlotPayload
           });
           const propsScript = `<script>
-window.__FARM_PROPS__ = ${serializeInlineValue(deferredProps.data.page)};
-window.__FARM_ROUTE_SLOTS__ = ${serializeInlineValue(deferredProps.data.slots)};
-window.__FARM_DEPLOYMENT_ID__ = ${serializeInlineValue(deploymentId)};
+window.__FARM_PROPS__ = ${serializeInlineValue2(deferredProps.data.page)};
+window.__FARM_ROUTE_SLOTS__ = ${serializeInlineValue2(deferredProps.data.slots)};
+window.__FARM_DEPLOYMENT_ID__ = ${serializeInlineValue2(deploymentId)};
 window.__FARM_PATH__ = ${JSON.stringify(req.__FARM_ROUTE__ || req.url || "/")};
 window.__FARM_IS_CLIENT__ = ${JSON.stringify(isClientComponent)};
 window.__FARM_PAGE_SHOULD_HYDRATE__ = ${JSON.stringify(
@@ -14257,7 +14508,7 @@ window.__FARM_LOADING_MODULE__ = ${JSON.stringify(
           )};
 window.__FARM_MANIFEST__ = ${JSON.stringify(clientManifest)};
 window.__FARM_INTEGRATION_API_MANIFEST__ = ${JSON.stringify(getRegisteredIntegrationAPIManifest())};
-${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(getFarmI18nClientSnapshot())};` : ""}
+${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue2(getFarmI18nClientSnapshot())};` : ""}
 </script>`;
           const hydrationClickQueueScript = isClientComponent || req.__FARM_SHOULD_HYDRATE__ === true || req.__FARM_HAS_HYDRATABLE_ROUTE_SLOTS__ === true ? createPreHydrationClickQueueScript() : "";
           const {
@@ -14268,6 +14519,11 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(g
           const i18nSnapshot = getFarmI18nClientSnapshot();
           const i18nAlternateTags = i18nSnapshot ? renderI18nAlternateLinks(req.__FARM_ROUTE__ || req.url || "/", i18nSnapshot) : "";
           const fontHead = renderFarmFontDevHead(this.config.root || process.cwd());
+          const themeDocument = createFarmThemeDocumentParts(
+            this.config.theme,
+            this.config.basePath,
+            getTheme()
+          );
           const streamRoot = import_react5.default.createElement("div", { style: { display: "contents" } }, element);
           const { pipe } = (0, import_server2.renderToPipeableStream)(streamRoot, {
             onShellReady() {
@@ -14281,8 +14537,9 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(g
                 console.log(`[FARM STREAM] onShellReady at ${shellReadyMs}ms`);
               }
               const shell = `<!DOCTYPE html>
-<html lang="${escapeHtmlAttribute2(i18nSnapshot?.locale || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}>
+<html lang="${escapeHtmlAttribute2(i18nSnapshot?.locale || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}>
 <head>
+  ${themeDocument.head}
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <meta name="farm-deployment-id" content="${escapeHtmlAttribute2(deploymentId)}">
@@ -14359,7 +14616,7 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(g
                     route: observabilityRoute,
                     durationMs: Date.now() - streamStartTime
                   });
-                  resolve6();
+                  resolve7();
                 }
               });
               res.write(shell);
@@ -14484,15 +14741,21 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(g
         const i18nSnapshot = getFarmI18nClientSnapshot();
         const clientScript = isClientComponent ? `  <script type="module" src="/@farm/client.js"></script>` : "";
         const integrationManifestScript = `<script>
-window.__FARM_DEPLOYMENT_ID__ = ${serializeInlineValue(this.getDeploymentId())};
+window.__FARM_DEPLOYMENT_ID__ = ${serializeInlineValue2(this.getDeploymentId())};
 window.__FARM_INTEGRATION_API_MANIFEST__ = ${JSON.stringify(getRegisteredIntegrationAPIManifest())};
-${i18nSnapshot ? `window.__FARM_I18N__ = ${serializeInlineValue(i18nSnapshot)};` : ""}
+${i18nSnapshot ? `window.__FARM_I18N__ = ${serializeInlineValue2(i18nSnapshot)};` : ""}
 </script>`;
         const alternateLinks = i18nSnapshot ? renderI18nAlternateLinks(requestPath, i18nSnapshot) : "";
         const fontHead = renderFarmFontDevHead(this.config.root || process.cwd());
+        const themeDocument = createFarmThemeDocumentParts(
+          this.config.theme,
+          this.config.basePath,
+          getTheme()
+        );
         return `<!DOCTYPE html>
-<html lang="${escapeHtmlAttribute2(i18nSnapshot?.locale || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}>
+<html lang="${escapeHtmlAttribute2(i18nSnapshot?.locale || "en")}"${i18nSnapshot ? ` dir="${i18nSnapshot.direction}"` : ""}${themeDocument.attributes}>
 <head>
+  ${themeDocument.head}
   <meta charset="utf-8">
   <meta name="viewport" content="width=device-width, initial-scale=1">
   <meta name="farm-deployment-id" content="${escapeHtmlAttribute2(this.getDeploymentId())}">
@@ -14576,6 +14839,8 @@ var init_app = __esm({
     init_auth_config();
     init_preload();
     init_security();
+    init_config2();
+    init_server3();
     defaultDocsConfig = {
       enabled: false,
       entry: "/docs",
@@ -14586,6 +14851,7 @@ var init_app = __esm({
       constructor(config = {}, viteServer) {
         this.config = this.normalizeConfig(config);
         configureFarmObservability(this.config.observability);
+        _setDefaultFarmThemeConfig(this.config.theme);
         this.i18nRuntime = createFarmI18nRuntime(this.config.i18n);
         _setDefaultFarmI18nRuntime(this.i18nRuntime);
         this.viteServer = viteServer;
@@ -14644,6 +14910,7 @@ var init_app = __esm({
           security: resolveFarmSecurityConfig(config.security),
           images: resolveFarmImageConfig(config.images),
           performance: resolveFarmPerformanceConfig(config.performance),
+          theme: resolveFarmThemeConfig(config.theme, config.basePath || "/"),
           i18n: isResolvedI18nConfig(config.i18n) ? config.i18n : resolveFarmI18nConfig(config.i18n, {
             root,
             mode: process.env.NODE_ENV === "production" ? "production" : "development"
@@ -16409,6 +16676,36 @@ var init_vite_config = __esm({
   }
 });
 
+// src/theme/vite.ts
+function createFarmThemeCssPlugin(input, basePath = "/") {
+  const config = resolveFarmThemeConfig(input, basePath);
+  return {
+    name: "farm:theme-css",
+    enforce: "pre",
+    transform(code, id) {
+      if (!config.enabled || !/\.css(?:\?.*)?$/.test(id) || !/@import\s+["']tailwindcss["']/.test(code) || /@custom-variant\s+dark\b/.test(code)) {
+        return null;
+      }
+      return {
+        code: `${code.trimEnd()}
+
+${FARM_DARK_VARIANT}
+`,
+        map: null
+      };
+    }
+  };
+}
+var FARM_DARK_VARIANT;
+var init_vite = __esm({
+  "src/theme/vite.ts"() {
+    "use strict";
+    init_config2();
+    FARM_DARK_VARIANT = '@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));';
+    __name(createFarmThemeCssPlugin, "createFarmThemeCssPlugin");
+  }
+});
+
 // src/default-styles.ts
 var defaultGlobalCSS;
 var init_default_styles = __esm({
@@ -17302,11 +17599,11 @@ var init_type_generator = __esm({
           routeGroups.get(key).push(route);
         }
         const nestedStructure = {};
-        for (const [path31, routeList] of routeGroups) {
+        for (const [path32, routeList] of routeGroups) {
           const route = routeList[0];
           const importPath = this.getRouteImportPath(route, options.outFile);
           const routeName = this.pathToRouteName(route.path);
-          const cleanPath = path31 === "/api" ? "" : path31.replace(/^\/api\//, "");
+          const cleanPath = path32 === "/api" ? "" : path32.replace(/^\/api\//, "");
           const parts = cleanPath ? cleanPath.split("/") : [];
           const allMethods = routeList.flatMap((r) => r.methods);
           for (const method of allMethods) {
@@ -17365,8 +17662,8 @@ ${typeExports}
         const relativeImport = (0, import_path10.relative)((0, import_path10.dirname)(outFile), route.filePath).replace(/\\/g, "/").replace(/\.(ts|tsx|js|jsx)$/, "");
         return relativeImport.startsWith(".") ? relativeImport : `./${relativeImport}`;
       }
-      pathToRouteName(path31) {
-        return (path31 === "/api" ? "root" : path31.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
+      pathToRouteName(path32) {
+        return (path32 === "/api" ? "root" : path32.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
       }
       structureToTypeString(obj, indent) {
         const spaces = "  ".repeat(indent);
@@ -17386,15 +17683,15 @@ ${typeExports}
       toTypePropertyKey(key) {
         return /^[$A-Z_][0-9A-Z_$]*$/i.test(key) ? key : JSON.stringify(key);
       }
-      getBaseExportName(path31) {
-        const cleanPath = path31.replace(/^\/api\//, "");
+      getBaseExportName(path32) {
+        const cleanPath = path32.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return "api";
         }
         return cleanPath;
       }
-      getExportName(path31, method) {
-        const cleanPath = path31.replace(/^\/api\//, "");
+      getExportName(path32, method) {
+        const cleanPath = path32.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return method.toLowerCase();
         }
@@ -18081,7 +18378,7 @@ var init_type_artifacts = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.22";
+    version = "0.1.0-beta.24";
   }
 });
 
@@ -18118,8 +18415,8 @@ function reportAfterError(state, error) {
 function createAfterRequestState(reportError = defaultAfterErrorReporter) {
   let resolveResponseFinished;
   let responseFinished = false;
-  const responseFinishedPromise = new Promise((resolve6) => {
-    resolveResponseFinished = resolve6;
+  const responseFinishedPromise = new Promise((resolve7) => {
+    resolveResponseFinished = resolve7;
   });
   const state = {
     completion: Promise.resolve(),
@@ -18202,6 +18499,40 @@ var init_after = __esm({
   }
 });
 
+// src/dev-static.ts
+function devServableFileExists(pathname, baseDirs) {
+  let decodedPathname;
+  try {
+    decodedPathname = decodeURIComponent(pathname);
+  } catch {
+    return false;
+  }
+  const relativePathname = decodedPathname.replace(/^\/+/, "");
+  if (!relativePathname) return false;
+  for (const baseDir of baseDirs) {
+    if (typeof baseDir !== "string" || baseDir.length === 0) continue;
+    const resolvedBase = path24.resolve(baseDir);
+    const candidate = path24.resolve(resolvedBase, relativePathname);
+    if (!candidate.startsWith(resolvedBase + path24.sep)) continue;
+    try {
+      if (fs7.existsSync(candidate) && fs7.statSync(candidate).isFile()) {
+        return true;
+      }
+    } catch {
+    }
+  }
+  return false;
+}
+var fs7, path24;
+var init_dev_static = __esm({
+  "src/dev-static.ts"() {
+    "use strict";
+    fs7 = __toESM(require("fs"));
+    path24 = __toESM(require("path"));
+    __name(devServableFileExists, "devServableFileExists");
+  }
+});
+
 // src/image-vite.ts
 function farmImageImportsPlugin() {
   return {
@@ -22495,7 +22826,7 @@ var init_api = __esm({
   "src/docs/api.ts"() {
     "use strict";
     import_docs2 = require("@farming-labs/docs");
-    init_config2();
+    init_config3();
     init_handler();
     __name(isRecord4, "isRecord");
     __name(isResolvedDocsConfig2, "isResolvedDocsConfig");
@@ -22789,8 +23120,8 @@ var init_generator = __esm({
           }
           routeGroups.get(key).push(route);
         }
-        for (const [path31, routeList] of routeGroups) {
-          const openAPIPath = this.convertToOpenAPIPath(path31);
+        for (const [path32, routeList] of routeGroups) {
+          const openAPIPath = this.convertToOpenAPIPath(path32);
           spec.paths[openAPIPath] = {};
           for (const route of routeList) {
             for (const method of route.methods) {
@@ -22804,8 +23135,8 @@ var init_generator = __esm({
       /**
        * Convert Farm.js API path to OpenAPI path format
        */
-      convertToOpenAPIPath(path31) {
-        return path31.replace(/^\/api/, "");
+      convertToOpenAPIPath(path32) {
+        return path32.replace(/^\/api/, "");
       }
       /**
        * Extract request body schema from endpoint
@@ -22967,8 +23298,8 @@ var init_generator = __esm({
       /**
        * Generate operation summary
        */
-      generateSummary(path31, method) {
-        const cleanPath = path31.replace(/^\/api\//, "");
+      generateSummary(path32, method) {
+        const cleanPath = path32.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         const lastPart = pathParts[pathParts.length - 1];
         const action = method === "GET" ? "Get" : method === "POST" ? "Create" : method === "PUT" ? "Update" : method === "DELETE" ? "Delete" : method === "PATCH" ? "Update" : method;
@@ -22977,22 +23308,22 @@ var init_generator = __esm({
       /**
        * Generate operation description
        */
-      generateDescription(path31, method) {
-        const cleanPath = path31.replace(/^\/api\//, "");
+      generateDescription(path32, method) {
+        const cleanPath = path32.replace(/^\/api\//, "");
         return `${method} ${cleanPath} endpoint`;
       }
       /**
        * Generate operation ID
        */
-      generateOperationId(path31, method) {
-        const cleanPath = path31.replace(/^\/api\//, "").replace(/\//g, "_");
+      generateOperationId(path32, method) {
+        const cleanPath = path32.replace(/^\/api\//, "").replace(/\//g, "_");
         return `${method.toLowerCase()}_${cleanPath}`;
       }
       /**
        * Generate tags for grouping operations
        */
-      generateTags(path31) {
-        const cleanPath = path31.replace(/^\/api\//, "");
+      generateTags(path32) {
+        const cleanPath = path32.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         if (pathParts.length > 1) {
           return [pathParts[0]];
@@ -23004,13 +23335,13 @@ var init_generator = __esm({
        */
       async generateSpecFile(routes, outputPath) {
         const spec = await this.generateSpec(routes);
-        const fs8 = require("fs");
-        const path31 = require("path");
-        const dir = path31.dirname(outputPath);
-        if (!fs8.existsSync(dir)) {
-          fs8.mkdirSync(dir, { recursive: true });
+        const fs9 = require("fs");
+        const path32 = require("path");
+        const dir = path32.dirname(outputPath);
+        if (!fs9.existsSync(dir)) {
+          fs9.mkdirSync(dir, { recursive: true });
         }
-        fs8.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
+        fs9.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
       }
     };
     __name(_OpenAPIGenerator, "OpenAPIGenerator");
@@ -23480,7 +23811,7 @@ var init_devtools = __esm({
   "src/devtools.ts"() {
     "use strict";
     import_node_path14 = __toESM(require("path"));
-    init_config2();
+    init_config3();
     init_cron();
     init_route_runtime();
     __name(normalizePath, "normalizePath");
@@ -25298,18 +25629,18 @@ function isPotentialProgrammaticRouteSourceFile(normalizedFile, srcDirSlug) {
   return normalizedFile.startsWith(`${srcDirSlug}/`) && /\.(ts|tsx|js|jsx)$/.test(normalizedFile) && !normalizedFile.endsWith(".d.ts") && !normalizedFile.endsWith("/farm-routes.d.ts") && !normalizedFile.endsWith("/farm-env.d.ts") && !normalizedFile.endsWith("/lib/api.generated.ts");
 }
 function fileContainsProgrammaticPageRoute(file) {
-  if (!fs7.existsSync(file)) {
+  if (!fs8.existsSync(file)) {
     return false;
   }
   try {
-    return scanProgrammaticPagePaths(fs7.readFileSync(file, "utf8")).length > 0;
+    return scanProgrammaticPagePaths(fs8.readFileSync(file, "utf8")).length > 0;
   } catch {
     return false;
   }
 }
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path27.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path28.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -25329,7 +25660,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 = path27.resolve(path27.dirname(cleanId), sourcePath);
+    const resolvedPath = path28.resolve(path28.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -25404,7 +25735,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...layerRoots.length ? {
           server: {
             fs: {
-              allow: [path27.resolve(options.root || process.cwd()), ...layerRoots]
+              allow: [path28.resolve(options.root || process.cwd()), ...layerRoots]
             }
           }
         } : {}
@@ -25435,13 +25766,13 @@ function farmPlugin(options = {}, initialPluginManager) {
         },
         server
       );
-      const globalsCSSPath = path27.join(server.config.root, "src/app/globals.css");
-      if (!fs7.existsSync(globalsCSSPath)) {
-        const appDir = path27.join(server.config.root, "src/app");
-        if (!fs7.existsSync(appDir)) {
-          fs7.mkdirSync(appDir, { recursive: true });
+      const globalsCSSPath = path28.join(server.config.root, "src/app/globals.css");
+      if (!fs8.existsSync(globalsCSSPath)) {
+        const appDir = path28.join(server.config.root, "src/app");
+        if (!fs8.existsSync(appDir)) {
+          fs8.mkdirSync(appDir, { recursive: true });
         }
-        fs7.writeFileSync(globalsCSSPath, defaultGlobalCSS);
+        fs8.writeFileSync(globalsCSSPath, defaultGlobalCSS);
       }
       await farmApp.initialize();
       const farmConfig = farmApp.getConfig();
@@ -25460,10 +25791,10 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path27.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path28.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
-          farmConfig.i18n.messages.includes("{locale}") ? path27.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
+          farmConfig.i18n.messages.includes("{locale}") ? path28.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
         );
       }
       const workflowConfig = farmConfig.workflows;
@@ -25473,7 +25804,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path27.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path28.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -25513,7 +25844,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path27.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path28.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -25631,7 +25962,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       await apiRouteManager.discoverRoutes();
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs7.existsSync(path27.isAbsolute(dir) ? dir : path27.join(farmConfig.root, dir))
+        (dir) => fs8.existsSync(path28.isAbsolute(dir) ? dir : path28.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler: createFarmWorkflowRequestHandler2, discoverFarmWorkflows: discoverFarmWorkflows2 } = await loadFarmWorkflowsDevRuntime();
@@ -25865,12 +26196,12 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             }
           }
           const farmDocsFontPath = farmDocsFontAssets.get(requestPathname);
-          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs7.existsSync(farmDocsFontPath)) {
+          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs8.existsSync(farmDocsFontPath)) {
             res.statusCode = 200;
             res.setHeader("Content-Type", "font/woff2");
             res.setHeader("Cache-Control", "public, max-age=31536000, immutable");
             if (requestMethod === "HEAD") res.end();
-            else fs7.createReadStream(farmDocsFontPath).pipe(res);
+            else fs8.createReadStream(farmDocsFontPath).pipe(res);
             return;
           }
           if (requestMethod === "GET" && (requestPathname === FARM_DEVTOOLS_PATH || requestPathname === `${FARM_DEVTOOLS_PATH}.json`)) {
@@ -25968,7 +26299,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 return null;
               }
               return {
-                source: await fs7.promises.readFile(sourcePath, "utf8"),
+                source: await fs8.promises.readFile(sourcePath, "utf8"),
                 filePath: sourcePath
               };
             }, "resolveSource")
@@ -26303,9 +26634,17 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             res.end(JSON.stringify({ error: "API route not found", pathname: pathname2 }));
             return;
           }
-          if (req.url?.startsWith("/@") || req.url?.startsWith("/node_modules") || requestPathname.includes(".") && !requestPathname.endsWith(".html")) {
+          if (req.url?.startsWith("/@") || req.url?.startsWith("/node_modules")) {
             return next();
           }
+          if (requestPathname.includes(".") && !requestPathname.endsWith(".html")) {
+            const matchesAppRoute = Boolean(
+              farmApp?.getRouteManager()?.matchRoute(requestPathname)?.route
+            );
+            if (!matchesAppRoute || devServableFileExists(requestPathname, [server.config.publicDir, server.config.root])) {
+              return next();
+            }
+          }
           if (req.url?.startsWith("/__farm/page-data")) {
             const urlObj = new URL(req.url, `http://${req.headers.host || "localhost:3000"}`);
             const targetPath = urlObj.searchParams.get("path") || "/";
@@ -27011,8 +27350,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path27.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path27.join(outDir, "client");
+        const outDir = path28.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path28.join(outDir, "client");
         for (const page2 of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page2.urlPath, "http://farm.static"));
@@ -27064,9 +27403,9 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page2.urlPath === "/" ? path27.join(clientDir, "index.html") : path27.join(clientDir, page2.urlPath + ".html");
-              fs7.mkdirSync(path27.dirname(outputPath), { recursive: true });
-              fs7.writeFileSync(outputPath, fullHtml);
+              const outputPath = page2.urlPath === "/" ? path28.join(clientDir, "index.html") : path28.join(clientDir, page2.urlPath + ".html");
+              fs8.mkdirSync(path28.dirname(outputPath), { recursive: true });
+              fs8.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page2.revalidate ? ` (revalidate: ${page2.revalidate}s)` : "";
               logger.success(`  \u2713 ${page2.urlPath}${revalidateInfo}`);
             });
@@ -27074,8 +27413,8 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page2.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path27.join(outDir, "__ssg_manifest.json");
-        fs7.writeFileSync(
+        const manifestPath = path28.join(outDir, "__ssg_manifest.json");
+        fs8.writeFileSync(
           manifestPath,
           JSON.stringify(
             ssgPages.map((p) => ({
@@ -27110,9 +27449,9 @@ if (import.meta.hot) {
       }
       const currentFarmConfig = farmApp?.getConfig();
       const normalizedFile = file.replace(/\\/g, "/");
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path27.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path28.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path27.basename(file)}`);
+        logUpdate("PAGE", `updated ${path28.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -28292,6 +28631,19 @@ async function tryHydrateImportedPage(
     const PageComponent = pageModule?.default;
     if (!PageComponent) return false;
 
+    if (
+      typeof PageComponent === 'function' &&
+      PageComponent.constructor &&
+      PageComponent.constructor.name === 'AsyncFunction'
+    ) {
+      console.warn(
+        '[Farm.js] Skipping hydration for ' + modulePath +
+        ': async server components cannot run in the browser. ' +
+        'Server-rendered HTML is preserved; move interactive UI into a "use client" child of a synchronous page.'
+      );
+      return false;
+    }
+
     currentPageComponent = PageComponent;
     currentPageProps = await buildRouteComponentProps(
       pageModule,
@@ -28458,14 +28810,22 @@ async function renderPage(pageData) {
     if (!doc.documentElement || !doc.body) return false;
 
     resetReactRoots();
+    const activeFarmTheme =
+      window.__FARM_THEME__?.snapshot?.resolvedTheme ||
+      document.documentElement.getAttribute('data-theme');
     Array.from(document.documentElement.attributes).forEach(function(attr) {
+      if (attr.name === 'data-theme') return;
       if (!doc.documentElement.hasAttribute(attr.name)) {
         document.documentElement.removeAttribute(attr.name);
       }
     });
     Array.from(doc.documentElement.attributes).forEach(function(attr) {
+      if (attr.name === 'data-theme') return;
       document.documentElement.setAttribute(attr.name, attr.value);
     });
+    if (activeFarmTheme) {
+      document.documentElement.setAttribute('data-theme', activeFarmTheme);
+    }
 
     document.head.innerHTML = doc.head ? doc.head.innerHTML : '';
     document.body.innerHTML = doc.body.innerHTML;
@@ -28474,6 +28834,7 @@ async function renderPage(pageData) {
 
     setTimeout(function() {
       Array.from(document.querySelectorAll('script')).forEach(function(script) {
+        if (script.id === 'farm-theme-script') return;
         const freshScript = document.createElement('script');
         Array.from(script.attributes).forEach(function(attr) {
           freshScript.setAttribute(attr.name, attr.value);
@@ -28833,7 +29194,7 @@ function generateClientManifest(bundle) {
 }
 async function defineConfig2(config = {}) {
   const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const appRoot = path27.resolve(config.root || process.cwd());
+  const appRoot = path28.resolve(config.root || process.cwd());
   if (config.extends?.length) {
     const { config: layeredConfig } = await Promise.resolve().then(() => (init_layers(), layers_exports)).then(
       ({ resolveFarmLayers: resolveFarmLayers2 }) => resolveFarmLayers2(config, {
@@ -28968,6 +29329,7 @@ async function defineConfig2(config = {}) {
   };
   return {
     plugins: [
+      createFarmThemeCssPlugin(config.theme, config.basePath),
       tailwindcss(),
       viteBrowserExternalPlugin,
       farmI18nClientBridgePlugin(),
@@ -29039,8 +29401,8 @@ async function defineConfig2(config = {}) {
     }
   };
 }
-var fs7, path27, ALL_TYPE_ARTIFACTS, createEmptyTypeArtifactSelection, FARM_I18N_CLIENT_BRIDGE_ID, EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, FARM_CONFIG_FILENAMES;
-var init_vite = __esm({
+var fs8, path28, ALL_TYPE_ARTIFACTS, createEmptyTypeArtifactSelection, FARM_I18N_CLIENT_BRIDGE_ID, EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, FARM_CONFIG_FILENAMES;
+var init_vite2 = __esm({
   "src/vite.ts"() {
     "use strict";
     init_app();
@@ -29058,13 +29420,14 @@ var init_vite = __esm({
     init_integrations();
     init_route_context();
     init_devtools_config();
-    fs7 = __toESM(require("fs"));
-    path27 = __toESM(require("path"));
+    fs8 = __toESM(require("fs"));
+    path28 = __toESM(require("path"));
     init_layers();
     init_environment_vite();
     init_version();
     init_deferred();
     init_after();
+    init_dev_static();
     init_deployment();
     init_image_config();
     init_image_vite();
@@ -29077,6 +29440,7 @@ var init_vite = __esm({
     init_fonts();
     init_server_http();
     init_cli_colors();
+    init_vite();
     ALL_TYPE_ARTIFACTS = {
       routes: true,
       api: true,
@@ -29176,7 +29540,7 @@ var init_plugin = __esm({
     init_env();
     init_request_context();
     init_plugin_integration_context();
-    init_vite();
+    init_vite2();
     _FarmRuntimeShutdownError = class _FarmRuntimeShutdownError extends Error {
       constructor(message, errors) {
         super(message);
@@ -30521,7 +30885,7 @@ __export(build_runtime_exports, {
 module.exports = __toCommonJS(build_runtime_exports);
 
 // src/build/index.ts
-init_config2();
+init_config3();
 var import_path14 = __toESM(require("path"));
 init_utils();
 init_app();
@@ -30529,7 +30893,7 @@ init_route_manager2();
 init_layers();
 
 // src/nitro/universal-build.ts
-init_config2();
+init_config3();
 init_client_plugin_build();
 var import_os = __toESM(require("os"));
 var import_path12 = __toESM(require("path"));
@@ -30603,10 +30967,10 @@ async function createFarmRouteRuntimeManifest(options) {
 }
 __name(createFarmRouteRuntimeManifest, "createFarmRouteRuntimeManifest");
 async function writeFarmRouteRuntimeManifest(directory, manifest) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const manifestPath = import_path8.default.join(directory, FARM_ROUTE_RUNTIME_MANIFEST);
-  await fs8.mkdir(directory, { recursive: true });
-  await fs8.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
+  await fs9.mkdir(directory, { recursive: true });
+  await fs9.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}
 `);
   return manifestPath;
 }
@@ -30652,7 +31016,7 @@ __name(normalizeManifestSource, "normalizeManifestSource");
 // src/nitro/vercel-route-runtime.ts
 var import_path9 = __toESM(require("path"));
 init_route_runtime();
-async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs8) {
+async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs9) {
   const dynamicRoutes = manifest.routes.filter(
     (route) => route.rendering === "dynamic" && route.runtime !== "edge"
   );
@@ -30683,8 +31047,8 @@ async function createFarmVercelRouteRuntimeFunctions(outputDir, manifest, fs8) {
     groupIndex += 1;
     const functionName = `__farm_runtime_${groupIndex}`;
     const functionDir = import_path9.default.join(functionsDir, `${functionName}.func`);
-    await fs8.cp(baseFunctionDir, functionDir, { recursive: true, force: true });
-    await configureVercelFunction(functionDir, group.config, fs8);
+    await fs9.cp(baseFunctionDir, functionDir, { recursive: true, force: true });
+    await configureVercelFunction(functionDir, group.config, fs9);
     destinations.set(key, `/${functionName}`);
   }
   const routes = [];
@@ -30731,15 +31095,15 @@ function farmRoutePatternToVercelSource(pattern) {
   return source || "/";
 }
 __name(farmRoutePatternToVercelSource, "farmRoutePatternToVercelSource");
-async function configureVercelFunction(functionDir, config, fs8) {
+async function configureVercelFunction(functionDir, config, fs9) {
   const configPath = import_path9.default.join(functionDir, ".vc-config.json");
-  const current = JSON.parse(await fs8.readFile(configPath, "utf8"));
+  const current = JSON.parse(await fs9.readFile(configPath, "utf8"));
   const next = {
     ...current,
     ...config.regions?.length ? { regions: config.regions } : {},
     ...config.maxDuration ? { maxDuration: config.maxDuration } : {}
   };
-  await fs8.writeFile(configPath, `${JSON.stringify(next, null, 2)}
+  await fs9.writeFile(configPath, `${JSON.stringify(next, null, 2)}
 `);
 }
 __name(configureVercelFunction, "configureVercelFunction");
@@ -31065,6 +31429,7 @@ __name(withVite5TransformContext, "withVite5TransformContext");
 init_font_vite();
 init_vite_config();
 init_not_found();
+init_vite();
 var import_meta = {};
 function preloadFarmNitroRuntime() {
   return import("nitro").then(
@@ -31380,7 +31745,7 @@ function hasProjectPostcssConfig(root) {
 }
 __name(hasProjectPostcssConfig, "hasProjectPostcssConfig");
 async function findFarmConfigPath(root) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const candidates = [
     "farm.config.ts",
     "farm.config.mts",
@@ -31394,7 +31759,7 @@ async function findFarmConfigPath(root) {
   for (const candidate of candidates) {
     const resolvedPath = import_path12.default.join(root, candidate);
     try {
-      await fs8.access(resolvedPath);
+      await fs9.access(resolvedPath);
       return resolvedPath;
     } catch {
     }
@@ -31421,13 +31786,13 @@ function hasFarmServerRuntimePlugins(config) {
 }
 __name(hasFarmServerRuntimePlugins, "hasFarmServerRuntimePlugins");
 async function discoverMiddlewareRoutes(appDir) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const appDirs = Array.isArray(appDir) ? [...appDir] : [appDir];
   const routes = /* @__PURE__ */ new Map();
   async function walk(dir, routePath, discovered) {
     let entries;
     try {
-      entries = await fs8.readdir(dir, { withFileTypes: true });
+      entries = await fs9.readdir(dir, { withFileTypes: true });
     } catch {
       return;
     }
@@ -31508,12 +31873,12 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
       })
     );
     logger.info(`\u{1F4CB} Found ${pageRoutes.length} page routes`);
-    const fs8 = await import("fs/promises");
+    const fs9 = await import("fs/promises");
     const layoutRoutes = [];
     const appDir = import_path12.default.join(root, srcDir, "app");
     async function findLayoutsForClient(dir, routePrefix = "/") {
       try {
-        const entries = await fs8.readdir(dir, { withFileTypes: true });
+        const entries = await fs9.readdir(dir, { withFileTypes: true });
         for (const entry of entries) {
           if (entry.isFile() && entry.name.match(/^layout\.(tsx?|jsx?)$/)) {
             layoutRoutes.push({
@@ -31647,7 +32012,7 @@ async function buildUniversal(config, routeManager, apiRouteManager, serverRende
 }
 __name(buildUniversal, "buildUniversal");
 async function writeSSRAssetsToClient(bundle, outputDir) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   for (const [fileName, output] of Object.entries(bundle)) {
     if (output.type !== "asset") continue;
     if (fileName === "farm-fonts.css") {
@@ -31655,29 +32020,29 @@ async function writeSSRAssetsToClient(bundle, outputDir) {
       continue;
     }
     const filePath = import_path12.default.join(outputDir, fileName);
-    await fs8.mkdir(import_path12.default.dirname(filePath), { recursive: true });
-    await fs8.writeFile(filePath, output.source);
+    await fs9.mkdir(import_path12.default.dirname(filePath), { recursive: true });
+    await fs9.writeFile(filePath, output.source);
   }
 }
 __name(writeSSRAssetsToClient, "writeSSRAssetsToClient");
 async function copyFarmDocsFontAssetsToClient(root, outputDir) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   await Promise.all(
     resolveFarmDocsFontAssets(root).map(async ({ sourcePath, url }) => {
       const targetPath = import_path12.default.join(outputDir, url.replace(/^\/+/, ""));
-      await fs8.mkdir(import_path12.default.dirname(targetPath), { recursive: true });
-      await fs8.copyFile(sourcePath, targetPath);
+      await fs9.mkdir(import_path12.default.dirname(targetPath), { recursive: true });
+      await fs9.copyFile(sourcePath, targetPath);
     })
   );
 }
 __name(copyFarmDocsFontAssetsToClient, "copyFarmDocsFontAssetsToClient");
 async function mergeBuiltFontCss(outputDir, fontCssSource) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const fontCssPath = import_path12.default.join(outputDir, "farm-fonts.css");
   let fontCss = fontCssSource;
   if (fontCss === void 0) {
     try {
-      fontCss = await fs8.readFile(fontCssPath);
+      fontCss = await fs9.readFile(fontCssPath);
     } catch {
       return;
     }
@@ -31685,12 +32050,12 @@ async function mergeBuiltFontCss(outputDir, fontCssSource) {
   const clientCssPath = import_path12.default.join(outputDir, "farm-client.css");
   let clientCss = "";
   try {
-    clientCss = await fs8.readFile(clientCssPath, "utf8");
+    clientCss = await fs9.readFile(clientCssPath, "utf8");
   } catch {
   }
   const normalizedFontCss = typeof fontCss === "string" ? fontCss : Buffer.from(fontCss).toString("utf8");
-  await fs8.writeFile(fontCssPath, normalizedFontCss);
-  await fs8.writeFile(clientCssPath, mergeFarmFontCss(clientCss, normalizedFontCss));
+  await fs9.writeFile(fontCssPath, normalizedFontCss);
+  await fs9.writeFile(clientCssPath, mergeFarmFontCss(clientCss, normalizedFontCss));
 }
 __name(mergeBuiltFontCss, "mergeBuiltFontCss");
 var _IncompleteClientBuildOutputError = class _IncompleteClientBuildOutputError extends Error {
@@ -31702,11 +32067,11 @@ var _IncompleteClientBuildOutputError = class _IncompleteClientBuildOutputError
 __name(_IncompleteClientBuildOutputError, "IncompleteClientBuildOutputError");
 var IncompleteClientBuildOutputError = _IncompleteClientBuildOutputError;
 async function validateClientBuildOutput(root, srcDir, outputDir) {
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const clientEntryPath = import_path12.default.join(outputDir, "farm-client.js");
   let clientEntrySize = 0;
   try {
-    const clientEntry = await fs8.stat(clientEntryPath);
+    const clientEntry = await fs9.stat(clientEntryPath);
     if (clientEntry.isFile()) clientEntrySize = clientEntry.size;
   } catch {
   }
@@ -31717,12 +32082,12 @@ async function validateClientBuildOutput(root, srcDir, outputDir) {
   const globalsCssPath = import_path12.default.join(root, srcDir, "app", "globals.css");
   let expectsCss = false;
   try {
-    const globalsCss = await fs8.readFile(globalsCssPath, "utf8");
+    const globalsCss = await fs9.readFile(globalsCssPath, "utf8");
     expectsCss = globalsCss.replace(/\/\*[\s\S]*?\*\//g, "").trim().length > 0;
   } catch {
   }
   try {
-    const clientCss = await fs8.stat(clientCssPath);
+    const clientCss = await fs9.stat(clientCssPath);
     if (expectsCss && (!clientCss.isFile() || clientCss.size === 0)) {
       throw new IncompleteClientBuildOutputError("farm-client.css is empty");
     }
@@ -31731,15 +32096,15 @@ async function validateClientBuildOutput(root, srcDir, outputDir) {
     if (expectsCss) {
       throw new IncompleteClientBuildOutputError("farm-client.css is missing");
     }
-    await fs8.writeFile(clientCssPath, "");
+    await fs9.writeFile(clientCssPath, "");
   }
 }
 __name(validateClientBuildOutput, "validateClientBuildOutput");
 async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = []) {
   const viteBuild = productionVite.build;
-  const { farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite(), vite_exports));
+  const { farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite2(), vite_exports));
   const { PluginManager: PluginManager2 } = await Promise.resolve().then(() => (init_plugin(), plugin_exports));
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -31775,6 +32140,11 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
       const applicableClientLayouts = clientLayouts.filter(
         (layout2) => layout2.shouldHydrate && layoutAppliesToRoute(layout2.pattern, route.pattern)
       );
+      if (metadata.suppressedAsyncHydration) {
+        logger.warn(
+          `\u26A0\uFE0F  ${route.pattern} is an async server component that imports client components; React cannot hydrate async components, so the route stays server-rendered and its client imports are not interactive.`
+        );
+      }
       if (metadata.shouldHydrate || applicableClientLayouts.length > 0) {
         const relativePath2 = route.modulePath.replace(root, "").replace(/^\//, "");
         const hydrationStrategies = [
@@ -31833,8 +32203,8 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     `\u{1F4F1} Total hydratable routes detected: ${clientPages.length} pages, ${clientLayouts.filter((layout2) => layout2.shouldHydrate).length} layouts, and ${clientRouteSlots.length} slots`
   );
   const clientEntryRoot = import_path12.default.join(root, ".farm", "tmp");
-  await fs8.mkdir(clientEntryRoot, { recursive: true });
-  const clientEntryDir = await fs8.mkdtemp(import_path12.default.join(clientEntryRoot, "client-entry-"));
+  await fs9.mkdir(clientEntryRoot, { recursive: true });
+  const clientEntryDir = await fs9.mkdtemp(import_path12.default.join(clientEntryRoot, "client-entry-"));
   const clientEntryPath = import_path12.default.join(clientEntryDir, "farm-client-entry.tsx");
   const clientHydrationCode = generateClientHydrationEntry(
     clientPages,
@@ -31848,7 +32218,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     config.i18n,
     config.plugins
   );
-  await fs8.writeFile(clientEntryPath, clientHydrationCode);
+  await fs9.writeFile(clientEntryPath, clientHydrationCode);
   const hasScopedPostcssConfig = hasProjectPostcssConfig(root);
   let postcssSearchPath;
   let tailwindVitePlugin = void 0;
@@ -31856,7 +32226,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
   } else {
     const postcssConfigPath = import_path12.default.join(clientEntryDir, "postcss.config.cjs");
-    await fs8.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
+    await fs9.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
     postcssSearchPath = clientEntryDir;
     try {
       const tailwindVite = (await import("@tailwindcss/vite")).default;
@@ -31929,6 +32299,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
         }
       },
       plugins: [
+        createFarmThemeCssPlugin(config.theme, config.basePath),
         ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
         // Plugin to redirect @farm.js/core imports to client-only exports
         {
@@ -32000,7 +32371,7 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
     await validateClientBuildOutput(root, srcDir, outputDir);
   } finally {
     try {
-      await fs8.rm(clientEntryDir, { recursive: true, force: true });
+      await fs9.rm(clientEntryDir, { recursive: true, force: true });
     } catch {
     }
   }
@@ -32651,6 +33022,13 @@ async function createMatchedHydrationElement(matched, pathname, searchParams) {
   if (matched.route.pageShouldHydrate) {
     const Component = await loadRouteComponent(matched.route);
     if (!Component) return null;
+    if (typeof Component === "function" && Component.constructor && Component.constructor.name === "AsyncFunction") {
+      console.warn(
+        "[Farm.js] Skipping hydration for " + pathname +
+        ": async server components cannot run in the browser. Server-rendered HTML is preserved."
+      );
+      return null;
+    }
     const props = { params: params, searchParams: Promise.resolve(searchParams) };
     pageElement = React.createElement(Component, props);
   } else if (hydrateLayouts) {
@@ -33306,9 +33684,9 @@ void hydrate();
 __name(generateClientHydrationEntry, "generateClientHydrationEntry");
 async function buildSSRInMemory(productionVite, config, root, routeManager, apiRouteManager, serverRenderer, preset, collectedPageRoutes, collectedLayoutRoutes, collectedRouteSlots) {
   const viteBuild = productionVite.build;
-  const { farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite(), vite_exports));
+  const { farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite2(), vite_exports));
   const { PluginManager: PluginManager2 } = await Promise.resolve().then(() => (init_plugin(), plugin_exports));
-  const fs8 = await import("fs/promises");
+  const fs9 = await import("fs/promises");
   const pluginManager = new PluginManager2({
     config,
     isDev: false,
@@ -33319,8 +33697,8 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   let postcssConfigDir;
   let tailwindVitePlugin = void 0;
   if (!hasScopedPostcssConfig) {
-    postcssConfigDir = await fs8.mkdtemp(import_path12.default.join(import_os.default.tmpdir(), "farm-postcss-"));
-    await fs8.writeFile(
+    postcssConfigDir = await fs9.mkdtemp(import_path12.default.join(import_os.default.tmpdir(), "farm-postcss-"));
+    await fs9.writeFile(
       import_path12.default.join(postcssConfigDir, "postcss.config.cjs"),
       "module.exports = { plugins: [] };\n"
     );
@@ -33350,7 +33728,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         fileName: entry.fileName,
         sourceType: "static",
         staticInfo: entry.staticInfo,
-        data: (await fs8.readFile(entry.modulePath)).toString("base64")
+        data: (await fs9.readFile(entry.modulePath)).toString("base64")
       });
       continue;
     }
@@ -33400,7 +33778,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
     for (const ext of notFoundExtensions) {
       const checkPath = import_path12.default.join(sourceAppDir, `not-found${ext}`);
       try {
-        await fs8.access(checkPath);
+        await fs9.access(checkPath);
         notFoundPath = checkPath;
         break;
       } catch {
@@ -33547,6 +33925,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
         __FARM_PUBLIC_ENV__: JSON.stringify(config.env?.public || {})
       },
       plugins: [
+        createFarmThemeCssPlugin(config.theme, config.basePath),
         ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
         ...!useExternalMetadataImageRuntime && metadataImageRoutes.some((image) => image.sourceType === "module") ? [createMetadataImageWasmPlugin()] : [],
         {
@@ -33611,7 +33990,7 @@ async function buildSSRInMemory(productionVite, config, root, routeManager, apiR
   } finally {
     if (postcssConfigDir) {
       try {
-        await fs8.rm(postcssConfigDir, { recursive: true, force: true });
+        await fs9.rm(postcssConfigDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -33760,15 +34139,19 @@ function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlot
   _runWithCurrentRequest,
   _runWithMiddlewareContext,
   _runWithMiddlewareData,
+  _setDefaultFarmThemeConfig,
   addMetadataImageReference,
+  applyFarmThemeDocument,
   appendFarmLinkHeader,
   applyProductionMiddlewareHeaders,
   configureFarmCache,
   configureFarmObservability,
   createFarmCacheKey,
+  createFarmThemeDocumentParts,
   createFarmLocaleCookie,
   createFarmProductionLifecycle,
   createProductionMiddlewareRunner,
+  getTheme as getFarmTheme,
   emitFarmEvent,
   getFarmDataCache,
   getFarmLocaleVaryHeaders,
@@ -33963,6 +34346,8 @@ configureFarmObservability(farmObservabilityConfig);
 configureFarmCache(farmResolvedRuntimeConfig.cache);
 const farmI18nConfig = ${JSON.stringify(config.i18n)};
 const farmServerConfig = ${JSON.stringify(config.server)};
+const farmThemeConfig = ${JSON.stringify(config.theme)};
+_setDefaultFarmThemeConfig(farmThemeConfig);
 export const farmProductionLifecycle = createFarmProductionLifecycle({
   server: farmServerConfig,
   start: () => farmPluginRuntime?.startRuntime(),
@@ -35799,7 +36184,13 @@ async function handleFarmRequestInContext(
           !farmI18nSnapshot &&
           !pprCacheKey
         ) {
+          const farmThemeDocument = createFarmThemeDocumentParts(
+            farmThemeConfig,
+            farmResolvedRuntimeConfig.basePath,
+            getFarmTheme(request)
+          );
           const streamPrefix = '<!DOCTYPE html>\\n<html lang="en">\\n<head>\\n' +
+            farmThemeDocument.head + '\\n' +
             '  <meta charset="utf-8">\\n' +
             '  <meta name="viewport" content="width=device-width, initial-scale=1">\\n' +
             (hasFavicon ? '' : '  <link rel="icon" href="data:,">\\n') +
@@ -35815,9 +36206,13 @@ async function handleFarmRequestInContext(
             ) + '\\n' +
             '  <script type="module" src="/farm-client.js"></script>\\n' +
             '</body>\\n</html>';
+          const themedStreamPrefix = streamPrefix.replace(
+            '<html lang="en">',
+            '<html lang="en"' + farmThemeDocument.attributes + '>'
+          );
           const streamedDocument = createFarmDocumentStream(
             renderedPage.stream,
-            streamPrefix,
+            themedStreamPrefix,
             streamSuffix,
             function() {
               if (pprBypassReason === "refresh") {
@@ -35900,6 +36295,12 @@ async function handleFarmRequestInContext(
 </html>\`;
         }
         fullHtml = applyFarmI18nDocument(fullHtml, pathname, farmI18nSnapshot);
+        fullHtml = applyFarmThemeDocument(
+          fullHtml,
+          farmThemeConfig,
+          farmResolvedRuntimeConfig.basePath,
+          getFarmTheme(request)
+        );
 
         if (pageStatus === 200 && pprCacheKey && request.method.toUpperCase() !== "HEAD") {
           await pprShellCache.setAsync(
@@ -36026,10 +36427,15 @@ async function handleFarmRequestInContext(
           const errorHtml = ${hasMiddlewareRuntime ? `await _runWithMiddlewareData(middlewareData, () =>
             _runWithMiddlewareContext(middlewareContext, renderErrorElement)
           )` : "await renderErrorElement()"};
-          const errorDocument = applyFarmI18nDocument(
-            createFarmErrorDocument(errorHtml, "Application Error"),
-            pathname,
-            getFarmI18nSnapshot()
+          const errorDocument = applyFarmThemeDocument(
+            applyFarmI18nDocument(
+              createFarmErrorDocument(errorHtml, "Application Error"),
+              pathname,
+              getFarmI18nSnapshot()
+            ),
+            farmThemeConfig,
+            farmResolvedRuntimeConfig.basePath,
+            getFarmTheme(request)
           );
           emitFarmEvent({
             type: "render.complete",
@@ -36054,10 +36460,15 @@ async function handleFarmRequestInContext(
       const errorMessage = "Internal Server Error";
       const fallbackHtml = '<main><h1>Application Error</h1><p>' +
         escapeFarmHtmlAttribute(errorMessage) + '</p></main>';
-      const fallbackDocument = applyFarmI18nDocument(
-        createFarmErrorDocument(fallbackHtml, "Application Error"),
-        pathname,
-        getFarmI18nSnapshot()
+      const fallbackDocument = applyFarmThemeDocument(
+        applyFarmI18nDocument(
+          createFarmErrorDocument(fallbackHtml, "Application Error"),
+          pathname,
+          getFarmI18nSnapshot()
+        ),
+        farmThemeConfig,
+        farmResolvedRuntimeConfig.basePath,
+        getFarmTheme(request)
       );
       return applyProductionMiddlewareHeaders(new Response(
         fallbackDocument,
@@ -36155,6 +36566,12 @@ async function handleFarmRequestInContext(
 </html>\`;
     }
     fullHtml = applyFarmI18nDocument(fullHtml, pathname, getFarmI18nSnapshot());
+    fullHtml = applyFarmThemeDocument(
+      fullHtml,
+      farmThemeConfig,
+      farmResolvedRuntimeConfig.basePath,
+      getFarmTheme(request)
+    );
     
     emitFarmEvent({
       type: "render.complete",
@@ -36173,8 +36590,14 @@ async function handleFarmRequestInContext(
     }), middlewareHeaders);
   } catch (error) {
     console.error("404 render error:", error);
-    return applyProductionMiddlewareHeaders(new Response(
+    const fallbackDocument = applyFarmThemeDocument(
       \`<!DOCTYPE html><html><head><title>404</title></head><body><h1>404 - Page Not Found</h1><p>The page \${pathname} doesn't exist.</p><a href="/">Go Home</a></body></html>\`,
+      farmThemeConfig,
+      farmResolvedRuntimeConfig.basePath,
+      getFarmTheme(request)
+    );
+    return applyProductionMiddlewareHeaders(new Response(
+      fallbackDocument,
       {
         status: 404,
         headers: { "Content-Type": "text/html", "x-farm-preload-buffered": "1" },
@@ -36462,7 +36885,7 @@ function getPhysicalPrerenderBypassReason(options) {
 }
 __name(getPhysicalPrerenderBypassReason, "getPhysicalPrerenderBypassReason");
 async function buildNitroUniversal(config, routeManager, apiRouteManager, serverRenderer, preset, root, distDir, ssrBundle, ssrEntryFile, clientOutputDir, routeRuntimeManifest, configuredHeaderRoutes, nitroRuntimeResultPromise, pluginManager) {
-  const [fs8, nitroRuntimeResult] = await Promise.all([
+  const [fs9, nitroRuntimeResult] = await Promise.all([
     import("fs/promises"),
     nitroRuntimeResultPromise
   ]);
@@ -36540,11 +36963,11 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   }
   const scheduledTasks = mergeScheduledTasks(farmWorkflows.scheduledTasks, farmCron.scheduledTasks);
   const cloudflareCronConfig = createFarmCronCloudflareConfig(farmCron.jobs);
-  await fs8.mkdir(ssrOutputDir, { recursive: true });
+  await fs9.mkdir(ssrOutputDir, { recursive: true });
   for (const [fileName, output] of Object.entries(ssrBundle)) {
     const filePath = import_path12.default.join(ssrOutputDir, fileName);
-    await fs8.mkdir(import_path12.default.dirname(filePath), { recursive: true });
-    await fs8.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
+    await fs9.mkdir(import_path12.default.dirname(filePath), { recursive: true });
+    await fs9.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
   }
   const nitroEntryPath = import_path12.default.join(ssrOutputDir, "nitro-entry.mjs");
   const nitroEntryCode = `
@@ -36610,10 +37033,10 @@ export default async function farmNitroEventHandler(event) {
   return response
 }
   `.trim();
-  await fs8.writeFile(nitroEntryPath, nitroEntryCode);
+  await fs9.writeFile(nitroEntryPath, nitroEntryCode);
   const farmNodeServerEntryPath = preset === "node-server" ? import_path12.default.join(ssrOutputDir, "farm-node-server-entry.mjs") : null;
   if (farmNodeServerEntryPath) {
-    await fs8.writeFile(
+    await fs9.writeFile(
       farmNodeServerEntryPath,
       createFarmNodeServerEntry({
         nitroEntryFile: import_path12.default.basename(nitroEntryPath),
@@ -36813,9 +37236,9 @@ export default async function farmNitroEventHandler(event) {
           import_path12.default.join(prerenderServerDir, FARM_SSR_OUTPUT_DIR),
           {},
           false,
-          fs8
+          fs9
         );
-        await registerPrebuiltSSRPackageImport(prerenderServerDir, ssrEntryFile, fs8);
+        await registerPrebuiltSSRPackageImport(prerenderServerDir, ssrEntryFile, fs9);
       });
     });
   }
@@ -36847,17 +37270,17 @@ export default async function farmNitroEventHandler(event) {
       import_path12.default.join(outputDir, "server", FARM_SSR_OUTPUT_DIR),
       configuredEsbuildOptions,
       effectiveMinify,
-      fs8
+      fs9
     ) : Promise.resolve(),
-    imageRuntime === "node" ? copySharpRuntime(config, root, import_path12.default.join(outputDir, "server"), fs8) : Promise.resolve(),
-    useExternalMetadataImageRuntime ? copyMetadataImageRuntime(root, import_path12.default.join(outputDir, "server"), fs8) : Promise.resolve()
+    imageRuntime === "node" ? copySharpRuntime(config, root, import_path12.default.join(outputDir, "server"), fs9) : Promise.resolve(),
+    useExternalMetadataImageRuntime ? copyMetadataImageRuntime(root, import_path12.default.join(outputDir, "server"), fs9) : Promise.resolve()
   ]);
   const failedCopy = copyResults.find(
     (result) => result.status === "rejected"
   );
   if (failedCopy) throw failedCopy.reason;
   if (canReusePrebuiltSSR) {
-    await registerPrebuiltSSRPackageImport(import_path12.default.join(outputDir, "server"), ssrEntryFile, fs8);
+    await registerPrebuiltSSRPackageImport(import_path12.default.join(outputDir, "server"), ssrEntryFile, fs9);
     logger.info("\u26A1 Reused Farm's prebuilt SSR bundle for the Node output");
   }
   if (useRolldownBuilder) {
@@ -36872,12 +37295,12 @@ export default async function farmNitroEventHandler(event) {
     });
   }
   if (isVercel) {
-    await postProcessVercelOutput(root, outputDir, fs8, config, farmWorkflows, routeRuntimeManifest);
+    await postProcessVercelOutput(root, outputDir, fs9, config, farmWorkflows, routeRuntimeManifest);
   }
   logger.success(`\u2705 Nitro build completed with preset: ${preset}`);
 }
 __name(buildNitroUniversal, "buildNitroUniversal");
-async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOptions, minify, fs8) {
+async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOptions, minify, fs9) {
   const {
     include: _include,
     exclude: _exclude,
@@ -36894,13 +37317,13 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
     "node18"
   );
   const transform = minify || hasConfiguredTransforms ? (await import("esbuild")).transform : null;
-  await fs8.rm(targetDir, { recursive: true, force: true });
+  await fs9.rm(targetDir, { recursive: true, force: true });
   await Promise.all(
     Object.entries(ssrBundle).map(async ([fileName, output]) => {
       const targetPath = import_path12.default.join(targetDir, fileName);
-      await fs8.mkdir(import_path12.default.dirname(targetPath), { recursive: true });
+      await fs9.mkdir(import_path12.default.dirname(targetPath), { recursive: true });
       if (output.type === "asset") {
-        await fs8.writeFile(targetPath, output.source);
+        await fs9.writeFile(targetPath, output.source);
         return;
       }
       let code = output.code;
@@ -36911,14 +37334,14 @@ async function copyPrebuiltSSRBundle(ssrBundle, targetDir, configuredEsbuildOpti
         });
         code = result.code;
       }
-      await fs8.writeFile(targetPath, code);
+      await fs9.writeFile(targetPath, code);
     })
   );
 }
 __name(copyPrebuiltSSRBundle, "copyPrebuiltSSRBundle");
-async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs8) {
+async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs9) {
   const packagePath = import_path12.default.join(serverDir, "package.json");
-  const packageJSON = await fs8.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
+  const packageJSON = await fs9.readFile(packagePath, "utf8").then((contents) => JSON.parse(contents)).catch((error) => {
     if (error.code === "ENOENT") return { type: "module" };
     throw error;
   });
@@ -36928,38 +37351,38 @@ async function registerPrebuiltSSRPackageImport(serverDir, ssrEntryFile, fs8) {
     ...existingImports,
     [FARM_SSR_PACKAGE_IMPORT]: `./${outputEntry}`
   };
-  await fs8.mkdir(serverDir, { recursive: true });
-  await fs8.writeFile(packagePath, `${JSON.stringify(packageJSON, null, 2)}
+  await fs9.mkdir(serverDir, { recursive: true });
+  await fs9.writeFile(packagePath, `${JSON.stringify(packageJSON, null, 2)}
 `);
 }
 __name(registerPrebuiltSSRPackageImport, "registerPrebuiltSSRPackageImport");
-async function postProcessVercelOutput(root, outputDir, fs8, config, farmWorkflows, routeRuntimeManifest) {
+async function postProcessVercelOutput(root, outputDir, fs9, config, farmWorkflows, routeRuntimeManifest) {
   const serverDir = import_path12.default.join(outputDir, "server");
   const functionsDir = import_path12.default.join(outputDir, "functions");
   const nitroFuncDir = import_path12.default.join(functionsDir, "__nitro.func");
   const staticDir = import_path12.default.join(outputDir, "static");
   const publicDir = import_path12.default.join(outputDir, "public");
-  await fs8.mkdir(nitroFuncDir, { recursive: true });
-  const serverContents = await fs8.readdir(serverDir);
+  await fs9.mkdir(nitroFuncDir, { recursive: true });
+  const serverContents = await fs9.readdir(serverDir);
   for (const file of serverContents) {
     const src = import_path12.default.join(serverDir, file);
     const dest = import_path12.default.join(nitroFuncDir, file);
-    await fs8.rename(src, dest);
+    await fs9.rename(src, dest);
   }
-  await fs8.rmdir(serverDir);
+  await fs9.rmdir(serverDir);
   try {
-    await fs8.rename(publicDir, staticDir);
+    await fs9.rename(publicDir, staticDir);
   } catch {
   }
-  await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs8);
-  await copyPrismaClientForVercel(root, nitroFuncDir, fs8);
+  await copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs9);
+  await copyPrismaClientForVercel(root, nitroFuncDir, fs9);
   const configPath = import_path12.default.join(outputDir, "config.json");
-  const configContent = await fs8.readFile(configPath, "utf-8");
+  const configContent = await fs9.readFile(configPath, "utf-8");
   const vercelConfig = JSON.parse(configContent);
   const runtimeRoutes = await createFarmVercelRouteRuntimeFunctions(
     outputDir,
     routeRuntimeManifest,
-    fs8
+    fs9
   );
   vercelConfig.routes = [
     // Apply the header before the filesystem handler. `continue` lets Vercel
@@ -36994,24 +37417,24 @@ async function postProcessVercelOutput(root, outputDir, fs8, config, farmWorkflo
     vercelConfigWithWorkflowCrons,
     config.cron.jobs
   );
-  await fs8.writeFile(configPath, JSON.stringify(vercelConfigWithCrons, null, 2));
+  await fs9.writeFile(configPath, JSON.stringify(vercelConfigWithCrons, null, 2));
   logger.info("\u2705 Post-processed Vercel output for Build Output API v3");
 }
 __name(postProcessVercelOutput, "postProcessVercelOutput");
-async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs8) {
+async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs9) {
   const docsContentDir = resolveBuildDocsContentDir(config, root);
   if (!docsContentDir) return;
   const bundledContentDir = import_path12.default.join(nitroFuncDir, "chunks", "nitro", "farm-docs-content");
   const lastModifiedManifest = createFarmDocsLastModifiedManifest(docsContentDir, {
     fallback: "now"
   });
-  await fs8.rm(bundledContentDir, { recursive: true, force: true });
-  await fs8.mkdir(import_path12.default.dirname(bundledContentDir), { recursive: true });
-  await fs8.cp(docsContentDir, bundledContentDir, {
+  await fs9.rm(bundledContentDir, { recursive: true, force: true });
+  await fs9.mkdir(import_path12.default.dirname(bundledContentDir), { recursive: true });
+  await fs9.cp(docsContentDir, bundledContentDir, {
     recursive: true,
     force: true
   });
-  await fs8.writeFile(
+  await fs9.writeFile(
     import_path12.default.join(bundledContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST),
     `${JSON.stringify(lastModifiedManifest, null, 2)}
 `
@@ -37019,7 +37442,7 @@ async function copyFarmDocsContentForVercel(config, root, nitroFuncDir, fs8) {
   logger.info(`\u{1F4DA} Bundled docs content for Vercel: ${import_path12.default.relative(root, docsContentDir)}`);
 }
 __name(copyFarmDocsContentForVercel, "copyFarmDocsContentForVercel");
-async function copySharpRuntime(config, root, nitroFuncDir, fs8) {
+async function copySharpRuntime(config, root, nitroFuncDir, fs9) {
   if (config.images.provider === "none") return;
   const projectRequire = (0, import_module2.createRequire)(import_path12.default.join(root, "package.json"));
   let sharpRequire = projectRequire;
@@ -37043,18 +37466,18 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs8) {
   async function copyPackageOnce(packageName, parentRequire) {
     const packageJsonPath = resolvePackageJson(parentRequire, packageName);
     if (!packageJsonPath) return;
-    const packageJson = JSON.parse(await fs8.readFile(packageJsonPath, "utf8"));
+    const packageJson = JSON.parse(await fs9.readFile(packageJsonPath, "utf8"));
     const packageDir = import_path12.default.dirname(packageJsonPath);
     const targetDir = import_path12.default.join(targetNodeModules, ...packageName.split("/"));
     copiedPackages.set(packageName, String(packageJson.version || "*"));
-    await fs8.mkdir(import_path12.default.dirname(targetDir), { recursive: true });
+    await fs9.mkdir(import_path12.default.dirname(targetDir), { recursive: true });
     const packageRequire = (0, import_module2.createRequire)(packageJsonPath);
     const dependencies = {
       ...packageJson.dependencies,
       ...packageJson.optionalDependencies
     };
     await Promise.all([
-      fs8.cp(packageDir, targetDir, {
+      fs9.cp(packageDir, targetDir, {
         recursive: true,
         force: true,
         dereference: true,
@@ -37073,16 +37496,16 @@ async function copySharpRuntime(config, root, nitroFuncDir, fs8) {
     );
   }
   const functionPackagePath = import_path12.default.join(nitroFuncDir, "package.json");
-  const functionPackage = JSON.parse(await fs8.readFile(functionPackagePath, "utf8"));
+  const functionPackage = JSON.parse(await fs9.readFile(functionPackagePath, "utf8"));
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
     ...Object.fromEntries([...copiedPackages].sort(([left], [right]) => left.localeCompare(right)))
   };
-  await fs8.writeFile(functionPackagePath, JSON.stringify(functionPackage, null, 2));
+  await fs9.writeFile(functionPackagePath, JSON.stringify(functionPackage, null, 2));
   logger.info(`\u{1F5BC}\uFE0F  Bundled Sharp image runtime (${copiedPackages.size} packages)`);
 }
 __name(copySharpRuntime, "copySharpRuntime");
-async function copyMetadataImageRuntime(root, nitroFuncDir, fs8) {
+async function copyMetadataImageRuntime(root, nitroFuncDir, fs9) {
   const projectRequire = (0, import_module2.createRequire)(import_path12.default.join(root, "package.json"));
   let runtimeRequire = projectRequire;
   let packageJsonPath = resolvePackageJson(runtimeRequire, "@vercel/og");
@@ -37098,23 +37521,23 @@ async function copyMetadataImageRuntime(root, nitroFuncDir, fs8) {
       "Generated metadata images require @vercel/og. Reinstall @farm.js/core with production dependencies."
     );
   }
-  const packageJson = JSON.parse(await fs8.readFile(packageJsonPath, "utf8"));
+  const packageJson = JSON.parse(await fs9.readFile(packageJsonPath, "utf8"));
   const packageDir = import_path12.default.dirname(packageJsonPath);
   const targetDir = import_path12.default.join(nitroFuncDir, "node_modules", "@vercel", "og");
-  await fs8.mkdir(import_path12.default.dirname(targetDir), { recursive: true });
-  await fs8.cp(packageDir, targetDir, {
+  await fs9.mkdir(import_path12.default.dirname(targetDir), { recursive: true });
+  await fs9.cp(packageDir, targetDir, {
     recursive: true,
     force: true,
     dereference: true,
     mode: import_fs5.constants.COPYFILE_FICLONE
   });
   const functionPackagePath = import_path12.default.join(nitroFuncDir, "package.json");
-  const functionPackage = JSON.parse(await fs8.readFile(functionPackagePath, "utf8"));
+  const functionPackage = JSON.parse(await fs9.readFile(functionPackagePath, "utf8"));
   functionPackage.dependencies = {
     ...functionPackage.dependencies,
     "@vercel/og": String(packageJson.version || "0.11.1")
   };
-  await fs8.writeFile(functionPackagePath, JSON.stringify(functionPackage, null, 2));
+  await fs9.writeFile(functionPackagePath, JSON.stringify(functionPackage, null, 2));
   logger.info("\u{1F5BC}\uFE0F  Bundled generated metadata image runtime");
 }
 __name(copyMetadataImageRuntime, "copyMetadataImageRuntime");
@@ -37128,7 +37551,7 @@ function resolvePackageJson(parentRequire, packageName) {
   return null;
 }
 __name(resolvePackageJson, "resolvePackageJson");
-async function copyPrismaClientForVercel(root, nitroFuncDir, fs8) {
+async function copyPrismaClientForVercel(root, nitroFuncDir, fs9) {
   const projectRequire = (0, import_module2.createRequire)(import_path12.default.join(root, "package.json"));
   let prismaClientDir;
   try {
@@ -37138,7 +37561,7 @@ async function copyPrismaClientForVercel(root, nitroFuncDir, fs8) {
   }
   const generatedClientDir = import_path12.default.join(prismaClientDir, "..", "..", ".prisma", "client");
   try {
-    await fs8.access(generatedClientDir);
+    await fs9.access(generatedClientDir);
   } catch {
     return;
   }
@@ -37146,20 +37569,20 @@ async function copyPrismaClientForVercel(root, nitroFuncDir, fs8) {
   const targetPrismaScopeDir = import_path12.default.join(targetNodeModules, "@prisma");
   const targetGeneratedDir = import_path12.default.join(targetNodeModules, ".prisma", "client");
   const targetClientDir = import_path12.default.join(targetPrismaScopeDir, "client");
-  await fs8.mkdir(targetPrismaScopeDir, { recursive: true });
-  await fs8.cp(prismaClientDir, targetClientDir, {
+  await fs9.mkdir(targetPrismaScopeDir, { recursive: true });
+  await fs9.cp(prismaClientDir, targetClientDir, {
     recursive: true,
     force: true
   });
-  await fs8.cp(generatedClientDir, targetGeneratedDir, {
+  await fs9.cp(generatedClientDir, targetGeneratedDir, {
     recursive: true,
     force: true
   });
   const functionPackagePath = import_path12.default.join(nitroFuncDir, "package.json");
   const clientPackagePath = import_path12.default.join(prismaClientDir, "package.json");
   const [functionPackageContent, clientPackageContent] = await Promise.all([
-    fs8.readFile(functionPackagePath, "utf-8"),
-    fs8.readFile(clientPackagePath, "utf-8")
+    fs9.readFile(functionPackagePath, "utf-8"),
+    fs9.readFile(clientPackagePath, "utf-8")
   ]);
   const functionPackage = JSON.parse(functionPackageContent);
   const clientPackage = JSON.parse(clientPackageContent);
@@ -37167,7 +37590,7 @@ async function copyPrismaClientForVercel(root, nitroFuncDir, fs8) {
     ...functionPackage.dependencies,
     "@prisma/client": clientPackage.version
   };
-  await fs8.writeFile(functionPackagePath, JSON.stringify(functionPackage, null, 2));
+  await fs9.writeFile(functionPackagePath, JSON.stringify(functionPackage, null, 2));
 }
 __name(copyPrismaClientForVercel, "copyPrismaClientForVercel");
 
@@ -37401,7 +37824,7 @@ async function createProjectModuleServer(createViteServer, config, root) {
 }
 __name(createProjectModuleServer, "createProjectModuleServer");
 async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
-  const { farmI18nClientBridgePlugin: farmI18nClientBridgePlugin2, farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite(), vite_exports));
+  const { farmI18nClientBridgePlugin: farmI18nClientBridgePlugin2, farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite2(), vite_exports));
   const { PluginManager: PluginManager2 } = await Promise.resolve().then(() => (init_plugin(), plugin_exports));
   const pluginManager = new PluginManager2({
     config,
@@ -37428,7 +37851,7 @@ async function buildClient2(viteBuild, config, root, srcDir, outputDir) {
 }
 __name(buildClient2, "buildClient");
 async function buildSSR(viteBuild, config, root, srcDir, outputDir) {
-  const { farmI18nClientBridgePlugin: farmI18nClientBridgePlugin2, farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite(), vite_exports));
+  const { farmI18nClientBridgePlugin: farmI18nClientBridgePlugin2, farmPlugin: farmPlugin2 } = await Promise.resolve().then(() => (init_vite2(), vite_exports));
   const { PluginManager: PluginManager2 } = await Promise.resolve().then(() => (init_plugin(), plugin_exports));
   const pluginManager = new PluginManager2({
     config,
@@ -37489,10 +37912,10 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
     const manifestPath = import_path14.default.join(publicOutputDir, "farm-client-manifest.json");
     const assetsDir = import_path14.default.join(publicOutputDir, "assets");
     const manifestExists = await import("fs/promises").then(
-      (fs8) => fs8.access(manifestPath).then(() => true).catch(() => false)
+      (fs9) => fs9.access(manifestPath).then(() => true).catch(() => false)
     );
     const assetsExist = await import("fs/promises").then(
-      (fs8) => fs8.access(assetsDir).then(() => true).catch(() => false)
+      (fs9) => fs9.access(assetsDir).then(() => true).catch(() => false)
     );
     if (manifestExists && assetsExist) {
       logger.info("\u2705 Verified client assets are present");
@@ -37553,7 +37976,7 @@ async function buildNitro(config, routeManager, apiRouteManager, serverRenderer,
 __name(buildNitro, "buildNitro");
 
 // src/nitro/build-runtime.ts
-init_config2();
+init_config3();
 init_utils();
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {