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

package/dist/{route-rendering.d-DShqKlgK.d.mts → route-rendering.d-Bpmw7PED.d.mts}

@@ -1,4 +1,4 @@
-import { i as RouteModule } from './client-plugins.d-C_3CdALC.mjs';
+import { i as RouteModule } from './client-plugins.d-Bx3FXpqm.mjs';
 
 /**
  * The rendering-mode merge shared by every consumer of route directives.

package/dist/{router.d-Bw3K3b0a.d.ts → router.d-Bd1x9XxQ.d.ts}

@@ -1,6 +1,6 @@
 import { RefObject } from 'react';
 import { FarmRouterRouteInput } from './router.js';
-import { F as FarmNavigationBlockerContext, a as FarmNavigationState } from './spa-router.d-C5opIgXg.js';
+import { F as FarmNavigationBlockerContext, a as FarmNavigationState } from './spa-router.d-CO01mVOM.js';
 
 interface UseRouterOptions {
     basePath?: string;

package/dist/{router.d-BE7i84fb.d.mts → router.d-e0jQ3jQ-.d.mts}

@@ -1,6 +1,6 @@
 import { RefObject } from 'react';
 import { FarmRouterRouteInput } from './router.mjs';
-import { F as FarmNavigationBlockerContext, a as FarmNavigationState } from './spa-router.d-D63jb6nX.mjs';
+import { F as FarmNavigationBlockerContext, a as FarmNavigationState } from './spa-router.d-BWDhS0FK.mjs';
 
 interface UseRouterOptions {
     basePath?: string;

package/dist/{routes.d-_5tBQexL.d.mts → routes.d-Cmv8TgVq.d.mts}

@@ -1,7 +1,89 @@
 import { g as FarmI18nRouting } from './types.d-C41ePjvP.mjs';
-import { l as FarmMobileScreen, j as FarmMobilePresentation, i as FarmMobilePrefetch, h as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, m as FarmMobileTab } from './config.d-CnhyvvmT.mjs';
+import { l as FarmMobileScreen, j as FarmMobilePresentation, i as FarmMobilePrefetch, h as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, m as FarmMobileTab } from './config.d-iRPI16ku.mjs';
 import { P as PlatformRouteFiles } from './generate-route-types.d-BoVDU8qX.mjs';
 
+type FarmUiNodeKind = "View" | "Text" | "Image" | "Pressable" | "TextInput" | "List";
+/** A minimal, platform-neutral UI tree for a portable component. No emitter reads it yet. */
+interface FarmUiNode {
+    kind: FarmUiNodeKind | "Component" | "Fragment";
+    /** The JSX tag it came from, such as `"button"` or `"Card"`. */
+    tag: string;
+    /** Static props, such as `href`, `src`, `alt`, `placeholder`. Expressions are `"{expr}"`. */
+    props?: Record<string, string | number | boolean>;
+    /** Tailwind classes and inline style keys that map to native style. */
+    style?: string[];
+    /** Event props, such as `["onClick"]`. */
+    events?: string[];
+    /** Static text children. */
+    text?: string;
+    children?: FarmUiNode[];
+}
+interface FarmMobileBlocker {
+    /** App-root-relative POSIX path. */
+    file: string;
+    line: number;
+    column: number;
+    rule: FarmMobileBlockerRule;
+    message: string;
+    /** Internal: the one tier this blocks. Reported blockers are split by tier instead. */
+    only?: Exclude<FarmMobileTier, "web">;
+}
+/**
+ * What a route can become on mobile. `"native"`: the server renders the page into a tree of
+ * native views, with no JavaScript on the device (no hooks, event handlers, or client
+ * components). `"react-native"`: a React Native screen ported from the page. `"web"`: a WebView.
+ */
+type FarmMobileTier = "native" | "react-native" | "web";
+type FarmMobileBlockerRule = "parse-error" | "markdown-page" | "programmatic-route" | "server-component" | "async-component" | "unmapped-element" | "dangerously-set-inner-html" | "content-editable" | "dom-ref" | "dom-event" | "spread-props" | "form-action" | "dynamic-component" | "runtime-class-name" | "class-name" | "runtime-style" | "style" | "browser-global" | "layout-effect" | "create-element" | "css-import" | "dom-package" | "unknown-package" | "unmapped-import" | "unresolved-import" | "dynamic-import" | "node-builtin" | "client-logic";
+type FarmMobileWin = "list" | "input" | "timer";
+interface FarmMobileElementCounts {
+    /** JSX elements in the route's modules, intrinsic and imported components. */
+    total: number;
+    /** Elements with a native mapping. */
+    mapped: number;
+    byKind: Partial<Record<FarmUiNodeKind, number>>;
+}
+interface FarmMobileRouteAnalysis {
+    route: string;
+    /** The first tier no blocker rules out: `"native"`, then `"react-native"`, then `"web"`. */
+    tier: FarmMobileTier;
+    /**
+     * `"port"`: portable and native would help (lists, input, timers). `"web"`: blocked, or
+     * portable with no win. Any doubt is web.
+     */
+    decision: "port" | "web";
+    portable: boolean;
+    /** What keeps a React Native port out: the page's module graph first, then its layouts'. */
+    blockers: FarmMobileBlocker[];
+    /**
+     * What keeps the server-rendered native tier out. The page's graph only: a native screen shows
+     * the page without its layouts, since the shell draws the chrome.
+     */
+    nativeBlockers: FarmMobileBlocker[];
+    wins: FarmMobileWin[];
+    elements: FarmMobileElementCounts;
+    /** `mapped / total`, rounded, 100 for a route with no elements. */
+    portablePercent: number;
+    /** App modules in the route's graph, page and layouts. */
+    modules: number;
+    /** Byte size of `ir` as JSON. Portable routes only. */
+    irBytes?: number;
+    ir?: FarmMobileRouteIR;
+}
+interface FarmMobileRouteIR {
+    /** The page component, as `"<file>#default"`. */
+    root: string;
+    components: Record<string, FarmUiNode>;
+}
+interface FarmMobileAnalyzerStats {
+    /** Distinct app modules read. */
+    modules: number;
+    /** Modules parsed in this run; the rest came from the content-hash cache. */
+    parsed: number;
+    cached: number;
+    ms: number;
+}
+
 type FarmMobileScreenSource = "page" | "config" | "file" | "analyzer" | "default";
 interface FarmMobileScreenDecision {
     screen: FarmMobileScreen;
@@ -33,6 +115,11 @@ interface FarmMobileScreensOptions {
     analyzerPorts?: ReadonlySet<string>;
     /** Why the analyzer cannot port a route, for config routes that ask for a port. */
     analyzerBlockers?: ReadonlyMap<string, readonly string[]>;
+    /** Each analyzed route's tier, and what rules out the native tier. */
+    analyzerTiers?: ReadonlyMap<string, {
+        tier: FarmMobileTier;
+        nativeBlockers: readonly string[];
+    }>;
 }
 interface FarmMobileScreens {
     screens: Record<string, FarmMobileScreenDecision>;
@@ -118,4 +205,4 @@ declare function createFarmMobileRoutePattern(pattern: string, options?: Pick<Fa
  */
 declare function createFarmMobileRouteManifest(mobile: ResolvedFarmMobileConfig, options: FarmMobileRouteManifestOptions): FarmMobileRouteManifest;
 
-export { type FarmMobileRouteManifest as F, type FarmMobileRouteRule as a, type FarmMobileScreenSource as b, type FarmMobileScreenDecision as c, type FarmMobilePageExport as d, type FarmMobileRouteManifestOptions as e, type FarmMobileScreens as f, type FarmMobileScreensOptions as g, createFarmMobileModuleId as h, createFarmMobileRouteManifest as i, createFarmMobileRoutePattern as j, resolveFarmMobileScreens as k, readFarmMobilePageExport as r };
+export { type FarmMobileRouteManifest as F, type FarmMobileRouteRule as a, type FarmMobileTier as b, type FarmMobileScreenSource as c, type FarmMobileRouteAnalysis as d, type FarmMobileScreenDecision as e, type FarmMobileAnalyzerStats as f, type FarmMobileBlocker as g, type FarmMobileBlockerRule as h, type FarmMobilePageExport as i, type FarmMobileRouteManifestOptions as j, type FarmMobileScreens as k, type FarmMobileScreensOptions as l, type FarmUiNode as m, createFarmMobileModuleId as n, createFarmMobileRouteManifest as o, createFarmMobileRoutePattern as p, resolveFarmMobileScreens as q, readFarmMobilePageExport as r };

package/dist/{routes.d-DVZQL0-H.d.ts → routes.d-D96Dq9lz.d.ts}

@@ -1,7 +1,89 @@
 import { g as FarmI18nRouting } from './types.d-C41ePjvP.js';
-import { l as FarmMobileScreen, j as FarmMobilePresentation, i as FarmMobilePrefetch, h as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, m as FarmMobileTab } from './config.d-CnhyvvmT.js';
+import { l as FarmMobileScreen, j as FarmMobilePresentation, i as FarmMobilePrefetch, h as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, m as FarmMobileTab } from './config.d-iRPI16ku.js';
 import { P as PlatformRouteFiles } from './generate-route-types.d-BL2pq6xC.js';
 
+type FarmUiNodeKind = "View" | "Text" | "Image" | "Pressable" | "TextInput" | "List";
+/** A minimal, platform-neutral UI tree for a portable component. No emitter reads it yet. */
+interface FarmUiNode {
+    kind: FarmUiNodeKind | "Component" | "Fragment";
+    /** The JSX tag it came from, such as `"button"` or `"Card"`. */
+    tag: string;
+    /** Static props, such as `href`, `src`, `alt`, `placeholder`. Expressions are `"{expr}"`. */
+    props?: Record<string, string | number | boolean>;
+    /** Tailwind classes and inline style keys that map to native style. */
+    style?: string[];
+    /** Event props, such as `["onClick"]`. */
+    events?: string[];
+    /** Static text children. */
+    text?: string;
+    children?: FarmUiNode[];
+}
+interface FarmMobileBlocker {
+    /** App-root-relative POSIX path. */
+    file: string;
+    line: number;
+    column: number;
+    rule: FarmMobileBlockerRule;
+    message: string;
+    /** Internal: the one tier this blocks. Reported blockers are split by tier instead. */
+    only?: Exclude<FarmMobileTier, "web">;
+}
+/**
+ * What a route can become on mobile. `"native"`: the server renders the page into a tree of
+ * native views, with no JavaScript on the device (no hooks, event handlers, or client
+ * components). `"react-native"`: a React Native screen ported from the page. `"web"`: a WebView.
+ */
+type FarmMobileTier = "native" | "react-native" | "web";
+type FarmMobileBlockerRule = "parse-error" | "markdown-page" | "programmatic-route" | "server-component" | "async-component" | "unmapped-element" | "dangerously-set-inner-html" | "content-editable" | "dom-ref" | "dom-event" | "spread-props" | "form-action" | "dynamic-component" | "runtime-class-name" | "class-name" | "runtime-style" | "style" | "browser-global" | "layout-effect" | "create-element" | "css-import" | "dom-package" | "unknown-package" | "unmapped-import" | "unresolved-import" | "dynamic-import" | "node-builtin" | "client-logic";
+type FarmMobileWin = "list" | "input" | "timer";
+interface FarmMobileElementCounts {
+    /** JSX elements in the route's modules, intrinsic and imported components. */
+    total: number;
+    /** Elements with a native mapping. */
+    mapped: number;
+    byKind: Partial<Record<FarmUiNodeKind, number>>;
+}
+interface FarmMobileRouteAnalysis {
+    route: string;
+    /** The first tier no blocker rules out: `"native"`, then `"react-native"`, then `"web"`. */
+    tier: FarmMobileTier;
+    /**
+     * `"port"`: portable and native would help (lists, input, timers). `"web"`: blocked, or
+     * portable with no win. Any doubt is web.
+     */
+    decision: "port" | "web";
+    portable: boolean;
+    /** What keeps a React Native port out: the page's module graph first, then its layouts'. */
+    blockers: FarmMobileBlocker[];
+    /**
+     * What keeps the server-rendered native tier out. The page's graph only: a native screen shows
+     * the page without its layouts, since the shell draws the chrome.
+     */
+    nativeBlockers: FarmMobileBlocker[];
+    wins: FarmMobileWin[];
+    elements: FarmMobileElementCounts;
+    /** `mapped / total`, rounded, 100 for a route with no elements. */
+    portablePercent: number;
+    /** App modules in the route's graph, page and layouts. */
+    modules: number;
+    /** Byte size of `ir` as JSON. Portable routes only. */
+    irBytes?: number;
+    ir?: FarmMobileRouteIR;
+}
+interface FarmMobileRouteIR {
+    /** The page component, as `"<file>#default"`. */
+    root: string;
+    components: Record<string, FarmUiNode>;
+}
+interface FarmMobileAnalyzerStats {
+    /** Distinct app modules read. */
+    modules: number;
+    /** Modules parsed in this run; the rest came from the content-hash cache. */
+    parsed: number;
+    cached: number;
+    ms: number;
+}
+
 type FarmMobileScreenSource = "page" | "config" | "file" | "analyzer" | "default";
 interface FarmMobileScreenDecision {
     screen: FarmMobileScreen;
@@ -33,6 +115,11 @@ interface FarmMobileScreensOptions {
     analyzerPorts?: ReadonlySet<string>;
     /** Why the analyzer cannot port a route, for config routes that ask for a port. */
     analyzerBlockers?: ReadonlyMap<string, readonly string[]>;
+    /** Each analyzed route's tier, and what rules out the native tier. */
+    analyzerTiers?: ReadonlyMap<string, {
+        tier: FarmMobileTier;
+        nativeBlockers: readonly string[];
+    }>;
 }
 interface FarmMobileScreens {
     screens: Record<string, FarmMobileScreenDecision>;
@@ -118,4 +205,4 @@ declare function createFarmMobileRoutePattern(pattern: string, options?: Pick<Fa
  */
 declare function createFarmMobileRouteManifest(mobile: ResolvedFarmMobileConfig, options: FarmMobileRouteManifestOptions): FarmMobileRouteManifest;
 
-export { type FarmMobileRouteManifest as F, type FarmMobileRouteRule as a, type FarmMobileScreenSource as b, type FarmMobileScreenDecision as c, type FarmMobilePageExport as d, type FarmMobileRouteManifestOptions as e, type FarmMobileScreens as f, type FarmMobileScreensOptions as g, createFarmMobileModuleId as h, createFarmMobileRouteManifest as i, createFarmMobileRoutePattern as j, resolveFarmMobileScreens as k, readFarmMobilePageExport as r };
+export { type FarmMobileRouteManifest as F, type FarmMobileRouteRule as a, type FarmMobileTier as b, type FarmMobileScreenSource as c, type FarmMobileRouteAnalysis as d, type FarmMobileScreenDecision as e, type FarmMobileAnalyzerStats as f, type FarmMobileBlocker as g, type FarmMobileBlockerRule as h, type FarmMobilePageExport as i, type FarmMobileRouteManifestOptions as j, type FarmMobileScreens as k, type FarmMobileScreensOptions as l, type FarmUiNode as m, createFarmMobileModuleId as n, createFarmMobileRouteManifest as o, createFarmMobileRoutePattern as p, resolveFarmMobileScreens as q, readFarmMobilePageExport as r };

package/dist/routes.d.mts

@@ -1,4 +1,4 @@
-import { v as FarmAppContext, w as PageProps, x as FarmSearchParams, y as PluginContextProps, f as FarmRouteRuntimeConfig, M as Metadata, i as RouteModule, L as LayoutProps, z as FarmRouteRuntime, A as FarmRouteRegions, C as FarmRouteMaxDuration, P as ParsedRoute } from './client-plugins.d-C_3CdALC.mjs';
+import { v as FarmAppContext, w as PageProps, x as FarmSearchParams, y as PluginContextProps, f as FarmRouteRuntimeConfig, M as Metadata, i as RouteModule, L as LayoutProps, z as FarmRouteRuntime, A as FarmRouteRegions, C as FarmRouteMaxDuration, P as ParsedRoute } from './client-plugins.d-Bx3FXpqm.mjs';
 import { ComponentType } from 'react';
 import { RouteDataCacheKey } from './cache.mjs';
 import { ServerFn } from './server-fn.mjs';
@@ -27,7 +27,7 @@ import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.mjs';
 import './types.d-C41ePjvP.mjs';
-import './config.d-CnhyvvmT.mjs';
+import './config.d-iRPI16ku.mjs';
 import './types.d-DQnyD3VD.mjs';
 import './font.mjs';
 import './deployment.mjs';

package/dist/routes.d.ts

@@ -1,4 +1,4 @@
-import { v as FarmAppContext, w as PageProps, x as FarmSearchParams, y as PluginContextProps, f as FarmRouteRuntimeConfig, M as Metadata, i as RouteModule, L as LayoutProps, z as FarmRouteRuntime, A as FarmRouteRegions, C as FarmRouteMaxDuration, P as ParsedRoute } from './client-plugins.d-C0n8Yhh-.js';
+import { v as FarmAppContext, w as PageProps, x as FarmSearchParams, y as PluginContextProps, f as FarmRouteRuntimeConfig, M as Metadata, i as RouteModule, L as LayoutProps, z as FarmRouteRuntime, A as FarmRouteRegions, C as FarmRouteMaxDuration, P as ParsedRoute } from './client-plugins.d-TiLbS5j4.js';
 import { ComponentType } from 'react';
 import { RouteDataCacheKey } from './cache.js';
 import { ServerFn } from './server-fn.js';
@@ -27,7 +27,7 @@ import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.js';
 import './types.d-C41ePjvP.js';
-import './config.d-CnhyvvmT.js';
+import './config.d-iRPI16ku.js';
 import './types.d-DQnyD3VD.js';
 import './font.js';
 import './deployment.js';

package/dist/{rsc-pipeline-IQI5XQLS.cjs → rsc-pipeline-DX4OC5FN.cjs}

@@ -2,7 +2,7 @@
 
 
 
-var _chunkTT66CP3Pcjs = require('./chunk-TT66CP3P.cjs');
+var _chunkNXBHYO7Scjs = require('./chunk-NXBHYO7S.cjs');
 
 
 
@@ -11,7 +11,7 @@ var _chunkTT66CP3Pcjs = require('./chunk-TT66CP3P.cjs');
 
 var _chunkSJ23LJ3Ncjs = require('./chunk-SJ23LJ3N.cjs');
 require('./chunk-XPMC4E2G.cjs');
-require('./chunk-VITZRYW3.cjs');
+require('./chunk-NPQLMP7M.cjs');
 require('./chunk-OZC2JPW6.cjs');
 require('./chunk-65Y5SIBH.cjs');
 require('./chunk-LNM57D3H.cjs');
@@ -80,4 +80,4 @@ require('./chunk-BTZ5O6VM.cjs');
 
 
 
-exports.FARM_RSC_PACKAGES = _chunkSJ23LJ3Ncjs.FARM_RSC_PACKAGES; exports.buildFarmRsc = _chunkTT66CP3Pcjs.buildFarmRsc; exports.createFarmRscDevServer = _chunkTT66CP3Pcjs.createFarmRscDevServer; exports.createFarmRscViteConfig = _chunkTT66CP3Pcjs.createFarmRscViteConfig; exports.farmAppUsesRscPipeline = _chunkSJ23LJ3Ncjs.farmAppUsesRscPipeline; exports.farmConfigUsesServerComponents = _chunkSJ23LJ3Ncjs.farmConfigUsesServerComponents; exports.inspectFarmServerComponents = _chunkSJ23LJ3Ncjs.inspectFarmServerComponents; exports.resolveFarmRscCheckConfig = _chunkSJ23LJ3Ncjs.resolveFarmRscCheckConfig;
+exports.FARM_RSC_PACKAGES = _chunkSJ23LJ3Ncjs.FARM_RSC_PACKAGES; exports.buildFarmRsc = _chunkNXBHYO7Scjs.buildFarmRsc; exports.createFarmRscDevServer = _chunkNXBHYO7Scjs.createFarmRscDevServer; exports.createFarmRscViteConfig = _chunkNXBHYO7Scjs.createFarmRscViteConfig; exports.farmAppUsesRscPipeline = _chunkSJ23LJ3Ncjs.farmAppUsesRscPipeline; exports.farmConfigUsesServerComponents = _chunkSJ23LJ3Ncjs.farmConfigUsesServerComponents; exports.inspectFarmServerComponents = _chunkSJ23LJ3Ncjs.inspectFarmServerComponents; exports.resolveFarmRscCheckConfig = _chunkSJ23LJ3Ncjs.resolveFarmRscCheckConfig;

package/dist/{rsc-pipeline-FBM6NFYY.mjs → rsc-pipeline-ZQ4CTVEG.mjs}

@@ -2,7 +2,7 @@ import {
   buildFarmRsc,
   createFarmRscDevServer,
   createFarmRscViteConfig
-} from "./chunk-SCRC5AMM.mjs";
+} from "./chunk-IBSAYAWB.mjs";
 import {
   FARM_RSC_PACKAGES,
   farmAppUsesRscPipeline,
@@ -11,7 +11,7 @@ import {
   resolveFarmRscCheckConfig
 } from "./chunk-SHS6KXOZ.mjs";
 import "./chunk-LMFJCXDD.mjs";
-import "./chunk-KMB5BMFX.mjs";
+import "./chunk-CTM4SPB3.mjs";
 import "./chunk-VISQDC6W.mjs";
 import "./chunk-QOSDWGKT.mjs";
 import "./chunk-PIHKO25G.mjs";

package/dist/{runtime-2JYIDUON.mjs → runtime-NPDRDV6R.mjs}

@@ -1,7 +1,7 @@
 import {
   loadConfig,
   resolveConfig
-} from "./chunk-KMB5BMFX.mjs";
+} from "./chunk-CTM4SPB3.mjs";
 import "./chunk-VISQDC6W.mjs";
 import {
   createPlatformBlockChecker,
@@ -241,10 +241,8 @@ function validateFarmMobilePageConfig(value, where, context) {
   checkKeys(value, PAGE_KEYS, `${where}: mobile.`);
   checkPresentation(value.presentation, `${where}: mobile`, check);
   checkPrefetch(value.prefetch, `${where}: mobile.`, check);
-  if (value.native !== void 0 && value.native !== false) {
-    fail(
-      `${where}: mobile.native can only be false. A native screen comes from a page.native.tsx next to the page.`
-    );
+  if (value.native !== void 0 && typeof value.native !== "boolean") {
+    fail(`${where}: mobile.native must be true or false.`);
   }
   return value;
 }
@@ -455,7 +453,15 @@ function resolveFarmMobileBlock(input, context, cache) {
 
 // src/mobile/report.ts
 function createFarmMobileNativeReport(options) {
-  const summary = { routes: 0, analyzed: 0, port: 0, portableNoWin: 0, blocked: 0, native: 0 };
+  const summary = {
+    routes: 0,
+    analyzed: 0,
+    port: 0,
+    portableNoWin: 0,
+    blocked: 0,
+    native: 0,
+    tiers: { native: 0, "react-native": 0, web: 0 }
+  };
   const routes = options.routes.map((route) => {
     const decision = options.screens[route];
     const analyzed = options.analysis[route];
@@ -463,6 +469,7 @@ function createFarmMobileNativeReport(options) {
     if (decision.screen !== "web") summary.native += 1;
     if (analyzed) {
       summary.analyzed += 1;
+      summary.tiers[analyzed.tier] += 1;
       if (analyzed.decision === "port") summary.port += 1;
       else if (analyzed.portable) summary.portableNoWin += 1;
       else summary.blocked += 1;
@@ -489,17 +496,20 @@ function createFarmMobileNativeReport(options) {
 function reasonFor(entry) {
   const analysis = entry.analysis;
   if (!analysis) {
-    if (entry.source === "page") return `${entry.file}: mobile.native false`;
+    if (entry.source === "page") {
+      return `${entry.file}: mobile.native ${entry.requested ? "true" : "false"}`;
+    }
     if (entry.source === "file") return entry.file;
     if (entry.source === "config") {
       return entry.file ? `native.routes, ${entry.file}` : "native.routes";
     }
     return "";
   }
+  if (analysis.tier === "native") return "renders natively, no JavaScript on the device";
   if (analysis.portable) {
     return analysis.wins.length > 0 ? `portable; ${analysis.wins.join(", ")}` : `portable; no win (${analysis.elements.total} elements)`;
   }
-  const [first, ...rest] = analysis.blockers;
+  const [first, ...rest] = analysis.nativeBlockers.length ? analysis.nativeBlockers : analysis.blockers;
   const where = first.file ? `${first.file}:${first.line}:${first.column} ` : "";
   return `${where}${first.message}${rest.length > 0 ? ` (+${rest.length} more)` : ""}`;
 }
@@ -507,12 +517,13 @@ function formatFarmMobileNativeReport(report, options = {}) {
   const rows = report.routes.map((entry) => [
     entry.route,
     entry.screen,
+    entry.analysis ? entry.analysis.tier : "-",
     entry.analysis ? entry.analysis.decision : "-",
     entry.analysis ? `${entry.analysis.elements.mapped}/${entry.analysis.elements.total}` : "",
     entry.analysis ? `${entry.analysis.portablePercent}%` : "",
     reasonFor(entry)
   ]);
-  const header = ["route", "screen", "decision", "mapped", "portable", "reason"];
+  const header = ["route", "screen", "tier", "decision", "mapped", "portable", "reason"];
   const widths = header.map(
     (title, column) => Math.min(
       column === 0 ? 40 : 12,
@@ -529,7 +540,8 @@ function formatFarmMobileNativeReport(report, options = {}) {
     line(header),
     ...rows.map(line),
     "",
-    `${summary.routes} routes: ${summary.port} port, ${summary.portableNoWin} portable without a win, ${summary.blocked} blocked, ${summary.native} native from files or config`
+    `${summary.routes} routes: ${summary.port} port, ${summary.portableNoWin} portable without a win, ${summary.blocked} blocked, ${summary.native} native from files or config`,
+    `tiers: ${summary.tiers.native} native, ${summary.tiers["react-native"]} react-native, ${summary.tiers.web} web`
   ];
   if (options.stats) {
     const { modules, parsed, cached, ms } = options.stats;
@@ -604,6 +616,38 @@ function resolveFarmMobileScreens(options) {
       screens[route] = { screen: "web", source: "page", file: page.file, ...base };
       continue;
     }
+    if (page?.config.native === true) {
+      if (tier !== void 0 && tier !== "native") {
+        warnings.push(`${page.file}: mobile.native true overrides ${where}.${tierKey} "${tier}".`);
+      }
+      const file2 = reactFile ?? platformFile;
+      if (file2) {
+        screens[route] = {
+          screen: reactFile ? "native" : "platform",
+          source: "page",
+          file: relativeFile(root, file2),
+          module,
+          ...base
+        };
+        continue;
+      }
+      const analysis = options.analyzerTiers?.get(route);
+      if (analysis && analysis.tier !== "native") {
+        throw new TypeError(
+          `${prefix}: ${page.file} sets mobile.native to true, but "${route}" cannot render as a native screen:
+${analysis.nativeBlockers.map((blocker) => `  - ${blocker}`).join("\n")}
+` + (analysis.tier === "react-native" ? "It needs JavaScript on the device: add page.native.tsx next to the page, or " : "Remove the blockers, add page.native.tsx next to the page, or ") + "remove mobile.native."
+        );
+      }
+      screens[route] = {
+        screen: "web",
+        source: "page",
+        file: page.file,
+        requested: "native",
+        ...base
+      };
+      continue;
+    }
     if (tier === "web") {
       screens[route] = { screen: "web", source: "config", ...base };
       continue;
@@ -822,6 +866,9 @@ function getFarmMobileOutputDirs(distDir) {
   };
 }
 var SCRIPT_PAGE = /\.(?:tsx|ts|jsx|js)$/;
+function describe(blocker) {
+  return `${blocker.file ? `${blocker.file}:${blocker.line}:${blocker.column} ` : ""}${blocker.message}`;
+}
 function scriptLang(file) {
   return file.endsWith(".tsx") ? "tsx" : file.endsWith(".ts") ? "ts" : "jsx";
 }
@@ -894,13 +941,14 @@ async function resolveFarmMobileApp(options = {}) {
   let { screens, warnings } = resolveFarmMobileScreens(screenOptions);
   let report;
   let analyzerStats;
-  const analyze = options.analyze === "always" || options.analyze === true && mobile.native.auto !== "off";
+  const asserted = [...pageExports.values()].some((page) => page.config.native === true);
+  const analyze = options.analyze === "always" || asserted || options.analyze === true && mobile.native.auto !== "off";
   if (analyze) {
     const candidates = routes.filter((route) => {
       const decision = screens[route];
       return decision.source === "default" || decision.requested !== void 0;
     });
-    const { analyzeFarmMobileRoutes } = await import("./analyzer-V74FTD2F.mjs");
+    const { analyzeFarmMobileRoutes } = await import("./analyzer-Z6TNEAET.mjs");
     const result = await analyzeFarmMobileRoutes({
       root,
       srcDir: config.srcDir,
@@ -916,11 +964,12 @@ async function resolveFarmMobileApp(options = {}) {
         Object.values(result.routes).filter((route) => route.decision === "port").map((route) => route.route)
       ),
       analyzerBlockers: new Map(
+        Object.values(result.routes).map((route) => [route.route, route.blockers.map(describe)])
+      ),
+      analyzerTiers: new Map(
         Object.values(result.routes).map((route) => [
           route.route,
-          route.blockers.map(
-            (blocker) => `${blocker.file ? `${blocker.file}:${blocker.line}:${blocker.column} ` : ""}${blocker.message}`
-          )
+          { tier: route.tier, nativeBlockers: route.nativeBlockers.map(describe) }
         ])
       )
     }));