@farm.js/core 0.1.51-beta.2 → 0.1.51-beta.3

package/dist/{chunk-4SSRBCBR.mjs → chunk-NOTSHVRN.mjs}

@@ -1,3 +1,12 @@
+import {
+  FARM_MOBILE_CLIENT_ENTRY_NAME,
+  FARM_MOBILE_SHELL_CLIENT_PLACEHOLDER,
+  createFarmMobileClientManifestPlugin,
+  encodeFarmMobileShellClient,
+  finalizeFarmMobileClient,
+  hasFarmMobileClientEntry,
+  removeFarmMobileClientManifest
+} from "./chunk-ZNXTU4YH.mjs";
 import {
   loadFarmProductionVite
 } from "./chunk-PSUYE5HR.mjs";
@@ -22,7 +31,7 @@ import {
   createFarmDocsAPIHandler,
   hasFarmDocsRuntimeAdapter,
   listFarmDocsAdapterPages
-} from "./chunk-FM2UEKS2.mjs";
+} from "./chunk-5FXPJIOT.mjs";
 import {
   FARM_DOCS_LAST_MODIFIED_MANIFEST,
   createFarmDocsHandler,
@@ -34,7 +43,7 @@ import {
   loadFarmDocsPage,
   resolveFarmDocsContentDir,
   toFarmDocsMarkdownPage
-} from "./chunk-EIMK7D2D.mjs";
+} from "./chunk-ZD2VKAUI.mjs";
 import {
   generateFarmDocsSearchClientRuntime,
   isFarmDocsSearchEnabled,
@@ -42,7 +51,7 @@ import {
 } from "./chunk-ALEUMLJN.mjs";
 import {
   FARM_PRERENDER_ENV
-} from "./chunk-E6LTONL4.mjs";
+} from "./chunk-3SMXQNFD.mjs";
 import {
   resolveFarmInstrumentationFile
 } from "./chunk-N35YPV4N.mjs";
@@ -57,7 +66,7 @@ import {
   getDeployTargetForPreset,
   hasCustomFarmRouteContext,
   resolveDeployOutputPath
-} from "./chunk-CTM4SPB3.mjs";
+} from "./chunk-GAO7MS5O.mjs";
 import {
   DEFAULT_NOT_FOUND_STYLES,
   FARM_LAYOUT_ELEMENT_CLIENT_SOURCE,
@@ -88,8 +97,10 @@ import {
   resolveFarmImageServerRuntime,
   resolveFarmIsolatedClientHydrationMode,
   resolveFarmNotFoundComponentPath,
-  usesFarmServerTree
-} from "./chunk-PMKUU273.mjs";
+  usePackageClientBoundaryCacheFile,
+  usesFarmServerTree,
+  withPackageClientBoundaryCache
+} from "./chunk-3TLKUBXG.mjs";
 import {
   loadTailwindVitePlugin
 } from "./chunk-PIHKO25G.mjs";
@@ -113,7 +124,10 @@ import {
   layoutsCanCoverSamePage,
   routeBoundaryCoversDirectory,
   stripRouteGroups
-} from "./chunk-7UPCJDB5.mjs";
+} from "./chunk-YUEYBL35.mjs";
+import {
+  FARM_NATIVE_TREE_CONTENT_TYPE
+} from "./chunk-LLZSYFOM.mjs";
 import {
   farmPluginMayAffectRuntimePath
 } from "./chunk-UUMKLGUU.mjs";
@@ -127,18 +141,18 @@ import {
   listFarmBuiltInRoutePaths,
   resolveFarmApiCatalogInput,
   resolveFarmAppManifestInput
-} from "./chunk-E73PGHSR.mjs";
+} from "./chunk-4TKAIO2F.mjs";
 import {
   FARM_DEFAULT_MCP_PATH,
   createFarmDefaultMCPServer,
   farmConfigMountsMCP
-} from "./chunk-KRRZJ77U.mjs";
+} from "./chunk-E5DXF5GE.mjs";
 import {
   farmEnvironmentFunctionsPlugin
 } from "./chunk-ZQ5BDNKW.mjs";
 import {
   isFarmMarkdownPageFile
-} from "./chunk-GW4YUIHW.mjs";
+} from "./chunk-3Z63X45F.mjs";
 import {
   generateFarmDocsAdapterClientRuntime,
   getFarmDocsAdapterConfigModule
@@ -191,7 +205,7 @@ import {
 } from "./chunk-FSQMN2MQ.mjs";
 import {
   getFarmMarkdownAlternatePath
-} from "./chunk-N77JBPLC.mjs";
+} from "./chunk-LPDKG6RA.mjs";
 import {
   _collectFarmStorageModules
 } from "./chunk-TJVUTGED.mjs";
@@ -236,7 +250,7 @@ import {
 } from "./chunk-LM2YOGDK.mjs";
 import {
   FARM_VERSION
-} from "./chunk-6CYQQQGR.mjs";
+} from "./chunk-R4PHCZ3G.mjs";
 import {
   getFarmPresetRuntime
 } from "./chunk-UAQD67HM.mjs";
@@ -1615,7 +1629,7 @@ function restoreLiteralModuleSpecifiers(code, fileName, { parseSync, Visitor })
     throw new Error(`Failed to minify ${fileName}: ${parsed.errors[0].message}`);
   }
   const replacements = [];
-  let needsAst = hasRequireTemplate;
+  let needsAst = hasRequireTemplate && /(?<![\w$])require\(`/.test(code);
   if (!needsAst) {
     const seenStarts = /* @__PURE__ */ new Set();
     for (const { moduleRequest } of parsed.module.dynamicImports) {
@@ -1909,6 +1923,7 @@ ${islandsErrors.map((error) => `  - ${error}`).join("\n")}`
     }
     const productionVite = productionViteResult.value;
     logger.info("\u26A1 Building application bundles with Vite Rolldown");
+    const mobileClient = shouldBuildFarmMobileClient(config);
     const buildClientBundle = () => buildClient(
       productionVite,
       config,
@@ -1921,7 +1936,8 @@ ${islandsErrors.map((error) => `  - ${error}`).join("\n")}`
       isolatedClientBoundaryModules,
       hydrationPlanCache,
       rendererBuildLifetime,
-      routeManager.getProgrammaticClientRoutes()
+      routeManager.getProgrammaticClientRoutes(),
+      mobileClient
     );
     const buildSSRBundle = () => buildSSRInMemory(
       productionVite,
@@ -1974,7 +1990,8 @@ ${islandsErrors.map((error) => `  - ${error}`).join("\n")}`
           isolatedClientBoundaryModules,
           hydrationPlanCache,
           rendererBuildLifetime,
-          routeManager.getProgrammaticClientRoutes()
+          routeManager.getProgrammaticClientRoutes(),
+          mobileClient
         );
       } catch (retryError) {
         if (!(retryError instanceof IncompleteClientBuildOutputError)) throw retryError;
@@ -2033,6 +2050,27 @@ ${islandsErrors.map((error) => `  - ${error}`).join("\n")}`
     rendererBuild?.abort();
   }
 }
+function shouldBuildFarmMobileClient(config, options = {}) {
+  if (!config.mobileClient || config.desktop) return false;
+  const mode = resolveFarmServerComponentsMode(config.experimental?.serverComponents);
+  if (mode === void 0) return true;
+  if (!options.quiet)
+    logger.info(
+      `\u{1F4F1} No mobile client for experimental.serverComponents (${mode}) yet; a mobile shell loads the web client.`
+    );
+  return false;
+}
+function varyFarmNitroCacheRulesByShell(rules) {
+  return Object.fromEntries(
+    Object.entries(rules).map(([source, rule]) => {
+      const cached = rule?.swr !== void 0 && rule.swr !== false || rule?.cache !== void 0 && rule.cache !== false;
+      if (!cached || rule.cache === false) return [source, rule];
+      const cache = rule.cache && typeof rule.cache === "object" ? rule.cache : {};
+      const varies = [...Array.isArray(cache.varies) ? cache.varies : [], "x-farm-shell"];
+      return [source, { ...rule, cache: { ...cache, varies } }];
+    })
+  );
+}
 async function writeSSRAssetsToClient(bundle, outputDir) {
   const fs4 = await import("fs/promises");
   for (const [fileName, output] of Object.entries(bundle)) {
@@ -2126,7 +2164,8 @@ function getCachedClientModuleHydrationPlan(modulePath, root, mode, cache, optio
   }
   return { ...plan, isolatedBoundaries: [...plan.isolatedBoundaries] };
 }
-async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map(), rendererBuildLifetime, programmaticClientRoutes) {
+async function buildClient(productionVite, config, root, srcDir, outputDir, pageRoutes, layoutRoutes = [], routeSlots = [], isolatedClientBoundaryModules = /* @__PURE__ */ new Set(), hydrationPlanCache = /* @__PURE__ */ new Map(), rendererBuildLifetime, programmaticClientRoutes, mobile = false) {
+  if (!mobile) await removeFarmMobileClientManifest(path10.dirname(outputDir));
   const viteBuild = productionVite.build;
   const { farmPlugin, farmServerOnlyEntriesPlugin } = await import("./vite.mjs");
   const { PluginManager: PluginManager2 } = await import("./plugin-53SY5YBS.mjs");
@@ -2369,206 +2408,229 @@ async function buildClient(productionVite, config, root, srcDir, outputDir, page
   logger.info(
     `\u{1F4F1} Total hydratable routes detected: ${clientPages.length} pages, ${clientLayouts.filter((layout) => layout.shouldHydrate || layout.hasIsolatedClientBoundaries).length} layouts, and ${clientRouteSlots.length} slots`
   );
-  const clientEntryRoot = path10.join(root, ".farm", "tmp");
-  await fs4.mkdir(clientEntryRoot, { recursive: true });
-  const clientEntryDir = await fs4.mkdtemp(path10.join(clientEntryRoot, "client-entry-"));
-  const clientEntryPath = path10.join(clientEntryDir, "farm-client-entry.tsx");
-  const clientHydrationCode = generateClientHydrationEntry(
-    clientPages,
-    clientLayouts,
-    clientRouteSlots,
-    root,
-    srcDir,
-    adapterOwnsDocsRuntime ? false : isFarmDocsSearchEnabled(config.docs),
-    adapterOwnsDocsRuntime ? void 0 : resolveFarmDocsSearchClientModule(root),
-    config.docs?.enabled ? getFarmDocsRoots(config.docs).map((docsRoot) => docsRoot.entry) : void 0,
-    adapterOwnsDocsRuntime ? config.docs.adapter?.react : void 0,
-    config.i18n,
-    config.plugins,
-    config.renderer,
-    config.publicRuntimeConfig,
-    config.trailingSlash,
-    getIntegrationProviders(config.integrations),
-    config.basePath,
-    generateClientCachePersistenceCode(resolveFarmClientCacheAdapterEntry(root, config.cache)),
-    adapterOwnsDocsRuntime ? getFarmDocsAdapterConfigModule(config.docs) : void 0,
-    resolveFarmServerComponentsMode(config.experimental?.serverComponents) === "islands"
-  );
-  await fs4.writeFile(clientEntryPath, clientHydrationCode);
-  const hasScopedPostcssConfig = hasProjectPostcssConfig(root);
-  let postcssSearchPath;
-  let tailwindVitePlugin = void 0;
-  const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, root, {
-    ssr: false,
-    buildLifetime: rendererBuildLifetime
-  });
-  if (hasScopedPostcssConfig) {
-    logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
-  } else {
-    const postcssConfigPath = path10.join(clientEntryDir, "postcss.config.cjs");
-    await fs4.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
-    postcssSearchPath = clientEntryDir;
-    tailwindVitePlugin = await loadTailwindVitePlugin({
-      builder: productionVite.builder,
-      announce: true
-    });
-  }
-  try {
-    const clientViteConfig = {
+  const buildTarget = async (platform) => {
+    const clientEntryRoot = path10.join(root, ".farm", "tmp");
+    await fs4.mkdir(clientEntryRoot, { recursive: true });
+    const clientEntryDir = await fs4.mkdtemp(path10.join(clientEntryRoot, "client-entry-"));
+    const clientEntryPath = path10.join(clientEntryDir, "farm-client-entry.tsx");
+    const clientHydrationCode = generateClientHydrationEntry(
+      clientPages,
+      clientLayouts,
+      clientRouteSlots,
       root,
-      // Vite otherwise falls back to <root>/public, silently dropping every
-      // asset in a custom config.publicDir from the production client output.
-      publicDir: config.publicDir,
-      esbuild: {
-        jsxDev: false
-      },
-      build: {
-        // Preserve Farm's Vite 5 browser baseline when the production builder
-        // uses Vite 8, whose default target only covers newer browsers.
-        target: FARM_CLIENT_BUILD_TARGET,
-        outDir: outputDir,
-        emptyOutDir: true,
-        // Never public: see resolveFarmClientSourcemap.
-        sourcemap: resolveFarmClientSourcemap(config.vite?.build?.sourcemap),
-        assetsInlineLimit: 0,
-        cssCodeSplit: false,
-        // Bundle all CSS into one file
-        rollupOptions: {
-          input: {
-            "farm-client": clientEntryPath
-          },
-          output: {
-            entryFileNames: "[name]-h[hash].js",
-            chunkFileNames: "chunks/[name]-h[hash].js",
-            hashCharacters: "hex",
-            // Use predictable name for CSS so we can reference it in SSR HTML
-            assetFileNames: (assetInfo) => {
-              if (assetInfo.name?.endsWith(".css")) {
-                return "farm-client.css";
+      srcDir,
+      adapterOwnsDocsRuntime ? false : isFarmDocsSearchEnabled(config.docs),
+      adapterOwnsDocsRuntime ? void 0 : resolveFarmDocsSearchClientModule(root),
+      config.docs?.enabled ? getFarmDocsRoots(config.docs).map((docsRoot) => docsRoot.entry) : void 0,
+      adapterOwnsDocsRuntime ? config.docs.adapter?.react : void 0,
+      config.i18n,
+      config.plugins,
+      config.renderer,
+      config.publicRuntimeConfig,
+      config.trailingSlash,
+      getIntegrationProviders(config.integrations),
+      config.basePath,
+      generateClientCachePersistenceCode(resolveFarmClientCacheAdapterEntry(root, config.cache)),
+      adapterOwnsDocsRuntime ? getFarmDocsAdapterConfigModule(config.docs) : void 0,
+      resolveFarmServerComponentsMode(config.experimental?.serverComponents) === "islands",
+      platform
+    );
+    const entryName = platform === "mobile" ? FARM_MOBILE_CLIENT_ENTRY_NAME : "farm-client";
+    await fs4.writeFile(clientEntryPath, clientHydrationCode);
+    const hasScopedPostcssConfig = hasProjectPostcssConfig(root);
+    let postcssSearchPath;
+    let tailwindVitePlugin = void 0;
+    const rendererVitePlugins = await loadFarmRendererVitePlugins(config.renderer, root, {
+      ssr: false,
+      buildLifetime: rendererBuildLifetime
+    });
+    if (hasScopedPostcssConfig) {
+      logger.info("\u{1F4E6} Using project PostCSS/Tailwind configuration");
+    } else {
+      const postcssConfigPath = path10.join(clientEntryDir, "postcss.config.cjs");
+      await fs4.writeFile(postcssConfigPath, "module.exports = { plugins: [] };\n");
+      postcssSearchPath = clientEntryDir;
+      tailwindVitePlugin = await loadTailwindVitePlugin({
+        builder: productionVite.builder,
+        announce: true
+      });
+    }
+    try {
+      const clientViteConfig = {
+        root,
+        // Vite otherwise falls back to <root>/public, silently dropping every
+        // asset in a custom config.publicDir from the production client output.
+        // The mobile client adds to the web client's output; public files are copied once.
+        publicDir: platform === "mobile" ? false : config.publicDir,
+        esbuild: {
+          jsxDev: false
+        },
+        build: {
+          // Preserve Farm's Vite 5 browser baseline when the production builder
+          // uses Vite 8, whose default target only covers newer browsers.
+          target: FARM_CLIENT_BUILD_TARGET,
+          outDir: outputDir,
+          emptyOutDir: platform === "web",
+          // Never public: see resolveFarmClientSourcemap.
+          sourcemap: resolveFarmClientSourcemap(config.vite?.build?.sourcemap),
+          assetsInlineLimit: 0,
+          cssCodeSplit: false,
+          // Bundle all CSS into one file
+          rollupOptions: {
+            input: {
+              [entryName]: clientEntryPath
+            },
+            output: {
+              entryFileNames: "[name]-h[hash].js",
+              chunkFileNames: "chunks/[name]-h[hash].js",
+              hashCharacters: "hex",
+              // Use predictable name for CSS so we can reference it in SSR HTML
+              assetFileNames: (assetInfo) => {
+                if (assetInfo.name?.endsWith(".css")) {
+                  return `${entryName}.css`;
+                }
+                return "assets/[name]-h[hash][extname]";
               }
-              return "assets/[name]-h[hash][extname]";
-            }
-          },
-          // A browser cannot load a Node builtin: farmServerOnlyEntriesPlugin
-          // resolves one to Farm's browser module for it instead.
-          external: (id) => {
-            if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node")) {
-              return true;
+            },
+            // A browser cannot load a Node builtin: farmServerOnlyEntriesPlugin
+            // resolves one to Farm's browser module for it instead.
+            external: (id) => {
+              if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node")) {
+                return true;
+              }
+              return false;
             }
-            return false;
           }
-        }
-      },
-      plugins: [
-        createFarmThemeCssPlugin(config.theme, config.basePath),
-        createFarmPrivateClientSourcemapsPlugin({
-          outDir: path10.join(path10.dirname(outputDir), FARM_CLIENT_SOURCEMAPS_DIR)
-        }),
-        createFarmClientModulePreloadPlugin({
-          root,
-          buildDir: path10.dirname(outputDir),
-          entryName: "farm-client"
-        }),
-        ...adapterOwnsDocsRuntime ? [
-          createFarmDocsModulePreloadPlugin({
+        },
+        plugins: [
+          createFarmThemeCssPlugin(config.theme, config.basePath),
+          createFarmPrivateClientSourcemapsPlugin({
+            outDir: path10.join(
+              path10.dirname(outputDir),
+              platform === "mobile" ? `${FARM_CLIENT_SOURCEMAPS_DIR}-mobile` : FARM_CLIENT_SOURCEMAPS_DIR
+            )
+          }),
+          // The web client's preload manifests; the mobile client records its files instead.
+          platform === "mobile" ? createFarmMobileClientManifestPlugin({
+            buildDir: path10.dirname(outputDir),
+            entryName
+          }) : createFarmClientModulePreloadPlugin({
             root,
             buildDir: path10.dirname(outputDir),
-            importer: clientEntryPath,
-            entryName: "farm-client",
-            modules: [
-              config.docs.adapter.react,
-              getFarmDocsAdapterConfigModule(config.docs)
-            ].filter((specifier) => Boolean(specifier))
-          })
-        ] : [],
-        ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
-        ...rendererVitePlugins,
-        ...config.vite.plugins || [],
-        farmServerOnlyEntriesPlugin(),
-        farmDocsClientConfigPlugin(
-          adapterOwnsDocsRuntime ? getFarmDocsAdapterConfigModule(config.docs) : void 0
-        ),
-        // Plugin to redirect @farm.js/core imports to client-only exports
-        {
-          name: "farm-client-only-imports",
-          enforce: "pre",
-          resolveId(id) {
-            if (id === "@farm.js/core") {
-              return { id: "\0farm-client-exports", external: false };
-            }
-            if (id === "@farm.js/core/i18n/server") {
-              return { id: "\0farm-i18n-client-bridge", external: false };
-            }
-            if (id === "@farm.js/core/server" || id === "@farm.js/core/api" || id === "@farm.js/core/middleware" || id === "@farm.js/core/headers" || id === "@farm.js/core/config" || id.includes("@farm.js/core/middleware") || id.includes("@farm.js/core/query/server")) {
-              return { id: "\0empty-module", external: false };
-            }
-            if (id.includes("/api/") && id.includes("/route")) {
-              return { id: "\0empty-api-route", external: false };
-            }
-            if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node") || id === "nitro" || id === "vite" || id === "esbuild" || id === "rolldown" || id.startsWith("rolldown/") || id === "rollup" || id.startsWith("nitro/") || id.includes("node-pre-gyp") || id.includes("nf3")) {
-              return { id: "\0empty-module", external: false };
+            entryName: "farm-client"
+          }),
+          ...adapterOwnsDocsRuntime && platform === "web" ? [
+            createFarmDocsModulePreloadPlugin({
+              root,
+              buildDir: path10.dirname(outputDir),
+              importer: clientEntryPath,
+              entryName: "farm-client",
+              modules: [
+                config.docs.adapter.react,
+                getFarmDocsAdapterConfigModule(config.docs)
+              ].filter((specifier) => Boolean(specifier))
+            })
+          ] : [],
+          ...tailwindVitePlugin ? [tailwindVitePlugin] : [],
+          ...rendererVitePlugins,
+          ...config.vite.plugins || [],
+          farmServerOnlyEntriesPlugin({ platform }),
+          farmDocsClientConfigPlugin(
+            adapterOwnsDocsRuntime ? getFarmDocsAdapterConfigModule(config.docs) : void 0
+          ),
+          // Plugin to redirect @farm.js/core imports to client-only exports
+          {
+            name: "farm-client-only-imports",
+            enforce: "pre",
+            resolveId(id) {
+              if (id === "@farm.js/core") {
+                return { id: "\0farm-client-exports", external: false };
+              }
+              if (id === "@farm.js/core/i18n/server") {
+                return { id: "\0farm-i18n-client-bridge", external: false };
+              }
+              if (id === "@farm.js/core/server" || id === "@farm.js/core/api" || id === "@farm.js/core/middleware" || id === "@farm.js/core/headers" || id === "@farm.js/core/config" || id.includes("@farm.js/core/middleware") || id.includes("@farm.js/core/query/server")) {
+                return { id: "\0empty-module", external: false };
+              }
+              if (id.includes("/api/") && id.includes("/route")) {
+                return { id: "\0empty-api-route", external: false };
+              }
+              if (id === "fsevents" || id.includes("fsevents") || id.endsWith(".node") || id === "nitro" || id === "vite" || id === "esbuild" || id === "rolldown" || id.startsWith("rolldown/") || id === "rollup" || id.startsWith("nitro/") || id.includes("node-pre-gyp") || id.includes("nf3")) {
+                return { id: "\0empty-module", external: false };
+              }
+              return null;
+            },
+            load(id) {
+              if (id === "\0empty-module") {
+                return "const emptyMiddlewareStore = new Map(); export default {}; export const getMiddlewareContext = () => emptyMiddlewareStore; export const getMiddlewareData = () => emptyMiddlewareStore; export const getMiddlewareValue = () => undefined; export const middleware = () => ({});";
+              }
+              if (id === "\0empty-api-route") {
+                return "export const GET = () => {}; export const HEAD = () => {}; export const QUERY = () => {}; export const POST = () => {}; export const PUT = () => {}; export const DELETE = () => {}; export const PATCH = () => {}; export const OPTIONS = () => {}; export default {};";
+              }
+              if (id === "\0farm-i18n-client-bridge") {
+                return 'export { createTranslator, format, getLocale, getLocaleSource, t } from "@farm.js/core/i18n/client";';
+              }
+              if (id === "\0farm-client-exports") {
+                return [
+                  "// Farm.js Client Exports - Safe for browser bundling",
+                  'export { Link } from "@farm.js/core/client";',
+                  'export { useRouter } from "@farm.js/core/client";',
+                  'export { usePathname, useSearchParams } from "@farm.js/core/navigation";',
+                  // A page that hydrates ships to the browser with its notFound()/redirect() calls.
+                  'export { getFarmRedirectError, isFarmNotFoundError, isFarmRedirectError, notFound, permanentRedirect, redirect } from "@farm.js/core/navigation";',
+                  'export { createAPIClient } from "@farm.js/core/client";',
+                  'export { localFont, remoteFont } from "@farm.js/core/font";'
+                ].join("\n");
+              }
+              return null;
             }
-            return null;
           },
-          load(id) {
-            if (id === "\0empty-module") {
-              return "const emptyMiddlewareStore = new Map(); export default {}; export const getMiddlewareContext = () => emptyMiddlewareStore; export const getMiddlewareData = () => emptyMiddlewareStore; export const getMiddlewareValue = () => undefined; export const middleware = () => ({});";
-            }
-            if (id === "\0empty-api-route") {
-              return "export const GET = () => {}; export const HEAD = () => {}; export const QUERY = () => {}; export const POST = () => {}; export const PUT = () => {}; export const DELETE = () => {}; export const PATCH = () => {}; export const OPTIONS = () => {}; export default {};";
-            }
-            if (id === "\0farm-i18n-client-bridge") {
-              return 'export { createTranslator, format, getLocale, getLocaleSource, t } from "@farm.js/core/i18n/client";';
-            }
-            if (id === "\0farm-client-exports") {
-              return [
-                "// Farm.js Client Exports - Safe for browser bundling",
-                'export { Link } from "@farm.js/core/client";',
-                'export { useRouter } from "@farm.js/core/client";',
-                'export { usePathname, useSearchParams } from "@farm.js/core/navigation";',
-                // A page that hydrates ships to the browser with its notFound()/redirect() calls.
-                'export { getFarmRedirectError, isFarmNotFoundError, isFarmRedirectError, notFound, permanentRedirect, redirect } from "@farm.js/core/navigation";',
-                'export { createAPIClient } from "@farm.js/core/client";',
-                'export { localFont, remoteFont } from "@farm.js/core/font";'
-              ].join("\n");
-            }
-            return null;
-          }
+          farmPlugin(
+            { ...config, isolatedClientBoundaryModules, programmaticClientRoutes },
+            pluginManager
+          ),
+          farmEnvironmentFunctionsPlugin(config)
+        ],
+        mode: "production",
+        css: postcssSearchPath ? {
+          postcss: postcssSearchPath
+        } : void 0,
+        // Ensure React is bundled for client
+        resolve: {
+          alias: createFarmSourceAlias(root, config.srcDir),
+          dedupe: [...config.renderer.dedupe || []]
         },
-        farmPlugin(
-          { ...config, isolatedClientBoundaryModules, programmaticClientRoutes },
-          pluginManager
-        ),
-        farmEnvironmentFunctionsPlugin(config)
-      ],
-      mode: "production",
-      css: postcssSearchPath ? {
-        postcss: postcssSearchPath
-      } : void 0,
-      // Ensure React is bundled for client
-      resolve: {
-        alias: createFarmSourceAlias(root, config.srcDir),
-        dedupe: [...config.renderer.dedupe || []]
-      },
-      // Optimize dependencies - exclude server-side code from client bundle
-      optimizeDeps: {
-        exclude: [
-          "@farm.js/core/server",
-          "@farm.js/core/api",
-          "@farm.js/core/middleware",
-          "@farm.js/core/headers"
-        ]
+        // Optimize dependencies - exclude server-side code from client bundle
+        optimizeDeps: {
+          exclude: [
+            "@farm.js/core/server",
+            "@farm.js/core/api",
+            "@farm.js/core/middleware",
+            "@farm.js/core/headers"
+          ]
+        }
+      };
+      await viteBuild(mergeFarmProductionViteConfig(clientViteConfig, config.vite));
+      if (platform === "mobile") {
+        await fs4.rm(path10.join(outputDir, `${entryName}.css`), { force: true });
+        if (!await hasFarmMobileClientEntry(path10.dirname(outputDir), outputDir)) {
+          throw new IncompleteClientBuildOutputError(
+            `${FARM_MOBILE_CLIENT_ENTRY_NAME}.js is missing or empty`
+          );
+        }
+      } else {
+        await mergeBuiltFontCss(outputDir);
+        await validateClientBuildOutput(root, srcDir, outputDir);
+      }
+    } finally {
+      try {
+        await fs4.rm(clientEntryDir, { recursive: true, force: true });
+      } catch {
       }
-    };
-    await viteBuild(mergeFarmProductionViteConfig(clientViteConfig, config.vite));
-    await mergeBuiltFontCss(outputDir);
-    await validateClientBuildOutput(root, srcDir, outputDir);
-  } finally {
-    try {
-      await fs4.rm(clientEntryDir, { recursive: true, force: true });
-    } catch {
     }
-  }
+  };
+  await buildTarget("web");
+  if (mobile) await buildTarget("mobile");
 }
 function toBakedMarkdownSourcePath(root, filePath) {
   if (!filePath) return "";
@@ -3444,13 +3506,14 @@ function generateClientHydrationEntry(clientPages, layoutRoutes, clientRouteSlot
     secure: false
   },
   direction: {}
-}, plugins = [], renderer = REACT_RENDERER, publicRuntimeConfig = void 0, trailingSlash = false, integrationProviders = [], basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule, islandValues = false) {
+}, plugins = [], renderer = REACT_RENDERER, publicRuntimeConfig = void 0, trailingSlash = false, integrationProviders = [], basePath = "/", clientCachePersistence = { imports: "", init: "" }, docsConfigModule, islandValues = false, platform) {
   const toImportPath = (targetPath) => targetPath.replace(/\\/g, "/");
   const clientPluginEntry = generateFarmClientPluginEntryCode(
     plugins,
     root,
     srcDir,
-    publicRuntimeConfig
+    publicRuntimeConfig,
+    platform
   );
   const appSetupPath = resolveFarmRendererAppSetup(root, renderer);
   const rendererClientImports = isReactRenderer(renderer) ? `import React from "react";
@@ -5961,6 +6024,7 @@ ReactDOMServer.configureApp(__farmAppSetup);`;
 }
 function generateVirtualEntryCode(apiRoutes, pageRoutes, layoutRoutes, routeSlots, errorRoutes, metadataImageRoutes, applicationMetadataRoutes, middlewareRoutes, redirectRoutes, configuredRewriteRoutes, configuredHeaderRoutes, openAPIReference, notFoundPath, instrumentationPath, config, farmDocsPrecompiledManifest, configModulePath, hasServerRuntimeIntegrations, hasRuntimeIntegrationConfig, hasConfiguredRuntimePlugins, hasServerRuntimePlugins, preset, i18nCatalogs, isolatedClientBoundaryModules, hydrationPlanCache) {
   const farmIslandsMode = resolveFarmServerComponentsMode(config.experimental?.serverComponents) === "islands";
+  const farmMobileClient = shouldBuildFarmMobileClient(config, { quiet: true });
   const hasCompressionRuntime = config.compress && resolveFarmInstrumentationRuntime(preset) === "nodejs";
   const servesAgentRobotsTxt = Boolean(config.agent?.crawlers?.enabled) && !applicationMetadataRoutes.some(
     (metadata) => metadata.kind === "robots" && metadata.pattern === "/"
@@ -6389,8 +6453,22 @@ function renderFarmServerTreeLayout(Layout, props, outlets) {
   stripFarmLocaleFromPathname,
   withFarmRouteContext,
   createLateNotFoundRecovery,
-  createLateRedirectRecovery,${hasInfraAnalyticsRuntime ? "\n  resolveFarmDocsEngineRouteLabel,\n  resolveFarmDocsRouteLabel,\n  resolveFarmMarkdownRouteLabel,\n  resolveFarmMCPRouteLabel,\n  setFarmRouteLabel," : ""}${hasFarmServerStorageConfig(config.storage) ? "\n  _registerFarmStorageModules,\n  disposeFarmStorage,\n  initFarmStorage," : ""}
-} from "@farm.js/core/internal/production-runtime";${farmIslandsMode ? `
+  createLateRedirectRecovery,${config.mobileClient ? "\n  createFarmNativeTreeResponse," : ""}${hasInfraAnalyticsRuntime ? "\n  resolveFarmDocsEngineRouteLabel,\n  resolveFarmDocsRouteLabel,\n  resolveFarmMarkdownRouteLabel,\n  resolveFarmMCPRouteLabel,\n  setFarmRouteLabel," : ""}${hasFarmServerStorageConfig(config.storage) ? "\n  _registerFarmStorageModules,\n  disposeFarmStorage,\n  initFarmStorage," : ""}
+} from "@farm.js/core/internal/production-runtime";${farmMobileClient ? `
+import { _applyFarmMobileShellClient } from "@farm.js/core/internal/production-runtime";
+// The mobile client documents load when a mobile shell asks for them (RFC 0004, 7.2), filled in
+// once the client build has finished (see buildNitroUniversal). A shell's document stays out of
+// shared caches, which the adapter learns as it does for a guarded response.
+const farmMobileShellClient = JSON.parse("${FARM_MOBILE_SHELL_CLIENT_PLACEHOLDER}");
+function applyFarmMobileShellResponse(request, response, context) {
+  return _applyFarmMobileShellClient(request, response, farmMobileShellClient, () =>
+    context?.onGuardedResponse?.()
+  );
+}` : `
+// No mobile block: no mobile client, and documents ignore X-Farm-Shell.
+function applyFarmMobileShellResponse(request, response) {
+  return response;
+}`}${farmIslandsMode ? `
 import { getSharedLayoutPrefixLength, handleFarmFormActionRequest, ignoreFarmHeldValues, installFarmIslandValues, parseFarmLayoutChainHeader } from "@farm.js/core/internal/production-runtime";
 import { installFarmIslandsServer } from "@farm.js/core/internal/islands-server";
 installFarmIslandsServer();
@@ -9125,6 +9203,21 @@ ${hasServerRuntimeIntegrations ? `
   }
   ` : ""}
 
+  ${config.mobileClient ? `
+  // The mobile app's native-tier screens: the page, rendered as for a browser, read into a
+  // tree of native views.
+  if (
+    (request.method === "GET" || request.method === "HEAD") &&
+    request.headers.get("accept")?.includes(${JSON.stringify(FARM_NATIVE_TREE_CONTENT_TYPE)})
+  ) {
+    const treeResponse = await createFarmNativeTreeResponse({
+      request,
+      renderPage: (targetRequest) => fetchFarmInnerRequest(targetRequest, adapterContext),
+    });
+    return applyProductionMiddlewareHeaders(treeResponse, middlewareHeaders);
+  }
+  ` : ""}
+
   ${config.md?.enabled ? `
   if (farmMarkdownConfig?.enabled) {
     const markdownResponse = await createMarkdownMirrorResponse({
@@ -10611,10 +10704,11 @@ async function handleFarmFetch(request, context) {
             ? getFarmRoutePathname(new URL(runtimeRequest.url).pathname)
             : undefined;
           const configured = applyConfiguredResponseHeaders(response, routePathname);
+          // Configured headers may edit the response in place, so check it either way.
+          const guarded = farmGuardedResponse ? _withFarmGuardedResponseCache(configured) : configured;
           return applyFarmPreloadBudget(
             applyFarmCspNonceToResponse(
-              // Configured headers may edit the response in place, so check it either way.
-              farmGuardedResponse ? _withFarmGuardedResponseCache(configured) : configured,
+              applyFarmMobileShellResponse(runtimeRequest, guarded, context),
               farmSecurityConfig,
               cspNonce,
             ),
@@ -10921,8 +11015,20 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
   ]);
   const encodedDocsModulePreloads = encodeFarmDocsModulePreloads(docsModulePreloads);
   const encodedClientModulePreloads = encodeFarmClientModulePreloads(clientModulePreloads);
+  const encodedMobileShellClient = shouldBuildFarmMobileClient(config, { quiet: true }) ? encodeFarmMobileShellClient(
+    await finalizeFarmMobileClient({
+      buildDir: path10.join(root, distDir),
+      clientOutputDir,
+      webEntry: clientJsSrc,
+      stylesheet: clientCssHref,
+      webFiles: clientModulePreloads?.files ?? []
+    })
+  ) : null;
   for (const output of Object.values(ssrBundle)) {
     if (output.type !== "chunk") continue;
+    if (encodedMobileShellClient && output.code.includes(FARM_MOBILE_SHELL_CLIENT_PLACEHOLDER)) {
+      output.code = output.code.split(FARM_MOBILE_SHELL_CLIENT_PLACEHOLDER).join(encodedMobileShellClient);
+    }
     if (output.code.includes(FARM_DOCS_MODULE_PRELOADS_PLACEHOLDER)) {
       output.code = output.code.split(FARM_DOCS_MODULE_PRELOADS_PLACEHOLDER).join(encodedDocsModulePreloads);
     }
@@ -10937,11 +11043,13 @@ async function buildNitroUniversal(config, routeManager, apiRouteManager, server
     }
   }
   await fs4.mkdir(ssrOutputDir, { recursive: true });
-  for (const [fileName, output] of Object.entries(ssrBundle)) {
-    const filePath = path10.join(ssrOutputDir, fileName);
-    await fs4.mkdir(path10.dirname(filePath), { recursive: true });
-    await fs4.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
-  }
+  await Promise.all(
+    Object.entries(ssrBundle).map(async ([fileName, output]) => {
+      const filePath = path10.join(ssrOutputDir, fileName);
+      await fs4.mkdir(path10.dirname(filePath), { recursive: true });
+      await fs4.writeFile(filePath, output.type === "chunk" ? output.code : output.source);
+    })
+  );
   const nitroEntryPath = path10.join(ssrOutputDir, "nitro-entry.mjs");
   const nodeAdapterModule = preset === "node-server" ? resolveNitroRuntimeDependency(root, "srvx/node") : null;
   const hasNitroCacheRouteRules = hasFarmNitroCacheRouteRule(config.routeRules);
@@ -11198,7 +11306,7 @@ function toFarmNodeResponse(request, response) {
     ssrOutputDir,
     ssrEntryFile
   );
-  const configuredNitroRouteRules = routeRulesToNitroRouteRules(config.routeRules);
+  const configuredNitroRouteRules = shouldBuildFarmMobileClient(config, { quiet: true }) ? varyFarmNitroCacheRulesByShell(routeRulesToNitroRouteRules(config.routeRules)) : routeRulesToNitroRouteRules(config.routeRules);
   const prerenderNitroRouteRules = Object.fromEntries(
     prerenderRoutes.map((route) => {
       const configuredRule = configuredNitroRouteRules[route] || {};
@@ -11245,10 +11353,18 @@ function toFarmNodeResponse(request, response) {
     // fixed top quality cost a docs app ~20 s of build CPU for a small further
     // saving. Serverless and edge targets sit behind a CDN that compresses.
     ...preset === "node-server" ? { compressPublicAssets: { gzip: true } } : {},
+    // Nitro gzips every server output file at level 9, node_modules included, to
+    // print sizes after the build. A self-hosted server is never shipped compressed,
+    // so list plain sizes; zipped serverless and edge bundles keep the gzip column.
+    ...preset === "node-server" || preset === "bun" ? { logging: { compressedSizes: false } } : {},
     ...prerenderRoutes.length > 0 ? {
       prerender: {
         crawlLinks: false,
         failOnError: true,
+        // Nitro's default renders one route at a time. Each prerender request is
+        // answered independently, as by the production server, so keeping several
+        // in flight overlaps the worker's rendering with this thread's per-route work.
+        concurrency: Math.min(os.availableParallelism(), 8),
         routes: prerenderRoutes
       }
     } : {},
@@ -11346,6 +11462,22 @@ function toFarmNodeResponse(request, response) {
   }
   nitroConfig.minify = useFarmServerMinifier ? false : shouldMinify;
   const nitroInstance = await nitroBuilder.createNitro(nitroConfig);
+  let prerenderOrder = /* @__PURE__ */ new Map();
+  nitroInstance.hooks.hook("prerender:routes", (routes) => {
+    prerenderOrder = new Map(
+      Array.from(routes, (route, index) => {
+        try {
+          return [decodeURI(route), index];
+        } catch {
+          return [route, index];
+        }
+      })
+    );
+  });
+  nitroInstance.hooks.hook("prerender:done", ({ prerenderedRoutes }) => {
+    const orderOf = (route) => prerenderOrder.get(route) ?? Number.MAX_SAFE_INTEGER;
+    prerenderedRoutes.sort((a, b) => orderOf(a.route) - orderOf(b.route));
+  });
   if (config.md?.enabled) {
     nitroInstance.hooks.hook("prerender:generate", (route) => {
       if (!route.contents || !route.contentType?.toLowerCase().includes("html")) return;
@@ -11953,7 +12085,9 @@ async function createFarmProjectModuleSsrEnvironment() {
 
 // src/build/index.ts
 async function build(config, options = {}) {
-  return withProductionNodeEnv(() => buildWithProductionNodeEnv(config, options));
+  return withProductionNodeEnv(
+    () => withPackageClientBoundaryCache(() => buildWithProductionNodeEnv(config, options))
+  );
 }
 function createBuildTargetBaseline(config) {
   const preset = config.preset || "node-server";
@@ -12026,6 +12160,9 @@ async function buildWithProductionNodeEnv(inputConfig, options) {
     if (config.docs?.enabled) await loadFarmDocsEngine();
     pluginManager.updateContext({ config });
     const { root, preset, srcDir, distDir, deployOutputDir } = targets;
+    usePackageClientBoundaryCacheFile(
+      path11.resolve(root, distDir, "cache", "client-boundaries.json")
+    );
     logger.info(`\u{1F69C} Building Farm.js application with preset: ${preset}...`);
     await pluginManager.setupPlugins();
     await pluginManager.runHookParallel("beforeBundle", {