@farm.js/core 0.1.0-beta.11 → 0.1.0-beta.13

package/dist/vite.cjs

@@ -652,26 +652,26 @@ async function prepareFarmWorkflowsForNitro(config) {
   const root = config.root || process.cwd();
   const distDir = config.distDir || ".farm";
   const fs8 = await import("fs/promises");
-  const path24 = await import("path");
-  const generatedDir = path24.join(root, distDir, ".nitro", "farm-workflows");
+  const path26 = await import("path");
+  const generatedDir = path26.join(root, distDir, ".nitro", "farm-workflows");
   await fs8.mkdir(generatedDir, { recursive: true });
   const tasks = {};
   const scheduledTasks = createScheduledTasks(workflows);
   for (const workflow of workflows) {
-    const wrapperPath = path24.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
+    const wrapperPath = path26.join(generatedDir, `${safeFileName(workflow.id)}.mjs`);
     await fs8.writeFile(wrapperPath, createNitroTaskWrapper(workflow), "utf8");
     tasks[workflow.id] = {
       handler: wrapperPath,
       description: workflow.description || `Farm workflow ${workflow.id}`
     };
   }
-  const handlerPath = path24.join(generatedDir, "http-handler.mjs");
+  const handlerPath = path26.join(generatedDir, "http-handler.mjs");
   await fs8.writeFile(
     handlerPath,
     createNitroWorkflowHTTPHandler(workflowConfig, workflows),
     "utf8"
   );
-  const manifestPath = path24.join(generatedDir, "manifest.json");
+  const manifestPath = path26.join(generatedDir, "manifest.json");
   await fs8.writeFile(
     manifestPath,
     JSON.stringify(
@@ -754,10 +754,10 @@ function resolveWorkflowDefinition(module2) {
 }
 async function findWorkflowFiles(root, dirs) {
   const fs8 = await import("fs/promises");
-  const path24 = await import("path");
+  const path26 = await import("path");
   const files = [];
   for (const dir of dirs) {
-    const absoluteDir = path24.isAbsolute(dir) ? dir : path24.join(root, dir);
+    const absoluteDir = path26.isAbsolute(dir) ? dir : path26.join(root, dir);
     if (!await pathExists(absoluteDir)) continue;
     await walkWorkflowDir(absoluteDir, files);
   }
@@ -765,10 +765,10 @@ async function findWorkflowFiles(root, dirs) {
 }
 async function walkWorkflowDir(dir, files) {
   const fs8 = await import("fs/promises");
-  const path24 = await import("path");
+  const path26 = await import("path");
   const entries = await fs8.readdir(dir, { withFileTypes: true });
   for (const entry of entries) {
-    const filePath = path24.join(dir, entry.name);
+    const filePath = path26.join(dir, entry.name);
     if (entry.isDirectory()) {
       if (entry.name === "node_modules" || entry.name.startsWith(".")) continue;
       await walkWorkflowDir(filePath, files);
@@ -788,12 +788,12 @@ function isWorkflowFile(fileName) {
 }
 async function loadWorkflowModule(filePath, root) {
   const fs8 = await import("fs/promises");
-  const path24 = await import("path");
+  const path26 = await import("path");
   const { pathToFileURL: pathToFileURL5 } = await import("url");
   const { build } = await import("esbuild");
-  const outDir = path24.join(root, ".farm", ".workflow-loader");
+  const outDir = path26.join(root, ".farm", ".workflow-loader");
   await fs8.mkdir(outDir, { recursive: true });
-  const outfile = path24.join(
+  const outfile = path26.join(
     outDir,
     `workflow-${Date.now()}-${Math.random().toString(36).slice(2)}.mjs`
   );
@@ -1076,7 +1076,7 @@ function normalizeCronJob(name, job) {
   if (!job || typeof job !== "object" || Array.isArray(job)) {
     throw new TypeError(`Farm cron ${JSON.stringify(name)} must be a configuration object.`);
   }
-  const path24 = normalizeCronPath(name, job.path);
+  const path26 = normalizeCronPath(name, job.path);
   const rawSchedule = Array.isArray(job.schedule) ? job.schedule : [job.schedule];
   const schedule = [...new Set(rawSchedule.map((value) => normalizeCronExpression(name, value)))];
   if (schedule.length === 0) {
@@ -1085,7 +1085,7 @@ function normalizeCronJob(name, job) {
   return {
     name,
     schedule,
-    path: path24,
+    path: path26,
     description: job.description?.trim() || void 0
   };
 }
@@ -1093,13 +1093,13 @@ function normalizeCronPath(name, value) {
   if (typeof value !== "string" || !value.trim().startsWith("/")) {
     throw new TypeError(`Farm cron ${JSON.stringify(name)} path must start with "/".`);
   }
-  const path24 = value.trim();
-  if (path24.startsWith("//") || path24.includes("?") || path24.includes("#")) {
+  const path26 = value.trim();
+  if (path26.startsWith("//") || path26.includes("?") || path26.includes("#")) {
     throw new TypeError(
       `Farm cron ${JSON.stringify(name)} path must be an application pathname without a host, query, or hash.`
     );
   }
-  return path24.length > 1 ? path24.replace(/\/+$/, "") : path24;
+  return path26.length > 1 ? path26.replace(/\/+$/, "") : path26;
 }
 function normalizeCronExpression(name, value) {
   if (typeof value !== "string") {
@@ -1956,7 +1956,7 @@ var init_server_action_security = __esm({
 
 // src/image-config.ts
 function resolveFarmImageConfig(config) {
-  const path24 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
+  const path26 = normalizeImagePath(config?.path ?? DEFAULT_FARM_IMAGE_PATH);
   const deviceSizes = normalizeIntegerList(
     config?.deviceSizes ?? DEFAULT_FARM_IMAGE_DEVICE_SIZES,
     "images.deviceSizes"
@@ -1984,7 +1984,7 @@ function resolveFarmImageConfig(config) {
   );
   return Object.freeze({
     provider: config?.provider ?? "auto",
-    path: path24,
+    path: path26,
     domains: Object.freeze([
       ...new Set(
         (config?.domains ?? []).map((domain) => domain.trim().toLowerCase()).filter(Boolean)
@@ -2023,11 +2023,11 @@ function getPublicFarmImageConfig(config) {
   };
 }
 function normalizeImagePath(value) {
-  const path24 = value.trim().replace(/\/+$/, "") || "/";
-  if (!path24.startsWith("/") || path24.includes("?") || path24.includes("#")) {
+  const path26 = value.trim().replace(/\/+$/, "") || "/";
+  if (!path26.startsWith("/") || path26.includes("?") || path26.includes("#")) {
     throw new TypeError("images.path must be an absolute pathname without a query or hash");
   }
-  return path24;
+  return path26;
 }
 function normalizeIntegerList(values, name, max) {
   if (values.length === 0) {
@@ -2866,9 +2866,9 @@ var init_integration_orm = __esm({
 });
 
 // src/integrations.ts
-function defineTypedIntegrationRoute(method, path24, input) {
+function defineTypedIntegrationRoute(method, path26, input) {
   return {
-    path: path24,
+    path: path26,
     method,
     middleware: input.middleware,
     before: input.before,
@@ -2878,7 +2878,7 @@ function defineTypedIntegrationRoute(method, path24, input) {
     input: normalizeIntegrationRouteInputSchemas(input),
     handler: input.handler,
     __operation: defineIntegrationAPIOperation({
-      path: path24,
+      path: path26,
       method,
       bodyFormat: input.bodyFormat,
       responseFormat: input.responseFormat,
@@ -2890,52 +2890,52 @@ function defineTypedIntegrationRoute(method, path24, input) {
 }
 function createIntegrationRouteFactory() {
   return {
-    get(path24, input) {
+    get(path26, input) {
       return defineTypedIntegrationRoute(
         "GET",
-        path24,
+        path26,
         input
       );
     },
-    post(path24, input) {
+    post(path26, input) {
       return defineTypedIntegrationRoute(
         "POST",
-        path24,
+        path26,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    put(path24, input) {
+    put(path26, input) {
       return defineTypedIntegrationRoute(
         "PUT",
-        path24,
+        path26,
         {
           bodyFormat: "json",
           ...input
         }
       );
     },
-    patch(path24, input) {
-      return defineTypedIntegrationRoute("PATCH", path24, {
+    patch(path26, input) {
+      return defineTypedIntegrationRoute("PATCH", path26, {
         bodyFormat: "json",
         ...input
       });
     },
-    delete(path24, input) {
-      return defineTypedIntegrationRoute("DELETE", path24, {
+    delete(path26, input) {
+      return defineTypedIntegrationRoute("DELETE", path26, {
         bodyFormat: "json",
         ...input
       });
     },
-    options(path24, input) {
-      return defineTypedIntegrationRoute("OPTIONS", path24, input);
+    options(path26, input) {
+      return defineTypedIntegrationRoute("OPTIONS", path26, input);
     },
-    head(path24, input) {
+    head(path26, input) {
       return defineTypedIntegrationRoute(
         "HEAD",
-        path24,
+        path26,
         input
       );
     }
@@ -3272,8 +3272,8 @@ function normalizeIntegrationValidationIssues(source, error) {
     }
   ];
 }
-function normalizeIntegrationValidationPath(path24) {
-  return (path24 || []).map((segment) => {
+function normalizeIntegrationValidationPath(path26) {
+  return (path26 || []).map((segment) => {
     const key = typeof segment === "object" && segment !== null && "key" in segment ? segment.key : segment;
     return typeof key === "symbol" ? key.description || key.toString() : key;
   });
@@ -3962,8 +3962,8 @@ function createFarmDeploymentMismatchResponse(mismatch) {
     }
   );
 }
-function createFarmDeploymentCookie(deploymentId, path24 = "/", secure = false) {
-  const normalizedPath = path24.startsWith("/") ? path24 : `/${path24}`;
+function createFarmDeploymentCookie(deploymentId, path26 = "/", secure = false) {
+  const normalizedPath = path26.startsWith("/") ? path26 : `/${path26}`;
   return [
     `${FARM_DEPLOYMENT_COOKIE}=${encodeURIComponent(deploymentId)}`,
     `Path=${normalizedPath}`,
@@ -4219,6 +4219,33 @@ var init_auth_config = __esm({
   }
 });
 
+// src/preload.ts
+function resolveFarmPerformanceConfig(config) {
+  return {
+    preload: {
+      mode: config?.preload?.mode === "warn" ? "warn" : "enforce",
+      maxImages: normalizeBudget(config?.preload?.maxImages, DEFAULT_PRELOAD_CONFIG.maxImages),
+      maxFonts: normalizeBudget(config?.preload?.maxFonts, DEFAULT_PRELOAD_CONFIG.maxFonts)
+    }
+  };
+}
+function normalizeBudget(value, fallback) {
+  return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.floor(value) : fallback;
+}
+var DEFAULT_PRELOAD_CONFIG;
+var init_preload = __esm({
+  "src/preload.ts"() {
+    "use strict";
+    DEFAULT_PRELOAD_CONFIG = {
+      mode: "enforce",
+      maxImages: 1,
+      maxFonts: 2
+    };
+    __name(resolveFarmPerformanceConfig, "resolveFarmPerformanceConfig");
+    __name(normalizeBudget, "normalizeBudget");
+  }
+});
+
 // src/write-file-if-changed.ts
 function writeFileIfChanged(filePath, content) {
   try {
@@ -4338,11 +4365,11 @@ var init_type_generator = __esm({
           routeGroups.get(key).push(route);
         }
         const nestedStructure = {};
-        for (const [path24, routeList] of routeGroups) {
+        for (const [path26, routeList] of routeGroups) {
           const route = routeList[0];
           const importPath = this.getRouteImportPath(route, options.outFile);
           const routeName = this.pathToRouteName(route.path);
-          const cleanPath = path24 === "/api" ? "" : path24.replace(/^\/api\//, "");
+          const cleanPath = path26 === "/api" ? "" : path26.replace(/^\/api\//, "");
           const parts = cleanPath ? cleanPath.split("/") : [];
           const allMethods = routeList.flatMap((r) => r.methods);
           for (const method of allMethods) {
@@ -4401,8 +4428,8 @@ ${typeExports}
         const relativeImport = (0, import_path7.relative)((0, import_path7.dirname)(outFile), route.filePath).replace(/\\/g, "/").replace(/\.(ts|tsx|js|jsx)$/, "");
         return relativeImport.startsWith(".") ? relativeImport : `./${relativeImport}`;
       }
-      pathToRouteName(path24) {
-        return (path24 === "/api" ? "root" : path24.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
+      pathToRouteName(path26) {
+        return (path26 === "/api" ? "root" : path26.replace(/^\/api\//, "")).replace(/\//g, "_").replace(/[^a-zA-Z0-9_]/g, "");
       }
       structureToTypeString(obj, indent) {
         const spaces = "  ".repeat(indent);
@@ -4422,15 +4449,15 @@ ${typeExports}
       toTypePropertyKey(key) {
         return /^[$A-Z_][0-9A-Z_$]*$/i.test(key) ? key : JSON.stringify(key);
       }
-      getBaseExportName(path24) {
-        const cleanPath = path24.replace(/^\/api\//, "");
+      getBaseExportName(path26) {
+        const cleanPath = path26.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return "api";
         }
         return cleanPath;
       }
-      getExportName(path24, method) {
-        const cleanPath = path24.replace(/^\/api\//, "");
+      getExportName(path26, method) {
+        const cleanPath = path26.replace(/^\/api\//, "");
         if (cleanPath === "") {
           return method.toLowerCase();
         }
@@ -4872,28 +4899,71 @@ var init_image_server = __esm({
   }
 });
 
+// src/docs/fonts.ts
+function resolveFarmDocsFontAssets(root) {
+  return FARM_DOCS_FONT_SOURCES.flatMap(({ family, packagePath }) => {
+    const sourcePath = import_node_path10.default.join(root, "node_modules", packagePath);
+    if (!(0, import_node_fs6.existsSync)(sourcePath)) return [];
+    const source = (0, import_node_fs6.readFileSync)(sourcePath);
+    const fingerprint = (0, import_node_crypto3.createHash)("sha256").update(source).digest("hex").slice(0, 12);
+    const extension = import_node_path10.default.extname(packagePath);
+    const baseName = import_node_path10.default.basename(packagePath, extension);
+    return [
+      {
+        family,
+        sourcePath,
+        url: `/assets/fonts/${baseName}-h${fingerprint}${extension}`
+      }
+    ];
+  });
+}
+function toFarmDocsPublicFontAssets(assets) {
+  return assets.map(({ family, url }) => ({ family, url }));
+}
+var import_node_crypto3, import_node_fs6, import_node_path10, FARM_DOCS_FONT_SOURCES;
+var init_fonts = __esm({
+  "src/docs/fonts.ts"() {
+    "use strict";
+    import_node_crypto3 = require("crypto");
+    import_node_fs6 = require("fs");
+    import_node_path10 = __toESM(require("path"));
+    FARM_DOCS_FONT_SOURCES = [
+      {
+        family: "Geist Sans",
+        packagePath: "geist/dist/fonts/geist-sans/Geist-Variable.woff2"
+      },
+      {
+        family: "Geist Mono",
+        packagePath: "geist/dist/fonts/geist-mono/GeistMono-Variable.woff2"
+      }
+    ];
+    __name(resolveFarmDocsFontAssets, "resolveFarmDocsFontAssets");
+    __name(toFarmDocsPublicFontAssets, "toFarmDocsPublicFontAssets");
+  }
+});
+
 // src/docs/last-modified.ts
 function normalizeRelativePath(value) {
   return value.replace(/\\/g, "/").replace(/^\.\/+/, "");
 }
 function resolveExistingPath(filePath) {
   try {
-    return (0, import_node_fs6.realpathSync)(filePath);
+    return (0, import_node_fs7.realpathSync)(filePath);
   } catch {
-    return import_node_path9.default.resolve(filePath);
+    return import_node_path11.default.resolve(filePath);
   }
 }
 function isDocsSourceFile(filePath) {
-  return DOCS_FILE_EXTENSIONS.has(import_node_path9.default.extname(filePath).toLowerCase());
+  return DOCS_FILE_EXTENSIONS.has(import_node_path11.default.extname(filePath).toLowerCase());
 }
 function discoverDocsSourceFiles(contentDir) {
   const files = [];
   const visit = /* @__PURE__ */ __name((dir) => {
-    for (const entry of (0, import_node_fs6.readdirSync)(dir, { withFileTypes: true }).sort(
+    for (const entry of (0, import_node_fs7.readdirSync)(dir, { withFileTypes: true }).sort(
       (a, b) => a.name.localeCompare(b.name)
     )) {
       if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-      const absolutePath = import_node_path9.default.join(dir, entry.name);
+      const absolutePath = import_node_path11.default.join(dir, entry.name);
       if (entry.isDirectory()) {
         visit(absolutePath);
       } else if (entry.isFile() && isDocsSourceFile(absolutePath)) {
@@ -4901,7 +4971,7 @@ function discoverDocsSourceFiles(contentDir) {
       }
     }
   }, "visit");
-  if ((0, import_node_fs6.existsSync)(contentDir)) visit(contentDir);
+  if ((0, import_node_fs7.existsSync)(contentDir)) visit(contentDir);
   return files;
 }
 function getGitLastModifiedDates(contentDir) {
@@ -4911,7 +4981,7 @@ function getGitLastModifiedDates(contentDir) {
       stdio: ["ignore", "pipe", "ignore"]
     }).trim();
     if (!gitRoot) return {};
-    const contentPathspec = normalizeRelativePath(import_node_path9.default.relative(gitRoot, contentDir)) || ".";
+    const contentPathspec = normalizeRelativePath(import_node_path11.default.relative(gitRoot, contentDir)) || ".";
     const contentPrefix = contentPathspec === "." ? "" : `${contentPathspec}/`;
     const history = (0, import_node_child_process.execFileSync)(
       "git",
@@ -4953,11 +5023,11 @@ function getGitLastModifiedDates(contentDir) {
   }
 }
 function readManifest(contentDir) {
-  const manifestPath = import_node_path9.default.join(contentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST);
-  if (!(0, import_node_fs6.existsSync)(manifestPath)) return null;
+  const manifestPath = import_node_path11.default.join(contentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST);
+  if (!(0, import_node_fs7.existsSync)(manifestPath)) return null;
   try {
     const parsed = JSON.parse(
-      (0, import_node_fs6.readFileSync)(manifestPath, "utf8")
+      (0, import_node_fs7.readFileSync)(manifestPath, "utf8")
     );
     if (parsed.version !== 1 || !parsed.pages || typeof parsed.pages !== "object") return null;
     const pages = Object.fromEntries(
@@ -4976,15 +5046,15 @@ function createFarmDocsLastModifiedManifest(contentDir, options = {}) {
   const fallbackDate = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
   const pages = {};
   for (const sourcePath of discoverDocsSourceFiles(resolvedContentDir)) {
-    const relativePath2 = normalizeRelativePath(import_node_path9.default.relative(resolvedContentDir, sourcePath));
-    pages[relativePath2] = gitDates[relativePath2] || (options.fallback === "now" ? fallbackDate : (0, import_node_fs6.statSync)(sourcePath).mtime.toISOString());
+    const relativePath2 = normalizeRelativePath(import_node_path11.default.relative(resolvedContentDir, sourcePath));
+    pages[relativePath2] = gitDates[relativePath2] || (options.fallback === "now" ? fallbackDate : (0, import_node_fs7.statSync)(sourcePath).mtime.toISOString());
   }
   return { version: 1, pages };
 }
 function getLastModifiedManifest(contentDir) {
   const resolvedContentDir = resolveExistingPath(contentDir);
-  const manifestPath = import_node_path9.default.join(resolvedContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST);
-  const manifestStat = (0, import_node_fs6.existsSync)(manifestPath) ? (0, import_node_fs6.statSync)(manifestPath) : null;
+  const manifestPath = import_node_path11.default.join(resolvedContentDir, FARM_DOCS_LAST_MODIFIED_MANIFEST);
+  const manifestStat = (0, import_node_fs7.existsSync)(manifestPath) ? (0, import_node_fs7.statSync)(manifestPath) : null;
   const signature = manifestStat ? `file:${manifestStat.mtimeMs}:${manifestStat.size}` : "generated";
   const cached = manifestCache.get(resolvedContentDir);
   if (cached?.signature === signature) return cached.manifest;
@@ -4997,21 +5067,21 @@ function resolveFarmDocsPageLastModified(contentDir, sourcePath, frontmatter) {
   if (configured) return configured;
   const resolvedContentDir = resolveExistingPath(contentDir);
   const resolvedSourcePath = resolveExistingPath(sourcePath);
-  const relativePath2 = normalizeRelativePath(import_node_path9.default.relative(resolvedContentDir, resolvedSourcePath));
-  const isInsideContentDir = relativePath2 !== ".." && !relativePath2.startsWith("../") && !import_node_path9.default.isAbsolute(relativePath2);
+  const relativePath2 = normalizeRelativePath(import_node_path11.default.relative(resolvedContentDir, resolvedSourcePath));
+  const isInsideContentDir = relativePath2 !== ".." && !relativePath2.startsWith("../") && !import_node_path11.default.isAbsolute(relativePath2);
   if (isInsideContentDir) {
     const generated = getLastModifiedManifest(resolvedContentDir).pages[relativePath2];
     if (generated) return generated;
   }
-  return (0, import_node_fs6.statSync)(resolvedSourcePath).mtime.toISOString();
+  return (0, import_node_fs7.statSync)(resolvedSourcePath).mtime.toISOString();
 }
-var import_node_child_process, import_node_fs6, import_node_path9, FARM_DOCS_LAST_MODIFIED_MANIFEST, COMMIT_MARKER, DOCS_FILE_EXTENSIONS, manifestCache;
+var import_node_child_process, import_node_fs7, import_node_path11, FARM_DOCS_LAST_MODIFIED_MANIFEST, COMMIT_MARKER, DOCS_FILE_EXTENSIONS, manifestCache;
 var init_last_modified = __esm({
   "src/docs/last-modified.ts"() {
     "use strict";
     import_node_child_process = require("child_process");
-    import_node_fs6 = require("fs");
-    import_node_path9 = __toESM(require("path"));
+    import_node_fs7 = require("fs");
+    import_node_path11 = __toESM(require("path"));
     FARM_DOCS_LAST_MODIFIED_MANIFEST = ".farm-docs-last-modified.json";
     COMMIT_MARKER = "__FARM_DOCS_COMMIT__";
     DOCS_FILE_EXTENSIONS = /* @__PURE__ */ new Set([".md", ".mdx"]);
@@ -5073,8 +5143,8 @@ var init_pixel_border_css = __esm({
   --scrollbar-thumb-hover: var(--color-fd-ring);
   --scrollbar-track: transparent;
   --radius: 0px;
-  --font-geist-sans: "Geist Sans";
-  --font-geist-mono: "Geist Mono";
+  --font-geist-sans: ui-sans-serif, system-ui, sans-serif;
+  --font-geist-mono: ui-monospace, monospace;
 }
 
 .dark {
@@ -5087,28 +5157,6 @@ body,
   background-color: var(--color-fd-background) !important;
 }
 
-@font-face {
-  font-family: "Geist Sans";
-  font-display: block;
-  font-style: normal;
-  font-weight: 100 900;
-  src:
-    local("Geist Sans"),
-    url("/assets/Geist-Variable-CrgPqtmy.woff2") format("woff2"),
-    url("/node_modules/geist/dist/fonts/geist-sans/Geist-Variable.woff2") format("woff2");
-}
-
-@font-face {
-  font-family: "Geist Mono";
-  font-display: block;
-  font-style: normal;
-  font-weight: 100 900;
-  src:
-    local("Geist Mono"),
-    url("/assets/GeistMono-Variable-BNLlm6Cd.woff2") format("woff2"),
-    url("/node_modules/geist/dist/fonts/geist-mono/GeistMono-Variable.woff2") format("woff2");
-}
-
 * {
   scrollbar-color: var(--scrollbar-thumb) var(--scrollbar-track);
   scrollbar-width: thin;
@@ -6315,10 +6363,10 @@ function isFarmDocsSearchEnabled(docs) {
 }
 function resolveFarmDocsSearchClientModule(root) {
   try {
-    const requireFromApp = (0, import_node_module4.createRequire)(import_node_path10.default.join(import_node_path10.default.resolve(root), "package.json"));
+    const requireFromApp = (0, import_node_module4.createRequire)(import_node_path12.default.join(import_node_path12.default.resolve(root), "package.json"));
     const themeEntry = requireFromApp.resolve("@farming-labs/theme");
-    const commandSearchModule = import_node_path10.default.join(import_node_path10.default.dirname(themeEntry), "docs-command-search.mjs");
-    if ((0, import_node_fs7.existsSync)(commandSearchModule)) return commandSearchModule;
+    const commandSearchModule = import_node_path12.default.join(import_node_path12.default.dirname(themeEntry), "docs-command-search.mjs");
+    if ((0, import_node_fs8.existsSync)(commandSearchModule)) return commandSearchModule;
   } catch {
   }
   return void 0;
@@ -6457,13 +6505,13 @@ async function mountFarmDocsSearch() {
 window.__FARM_MOUNT_DOCS_SEARCH__ = mountFarmDocsSearch;
 `;
 }
-var import_node_fs7, import_node_module4, import_node_path10;
+var import_node_fs8, import_node_module4, import_node_path12;
 var init_search_client = __esm({
   "src/docs/search-client.ts"() {
     "use strict";
-    import_node_fs7 = require("fs");
+    import_node_fs8 = require("fs");
     import_node_module4 = require("module");
-    import_node_path10 = __toESM(require("path"));
+    import_node_path12 = __toESM(require("path"));
     __name(isFarmDocsSearchEnabled, "isFarmDocsSearchEnabled");
     __name(resolveFarmDocsSearchClientModule, "resolveFarmDocsSearchClientModule");
     __name(generateFarmDocsSearchBootstrapRuntime, "generateFarmDocsSearchBootstrapRuntime");
@@ -6471,11 +6519,418 @@ var init_search_client = __esm({
   }
 });
 
+// src/docs/social-image.ts
+function normalizeEntry(entry) {
+  if (!entry || entry === "/") return "";
+  return `/${entry.replace(/^\/+|\/+$/g, "")}`;
+}
+function encodeSlugPath(slug) {
+  return slug.split("/").filter(Boolean).map((segment) => encodeURIComponent(segment)).join("/");
+}
+function getSocialImageConfig(docs) {
+  return typeof docs.config.socialImage === "object" && docs.config.socialImage ? docs.config.socialImage : void 0;
+}
+function getNavTitle(docs) {
+  if (typeof docs.config.nav !== "object" || !docs.config.nav || !("title" in docs.config.nav)) {
+    return "Farm.js";
+  }
+  return String(docs.config.nav.title || "Farm.js");
+}
+function isFalse(value) {
+  return value ? /^(false|no|none|off|disabled)$/i.test(value.trim()) : false;
+}
+function isExternalOrRootPath(value) {
+  return /^(https?:)?\/\//i.test(value) || value.startsWith("/");
+}
+function isFarmDocsSocialImageEnabled(page2, docs) {
+  if (docs.config.socialImage === false || getSocialImageConfig(docs)?.enabled === false) {
+    return false;
+  }
+  return !isFalse(page2.frontmatter.socialImage);
+}
+function getFarmDocsCustomSocialImage(page2) {
+  const value = page2.frontmatter.socialImage || page2.frontmatter.openGraphImage || page2.frontmatter.ogImage;
+  return value && !isFalse(value) && isExternalOrRootPath(value) ? value : void 0;
+}
+function resolveIllustration(page2) {
+  const explicit = page2.frontmatter.socialIllustration?.toLowerCase();
+  if (explicit === "auth" || explicit === "cache" || explicit === "cli" || explicit === "integrations" || explicit === "project" || explicit === "routing" || explicit === "runtime") {
+    return explicit;
+  }
+  const source = `${page2.slug} ${page2.title} ${page2.section || ""}`.toLowerCase();
+  if (/auth|session|security|csrf/.test(source)) return "auth";
+  if (/cache|ppr|render|static|revalid|stream/.test(source)) return "cache";
+  if (/integration|stripe|prisma|better.auth|email|job|workflow/.test(source)) {
+    return "integrations";
+  }
+  if (/cli|test|deploy|preview|upgrade|migration|install/.test(source)) return "cli";
+  if (/project|structure|config|environment|markdown|docs.engine/.test(source)) {
+    return "project";
+  }
+  if (/rout|endpoint|middleware|navigation|server.function|server.action|api/.test(source)) {
+    return "routing";
+  }
+  return "runtime";
+}
+function createHashValue(value) {
+  return (0, import_node_crypto4.createHash)("sha256").update(JSON.stringify(value)).digest("hex").slice(0, 16);
+}
+function resolveBaseUrl(requestUrl, config) {
+  return config?.baseUrl ? new URL(config.baseUrl) : new URL(requestUrl.origin);
+}
+function createFarmDocsSocialImageDescriptor(page2, docs, requestUrl) {
+  const config = getSocialImageConfig(docs);
+  const siteName = config?.siteName || getNavTitle(docs);
+  const brand = config?.brand || siteName;
+  const title = page2.frontmatter.socialTitle || page2.title;
+  const description = page2.frontmatter.socialDescription || page2.description || docs.config.metadata?.description || `Documentation for ${siteName}`;
+  const section = page2.frontmatter.section || page2.section || "Documentation";
+  const illustration = resolveIllustration(page2);
+  const entry = normalizeEntry(docs.entry);
+  const slugPath = encodeSlugPath(page2.slug) || "index";
+  const imagePath = `${entry}/_social/${slugPath}/opengraph-image.svg`;
+  const baseUrl = resolveBaseUrl(requestUrl, config);
+  const pageUrl = new URL(page2.href, baseUrl).href;
+  const imageAlt = `${title} \u2014 ${siteName} documentation`;
+  const hash = createHashValue({
+    version: FARM_DOCS_SOCIAL_IMAGE_VERSION,
+    title,
+    description,
+    section,
+    siteName,
+    brand,
+    pageHref: page2.href,
+    illustration,
+    fonts: config?.fonts
+  });
+  return {
+    title,
+    description,
+    section,
+    siteName,
+    brand,
+    pageHref: page2.href,
+    pageUrl,
+    imagePath,
+    imageUrl: new URL(`${imagePath}?v=${hash}`, baseUrl).href,
+    imageAlt,
+    illustration,
+    fonts: config?.fonts,
+    hash
+  };
+}
+function getFarmDocsSocialImageSlug(docs, requestUrl) {
+  const entry = normalizeEntry(docs.entry);
+  const prefix = `${entry}/_social/`;
+  const suffix = "/opengraph-image.svg";
+  if (!requestUrl.pathname.startsWith(prefix) || !requestUrl.pathname.endsWith(suffix)) {
+    return null;
+  }
+  const rawSlug = requestUrl.pathname.slice(prefix.length, -suffix.length);
+  if (!rawSlug) return null;
+  try {
+    const slug = rawSlug.split("/").map((segment) => decodeURIComponent(segment)).join("/");
+    if (slug.split("/").some((segment) => !segment || segment === ".." || segment === ".")) {
+      return null;
+    }
+    return slug === "index" ? "" : slug;
+  } catch {
+    return null;
+  }
+}
+function escapeXml(value) {
+  return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
+}
+function truncate(value, length) {
+  if (value.length <= length) return value;
+  return `${value.slice(0, Math.max(0, length - 1)).trimEnd()}\u2026`;
+}
+function wrapText(value, maxCharacters, maxLines) {
+  const words = value.trim().split(/\s+/).filter(Boolean);
+  const lines = [];
+  let current = "";
+  let consumedWords = 0;
+  for (const word of words) {
+    const candidate = current ? `${current} ${word}` : word;
+    if (candidate.length <= maxCharacters || !current) {
+      current = candidate;
+      consumedWords += 1;
+      continue;
+    }
+    lines.push(current);
+    if (lines.length === maxLines) break;
+    current = word;
+    consumedWords += 1;
+  }
+  if (current && lines.length < maxLines) lines.push(current);
+  if (consumedWords < words.length && lines.length) {
+    lines[lines.length - 1] = truncate(`${lines[lines.length - 1]}\u2026`, maxCharacters);
+  }
+  return lines;
+}
+function renderTextLines(lines, x, y, lineHeight, attributes) {
+  return lines.map(
+    (line, index) => `<text x="${x}" y="${y + index * lineHeight}" ${attributes}>${escapeXml(line)}</text>`
+  ).join("");
+}
+function renderEmbeddedFont(name, source, weight) {
+  if (!source) return "";
+  return `@font-face{font-family:"${name}";src:url("${escapeXml(source)}") format("woff2");font-style:normal;font-weight:${weight};font-display:block;}`;
+}
+function renderArrow(x1, y, x2, color = "#8b8b8b") {
+  return `<path d="M${x1} ${y}H${x2 - 9}" fill="none" stroke="${color}"/><path d="m${x2 - 9} ${y - 5} 9 5-9 5" fill="none" stroke="${color}"/>`;
+}
+function renderPanelHeader(label, status) {
+  return `<text x="819" y="171" class="label">${escapeXml(label)}</text><text x="1134" y="171" class="label bright" text-anchor="end">${escapeXml(status)}</text>`;
+}
+function renderRoutingIllustration() {
+  return `${renderPanelHeader("ROUTE BLUEPRINT", "TYPED")}
+    <rect x="819" y="296" width="92" height="54" fill="#a3a3a3"/>
+    <text x="832" y="327" class="diagram-title ink">src/app</text>
+    <path d="M911 323h41M952 232v181M952 232h44M952 323h44M952 413h44" fill="none" stroke="#696969"/>
+    <rect x="996" y="205" width="138" height="54" fill="#0a0a0a" stroke="#414141"/>
+    <text x="1010" y="228" class="diagram-title">/</text><text x="1010" y="246" class="micro">STATIC</text>
+    <rect x="996" y="296" width="138" height="54" fill="#0a0a0a" stroke="#414141"/>
+    <text x="1010" y="319" class="diagram-title">/blog/:slug</text><text x="1010" y="337" class="micro">DYNAMIC</text>
+    <rect x="996" y="386" width="138" height="55" fill="#f0f0f0"/>
+    <text x="1010" y="410" class="diagram-title ink">/docs/:path*</text><text x="1010" y="428" class="micro ink-muted">CATCH-ALL</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">FILE ROUTES</text><text x="1134" y="475" class="label" text-anchor="end">TYPES INCLUDED</text>`;
+}
+function renderAuthIllustration() {
+  return `${renderPanelHeader("REQUEST GUARD", "SERVER VERIFIED")}
+    <rect x="819" y="269" width="86" height="54" fill="#0a0a0a" stroke="#454545"/>
+    <text x="837" y="292" class="micro bright">REQUEST</text><text x="837" y="310" class="diagram-title">GET /app</text>
+    ${renderArrow(905, 296, 943)}
+    <rect x="943" y="224" width="104" height="118" fill="#f0f0f0"/>
+    <path d="M974 271v-12a21 21 0 0 1 42 0v12M968 271h54v45h-54z" fill="#050505"/>
+    <circle cx="995" cy="292" r="4" fill="#f0f0f0"/><path d="M995 296v8" stroke="#f0f0f0" stroke-width="3"/>
+    <text x="995" y="332" class="micro ink" text-anchor="middle">auth()</text>
+    ${renderArrow(1047, 296, 1071)}
+    <rect x="1071" y="269" width="63" height="54" fill="#0a0a0a" stroke="#454545"/>
+    <text x="1082" y="292" class="micro bright">ALLOW</text><text x="1082" y="310" class="micro">/app</text>
+    <rect x="819" y="372" width="315" height="38" fill="#090909" stroke="#3d3d3d"/>
+    <rect x="832" y="385" width="11" height="11" fill="#a3a3a3"/>
+    <text x="856" y="395" class="code">session.user / verified</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">SESSION TYPED</text><text x="1134" y="475" class="label" text-anchor="end">CSRF PROTECTED</text>`;
+}
+function renderCacheIllustration() {
+  return `${renderPanelHeader("PAGE / PRODUCT", "CACHE + PPR")}
+    <rect x="819" y="204" width="315" height="54" fill="#f0f0f0"/>
+    <text x="836" y="235" class="diagram-title ink">STATIC SHELL</text><text x="1116" y="235" class="micro ink-muted" text-anchor="end">BUILD</text>
+    <rect x="819" y="271" width="198" height="76" fill="#a3a3a3"/>
+    <text x="836" y="301" class="diagram-title ink">CACHED DATA</text><text x="836" y="326" class="micro ink-muted">tag: products</text>
+    <rect x="1029" y="271" width="105" height="76" fill="#0a0a0a" stroke="#555"/>
+    <text x="1045" y="301" class="diagram-title">LIVE</text><text x="1045" y="326" class="micro">stream</text>
+    <path d="M1081 347v43m-8-9 8 9 8-9" fill="none" stroke="#d4d4d4"/>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">STATIC FIRST</text><text x="1134" y="475" class="label" text-anchor="end">DYNAMIC WHERE NEEDED</text>`;
+}
+function renderIntegrationsIllustration() {
+  return `${renderPanelHeader("INTEGRATION GRAPH", "ONE PRODUCT")}
+    <path d="M976 309H879V247M976 309H879v87M1030 309h93V247M1030 309h93v87" fill="none" stroke="#4a4a4a"/>
+    <rect x="819" y="214" width="120" height="57" fill="#0a0a0a" stroke="#4b4b4b"/><text x="839" y="247" class="diagram-title">BETTER AUTH</text>
+    <rect x="819" y="368" width="120" height="57" fill="#0a0a0a" stroke="#4b4b4b"/><text x="851" y="401" class="diagram-title">PRISMA</text>
+    <rect x="1061" y="214" width="73" height="57" fill="#0a0a0a" stroke="#4b4b4b"/><text x="1077" y="247" class="diagram-title">STRIPE</text>
+    <rect x="1061" y="368" width="73" height="57" fill="#a3a3a3"/><text x="1075" y="401" class="diagram-title ink">VERCEL</text>
+    <rect x="976" y="277" width="94" height="64" fill="#f0f0f0"/>
+    <text x="994" y="304" class="diagram-title ink">FARM.JS</text><text x="994" y="324" class="micro ink-muted">CORE</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">BRING YOUR STACK</text><text x="1134" y="475" class="label" text-anchor="end">CONNECTED ONCE</text>`;
+}
+function renderCliIllustration() {
+  return `${renderPanelHeader("TERMINAL", "PRODUCTION OUTPUT")}
+    <rect x="819" y="203" width="315" height="213" fill="#050505" stroke="#555"/>
+    <line x1="819" y1="236" x2="1134" y2="236" stroke="#555"/>
+    <circle cx="837" cy="220" r="4" fill="#5d5d5d"/><circle cx="850" cy="220" r="4" fill="#7a7a7a"/><circle cx="863" cy="220" r="4" fill="#a3a3a3"/>
+    <text x="837" y="273" class="code bright"><tspan fill="#7a7a7a">$</tspan> farm build</text>
+    <rect x="837" y="293" width="11" height="11" fill="#a3a3a3"/><path d="m839 298 3 3 6-7" fill="none" stroke="#050505" stroke-width="1.5"/>
+    <text x="861" y="303" class="code">64 routes discovered</text>
+    <rect x="837" y="320" width="11" height="11" fill="#a3a3a3"/><path d="m839 325 3 3 6-7" fill="none" stroke="#050505" stroke-width="1.5"/>
+    <text x="861" y="330" class="code">client + server bundles</text>
+    <rect x="837" y="355" width="126" height="30" fill="#f0f0f0"/><text x="853" y="374" class="micro ink">BUILD COMPLETE</text>
+    <text x="1115" y="374" class="micro" text-anchor="end">/dist</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">REAL COMMANDS</text><text x="1134" y="475" class="label" text-anchor="end">842MS</text>`;
+}
+function renderProjectIllustration() {
+  return `${renderPanelHeader("PROJECT MAP", "CONVENTION TYPED")}
+    <rect x="819" y="202" width="315" height="216" fill="#050505" stroke="#555"/>
+    <text x="837" y="227" class="diagram-title bright">my-app/</text>
+    <path d="M847 243v143M847 259h23M847 293h23M847 327h23M847 361h23" fill="none" stroke="#666"/>
+    <rect x="870" y="243" width="246" height="33" fill="#0a0a0a" stroke="#444"/><text x="886" y="264" class="code">src/app</text><text x="1098" y="264" class="micro" text-anchor="end">ROUTES</text>
+    <rect x="870" y="277" width="246" height="33" fill="#f0f0f0"/><text x="886" y="298" class="code ink">src/app/page.tsx</text>
+    <rect x="870" y="311" width="246" height="33" fill="#0a0a0a" stroke="#444"/><text x="886" y="332" class="code">src/app/api/users/route.ts</text><text x="1098" y="332" class="micro" text-anchor="end">API</text>
+    <rect x="870" y="345" width="246" height="33" fill="#0a0a0a" stroke="#444"/><text x="886" y="366" class="code">farm.config.ts</text><text x="1098" y="366" class="micro" text-anchor="end">CONFIG</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">FILES BECOME FEATURES</text><text x="1134" y="475" class="label" text-anchor="end">ONE CONFIG</text>`;
+}
+function renderRuntimeIllustration() {
+  return `${renderPanelHeader("PRODUCT ARCHITECTURE", "FULL STACK")}
+    <rect x="819" y="211" width="315" height="55" fill="#f0f0f0"/>
+    <text x="836" y="244" class="diagram-title ink">PRODUCT SURFACE</text><text x="1116" y="244" class="micro ink-muted" text-anchor="end">UI + ROUTES</text>
+    <path d="M976 266v20m0 61v20" stroke="#727272"/>
+    <rect x="855" y="286" width="242" height="61" fill="#a3a3a3"/>
+    <text x="874" y="314" class="diagram-title ink">APPLICATION CORE</text><text x="874" y="334" class="micro ink-muted">APIS \xB7 MIDDLEWARE</text>
+    <rect x="819" y="367" width="315" height="55" fill="#4c4c4c"/>
+    <text x="836" y="400" class="diagram-title bright">CONNECTED STACK</text><text x="1116" y="400" class="micro" text-anchor="end">DATA \xB7 AUTH \xB7 DEPLOY</text>
+    <line x1="819" y1="450" x2="1134" y2="450" stroke="#343434"/>
+    <text x="819" y="475" class="label bright">ONE FRAMEWORK</text><text x="1134" y="475" class="label" text-anchor="end">ONE DEPLOYMENT MODEL</text>`;
+}
+function renderIllustration(type) {
+  switch (type) {
+    case "auth":
+      return renderAuthIllustration();
+    case "cache":
+      return renderCacheIllustration();
+    case "cli":
+      return renderCliIllustration();
+    case "integrations":
+      return renderIntegrationsIllustration();
+    case "project":
+      return renderProjectIllustration();
+    case "routing":
+      return renderRoutingIllustration();
+    default:
+      return renderRuntimeIllustration();
+  }
+}
+function renderFarmDocsSocialImageSvg(descriptor) {
+  const titleLines = wrapText(descriptor.title, 22, 2);
+  const longestTitleLine = Math.max(...titleLines.map((line) => line.length));
+  const titleSize = titleLines.length === 1 ? longestTitleLine > 17 ? 62 : 74 : 56;
+  const titleLineHeight = Math.round(titleSize * 0.98);
+  const titleY = titleLines.length === 1 ? 294 : 266;
+  const descriptionY = titleY + (titleLines.length - 1) * titleLineHeight + 59;
+  const descriptionLines = wrapText(descriptor.description, 68, 2);
+  const routeY = Math.max(418, descriptionY + descriptionLines.length * 29 + 24);
+  const section = truncate(descriptor.section.toUpperCase(), 27);
+  const route = truncate(descriptor.pageHref, 42);
+  const footerUrl = truncate(descriptor.pageUrl.replace(/^https?:\/\//, ""), 70);
+  const brand = truncate(descriptor.brand.toUpperCase(), 25);
+  const titleId = `farm-docs-og-${descriptor.hash}`;
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="${FARM_DOCS_SOCIAL_IMAGE_WIDTH}" height="${FARM_DOCS_SOCIAL_IMAGE_HEIGHT}" viewBox="0 0 ${FARM_DOCS_SOCIAL_IMAGE_WIDTH} ${FARM_DOCS_SOCIAL_IMAGE_HEIGHT}" role="img" aria-labelledby="${titleId}-title ${titleId}-description">
+  <title id="${titleId}-title">${escapeXml(descriptor.imageAlt)}</title>
+  <desc id="${titleId}-description">${escapeXml(descriptor.description)}</desc>
+  <metadata>${escapeXml(JSON.stringify({ generator: "Farm.js docs", page: descriptor.pageUrl, illustration: descriptor.illustration }))}</metadata>
+  <style type="text/css">
+    ${renderEmbeddedFont("Farm Sans", descriptor.fonts?.sans, "100 900")}
+    ${renderEmbeddedFont("Farm Mono", descriptor.fonts?.mono, "100 900")}
+    ${renderEmbeddedFont("Farm Pixel", descriptor.fonts?.display, "400 700")}
+    .sans{font-family:"Farm Sans","Arial",sans-serif}.mono,.label,.code,.diagram-title,.micro{font-family:"Farm Mono","Menlo","DejaVu Sans Mono",monospace}.pixel{font-family:"Farm Pixel","Farm Mono",monospace}.label{fill:#8b8b8b;font-size:10px;font-weight:600;letter-spacing:1.2px}.code{fill:#8b8b8b;font-size:11px}.diagram-title{fill:#e7e7e7;font-size:11px;font-weight:650}.micro{fill:#777;font-size:8px;letter-spacing:.45px}.bright{fill:#f5f5f4}.ink{fill:#050505}.ink-muted{fill:#4c4c4c}
+  </style>
+  <defs>
+    <pattern id="canvas-grid" width="40" height="40" patternUnits="userSpaceOnUse"><path d="M40 0H0V40" fill="none" stroke="#151515"/></pattern>
+    <pattern id="diagonal" width="12" height="12" patternUnits="userSpaceOnUse" patternTransform="rotate(45)"><line x1="0" y1="0" x2="0" y2="12" stroke="#171717" stroke-width="2"/></pattern>
+    <clipPath id="frame-clip"><rect x="28" y="28" width="1144" height="574"/></clipPath>
+  </defs>
+  <rect width="1200" height="630" fill="#050505"/>
+  <rect width="1200" height="630" fill="url(#canvas-grid)"/>
+  <g clip-path="url(#frame-clip)">
+    <rect x="28" y="28" width="1144" height="574" fill="#020202"/>
+    <rect x="782" y="114" width="390" height="411" fill="url(#diagonal)"/>
+  </g>
+  <rect x="28.5" y="28.5" width="1143" height="573" fill="none" stroke="#323232"/>
+  <path d="M28 114.5h1144M28 525.5h1144M781.5 114v411" fill="none" stroke="#303030"/>
+
+  <g transform="translate(71 51)">
+    <rect width="11" height="11" rx="1" fill="#f5f5f4"/><rect x="15" width="28" height="11" rx="1" fill="#f5f5f4"/>
+    <rect y="15" width="11" height="11" rx="1" fill="#9b9b9b"/><rect x="15" y="15" width="28" height="11" rx="1" fill="#9b9b9b"/>
+    <rect y="30" width="11" height="11" rx="1" fill="#5f5f5f"/><rect x="15" y="30" width="20" height="11" rx="1" fill="#5f5f5f"/>
+    <text x="61" y="24" class="mono bright" font-size="24" font-weight="550">FARM<tspan fill="#777">.JS</tspan></text>
+    <text x="61" y="43" class="label">BY FARMING LABS</text>
+  </g>
+  <text x="1134" y="72" class="label" text-anchor="end">${escapeXml(brand)} \xB7 DOCUMENTATION</text>
+
+  <text x="71" y="198" class="mono bright" font-size="13" font-weight="650">DOCS</text>
+  <line x1="117" y1="193" x2="155" y2="193" stroke="#696969"/>
+  <text x="166" y="198" class="mono" fill="#9b9b9b" font-size="13">${escapeXml(section)}</text>
+  ${renderTextLines(titleLines, 71, titleY, titleLineHeight, `class="pixel bright" font-size="${titleSize}" font-weight="500" letter-spacing="-2.4"`)}
+  ${renderTextLines(descriptionLines, 71, descriptionY, 29, 'class="sans" fill="#a3a3a3" font-size="20" font-weight="430" letter-spacing="-.3"')}
+  <rect x="71" y="${routeY}" width="${Math.min(390, 56 + route.length * 8)}" height="36" fill="#050505" stroke="#3c3c3c"/>
+  <text x="85" y="${routeY + 23}" class="mono bright" font-size="11" font-weight="600">GET</text>
+  <text x="119" y="${routeY + 23}" class="mono" fill="#898989" font-size="11">${escapeXml(route)}</text>
+
+  ${renderIllustration(descriptor.illustration)}
+
+  <text x="71" y="570" class="mono bright" font-size="13" font-weight="550">${escapeXml(footerUrl)}</text>
+  <text x="1134" y="570" class="mono" fill="#9b9b9b" font-size="12" text-anchor="end">FARM.JS DOCUMENTATION</text>
+  <path d="M20 20h10M20 20v10M1180 20h-10M1180 20v10M20 610h10M20 610v-10M1180 610h-10M1180 610v-10" fill="none" stroke="#9b9b9b"/>
+</svg>`;
+}
+function renderFarmDocsSocialMetadata(descriptor, customImage) {
+  const imageUrl = customImage ? new URL(customImage, descriptor.pageUrl).href : descriptor.imageUrl;
+  const customExtension = customImage?.toLowerCase().split(/[?#]/, 1)[0];
+  const imageType = customExtension?.endsWith(".webp") ? "image/webp" : customExtension?.endsWith(".png") ? "image/png" : customExtension?.match(/\.jpe?g$/) ? "image/jpeg" : "image/svg+xml";
+  const tag = /* @__PURE__ */ __name((property, content, name = false) => `<meta ${name ? "name" : "property"}="${property}" content="${escapeXml(content)}">`, "tag");
+  return [
+    tag("og:type", "article"),
+    tag("og:site_name", descriptor.siteName),
+    tag("og:title", descriptor.title),
+    tag("og:description", descriptor.description),
+    tag("og:url", descriptor.pageUrl),
+    tag("og:image", imageUrl),
+    tag("og:image:type", imageType),
+    ...customImage ? [] : [
+      tag("og:image:width", String(FARM_DOCS_SOCIAL_IMAGE_WIDTH)),
+      tag("og:image:height", String(FARM_DOCS_SOCIAL_IMAGE_HEIGHT))
+    ],
+    tag("og:image:alt", descriptor.imageAlt),
+    tag("twitter:card", "summary_large_image", true),
+    tag("twitter:title", descriptor.title, true),
+    tag("twitter:description", descriptor.description, true),
+    tag("twitter:image", imageUrl, true),
+    tag("twitter:image:alt", descriptor.imageAlt, true)
+  ].join("\n  ");
+}
+var import_node_crypto4, FARM_DOCS_SOCIAL_IMAGE_WIDTH, FARM_DOCS_SOCIAL_IMAGE_HEIGHT, FARM_DOCS_SOCIAL_IMAGE_VERSION;
+var init_social_image = __esm({
+  "src/docs/social-image.ts"() {
+    "use strict";
+    import_node_crypto4 = require("crypto");
+    FARM_DOCS_SOCIAL_IMAGE_WIDTH = 1200;
+    FARM_DOCS_SOCIAL_IMAGE_HEIGHT = 630;
+    FARM_DOCS_SOCIAL_IMAGE_VERSION = 3;
+    __name(normalizeEntry, "normalizeEntry");
+    __name(encodeSlugPath, "encodeSlugPath");
+    __name(getSocialImageConfig, "getSocialImageConfig");
+    __name(getNavTitle, "getNavTitle");
+    __name(isFalse, "isFalse");
+    __name(isExternalOrRootPath, "isExternalOrRootPath");
+    __name(isFarmDocsSocialImageEnabled, "isFarmDocsSocialImageEnabled");
+    __name(getFarmDocsCustomSocialImage, "getFarmDocsCustomSocialImage");
+    __name(resolveIllustration, "resolveIllustration");
+    __name(createHashValue, "createHashValue");
+    __name(resolveBaseUrl, "resolveBaseUrl");
+    __name(createFarmDocsSocialImageDescriptor, "createFarmDocsSocialImageDescriptor");
+    __name(getFarmDocsSocialImageSlug, "getFarmDocsSocialImageSlug");
+    __name(escapeXml, "escapeXml");
+    __name(truncate, "truncate");
+    __name(wrapText, "wrapText");
+    __name(renderTextLines, "renderTextLines");
+    __name(renderEmbeddedFont, "renderEmbeddedFont");
+    __name(renderArrow, "renderArrow");
+    __name(renderPanelHeader, "renderPanelHeader");
+    __name(renderRoutingIllustration, "renderRoutingIllustration");
+    __name(renderAuthIllustration, "renderAuthIllustration");
+    __name(renderCacheIllustration, "renderCacheIllustration");
+    __name(renderIntegrationsIllustration, "renderIntegrationsIllustration");
+    __name(renderCliIllustration, "renderCliIllustration");
+    __name(renderProjectIllustration, "renderProjectIllustration");
+    __name(renderRuntimeIllustration, "renderRuntimeIllustration");
+    __name(renderIllustration, "renderIllustration");
+    __name(renderFarmDocsSocialImageSvg, "renderFarmDocsSocialImageSvg");
+    __name(renderFarmDocsSocialMetadata, "renderFarmDocsSocialMetadata");
+  }
+});
+
 // src/docs/handler.ts
 function trimSlashes2(value) {
   return value.replace(/^\/+|\/+$/g, "");
 }
-function normalizeEntry(entry) {
+function normalizeEntry2(entry) {
   if (!entry || entry === "/") return "/";
   return `/${trimSlashes2(entry)}`;
 }
@@ -6487,10 +6942,10 @@ function resolveFarmDocsFavicon(docs, options) {
   if (typeof configuredFavicon === "string" && configuredFavicon.trim()) {
     return configuredFavicon.trim();
   }
-  const publicDir = import_node_path11.default.join(import_node_path11.default.resolve(options.root), "public");
+  const publicDir = import_node_path13.default.join(import_node_path13.default.resolve(options.root), "public");
   for (const fileName of FARM_DOCS_FAVICON_FILES) {
-    const faviconPath = import_node_path11.default.join(publicDir, fileName);
-    if ((0, import_node_fs8.existsSync)(faviconPath) && (0, import_node_fs8.statSync)(faviconPath).isFile()) {
+    const faviconPath = import_node_path13.default.join(publicDir, fileName);
+    if ((0, import_node_fs9.existsSync)(faviconPath) && (0, import_node_fs9.statSync)(faviconPath).isFile()) {
       return `/${fileName}`;
     }
   }
@@ -6524,10 +6979,10 @@ function isSafeSegment(segment) {
   return segment !== ".." && !segment.includes("/") && !segment.includes("\\");
 }
 function resolveInside(root, target) {
-  const resolvedRoot = import_node_path11.default.resolve(root);
-  const resolvedTarget = import_node_path11.default.resolve(target);
-  const relative4 = import_node_path11.default.relative(resolvedRoot, resolvedTarget);
-  if (relative4 === "" || !relative4.startsWith("..") && !import_node_path11.default.isAbsolute(relative4)) {
+  const resolvedRoot = import_node_path13.default.resolve(root);
+  const resolvedTarget = import_node_path13.default.resolve(target);
+  const relative4 = import_node_path13.default.relative(resolvedRoot, resolvedTarget);
+  if (relative4 === "" || !relative4.startsWith("..") && !import_node_path13.default.isAbsolute(relative4)) {
     return resolvedTarget;
   }
   return null;
@@ -6536,36 +6991,36 @@ function isFarmDocsRequest(docs, request) {
   if (!docs?.enabled) return false;
   if (request.method !== "GET" && request.method !== "HEAD") return false;
   const pathname = new URL(request.url).pathname;
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   if (entry === "/") return true;
   return pathname === entry || pathname === `${entry}.md` || pathname.startsWith(`${entry}/`);
 }
 function resolveFarmDocsContentDir(docs, options) {
-  const root = import_node_path11.default.resolve(options.root);
+  const root = import_node_path13.default.resolve(options.root);
   const srcDir = options.srcDir || "src";
   const configuredContentDir = docs.contentDir || docs.config.contentDir;
   if (configuredContentDir) {
-    return import_node_path11.default.isAbsolute(configuredContentDir) ? configuredContentDir : import_node_path11.default.join(root, configuredContentDir);
+    return import_node_path13.default.isAbsolute(configuredContentDir) ? configuredContentDir : import_node_path13.default.join(root, configuredContentDir);
   }
   const entryDir = docs.config.entry || trimSlashes2(docs.entry) || "docs";
-  const appDocsDir = import_node_path11.default.join(root, srcDir, "app", entryDir);
-  if ((0, import_node_fs8.existsSync)(appDocsDir)) return appDocsDir;
-  return import_node_path11.default.join(root, entryDir);
+  const appDocsDir = import_node_path13.default.join(root, srcDir, "app", entryDir);
+  if ((0, import_node_fs9.existsSync)(appDocsDir)) return appDocsDir;
+  return import_node_path13.default.join(root, entryDir);
 }
 function getFarmDocsRouteTypeEntries(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   if (entry === "/") return ["/", "/[...docs]"];
   return [entry, `${entry}/[...docs]`];
 }
 function getFarmDocsDocumentNavigationMatchers(docs) {
   if (!docs?.enabled) return [];
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   return [entry === "/" ? "/(.*)" : `${entry}(.*)`];
 }
 function getRequestSlug(docs, request) {
   const pathname = new URL(request.url).pathname;
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   if (entry === "/") return normalizeSlug(pathname);
   if (pathname === entry || pathname === `${entry}.md`) return "";
   return normalizeSlug(pathname.slice(entry.length));
@@ -6573,14 +7028,14 @@ function getRequestSlug(docs, request) {
 function findDocsPageFile(contentDir, slug) {
   const segments = slug ? slug.split("/").filter(Boolean) : [];
   if (!segments.every(isSafeSegment)) return null;
-  const slugDir = import_node_path11.default.join(contentDir, ...segments);
-  const candidates = segments.length === 0 ? DOCS_FILE_NAMES.map((filename) => import_node_path11.default.join(contentDir, filename)) : [
-    ...DOCS_FILE_NAMES.map((filename) => import_node_path11.default.join(slugDir, filename)),
-    ...DOCS_FILE_EXTENSIONS2.map((extension) => import_node_path11.default.join(contentDir, `${slug}${extension}`))
+  const slugDir = import_node_path13.default.join(contentDir, ...segments);
+  const candidates = segments.length === 0 ? DOCS_FILE_NAMES.map((filename) => import_node_path13.default.join(contentDir, filename)) : [
+    ...DOCS_FILE_NAMES.map((filename) => import_node_path13.default.join(slugDir, filename)),
+    ...DOCS_FILE_EXTENSIONS2.map((extension) => import_node_path13.default.join(contentDir, `${slug}${extension}`))
   ];
   for (const candidate of candidates) {
     const safePath = resolveInside(contentDir, candidate);
-    if (safePath && (0, import_node_fs8.existsSync)(safePath) && (0, import_node_fs8.statSync)(safePath).isFile()) {
+    if (safePath && (0, import_node_fs9.existsSync)(safePath) && (0, import_node_fs9.statSync)(safePath).isFile()) {
       return safePath;
     }
   }
@@ -6615,7 +7070,7 @@ function titleFromMarkdown2(body, fallback) {
 function loadFarmDocsPage(contentDir, docs, slug) {
   const sourcePath = findDocsPageFile(contentDir, slug);
   if (!sourcePath) return null;
-  const source = (0, import_node_fs8.readFileSync)(sourcePath, "utf8");
+  const source = (0, import_node_fs9.readFileSync)(sourcePath, "utf8");
   const { frontmatter, body } = parseFrontmatter(source);
   const title = frontmatter.title || titleFromMarkdown2(body, titleFromSlug(slug));
   const href = createDocsHref(docs.entry, slug);
@@ -6623,6 +7078,7 @@ function loadFarmDocsPage(contentDir, docs, slug) {
     slug,
     title,
     description: frontmatter.description,
+    section: frontmatter.section,
     href,
     sourcePath,
     lastModified: resolveFarmDocsPageLastModified(contentDir, sourcePath, frontmatter),
@@ -6631,15 +7087,15 @@ function loadFarmDocsPage(contentDir, docs, slug) {
   };
 }
 function createDocsHref(entry, slug) {
-  const normalizedEntry = normalizeEntry(entry);
+  const normalizedEntry = normalizeEntry2(entry);
   const normalizedSlug = trimSlashes2(slug);
   if (normalizedEntry === "/") return normalizedSlug ? `/${normalizedSlug}` : "/";
   return normalizedSlug ? `${normalizedEntry}/${normalizedSlug}` : normalizedEntry;
 }
 function pathToSlug(contentDir, filePath) {
-  const relative4 = import_node_path11.default.relative(contentDir, filePath).replace(/\\/g, "/");
+  const relative4 = import_node_path13.default.relative(contentDir, filePath).replace(/\\/g, "/");
   if (relative4.startsWith("..")) return null;
-  const extension = import_node_path11.default.extname(relative4);
+  const extension = import_node_path13.default.extname(relative4);
   if (!DOCS_FILE_EXTENSIONS2.includes(extension)) return null;
   const withoutExtension = relative4.slice(0, -extension.length);
   if (withoutExtension === "page" || withoutExtension === "index") return "";
@@ -6652,12 +7108,12 @@ function loadPage(contentDir, docs, request) {
   return loadFarmDocsPage(contentDir, docs, getRequestSlug(docs, request));
 }
 function discoverFarmDocsPages(contentDir, docs) {
-  if (!(0, import_node_fs8.existsSync)(contentDir)) return [];
+  if (!(0, import_node_fs9.existsSync)(contentDir)) return [];
   const pages = [];
   const visit = /* @__PURE__ */ __name((dir) => {
-    for (const entry of (0, import_node_fs8.readdirSync)(dir, { withFileTypes: true })) {
+    for (const entry of (0, import_node_fs9.readdirSync)(dir, { withFileTypes: true })) {
       if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-      const absolutePath = import_node_path11.default.join(dir, entry.name);
+      const absolutePath = import_node_path13.default.join(dir, entry.name);
       if (entry.isDirectory()) {
         visit(absolutePath);
         continue;
@@ -6665,7 +7121,7 @@ function discoverFarmDocsPages(contentDir, docs) {
       if (!entry.isFile()) continue;
       const slug = pathToSlug(contentDir, absolutePath);
       if (slug === null) continue;
-      const source = (0, import_node_fs8.readFileSync)(absolutePath, "utf8");
+      const source = (0, import_node_fs9.readFileSync)(absolutePath, "utf8");
       const { frontmatter, body } = parseFrontmatter(source);
       pages.push({
         slug,
@@ -7443,7 +7899,7 @@ function renderPixelBreadcrumb(page2, docs) {
   const parentSegments = segments.slice(0, -1);
   const parentSegment = parentSegments[parentSegments.length - 1];
   const currentSegment = segments[segments.length - 1];
-  const entry = normalizeEntry(docs.entry);
+  const entry = normalizeEntry2(docs.entry);
   const parentPath = parentSegments.join("/");
   const parentHref = entry === "/" ? `/${parentPath}` : `${entry}/${parentPath}`;
   return `<nav class="fd-breadcrumb" aria-label="Breadcrumb">
@@ -7481,7 +7937,7 @@ ${items.map(
 </div>`;
 }
 function renderDocsRuntimeScript(docs) {
-  const docsEntry = JSON.stringify(normalizeEntry(docs.entry));
+  const docsEntry = JSON.stringify(normalizeEntry2(docs.entry));
   return `<script>(()=>{if(window.__farmDocsRuntime)return;window.__farmDocsRuntime=true;document.documentElement.dataset.farmDocsRuntime="true";document.documentElement.dataset.farmDocsRuntimeId=Math.random().toString(36).slice(2);const docsEntry=${docsEntry};let cleanupToc=()=>{};let closeMobileSidebar=()=>{};const normalizePath=(path)=>path.length>1?path.replace(/\\/+$/,""):path;const isDocsPath=(path)=>{const next=normalizePath(path);const entry=normalizePath(docsEntry);if(next.endsWith(".md"))return false;if(entry==="/")return true;return next===entry||next.startsWith(entry+"/")};const initToc=()=>{cleanupToc();const toc=document.getElementById("nd-toc");if(!toc){cleanupToc=()=>{};return}const links=Array.from(toc.querySelectorAll("[data-toc-item]"));const thumb=toc.querySelector("[data-toc-thumb]");const pairs=links.map((link)=>{let id=link.hash.slice(1);try{id=decodeURIComponent(id)}catch{}return{link,heading:document.getElementById(id)}}).filter((item)=>item.heading);const setActive=(active)=>{for(const {link} of pairs)link.dataset.active=link===active.link?"true":"false";if(!thumb)return;const styles=getComputedStyle(active.link);const top=active.link.offsetTop+parseFloat(styles.paddingTop||"0");const bottom=active.link.offsetTop+active.link.clientHeight-parseFloat(styles.paddingBottom||"0");thumb.style.clipPath="polygon(0 "+top+"px,100% "+top+"px,100% "+bottom+"px,0 "+bottom+"px)"};const update=()=>{if(pairs.length===0)return;const offset=Math.min(window.innerHeight*0.3,160);let active=pairs[0];for(const pair of pairs){if(pair.heading.getBoundingClientRect().top<=offset)active=pair;else break}setActive(active)};let frame=0;const schedule=()=>{if(frame)return;frame=requestAnimationFrame(()=>{frame=0;update()})};const onHashChange=()=>setTimeout(schedule,0);window.addEventListener("scroll",schedule,{passive:true});window.addEventListener("resize",schedule);window.addEventListener("hashchange",onHashChange);cleanupToc=()=>{window.removeEventListener("scroll",schedule);window.removeEventListener("resize",schedule);window.removeEventListener("hashchange",onHashChange);if(frame)cancelAnimationFrame(frame);frame=0};update()};const getSidebar=()=>document.getElementById("nd-sidebar");const ensureActiveVisible=()=>{const sidebar=getSidebar();if(!sidebar)return;const active=sidebar.querySelector('a[data-active="true"]');if(!(active instanceof HTMLElement))return;const activeRect=active.getBoundingClientRect();const sidebarRect=sidebar.getBoundingClientRect();if(activeRect.top<sidebarRect.top||activeRect.bottom>sidebarRect.bottom)sidebar.scrollTop+=activeRect.top-sidebarRect.top-(sidebar.clientHeight-activeRect.height)/2};const setSidebarActive=(path)=>{const sidebar=getSidebar();if(!sidebar)return;const current=normalizePath(path);for(const link of Array.from(sidebar.querySelectorAll("a[href]"))){try{link.dataset.active=normalizePath(new URL(link.href,location.href).pathname)===current?"true":"false"}catch{}}ensureActiveVisible()};const initMobileSidebar=()=>{const layout=document.getElementById("nd-docs-layout");const sidebar=getSidebar();const toggle=document.querySelector("[data-sidebar-toggle]");const backdrop=document.querySelector("[data-sidebar-backdrop]");if(!layout||!sidebar||!(toggle instanceof HTMLButtonElement))return;const setOpen=(open)=>{layout.dataset.sidebarOpen=open?"true":"false";document.documentElement.dataset.farmDocsSidebar=open?"open":"closed";toggle.setAttribute("aria-expanded",open?"true":"false");toggle.setAttribute("aria-label",open?"Close menu":"Open menu")};const toggleOpen=()=>setOpen(layout.dataset.sidebarOpen!=="true");closeMobileSidebar=()=>setOpen(false);toggle.addEventListener("click",(event)=>{event.preventDefault();toggleOpen()});backdrop?.addEventListener("click",()=>closeMobileSidebar());document.addEventListener("keydown",(event)=>{if(event.key==="Escape")closeMobileSidebar()});sidebar.addEventListener("click",(event)=>{const target=event.target instanceof Element?event.target.closest("a[href]"):null;if(target)closeMobileSidebar()});closeMobileSidebar()};const initSidebarScroll=()=>{const sidebar=getSidebar();if(!sidebar)return;const key="farmdocs:sidebar-scroll:"+location.origin;const getStorage=()=>{try{return window.sessionStorage}catch{return null}};const readSaved=()=>{try{const raw=getStorage()?.getItem(key);if(!raw)return null;const parsed=JSON.parse(raw);return parsed&&typeof parsed==="object"?parsed:null}catch{return null}};const save=(path=location.pathname)=>{try{getStorage()?.setItem(key,JSON.stringify({path,scrollTop:sidebar.scrollTop}))}catch{}};const saved=readSaved();if(saved?.path===location.pathname&&Number.isFinite(Number(saved.scrollTop)))sidebar.scrollTop=Number(saved.scrollTop);ensureActiveVisible();save();sidebar.addEventListener("scroll",()=>save(),{passive:true});sidebar.addEventListener("click",(event)=>{const target=event.target instanceof Element?event.target.closest("a[href]"):null;if(!target)return;try{save(new URL(target.href,location.href).pathname)}catch{save()}});window.addEventListener("beforeunload",()=>save())};let navigateController=null;const getPageKey=(root)=>{const article=root.getElementById("nd-page");if(!article)return"";return article.querySelector("h1")?.textContent?.trim()||article.textContent?.replace(/\\s+/g," ").trim().slice(0,160)||""};const swapDocsPage=(html,url)=>{const nextDoc=new DOMParser().parseFromString(html,"text/html");const nextArticle=nextDoc.getElementById("nd-page");const currentArticle=document.getElementById("nd-page");if(!nextArticle||!currentArticle)return false;const nextKey=getPageKey(nextDoc);const importedArticle=document.importNode(nextArticle,true);currentArticle.replaceWith(importedArticle);const renderedArticle=document.getElementById("nd-page");if(!renderedArticle||renderedArticle===currentArticle||(nextKey&&getPageKey(document)!==nextKey))return false;const nextToc=nextDoc.getElementById("nd-toc");const currentToc=document.getElementById("nd-toc");if(nextToc&&currentToc)currentToc.replaceWith(document.importNode(nextToc,true));if(nextDoc.title)document.title=nextDoc.title;const nextDescription=nextDoc.querySelector('meta[name="description"]');const currentDescription=document.querySelector('meta[name="description"]');if(nextDescription&&currentDescription)currentDescription.setAttribute("content",nextDescription.getAttribute("content")||"");setSidebarActive(url.pathname);initToc();closeMobileSidebar();return true};const navigateDocs=async(url,{replace=false,scroll=true}={})=>{if(!isDocsPath(url.pathname))return false;if(navigateController)navigateController.abort();const controller=new AbortController();navigateController=controller;document.documentElement.dataset.farmDocsNavigating="true";try{const response=await fetch(url.href,{cache:"no-store",headers:{accept:"text/html","x-farm-docs-navigate":"1"},signal:controller.signal});if(!response.ok||!((response.headers.get("content-type")||"").includes("text/html")))return false;const html=await response.text();if(!swapDocsPage(html,url))return false;if(replace)history.replaceState({farmDocs:true},"",url.href);else history.pushState({farmDocs:true},"",url.href);if(scroll){if(url.hash){let id=url.hash.slice(1);try{id=decodeURIComponent(id)}catch{}document.getElementById(id)?.scrollIntoView({block:"start"})}else window.scrollTo({top:0,left:0})}return true}catch(error){if(error?.name==="AbortError")return true;return false}finally{if(navigateController===controller){delete document.documentElement.dataset.farmDocsNavigating;navigateController=null}}};const initClientNavigation=()=>{document.addEventListener("click",(event)=>{if(event.defaultPrevented||event.button!==0||event.metaKey||event.ctrlKey||event.shiftKey||event.altKey)return;const target=event.target instanceof Element?event.target.closest("a[href]"):null;if(!target||target.target||target.hasAttribute("download"))return;let url;try{url=new URL(target.href,location.href)}catch{return}if(url.origin!==location.origin||!isDocsPath(url.pathname))return;if(normalizePath(url.pathname)===normalizePath(location.pathname)&&url.hash)return;event.preventDefault();navigateDocs(url).then((handled)=>{if(!handled)location.href=url.href})});window.addEventListener("popstate",()=>{navigateDocs(new URL(location.href),{replace:true,scroll:false}).then((handled)=>{if(!handled)location.reload()})})};const init=()=>{initToc();initMobileSidebar();initSidebarScroll();initClientNavigation()};if(document.readyState==="loading")document.addEventListener("DOMContentLoaded",init,{once:true});else init()})();</script>`;
 }
 function renderDocsPageActionsRuntimeScript() {
@@ -7496,13 +7952,13 @@ ${renderDocsHashRuntimeScript()}
 ${renderDocsPageActionsRuntimeScript()}`;
 }
 function readCssWithImports(filePath, seen = /* @__PURE__ */ new Set()) {
-  const resolved = import_node_path11.default.resolve(filePath);
+  const resolved = import_node_path13.default.resolve(filePath);
   if (seen.has(resolved)) return "";
   seen.add(resolved);
-  const source = (0, import_node_fs8.readFileSync)(resolved, "utf8");
+  const source = (0, import_node_fs9.readFileSync)(resolved, "utf8");
   return source.replace(/@import\s+["']([^"']+)["'];?/g, (_match, importPath) => {
     try {
-      const importedPath = importPath.startsWith(".") ? import_node_path11.default.resolve(import_node_path11.default.dirname(resolved), importPath) : (0, import_node_module5.createRequire)(resolved).resolve(importPath);
+      const importedPath = importPath.startsWith(".") ? import_node_path13.default.resolve(import_node_path13.default.dirname(resolved), importPath) : (0, import_node_module5.createRequire)(resolved).resolve(importPath);
       return readCssWithImports(importedPath, seen);
     } catch {
       return "";
@@ -7510,11 +7966,11 @@ function readCssWithImports(filePath, seen = /* @__PURE__ */ new Set()) {
   });
 }
 function resolvePixelBorderThemeCss(options) {
-  const cacheKey = import_node_path11.default.resolve(options.root);
+  const cacheKey = import_node_path13.default.resolve(options.root);
   const cached = themeCssCache.get(cacheKey);
   if (cached !== void 0) return cached;
   try {
-    const requireFromApp = (0, import_node_module5.createRequire)(import_node_path11.default.join(cacheKey, "package.json"));
+    const requireFromApp = (0, import_node_module5.createRequire)(import_node_path13.default.join(cacheKey, "package.json"));
     const themeCssPath = requireFromApp.resolve("@farming-labs/theme/pixel-border/css");
     const requireFromTheme = (0, import_node_module5.createRequire)(themeCssPath);
     const fumadocsCssPath = requireFromTheme.resolve("fumadocs-ui/style.css");
@@ -7527,17 +7983,28 @@ ${readCssWithImports(themeCssPath)}`;
     return "";
   }
 }
-function renderFarmDocsBridgeCss(docs) {
+function renderFarmDocsBridgeCss(docs, fontAssets, layoutFonts) {
   const sidebarWidth = getThemeLayoutValue(docs, "sidebarWidth", 320);
   const contentWidth = getThemeLayoutValue(docs, "contentWidth", 860);
+  const fontFaces = fontAssets.map(
+    ({ family, url }) => `@font-face { font-family: "${family}"; src: url("${url}") format("woff2"); font-style: normal; font-weight: 100 900; font-display: block; }`
+  ).join("\n");
+  const fontVariables = [
+    fontAssets.some(({ family }) => family === "Geist Sans") ? '--font-geist-sans: "Geist Sans", ui-sans-serif, system-ui, sans-serif;' : "",
+    fontAssets.some(({ family }) => family === "Geist Mono") ? '--font-geist-mono: "Geist Mono", ui-monospace, monospace;' : ""
+  ].filter(Boolean).join(" ");
+  const fontCss = fontFaces ? `${fontFaces}
+:root { ${fontVariables} }` : "";
+  const layoutFontVariables = [
+    renderFarmDocsLayoutFontVariable("--fd-layout-font-body", layoutFonts?.body),
+    renderFarmDocsLayoutFontVariable("--fd-layout-font-code", layoutFonts?.code)
+  ].filter(Boolean).join(" ");
   return `
-    @font-face { font-family: "Geist Sans"; src: local("Geist Sans"), url("${GEIST_SANS_FONT_URL}") format("woff2"), url("/node_modules/geist/dist/fonts/geist-sans/Geist-Variable.woff2") format("woff2"); font-display: block; font-style: normal; font-weight: 100 900; }
-    @font-face { font-family: "Geist Mono"; src: local("Geist Mono"), url("${GEIST_MONO_FONT_URL}") format("woff2"), url("/node_modules/geist/dist/fonts/geist-mono/GeistMono-Variable.woff2") format("woff2"); font-display: block; font-style: normal; font-weight: 100 900; }
-    :root { color-scheme: dark; --font-geist-sans: "Geist Sans"; --font-geist-mono: "Geist Mono"; --fd-sidebar-width: ${sidebarWidth}px; --fd-content-width: ${contentWidth}px; --fd-toc-width: 240px; --fd-docs-height: 100vh; --fd-docs-row-1: var(--fd-nav-height, 44px); --fd-docs-font-sans: var(--font-geist-sans, "Geist Sans", var(--font-sans, system-ui, -apple-system, sans-serif)); --fd-docs-font-mono: var(--font-geist-mono, "Geist Mono", var(--font-mono, ui-monospace, monospace)); --fd-font-sans: var(--fd-docs-font-sans); --fd-font-mono: var(--fd-docs-font-mono); --fd-pixel-rail-width: 12px; --fd-sidebar-edge: calc(var(--fd-pixel-rail-width) + 18px); --fd-sidebar-guide-x: calc(var(--fd-sidebar-edge) + 16px); --fd-sidebar-link-x: calc(var(--fd-sidebar-guide-x) + 22px); --fd-sidebar-sub-guide-x: calc(var(--fd-sidebar-link-x) + 7px); --fd-sidebar-sub-link-x: calc(var(--fd-sidebar-sub-guide-x) + 28px); --fd-sidebar-branch-gap: 0px; --fd-sidebar-nested-icon-gap: 0px; --fd-sidebar-line-color: color-mix(in srgb, var(--color-fd-border, hsl(0 0% 15%)) 88%, transparent); }
+    :root { color-scheme: dark; --font-geist-sans: ui-sans-serif, system-ui, sans-serif; --font-geist-mono: ui-monospace, monospace; ${layoutFontVariables} --fd-sidebar-width: ${sidebarWidth}px; --fd-content-width: ${contentWidth}px; --fd-toc-width: 240px; --fd-docs-height: 100vh; --fd-docs-row-1: var(--fd-nav-height, 44px); --fd-docs-font-sans: var(--fd-layout-font-body, var(--font-geist-sans, var(--font-sans, system-ui, -apple-system, sans-serif))); --fd-docs-font-mono: var(--fd-layout-font-code, var(--font-geist-mono, var(--font-mono, ui-monospace, monospace))); --fd-font-sans: var(--fd-docs-font-sans); --fd-font-mono: var(--fd-docs-font-mono); --fd-pixel-rail-width: 12px; --fd-sidebar-edge: calc(var(--fd-pixel-rail-width) + 18px); --fd-sidebar-guide-x: calc(var(--fd-sidebar-edge) + 16px); --fd-sidebar-link-x: calc(var(--fd-sidebar-guide-x) + 22px); --fd-sidebar-sub-guide-x: calc(var(--fd-sidebar-link-x) + 7px); --fd-sidebar-sub-link-x: calc(var(--fd-sidebar-sub-guide-x) + 28px); --fd-sidebar-branch-gap: 0px; --fd-sidebar-nested-icon-gap: 0px; --fd-sidebar-line-color: color-mix(in srgb, var(--color-fd-border, hsl(0 0% 15%)) 88%, transparent); }
     * { box-sizing: border-box; }
     html { background: var(--color-fd-background, hsl(0 0% 2%)); scroll-padding-top: calc(var(--fd-nav-height, 44px) + 24px); }
     html[data-farm-docs-sidebar="open"], html[data-farm-docs-sidebar="open"] body { overflow: hidden; }
-    body { margin: 0; min-height: 100vh; background: var(--color-fd-background, hsl(0 0% 2%)); color: var(--color-fd-foreground, oklch(0.985 0.001 106.423)); font-family: var(--fd-docs-font-sans); text-rendering: optimizeLegibility; }
+    body { margin: 0; min-height: 100vh; background: var(--color-fd-background, hsl(0 0% 2%)); color: var(--color-fd-foreground, oklch(0.985 0.001 106.423)); font-family: var(--fd-docs-font-sans); font-synthesis: none; text-rendering: optimizeLegibility; }
     ::selection { background: var(--color-fd-foreground, #fff); color: var(--color-fd-background, #000); }
     a { color: inherit; }
     #nd-docs-layout { --fd-sidebar-col: var(--fd-sidebar-width); display: grid; grid-template: "sidebar header header" var(--fd-nav-height, 44px) "sidebar main toc" 1fr / var(--fd-sidebar-width) minmax(0, 1fr) var(--fd-toc-width) !important; min-height: 100vh; border-top: 1px solid var(--color-fd-border, hsl(0 0% 15%)); background: var(--color-fd-background, hsl(0 0% 2%)); }
@@ -7717,14 +8184,45 @@ function renderFarmDocsBridgeCss(docs) {
       .sh__line { min-height: 1.6em; }
     }
 ${farmDocsPixelBorderCss}
+${fontCss}
   `;
 }
-function renderPixelDocsHtml(page2, pages, docs, themeCss, clientEntry, faviconHref) {
+function renderFarmDocsLayoutFontVariable(name, font) {
+  const family = font?.style.fontFamily;
+  if (!family || /[;{}<>]/.test(family)) return "";
+  return `${name}: ${family};`;
+}
+function renderFarmDocsFontPreloads(fontAssets) {
+  return fontAssets.map(
+    ({ url }) => `<link rel="preload" href="${escapeAttribute2(url)}" as="font" type="font/woff2" crossorigin>`
+  ).join("\n  ");
+}
+function renderFarmDocsFontPreloadHeader(fontAssets) {
+  return fontAssets.map(({ url }) => `<${url}>; rel=preload; as=font; type=font/woff2; crossorigin`).join(", ");
+}
+function getFarmLayoutFontPreloads(layoutFonts) {
+  const seen = /* @__PURE__ */ new Set();
+  return [layoutFonts?.body, layoutFonts?.code].flatMap(
+    (font) => (font?.preloads || []).filter(({ href }) => {
+      if (seen.has(href)) return false;
+      seen.add(href);
+      return true;
+    })
+  );
+}
+function renderFarmLayoutFontPreloadHeader(layoutFonts) {
+  return getFarmLayoutFontPreloads(layoutFonts).map(({ href, type }) => `<${href}>; rel=preload; as=font; type=${type}; crossorigin`).join(", ");
+}
+function renderPixelDocsHtml(page2, pages, docs, themeCss, clientEntry, faviconHref, requestUrl, fontAssets, layoutFonts, fontStylesheetHref) {
   const navTitle = typeof docs.config.nav === "object" && docs.config.nav && "title" in docs.config.nav ? String(docs.config.nav.title || "Docs") : "Docs";
   const description = page2.description || docs.config.metadata?.description || "";
   const tocItems = extractTocItems(page2.body, getThemeTocDepth(docs));
   const themeName = getThemeName(docs);
   const searchEnabled = isFarmDocsSearchEnabled(docs);
+  const socialMetadata = isFarmDocsSocialImageEnabled(page2, docs) ? renderFarmDocsSocialMetadata(
+    createFarmDocsSocialImageDescriptor(page2, docs, requestUrl),
+    getFarmDocsCustomSocialImage(page2)
+  ) : "";
   return `<!DOCTYPE html>
 <html class="dark" lang="en" data-docs-theme="${escapeAttribute2(themeName)}">
 <head>
@@ -7733,11 +8231,12 @@ function renderPixelDocsHtml(page2, pages, docs, themeCss, clientEntry, faviconH
   <meta name="generator" content="@farming-labs/docs via Farm.js">
   <title>${escapeHtml(page2.title)}</title>
   ${renderFarmDocsFaviconLink(faviconHref)}
-  <link rel="preload" href="${GEIST_SANS_FONT_URL}" as="font" type="font/woff2" crossorigin>
-  <link rel="preload" href="${GEIST_MONO_FONT_URL}" as="font" type="font/woff2" crossorigin>
+  ${renderFarmDocsFontPreloads(fontAssets)}
+  ${fontStylesheetHref ? `<link rel="stylesheet" href="${escapeAttribute2(fontStylesheetHref)}">` : ""}
   ${description ? `<meta name="description" content="${escapeHtml(description)}">` : ""}
+  ${socialMetadata}
   <style>${themeCss}
-${renderFarmDocsBridgeCss(docs)}</style>
+${renderFarmDocsBridgeCss(docs, fontAssets, layoutFonts)}</style>
   ${searchEnabled ? renderDocsSearchBootstrapScript() : ""}
 </head>
 <body>
@@ -7789,9 +8288,34 @@ ${renderMarkdownHtmlWithTitleMeta(page2, docs)}
 }
 function createFarmDocsHandler(docs, options) {
   const faviconHref = resolveFarmDocsFavicon(docs, options);
+  const fontAssets = options.fontAssets ?? toFarmDocsPublicFontAssets(resolveFarmDocsFontAssets(options.root));
+  const fallbackFontPreloadHeader = renderFarmDocsFontPreloadHeader(fontAssets);
   return /* @__PURE__ */ __name(async function handleFarmDocsRequest(request) {
     if (!docs?.enabled || request.method !== "GET" && request.method !== "HEAD") return null;
     const contentDir = resolveFarmDocsContentDir(docs, options);
+    const requestUrl = new URL(request.url);
+    const socialImageSlug = getFarmDocsSocialImageSlug(docs, requestUrl);
+    if (socialImageSlug !== null) {
+      const socialImagePage = loadFarmDocsPage(contentDir, docs, socialImageSlug);
+      if (!socialImagePage || !isFarmDocsSocialImageEnabled(socialImagePage, docs) || getFarmDocsCustomSocialImage(socialImagePage)) {
+        return null;
+      }
+      const descriptor = createFarmDocsSocialImageDescriptor(socialImagePage, docs, requestUrl);
+      if (requestUrl.pathname !== descriptor.imagePath) return null;
+      const etag = `"${descriptor.hash}"`;
+      const immutable = requestUrl.searchParams.get("v") === descriptor.hash;
+      const headers = new Headers({
+        "Content-Type": "image/svg+xml; charset=utf-8",
+        "Cache-Control": immutable ? "public, max-age=31536000, immutable" : "public, max-age=0, must-revalidate",
+        ETag: etag,
+        "X-Content-Type-Options": "nosniff"
+      });
+      if (request.headers.get("if-none-match") === etag) {
+        return new Response(null, { status: 304, headers });
+      }
+      if (request.method === "HEAD") return new Response(null, { status: 200, headers });
+      return new Response(renderFarmDocsSocialImageSvg(descriptor), { status: 200, headers });
+    }
     const publicResponse = createFarmDocsPublicResponse(contentDir, docs, request);
     if (publicResponse) return publicResponse;
     if (!isFarmDocsRequest(docs, request)) return null;
@@ -7814,6 +8338,11 @@ function createFarmDocsHandler(docs, options) {
         }
       );
     }
+    const pathname = new URL(request.url).pathname;
+    const layoutFonts = await options.resolveLayoutFonts?.(pathname);
+    const usesLayoutFonts = Boolean(layoutFonts?.body || layoutFonts?.code);
+    const activeFontAssets = usesLayoutFonts ? [] : fontAssets;
+    const fontPreloadHeader = usesLayoutFonts ? renderFarmLayoutFontPreloadHeader(layoutFonts) : fallbackFontPreloadHeader;
     return new Response(
       renderPixelDocsHtml(
         page2,
@@ -7821,39 +8350,44 @@ function createFarmDocsHandler(docs, options) {
         docs,
         resolvePixelBorderThemeCss(options),
         options.clientEntry || "/farm-client.js",
-        faviconHref
+        faviconHref,
+        requestUrl,
+        activeFontAssets,
+        layoutFonts,
+        usesLayoutFonts ? options.fontStylesheetHref : void 0
       ),
       {
         status: 200,
         headers: {
           "Content-Type": "text/html; charset=utf-8",
-          "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300"
+          "Cache-Control": "public, s-maxage=60, stale-while-revalidate=300",
+          ...fontPreloadHeader ? { Link: fontPreloadHeader } : {}
         }
       }
     );
   }, "handleFarmDocsRequest");
 }
-var import_node_fs8, import_node_module5, import_node_path11, import_docs, import_marked, import_sugar_high, DOCS_FILE_NAMES, DOCS_FILE_EXTENSIONS2, FARM_DOCS_FALLBACK_FAVICON, FARM_DOCS_FAVICON_FILES, GEIST_SANS_FONT_URL, GEIST_MONO_FONT_URL, CODE_LANGUAGE_LABELS, EXTENSIONLESS_CODE_FILENAMES, SIDEBAR_SECTION_ORDER, SIDEBAR_PAGE_ORDER, themeCssCache;
+var import_node_fs9, import_node_module5, import_node_path13, import_docs, import_marked, import_sugar_high, DOCS_FILE_NAMES, DOCS_FILE_EXTENSIONS2, FARM_DOCS_FALLBACK_FAVICON, FARM_DOCS_FAVICON_FILES, CODE_LANGUAGE_LABELS, EXTENSIONLESS_CODE_FILENAMES, SIDEBAR_SECTION_ORDER, SIDEBAR_PAGE_ORDER, themeCssCache;
 var init_handler = __esm({
   "src/docs/handler.ts"() {
     "use strict";
-    import_node_fs8 = require("fs");
+    import_node_fs9 = require("fs");
     import_node_module5 = require("module");
-    import_node_path11 = __toESM(require("path"));
+    import_node_path13 = __toESM(require("path"));
     import_docs = require("@farming-labs/docs");
     import_marked = require("marked");
     import_sugar_high = require("sugar-high");
+    init_fonts();
     init_last_modified();
     init_pixel_border_css();
     init_search_client();
+    init_social_image();
     DOCS_FILE_NAMES = ["page.mdx", "page.md", "index.mdx", "index.md"];
     DOCS_FILE_EXTENSIONS2 = [".mdx", ".md"];
     FARM_DOCS_FALLBACK_FAVICON = "data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32'%3E%3Crect width='32' height='32' fill='black'/%3E%3Cpath d='M7 8h18v3H10v5h12v3H10v5H7z' fill='white'/%3E%3C/svg%3E";
     FARM_DOCS_FAVICON_FILES = ["favicon.svg", "favicon.ico", "favicon.png"];
-    GEIST_SANS_FONT_URL = "/assets/Geist-Variable-CrgPqtmy.woff2";
-    GEIST_MONO_FONT_URL = "/assets/GeistMono-Variable-BNLlm6Cd.woff2";
     __name(trimSlashes2, "trimSlashes");
-    __name(normalizeEntry, "normalizeEntry");
+    __name(normalizeEntry2, "normalizeEntry");
     __name(normalizeSlug, "normalizeSlug");
     __name(resolveFarmDocsFavicon, "resolveFarmDocsFavicon");
     __name(renderFarmDocsFaviconLink, "renderFarmDocsFaviconLink");
@@ -8043,6 +8577,11 @@ var init_handler = __esm({
     __name(readCssWithImports, "readCssWithImports");
     __name(resolvePixelBorderThemeCss, "resolvePixelBorderThemeCss");
     __name(renderFarmDocsBridgeCss, "renderFarmDocsBridgeCss");
+    __name(renderFarmDocsLayoutFontVariable, "renderFarmDocsLayoutFontVariable");
+    __name(renderFarmDocsFontPreloads, "renderFarmDocsFontPreloads");
+    __name(renderFarmDocsFontPreloadHeader, "renderFarmDocsFontPreloadHeader");
+    __name(getFarmLayoutFontPreloads, "getFarmLayoutFontPreloads");
+    __name(renderFarmLayoutFontPreloadHeader, "renderFarmLayoutFontPreloadHeader");
     __name(renderPixelDocsHtml, "renderPixelDocsHtml");
     __name(createFarmDocsHandler, "createFarmDocsHandler");
   }
@@ -8227,18 +8766,18 @@ function sanitizeDocsConfig(config) {
   return cloneSerializable(config) || {};
 }
 async function findDocsConfigPath(rootDir, configPath) {
-  const { existsSync: existsSync15 } = await import("fs");
+  const { existsSync: existsSync16 } = await import("fs");
   const root = import_path9.default.resolve(rootDir || process.cwd());
   if (configPath) {
     const resolvedPath = import_path9.default.isAbsolute(configPath) ? configPath : import_path9.default.join(root, configPath);
-    if (!existsSync15(resolvedPath)) {
+    if (!existsSync16(resolvedPath)) {
       throw new Error(`Could not find docs config at ${configPath}.`);
     }
     return import_path9.default.resolve(resolvedPath);
   }
   for (const filename of DOCS_CONFIG_FILENAMES) {
     const resolvedPath = import_path9.default.join(root, filename);
-    if (existsSync15(resolvedPath)) {
+    if (existsSync16(resolvedPath)) {
       return resolvedPath;
     }
   }
@@ -8374,6 +8913,7 @@ var init_config2 = __esm({
     init_image_config();
     init_config();
     init_auth_config();
+    init_preload();
     init_config_entry();
     __name(getDeployTargetForPreset, "getDeployTargetForPreset");
     DOCS_CONFIG_FILENAMES = [
@@ -9162,8 +9702,8 @@ var init_generator = __esm({
           }
           routeGroups.get(key).push(route);
         }
-        for (const [path24, routeList] of routeGroups) {
-          const openAPIPath = this.convertToOpenAPIPath(path24);
+        for (const [path26, routeList] of routeGroups) {
+          const openAPIPath = this.convertToOpenAPIPath(path26);
           spec.paths[openAPIPath] = {};
           for (const route of routeList) {
             for (const method of route.methods) {
@@ -9177,8 +9717,8 @@ var init_generator = __esm({
       /**
        * Convert Farm.js API path to OpenAPI path format
        */
-      convertToOpenAPIPath(path24) {
-        return path24.replace(/^\/api/, "");
+      convertToOpenAPIPath(path26) {
+        return path26.replace(/^\/api/, "");
       }
       /**
        * Extract request body schema from endpoint
@@ -9340,8 +9880,8 @@ var init_generator = __esm({
       /**
        * Generate operation summary
        */
-      generateSummary(path24, method) {
-        const cleanPath = path24.replace(/^\/api\//, "");
+      generateSummary(path26, method) {
+        const cleanPath = path26.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         const lastPart = pathParts[pathParts.length - 1];
         const action = method === "GET" ? "Get" : method === "POST" ? "Create" : method === "PUT" ? "Update" : method === "DELETE" ? "Delete" : method === "PATCH" ? "Update" : method;
@@ -9350,22 +9890,22 @@ var init_generator = __esm({
       /**
        * Generate operation description
        */
-      generateDescription(path24, method) {
-        const cleanPath = path24.replace(/^\/api\//, "");
+      generateDescription(path26, method) {
+        const cleanPath = path26.replace(/^\/api\//, "");
         return `${method} ${cleanPath} endpoint`;
       }
       /**
        * Generate operation ID
        */
-      generateOperationId(path24, method) {
-        const cleanPath = path24.replace(/^\/api\//, "").replace(/\//g, "_");
+      generateOperationId(path26, method) {
+        const cleanPath = path26.replace(/^\/api\//, "").replace(/\//g, "_");
         return `${method.toLowerCase()}_${cleanPath}`;
       }
       /**
        * Generate tags for grouping operations
        */
-      generateTags(path24) {
-        const cleanPath = path24.replace(/^\/api\//, "");
+      generateTags(path26) {
+        const cleanPath = path26.replace(/^\/api\//, "");
         const pathParts = cleanPath.split("/");
         if (pathParts.length > 1) {
           return [pathParts[0]];
@@ -9378,8 +9918,8 @@ var init_generator = __esm({
       async generateSpecFile(routes, outputPath) {
         const spec = await this.generateSpec(routes);
         const fs8 = require("fs");
-        const path24 = require("path");
-        const dir = path24.dirname(outputPath);
+        const path26 = require("path");
+        const dir = path26.dirname(outputPath);
         if (!fs8.existsSync(dir)) {
           fs8.mkdirSync(dir, { recursive: true });
         }
@@ -9799,7 +10339,7 @@ async function createFarmDevtoolsSnapshot(input) {
     generatedAt: (input.now?.() || /* @__PURE__ */ new Date()).toISOString(),
     health: resolveHealth(diagnostics),
     project: {
-      name: import_node_path12.default.basename(import_node_path12.default.resolve(input.root)),
+      name: import_node_path14.default.basename(import_node_path14.default.resolve(input.root)),
       root: input.root,
       srcDir: input.srcDir,
       basePath: config.basePath || "/",
@@ -9848,11 +10388,11 @@ async function createFarmDevtoolsSnapshot(input) {
     diagnostics
   };
 }
-var import_node_path12;
+var import_node_path14;
 var init_devtools = __esm({
   "src/devtools.ts"() {
     "use strict";
-    import_node_path12 = __toESM(require("path"));
+    import_node_path14 = __toESM(require("path"));
     init_config2();
     init_cron();
     init_route_runtime();
@@ -11810,6 +12350,22 @@ var import_promises3 = require("fs/promises");
 var OPTIONAL_CATCH_ALL_SEGMENT = /^\[\[\.\.\.([^\]]+)\]\]$/;
 var REQUIRED_CATCH_ALL_SEGMENT = /^\[\.\.\.([^\]]+)\]$/;
 var REQUIRED_DYNAMIC_SEGMENT = /^\[([^\]]+)\]$/;
+var REQUEST_API_LABELS = /* @__PURE__ */ new Map([
+  ["cookies", "request cookies"],
+  ["headers", "request headers"],
+  ["getCurrentRequest", "the current Request"],
+  ["useSearchParams", "URL search parameters"],
+  ["auth", "request authentication"],
+  ["getServerSession", "request authentication"],
+  ["getSession", "request authentication"],
+  ["currentUser", "request authentication"]
+]);
+var ROUTE_PROP_LABELS = /* @__PURE__ */ new Map([
+  ["searchParams", "URL search parameters"],
+  ["middleware", "middleware request data"],
+  ["middlewareData", "middleware request data"],
+  ["context", "request context"]
+]);
 function resolveRouteRenderingConfig(mod, source) {
   const directiveConfig = parseRouteRenderingDirective(source);
   let ssg = directiveConfig?.ssg ?? false;
@@ -11862,6 +12418,221 @@ async function resolveRouteRenderingConfigFromFile(mod, filePath) {
   return resolveRouteRenderingConfig(mod, source);
 }
 __name(resolveRouteRenderingConfigFromFile, "resolveRouteRenderingConfigFromFile");
+function analyzeStaticRouteCandidate(mod, source, options = {}) {
+  const blockers = [];
+  if (!source) {
+    blockers.push("route source is unavailable");
+  }
+  if (options.isDynamic) {
+    blockers.push("the route has dynamic path segments");
+  }
+  if (hasExplicitRenderingConfig(mod, source)) {
+    blockers.push("the route already has explicit rendering config");
+  }
+  if (source) {
+    blockers.push(...findRequestBoundSourceBlockers(source));
+  }
+  return {
+    candidate: blockers.length === 0,
+    blockers
+  };
+}
+__name(analyzeStaticRouteCandidate, "analyzeStaticRouteCandidate");
+function findRequestBoundSourceBlockers(source) {
+  const blockers = /* @__PURE__ */ new Set();
+  const code = stripCommentsAndLiteralContents(source);
+  const sourceWithoutComments = stripComments(source);
+  for (const binding of readRequestApiImportBindings(sourceWithoutComments)) {
+    if (new RegExp(`\\b${escapeRegExp2(binding.local)}\\s*(?:\\?\\.\\s*)?\\(`).test(code)) {
+      blockers.add(`the route reads ${binding.label}`);
+    }
+  }
+  for (const namespace of readNamespaceImportBindings(sourceWithoutComments)) {
+    for (const [name, label] of REQUEST_API_LABELS) {
+      if (new RegExp(
+        `\\b${escapeRegExp2(namespace)}\\s*(?:\\?\\.\\s*|\\.\\s*)${name}\\s*(?:\\?\\.\\s*)?\\(`
+      ).test(code)) {
+        blockers.add(`the route reads ${label}`);
+      }
+    }
+  }
+  const params = readDefaultRouteParameters(code);
+  if (params) {
+    for (const [name, label] of ROUTE_PROP_LABELS) {
+      if (new RegExp(`\\b${name}\\b`).test(params)) {
+        blockers.add(`the route reads ${label}`);
+      }
+    }
+    const propsName = params.match(/^\s*([A-Za-z_$][\w$]*)\s*(?::|,|$)/)?.[1];
+    if (propsName) {
+      for (const [name, label] of ROUTE_PROP_LABELS) {
+        if (new RegExp(`\\b${escapeRegExp2(propsName)}\\s*\\.\\s*${name}\\b`).test(code)) {
+          blockers.add(`the route reads ${label}`);
+        }
+        if (new RegExp(`\\{[^}]*\\b${name}\\b[^}]*\\}\\s*=\\s*${escapeRegExp2(propsName)}\\b`).test(
+          code
+        )) {
+          blockers.add(`the route reads ${label}`);
+        }
+      }
+    }
+  }
+  return [...blockers];
+}
+__name(findRequestBoundSourceBlockers, "findRequestBoundSourceBlockers");
+function readRequestApiImportBindings(source) {
+  const bindings = [];
+  for (const clause of readStaticImportClauses(source)) {
+    const namedGroup = clause.match(/\{([\s\S]*?)\}/)?.[1];
+    for (const rawSpecifier of (namedGroup ?? "").split(",")) {
+      const specifier = rawSpecifier.trim().replace(/^type\s+/, "");
+      const imported = specifier.match(/^([A-Za-z_$][\w$]*)(?:\s+as\s+([A-Za-z_$][\w$]*))?$/);
+      if (!imported?.[1]) continue;
+      const label = REQUEST_API_LABELS.get(imported[1]);
+      if (label) bindings.push({ local: imported[2] ?? imported[1], label });
+    }
+    const local = clause.match(/^\s*([A-Za-z_$][\w$]*)\s*(?:,|$)/)?.[1];
+    if (local) {
+      const label = REQUEST_API_LABELS.get(local);
+      if (label) bindings.push({ local, label });
+    }
+  }
+  return bindings;
+}
+__name(readRequestApiImportBindings, "readRequestApiImportBindings");
+function readNamespaceImportBindings(source) {
+  return readStaticImportClauses(source).map((clause) => clause.match(/\*\s*as\s*([A-Za-z_$][\w$]*)/)?.[1]).filter((binding) => Boolean(binding));
+}
+__name(readNamespaceImportBindings, "readNamespaceImportBindings");
+function readStaticImportClauses(source) {
+  return [...source.matchAll(/\bimport\s+(?!\()([\s\S]*?)\s+from\s*["'][^"']+["']/g)].map((match) => match[1]).filter((clause) => Boolean(clause));
+}
+__name(readStaticImportClauses, "readStaticImportClauses");
+function readDefaultRouteParameters(code) {
+  const inlineParams = code.match(/\bexport\s+default\s+(?:async\s+)?function\b[^(]*\(([^)]*)\)/)?.[1] ?? code.match(/\bexport\s+default\s+(?:async\s+)?\(([^)]*)\)\s*=>/)?.[1];
+  if (inlineParams !== void 0) return inlineParams;
+  const binding = code.match(/\bexport\s+default\s+([A-Za-z_$][\w$]*)\s*;?/)?.[1] ?? code.match(/\bexport\s*\{\s*([A-Za-z_$][\w$]*)\s+as\s+default\s*\}/)?.[1];
+  if (!binding) return void 0;
+  const escapedBinding = escapeRegExp2(binding);
+  return code.match(new RegExp(`\\bfunction\\s+${escapedBinding}\\s*\\(([^)]*)\\)`))?.[1] ?? code.match(
+    new RegExp(
+      `\\b(?:const|let|var)\\s+${escapedBinding}\\s*=\\s*(?:async\\s+)?\\(([^)]*)\\)\\s*=>`
+    )
+  )?.[1] ?? code.match(
+    new RegExp(`\\b(?:const|let|var)\\s+${escapedBinding}\\s*=\\s*function\\s*\\(([^)]*)\\)`)
+  )?.[1];
+}
+__name(readDefaultRouteParameters, "readDefaultRouteParameters");
+function stripCommentsAndLiteralContents(source) {
+  return sanitizeSource(source, true);
+}
+__name(stripCommentsAndLiteralContents, "stripCommentsAndLiteralContents");
+function stripComments(source) {
+  return sanitizeSource(source, false);
+}
+__name(stripComments, "stripComments");
+function sanitizeSource(source, maskLiterals) {
+  const output = [...source];
+  const mask = /* @__PURE__ */ __name((index) => {
+    if (output[index] !== "\n" && output[index] !== "\r") output[index] = " ";
+  }, "mask");
+  const scanQuoted = /* @__PURE__ */ __name((start, quote) => {
+    let index = start;
+    if (maskLiterals) mask(index);
+    index += 1;
+    while (index < source.length) {
+      if (source[index] === "\\") {
+        if (maskLiterals) mask(index);
+        if (index + 1 < source.length && maskLiterals) mask(index + 1);
+        index += 2;
+        continue;
+      }
+      const character = source[index];
+      if (maskLiterals) mask(index);
+      index += 1;
+      if (character === quote) break;
+    }
+    return index;
+  }, "scanQuoted");
+  const scanCode = /* @__PURE__ */ __name((start, stopAtTemplateBrace) => {
+    let index = start;
+    let braceDepth = 0;
+    while (index < source.length) {
+      const character = source[index];
+      const next = source[index + 1];
+      if (character === "/" && next === "/") {
+        while (index < source.length && source[index] !== "\n" && source[index] !== "\r") {
+          mask(index++);
+        }
+        continue;
+      }
+      if (character === "/" && next === "*") {
+        mask(index++);
+        mask(index++);
+        while (index < source.length) {
+          const closesComment = source[index] === "*" && source[index + 1] === "/";
+          mask(index++);
+          if (closesComment) {
+            mask(index++);
+            break;
+          }
+        }
+        continue;
+      }
+      if (character === "'" || character === '"') {
+        index = scanQuoted(index, character);
+        continue;
+      }
+      if (character === "`") {
+        if (maskLiterals) mask(index);
+        index += 1;
+        while (index < source.length) {
+          if (source[index] === "\\") {
+            if (maskLiterals) mask(index);
+            if (index + 1 < source.length && maskLiterals) mask(index + 1);
+            index += 2;
+          } else if (source[index] === "`") {
+            if (maskLiterals) mask(index);
+            index += 1;
+            break;
+          } else if (source[index] === "$" && source[index + 1] === "{") {
+            if (maskLiterals) {
+              mask(index);
+              mask(index + 1);
+            }
+            index = scanCode(index + 2, true);
+          } else {
+            if (maskLiterals) mask(index);
+            index += 1;
+          }
+        }
+        continue;
+      }
+      if (character === "{") {
+        braceDepth += 1;
+      } else if (character === "}") {
+        if (stopAtTemplateBrace && braceDepth === 0) {
+          if (maskLiterals) mask(index);
+          return index + 1;
+        }
+        braceDepth = Math.max(0, braceDepth - 1);
+      }
+      index += 1;
+    }
+    return index;
+  }, "scanCode");
+  scanCode(0, false);
+  return output.join("");
+}
+__name(sanitizeSource, "sanitizeSource");
+function escapeRegExp2(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+__name(escapeRegExp2, "escapeRegExp");
+function hasExplicitRenderingConfig(mod, source) {
+  return typeof mod?.ssg === "boolean" || typeof mod?.ppr === "boolean" || typeof mod?.experimental_ppr === "boolean" || typeof mod?.revalidate !== "undefined" || typeof mod?.dynamic !== "undefined" || typeof parseRouteRenderingDirective(source) !== "undefined";
+}
+__name(hasExplicitRenderingConfig, "hasExplicitRenderingConfig");
 function parseRouteRenderingDirective(source) {
   if (!source) {
     return void 0;
@@ -11993,9 +12764,10 @@ function skipHorizontalWhitespace(source, start) {
   return index;
 }
 __name(skipHorizontalWhitespace, "skipHorizontalWhitespace");
-async function collectSSGPages(routes, loadModule2) {
+async function collectSSGPages(routes, loadModule2, options = {}) {
   const ssgPages = [];
   const ssrRoutes = [];
+  const staticCandidateRoutes = [];
   for (const route of routes) {
     try {
       const mod = await loadModule2(route.filePath);
@@ -12003,7 +12775,8 @@ async function collectSSGPages(routes, loadModule2) {
         ssrRoutes.push(route.path);
         continue;
       }
-      const rendering = await resolveRouteRenderingConfigFromFile(mod, route.filePath);
+      const source = await (0, import_promises3.readFile)(route.filePath, "utf8").catch(() => void 0);
+      const rendering = resolveRouteRenderingConfig(mod, source);
       if (rendering.ssg) {
         if (route.isDynamic) {
           const getStaticPaths = mod.getStaticPaths || mod.generateStaticParams;
@@ -12030,12 +12803,26 @@ async function collectSSGPages(routes, loadModule2) {
         }
       } else {
         ssrRoutes.push(route.path);
+        if (options.suggestStaticRendering !== false && analyzeStaticRouteCandidate(mod, source, { isDynamic: route.isDynamic }).candidate) {
+          staticCandidateRoutes.push(route.path);
+        }
       }
     } catch (error) {
       console.error(`Error processing route ${route.path}:`, error);
       ssrRoutes.push(route.path);
     }
   }
+  if (staticCandidateRoutes.length > 0) {
+    const visibleRoutes = staticCandidateRoutes.slice(0, 10);
+    const remainingCount = staticCandidateRoutes.length - visibleRoutes.length;
+    const remainingSuffix = remainingCount > 0 ? `
+  \u2026and ${remainingCount} more` : "";
+    console.warn(
+      `[Farm.js] ${staticCandidateRoutes.length} route${staticCandidateRoutes.length === 1 ? " appears" : "s appear"} eligible for static rendering:
+  ${visibleRoutes.join("\n  ")}${remainingSuffix}
+Add \`export const dynamic = "force-static";\` after verifying that imported code does not read cookies, headers, authentication, or other request data.`
+    );
+  }
   return { ssg: ssgPages, ssr: ssrRoutes };
 }
 __name(collectSSGPages, "collectSSGPages");
@@ -12798,25 +13585,25 @@ function defineRoutes(input) {
 }
 __name(defineRoutes, "defineRoutes");
 var routesBuilder = {
-  page(path24, options) {
+  page(path26, options) {
     return normalizeProgrammaticRoute({
       kind: "page",
-      path: path24,
+      path: path26,
       ...options
     });
   },
-  layout(path24, options) {
+  layout(path26, options) {
     return normalizeProgrammaticRoute({
       kind: "layout",
-      path: path24,
+      path: path26,
       ...options
     });
   },
-  api(path24, options) {
+  api(path26, options) {
     const { render, runtime, regions, maxDuration, ...methods } = options;
     return normalizeProgrammaticRoute({
       kind: "api",
-      path: path24,
+      path: path26,
       render,
       runtime,
       regions,
@@ -12852,7 +13639,7 @@ function getProgrammaticRouteSearchClientOptions(search) {
   return Object.keys(options).length > 0 ? options : void 0;
 }
 __name(getProgrammaticRouteSearchClientOptions, "getProgrammaticRouteSearchClientOptions");
-function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path24, routePath) {
+function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path26, routePath) {
   const schema = getProgrammaticRouteSearchSchema(searchConfig);
   const search = parseProgrammaticSchema(schema, rawSearch, "search", routePath);
   const options = getProgrammaticRouteSearchOptions(searchConfig);
@@ -12861,7 +13648,7 @@ function resolveProgrammaticRouteSearch(searchConfig, rawSearch, path24, routePa
     schema,
     rawSearch,
     parsedSearch: search,
-    path: path24
+    path: path26
   });
   return { search, canonicalPath };
 }
@@ -13044,7 +13831,7 @@ function createRouteModuleFromProgrammaticPage(route) {
     mod.__farmRouteData = route.data;
     mod.__farmRouteParsesProps = true;
     mod.__farmResolveRouteProps = (props) => resolveProgrammaticRouteProps(route, props);
-    mod.__farmResolveRouteCanonicalPath = (rawSearch, path24) => resolveProgrammaticRouteSearch(route.search, rawSearch, path24, route.path).canonicalPath;
+    mod.__farmResolveRouteCanonicalPath = (rawSearch, path26) => resolveProgrammaticRouteSearch(route.search, rawSearch, path26, route.path).canonicalPath;
   }
   if (route.pending || route.error || route.notFound) {
     mod.__farmRouteComponents = {
@@ -13520,6 +14307,15 @@ var import_path5 = __toESM(require("path"));
 var import_fs2 = __toESM(require("fs"));
 var import_path4 = __toESM(require("path"));
 var import_url2 = require("url");
+
+// src/island.ts
+var FARM_ISLAND_STRATEGIES = ["load", "interaction", "visible", "idle"];
+function isFarmIslandStrategy(value) {
+  return FARM_ISLAND_STRATEGIES.includes(value);
+}
+__name(isFarmIslandStrategy, "isFarmIslandStrategy");
+
+// src/utils/client-component.ts
 function readIfExists(filePath) {
   try {
     if (!filePath || !import_fs2.default.existsSync(filePath)) {
@@ -13590,56 +14386,186 @@ function hasHydrateExport(content) {
   return /\bexport\s+const\s+hydrate\s*=\s*true\b/.test(content) || /\bexport\s*\{\s*hydrate\s*\}\b/.test(content);
 }
 __name(hasHydrateExport, "hasHydrateExport");
+function tokenizeModuleSource(content) {
+  const tokens = [];
+  let index = 0;
+  let line = 1;
+  while (index < content.length) {
+    const character = content[index];
+    if (/\s/.test(character)) {
+      if (character === "\n") line++;
+      index++;
+      continue;
+    }
+    if (character === "/" && content[index + 1] === "/") {
+      index += 2;
+      while (index < content.length && content[index] !== "\n") index++;
+      continue;
+    }
+    if (character === "/" && content[index + 1] === "*") {
+      index += 2;
+      while (index < content.length) {
+        if (content[index] === "\n") line++;
+        if (content[index] === "*" && content[index + 1] === "/") {
+          index += 2;
+          break;
+        }
+        index++;
+      }
+      continue;
+    }
+    if (character === '"' || character === "'") {
+      const quote = character;
+      const tokenLine = line;
+      let value = "";
+      index++;
+      while (index < content.length) {
+        const next = content[index];
+        if (next === "\\") {
+          value += next;
+          if (index + 1 < content.length) value += content[index + 1];
+          index += 2;
+          continue;
+        }
+        if (next === quote) {
+          index++;
+          break;
+        }
+        if (next === "\n") line++;
+        value += next;
+        index++;
+      }
+      tokens.push({ kind: "string", value, line: tokenLine });
+      continue;
+    }
+    if (character === "`") {
+      index++;
+      while (index < content.length) {
+        const next = content[index];
+        if (next === "\\") {
+          index += 2;
+          continue;
+        }
+        if (next === "`") {
+          index++;
+          break;
+        }
+        if (next === "\n") line++;
+        index++;
+      }
+      continue;
+    }
+    if (/[A-Za-z_$]/.test(character)) {
+      const start = index++;
+      while (index < content.length && /[\w$]/.test(content[index])) index++;
+      tokens.push({ kind: "identifier", value: content.slice(start, index), line });
+      continue;
+    }
+    tokens.push({ kind: "punctuation", value: character, line });
+    index++;
+  }
+  return tokens;
+}
+__name(tokenizeModuleSource, "tokenizeModuleSource");
+function isIslandExportStart(tokens, index) {
+  const token = tokens[index];
+  const previous = tokens[index - 1];
+  const startsStatement = !previous || previous.value === ";" || previous.value === "{" || previous.value === "}" || token.line > previous.line;
+  return startsStatement && token.value === "export" && tokens[index + 1]?.value === "const" && tokens[index + 2]?.value === "island";
+}
+__name(isIslandExportStart, "isIslandExportStart");
+function getIslandStrategyExport(content) {
+  if (!content) return null;
+  const tokens = tokenizeModuleSource(content);
+  for (let index = 0; index < tokens.length - 2; index++) {
+    if (!isIslandExportStart(tokens, index)) continue;
+    let valueIndex = index + 3;
+    if (tokens[valueIndex]?.value === ":") {
+      while (valueIndex < tokens.length && tokens[valueIndex].value !== "=") valueIndex++;
+    }
+    if (tokens[valueIndex]?.value !== "=") break;
+    valueIndex++;
+    const literal = tokens[valueIndex];
+    if (!literal || literal.kind !== "string" || !isFarmIslandStrategy(literal.value)) break;
+    let trailingIndex = valueIndex + 1;
+    if (tokens[trailingIndex]?.value === "as" && tokens[trailingIndex + 1]?.value === "const") {
+      trailingIndex += 2;
+    }
+    const trailing = tokens[trailingIndex];
+    if (trailing && trailing.value !== ";" && trailing.line === literal.line) break;
+    return literal.value;
+  }
+  if (tokens.some((_token, index) => isIslandExportStart(tokens, index))) {
+    throw new Error(
+      'Farm island configuration must be a static "load", "interaction", "visible", or "idle" string literal.'
+    );
+  }
+  return null;
+}
+__name(getIslandStrategyExport, "getIslandStrategyExport");
 function stripUseClientDirective(content) {
   return content.replace(/^\s*(["'])use client\1\s*;?\s*/, "");
 }
 __name(stripUseClientDirective, "stripUseClientDirective");
-function parseClientModuleMetadata(content) {
+function parseClientModuleMetadata(content, inspectIslandExport) {
   if (!content) {
     return {
       isClientComponent: false,
-      hasHydrateExport: false
+      hasHydrateExport: false,
+      islandStrategy: null
     };
   }
+  const isClientComponent = hasUseClientDirective(content);
+  const hasHydrate = hasHydrateExport(content);
   return {
-    isClientComponent: hasUseClientDirective(content),
-    hasHydrateExport: hasHydrateExport(content)
+    isClientComponent,
+    hasHydrateExport: hasHydrate,
+    islandStrategy: inspectIslandExport || isClientComponent || hasHydrate ? getIslandStrategyExport(content) : null
   };
 }
 __name(parseClientModuleMetadata, "parseClientModuleMetadata");
 function getClientModuleMetadata(modulePath, root) {
   const resolvedPath = resolveModuleSourcePath(modulePath, root);
-  return inspectClientModuleMetadata(resolvedPath, root, /* @__PURE__ */ new Set());
+  return inspectClientModuleMetadata(resolvedPath, root, /* @__PURE__ */ new Set(), true);
 }
 __name(getClientModuleMetadata, "getClientModuleMetadata");
-function inspectClientModuleMetadata(resolvedPath, root, visited) {
+function inspectClientModuleMetadata(resolvedPath, root, visited, inspectIslandExport) {
   if (!resolvedPath || visited.has(resolvedPath)) {
     return {
       isClientComponent: false,
-      shouldHydrate: false
+      shouldHydrate: false,
+      islandStrategy: null
     };
   }
   visited.add(resolvedPath);
   const content = readIfExists(resolvedPath);
-  const parsed = parseClientModuleMetadata(content);
+  const parsed = parseClientModuleMetadata(content, inspectIslandExport);
   if (parsed.isClientComponent) {
     return {
       isClientComponent: true,
-      shouldHydrate: true
+      shouldHydrate: true,
+      islandStrategy: parsed.islandStrategy ?? "load"
     };
   }
   let importsClientBoundary = false;
+  let importedIslandStrategy = null;
   for (const specifier of getRelativeImportSpecifiers(content)) {
     const importedPath = resolveImportedModuleSourcePath(resolvedPath, specifier, root);
-    const importedMetadata = inspectClientModuleMetadata(importedPath, root, visited);
+    const importedMetadata = inspectClientModuleMetadata(importedPath, root, visited, false);
     if (importedMetadata.isClientComponent || importedMetadata.shouldHydrate) {
       importsClientBoundary = true;
-      break;
+      if (importedIslandStrategy === null) {
+        importedIslandStrategy = importedMetadata.islandStrategy;
+      } else if (importedIslandStrategy !== importedMetadata.islandStrategy) {
+        importedIslandStrategy = "load";
+      }
     }
   }
+  const shouldHydrate = parsed.hasHydrateExport || importsClientBoundary;
   return {
     isClientComponent: false,
-    shouldHydrate: parsed.hasHydrateExport || importsClientBoundary
+    shouldHydrate,
+    islandStrategy: shouldHydrate ? parsed.islandStrategy ?? importedIslandStrategy ?? "load" : null
   };
 }
 __name(inspectClientModuleMetadata, "inspectClientModuleMetadata");
@@ -13895,6 +14821,10 @@ function parseInterceptionMarker(segment) {
 __name(parseInterceptionMarker, "parseInterceptionMarker");
 
 // src/routing/route-manager.ts
+function shouldSuggestStaticRenderingForI18n(i18n) {
+  return !i18n || i18n.routing === "prefix-always" || i18n.routing === "prefix-except-default" && i18n.detection.every((signal) => signal === "url");
+}
+__name(shouldSuggestStaticRenderingForI18n, "shouldSuggestStaticRenderingForI18n");
 function routeSpecificity(entry) {
   return entry.route.segments.reduce((score, segment) => {
     if (!segment.isDynamic) return score + 100;
@@ -14138,6 +15068,7 @@ var _RouteManager = class _RouteManager {
         modulePath: toUrlPath(entry.modulePath),
         shouldHydrate: metadata.shouldHydrate,
         isClientComponent: metadata.isClientComponent,
+        islandStrategy: metadata.islandStrategy,
         search: getProgrammaticRouteSearchClientOptions(programmaticPage?.search),
         segments: entry.route.segments.map((seg) => ({
           segment: seg.segment,
@@ -14600,8 +15531,10 @@ var _RouteManager = class _RouteManager {
       isDynamic: entry.route.segments.some((seg) => seg.isDynamic),
       pattern: entry.pattern
     }));
-    const result = await collectSSGPages(routes, (filePath) => this.loadRouteModule(filePath));
     const i18n = this.getI18nConfig();
+    const result = await collectSSGPages(routes, (filePath) => this.loadRouteModule(filePath), {
+      suggestStaticRendering: shouldSuggestStaticRenderingForI18n(i18n)
+    });
     if (!i18n) {
       return result;
     }
@@ -14732,8 +15665,8 @@ async function safeGlobFiles(pattern, cwd) {
 __name(safeGlobFiles, "safeGlobFiles");
 
 // src/server/renderer.ts
-var import_react4 = __toESM(require("react"));
-var import_server = require("react-dom/server");
+var import_react5 = __toESM(require("react"));
+var import_server2 = require("react-dom/server");
 var fs2 = __toESM(require("fs"));
 var path9 = __toESM(require("path"));
 var import_stream = require("stream");
@@ -16192,6 +17125,10 @@ ${FONT_SECTION_END}
       fallback,
       display,
       preload: raw.preload !== false,
+      preloadResources: raw.preload === false ? [] : normalizedSources.map(({ resource }) => ({
+        href: resourceUrl(resource, production, this.basePath),
+        type: fontContentType(resource.extension)
+      })),
       weight: defaultWeight,
       style: raw.style === void 0 ? void 0 : defaultStyle,
       sources: normalizedSources
@@ -16288,7 +17225,7 @@ ${FONT_SECTION_END}
     const normalizedExtension = extension.toLowerCase();
     const hash = (0, import_node_crypto2.createHash)("sha256").update(bytes).digest("hex").slice(0, 12);
     const baseName = sanitizeFileName(import_node_path4.default.basename(fileName, extension)) || "font";
-    const outputFileName = `assets/fonts/${baseName}-${hash}${normalizedExtension}`;
+    const outputFileName = `assets/fonts/${baseName}-h${hash}${normalizedExtension}`;
     const key = `${hash}${normalizedExtension}`;
     const existing = this.resources.get(key);
     if (existing) return existing;
@@ -16558,7 +17495,8 @@ function serializeFontResult(font) {
       fontFamily: stack,
       ...font.style ? { fontStyle: font.style } : {},
       ...font.weight !== void 0 && !String(font.weight).includes(" ") ? { fontWeight: font.weight } : {}
-    }
+    },
+    preloads: font.preloadResources
   });
 }
 __name(serializeFontResult, "serializeFontResult");
@@ -16901,6 +17839,166 @@ function fontError(id, message) {
 }
 __name(fontError, "fontError");
 
+// src/metadata-image.ts
+var import_react4 = __toESM(require("react"));
+var import_server = require("react-dom/server");
+var REACT_FORWARD_REF_TYPE = /* @__PURE__ */ Symbol.for("react.forward_ref");
+var REACT_MEMO_TYPE = /* @__PURE__ */ Symbol.for("react.memo");
+var REACT_LAZY_TYPE = /* @__PURE__ */ Symbol.for("react.lazy");
+function isResponse(value) {
+  return typeof Response !== "undefined" && (value instanceof Response || Boolean(
+    value && typeof value === "object" && typeof value.arrayBuffer === "function" && value.headers
+  ));
+}
+__name(isResponse, "isResponse");
+function isThenable(value) {
+  return Boolean(
+    value && (typeof value === "object" || typeof value === "function") && typeof value.then === "function"
+  );
+}
+__name(isThenable, "isThenable");
+async function prepareMetadataImageNode(node) {
+  if (isThenable(node)) {
+    return prepareMetadataImageNode(await node);
+  }
+  if (Array.isArray(node)) {
+    return Promise.all(node.map((child) => prepareMetadataImageNode(child)));
+  }
+  if (!import_react4.default.isValidElement(node)) {
+    return node;
+  }
+  const element = node;
+  const type = element.type;
+  const props = element.props || {};
+  if (typeof type === "function") {
+    if (type.prototype?.isReactComponent) {
+      throw new Error(
+        "Metadata image components must be stateless function components; React class components are not supported."
+      );
+    }
+    return prepareMetadataImageNode(await type(props));
+  }
+  if (type && typeof type === "object") {
+    if (type.$$typeof === REACT_MEMO_TYPE) {
+      return prepareMetadataImageNode(import_react4.default.createElement(type.type, props));
+    }
+    if (type.$$typeof === REACT_FORWARD_REF_TYPE) {
+      return prepareMetadataImageNode(await type.render(props, null));
+    }
+    if (type.$$typeof === REACT_LAZY_TYPE) {
+      return prepareMetadataImageNode(import_react4.default.createElement(type._init(type._payload), props));
+    }
+  }
+  const preparedChildren = await prepareMetadataImageNode(props.children);
+  const preparedProps = { ...props };
+  if (typeof preparedProps.className === "string") {
+    preparedProps.tw = [preparedProps.tw, preparedProps.className].filter(Boolean).join(" ");
+    delete preparedProps.className;
+  }
+  delete preparedProps.children;
+  return import_react4.default.createElement(type, {
+    ...preparedProps,
+    key: element.key,
+    children: preparedChildren
+  });
+}
+__name(prepareMetadataImageNode, "prepareMetadataImageNode");
+async function normalizeFonts(fonts) {
+  if (!fonts?.length) return void 0;
+  return Promise.all(
+    fonts.map(async (font) => {
+      const data = await font.data;
+      const arrayBuffer = ArrayBuffer.isView(data) ? toArrayBuffer(data) : data;
+      return { ...font, data: arrayBuffer };
+    })
+  );
+}
+__name(normalizeFonts, "normalizeFonts");
+function resolveCacheControl(revalidate) {
+  if (revalidate === false) {
+    return "public, max-age=31536000, immutable";
+  }
+  if (typeof revalidate === "number" && Number.isFinite(revalidate) && revalidate > 0) {
+    return `public, s-maxage=${Math.floor(revalidate)}, stale-while-revalidate=300`;
+  }
+  return "public, max-age=0, must-revalidate";
+}
+__name(resolveCacheControl, "resolveCacheControl");
+function toArrayBuffer(value) {
+  if (value instanceof ArrayBuffer) return value;
+  const bytes = new Uint8Array(value.byteLength);
+  bytes.set(new Uint8Array(value.buffer, value.byteOffset, value.byteLength));
+  return bytes.buffer;
+}
+__name(toArrayBuffer, "toArrayBuffer");
+async function createEntityTag(body) {
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", body);
+  const hash = Array.from(new Uint8Array(digest), (byte) => byte.toString(16).padStart(2, "0")).join("").slice(0, 32);
+  return `"${hash}"`;
+}
+__name(createEntityTag, "createEntityTag");
+async function finalizeMetadataImageResponse(body, headers, options) {
+  const responseHeaders = new Headers(headers);
+  const etag = await createEntityTag(body);
+  responseHeaders.set("ETag", etag);
+  responseHeaders.set("Content-Length", String(body.byteLength));
+  responseHeaders.set("X-Content-Type-Options", "nosniff");
+  const matchesEntityTag = options.ifNoneMatch?.trim() === "*" || options.ifNoneMatch?.split(",").some((candidate) => candidate.trim().replace(/^W\//, "") === etag);
+  if (matchesEntityTag) {
+    return new Response(null, { status: 304, headers: responseHeaders });
+  }
+  return new Response(options.method?.toUpperCase() === "HEAD" ? null : body, {
+    status: 200,
+    headers: responseHeaders
+  });
+}
+__name(finalizeMetadataImageResponse, "finalizeMetadataImageResponse");
+async function createFarmMetadataImageResponse(value, imageModule, options = {}) {
+  const method = (options.method || "GET").toUpperCase();
+  if (method !== "GET" && method !== "HEAD") {
+    return new Response(null, { status: 405, headers: { Allow: "GET, HEAD" } });
+  }
+  if (isResponse(value)) {
+    return method === "HEAD" ? new Response(null, { status: value.status, headers: value.headers }) : value;
+  }
+  const cacheControl = resolveCacheControl(imageModule.revalidate);
+  const explicitContentType = imageModule.contentType?.split(";", 1)[0]?.trim().toLowerCase();
+  if (import_react4.default.isValidElement(value) && explicitContentType !== "image/svg+xml") {
+    const { ImageResponse } = await import("@vercel/og");
+    const element = await prepareMetadataImageNode(value);
+    const response = new ImageResponse(element, {
+      width: imageModule.size?.width || 1200,
+      height: imageModule.size?.height || 630,
+      fonts: await normalizeFonts(imageModule.fonts),
+      emoji: imageModule.emoji,
+      debug: imageModule.debug,
+      headers: { "cache-control": cacheControl }
+    });
+    const headers = new Headers(response.headers);
+    headers.set("Cache-Control", cacheControl);
+    return finalizeMetadataImageResponse(await response.arrayBuffer(), headers, options);
+  }
+  let body;
+  if (typeof value === "string") {
+    body = toArrayBuffer(new TextEncoder().encode(value));
+  } else if (value instanceof ArrayBuffer || ArrayBuffer.isView(value)) {
+    body = toArrayBuffer(value);
+  } else if (import_react4.default.isValidElement(value)) {
+    body = toArrayBuffer(new TextEncoder().encode((0, import_server.renderToStaticMarkup)(value)));
+  } else {
+    throw new Error("Metadata image must return a Response, string, bytes, or React element");
+  }
+  return finalizeMetadataImageResponse(
+    body,
+    {
+      "Content-Type": imageModule.contentType || "image/svg+xml; charset=utf-8",
+      "Cache-Control": cacheControl
+    },
+    options
+  );
+}
+__name(createFarmMetadataImageResponse, "createFarmMetadataImageResponse");
+
 // src/server/renderer.ts
 var cachedClerkProvider = null;
 var importRuntimeModule = new Function("specifier", "return import(specifier);");
@@ -16974,7 +18072,7 @@ function createPPRRefreshScript() {
 }
 __name(createPPRRefreshScript, "createPPRRefreshScript");
 function createPreHydrationClickQueueScript() {
-  return `<script>(function(){if(window.__FARM_PREHYDRATION_CLICK_QUEUE__)return;var queue=[];window.__FARM_PREHYDRATION_CLICK_QUEUE__=queue;window.__FARM_HYDRATED__=false;document.documentElement.dataset.farmHydrated="false";function isModified(event){return !!(event.metaKey||event.altKey||event.ctrlKey||event.shiftKey)}function closestQueuedTarget(target){while(target&&target!==document.documentElement){if(target.matches&&target.matches('button,[role="button"],input[type="button"],input[type="submit"],input[type="reset"]'))return target;target=target.parentElement}return null}document.addEventListener("click",function(event){if(window.__FARM_HYDRATED__)return;if(event.defaultPrevented||event.button!==0||isModified(event))return;var target=closestQueuedTarget(event.target);if(!target||target.closest&&target.closest("a[href]"))return;if(queue.some(function(item){return item.target===target}))return;queue.push({target:target,createdAt:Date.now()});event.preventDefault();event.stopImmediatePropagation()},true);})();</script>`;
+  return `<script>(function(){if(window.__FARM_PREHYDRATION_CLICK_QUEUE__)return;var queue=[];window.__FARM_PREHYDRATION_CLICK_QUEUE__=queue;window.__FARM_HYDRATED__=false;document.documentElement.dataset.farmHydrated="false";function isModified(event){return !!(event.metaKey||event.altKey||event.ctrlKey||event.shiftKey)}function closestQueuedTarget(target){while(target&&target!==document.documentElement){if(target.matches&&target.matches('button,[role="button"],input[type="button"],input[type="submit"],input[type="reset"]'))return target;target=target.parentElement}return null}document.addEventListener("click",function(event){if(window.__FARM_HYDRATED__)return;if(event.defaultPrevented||event.button!==0||isModified(event))return;var target=closestQueuedTarget(event.target);if(!target||target.closest&&target.closest("a[href]")||target.closest&&target.closest('[data-farm-island-hydrated="true"]'))return;if(queue.some(function(item){return item.target===target}))return;queue.push({target:target,createdAt:Date.now()});document.dispatchEvent(new CustomEvent("farm:island-interaction",{detail:{target:target}}));event.preventDefault();event.stopImmediatePropagation()},true);})();</script>`;
 }
 __name(createPreHydrationClickQueueScript, "createPreHydrationClickQueueScript");
 function searchParamsToObject(searchParams) {
@@ -17025,7 +18123,7 @@ function isWebResponse(value) {
   return typeof Response !== "undefined" && value instanceof Response && typeof value.arrayBuffer === "function";
 }
 __name(isWebResponse, "isWebResponse");
-var _FarmRouteErrorBoundary = class _FarmRouteErrorBoundary extends import_react4.default.Component {
+var _FarmRouteErrorBoundary = class _FarmRouteErrorBoundary extends import_react5.default.Component {
   constructor(props) {
     super(props);
     this.state = { hasError: false, error: null };
@@ -17036,7 +18134,7 @@ var _FarmRouteErrorBoundary = class _FarmRouteErrorBoundary extends import_react
   render() {
     if (this.state.hasError) {
       const Fallback = this.props.Fallback;
-      return import_react4.default.createElement(Fallback, {
+      return import_react5.default.createElement(Fallback, {
         ...this.props.fallbackProps,
         error: this.state.error,
         reset: /* @__PURE__ */ __name(() => this.setState({ hasError: false, error: null }), "reset")
@@ -17252,14 +18350,14 @@ var _ServerRenderer = class _ServerRenderer {
             searchParams: Promise.resolve({}),
             path: page2.urlPath
           };
-          let pageElement = import_react4.default.createElement(
+          let pageElement = import_react5.default.createElement(
             PageComponent,
             pageProps
           );
           for (let i = layoutModules.length - 1; i >= 0; i--) {
             const layoutModule = layoutModules[i];
             const LayoutComponent = layoutModule.default;
-            pageElement = import_react4.default.createElement(
+            pageElement = import_react5.default.createElement(
               LayoutComponent,
               {
                 children: pageElement,
@@ -17585,6 +18683,7 @@ var _ServerRenderer = class _ServerRenderer {
       req.__FARM_ROUTE__ = pathname;
       req.__FARM_IS_CLIENT_COMPONENT__ = isClientComponent;
       req.__FARM_SHOULD_HYDRATE__ = shouldHydrate;
+      req.__FARM_ISLAND_STRATEGY__ = moduleMetadata.islandStrategy;
       req.__FARM_HAS_HYDRATABLE_ROUTE_SLOTS__ = hasHydratableRouteSlots;
       req.__FARM_LOADING_MODULE_PATH__ = loadingBoundaryEntry?.modulePath ? loadingBoundaryEntry.modulePath.substring(
         loadingBoundaryEntry.modulePath.indexOf("/src/app/")
@@ -17637,12 +18736,12 @@ var _ServerRenderer = class _ServerRenderer {
       await _runWithMiddlewareData(middlewareDataForContext, async () => {
         await _runWithMiddlewareContext(middlewareContext, async () => {
           await _runWithCurrentRequest(currentRequest, async () => {
-            let pageElement = import_react4.default.createElement(
+            let pageElement = import_react5.default.createElement(
               PageComponent,
               pageProps
             );
             if (LoadingFallbackComponent) {
-              const loadingFallback = import_react4.default.createElement(LoadingFallbackComponent, {
+              const loadingFallback = import_react5.default.createElement(LoadingFallbackComponent, {
                 ...createRouteStateProps({
                   params,
                   searchParamsObject,
@@ -17651,16 +18750,21 @@ var _ServerRenderer = class _ServerRenderer {
                   pluginExposedContext
                 })
               });
-              pageElement = import_react4.default.createElement(
-                import_react4.default.Suspense,
+              pageElement = import_react5.default.createElement(
+                import_react5.default.Suspense,
                 { fallback: loadingFallback },
                 pageElement
               );
             }
             if (isClientComponent || shouldHydrate) {
-              pageElement = import_react4.default.createElement(
+              pageElement = import_react5.default.createElement(
                 "div",
-                { id: "__farm_page__", "data-farm-client": "true" },
+                {
+                  id: "__farm_page__",
+                  "data-farm-client": "true",
+                  "data-farm-island": "page",
+                  "data-farm-island-strategy": moduleMetadata.islandStrategy ?? "load"
+                },
                 pageElement
               );
             }
@@ -17672,11 +18776,11 @@ var _ServerRenderer = class _ServerRenderer {
               const slotProps = {};
               for (const slot of renderedRouteSlots) {
                 if (slot.ownerPattern !== layoutEntry.pattern) continue;
-                let slotElement = import_react4.default.createElement(
+                let slotElement = import_react5.default.createElement(
                   slot.module.default,
                   slot.props
                 );
-                slotElement = import_react4.default.createElement(
+                slotElement = import_react5.default.createElement(
                   "div",
                   {
                     id: slot.containerId,
@@ -17687,7 +18791,7 @@ var _ServerRenderer = class _ServerRenderer {
                 );
                 slotProps[slot.name] = slotElement;
               }
-              wrappedElement = import_react4.default.createElement(
+              wrappedElement = import_react5.default.createElement(
                 LayoutComponent,
                 {
                   children: wrappedElement,
@@ -17697,7 +18801,7 @@ var _ServerRenderer = class _ServerRenderer {
               );
             }
             if (ErrorFallbackComponent) {
-              wrappedElement = import_react4.default.createElement(
+              wrappedElement = import_react5.default.createElement(
                 FarmRouteErrorBoundary,
                 {
                   Fallback: ErrorFallbackComponent,
@@ -17830,7 +18934,7 @@ var _ServerRenderer = class _ServerRenderer {
         if (!cachedClerkProvider) {
           cachedClerkProvider = await importRuntimeModule("@clerk/react");
         }
-        wrapped = import_react4.default.createElement(
+        wrapped = import_react5.default.createElement(
           cachedClerkProvider.ClerkProvider,
           provider.props || {},
           wrapped
@@ -17905,6 +19009,13 @@ var _ServerRenderer = class _ServerRenderer {
     return reference;
   }
   async renderMetadataImage(req, res, options) {
+    const method = (req.method || "GET").toUpperCase();
+    if (method !== "GET" && method !== "HEAD") {
+      res.statusCode = 405;
+      res.setHeader("Allow", "GET, HEAD");
+      res.end();
+      return;
+    }
     if (options.image.sourceType === "static") {
       if (!options.image.staticInfo) {
         throw new Error(`Static metadata image ${options.image.modulePath} is missing file info`);
@@ -17930,42 +19041,12 @@ var _ServerRenderer = class _ServerRenderer {
     await this.writeMetadataImageResponse(req, res, handlerResult, imageModule);
   }
   async writeMetadataImageResponse(req, res, value, imageModule) {
-    if (isWebResponse(value)) {
-      res.statusCode = value.status;
-      value.headers.forEach((headerValue, key) => {
-        res.setHeader(key, headerValue);
-      });
-      if (req.method === "HEAD") {
-        res.end();
-        return;
-      }
-      const body2 = Buffer.from(await value.arrayBuffer());
-      res.write(body2);
-      res.end();
-      return;
-    }
-    const contentType = imageModule.contentType || "image/svg+xml; charset=utf-8";
-    let body;
-    if (typeof value === "string") {
-      body = value;
-    } else if (value instanceof ArrayBuffer) {
-      body = Buffer.from(value);
-    } else if (ArrayBuffer.isView(value)) {
-      body = Buffer.from(value.buffer, value.byteOffset, value.byteLength);
-    } else if (import_react4.default.isValidElement(value)) {
-      body = (0, import_server.renderToStaticMarkup)(value);
-    } else {
-      throw new Error("Metadata image must return a Response, string, bytes, or React element");
-    }
-    res.statusCode = res.statusCode || 200;
-    res.setHeader("Content-Type", contentType);
-    res.setHeader("Cache-Control", "public, max-age=0, must-revalidate");
-    if (req.method === "HEAD") {
-      res.end();
-      return;
-    }
-    res.write(body);
-    res.end();
+    const ifNoneMatch = req.headers["if-none-match"];
+    const response = await createFarmMetadataImageResponse(value, imageModule, {
+      method: req.method,
+      ifNoneMatch: Array.isArray(ifNoneMatch) ? ifNoneMatch[0] : ifNoneMatch
+    });
+    await sendWebResponse(res, response);
   }
   async writeStaticMetadataImageResponse(req, res, image) {
     const method = (req.method || "GET").toUpperCase();
@@ -18012,7 +19093,7 @@ var _ServerRenderer = class _ServerRenderer {
         return false;
       }
       const ErrorComponent = errorModule.default;
-      const errorElement = import_react4.default.createElement(ErrorComponent, {
+      const errorElement = import_react5.default.createElement(ErrorComponent, {
         ...createRouteStateProps({
           params: options.params,
           searchParamsObject: options.searchParamsObject,
@@ -18030,7 +19111,7 @@ var _ServerRenderer = class _ServerRenderer {
       );
       for (let i = layoutModules.length - 1; i >= 0; i--) {
         const LayoutComponent = layoutModules[i].default;
-        wrapped = import_react4.default.createElement(
+        wrapped = import_react5.default.createElement(
           LayoutComponent,
           {
             children: wrapped,
@@ -18095,6 +19176,7 @@ var _ServerRenderer = class _ServerRenderer {
           search: routeEntry.search,
           isClientComponent: routeEntry.isClientComponent,
           shouldHydrate: routeEntry.shouldHydrate,
+          islandStrategy: routeEntry.islandStrategy,
           preloads: [routeEntry.modulePath],
           assets: []
         };
@@ -18131,6 +19213,7 @@ window.__FARM_DEPLOYMENT_ID__ = ${serializeInlineValue(deploymentId)};
 window.__FARM_PATH__ = ${JSON.stringify(req.__FARM_ROUTE__ || req.url || "/")};
 window.__FARM_IS_CLIENT__ = ${JSON.stringify(isClientComponent)};
 window.__FARM_SHOULD_HYDRATE__ = ${JSON.stringify(req.__FARM_SHOULD_HYDRATE__ === true)};
+window.__FARM_ISLAND_STRATEGY__ = ${JSON.stringify(req.__FARM_ISLAND_STRATEGY__ || "load")};
 window.__FARM_PAGE_MODULE__ = ${JSON.stringify(relativePath2)};
 window.__FARM_LOADING_MODULE__ = ${JSON.stringify(
         req.__FARM_LOADING_MODULE_PATH__ || null
@@ -18148,8 +19231,8 @@ ${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 streamRoot = import_react4.default.createElement("div", { style: { display: "contents" } }, element);
-      const { pipe, abort } = (0, import_server.renderToPipeableStream)(streamRoot, {
+      const streamRoot = import_react5.default.createElement("div", { style: { display: "contents" } }, element);
+      const { pipe, abort } = (0, import_server2.renderToPipeableStream)(streamRoot, {
         onShellReady() {
           const shellReadyMs = Date.now() - streamStartTime;
           emitFarmEvent({
@@ -18307,12 +19390,12 @@ ${getFarmI18nClientSnapshot() ? `window.__FARM_I18N__ = ${serializeInlineValue(g
               break;
             }
           }
-          let element = import_react4.default.createElement(
+          let element = import_react5.default.createElement(
             NotFoundComponent,
             { pathname }
           );
           if (LayoutComponent) {
-            element = import_react4.default.createElement(
+            element = import_react5.default.createElement(
               LayoutComponent,
               { children: element }
             );
@@ -18426,6 +19509,7 @@ var import_path6 = __toESM(require("path"));
 init_devtools_config();
 init_config();
 init_auth_config();
+init_preload();
 var defaultDocsConfig = {
   enabled: false,
   entry: "/docs",
@@ -18494,6 +19578,7 @@ var _FarmApp = class _FarmApp {
       context: config.context || (() => void 0),
       serverActions: resolveServerActionsConfig(config.serverActions),
       images: resolveFarmImageConfig(config.images),
+      performance: resolveFarmPerformanceConfig(config.performance),
       i18n: isResolvedI18nConfig(config.i18n) ? config.i18n : resolveFarmI18nConfig(config.i18n, {
         root,
         mode: process.env.NODE_ENV === "production" ? "production" : "development"
@@ -20726,7 +21811,7 @@ init_response();
 init_integrations();
 init_devtools_config();
 var fs7 = __toESM(require("fs"));
-var path23 = __toESM(require("path"));
+var path25 = __toESM(require("path"));
 init_layers();
 
 // src/environment-vite.ts
@@ -21073,7 +22158,7 @@ function transformError(id, message) {
 __name(transformError, "transformError");
 
 // package.json
-var version = "0.1.0-beta.11";
+var version = "0.1.0-beta.13";
 
 // src/version.ts
 var FARM_VERSION = version;
@@ -21252,8 +22337,66 @@ async function createBlurDataURL(bytes) {
 }
 __name(createBlurDataURL, "createBlurDataURL");
 
+// src/font.ts
+function resolveFarmLayoutFonts(layouts) {
+  let resolved;
+  for (const layout2 of layouts) {
+    if (!layout2.fonts) continue;
+    resolved = { ...resolved, ...layout2.fonts };
+  }
+  return resolved;
+}
+__name(resolveFarmLayoutFonts, "resolveFarmLayoutFonts");
+
 // src/vite.ts
 init_image_server();
+
+// src/server/vite-config.ts
+var import_node_path9 = __toESM(require("path"));
+var FARM_CLIENT_ENTRY_PATTERN = "**/{page,layout,loading,error,not-found,default}.{js,jsx,ts,tsx}";
+var FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE = [
+  "react",
+  "react-dom",
+  "react-dom/client",
+  "react/jsx-runtime",
+  "react/jsx-dev-runtime",
+  "@farm.js/core/client",
+  "@farm.js/core/plugin/client",
+  "@farm.js/core/deferred",
+  "@farm.js/core/deployment",
+  "@farm.js/core/i18n/client",
+  "@farm.js/core/query/client",
+  "@farm.js/core/server-fn/client",
+  "@farm.js/core/server-query/client"
+];
+function createFarmClientOptimizeDepsEntries(projectRoot, appDirectories) {
+  const resolvedProjectRoot = import_node_path9.default.resolve(projectRoot);
+  return appDirectories.map((appDirectory) => {
+    const relativeAppDirectory = import_node_path9.default.relative(resolvedProjectRoot, import_node_path9.default.resolve(appDirectory)).replace(/\\/g, "/");
+    const prefix = relativeAppDirectory || ".";
+    return `${prefix}/${FARM_CLIENT_ENTRY_PATTERN}`;
+  });
+}
+__name(createFarmClientOptimizeDepsEntries, "createFarmClientOptimizeDepsEntries");
+function createFarmClientOptimizeDepsConfig(entries) {
+  return {
+    // Keep normal application dependency discovery for CJS-only packages, but
+    // seed every Farm browser runtime so React is present in the first crawl.
+    noDiscovery: false,
+    // Waiting for the crawl avoids serving a partial optimizer generation and
+    // then changing browser hashes while hydration is already in progress.
+    holdUntilCrawlEnd: true,
+    include: [...FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE],
+    // Farm's HTML boots through a virtual module and imports route UI lazily.
+    // Explicit entries let Vite finish that crawl before a navigation can
+    // rotate the optimizer hash underneath a hydrated React runtime.
+    ...entries?.length ? { entries: [...entries] } : {}
+  };
+}
+__name(createFarmClientOptimizeDepsConfig, "createFarmClientOptimizeDepsConfig");
+
+// src/vite.ts
+init_fonts();
 var ALL_TYPE_ARTIFACTS = {
   routes: true,
   api: true,
@@ -21474,7 +22617,7 @@ function fileContainsProgrammaticPageRoute(file) {
 __name(fileContainsProgrammaticPageRoute, "fileContainsProgrammaticPageRoute");
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path23.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path25.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -21494,7 +22637,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 = path23.resolve(path23.dirname(cleanId), sourcePath);
+    const resolvedPath = path25.resolve(path25.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -21579,7 +22722,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...layerRoots.length ? {
           server: {
             fs: {
-              allow: [path23.resolve(options.root || process.cwd()), ...layerRoots]
+              allow: [path25.resolve(options.root || process.cwd()), ...layerRoots]
             }
           }
         } : {}
@@ -21610,9 +22753,9 @@ function farmPlugin(options = {}, initialPluginManager) {
         },
         server
       );
-      const globalsCSSPath = path23.join(server.config.root, "src/app/globals.css");
+      const globalsCSSPath = path25.join(server.config.root, "src/app/globals.css");
       if (!fs7.existsSync(globalsCSSPath)) {
-        const appDir = path23.join(server.config.root, "src/app");
+        const appDir = path25.join(server.config.root, "src/app");
         if (!fs7.existsSync(appDir)) {
           fs7.mkdirSync(appDir, { recursive: true });
         }
@@ -21634,10 +22777,10 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path23.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path25.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
-          farmConfig.i18n.messages.includes("{locale}") ? path23.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
+          farmConfig.i18n.messages.includes("{locale}") ? path25.dirname(farmConfig.i18n.messages) : farmConfig.i18n.messages
         );
       }
       const workflowConfig = farmConfig.workflows;
@@ -21647,7 +22790,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path23.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path25.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -21687,7 +22830,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path23.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path25.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -21805,7 +22948,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       await apiRouteManager.discoverRoutes();
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs7.existsSync(path23.isAbsolute(dir) ? dir : path23.join(farmConfig.root, dir))
+        (dir) => fs7.existsSync(path25.isAbsolute(dir) ? dir : path25.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler: createFarmWorkflowRequestHandler2, discoverFarmWorkflows: discoverFarmWorkflows2 } = await loadFarmWorkflowsDevRuntime();
@@ -21869,10 +23012,20 @@ function farmPlugin(options = {}, initialPluginManager) {
           logger.info(`Refreshed routes: ${reason}`);
         }
       }, "refreshRouteDiscovery");
+      const farmDocsFontAssetList = farmDocsDevRuntime ? resolveFarmDocsFontAssets(farmConfig.root) : [];
       const farmDocsHandler = farmDocsDevRuntime ? farmDocsDevRuntime.createFarmDocsHandler(farmConfig.docs, {
         root: farmConfig.root,
         srcDir: farmConfig.srcDir,
-        clientEntry: "/@farm/client.js"
+        clientEntry: "/@farm/client.js",
+        fontAssets: toFarmDocsPublicFontAssets(farmDocsFontAssetList),
+        resolveLayoutFonts: /* @__PURE__ */ __name(async (pathname) => {
+          const layouts = routeManager.matchRoute(pathname).layouts;
+          const layoutModules = await Promise.all(
+            layouts.map((layout2) => routeManager.loadLayoutModule(layout2.modulePath))
+          );
+          return resolveFarmLayoutFonts(layoutModules);
+        }, "resolveLayoutFonts"),
+        fontStylesheetHref: "/@farm/fonts.css"
       }) : null;
       const farmDocsAPIHandler = farmDocsDevRuntime ? farmDocsDevRuntime.createFarmDocsAPIHandler({
         rootDir: farmConfig.root,
@@ -21880,22 +23033,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         docs: farmConfig.docs
       }) : null;
       const farmDocsFontAssets = new Map(
-        farmDocsDevRuntime ? [
-          [
-            "/assets/Geist-Variable-CrgPqtmy.woff2",
-            path23.join(
-              farmConfig.root,
-              "node_modules/geist/dist/fonts/geist-sans/Geist-Variable.woff2"
-            )
-          ],
-          [
-            "/assets/GeistMono-Variable-BNLlm6Cd.woff2",
-            path23.join(
-              farmConfig.root,
-              "node_modules/geist/dist/fonts/geist-mono/GeistMono-Variable.woff2"
-            )
-          ]
-        ] : []
+        farmDocsFontAssetList.map(({ url, sourcePath }) => [url, sourcePath])
       );
       const logRequest = /* @__PURE__ */ __name((method, urlPath, tag) => {
         try {
@@ -21959,11 +23097,12 @@ function farmPlugin(options = {}, initialPluginManager) {
             }
           }
           const farmDocsFontPath = farmDocsFontAssets.get(requestPathname);
-          if (farmDocsFontPath && fs7.existsSync(farmDocsFontPath)) {
+          if ((requestMethod === "GET" || requestMethod === "HEAD") && farmDocsFontPath && fs7.existsSync(farmDocsFontPath)) {
             res.statusCode = 200;
             res.setHeader("Content-Type", "font/woff2");
             res.setHeader("Cache-Control", "public, max-age=31536000, immutable");
-            fs7.createReadStream(farmDocsFontPath).pipe(res);
+            if (requestMethod === "HEAD") res.end();
+            else fs7.createReadStream(farmDocsFontPath).pipe(res);
             return;
           }
           if (requestMethod === "GET" && (requestPathname === FARM_DEVTOOLS_PATH || requestPathname === `${FARM_DEVTOOLS_PATH}.json`)) {
@@ -22569,6 +23708,7 @@ function farmPlugin(options = {}, initialPluginManager) {
                   modulePath: toUrlPath(route.modulePath),
                   isClientComponent: routeSlots.length > 0 ? false : isClientComponent,
                   shouldHydrate: shouldHydrate || routeSlots.some((slot) => slot.isClientComponent || slot.shouldHydrate),
+                  islandStrategy: moduleMetadata.islandStrategy,
                   metadata: {
                     title: mergedMetadata.title,
                     description: mergedMetadata.description
@@ -22953,6 +24093,7 @@ export const getManifest = () => ({
             search: route.search,
             isClientComponent: moduleMetadata.isClientComponent,
             shouldHydrate: moduleMetadata.shouldHydrate,
+            islandStrategy: moduleMetadata.islandStrategy,
             preloads: [route.modulePath],
             // In dev, preload is just the module
             assets: []
@@ -23079,8 +24220,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path23.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path23.join(outDir, "client");
+        const outDir = path25.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path25.join(outDir, "client");
         for (const page2 of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page2.urlPath, "http://farm.static"));
@@ -23091,7 +24232,7 @@ if (import.meta.hot) {
               const layoutModules = await Promise.all(
                 layouts.map((l) => routeManager.loadLayoutModule(l.modulePath))
               );
-              const React3 = await import("react");
+              const React4 = await import("react");
               const { renderToString } = await import("react-dom/server");
               const PageComponent = mod.default;
               const pageProps = {
@@ -23099,14 +24240,14 @@ if (import.meta.hot) {
                 searchParams: Promise.resolve({}),
                 path: page2.urlPath
               };
-              let pageElement = React3.createElement(
+              let pageElement = React4.createElement(
                 PageComponent,
                 pageProps
               );
               for (let i = layoutModules.length - 1; i >= 0; i--) {
                 const layoutModule = layoutModules[i];
                 const LayoutComponent = layoutModule.default;
-                pageElement = React3.createElement(
+                pageElement = React4.createElement(
                   LayoutComponent,
                   {
                     children: pageElement,
@@ -23132,8 +24273,8 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page2.urlPath === "/" ? path23.join(clientDir, "index.html") : path23.join(clientDir, page2.urlPath + ".html");
-              fs7.mkdirSync(path23.dirname(outputPath), { recursive: true });
+              const outputPath = page2.urlPath === "/" ? path25.join(clientDir, "index.html") : path25.join(clientDir, page2.urlPath + ".html");
+              fs7.mkdirSync(path25.dirname(outputPath), { recursive: true });
               fs7.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page2.revalidate ? ` (revalidate: ${page2.revalidate}s)` : "";
               logger.success(`  \u2713 ${page2.urlPath}${revalidateInfo}`);
@@ -23142,7 +24283,7 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page2.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path23.join(outDir, "__ssg_manifest.json");
+        const manifestPath = path25.join(outDir, "__ssg_manifest.json");
         fs7.writeFileSync(
           manifestPath,
           JSON.stringify(
@@ -23178,9 +24319,9 @@ if (import.meta.hot) {
       }
       const currentFarmConfig = farmApp?.getConfig();
       const normalizedFile = file.replace(/\\/g, "/");
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path23.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path25.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path23.basename(file)}`);
+        logUpdate("PAGE", `updated ${path25.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -23577,6 +24718,7 @@ import React from 'react'
 import { hydrateRoot, createRoot } from 'react-dom/client'
 import { installChunkErrorRecovery, SPARouter } from '@farm.js/core/client'
 import { createClientPluginManager } from '@farm.js/core/plugin/client'
+import { scheduleFarmIslandHydration } from '@farm.js/core/internal/client-runtime'
 import { reviveDeferredData } from '@farm.js/core/deferred'
 import {
   createFarmDeploymentMismatchError,
@@ -23829,6 +24971,7 @@ class LegacyManifestSPARouter {
 
     // Only prefetch routes that will hydrate on the client.
     if (!match.route.isClientComponent && !match.route.shouldHydrate) return;
+    if (match.route.islandStrategy && match.route.islandStrategy !== 'load') return;
 
     const modulePath = match.route.modulePath;
     if (this.moduleCache.has(modulePath)) return;
@@ -23973,6 +25116,12 @@ let hasClientTakenOver = false;
 const routeSlotRoots = new Map();
 const routeSlotDefinitions = new Map();
 let activeRouteInterception = null;
+let pendingPageHydrationController = null;
+
+function cancelPendingPageHydration() {
+  pendingPageHydrationController?.abort();
+  pendingPageHydrationController = null;
+}
 
 function normalizeServerProps(rawProps) {
   const props = rawProps && typeof rawProps === 'object' ? { ...rawProps } : {};
@@ -24041,7 +25190,11 @@ async function hydrateInitialRouteSlots() {
     routeSlotDefinitions.set(getRouteSlotKey(slot), slot);
     if (!slot.isClientComponent && !slot.shouldHydrate) continue;
     try {
-      hydrated = (await renderRouteSlot(slot, 'hydrate')) || hydrated;
+      const slotHydrated = await renderRouteSlot(slot, 'hydrate');
+      hydrated = slotHydrated || hydrated;
+      if (slotHydrated) {
+        replayPreHydrationClicks(document.getElementById(slot.containerId));
+      }
     } catch (error) {
       console.warn('[Farm.js] Could not hydrate route slot:', slot.name, error);
     }
@@ -24112,16 +25265,29 @@ function applyCanonicalPathFromProps(props) {
   window.history.replaceState({ ...(window.history.state || {}), path: canonicalPath }, '', canonicalPath);
 }
 
-function replayPreHydrationClicks() {
-  window.__FARM_HYDRATED__ = true;
-  document.documentElement.dataset.farmHydrated = 'true';
+function replayPreHydrationClicks(container = null) {
+  if (!container) {
+    markFarmHydrated();
+  } else {
+    container.dataset.farmIslandHydrated = 'true';
+  }
 
   const queue = Array.isArray(window.__FARM_PREHYDRATION_CLICK_QUEUE__)
     ? window.__FARM_PREHYDRATION_CLICK_QUEUE__
     : [];
   if (queue.length === 0) return;
 
-  const queuedClicks = queue.splice(0, queue.length);
+  const queuedClicks = [];
+  const remainingClicks = [];
+  for (const queuedClick of queue) {
+    const target = queuedClick?.target;
+    if (!container || (target instanceof Node && container.contains(target))) {
+      queuedClicks.push(queuedClick);
+    } else {
+      remainingClicks.push(queuedClick);
+    }
+  }
+  queue.splice(0, queue.length, ...remainingClicks);
   for (const queuedClick of queuedClicks) {
     const target = queuedClick?.target;
     if (!target || typeof target.click !== 'function') continue;
@@ -24130,6 +25296,11 @@ function replayPreHydrationClicks() {
   }
 }
 
+function markFarmHydrated() {
+  window.__FARM_HYDRATED__ = true;
+  document.documentElement.dataset.farmHydrated = 'true';
+}
+
 async function buildClientHydrationElement(PageComponent, pageProps) {
   let element = React.createElement(PageComponent, pageProps);
   const loadingModulePath = window.__FARM_LOADING_MODULE__;
@@ -24272,9 +25443,10 @@ async function tryHydrateImportedPage(
   layouts,
   useHydrate = false,
   existingProps = null,
+  signal = null,
 ) {
   const modulePath = route?.modulePath;
-  if (!modulePath) {
+  if (!modulePath || signal?.aborted) {
     return false;
   }
 
@@ -24283,6 +25455,7 @@ async function tryHydrateImportedPage(
     pageModule = await import(/* @vite-ignore */ modulePath);
     pageModuleCache.set(modulePath, pageModule);
   }
+  if (signal?.aborted || !container?.isConnected) return false;
 
   const PageComponent = pageModule?.default;
   if (!PageComponent) {
@@ -24297,6 +25470,7 @@ async function tryHydrateImportedPage(
     window.location.pathname,
     existingProps,
   );
+  if (signal?.aborted || !container?.isConnected) return false;
 
   const wrappedElement = useHydrate && container?.id === '__farm_page__'
     ? wrapWithIntegrationProviders(
@@ -24307,6 +25481,7 @@ async function tryHydrateImportedPage(
         currentPageProps,
         layouts,
       );
+  if (signal?.aborted || !container?.isConnected) return false;
 
   if (useHydrate) {
     try {
@@ -24337,6 +25512,7 @@ async function tryHydrateImportedPage(
 async function renderPage(pageData) {
   const container = document.getElementById('root');
   if (!container) return;
+  cancelPendingPageHydration();
   const destination = window.location.pathname + window.location.search;
 
   if (pageData.interception) {
@@ -24353,6 +25529,7 @@ async function renderPage(pageData) {
     modulePath: pageData.modulePath,
     isClientComponent: pageData.isClientComponent === true,
     shouldHydrate: pageData.shouldHydrate === true,
+    islandStrategy: pageData.islandStrategy || 'load',
   };
   const params = pageData.props?.params || {};
   const layouts = (pageData.layoutModules || []).map((modulePath, index) => ({
@@ -24552,14 +25729,6 @@ async function hydrate() {
   }
 
   try {
-    // Pre-load layout for SPA navigation
-    try {
-      const layoutModule = await import(/* @vite-ignore */ '/src/app/layout.tsx');
-      LayoutComponent = layoutModule.default;
-    } catch (e) {
-      console.warn('[Farm.js] Could not preload layout:', e);
-    }
-
     // Check if this is a client component (set by SSR)
     const isClientComponent = window.__FARM_IS_CLIENT__ === true;
     const modulePath = window.__FARM_PAGE_MODULE__;
@@ -24607,34 +25776,88 @@ async function hydrate() {
       return
     }
 
-    const hydrationSession = await farmClientRuntime.beginHydration({
-      container: pageContainer,
-      mode: shouldHydrate ? 'hydrate' : 'render',
-    });
+    const currentRoute = findRoute(window.location.pathname)?.route;
+    const islandStrategy = window.__FARM_ISLAND_STRATEGY__ || currentRoute?.islandStrategy || 'load';
+    pageContainer.dataset.farmIsland = 'page';
+    pageContainer.dataset.farmIslandStrategy = islandStrategy;
 
-    let hydrated = false;
+    const hydrationPathname = window.location.pathname;
+    const hydrationController = new AbortController();
+    pendingPageHydrationController = hydrationController;
     try {
-      hydrated = await tryHydrateImportedPage(
-        pageContainer,
-        { modulePath },
-        currentPageProps.params || {},
-        layouts,
-        shouldHydrate,
-        currentPageProps,
-      );
-      await farmClientRuntime.completeHydration(hydrationSession);
-    } catch (error) {
-      await farmClientRuntime.failHydration(hydrationSession, error);
-      throw error;
-    }
+      await scheduleFarmIslandHydration({
+        container: pageContainer,
+        strategy: islandStrategy,
+        signal: hydrationController.signal,
+        hydrate: async () => {
+          if (
+            hydrationController.signal.aborted ||
+            !pageContainer.isConnected ||
+            window.location.pathname !== hydrationPathname
+          ) {
+            return;
+          }
 
-    if (hydrated) {
-      replayPreHydrationClicks();
-      console.log('[Farm.js] \u2705 Hydrated:', modulePath);
-      return;
-    }
+          // Layout code is only needed when this route boundary actually hydrates.
+          try {
+            const layoutModule = await import(/* @vite-ignore */ '/src/app/layout.tsx');
+            LayoutComponent = layoutModule.default;
+          } catch (e) {
+            console.warn('[Farm.js] Could not preload layout:', e);
+          }
+          if (hydrationController.signal.aborted || !pageContainer.isConnected) return;
+
+          const hydrationSession = await farmClientRuntime.beginHydration({
+            container: pageContainer,
+            mode: shouldHydrate ? 'hydrate' : 'render',
+          });
 
-    console.log('[Farm.js] Server component - SPA router ready')
+          let hydrated = false;
+          try {
+            if (hydrationController.signal.aborted || !pageContainer.isConnected) {
+              await farmClientRuntime.failHydration(
+                hydrationSession,
+                new DOMException('Route hydration was cancelled', 'AbortError'),
+              );
+              return;
+            }
+            hydrated = await tryHydrateImportedPage(
+              pageContainer,
+              { modulePath },
+              currentPageProps.params || {},
+              layouts,
+              shouldHydrate,
+              currentPageProps,
+              hydrationController.signal,
+            );
+            if (hydrationController.signal.aborted || !pageContainer.isConnected) {
+              await farmClientRuntime.failHydration(
+                hydrationSession,
+                new DOMException('Route hydration was cancelled', 'AbortError'),
+              );
+              return;
+            }
+            await farmClientRuntime.completeHydration(hydrationSession);
+          } catch (error) {
+            await farmClientRuntime.failHydration(hydrationSession, error);
+            throw error;
+          }
+
+          if (hydrated) {
+            // The scheduler owns queue draining and exactly-once click replay.
+            markFarmHydrated();
+            console.log('[Farm.js] \u2705 Hydrated:', modulePath, '(' + islandStrategy + ')');
+            return;
+          }
+
+          console.log('[Farm.js] Server component - SPA router ready')
+        },
+      });
+    } finally {
+      if (pendingPageHydrationController === hydrationController) {
+        pendingPageHydrationController = null;
+      }
+    }
   } catch (error) {
     console.error('[Farm.js] Hydration error:', error)
   }
@@ -24740,7 +25963,7 @@ function generateClientManifest(bundle) {
 __name(generateClientManifest, "generateClientManifest");
 async function defineConfig2(config = {}) {
   const tailwindcss = (await import("@tailwindcss/vite")).default;
-  const appRoot = path23.resolve(config.root || process.cwd());
+  const appRoot = path25.resolve(config.root || process.cwd());
   if (config.extends?.length) {
     const { config: layeredConfig } = await Promise.resolve().then(() => (init_layers(), layers_exports)).then(
       ({ resolveFarmLayers: resolveFarmLayers2 }) => resolveFarmLayers2(config, {
@@ -24885,13 +26108,16 @@ async function defineConfig2(config = {}) {
     customLogger: farmLogger,
     clearScreen: false,
     optimizeDeps: {
-      include: [
-        "react",
-        "react-dom",
-        "react-dom/client",
-        "react/jsx-runtime",
-        "react/jsx-dev-runtime"
-      ],
+      ...createFarmClientOptimizeDepsConfig(
+        createFarmClientOptimizeDepsEntries(
+          appRoot,
+          getFarmAppDirectories({ ...config, root: appRoot })
+        )
+      ),
+      // Pre-bundle every framework client-runtime entry with React. Without
+      // this, Vite can discover a linked Farm entry after the page has loaded,
+      // regenerate the optimizer browser hash, and leave React DOM holding a
+      // different React module instance from a client component.
       // Exclude server-side packages from browser bundling
       exclude: [
         "@farm.js/core/server",
@@ -24926,7 +26152,7 @@ async function defineConfig2(config = {}) {
       // Stub out problematic server-only modules during dev mode
       alias: {
         ...getFarmLayerAliases(config.layers),
-        "@": path23.resolve(appRoot, "src"),
+        "@": path25.resolve(appRoot, "src"),
         // Nitro internals that should not be resolved in browser
         "supports-color": "data:text/javascript,export default false; export const supportsColor = false; export const stdout = false; export const stderr = false;",
         "@poppinss/dumper": "data:text/javascript,export default {};",