@farm.js/core 0.1.42 → 0.1.44

package/dist/{chunk-QTEJGB5A.mjs → chunk-QGFKXYC7.mjs}

@@ -2,12 +2,13 @@ import {
   collectSSGPages,
   matchSSGPage,
   resolveRouteRenderingConfigFromFile
-} from "./chunk-35WS7P2V.mjs";
+} from "./chunk-26CXZR6L.mjs";
 import {
   classifyFarmDocumentPrefix,
   composeFarmFullDocument,
   createDefaultErrorMarkup,
   createFarmMetadataRouteResponse,
+  createFarmRouteRenderPlan,
   createFarmThemeDocumentParts,
   createLateNotFoundRecovery,
   createLateRedirectRecovery,
@@ -24,7 +25,7 @@ import {
   renderFarmLocaleAlternateLinks,
   resolveDefaultErrorStatus,
   routeBoundaryCoversDirectory
-} from "./chunk-PIZXONIS.mjs";
+} from "./chunk-YFLBG2W3.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   collectFarmDefaultMCPPages,
@@ -33,9 +34,15 @@ import {
   isFarmDefaultMCPPathname,
   resolveFarmDefaultMCPServer
 } from "./chunk-4ZZNPK25.mjs";
+import {
+  handleFarmFormActionRequest
+} from "./chunk-XUGFRFD2.mjs";
 import {
   createFarmMetadataImageResponse
 } from "./chunk-OJ7JP7RJ.mjs";
+import {
+  installFarmIslandValues
+} from "./chunk-D5RFPV2H.mjs";
 import {
   FARM_ISLAND_REPLAYABLE_SELECTOR,
   isFarmIslandStrategy
@@ -55,14 +62,15 @@ import {
 import {
   getFarmProjectSourceDir,
   resolveFarmAuthConfig,
-  resolveFarmDevIndicatorsConfig
-} from "./chunk-HCSVR4YZ.mjs";
-import {
-  normalizeRouteRules
-} from "./chunk-GHFS7RUB.mjs";
+  resolveFarmDevIndicatorsConfig,
+  resolveFarmServerComponentsMode
+} from "./chunk-M3BXTWJM.mjs";
 import {
   resolveFarmDevtoolsConfig
 } from "./chunk-JBSVKMC5.mjs";
+import {
+  normalizeRouteRules
+} from "./chunk-GHFS7RUB.mjs";
 import {
   assertFarmRendererStreamingRuntime,
   getFarmRendererCapabilities,
@@ -147,7 +155,7 @@ import {
   getIntegrationProviders,
   getRegisteredIntegrationAPIManifest,
   isFarmIntegrationProviderComponentReference
-} from "./chunk-AX7S67YV.mjs";
+} from "./chunk-37VKVISD.mjs";
 import {
   createRouteSlotContainerId,
   parseRouteSlotFile
@@ -170,7 +178,6 @@ import {
 } from "./chunk-NPC7VWJE.mjs";
 import {
   formatOptionalPeerInstallHint,
-  isMissingPackageError,
   isOptionalPeerInstalled
 } from "./chunk-YOZYCI6Z.mjs";
 import {
@@ -237,7 +244,7 @@ import {
 } from "./chunk-P7XDC7UJ.mjs";
 import {
   FARM_VERSION
-} from "./chunk-U2UC7UGP.mjs";
+} from "./chunk-R4J2UOV4.mjs";
 import {
   resolveFarmTrailingSlashRedirect,
   setFarmTrailingSlashPreference
@@ -731,7 +738,7 @@ function getClientModuleHydrationPlan(modulePath, root, mode = "off", options =
     ...costGuardExceeded ? { costGuardExceeded: true } : {},
     ...fallbackReason ? { fallbackReason } : {}
   }), "emptyPlan");
-  const asyncOwner = metadata.suppressedAsyncHydration === true && options.asyncOwnerIslands === true;
+  const asyncOwner = (metadata.suppressedAsyncHydration === true || options.serverOwners === true) && options.asyncOwnerIslands === true;
   if (mode === "off" && !asyncOwner) return emptyPlan();
   const resolvedPath = resolveOwnerSourcePath(resolveModuleSourcePath(modulePath, root), root);
   const content = readIfExists(resolvedPath ?? "");
@@ -1745,56 +1752,6 @@ function resolveSourceCandidate(candidates) {
 }
 __name(resolveSourceCandidate, "resolveSourceCandidate");
 
-// src/navigation/render-plan.ts
-function createFarmRouteRenderPlan(input = {}) {
-  const pageShouldHydrate = input.pageShouldHydrate === true;
-  const layoutShouldHydrate = input.layoutShouldHydrate === true;
-  const hydration = pageShouldHydrate ? layoutShouldHydrate ? "route-and-layout-islands" : "route-island" : layoutShouldHydrate ? "layout-island" : "none";
-  const rendering = input.rendering;
-  const cache2 = rendering?.ssg ? typeof rendering.revalidate === "number" && rendering.revalidate > 0 ? { mode: "revalidate", revalidate: rendering.revalidate } : { mode: "static" } : { mode: "dynamic" };
-  return {
-    version: 1,
-    output: "html",
-    navigation: "html-fragment",
-    hydration,
-    islandStrategy: hydration === "none" ? null : input.islandStrategy ?? "load",
-    cache: cache2
-  };
-}
-__name(createFarmRouteRenderPlan, "createFarmRouteRenderPlan");
-function getFarmFragmentCacheControl(plan) {
-  if (plan.cache.mode === "static") {
-    return "public, max-age=0, s-maxage=31536000, immutable";
-  }
-  if (plan.cache.mode === "revalidate") {
-    const seconds = Math.max(1, plan.cache.revalidate ?? 1);
-    return `public, max-age=0, s-maxage=${seconds}, stale-while-revalidate=${seconds}`;
-  }
-  return "private, max-age=0";
-}
-__name(getFarmFragmentCacheControl, "getFarmFragmentCacheControl");
-function parseFarmLayoutChainHeader(value) {
-  if (!value || value.length > 8192) return [];
-  try {
-    const parsed = JSON.parse(value);
-    if (!Array.isArray(parsed) || parsed.length > 64) return [];
-    return parsed.filter(
-      (pattern) => typeof pattern === "string" && pattern.startsWith("/") && pattern.length <= 512
-    );
-  } catch {
-    return [];
-  }
-}
-__name(parseFarmLayoutChainHeader, "parseFarmLayoutChainHeader");
-function getSharedLayoutPrefixLength(current, next) {
-  let index = 0;
-  while (index < current.length && index < next.length && current[index] === next[index]) {
-    index++;
-  }
-  return index;
-}
-__name(getSharedLayoutPrefixLength, "getSharedLayoutPrefixLength");
-
 // src/routing/route-manager.ts
 import { realpathSync } from "fs";
 import path3 from "path";
@@ -2204,7 +2161,7 @@ var _RouteManager = class _RouteManager {
     const unsupportedIntegrationProvider = integrationProviders.find(
       (provider) => provider.supportsIsolatedHydration !== true
     );
-    if (this.config.experimental?.isolatedClientHydration === "enabled" && this.config.experimental?.serverComponents !== true && unsupportedIntegrationProvider) {
+    if (this.config.experimental?.isolatedClientHydration === "enabled" && resolveFarmServerComponentsMode(this.config.experimental?.serverComponents) !== "rsc" && unsupportedIntegrationProvider) {
       logger.warn(
         `[Farm.js] isolated hydration kept route-wide because integration provider "${unsupportedIntegrationProvider.name}" does not declare supportsIsolatedHydration: true.`
       );
@@ -2212,7 +2169,7 @@ var _RouteManager = class _RouteManager {
     const isolatedMode = resolveFarmIsolatedClientHydrationMode(
       this.config.experimental?.isolatedClientHydration,
       {
-        serverComponents: this.config.experimental?.serverComponents === true,
+        serverComponents: resolveFarmServerComponentsMode(this.config.experimental?.serverComponents) === "rsc",
         hasUnsupportedIntegrationProvider: Boolean(unsupportedIntegrationProvider)
       }
     );
@@ -2237,12 +2194,10 @@ var _RouteManager = class _RouteManager {
     );
     const routeEntries = Array.from(this.routes.values()).map((entry) => ({
       entry,
-      metadata: isFarmMarkdownPageFile(entry.modulePath) ? markdownPagePlan() : getClientModuleHydrationPlan(
-        entry.modulePath,
-        normalizedProjectRoot,
-        isolatedMode,
-        planOptions
-      )
+      metadata: isFarmMarkdownPageFile(entry.modulePath) ? markdownPagePlan() : getClientModuleHydrationPlan(entry.modulePath, normalizedProjectRoot, isolatedMode, {
+        ...planOptions,
+        serverOwners: resolveFarmServerComponentsMode(this.config.experimental?.serverComponents) === "islands"
+      })
     }));
     const markdownFallback = routeEntries.find(
       ({ entry, metadata }) => isFarmMarkdownPageFile(entry.modulePath) && metadata.fallbackReason
@@ -4530,6 +4485,8 @@ function createDefaultErrorDiagnostics(error, root) {
 __name(createDefaultErrorDiagnostics, "createDefaultErrorDiagnostics");
 
 // src/server/renderer.ts
+installFarmIslandValues();
+var islands;
 var cachedClerkProvider = null;
 var importRuntimeModule = new Function("specifier", "return import(specifier);");
 function shouldServePrerenderedPage(nodeEnv, method) {
@@ -4789,6 +4746,10 @@ var _ServerRenderer = class _ServerRenderer {
   }
   async initialize() {
     if (this.rendererRuntime) return;
+    if (this.islandValues()) {
+      (await import("./internal/islands-server.mjs")).installFarmIslandsServer();
+      islands ?? (islands = await import("./internal/islands-runtime.mjs"));
+    }
     if (this.config.notFound?.component?.trim()) {
       resolveFarmNotFoundComponentPath(this.config, getFarmAppDirectories(this.config));
     }
@@ -4899,8 +4860,20 @@ var _ServerRenderer = class _ServerRenderer {
     if (!this.rendererRuntime.wrapClientGraph || typeof getIsolatedClientBoundaryModules !== "function" || getIsolatedClientBoundaryModules.call(this.routeManager, this.config.root).size === 0) {
       return element;
     }
+    if (islands && this.islandValues())
+      return islands.wrapFarmIsolatedClientGraph(void 0, element);
     return this.rendererRuntime.wrapClientGraph(element);
   }
+  /** The page a hydrating layout keeps as server HTML: islands again, or a server tree. */
+  async isolateServerPage(element, serverTree) {
+    if (islands && this.islandValues()) {
+      const runtime = islands;
+      return serverTree ? runtime.renderFarmServerTreePage(void 0, element, {
+        isolate: /* @__PURE__ */ __name((node) => runtime.isolateFarmServerPageGraph(void 0, node), "isolate")
+      }) : runtime.isolateFarmServerPageGraph(void 0, element);
+    }
+    return serverTree && this.rendererRuntime.renderServerTreePage ? this.rendererRuntime.renderServerTreePage(element, { values: false }) : this.rendererRuntime.isolateServerPageGraph(element);
+  }
   async renderElementToCompleteHTML(element, options = {}) {
     const streaming = getFarmRendererStreamingCapabilitiesForRuntime(this.config.renderer, "node");
     const renderToPipeableStream = streaming.node ? this.rendererRuntime.renderToPipeableStream : void 0;
@@ -4961,6 +4934,10 @@ var _ServerRenderer = class _ServerRenderer {
     }
     return { html: await this.renderElementToCompleteHTML(element, options), head: "" };
   }
+  /** Islands mode sends large prop values once, keyed by content (RFC 0003). */
+  islandValues() {
+    return resolveFarmServerComponentsMode(this.config.experimental?.serverComponents) === "islands";
+  }
   /**
    * Render the route tree used by client navigation without producing a second
    * document response. Layout markers let the browser preserve the longest
@@ -4987,7 +4964,7 @@ var _ServerRenderer = class _ServerRenderer {
     if (input.pageShouldHydrate && !input.layoutShouldHydrate) {
       element = this.wrapClientGraph(element);
     } else if (input.layoutShouldHydrate && !input.pageShouldHydrate && this.rendererRuntime.isolateServerPageGraph) {
-      element = input.serverTree && this.rendererRuntime.renderServerTreePage ? await this.rendererRuntime.renderServerTreePage(element) : this.rendererRuntime.isolateServerPageGraph(element);
+      element = await this.isolateServerPage(element, input.serverTree === true);
     }
     element = this.createPageBoundary(element, {
       pageShouldHydrate: input.pageShouldHydrate,
@@ -5434,6 +5411,25 @@ var _ServerRenderer = class _ServerRenderer {
         route: route.pattern,
         params
       });
+      let actionRequest;
+      if (req.method === "POST" && resolveFarmServerComponentsMode(this.config.experimental?.serverComponents) === "islands") {
+        await Promise.all([
+          this.routeManager.loadRouteModule(route.modulePath),
+          ...layouts.map((layout) => this.routeManager.loadLayoutModule(layout.modulePath))
+        ]);
+        actionRequest = createWebRequestFromFarmRequest(req, {
+          trustProxy: this.config.server?.trustProxy
+        });
+        const actionResponse = await handleFarmFormActionRequest(
+          actionRequest,
+          resolveServerActionsConfig(this.config.serverActions)
+        );
+        if (actionResponse) {
+          await sendWebResponse(res, actionResponse);
+          completeRender(actionResponse.status, route.pattern);
+          return;
+        }
+      }
       const loadingBoundaryEntry = this.routeManager.getMatchingLoading(pathname, route);
       errorBoundaryEntry = this.routeManager.getMatchingError(pathname, route);
       middlewareMap = toMiddlewareMap(req.__FARM_MIDDLEWARE_DATA__);
@@ -5441,7 +5437,7 @@ var _ServerRenderer = class _ServerRenderer {
       pluginExposedContext = getRequestContextSnapshot(req, {
         exposedOnly: true
       });
-      const currentRequest = createWebRequestFromFarmRequest(req, {
+      const currentRequest = actionRequest ?? createWebRequestFromFarmRequest(req, {
         trustProxy: this.config.server?.trustProxy
       });
       const routeContext = await this.resolveRouteContext({
@@ -5762,7 +5758,10 @@ var _ServerRenderer = class _ServerRenderer {
             if ((isClientComponent || shouldHydrate) && !shouldHydrateLayout) {
               pageElement = this.wrapClientGraph(pageElement);
             } else if (shouldHydrateLayout && !(isClientComponent || shouldHydrate) && this.rendererRuntime.isolateServerPageGraph) {
-              pageElement = routeManifestEntry?.serverTree === true && this.rendererRuntime.renderServerTreePage ? await this.rendererRuntime.renderServerTreePage(pageElement) : this.rendererRuntime.isolateServerPageGraph(pageElement);
+              pageElement = await this.isolateServerPage(
+                pageElement,
+                routeManifestEntry?.serverTree === true
+              );
             }
             pageElement = this.createPageBoundary(pageElement, {
               pageShouldHydrate: isClientComponent || shouldHydrate,
@@ -8366,103 +8365,8 @@ function farmDocsClientConfigPlugin(configModule) {
 }
 __name(farmDocsClientConfigPlugin, "farmDocsClientConfigPlugin");
 
-// src/build/tailwind.ts
-import path16 from "path";
-
-// src/build/vite-plugin-compat.ts
-function adaptTailwindVitePlugin(pluginOption, builder) {
-  if (builder !== "rolldown") return pluginOption;
-  return adaptPluginOption(pluginOption);
-}
-__name(adaptTailwindVitePlugin, "adaptTailwindVitePlugin");
-function adaptPluginOption(pluginOption) {
-  if (Array.isArray(pluginOption)) return pluginOption.map(adaptPluginOption);
-  if (!pluginOption || typeof pluginOption !== "object") return pluginOption;
-  const plugin = pluginOption;
-  if (!plugin.name?.startsWith("@tailwindcss/vite:generate:")) return pluginOption;
-  if (isVitePluginHook(plugin.transform)) {
-    return {
-      ...plugin,
-      transform: withVite5TransformContext(plugin.transform)
-    };
-  }
-  if (plugin.transform && typeof plugin.transform === "object" && "handler" in plugin.transform && isVitePluginHook(plugin.transform.handler)) {
-    return {
-      ...plugin,
-      transform: {
-        ...plugin.transform,
-        handler: withVite5TransformContext(plugin.transform.handler)
-      }
-    };
-  }
-  return pluginOption;
-}
-__name(adaptPluginOption, "adaptPluginOption");
-function isVitePluginHook(value) {
-  return typeof value === "function";
-}
-__name(isVitePluginHook, "isVitePluginHook");
-function withVite5TransformContext(handler) {
-  return function(...args) {
-    const context = new Proxy(this, {
-      get(target, property2, receiver) {
-        if (property2 === "environment") return void 0;
-        return Reflect.get(target, property2, receiver);
-      }
-    });
-    return handler.apply(context, args);
-  };
-}
-__name(withVite5TransformContext, "withVite5TransformContext");
-
-// src/build/tailwind.ts
-var TAILWIND_CSS_IMPORT = /@import\s+["']tailwindcss["']/;
-var TAILWIND_VITE_INSTALL_HINT = formatOptionalPeerInstallHint(
-  "@tailwindcss/vite",
-  "enable built-in Tailwind CSS support",
-  { dev: true }
-);
-var warnedMissingTailwind = false;
-async function loadTailwindVitePlugin(options = {}, importTailwind = () => import("@tailwindcss/vite")) {
-  try {
-    const tailwindVite = (await importTailwind()).default;
-    const plugin = options.builder ? adaptTailwindVitePlugin(tailwindVite(), options.builder) : tailwindVite();
-    if (options.announce) logger.info("\u{1F4E6} Enabled built-in Tailwind support (@tailwindcss/vite)");
-    return plugin;
-  } catch (error) {
-    if (isMissingPackageError(error, "@tailwindcss/vite")) return createMissingTailwindPlugin();
-    logger.warn(
-      `Tailwind plugin auto-enable failed${options.label ? ` ${options.label}` : ""}; continuing without it: ${error.message}`
-    );
-    return void 0;
-  }
-}
-__name(loadTailwindVitePlugin, "loadTailwindVitePlugin");
-function createMissingTailwindPlugin() {
-  let root = process.cwd();
-  return {
-    name: "farm:tailwind-missing",
-    enforce: "pre",
-    configResolved(config) {
-      root = config.root;
-    },
-    transform(code, id) {
-      if (warnedMissingTailwind || !/\.css(?:\?.*)?$/.test(id) || !TAILWIND_CSS_IMPORT.test(code)) {
-        return null;
-      }
-      warnedMissingTailwind = true;
-      const file = path16.relative(root, id.split("?", 1)[0]).replace(/\\/g, "/");
-      logger.warn(
-        `${file} imports Tailwind CSS, but @tailwindcss/vite is not installed; continuing without Tailwind. ${TAILWIND_VITE_INSTALL_HINT}`
-      );
-      return null;
-    }
-  };
-}
-__name(createMissingTailwindPlugin, "createMissingTailwindPlugin");
-
 // src/server/vite-config.ts
-import path17 from "path";
+import path16 from "path";
 var FARM_CLIENT_ENTRY_PATTERN = "**/{page,layout,loading,error,not-found,default}.{js,jsx,ts,tsx}";
 var FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE = [
   "react",
@@ -8477,7 +8381,11 @@ var FARM_CLIENT_OPTIMIZE_DEPS_INCLUDE = [
   "@farm.js/core/i18n/client",
   "@farm.js/core/query/client",
   "@farm.js/core/server-fn/client",
-  "@farm.js/core/server-query/client"
+  "@farm.js/core/server-query/client",
+  // Islands mode's browser runtime: Farm imports islx, which the app reaches only through Farm.
+  "@farm.js/core > @farm.js/islx/client",
+  "@farm.js/core > @farm.js/islx/react",
+  "@farm.js/core > @farm.js/islx/react/client"
 ];
 function getFarmClientOptimizeDepsInclude(renderer) {
   return Array.from(
@@ -8486,9 +8394,9 @@ function getFarmClientOptimizeDepsInclude(renderer) {
 }
 __name(getFarmClientOptimizeDepsInclude, "getFarmClientOptimizeDepsInclude");
 function createFarmClientOptimizeDepsEntries(projectRoot, appDirectories) {
-  const resolvedProjectRoot = path17.resolve(projectRoot);
+  const resolvedProjectRoot = path16.resolve(projectRoot);
   return appDirectories.map((appDirectory) => {
-    const relativeAppDirectory = path17.relative(resolvedProjectRoot, path17.resolve(appDirectory)).replace(/\\/g, "/");
+    const relativeAppDirectory = path16.relative(resolvedProjectRoot, path16.resolve(appDirectory)).replace(/\\/g, "/");
     const prefix = relativeAppDirectory || ".";
     return `${prefix}/${FARM_CLIENT_ENTRY_PATTERN}`;
   });
@@ -8512,7 +8420,7 @@ function createFarmClientOptimizeDepsConfig(entries, renderer) {
 __name(createFarmClientOptimizeDepsConfig, "createFarmClientOptimizeDepsConfig");
 function createFarmSourceAlias(projectRoot, srcDir = "src") {
   return {
-    "@": path17.resolve(projectRoot, srcDir)
+    "@": path16.resolve(projectRoot, srcDir)
   };
 }
 __name(createFarmSourceAlias, "createFarmSourceAlias");
@@ -8680,10 +8588,6 @@ export {
   createMarkdownPageHydrationPlanner,
   enforceFarmIsolatedHydrationRouteBudget,
   isIsolatableClientBoundarySource,
-  createFarmRouteRenderPlan,
-  getFarmFragmentCacheControl,
-  parseFarmLayoutChainHeader,
-  getSharedLayoutPrefixLength,
   RouteManager,
   resolveDevGlobalStylesheetHref,
   resolveFarmNotFoundComponentPath,
@@ -8707,7 +8611,6 @@ export {
   redactFarmDocsClientConfig,
   isFarmDocsClientConfigModule,
   farmDocsClientConfigPlugin,
-  loadTailwindVitePlugin,
   createFarmClientOptimizeDepsEntries,
   createFarmClientOptimizeDepsConfig,
   createFarmSourceAlias,

package/dist/chunk-QGH2RQVF.mjs

@@ -0,0 +1,132 @@
+import {
+  isExplicitFarmServerComponentsMode,
+  resolveFarmServerComponentsMode
+} from "./chunk-M3BXTWJM.mjs";
+import {
+  logger
+} from "./chunk-KI3MESHB.mjs";
+import {
+  __name
+} from "./chunk-LPEX4YW6.mjs";
+
+// src/server-components-status.ts
+import { existsSync, realpathSync } from "fs";
+import path from "path";
+var FARM_RSC_PACKAGES = [
+  "@farm.js/plugin",
+  "@vitejs/plugin-rsc",
+  "react-server-dom-webpack"
+];
+var FARM_RSC_INSTALL_HINT = `pnpm add ${FARM_RSC_PACKAGES.join(" ")}`;
+var FARM_RSC_BLOCKING_KEYS = [
+  "auth",
+  "integrations",
+  "headers",
+  "redirects",
+  "rewrites",
+  "routeRules",
+  "context"
+];
+var FARM_RSC_IGNORED_KEYS = [
+  "plugins",
+  "storage",
+  "schema",
+  "cron",
+  "workflows",
+  "docs",
+  "theme",
+  "observability"
+];
+function farmConfigUsesServerComponents(config) {
+  return resolveFarmServerComponentsMode(config?.experimental?.serverComponents) === "rsc";
+}
+__name(farmConfigUsesServerComponents, "farmConfigUsesServerComponents");
+function findFarmAppPackageDir(root, packageName) {
+  for (let dir = path.resolve(root); ; dir = path.dirname(dir)) {
+    const candidate = path.join(dir, "node_modules", packageName);
+    if (existsSync(path.join(candidate, "package.json"))) return realpathSync(candidate);
+    if (path.dirname(dir) === dir) return void 0;
+  }
+}
+__name(findFarmAppPackageDir, "findFarmAppPackageDir");
+function isSet(value) {
+  if (value === void 0 || value === false || value === null) return false;
+  if (Array.isArray(value)) return value.length > 0;
+  return typeof value !== "object" || Object.keys(value).length > 0;
+}
+__name(isSet, "isSet");
+function inspectFarmServerComponents(config, root) {
+  const value = config?.experimental?.serverComponents;
+  const mode = resolveFarmServerComponentsMode(value);
+  const enabled = mode === "rsc";
+  const explicit = enabled && isExplicitFarmServerComponentsMode(value);
+  const missingPackages = enabled ? FARM_RSC_PACKAGES.filter((name) => !findFarmAppPackageDir(root, name)) : [];
+  return {
+    mode,
+    enabled,
+    explicit,
+    missingPackages,
+    // `true` predates the pipeline; `{ mode: "rsc" }` is new and fails with the install command.
+    fallback: enabled && !explicit && missingPackages.length > 0,
+    blockingKeys: enabled ? FARM_RSC_BLOCKING_KEYS.filter((key) => isSet(config?.[key])) : [],
+    ignoredKeys: enabled ? FARM_RSC_IGNORED_KEYS.filter((key) => isSet(config?.[key])) : []
+  };
+}
+__name(inspectFarmServerComponents, "inspectFarmServerComponents");
+function formatKeys(keys) {
+  return keys.map((key) => `\`${key}\``).join(", ");
+}
+__name(formatKeys, "formatKeys");
+function formatFarmRscFallbackMessage(missingPackages, blockingKeys = []) {
+  if (blockingKeys.length > 0) {
+    return `experimental.serverComponents is true, but this app uses ${formatKeys(
+      blockingKeys
+    )}, which the RSC pipeline does not run yet, so it runs without React Server Components. Remove the flag, or move ${blockingKeys.length === 1 ? "that feature" : "those features"} out of farm.config to turn RSC on.`;
+  }
+  return `experimental.serverComponents is true, but ${missingPackages.join(", ")} ${missingPackages.length === 1 ? "is" : "are"} not installed, so the app runs without React Server Components. \`farm dev\` and \`farm build\` install them outside CI; in CI or with another tool, run ${FARM_RSC_INSTALL_HINT}.`;
+}
+__name(formatFarmRscFallbackMessage, "formatFarmRscFallbackMessage");
+function formatFarmRscBlockingMessage(blockingKeys) {
+  return `experimental.serverComponents runs on the RSC pipeline, which does not run ${formatKeys(
+    blockingKeys
+  )} yet. Serving the app without ${blockingKeys.length === 1 ? "it" : "them"} could expose what ${blockingKeys.length === 1 ? "it protects" : "they protect"}, so RSC does not start. Remove experimental.serverComponents to keep ${blockingKeys.length === 1 ? "it" : "them"}.`;
+}
+__name(formatFarmRscBlockingMessage, "formatFarmRscBlockingMessage");
+var warnedFallback = false;
+function farmAppUsesRscPipeline(config, root) {
+  const status = inspectFarmServerComponents(config, root);
+  if (status.mode === "islands") return false;
+  if (!status.enabled) return false;
+  if (status.fallback) {
+    if (!warnedFallback) {
+      warnedFallback = true;
+      logger.warn(
+        `[Farm.js] ${formatFarmRscFallbackMessage(status.missingPackages, status.blockingKeys)}`
+      );
+    }
+    return false;
+  }
+  if (status.blockingKeys.length > 0) {
+    throw new Error(`[Farm.js] ${formatFarmRscBlockingMessage(status.blockingKeys)}`);
+  }
+  if (status.ignoredKeys.length > 0) {
+    logger.warn(
+      `[Farm.js] experimental.serverComponents runs on the RSC pipeline, which does not run ${formatKeys(
+        status.ignoredKeys
+      )} yet. ${status.ignoredKeys.length === 1 ? "It is" : "They are"} ignored.`
+    );
+  }
+  return true;
+}
+__name(farmAppUsesRscPipeline, "farmAppUsesRscPipeline");
+
+export {
+  FARM_RSC_PACKAGES,
+  FARM_RSC_INSTALL_HINT,
+  farmConfigUsesServerComponents,
+  findFarmAppPackageDir,
+  inspectFarmServerComponents,
+  formatFarmRscFallbackMessage,
+  formatFarmRscBlockingMessage,
+  farmAppUsesRscPipeline
+};