@farm.js/core 0.1.0-beta.3 → 0.1.0-beta.5

package/dist/client.d.mts

@@ -1,8 +1,9 @@
-import { n as ClientOptions, e as APIResult } from './client-DiViK9yK.mjs';
-export { p as APIClient, f as APIClientError, A as APIClientOptions, g as APIClientSystemError, a as APIClientWithoutIntegrationsOptions, U as InferIntegrationOperationBody, V as InferIntegrationOperationQuery, W as InferIntegrationOperationResponse, N as IntegrationAPI, H as IntegrationClient, J as IntegrationClientAliases, Q as IntegrationClientData, v as IntegrationClientError, L as IntegrationClientOptions, M as IntegrationClientRequestOptions, K as IntegrationClientRoot, P as IntegrationClients, T as IntegrationOperationResult, X as IntegrationServerClient, Y as IntegrationServerClientAliases, Z as IntegrationServerClientOptions, _ as IntegrationServerClientRequestOptions, $ as IntegrationServerClientRoot, a0 as IntegrationServerRequestLike, o as RouteAPIClient, q as ServerAPIClient, S as ServerAPIClientOptions, b as ServerAPIClientWithoutIntegrationsOptions, r as createAPIClient, w as createIntegrationApi, u as createIntegrationClient, x as createIntegrationClients, z as createIntegrationServerClient, y as createIntegrations, t as createServerAPIClient, B as getIntegrationAPIManifest, D as integrationClients, E as integrationsClient, G as integrationsServer } from './client-DiViK9yK.mjs';
+import { p as ClientOptions, g as APIResult } from './client-BT1mFQas.mjs';
+export { r as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, X as InferIntegrationOperationBody, Y as InferIntegrationOperationQuery, Z as InferIntegrationOperationResponse, T as IntegrationAPI, L as IntegrationClient, M as IntegrationClientAliases, V as IntegrationClientData, y as IntegrationClientError, P as IntegrationClientOptions, Q as IntegrationClientRequestOptions, N as IntegrationClientRoot, U as IntegrationClients, W as IntegrationOperationResult, _ as IntegrationServerClient, $ as IntegrationServerClientAliases, a0 as IntegrationServerClientOptions, a1 as IntegrationServerClientRequestOptions, a2 as IntegrationServerClientRoot, a3 as IntegrationServerRequestLike, q as RouteAPIClient, s as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, t as createAPIClient, z as createIntegrationApi, x as createIntegrationClient, B as createIntegrationClients, E as createIntegrationServerClient, D as createIntegrations, w as createServerAPIClient, G as getIntegrationAPIManifest, H as integrationClients, J as integrationsClient, K as integrationsServer } from './client-BT1mFQas.mjs';
+export { F as FarmAPIStream } from './transport-BmbGTXA5.mjs';
+import React__default, { ComponentType, FormHTMLAttributes, FormEvent, AnchorHTMLAttributes, RefObject } from 'react';
 export { ServerQueryFetchOptions, UseServerQueryOptions, UseServerQueryResult, fetchServerQuery, prefetchServerQuery, useServerQuery } from './server-query-client.mjs';
 export { F as FarmIntegrationAPI, e as FarmIntegrationAPIBodyFormat, f as FarmIntegrationAPIMethod, a as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, b as api, d as defineIntegrationAPI, c as defineIntegrationAPIOperation, i as endpoint } from './integration-api-CHT2OKAf.mjs';
-import React__default, { AnchorHTMLAttributes, RefObject } from 'react';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions, FarmRouterRouteInput } from './router.mjs';
 import { F as FarmClientPluginManager } from './plugin-BJDf43dc.mjs';
 export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './plugin-BJDf43dc.mjs';
@@ -64,6 +65,55 @@ type UseMutationReturn<TTarget extends AnyMutationTarget, TData = MutationData<T
  */
 declare function useMutation<TTarget extends AnyMutationTarget>(target: TTarget, options?: UseMutationOptions<MutationInput<TTarget>, MutationData<TTarget>, MutationError<TTarget>>): UseMutationReturn<TTarget>;
 
+type FetcherState = "idle" | "submitting";
+type FetcherFormDataContext = {
+    form: HTMLFormElement | null;
+    submitter: HTMLElement | null;
+};
+type UseFetcherOptions<TTarget extends AnyMutationTarget> = UseMutationOptions<InferMutationVariables<TTarget>, InferMutationData<TTarget>, InferMutationError<TTarget>> & {
+    /**
+     * Convert browser FormData into the target's typed variables.
+     *
+     * Generated API routes default to `{ body: Object.fromEntries(formData) }`
+     * (or `{ query: ... }` for GET/HEAD). Server functions receive FormData
+     * directly so their input schema remains authoritative.
+     */
+    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;
+    data: InferMutationData<TTarget> | null;
+    error: InferMutationError<TTarget> | 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>;
+
 type StoreState = Record<string, any>;
 type StoreValueUpdater<T> = T | ((previous: T) => T);
 type StorePatch<T extends StoreState> = Partial<T> | ((state: T) => Partial<T>);
@@ -118,8 +168,24 @@ interface PageData {
         description?: string;
     };
     layoutModules?: string[];
+    routeSlots?: RouteSlotPageData[];
+    interception?: {
+        from?: string;
+        slots: string[];
+    };
     i18n?: FarmI18nClientSnapshot;
 }
+interface RouteSlotPageData {
+    name: string;
+    ownerPattern: string;
+    containerId: string;
+    interception: boolean;
+    fallback: boolean;
+    modulePath: string;
+    isClientComponent: boolean;
+    shouldHydrate: boolean;
+    props: Record<string, any>;
+}
 interface RouterOptions {
     prefetchTimeout?: number;
     cacheMaxAge?: number;
@@ -376,6 +442,6 @@ declare function useRouter(options?: UseRouterOptions): {
 declare function usePageState<TState = unknown>(): TState | null;
 declare function useNavigation(): FarmNavigationState;
 declare function useBlocker(options: UseBlockerOptions): UseBlockerReturn;
-declare function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(key: string): RefObject<TElement>;
+declare function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(key: string): RefObject<TElement | null>;
 
-export { type DefaultRouteHref, type DefaultRoutePath, type DefaultRoutePattern, type ExternalHref, FarmClientPluginManager, type FarmNavigateOptions, type FarmNavigationBlocker, type FarmNavigationBlockerContext, type FarmNavigationListener, type FarmNavigationLocation, type FarmNavigationState, type FarmViewTransitionMode, type InferMutationData, type InferMutationError, type InferMutationVariables, Link, type LinkDefaultRoute, type LinkProps, type MutationAsync, type MutationOptimisticContext, type MutationStatus, type MutationTrigger, type PrefetchBehavior, type RouteHref, type RouteOptionalParamValue, type RouteParamValue, type RouteParams, SPARouter, type Store, type StoreApi, type StoreFields, type StoreKeyListener, type StoreKeysListener, type StoreListener, type StorePatch, type StoreState, type StoreValueUpdater, type UseBlockerOptions, type UseBlockerReturn, type UseMutationOptions, type UseMutationReturn, type UseRouterOptions, createStore, getRouter, navigateTo, prefetch, pushState, readPageState, replaceState, useBlocker, useMutation, useNavigation, usePageState, useRouter, useScrollRestoration };
+export { type AnyMutationTarget, type DefaultRouteHref, type DefaultRoutePath, type DefaultRoutePattern, type ExternalHref, FarmClientPluginManager, type FarmNavigateOptions, type FarmNavigationBlocker, type FarmNavigationBlockerContext, type FarmNavigationListener, type FarmNavigationLocation, type FarmNavigationState, type FarmViewTransitionMode, type FetcherFormDataContext, type FetcherFormProps, type FetcherState, type FetcherSubmit, type FetcherSubmitAsync, type InferMutationData, type InferMutationError, type InferMutationVariables, Link, type LinkDefaultRoute, type LinkProps, type MutationAsync, type MutationOptimisticContext, type MutationStatus, type MutationTrigger, type PrefetchBehavior, type RouteHref, type RouteOptionalParamValue, type RouteParamValue, type RouteParams, SPARouter, type Store, type StoreApi, type StoreFields, type StoreKeyListener, type StoreKeysListener, type StoreListener, type StorePatch, type StoreState, type StoreValueUpdater, type UseBlockerOptions, type UseBlockerReturn, type UseFetcherOptions, type UseFetcherReturn, type UseMutationOptions, type UseMutationReturn, type UseRouterOptions, createStore, getRouter, navigateTo, prefetch, pushState, readPageState, replaceState, useBlocker, useFetcher, useMutation, useNavigation, usePageState, useRouter, useScrollRestoration };

package/dist/client.d.ts

@@ -1,8 +1,9 @@
-import { n as ClientOptions, e as APIResult } from './client-DpEBJbts.js';
-export { p as APIClient, f as APIClientError, A as APIClientOptions, g as APIClientSystemError, a as APIClientWithoutIntegrationsOptions, U as InferIntegrationOperationBody, V as InferIntegrationOperationQuery, W as InferIntegrationOperationResponse, N as IntegrationAPI, H as IntegrationClient, J as IntegrationClientAliases, Q as IntegrationClientData, v as IntegrationClientError, L as IntegrationClientOptions, M as IntegrationClientRequestOptions, K as IntegrationClientRoot, P as IntegrationClients, T as IntegrationOperationResult, X as IntegrationServerClient, Y as IntegrationServerClientAliases, Z as IntegrationServerClientOptions, _ as IntegrationServerClientRequestOptions, $ as IntegrationServerClientRoot, a0 as IntegrationServerRequestLike, o as RouteAPIClient, q as ServerAPIClient, S as ServerAPIClientOptions, b as ServerAPIClientWithoutIntegrationsOptions, r as createAPIClient, w as createIntegrationApi, u as createIntegrationClient, x as createIntegrationClients, z as createIntegrationServerClient, y as createIntegrations, t as createServerAPIClient, B as getIntegrationAPIManifest, D as integrationClients, E as integrationsClient, G as integrationsServer } from './client-DpEBJbts.js';
+import { p as ClientOptions, g as APIResult } from './client-Nn0q4eO4.js';
+export { r as APIClient, h as APIClientError, b as APIClientOptions, i as APIClientSystemError, c as APIClientWithoutIntegrationsOptions, X as InferIntegrationOperationBody, Y as InferIntegrationOperationQuery, Z as InferIntegrationOperationResponse, T as IntegrationAPI, L as IntegrationClient, M as IntegrationClientAliases, V as IntegrationClientData, y as IntegrationClientError, P as IntegrationClientOptions, Q as IntegrationClientRequestOptions, N as IntegrationClientRoot, U as IntegrationClients, W as IntegrationOperationResult, _ as IntegrationServerClient, $ as IntegrationServerClientAliases, a0 as IntegrationServerClientOptions, a1 as IntegrationServerClientRequestOptions, a2 as IntegrationServerClientRoot, a3 as IntegrationServerRequestLike, q as RouteAPIClient, s as ServerAPIClient, S as ServerAPIClientOptions, d as ServerAPIClientWithoutIntegrationsOptions, t as createAPIClient, z as createIntegrationApi, x as createIntegrationClient, B as createIntegrationClients, E as createIntegrationServerClient, D as createIntegrations, w as createServerAPIClient, G as getIntegrationAPIManifest, H as integrationClients, J as integrationsClient, K as integrationsServer } from './client-Nn0q4eO4.js';
+export { F as FarmAPIStream } from './transport-BmbGTXA5.js';
+import React__default, { ComponentType, FormHTMLAttributes, FormEvent, AnchorHTMLAttributes, RefObject } from 'react';
 export { ServerQueryFetchOptions, UseServerQueryOptions, UseServerQueryResult, fetchServerQuery, prefetchServerQuery, useServerQuery } from './server-query-client.js';
 export { F as FarmIntegrationAPI, e as FarmIntegrationAPIBodyFormat, f as FarmIntegrationAPIMethod, a as FarmIntegrationAPIOperation, g as FarmIntegrationAPIResponseFormat, b as api, d as defineIntegrationAPI, c as defineIntegrationAPIOperation, i as endpoint } from './integration-api-CHT2OKAf.js';
-import React__default, { AnchorHTMLAttributes, RefObject } from 'react';
 import { FarmRouterPathParams, FarmRouterPathParam, FarmRouterBuildOptions, FarmRouterRouteInput } from './router.js';
 import { F as FarmClientPluginManager } from './plugin-BJDf43dc.js';
 export { a as FarmClientHydrationCompleteEvent, b as FarmClientHydrationEvent, d as FarmClientHydrationMode, e as FarmClientHydrationSession, f as FarmClientLocation, g as FarmClientNavigationAction, h as FarmClientNavigationErrorEvent, i as FarmClientNavigationEvent, j as FarmClientNavigationLoadedEvent, k as FarmClientNavigationResolvedEvent, l as FarmClientNavigationSession, m as FarmClientPerformanceEvent, n as FarmClientPlugin, o as FarmClientPluginCloseEvent, p as FarmClientPluginEnforce, q as FarmClientPluginErrorEvent, r as FarmClientPluginErrorPhase, s as FarmClientPluginManagerOptions, t as FarmClientPluginMetadata, u as FarmClientPluginRegistration, v as FarmClientPluginRouter, w as FarmClientPluginSetupEvent, x as FarmClientPluginStateEvent, c as createClientPluginManager } from './plugin-BJDf43dc.js';
@@ -64,6 +65,55 @@ type UseMutationReturn<TTarget extends AnyMutationTarget, TData = MutationData<T
  */
 declare function useMutation<TTarget extends AnyMutationTarget>(target: TTarget, options?: UseMutationOptions<MutationInput<TTarget>, MutationData<TTarget>, MutationError<TTarget>>): UseMutationReturn<TTarget>;
 
+type FetcherState = "idle" | "submitting";
+type FetcherFormDataContext = {
+    form: HTMLFormElement | null;
+    submitter: HTMLElement | null;
+};
+type UseFetcherOptions<TTarget extends AnyMutationTarget> = UseMutationOptions<InferMutationVariables<TTarget>, InferMutationData<TTarget>, InferMutationError<TTarget>> & {
+    /**
+     * Convert browser FormData into the target's typed variables.
+     *
+     * Generated API routes default to `{ body: Object.fromEntries(formData) }`
+     * (or `{ query: ... }` for GET/HEAD). Server functions receive FormData
+     * directly so their input schema remains authoritative.
+     */
+    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;
+    data: InferMutationData<TTarget> | null;
+    error: InferMutationError<TTarget> | 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>;
+
 type StoreState = Record<string, any>;
 type StoreValueUpdater<T> = T | ((previous: T) => T);
 type StorePatch<T extends StoreState> = Partial<T> | ((state: T) => Partial<T>);
@@ -118,8 +168,24 @@ interface PageData {
         description?: string;
     };
     layoutModules?: string[];
+    routeSlots?: RouteSlotPageData[];
+    interception?: {
+        from?: string;
+        slots: string[];
+    };
     i18n?: FarmI18nClientSnapshot;
 }
+interface RouteSlotPageData {
+    name: string;
+    ownerPattern: string;
+    containerId: string;
+    interception: boolean;
+    fallback: boolean;
+    modulePath: string;
+    isClientComponent: boolean;
+    shouldHydrate: boolean;
+    props: Record<string, any>;
+}
 interface RouterOptions {
     prefetchTimeout?: number;
     cacheMaxAge?: number;
@@ -376,6 +442,6 @@ declare function useRouter(options?: UseRouterOptions): {
 declare function usePageState<TState = unknown>(): TState | null;
 declare function useNavigation(): FarmNavigationState;
 declare function useBlocker(options: UseBlockerOptions): UseBlockerReturn;
-declare function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(key: string): RefObject<TElement>;
+declare function useScrollRestoration<TElement extends HTMLElement = HTMLElement>(key: string): RefObject<TElement | null>;
 
-export { type DefaultRouteHref, type DefaultRoutePath, type DefaultRoutePattern, type ExternalHref, FarmClientPluginManager, type FarmNavigateOptions, type FarmNavigationBlocker, type FarmNavigationBlockerContext, type FarmNavigationListener, type FarmNavigationLocation, type FarmNavigationState, type FarmViewTransitionMode, type InferMutationData, type InferMutationError, type InferMutationVariables, Link, type LinkDefaultRoute, type LinkProps, type MutationAsync, type MutationOptimisticContext, type MutationStatus, type MutationTrigger, type PrefetchBehavior, type RouteHref, type RouteOptionalParamValue, type RouteParamValue, type RouteParams, SPARouter, type Store, type StoreApi, type StoreFields, type StoreKeyListener, type StoreKeysListener, type StoreListener, type StorePatch, type StoreState, type StoreValueUpdater, type UseBlockerOptions, type UseBlockerReturn, type UseMutationOptions, type UseMutationReturn, type UseRouterOptions, createStore, getRouter, navigateTo, prefetch, pushState, readPageState, replaceState, useBlocker, useMutation, useNavigation, usePageState, useRouter, useScrollRestoration };
+export { type AnyMutationTarget, type DefaultRouteHref, type DefaultRoutePath, type DefaultRoutePattern, type ExternalHref, FarmClientPluginManager, type FarmNavigateOptions, type FarmNavigationBlocker, type FarmNavigationBlockerContext, type FarmNavigationListener, type FarmNavigationLocation, type FarmNavigationState, type FarmViewTransitionMode, type FetcherFormDataContext, type FetcherFormProps, type FetcherState, type FetcherSubmit, type FetcherSubmitAsync, type InferMutationData, type InferMutationError, type InferMutationVariables, Link, type LinkDefaultRoute, type LinkProps, type MutationAsync, type MutationOptimisticContext, type MutationStatus, type MutationTrigger, type PrefetchBehavior, type RouteHref, type RouteOptionalParamValue, type RouteParamValue, type RouteParams, SPARouter, type Store, type StoreApi, type StoreFields, type StoreKeyListener, type StoreKeysListener, type StoreListener, type StorePatch, type StoreState, type StoreValueUpdater, type UseBlockerOptions, type UseBlockerReturn, type UseFetcherOptions, type UseFetcherReturn, type UseMutationOptions, type UseMutationReturn, type UseRouterOptions, createStore, getRouter, navigateTo, prefetch, pushState, readPageState, replaceState, useBlocker, useFetcher, useMutation, useNavigation, usePageState, useRouter, useScrollRestoration };

package/dist/client.mjs

@@ -1,8 +1,9 @@
 import {
   Link,
   createStore,
+  useFetcher,
   useMutation
-} from "./chunk-XUBZ7JI4.mjs";
+} from "./chunk-2CUKEMVR.mjs";
 import {
   installChunkErrorRecovery,
   isChunkLoadError
@@ -11,7 +12,7 @@ import {
   fetchServerQuery,
   prefetchServerQuery,
   useServerQuery
-} from "./chunk-MH6FKW2I.mjs";
+} from "./chunk-J5YWQVI5.mjs";
 import {
   APIClientError,
   IntegrationClientError,
@@ -26,8 +27,8 @@ import {
   integrationClients,
   integrationsClient,
   integrationsServer
-} from "./chunk-C33RALN7.mjs";
-import "./chunk-NRRFGX45.mjs";
+} from "./chunk-W2CRQFF6.mjs";
+import "./chunk-TQAEEJB4.mjs";
 import "./chunk-SCFX4UTD.mjs";
 import {
   SPARouter,
@@ -42,7 +43,7 @@ import {
   usePageState,
   useRouter,
   useScrollRestoration
-} from "./chunk-5FW6PQ3J.mjs";
+} from "./chunk-QTZZ2ISQ.mjs";
 import "./chunk-ITN462YM.mjs";
 import "./chunk-B232I2GP.mjs";
 import {
@@ -53,9 +54,10 @@ import {
 } from "./chunk-JK25YEN6.mjs";
 import "./chunk-GS6K5OCM.mjs";
 import "./chunk-44ZCFSKE.mjs";
-import "./chunk-GZWT6VI5.mjs";
+import "./chunk-ALCLXXTY.mjs";
+import "./chunk-V3XURYJO.mjs";
 import "./chunk-WZ5QFROO.mjs";
-import "./chunk-SHRJG6OG.mjs";
+import "./chunk-RBRLLZL5.mjs";
 import "./chunk-7ZY5AIJO.mjs";
 import "./chunk-ZBE6MLHL.mjs";
 import {
@@ -97,6 +99,7 @@ export {
   readPageState,
   replaceState,
   useBlocker,
+  useFetcher,
   useMutation,
   useNavigation,
   usePageState,

package/dist/config.d.mts

@@ -1,4 +1,4 @@
-import { T as FarmUserConfig } from './client-plugins-Cnr0D3kk.mjs';
+import { T as FarmUserConfig } from './client-plugins-DQQ1adXM.mjs';
 import './plugin-BJDf43dc.mjs';
 import 'react';
 import 'http';
@@ -18,6 +18,7 @@ import './env.mjs';
 import './server-action-security.mjs';
 import './image-config-Duob7wER.mjs';
 import './types-BH1lhg5G.mjs';
+import './cache.mjs';
 import './route-runtime-DoOHzCAD.mjs';
 
 /** Define a Farm application config while preserving literal types. */

package/dist/config.d.ts

@@ -1,4 +1,4 @@
-import { T as FarmUserConfig } from './client-plugins-CTnsZz_A.js';
+import { T as FarmUserConfig } from './client-plugins-Cw4qUGsw.js';
 import './plugin-BJDf43dc.js';
 import 'react';
 import 'http';
@@ -18,6 +18,7 @@ import './env.js';
 import './server-action-security.js';
 import './image-config-Duob7wER.js';
 import './types-BH1lhg5G.js';
+import './cache.js';
 import './route-runtime-DoOHzCAD.js';
 
 /** Define a Farm application config while preserving literal types. */

package/dist/{devtools-HE4FTUDN.mjs → devtools-LVC3VB5P.mjs}

@@ -1,13 +1,13 @@
 import {
   getDeployTargetForPreset
-} from "./chunk-T543TMFY.mjs";
+} from "./chunk-NM3CRAAL.mjs";
 import "./chunk-UVCIEUJC.mjs";
 import "./chunk-RSKVYESE.mjs";
 import "./chunk-74YTBPTY.mjs";
 import "./chunk-7MABZJIM.mjs";
 import "./chunk-YW7OBE6Q.mjs";
 import "./chunk-GY2STC2S.mjs";
-import "./chunk-45LKHSHJ.mjs";
+import "./chunk-UB5UOSHB.mjs";
 import "./chunk-LLC7BNXW.mjs";
 import "./chunk-QGQX7SFC.mjs";
 import "./chunk-XIVV5IWN.mjs";
@@ -24,7 +24,7 @@ import {
 } from "./chunk-GQVGIUSN.mjs";
 import "./chunk-B232I2GP.mjs";
 import "./chunk-JK25YEN6.mjs";
-import "./chunk-SHRJG6OG.mjs";
+import "./chunk-RBRLLZL5.mjs";
 import {
   __name
 } from "./chunk-CGILA3WO.mjs";
@@ -367,4 +367,4 @@ __name(createFarmDevtoolsSnapshot, "createFarmDevtoolsSnapshot");
 export {
   createFarmDevtoolsSnapshot
 };
-//# sourceMappingURL=devtools-HE4FTUDN.mjs.map
+//# sourceMappingURL=devtools-LVC3VB5P.mjs.map

package/dist/docs.cjs

@@ -4785,7 +4785,8 @@ var FARM_CACHE_INVALIDATION_STATE = /* @__PURE__ */ Symbol.for("farm.cacheInvali
 var globalState = globalThis;
 function getFarmCacheInvalidationState() {
   return globalState[FARM_CACHE_INVALIDATION_STATE] ?? (globalState[FARM_CACHE_INVALIDATION_STATE] = {
-    listeners: /* @__PURE__ */ new Set()
+    listeners: /* @__PURE__ */ new Set(),
+    taskListeners: /* @__PURE__ */ new Set()
   });
 }
 __name(getFarmCacheInvalidationState, "getFarmCacheInvalidationState");
@@ -4795,6 +4796,12 @@ function subscribeFarmCacheInvalidation(listener) {
   return () => state.listeners.delete(listener);
 }
 __name(subscribeFarmCacheInvalidation, "subscribeFarmCacheInvalidation");
+function subscribeFarmCacheTask(listener) {
+  const state = getFarmCacheInvalidationState();
+  state.taskListeners.add(listener);
+  return () => state.taskListeners.delete(listener);
+}
+__name(subscribeFarmCacheTask, "subscribeFarmCacheTask");
 
 // src/server-action-security.ts
 var SERVER_ACTION_STORAGE_KEY = /* @__PURE__ */ Symbol.for("farm.serverActionStorage");
@@ -4805,6 +4812,9 @@ __name(getServerActionExecutionContext, "getServerActionExecutionContext");
 subscribeFarmCacheInvalidation((key) => {
   getServerActionExecutionContext()?.invalidations.add(key);
 });
+subscribeFarmCacheTask((task) => {
+  getServerActionExecutionContext()?.cacheTasks.add(task);
+});
 function getServerActionStorage() {
   const globalState2 = globalThis;
   if (!globalState2[SERVER_ACTION_STORAGE_KEY]) {