import * as React from 'react';
interface StepperContextValue {
    currentStep: number;
    totalSteps: number;
    orientation: 'horizontal' | 'vertical';
}
declare const useStepperContext: () => StepperContextValue;
interface StepperProps extends React.HTMLAttributes<HTMLDivElement> {
    currentStep: number;
    /** Layout direction. @default "horizontal" */
    orientation?: 'horizontal' | 'vertical';
}
/**
 * Multi-step progress indicator for sequential forms and wizards.
 *
 * @description
 * Guides the user through a linear multi-step flow. Supports horizontal (default)
 * and vertical orientations. Steps before `currentStep` show as completed (checkmark),
 * the current step as active (primary), error steps show an X, and future steps as pending (muted).
 *
 * @ai-rules
 * 1. `step` props are 1-indexed — the first step is `step={1}`, not `step={0}`.
 * 2. Control the active step with `currentStep` on `<Stepper>` (1-indexed).
 * 3. Validate the current step's form data BEFORE advancing `currentStep`.
 * 4. Use `error={true}` on a `<Step>` to indicate a validation failure on that step.
 */
declare const Stepper: React.ForwardRefExoticComponent<StepperProps & React.RefAttributes<HTMLDivElement>>;
interface StepProps extends React.HTMLAttributes<HTMLDivElement> {
    step: number;
    label: string;
    description?: string;
    /** Marks this step as having a validation error. Renders a red X icon. */
    error?: boolean;
}
declare const Step: React.ForwardRefExoticComponent<StepProps & React.RefAttributes<HTMLDivElement>>;
export { Stepper, Step, useStepperContext };