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

package/dist/client.d.ts

@@ -1,5 +1,5 @@
-import { g as APIResult, p as ClientOptions } from './api-client.d-BWcqZciH.js';
-export { A as APIClient, a as APIClientError, b as APIClientOptions, c as APIClientSystemError, d as APIClientWithoutIntegrationsOptions, j as ApiClients, n as ClientHeaders, o as ClientLifecycleHooks, q as ClientRequestEvent, r as ClientResponseEvent, I as InferIntegrationOperationBody, t as InferIntegrationOperationQuery, u as InferIntegrationOperationResponse, v as IntegrationAPI, w as IntegrationClient, x as IntegrationClientAliases, y as IntegrationClientData, z as IntegrationClientError, B as IntegrationClientOptions, D as IntegrationClientRequestOptions, E as IntegrationClientRoot, G as IntegrationClients, H as IntegrationOperationResult, J as IntegrationServerClient, K as IntegrationServerClientAliases, L as IntegrationServerClientOptions, M as IntegrationServerClientRequestOptions, N as IntegrationServerClientRoot, O as IntegrationServerRequestLike, X as RouteAPIClient, Y as ServerAPIClient, Z as ServerAPIClientOptions, _ as ServerAPIClientWithoutIntegrationsOptions, a2 as createAPIClient, a3 as createApiClients, a4 as createIntegrationApi, a5 as createIntegrationClient, a6 as createIntegrationClients, a7 as createIntegrationServerClient, a8 as createIntegrations, a9 as createServerAPIClient, ab as getIntegrationAPIManifest, ac as integrationClients, ad as integrationsClient, ae as integrationsServer } from './api-client.d-BWcqZciH.js';
+import { n as APIResult, v as ClientOptions } from './api-client.d-ddQBNGtu.js';
+export { A as APIClient, b as APIClientError, d as APIClientOptions, e as APIClientSystemError, f as APIClientWithoutIntegrationsOptions, g as ApiClients, t as ClientHeaders, u as ClientLifecycleHooks, w as ClientRequestEvent, x as ClientResponseEvent, I as InferIntegrationOperationBody, z as InferIntegrationOperationQuery, B as InferIntegrationOperationResponse, D as IntegrationAPI, E as IntegrationClient, G as IntegrationClientAliases, H as IntegrationClientData, J as IntegrationClientError, K as IntegrationClientOptions, L as IntegrationClientRequestOptions, M as IntegrationClientRoot, N as IntegrationClients, O as IntegrationOperationResult, P as IntegrationServerClient, Q as IntegrationServerClientAliases, T as IntegrationServerClientOptions, U as IntegrationServerClientRequestOptions, V as IntegrationServerClientRoot, W as IntegrationServerRequestLike, R as RouteAPIClient, S as ServerAPIClient, h as ServerAPIClientOptions, i as ServerAPIClientWithoutIntegrationsOptions, c as createAPIClient, a as createApiClients, a5 as createIntegrationApi, a6 as createIntegrationClient, a7 as createIntegrationClients, a8 as createIntegrationServerClient, a9 as createIntegrations, j as createServerAPIClient, ab as getIntegrationAPIManifest, ac as integrationClients, ad as integrationsClient, ae as integrationsServer } from './api-client.d-ddQBNGtu.js';
 export { F as FarmAPIStream } from './endpoint.d-BgHn0lhl.js';
 import React__default, { FormHTMLAttributes, FormEvent, ComponentType, AnchorHTMLAttributes } from 'react';
 export { RouteActionTarget, UseActionFormProps, UseActionReturn, UseServerFnOptions, useAction } from './server-fn-client.js';
@@ -8,11 +8,11 @@ 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.d-DBTEqifW.js';
 export { UseThemeResult, useTheme } from './theme/client.js';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions } from './router.js';
-import { f as FarmViewTransitionMode } from './spa-router.d-DqZ6Lfs0.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.d-DqZ6Lfs0.js';
+import { f as FarmViewTransitionMode } from './spa-router.d-DAtnNoBe.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.d-DAtnNoBe.js';
 import { c as FarmI18nLocale } from './types.d-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.d-DQ3k7EYn.js';
-export { F as FarmNavigationDelegate, a as FarmNavigationDelegateContext, d as delegateNavigation } from './navigation-delegate.d-DIyDslxt.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.d-DjGn_al7.js';
+export { F as FarmNavigationDelegate, a as FarmNavigationDelegateContext, d as delegateNavigation } from './navigation-delegate.d-JXx40JzR.js';
 export { F as FarmChunkRecoveryOptions, i as installChunkErrorRecovery, a as isChunkLoadError } from './chunk-recovery.d-lnQFzcQP.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.d-C2aLBOwu.js';
 export { S as ServerQueryFetchOptions, f as fetchServerQuery, p as prefetchServerQuery } from './server-query-runtime.d-DXRNhX_3.js';
@@ -22,7 +22,7 @@ import './server-fn.js';
 import './server-fn-error.d-DrcH9cc1.js';
 import './server-query.js';
 import './types.d-DQnyD3VD.js';
-import './client-plugins.d-n3iWY1EJ.js';
+import './client-plugins.d-vXrbcfJ1.js';
 import './renderer.js';
 import './deployment.js';
 import 'http';
@@ -43,10 +43,10 @@ import './layers.d-CcS42OGR.js';
 import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.js';
-import './config.d-DqKaCr1r.js';
+import './config.d-DqZkLwef.js';
 import './font.js';
 import './island.d-CfGru1MO.js';
-import './render-plan.d-Dr5WRjoV.js';
+import './render-plan.d-B9lAP3uX.js';
 
 type MutationStatus = "idle" | "pending" | "success" | "error";
 type AnyMutationTarget = (...args: any[]) => Promise<any>;

package/dist/client.mjs

@@ -13,24 +13,24 @@ import {
   storageClientCacheAdapter,
   useFetcher,
   useMutation
-} from "./chunk-JWI5PUO2.mjs";
+} from "./chunk-W2ZXMMHA.mjs";
 import {
   installChunkErrorRecovery,
   isChunkLoadError
 } from "./chunk-O4F3JUST.mjs";
-import {
-  useServerQuery
-} from "./chunk-724WT3NI.mjs";
 import {
   useAction
 } from "./chunk-GL3ZDHKI.mjs";
+import {
+  useServerQuery
+} from "./chunk-724WT3NI.mjs";
 import {
   useBlocker,
   useNavigation,
   usePageState,
   useRouter,
   useScrollRestoration
-} from "./chunk-VAHBCI6X.mjs";
+} from "./chunk-BQWBHWEW.mjs";
 import {
   useTheme
 } from "./chunk-EFLNOZGH.mjs";
@@ -49,7 +49,7 @@ import {
   integrationClients,
   integrationsClient,
   integrationsServer
-} from "./chunk-2NHOYYUT.mjs";
+} from "./chunk-7H45IJWO.mjs";
 import "./chunk-IAPTECEB.mjs";
 import "./chunk-Z64V4WZI.mjs";
 import {
@@ -70,11 +70,11 @@ import {
   pushState,
   readPageState,
   replaceState
-} from "./chunk-SN5VSO3Q.mjs";
+} from "./chunk-25T5VXOE.mjs";
 import "./chunk-PTLXHRJZ.mjs";
 import {
   delegateNavigation
-} from "./chunk-G2KTRMWA.mjs";
+} from "./chunk-RSEAX5MW.mjs";
 import "./chunk-NCIAP562.mjs";
 import {
   getFarmClientDataCache,
@@ -97,7 +97,7 @@ import {
 import "./chunk-5Y4GYKKH.mjs";
 import "./chunk-YT3SLLZK.mjs";
 import "./chunk-GUZC226X.mjs";
-import "./chunk-BLD5GVCG.mjs";
+import "./chunk-W6QLRQ3V.mjs";
 import "./chunk-MFQGU5CC.mjs";
 import "./chunk-S6O2L47H.mjs";
 import "./chunk-NBIVGHAT.mjs";

package/dist/{config.d-DqKaCr1r.d.ts → config.d-DqZkLwef.d.mts}

@@ -7,6 +7,125 @@ interface PlatformBlockChecker {
 /** Results of function-valued blocks for one dev session or build. */
 type PlatformBlockCache<T> = Map<string, Promise<T>>;
 
+/**
+ * What web screens can call on an app native module (RFC 0004, 7.5): the Promise methods of its
+ * Codegen spec, read with React Native's own Codegen parser so the spec stays the one source. The
+ * Android shell checks arguments against these types before the module runs, and `src/farm.d.ts`
+ * types `native.<module>` from them.
+ */
+/** A value a web screen sends or receives, as the Codegen spec declares it. */
+type FarmNativeType = ({
+    type: "string";
+} | {
+    type: "number";
+    integer?: true;
+} | {
+    type: "boolean";
+}
+/** A string literal union, a single literal, or an enum: the values the spec allows. */
+ | {
+    type: "literal";
+    values: Array<string | number>;
+}
+/** An object type with declared properties: `ReadableMap` in Kotlin. */
+ | {
+    type: "object";
+    properties: FarmNativeProperty[];
+}
+/** `Object` or `UnsafeObject`: any JSON object, `ReadableMap` in Kotlin. */
+ | {
+    type: "map";
+}
+/** An array; without `element`, any JSON values. `ReadableArray` in Kotlin. */
+ | {
+    type: "array";
+    element?: FarmNativeType;
+}
+/** Return values only: `Promise<void>`. */
+ | {
+    type: "void";
+}
+/** Return values only: a type web screens get as JSON without a narrower type. */
+ | {
+    type: "unknown";
+}) & {
+    nullable?: true;
+};
+interface FarmNativeProperty {
+    name: string;
+    optional: boolean;
+    type: FarmNativeType;
+}
+interface FarmNativeMethod {
+    name: string;
+    params: FarmNativeProperty[];
+    /** What the Promise resolves with. */
+    returns: FarmNativeType;
+}
+/** The part of one Codegen spec web screens reach. */
+interface FarmNativeWebSpec {
+    /** Promise methods whose parameters web screens can send, in spec order. */
+    methods: FarmNativeMethod[];
+    /** Promise methods web screens cannot call, and why, such as a callback parameter. */
+    unsupported: Array<{
+        method: string;
+        reason: string;
+    }>;
+}
+
+/**
+ * Native modules (RFC 0004, 7.5): the app's own TurboModules in `src/native/`, and
+ * `mobile.modules`, the OS permission entries and usage strings per module.
+ */
+/** What the OS needs for one module: `mobile.modules.<name>`. */
+interface FarmMobileModuleConfig {
+    /**
+     * Android permissions the generated `AndroidManifest.xml` declares, such as
+     * `"android.permission.VIBRATE"`. Community modules already merge their own manifest's
+     * permissions, so this is for extra ones.
+     */
+    permissions?: string[];
+    /**
+     * iOS usage strings the generated `Info.plist` gets, keyed by usage-description key, such as
+     * `{ NSCameraUsageDescription: "Scans receipts." }`.
+     */
+    usage?: Record<string, string>;
+    /**
+     * Lets web screens (`page.tsx` in the shell's WebView) call the module's Promise methods as
+     * `native.<name>.<method>()` from `@farm.js/core/native`, with arguments checked against its
+     * Codegen spec. App modules in `src/native/` only: community modules need the React Native JS
+     * runtime. Android only for now. Defaults to `false`.
+     */
+    web?: boolean;
+}
+interface ResolvedFarmMobileModuleConfig {
+    permissions: string[];
+    usage: Record<string, string>;
+    web: boolean;
+}
+/** One Codegen spec in `src/native/`, such as `NativeDevice.ts`. */
+interface FarmMobileAppModuleSpec {
+    /** The name the spec registers: `TurboModuleRegistry.getEnforcing<Spec>("Device")`. */
+    name: string;
+    /** Absolute path of the spec file. */
+    file: string;
+    /**
+     * With `mobile.modules.<name>.web`: the Promise methods web screens may call, read from the spec
+     * with React Native's Codegen.
+     */
+    web?: FarmNativeWebSpec;
+}
+/** The app's own native modules: the files in `src/native/` the generated projects copy. */
+interface FarmMobileAppModules {
+    /** Absolute path of `src/native/`. */
+    dir: string;
+    specs: FarmMobileAppModuleSpec[];
+    /** Absolute paths of the Kotlin files (`*.kt`), linked into the Android app. */
+    android: string[];
+    /** Absolute paths of the Swift files (`*.swift`), copied but not built: iOS has no host yet. */
+    ios: string[];
+}
+
 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";
@@ -114,6 +233,20 @@ interface FarmMobileUserConfig {
     routes?: Record<string, FarmMobileRouteConfig>;
     /** Screen tiers per route, the native engine, and the analyzer. */
     native?: FarmMobileNativeConfig;
+    /**
+     * Bundle a page shell, the route's layouts around its `loading.tsx`, into the app for routes
+     * whose loading file and layouts sit in static folders. A web screen that loads a document
+     * shows its shell at once, and keeps it up while the server is unreachable. Built by
+     * `farm build --mobile`; defaults to `false`.
+     */
+    shells?: boolean;
+    /**
+     * What the OS needs for each native module, keyed by module name: an app module's registered
+     * name (`src/native/NativeDevice.ts` registers `"Device"`) or an installed package such as
+     * `"react-native-vision-camera"`. `permissions` go into the Android manifest and `usage`
+     * strings into the iOS `Info.plist`.
+     */
+    modules?: Record<string, FarmMobileModuleConfig>;
 }
 /** What a function-valued `mobile` block receives. Resolved once per OS per dev start or build. */
 interface FarmMobileContext {
@@ -149,6 +282,9 @@ interface ResolvedFarmMobileConfig {
     /** `mobile.routes`, keyed by route pattern with route groups removed. */
     routes: Record<string, FarmMobileRouteConfig>;
     native: ResolvedFarmMobileNativeConfig;
+    shells: boolean;
+    /** `mobile.modules`, checked: permissions deduplicated per module, usage strings trimmed. */
+    modules: Record<string, ResolvedFarmMobileModuleConfig>;
 }
 /**
  * The origin a mobile app loads pages from. `https://` anywhere; `http://` only for loopback and
@@ -170,6 +306,8 @@ interface FarmMobileResolveOptions {
     srcDir?: string;
     /** The app's page route patterns, such as `"/notes/[id]"` (route groups removed). */
     routes: readonly string[];
+    /** Names the app's own native module specs register (`scanFarmMobileAppModules`). */
+    appModules?: readonly string[];
 }
 /**
  * Fill in defaults for an already resolved (static or returned) `mobile` block and check it
@@ -196,4 +334,4 @@ type FarmMobileBlockCache = PlatformBlockCache<FarmMobileUserConfig>;
  */
 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 FarmMobileRouteScreen as l, type FarmMobileScreen as m, type FarmMobileTab as n, type FarmMobileUserConfig as o, type FarmMobileBlockCache as p, type FarmMobileContextOptions as q, type FarmMobileResolveOptions as r, type ResolvedFarmMobileNativeConfig as s, createFarmMobileContext as t, resolveFarmMobileBlock as u, resolveFarmMobileConfig as v, resolveFarmMobileServer as w, validateFarmMobileConfig as x, validateFarmMobilePageConfig as y };
+export { type ResolvedFarmMobileNativeConfig as A, createFarmMobileContext as B, resolveFarmMobileBlock as C, resolveFarmMobileConfig as D, resolveFarmMobileServer as E, type FarmMobileOS as F, validateFarmMobileConfig as G, validateFarmMobilePageConfig as H, type PlatformBlockCache as P, type ResolvedFarmMobileConfig as R, type FarmMobileAppModules as a, type FarmMobileAppModuleSpec as b, type FarmMobileBudgets as c, type FarmMobileConfigInput as d, type FarmMobileContext as e, type FarmMobileModuleConfig as f, type FarmMobileNativeAuto as g, type FarmMobileNativeConfig as h, type FarmMobileNativeEngine as i, type FarmMobileNativeRouteConfig as j, type FarmMobilePageConfig as k, type FarmMobilePrefetch as l, type FarmMobilePresentation as m, type FarmMobileRouteConfig as n, type FarmMobileRouteScreen as o, type FarmMobileScreen as p, type FarmMobileTab as q, type FarmMobileUserConfig as r, type FarmNativeMethod as s, type FarmNativeProperty as t, type FarmNativeType as u, type FarmNativeWebSpec as v, type ResolvedFarmMobileModuleConfig as w, type FarmMobileBlockCache as x, type FarmMobileContextOptions as y, type FarmMobileResolveOptions as z };

package/dist/{config.d-DqKaCr1r.d.mts → config.d-DqZkLwef.d.ts}

@@ -7,6 +7,125 @@ interface PlatformBlockChecker {
 /** Results of function-valued blocks for one dev session or build. */
 type PlatformBlockCache<T> = Map<string, Promise<T>>;
 
+/**
+ * What web screens can call on an app native module (RFC 0004, 7.5): the Promise methods of its
+ * Codegen spec, read with React Native's own Codegen parser so the spec stays the one source. The
+ * Android shell checks arguments against these types before the module runs, and `src/farm.d.ts`
+ * types `native.<module>` from them.
+ */
+/** A value a web screen sends or receives, as the Codegen spec declares it. */
+type FarmNativeType = ({
+    type: "string";
+} | {
+    type: "number";
+    integer?: true;
+} | {
+    type: "boolean";
+}
+/** A string literal union, a single literal, or an enum: the values the spec allows. */
+ | {
+    type: "literal";
+    values: Array<string | number>;
+}
+/** An object type with declared properties: `ReadableMap` in Kotlin. */
+ | {
+    type: "object";
+    properties: FarmNativeProperty[];
+}
+/** `Object` or `UnsafeObject`: any JSON object, `ReadableMap` in Kotlin. */
+ | {
+    type: "map";
+}
+/** An array; without `element`, any JSON values. `ReadableArray` in Kotlin. */
+ | {
+    type: "array";
+    element?: FarmNativeType;
+}
+/** Return values only: `Promise<void>`. */
+ | {
+    type: "void";
+}
+/** Return values only: a type web screens get as JSON without a narrower type. */
+ | {
+    type: "unknown";
+}) & {
+    nullable?: true;
+};
+interface FarmNativeProperty {
+    name: string;
+    optional: boolean;
+    type: FarmNativeType;
+}
+interface FarmNativeMethod {
+    name: string;
+    params: FarmNativeProperty[];
+    /** What the Promise resolves with. */
+    returns: FarmNativeType;
+}
+/** The part of one Codegen spec web screens reach. */
+interface FarmNativeWebSpec {
+    /** Promise methods whose parameters web screens can send, in spec order. */
+    methods: FarmNativeMethod[];
+    /** Promise methods web screens cannot call, and why, such as a callback parameter. */
+    unsupported: Array<{
+        method: string;
+        reason: string;
+    }>;
+}
+
+/**
+ * Native modules (RFC 0004, 7.5): the app's own TurboModules in `src/native/`, and
+ * `mobile.modules`, the OS permission entries and usage strings per module.
+ */
+/** What the OS needs for one module: `mobile.modules.<name>`. */
+interface FarmMobileModuleConfig {
+    /**
+     * Android permissions the generated `AndroidManifest.xml` declares, such as
+     * `"android.permission.VIBRATE"`. Community modules already merge their own manifest's
+     * permissions, so this is for extra ones.
+     */
+    permissions?: string[];
+    /**
+     * iOS usage strings the generated `Info.plist` gets, keyed by usage-description key, such as
+     * `{ NSCameraUsageDescription: "Scans receipts." }`.
+     */
+    usage?: Record<string, string>;
+    /**
+     * Lets web screens (`page.tsx` in the shell's WebView) call the module's Promise methods as
+     * `native.<name>.<method>()` from `@farm.js/core/native`, with arguments checked against its
+     * Codegen spec. App modules in `src/native/` only: community modules need the React Native JS
+     * runtime. Android only for now. Defaults to `false`.
+     */
+    web?: boolean;
+}
+interface ResolvedFarmMobileModuleConfig {
+    permissions: string[];
+    usage: Record<string, string>;
+    web: boolean;
+}
+/** One Codegen spec in `src/native/`, such as `NativeDevice.ts`. */
+interface FarmMobileAppModuleSpec {
+    /** The name the spec registers: `TurboModuleRegistry.getEnforcing<Spec>("Device")`. */
+    name: string;
+    /** Absolute path of the spec file. */
+    file: string;
+    /**
+     * With `mobile.modules.<name>.web`: the Promise methods web screens may call, read from the spec
+     * with React Native's Codegen.
+     */
+    web?: FarmNativeWebSpec;
+}
+/** The app's own native modules: the files in `src/native/` the generated projects copy. */
+interface FarmMobileAppModules {
+    /** Absolute path of `src/native/`. */
+    dir: string;
+    specs: FarmMobileAppModuleSpec[];
+    /** Absolute paths of the Kotlin files (`*.kt`), linked into the Android app. */
+    android: string[];
+    /** Absolute paths of the Swift files (`*.swift`), copied but not built: iOS has no host yet. */
+    ios: string[];
+}
+
 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";
@@ -114,6 +233,20 @@ interface FarmMobileUserConfig {
     routes?: Record<string, FarmMobileRouteConfig>;
     /** Screen tiers per route, the native engine, and the analyzer. */
     native?: FarmMobileNativeConfig;
+    /**
+     * Bundle a page shell, the route's layouts around its `loading.tsx`, into the app for routes
+     * whose loading file and layouts sit in static folders. A web screen that loads a document
+     * shows its shell at once, and keeps it up while the server is unreachable. Built by
+     * `farm build --mobile`; defaults to `false`.
+     */
+    shells?: boolean;
+    /**
+     * What the OS needs for each native module, keyed by module name: an app module's registered
+     * name (`src/native/NativeDevice.ts` registers `"Device"`) or an installed package such as
+     * `"react-native-vision-camera"`. `permissions` go into the Android manifest and `usage`
+     * strings into the iOS `Info.plist`.
+     */
+    modules?: Record<string, FarmMobileModuleConfig>;
 }
 /** What a function-valued `mobile` block receives. Resolved once per OS per dev start or build. */
 interface FarmMobileContext {
@@ -149,6 +282,9 @@ interface ResolvedFarmMobileConfig {
     /** `mobile.routes`, keyed by route pattern with route groups removed. */
     routes: Record<string, FarmMobileRouteConfig>;
     native: ResolvedFarmMobileNativeConfig;
+    shells: boolean;
+    /** `mobile.modules`, checked: permissions deduplicated per module, usage strings trimmed. */
+    modules: Record<string, ResolvedFarmMobileModuleConfig>;
 }
 /**
  * The origin a mobile app loads pages from. `https://` anywhere; `http://` only for loopback and
@@ -170,6 +306,8 @@ interface FarmMobileResolveOptions {
     srcDir?: string;
     /** The app's page route patterns, such as `"/notes/[id]"` (route groups removed). */
     routes: readonly string[];
+    /** Names the app's own native module specs register (`scanFarmMobileAppModules`). */
+    appModules?: readonly string[];
 }
 /**
  * Fill in defaults for an already resolved (static or returned) `mobile` block and check it
@@ -196,4 +334,4 @@ type FarmMobileBlockCache = PlatformBlockCache<FarmMobileUserConfig>;
  */
 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 FarmMobileRouteScreen as l, type FarmMobileScreen as m, type FarmMobileTab as n, type FarmMobileUserConfig as o, type FarmMobileBlockCache as p, type FarmMobileContextOptions as q, type FarmMobileResolveOptions as r, type ResolvedFarmMobileNativeConfig as s, createFarmMobileContext as t, resolveFarmMobileBlock as u, resolveFarmMobileConfig as v, resolveFarmMobileServer as w, validateFarmMobileConfig as x, validateFarmMobilePageConfig as y };
+export { type ResolvedFarmMobileNativeConfig as A, createFarmMobileContext as B, resolveFarmMobileBlock as C, resolveFarmMobileConfig as D, resolveFarmMobileServer as E, type FarmMobileOS as F, validateFarmMobileConfig as G, validateFarmMobilePageConfig as H, type PlatformBlockCache as P, type ResolvedFarmMobileConfig as R, type FarmMobileAppModules as a, type FarmMobileAppModuleSpec as b, type FarmMobileBudgets as c, type FarmMobileConfigInput as d, type FarmMobileContext as e, type FarmMobileModuleConfig as f, type FarmMobileNativeAuto as g, type FarmMobileNativeConfig as h, type FarmMobileNativeEngine as i, type FarmMobileNativeRouteConfig as j, type FarmMobilePageConfig as k, type FarmMobilePrefetch as l, type FarmMobilePresentation as m, type FarmMobileRouteConfig as n, type FarmMobileRouteScreen as o, type FarmMobileScreen as p, type FarmMobileTab as q, type FarmMobileUserConfig as r, type FarmNativeMethod as s, type FarmNativeProperty as t, type FarmNativeType as u, type FarmNativeWebSpec as v, type ResolvedFarmMobileModuleConfig as w, type FarmMobileBlockCache as x, type FarmMobileContextOptions as y, type FarmMobileResolveOptions as z };

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { p as FarmUserConfig } from './client-plugins.d-DllmH8eM.mjs';
+import { p as FarmUserConfig } from './client-plugins.d-CgQQ-EAv.mjs';
 import './lifecycle.d-C2aLBOwu.mjs';
 import './route.d-BaVH3V0w.mjs';
 import './endpoint.d-BkMSCRf6.mjs';
@@ -28,7 +28,7 @@ import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.mjs';
 import './types.d-C41ePjvP.mjs';
-import './config.d-DqKaCr1r.mjs';
+import './config.d-DqZkLwef.mjs';
 import './types.d-DQnyD3VD.mjs';
 import './font.mjs';
 

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { p as FarmUserConfig } from './client-plugins.d-n3iWY1EJ.js';
+import { p as FarmUserConfig } from './client-plugins.d-vXrbcfJ1.js';
 import './lifecycle.d-C2aLBOwu.js';
 import './route.d-DBTEqifW.js';
 import './endpoint.d-BgHn0lhl.js';
@@ -28,7 +28,7 @@ import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.js';
 import './types.d-C41ePjvP.js';
-import './config.d-DqKaCr1r.js';
+import './config.d-DqZkLwef.js';
 import './types.d-DQnyD3VD.js';
 import './font.js';
 

package/dist/cron.cjs

@@ -11,10 +11,10 @@
 
 
 
-var _chunkXYL4HSVCcjs = require('./chunk-XYL4HSVC.cjs');
+var _chunkYI6FKTTNcjs = require('./chunk-YI6FKTTN.cjs');
 require('./chunk-2KMIJDY6.cjs');
 require('./chunk-SHIWRBFI.cjs');
-require('./chunk-VQJYGZNX.cjs');
+require('./chunk-QMNWKQL4.cjs');
 require('./chunk-SUCDVKUB.cjs');
 require('./chunk-6CTFVBAT.cjs');
 require('./chunk-YTVSWXEZ.cjs');
@@ -32,4 +32,4 @@ require('./chunk-BTZ5O6VM.cjs');
 
 
 
-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;
+exports.DEFAULT_FARM_CRON_SECRET_ENV = _chunkYI6FKTTNcjs.DEFAULT_FARM_CRON_SECRET_ENV; exports.FARM_CRON_MANIFEST = _chunkYI6FKTTNcjs.FARM_CRON_MANIFEST; exports.applyFarmCronVercelCrons = _chunkYI6FKTTNcjs.applyFarmCronVercelCrons; exports.createFarmCronCloudflareConfig = _chunkYI6FKTTNcjs.createFarmCronCloudflareConfig; exports.createFarmCronCloudflareTriggers = _chunkYI6FKTTNcjs.createFarmCronCloudflareTriggers; exports.createFarmCronManifest = _chunkYI6FKTTNcjs.createFarmCronManifest; exports.createFarmCronVercelCrons = _chunkYI6FKTTNcjs.createFarmCronVercelCrons; exports.cronRoute = _chunkYI6FKTTNcjs.cronRoute; exports.isCronRequestAuthorized = _chunkYI6FKTTNcjs.isCronRequestAuthorized; exports.mergeScheduledTasks = _chunkYI6FKTTNcjs.mergeScheduledTasks; exports.prepareFarmCronForNitro = _chunkYI6FKTTNcjs.prepareFarmCronForNitro; exports.resolveCronConfig = _chunkYI6FKTTNcjs.resolveCronConfig;

package/dist/cron.d.mts

@@ -1,3 +1,6 @@
+import { T as TypedEndpoint } from './endpoint.d-BkMSCRf6.mjs';
+import './cache.mjs';
+
 type FarmCronSchedule = string | string[];
 interface FarmCronJobConfig {
     /** Portable five-field cron expression, or a list of expressions. */
@@ -73,6 +76,13 @@ declare function createFarmCronCloudflareTriggers(jobs: FarmCronJob[]): string[]
 declare function createFarmCronCloudflareConfig(jobs: FarmCronJob[]): FarmCronCloudflareConfig | undefined;
 declare function mergeScheduledTasks(...maps: Array<Record<string, string | string[]> | undefined>): Record<string, string | string[]>;
 declare function isCronRequestAuthorized(request: Request, options?: FarmCronRouteOptions): boolean;
+/** A `createEndpoint()` result: Farm's route runtime calls `__handler` with the parsed context. */
+type FarmCronEndpoint = TypedEndpoint<any, any, any, any, any, any, any, any>;
+/**
+ * Guards an API route so only the scheduler can call it: a `createEndpoint()` result, which keeps its
+ * validation, types and metadata, or a plain handler that receives the `Request`.
+ */
+declare function cronRoute<TEndpoint extends FarmCronEndpoint>(endpoint: TEndpoint, options?: FarmCronRouteOptions): TEndpoint;
 declare function cronRoute<TArgs extends unknown[], TResult>(handler: (request: Request, ...args: TArgs) => TResult, options?: FarmCronRouteOptions): (request: Request, ...args: TArgs) => TResult | Promise<Response>;
 
 export { DEFAULT_FARM_CRON_SECRET_ENV, FARM_CRON_MANIFEST, type FarmCronCloudflareConfig, type FarmCronJob, type FarmCronJobConfig, type FarmCronResolvedConfig, type FarmCronRouteOptions, type FarmCronSchedule, type FarmCronUserConfig, type PreparedFarmCron, applyFarmCronVercelCrons, createFarmCronCloudflareConfig, createFarmCronCloudflareTriggers, createFarmCronManifest, createFarmCronVercelCrons, cronRoute, isCronRequestAuthorized, mergeScheduledTasks, prepareFarmCronForNitro, resolveCronConfig };

package/dist/cron.d.ts

@@ -1,3 +1,6 @@
+import { T as TypedEndpoint } from './endpoint.d-BgHn0lhl.js';
+import './cache.js';
+
 type FarmCronSchedule = string | string[];
 interface FarmCronJobConfig {
     /** Portable five-field cron expression, or a list of expressions. */
@@ -73,6 +76,13 @@ declare function createFarmCronCloudflareTriggers(jobs: FarmCronJob[]): string[]
 declare function createFarmCronCloudflareConfig(jobs: FarmCronJob[]): FarmCronCloudflareConfig | undefined;
 declare function mergeScheduledTasks(...maps: Array<Record<string, string | string[]> | undefined>): Record<string, string | string[]>;
 declare function isCronRequestAuthorized(request: Request, options?: FarmCronRouteOptions): boolean;
+/** A `createEndpoint()` result: Farm's route runtime calls `__handler` with the parsed context. */
+type FarmCronEndpoint = TypedEndpoint<any, any, any, any, any, any, any, any>;
+/**
+ * Guards an API route so only the scheduler can call it: a `createEndpoint()` result, which keeps its
+ * validation, types and metadata, or a plain handler that receives the `Request`.
+ */
+declare function cronRoute<TEndpoint extends FarmCronEndpoint>(endpoint: TEndpoint, options?: FarmCronRouteOptions): TEndpoint;
 declare function cronRoute<TArgs extends unknown[], TResult>(handler: (request: Request, ...args: TArgs) => TResult, options?: FarmCronRouteOptions): (request: Request, ...args: TArgs) => TResult | Promise<Response>;
 
 export { DEFAULT_FARM_CRON_SECRET_ENV, FARM_CRON_MANIFEST, type FarmCronCloudflareConfig, type FarmCronJob, type FarmCronJobConfig, type FarmCronResolvedConfig, type FarmCronRouteOptions, type FarmCronSchedule, type FarmCronUserConfig, type PreparedFarmCron, applyFarmCronVercelCrons, createFarmCronCloudflareConfig, createFarmCronCloudflareTriggers, createFarmCronManifest, createFarmCronVercelCrons, cronRoute, isCronRequestAuthorized, mergeScheduledTasks, prepareFarmCronForNitro, resolveCronConfig };

package/dist/cron.mjs

@@ -11,10 +11,10 @@ import {
   mergeScheduledTasks,
   prepareFarmCronForNitro,
   resolveCronConfig
-} from "./chunk-X3JNB2TB.mjs";
+} from "./chunk-3PX4AIXO.mjs";
 import "./chunk-WXFY5JIY.mjs";
 import "./chunk-YP7YO3S3.mjs";
-import "./chunk-Y3N5BFRJ.mjs";
+import "./chunk-JSDV2NUN.mjs";
 import "./chunk-H3ASZDT7.mjs";
 import "./chunk-OHWM2VI4.mjs";
 import "./chunk-AYP2YFVN.mjs";

package/dist/desktop.d.mts

@@ -1,5 +1,5 @@
-import { R as ResolvedFarmDesktopConfig } from './client-plugins.d-DllmH8eM.mjs';
-export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins.d-DllmH8eM.mjs';
+import { R as ResolvedFarmDesktopConfig } from './client-plugins.d-CgQQ-EAv.mjs';
+export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins.d-CgQQ-EAv.mjs';
 import './lifecycle.d-C2aLBOwu.mjs';
 import './route.d-BaVH3V0w.mjs';
 import './endpoint.d-BkMSCRf6.mjs';
@@ -29,7 +29,7 @@ import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.mjs';
 import './types.d-C41ePjvP.mjs';
-import './config.d-DqKaCr1r.mjs';
+import './config.d-DqZkLwef.mjs';
 import './types.d-DQnyD3VD.mjs';
 import './font.mjs';
 

package/dist/desktop.d.ts

@@ -1,5 +1,5 @@
-import { R as ResolvedFarmDesktopConfig } from './client-plugins.d-n3iWY1EJ.js';
-export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins.d-n3iWY1EJ.js';
+import { R as ResolvedFarmDesktopConfig } from './client-plugins.d-vXrbcfJ1.js';
+export { b as FarmDesktopConfigInput, c as FarmDesktopContext, d as FarmDesktopUserConfig, e as FarmDesktopWindowConfig } from './client-plugins.d-vXrbcfJ1.js';
 import './lifecycle.d-C2aLBOwu.js';
 import './route.d-DBTEqifW.js';
 import './endpoint.d-BgHn0lhl.js';
@@ -29,7 +29,7 @@ import 'rolldown/utils';
 import 'rolldown';
 import './image-config.d-CeDgNyX4.js';
 import './types.d-C41ePjvP.js';
-import './config.d-DqKaCr1r.js';
+import './config.d-DqZkLwef.js';
 import './types.d-DQnyD3VD.js';
 import './font.js';