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

package/dist/server.cjs

@@ -580,11 +580,11 @@ function resolveFarmServerHealthConfig(config) {
   return Object.freeze({ enabled: true, livenessPath, readinessPath });
 }
 function normalizeHealthPath(value, optionName) {
-  const path27 = value.trim();
-  if (!path27.startsWith("/") || path27.includes("?") || path27.includes("#") || path27.includes("*")) {
+  const path28 = value.trim();
+  if (!path28.startsWith("/") || path28.includes("?") || path28.includes("#") || path28.includes("*")) {
     throw new TypeError(`${optionName} must be an absolute pathname without a query or wildcard`);
   }
-  return path27.length > 1 ? path27.replace(/\/+$/, "") || "/" : path27;
+  return path28.length > 1 ? path28.replace(/\/+$/, "") || "/" : path28;
 }
 function parseBodySizeLimit(value, optionName = "bodySizeLimit") {
   if (typeof value === "number") {
@@ -681,7 +681,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;
@@ -710,7 +710,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);
@@ -939,22 +939,22 @@ async function prepareFarmWorkflowsForNitro(config) {
   }
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
-  const generatedDir = path27.join(root, distDir, ".nitro", "farm-workflows");
-  await fs9.mkdir(generatedDir, { recursive: true });
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
+  const generatedDir = path28.join(root, distDir, ".nitro", "farm-workflows");
+  await fs10.mkdir(generatedDir, { recursive: true });
   const tasks = {};
   const scheduledTasks = createScheduledTasks(workflows);
   for (const workflow of workflows) {
-    const wrapperPath = path27.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
-    await fs9.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
+    const wrapperPath = path28.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
+    await fs10.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
     tasks[workflow.id] = {
       handler: wrapperPath,
       description: workflow.description || `Farm workflow ${workflow.id}`
     };
   }
-  const handlerPath = path27.join(generatedDir, "http-handler.mjs");
-  await fs9.writeFile(
+  const handlerPath = path28.join(generatedDir, "http-handler.mjs");
+  await fs10.writeFile(
     handlerPath,
     createNitroWorkflowHTTPHandler(
       workflowConfig,
@@ -963,8 +963,8 @@ async function prepareFarmWorkflowsForNitro(config) {
     ),
     "utf8"
   );
-  const manifestPath = path27.join(generatedDir, "manifest.json");
-  await fs9.writeFile(
+  const manifestPath = path28.join(generatedDir, "manifest.json");
+  await fs10.writeFile(
     manifestPath,
     JSON.stringify(
       {
@@ -1045,22 +1045,22 @@ function resolveWorkflowDefinition(module2) {
   return null;
 }
 async function findWorkflowFiles(root, dirs) {
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
   const files = [];
   for (const dir of dirs) {
-    const absoluteDir = path27.isAbsolute(dir) ? dir : path27.join(root, dir);
+    const absoluteDir = path28.isAbsolute(dir) ? dir : path28.join(root, dir);
     if (!await pathExists(absoluteDir)) continue;
     await walkWorkflowDir(absoluteDir, files);
   }
   return files.sort();
 }
 async function walkWorkflowDir(dir, files) {
-  const fs9 = await import("fs/promises");
-  const path27 = await import("path");
-  const entries = await fs9.readdir(dir, { withFileTypes: true });
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
+  const entries = await fs10.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const filePath = path27.join(dir, entry.name);
+    const filePath = path28.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
       await walkWorkflowDir(filePath, files);
@@ -1072,20 +1072,20 @@ async function walkWorkflowDir(dir, files) {
   }
 }
 async function pathExists(filePath) {
-  const fs9 = await import("fs/promises");
-  return fs9.access(filePath).then(() => true).catch(() => false);
+  const fs10 = await import("fs/promises");
+  return fs10.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 fs9 = await import("fs/promises");
-  const path27 = await import("path");
+  const fs10 = await import("fs/promises");
+  const path28 = await import("path");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const { build } = await import("esbuild");
-  const outDir = path27.join(root, ".farm", ".workflow-loader");
-  await fs9.mkdir(outDir, { recursive: true });
-  const outfile = path27.join(
+  const outDir = path28.join(root, ".farm", ".workflow-loader");
+  await fs10.mkdir(outDir, { recursive: true });
+  const outfile = path28.join(
     outDir,
     `workflow-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
   );
@@ -1109,7 +1109,7 @@ async function loadWorkflowModule(filePath, root) {
       `${pathToFileURL5(outfile).href}?t=${Date.now()}`
     );
   } finally {
-    await fs9.unlink(outfile).catch(() => void 0);
+    await fs10.unlink(outfile).catch(() => void 0);
   }
 }
 function workflowIdFromFile(root, filePath) {
@@ -1384,7 +1384,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 path27 = normalizeCronPath(name, job.path);
+  const path28 = 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) {
@@ -1393,7 +1393,7 @@ function normalizeCronJob(name, job) {
   return {
     name,
     schedule,
-    path: path27,
+    path: path28,
     description: job.description?.trim() || void 0
   };
 }
@@ -1401,13 +1401,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 path27 = value.trim();
-  if (path27.startsWith("//") || path27.includes("?") || path27.includes("#")) {
+  const path28 = value.trim();
+  if (path28.startsWith("//") || path28.includes("?") || path28.includes("#")) {
     throw new TypeError(
       `Farm cron ${JSON.stringify(name)} path must be an application pathname without a host, query, or hash.`
     );
   }
-  return path27.length > 1 ? path27.replace(/\/+$/, "") : path27;
+  return path28.length > 1 ? path28.replace(/\/+$/, "") : path28;
 }
 function normalizeCronExpression(name, value) {
   if (typeof value !== "string") {
@@ -2687,7 +2687,7 @@ var init_server_action_security = __esm({
 
 // src/image-config.ts
 function resolveFarmImageConfig(config) {
-  const path27 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
+  const path28 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
   const deviceSizes = normalizeIntegerList(
     config?.deviceSizes ?? DEFAULT_FARM_IMAGE_DEVICE_SIZES,
     "images.deviceSizes"
@@ -2715,7 +2715,7 @@ function resolveFarmImageConfig(config) {
   );
   return Object.freeze({
     provider: config?.provider ?? "auto",
-    path: path27,
+    path: path28,
     domains: Object.freeze([
       ...new Set(
         (config?.domains ?? []).map((domain) => domain.trim().toLowerCase()).filter(Boolean)
@@ -2754,11 +2754,11 @@ function getPublicFarmImageConfig(config) {
   };
 }
 function normalizeImagePath(value) {
-  const path27 = value.trim().replace(/\/+$/, "") || "/";
-  if (!path27.startsWith("/") || path27.includes("?") || path27.includes("#")) {
+  const path28 = value.trim().replace(/\/+$/, "") || "/";
+  if (!path28.startsWith("/") || path28.includes("?") || path28.includes("#")) {
     throw new TypeError("images.path must be an absolute pathname without a query or hash");
   }
-  return path27;
+  return path28;
 }
 function normalizeIntegerList(values, name, max) {
   if (values.length === 0) {
@@ -3621,9 +3621,9 @@ function getFarmIntegrationPluginOwner(plugin) {
   const value = plugin[FARM_INTEGRATION_PLUGIN_OWNER];
   return value && typeof value === "object" ? value : void 0;
 }
-function defineTypedIntegrationRoute(method, path27, input) {
+function defineTypedIntegrationRoute(method, path28, input) {
   return {
-    path: path27,
+    path: path28,
     method,
     middleware: input.middleware,
     before: input.before,
@@ -3633,7 +3633,7 @@ function defineTypedIntegrationRoute(method, path27, input) {
     input: normalizeIntegrationRouteInputSchemas(input),
     handler: input.handler,
     __operation: defineIntegrationAPIOperation({
-      path: path27,
+      path: path28,
       method,
       bodyFormat: input.bodyFormat,
       responseFormat: input.responseFormat,
@@ -3645,52 +3645,52 @@ function defineTypedIntegrationRoute(method, path27, input) {
 }
 function createIntegrationRouteFactory() {
   return {
-    get(path27, input) {
+    get(path28, input) {
       return defineTypedIntegrationRoute(
         "GET",
-        path27,
+        path28,
         input
       );
     },
-    post(path27, input) {
+    post(path28, input) {
       return defineTypedIntegrationRoute(
         "POST",
-        path27,
+        path28,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    put(path27, input) {
+    put(path28, input) {
       return defineTypedIntegrationRoute(
         "PUT",
-        path27,
+        path28,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    patch(path27, input) {
-      return defineTypedIntegrationRoute("PATCH", path27, {
+    patch(path28, input) {
+      return defineTypedIntegrationRoute("PATCH", path28, {
         bodyFormat: "json",
         ...input
       });
     },
-    delete(path27, input) {
-      return defineTypedIntegrationRoute("DELETE", path27, {
+    delete(path28, input) {
+      return defineTypedIntegrationRoute("DELETE", path28, {
         bodyFormat: "json",
         ...input
       });
     },
-    options(path27, input) {
-      return defineTypedIntegrationRoute("OPTIONS", path27, input);
+    options(path28, input) {
+      return defineTypedIntegrationRoute("OPTIONS", path28, input);
     },
-    head(path27, input) {
+    head(path28, input) {
       return defineTypedIntegrationRoute(
         "HEAD",
-        path27,
+        path28,
         input
       );
     }
@@ -3964,8 +3964,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 path27 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
-    return `${path27}${issue.message || "Invalid config"}`;
+    const path28 = normalizedPath.length ? `${normalizedPath.join(".")}: ` : "";
+    return `${path28}${issue.message || "Invalid config"}`;
   }).join("; ") : error.message || "Invalid config";
   return new Error(`Integration "${integration.type}" config validation failed: ${issues}`);
 }
@@ -4662,8 +4662,8 @@ function normalizeIntegrationValidationIssues(source, error) {
     }
   ];
 }
-function normalizeIntegrationValidationPath(path27) {
-  return (path27 || []).map((segment) => {
+function normalizeIntegrationValidationPath(path28) {
+  return (path28 || []).map((segment) => {
     const key = typeof segment === "object" && segment !== null && "key" in segment ? segment.key : segment;
     return typeof key === "symbol" ? key.description || key.toString() : key;
   });
@@ -5461,8 +5461,8 @@ function createFarmDeploymentMismatchResponse(mismatch) {
     }
   );
 }
-function createFarmDeploymentCookie(deploymentId, path27 = "/", secure = false) {
-  const normalizedPath = path27.startsWith("/") ? path27 : `/${path27}`;
+function createFarmDeploymentCookie(deploymentId, path28 = "/", secure = false) {
+  const normalizedPath = path28.startsWith("/") ? path28 : `/${path28}`;
   return [
     `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,
     `Path=${normalizedPath}`,
@@ -5632,6 +5632,52 @@ var init_config = __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/devtools-config.ts
 function resolveFarmDevtoolsConfig(config, mode = "development") {
   if (mode !== "development" || config === false) {
@@ -6029,11 +6075,11 @@ var init_type_generator = __esm({
           routeGroups.get(key).push(route);
         }
         const nestedStructure = {};
-        for (const [path27, routeList] of routeGroups) {
+        for (const [path28, routeList] of routeGroups) {
           const route = routeList[0];
           const importPath = this.getRouteImportPath(route, options.outFile);
           const routeName = this.pathToRouteName(route.path);
-          const cleanPath = path27 === "/api" ? "" : path27.replace(/^\/api\//, "");
+          const cleanPath = path28 === "/api" ? "" : path28.replace(/^\/api\//, "");
           const parts = cleanPath ? cleanPath.split("/") : [];
           const allMethods = routeList.flatMap((r) => r.methods);
           for (const method of allMethods) {
@@ -6092,8 +6138,8 @@ ${typeExports}
         const relativeImport = (0, import_path7.relative)((0, import_path7.dirname)(outFile), route.filePath).replace(/\\/g, "/").replace(/\.(ts|tsx|js|jsx)$/, "");
         return relativeImport.startsWith(".") ? relativeImport : `./${relativeImport}`;
       }
-      pathToRouteName(path27) {
-        return (path27 === "/api" ? "root" : path27.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
+      pathToRouteName(path28) {
+        return (path28 === "/api" ? "root" : path28.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
       }
       structureToTypeString(obj, indent) {
         const spaces = "  ".repeat(indent);
@@ -6113,15 +6159,15 @@ ${typeExports}
       toTypePropertyKey(key) {
         return /^[$A-Z_][0-9A-Z_$]*$/i.test(key) ? key : JSON.stringify(key);
       }
-      getBaseExportName(path27) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      getBaseExportName(path28) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return "api";
         }
         return cleanPath;
       }
-      getExportName(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      getExportName(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return method.toLowerCase();
         }
@@ -10527,37 +10573,37 @@ function sanitizeDocsConfig(config) {
   return cloneSerializable(config) || {};
 }
 async function findDocsConfigPath(rootDir, configPath) {
-  const { existsSync: existsSync16 } = await import("fs");
+  const { existsSync: existsSync17 } = await import("fs");
   const root = import_path9.default.resolve(rootDir || process.cwd());
   if (configPath) {
     const resolvedPath = import_path9.default.isAbsolute(configPath) ? configPath : import_path9.default.join(root, configPath);
-    if (!existsSync16(resolvedPath)) {
+    if (!existsSync17(resolvedPath)) {
       throw new Error(`Could not find docs config at ${configPath}.`);
     }
     return import_path9.default.resolve(resolvedPath);
   }
   for (const filename of DOCS_CONFIG_FILENAMES) {
     const resolvedPath = import_path9.default.join(root, filename);
-    if (existsSync16(resolvedPath)) {
+    if (existsSync17(resolvedPath)) {
       return resolvedPath;
     }
   }
   return void 0;
 }
 async function loadDocsConfig(rootDir, configPath) {
-  const fs9 = await import("fs/promises");
+  const fs10 = await import("fs/promises");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const root = import_path9.default.resolve(rootDir || process.cwd());
   const resolvedPath = await findDocsConfigPath(root, configPath);
   if (!resolvedPath) return void 0;
   try {
     if (resolvedPath.endsWith(".json")) {
-      const content = await fs9.readFile(resolvedPath, "utf8");
+      const content = await fs10.readFile(resolvedPath, "utf8");
       return { config: JSON.parse(content), configPath: resolvedPath };
     }
     const { build } = await import("esbuild");
     const configCacheDir = import_path9.default.join(root, ".farm", ".config-loader");
-    await fs9.mkdir(configCacheDir, { recursive: true });
+    await fs10.mkdir(configCacheDir, { recursive: true });
     const modulePath = import_path9.default.join(
       configCacheDir,
       `docs-config-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
@@ -10583,7 +10629,7 @@ async function loadDocsConfig(rootDir, configPath) {
         moduleUrl
       );
     } finally {
-      await fs9.unlink(modulePath).catch(() => void 0);
+      await fs10.unlink(modulePath).catch(() => void 0);
     }
     return {
       config: importedConfig.default || importedConfig,
@@ -10733,6 +10779,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: {
@@ -10773,7 +10820,7 @@ async function resolveConfig(userConfig, mode) {
   return resolved;
 }
 async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "production" ? "production" : "development", loadEnvironment) {
-  const { existsSync: existsSync16 } = await import("fs");
+  const { existsSync: existsSync17 } = await import("fs");
   const loadEnv = loadEnvironment || (await import("vite")).loadEnv;
   const root = rootDir || process.cwd();
   const loadedEnv = loadEnv(mode, root, "");
@@ -10797,7 +10844,7 @@ async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "
     try {
       const absolutePath = relativePath2.startsWith("/") ? relativePath2 : import_path9.default.join(root, relativePath2);
       const normalizedPath = import_path9.default.resolve(absolutePath);
-      if (!existsSync16(normalizedPath)) {
+      if (!existsSync17(normalizedPath)) {
         continue;
       }
       const loadedConfig = await loadFarmConfigFile(normalizedPath, { root });
@@ -10810,7 +10857,7 @@ async function loadConfig(rootDir, configPath, mode = process.env.NODE_ENV === "
   return void 0;
 }
 var import_path9, FARM_RESOLVED_CUSTOM_CONTEXT, DOCS_CONFIG_FILENAMES;
-var init_config2 = __esm({
+var init_config3 = __esm({
   "src/config.ts"() {
     "use strict";
     init_integrations();
@@ -10831,6 +10878,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(normalizeDeployTarget, "normalizeDeployTarget");
@@ -11333,7 +11381,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");
@@ -11627,8 +11675,8 @@ var init_generator = __esm({
           }
           routeGroups.get(key).push(route);
         }
-        for (const [path27, routeList] of routeGroups) {
-          const openAPIPath = this.convertToOpenAPIPath(path27);
+        for (const [path28, routeList] of routeGroups) {
+          const openAPIPath = this.convertToOpenAPIPath(path28);
           spec.paths[openAPIPath] = {};
           for (const route of routeList) {
             for (const method of route.methods) {
@@ -11642,8 +11690,8 @@ var init_generator = __esm({
       /**
        * Convert Farm.js API path to OpenAPI path format
        */
-      convertToOpenAPIPath(path27) {
-        return path27.replace(/^\/api/, "");
+      convertToOpenAPIPath(path28) {
+        return path28.replace(/^\/api/, "");
       }
       /**
        * Extract request body schema from endpoint
@@ -11805,8 +11853,8 @@ var init_generator = __esm({
       /**
        * Generate operation summary
        */
-      generateSummary(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      generateSummary(path28, method) {
+        const cleanPath = path28.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;
@@ -11815,22 +11863,22 @@ var init_generator = __esm({
       /**
        * Generate operation description
        */
-      generateDescription(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      generateDescription(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         return `${method} ${cleanPath} endpoint`;
       }
       /**
        * Generate operation ID
        */
-      generateOperationId(path27, method) {
-        const cleanPath = path27.replace(/^\/api\//, "").replace(/\//g, "_");
+      generateOperationId(path28, method) {
+        const cleanPath = path28.replace(/^\/api\//, "").replace(/\//g, "_");
         return `${method.toLowerCase()}_${cleanPath}`;
       }
       /**
        * Generate tags for grouping operations
        */
-      generateTags(path27) {
-        const cleanPath = path27.replace(/^\/api\//, "");
+      generateTags(path28) {
+        const cleanPath = path28.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         if (pathParts.length > 1) {
           return [pathParts[0]];
@@ -11842,13 +11890,13 @@ var init_generator = __esm({
        */
       async generateSpecFile(routes, outputPath) {
         const spec = await this.generateSpec(routes);
-        const fs9 = require("fs");
-        const path27 = require("path");
-        const dir = path27.dirname(outputPath);
-        if (!fs9.existsSync(dir)) {
-          fs9.mkdirSync(dir, { recursive: true });
+        const fs10 = require("fs");
+        const path28 = require("path");
+        const dir = path28.dirname(outputPath);
+        if (!fs10.existsSync(dir)) {
+          fs10.mkdirSync(dir, { recursive: true });
         }
-        fs9.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
+        fs10.writeFileSync(outputPath, JSON.stringify(spec, null, 2));
       }
     };
     __name(_OpenAPIGenerator, "OpenAPIGenerator");
@@ -12318,7 +12366,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");
@@ -14025,6 +14073,8 @@ __export(server_exports, {
   getServerActionInvalidations: () => getServerActionInvalidations,
   getServerActionSignal: () => getServerActionSignal,
   getStorage: () => getStorage,
+  getTheme: () => getTheme,
+  getThemeSnapshot: () => getThemeSnapshot,
   globFiles: () => globFiles,
   initStorage: () => initStorage,
   invalidate: () => invalidate,
@@ -14201,8 +14251,8 @@ function toViteModuleId(filePath, root) {
 __name(toViteModuleId, "toViteModuleId");
 async function fileExists(filePath) {
   try {
-    const fs9 = await import("fs/promises");
-    await fs9.access(filePath);
+    const fs10 = await import("fs/promises");
+    await fs10.access(filePath);
     return true;
   } catch {
     return false;
@@ -15625,7 +15675,7 @@ function normalizePositiveDuration(value, fallback, name) {
 }
 __name(normalizePositiveDuration, "normalizePositiveDuration");
 function delay(ms) {
-  return new Promise((resolve6) => setTimeout(resolve6, ms));
+  return new Promise((resolve7) => setTimeout(resolve7, ms));
 }
 __name(delay, "delay");
 function normalizeCacheOptionsTags(options) {
@@ -15776,25 +15826,25 @@ function defineRoutes(input) {
 }
 __name(defineRoutes, "defineRoutes");
 var routesBuilder = {
-  page(path27, options) {
+  page(path28, options) {
     return normalizeProgrammaticRoute({
       kind: "page",
-      path: path27,
+      path: path28,
       ...options
     });
   },
-  layout(path27, options) {
+  layout(path28, options) {
     return normalizeProgrammaticRoute({
       kind: "layout",
-      path: path27,
+      path: path28,
       ...options
     });
   },
-  api(path27, options) {
+  api(path28, options) {
     const { render, runtime, regions, maxDuration, ...methods } = options;
     return normalizeProgrammaticRoute({
       kind: "api",
-      path: path27,
+      path: path28,
       render,
       runtime,
       regions,
@@ -15830,7 +15880,7 @@ function getProgrammaticRouteSearchClientOptions(search) {
   return Object.keys(options).length > 0 ? options : void 0;
 }
 __name(getProgrammaticRouteSearchClientOptions, "getProgrammaticRouteSearchClientOptions");
-function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path27, routePath) {
+function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path28, routePath) {
   const schema = getProgrammaticRouteSearchSchema(searchConfig);
   const search = parseProgrammaticSchema(schema, rawSearch, "search", routePath);
   const options = getProgrammaticRouteSearchOptions(searchConfig);
@@ -15839,7 +15889,7 @@ function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path27, routePa
     schema,
     rawSearch,
     parsedSearch: search,
-    path: path27
+    path: path28
   });
   return { search, canonicalPath };
 }
@@ -16022,7 +16072,7 @@ function createRouteModuleFromProgrammaticPage(route) {
     mod.__farmRouteData = route.data;
     mod.__farmRouteParsesProps = true;
     mod.__farmResolveRouteProps = (props) => resolveProgrammaticRouteProps(route, props);
-    mod.__farmResolveRouteCanonicalPath = (rawSearch, path27) => resolveProgrammaticRouteSearch(route.search, rawSearch, path27, route.path).canonicalPath;
+    mod.__farmResolveRouteCanonicalPath = (rawSearch, path28) => resolveProgrammaticRouteSearch(route.search, rawSearch, path28, route.path).canonicalPath;
   }
   if (route.pending || route.error || route.notFound) {
     mod.__farmRouteComponents = {
@@ -16776,6 +16826,37 @@ function stripUseClientDirective(content) {
   return content.replace(/^\s*(["'])use client\1\s*;?\s*/, "");
 }
 __name(stripUseClientDirective, "stripUseClientDirective");
+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;
+}
+__name(hasAsyncDefaultExport, "hasAsyncDefaultExport");
+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;
+}
+__name(isAsyncLocalDeclaration, "isAsyncLocalDeclaration");
 function parseClientModuleMetadata(content, inspectIslandExport) {
   if (!content) {
     return {
@@ -16831,6 +16912,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,
@@ -17546,6 +17635,7 @@ var _RouteManager = class _RouteManager {
         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,
@@ -20671,18 +20761,146 @@ function DefaultNotFoundPage(_props) {
 }
 __name(DefaultNotFoundPage, "DefaultNotFoundPage");
 
+// src/theme/server-runtime.ts
+init_config2();
+var THEME_SCRIPT_ID = "farm-theme-script";
+var THEME_STYLE_ID = "farm-theme-style";
+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>`
+  };
+}
+__name(createFarmThemeDocumentParts, "createFarmThemeDocumentParts");
+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)});`;
+}
+__name(createFarmThemeBootstrapScript, "createFarmThemeBootstrapScript");
+function serializeInlineValue(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+__name(serializeInlineValue, "serializeInlineValue");
+
+// src/theme/bridge.ts
+var FALLBACK_SERVER_SNAPSHOT = Object.freeze({
+  theme: "system",
+  resolvedTheme: void 0,
+  mounted: false
+});
+var FARM_THEME_SERVER_SNAPSHOT_RESOLVER = /* @__PURE__ */ Symbol.for("farm.js.theme.server-snapshot-resolver");
+function _setFarmThemeServerSnapshotResolver(resolver) {
+  globalThis[FARM_THEME_SERVER_SNAPSHOT_RESOLVER] = resolver;
+}
+__name(_setFarmThemeServerSnapshotResolver, "_setFarmThemeServerSnapshotResolver");
+
+// src/theme/server.ts
+init_config2();
+var defaultThemeConfig = resolveFarmThemeConfig(void 0);
+function _setDefaultFarmThemeConfig(config, basePath = "/") {
+  defaultThemeConfig = resolveFarmThemeConfig(config, basePath);
+}
+__name(_setDefaultFarmThemeConfig, "_setDefaultFarmThemeConfig");
+function getTheme(request = getCurrentRequest()) {
+  return readFarmThemePreference(request, defaultThemeConfig);
+}
+__name(getTheme, "getTheme");
+function getThemeSnapshot(request = getCurrentRequest()) {
+  const theme = readFarmThemePreference(request, defaultThemeConfig);
+  return {
+    theme,
+    resolvedTheme: theme === "system" ? void 0 : theme,
+    mounted: false
+  };
+}
+__name(getThemeSnapshot, "getThemeSnapshot");
+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;
+}
+__name(readFarmThemePreference, "readFarmThemePreference");
+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;
+}
+__name(readCookie3, "readCookie");
+function decodeCookieValue(value) {
+  try {
+    return decodeURIComponent(value);
+  } catch {
+    return value;
+  }
+}
+__name(decodeCookieValue, "decodeCookieValue");
+function isFarmThemePreference(value) {
+  return value === "light" || value === "dark" || value === "system";
+}
+__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
 var cachedClerkProvider = null;
 var importRuntimeModule = new Function("specifier", "return import(specifier);");
+var warnedSuppressedAsyncHydrationModules = /* @__PURE__ */ new Set();
+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.`
+  );
+}
+__name(warnSuppressedAsyncHydrationOnce, "warnSuppressedAsyncHydrationOnce");
 function hasRequestHeader(req, name) {
   const value = req.headers[name.toLowerCase()];
   return Array.isArray(value) ? value.length > 0 : Boolean(value);
 }
 __name(hasRequestHeader, "hasRequestHeader");
-function serializeInlineValue(value) {
+function serializeInlineValue2(value) {
   return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
 }
-__name(serializeInlineValue, "serializeInlineValue");
+__name(serializeInlineValue2, "serializeInlineValue");
 function escapeHtmlAttribute2(value) {
   return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
 }
@@ -20776,7 +20994,7 @@ function createDocumentFooter(options) {
 __name(createDocumentFooter, "createDocumentFooter");
 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>`;
 }
@@ -21348,6 +21566,9 @@ var _ServerRenderer = class _ServerRenderer {
         })
       );
       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
@@ -21845,7 +22066,7 @@ var _ServerRenderer = class _ServerRenderer {
     }
   }
   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();
@@ -21917,9 +22138,9 @@ var _ServerRenderer = class _ServerRenderer {
         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(
@@ -21937,7 +22158,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 {
@@ -21948,6 +22169,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() {
@@ -21961,8 +22187,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)}">
@@ -22039,7 +22266,7 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(g
                 route: observabilityRoute,
                 durationMs: Date.now() - streamStartTime
               });
-              resolve6();
+              resolve7();
             }
           });
           res.write(shell);
@@ -22164,15 +22391,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())}">
@@ -22219,6 +22452,7 @@ init_config();
 init_auth_config();
 init_preload();
 init_security();
+init_config2();
 var defaultDocsConfig = {
   enabled: false,
   entry: "/docs",
@@ -22232,6 +22466,7 @@ var _FarmApp = class _FarmApp {
   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;
@@ -22290,6 +22525,7 @@ var _FarmApp = class _FarmApp {
       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"
@@ -24556,8 +24792,8 @@ init_app_markdown();
 init_response();
 init_integrations();
 init_devtools_config();
-var fs7 = __toESM(require("fs"));
-var path25 = __toESM(require("path"));
+var fs8 = __toESM(require("fs"));
+var path26 = __toESM(require("path"));
 init_layers();
 
 // src/environment-vite.ts
@@ -24904,7 +25140,7 @@ function transformError(id, message) {
 __name(transformError, "transformError");
 
 // package.json
-var version = "0.1.0-beta.22";
+var version = "0.1.0-beta.24";
 
 // src/version.ts
 var FARM_VERSION = version;
@@ -24938,8 +25174,8 @@ __name(reportAfterError, "reportAfterError");
 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(),
@@ -25051,8 +25287,8 @@ function after(callback) {
     throw new Error("after() cannot schedule work after the request lifecycle has completed.");
   }
   let start;
-  const ready = new Promise((resolve6) => {
-    start = resolve6;
+  const ready = new Promise((resolve7) => {
+    start = resolve7;
   });
   const result = ready.then(callback);
   state.tasks.push({ result, start });
@@ -25101,6 +25337,34 @@ function _withAfterNodeMiddleware(handler) {
 }
 __name(_withAfterNodeMiddleware, "_withAfterNodeMiddleware");
 
+// src/dev-static.ts
+var fs7 = __toESM(require("fs"));
+var path17 = __toESM(require("path"));
+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 = path17.resolve(baseDir);
+    const candidate = path17.resolve(resolvedBase, relativePathname);
+    if (!candidate.startsWith(resolvedBase + path17.sep)) continue;
+    try {
+      if (fs7.existsSync(candidate) && fs7.statSync(candidate).isFile()) {
+        return true;
+      }
+    } catch {
+    }
+  }
+  return false;
+}
+__name(devServableFileExists, "devServableFileExists");
+
 // src/vite.ts
 init_deployment();
 init_image_config();
@@ -25305,6 +25569,32 @@ __name(mergeFarmViteConfig, "mergeFarmViteConfig");
 // src/vite.ts
 init_fonts();
 init_server_http();
+
+// src/theme/vite.ts
+init_config2();
+var FARM_DARK_VARIANT = '@custom-variant dark (&:where([data-theme="dark"], [data-theme="dark"] *));';
+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
+      };
+    }
+  };
+}
+__name(createFarmThemeCssPlugin, "createFarmThemeCssPlugin");
+
+// src/vite.ts
 var ALL_TYPE_ARTIFACTS = {
   routes: true,
   api: true,
@@ -25520,11 +25810,11 @@ function isPotentialProgrammaticRouteSourceFile(normalizedFile, srcDirSlug) {
 }
 __name(isPotentialProgrammaticRouteSourceFile, "isPotentialProgrammaticRouteSourceFile");
 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;
   }
@@ -25532,7 +25822,7 @@ function fileContainsProgrammaticPageRoute(file) {
 __name(fileContainsProgrammaticPageRoute, "fileContainsProgrammaticPageRoute");
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path25.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path26.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -25552,7 +25842,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 = path25.resolve(path25.dirname(cleanId), sourcePath);
+    const resolvedPath = path26.resolve(path26.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -25631,7 +25921,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...layerRoots.length ? {
           server: {
             fs: {
-              allow: [path25.resolve(options.root || process.cwd()), ...layerRoots]
+              allow: [path26.resolve(options.root || process.cwd()), ...layerRoots]
             }
           }
         } : {}
@@ -25662,13 +25952,13 @@ function farmPlugin(options = {}, initialPluginManager) {
         },
         server
       );
-      const globalsCSSPath = path25.join(server.config.root, "src/app/globals.css");
-      if (!fs7.existsSync(globalsCSSPath)) {
-        const appDir = path25.join(server.config.root, "src/app");
-        if (!fs7.existsSync(appDir)) {
-          fs7.mkdirSync(appDir, { recursive: true });
+      const globalsCSSPath = path26.join(server.config.root, "src/app/globals.css");
+      if (!fs8.existsSync(globalsCSSPath)) {
+        const appDir = path26.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();
@@ -25687,10 +25977,10 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path25.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path26.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
-          farmConfig.i18n.messages.includes("{locale}") ? path25.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
+          farmConfig.i18n.messages.includes("{locale}") ? path26.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
         );
       }
       const workflowConfig = farmConfig.workflows;
@@ -25700,7 +25990,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path25.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path26.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -25740,7 +26030,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path25.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path26.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -25858,7 +26148,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       await apiRouteManager.discoverRoutes();
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs7.existsSync(path25.isAbsolute(dir) ? dir : path25.join(farmConfig.root, dir))
+        (dir) => fs8.existsSync(path26.isAbsolute(dir) ? dir : path26.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler: createFarmWorkflowRequestHandler2, discoverFarmWorkflows: discoverFarmWorkflows2 } = await loadFarmWorkflowsDevRuntime();
@@ -26092,12 +26382,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`)) {
@@ -26195,7 +26485,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")
@@ -26530,9 +26820,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") || "/";
@@ -27238,8 +27536,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path25.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path25.join(outDir, "client");
+        const outDir = path26.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path26.join(outDir, "client");
         for (const page2 of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page2.urlPath, "http://farm.static"));
@@ -27291,9 +27589,9 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page2.urlPath === "/" ? path25.join(clientDir, "index.html") : path25.join(clientDir, page2.urlPath + ".html");
-              fs7.mkdirSync(path25.dirname(outputPath), { recursive: true });
-              fs7.writeFileSync(outputPath, fullHtml);
+              const outputPath = page2.urlPath === "/" ? path26.join(clientDir, "index.html") : path26.join(clientDir, page2.urlPath + ".html");
+              fs8.mkdirSync(path26.dirname(outputPath), { recursive: true });
+              fs8.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page2.revalidate ? ` (revalidate: ${page2.revalidate}s)` : "";
               logger.success(`  \u2713 ${page2.urlPath}${revalidateInfo}`);
             });
@@ -27301,8 +27599,8 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page2.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path25.join(outDir, "__ssg_manifest.json");
-        fs7.writeFileSync(
+        const manifestPath = path26.join(outDir, "__ssg_manifest.json");
+        fs8.writeFileSync(
           manifestPath,
           JSON.stringify(
             ssgPages.map((p) => ({
@@ -27337,9 +27635,9 @@ if (import.meta.hot) {
       }
       const currentFarmConfig = farmApp?.getConfig();
       const normalizedFile = file.replace(/\\/g, "/");
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path25.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path26.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path25.basename(file)}`);
+        logUpdate("PAGE", `updated ${path26.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -28525,6 +28823,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,
@@ -28691,14 +29002,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;
@@ -28707,6 +29026,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);
@@ -29069,7 +29389,7 @@ function generateClientManifest(bundle) {
 __name(generateClientManifest, "generateClientManifest");
 async function defineConfig2(config = {}) {
   const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const appRoot = path25.resolve(config.root || process.cwd());
+  const appRoot = path26.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, {
@@ -29204,6 +29524,7 @@ async function defineConfig2(config = {}) {
   };
   return {
     plugins: [
+      createFarmThemeCssPlugin(config.theme, config.basePath),
       tailwindcss(),
       viteBrowserExternalPlugin,
       farmI18nClientBridgePlugin(),
@@ -29683,8 +30004,8 @@ function assertServerQueryKey(key) {
 __name(assertServerQueryKey, "assertServerQueryKey");
 
 // src/server/create-server.ts
-var import_vite2 = require("vite");
-init_config2();
+var import_vite3 = require("vite");
+init_config3();
 
 // src/plugin.ts
 init_env();
@@ -30639,19 +30960,19 @@ async function createServer(config = {}) {
       try {
         const tailwindcss = (await import("@tailwindcss/vite")).default;
         tailwindVitePlugin = tailwindcss();
-        logger.info("\u{1F4E6} Enabled built-in Tailwind support (@tailwindcss/vite)");
       } catch (error) {
         logger.warn(
           `Tailwind plugin auto-enable failed; continuing without it: ${error.message}`
         );
       }
     }
-    const server = await (0, import_vite2.createServer)(
+    const server = await (0, import_vite3.createServer)(
       mergeFarmViteConfig(
         {
           root: projectRoot,
           css: shouldUseProjectPostcss ? void 0 : { postcss: { plugins: [] } },
           plugins: [
+            createFarmThemeCssPlugin(finalConfig.theme, finalConfig.basePath),
             ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
             createDevDependencyStubsPlugin(),
             farmI18nClientBridgePlugin(),
@@ -30862,6 +31183,8 @@ __name(assertFunction, "assertFunction");
   getServerActionInvalidations,
   getServerActionSignal,
   getStorage,
+  getTheme,
+  getThemeSnapshot,
   globFiles,
   initStorage,
   invalidate,