/**
 * EventualResult - A utility for the "stale-while-revalidate" pattern
 *
 * Returns cached data immediately, optionally refreshes in background.
 */
type EventualResult<TData> = {
    readonly current: TData;
    readonly fresh: Promise<TData> | null;
    readonly isStale: boolean;
};
/**
 * Create an EventualResult from current data and optional fresh promise
 */
declare const eventual: <TData>(current: TData, fresh: Promise<TData> | null) => EventualResult<TData>;
/**
 * Create an EventualResult, lazily creating the fresh promise only when stale
 */
declare const eventualIf: <TData>(current: TData, isStale: boolean, getFresh: () => Promise<TData>) => EventualResult<TData>;
/**
 * Transform both current and fresh values of an EventualResult
 */
declare const mapEventual: <TInput, TOutput>(result: EventualResult<TInput>, fn: (value: TInput) => TOutput) => EventualResult<TOutput>;
/**
 * Combine multiple EventualResults into a single EventualResult
 *
 * The combined result is stale if any input is stale.
 * The fresh promise resolves when all stale inputs have refreshed.
 */
declare const combineEventual: <TResults extends Record<string, EventualResult<unknown>>>(results: TResults) => EventualResult<{ [K in keyof TResults]: TResults[K]["current"]; }>;
export { eventual, eventualIf, mapEventual, combineEventual };
export type { EventualResult };
//# sourceMappingURL=eventual.d.ts.map