jotai
Version:
👻 Next gen state management that will spook you
48 lines (47 loc) • 2.69 kB
TypeScript
declare type Awaited<T> = T extends Promise<infer V> ? Awaited<V> : T;
declare type Getter = {
<Value>(atom: Atom<Value | Promise<Value>>): Value;
<Value>(atom: Atom<Promise<Value>>): Value;
<Value>(atom: Atom<Value>): Awaited<Value>;
};
declare type WriteGetter = Getter & {
<Value>(atom: Atom<Value | Promise<Value>>, options: {
unstable_promise: true;
}): Promise<Value> | Value;
<Value>(atom: Atom<Promise<Value>>, options: {
unstable_promise: true;
}): Promise<Value> | Value;
<Value>(atom: Atom<Value>, options: {
unstable_promise: true;
}): Promise<Awaited<Value>> | Awaited<Value>;
};
declare type Setter = {
<Value, Result extends void | Promise<void>>(atom: WritableAtom<Value, undefined, Result>): Result;
<Value, Update, Result extends void | Promise<void>>(atom: WritableAtom<Value, Update, Result>, update: Update): Result;
};
declare type Read<Value> = (get: Getter) => Value;
declare type Write<Update, Result extends void | Promise<void>> = (get: WriteGetter, set: Setter, update: Update) => Result;
declare type WithInitialValue<Value> = {
init: Value;
};
export declare type Scope = symbol | string | number;
export declare type SetAtom<Update, Result extends void | Promise<void>> = undefined extends Update ? (update?: Update) => Result : (update: Update) => Result;
declare type OnUnmount = () => void;
declare type OnMount<Update, Result extends void | Promise<void>> = <S extends SetAtom<Update, Result>>(setAtom: S) => OnUnmount | void;
export declare type Atom<Value> = {
toString: () => string;
debugLabel?: string;
read: Read<Value>;
};
export declare type WritableAtom<Value, Update, Result extends void | Promise<void> = void> = Atom<Value> & {
write: Write<Update, Result>;
onMount?: OnMount<Update, Result>;
};
declare type SetStateAction<Value> = Value | ((prev: Value) => Value);
export declare type PrimitiveAtom<Value> = WritableAtom<Value, SetStateAction<Value>>;
export declare function atom<Value, Update, Result extends void | Promise<void> = void>(read: Read<Value>, write: Write<Update, Result>): WritableAtom<Value, Update, Result>;
export declare function atom<Value>(read: Read<Value>): Atom<Value>;
export declare function atom(invalidFunction: (...args: any) => any, write?: any): never;
export declare function atom<Value, Update, Result extends void | Promise<void> = void>(initialValue: Value, write: Write<Update, Result>): WritableAtom<Value, Update, Result> & WithInitialValue<Value>;
export declare function atom<Value>(initialValue: Value): PrimitiveAtom<Value> & WithInitialValue<Value>;
export {};