@farm.js/core 0.1.0-beta.21 → 0.1.0-beta.23

package/dist/internal/build-runtime.cjs

@@ -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"() {
@@ -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: {
@@ -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");
@@ -10442,6 +10490,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 +10511,7 @@ var init_request = __esm({
     _setCurrentRequestResolver(() => requestStore.getStore());
     __name(createWebRequestFromFarmRequest, "createWebRequestFromFarmRequest");
     __name(_runWithCurrentRequest, "_runWithCurrentRequest");
+    __name(getCurrentRequest, "getCurrentRequest");
   }
 });
 
@@ -12961,12 +13019,151 @@ 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 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 +13250,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>`;
 }
@@ -13146,10 +13343,12 @@ 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);");
     __name(hasRequestHeader, "hasRequestHeader");
-    __name(serializeInlineValue, "serializeInlineValue");
+    __name(serializeInlineValue2, "serializeInlineValue");
     __name(escapeHtmlAttribute2, "escapeHtmlAttribute");
     __name(appendResponseHeader, "appendResponseHeader");
     __name(appendResponseVary, "appendResponseVary");
@@ -14237,9 +14436,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 +14456,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 +14467,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 +14485,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)}">
@@ -14484,15 +14689,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 +14787,8 @@ var init_app = __esm({
     init_auth_config();
     init_preload();
     init_security();
+    init_config2();
+    init_server3();
     defaultDocsConfig = {
       enabled: false,
       entry: "/docs",
@@ -14586,6 +14799,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 +14858,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 +16624,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({
@@ -16727,6 +16972,19 @@ var init_module = __esm({
   }
 });
 
+// src/cli-colors.ts
+function createCliColors(interactive = process.stdout.isTTY === true) {
+  return import_picocolors.default.createColors(interactive);
+}
+var import_picocolors;
+var init_cli_colors = __esm({
+  "src/cli-colors.ts"() {
+    "use strict";
+    import_picocolors = __toESM(require("picocolors"));
+    __name(createCliColors, "createCliColors");
+  }
+});
+
 // src/middleware/manager.ts
 function isMiddlewareResponse(value) {
   return value instanceof Response;
@@ -16743,6 +17001,7 @@ var init_manager = __esm({
     init_response();
     init_observability();
     init_routing();
+    init_cli_colors();
     __name(isMiddlewareResponse, "isMiddlewareResponse");
     _MiddlewareManager = class _MiddlewareManager {
       constructor(appDir, viteServer, config, i18n) {
@@ -16896,23 +17155,16 @@ var init_manager = __esm({
         if (applicable.length === 0) {
           return false;
         }
-        try {
-          const pc = require("picocolors");
-          const middlewarePaths = applicable.map(({ mw }) => mw.path).join(", ");
-          const log = [
-            pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-            pc.dim("[") + pc.bold(pc.magenta("MIDDLEWARE")) + pc.dim("]"),
-            pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
-            pc.gray("Executing middleware: "),
-            pc.gray(pathname),
-            pc.dim(` (${(Date.now() - startTime).toFixed(2)}ms)`)
-          ].join(" ");
-          console.log(log);
-        } catch {
-          console.log(
-            `[FARM] [MIDDLEWARE] [${method}] Executing ${pathname} (${applicable.length} middleware)`
-          );
-        }
+        const pc = createCliColors();
+        const log = [
+          pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+          pc.dim("[") + pc.bold(pc.magenta("MIDDLEWARE")) + pc.dim("]"),
+          pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
+          pc.gray("Executing middleware: "),
+          pc.gray(pathname),
+          pc.dim(` (${(Date.now() - startTime).toFixed(2)}ms)`)
+        ].join(" ");
+        console.log(log);
         for (const entry of applicable) {
           const { mw, routeMatch } = entry;
           const configMatch = mw.config ? this.matchesConfig(routePathname, mw.config, ctx) : { matched: true };
@@ -18074,7 +18326,7 @@ var init_type_artifacts = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.21";
+    version = "0.1.0-beta.23";
   }
 });
 
@@ -22488,7 +22740,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");
@@ -23473,7 +23725,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");
@@ -25375,18 +25627,14 @@ function farmPlugin(options = {}, initialPluginManager) {
   let refreshRouteDiscovery = null;
   let workflowHandler = null;
   const logUpdate = /* @__PURE__ */ __name((tag, message) => {
-    try {
-      const pc = require("picocolors");
-      const log = [
-        pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.yellow("UPDATE")) + pc.dim("]"),
-        pc.gray(message)
-      ].join(" ");
-      console.log(log);
-    } catch {
-      console.log(`[FARM] [${tag}] [UPDATE] ${message}`);
-    }
+    const pc = createCliColors();
+    const log = [
+      pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.yellow("UPDATE")) + pc.dim("]"),
+      pc.gray(message)
+    ].join(" ");
+    console.log(log);
   }, "logUpdate");
   return {
     name: "farm",
@@ -25827,25 +26075,21 @@ window.__FARM_MANIFEST__ = ${inlineValue({
           return;
         }
         logResponse.__last = { key: dedupeKey, ts: now };
-        try {
-          const pc = require("picocolors");
-          let statusColor = pc.green;
-          if (status >= 500) statusColor = pc.red;
-          else if (status >= 400) statusColor = pc.yellow;
-          else if (status >= 300) statusColor = pc.cyan;
-          const log = [
-            pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-            pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
-            pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
-            pc.gray(urlPath),
-            pc.dim("-"),
-            statusColor(status.toString()),
-            pc.dim(`(${duration}ms)`)
-          ].join(" ");
-          console.log(log);
-        } catch {
-          console.log(`[FARM] [${tag}] [${method}] ${urlPath} - ${status} (${duration}ms)`);
-        }
+        const pc = createCliColors();
+        let statusColor = pc.green;
+        if (status >= 500) statusColor = pc.red;
+        else if (status >= 400) statusColor = pc.yellow;
+        else if (status >= 300) statusColor = pc.cyan;
+        const log = [
+          pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+          pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
+          pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
+          pc.gray(urlPath),
+          pc.dim("-"),
+          statusColor(status.toString()),
+          pc.dim(`(${duration}ms)`)
+        ].join(" ");
+        console.log(log);
       }, "logResponse");
       server.middlewares.use(
         _withAfterNodeMiddleware(async (req, res, next) => {
@@ -28459,14 +28703,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;
@@ -28475,6 +28727,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);
@@ -28902,7 +29155,7 @@ async function defineConfig2(config = {}) {
       return null;
     }
   };
-  const pc = await import("picocolors").then((m) => m.default);
+  const pc = createCliColors();
   let serverStarted = false;
   let startTime = Date.now();
   const farmLogger = {
@@ -28969,6 +29222,7 @@ async function defineConfig2(config = {}) {
   };
   return {
     plugins: [
+      createFarmThemeCssPlugin(config.theme, config.basePath),
       tailwindcss(),
       viteBrowserExternalPlugin,
       farmI18nClientBridgePlugin(),
@@ -29041,7 +29295,7 @@ 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 init_vite2 = __esm({
   "src/vite.ts"() {
     "use strict";
     init_app();
@@ -29077,6 +29331,8 @@ var init_vite = __esm({
     init_vite_config();
     init_fonts();
     init_server_http();
+    init_cli_colors();
+    init_vite();
     ALL_TYPE_ARTIFACTS = {
       routes: true,
       api: true,
@@ -29176,7 +29432,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 +30777,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 +30785,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"));
@@ -31065,6 +31321,7 @@ __name(withVite5TransformContext, "withVite5TransformContext");
 init_font_vite();
 init_vite_config();
 init_not_found();
+init_vite();
 var import_meta = {};
 function preloadFarmNitroRuntime() {
   return import("nitro").then(
@@ -31737,7 +31994,7 @@ async function validateClientBuildOutput(root, srcDir, outputDir) {
 __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 pluginManager = new PluginManager2({
@@ -31929,6 +32186,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
         {
@@ -33306,7 +33564,7 @@ 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 pluginManager = new PluginManager2({
@@ -33547,6 +33805,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()] : [],
         {
@@ -33760,15 +34019,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 +34226,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 +36064,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 +36086,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 +36175,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 +36307,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 +36340,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 +36446,12 @@ async function handleFarmRequestInContext(
 </html>\`;
     }
     fullHtml = applyFarmI18nDocument(fullHtml, pathname, getFarmI18nSnapshot());
+    fullHtml = applyFarmThemeDocument(
+      fullHtml,
+      farmThemeConfig,
+      farmResolvedRuntimeConfig.basePath,
+      getFarmTheme(request)
+    );
     
     emitFarmEvent({
       type: "render.complete",
@@ -36173,8 +36470,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" },
@@ -37401,7 +37704,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 +37731,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,
@@ -37553,7 +37856,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 = {