import { type Derived } from "./core/handle.ts";
export interface ResourceOptions {
    /** 連続した変化をまとめる(ms)。入力に追従する検索などで使う。 */
    debounce?: number;
    /** 取得中も前回の値を保持する(既定 true。チラつき防止)。 */
    keepPrevious?: boolean;
    /** 生成時にすぐ取得するか(既定 true)。 */
    immediate?: boolean;
}
export interface Resource<T> {
    /** 取得できた値。まだ無ければ undefined。 */
    data: Derived<T | undefined>;
    /** 取得中か(debounce 待ちも含む)。 */
    loading: Derived<boolean>;
    /** 失敗した理由。成功したら undefined に戻る。 */
    error: Derived<unknown>;
    /** 手動で取り直す。 */
    refetch(): void;
    /** 進行中のリクエストを中断する。 */
    abort(): void;
    /** 取得の完了を待つ(テスト・初期化待ち用)。 */
    ready(): Promise<T | undefined>;
}
type Fetcher<S, T> = (value: S, signal: AbortSignal) => T | Promise<T>;
/**
 * 一度だけ取得する:
 *   const rows = $$.resource(() => fetch("/js/simulation.json").then(r => r.json()));
 *   $$("@spinner").when(rows.loading);
 *   $$("@error").when(() => !!rows.error());
 *
 * 入力に追従して取得し直す(前のリクエストは自動で中断される):
 *   const q = $$("@q").val().state("");
 *   const hits = $$.resource(q, (keyword, signal) =>
 *     fetch(`/search?q=${keyword}`, { signal }).then(r => r.json()), { debounce: 300 });
 */
export declare function resource<T>(fetcher: Fetcher<undefined, T>, options?: ResourceOptions): Resource<T>;
export declare function resource<S, T>(source: unknown, fetcher: Fetcher<S, T>, options?: ResourceOptions): Resource<T>;
export interface Action<A extends unknown[]> {
    (...args: A): Promise<void>;
    /** 実行中か。 $$("@save").prop("disabled", save.running) */
    running: Derived<boolean>;
    /** 直前の失敗理由。 */
    error: Derived<unknown>;
}
/**
 *   const save = $$.action(async () => {
 *     await fetch("/api/save", { method: "POST", body: … });
 *   });
 *   $$("@save").click(save);
 *   $$("@save").prop("disabled", save.running);   // 押せない間は自動で無効
 *   $$("@save-error").when(() => !!save.error());
 */
export declare function action<A extends unknown[]>(fn: (...args: A) => unknown | Promise<unknown>): Action<A>;
export {};