import type { OnboardingStepStatus } from "../../onboarding/types.js";
export interface UseOnboardingChecklistResult {
    steps: OnboardingStepStatus[];
    completeCount: number;
    totalCount: number;
    dismissed: boolean;
    collapsed: boolean;
    /** `loading` only before the first answer; a refresh keeps the last one. */
    status: "loading" | "ready" | "error";
    error: Error | null;
    refresh: () => Promise<unknown>;
    dismiss: () => Promise<void>;
    reopen: () => Promise<void>;
    setCollapsed: (collapsed: boolean) => Promise<void>;
}
/**
 * Reads one named onboarding checklist (steps registered with
 * `registerOnboardingStep({ checklist })`). Rows are re-read whenever a local
 * action or an agent tool finishes, so a step checks itself off after the work
 * that completes it. Dismissal is stored by the onboarding plugin and the
 * collapsed state in application state, so both follow the user across devices.
 */
export declare function useOnboardingChecklist(checklist: string): UseOnboardingChecklistResult;