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

package/dist/client.d.ts

@@ -1,452 +0,0 @@
-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';
-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';
-export { UseServerQueryOptions, UseServerQueryResult, useServerQuery } from './server-query-client.js';
-export { a as FarmClientCacheEntry, b as FarmClientCacheKey, F as FarmClientCacheStatus, g as getFarmClientDataCache, n as normalizeFarmClientCacheKey } from './client-cache.d-Deoqq-nM.js';
-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 { 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 { 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';
-export { getTheme, setTheme, toggleTheme } from './theme/runtime.js';
-import './cache.js';
-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 './renderer.js';
-import './deployment.js';
-import 'http';
-import './types.d-BnIqOn9w.js';
-import 'db0';
-import 'unstorage';
-import './schema.js';
-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 './config.d-DqKaCr1r.js';
-import './font.js';
-import './island.d-CfGru1MO.js';
-import './render-plan.d-Dr5WRjoV.js';
-
-type MutationStatus = "idle" | "pending" | "success" | "error";
-type AnyMutationTarget = (...args: any[]) => Promise<any>;
-type InferMutationVariables<TTarget extends AnyMutationTarget> = Parameters<TTarget> extends [] ? undefined : Parameters<TTarget>[0];
-type InferMutationData<TTarget extends AnyMutationTarget> = TTarget extends {
-    readonly __farmRouteData: infer TData;
-} ? TData : Awaited<ReturnType<TTarget>>;
-type InferMutationError<TTarget extends AnyMutationTarget> = TTarget extends {
-    readonly __farmServerFnError: infer TError;
-} ? TError : TTarget extends (...args: any[]) => Promise<APIResult<any, infer TError>> ? TError : Error;
-type MutationOptimisticContext<TVariables, TData> = {
-    variables: TVariables | undefined;
-    current: TData | null;
-};
-type MutationNetworkMode = "always" | "online";
-type UseMutationOptions<TVariables, TData, TError = Error> = {
-    initialData?: TData | null;
-    resetOnMutate?: boolean;
-    /**
-     * `"always"` (default) dispatches regardless of connectivity, preserving
-     * existing behavior. `"online"` pauses a submission while the browser is
-     * offline — including one whose dispatch failed while offline — and resumes
-     * it on the `online` event instead of failing it.
-     */
-    networkMode?: MutationNetworkMode;
-    optimistic?: (context: MutationOptimisticContext<TVariables, TData>) => TData | null | undefined;
-    rollbackOnError?: boolean;
-    /**
-     * Options forwarded to generated `api.route.method` clients.
-     * Server-function targets honor `request.retry`, key-targeted
-     * `request.optimistic` updates, and key-targeted `request.invalidate`;
-     * the remaining request options apply to API routes only.
-     */
-    request?: ClientOptions<TData, TError>;
-    onSuccess?: (data: TData, variables: TVariables | undefined) => void;
-    onError?: (error: TError, variables: TVariables | undefined) => void;
-    onSettled?: (data: TData | null, error: TError | null, variables: TVariables | undefined) => void;
-};
-type MutationInput<TTarget extends AnyMutationTarget> = InferMutationVariables<TTarget>;
-type MutationData<TTarget extends AnyMutationTarget> = InferMutationData<TTarget>;
-type MutationError<TTarget extends AnyMutationTarget> = InferMutationError<TTarget>;
-type MutationAsync<TTarget extends AnyMutationTarget, TData = MutationData<TTarget>> = [
-] extends Parameters<TTarget> ? (variables?: MutationInput<TTarget>) => Promise<TData> : (variables: MutationInput<TTarget>) => Promise<TData>;
-type MutationTrigger<TTarget extends AnyMutationTarget> = [
-] extends Parameters<TTarget> ? (variables?: MutationInput<TTarget>) => void : (variables: MutationInput<TTarget>) => void;
-type UseMutationReturn<TTarget extends AnyMutationTarget, TData = MutationData<TTarget>, TError = MutationError<TTarget>> = {
-    pending: boolean;
-    /** True while a submission is waiting for the browser to come back online. */
-    paused: boolean;
-    status: MutationStatus;
-    data: TData | null;
-    error: TError | null;
-    variables: MutationInput<TTarget> | undefined;
-    mutate: MutationTrigger<TTarget>;
-    mutateAsync: MutationAsync<TTarget, TData>;
-    reset: () => void;
-};
-/**
- * Track a generated API route mutation or a Farm server function with one
- * React lifecycle.
- *
- * API routes keep using their existing fetch transport and request options.
- * Server functions keep using their configured server-function transport.
- */
-declare function useMutation<TTarget extends AnyMutationTarget>(target: TTarget, options?: UseMutationOptions<MutationInput<TTarget>, MutationData<TTarget>, MutationError<TTarget>>): UseMutationReturn<TTarget>;
-
-type FetcherState = "idle" | "submitting";
-/** Local form conversion failed before the target was called. */
-declare class FetcherInputError extends Error {
-    readonly name: "FetcherInputError";
-    readonly code: "input_error";
-    readonly status: 0;
-    readonly data: undefined;
-    readonly cause: unknown;
-    constructor(cause: unknown);
-}
-type FetcherFormDataContext = {
-    form: HTMLFormElement | null;
-    submitter: HTMLElement | null;
-};
-type UseFetcherOptions<TTarget extends AnyMutationTarget> = Omit<UseMutationOptions<InferMutationVariables<TTarget>, InferMutationData<TTarget>, InferMutationError<TTarget> | FetcherInputError>, "request"> & {
-    request?: UseMutationOptions<InferMutationVariables<TTarget>, InferMutationData<TTarget>, InferMutationError<TTarget>>["request"];
-    /**
-     * Convert browser FormData into the target's typed variables.
-     *
-     * Generated API routes preserve multipart forms and file values as a FormData
-     * body; text-only submissions default to a JSON object (or query for GET/HEAD).
-     * Server functions receive FormData directly. This mapper overrides defaults.
-     */
-    mapFormData?: (formData: FormData, context: FetcherFormDataContext) => InferMutationVariables<TTarget>;
-};
-type FetcherFormProps = Omit<FormHTMLAttributes<HTMLFormElement>, "action" | "onSubmit"> & {
-    /**
-     * Override the native form fallback. By default server functions remain the
-     * action and generated GET/POST API routes use their real URL.
-     */
-    action?: string | ((formData: FormData) => void | Promise<void>);
-    onSubmit?: (event: FormEvent<HTMLFormElement>) => void;
-};
-type FetcherInput<TTarget extends AnyMutationTarget> = InferMutationVariables<TTarget> | FormData;
-type FetcherSubmitAsync<TTarget extends AnyMutationTarget> = [
-] extends Parameters<TTarget> ? (input?: FetcherInput<TTarget>) => Promise<InferMutationData<TTarget>> : (input: FetcherInput<TTarget>) => Promise<InferMutationData<TTarget>>;
-type FetcherSubmit<TTarget extends AnyMutationTarget> = [
-] extends Parameters<TTarget> ? (input?: FetcherInput<TTarget>) => void : (input: FetcherInput<TTarget>) => void;
-type UseFetcherReturn<TTarget extends AnyMutationTarget> = {
-    state: FetcherState;
-    status: MutationStatus;
-    pending: boolean;
-    /** True while a submission is waiting for the browser to come back online. */
-    paused: boolean;
-    data: InferMutationData<TTarget> | null;
-    error: InferMutationError<TTarget> | FetcherInputError | null;
-    variables: InferMutationVariables<TTarget> | undefined;
-    formData: FormData | null;
-    submit: FetcherSubmit<TTarget>;
-    submitAsync: FetcherSubmitAsync<TTarget>;
-    Form: ComponentType<FetcherFormProps>;
-    reset: () => void;
-};
-/**
- * Run a typed server function or generated API operation without navigating.
- *
- * `fetcher.Form` progressively keeps a server function as the native form
- * action, while hydration intercepts submissions into this fetcher lifecycle.
- */
-declare function useFetcher<TTarget extends AnyMutationTarget>(target: TTarget, options?: UseFetcherOptions<TTarget>): UseFetcherReturn<TTarget>;
-
-declare const FARM_CACHE_INVALIDATION_CHANNEL = "farm:cache-invalidation";
-type CrossTabCacheInvalidationOptions = {
-    /** Override the BroadcastChannel name, e.g. to isolate multiple apps on one origin. */
-    channelName?: string;
-};
-/**
- * Bridge the cache invalidation bus across tabs of the same origin.
- *
- * Local invalidations are posted to a BroadcastChannel and applied in every
- * other tab through the normal invalidation path, so mounted stale queries
- * there refetch on their own. Only invalidation keys cross the channel, never
- * cached data, which keeps private and credentialed cache scoping untouched.
- *
- * Opt-in and idempotent. Returns a disposer; a no-op where BroadcastChannel
- * is unavailable (server rendering, older browsers).
- */
-declare function enableCrossTabCacheInvalidation(options?: CrossTabCacheInvalidationOptions): () => void;
-
-interface LiveCacheInvalidationOptions {
-    /** App-owned SSE endpoint created with createFarmCacheInvalidationStream(). */
-    url: string | URL;
-    /** Include credentials for a cross-origin EventSource connection. */
-    withCredentials?: boolean;
-}
-/**
- * Connect the browser cache to an app-owned invalidation event stream.
- * Native EventSource reconnection handles transient disconnects.
- */
-declare function enableLiveCacheInvalidation(options: LiveCacheInvalidationOptions): () => void;
-
-/**
- * Protocol version stamped into every persisted entry. Bump when the
- * persisted shape changes; mismatched entries are dropped on load.
- */
-declare const FARM_CLIENT_CACHE_PERSIST_VERSION = "1";
-/** Snapshot of a confirmed cache entry as stored by an adapter. */
-type PersistedEntry = {
-    data: unknown;
-    updatedAt: number;
-    staleAt: number;
-    gcAt?: number;
-    version: string;
-};
-/**
- * Storage contract for client cache persistence. Implement these callbacks
- * over any storage: IndexedDB, localStorage, OPFS, a native bridge. Farm owns
- * every policy decision (what, when, and whether to persist); the adapter is
- * plain keyed storage. `set` is an upsert.
- */
-type FarmClientCacheAdapter = {
-    keys(): Promise<string[]>;
-    get(key: string): Promise<PersistedEntry | null>;
-    set(key: string, entry: PersistedEntry): Promise<void>;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
-    /** Optional batch fast paths; the engine prefers them when present. */
-    getMany?(keys: string[]): Promise<Array<PersistedEntry | null>>;
-    setMany?(entries: Array<[string, PersistedEntry]>): Promise<void>;
-};
-/** Key-value client shape accepted by {@link storageClientCacheAdapter}. */
-type FarmClientCacheStorage = {
-    getItem<T = unknown>(key: string): Promise<T | null>;
-    setItem<T = unknown>(key: string, value: T): Promise<unknown>;
-    removeItem(key: string): Promise<unknown>;
-    getKeys?(base?: string): Promise<string[]>;
-    keys?(base?: string): Promise<string[]>;
-    clear?(base?: string): Promise<unknown>;
-};
-type ClientCachePersistenceOptions = {
-    /**
-     * Extra version salt, typically an app build or deploy id. Entries written
-     * under a different value are dropped on load.
-     */
-    version?: string;
-    /** Coarse additional filter on top of per-declaration `persist: true`. */
-    persistKey?: (key: string) => boolean;
-    /** Debounce for write-behind flushes. */
-    flushDelayMs?: number;
-};
-/**
- * Validate and type an adapter definition. Identity at runtime beyond shape
- * checking, mirroring `defineConfig`-style helpers.
- */
-declare function defineClientCacheAdapter(adapter: FarmClientCacheAdapter): FarmClientCacheAdapter;
-/**
- * Adapt any Farm/unstorage-compatible key-value client to the client cache
- * adapter contract, mirroring the server's `storageCacheAdapter`. Without a
- * key enumeration method the adapter still persists but cannot warm-start.
- */
-declare function storageClientCacheAdapter(storage: FarmClientCacheStorage, options?: {
-    base?: string;
-}): FarmClientCacheAdapter;
-/**
- * @internal Wire an adapter to the shared client cache. Called by the
- * generated client entry from the `cache.client.adapter` configuration; not
- * part of the public API. Returns a disposer.
- */
-declare function initPersistedClientCache(adapter: FarmClientCacheAdapter, options?: ClientCachePersistenceOptions): () => void;
-/**
- * @internal Entry point used by the generated client entries for the
- * `cache.client.adapter` configuration. Accepts the imported module namespace
- * and reports a misconfigured adapter without breaking application startup:
- * persistence is optional capability and must never block hydration.
- */
-declare function initConfiguredClientCachePersistence(adapterModule: unknown, options?: ClientCachePersistenceOptions): void;
-/**
- * Remove every persisted cache entry. Call on logout or any session change so
- * the next visitor on this device cannot warm-start into another user's data.
- * Safe to call when persistence is not configured.
- */
-declare function clearPersistedCache(): Promise<void>;
-
-type StoreState = Record<string, any>;
-type StoreValueUpdater<T> = T | ((previous: T) => T);
-type StorePatch<T extends StoreState> = Partial<T> | ((state: T) => Partial<T>);
-type StoreListener<T extends StoreState> = (state: T, previousState: T) => void;
-type StoreKeyListener<T extends StoreState, K extends keyof T> = (value: T[K], previousValue: T[K]) => void;
-type StoreKeysListener<T extends StoreState, K extends keyof T> = (value: Pick<T, K>, previousValue: Pick<T, K>) => void;
-type FieldAccessor<T extends StoreState, K extends keyof T> = {
-    (): T[K];
-    get(): T[K];
-    set(value: StoreValueUpdater<T[K]>): T[K];
-    subscribe(listener: StoreKeyListener<T, K>): () => void;
-};
-type StoreFields<T extends StoreState> = {
-    [K in keyof T]: FieldAccessor<T, K>;
-};
-interface StoreApi<T extends StoreState> {
-    use(): T;
-    use<K extends keyof T>(key: K): T[K];
-    use<K extends keyof T>(keys: readonly K[]): Pick<T, K>;
-    get(): T;
-    get<K extends keyof T>(key: K): T[K];
-    set<K extends keyof T>(key: K, value: StoreValueUpdater<T[K]>): T[K];
-    set(patch: StorePatch<T>): T;
-    replace(nextState: T | ((state: T) => T)): T;
-    reset(): T;
-    subscribe(listener: StoreListener<T>): () => void;
-    subscribe<K extends keyof T>(key: K, listener: StoreKeyListener<T, K>): () => void;
-    subscribe<K extends keyof T>(keys: readonly K[], listener: StoreKeysListener<T, K>): () => void;
-}
-type Store<T extends StoreState, TMethods extends Record<string, any> = {}> = StoreApi<T> & StoreFields<T> & TMethods;
-declare function createStore<T extends StoreState, TMethods extends Record<string, any> = {}>(initialState: T, extend?: (store: Store<T>) => TMethods): Store<T, TMethods>;
-
-/**
- * Prefetch strategy (TanStack Router–style):
- * - "intent": prefetch on hover and touchstart (with prefetchDelay)
- * - "viewport": prefetch when link enters viewport (IntersectionObserver)
- * - "render": prefetch as soon as the link is mounted
- * - "none" | false: no prefetch
- */
-type PrefetchBehavior = false | "intent" | "viewport" | "render" | "none";
-/** @internal Legacy prefetch mode for backward compatibility */
-type PrefetchLegacy = boolean | "hover" | "viewport" | "none";
-/**
- * Augment this interface via the generated farm.d.ts so Link href is typed
- * without passing a generic. Defaults to string when not augmented.
- */
-interface LinkDefaultRoute {
-}
-type DefaultRoutePath = LinkDefaultRoute extends {
-    _: infer TRoute extends string;
-} ? TRoute : string;
-type DefaultRoutePattern = LinkDefaultRoute extends {
-    pattern: infer TRoute extends string;
-} ? TRoute : DefaultRoutePath;
-type DefaultRouteHref = DefaultRoutePath | DefaultRoutePattern;
-type RouteHref<TRoute extends string> = TRoute | `${TRoute}?${string}` | `${TRoute}#${string}` | `${TRoute}?${string}#${string}`;
-type RouteParamValue = Exclude<FarmRouterPathParam, null | undefined>;
-type RouteOptionalParamValue = FarmRouterPathParam;
-type RouteParams<TRoute extends string> = string extends TRoute ? FarmRouterPathParams : ExtractRouteParams<StripRouteSuffix<TRoute>>;
-/** URI schemes recognized as typed external Link targets. Apps may augment this interface. */
-interface LinkExternalUriSchemes {
-    about: true;
-    blob: true;
-    data: true;
-    file: true;
-    ftp: true;
-    ftps: true;
-    geo: true;
-    git: true;
-    http: true;
-    https: true;
-    im: true;
-    intent: true;
-    irc: true;
-    ircs: true;
-    magnet: true;
-    mailto: true;
-    market: true;
-    sms: true;
-    ssh: true;
-    tel: true;
-    urn: true;
-    vscode: true;
-    webcal: true;
-    ws: true;
-    wss: true;
-}
-type ExternalUriScheme = Extract<keyof LinkExternalUriSchemes, string>;
-type UriSchemeLetter = "a" | "b" | "c" | "d" | "e" | "f" | "g" | "h" | "i" | "j" | "k" | "l" | "m" | "n" | "o" | "p" | "q" | "r" | "s" | "t" | "u" | "v" | "w" | "x" | "y" | "z";
-type UriSchemeStart = UriSchemeLetter | Uppercase<UriSchemeLetter>;
-type UriSchemeCharacter = UriSchemeStart | "0" | "1" | "2" | "3" | "4" | "5" | "6" | "7" | "8" | "9" | "+" | "-" | ".";
-type IsUriSchemeTail<TValue extends string> = TValue extends "" ? true : TValue extends `${infer First}${infer Rest}` ? First extends UriSchemeCharacter ? IsUriSchemeTail<Rest> : false : false;
-type IsUriScheme<TValue extends string> = TValue extends `${infer First}${infer Rest}` ? First extends UriSchemeStart ? IsUriSchemeTail<Rest> : false : false;
-type KnownExternalHref = `//${string}` | `${ExternalUriScheme}:${string}`;
-/** External URLs; these are never type-checked as routes. */
-type ExternalHref<THref extends string = string> = string extends THref ? KnownExternalHref : THref extends `//${string}` ? THref : THref extends `${infer Scheme}:${string}` ? IsUriScheme<Scheme> extends true ? THref : never : never;
-type StripRouteSuffix<TRoute extends string> = TRoute extends `${infer Path}?${string}` ? StripRouteSuffix<Path> : TRoute extends `${infer Path}#${string}` ? StripRouteSuffix<Path> : TRoute;
-type ExtractRouteParams<TRoute extends string> = Simplify<ExtractOptionalCatchAllParams<TRoute> & ExtractCatchAllParams<TRoute> & ExtractDynamicParams<TRoute>>;
-type ExtractOptionalCatchAllParams<TRoute extends string> = TRoute extends `${string}[[...${infer Param}]]${infer Rest}` ? {
-    [Key in Param]?: RouteOptionalParamValue;
-} & ExtractOptionalCatchAllParams<Rest> : {};
-type ExtractCatchAllParams<TRoute extends string> = TRoute extends `${string}[...${infer Param}]${infer Rest}` ? Param extends `[...${string}` ? ExtractCatchAllParams<Rest> : {
-    [Key in Param]: RouteParamValue;
-} & ExtractCatchAllParams<Rest> : {};
-type ExtractDynamicParams<TRoute extends string> = TRoute extends `${string}[${infer Param}]${infer Rest}` ? Param extends `...${string}` | `[...${string}` ? ExtractDynamicParams<Rest> : {
-    [Key in Param]: RouteParamValue;
-} & ExtractDynamicParams<Rest> : {};
-type Simplify<T> = {
-    [Key in keyof T]: T[Key];
-} & {};
-type HasRouteParams<TRoute extends string> = keyof RouteParams<TRoute> extends never ? false : true;
-type RoutesWithRequiredParams<TRoute extends string> = TRoute extends string ? HasRouteParams<TRoute> extends true ? TRoute : never : never;
-type LinkRouteParamsProps<TRoute extends string> = string extends TRoute ? {
-    params?: FarmRouterPathParams;
-} : HasRouteParams<TRoute> extends true ? {
-    params: RouteParams<TRoute>;
-} : {
-    params?: FarmRouterPathParams;
-};
-type LinkRouteTargetProps<TRoute extends string> = [RoutesWithRequiredParams<TRoute>] extends [
-    never
-] ? {
-    /** Internal route path with all params already resolved. */
-    href: RouteHref<TRoute>;
-    params?: FarmRouterPathParams;
-} : TRoute extends string ? {
-    /** Internal route path or route pattern. */
-    href: RouteHref<TRoute>;
-} & LinkRouteParamsProps<TRoute> : never;
-type LinkExternalTargetProps<THref extends string = string> = {
-    /** External URL; these are never type-checked as app routes. */
-    href: ExternalHref<THref>;
-    params?: never;
-};
-type LinkTargetProps<TRoute extends string, THref extends string> = LinkExternalTargetProps<THref> | LinkRouteTargetProps<TRoute>;
-type LinkProps<TRoute extends string = DefaultRouteHref, THref extends string = string> = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, "href"> & LinkTargetProps<TRoute, THref> & {
-    /**
-     * When to prefetch. TanStack-style: "intent" (hover+touch), "viewport", "render", or "none".
-     * Legacy: true (intent+viewport), "hover" (intent), "viewport", false/"none".
-     */
-    prefetch?: PrefetchBehavior | PrefetchLegacy;
-    /** Search params appended after route params are resolved. */
-    query?: FarmRouterBuildOptions["query"];
-    /** Hash appended after route params and search params are resolved. */
-    hash?: string;
-    /** Add a trailing slash to the generated internal href. */
-    trailingSlash?: boolean;
-    /** Delay in ms before intent-based prefetch (hover/touch). Default 50. */
-    prefetchDelay?: number;
-    /** Replace current history entry instead of pushing */
-    replace?: boolean;
-    /** Scroll to top after navigation (default: true) */
-    scroll?: boolean;
-    /** Wrap this SPA navigation in a browser View Transition when supported. */
-    viewTransition?: FarmViewTransitionMode;
-    /** Preserve the active locale by default, or navigate using this locale. */
-    locale?: FarmI18nLocale;
-};
-type LinkComponentType = <TRoute extends string = DefaultRouteHref, THref extends string = string>(props: LinkProps<TRoute, THref> & {
-    ref?: React__default.ForwardedRef<HTMLAnchorElement>;
-}) => React__default.ReactElement;
-declare const Link: LinkComponentType;
-
-export { type AnyMutationTarget, type ClientCachePersistenceOptions, type CrossTabCacheInvalidationOptions, type DefaultRouteHref, type DefaultRoutePath, type DefaultRoutePattern, type ExternalHref, FARM_CACHE_INVALIDATION_CHANNEL, FARM_CLIENT_CACHE_PERSIST_VERSION, type FarmClientCacheAdapter, type FarmClientCacheStorage, FarmViewTransitionMode, type FetcherFormDataContext, type FetcherFormProps, FetcherInputError, type FetcherState, type FetcherSubmit, type FetcherSubmitAsync, type InferMutationData, type InferMutationError, type InferMutationVariables, Link, type LinkDefaultRoute, type LinkExternalUriSchemes, type LinkProps, type LiveCacheInvalidationOptions, type MutationAsync, type MutationNetworkMode, type MutationOptimisticContext, type MutationStatus, type MutationTrigger, type PersistedEntry, type PrefetchBehavior, type RouteHref, type RouteOptionalParamValue, type RouteParamValue, type RouteParams, type Store, type StoreApi, type StoreFields, type StoreKeyListener, type StoreKeysListener, type StoreListener, type StorePatch, type StoreState, type StoreValueUpdater, type UseFetcherOptions, type UseFetcherReturn, type UseMutationOptions, type UseMutationReturn, clearPersistedCache, createStore, defineClientCacheAdapter, enableCrossTabCacheInvalidation, enableLiveCacheInvalidation, initConfiguredClientCachePersistence, initPersistedClientCache, storageClientCacheAdapter, useFetcher, useMutation };

package/dist/client.react-server.mjs

@@ -1,2 +0,0 @@
-"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, 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.d-DqKaCr1r.d.mts

@@ -1,199 +0,0 @@
-/** 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 the route manifest shows for a route: a {@link FarmMobileScreen}, or `"server"`, a native
- * screen the shell draws from the page the server renders (the analyzer's native tier). Config
- * cannot ask for `"server"`; `export const mobile = { native: true }` or `native.auto: "on"` gets
- * it for a page the analyzer proves. A shell that does not know a screen shows the route as web.
- */
-type FarmMobileRouteScreen = FarmMobileScreen | "server";
-/** 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`. `true` requires a native
-     * screen: a native file next to the page, or a page the analyzer finds can render natively.
-     * The build fails, naming each blocker, when it cannot.
-     */
-    native?: boolean;
-}
-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 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 };