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

package/dist/router.d-Bi23a6Xc.d.mts

@@ -1,50 +0,0 @@
-import { RefObject } from 'react';
-import { FarmRouterRouteInput } from './router.mjs';
-import { F as FarmNavigationBlockerContext, a as FarmNavigationState } from './spa-router.d-B2rIFGs0.mjs';
-
-interface UseRouterOptions {
-    basePath?: string;
-    routes?: FarmRouterRouteInput[];
-}
-interface UseBlockerOptions {
-    when: boolean | ((context: FarmNavigationBlockerContext) => boolean);
-    message?: string;
-    shouldBlock?: (context: FarmNavigationBlockerContext) => boolean | Promise<boolean>;
-}
-interface UseBlockerReturn {
-    active: boolean;
-}
-/**
- * Hook for accessing router state and navigation
- */
-/**
- * Imperative navigation for useRouter. Delegates to the installed SPA router
- * so blockers run before the URL changes, history state is written by the
- * router, and the action is labelled push/replace rather than pop. Without a
- * Farm router (embedded usage) the URL is written directly and announced on
- * the shared history channel, whose no-router fallback is the nuqs-style
- * synthetic popstate this code previously hand-rolled.
- */
-/** The options Next.js's router accepts on `push` and `replace`. */
-interface FarmRouterNavigateOptions {
-    /** Scroll to the top, or to the URL's hash, after navigating. Defaults to true. */
-    scroll?: boolean;
-}
-declare function useRouter(options?: UseRouterOptions): {
-    push: (href: string, navigateOptions?: FarmRouterNavigateOptions) => void;
-    replace: (href: string, navigateOptions?: FarmRouterNavigateOptions) => void;
-    pushState: <TState>(pageState: TState, href?: string) => void;
-    replaceState: <TState>(pageState: TState, href?: string) => void;
-    back: () => void;
-    forward: () => void;
-    pathname: string;
-    searchParams: URLSearchParams;
-    params: Record<string, string>;
-    pageState: unknown;
-};
-declare function usePageState<TState = unknown>(): TState | null;
-declare function useNavigation(): FarmNavigationState;
-declare function useBlocker(options: UseBlockerOptions): UseBlockerReturn;
-declare function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(key: string): RefObject<TElement | null>;
-
-export { type FarmRouterNavigateOptions as F, type UseBlockerOptions as U, type UseBlockerReturn as a, type UseRouterOptions as b, useNavigation as c, usePageState as d, useRouter as e, useScrollRestoration as f, useBlocker as u };

package/dist/router.d-DQ3k7EYn.d.ts

@@ -1,50 +0,0 @@
-import { RefObject } from 'react';
-import { FarmRouterRouteInput } from './router.js';
-import { F as FarmNavigationBlockerContext, a as FarmNavigationState } from './spa-router.d-DqZ6Lfs0.js';
-
-interface UseRouterOptions {
-    basePath?: string;
-    routes?: FarmRouterRouteInput[];
-}
-interface UseBlockerOptions {
-    when: boolean | ((context: FarmNavigationBlockerContext) => boolean);
-    message?: string;
-    shouldBlock?: (context: FarmNavigationBlockerContext) => boolean | Promise<boolean>;
-}
-interface UseBlockerReturn {
-    active: boolean;
-}
-/**
- * Hook for accessing router state and navigation
- */
-/**
- * Imperative navigation for useRouter. Delegates to the installed SPA router
- * so blockers run before the URL changes, history state is written by the
- * router, and the action is labelled push/replace rather than pop. Without a
- * Farm router (embedded usage) the URL is written directly and announced on
- * the shared history channel, whose no-router fallback is the nuqs-style
- * synthetic popstate this code previously hand-rolled.
- */
-/** The options Next.js's router accepts on `push` and `replace`. */
-interface FarmRouterNavigateOptions {
-    /** Scroll to the top, or to the URL's hash, after navigating. Defaults to true. */
-    scroll?: boolean;
-}
-declare function useRouter(options?: UseRouterOptions): {
-    push: (href: string, navigateOptions?: FarmRouterNavigateOptions) => void;
-    replace: (href: string, navigateOptions?: FarmRouterNavigateOptions) => void;
-    pushState: <TState>(pageState: TState, href?: string) => void;
-    replaceState: <TState>(pageState: TState, href?: string) => void;
-    back: () => void;
-    forward: () => void;
-    pathname: string;
-    searchParams: URLSearchParams;
-    params: Record<string, string>;
-    pageState: unknown;
-};
-declare function usePageState<TState = unknown>(): TState | null;
-declare function useNavigation(): FarmNavigationState;
-declare function useBlocker(options: UseBlockerOptions): UseBlockerReturn;
-declare function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(key: string): RefObject<TElement | null>;
-
-export { type FarmRouterNavigateOptions as F, type UseBlockerOptions as U, type UseBlockerReturn as a, type UseRouterOptions as b, useNavigation as c, usePageState as d, useRouter as e, useScrollRestoration as f, useBlocker as u };

package/dist/router.d.mts

@@ -1,36 +0,0 @@
-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.d.ts

@@ -1,36 +0,0 @@
-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/routes.d-BgTd7vI4.d.mts

@@ -1,208 +0,0 @@
-import { g as FarmI18nRouting } from './types.d-C41ePjvP.mjs';
-import { l as FarmMobileRouteScreen, m as FarmMobileScreen, j as FarmMobilePresentation, i as FarmMobilePrefetch, h as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, n as FarmMobileTab } from './config.d-DqKaCr1r.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">;
-    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>;
-    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[];
-    }>;
-}
-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;
-    /** Only when the page overrides the manifest's `prefetch`. */
-    prefetch?: FarmMobilePrefetch;
-}
-/** `.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[];
-}
-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;
-}
-/**
- * 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 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-C7jMJFvP.d.ts

@@ -1,208 +0,0 @@
-import { g as FarmI18nRouting } from './types.d-C41ePjvP.js';
-import { l as FarmMobileRouteScreen, m as FarmMobileScreen, j as FarmMobilePresentation, i as FarmMobilePrefetch, h as FarmMobilePageConfig, F as FarmMobileOS, R as ResolvedFarmMobileConfig, n as FarmMobileTab } from './config.d-DqKaCr1r.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">;
-    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>;
-    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[];
-    }>;
-}
-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;
-    /** Only when the page overrides the manifest's `prefetch`. */
-    prefetch?: FarmMobilePrefetch;
-}
-/** `.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[];
-}
-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;
-}
-/**
- * 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 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 };