@farm.js/core 0.1.61 → 0.1.62

package/dist/router.d.ts

@@ -0,0 +1,36 @@
+type FarmRouterPrimitiveParam = string | number | boolean;
+type FarmRouterPathParam = FarmRouterPrimitiveParam | readonly FarmRouterPrimitiveParam[] | null | undefined;
+type FarmRouterPathParams = Record<string, FarmRouterPathParam>;
+type FarmRouterParams = Record<string, string>;
+interface FarmRouterRoute<TMeta = unknown> {
+    path: string;
+    name?: string;
+    meta?: TMeta;
+}
+type FarmRouterRouteInput<TMeta = unknown> = string | FarmRouterRoute<TMeta>;
+interface FarmRouterMatch<TMeta = unknown> {
+    route: FarmRouterRoute<TMeta>;
+    pathname: string;
+    params: FarmRouterParams;
+}
+type FarmRouterQueryValue = FarmRouterPrimitiveParam | readonly FarmRouterPrimitiveParam[] | null | undefined;
+interface FarmRouterBuildOptions {
+    query?: URLSearchParams | Record<string, FarmRouterQueryValue>;
+    hash?: string;
+    trailingSlash?: boolean;
+}
+interface FarmRouterActiveOptions {
+    exact?: boolean;
+}
+interface FarmRouter<TMeta = unknown> {
+    routes: FarmRouterRoute<TMeta>[];
+    match(pathname: string): FarmRouterMatch<TMeta> | null;
+    build(pattern: string, params?: FarmRouterPathParams, options?: FarmRouterBuildOptions): string;
+    isActive(pattern: string, pathname: string, options?: FarmRouterActiveOptions): boolean;
+}
+declare function createFarmRouter<TMeta = unknown>(routes: FarmRouterRouteInput<TMeta>[]): FarmRouter<TMeta>;
+declare function matchFarmRoute(pattern: string, pathname: string): FarmRouterParams | null;
+declare function buildFarmRoutePath(pattern: string, params?: FarmRouterPathParams, options?: FarmRouterBuildOptions): string;
+declare function isFarmRouteActive(pattern: string, pathname: string, options?: FarmRouterActiveOptions): boolean;
+
+export { type FarmRouter, type FarmRouterActiveOptions, type FarmRouterBuildOptions, type FarmRouterMatch, type FarmRouterParams, type FarmRouterPathParam, type FarmRouterPathParams, type FarmRouterPrimitiveParam, type FarmRouterQueryValue, type FarmRouterRoute, type FarmRouterRouteInput, buildFarmRoutePath, createFarmRouter, isFarmRouteActive, matchFarmRoute };

package/dist/router.mjs

@@ -3,10 +3,10 @@ import {
   createFarmRouter,
   isFarmRouteActive,
   matchFarmRoute
-} from "./chunk-6NT6S2VQ.mjs";
-import "./chunk-OT6ZEW74.mjs";
-import "./chunk-55YI3RRB.mjs";
-import "./chunk-LPEX4YW6.mjs";
+} from "./chunk-BPAXGCKX.mjs";
+import "./chunk-MFQGU5CC.mjs";
+import "./chunk-AYP2YFVN.mjs";
+import "./chunk-Y6FXYEAI.mjs";
 export {
   buildFarmRoutePath,
   createFarmRouter,

package/dist/routes.cjs

@@ -19,17 +19,19 @@
 
 
 
-var _chunkIHNIDL6Hcjs = require('./chunk-IHNIDL6H.cjs');
-require('./chunk-6QQDAAAZ.cjs');
-require('./chunk-6V4TDWEC.cjs');
-require('./chunk-SOR334EB.cjs');
-require('./chunk-YWN746US.cjs');
-require('./chunk-E3UK5IIB.cjs');
-require('./chunk-LIUGYUX3.cjs');
-require('./chunk-NYJMY3JA.cjs');
-require('./chunk-ZEG3OPIB.cjs');
-require('./chunk-NO3WWW3N.cjs');
-require('./chunk-S3JO3N4H.cjs');
+var _chunk5A77OEIGcjs = require('./chunk-5A77OEIG.cjs');
+require('./chunk-X333W5KV.cjs');
+require('./chunk-E7QOEV5Z.cjs');
+require('./chunk-OYZXVBZP.cjs');
+require('./chunk-DMAP4RND.cjs');
+require('./chunk-SUCDVKUB.cjs');
+require('./chunk-EVIWKPJV.cjs');
+require('./chunk-AOKXITZ6.cjs');
+require('./chunk-DXUXQP2T.cjs');
+require('./chunk-UZCMMJJT.cjs');
+require('./chunk-3BIASUGR.cjs');
+require('./chunk-YTVSWXEZ.cjs');
+require('./chunk-BTZ5O6VM.cjs');
 
 
 
@@ -51,4 +53,4 @@ require('./chunk-S3JO3N4H.cjs');
 
 
 
-exports.PROGRAMMATIC_ROUTE_FILE_NAMES = _chunkIHNIDL6Hcjs.PROGRAMMATIC_ROUTE_FILE_NAMES; exports.api = _chunkIHNIDL6Hcjs.api; exports.createLayoutModuleFromProgrammaticLayout = _chunkIHNIDL6Hcjs.createLayoutModuleFromProgrammaticLayout; exports.createProgrammaticRouteModuleId = _chunkIHNIDL6Hcjs.createProgrammaticRouteModuleId; exports.createRoute = _chunkIHNIDL6Hcjs.createRoute; exports.createRouteModuleFromProgrammaticPage = _chunkIHNIDL6Hcjs.createRouteModuleFromProgrammaticPage; exports.defineRoutes = _chunkIHNIDL6Hcjs.defineRoutes; exports.getProgrammaticRouteManifest = _chunkIHNIDL6Hcjs.getProgrammaticRouteManifest; exports.getProgrammaticRouteSearchClientOptions = _chunkIHNIDL6Hcjs.getProgrammaticRouteSearchClientOptions; exports.getProgrammaticRouteSearchSchema = _chunkIHNIDL6Hcjs.getProgrammaticRouteSearchSchema; exports.isProgrammaticRouteDefinition = _chunkIHNIDL6Hcjs.isProgrammaticRouteDefinition; exports.isProgrammaticRouteManifest = _chunkIHNIDL6Hcjs.isProgrammaticRouteManifest; exports.isProgrammaticRoutesFileName = _chunkIHNIDL6Hcjs.isProgrammaticRoutesFileName; exports.layout = _chunkIHNIDL6Hcjs.layout; exports.page = _chunkIHNIDL6Hcjs.page; exports.parseProgrammaticRouteModuleId = _chunkIHNIDL6Hcjs.parseProgrammaticRouteModuleId; exports.parseProgrammaticRoutePath = _chunkIHNIDL6Hcjs.parseProgrammaticRoutePath; exports.redirect = _chunkIHNIDL6Hcjs.redirect; exports.routesBuilder = _chunkIHNIDL6Hcjs.routesBuilder; exports.scanProgrammaticPagePaths = _chunkIHNIDL6Hcjs.scanProgrammaticPagePaths;
+exports.PROGRAMMATIC_ROUTE_FILE_NAMES = _chunk5A77OEIGcjs.PROGRAMMATIC_ROUTE_FILE_NAMES; exports.api = _chunk5A77OEIGcjs.api; exports.createLayoutModuleFromProgrammaticLayout = _chunk5A77OEIGcjs.createLayoutModuleFromProgrammaticLayout; exports.createProgrammaticRouteModuleId = _chunk5A77OEIGcjs.createProgrammaticRouteModuleId; exports.createRoute = _chunk5A77OEIGcjs.createRoute; exports.createRouteModuleFromProgrammaticPage = _chunk5A77OEIGcjs.createRouteModuleFromProgrammaticPage; exports.defineRoutes = _chunk5A77OEIGcjs.defineRoutes; exports.getProgrammaticRouteManifest = _chunk5A77OEIGcjs.getProgrammaticRouteManifest; exports.getProgrammaticRouteSearchClientOptions = _chunk5A77OEIGcjs.getProgrammaticRouteSearchClientOptions; exports.getProgrammaticRouteSearchSchema = _chunk5A77OEIGcjs.getProgrammaticRouteSearchSchema; exports.isProgrammaticRouteDefinition = _chunk5A77OEIGcjs.isProgrammaticRouteDefinition; exports.isProgrammaticRouteManifest = _chunk5A77OEIGcjs.isProgrammaticRouteManifest; exports.isProgrammaticRoutesFileName = _chunk5A77OEIGcjs.isProgrammaticRoutesFileName; exports.layout = _chunk5A77OEIGcjs.layout; exports.page = _chunk5A77OEIGcjs.page; exports.parseProgrammaticRouteModuleId = _chunk5A77OEIGcjs.parseProgrammaticRouteModuleId; exports.parseProgrammaticRoutePath = _chunk5A77OEIGcjs.parseProgrammaticRoutePath; exports.redirect = _chunk5A77OEIGcjs.redirect; exports.routesBuilder = _chunk5A77OEIGcjs.routesBuilder; exports.scanProgrammaticPagePaths = _chunk5A77OEIGcjs.scanProgrammaticPagePaths;

package/dist/routes.d-BknKQcTu.d.ts

@@ -0,0 +1,237 @@
+import { g as FarmI18nRouting } from './types.d-C41ePjvP.js';
+import { o as FarmMobileRouteScreen, p as FarmMobileScreen, m as FarmMobilePresentation, l as FarmMobilePrefetch, k as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, q as FarmMobileTab } from './config.d-qt-mE8O5.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: FarmMobileRouteScreen;
+    source: FarmMobileScreenSource;
+    /** App-root-relative file that decided (`"page"`), or the screen's file. */
+    file?: string;
+    /** Native module id, derived from the route, such as `"app/notes/[id]"`. Not on web screens. */
+    module?: string;
+    /** The tier a config route or the analyzer asked for, while nothing can build it yet. */
+    requested?: Exclude<FarmMobileScreen, "web">;
+    /** The route has no `page.tsx` (RFC 0004, 7.3): mobile only, no web screen, no web fallback. */
+    nativeOnly?: boolean;
+    presentation: FarmMobilePresentation;
+    prefetch: FarmMobilePrefetch;
+}
+/** A page's static `export const mobile` and the file it came from. */
+interface FarmMobilePageExport {
+    file: string;
+    config: FarmMobilePageConfig;
+}
+interface FarmMobileScreensOptions {
+    root: string;
+    os: FarmMobileOS;
+    /** Page route patterns with route groups removed. */
+    routes: readonly string[];
+    mobile: Pick<ResolvedFarmMobileConfig, "routes" | "native">;
+    /** Absolute screen files per route. */
+    nativePages?: ReadonlyMap<string, PlatformRouteFiles>;
+    /** Routes with screen files and no `page.tsx`; always a subset of `nativePages`' keys. */
+    nativeOnlyRoutes?: ReadonlySet<string>;
+    pageExports?: ReadonlyMap<string, FarmMobilePageExport>;
+    /** Routes the analyzer would port; used only with `native.auto: "on"`. */
+    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[];
+    }>;
+    /** The generated React Native port of each route Farm ported, as an absolute screen file. */
+    portFiles?: ReadonlyMap<string, string>;
+    /** Why Farm could not emit the port of a portable route. */
+    portProblems?: ReadonlyMap<string, readonly string[]>;
+}
+interface FarmMobileScreens {
+    screens: Record<string, FarmMobileScreenDecision>;
+    /** Overridden settings, unused files, and ports nothing can build yet. */
+    warnings: string[];
+}
+/**
+ * The id a native screen registers under: the route under `app/`, route groups removed, such as
+ * `"app"` for `/` and `"app/notes/[id]"` for `/notes/[id]`. Never hand-written, so the shell,
+ * the native bundle, and the manifest cannot disagree.
+ */
+declare function createFarmMobileModuleId(route: string): string;
+declare function resolveFarmMobileScreens(options: FarmMobileScreensOptions): FarmMobileScreens;
+type Node = {
+    type: string;
+    [key: string]: unknown;
+};
+type ParseProgram = (file: string, source: string) => {
+    body: Node[];
+};
+/**
+ * A page's `export const mobile = { ... }`, read from its source without running it. Returns
+ * undefined when the page has no such export. Only literal values are allowed.
+ */
+declare function readFarmMobilePageExport(source: string, file: string, parse: ParseProgram, context?: {
+    os: FarmMobileOS;
+}): FarmMobilePageConfig | undefined;
+
+/**
+ * One navigator rule. The shell tests `pattern` against a link's decoded URL path, top to
+ * bottom, and uses the first match.
+ */
+interface FarmMobileRouteRule {
+    /** The app route pattern the rule came from, such as `"/notes/[id]"`. */
+    route?: string;
+    pattern: string;
+    /** `"tab"` switches to tab `tab` instead of presenting a screen. */
+    presentation: FarmMobilePresentation | "tab";
+    tab?: number;
+    screen: FarmMobileRouteScreen;
+    /** What decided `screen`: the page export, config, a screen file, the analyzer, or the default. */
+    source?: FarmMobileScreenSource;
+    /** Native module id derived from the route, such as `"app/notes/[id]"`. Not on web screens. */
+    module?: string;
+    /** The route has no web page (RFC 0004, 7.3): shells must not fall back to a web screen. */
+    nativeOnly?: true;
+    /** Only when the page overrides the manifest's `prefetch`. */
+    prefetch?: FarmMobilePrefetch;
+}
+/**
+ * The page shells bundled into the app (`mobile.shells`). A rule's `route` picks its shell; a
+ * route without one loads its document with no shell.
+ */
+interface FarmMobileShellManifest {
+    /**
+     * The mobile client entry the shells were rendered with, such as
+     * `/farm-mobile-client-h1a2b3c4d.js`. A document that loads another entry comes from a
+     * different client build, whose layouts the shells may not match, so the app stops showing
+     * them until a document loads this entry again.
+     */
+    client: string;
+    /** Shell file per page route, relative to the app's shell directory, such as `"1a2b3c4d5e6f7a8b.html"`. */
+    routes: Record<string, string>;
+}
+/** `.farm/output/mobile/farm-routes.json` (RFC 0004, 7.2). */
+interface FarmMobileRouteManifest {
+    version: 1;
+    server: string;
+    /** Tab roots; `path` includes the base path. */
+    tabs: FarmMobileTab[];
+    /** Default for every rule; a rule's own `prefetch` wins. */
+    prefetch: FarmMobilePrefetch;
+    rules: FarmMobileRouteRule[];
+    /** Only in `farm build --mobile` with `mobile.shells`, when at least one route has a shell. */
+    shells?: FarmMobileShellManifest;
+}
+interface FarmMobileRouteManifestOptions {
+    /** The app's page route patterns. */
+    routes: readonly string[];
+    /** Server origin; defaults to `mobile.server`. The CLI passes the dev server's in dev. */
+    server?: string;
+    basePath?: string;
+    i18n?: {
+        locales: readonly string[];
+        routing: FarmI18nRouting;
+    } | null;
+    /** Per-route screens; resolved from config alone (no page files) when omitted. */
+    screens?: Readonly<Record<string, FarmMobileScreenDecision>>;
+    /** The OS for the config-only fallback; defaults to `"android"`. */
+    os?: FarmMobileOS;
+    /** The page shells `farm build --mobile` rendered; written as `shells` when any route has one. */
+    shells?: FarmMobileShellManifest;
+}
+/**
+ * A regular expression, in the subset Kotlin, Swift, and JavaScript share, that matches the
+ * decoded URL paths the client router sends to `pattern`: the base path, an optional locale
+ * prefix, `[param]` as one segment, `[...rest]` as one or more, `[[...rest]]` as zero or more,
+ * route groups removed, and an optional trailing slash.
+ */
+declare function createFarmMobileRoutePattern(pattern: string, options?: Pick<FarmMobileRouteManifestOptions, "basePath" | "i18n">): string;
+/**
+ * The navigator manifest for a resolved `mobile` block: a rule for every page route, most
+ * specific first (the client router's order), then a catch-all push for other same-origin paths.
+ */
+declare function createFarmMobileRouteManifest(mobile: ResolvedFarmMobileConfig, options: FarmMobileRouteManifestOptions): FarmMobileRouteManifest;
+
+export { type FarmMobileRouteManifest as F, type FarmMobileRouteRule as a, type FarmMobileShellManifest as b, type FarmMobileTier as c, type FarmMobileScreenSource as d, type FarmMobileRouteAnalysis as e, type FarmMobileScreenDecision as f, type FarmMobileAnalyzerStats as g, type FarmMobileBlocker as h, type FarmMobileBlockerRule as i, type FarmMobilePageExport as j, type FarmMobileRouteManifestOptions as k, type FarmMobileScreens as l, type FarmMobileScreensOptions as m, type FarmUiNode as n, createFarmMobileModuleId as o, createFarmMobileRouteManifest as p, createFarmMobileRoutePattern as q, readFarmMobilePageExport as r, resolveFarmMobileScreens as s };

package/dist/routes.d-D1IrO9KK.d.mts

@@ -0,0 +1,237 @@
+import { g as FarmI18nRouting } from './types.d-C41ePjvP.mjs';
+import { o as FarmMobileRouteScreen, p as FarmMobileScreen, m as FarmMobilePresentation, l as FarmMobilePrefetch, k as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, q as FarmMobileTab } from './config.d-qt-mE8O5.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: FarmMobileRouteScreen;
+    source: FarmMobileScreenSource;
+    /** App-root-relative file that decided (`"page"`), or the screen's file. */
+    file?: string;
+    /** Native module id, derived from the route, such as `"app/notes/[id]"`. Not on web screens. */
+    module?: string;
+    /** The tier a config route or the analyzer asked for, while nothing can build it yet. */
+    requested?: Exclude<FarmMobileScreen, "web">;
+    /** The route has no `page.tsx` (RFC 0004, 7.3): mobile only, no web screen, no web fallback. */
+    nativeOnly?: boolean;
+    presentation: FarmMobilePresentation;
+    prefetch: FarmMobilePrefetch;
+}
+/** A page's static `export const mobile` and the file it came from. */
+interface FarmMobilePageExport {
+    file: string;
+    config: FarmMobilePageConfig;
+}
+interface FarmMobileScreensOptions {
+    root: string;
+    os: FarmMobileOS;
+    /** Page route patterns with route groups removed. */
+    routes: readonly string[];
+    mobile: Pick<ResolvedFarmMobileConfig, "routes" | "native">;
+    /** Absolute screen files per route. */
+    nativePages?: ReadonlyMap<string, PlatformRouteFiles>;
+    /** Routes with screen files and no `page.tsx`; always a subset of `nativePages`' keys. */
+    nativeOnlyRoutes?: ReadonlySet<string>;
+    pageExports?: ReadonlyMap<string, FarmMobilePageExport>;
+    /** Routes the analyzer would port; used only with `native.auto: "on"`. */
+    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[];
+    }>;
+    /** The generated React Native port of each route Farm ported, as an absolute screen file. */
+    portFiles?: ReadonlyMap<string, string>;
+    /** Why Farm could not emit the port of a portable route. */
+    portProblems?: ReadonlyMap<string, readonly string[]>;
+}
+interface FarmMobileScreens {
+    screens: Record<string, FarmMobileScreenDecision>;
+    /** Overridden settings, unused files, and ports nothing can build yet. */
+    warnings: string[];
+}
+/**
+ * The id a native screen registers under: the route under `app/`, route groups removed, such as
+ * `"app"` for `/` and `"app/notes/[id]"` for `/notes/[id]`. Never hand-written, so the shell,
+ * the native bundle, and the manifest cannot disagree.
+ */
+declare function createFarmMobileModuleId(route: string): string;
+declare function resolveFarmMobileScreens(options: FarmMobileScreensOptions): FarmMobileScreens;
+type Node = {
+    type: string;
+    [key: string]: unknown;
+};
+type ParseProgram = (file: string, source: string) => {
+    body: Node[];
+};
+/**
+ * A page's `export const mobile = { ... }`, read from its source without running it. Returns
+ * undefined when the page has no such export. Only literal values are allowed.
+ */
+declare function readFarmMobilePageExport(source: string, file: string, parse: ParseProgram, context?: {
+    os: FarmMobileOS;
+}): FarmMobilePageConfig | undefined;
+
+/**
+ * One navigator rule. The shell tests `pattern` against a link's decoded URL path, top to
+ * bottom, and uses the first match.
+ */
+interface FarmMobileRouteRule {
+    /** The app route pattern the rule came from, such as `"/notes/[id]"`. */
+    route?: string;
+    pattern: string;
+    /** `"tab"` switches to tab `tab` instead of presenting a screen. */
+    presentation: FarmMobilePresentation | "tab";
+    tab?: number;
+    screen: FarmMobileRouteScreen;
+    /** What decided `screen`: the page export, config, a screen file, the analyzer, or the default. */
+    source?: FarmMobileScreenSource;
+    /** Native module id derived from the route, such as `"app/notes/[id]"`. Not on web screens. */
+    module?: string;
+    /** The route has no web page (RFC 0004, 7.3): shells must not fall back to a web screen. */
+    nativeOnly?: true;
+    /** Only when the page overrides the manifest's `prefetch`. */
+    prefetch?: FarmMobilePrefetch;
+}
+/**
+ * The page shells bundled into the app (`mobile.shells`). A rule's `route` picks its shell; a
+ * route without one loads its document with no shell.
+ */
+interface FarmMobileShellManifest {
+    /**
+     * The mobile client entry the shells were rendered with, such as
+     * `/farm-mobile-client-h1a2b3c4d.js`. A document that loads another entry comes from a
+     * different client build, whose layouts the shells may not match, so the app stops showing
+     * them until a document loads this entry again.
+     */
+    client: string;
+    /** Shell file per page route, relative to the app's shell directory, such as `"1a2b3c4d5e6f7a8b.html"`. */
+    routes: Record<string, string>;
+}
+/** `.farm/output/mobile/farm-routes.json` (RFC 0004, 7.2). */
+interface FarmMobileRouteManifest {
+    version: 1;
+    server: string;
+    /** Tab roots; `path` includes the base path. */
+    tabs: FarmMobileTab[];
+    /** Default for every rule; a rule's own `prefetch` wins. */
+    prefetch: FarmMobilePrefetch;
+    rules: FarmMobileRouteRule[];
+    /** Only in `farm build --mobile` with `mobile.shells`, when at least one route has a shell. */
+    shells?: FarmMobileShellManifest;
+}
+interface FarmMobileRouteManifestOptions {
+    /** The app's page route patterns. */
+    routes: readonly string[];
+    /** Server origin; defaults to `mobile.server`. The CLI passes the dev server's in dev. */
+    server?: string;
+    basePath?: string;
+    i18n?: {
+        locales: readonly string[];
+        routing: FarmI18nRouting;
+    } | null;
+    /** Per-route screens; resolved from config alone (no page files) when omitted. */
+    screens?: Readonly<Record<string, FarmMobileScreenDecision>>;
+    /** The OS for the config-only fallback; defaults to `"android"`. */
+    os?: FarmMobileOS;
+    /** The page shells `farm build --mobile` rendered; written as `shells` when any route has one. */
+    shells?: FarmMobileShellManifest;
+}
+/**
+ * A regular expression, in the subset Kotlin, Swift, and JavaScript share, that matches the
+ * decoded URL paths the client router sends to `pattern`: the base path, an optional locale
+ * prefix, `[param]` as one segment, `[...rest]` as one or more, `[[...rest]]` as zero or more,
+ * route groups removed, and an optional trailing slash.
+ */
+declare function createFarmMobileRoutePattern(pattern: string, options?: Pick<FarmMobileRouteManifestOptions, "basePath" | "i18n">): string;
+/**
+ * The navigator manifest for a resolved `mobile` block: a rule for every page route, most
+ * specific first (the client router's order), then a catch-all push for other same-origin paths.
+ */
+declare function createFarmMobileRouteManifest(mobile: ResolvedFarmMobileConfig, options: FarmMobileRouteManifestOptions): FarmMobileRouteManifest;
+
+export { type FarmMobileRouteManifest as F, type FarmMobileRouteRule as a, type FarmMobileShellManifest as b, type FarmMobileTier as c, type FarmMobileScreenSource as d, type FarmMobileRouteAnalysis as e, type FarmMobileScreenDecision as f, type FarmMobileAnalyzerStats as g, type FarmMobileBlocker as h, type FarmMobileBlockerRule as i, type FarmMobilePageExport as j, type FarmMobileRouteManifestOptions as k, type FarmMobileScreens as l, type FarmMobileScreensOptions as m, type FarmUiNode as n, createFarmMobileModuleId as o, createFarmMobileRouteManifest as p, createFarmMobileRoutePattern as q, readFarmMobilePageExport as r, resolveFarmMobileScreens as s };