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

package/dist/index.cjs

@@ -14325,12 +14325,201 @@ body {
   }
 });
 
+// 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/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;
+}
+function getFarmThemeServerSnapshot() {
+  return globalThis[FARM_THEME_SERVER_SNAPSHOT_RESOLVER]?.() ?? FALLBACK_SERVER_SNAPSHOT;
+}
+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");
+    __name(getFarmThemeServerSnapshot, "getFarmThemeServerSnapshot");
+  }
+});
+
+// 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) {
@@ -14417,7 +14606,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>`;
 }
@@ -14510,10 +14699,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");
@@ -15601,9 +15792,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(
@@ -15621,7 +15812,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 {
@@ -15632,6 +15823,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() {
@@ -15645,8 +15841,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)}">
@@ -15848,15 +16045,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())}">
@@ -16218,6 +16421,8 @@ var init_app = __esm({
     init_auth_config();
     init_preload();
     init_security();
+    init_config2();
+    init_server3();
     defaultDocsConfig = {
       enabled: false,
       entry: "/docs",
@@ -16228,6 +16433,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;
@@ -16286,6 +16492,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"
@@ -19853,7 +20060,7 @@ var init_environment_vite = __esm({
 var version;
 var init_package = __esm({
   "package.json"() {
-    version = "0.1.0-beta.22";
+    version = "0.1.0-beta.23";
   }
 });
 
@@ -20753,6 +20960,36 @@ var init_fonts = __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/docs/last-modified.ts
 function normalizeRelativePath(value) {
   return value.replace(/\\/g, "/").replace(/^\.\/+/, "");
@@ -24730,6 +24967,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: {
@@ -24807,7 +25045,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();
@@ -24828,6 +25066,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");
@@ -25332,7 +25571,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");
@@ -26317,7 +26556,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");
@@ -31295,14 +31534,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;
@@ -31311,6 +31558,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);
@@ -31805,6 +32053,7 @@ async function defineConfig2(config = {}) {
   };
   return {
     plugins: [
+      createFarmThemeCssPlugin(config.theme, config.basePath),
       tailwindcss(),
       viteBrowserExternalPlugin,
       farmI18nClientBridgePlugin(),
@@ -31877,7 +32126,7 @@ async function defineConfig2(config = {}) {
   };
 }
 var fs7, path25, 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();
@@ -31914,6 +32163,7 @@ var init_vite = __esm({
     init_fonts();
     init_server_http();
     init_cli_colors();
+    init_vite();
     ALL_TYPE_ARTIFACTS = {
       routes: true,
       api: true,
@@ -32013,7 +32263,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);
@@ -33577,6 +33827,7 @@ __export(src_exports, {
   getServerActionInvalidations: () => getServerActionInvalidations,
   getServerActionSignal: () => getServerActionSignal,
   getStorage: () => getStorage,
+  getTheme: () => getTheme2,
   globFiles: () => globFiles,
   hasFarmRouteRuntimeControls: () => hasFarmRouteRuntimeControls,
   hasISR: () => hasISR,
@@ -33693,6 +33944,7 @@ __export(src_exports, {
   resolveFarmLayoutFonts: () => resolveFarmLayoutFonts,
   resolveFarmRouteRuleRuntimeConfig: () => resolveFarmRouteRuleRuntimeConfig,
   resolveFarmRouteRuntimeConfig: () => resolveFarmRouteRuntimeConfig,
+  resolveFarmThemeConfig: () => resolveFarmThemeConfig,
   resolveIntegrationOrmRuntimeClient: () => resolveIntegrationOrmRuntimeClient,
   resolveIntegrationPlugins: () => resolveIntegrationPlugins,
   resolveMarkdownConfig: () => resolveMarkdownConfig,
@@ -33719,12 +33971,14 @@ __export(src_exports, {
   segmentsToPattern: () => segmentsToPattern,
   serverEnv: () => serverEnv,
   setEnv: () => setEnv,
+  setTheme: () => setTheme,
   snapshotDeferredData: () => snapshotDeferredData,
   sqliteStorage: () => sqliteStorage,
   storageCacheAdapter: () => storageCacheAdapter,
   titleFromMarkdown: () => titleFromMarkdown,
   toFormData: () => toFormData,
   toViteModuleId: () => toViteModuleId,
+  toggleTheme: () => toggleTheme,
   unstable_cache: () => unstable_cache,
   unwrapMiddleware: () => unwrapMiddleware,
   updateTag: () => updateTag,
@@ -33740,6 +33994,7 @@ __export(src_exports, {
   useSearchParams: () => useSearchParams,
   useServerFn: () => useServerFn,
   useServerQuery: () => useServerQuery,
+  useTheme: () => useTheme,
   validateServerActionRequest: () => validateServerActionRequest,
   vercelBlobStorage: () => vercelBlobStorage,
   vercelKVStorage: () => vercelKVStorage,
@@ -33769,7 +34024,7 @@ __name(FarmProvider, "FarmProvider");
 // src/index.ts
 init_request();
 init_plugin();
-init_config2();
+init_config3();
 init_layers();
 
 // src/hmr.ts
@@ -37292,6 +37547,9 @@ init_cron();
 init_env();
 init_env_types();
 
+// src/theme/index.ts
+init_config2();
+
 // src/environment.ts
 var _FarmEnvironmentError = class _FarmEnvironmentError extends Error {
   constructor(api3, expected, actual) {
@@ -38000,12 +38258,12 @@ function useServerQuery(query, input, options = {}) {
   const mountedKeyRef = (0, import_react9.useRef)(void 0);
   inputRef.current = input;
   optionsRef.current = options;
-  const subscribe = (0, import_react9.useCallback)(
+  const subscribe2 = (0, import_react9.useCallback)(
     (listener) => cache.subscribe(key, listener),
     [cache, key]
   );
   const getSnapshot = (0, import_react9.useCallback)(() => cache.get(key), [cache, key]);
-  const entry = (0, import_react9.useSyncExternalStore)(subscribe, getSnapshot, () => void 0);
+  const entry = (0, import_react9.useSyncExternalStore)(subscribe2, getSnapshot, () => void 0);
   const run = (0, import_react9.useCallback)(
     (force = false) => fetchServerQuery(query, inputRef.current, {
       ...optionsRef.current,
@@ -38131,7 +38389,7 @@ init_deployment();
 init_generate_route_types();
 
 // src/build/index.ts
-init_config2();
+init_config3();
 var import_path14 = __toESM(require("path"));
 init_utils();
 init_app();
@@ -38139,7 +38397,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"));
@@ -38675,6 +38933,7 @@ __name(withVite5TransformContext, "withVite5TransformContext");
 init_font_vite();
 init_vite_config();
 init_not_found();
+init_vite();
 var import_meta = {};
 function preloadFarmNitroRuntime() {
   return import("nitro").then(
@@ -39347,7 +39606,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 fs9 = await import("fs/promises");
   const pluginManager = new PluginManager2({
@@ -39539,6 +39798,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
         {
@@ -40916,7 +41176,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 fs9 = await import("fs/promises");
   const pluginManager = new PluginManager2({
@@ -41157,6 +41417,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()] : [],
         {
@@ -41370,15 +41631,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,
@@ -41573,6 +41838,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(),
@@ -43409,7 +43676,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') +
@@ -43425,9 +43698,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") {
@@ -43510,6 +43787,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(
@@ -43636,10 +43919,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",
@@ -43664,10 +43952,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,
@@ -43765,6 +44058,12 @@ async function handleFarmRequestInContext(
 </html>\`;
     }
     fullHtml = applyFarmI18nDocument(fullHtml, pathname, getFarmI18nSnapshot());
+    fullHtml = applyFarmThemeDocument(
+      fullHtml,
+      farmThemeConfig,
+      farmResolvedRuntimeConfig.basePath,
+      getFarmTheme(request)
+    );
     
     emitFarmEvent({
       type: "render.complete",
@@ -43783,8 +44082,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" },
@@ -45011,7 +45316,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,
@@ -45038,7 +45343,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,
@@ -45684,8 +45989,74 @@ function createStore(initialState, extend) {
 }
 __name(createStore, "createStore");
 
-// src/client/link.tsx
+// src/theme/client.tsx
 var import_react13 = require("react");
+init_bridge2();
+var FALLBACK_CLIENT_SNAPSHOT = Object.freeze({
+  theme: "system",
+  resolvedTheme: "light",
+  mounted: true
+});
+var cachedClientSnapshot = FALLBACK_CLIENT_SNAPSHOT;
+function snapshotsMatch(left, right) {
+  return left.theme === right.theme && left.resolvedTheme === right.resolvedTheme && left.mounted === right.mounted;
+}
+__name(snapshotsMatch, "snapshotsMatch");
+function getClientSnapshot() {
+  const next = typeof window === "undefined" ? FALLBACK_CLIENT_SNAPSHOT : window.__FARM_THEME__?.snapshot;
+  if (!next) return cachedClientSnapshot;
+  if (!snapshotsMatch(cachedClientSnapshot, next)) cachedClientSnapshot = next;
+  return cachedClientSnapshot;
+}
+__name(getClientSnapshot, "getClientSnapshot");
+function getHydrationSnapshot() {
+  if (typeof window !== "undefined" && window.__FARM_THEME__?.serverSnapshot) {
+    return window.__FARM_THEME__.serverSnapshot;
+  }
+  return getFarmThemeServerSnapshot();
+}
+__name(getHydrationSnapshot, "getHydrationSnapshot");
+function subscribe(listener) {
+  if (typeof window === "undefined") return () => {
+  };
+  const handleThemeChange = /* @__PURE__ */ __name(() => {
+    getClientSnapshot();
+    listener();
+  }, "handleThemeChange");
+  window.addEventListener("farm:themechange", handleThemeChange);
+  return () => window.removeEventListener("farm:themechange", handleThemeChange);
+}
+__name(subscribe, "subscribe");
+function getTheme2() {
+  return getClientSnapshot();
+}
+__name(getTheme2, "getTheme");
+function setTheme(theme) {
+  const runtime = typeof window === "undefined" ? void 0 : window.__FARM_THEME__;
+  if (!runtime) {
+    throw new Error("The FARMJS theme runtime is not enabled. Add `theme` to farm.config.ts.");
+  }
+  runtime.setTheme(theme);
+}
+__name(setTheme, "setTheme");
+function toggleTheme() {
+  const next = getClientSnapshot().resolvedTheme === "dark" ? "light" : "dark";
+  setTheme(next);
+  return next;
+}
+__name(toggleTheme, "toggleTheme");
+function useTheme() {
+  const snapshot = (0, import_react13.useSyncExternalStore)(subscribe, getClientSnapshot, getHydrationSnapshot);
+  return {
+    ...snapshot,
+    setTheme,
+    toggleTheme
+  };
+}
+__name(useTheme, "useTheme");
+
+// src/client/link.tsx
+var import_react14 = require("react");
 init_router();
 init_client_runtime();
 var import_jsx_runtime5 = require("react/jsx-runtime");
@@ -45747,9 +46118,9 @@ function LinkInner({
   onTouchStart,
   ...props
 }, ref) {
-  const elementRef = (0, import_react13.useRef)(null);
-  const intentTimeoutRef = (0, import_react13.useRef)(null);
-  const hasPrefetched = (0, import_react13.useRef)(false);
+  const elementRef = (0, import_react14.useRef)(null);
+  const intentTimeoutRef = (0, import_react14.useRef)(null);
+  const hasPrefetched = (0, import_react14.useRef)(false);
   const { intent, viewport, render } = normalizePrefetch(prefetch2);
   const baseHref = resolveLinkHref(href, params, {
     query,
@@ -45758,17 +46129,17 @@ function LinkInner({
   });
   const resolvedHref = localizeActiveFarmHref(baseHref, locale);
   const isExternal = isExternalUrl(resolvedHref);
-  const doPrefetch = (0, import_react13.useCallback)(() => {
+  const doPrefetch = (0, import_react14.useCallback)(() => {
     if (isExternal || hasPrefetched.current) return;
     const router = getRouter2();
     if (!router) return;
     hasPrefetched.current = true;
     router.prefetch(resolvedHref);
   }, [resolvedHref, isExternal]);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     hasPrefetched.current = false;
   }, [resolvedHref]);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     const element = elementRef.current;
     if (!element || isExternal) return;
     const router = getRouter2();
@@ -45778,7 +46149,7 @@ function LinkInner({
       return () => router.unobserveForPrefetch(element);
     }
   }, [resolvedHref, viewport, isExternal]);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     if (!render || isExternal) return;
     let cancelled = false;
     let timeoutId = null;
@@ -45800,7 +46171,7 @@ function LinkInner({
       }
     };
   }, [render, isExternal, resolvedHref]);
-  (0, import_react13.useEffect)(() => {
+  (0, import_react14.useEffect)(() => {
     return () => {
       if (intentTimeoutRef.current) {
         clearTimeout(intentTimeoutRef.current);
@@ -45808,13 +46179,13 @@ function LinkInner({
       }
     };
   }, []);
-  const cancelIntent = (0, import_react13.useCallback)(() => {
+  const cancelIntent = (0, import_react14.useCallback)(() => {
     if (intentTimeoutRef.current) {
       clearTimeout(intentTimeoutRef.current);
       intentTimeoutRef.current = null;
     }
   }, []);
-  const scheduleIntentPrefetch = (0, import_react13.useCallback)(() => {
+  const scheduleIntentPrefetch = (0, import_react14.useCallback)(() => {
     if (isExternal || !intent || hasPrefetched.current) return;
     cancelIntent();
     intentTimeoutRef.current = setTimeout(() => {
@@ -45822,42 +46193,42 @@ function LinkInner({
       doPrefetch();
     }, prefetchDelay);
   }, [intent, isExternal, prefetchDelay, doPrefetch, cancelIntent]);
-  const handleMouseEnter = (0, import_react13.useCallback)(
+  const handleMouseEnter = (0, import_react14.useCallback)(
     (event) => {
       onMouseEnter?.(event);
       scheduleIntentPrefetch();
     },
     [onMouseEnter, scheduleIntentPrefetch]
   );
-  const handleMouseLeave = (0, import_react13.useCallback)(
+  const handleMouseLeave = (0, import_react14.useCallback)(
     (event) => {
       onMouseLeave?.(event);
       cancelIntent();
     },
     [onMouseLeave, cancelIntent]
   );
-  const handleTouchStart = (0, import_react13.useCallback)(
+  const handleTouchStart = (0, import_react14.useCallback)(
     (event) => {
       onTouchStart?.(event);
       scheduleIntentPrefetch();
     },
     [onTouchStart, scheduleIntentPrefetch]
   );
-  const handleFocus = (0, import_react13.useCallback)(
+  const handleFocus = (0, import_react14.useCallback)(
     (event) => {
       onFocus?.(event);
       scheduleIntentPrefetch();
     },
     [onFocus, scheduleIntentPrefetch]
   );
-  const handleBlur = (0, import_react13.useCallback)(
+  const handleBlur = (0, import_react14.useCallback)(
     (event) => {
       onBlur?.(event);
       cancelIntent();
     },
     [onBlur, cancelIntent]
   );
-  const handleClick = (0, import_react13.useCallback)(
+  const handleClick = (0, import_react14.useCallback)(
     (event) => {
       onClick?.(event);
       if (event.defaultPrevented) return;
@@ -45882,7 +46253,7 @@ function LinkInner({
     },
     [resolvedHref, replace, scroll, viewTransition, target, isExternal, onClick]
   );
-  const setRefs = (0, import_react13.useCallback)(
+  const setRefs = (0, import_react14.useCallback)(
     (node) => {
       elementRef.current = node;
       if (typeof ref === "function") ref(node);
@@ -45911,7 +46282,7 @@ function LinkInner({
   );
 }
 __name(LinkInner, "LinkInner");
-var LinkWithRef = (0, import_react13.forwardRef)(LinkInner);
+var LinkWithRef = (0, import_react14.forwardRef)(LinkInner);
 LinkWithRef.displayName = "Link";
 var Link = LinkWithRef;
 function resolveLinkHref(href, params, options) {
@@ -46851,6 +47222,7 @@ __name(decodeCookiePart, "decodeCookiePart");
   getServerActionInvalidations,
   getServerActionSignal,
   getStorage,
+  getTheme,
   globFiles,
   hasFarmRouteRuntimeControls,
   hasISR,
@@ -46967,6 +47339,7 @@ __name(decodeCookiePart, "decodeCookiePart");
   resolveFarmLayoutFonts,
   resolveFarmRouteRuleRuntimeConfig,
   resolveFarmRouteRuntimeConfig,
+  resolveFarmThemeConfig,
   resolveIntegrationOrmRuntimeClient,
   resolveIntegrationPlugins,
   resolveMarkdownConfig,
@@ -46993,12 +47366,14 @@ __name(decodeCookiePart, "decodeCookiePart");
   segmentsToPattern,
   serverEnv,
   setEnv,
+  setTheme,
   snapshotDeferredData,
   sqliteStorage,
   storageCacheAdapter,
   titleFromMarkdown,
   toFormData,
   toViteModuleId,
+  toggleTheme,
   unstable_cache,
   unwrapMiddleware,
   updateTag,
@@ -47014,6 +47389,7 @@ __name(decodeCookiePart, "decodeCookiePart");
   useSearchParams,
   useServerFn,
   useServerQuery,
+  useTheme,
   validateServerActionRequest,
   vercelBlobStorage,
   vercelKVStorage,