import { type ComponentPropsWithoutRef } from 'react';
import { type VariantProps } from 'class-variance-authority';
import type { StepSpec } from '../_shared/stepper';
type Size = 'sm' | 'default';
type CaptionPosition = 'top' | 'bottom';
declare const rootVariants: (props?: ({
    captionPosition?: "top" | "bottom" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
declare const trackVariants: (props?: ({
    size?: "default" | "sm" | null | undefined;
} & import("class-variance-authority/types").ClassProp) | undefined) => string;
export interface StepperProgressProps extends Omit<ComponentPropsWithoutRef<'div'>, 'aria-label'>, VariantProps<typeof trackVariants>, VariantProps<typeof rootVariants> {
    /** Active step (0-indexed). */
    activeStep: number;
    /** Step specs — `label` is used in the caption for the active step. */
    steps: StepSpec[];
    /** Override the default `aria-label` on the progressbar. */
    'aria-label'?: string;
    /** Hide the "Step N of M — label" caption. @default false */
    hideCaption?: boolean;
    /** Track size. @default 'default' */
    size?: Size;
    /** Caption position relative to the bar. @default 'top' */
    captionPosition?: CaptionPosition;
    /**
     * Consumer-supplied instance id, surfaced as `data-component-id` so an
     * agent / UI bridge can address this instance.
     */
    id?: string;
    /**
     * Called when an external driver (agent adapter) requests a step change.
     * StepperProgress is a pure indicator and does not own step state itself
     * — this hook lets a host wizard react to agent-driven navigation.
     */
    onStepChange?: (next: number) => void;
}
/**
 * Imperative handle for agent-readiness. Exposed via `ref`.
 *
 * The handle is the surface the future MCP UI bridge invokes through the
 * runtime registry. Methods are pure functions of the current props +
 * internal state; mutations route through the consumer's `onStepChange`.
 */
export interface StepperProgressHandle {
    getCurrentStep: () => number;
    getTotalSteps: () => number;
    gotoStep: (step: number) => void;
    next: () => void;
    previous: () => void;
}
declare const StepperProgress: import("react").ForwardRefExoticComponent<StepperProgressProps & import("react").RefAttributes<HTMLDivElement>>;
export { StepperProgress };
//# sourceMappingURL=stepper-progress.d.ts.map