@farm.js/core 0.1.0-beta.95 → 0.1.0-beta.97

package/dist/{chunk-A3636IHN.mjs → chunk-FP5Q67FO.mjs}

@@ -49,7 +49,7 @@ import {
   FARM_DEVTOOLS_LAUNCH_PARAM,
   FARM_DEVTOOLS_PATH,
   resolveFarmDevtoolsConfig
-} from "./chunk-7MABZJIM.mjs";
+} from "./chunk-7PYVLJ4J.mjs";
 import {
   normalizeRouteRules
 } from "./chunk-7T2QYWDH.mjs";
@@ -96,7 +96,7 @@ import {
 } from "./chunk-BZAIS65C.mjs";
 import {
   resolveServerActionsConfig
-} from "./chunk-VV24CC42.mjs";
+} from "./chunk-35NPLKQJ.mjs";
 import {
   _setDefaultFarmThemeConfig,
   getTheme
@@ -129,7 +129,7 @@ import {
 } from "./chunk-ISSFLGJ5.mjs";
 import {
   MiddlewareManager
-} from "./chunk-RWYRFCLG.mjs";
+} from "./chunk-4X57GXQA.mjs";
 import {
   _clearCurrentMiddlewareContext,
   _clearCurrentMiddlewareData,
@@ -141,20 +141,20 @@ import {
 } from "./chunk-YUE4CJNB.mjs";
 import {
   _withAfterNodeMiddleware
-} from "./chunk-ZFNK77WN.mjs";
+} from "./chunk-6JNGOC37.mjs";
 import {
   APIRouteManager,
   discoverProgrammaticRoutePaths,
   findProgrammaticRouteFiles,
   loadProgrammaticRouteManifests
-} from "./chunk-MH27UH72.mjs";
+} from "./chunk-TT3E2JOF.mjs";
 import {
   _runWithFarmI18nRequest,
   _setDefaultFarmI18nRuntime,
   createFarmI18nRuntime,
   getFarmI18nClientSnapshot,
   readFarmI18nCatalogs
-} from "./chunk-WB75GIX2.mjs";
+} from "./chunk-TQTB33JS.mjs";
 import {
   resolveFarmI18nConfig
 } from "./chunk-STV7A2LH.mjs";
@@ -198,7 +198,7 @@ import {
 import {
   isFarmAPIPathname,
   resolvePluginRoutes
-} from "./chunk-D7QH7MDU.mjs";
+} from "./chunk-3TWQERDE.mjs";
 import {
   resolveFarmAPIServerBasePath
 } from "./chunk-O2IGROSM.mjs";
@@ -237,15 +237,15 @@ import {
   createFarmCacheKey,
   getFarmDataCache,
   normalizeRevalidatePath
-} from "./chunk-AXVJCMVF.mjs";
+} from "./chunk-2HDOV47R.mjs";
 import {
   configureFarmObservability,
   emitFarmEvent,
   runWithFarmRequestSpan
-} from "./chunk-ZRBCBOEX.mjs";
+} from "./chunk-N2FY2QZ7.mjs";
 import {
   FARM_VERSION
-} from "./chunk-22VG4DFJ.mjs";
+} from "./chunk-J3MPQ4MQ.mjs";
 import {
   FARM_CONFIG_REWRITES_PLUGIN_NAME
 } from "./chunk-PHN22XB2.mjs";
@@ -305,10 +305,11 @@ var ROUTE_PROP_LABELS = /* @__PURE__ */ new Map([
   ["middlewareData", "middleware request data"],
   ["context", "request context"]
 ]);
-function resolveConfiguredRouteRenderingConfig(mod, source) {
+function resolveConfiguredRouteRenderingConfig(mod, source, options) {
+  const pprEnabled = options?.experimentalPPR === true;
   const directiveConfig = parseRouteRenderingDirective(source);
   let ssg = directiveConfig?.ssg ?? false;
-  let ppr = directiveConfig?.ppr ?? false;
+  let requestedPPR = directiveConfig?.ppr ?? false;
   let revalidate = directiveConfig?.revalidate;
   const moduleDynamic = normalizeDynamicMode(mod?.dynamic);
   const dynamic = moduleDynamic ?? directiveConfig?.dynamic;
@@ -318,12 +319,12 @@ function resolveConfiguredRouteRenderingConfig(mod, source) {
     ssg = mod.ssg === true;
   }
   if (hasExplicitPPR) {
-    ppr = mod?.ppr === true || mod?.experimental_ppr === true;
+    requestedPPR = mod?.ppr === true || mod?.experimental_ppr === true;
   }
   if (typeof mod?.revalidate === "number") {
     if (mod.revalidate > 0) {
       revalidate = mod.revalidate;
-      if (!hasExplicitSsg && !ppr) {
+      if (!hasExplicitSsg && !requestedPPR) {
         ssg = true;
       }
     } else {
@@ -337,23 +338,24 @@ function resolveConfiguredRouteRenderingConfig(mod, source) {
   }
   if (moduleDynamic === "force-static" || moduleDynamic === "error") {
     ssg = true;
-    ppr = false;
+    requestedPPR = false;
   } else if (moduleDynamic === "force-dynamic") {
     ssg = false;
-    ppr = false;
+    requestedPPR = false;
     revalidate = void 0;
   }
+  const ppr = pprEnabled && !ssg && requestedPPR;
   return {
     ssg,
-    ppr: ssg ? false : ppr,
+    ppr,
     revalidate: ssg || ppr ? revalidate : void 0,
     dynamic,
     directive: directiveConfig?.directive
   };
 }
 __name(resolveConfiguredRouteRenderingConfig, "resolveConfiguredRouteRenderingConfig");
-function resolveRouteRenderingConfig(mod, source) {
-  const rendering = resolveConfiguredRouteRenderingConfig(mod, source);
+function resolveRouteRenderingConfig(mod, source, options) {
+  const rendering = resolveConfiguredRouteRenderingConfig(mod, source, options);
   if (!rendering.ssg || !source) {
     return rendering;
   }
@@ -368,9 +370,9 @@ function resolveRouteRenderingConfig(mod, source) {
   };
 }
 __name(resolveRouteRenderingConfig, "resolveRouteRenderingConfig");
-async function resolveRouteRenderingConfigFromFile(mod, filePath) {
+async function resolveRouteRenderingConfigFromFile(mod, filePath, options) {
   const source = await readFile(filePath, "utf8").catch(() => void 0);
-  return resolveRouteRenderingConfig(mod, source);
+  return resolveRouteRenderingConfig(mod, source, options);
 }
 __name(resolveRouteRenderingConfigFromFile, "resolveRouteRenderingConfigFromFile");
 function analyzeStaticRouteCandidate(mod, source, options = {}) {
@@ -905,8 +907,8 @@ function getRevalidateInterval(mod) {
   return resolveRouteRenderingConfig(mod).revalidate;
 }
 __name(getRevalidateInterval, "getRevalidateInterval");
-function hasPPR(mod) {
-  return resolveRouteRenderingConfig(mod).ppr;
+function hasPPR(mod, options) {
+  return resolveRouteRenderingConfig(mod, void 0, options).ppr;
 }
 __name(hasPPR, "hasPPR");
 function generateSSGManifest(pages) {
@@ -1258,7 +1260,7 @@ function getIslandStrategyExport(content) {
 __name(getIslandStrategyExport, "getIslandStrategyExport");
 function stripUseClientDirective(content) {
   return content.replace(
-    /^((?:\s|\/\/[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/)*)(["'])use client\2\s*;?\s*/,
+    /^((?:\s|\/\/[^\n]*(?:\n|$)|\/\*[\s\S]*?\*\/|(?:"[^"\n]*"|'[^'\n]*')\s*;?)*)(["'])use client\2\s*;?\s*/,
     "$1"
   );
 }
@@ -5460,7 +5462,8 @@ var _ServerRenderer = class _ServerRenderer {
       }
       const renderingConfig = await resolveRouteRenderingConfigFromFile(
         routeModule,
-        route.modulePath
+        route.modulePath,
+        { experimentalPPR: this.config.experimental?.ppr === true }
       );
       const pprBypassReason = renderingConfig.ppr ? this.getPPRShellBypassReason(req, middlewareMap, middlewareContext, pluginExposedContext) : void 0;
       const canCachePPRShell = renderingConfig.ppr && !pprBypassReason;
@@ -6165,6 +6168,11 @@ var _ServerRenderer = class _ServerRenderer {
       );
       res.statusCode = options.statusCode;
       res.setHeader("Content-Type", "text/html; charset=utf-8");
+      res.setHeader("Cache-Control", "private, no-store");
+      res.setHeader("X-Content-Type-Options", "nosniff");
+      if (typeof res.removeHeader === "function") {
+        res.removeHeader("X-Farm-PPR");
+      }
       res.write(this.createFullHTML(html, false, options.pathname));
       res.end();
       return true;
@@ -6891,6 +6899,7 @@ var _FarmApp = class _FarmApp {
         serverComponents: config.experimental?.serverComponents ?? false,
         serverActions: config.experimental?.serverActions ?? false,
         isolatedClientHydration: config.experimental?.isolatedClientHydration ?? "off",
+        ppr: config.experimental?.ppr ?? false,
         ...config.experimental
       },
       vite: config.vite || {}
@@ -7879,13 +7888,60 @@ function isArrayIndex(key) {
 }
 __name(isArrayIndex, "isArrayIndex");
 
+// src/client-cache-persistence-build.ts
+import fs6 from "fs";
+import path10 from "path";
+var ADAPTER_EXTENSIONS = ["ts", "tsx", "js", "jsx", "mts", "mjs"];
+function resolveFarmClientCacheAdapterEntry(root, cache) {
+  const client = cache?.client;
+  const adapter = client?.adapter;
+  if (adapter === void 0) return void 0;
+  if (typeof adapter !== "string" || adapter.trim().length === 0) {
+    throw new Error(
+      'cache.client.adapter must be a module path string, for example "./src/cache-adapter".'
+    );
+  }
+  const resolved = path10.resolve(root, adapter);
+  const found = resolveAdapterFile(resolved);
+  if (!found) {
+    throw new Error(
+      `cache.client.adapter was not found: ${adapter} (resolved to ${resolved}). Point it at a client module whose default export is created with defineClientCacheAdapter().`
+    );
+  }
+  const options = {};
+  if (client?.version !== void 0) options.version = client.version;
+  if (client?.flushDelayMs !== void 0) options.flushDelayMs = client.flushDelayMs;
+  return { importPath: found.replace(/\\/g, "/"), options };
+}
+__name(resolveFarmClientCacheAdapterEntry, "resolveFarmClientCacheAdapterEntry");
+function resolveAdapterFile(resolved) {
+  if (fs6.existsSync(resolved) && fs6.statSync(resolved).isFile()) return resolved;
+  for (const extension of ADAPTER_EXTENSIONS) {
+    const candidate = `${resolved}.${extension}`;
+    if (fs6.existsSync(candidate) && fs6.statSync(candidate).isFile()) return candidate;
+  }
+  return void 0;
+}
+__name(resolveAdapterFile, "resolveAdapterFile");
+function generateClientCachePersistenceCode(entry) {
+  if (!entry) return { imports: "", init: "" };
+  return {
+    imports: [
+      `import * as __farmClientCacheAdapterModule from ${JSON.stringify(entry.importPath)};`,
+      `import { initConfiguredClientCachePersistence as __farmInitClientCachePersistence } from "@farm.js/core/client";`
+    ].join("\n"),
+    init: `__farmInitClientCachePersistence(__farmClientCacheAdapterModule, ${JSON.stringify(entry.options)});`
+  };
+}
+__name(generateClientCachePersistenceCode, "generateClientCachePersistenceCode");
+
 // src/type-artifacts.ts
 import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync3, unlinkSync } from "fs";
 import { dirname as dirname4, isAbsolute as isAbsolute4, join as join5, resolve as resolve6 } from "path";
 
 // src/routing/generate-route-types.ts
-import * as path10 from "path";
-import * as fs6 from "fs";
+import * as path11 from "path";
+import * as fs7 from "fs";
 function routeSegmentsToTsTypeLiteral(segments) {
   if (segments.length === 0) return '"/"';
   const hasDynamic = segments.some((s) => s.startsWith("["));
@@ -7935,12 +7991,12 @@ function createRoutePattern(route) {
 __name(createRoutePattern, "createRoutePattern");
 var DEFAULT_OUT_FILE = "farm-routes.d.ts";
 async function generateRouteTypes(options) {
-  const root = path10.resolve(options.root);
+  const root = path11.resolve(options.root);
   const srcDir = options.srcDir || "src";
   const outFile = options.outFile || DEFAULT_OUT_FILE;
-  const outPath = path10.isAbsolute(outFile) ? outFile : path10.join(root, srcDir, outFile);
+  const outPath = path11.isAbsolute(outFile) ? outFile : path11.join(root, srcDir, outFile);
   const content = await createRouteTypeDeclarations(options, outPath);
-  fs6.mkdirSync(path10.dirname(outPath), { recursive: true });
+  fs7.mkdirSync(path11.dirname(outPath), { recursive: true });
   writeFileIfChanged(outPath, content);
   return outPath;
 }
@@ -7955,8 +8011,8 @@ async function createRouteTypeDeclarations(options, outPath) {
   const routeModulePatterns = /* @__PURE__ */ new Set();
   const glob = await import("fast-glob");
   for (const source of sourceRoots) {
-    const appDir = path10.join(source.root, source.srcDir, "app");
-    if (fs6.existsSync(appDir)) {
+    const appDir = path11.join(source.root, source.srcDir, "app");
+    if (fs7.existsSync(appDir)) {
       const routeModuleFiles = await glob.default(
         `**/{page,layout,loading,error}.{${componentExtensions.join(",")},md,mdx}`,
         {
@@ -7992,7 +8048,7 @@ async function createRouteTypeDeclarations(options, outPath) {
   const routePathType = suppressLintOnLink ? "string" : renderTypeUnion(typeLiterals);
   const routePatternType = suppressLintOnLink ? "string" : renderTypeUnion(patternLiterals);
   const routeModulePatternType = renderTypeUnion(routeModulePatternLiterals);
-  const routeTypesImportPath = `./${path10.basename(outPath).replace(/\.d\.ts$/, "")}`;
+  const routeTypesImportPath = `./${path11.basename(outPath).replace(/\.d\.ts$/, "")}`;
   const linkAugmentationBlock = suppressLintOnLink ? "" : `
 declare module "@farm.js/core/client" {
   interface LinkDefaultRoute {
@@ -8043,11 +8099,11 @@ __name(createRouteTypeDeclarations, "createRouteTypeDeclarations");
 
 // src/image-types.ts
 import { mkdirSync as mkdirSync2 } from "fs";
-import path11 from "path";
+import path12 from "path";
 var FARM_STATIC_IMAGE_EXTENSIONS = ["avif", "gif", "jpeg", "jpg", "png", "webp"];
 function generateFarmImageTypes(options) {
-  const outputPath = options.outFile ? path11.resolve(options.root, options.outFile) : path11.join(options.root, options.srcDir || "src", "farm-images.d.ts");
-  mkdirSync2(path11.dirname(outputPath), { recursive: true });
+  const outputPath = options.outFile ? path12.resolve(options.root, options.outFile) : path12.join(options.root, options.srcDir || "src", "farm-images.d.ts");
+  mkdirSync2(path12.dirname(outputPath), { recursive: true });
   writeFileIfChanged(outputPath, createFarmImageTypeDeclarations());
   return outputPath;
 }
@@ -8075,8 +8131,8 @@ declare module "*?url" {
 __name(createFarmImageTypeDeclarations, "createFarmImageTypeDeclarations");
 
 // src/content-types.ts
-import * as fs7 from "fs";
-import * as path12 from "path";
+import * as fs8 from "fs";
+import * as path13 from "path";
 var CONFIG_FILENAMES = [
   "farm.config.ts",
   "farm.config.tsx",
@@ -8096,10 +8152,10 @@ var CONFIG_FILENAMES = [
   "config.cjs"
 ];
 function createContentTypeDeclarations(options, outPath) {
-  const root = path12.resolve(options.root);
+  const root = path13.resolve(options.root);
   const projectConfig = findConfigPath(root, options.configPath);
   const configPaths = [
-    ...(options.layerConfigPaths ?? []).filter((value) => fs7.existsSync(value)),
+    ...(options.layerConfigPaths ?? []).filter((value) => fs8.existsSync(value)),
     ...projectConfig ? [projectConfig] : []
   ];
   if (configPaths.length === 0) return createEmptyContentTypes();
@@ -8169,18 +8225,18 @@ export {};
 __name(createEmptyContentTypes, "createEmptyContentTypes");
 function findConfigPath(root, configPath) {
   if (configPath) {
-    const resolvedPath = path12.isAbsolute(configPath) ? configPath : path12.join(root, configPath);
-    return fs7.existsSync(resolvedPath) ? resolvedPath : null;
+    const resolvedPath = path13.isAbsolute(configPath) ? configPath : path13.join(root, configPath);
+    return fs8.existsSync(resolvedPath) ? resolvedPath : null;
   }
   for (const filename of CONFIG_FILENAMES) {
-    const resolvedPath = path12.join(root, filename);
-    if (fs7.existsSync(resolvedPath)) return resolvedPath;
+    const resolvedPath = path13.join(root, filename);
+    if (fs8.existsSync(resolvedPath)) return resolvedPath;
   }
   return null;
 }
 __name(findConfigPath, "findConfigPath");
 function toTypeImportPath(outPath, targetPath) {
-  const relativePath = path12.relative(path12.dirname(outPath), targetPath).replace(/\\/g, "/").replace(/\.(tsx?|jsx?|mjs|cjs|mts|cts)$/, "");
+  const relativePath = path13.relative(path13.dirname(outPath), targetPath).replace(/\\/g, "/").replace(/\.(tsx?|jsx?|mjs|cjs|mts|cts)$/, "");
   return relativePath.startsWith(".") ? relativePath : `./${relativePath}`;
 }
 __name(toTypeImportPath, "toTypeImportPath");
@@ -8477,13 +8533,13 @@ function collectLegacyTypeArtifacts(root, srcDir, stalePaths) {
 __name(collectLegacyTypeArtifacts, "collectLegacyTypeArtifacts");
 
 // src/vite.ts
-import * as fs9 from "fs";
-import * as path17 from "path";
+import * as fs10 from "fs";
+import * as path18 from "path";
 import { pathToFileURL as pathToFileURL3 } from "url";
 
 // src/dev-static.ts
-import * as fs8 from "fs";
-import * as path13 from "path";
+import * as fs9 from "fs";
+import * as path14 from "path";
 function shouldBypassFarmRouterForDottedPath(pathname, routeManager, baseDirs) {
   if (!pathname.includes(".") || pathname.endsWith(".html")) return false;
   const matchesAppRoute = Boolean(
@@ -8503,11 +8559,11 @@ function devServableFileExists(pathname, baseDirs) {
   if (!relativePathname) return false;
   for (const baseDir of baseDirs) {
     if (typeof baseDir !== "string" || baseDir.length === 0) continue;
-    const resolvedBase = path13.resolve(baseDir);
-    const candidate = path13.resolve(resolvedBase, relativePathname);
-    if (!candidate.startsWith(resolvedBase + path13.sep)) continue;
+    const resolvedBase = path14.resolve(baseDir);
+    const candidate = path14.resolve(resolvedBase, relativePathname);
+    if (!candidate.startsWith(resolvedBase + path14.sep)) continue;
     try {
-      if (fs8.existsSync(candidate) && fs8.statSync(candidate).isFile()) {
+      if (fs9.existsSync(candidate) && fs9.statSync(candidate).isFile()) {
         return true;
       }
     } catch {
@@ -8522,6 +8578,7 @@ var SERVER_FN_FACTORIES = ["createServerQuery", "createServerFn"];
 var FARM_CORE_IMPORT_RE = /import\s*(?!type\b)(?:[\w$]+\s*,\s*)?\{([^}]*)\}\s*from\s*(["'])@farm\.js\/core(?:\/[\w./-]+)?\2/g;
 function findClientServerFnViolation(code, id) {
   if (id.startsWith("\0") || id.startsWith("virtual:") || id.includes("node_modules")) return null;
+  if (/\.(md|mdx)(\?|$)/.test(id)) return null;
   if (!code.includes("@farm.js/core")) return null;
   for (const match of code.matchAll(FARM_CORE_IMPORT_RE)) {
     const specifiers = match[1];
@@ -8547,7 +8604,7 @@ __name(formatServerFnBoundaryError, "formatServerFnBoundaryError");
 
 // src/image-vite.ts
 import { readFile as readFile4 } from "fs/promises";
-import path14 from "path";
+import path15 from "path";
 import { imageSize as imageSize2 } from "image-size";
 var FARM_IMAGE_ID_PREFIX = "\0farm:image:";
 var STATIC_IMAGE_RE = /\.(?:avif|gif|jpe?g|png|webp)$/i;
@@ -8615,7 +8672,7 @@ async function createBlurDataURL(bytes) {
 __name(createBlurDataURL, "createBlurDataURL");
 
 // src/server/vite-config.ts
-import path15 from "path";
+import path16 from "path";
 var FARM_CLIENT_ENTRY_PATTERN = "**/{page,layout,loading,error,not-found,default}.{js,jsx,ts,tsx}";
 var FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE = [
   "react",
@@ -8639,9 +8696,9 @@ function getFarmClientOptimizeDepsInclude(renderer) {
 }
 __name(getFarmClientOptimizeDepsInclude, "getFarmClientOptimizeDepsInclude");
 function createFarmClientOptimizeDepsEntries(projectRoot, appDirectories) {
-  const resolvedProjectRoot = path15.resolve(projectRoot);
+  const resolvedProjectRoot = path16.resolve(projectRoot);
   return appDirectories.map((appDirectory) => {
-    const relativeAppDirectory = path15.relative(resolvedProjectRoot, path15.resolve(appDirectory)).replace(/\\/g, "/");
+    const relativeAppDirectory = path16.relative(resolvedProjectRoot, path16.resolve(appDirectory)).replace(/\\/g, "/");
     const prefix = relativeAppDirectory || ".";
     return `${prefix}/${FARM_CLIENT_ENTRY_PATTERN}`;
   });
@@ -8665,7 +8722,7 @@ function createFarmClientOptimizeDepsConfig(entries, renderer) {
 __name(createFarmClientOptimizeDepsConfig, "createFarmClientOptimizeDepsConfig");
 function createFarmSourceAlias(projectRoot, srcDir = "src") {
   return {
-    "@": path15.resolve(projectRoot, srcDir)
+    "@": path16.resolve(projectRoot, srcDir)
   };
 }
 __name(createFarmSourceAlias, "createFarmSourceAlias");
@@ -8758,7 +8815,7 @@ ${FARM_DARK_VARIANT}
 __name(createFarmThemeCssPlugin, "createFarmThemeCssPlugin");
 
 // src/integration-provider-build.ts
-import path16 from "path";
+import path17 from "path";
 function generateFarmIntegrationProviderClientCode(providers, root) {
   const renderedProviders = providers.filter(
     (provider) => provider.component || provider.type === "clerk"
@@ -8839,7 +8896,7 @@ function generateFarmIntegrationProviderServerModules(providers, root) {
 __name(generateFarmIntegrationProviderServerModules, "generateFarmIntegrationProviderServerModules");
 function resolveProviderModule(moduleId, root) {
   if (!moduleId.startsWith(".")) return moduleId;
-  return toViteModuleId(path16.resolve(root, moduleId), root);
+  return toViteModuleId(path17.resolve(root, moduleId), root);
 }
 __name(resolveProviderModule, "resolveProviderModule");
 
@@ -8900,6 +8957,7 @@ var createEmptyTypeArtifactSelection = /* @__PURE__ */ __name(() => ({
   i18n: false
 }), "createEmptyTypeArtifactSelection");
 var FARM_I18N_CLIENT_BRIDGE_ID = "\0farm-i18n-client-bridge";
+var warnedDeprecatedDevtoolsDashboard = false;
 var EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME = `
 function isFarmDocsSearchPage() {
   return false;
@@ -8926,15 +8984,15 @@ function loadFarmWorkflowsDevRuntime() {
 }
 __name(loadFarmWorkflowsDevRuntime, "loadFarmWorkflowsDevRuntime");
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-S52RRRMN.mjs");
+  return import("./devtools-XWZX6CCL.mjs");
 }
 __name(loadFarmDevtoolsSnapshotRuntime, "loadFarmDevtoolsSnapshotRuntime");
 function loadFarmDevtoolsUIRuntime() {
-  return import("./devtools-ui-NJKFORTG.mjs");
+  return import("./devtools-ui-2HG5M4EL.mjs");
 }
 __name(loadFarmDevtoolsUIRuntime, "loadFarmDevtoolsUIRuntime");
 function loadFarmDevtoolsClientRuntime() {
-  return import("./devtools-client-3XRTBND5.mjs");
+  return import("./devtools-client-Z7QQA3Q2.mjs");
 }
 __name(loadFarmDevtoolsClientRuntime, "loadFarmDevtoolsClientRuntime");
 function farmI18nClientBridgePlugin() {
@@ -9318,11 +9376,11 @@ function isPotentialProgrammaticRouteSourceFile(normalizedFile, srcDirSlug) {
 }
 __name(isPotentialProgrammaticRouteSourceFile, "isPotentialProgrammaticRouteSourceFile");
 function fileContainsProgrammaticPageRoute(file) {
-  if (!fs9.existsSync(file)) {
+  if (!fs10.existsSync(file)) {
     return false;
   }
   try {
-    return scanProgrammaticPagePaths(fs9.readFileSync(file, "utf8")).length > 0;
+    return scanProgrammaticPagePaths(fs10.readFileSync(file, "utf8")).length > 0;
   } catch {
     return false;
   }
@@ -9330,7 +9388,7 @@ function fileContainsProgrammaticPageRoute(file) {
 __name(fileContainsProgrammaticPageRoute, "fileContainsProgrammaticPageRoute");
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path17.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path18.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -9350,7 +9408,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 = path17.resolve(path17.dirname(cleanId), sourcePath);
+    const resolvedPath = path18.resolve(path18.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -9512,7 +9570,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...layerRoots.length ? {
           server: {
             fs: {
-              allow: [path17.resolve(options.root || process.cwd()), ...layerRoots]
+              allow: [path18.resolve(options.root || process.cwd()), ...layerRoots]
             }
           }
         } : {}
@@ -9543,13 +9601,13 @@ function farmPlugin(options = {}, initialPluginManager) {
         },
         server
       );
-      const globalsCSSPath = path17.join(server.config.root, "src/app/globals.css");
-      if (!fs9.existsSync(globalsCSSPath)) {
-        const appDir = path17.join(server.config.root, "src/app");
-        if (!fs9.existsSync(appDir)) {
-          fs9.mkdirSync(appDir, { recursive: true });
+      const globalsCSSPath = path18.join(server.config.root, "src/app/globals.css");
+      if (!fs10.existsSync(globalsCSSPath)) {
+        const appDir = path18.join(server.config.root, "src/app");
+        if (!fs10.existsSync(appDir)) {
+          fs10.mkdirSync(appDir, { recursive: true });
         }
-        fs9.writeFileSync(globalsCSSPath, defaultGlobalCSS);
+        fs10.writeFileSync(globalsCSSPath, defaultGlobalCSS);
       }
       await farmApp.initialize();
       const farmConfig = farmApp.getConfig();
@@ -9570,10 +9628,10 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path17.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path18.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
-          farmConfig.i18n.messages.includes("{locale}") ? path17.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
+          farmConfig.i18n.messages.includes("{locale}") ? path18.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
         );
       }
       const workflowConfig = farmConfig.workflows;
@@ -9583,7 +9641,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path17.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path18.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -9624,7 +9682,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path17.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path18.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -9745,7 +9803,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       await apiRouteManager.discoverRoutes();
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs9.existsSync(path17.isAbsolute(dir) ? dir : path17.join(farmConfig.root, dir))
+        (dir) => fs10.existsSync(path18.isAbsolute(dir) ? dir : path18.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler, discoverFarmWorkflows } = await loadFarmWorkflowsDevRuntime();
@@ -10010,12 +10068,12 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             }
           }
           const farmDocsFontPath = farmDocsFontAssets.get(requestPathname);
-          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs9.existsSync(farmDocsFontPath)) {
+          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs10.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 fs9.createReadStream(farmDocsFontPath).pipe(res);
+            else fs10.createReadStream(farmDocsFontPath).pipe(res);
             return;
           }
           if (requestMethod === "GET" && (requestPathname === FARM_DEVTOOLS_PATH || requestPathname === `${FARM_DEVTOOLS_PATH}.json`)) {
@@ -10071,6 +10129,12 @@ window.__FARM_MANIFEST__ = ${inlineValue({
             if (requestPathname.endsWith(".json")) {
               res.end(JSON.stringify(snapshot, null, 2));
             } else {
+              if (!warnedDeprecatedDevtoolsDashboard) {
+                warnedDeprecatedDevtoolsDashboard = true;
+                logger.warn(
+                  "The built-in DevTools dashboard is deprecated. Install @farm.js/devtools and add devtools() to plugins in farm.config.ts."
+                );
+              }
               const { renderFarmDevtoolsHtml } = await loadFarmDevtoolsUIRuntime();
               res.end(renderFarmDevtoolsHtml(snapshot));
             }
@@ -10113,7 +10177,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                 return null;
               }
               return {
-                source: await fs9.promises.readFile(sourcePath, "utf8"),
+                source: await fs10.promises.readFile(sourcePath, "utf8"),
                 filePath: sourcePath
               };
             }, "resolveSource")
@@ -10997,7 +11061,10 @@ ${generatedDevIndicatorsClientRuntime}`,
           renderer,
           isolatedHydrationMode === "enabled",
           resolvedConfig?.trailingSlash ?? false,
-          resolvedConfig?.basePath ?? "/"
+          resolvedConfig?.basePath ?? "/",
+          generateClientCachePersistenceCode(
+            resolveFarmClientCacheAdapterEntry(root, resolvedConfig?.cache)
+          )
         );
       }
       if (id === "/@farm/server") {
@@ -11136,7 +11203,7 @@ export const manifest = getManifest();
         const root = currentConfig.root || server?.config.root || process.cwd();
         const cleanId = id.split("?", 1)[0];
         const selectedIsolatedModules = options.isolatedClientBoundaryModules ?? farmApp?.getRouteManager().getIsolatedClientBoundaryModules(root);
-        const selectedForIsolatedHydration = selectedIsolatedModules?.has(path17.resolve(cleanId)) === true;
+        const selectedForIsolatedHydration = selectedIsolatedModules?.has(path18.resolve(cleanId)) === true;
         if (isolatedHydrationEnabled && selectedForIsolatedHydration && isIsolatableClientBoundarySource(clientBoundarySource)) {
           isolatedModuleReference = toViteModuleId(cleanId, root);
           const transformedBoundary = transformIsolatedClientBoundaryModule({
@@ -11227,8 +11294,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path17.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path17.join(outDir, "client");
+        const outDir = path18.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path18.join(outDir, "client");
         for (const page of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page.urlPath, "http://farm.static"));
@@ -11280,9 +11347,9 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page.urlPath === "/" ? path17.join(clientDir, "index.html") : path17.join(clientDir, page.urlPath + ".html");
-              fs9.mkdirSync(path17.dirname(outputPath), { recursive: true });
-              fs9.writeFileSync(outputPath, fullHtml);
+              const outputPath = page.urlPath === "/" ? path18.join(clientDir, "index.html") : path18.join(clientDir, page.urlPath + ".html");
+              fs10.mkdirSync(path18.dirname(outputPath), { recursive: true });
+              fs10.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page.revalidate ? ` (revalidate: ${page.revalidate}s)` : "";
               logger.success(`  \u2713 ${page.urlPath}${revalidateInfo}`);
             });
@@ -11290,8 +11357,8 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path17.join(outDir, "__ssg_manifest.json");
-        fs9.writeFileSync(
+        const manifestPath = path18.join(outDir, "__ssg_manifest.json");
+        fs10.writeFileSync(
           manifestPath,
           JSON.stringify(
             ssgPages.map((p) => ({
@@ -11334,9 +11401,9 @@ if (import.meta.hot) {
         server2.ws.send({ type: "full-reload", path: "*" });
         return [];
       }
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path17.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path18.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path17.basename(file)}`);
+        logUpdate("PAGE", `updated ${path18.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -11759,7 +11826,7 @@ function parseRouteModuleSchema2(schema, value, label, routePath) {
   }
 }
 __name(parseRouteModuleSchema2, "parseRouteModuleSchema");
-function generateClientCode(integrationProviders = [], documentNavigationMatchers = [], docsSearchClientRuntime = EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, devtoolsClientRuntime = "", plugins = [], root = process.cwd(), srcDir = "src", publicRuntimeConfig = void 0, docsAdapterReact, renderer = REACT_RENDERER, isolatedHydrationEnabled = false, trailingSlash = false, basePath = "/") {
+function generateClientCode(integrationProviders = [], documentNavigationMatchers = [], docsSearchClientRuntime = EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, devtoolsClientRuntime = "", plugins = [], root = process.cwd(), srcDir = "src", publicRuntimeConfig = void 0, docsAdapterReact, renderer = REACT_RENDERER, isolatedHydrationEnabled = false, trailingSlash = false, basePath = "/", clientCachePersistence = { imports: "", init: "" }) {
   const providerClientCode = generateFarmIntegrationProviderClientCode(integrationProviders, root);
   const clientPluginEntry = generateFarmClientPluginEntryCode(
     plugins,
@@ -11815,6 +11882,7 @@ import {
 } from '@farm.js/core/deployment'
 ${providerClientCode.imports}
 ${clientPluginEntry.imports}
+${clientCachePersistence.imports}
 ${docsSearchClientRuntime}
 ${devtoolsClientRuntime}
 ${docsAdapterImportBlock}
@@ -11830,6 +11898,7 @@ const integrationDocumentNavigationMatchers = ${JSON.stringify(documentNavigatio
 setFarmBasePath(${JSON.stringify(basePath)});
 setFarmTrailingSlashPreference(${JSON.stringify(trailingSlash)});
 installChunkErrorRecovery();
+${clientCachePersistence.init}
 
 let reactRoot = null;
 ${isolatedHydrationRuntime}
@@ -13213,7 +13282,7 @@ function generateClientManifest(bundle) {
 __name(generateClientManifest, "generateClientManifest");
 async function defineConfig(config = {}) {
   const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const appRoot = path17.resolve(config.root || process.cwd());
+  const appRoot = path18.resolve(config.root || process.cwd());
   if (config.extends?.length) {
     const { config: layeredConfig } = await import("./layers-KJI5XUAP.mjs").then(
       ({ resolveFarmLayers }) => resolveFarmLayers(config, {
@@ -13454,6 +13523,8 @@ export {
   FarmApp,
   createFarmApp,
   generateFarmClientPluginEntryCode,
+  resolveFarmClientCacheAdapterEntry,
+  generateClientCachePersistenceCode,
   generateRouteTypes,
   generateFarmImageTypes,
   createFarmImageTypeDeclarations,
@@ -13477,4 +13548,4 @@ export {
   PluginManager,
   definePlugin
 };
-//# sourceMappingURL=chunk-A3636IHN.mjs.map
+//# sourceMappingURL=chunk-FP5Q67FO.mjs.map