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

package/dist/internal/config-runtime.cjs

@@ -5,7 +5,7 @@ var _chunkMF3IA2AWcjs = require('../chunk-MF3IA2AW.cjs');
 
 
 
-var _chunkNPQLMP7Mcjs = require('../chunk-NPQLMP7M.cjs');
+var _chunkNQJDO7K7cjs = require('../chunk-NQJDO7K7.cjs');
 require('../chunk-OZC2JPW6.cjs');
 
 
@@ -22,50 +22,50 @@ require('../chunk-V56632LA.cjs');
 require('../chunk-LSHX2H5G.cjs');
 require('../chunk-STF6VDYQ.cjs');
 require('../chunk-RD623KW4.cjs');
-require('../chunk-NYQSC4DX.cjs');
-require('../chunk-SG57PX7K.cjs');
-require('../chunk-HIFIG6HL.cjs');
+require('../chunk-DZPR2W6U.cjs');
 require('../chunk-6JHZPB52.cjs');
+require('../chunk-SG57PX7K.cjs');
+require('../chunk-MEQN6DDA.cjs');
+require('../chunk-5Y2P454O.cjs');
 require('../chunk-HEPJIKKQ.cjs');
 require('../chunk-3EIPOTZV.cjs');
-require('../chunk-5Y2P454O.cjs');
 require('../chunk-2HW5LWAH.cjs');
+require('../chunk-LT4VAF5Z.cjs');
 require('../chunk-DQJ2CIH7.cjs');
-require('../chunk-XB24LZWI.cjs');
-require('../chunk-XYL4HSVC.cjs');
+require('../chunk-QRX4JRBO.cjs');
+require('../chunk-YI6FKTTN.cjs');
 require('../chunk-2KMIJDY6.cjs');
 require('../chunk-FK25QSVC.cjs');
-require('../chunk-WT6RAN2I.cjs');
-require('../chunk-WJFFPXCV.cjs');
 require('../chunk-SHIWRBFI.cjs');
-require('../chunk-CECUDGXQ.cjs');
+require('../chunk-WT6RAN2I.cjs');
+require('../chunk-ZP32GNJQ.cjs');
 require('../chunk-DUIP64BF.cjs');
-require('../chunk-PFV2KPDZ.cjs');
+require('../chunk-ZOYKJBP5.cjs');
 require('../chunk-ZXK2EYQW.cjs');
 require('../chunk-5DX3O6TT.cjs');
-require('../chunk-6ONBZGVH.cjs');
+require('../chunk-LRB5OVRT.cjs');
 require('../chunk-OYZXVBZP.cjs');
 require('../chunk-ITV4QQL2.cjs');
 require('../chunk-FEFCISOX.cjs');
 require('../chunk-LNVGXUL3.cjs');
 
 
-var _chunkVQJYGZNXcjs = require('../chunk-VQJYGZNX.cjs');
+var _chunkQMNWKQL4cjs = require('../chunk-QMNWKQL4.cjs');
 require('../chunk-SUCDVKUB.cjs');
 require('../chunk-EVIWKPJV.cjs');
 require('../chunk-YIHRZBD7.cjs');
+require('../chunk-2OF5RPVU.cjs');
 require('../chunk-LIFUPCXW.cjs');
 require('../chunk-JYT7AN37.cjs');
-require('../chunk-B5BBTPJQ.cjs');
 require('../chunk-HA7YRO53.cjs');
 require('../chunk-CA7DNRHO.cjs');
-require('../chunk-IWFV5ZED.cjs');
+require('../chunk-PMJSG4JS.cjs');
 require('../chunk-6FXBJPF5.cjs');
 require('../chunk-E552H232.cjs');
 require('../chunk-UZCMMJJT.cjs');
 require('../chunk-6XQSPIN6.cjs');
-require('../chunk-7JUIK547.cjs');
 require('../chunk-A25FXJ7D.cjs');
+require('../chunk-7JUIK547.cjs');
 require('../chunk-6CTFVBAT.cjs');
 require('../chunk-3BIASUGR.cjs');
 require('../chunk-OWQV6MLM.cjs');
@@ -75,7 +75,7 @@ require('../chunk-BTZ5O6VM.cjs');
 
 // src/config-runtime.ts
 function loadFarmMobileRuntime() {
-  return import("../runtime-NQ3EDSA7.cjs");
+  return import("../runtime-DGUOWSMF.cjs");
 }
 
 
@@ -91,4 +91,4 @@ function loadFarmMobileRuntime() {
 
 
 
-exports.createFarmDesktopContext = _chunkAQLHD6HZcjs.createFarmDesktopContext; exports.getFarmDesktopOutputDirs = _chunkAQLHD6HZcjs.getFarmDesktopOutputDirs; exports.installFarmDesktopSetup = _chunkAQLHD6HZcjs.installFarmDesktopSetup; exports.loadConfig = _chunkNPQLMP7Mcjs.loadConfig; exports.loadFarmMobileRuntime = loadFarmMobileRuntime; exports.loadFarmProductionVite = _chunkMF3IA2AWcjs.loadFarmProductionVite; exports.logger = _chunkVQJYGZNXcjs.logger; exports.resolveConfig = _chunkNPQLMP7Mcjs.resolveConfig; exports.resolveDeployConfig = _chunkNPQLMP7Mcjs.resolveDeployConfig; exports.resolveFarmDesktopBlock = _chunkAQLHD6HZcjs.resolveFarmDesktopBlock; exports.resolveFarmDesktopConfig = _chunkAQLHD6HZcjs.resolveFarmDesktopConfig; exports.setFarmDesktopDevSession = _chunkAQLHD6HZcjs.setFarmDesktopDevSession; exports.validateFarmDesktopConfig = _chunkAQLHD6HZcjs.validateFarmDesktopConfig;
+exports.createFarmDesktopContext = _chunkAQLHD6HZcjs.createFarmDesktopContext; exports.getFarmDesktopOutputDirs = _chunkAQLHD6HZcjs.getFarmDesktopOutputDirs; exports.installFarmDesktopSetup = _chunkAQLHD6HZcjs.installFarmDesktopSetup; exports.loadConfig = _chunkNQJDO7K7cjs.loadConfig; exports.loadFarmMobileRuntime = loadFarmMobileRuntime; exports.loadFarmProductionVite = _chunkMF3IA2AWcjs.loadFarmProductionVite; exports.logger = _chunkQMNWKQL4cjs.logger; exports.resolveConfig = _chunkNQJDO7K7cjs.resolveConfig; exports.resolveDeployConfig = _chunkNQJDO7K7cjs.resolveDeployConfig; exports.resolveFarmDesktopBlock = _chunkAQLHD6HZcjs.resolveFarmDesktopBlock; exports.resolveFarmDesktopConfig = _chunkAQLHD6HZcjs.resolveFarmDesktopConfig; exports.setFarmDesktopDevSession = _chunkAQLHD6HZcjs.setFarmDesktopDevSession; exports.validateFarmDesktopConfig = _chunkAQLHD6HZcjs.validateFarmDesktopConfig;

package/dist/internal/config-runtime.d.mts

@@ -1,10 +1,11 @@
-import { bo as ResolvedFarmConfig, p as FarmUserConfig } from '../client-plugins.d-Bx3FXpqm.mjs';
-export { bs as FarmDesktopDevSession, bt as FarmDesktopSetupOptions, bu as createFarmDesktopContext, bv as getFarmDesktopOutputDirs, bw as installFarmDesktopSetup, O as loadConfig, Q as resolveConfig, S as resolveDeployConfig, bx as resolveFarmDesktopBlock, by as resolveFarmDesktopConfig, bz as setFarmDesktopDevSession, bA as validateFarmDesktopConfig } from '../client-plugins.d-Bx3FXpqm.mjs';
+import { bo as ResolvedFarmConfig, p as FarmUserConfig } from '../client-plugins.d-CgQQ-EAv.mjs';
+export { bF as FarmDesktopDevSession, bG as FarmDesktopSetupOptions, bH as createFarmDesktopContext, bI as getFarmDesktopOutputDirs, bJ as installFarmDesktopSetup, O as loadConfig, Q as resolveConfig, S as resolveDeployConfig, bK as resolveFarmDesktopBlock, bL as resolveFarmDesktopConfig, bM as setFarmDesktopDevSession, bN as validateFarmDesktopConfig } from '../client-plugins.d-CgQQ-EAv.mjs';
 import { P as PlatformRouteFiles } from '../generate-route-types.d-BoVDU8qX.mjs';
-import { F as FarmMobileOS, f as FarmMobileNativeEngine, d as FarmMobileNativeAuto, l as FarmMobileScreen, c as FarmMobileContext, R as ResolvedFarmMobileConfig, o as FarmMobileBlockCache, a as FarmMobileBudgets, b as FarmMobileConfigInput, p as FarmMobileContextOptions, e as FarmMobileNativeConfig, g as FarmMobileNativeRouteConfig, h as FarmMobilePageConfig, i as FarmMobilePrefetch, j as FarmMobilePresentation, q as FarmMobileResolveOptions, k as FarmMobileRouteConfig, m as FarmMobileTab, n as FarmMobileUserConfig, r as ResolvedFarmMobileNativeConfig, s as createFarmMobileContext, t as resolveFarmMobileBlock, u as resolveFarmMobileConfig, v as resolveFarmMobileServer, w as validateFarmMobileConfig, x as validateFarmMobilePageConfig } from '../config.d-iRPI16ku.mjs';
-import { b as FarmMobileTier, c as FarmMobileScreenSource, d as FarmMobileRouteAnalysis, e as FarmMobileScreenDecision, f as FarmMobileAnalyzerStats, F as FarmMobileRouteManifest, g as FarmMobileBlocker, h as FarmMobileBlockerRule, i as FarmMobilePageExport, j as FarmMobileRouteManifestOptions, a as FarmMobileRouteRule, k as FarmMobileScreens, l as FarmMobileScreensOptions, m as FarmUiNode, n as createFarmMobileModuleId, o as createFarmMobileRouteManifest, p as createFarmMobileRoutePattern, r as readFarmMobilePageExport, q as resolveFarmMobileScreens } from '../routes.d-Cmv8TgVq.mjs';
+import { F as FarmMobileOS, i as FarmMobileNativeEngine, g as FarmMobileNativeAuto, o as FarmMobileRouteScreen, p as FarmMobileScreen, e as FarmMobileContext, R as ResolvedFarmMobileConfig, a as FarmMobileAppModules, x as FarmMobileBlockCache, c as FarmMobileBudgets, d as FarmMobileConfigInput, y as FarmMobileContextOptions, h as FarmMobileNativeConfig, j as FarmMobileNativeRouteConfig, k as FarmMobilePageConfig, l as FarmMobilePrefetch, m as FarmMobilePresentation, z as FarmMobileResolveOptions, n as FarmMobileRouteConfig, q as FarmMobileTab, r as FarmMobileUserConfig, A as ResolvedFarmMobileNativeConfig, B as createFarmMobileContext, C as resolveFarmMobileBlock, D as resolveFarmMobileConfig, E as resolveFarmMobileServer, G as validateFarmMobileConfig, H as validateFarmMobilePageConfig } from '../config.d-DqZkLwef.mjs';
+import { c as FarmMobileTier, d as FarmMobileScreenSource, e as FarmMobileRouteAnalysis, f as FarmMobileScreenDecision, g as FarmMobileAnalyzerStats, b as FarmMobileShellManifest, F as FarmMobileRouteManifest, h as FarmMobileBlocker, i as FarmMobileBlockerRule, j as FarmMobilePageExport, k as FarmMobileRouteManifestOptions, a as FarmMobileRouteRule, l as FarmMobileScreens, m as FarmMobileScreensOptions, n as FarmUiNode, o as createFarmMobileModuleId, p as createFarmMobileRouteManifest, q as createFarmMobileRoutePattern, r as readFarmMobilePageExport, s as resolveFarmMobileScreens } from '../routes.d-qd8Qf4LG.mjs';
+import { F as FARM_SHELL_PARAM_SEGMENT, a as FARM_SHELL_RENDER_HEADER, b as FARM_SHELL_ROUTE_HEADER, c as createFarmMobileShellRenderPath } from '../shell-render.d-CG6bPiiA.mjs';
 export { F as FarmProductionViteRuntime, l as loadFarmProductionVite } from '../production-vite.d-BQFAlG7n.mjs';
-export { l as logger } from '../utils.d-DRDazhCA.mjs';
+export { l as logger } from '../utils.d-uKZcKJk4.mjs';
 import '../lifecycle.d-C2aLBOwu.mjs';
 import '../route.d-BaVH3V0w.mjs';
 import '../endpoint.d-BkMSCRf6.mjs';
@@ -37,6 +38,13 @@ import '../types.d-C41ePjvP.mjs';
 import '../types.d-DQnyD3VD.mjs';
 import '../font.mjs';
 
+interface FarmMobilePort {
+    /** The screen module the native entry registers, relative to the ports directory. */
+    entry: string;
+    /** Generated sources, keyed by path relative to the ports directory. */
+    files: Record<string, string>;
+}
+
 /**
  * `.farm/output/mobile/native-report.json` and its terminal table: what each route shows, and
  * for routes the analyzer looked at, whether it could become a native screen and why not.
@@ -45,7 +53,7 @@ import '../font.mjs';
 interface FarmMobileNativeReportRoute {
     route: string;
     /** What `farm-routes.json` shows for the route. */
-    screen: FarmMobileScreen;
+    screen: FarmMobileRouteScreen;
     source: FarmMobileScreenSource;
     requested?: Exclude<FarmMobileScreen, "web">;
     /** The page export or screen file that decided, app-root-relative. */
@@ -88,6 +96,85 @@ declare function formatFarmMobileNativeReport(report: FarmMobileNativeReport, op
     file?: string;
 }): string;
 
+/** The page shells of one build, as a shell package writes them into the app. */
+interface FarmMobilePageShells extends FarmMobileShellManifest {
+    /** Shell HTML by file name, such as `{ "1a2b3c4d5e6f7a8b.html": "<!DOCTYPE html>..." }`. */
+    files: Record<string, string>;
+}
+interface FarmMobilePageShellOptions {
+    os: FarmMobileOS;
+    /**
+     * The text of a stylesheet the document links, by its href, such as `/assets/app-h1a2.css`;
+     * undefined for one the build did not write. iOS shells inline every stylesheet they can
+     * (`loadHTMLString` has no bundled files to load it from); Android loads it from the app.
+     */
+    readStylesheet?: (href: string) => string | undefined;
+}
+/**
+ * A rendered document as a page shell: every script and script preload removed (a shell never
+ * runs code; the real document does), the links that name the request's URL (`canonical`,
+ * `alternate`: locale and markdown versions) removed, so a shell is the same file for every route
+ * that shares it and carries no address of the build's server, `data-farm-page-shell` on `<html>`
+ * so app CSS can tell, and on iOS each stylesheet the build wrote inlined.
+ */
+declare function createFarmMobilePageShell(html: string, options: FarmMobilePageShellOptions): string;
+/** A shell's file name: its content hash, so equal shells share one file. */
+declare function getFarmMobilePageShellFile(shell: string): string;
+interface RenderFarmMobilePageShellsOptions extends FarmMobilePageShellOptions {
+    /** Page route patterns, route groups removed. */
+    routes: readonly string[];
+    /** The token the build's server answers shell requests with. */
+    token: string;
+    /** The app's basePath ("" or "/base"). */
+    basePath: string;
+    /** The mobile client entry of the build, from `mobile-client.json`. */
+    client: string;
+    /** Requests a path (with the base path) from the build's server. */
+    fetch: (path: string, init: {
+        headers: Record<string, string>;
+    }) => Promise<Response>;
+    /** Requests in flight at once; defaults to 4. */
+    concurrency?: number;
+}
+interface RenderedFarmMobilePageShells {
+    shells: FarmMobilePageShells;
+    /** Routes without a shell and why, for `--verbose` output. */
+    skipped: {
+        route: string;
+        reason: string;
+    }[];
+}
+/**
+ * Ask the build's server for each route's shell and keep the ones it renders. The server decides
+ * which routes qualify (a loading file and layouts in static folders) and says why the others do
+ * not; middleware and guards run as for any request, so a route they redirect gets no shell.
+ */
+declare function renderFarmMobilePageShells(options: RenderFarmMobilePageShellsOptions): Promise<RenderedFarmMobilePageShells>;
+
+/** `.farm/mobile-client.json` once the build has finished. */
+interface FarmMobileClientManifest {
+    version: 1;
+    /** The web client entry documents reference, such as `/farm-client-h1a2b3c4d.js`. */
+    webEntry: string;
+    /** The mobile client entry a shell's documents load instead. */
+    entry: string;
+    /** The stylesheet both clients use. */
+    stylesheet: string;
+    /**
+     * Every content-hashed file a shell's document loads, as URL paths: the mobile client's
+     * chunks and assets, the stylesheet, and the files the stylesheet references. A shell may
+     * answer exactly these paths from its bundle; a hashed name only ever has these bytes.
+     */
+    files: string[];
+    /**
+     * The client output the files are in, relative to the app root, when it is not the build
+     * directory's `client/`: the RSC pipeline (`@farm.js/plugin/rsc`) writes this manifest too.
+     */
+    clientDir?: string;
+}
+/** Read the finished manifest, or null when the last build had no mobile client. */
+declare function readFarmMobileClientManifest(buildDir: string): Promise<FarmMobileClientManifest | null>;
+
 /** An expected failure with its own fix; the CLI prints it without a stack. */
 declare class FarmMobileError extends Error {
     name: string;
@@ -104,7 +191,11 @@ declare function getFarmMobileOutputDirs(distDir: string): {
     /** Built apps, such as the debug APK. */
     dist: string;
     report: string;
+    /** Generated React Native ports of portable pages. */
+    ports: string;
     analyzerCache: string;
+    /** The production build's client output, which holds the mobile client a shell bundles. */
+    client: string;
 };
 interface FarmMobileAppOptions {
     root?: string;
@@ -128,6 +219,8 @@ interface FarmMobileAppOptions {
      * that a page with `export const mobile = { native: true }` is always checked.
      */
     analyze?: boolean | "always";
+    /** `farm build --mobile` with `mobile.shells`: the page shells it rendered, for the manifest. */
+    shells?: FarmMobileShellManifest;
 }
 interface FarmMobileApp {
     context: FarmMobileContext;
@@ -142,9 +235,13 @@ interface FarmMobileApp {
     nativeLayouts: Record<string, PlatformRouteFiles>;
     /** Absolute page file per file-based page route. */
     pageFiles: Map<string, string>;
+    /** The React Native port of each route Farm ported, written by `generateFarmMobileRoutes`. */
+    ports: Record<string, FarmMobilePort>;
     /** The analyzer's report, when it ran. */
     report?: FarmMobileNativeReport;
     analyzerStats?: FarmMobileAnalyzerStats;
+    /** The app's own native modules in `src/native/`, when it has any. */
+    appModules?: FarmMobileAppModules;
 }
 /** Resolve the `mobile` block for one OS against the app's routes. Writes nothing. */
 declare function resolveFarmMobileApp(options?: FarmMobileAppOptions): Promise<FarmMobileApp>;
@@ -158,6 +255,9 @@ declare function generateFarmMobileRoutes(options?: FarmMobileAppOptions): Promi
     table?: string;
 }>;
 
+declare const __mobile_runtime_FARM_SHELL_PARAM_SEGMENT: typeof FARM_SHELL_PARAM_SEGMENT;
+declare const __mobile_runtime_FARM_SHELL_RENDER_HEADER: typeof FARM_SHELL_RENDER_HEADER;
+declare const __mobile_runtime_FARM_SHELL_ROUTE_HEADER: typeof FARM_SHELL_ROUTE_HEADER;
 declare const __mobile_runtime_FarmMobileAnalyzerStats: typeof FarmMobileAnalyzerStats;
 type __mobile_runtime_FarmMobileApp = FarmMobileApp;
 type __mobile_runtime_FarmMobileAppOptions = FarmMobileAppOptions;
@@ -165,6 +265,7 @@ declare const __mobile_runtime_FarmMobileBlockCache: typeof FarmMobileBlockCache
 declare const __mobile_runtime_FarmMobileBlocker: typeof FarmMobileBlocker;
 declare const __mobile_runtime_FarmMobileBlockerRule: typeof FarmMobileBlockerRule;
 declare const __mobile_runtime_FarmMobileBudgets: typeof FarmMobileBudgets;
+type __mobile_runtime_FarmMobileClientManifest = FarmMobileClientManifest;
 declare const __mobile_runtime_FarmMobileConfigInput: typeof FarmMobileConfigInput;
 declare const __mobile_runtime_FarmMobileContext: typeof FarmMobileContext;
 declare const __mobile_runtime_FarmMobileContextOptions: typeof FarmMobileContextOptions;
@@ -179,6 +280,8 @@ declare const __mobile_runtime_FarmMobileNativeRouteConfig: typeof FarmMobileNat
 declare const __mobile_runtime_FarmMobileOS: typeof FarmMobileOS;
 declare const __mobile_runtime_FarmMobilePageConfig: typeof FarmMobilePageConfig;
 declare const __mobile_runtime_FarmMobilePageExport: typeof FarmMobilePageExport;
+type __mobile_runtime_FarmMobilePageShellOptions = FarmMobilePageShellOptions;
+type __mobile_runtime_FarmMobilePageShells = FarmMobilePageShells;
 declare const __mobile_runtime_FarmMobilePrefetch: typeof FarmMobilePrefetch;
 declare const __mobile_runtime_FarmMobilePresentation: typeof FarmMobilePresentation;
 declare const __mobile_runtime_FarmMobileResolveOptions: typeof FarmMobileResolveOptions;
@@ -187,26 +290,35 @@ declare const __mobile_runtime_FarmMobileRouteConfig: typeof FarmMobileRouteConf
 declare const __mobile_runtime_FarmMobileRouteManifest: typeof FarmMobileRouteManifest;
 declare const __mobile_runtime_FarmMobileRouteManifestOptions: typeof FarmMobileRouteManifestOptions;
 declare const __mobile_runtime_FarmMobileRouteRule: typeof FarmMobileRouteRule;
+declare const __mobile_runtime_FarmMobileRouteScreen: typeof FarmMobileRouteScreen;
 declare const __mobile_runtime_FarmMobileScreen: typeof FarmMobileScreen;
 declare const __mobile_runtime_FarmMobileScreenDecision: typeof FarmMobileScreenDecision;
 declare const __mobile_runtime_FarmMobileScreenSource: typeof FarmMobileScreenSource;
 declare const __mobile_runtime_FarmMobileScreens: typeof FarmMobileScreens;
 declare const __mobile_runtime_FarmMobileScreensOptions: typeof FarmMobileScreensOptions;
+declare const __mobile_runtime_FarmMobileShellManifest: typeof FarmMobileShellManifest;
 declare const __mobile_runtime_FarmMobileTab: typeof FarmMobileTab;
 declare const __mobile_runtime_FarmMobileTier: typeof FarmMobileTier;
 declare const __mobile_runtime_FarmMobileUserConfig: typeof FarmMobileUserConfig;
 declare const __mobile_runtime_FarmUiNode: typeof FarmUiNode;
+type __mobile_runtime_RenderFarmMobilePageShellsOptions = RenderFarmMobilePageShellsOptions;
+type __mobile_runtime_RenderedFarmMobilePageShells = RenderedFarmMobilePageShells;
 declare const __mobile_runtime_ResolvedFarmMobileConfig: typeof ResolvedFarmMobileConfig;
 declare const __mobile_runtime_ResolvedFarmMobileNativeConfig: typeof ResolvedFarmMobileNativeConfig;
 declare const __mobile_runtime_createFarmMobileContext: typeof createFarmMobileContext;
 declare const __mobile_runtime_createFarmMobileModuleId: typeof createFarmMobileModuleId;
 declare const __mobile_runtime_createFarmMobileNativeReport: typeof createFarmMobileNativeReport;
+declare const __mobile_runtime_createFarmMobilePageShell: typeof createFarmMobilePageShell;
 declare const __mobile_runtime_createFarmMobileRouteManifest: typeof createFarmMobileRouteManifest;
 declare const __mobile_runtime_createFarmMobileRoutePattern: typeof createFarmMobileRoutePattern;
+declare const __mobile_runtime_createFarmMobileShellRenderPath: typeof createFarmMobileShellRenderPath;
 declare const __mobile_runtime_formatFarmMobileNativeReport: typeof formatFarmMobileNativeReport;
 declare const __mobile_runtime_generateFarmMobileRoutes: typeof generateFarmMobileRoutes;
 declare const __mobile_runtime_getFarmMobileOutputDirs: typeof getFarmMobileOutputDirs;
+declare const __mobile_runtime_getFarmMobilePageShellFile: typeof getFarmMobilePageShellFile;
+declare const __mobile_runtime_readFarmMobileClientManifest: typeof readFarmMobileClientManifest;
 declare const __mobile_runtime_readFarmMobilePageExport: typeof readFarmMobilePageExport;
+declare const __mobile_runtime_renderFarmMobilePageShells: typeof renderFarmMobilePageShells;
 declare const __mobile_runtime_resolveFarmMobileApp: typeof resolveFarmMobileApp;
 declare const __mobile_runtime_resolveFarmMobileBlock: typeof resolveFarmMobileBlock;
 declare const __mobile_runtime_resolveFarmMobileConfig: typeof resolveFarmMobileConfig;
@@ -215,7 +327,7 @@ declare const __mobile_runtime_resolveFarmMobileServer: typeof resolveFarmMobile
 declare const __mobile_runtime_validateFarmMobileConfig: typeof validateFarmMobileConfig;
 declare const __mobile_runtime_validateFarmMobilePageConfig: typeof validateFarmMobilePageConfig;
 declare namespace __mobile_runtime {
-  export { __mobile_runtime_FarmMobileAnalyzerStats as FarmMobileAnalyzerStats, type __mobile_runtime_FarmMobileApp as FarmMobileApp, type __mobile_runtime_FarmMobileAppOptions as FarmMobileAppOptions, __mobile_runtime_FarmMobileBlockCache as FarmMobileBlockCache, __mobile_runtime_FarmMobileBlocker as FarmMobileBlocker, __mobile_runtime_FarmMobileBlockerRule as FarmMobileBlockerRule, __mobile_runtime_FarmMobileBudgets as FarmMobileBudgets, __mobile_runtime_FarmMobileConfigInput as FarmMobileConfigInput, __mobile_runtime_FarmMobileContext as FarmMobileContext, __mobile_runtime_FarmMobileContextOptions as FarmMobileContextOptions, __mobile_runtime_FarmMobileError as FarmMobileError, __mobile_runtime_FarmMobileNativeAuto as FarmMobileNativeAuto, __mobile_runtime_FarmMobileNativeConfig as FarmMobileNativeConfig, __mobile_runtime_FarmMobileNativeEngine as FarmMobileNativeEngine, type __mobile_runtime_FarmMobileNativeReport as FarmMobileNativeReport, type __mobile_runtime_FarmMobileNativeReportRoute as FarmMobileNativeReportRoute, __mobile_runtime_FarmMobileNativeRouteConfig as FarmMobileNativeRouteConfig, __mobile_runtime_FarmMobileOS as FarmMobileOS, __mobile_runtime_FarmMobilePageConfig as FarmMobilePageConfig, __mobile_runtime_FarmMobilePageExport as FarmMobilePageExport, __mobile_runtime_FarmMobilePrefetch as FarmMobilePrefetch, __mobile_runtime_FarmMobilePresentation as FarmMobilePresentation, __mobile_runtime_FarmMobileResolveOptions as FarmMobileResolveOptions, __mobile_runtime_FarmMobileRouteAnalysis as FarmMobileRouteAnalysis, __mobile_runtime_FarmMobileRouteConfig as FarmMobileRouteConfig, __mobile_runtime_FarmMobileRouteManifest as FarmMobileRouteManifest, __mobile_runtime_FarmMobileRouteManifestOptions as FarmMobileRouteManifestOptions, __mobile_runtime_FarmMobileRouteRule as FarmMobileRouteRule, __mobile_runtime_FarmMobileScreen as FarmMobileScreen, __mobile_runtime_FarmMobileScreenDecision as FarmMobileScreenDecision, __mobile_runtime_FarmMobileScreenSource as FarmMobileScreenSource, __mobile_runtime_FarmMobileScreens as FarmMobileScreens, __mobile_runtime_FarmMobileScreensOptions as FarmMobileScreensOptions, __mobile_runtime_FarmMobileTab as FarmMobileTab, __mobile_runtime_FarmMobileTier as FarmMobileTier, __mobile_runtime_FarmMobileUserConfig as FarmMobileUserConfig, __mobile_runtime_FarmUiNode as FarmUiNode, __mobile_runtime_ResolvedFarmMobileConfig as ResolvedFarmMobileConfig, __mobile_runtime_ResolvedFarmMobileNativeConfig as ResolvedFarmMobileNativeConfig, __mobile_runtime_createFarmMobileContext as createFarmMobileContext, __mobile_runtime_createFarmMobileModuleId as createFarmMobileModuleId, __mobile_runtime_createFarmMobileNativeReport as createFarmMobileNativeReport, __mobile_runtime_createFarmMobileRouteManifest as createFarmMobileRouteManifest, __mobile_runtime_createFarmMobileRoutePattern as createFarmMobileRoutePattern, __mobile_runtime_formatFarmMobileNativeReport as formatFarmMobileNativeReport, __mobile_runtime_generateFarmMobileRoutes as generateFarmMobileRoutes, __mobile_runtime_getFarmMobileOutputDirs as getFarmMobileOutputDirs, __mobile_runtime_readFarmMobilePageExport as readFarmMobilePageExport, __mobile_runtime_resolveFarmMobileApp as resolveFarmMobileApp, __mobile_runtime_resolveFarmMobileBlock as resolveFarmMobileBlock, __mobile_runtime_resolveFarmMobileConfig as resolveFarmMobileConfig, __mobile_runtime_resolveFarmMobileScreens as resolveFarmMobileScreens, __mobile_runtime_resolveFarmMobileServer as resolveFarmMobileServer, __mobile_runtime_validateFarmMobileConfig as validateFarmMobileConfig, __mobile_runtime_validateFarmMobilePageConfig as validateFarmMobilePageConfig };
+  export { __mobile_runtime_FARM_SHELL_PARAM_SEGMENT as FARM_SHELL_PARAM_SEGMENT, __mobile_runtime_FARM_SHELL_RENDER_HEADER as FARM_SHELL_RENDER_HEADER, __mobile_runtime_FARM_SHELL_ROUTE_HEADER as FARM_SHELL_ROUTE_HEADER, __mobile_runtime_FarmMobileAnalyzerStats as FarmMobileAnalyzerStats, type __mobile_runtime_FarmMobileApp as FarmMobileApp, type __mobile_runtime_FarmMobileAppOptions as FarmMobileAppOptions, __mobile_runtime_FarmMobileBlockCache as FarmMobileBlockCache, __mobile_runtime_FarmMobileBlocker as FarmMobileBlocker, __mobile_runtime_FarmMobileBlockerRule as FarmMobileBlockerRule, __mobile_runtime_FarmMobileBudgets as FarmMobileBudgets, type __mobile_runtime_FarmMobileClientManifest as FarmMobileClientManifest, __mobile_runtime_FarmMobileConfigInput as FarmMobileConfigInput, __mobile_runtime_FarmMobileContext as FarmMobileContext, __mobile_runtime_FarmMobileContextOptions as FarmMobileContextOptions, __mobile_runtime_FarmMobileError as FarmMobileError, __mobile_runtime_FarmMobileNativeAuto as FarmMobileNativeAuto, __mobile_runtime_FarmMobileNativeConfig as FarmMobileNativeConfig, __mobile_runtime_FarmMobileNativeEngine as FarmMobileNativeEngine, type __mobile_runtime_FarmMobileNativeReport as FarmMobileNativeReport, type __mobile_runtime_FarmMobileNativeReportRoute as FarmMobileNativeReportRoute, __mobile_runtime_FarmMobileNativeRouteConfig as FarmMobileNativeRouteConfig, __mobile_runtime_FarmMobileOS as FarmMobileOS, __mobile_runtime_FarmMobilePageConfig as FarmMobilePageConfig, __mobile_runtime_FarmMobilePageExport as FarmMobilePageExport, type __mobile_runtime_FarmMobilePageShellOptions as FarmMobilePageShellOptions, type __mobile_runtime_FarmMobilePageShells as FarmMobilePageShells, __mobile_runtime_FarmMobilePrefetch as FarmMobilePrefetch, __mobile_runtime_FarmMobilePresentation as FarmMobilePresentation, __mobile_runtime_FarmMobileResolveOptions as FarmMobileResolveOptions, __mobile_runtime_FarmMobileRouteAnalysis as FarmMobileRouteAnalysis, __mobile_runtime_FarmMobileRouteConfig as FarmMobileRouteConfig, __mobile_runtime_FarmMobileRouteManifest as FarmMobileRouteManifest, __mobile_runtime_FarmMobileRouteManifestOptions as FarmMobileRouteManifestOptions, __mobile_runtime_FarmMobileRouteRule as FarmMobileRouteRule, __mobile_runtime_FarmMobileRouteScreen as FarmMobileRouteScreen, __mobile_runtime_FarmMobileScreen as FarmMobileScreen, __mobile_runtime_FarmMobileScreenDecision as FarmMobileScreenDecision, __mobile_runtime_FarmMobileScreenSource as FarmMobileScreenSource, __mobile_runtime_FarmMobileScreens as FarmMobileScreens, __mobile_runtime_FarmMobileScreensOptions as FarmMobileScreensOptions, __mobile_runtime_FarmMobileShellManifest as FarmMobileShellManifest, __mobile_runtime_FarmMobileTab as FarmMobileTab, __mobile_runtime_FarmMobileTier as FarmMobileTier, __mobile_runtime_FarmMobileUserConfig as FarmMobileUserConfig, __mobile_runtime_FarmUiNode as FarmUiNode, type __mobile_runtime_RenderFarmMobilePageShellsOptions as RenderFarmMobilePageShellsOptions, type __mobile_runtime_RenderedFarmMobilePageShells as RenderedFarmMobilePageShells, __mobile_runtime_ResolvedFarmMobileConfig as ResolvedFarmMobileConfig, __mobile_runtime_ResolvedFarmMobileNativeConfig as ResolvedFarmMobileNativeConfig, __mobile_runtime_createFarmMobileContext as createFarmMobileContext, __mobile_runtime_createFarmMobileModuleId as createFarmMobileModuleId, __mobile_runtime_createFarmMobileNativeReport as createFarmMobileNativeReport, __mobile_runtime_createFarmMobilePageShell as createFarmMobilePageShell, __mobile_runtime_createFarmMobileRouteManifest as createFarmMobileRouteManifest, __mobile_runtime_createFarmMobileRoutePattern as createFarmMobileRoutePattern, __mobile_runtime_createFarmMobileShellRenderPath as createFarmMobileShellRenderPath, __mobile_runtime_formatFarmMobileNativeReport as formatFarmMobileNativeReport, __mobile_runtime_generateFarmMobileRoutes as generateFarmMobileRoutes, __mobile_runtime_getFarmMobileOutputDirs as getFarmMobileOutputDirs, __mobile_runtime_getFarmMobilePageShellFile as getFarmMobilePageShellFile, __mobile_runtime_readFarmMobileClientManifest as readFarmMobileClientManifest, __mobile_runtime_readFarmMobilePageExport as readFarmMobilePageExport, __mobile_runtime_renderFarmMobilePageShells as renderFarmMobilePageShells, __mobile_runtime_resolveFarmMobileApp as resolveFarmMobileApp, __mobile_runtime_resolveFarmMobileBlock as resolveFarmMobileBlock, __mobile_runtime_resolveFarmMobileConfig as resolveFarmMobileConfig, __mobile_runtime_resolveFarmMobileScreens as resolveFarmMobileScreens, __mobile_runtime_resolveFarmMobileServer as resolveFarmMobileServer, __mobile_runtime_validateFarmMobileConfig as validateFarmMobileConfig, __mobile_runtime_validateFarmMobilePageConfig as validateFarmMobilePageConfig };
 }
 
 /** The `mobile` block and its route manifest, loaded only by mobile commands. */

package/dist/internal/config-runtime.d.ts

@@ -1,10 +1,11 @@
-import { bo as ResolvedFarmConfig, p as FarmUserConfig } from '../client-plugins.d-TiLbS5j4.js';
-export { bs as FarmDesktopDevSession, bt as FarmDesktopSetupOptions, bu as createFarmDesktopContext, bv as getFarmDesktopOutputDirs, bw as installFarmDesktopSetup, O as loadConfig, Q as resolveConfig, S as resolveDeployConfig, bx as resolveFarmDesktopBlock, by as resolveFarmDesktopConfig, bz as setFarmDesktopDevSession, bA as validateFarmDesktopConfig } from '../client-plugins.d-TiLbS5j4.js';
+import { bo as ResolvedFarmConfig, p as FarmUserConfig } from '../client-plugins.d-vXrbcfJ1.js';
+export { bF as FarmDesktopDevSession, bG as FarmDesktopSetupOptions, bH as createFarmDesktopContext, bI as getFarmDesktopOutputDirs, bJ as installFarmDesktopSetup, O as loadConfig, Q as resolveConfig, S as resolveDeployConfig, bK as resolveFarmDesktopBlock, bL as resolveFarmDesktopConfig, bM as setFarmDesktopDevSession, bN as validateFarmDesktopConfig } from '../client-plugins.d-vXrbcfJ1.js';
 import { P as PlatformRouteFiles } from '../generate-route-types.d-BL2pq6xC.js';
-import { F as FarmMobileOS, f as FarmMobileNativeEngine, d as FarmMobileNativeAuto, l as FarmMobileScreen, c as FarmMobileContext, R as ResolvedFarmMobileConfig, o as FarmMobileBlockCache, a as FarmMobileBudgets, b as FarmMobileConfigInput, p as FarmMobileContextOptions, e as FarmMobileNativeConfig, g as FarmMobileNativeRouteConfig, h as FarmMobilePageConfig, i as FarmMobilePrefetch, j as FarmMobilePresentation, q as FarmMobileResolveOptions, k as FarmMobileRouteConfig, m as FarmMobileTab, n as FarmMobileUserConfig, r as ResolvedFarmMobileNativeConfig, s as createFarmMobileContext, t as resolveFarmMobileBlock, u as resolveFarmMobileConfig, v as resolveFarmMobileServer, w as validateFarmMobileConfig, x as validateFarmMobilePageConfig } from '../config.d-iRPI16ku.js';
-import { b as FarmMobileTier, c as FarmMobileScreenSource, d as FarmMobileRouteAnalysis, e as FarmMobileScreenDecision, f as FarmMobileAnalyzerStats, F as FarmMobileRouteManifest, g as FarmMobileBlocker, h as FarmMobileBlockerRule, i as FarmMobilePageExport, j as FarmMobileRouteManifestOptions, a as FarmMobileRouteRule, k as FarmMobileScreens, l as FarmMobileScreensOptions, m as FarmUiNode, n as createFarmMobileModuleId, o as createFarmMobileRouteManifest, p as createFarmMobileRoutePattern, r as readFarmMobilePageExport, q as resolveFarmMobileScreens } from '../routes.d-D96Dq9lz.js';
+import { F as FarmMobileOS, i as FarmMobileNativeEngine, g as FarmMobileNativeAuto, o as FarmMobileRouteScreen, p as FarmMobileScreen, e as FarmMobileContext, R as ResolvedFarmMobileConfig, a as FarmMobileAppModules, x as FarmMobileBlockCache, c as FarmMobileBudgets, d as FarmMobileConfigInput, y as FarmMobileContextOptions, h as FarmMobileNativeConfig, j as FarmMobileNativeRouteConfig, k as FarmMobilePageConfig, l as FarmMobilePrefetch, m as FarmMobilePresentation, z as FarmMobileResolveOptions, n as FarmMobileRouteConfig, q as FarmMobileTab, r as FarmMobileUserConfig, A as ResolvedFarmMobileNativeConfig, B as createFarmMobileContext, C as resolveFarmMobileBlock, D as resolveFarmMobileConfig, E as resolveFarmMobileServer, G as validateFarmMobileConfig, H as validateFarmMobilePageConfig } from '../config.d-DqZkLwef.js';
+import { c as FarmMobileTier, d as FarmMobileScreenSource, e as FarmMobileRouteAnalysis, f as FarmMobileScreenDecision, g as FarmMobileAnalyzerStats, b as FarmMobileShellManifest, F as FarmMobileRouteManifest, h as FarmMobileBlocker, i as FarmMobileBlockerRule, j as FarmMobilePageExport, k as FarmMobileRouteManifestOptions, a as FarmMobileRouteRule, l as FarmMobileScreens, m as FarmMobileScreensOptions, n as FarmUiNode, o as createFarmMobileModuleId, p as createFarmMobileRouteManifest, q as createFarmMobileRoutePattern, r as readFarmMobilePageExport, s as resolveFarmMobileScreens } from '../routes.d-BKSjHuH9.js';
+import { F as FARM_SHELL_PARAM_SEGMENT, a as FARM_SHELL_RENDER_HEADER, b as FARM_SHELL_ROUTE_HEADER, c as createFarmMobileShellRenderPath } from '../shell-render.d-CG6bPiiA.js';
 export { F as FarmProductionViteRuntime, l as loadFarmProductionVite } from '../production-vite.d-BQFAlG7n.js';
-export { l as logger } from '../utils.d-B77__yh8.js';
+export { l as logger } from '../utils.d-DwZ-KLSB.js';
 import '../lifecycle.d-C2aLBOwu.js';
 import '../route.d-DBTEqifW.js';
 import '../endpoint.d-BgHn0lhl.js';
@@ -37,6 +38,13 @@ import '../types.d-C41ePjvP.js';
 import '../types.d-DQnyD3VD.js';
 import '../font.js';
 
+interface FarmMobilePort {
+    /** The screen module the native entry registers, relative to the ports directory. */
+    entry: string;
+    /** Generated sources, keyed by path relative to the ports directory. */
+    files: Record<string, string>;
+}
+
 /**
  * `.farm/output/mobile/native-report.json` and its terminal table: what each route shows, and
  * for routes the analyzer looked at, whether it could become a native screen and why not.
@@ -45,7 +53,7 @@ import '../font.js';
 interface FarmMobileNativeReportRoute {
     route: string;
     /** What `farm-routes.json` shows for the route. */
-    screen: FarmMobileScreen;
+    screen: FarmMobileRouteScreen;
     source: FarmMobileScreenSource;
     requested?: Exclude<FarmMobileScreen, "web">;
     /** The page export or screen file that decided, app-root-relative. */
@@ -88,6 +96,85 @@ declare function formatFarmMobileNativeReport(report: FarmMobileNativeReport, op
     file?: string;
 }): string;
 
+/** The page shells of one build, as a shell package writes them into the app. */
+interface FarmMobilePageShells extends FarmMobileShellManifest {
+    /** Shell HTML by file name, such as `{ "1a2b3c4d5e6f7a8b.html": "<!DOCTYPE html>..." }`. */
+    files: Record<string, string>;
+}
+interface FarmMobilePageShellOptions {
+    os: FarmMobileOS;
+    /**
+     * The text of a stylesheet the document links, by its href, such as `/assets/app-h1a2.css`;
+     * undefined for one the build did not write. iOS shells inline every stylesheet they can
+     * (`loadHTMLString` has no bundled files to load it from); Android loads it from the app.
+     */
+    readStylesheet?: (href: string) => string | undefined;
+}
+/**
+ * A rendered document as a page shell: every script and script preload removed (a shell never
+ * runs code; the real document does), the links that name the request's URL (`canonical`,
+ * `alternate`: locale and markdown versions) removed, so a shell is the same file for every route
+ * that shares it and carries no address of the build's server, `data-farm-page-shell` on `<html>`
+ * so app CSS can tell, and on iOS each stylesheet the build wrote inlined.
+ */
+declare function createFarmMobilePageShell(html: string, options: FarmMobilePageShellOptions): string;
+/** A shell's file name: its content hash, so equal shells share one file. */
+declare function getFarmMobilePageShellFile(shell: string): string;
+interface RenderFarmMobilePageShellsOptions extends FarmMobilePageShellOptions {
+    /** Page route patterns, route groups removed. */
+    routes: readonly string[];
+    /** The token the build's server answers shell requests with. */
+    token: string;
+    /** The app's basePath ("" or "/base"). */
+    basePath: string;
+    /** The mobile client entry of the build, from `mobile-client.json`. */
+    client: string;
+    /** Requests a path (with the base path) from the build's server. */
+    fetch: (path: string, init: {
+        headers: Record<string, string>;
+    }) => Promise<Response>;
+    /** Requests in flight at once; defaults to 4. */
+    concurrency?: number;
+}
+interface RenderedFarmMobilePageShells {
+    shells: FarmMobilePageShells;
+    /** Routes without a shell and why, for `--verbose` output. */
+    skipped: {
+        route: string;
+        reason: string;
+    }[];
+}
+/**
+ * Ask the build's server for each route's shell and keep the ones it renders. The server decides
+ * which routes qualify (a loading file and layouts in static folders) and says why the others do
+ * not; middleware and guards run as for any request, so a route they redirect gets no shell.
+ */
+declare function renderFarmMobilePageShells(options: RenderFarmMobilePageShellsOptions): Promise<RenderedFarmMobilePageShells>;
+
+/** `.farm/mobile-client.json` once the build has finished. */
+interface FarmMobileClientManifest {
+    version: 1;
+    /** The web client entry documents reference, such as `/farm-client-h1a2b3c4d.js`. */
+    webEntry: string;
+    /** The mobile client entry a shell's documents load instead. */
+    entry: string;
+    /** The stylesheet both clients use. */
+    stylesheet: string;
+    /**
+     * Every content-hashed file a shell's document loads, as URL paths: the mobile client's
+     * chunks and assets, the stylesheet, and the files the stylesheet references. A shell may
+     * answer exactly these paths from its bundle; a hashed name only ever has these bytes.
+     */
+    files: string[];
+    /**
+     * The client output the files are in, relative to the app root, when it is not the build
+     * directory's `client/`: the RSC pipeline (`@farm.js/plugin/rsc`) writes this manifest too.
+     */
+    clientDir?: string;
+}
+/** Read the finished manifest, or null when the last build had no mobile client. */
+declare function readFarmMobileClientManifest(buildDir: string): Promise<FarmMobileClientManifest | null>;
+
 /** An expected failure with its own fix; the CLI prints it without a stack. */
 declare class FarmMobileError extends Error {
     name: string;
@@ -104,7 +191,11 @@ declare function getFarmMobileOutputDirs(distDir: string): {
     /** Built apps, such as the debug APK. */
     dist: string;
     report: string;
+    /** Generated React Native ports of portable pages. */
+    ports: string;
     analyzerCache: string;
+    /** The production build's client output, which holds the mobile client a shell bundles. */
+    client: string;
 };
 interface FarmMobileAppOptions {
     root?: string;
@@ -128,6 +219,8 @@ interface FarmMobileAppOptions {
      * that a page with `export const mobile = { native: true }` is always checked.
      */
     analyze?: boolean | "always";
+    /** `farm build --mobile` with `mobile.shells`: the page shells it rendered, for the manifest. */
+    shells?: FarmMobileShellManifest;
 }
 interface FarmMobileApp {
     context: FarmMobileContext;
@@ -142,9 +235,13 @@ interface FarmMobileApp {
     nativeLayouts: Record<string, PlatformRouteFiles>;
     /** Absolute page file per file-based page route. */
     pageFiles: Map<string, string>;
+    /** The React Native port of each route Farm ported, written by `generateFarmMobileRoutes`. */
+    ports: Record<string, FarmMobilePort>;
     /** The analyzer's report, when it ran. */
     report?: FarmMobileNativeReport;
     analyzerStats?: FarmMobileAnalyzerStats;
+    /** The app's own native modules in `src/native/`, when it has any. */
+    appModules?: FarmMobileAppModules;
 }
 /** Resolve the `mobile` block for one OS against the app's routes. Writes nothing. */
 declare function resolveFarmMobileApp(options?: FarmMobileAppOptions): Promise<FarmMobileApp>;
@@ -158,6 +255,9 @@ declare function generateFarmMobileRoutes(options?: FarmMobileAppOptions): Promi
     table?: string;
 }>;
 
+declare const __mobile_runtime_FARM_SHELL_PARAM_SEGMENT: typeof FARM_SHELL_PARAM_SEGMENT;
+declare const __mobile_runtime_FARM_SHELL_RENDER_HEADER: typeof FARM_SHELL_RENDER_HEADER;
+declare const __mobile_runtime_FARM_SHELL_ROUTE_HEADER: typeof FARM_SHELL_ROUTE_HEADER;
 declare const __mobile_runtime_FarmMobileAnalyzerStats: typeof FarmMobileAnalyzerStats;
 type __mobile_runtime_FarmMobileApp = FarmMobileApp;
 type __mobile_runtime_FarmMobileAppOptions = FarmMobileAppOptions;
@@ -165,6 +265,7 @@ declare const __mobile_runtime_FarmMobileBlockCache: typeof FarmMobileBlockCache
 declare const __mobile_runtime_FarmMobileBlocker: typeof FarmMobileBlocker;
 declare const __mobile_runtime_FarmMobileBlockerRule: typeof FarmMobileBlockerRule;
 declare const __mobile_runtime_FarmMobileBudgets: typeof FarmMobileBudgets;
+type __mobile_runtime_FarmMobileClientManifest = FarmMobileClientManifest;
 declare const __mobile_runtime_FarmMobileConfigInput: typeof FarmMobileConfigInput;
 declare const __mobile_runtime_FarmMobileContext: typeof FarmMobileContext;
 declare const __mobile_runtime_FarmMobileContextOptions: typeof FarmMobileContextOptions;
@@ -179,6 +280,8 @@ declare const __mobile_runtime_FarmMobileNativeRouteConfig: typeof FarmMobileNat
 declare const __mobile_runtime_FarmMobileOS: typeof FarmMobileOS;
 declare const __mobile_runtime_FarmMobilePageConfig: typeof FarmMobilePageConfig;
 declare const __mobile_runtime_FarmMobilePageExport: typeof FarmMobilePageExport;
+type __mobile_runtime_FarmMobilePageShellOptions = FarmMobilePageShellOptions;
+type __mobile_runtime_FarmMobilePageShells = FarmMobilePageShells;
 declare const __mobile_runtime_FarmMobilePrefetch: typeof FarmMobilePrefetch;
 declare const __mobile_runtime_FarmMobilePresentation: typeof FarmMobilePresentation;
 declare const __mobile_runtime_FarmMobileResolveOptions: typeof FarmMobileResolveOptions;
@@ -187,26 +290,35 @@ declare const __mobile_runtime_FarmMobileRouteConfig: typeof FarmMobileRouteConf
 declare const __mobile_runtime_FarmMobileRouteManifest: typeof FarmMobileRouteManifest;
 declare const __mobile_runtime_FarmMobileRouteManifestOptions: typeof FarmMobileRouteManifestOptions;
 declare const __mobile_runtime_FarmMobileRouteRule: typeof FarmMobileRouteRule;
+declare const __mobile_runtime_FarmMobileRouteScreen: typeof FarmMobileRouteScreen;
 declare const __mobile_runtime_FarmMobileScreen: typeof FarmMobileScreen;
 declare const __mobile_runtime_FarmMobileScreenDecision: typeof FarmMobileScreenDecision;
 declare const __mobile_runtime_FarmMobileScreenSource: typeof FarmMobileScreenSource;
 declare const __mobile_runtime_FarmMobileScreens: typeof FarmMobileScreens;
 declare const __mobile_runtime_FarmMobileScreensOptions: typeof FarmMobileScreensOptions;
+declare const __mobile_runtime_FarmMobileShellManifest: typeof FarmMobileShellManifest;
 declare const __mobile_runtime_FarmMobileTab: typeof FarmMobileTab;
 declare const __mobile_runtime_FarmMobileTier: typeof FarmMobileTier;
 declare const __mobile_runtime_FarmMobileUserConfig: typeof FarmMobileUserConfig;
 declare const __mobile_runtime_FarmUiNode: typeof FarmUiNode;
+type __mobile_runtime_RenderFarmMobilePageShellsOptions = RenderFarmMobilePageShellsOptions;
+type __mobile_runtime_RenderedFarmMobilePageShells = RenderedFarmMobilePageShells;
 declare const __mobile_runtime_ResolvedFarmMobileConfig: typeof ResolvedFarmMobileConfig;
 declare const __mobile_runtime_ResolvedFarmMobileNativeConfig: typeof ResolvedFarmMobileNativeConfig;
 declare const __mobile_runtime_createFarmMobileContext: typeof createFarmMobileContext;
 declare const __mobile_runtime_createFarmMobileModuleId: typeof createFarmMobileModuleId;
 declare const __mobile_runtime_createFarmMobileNativeReport: typeof createFarmMobileNativeReport;
+declare const __mobile_runtime_createFarmMobilePageShell: typeof createFarmMobilePageShell;
 declare const __mobile_runtime_createFarmMobileRouteManifest: typeof createFarmMobileRouteManifest;
 declare const __mobile_runtime_createFarmMobileRoutePattern: typeof createFarmMobileRoutePattern;
+declare const __mobile_runtime_createFarmMobileShellRenderPath: typeof createFarmMobileShellRenderPath;
 declare const __mobile_runtime_formatFarmMobileNativeReport: typeof formatFarmMobileNativeReport;
 declare const __mobile_runtime_generateFarmMobileRoutes: typeof generateFarmMobileRoutes;
 declare const __mobile_runtime_getFarmMobileOutputDirs: typeof getFarmMobileOutputDirs;
+declare const __mobile_runtime_getFarmMobilePageShellFile: typeof getFarmMobilePageShellFile;
+declare const __mobile_runtime_readFarmMobileClientManifest: typeof readFarmMobileClientManifest;
 declare const __mobile_runtime_readFarmMobilePageExport: typeof readFarmMobilePageExport;
+declare const __mobile_runtime_renderFarmMobilePageShells: typeof renderFarmMobilePageShells;
 declare const __mobile_runtime_resolveFarmMobileApp: typeof resolveFarmMobileApp;
 declare const __mobile_runtime_resolveFarmMobileBlock: typeof resolveFarmMobileBlock;
 declare const __mobile_runtime_resolveFarmMobileConfig: typeof resolveFarmMobileConfig;
@@ -215,7 +327,7 @@ declare const __mobile_runtime_resolveFarmMobileServer: typeof resolveFarmMobile
 declare const __mobile_runtime_validateFarmMobileConfig: typeof validateFarmMobileConfig;
 declare const __mobile_runtime_validateFarmMobilePageConfig: typeof validateFarmMobilePageConfig;
 declare namespace __mobile_runtime {
-  export { __mobile_runtime_FarmMobileAnalyzerStats as FarmMobileAnalyzerStats, type __mobile_runtime_FarmMobileApp as FarmMobileApp, type __mobile_runtime_FarmMobileAppOptions as FarmMobileAppOptions, __mobile_runtime_FarmMobileBlockCache as FarmMobileBlockCache, __mobile_runtime_FarmMobileBlocker as FarmMobileBlocker, __mobile_runtime_FarmMobileBlockerRule as FarmMobileBlockerRule, __mobile_runtime_FarmMobileBudgets as FarmMobileBudgets, __mobile_runtime_FarmMobileConfigInput as FarmMobileConfigInput, __mobile_runtime_FarmMobileContext as FarmMobileContext, __mobile_runtime_FarmMobileContextOptions as FarmMobileContextOptions, __mobile_runtime_FarmMobileError as FarmMobileError, __mobile_runtime_FarmMobileNativeAuto as FarmMobileNativeAuto, __mobile_runtime_FarmMobileNativeConfig as FarmMobileNativeConfig, __mobile_runtime_FarmMobileNativeEngine as FarmMobileNativeEngine, type __mobile_runtime_FarmMobileNativeReport as FarmMobileNativeReport, type __mobile_runtime_FarmMobileNativeReportRoute as FarmMobileNativeReportRoute, __mobile_runtime_FarmMobileNativeRouteConfig as FarmMobileNativeRouteConfig, __mobile_runtime_FarmMobileOS as FarmMobileOS, __mobile_runtime_FarmMobilePageConfig as FarmMobilePageConfig, __mobile_runtime_FarmMobilePageExport as FarmMobilePageExport, __mobile_runtime_FarmMobilePrefetch as FarmMobilePrefetch, __mobile_runtime_FarmMobilePresentation as FarmMobilePresentation, __mobile_runtime_FarmMobileResolveOptions as FarmMobileResolveOptions, __mobile_runtime_FarmMobileRouteAnalysis as FarmMobileRouteAnalysis, __mobile_runtime_FarmMobileRouteConfig as FarmMobileRouteConfig, __mobile_runtime_FarmMobileRouteManifest as FarmMobileRouteManifest, __mobile_runtime_FarmMobileRouteManifestOptions as FarmMobileRouteManifestOptions, __mobile_runtime_FarmMobileRouteRule as FarmMobileRouteRule, __mobile_runtime_FarmMobileScreen as FarmMobileScreen, __mobile_runtime_FarmMobileScreenDecision as FarmMobileScreenDecision, __mobile_runtime_FarmMobileScreenSource as FarmMobileScreenSource, __mobile_runtime_FarmMobileScreens as FarmMobileScreens, __mobile_runtime_FarmMobileScreensOptions as FarmMobileScreensOptions, __mobile_runtime_FarmMobileTab as FarmMobileTab, __mobile_runtime_FarmMobileTier as FarmMobileTier, __mobile_runtime_FarmMobileUserConfig as FarmMobileUserConfig, __mobile_runtime_FarmUiNode as FarmUiNode, __mobile_runtime_ResolvedFarmMobileConfig as ResolvedFarmMobileConfig, __mobile_runtime_ResolvedFarmMobileNativeConfig as ResolvedFarmMobileNativeConfig, __mobile_runtime_createFarmMobileContext as createFarmMobileContext, __mobile_runtime_createFarmMobileModuleId as createFarmMobileModuleId, __mobile_runtime_createFarmMobileNativeReport as createFarmMobileNativeReport, __mobile_runtime_createFarmMobileRouteManifest as createFarmMobileRouteManifest, __mobile_runtime_createFarmMobileRoutePattern as createFarmMobileRoutePattern, __mobile_runtime_formatFarmMobileNativeReport as formatFarmMobileNativeReport, __mobile_runtime_generateFarmMobileRoutes as generateFarmMobileRoutes, __mobile_runtime_getFarmMobileOutputDirs as getFarmMobileOutputDirs, __mobile_runtime_readFarmMobilePageExport as readFarmMobilePageExport, __mobile_runtime_resolveFarmMobileApp as resolveFarmMobileApp, __mobile_runtime_resolveFarmMobileBlock as resolveFarmMobileBlock, __mobile_runtime_resolveFarmMobileConfig as resolveFarmMobileConfig, __mobile_runtime_resolveFarmMobileScreens as resolveFarmMobileScreens, __mobile_runtime_resolveFarmMobileServer as resolveFarmMobileServer, __mobile_runtime_validateFarmMobileConfig as validateFarmMobileConfig, __mobile_runtime_validateFarmMobilePageConfig as validateFarmMobilePageConfig };
+  export { __mobile_runtime_FARM_SHELL_PARAM_SEGMENT as FARM_SHELL_PARAM_SEGMENT, __mobile_runtime_FARM_SHELL_RENDER_HEADER as FARM_SHELL_RENDER_HEADER, __mobile_runtime_FARM_SHELL_ROUTE_HEADER as FARM_SHELL_ROUTE_HEADER, __mobile_runtime_FarmMobileAnalyzerStats as FarmMobileAnalyzerStats, type __mobile_runtime_FarmMobileApp as FarmMobileApp, type __mobile_runtime_FarmMobileAppOptions as FarmMobileAppOptions, __mobile_runtime_FarmMobileBlockCache as FarmMobileBlockCache, __mobile_runtime_FarmMobileBlocker as FarmMobileBlocker, __mobile_runtime_FarmMobileBlockerRule as FarmMobileBlockerRule, __mobile_runtime_FarmMobileBudgets as FarmMobileBudgets, type __mobile_runtime_FarmMobileClientManifest as FarmMobileClientManifest, __mobile_runtime_FarmMobileConfigInput as FarmMobileConfigInput, __mobile_runtime_FarmMobileContext as FarmMobileContext, __mobile_runtime_FarmMobileContextOptions as FarmMobileContextOptions, __mobile_runtime_FarmMobileError as FarmMobileError, __mobile_runtime_FarmMobileNativeAuto as FarmMobileNativeAuto, __mobile_runtime_FarmMobileNativeConfig as FarmMobileNativeConfig, __mobile_runtime_FarmMobileNativeEngine as FarmMobileNativeEngine, type __mobile_runtime_FarmMobileNativeReport as FarmMobileNativeReport, type __mobile_runtime_FarmMobileNativeReportRoute as FarmMobileNativeReportRoute, __mobile_runtime_FarmMobileNativeRouteConfig as FarmMobileNativeRouteConfig, __mobile_runtime_FarmMobileOS as FarmMobileOS, __mobile_runtime_FarmMobilePageConfig as FarmMobilePageConfig, __mobile_runtime_FarmMobilePageExport as FarmMobilePageExport, type __mobile_runtime_FarmMobilePageShellOptions as FarmMobilePageShellOptions, type __mobile_runtime_FarmMobilePageShells as FarmMobilePageShells, __mobile_runtime_FarmMobilePrefetch as FarmMobilePrefetch, __mobile_runtime_FarmMobilePresentation as FarmMobilePresentation, __mobile_runtime_FarmMobileResolveOptions as FarmMobileResolveOptions, __mobile_runtime_FarmMobileRouteAnalysis as FarmMobileRouteAnalysis, __mobile_runtime_FarmMobileRouteConfig as FarmMobileRouteConfig, __mobile_runtime_FarmMobileRouteManifest as FarmMobileRouteManifest, __mobile_runtime_FarmMobileRouteManifestOptions as FarmMobileRouteManifestOptions, __mobile_runtime_FarmMobileRouteRule as FarmMobileRouteRule, __mobile_runtime_FarmMobileRouteScreen as FarmMobileRouteScreen, __mobile_runtime_FarmMobileScreen as FarmMobileScreen, __mobile_runtime_FarmMobileScreenDecision as FarmMobileScreenDecision, __mobile_runtime_FarmMobileScreenSource as FarmMobileScreenSource, __mobile_runtime_FarmMobileScreens as FarmMobileScreens, __mobile_runtime_FarmMobileScreensOptions as FarmMobileScreensOptions, __mobile_runtime_FarmMobileShellManifest as FarmMobileShellManifest, __mobile_runtime_FarmMobileTab as FarmMobileTab, __mobile_runtime_FarmMobileTier as FarmMobileTier, __mobile_runtime_FarmMobileUserConfig as FarmMobileUserConfig, __mobile_runtime_FarmUiNode as FarmUiNode, type __mobile_runtime_RenderFarmMobilePageShellsOptions as RenderFarmMobilePageShellsOptions, type __mobile_runtime_RenderedFarmMobilePageShells as RenderedFarmMobilePageShells, __mobile_runtime_ResolvedFarmMobileConfig as ResolvedFarmMobileConfig, __mobile_runtime_ResolvedFarmMobileNativeConfig as ResolvedFarmMobileNativeConfig, __mobile_runtime_createFarmMobileContext as createFarmMobileContext, __mobile_runtime_createFarmMobileModuleId as createFarmMobileModuleId, __mobile_runtime_createFarmMobileNativeReport as createFarmMobileNativeReport, __mobile_runtime_createFarmMobilePageShell as createFarmMobilePageShell, __mobile_runtime_createFarmMobileRouteManifest as createFarmMobileRouteManifest, __mobile_runtime_createFarmMobileRoutePattern as createFarmMobileRoutePattern, __mobile_runtime_createFarmMobileShellRenderPath as createFarmMobileShellRenderPath, __mobile_runtime_formatFarmMobileNativeReport as formatFarmMobileNativeReport, __mobile_runtime_generateFarmMobileRoutes as generateFarmMobileRoutes, __mobile_runtime_getFarmMobileOutputDirs as getFarmMobileOutputDirs, __mobile_runtime_getFarmMobilePageShellFile as getFarmMobilePageShellFile, __mobile_runtime_readFarmMobileClientManifest as readFarmMobileClientManifest, __mobile_runtime_readFarmMobilePageExport as readFarmMobilePageExport, __mobile_runtime_renderFarmMobilePageShells as renderFarmMobilePageShells, __mobile_runtime_resolveFarmMobileApp as resolveFarmMobileApp, __mobile_runtime_resolveFarmMobileBlock as resolveFarmMobileBlock, __mobile_runtime_resolveFarmMobileConfig as resolveFarmMobileConfig, __mobile_runtime_resolveFarmMobileScreens as resolveFarmMobileScreens, __mobile_runtime_resolveFarmMobileServer as resolveFarmMobileServer, __mobile_runtime_validateFarmMobileConfig as validateFarmMobileConfig, __mobile_runtime_validateFarmMobilePageConfig as validateFarmMobilePageConfig };
 }
 
 /** The `mobile` block and its route manifest, loaded only by mobile commands. */