import { AsyncState, AsyncMode, AsyncKey, AsyncRequestId } from './types';

/**
 * Extra properties that can be added to async state.
 * @internal
 */
export interface AsyncStateExtra<T> {
    __key?: AsyncKey<T>;
    __requestId?: AsyncRequestId;
}
/**
 * Create a frozen AsyncState with the specified status.
 * Users cannot modify properties directly - must use async actions.
 *
 * Overloads:
 * - asyncState("fresh", "idle") - Fresh idle state
 * - asyncState("fresh", "pending", extra?) - Fresh pending state
 * - asyncState("fresh", "success", data) - Fresh success state
 * - asyncState("fresh", "error", error, extra?) - Fresh error state
 * - asyncState("stale", "idle", data) - Stale idle state
 * - asyncState("stale", "pending", data, extra?) - Stale pending state
 * - asyncState("stale", "success", data) - Stale success state
 * - asyncState("stale", "error", data, error, extra?) - Stale error state
 */
export declare function asyncState<T = unknown>(mode: "fresh", status: "idle"): AsyncState<T, "fresh">;
export declare function asyncState<T = unknown>(mode: "fresh", status: "pending", extra?: AsyncStateExtra<T>): AsyncState<T, "fresh">;
export declare function asyncState<T>(mode: "fresh", status: "success", data: T): AsyncState<T, "fresh">;
export declare function asyncState<T = unknown>(mode: "fresh", status: "error", error: Error, extra?: AsyncStateExtra<T>): AsyncState<T, "fresh">;
export declare function asyncState<T>(mode: "stale", status: "idle", data: T): AsyncState<T, "stale">;
export declare function asyncState<T>(mode: "stale", status: "pending", data: T, extra?: AsyncStateExtra<T>): AsyncState<T, "stale">;
export declare function asyncState<T>(mode: "stale", status: "success", data: T): AsyncState<T, "stale">;
export declare function asyncState<T>(mode: "stale", status: "error", data: T, error: Error, extra?: AsyncStateExtra<T>): AsyncState<T, "stale">;
export declare namespace asyncState {
    var from: typeof asyncStateFrom;
}
/**
 * Create a new AsyncState based on a previous state, preserving mode and stale data.
 * Useful for deriving new states while maintaining the mode semantics.
 *
 * @example
 * // From success to pending (preserves mode and stale data)
 * const next = asyncState.from(prev, "pending");
 *
 * // From pending to success
 * const next = asyncState.from(prev, "success", newData);
 *
 * // From any to error
 * const next = asyncState.from(prev, "error", new Error("failed"));
 */
export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "idle"): AsyncState<T, M>;
export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "pending"): AsyncState<T, M>;
export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "success", data: T): AsyncState<T, M>;
export declare function asyncStateFrom<T, M extends AsyncMode>(prev: AsyncState<T, M>, status: "error", error: Error): AsyncState<T, M>;
/**
 * Create a fresh mode async state (data undefined during loading/error).
 */
export declare function fresh<T = unknown>(): AsyncState<T, "fresh">;
/**
 * Create a stale mode async state with initial data.
 * Data is preserved during loading and error states.
 */
export declare function stale<T>(): AsyncState<T | undefined, "stale">;
export declare function stale<T>(initialData: T | undefined | null): AsyncState<T, "stale">;
//# sourceMappingURL=state.d.ts.map