@farm.js/core 0.1.49 → 0.1.51-beta.0

package/dist/client.d.ts

@@ -8,21 +8,21 @@ export { a as FarmClientCacheEntry, b as FarmClientCacheKey, F as FarmClientCach
 export { F as FarmIntegrationAPI, e as FarmIntegrationAPIBodyFormat, f as FarmIntegrationAPIMethod, g as FarmIntegrationAPIOperation, h as FarmIntegrationAPIResponseFormat, p as api, r as defineIntegrationAPI, s as defineIntegrationAPIOperation, t as endpoint } from './route-DFhZj6jN.js';
 export { UseThemeResult, useTheme } from './theme/client.js';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions } from './router.js';
-import { f as FarmViewTransitionMode } from './spa-router-B06APnGK.js';
-export { b as FarmNavigateOptions, c as FarmNavigationBlocker, F as FarmNavigationBlockerContext, d as FarmNavigationListener, e as FarmNavigationLocation, a as FarmNavigationState, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, h as pushState, r as readPageState, i as replaceState } from './spa-router-B06APnGK.js';
-import { c as FarmI18nLocale } from './types--Wh02r5_.js';
-export { U as UseBlockerOptions, a as UseBlockerReturn, b as UseRouterOptions, u as useBlocker, c as useNavigation, d as usePageState, e as useRouter, f as useScrollRestoration } from './router-xwLvi48p.js';
+import { f as FarmViewTransitionMode } from './spa-router-Kytv4jSB.js';
+export { b as FarmNavigateOptions, c as FarmNavigationBlocker, F as FarmNavigationBlockerContext, d as FarmNavigationListener, e as FarmNavigationLocation, a as FarmNavigationState, S as SPARouter, g as getRouter, n as navigateTo, p as prefetch, h as pushState, r as readPageState, i as replaceState } from './spa-router-Kytv4jSB.js';
+import { c as FarmI18nLocale } from './types-C41ePjvP.js';
+export { U as UseBlockerOptions, a as UseBlockerReturn, b as UseRouterOptions, u as useBlocker, c as useNavigation, d as usePageState, e as useRouter, f as useScrollRestoration } from './router-BUD_j2EL.js';
+export { F as FarmNavigationDelegate, a as FarmNavigationDelegateContext, d as delegateNavigation } from './navigation-delegate-BU4xqdnw.js';
 export { F as FarmChunkRecoveryOptions, i as installChunkErrorRecovery, a as isChunkLoadError } from './chunk-recovery-lnQFzcQP.js';
-export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, F as FarmClientPluginManager, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './lifecycle-DK06VuKP.js';
+export { b as FarmClientHydrationCompleteEvent, d as FarmClientHydrationEvent, e as FarmClientHydrationMode, f as FarmClientHydrationSession, g as FarmClientLocation, h as FarmClientNavigationAction, i as FarmClientNavigationErrorEvent, j as FarmClientNavigationEvent, k as FarmClientNavigationLoadedEvent, l as FarmClientNavigationResolvedEvent, m as FarmClientNavigationSession, n as FarmClientPerformanceEvent, a as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, F as FarmClientPluginManager, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './lifecycle-C2aLBOwu.js';
 export { S as ServerQueryFetchOptions, f as fetchServerQuery, p as prefetchServerQuery } from './server-query-runtime-DXRNhX_3.js';
 export { getTheme, setTheme, toggleTheme } from './theme/runtime.js';
 import './cache.js';
-import './cache-invalidation-BD0z_lfu.js';
 import './server-fn.js';
 import './server-fn-error-DrcH9cc1.js';
 import './server-query.js';
 import './types-DQnyD3VD.js';
-import './client-plugins-DFDQUI9Q.js';
+import './client-plugins-CFBEfVPO.js';
 import './renderer.js';
 import './deployment.js';
 import 'http';
@@ -35,17 +35,18 @@ import '@farming-labs/docs';
 import './observability-B2363jB6.js';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-Df1C_7OG.js';
+import './workflows-CRMzQZ3k.js';
 import './cron.js';
 import './env.js';
 import './server-action-security.js';
-import './layers-D9fbe-rz.js';
+import './layers-CcS42OGR.js';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-CeDgNyX4.js';
+import './config-CnhyvvmT.js';
 import './font.js';
 import './island-CfGru1MO.js';
-import './render-plan-B6cfssrr.js';
+import './render-plan-CrqcBbnV.js';
 
 type MutationStatus = "idle" | "pending" | "success" | "error";
 type AnyMutationTarget = (...args: any[]) => Promise<any>;

package/dist/client.mjs

@@ -13,27 +13,27 @@ import {
   storageClientCacheAdapter,
   useFetcher,
   useMutation
-} from "./chunk-VR4SEDEM.mjs";
+} from "./chunk-JWI5PUO2.mjs";
 import {
   installChunkErrorRecovery,
   isChunkLoadError
 } from "./chunk-O4F3JUST.mjs";
-import {
-  useAction
-} from "./chunk-GL3ZDHKI.mjs";
 import {
   useServerQuery
-} from "./chunk-MTB57GOK.mjs";
+} from "./chunk-724WT3NI.mjs";
 import {
-  useTheme
-} from "./chunk-EFLNOZGH.mjs";
+  useAction
+} from "./chunk-GL3ZDHKI.mjs";
 import {
   useBlocker,
   useNavigation,
   usePageState,
   useRouter,
   useScrollRestoration
-} from "./chunk-HAH4FBTA.mjs";
+} from "./chunk-VAHBCI6X.mjs";
+import {
+  useTheme
+} from "./chunk-EFLNOZGH.mjs";
 import {
   APIClientError,
   IntegrationClientError,
@@ -51,10 +51,11 @@ import {
   integrationsServer
 } from "./chunk-2NHOYYUT.mjs";
 import "./chunk-IAPTECEB.mjs";
+import "./chunk-Z64V4WZI.mjs";
 import {
   fetchServerQuery,
   prefetchServerQuery
-} from "./chunk-BNMHXVLL.mjs";
+} from "./chunk-XMHERKSE.mjs";
 import {
   getTheme,
   setTheme,
@@ -69,9 +70,11 @@ import {
   pushState,
   readPageState,
   replaceState
-} from "./chunk-VCFBQFOV.mjs";
+} from "./chunk-SN5VSO3Q.mjs";
 import "./chunk-PTLXHRJZ.mjs";
-import "./chunk-45EUIICW.mjs";
+import {
+  delegateNavigation
+} from "./chunk-G2KTRMWA.mjs";
 import "./chunk-NCIAP562.mjs";
 import {
   getFarmClientDataCache,
@@ -133,6 +136,7 @@ export {
   defineClientCacheAdapter,
   defineIntegrationAPI,
   defineIntegrationAPIOperation,
+  delegateNavigation,
   enableCrossTabCacheInvalidation,
   enableLiveCacheInvalidation,
   endpoint,

package/dist/client.react-server.mjs

@@ -1,2 +1,2 @@
 "use client";
-export { APIClientError, FARM_CACHE_INVALIDATION_CHANNEL, FARM_CLIENT_CACHE_PERSIST_VERSION, FarmClientPluginManager, FetcherInputError, IntegrationClientError, Link, SPARouter, api, clearPersistedCache, createAPIClient, createApiClients, createClientPluginManager, createIntegrationApi, createIntegrationClient, createIntegrationClients, createIntegrationServerClient, createIntegrations, createServerAPIClient, createStore, defineClientCacheAdapter, defineIntegrationAPI, defineIntegrationAPIOperation, enableCrossTabCacheInvalidation, enableLiveCacheInvalidation, endpoint, fetchServerQuery, getFarmClientDataCache, getIntegrationAPIManifest, getRouter, getTheme, initConfiguredClientCachePersistence, initPersistedClientCache, installChunkErrorRecovery, integrationClients, integrationsClient, integrationsServer, isChunkLoadError, navigateTo, normalizeFarmClientCacheKey, prefetch, prefetchServerQuery, pushState, readPageState, replaceState, setTheme, storageClientCacheAdapter, toggleTheme, useAction, useBlocker, useFetcher, useMutation, useNavigation, usePageState, useRouter, useScrollRestoration, useServerQuery, useTheme } from "./client.mjs";
+export { APIClientError, FARM_CACHE_INVALIDATION_CHANNEL, FARM_CLIENT_CACHE_PERSIST_VERSION, FarmClientPluginManager, FetcherInputError, IntegrationClientError, Link, SPARouter, api, clearPersistedCache, createAPIClient, createApiClients, createClientPluginManager, createIntegrationApi, createIntegrationClient, createIntegrationClients, createIntegrationServerClient, createIntegrations, createServerAPIClient, createStore, defineClientCacheAdapter, defineIntegrationAPI, defineIntegrationAPIOperation, delegateNavigation, enableCrossTabCacheInvalidation, enableLiveCacheInvalidation, endpoint, fetchServerQuery, getFarmClientDataCache, getIntegrationAPIManifest, getRouter, getTheme, initConfiguredClientCachePersistence, initPersistedClientCache, installChunkErrorRecovery, integrationClients, integrationsClient, integrationsServer, isChunkLoadError, navigateTo, normalizeFarmClientCacheKey, prefetch, prefetchServerQuery, pushState, readPageState, replaceState, setTheme, storageClientCacheAdapter, toggleTheme, useAction, useBlocker, useFetcher, useMutation, useNavigation, usePageState, useRouter, useScrollRestoration, useServerQuery, useTheme } from "./client.mjs";

package/dist/config-CnhyvvmT.d.mts

@@ -0,0 +1,188 @@
+/** Checks for one block, with errors prefixed by the block, such as `mobile (os: android)`. */
+interface PlatformBlockChecker {
+    fail(message: string): never;
+    checkKeys(value: Record<string, unknown>, allowed: ReadonlySet<string>, where: string): void;
+    optionalString(value: unknown, key: string): string | undefined;
+}
+/** Results of function-valued blocks for one dev session or build. */
+type PlatformBlockCache<T> = Map<string, Promise<T>>;
+
+type FarmMobileOS = "android" | "ios";
+/** How the native navigator shows a route: on a new stack screen, as a sheet, or in place. */
+type FarmMobilePresentation = "push" | "modal" | "replace";
+interface FarmMobileTab {
+    /** A static app route, such as `"/notes"`. Its screen is the tab's root. */
+    path: string;
+    title: string;
+    /** Platform icon name: an Android drawable or an SF Symbol on iOS, such as `"note.text"`. */
+    icon: string;
+}
+interface FarmMobileRouteConfig {
+    /** Defaults to `"push"`. A page's `export const mobile` wins. */
+    presentation?: FarmMobilePresentation;
+}
+/**
+ * What a route shows on mobile: a WebView of the web page (`"web"`), a screen from the
+ * `mobile.native.engine` (`"native"`), or a Compose or SwiftUI screen from `page.kt` or
+ * `page.swift` (`"platform"`).
+ */
+type FarmMobileScreen = "web" | "native" | "platform";
+/** What builds native screens. Only the decision is recorded for now; no engine ships yet. */
+type FarmMobileNativeEngine = "react-native" | "platform";
+/**
+ * The build-time analyzer that finds pages a native screen could replace. `"report"` writes
+ * `native-report.json`; `"on"` also records its decisions in the route manifest.
+ */
+type FarmMobileNativeAuto = "off" | "report" | "on";
+/** `"intent"` starts a route's data request when a link to it is pressed. */
+type FarmMobilePrefetch = "intent" | "off";
+interface FarmMobileNativeRouteConfig {
+    /**
+     * Wins over the route's native files and the analyzer. `"native"` uses `page.native.tsx` (or
+     * the OS file) and otherwise asks the analyzer to port the page; `"platform"` needs `page.kt`
+     * or `page.swift`; `"web"` keeps the route web even when native files exist.
+     */
+    screen: FarmMobileScreen;
+    /** Overrides `screen` on Android. */
+    android?: FarmMobileScreen;
+    /** Overrides `screen` on iOS. */
+    ios?: FarmMobileScreen;
+    /** Defaults to `"push"`. Set it here or in `mobile.routes`, not both. */
+    presentation?: FarmMobilePresentation;
+}
+interface FarmMobileBudgets {
+    /** Installed app size, in MB. */
+    appSizeMb?: number;
+    /** Time from a tap to the next screen's first frame, in ms. */
+    screenOpenMs?: number;
+    /** Dropped frames allowed per screen open. */
+    droppedFrames?: number;
+}
+interface FarmMobileNativeConfig {
+    /** Defaults to `"react-native"`. */
+    engine?: FarmMobileNativeEngine;
+    /** Defaults to `"report"`. */
+    auto?: FarmMobileNativeAuto;
+    /** Per-route screens and navigation, keyed by app route pattern such as `"/notes/[id]"`. */
+    routes?: Record<string, FarmMobileNativeRouteConfig>;
+    /**
+     * Components that may render as native views inside web screens, such as `"Map"`. Reserved:
+     * no islands render yet.
+     */
+    islands?: string[];
+    /** Default for every route; a page's `export const mobile` wins. Defaults to `"intent"`. */
+    prefetch?: FarmMobilePrefetch;
+    budgets?: FarmMobileBudgets;
+}
+/**
+ * A page's `export const mobile = { ... }`, read from `page.tsx` without running it, so its
+ * values must be literals.
+ */
+interface FarmMobilePageConfig {
+    presentation?: FarmMobilePresentation;
+    prefetch?: FarmMobilePrefetch;
+    /** `false` keeps the route a web screen, even with a `page.native.tsx`. */
+    native?: false;
+}
+interface FarmMobileUserConfig {
+    /** Display name of the app. Defaults to the package.json `productName` or `name`. */
+    name?: string;
+    /**
+     * Reverse-DNS app identifier, used as the Android application ID and the iOS bundle ID, such as
+     * `"com.example.notes"`. Stores key the app on it. Defaults to `local.farm.<name>`.
+     */
+    id?: string;
+    /**
+     * Origin of the web deployment whose pages the app shows, such as `"https://notes.example.com"`.
+     * `http://` is allowed only for loopback and LAN hosts in dev.
+     */
+    server?: string;
+    /** Tab bar entries, at most 5. Without tabs the app is one stack starting at `/`. */
+    tabs?: FarmMobileTab[];
+    /** Per-route navigation, keyed by app route pattern such as `"/notes/[id]"`. */
+    routes?: Record<string, FarmMobileRouteConfig>;
+    /** Screen tiers per route, the native engine, and the analyzer. */
+    native?: FarmMobileNativeConfig;
+}
+/** What a function-valued `mobile` block receives. Resolved once per OS per dev start or build. */
+interface FarmMobileContext {
+    os: FarmMobileOS;
+    mode: "development" | "production";
+    command: "dev" | "build";
+    /** `--profile`, `"production"` by default. */
+    profile: string;
+    env: Readonly<Record<string, string | undefined>>;
+    /** App root. */
+    root: string;
+}
+/**
+ * `mobile` in farm.config: a static block, or a function of the platform context that returns
+ * one. The function runs in the CLI only; its code never reaches a server or browser bundle.
+ */
+type FarmMobileConfigInput = FarmMobileUserConfig | ((context: FarmMobileContext) => FarmMobileUserConfig | Promise<FarmMobileUserConfig>);
+interface ResolvedFarmMobileNativeConfig {
+    engine: FarmMobileNativeEngine;
+    auto: FarmMobileNativeAuto;
+    /** Keyed by route pattern with route groups removed. */
+    routes: Record<string, FarmMobileNativeRouteConfig>;
+    islands: string[];
+    prefetch: FarmMobilePrefetch;
+    budgets: FarmMobileBudgets;
+}
+interface ResolvedFarmMobileConfig {
+    name: string;
+    id: string;
+    /** Origin, without a trailing slash. Undefined only when the CLI supplies one (dev). */
+    server?: string;
+    tabs: FarmMobileTab[];
+    /** `mobile.routes`, keyed by route pattern with route groups removed. */
+    routes: Record<string, FarmMobileRouteConfig>;
+    native: ResolvedFarmMobileNativeConfig;
+}
+/**
+ * The origin a mobile app loads pages from. `https://` anywhere; `http://` only for loopback and
+ * LAN hosts (the emulator's `10.0.2.2`, `192.168.x.y`, `*.local`) when `command` is `"dev"`.
+ */
+declare function resolveFarmMobileServer(value: string, context: Pick<FarmMobileContext, "command">, check?: PlatformBlockChecker, key?: string): string;
+/**
+ * Check a page's `export const mobile` value, already read from its source. `where` names the
+ * file in errors.
+ */
+declare function validateFarmMobilePageConfig(value: unknown, where: string, context?: Pick<FarmMobileContext, "os">): FarmMobilePageConfig;
+/**
+ * Check a returned or static `mobile` block's shape. Route and module existence are checked by
+ * `resolveFarmMobileConfig`, which has the app's routes.
+ */
+declare function validateFarmMobileConfig(input: unknown, context?: Pick<FarmMobileContext, "os" | "command">): FarmMobileUserConfig | undefined;
+interface FarmMobileResolveOptions {
+    root: string;
+    srcDir?: string;
+    /** The app's page route patterns, such as `"/notes/[id]"` (route groups removed). */
+    routes: readonly string[];
+}
+/**
+ * Fill in defaults for an already resolved (static or returned) `mobile` block and check it
+ * against the app: every tab, `routes`, and `native.routes` key must be a page route.
+ */
+declare function resolveFarmMobileConfig(input: FarmMobileUserConfig | undefined, options: FarmMobileResolveOptions, context: Pick<FarmMobileContext, "os" | "command">): ResolvedFarmMobileConfig;
+interface FarmMobileContextOptions {
+    command: FarmMobileContext["command"];
+    /** `--profile`; defaults to `"production"`. */
+    profile?: string;
+    /** Target OS; defaults to `"android"`, the first shell. */
+    os?: FarmMobileOS;
+    root: string;
+    mode: FarmMobileContext["mode"];
+}
+/** The context a function-valued block receives. `env` is a frozen snapshot. */
+declare function createFarmMobileContext(options: FarmMobileContextOptions): FarmMobileContext;
+/** Results of function-valued blocks for one dev session or build. */
+type FarmMobileBlockCache = PlatformBlockCache<FarmMobileUserConfig>;
+/**
+ * The plain `mobile` block for a context: the static object, or what the function returned.
+ * Validated, with errors naming the OS and field. With a cache, the function runs once per
+ * session and OS.
+ */
+declare function resolveFarmMobileBlock(input: FarmMobileConfigInput, context: FarmMobileContext, cache?: FarmMobileBlockCache): Promise<FarmMobileUserConfig>;
+
+export { type FarmMobileOS as F, type PlatformBlockCache as P, type ResolvedFarmMobileConfig as R, type FarmMobileBudgets as a, type FarmMobileConfigInput as b, type FarmMobileContext as c, type FarmMobileNativeAuto as d, type FarmMobileNativeConfig as e, type FarmMobileNativeEngine as f, type FarmMobileNativeRouteConfig as g, type FarmMobilePageConfig as h, type FarmMobilePrefetch as i, type FarmMobilePresentation as j, type FarmMobileRouteConfig as k, type FarmMobileScreen as l, type FarmMobileTab as m, type FarmMobileUserConfig as n, type FarmMobileBlockCache as o, type FarmMobileContextOptions as p, type FarmMobileResolveOptions as q, type ResolvedFarmMobileNativeConfig as r, createFarmMobileContext as s, resolveFarmMobileBlock as t, resolveFarmMobileConfig as u, resolveFarmMobileServer as v, validateFarmMobileConfig as w, validateFarmMobilePageConfig as x };

package/dist/config-CnhyvvmT.d.ts

@@ -0,0 +1,188 @@
+/** Checks for one block, with errors prefixed by the block, such as `mobile (os: android)`. */
+interface PlatformBlockChecker {
+    fail(message: string): never;
+    checkKeys(value: Record<string, unknown>, allowed: ReadonlySet<string>, where: string): void;
+    optionalString(value: unknown, key: string): string | undefined;
+}
+/** Results of function-valued blocks for one dev session or build. */
+type PlatformBlockCache<T> = Map<string, Promise<T>>;
+
+type FarmMobileOS = "android" | "ios";
+/** How the native navigator shows a route: on a new stack screen, as a sheet, or in place. */
+type FarmMobilePresentation = "push" | "modal" | "replace";
+interface FarmMobileTab {
+    /** A static app route, such as `"/notes"`. Its screen is the tab's root. */
+    path: string;
+    title: string;
+    /** Platform icon name: an Android drawable or an SF Symbol on iOS, such as `"note.text"`. */
+    icon: string;
+}
+interface FarmMobileRouteConfig {
+    /** Defaults to `"push"`. A page's `export const mobile` wins. */
+    presentation?: FarmMobilePresentation;
+}
+/**
+ * What a route shows on mobile: a WebView of the web page (`"web"`), a screen from the
+ * `mobile.native.engine` (`"native"`), or a Compose or SwiftUI screen from `page.kt` or
+ * `page.swift` (`"platform"`).
+ */
+type FarmMobileScreen = "web" | "native" | "platform";
+/** What builds native screens. Only the decision is recorded for now; no engine ships yet. */
+type FarmMobileNativeEngine = "react-native" | "platform";
+/**
+ * The build-time analyzer that finds pages a native screen could replace. `"report"` writes
+ * `native-report.json`; `"on"` also records its decisions in the route manifest.
+ */
+type FarmMobileNativeAuto = "off" | "report" | "on";
+/** `"intent"` starts a route's data request when a link to it is pressed. */
+type FarmMobilePrefetch = "intent" | "off";
+interface FarmMobileNativeRouteConfig {
+    /**
+     * Wins over the route's native files and the analyzer. `"native"` uses `page.native.tsx` (or
+     * the OS file) and otherwise asks the analyzer to port the page; `"platform"` needs `page.kt`
+     * or `page.swift`; `"web"` keeps the route web even when native files exist.
+     */
+    screen: FarmMobileScreen;
+    /** Overrides `screen` on Android. */
+    android?: FarmMobileScreen;
+    /** Overrides `screen` on iOS. */
+    ios?: FarmMobileScreen;
+    /** Defaults to `"push"`. Set it here or in `mobile.routes`, not both. */
+    presentation?: FarmMobilePresentation;
+}
+interface FarmMobileBudgets {
+    /** Installed app size, in MB. */
+    appSizeMb?: number;
+    /** Time from a tap to the next screen's first frame, in ms. */
+    screenOpenMs?: number;
+    /** Dropped frames allowed per screen open. */
+    droppedFrames?: number;
+}
+interface FarmMobileNativeConfig {
+    /** Defaults to `"react-native"`. */
+    engine?: FarmMobileNativeEngine;
+    /** Defaults to `"report"`. */
+    auto?: FarmMobileNativeAuto;
+    /** Per-route screens and navigation, keyed by app route pattern such as `"/notes/[id]"`. */
+    routes?: Record<string, FarmMobileNativeRouteConfig>;
+    /**
+     * Components that may render as native views inside web screens, such as `"Map"`. Reserved:
+     * no islands render yet.
+     */
+    islands?: string[];
+    /** Default for every route; a page's `export const mobile` wins. Defaults to `"intent"`. */
+    prefetch?: FarmMobilePrefetch;
+    budgets?: FarmMobileBudgets;
+}
+/**
+ * A page's `export const mobile = { ... }`, read from `page.tsx` without running it, so its
+ * values must be literals.
+ */
+interface FarmMobilePageConfig {
+    presentation?: FarmMobilePresentation;
+    prefetch?: FarmMobilePrefetch;
+    /** `false` keeps the route a web screen, even with a `page.native.tsx`. */
+    native?: false;
+}
+interface FarmMobileUserConfig {
+    /** Display name of the app. Defaults to the package.json `productName` or `name`. */
+    name?: string;
+    /**
+     * Reverse-DNS app identifier, used as the Android application ID and the iOS bundle ID, such as
+     * `"com.example.notes"`. Stores key the app on it. Defaults to `local.farm.<name>`.
+     */
+    id?: string;
+    /**
+     * Origin of the web deployment whose pages the app shows, such as `"https://notes.example.com"`.
+     * `http://` is allowed only for loopback and LAN hosts in dev.
+     */
+    server?: string;
+    /** Tab bar entries, at most 5. Without tabs the app is one stack starting at `/`. */
+    tabs?: FarmMobileTab[];
+    /** Per-route navigation, keyed by app route pattern such as `"/notes/[id]"`. */
+    routes?: Record<string, FarmMobileRouteConfig>;
+    /** Screen tiers per route, the native engine, and the analyzer. */
+    native?: FarmMobileNativeConfig;
+}
+/** What a function-valued `mobile` block receives. Resolved once per OS per dev start or build. */
+interface FarmMobileContext {
+    os: FarmMobileOS;
+    mode: "development" | "production";
+    command: "dev" | "build";
+    /** `--profile`, `"production"` by default. */
+    profile: string;
+    env: Readonly<Record<string, string | undefined>>;
+    /** App root. */
+    root: string;
+}
+/**
+ * `mobile` in farm.config: a static block, or a function of the platform context that returns
+ * one. The function runs in the CLI only; its code never reaches a server or browser bundle.
+ */
+type FarmMobileConfigInput = FarmMobileUserConfig | ((context: FarmMobileContext) => FarmMobileUserConfig | Promise<FarmMobileUserConfig>);
+interface ResolvedFarmMobileNativeConfig {
+    engine: FarmMobileNativeEngine;
+    auto: FarmMobileNativeAuto;
+    /** Keyed by route pattern with route groups removed. */
+    routes: Record<string, FarmMobileNativeRouteConfig>;
+    islands: string[];
+    prefetch: FarmMobilePrefetch;
+    budgets: FarmMobileBudgets;
+}
+interface ResolvedFarmMobileConfig {
+    name: string;
+    id: string;
+    /** Origin, without a trailing slash. Undefined only when the CLI supplies one (dev). */
+    server?: string;
+    tabs: FarmMobileTab[];
+    /** `mobile.routes`, keyed by route pattern with route groups removed. */
+    routes: Record<string, FarmMobileRouteConfig>;
+    native: ResolvedFarmMobileNativeConfig;
+}
+/**
+ * The origin a mobile app loads pages from. `https://` anywhere; `http://` only for loopback and
+ * LAN hosts (the emulator's `10.0.2.2`, `192.168.x.y`, `*.local`) when `command` is `"dev"`.
+ */
+declare function resolveFarmMobileServer(value: string, context: Pick<FarmMobileContext, "command">, check?: PlatformBlockChecker, key?: string): string;
+/**
+ * Check a page's `export const mobile` value, already read from its source. `where` names the
+ * file in errors.
+ */
+declare function validateFarmMobilePageConfig(value: unknown, where: string, context?: Pick<FarmMobileContext, "os">): FarmMobilePageConfig;
+/**
+ * Check a returned or static `mobile` block's shape. Route and module existence are checked by
+ * `resolveFarmMobileConfig`, which has the app's routes.
+ */
+declare function validateFarmMobileConfig(input: unknown, context?: Pick<FarmMobileContext, "os" | "command">): FarmMobileUserConfig | undefined;
+interface FarmMobileResolveOptions {
+    root: string;
+    srcDir?: string;
+    /** The app's page route patterns, such as `"/notes/[id]"` (route groups removed). */
+    routes: readonly string[];
+}
+/**
+ * Fill in defaults for an already resolved (static or returned) `mobile` block and check it
+ * against the app: every tab, `routes`, and `native.routes` key must be a page route.
+ */
+declare function resolveFarmMobileConfig(input: FarmMobileUserConfig | undefined, options: FarmMobileResolveOptions, context: Pick<FarmMobileContext, "os" | "command">): ResolvedFarmMobileConfig;
+interface FarmMobileContextOptions {
+    command: FarmMobileContext["command"];
+    /** `--profile`; defaults to `"production"`. */
+    profile?: string;
+    /** Target OS; defaults to `"android"`, the first shell. */
+    os?: FarmMobileOS;
+    root: string;
+    mode: FarmMobileContext["mode"];
+}
+/** The context a function-valued block receives. `env` is a frozen snapshot. */
+declare function createFarmMobileContext(options: FarmMobileContextOptions): FarmMobileContext;
+/** Results of function-valued blocks for one dev session or build. */
+type FarmMobileBlockCache = PlatformBlockCache<FarmMobileUserConfig>;
+/**
+ * The plain `mobile` block for a context: the static object, or what the function returned.
+ * Validated, with errors naming the OS and field. With a cache, the function runs once per
+ * session and OS.
+ */
+declare function resolveFarmMobileBlock(input: FarmMobileConfigInput, context: FarmMobileContext, cache?: FarmMobileBlockCache): Promise<FarmMobileUserConfig>;
+
+export { type FarmMobileOS as F, type PlatformBlockCache as P, type ResolvedFarmMobileConfig as R, type FarmMobileBudgets as a, type FarmMobileConfigInput as b, type FarmMobileContext as c, type FarmMobileNativeAuto as d, type FarmMobileNativeConfig as e, type FarmMobileNativeEngine as f, type FarmMobileNativeRouteConfig as g, type FarmMobilePageConfig as h, type FarmMobilePrefetch as i, type FarmMobilePresentation as j, type FarmMobileRouteConfig as k, type FarmMobileScreen as l, type FarmMobileTab as m, type FarmMobileUserConfig as n, type FarmMobileBlockCache as o, type FarmMobileContextOptions as p, type FarmMobileResolveOptions as q, type ResolvedFarmMobileNativeConfig as r, createFarmMobileContext as s, resolveFarmMobileBlock as t, resolveFarmMobileConfig as u, resolveFarmMobileServer as v, validateFarmMobileConfig as w, validateFarmMobilePageConfig as x };

package/dist/config.d.mts

@@ -1,9 +1,8 @@
-import { p as FarmUserConfig } from './client-plugins-BNBeyLMi.mjs';
-import './lifecycle-DK06VuKP.mjs';
+import { p as FarmUserConfig } from './client-plugins-cqy_dQd0.mjs';
+import './lifecycle-C2aLBOwu.mjs';
 import './route-2_yXC6gv.mjs';
 import './endpoint-BkMSCRf6.mjs';
 import './cache.mjs';
-import './cache-invalidation-BD0z_lfu.mjs';
 import './renderer.mjs';
 import './deployment.mjs';
 import 'http';
@@ -20,15 +19,16 @@ import '@farming-labs/docs';
 import './observability-B2363jB6.mjs';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-Df1C_7OG.mjs';
+import './workflows-CRMzQZ3k.mjs';
 import './cron.mjs';
 import './env.mjs';
 import './server-action-security.mjs';
-import './layers-D9fbe-rz.mjs';
+import './layers-CcS42OGR.mjs';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-CeDgNyX4.mjs';
-import './types--Wh02r5_.mjs';
+import './types-C41ePjvP.mjs';
+import './config-CnhyvvmT.mjs';
 import './types-DQnyD3VD.mjs';
 import './font.mjs';
 

package/dist/config.d.ts

@@ -1,9 +1,8 @@
-import { p as FarmUserConfig } from './client-plugins-DFDQUI9Q.js';
-import './lifecycle-DK06VuKP.js';
+import { p as FarmUserConfig } from './client-plugins-CFBEfVPO.js';
+import './lifecycle-C2aLBOwu.js';
 import './route-DFhZj6jN.js';
 import './endpoint-BgHn0lhl.js';
 import './cache.js';
-import './cache-invalidation-BD0z_lfu.js';
 import './renderer.js';
 import './deployment.js';
 import 'http';
@@ -20,15 +19,16 @@ import '@farming-labs/docs';
 import './observability-B2363jB6.js';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-Df1C_7OG.js';
+import './workflows-CRMzQZ3k.js';
 import './cron.js';
 import './env.js';
 import './server-action-security.js';
-import './layers-D9fbe-rz.js';
+import './layers-CcS42OGR.js';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-CeDgNyX4.js';
-import './types--Wh02r5_.js';
+import './types-C41ePjvP.js';
+import './config-CnhyvvmT.js';
 import './types-DQnyD3VD.js';
 import './font.js';
 

package/dist/cron.cjs

@@ -11,11 +11,11 @@
 
 
 
-var _chunkC7425KDGcjs = require('./chunk-C7425KDG.cjs');
+var _chunkXYL4HSVCcjs = require('./chunk-XYL4HSVC.cjs');
 require('./chunk-2KMIJDY6.cjs');
 require('./chunk-SHIWRBFI.cjs');
-require('./chunk-XN2MB4QZ.cjs');
-require('./chunk-JHXJBNLY.cjs');
+require('./chunk-VQJYGZNX.cjs');
+require('./chunk-SUCDVKUB.cjs');
 require('./chunk-6CTFVBAT.cjs');
 require('./chunk-YTVSWXEZ.cjs');
 require('./chunk-BTZ5O6VM.cjs');
@@ -32,4 +32,4 @@ require('./chunk-BTZ5O6VM.cjs');
 
 
 
-exports.DEFAULT_FARM_CRON_SECRET_ENV = _chunkC7425KDGcjs.DEFAULT_FARM_CRON_SECRET_ENV; exports.FARM_CRON_MANIFEST = _chunkC7425KDGcjs.FARM_CRON_MANIFEST; exports.applyFarmCronVercelCrons = _chunkC7425KDGcjs.applyFarmCronVercelCrons; exports.createFarmCronCloudflareConfig = _chunkC7425KDGcjs.createFarmCronCloudflareConfig; exports.createFarmCronCloudflareTriggers = _chunkC7425KDGcjs.createFarmCronCloudflareTriggers; exports.createFarmCronManifest = _chunkC7425KDGcjs.createFarmCronManifest; exports.createFarmCronVercelCrons = _chunkC7425KDGcjs.createFarmCronVercelCrons; exports.cronRoute = _chunkC7425KDGcjs.cronRoute; exports.isCronRequestAuthorized = _chunkC7425KDGcjs.isCronRequestAuthorized; exports.mergeScheduledTasks = _chunkC7425KDGcjs.mergeScheduledTasks; exports.prepareFarmCronForNitro = _chunkC7425KDGcjs.prepareFarmCronForNitro; exports.resolveCronConfig = _chunkC7425KDGcjs.resolveCronConfig;
+exports.DEFAULT_FARM_CRON_SECRET_ENV = _chunkXYL4HSVCcjs.DEFAULT_FARM_CRON_SECRET_ENV; exports.FARM_CRON_MANIFEST = _chunkXYL4HSVCcjs.FARM_CRON_MANIFEST; exports.applyFarmCronVercelCrons = _chunkXYL4HSVCcjs.applyFarmCronVercelCrons; exports.createFarmCronCloudflareConfig = _chunkXYL4HSVCcjs.createFarmCronCloudflareConfig; exports.createFarmCronCloudflareTriggers = _chunkXYL4HSVCcjs.createFarmCronCloudflareTriggers; exports.createFarmCronManifest = _chunkXYL4HSVCcjs.createFarmCronManifest; exports.createFarmCronVercelCrons = _chunkXYL4HSVCcjs.createFarmCronVercelCrons; exports.cronRoute = _chunkXYL4HSVCcjs.cronRoute; exports.isCronRequestAuthorized = _chunkXYL4HSVCcjs.isCronRequestAuthorized; exports.mergeScheduledTasks = _chunkXYL4HSVCcjs.mergeScheduledTasks; exports.prepareFarmCronForNitro = _chunkXYL4HSVCcjs.prepareFarmCronForNitro; exports.resolveCronConfig = _chunkXYL4HSVCcjs.resolveCronConfig;

package/dist/cron.mjs

@@ -11,11 +11,11 @@ import {
   mergeScheduledTasks,
   prepareFarmCronForNitro,
   resolveCronConfig
-} from "./chunk-UCQ52TJY.mjs";
+} from "./chunk-X3JNB2TB.mjs";
 import "./chunk-WXFY5JIY.mjs";
 import "./chunk-YP7YO3S3.mjs";
-import "./chunk-2SVJGOAX.mjs";
-import "./chunk-TXK4D46O.mjs";
+import "./chunk-Y3N5BFRJ.mjs";
+import "./chunk-H3ASZDT7.mjs";
 import "./chunk-OHWM2VI4.mjs";
 import "./chunk-AYP2YFVN.mjs";
 import "./chunk-Y6FXYEAI.mjs";

package/dist/desktop.d.mts

@@ -1,10 +1,9 @@
-import { R as ResolvedFarmDesktopConfig } from './client-plugins-BNBeyLMi.mjs';
-export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins-BNBeyLMi.mjs';
-import './lifecycle-DK06VuKP.mjs';
+import { R as ResolvedFarmDesktopConfig } from './client-plugins-cqy_dQd0.mjs';
+export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins-cqy_dQd0.mjs';
+import './lifecycle-C2aLBOwu.mjs';
 import './route-2_yXC6gv.mjs';
 import './endpoint-BkMSCRf6.mjs';
 import './cache.mjs';
-import './cache-invalidation-BD0z_lfu.mjs';
 import './renderer.mjs';
 import './deployment.mjs';
 import 'http';
@@ -21,15 +20,16 @@ import '@farming-labs/docs';
 import './observability-B2363jB6.mjs';
 import '@opentelemetry/api';
 import 'vite';
-import './workflows-Df1C_7OG.mjs';
+import './workflows-CRMzQZ3k.mjs';
 import './cron.mjs';
 import './env.mjs';
 import './server-action-security.mjs';
-import './layers-D9fbe-rz.mjs';
+import './layers-CcS42OGR.mjs';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config-CeDgNyX4.mjs';
-import './types--Wh02r5_.mjs';
+import './types-C41ePjvP.mjs';
+import './config-CnhyvvmT.mjs';
 import './types-DQnyD3VD.mjs';
 import './font.mjs';