@farm.js/core 0.1.41 → 0.1.43

package/dist/{chunk-BGGWKZ2V.mjs → chunk-OYSGGV6O.mjs}

@@ -1,3 +1,7 @@
+import {
+  createFarmReactRefreshPlugins,
+  isFarmReactRefreshActive
+} from "./chunk-5NIWBWDD.mjs";
 import {
   createFarmImageHandler
 } from "./chunk-INQ64HTJ.mjs";
@@ -7,7 +11,6 @@ import {
   collectFarmWebMCPTools,
   createFarmClientOptimizeDepsConfig,
   createFarmClientOptimizeDepsEntries,
-  createFarmRouteRenderPlan,
   createFarmSourceAlias,
   createFarmThemeCssPlugin,
   farmFontImportsPlugin,
@@ -15,14 +18,10 @@ import {
   generateFarmClientPluginEntryCode,
   generateFarmIntegrationProviderClientCode,
   getClientModuleMetadata,
-  getFarmFragmentCacheControl,
   getIslandStrategyExport,
-  getSharedLayoutPrefixLength,
   hasUseClientDirective,
   isFarmDocsClientConfigModule,
   isIsolatableClientBoundarySource,
-  loadTailwindVitePlugin,
-  parseFarmLayoutChainHeader,
   redactFarmDocsClientConfig,
   resolveDevGlobalStylesheetHref,
   resolveFarmAppPackages,
@@ -31,29 +30,35 @@ import {
   resolveFarmIsolatedClientHydrationMode,
   resolveModuleSourcePath,
   stripUseClientDirective
-} from "./chunk-FJGIVDA5.mjs";
+} from "./chunk-7SCCY6SI.mjs";
 import {
   FARM_NODE_RESPONSE_END_PENDING
 } from "./chunk-FGH3ZXTP.mjs";
+import {
+  loadTailwindVitePlugin
+} from "./chunk-S34OBRMZ.mjs";
 import {
   generateFarmTypeArtifacts,
   resolveRouteRenderingConfig
-} from "./chunk-35WS7P2V.mjs";
+} from "./chunk-26CXZR6L.mjs";
 import {
   FARM_API_CATALOG_PATH,
-  FARM_INFRA_SIGNATURE_HEADER,
   createFarmAiCatalogResponse,
   createFarmApiCatalogResponse,
   createFarmAppManifestResponse,
+  createFarmRouteRenderPlan,
   farmPathGuardCoversEndpoint,
   farmPathGuardCoversPage,
+  getFarmFragmentCacheControl,
   getRouteGroupScope,
+  getSharedLayoutPrefixLength,
   isFarmAppManifestPath,
+  parseFarmLayoutChainHeader,
   renderFarmLocaleAlternateLinks,
   resolveFarmApiCatalogInput,
   resolveFarmAppManifestInput,
   stripRouteGroups
-} from "./chunk-SVPGWJZF.mjs";
+} from "./chunk-TESO7EFU.mjs";
 import {
   isFarmPreviewDeploymentEnvironment
 } from "./chunk-BOYNDCZL.mjs";
@@ -74,8 +79,9 @@ import {
   toFarmDocsPublicFontAssets
 } from "./chunk-TVGP4BBZ.mjs";
 import {
-  generateFarmDevIndicatorsClientRuntime
-} from "./chunk-HCSVR4YZ.mjs";
+  generateFarmDevIndicatorsClientRuntime,
+  resolveFarmServerComponentsMode
+} from "./chunk-M3BXTWJM.mjs";
 import {
   FARM_DEVTOOLS_LAUNCH_PARAM,
   FARM_DEVTOOLS_PATH,
@@ -94,7 +100,7 @@ import {
   FARM_PREVIEW_ROBOTS_TAG,
   resolveFarmAgentCrawlers,
   resolveFarmAgentSitemap
-} from "./chunk-BYQVROIP.mjs";
+} from "./chunk-DMRPN25V.mjs";
 import {
   resolveFarmLlmsTxtConfig
 } from "./chunk-ETPEZLS3.mjs";
@@ -212,7 +218,7 @@ import {
 } from "./chunk-ZZGQD7A4.mjs";
 import {
   FARM_VERSION
-} from "./chunk-VLPII2JJ.mjs";
+} from "./chunk-YGZH4T2X.mjs";
 import {
   DEFAULT_FARM_API_BASE_PATH
 } from "./chunk-7LTCDQRS.mjs";
@@ -247,9 +253,32 @@ import {
   __require
 } from "./chunk-LPEX4YW6.mjs";
 
+// src/form-actions-transform.ts
+import { createHash } from "crypto";
+import { transformActions } from "@farm.js/islx/compiler";
+import path from "path";
+function transformFarmFormActionModule(options) {
+  const result = transformActions({
+    code: options.code,
+    id: options.id,
+    root: options.root,
+    environment: options.ssr ? "server" : "client",
+    parse: options.parse,
+    runtime: {
+      server: "@farm.js/core/internal/islx-server",
+      client: "@farm.js/core/internal/islx-client"
+    }
+  });
+  return result ? result.code : null;
+}
+__name(transformFarmFormActionModule, "transformFarmFormActionModule");
+
+// src/vite.ts
+import { parseSync } from "vite";
+
 // src/dev-preview-guard.ts
 import { promises as fsp } from "fs";
-import * as path from "path";
+import * as path2 from "path";
 var FARM_PREVIEW_REQUEST_HEADER = "x-farm-preview";
 function isFarmPreviewTunnelRequest(headers) {
   return headers[FARM_PREVIEW_REQUEST_HEADER] !== void 0;
@@ -265,10 +294,10 @@ var VITE_DEFAULT_FS_DENY = [
 ];
 function getFarmDevFsDeny(userDeny, options) {
   const deny = ["**/.farm/**"];
-  const root = path.resolve(options.root || process.cwd());
-  const distDir = options.distDir ? path.resolve(root, options.distDir) : void 0;
-  const relativeDistDir = distDir ? path.relative(root, distDir) : "";
-  if (distDir && relativeDistDir && relativeDistDir !== ".farm" && relativeDistDir !== ".." && !relativeDistDir.startsWith(`..${path.sep}`) && !/[*?[\]{}()!+@]/.test(distDir)) {
+  const root = path2.resolve(options.root || process.cwd());
+  const distDir = options.distDir ? path2.resolve(root, options.distDir) : void 0;
+  const relativeDistDir = distDir ? path2.relative(root, distDir) : "";
+  if (distDir && relativeDistDir && relativeDistDir !== ".farm" && relativeDistDir !== ".." && !relativeDistDir.startsWith(`..${path2.sep}`) && !/[*?[\]{}()!+@]/.test(distDir)) {
     deny.push(`${distDir.replace(/\\/g, "/")}/**`);
   }
   return userDeny ? deny : [...VITE_DEFAULT_FS_DENY, ...deny];
@@ -314,7 +343,7 @@ async function isAllowedPreviewRequest(server, options, req) {
   const inClientGraph = /* @__PURE__ */ __name(async () => Boolean(await client?.moduleGraph.getModuleByUrl(url)), "inClientGraph");
   if (SOURCE_QUERY_FLAGS.some((flag) => query.has(flag))) return inClientGraph();
   if (await inClientGraph()) return true;
-  if (file.split(path.sep).includes("node_modules")) return true;
+  if (file.split(path2.sep).includes("node_modules")) return true;
   if (server.config.publicDir && isInside(await realpathOr(server.config.publicDir), file)) {
     return true;
   }
@@ -322,8 +351,8 @@ async function isAllowedPreviewRequest(server, options, req) {
   if (!isModuleOrAsset) return false;
   for (const source of options.getSourceRoots()) {
     const sourceRoot = await realpathOr(source.root);
-    const sourceDir = await realpathOr(path.resolve(source.root, source.srcDir));
-    if (sourceRoot === sourceDir && path.dirname(file) === sourceDir) continue;
+    const sourceDir = await realpathOr(path2.resolve(source.root, source.srcDir));
+    if (sourceRoot === sourceDir && path2.dirname(file) === sourceDir) continue;
     if (isInside(sourceDir, file)) return true;
   }
   return false;
@@ -342,9 +371,9 @@ async function resolveRequestedFile(server, pathname) {
     }
     const resolved = await server.environments?.client?.pluginContainer.resolveId(id, void 0);
     const resolvedId = resolved?.id.replace(/[?#].*$/, "");
-    if (resolvedId && path.isAbsolute(resolvedId)) candidate = resolvedId;
+    if (resolvedId && path2.isAbsolute(resolvedId)) candidate = resolvedId;
     else if (resolvedId?.startsWith("\0")) return void 0;
-    else if (id.startsWith("/")) candidate = path.join(server.config.root, id);
+    else if (id.startsWith("/")) candidate = path2.join(server.config.root, id);
   }
   if (!candidate) return void 0;
   try {
@@ -359,24 +388,24 @@ async function realpathOr(directory) {
   try {
     return await fsp.realpath(directory);
   } catch {
-    return path.resolve(directory);
+    return path2.resolve(directory);
   }
 }
 __name(realpathOr, "realpathOr");
 function isInside(directory, file) {
-  const relative2 = path.relative(directory, file);
-  return relative2 !== "" && relative2 !== ".." && !relative2.startsWith(`..${path.sep}`) && !path.isAbsolute(relative2);
+  const relative2 = path2.relative(directory, file);
+  return relative2 !== "" && relative2 !== ".." && !relative2.startsWith(`..${path2.sep}`) && !path2.isAbsolute(relative2);
 }
 __name(isInside, "isInside");
 
 // src/vite.ts
 import * as fs2 from "fs";
-import * as path4 from "path";
-import { pathToFileURL as pathToFileURL2 } from "url";
+import * as path5 from "path";
+import { pathToFileURL } from "url";
 
 // src/dev-static.ts
 import * as fs from "fs";
-import * as path2 from "path";
+import * as path3 from "path";
 function shouldBypassFarmRouterForDottedPath(pathname, routeManager, baseDirs, generatedPaths = []) {
   if (!pathname.includes(".") || pathname.endsWith(".html")) return false;
   const matchesAppRoute = Boolean(
@@ -423,9 +452,9 @@ function devServableFileExists(pathname, baseDirs) {
   if (!relativePathname) return false;
   for (const baseDir of baseDirs) {
     if (typeof baseDir !== "string" || baseDir.length === 0) continue;
-    const resolvedBase = path2.resolve(baseDir);
-    const candidate = path2.resolve(resolvedBase, relativePathname);
-    if (!candidate.startsWith(resolvedBase + path2.sep)) continue;
+    const resolvedBase = path3.resolve(baseDir);
+    const candidate = path3.resolve(resolvedBase, relativePathname);
+    if (!candidate.startsWith(resolvedBase + path3.sep)) continue;
     try {
       if (fs.existsSync(candidate) && fs.statSync(candidate).isFile()) {
         return true;
@@ -572,7 +601,7 @@ __name(formatClientBoundaryWarning, "formatClientBoundaryWarning");
 
 // src/image-vite.ts
 import { readFile } from "fs/promises";
-import path3 from "path";
+import path4 from "path";
 import { imageSize } from "image-size";
 var FARM_IMAGE_ID_PREFIX = "\0farm:image:";
 var STATIC_IMAGE_RE = /\.(?:avif|gif|jpe?g|png|webp)$/i;
@@ -639,90 +668,6 @@ async function createBlurDataURL(bytes) {
 }
 __name(createBlurDataURL, "createBlurDataURL");
 
-// src/react-refresh.ts
-import { createRequire } from "module";
-import { pathToFileURL } from "url";
-var REACT_REFRESH_PLUGIN = "vite:react-refresh";
-var FARM_REACT_REFRESH_PREAMBLE_ID = "/@farm/react-refresh-preamble";
-var FARM_OWNED = /* @__PURE__ */ Symbol.for("farm.react-refresh.owned");
-function isFarmReactRefreshActive(config) {
-  return config.command === "serve" && !config.isProduction && config.server.hmr !== false && config.plugins.some((plugin) => plugin.name === REACT_REFRESH_PLUGIN);
-}
-__name(isFarmReactRefreshActive, "isFarmReactRefreshActive");
-function isFarmClientEntryId(id) {
-  const pathname = id.split("?", 1)[0];
-  return pathname === "/@farm/client" || pathname === "/@farm/client.js";
-}
-__name(isFarmClientEntryId, "isFarmClientEntryId");
-function hasAppReactPlugin(plugins) {
-  const pending = [...plugins ?? []];
-  while (pending.length > 0) {
-    const entry = pending.pop();
-    if (Array.isArray(entry)) {
-      pending.push(...entry);
-      continue;
-    }
-    if (!entry || typeof entry !== "object" || "then" in entry) continue;
-    if (entry.name === REACT_REFRESH_PLUGIN && !(FARM_OWNED in entry)) return true;
-  }
-  return false;
-}
-__name(hasAppReactPlugin, "hasAppReactPlugin");
-function createFarmReactRefreshPreamblePlugin() {
-  let active = false;
-  return {
-    name: "farm:react-refresh-preamble",
-    apply: "serve",
-    configResolved(config) {
-      active = isFarmReactRefreshActive(config);
-    },
-    resolveId(id) {
-      if (id === FARM_REACT_REFRESH_PREAMBLE_ID) return id;
-    },
-    load(id) {
-      if (id !== FARM_REACT_REFRESH_PREAMBLE_ID) return;
-      if (!active) return "";
-      return `import RefreshRuntime from "/@react-refresh";
-RefreshRuntime.injectIntoGlobalHook(window);
-window.$RefreshReg$ = () => {};
-window.$RefreshSig$ = () => (type) => type;
-window.__vite_plugin_react_preamble_installed__ = true;
-`;
-    },
-    transform(code, id) {
-      if (!active || this.environment?.config.consumer !== "client" || !isFarmClientEntryId(id)) {
-        return;
-      }
-      return {
-        code: `import ${JSON.stringify(FARM_REACT_REFRESH_PREAMBLE_ID)};
-${code}`,
-        map: null
-      };
-    }
-  };
-}
-__name(createFarmReactRefreshPreamblePlugin, "createFarmReactRefreshPreamblePlugin");
-async function createFarmReactRefreshPlugins() {
-  const entry = createRequire(
-    typeof __filename === "string" ? __filename : import.meta.url
-  ).resolve("@vitejs/plugin-react");
-  const { default: react } = await import(
-    /* @vite-ignore */
-    pathToFileURL(entry).href
-  );
-  const plugins = react().map(
-    (plugin) => Object.assign(
-      {
-        ...plugin,
-        apply: /* @__PURE__ */ __name((config, env) => env.command === "serve" && !hasAppReactPlugin(config.plugins), "apply")
-      },
-      { [FARM_OWNED]: true }
-    )
-  );
-  return [...plugins, createFarmReactRefreshPreamblePlugin()];
-}
-__name(createFarmReactRefreshPlugins, "createFarmReactRefreshPlugins");
-
 // src/navigation/page-data-error.ts
 function resolveFarmPageDataFailure(error) {
   if (isFarmNotFoundError(error)) {
@@ -824,7 +769,7 @@ function loadFarmWorkflowsDevRuntime() {
 }
 __name(loadFarmWorkflowsDevRuntime, "loadFarmWorkflowsDevRuntime");
 function loadFarmDevtoolsSnapshotRuntime() {
-  return import("./devtools-N3QLRIQU.mjs");
+  return import("./devtools-M22FEFPK.mjs");
 }
 __name(loadFarmDevtoolsSnapshotRuntime, "loadFarmDevtoolsSnapshotRuntime");
 function loadFarmDevtoolsUIRuntime() {
@@ -1247,7 +1192,7 @@ function fileContainsProgrammaticPageRoute(file) {
 __name(fileContainsProgrammaticPageRoute, "fileContainsProgrammaticPageRoute");
 function rewriteEarlySsrRelativeImports(options) {
   const cleanId = options.id.split("?", 1)[0];
-  if (!path4.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
+  if (!path5.isAbsolute(cleanId) || cleanId.replace(/\\/g, "/").includes("/node_modules/")) {
     return null;
   }
   const replacements = [];
@@ -1267,7 +1212,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 = path4.resolve(path4.dirname(cleanId), sourcePath);
+    const resolvedPath = path5.resolve(path5.dirname(cleanId), sourcePath);
     replacements.push({
       start: source.start,
       end: source.end,
@@ -1298,7 +1243,8 @@ function transformIsolatedClientBoundaryModule(options) {
     const safeName = exportName.replace(/[^A-Za-z0-9_$]/g, "_");
     const wrapperName = `__farm_isolated_boundary_${safeName || "default"}__`;
     wrapperStatements.push(
-      `const ${wrapperName} = __farm_create_isolated_boundary__(__farm_isolated_react__, ${localName}, ${JSON.stringify(options.moduleReference)}, ${JSON.stringify(exportName)}, ${JSON.stringify(options.islandStrategy)});`
+      // Islands mode renders through islx; the older isolated hydration keeps Farm's boundary.
+      options.slots ? `const ${wrapperName} = __farm_islx_island__(${localName}, ${JSON.stringify(options.moduleReference)}, ${JSON.stringify(exportName)}, ${JSON.stringify(options.islandStrategy)});` : `const ${wrapperName} = __farm_create_isolated_boundary__(__farm_isolated_react__, ${localName}, ${JSON.stringify(options.moduleReference)}, ${JSON.stringify(exportName)}, ${JSON.stringify(options.islandStrategy)});`
     );
     wrapperStatements.push(
       isDefault ? `export default ${wrapperName};` : `export { ${wrapperName} as ${exportName} };`
@@ -1354,8 +1300,9 @@ function transformIsolatedClientBoundaryModule(options) {
   for (const replacement of replacements.sort((left, right) => right.start - left.start)) {
     output = output.slice(0, replacement.start) + replacement.code + output.slice(replacement.end);
   }
-  return `import * as __farm_isolated_react__ from "react";
-import { createFarmIsolatedClientBoundary as __farm_create_isolated_boundary__ } from "@farm.js/core/internal/isolated-boundary";
+  const runtimeImport = options.slots ? `import { createIsland as __farm_islx_island__ } from "@farm.js/core/internal/islx-react";` : `import * as __farm_isolated_react__ from "react";
+import { createFarmIsolatedClientBoundary as __farm_create_isolated_boundary__ } from "@farm.js/core/internal/isolated-boundary";`;
+  return `${runtimeImport}
 ${output}
 ${wrapperStatements.join("\n")}
 export const __farm_client_boundary_originals__ = Object.freeze({ ${originalEntries.join(", ")} });
@@ -1473,7 +1420,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         },
         server: {
           fs: {
-            ...layerRoots.length ? { allow: [path4.resolve(options.root || process.cwd()), ...layerRoots] } : {},
+            ...layerRoots.length ? { allow: [path5.resolve(options.root || process.cwd()), ...layerRoots] } : {},
             deny: getFarmDevFsDeny(userConfig.server?.fs?.deny, options)
           }
         }
@@ -1550,7 +1497,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         });
       }
       const sourceRoots = getFarmSourceRoots(farmConfig);
-      server.watcher.add(sourceRoots.map((source) => path4.join(source.root, source.srcDir)));
+      server.watcher.add(sourceRoots.map((source) => path5.join(source.root, source.srcDir)));
       if (farmConfig.i18n.enabled) {
         server.watcher.add(
           farmConfig.i18n.locales.map(
@@ -1565,7 +1512,7 @@ function farmPlugin(options = {}, initialPluginManager) {
         ...farmDocsDevRuntime?.getFarmDocsRouteTypeEntries(farmConfig.docs) ?? []
       ], "getExtraRouteTypes");
       const appDirSlugs = sourceRoots.map(
-        (source) => path4.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
+        (source) => path5.join(source.root, source.srcDir, "app").replace(/\\/g, "/")
       );
       const generateTypeArtifacts = /* @__PURE__ */ __name(async (reason, selection = ALL_TYPE_ARTIFACTS, log = false) => {
         try {
@@ -1606,7 +1553,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       }, "generateTypeArtifacts");
       await generateTypeArtifacts("startup");
       const srcDirSlugs = sourceRoots.map(
-        (source) => path4.join(source.root, source.srcDir).replace(/\\/g, "/")
+        (source) => path5.join(source.root, source.srcDir).replace(/\\/g, "/")
       );
       const layerConfigFiles = new Set(
         farmConfig.layers.map((layer) => layer.configFile?.replace(/\\/g, "/")).filter((file) => Boolean(file))
@@ -1754,7 +1701,7 @@ function farmPlugin(options = {}, initialPluginManager) {
       farmApp.getServerRenderer().setAPIRouteLookup((routePath) => apiRouteManager.getRoutes().has(routePath));
       let discoveredWorkflows = [];
       const hasWorkflowDirectory = workflowConfig.enabled && workflowConfig.dirs.some(
-        (dir) => fs2.existsSync(path4.isAbsolute(dir) ? dir : path4.join(farmConfig.root, dir))
+        (dir) => fs2.existsSync(path5.isAbsolute(dir) ? dir : path5.join(farmConfig.root, dir))
       );
       if (hasWorkflowDirectory) {
         const { createFarmWorkflowRequestHandler, discoverFarmWorkflows } = await loadFarmWorkflowsDevRuntime();
@@ -1859,7 +1806,7 @@ function farmPlugin(options = {}, initialPluginManager) {
           if (specifier === farmConfig.docs.adapter?.server && resolved?.id) {
             return import(
               /* @vite-ignore */
-              pathToFileURL2(resolved.id).href
+              pathToFileURL(resolved.id).href
             );
           }
           return loadFarmDevModule(server, resolved?.id ?? specifier);
@@ -2233,14 +2180,10 @@ window.__FARM_MANIFEST__ = ${inlineValue({
           if (options.agent?.manifest !== false && isFarmAppManifestPath(stripFarmBasePath(requestPathname, farmConfig.basePath))) {
             await serveBuiltInRoute(async () => {
               farmAppPackages ?? (farmAppPackages = resolveFarmAppPackages(farmConfig.root ?? process.cwd()));
-              const header = /* @__PURE__ */ __name((name) => String(req.headers[name] ?? ""), "header");
               const manifest = await createFarmAppManifestResponse(
                 new Request(parsedRequestUrl, {
                   method: requestMethod,
-                  headers: {
-                    "if-none-match": header("if-none-match"),
-                    [FARM_INFRA_SIGNATURE_HEADER]: header(FARM_INFRA_SIGNATURE_HEADER)
-                  }
+                  headers: { "if-none-match": String(req.headers["if-none-match"] ?? "") }
                 }),
                 {
                   ...resolveFarmAppManifestInput(farmConfig, {
@@ -2251,12 +2194,12 @@ window.__FARM_MANIFEST__ = ${inlineValue({
                   }),
                   defaultMCP: /* @__PURE__ */ __name(() => farmApp.getServerRenderer().getDefaultMCPServer(), "defaultMCP"),
                   // A guard written for an MCP server's path keeps its tools out of the public view.
-                  guardCoversPath: /* @__PURE__ */ __name((path5) => farmPathGuardCoversEndpoint(
+                  guardCoversPath: /* @__PURE__ */ __name((path6) => farmPathGuardCoversEndpoint(
                     {
                       config: farmConfig,
                       middlewareRoutes: middlewareManager.getMiddlewares().filter((entry) => entry.source !== "config")
                     },
-                    path5,
+                    path6,
                     apiServerBasePath
                   ), "guardCoversPath")
                 }
@@ -3334,7 +3277,7 @@ window.__FARM_MANIFEST__ = ${inlineValue({
         const isolatedHydrationMode = resolveFarmIsolatedClientHydrationMode(
           resolvedConfig?.experimental?.isolatedClientHydration,
           {
-            serverComponents: resolvedConfig?.experimental?.serverComponents === true,
+            serverComponents: resolveFarmServerComponentsMode(resolvedConfig?.experimental?.serverComponents) === "rsc",
             hasUnsupportedIntegrationProvider: integrationProviders.filter((provider) => provider.component || provider.type === "clerk").some((provider) => provider.supportsIsolatedHydration !== true)
           }
         );
@@ -3359,7 +3302,8 @@ ${generatedDevIndicatorsClientRuntime}`,
           generateClientCachePersistenceCode(
             resolveFarmClientCacheAdapterEntry(root, resolvedConfig?.cache)
           ),
-          isReactRenderer(renderer) ? getFarmDocsAdapterConfigModule(docs) : void 0
+          isReactRenderer(renderer) ? getFarmDocsAdapterConfigModule(docs) : void 0,
+          resolveFarmServerComponentsMode(resolvedConfig?.experimental?.serverComponents) === "islands"
         );
       }
       if (id === "/@farm/server") {
@@ -3435,6 +3379,19 @@ export const manifest = getManifest();
       }
     },
     async transform(code, id, transformOptions) {
+      const actionConfig = farmApp?.getConfig() ?? options;
+      if (resolveFarmServerComponentsMode(actionConfig.experimental?.serverComponents) === "islands" && code.includes("use server") && !id.includes("/node_modules/") && /\.[cm]?[jt]sx?(?:$|\?)/.test(id)) {
+        const file = id.split("?", 1)[0];
+        const actionModule = transformFarmFormActionModule({
+          code,
+          id,
+          root: actionConfig.root || server?.config.root || process.cwd(),
+          ssr: transformOptions?.ssr === true,
+          // Parsed by file type: page components are TSX.
+          parse: /* @__PURE__ */ __name((source) => parseSync(file, source).program, "parse")
+        });
+        if (actionModule) return { code: actionModule, map: null };
+      }
       if (!transformOptions?.ssr) {
         const docsConfigModule = getFarmDocsAdapterConfigModule(farmApp?.getConfig()?.docs);
         if (isFarmDocsClientConfigModule(id, docsConfigModule)) {
@@ -3498,14 +3455,15 @@ export const manifest = getManifest();
         const root = currentConfig.root || server?.config.root || process.cwd();
         const cleanId = id.split("?", 1)[0];
         const selectedIsolatedModules = options.isolatedClientBoundaryModules ?? farmApp?.getRouteManager().getIsolatedClientBoundaryModules(root);
-        const selectedForIsolatedHydration = selectedIsolatedModules?.has(path4.resolve(cleanId)) === true;
+        const selectedForIsolatedHydration = selectedIsolatedModules?.has(path5.resolve(cleanId)) === true;
         if (isReactRenderer(resolveFarmRenderer(currentConfig.renderer)) && selectedForIsolatedHydration && isIsolatableClientBoundarySource(clientBoundarySource)) {
           isolatedModuleReference = toViteModuleId(cleanId, root);
           const transformedBoundary = transformIsolatedClientBoundaryModule({
             code: transformedCode,
             moduleReference: isolatedModuleReference,
             islandStrategy: getIslandStrategyExport(clientBoundarySource) ?? "load",
-            parse: /* @__PURE__ */ __name((source) => this.parse(source), "parse")
+            parse: /* @__PURE__ */ __name((source) => this.parse(source), "parse"),
+            slots: resolveFarmServerComponentsMode(currentConfig.experimental?.serverComponents) === "islands"
           });
           if (!transformedBoundary) {
             this.error(
@@ -3590,8 +3548,8 @@ if (import.meta.hot) {
         }
         logger.info(`Found ${ssgPages.length} SSG pages, ${ssrRoutes.length} SSR routes`);
         logger.info("Pre-rendering SSG pages...");
-        const outDir = path4.join(server?.config.root || process.cwd(), options.outDir || "dist");
-        const clientDir = path4.join(outDir, "client");
+        const outDir = path5.join(server?.config.root || process.cwd(), options.outDir || "dist");
+        const clientDir = path5.join(outDir, "client");
         for (const page of ssgPages) {
           try {
             const staticRequest = new Request(new URL(page.urlPath, "http://farm.static"));
@@ -3643,8 +3601,8 @@ if (import.meta.hot) {
   <script type="module" src="/assets/client.js"></script>
 </body>
 </html>`;
-              const outputPath = page.urlPath === "/" ? path4.join(clientDir, "index.html") : path4.join(clientDir, page.urlPath + ".html");
-              fs2.mkdirSync(path4.dirname(outputPath), { recursive: true });
+              const outputPath = page.urlPath === "/" ? path5.join(clientDir, "index.html") : path5.join(clientDir, page.urlPath + ".html");
+              fs2.mkdirSync(path5.dirname(outputPath), { recursive: true });
               fs2.writeFileSync(outputPath, fullHtml);
               const revalidateInfo = page.revalidate ? ` (revalidate: ${page.revalidate}s)` : "";
               logger.success(`  \u2713 ${page.urlPath}${revalidateInfo}`);
@@ -3653,7 +3611,7 @@ if (import.meta.hot) {
             logger.error(`  \u2717 ${page.urlPath}: ${error}`);
           }
         }
-        const manifestPath = path4.join(outDir, "__ssg_manifest.json");
+        const manifestPath = path5.join(outDir, "__ssg_manifest.json");
         fs2.writeFileSync(
           manifestPath,
           JSON.stringify(
@@ -3697,9 +3655,9 @@ if (import.meta.hot) {
         server2.ws.send({ type: "full-reload", path: "*" });
         return [];
       }
-      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path4.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
+      const currentSrcRoot = currentFarmConfig ? getFarmSourceRoots(currentFarmConfig).map((source) => path5.join(source.root, source.srcDir).replace(/\\/g, "/")).find((sourceRoot) => normalizedFile.startsWith(`${sourceRoot}/`)) || null : null;
       if (currentSrcRoot && normalizedFile.startsWith(`${currentSrcRoot}/`) && isProgrammaticRoutesFileName(normalizedFile)) {
-        logUpdate("PAGE", `updated ${path4.basename(file)}`);
+        logUpdate("PAGE", `updated ${path5.basename(file)}`);
         for (const mod of modules) {
           server2.moduleGraph.invalidateModule(mod);
         }
@@ -3833,10 +3791,10 @@ function createPageDataMiddlewareRequest(req, target) {
 __name(createPageDataMiddlewareRequest, "createPageDataMiddlewareRequest");
 function resolveDevelopmentRoot(farmRoot, viteRoot) {
   if (!farmRoot) return viteRoot;
-  if (path4.resolve(farmRoot) === path4.resolve(viteRoot)) return farmRoot;
+  if (path5.resolve(farmRoot) === path5.resolve(viteRoot)) return farmRoot;
   try {
     if (fs2.realpathSync(farmRoot) === fs2.realpathSync(viteRoot)) {
-      return path4.resolve(viteRoot);
+      return path5.resolve(viteRoot);
     }
   } catch {
   }
@@ -4224,7 +4182,7 @@ function parseRouteModuleSchema(schema, value, label, routePath) {
   }
 }
 __name(parseRouteModuleSchema, "parseRouteModuleSchema");
-function generateClientCode(integrationProviders = [], documentNavigationMatchers = [], docsSearchClientRuntime = EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, devtoolsClientRuntime = "", plugins = [], root = process.cwd(), srcDir = "src", publicRuntimeConfig = void 0, docsAdapterReact, renderer = REACT_RENDERER, isolatedHydrationEnabled = false, trailingSlash = false, basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule) {
+function generateClientCode(integrationProviders = [], documentNavigationMatchers = [], docsSearchClientRuntime = EMPTY_FARM_DOCS_SEARCH_CLIENT_RUNTIME, devtoolsClientRuntime = "", plugins = [], root = process.cwd(), srcDir = "src", publicRuntimeConfig = void 0, docsAdapterReact, renderer = REACT_RENDERER, isolatedHydrationEnabled = false, trailingSlash = false, basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule, islandValues = false) {
   const providerClientCode = generateFarmIntegrationProviderClientCode(
     integrationProviders,
     root,
@@ -4241,8 +4199,7 @@ function generateClientCode(integrationProviders = [], documentNavigationMatcher
 import { hydrateRoot, createRoot } from 'react-dom/client'` : appSetupPath ? `import React, { hydrateRoot, createRoot, configureApp as __farmConfigureApp } from ${JSON.stringify(renderer.client)}
 import __farmAppSetup from ${JSON.stringify(toViteModuleId(appSetupPath, root))}
 __farmConfigureApp(__farmAppSetup)` : `import React, { hydrateRoot, createRoot } from ${JSON.stringify(renderer.client)}`;
-  const isolatedHydrationImport = isolatedHydrationEnabled ? `import { createFarmIsolatedHydrationRuntime, createFarmServerPageBoundary, wrapFarmIsolatedClientGraph } from '@farm.js/core/internal/isolated-boundary'
-import { createFarmServerTreeElement } from '@farm.js/core/internal/server-tree'` : "";
+  const isolatedHydrationImport = isolatedHydrationEnabled ? `${islandValues ? "import { createFarmIsolatedHydrationRuntime, createFarmServerPageBoundary, wrapFarmIsolatedClientGraph, createFarmServerTreeElement } from '@farm.js/core/internal/islands-runtime'" : "import { createFarmIsolatedHydrationRuntime, createFarmServerPageBoundary, wrapFarmIsolatedClientGraph } from '@farm.js/core/internal/isolated-boundary'\nimport { createFarmServerTreeElement } from '@farm.js/core/internal/server-tree'"}` : "";
   const docsAdapterImportBlock = generateFarmDocsAdapterClientRuntime(
     docsAdapterReact,
     docsConfigModule
@@ -4250,7 +4207,7 @@ import { createFarmServerTreeElement } from '@farm.js/core/internal/server-tree'
   const isolatedHydrationRuntime = isolatedHydrationEnabled ? `const farmIsolatedHydrationRuntime = createFarmIsolatedHydrationRuntime({
   ReactRuntime: React,
   hydrateRoot,
-  load: (reference) => import(/* @vite-ignore */ reference),
+  load: (reference) => import(/* @vite-ignore */ farmModuleUrl(reference)),
   schedule: scheduleFarmIslandHydration,
   wrap: wrapWithIntegrationProviders,
 });
@@ -4270,7 +4227,7 @@ async function hydrateFarmIsolatedClientBoundaries(scope = document, signal) {
 async function createFarmServerTreePageElement(source, pathname) {
   try {
     return await createFarmServerTreeElement(React, source, {
-      load: (reference) => import(/* @vite-ignore */ reference),
+      load: (reference) => import(/* @vite-ignore */ farmModuleUrl(reference)),
       ServerHtml: FarmServerPage,
       key: pathname,
     });
@@ -4294,6 +4251,18 @@ import {
 } from '@farm.js/core/deployment'
 ${providerClientCode.imports}
 ${clientPluginEntry.imports}
+
+// Vite appends ?import to a dynamic import of a variable, and the browser keys that URL as a second
+// copy of a module other modules import statically: two React contexts, two stores. Vite leaves an
+// absolute URL alone. Other files (Markdown pages) need ?import to be served as JavaScript.
+function farmModuleUrl(reference) {
+  return typeof reference === "string" &&
+    reference[0] === "/" &&
+    reference[1] !== "/" &&
+    /\\.(?:[cm]?[jt]sx?|vue|svelte)(?:$|\\?)/.test(reference)
+    ? new URL(reference, location.origin).href
+    : reference;
+}
 ${clientCachePersistence.imports}
 ${docsSearchClientRuntime}
 ${devtoolsClientRuntime}
@@ -4577,7 +4546,7 @@ class LegacyManifestSPARouter {
     this.prefetchingUrls.add(pathname);
     try {
       // Prefetch by importing the module (Vite caches it)
-      const module = await import(/* @vite-ignore */ modulePath);
+      const module = await import(/* @vite-ignore */ farmModuleUrl(modulePath));
       this.moduleCache.set(modulePath, module);
       pageModuleCache.set(modulePath, module);
     } catch (error) {
@@ -4825,7 +4794,7 @@ async function renderRouteSlot(slot, mode = 'render') {
 
   let slotModule = pageModuleCache.get(slot.modulePath);
   if (!slotModule) {
-    slotModule = await import(/* @vite-ignore */ slot.modulePath);
+    slotModule = await import(/* @vite-ignore */ farmModuleUrl(slot.modulePath));
     pageModuleCache.set(slot.modulePath, slotModule);
   }
   const SlotComponent = slotModule?.default;
@@ -4990,7 +4959,7 @@ async function buildClientHydrationElement(
 
   if (loadingModulePath) {
     try {
-      const loadingModule = await import(/* @vite-ignore */ loadingModulePath);
+      const loadingModule = await import(/* @vite-ignore */ farmModuleUrl(loadingModulePath));
       const LoadingComponent = loadingModule?.default;
       if (LoadingComponent) {
         const loadingFallback = React.createElement(LoadingComponent, {
@@ -5018,7 +4987,7 @@ async function loadLayoutComponents(layouts = []) {
     try {
       let LayoutComponent = layoutComponentCache.get(layout.modulePath);
       if (!LayoutComponent) {
-        const layoutModule = await import(/* @vite-ignore */ layout.modulePath);
+        const layoutModule = await import(/* @vite-ignore */ farmModuleUrl(layout.modulePath));
         LayoutComponent = layoutModule.default;
         if (LayoutComponent) {
           layoutComponentCache.set(layout.modulePath, LayoutComponent);
@@ -5180,7 +5149,7 @@ async function tryHydrateImportedPage(
   if (pageShouldHydrate) {
     let pageModule = pageModuleCache.get(modulePath);
     if (!pageModule) {
-      pageModule = await import(/* @vite-ignore */ modulePath);
+      pageModule = await import(/* @vite-ignore */ farmModuleUrl(modulePath));
       pageModuleCache.set(modulePath, pageModule);
     }
     if (signal?.aborted || !container?.isConnected) return false;
@@ -5339,7 +5308,7 @@ function parseNavigationFragment(html) {
   return template.content;
 }
 
-function replaceNavigationBoundary(container, fragment, currentPatterns, nextPatterns) {
+function replaceNavigationBoundary(container, fragment, currentPatterns, nextPatterns, refresh = false) {
   let sharedCount = 0;
   while (
     sharedCount < currentPatterns.length &&
@@ -5366,7 +5335,9 @@ function replaceNavigationBoundary(container, fragment, currentPatterns, nextPat
     return container;
   }
 
-  ${isolatedHydrationEnabled ? "disposeFarmIsolatedClientBoundaries(currentTarget);" : ""}
+  ${isolatedHydrationEnabled ? `${islandValues ? `// A refresh keeps the islands still on the page, with their state and new props.
+  if (refresh) farmIsolatedHydrationRuntime.carryOver(currentTarget, nextTarget);
+  ` : ""}disposeFarmIsolatedClientBoundaries(currentTarget);` : ""}
   currentTarget.replaceWith(nextTarget);
   activateFragmentScripts(nextTarget);
   if (fragmentTreeRoot && fragmentTreeRoot !== nextTarget) fragmentTreeRoot.remove();
@@ -5390,7 +5361,7 @@ let activeLayoutShouldHydrate = window.__FARM_LAYOUT_SHOULD_HYDRATE__ === true;
 
 // ====== MANIFEST-DRIVEN HTML-FRAGMENT NAVIGATION ======
 // One page-data response carries both server HTML and the hydration plan.
-async function renderPage(pageData) {
+async function renderPage(pageData, info) {
   const container = document.getElementById('root');
   if (!container) return;
   cancelPendingPageHydration();
@@ -5483,7 +5454,7 @@ async function renderPage(pageData) {
     const pageShouldHydrate = route.pageShouldHydrate || route.isClientComponent;
     const layoutShouldHydrate = route.layoutShouldHydrate;
     ${isolatedHydrationEnabled ? `const hasIsolatedClientBoundaries = Boolean(
-      fragment.querySelector('farm-client-boundary[data-farm-client-boundary]'),
+      fragment.querySelector('f-island[src]'),
     );
     const shouldHydrate =
       pageShouldHydrate || layoutShouldHydrate || (route.shouldHydrate && !hasIsolatedClientBoundaries);` : "const shouldHydrate = route.shouldHydrate || pageShouldHydrate || layoutShouldHydrate;"}
@@ -5519,7 +5490,7 @@ async function renderPage(pageData) {
         if (appRoot) { try { appRoot.unmount(); } catch (error) {} appRoot = null; }
         if (reactRoot) { try { reactRoot.unmount(); } catch (error) {} reactRoot = null; }
         delete window.__FARM_REACT_ROOT__;
-        ${isolatedHydrationEnabled ? "isolatedHydrationScope = replaceNavigationBoundary(container, fragment, activeLayoutPatterns, layoutPatterns) || container;" : "replaceNavigationBoundary(container, fragment, activeLayoutPatterns, layoutPatterns);"}
+        ${isolatedHydrationEnabled ? "isolatedHydrationScope = replaceNavigationBoundary(container, fragment, activeLayoutPatterns, layoutPatterns, info?.refresh === true) || container;" : "replaceNavigationBoundary(container, fragment, activeLayoutPatterns, layoutPatterns);"}
       }
 
       const hydrationController = new AbortController();
@@ -5616,7 +5587,7 @@ async function hydrate() {
     const modulePath = window.__FARM_PAGE_MODULE__;
     ${isolatedHydrationEnabled ? `const hasIsolatedClientBoundaries =
       window.__FARM_HAS_ISOLATED_CLIENT_BOUNDARIES__ === true ||
-      Boolean(rootContainer.querySelector('farm-client-boundary[data-farm-client-boundary]'));` : ""}
+      Boolean(rootContainer.querySelector('f-island[src]'));` : ""}
 
     let pageProps = normalizeServerProps(window.__FARM_PROPS__);
     applyCanonicalPathFromProps(pageProps);
@@ -5863,7 +5834,7 @@ function generateClientManifest(bundle) {
 __name(generateClientManifest, "generateClientManifest");
 async function defineConfig(config = {}) {
   const tailwindVitePlugin = await loadTailwindVitePlugin();
-  const appRoot = path4.resolve(config.root || process.cwd());
+  const appRoot = path5.resolve(config.root || process.cwd());
   if (config.extends?.length) {
     const { config: layeredConfig } = await import("./layers-UTB43B7A.mjs").then(
       ({ resolveFarmLayers }) => resolveFarmLayers(config, {
@@ -6084,7 +6055,6 @@ __name(defineConfig, "defineConfig");
 
 export {
   farmImageImportsPlugin,
-  createFarmReactRefreshPlugins,
   farmI18nClientBridgePlugin,
   farmServerOnlyEntriesPlugin,
   withFarmRequestTracing,