import { Atom, AtomConfig, AtomOptions, ReducerAtom, ReadonlyAtom, SourceAtomConfig } from "./types.js";
/** The current state of an async atom. */
export type AsyncAtomState<Data, Error = unknown> = {
    status: 'pending';
} | {
    status: 'done';
    data: Data;
} | {
    status: 'error';
    error: Error;
};
/** Options passed to an async atom getter. */
export interface AsyncAtomOptions {
    /** Signal aborted when the async atom recomputes before this run settles. */
    signal: AbortSignal;
}
/**
 * Creates a read-only atom whose value is loaded from an async getter.
 *
 * The getter receives an `AbortSignal`; when the async atom recomputes, the
 * previous signal is aborted and stale resolutions are ignored.
 */
export declare function createAsyncAtom<T>(getValue: (options: AsyncAtomOptions) => Promise<T>, options?: AtomOptions<AsyncAtomState<T>>): ReadonlyAtom<AsyncAtomState<T>>;
/**
 * Creates an atom.
 *
 * Pass a value for a writable atom or a getter for a computed read-only atom.
 */
export declare function createAtom<T>(getValue: (prev?: T) => T, options?: AtomOptions<T>): ReadonlyAtom<T>;
export declare function createAtom<T>(initialValue: T, options?: AtomOptions<T>): Atom<T>;
/**
 * Creates a read-only atom backed by an external snapshot source.
 *
 * The listener is shared by direct and derived subscriptions. Plain reads do
 * not subscribe; the last consumer leaving synchronously releases the listener.
 */
export declare function createSourceAtom<T>(source: SourceAtomConfig<T>, options?: AtomOptions<T>): ReadonlyAtom<T>;
/**
 * Creates an inert atom config that can be instantiated later.
 *
 * Useful for framework hooks that need to create a stable local atom from
 * component input.
 */
export declare function createAtomConfig<T, TInput>(getInitialValue: (input: TInput) => T, options?: AtomOptions<T>): AtomConfig<T, TInput>;
export declare function createAtomConfig<T>(initialValue: T, options?: AtomOptions<T>): AtomConfig<T, undefined>;
/** Creates an atom whose updates are handled by a reducer function. */
export declare function createReducerAtom<TState, TEvent>(initialValue: TState, reducer: (state: TState, event: TEvent) => TState, options?: AtomOptions<TState>): ReducerAtom<TState, TEvent>;