export interface UseStepperProps {
    /** Total number of steps. */
    totalSteps: number;
    /** Initial active step (1-indexed). @default 1 */
    initialStep?: number;
    /**
     * Controlled current step (1-indexed).
     * When provided, step state is managed externally via `onStepChange`.
     */
    step?: number;
    /** Called whenever the active step changes. */
    onStepChange?: (step: number) => void;
    /**
     * Optional async guard called before advancing to the next step.
     * Return `true` to allow the transition, `false` to block it.
     * Useful for running form validation before moving forward.
     */
    onBeforeNext?: (currentStep: number) => boolean | Promise<boolean>;
}
export interface UseStepperReturn {
    /** The currently active step (1-indexed). */
    currentStep: number;
    /** Total number of steps. */
    totalSteps: number;
    /** Whether the current step is the first step. */
    isFirstStep: boolean;
    /** Whether the current step is the last step. */
    isLastStep: boolean;
    /** Whether navigation to the previous step is possible. */
    canGoPrev: boolean;
    /** Whether navigation to the next step is possible. */
    canGoNext: boolean;
    /**
     * Advance to the next step.
     * If `onBeforeNext` is provided, it is awaited first; the step only
     * advances when the guard returns `true`.
     */
    next: () => Promise<void>;
    /** Go back to the previous step (no-op if already on step 1). */
    prev: () => void;
    /** Jump directly to a specific step (1-indexed, clamped to valid range). */
    goTo: (step: number) => void;
    /** Jump to the first step. */
    reset: () => void;
}
/**
 * Headless hook for multi-step wizard / stepper logic.
 *
 * @description
 * Manages the active step state, navigation guards, and derived flags for
 * multi-step flows. Supports both controlled and uncontrolled modes.
 * Pair with the `<Stepper>` / `<Step>` visual components or any custom UI.
 *
 * @example
 * ```tsx
 * const { currentStep, totalSteps, next, prev, isFirstStep, isLastStep } =
 *   useStepper({ totalSteps: 3, onBeforeNext: () => form.trigger() });
 * ```
 */
export declare function useStepper({ totalSteps, initialStep, step: controlledStep, onStepChange, onBeforeNext, }: UseStepperProps): UseStepperReturn;