@farm.js/core 0.1.61 → 0.1.63

package/dist/internal/config-runtime.d.ts

@@ -0,0 +1,336 @@
+import { bo as ResolvedFarmConfig, p as FarmUserConfig } from '../client-plugins.d-BgPUYPc9.js';
+export { bF as FarmDesktopDevSession, bG as FarmDesktopSetupOptions, bH as createFarmDesktopContext, bI as getFarmDesktopOutputDirs, bJ as installFarmDesktopSetup, O as loadConfig, Q as resolveConfig, S as resolveDeployConfig, bK as resolveFarmDesktopBlock, bL as resolveFarmDesktopConfig, bM as setFarmDesktopDevSession, bN as validateFarmDesktopConfig } from '../client-plugins.d-BgPUYPc9.js';
+import { P as PlatformRouteFiles } from '../generate-route-types.d-BL2pq6xC.js';
+import { F as FarmMobileOS, i as FarmMobileNativeEngine, g as FarmMobileNativeAuto, o as FarmMobileRouteScreen, p as FarmMobileScreen, e as FarmMobileContext, R as ResolvedFarmMobileConfig, a as FarmMobileAppModules, x as FarmMobileBlockCache, c as FarmMobileBudgets, d as FarmMobileConfigInput, y as FarmMobileContextOptions, h as FarmMobileNativeConfig, j as FarmMobileNativeRouteConfig, k as FarmMobilePageConfig, l as FarmMobilePrefetch, m as FarmMobilePresentation, z as FarmMobileResolveOptions, n as FarmMobileRouteConfig, q as FarmMobileTab, r as FarmMobileUserConfig, A as ResolvedFarmMobileNativeConfig, B as createFarmMobileContext, C as resolveFarmMobileBlock, D as resolveFarmMobileConfig, E as resolveFarmMobileServer, G as validateFarmMobileConfig, H as validateFarmMobilePageConfig } from '../config.d-qt-mE8O5.js';
+import { c as FarmMobileTier, d as FarmMobileScreenSource, e as FarmMobileRouteAnalysis, f as FarmMobileScreenDecision, g as FarmMobileAnalyzerStats, b as FarmMobileShellManifest, F as FarmMobileRouteManifest, h as FarmMobileBlocker, i as FarmMobileBlockerRule, j as FarmMobilePageExport, k as FarmMobileRouteManifestOptions, a as FarmMobileRouteRule, l as FarmMobileScreens, m as FarmMobileScreensOptions, n as FarmUiNode, o as createFarmMobileModuleId, p as createFarmMobileRouteManifest, q as createFarmMobileRoutePattern, r as readFarmMobilePageExport, s as resolveFarmMobileScreens } from '../routes.d-BknKQcTu.js';
+import { F as FARM_SHELL_PARAM_SEGMENT, a as FARM_SHELL_RENDER_HEADER, b as FARM_SHELL_ROUTE_HEADER, c as createFarmMobileShellRenderPath } from '../shell-render.d-CG6bPiiA.js';
+export { F as FarmProductionViteRuntime, l as loadFarmProductionVite } from '../production-vite.d-BQFAlG7n.js';
+export { l as logger } from '../utils.d-CjyE-npA.js';
+import '../lifecycle.d-C2aLBOwu.js';
+import '../route.d-DBTEqifW.js';
+import '../endpoint.d-BgHn0lhl.js';
+import '../cache.js';
+import '../renderer.js';
+import '../deployment.js';
+import 'http';
+import '../server-fn.js';
+import '../server-fn-error.d-DrcH9cc1.js';
+import '../server-query.js';
+import '../types.d-BnIqOn9w.js';
+import 'db0';
+import 'unstorage';
+import '../schema.js';
+import 'react';
+import '@farming-labs/orm';
+import '@farming-labs/docs';
+import '../observability.d-B2363jB6.js';
+import '@opentelemetry/api';
+import 'vite';
+import '../workflows.d-CRMzQZ3k.js';
+import '../cron.js';
+import '../env.js';
+import '../server-action-security.js';
+import '../layers.d-CcS42OGR.js';
+import 'rolldown/utils';
+import 'rolldown';
+import '../image-config.d-CeDgNyX4.js';
+import '../types.d-C41ePjvP.js';
+import '../types.d-DQnyD3VD.js';
+import '../font.js';
+
+interface FarmMobilePort {
+    /** The screen module the native entry registers, relative to the ports directory. */
+    entry: string;
+    /** Generated sources, keyed by path relative to the ports directory. */
+    files: Record<string, string>;
+}
+
+/**
+ * `.farm/output/mobile/native-report.json` and its terminal table: what each route shows, and
+ * for routes the analyzer looked at, whether it could become a native screen and why not.
+ */
+
+interface FarmMobileNativeReportRoute {
+    route: string;
+    /** What `farm-routes.json` shows for the route. */
+    screen: FarmMobileRouteScreen;
+    source: FarmMobileScreenSource;
+    requested?: Exclude<FarmMobileScreen, "web">;
+    /** The page export or screen file that decided, app-root-relative. */
+    file?: string;
+    /** Present when the analyzer looked at the route. */
+    analysis?: Omit<FarmMobileRouteAnalysis, "route">;
+}
+interface FarmMobileNativeReport {
+    version: 1;
+    os: FarmMobileOS;
+    engine: FarmMobileNativeEngine;
+    auto: FarmMobileNativeAuto;
+    summary: {
+        routes: number;
+        analyzed: number;
+        /** Portable, and native would help. */
+        port: number;
+        /** Portable, but nothing native would improve. */
+        portableNoWin: number;
+        /** Analyzed and blocked. */
+        blocked: number;
+        /** Native or platform screens from files or config. */
+        native: number;
+        /** Analyzed routes per tier: what each could become. */
+        tiers: Record<FarmMobileTier, number>;
+    };
+    routes: FarmMobileNativeReportRoute[];
+}
+declare function createFarmMobileNativeReport(options: {
+    os: FarmMobileOS;
+    engine: FarmMobileNativeEngine;
+    auto: FarmMobileNativeAuto;
+    routes: readonly string[];
+    screens: Readonly<Record<string, FarmMobileScreenDecision>>;
+    analysis: Readonly<Record<string, FarmMobileRouteAnalysis>>;
+}): FarmMobileNativeReport;
+/** The report as a table, one row per route, with the first blocker of each web route. */
+declare function formatFarmMobileNativeReport(report: FarmMobileNativeReport, options?: {
+    stats?: FarmMobileAnalyzerStats;
+    file?: string;
+}): string;
+
+/** The page shells of one build, as a shell package writes them into the app. */
+interface FarmMobilePageShells extends FarmMobileShellManifest {
+    /** Shell HTML by file name, such as `{ "1a2b3c4d5e6f7a8b.html": "<!DOCTYPE html>..." }`. */
+    files: Record<string, string>;
+}
+interface FarmMobilePageShellOptions {
+    os: FarmMobileOS;
+    /**
+     * The text of a stylesheet the document links, by its href, such as `/assets/app-h1a2.css`;
+     * undefined for one the build did not write. iOS shells inline every stylesheet they can
+     * (`loadHTMLString` has no bundled files to load it from); Android loads it from the app.
+     */
+    readStylesheet?: (href: string) => string | undefined;
+}
+/**
+ * A rendered document as a page shell: every script and script preload removed (a shell never
+ * runs code; the real document does), the links that name the request's URL (`canonical`,
+ * `alternate`: locale and markdown versions) removed, so a shell is the same file for every route
+ * that shares it and carries no address of the build's server, `data-farm-page-shell` on `<html>`
+ * so app CSS can tell, and on iOS each stylesheet the build wrote inlined.
+ */
+declare function createFarmMobilePageShell(html: string, options: FarmMobilePageShellOptions): string;
+/** A shell's file name: its content hash, so equal shells share one file. */
+declare function getFarmMobilePageShellFile(shell: string): string;
+interface RenderFarmMobilePageShellsOptions extends FarmMobilePageShellOptions {
+    /** Page route patterns, route groups removed. */
+    routes: readonly string[];
+    /** The token the build's server answers shell requests with. */
+    token: string;
+    /** The app's basePath ("" or "/base"). */
+    basePath: string;
+    /** The mobile client entry of the build, from `mobile-client.json`. */
+    client: string;
+    /** Requests a path (with the base path) from the build's server. */
+    fetch: (path: string, init: {
+        headers: Record<string, string>;
+    }) => Promise<Response>;
+    /** Requests in flight at once; defaults to 4. */
+    concurrency?: number;
+}
+interface RenderedFarmMobilePageShells {
+    shells: FarmMobilePageShells;
+    /** Routes without a shell and why, for `--verbose` output. */
+    skipped: {
+        route: string;
+        reason: string;
+    }[];
+}
+/**
+ * Ask the build's server for each route's shell and keep the ones it renders. The server decides
+ * which routes qualify (a loading file and layouts in static folders) and says why the others do
+ * not; middleware and guards run as for any request, so a route they redirect gets no shell.
+ */
+declare function renderFarmMobilePageShells(options: RenderFarmMobilePageShellsOptions): Promise<RenderedFarmMobilePageShells>;
+
+/** `.farm/mobile-client.json` once the build has finished. */
+interface FarmMobileClientManifest {
+    version: 1;
+    /** The web client entry documents reference, such as `/farm-client-h1a2b3c4d.js`. */
+    webEntry: string;
+    /** The mobile client entry a shell's documents load instead. */
+    entry: string;
+    /** The stylesheet both clients use. */
+    stylesheet: string;
+    /**
+     * Every content-hashed file a shell's document loads, as URL paths: the mobile client's
+     * chunks and assets, the stylesheet, and the files the stylesheet references. A shell may
+     * answer exactly these paths from its bundle; a hashed name only ever has these bytes.
+     */
+    files: string[];
+    /**
+     * The client output the files are in, relative to the app root, when it is not the build
+     * directory's `client/`: the RSC pipeline (`@farm.js/plugin/rsc`) writes this manifest too.
+     */
+    clientDir?: string;
+}
+/** Read the finished manifest, or null when the last build had no mobile client. */
+declare function readFarmMobileClientManifest(buildDir: string): Promise<FarmMobileClientManifest | null>;
+
+/** An expected failure with its own fix; the CLI prints it without a stack. */
+declare class FarmMobileError extends Error {
+    name: string;
+}
+/** Where mobile outputs go, relative to the app root. */
+declare function getFarmMobileOutputDirs(distDir: string): {
+    root: string;
+    routes: string;
+    /** The `--mobile` client build (with its server), kept apart from the web build's output. */
+    www: string;
+    /** Generated native projects, one per OS. */
+    android: string;
+    ios: string;
+    /** Built apps, such as the debug APK. */
+    dist: string;
+    report: string;
+    /** Generated React Native ports of portable pages. */
+    ports: string;
+    analyzerCache: string;
+    /** The production build's client output, which holds the mobile client a shell bundles. */
+    client: string;
+};
+interface FarmMobileAppOptions {
+    root?: string;
+    command?: FarmMobileContext["command"];
+    profile?: string;
+    os?: FarmMobileOS;
+    /**
+     * Server origin chosen by the CLI, such as the dev server's LAN URL for `farm dev --mobile`.
+     * Wins over `mobile.server`; checked by the same rules.
+     */
+    server?: string;
+    /** farm.config as loaded; loaded from `root` when omitted. */
+    userConfig?: FarmUserConfig | null;
+    /** The resolved web config the build already has; resolved from `userConfig` when omitted. */
+    config?: ResolvedFarmConfig;
+    /** Shared across calls in one session so a function-valued block runs once per OS. */
+    cache?: FarmMobileBlockCache;
+    /**
+     * Run the build-time analyzer: `true` when `mobile.native.auto` is not `"off"` (what
+     * `farm build --mobile` passes), `"always"` for an explicit `--report`. Not in dev, except
+     * that a page with `export const mobile = { native: true }` is always checked.
+     */
+    analyze?: boolean | "always";
+    /** `farm build --mobile` with `mobile.shells`: the page shells it rendered, for the manifest. */
+    shells?: FarmMobileShellManifest;
+}
+interface FarmMobileApp {
+    context: FarmMobileContext;
+    mobile: ResolvedFarmMobileConfig;
+    manifest: FarmMobileRouteManifest;
+    config: ResolvedFarmConfig;
+    /** What each page route shows on this OS, and what decided it. */
+    screens: Record<string, FarmMobileScreenDecision>;
+    /** Settings a higher-precedence source overrides, unused screen files, unported routes. */
+    warnings: string[];
+    /** Reserved `layout.{native,ios,android}.tsx` files per app directory, app-root-relative. */
+    nativeLayouts: Record<string, PlatformRouteFiles>;
+    /** Absolute page file per file-based page route. */
+    pageFiles: Map<string, string>;
+    /** The React Native port of each route Farm ported, written by `generateFarmMobileRoutes`. */
+    ports: Record<string, FarmMobilePort>;
+    /** The analyzer's report, when it ran. */
+    report?: FarmMobileNativeReport;
+    analyzerStats?: FarmMobileAnalyzerStats;
+    /** The app's own native modules in `src/native/`, when it has any. */
+    appModules?: FarmMobileAppModules;
+}
+/** Resolve the `mobile` block for one OS against the app's routes. Writes nothing. */
+declare function resolveFarmMobileApp(options?: FarmMobileAppOptions): Promise<FarmMobileApp>;
+/**
+ * Resolve the block and write `.farm/output/mobile/farm-routes.json`, plus
+ * `native-report.json` when the analyzer ran (`analyze`). `table` is the report for a terminal.
+ */
+declare function generateFarmMobileRoutes(options?: FarmMobileAppOptions): Promise<FarmMobileApp & {
+    file: string;
+    reportFile?: string;
+    table?: string;
+}>;
+
+declare const __mobile_runtime_FARM_SHELL_PARAM_SEGMENT: typeof FARM_SHELL_PARAM_SEGMENT;
+declare const __mobile_runtime_FARM_SHELL_RENDER_HEADER: typeof FARM_SHELL_RENDER_HEADER;
+declare const __mobile_runtime_FARM_SHELL_ROUTE_HEADER: typeof FARM_SHELL_ROUTE_HEADER;
+declare const __mobile_runtime_FarmMobileAnalyzerStats: typeof FarmMobileAnalyzerStats;
+type __mobile_runtime_FarmMobileApp = FarmMobileApp;
+type __mobile_runtime_FarmMobileAppOptions = FarmMobileAppOptions;
+declare const __mobile_runtime_FarmMobileBlockCache: typeof FarmMobileBlockCache;
+declare const __mobile_runtime_FarmMobileBlocker: typeof FarmMobileBlocker;
+declare const __mobile_runtime_FarmMobileBlockerRule: typeof FarmMobileBlockerRule;
+declare const __mobile_runtime_FarmMobileBudgets: typeof FarmMobileBudgets;
+type __mobile_runtime_FarmMobileClientManifest = FarmMobileClientManifest;
+declare const __mobile_runtime_FarmMobileConfigInput: typeof FarmMobileConfigInput;
+declare const __mobile_runtime_FarmMobileContext: typeof FarmMobileContext;
+declare const __mobile_runtime_FarmMobileContextOptions: typeof FarmMobileContextOptions;
+type __mobile_runtime_FarmMobileError = FarmMobileError;
+declare const __mobile_runtime_FarmMobileError: typeof FarmMobileError;
+declare const __mobile_runtime_FarmMobileNativeAuto: typeof FarmMobileNativeAuto;
+declare const __mobile_runtime_FarmMobileNativeConfig: typeof FarmMobileNativeConfig;
+declare const __mobile_runtime_FarmMobileNativeEngine: typeof FarmMobileNativeEngine;
+type __mobile_runtime_FarmMobileNativeReport = FarmMobileNativeReport;
+type __mobile_runtime_FarmMobileNativeReportRoute = FarmMobileNativeReportRoute;
+declare const __mobile_runtime_FarmMobileNativeRouteConfig: typeof FarmMobileNativeRouteConfig;
+declare const __mobile_runtime_FarmMobileOS: typeof FarmMobileOS;
+declare const __mobile_runtime_FarmMobilePageConfig: typeof FarmMobilePageConfig;
+declare const __mobile_runtime_FarmMobilePageExport: typeof FarmMobilePageExport;
+type __mobile_runtime_FarmMobilePageShellOptions = FarmMobilePageShellOptions;
+type __mobile_runtime_FarmMobilePageShells = FarmMobilePageShells;
+declare const __mobile_runtime_FarmMobilePrefetch: typeof FarmMobilePrefetch;
+declare const __mobile_runtime_FarmMobilePresentation: typeof FarmMobilePresentation;
+declare const __mobile_runtime_FarmMobileResolveOptions: typeof FarmMobileResolveOptions;
+declare const __mobile_runtime_FarmMobileRouteAnalysis: typeof FarmMobileRouteAnalysis;
+declare const __mobile_runtime_FarmMobileRouteConfig: typeof FarmMobileRouteConfig;
+declare const __mobile_runtime_FarmMobileRouteManifest: typeof FarmMobileRouteManifest;
+declare const __mobile_runtime_FarmMobileRouteManifestOptions: typeof FarmMobileRouteManifestOptions;
+declare const __mobile_runtime_FarmMobileRouteRule: typeof FarmMobileRouteRule;
+declare const __mobile_runtime_FarmMobileRouteScreen: typeof FarmMobileRouteScreen;
+declare const __mobile_runtime_FarmMobileScreen: typeof FarmMobileScreen;
+declare const __mobile_runtime_FarmMobileScreenDecision: typeof FarmMobileScreenDecision;
+declare const __mobile_runtime_FarmMobileScreenSource: typeof FarmMobileScreenSource;
+declare const __mobile_runtime_FarmMobileScreens: typeof FarmMobileScreens;
+declare const __mobile_runtime_FarmMobileScreensOptions: typeof FarmMobileScreensOptions;
+declare const __mobile_runtime_FarmMobileShellManifest: typeof FarmMobileShellManifest;
+declare const __mobile_runtime_FarmMobileTab: typeof FarmMobileTab;
+declare const __mobile_runtime_FarmMobileTier: typeof FarmMobileTier;
+declare const __mobile_runtime_FarmMobileUserConfig: typeof FarmMobileUserConfig;
+declare const __mobile_runtime_FarmUiNode: typeof FarmUiNode;
+type __mobile_runtime_RenderFarmMobilePageShellsOptions = RenderFarmMobilePageShellsOptions;
+type __mobile_runtime_RenderedFarmMobilePageShells = RenderedFarmMobilePageShells;
+declare const __mobile_runtime_ResolvedFarmMobileConfig: typeof ResolvedFarmMobileConfig;
+declare const __mobile_runtime_ResolvedFarmMobileNativeConfig: typeof ResolvedFarmMobileNativeConfig;
+declare const __mobile_runtime_createFarmMobileContext: typeof createFarmMobileContext;
+declare const __mobile_runtime_createFarmMobileModuleId: typeof createFarmMobileModuleId;
+declare const __mobile_runtime_createFarmMobileNativeReport: typeof createFarmMobileNativeReport;
+declare const __mobile_runtime_createFarmMobilePageShell: typeof createFarmMobilePageShell;
+declare const __mobile_runtime_createFarmMobileRouteManifest: typeof createFarmMobileRouteManifest;
+declare const __mobile_runtime_createFarmMobileRoutePattern: typeof createFarmMobileRoutePattern;
+declare const __mobile_runtime_createFarmMobileShellRenderPath: typeof createFarmMobileShellRenderPath;
+declare const __mobile_runtime_formatFarmMobileNativeReport: typeof formatFarmMobileNativeReport;
+declare const __mobile_runtime_generateFarmMobileRoutes: typeof generateFarmMobileRoutes;
+declare const __mobile_runtime_getFarmMobileOutputDirs: typeof getFarmMobileOutputDirs;
+declare const __mobile_runtime_getFarmMobilePageShellFile: typeof getFarmMobilePageShellFile;
+declare const __mobile_runtime_readFarmMobileClientManifest: typeof readFarmMobileClientManifest;
+declare const __mobile_runtime_readFarmMobilePageExport: typeof readFarmMobilePageExport;
+declare const __mobile_runtime_renderFarmMobilePageShells: typeof renderFarmMobilePageShells;
+declare const __mobile_runtime_resolveFarmMobileApp: typeof resolveFarmMobileApp;
+declare const __mobile_runtime_resolveFarmMobileBlock: typeof resolveFarmMobileBlock;
+declare const __mobile_runtime_resolveFarmMobileConfig: typeof resolveFarmMobileConfig;
+declare const __mobile_runtime_resolveFarmMobileScreens: typeof resolveFarmMobileScreens;
+declare const __mobile_runtime_resolveFarmMobileServer: typeof resolveFarmMobileServer;
+declare const __mobile_runtime_validateFarmMobileConfig: typeof validateFarmMobileConfig;
+declare const __mobile_runtime_validateFarmMobilePageConfig: typeof validateFarmMobilePageConfig;
+declare namespace __mobile_runtime {
+  export { __mobile_runtime_FARM_SHELL_PARAM_SEGMENT as FARM_SHELL_PARAM_SEGMENT, __mobile_runtime_FARM_SHELL_RENDER_HEADER as FARM_SHELL_RENDER_HEADER, __mobile_runtime_FARM_SHELL_ROUTE_HEADER as FARM_SHELL_ROUTE_HEADER, __mobile_runtime_FarmMobileAnalyzerStats as FarmMobileAnalyzerStats, type __mobile_runtime_FarmMobileApp as FarmMobileApp, type __mobile_runtime_FarmMobileAppOptions as FarmMobileAppOptions, __mobile_runtime_FarmMobileBlockCache as FarmMobileBlockCache, __mobile_runtime_FarmMobileBlocker as FarmMobileBlocker, __mobile_runtime_FarmMobileBlockerRule as FarmMobileBlockerRule, __mobile_runtime_FarmMobileBudgets as FarmMobileBudgets, type __mobile_runtime_FarmMobileClientManifest as FarmMobileClientManifest, __mobile_runtime_FarmMobileConfigInput as FarmMobileConfigInput, __mobile_runtime_FarmMobileContext as FarmMobileContext, __mobile_runtime_FarmMobileContextOptions as FarmMobileContextOptions, __mobile_runtime_FarmMobileError as FarmMobileError, __mobile_runtime_FarmMobileNativeAuto as FarmMobileNativeAuto, __mobile_runtime_FarmMobileNativeConfig as FarmMobileNativeConfig, __mobile_runtime_FarmMobileNativeEngine as FarmMobileNativeEngine, type __mobile_runtime_FarmMobileNativeReport as FarmMobileNativeReport, type __mobile_runtime_FarmMobileNativeReportRoute as FarmMobileNativeReportRoute, __mobile_runtime_FarmMobileNativeRouteConfig as FarmMobileNativeRouteConfig, __mobile_runtime_FarmMobileOS as FarmMobileOS, __mobile_runtime_FarmMobilePageConfig as FarmMobilePageConfig, __mobile_runtime_FarmMobilePageExport as FarmMobilePageExport, type __mobile_runtime_FarmMobilePageShellOptions as FarmMobilePageShellOptions, type __mobile_runtime_FarmMobilePageShells as FarmMobilePageShells, __mobile_runtime_FarmMobilePrefetch as FarmMobilePrefetch, __mobile_runtime_FarmMobilePresentation as FarmMobilePresentation, __mobile_runtime_FarmMobileResolveOptions as FarmMobileResolveOptions, __mobile_runtime_FarmMobileRouteAnalysis as FarmMobileRouteAnalysis, __mobile_runtime_FarmMobileRouteConfig as FarmMobileRouteConfig, __mobile_runtime_FarmMobileRouteManifest as FarmMobileRouteManifest, __mobile_runtime_FarmMobileRouteManifestOptions as FarmMobileRouteManifestOptions, __mobile_runtime_FarmMobileRouteRule as FarmMobileRouteRule, __mobile_runtime_FarmMobileRouteScreen as FarmMobileRouteScreen, __mobile_runtime_FarmMobileScreen as FarmMobileScreen, __mobile_runtime_FarmMobileScreenDecision as FarmMobileScreenDecision, __mobile_runtime_FarmMobileScreenSource as FarmMobileScreenSource, __mobile_runtime_FarmMobileScreens as FarmMobileScreens, __mobile_runtime_FarmMobileScreensOptions as FarmMobileScreensOptions, __mobile_runtime_FarmMobileShellManifest as FarmMobileShellManifest, __mobile_runtime_FarmMobileTab as FarmMobileTab, __mobile_runtime_FarmMobileTier as FarmMobileTier, __mobile_runtime_FarmMobileUserConfig as FarmMobileUserConfig, __mobile_runtime_FarmUiNode as FarmUiNode, type __mobile_runtime_RenderFarmMobilePageShellsOptions as RenderFarmMobilePageShellsOptions, type __mobile_runtime_RenderedFarmMobilePageShells as RenderedFarmMobilePageShells, __mobile_runtime_ResolvedFarmMobileConfig as ResolvedFarmMobileConfig, __mobile_runtime_ResolvedFarmMobileNativeConfig as ResolvedFarmMobileNativeConfig, __mobile_runtime_createFarmMobileContext as createFarmMobileContext, __mobile_runtime_createFarmMobileModuleId as createFarmMobileModuleId, __mobile_runtime_createFarmMobileNativeReport as createFarmMobileNativeReport, __mobile_runtime_createFarmMobilePageShell as createFarmMobilePageShell, __mobile_runtime_createFarmMobileRouteManifest as createFarmMobileRouteManifest, __mobile_runtime_createFarmMobileRoutePattern as createFarmMobileRoutePattern, __mobile_runtime_createFarmMobileShellRenderPath as createFarmMobileShellRenderPath, __mobile_runtime_formatFarmMobileNativeReport as formatFarmMobileNativeReport, __mobile_runtime_generateFarmMobileRoutes as generateFarmMobileRoutes, __mobile_runtime_getFarmMobileOutputDirs as getFarmMobileOutputDirs, __mobile_runtime_getFarmMobilePageShellFile as getFarmMobilePageShellFile, __mobile_runtime_readFarmMobileClientManifest as readFarmMobileClientManifest, __mobile_runtime_readFarmMobilePageExport as readFarmMobilePageExport, __mobile_runtime_renderFarmMobilePageShells as renderFarmMobilePageShells, __mobile_runtime_resolveFarmMobileApp as resolveFarmMobileApp, __mobile_runtime_resolveFarmMobileBlock as resolveFarmMobileBlock, __mobile_runtime_resolveFarmMobileConfig as resolveFarmMobileConfig, __mobile_runtime_resolveFarmMobileScreens as resolveFarmMobileScreens, __mobile_runtime_resolveFarmMobileServer as resolveFarmMobileServer, __mobile_runtime_validateFarmMobileConfig as validateFarmMobileConfig, __mobile_runtime_validateFarmMobilePageConfig as validateFarmMobilePageConfig };
+}
+
+/** The `mobile` block and its route manifest, loaded only by mobile commands. */
+declare function loadFarmMobileRuntime(): Promise<typeof __mobile_runtime>;
+
+export { loadFarmMobileRuntime };

package/dist/internal/config-runtime.mjs

@@ -1,65 +1,94 @@
 import {
   loadFarmProductionVite
-} from "../chunk-S3FNNQHR.mjs";
+} from "../chunk-PSUYE5HR.mjs";
 import {
   loadConfig,
   resolveConfig,
   resolveDeployConfig
-} from "../chunk-OHLSEQ57.mjs";
-import "../chunk-XZNTNMHT.mjs";
-import "../chunk-RSOJ7DRT.mjs";
-import "../chunk-JBSVKMC5.mjs";
-import "../chunk-GHFS7RUB.mjs";
-import "../chunk-BUGNQIHC.mjs";
-import "../chunk-DAATZTKJ.mjs";
-import "../chunk-4E5WBPEG.mjs";
-import "../chunk-DTSROJ5J.mjs";
-import "../chunk-G2KY33I6.mjs";
-import "../chunk-YHOCRI4H.mjs";
-import "../chunk-4WVJLURN.mjs";
-import "../chunk-4OOBRCJX.mjs";
-import "../chunk-FA2W42OV.mjs";
-import "../chunk-WWIKMBRN.mjs";
-import "../chunk-MVL2RAJW.mjs";
-import "../chunk-SFGWNC43.mjs";
-import "../chunk-Q2KB32T4.mjs";
-import "../chunk-2UC36WAC.mjs";
-import "../chunk-ONUEYC6N.mjs";
-import "../chunk-AELACLOB.mjs";
-import "../chunk-MKYBIIAQ.mjs";
-import "../chunk-44SYJEG3.mjs";
-import "../chunk-JG6DJF5A.mjs";
-import "../chunk-ZLAT2CWY.mjs";
-import "../chunk-2J7W2WND.mjs";
-import "../chunk-FZ6YYU2W.mjs";
-import "../chunk-FP2INE7H.mjs";
-import "../chunk-ZMMBIVQM.mjs";
-import "../chunk-BCMSYSN2.mjs";
+} from "../chunk-BA2IA32Q.mjs";
+import "../chunk-VISQDC6W.mjs";
+import {
+  createFarmDesktopContext,
+  getFarmDesktopOutputDirs,
+  installFarmDesktopSetup,
+  resolveFarmDesktopBlock,
+  resolveFarmDesktopConfig,
+  setFarmDesktopDevSession,
+  validateFarmDesktopConfig
+} from "../chunk-SMUW7UST.mjs";
+import "../chunk-UB7RVEMX.mjs";
+import "../chunk-PAKCHVUS.mjs";
+import "../chunk-X3XUZWRB.mjs";
+import "../chunk-XR2ZIBQK.mjs";
+import "../chunk-CU5SYTJG.mjs";
+import "../chunk-ES2LD2YD.mjs";
+import "../chunk-T4TBK5NY.mjs";
+import "../chunk-22W4FNTG.mjs";
+import "../chunk-SQ5O7I3L.mjs";
+import "../chunk-KVW2M6PI.mjs";
+import "../chunk-52Y3C3HG.mjs";
+import "../chunk-2NGZFOKG.mjs";
+import "../chunk-N33DLJBC.mjs";
+import "../chunk-UIJOLBUL.mjs";
+import "../chunk-YSXTNSXS.mjs";
+import "../chunk-VFXE6NWR.mjs";
+import "../chunk-TZVUF5JJ.mjs";
+import "../chunk-DQF3QLOH.mjs";
+import "../chunk-WXFY5JIY.mjs";
+import "../chunk-E46NXBNJ.mjs";
+import "../chunk-YP7YO3S3.mjs";
+import "../chunk-YWPNIYUP.mjs";
+import "../chunk-TGULJSHD.mjs";
+import "../chunk-H4WUWLQR.mjs";
+import "../chunk-M53MIIXY.mjs";
+import "../chunk-46P5KNTE.mjs";
+import "../chunk-EDPENAVO.mjs";
+import "../chunk-C7GJDVN4.mjs";
+import "../chunk-EVMXPJCB.mjs";
+import "../chunk-TGSEVBPO.mjs";
+import "../chunk-QSTRBKHZ.mjs";
+import "../chunk-MU5V7XHL.mjs";
 import {
   logger
-} from "../chunk-KI3MESHB.mjs";
-import "../chunk-QVKYGNVM.mjs";
-import "../chunk-FUZEBRP3.mjs";
-import "../chunk-Z2RZJZIZ.mjs";
-import "../chunk-BTHHUD7Q.mjs";
-import "../chunk-JPLUGGRV.mjs";
-import "../chunk-O7BH5O46.mjs";
-import "../chunk-7LTCDQRS.mjs";
-import "../chunk-SKNL7VA2.mjs";
-import "../chunk-2A3EQHXX.mjs";
-import "../chunk-4SIYUGRY.mjs";
-import "../chunk-SAXPH6G5.mjs";
-import "../chunk-Z3HATSKO.mjs";
-import "../chunk-CBBLJMR5.mjs";
-import "../chunk-CQ6OSQ3K.mjs";
-import "../chunk-L3KT7IXV.mjs";
-import "../chunk-4RB44K6Z.mjs";
-import "../chunk-55YI3RRB.mjs";
-import "../chunk-LPEX4YW6.mjs";
+} from "../chunk-JSDV2NUN.mjs";
+import "../chunk-H3ASZDT7.mjs";
+import "../chunk-2DA7CLY7.mjs";
+import "../chunk-CO6UYM2D.mjs";
+import "../chunk-2I6PUKWJ.mjs";
+import "../chunk-QDWMCFTH.mjs";
+import "../chunk-D2LCAV6L.mjs";
+import "../chunk-GYMGK467.mjs";
+import "../chunk-GUZC226X.mjs";
+import "../chunk-W6QLRQ3V.mjs";
+import "../chunk-WCLLPR6H.mjs";
+import "../chunk-UAQD67HM.mjs";
+import "../chunk-AZQXXXDX.mjs";
+import "../chunk-ONG4RDW3.mjs";
+import "../chunk-LM55GS4R.mjs";
+import "../chunk-JNYFXL7X.mjs";
+import "../chunk-OHWM2VI4.mjs";
+import "../chunk-VIXTAVEA.mjs";
+import "../chunk-7S7AAK2D.mjs";
+import "../chunk-SF3JB56B.mjs";
+import "../chunk-AYP2YFVN.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+
+// src/config-runtime.ts
+function loadFarmMobileRuntime() {
+  return import("../runtime-X5UR7VHP.mjs");
+}
 export {
+  createFarmDesktopContext,
+  getFarmDesktopOutputDirs,
+  installFarmDesktopSetup,
   loadConfig,
+  loadFarmMobileRuntime,
   loadFarmProductionVite,
   logger,
   resolveConfig,
-  resolveDeployConfig
+  resolveDeployConfig,
+  resolveFarmDesktopBlock,
+  resolveFarmDesktopConfig,
+  setFarmDesktopDevSession,
+  validateFarmDesktopConfig
 };

package/dist/internal/desktop-guard.cjs

@@ -0,0 +1,17 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+
+
+
+var _chunkOY5XDG24cjs = require('../chunk-OY5XDG24.cjs');
+require('../chunk-SHIWRBFI.cjs');
+require('../chunk-R5U7OIPI.cjs');
+require('../chunk-BTZ5O6VM.cjs');
+
+
+
+
+
+
+exports.FARM_DESKTOP_COOKIE = _chunkOY5XDG24cjs.FARM_DESKTOP_COOKIE; exports.FARM_DESKTOP_HANDSHAKE_PARAM = _chunkOY5XDG24cjs.FARM_DESKTOP_HANDSHAKE_PARAM; exports.FARM_DESKTOP_HANDSHAKE_PATH = _chunkOY5XDG24cjs.FARM_DESKTOP_HANDSHAKE_PATH; exports.FARM_DESKTOP_MIN_SECRET_LENGTH = _chunkOY5XDG24cjs.FARM_DESKTOP_MIN_SECRET_LENGTH; exports.createFarmDesktopGuard = _chunkOY5XDG24cjs.createFarmDesktopGuard;

package/dist/internal/desktop-guard.d.mts

@@ -0,0 +1,52 @@
+/**
+ * The local guard for `farm dev --desktop` and `farm build --desktop`.
+ *
+ * A desktop app's Farm server listens on 127.0.0.1, where every local process and every page in
+ * the user's browser can reach it. The shell starts the server with a per-launch `secret` and a
+ * one-time `handshakeToken`, then opens its window at the handshake URL. The handshake consumes
+ * the token, sets the secret as an HttpOnly, SameSite=Strict cookie, and redirects to the app.
+ * Every other request needs that cookie, so only the app's own window gets an answer.
+ *
+ * Requests must also name a loopback Host on the server's port (DNS rebinding sends the
+ * attacker's host name), must not be cross-site or same-site according to Fetch Metadata
+ * (cookies ignore ports, so a page on another localhost port is "same-site" and would carry the
+ * cookie), and unsafe methods with an Origin must come from the server's own origin.
+ *
+ * Only desktop builds and `farm dev --desktop` load this module.
+ */
+declare const FARM_DESKTOP_HANDSHAKE_PATH = "/__farm/desktop/handshake";
+declare const FARM_DESKTOP_COOKIE = "farm_desktop";
+/** The handshake URL carries the one-time token in this query parameter. */
+declare const FARM_DESKTOP_HANDSHAKE_PARAM = "t";
+/** Shortest accepted secret or token: 32 random bytes encode to 43 base64url characters. */
+declare const FARM_DESKTOP_MIN_SECRET_LENGTH = 32;
+/** The parts of a request the guard reads. A Web `Request` satisfies it. */
+interface FarmDesktopGuardRequest {
+    method: string;
+    /** Absolute URL, or the path and query of the request target. */
+    url: string;
+    headers: {
+        get(name: string): string | null;
+    };
+}
+interface FarmDesktopGuardOptions {
+    /** Per-launch secret, sent back by the window as the session cookie. */
+    secret: string;
+    /** One-time token the window presents at the handshake URL. */
+    handshakeToken: string;
+    /** The app's basePath. The handshake lives under it. */
+    basePath?: string;
+    /** The port the server listens on. Read per request, since port 0 is bound after start. */
+    port: () => number | undefined;
+    /**
+     * Where the guard records that the handshake token was used. Pass an object that outlives the
+     * guard (the dev session, which survives Vite restarts) so a rebuilt guard keeps it used.
+     */
+    handshakeState?: {
+        handshakeUsed?: boolean;
+    };
+}
+type FarmDesktopGuard = (request: FarmDesktopGuardRequest) => Response | undefined;
+declare function createFarmDesktopGuard(options: FarmDesktopGuardOptions): FarmDesktopGuard;
+
+export { FARM_DESKTOP_COOKIE, FARM_DESKTOP_HANDSHAKE_PARAM, FARM_DESKTOP_HANDSHAKE_PATH, FARM_DESKTOP_MIN_SECRET_LENGTH, type FarmDesktopGuard, type FarmDesktopGuardOptions, type FarmDesktopGuardRequest, createFarmDesktopGuard };

package/dist/internal/desktop-guard.d.ts

@@ -0,0 +1,52 @@
+/**
+ * The local guard for `farm dev --desktop` and `farm build --desktop`.
+ *
+ * A desktop app's Farm server listens on 127.0.0.1, where every local process and every page in
+ * the user's browser can reach it. The shell starts the server with a per-launch `secret` and a
+ * one-time `handshakeToken`, then opens its window at the handshake URL. The handshake consumes
+ * the token, sets the secret as an HttpOnly, SameSite=Strict cookie, and redirects to the app.
+ * Every other request needs that cookie, so only the app's own window gets an answer.
+ *
+ * Requests must also name a loopback Host on the server's port (DNS rebinding sends the
+ * attacker's host name), must not be cross-site or same-site according to Fetch Metadata
+ * (cookies ignore ports, so a page on another localhost port is "same-site" and would carry the
+ * cookie), and unsafe methods with an Origin must come from the server's own origin.
+ *
+ * Only desktop builds and `farm dev --desktop` load this module.
+ */
+declare const FARM_DESKTOP_HANDSHAKE_PATH = "/__farm/desktop/handshake";
+declare const FARM_DESKTOP_COOKIE = "farm_desktop";
+/** The handshake URL carries the one-time token in this query parameter. */
+declare const FARM_DESKTOP_HANDSHAKE_PARAM = "t";
+/** Shortest accepted secret or token: 32 random bytes encode to 43 base64url characters. */
+declare const FARM_DESKTOP_MIN_SECRET_LENGTH = 32;
+/** The parts of a request the guard reads. A Web `Request` satisfies it. */
+interface FarmDesktopGuardRequest {
+    method: string;
+    /** Absolute URL, or the path and query of the request target. */
+    url: string;
+    headers: {
+        get(name: string): string | null;
+    };
+}
+interface FarmDesktopGuardOptions {
+    /** Per-launch secret, sent back by the window as the session cookie. */
+    secret: string;
+    /** One-time token the window presents at the handshake URL. */
+    handshakeToken: string;
+    /** The app's basePath. The handshake lives under it. */
+    basePath?: string;
+    /** The port the server listens on. Read per request, since port 0 is bound after start. */
+    port: () => number | undefined;
+    /**
+     * Where the guard records that the handshake token was used. Pass an object that outlives the
+     * guard (the dev session, which survives Vite restarts) so a rebuilt guard keeps it used.
+     */
+    handshakeState?: {
+        handshakeUsed?: boolean;
+    };
+}
+type FarmDesktopGuard = (request: FarmDesktopGuardRequest) => Response | undefined;
+declare function createFarmDesktopGuard(options: FarmDesktopGuardOptions): FarmDesktopGuard;
+
+export { FARM_DESKTOP_COOKIE, FARM_DESKTOP_HANDSHAKE_PARAM, FARM_DESKTOP_HANDSHAKE_PATH, FARM_DESKTOP_MIN_SECRET_LENGTH, type FarmDesktopGuard, type FarmDesktopGuardOptions, type FarmDesktopGuardRequest, createFarmDesktopGuard };

package/dist/internal/desktop-guard.mjs

@@ -0,0 +1,17 @@
+import {
+  FARM_DESKTOP_COOKIE,
+  FARM_DESKTOP_HANDSHAKE_PARAM,
+  FARM_DESKTOP_HANDSHAKE_PATH,
+  FARM_DESKTOP_MIN_SECRET_LENGTH,
+  createFarmDesktopGuard
+} from "../chunk-7PZVXMWG.mjs";
+import "../chunk-YP7YO3S3.mjs";
+import "../chunk-AY2YD5ZX.mjs";
+import "../chunk-Y6FXYEAI.mjs";
+export {
+  FARM_DESKTOP_COOKIE,
+  FARM_DESKTOP_HANDSHAKE_PARAM,
+  FARM_DESKTOP_HANDSHAKE_PATH,
+  FARM_DESKTOP_MIN_SECRET_LENGTH,
+  createFarmDesktopGuard
+};