import { type CSSProperties } from 'react';
import { type SStepperItem, type SStepperSize } from './stepper.config';
export interface SStepperProps {
    /** 단계 목록 */
    items: SStepperItem[];
    /** 현재 활성 단계 value */
    value?: string;
    /** 크기 */
    size?: SStepperSize;
    /** 세로형 여부 */
    vertical?: boolean;
    /** 단계 클릭 가능 여부. 미지정 시 가로형=false, 세로형=true */
    clickable?: boolean;
    /** 단계 선택 시 호출 */
    onValueChange?: (value: string, item: SStepperItem, index: number) => void;
    /** 접근성 레이블 */
    ariaLabel?: string;
    className?: string;
    style?: CSSProperties;
}
/**
 * ref 로 노출되는 커스텀 툴팁 제어 API. 세로형 전용 — items 중 error 가 true 인 첫 번째
 * 아이템의 텍스트+뱃지 영역에 표시된다.
 *
 * 지금은 대상(첫 번째 error 아이템 하나)·문구·스타일이 hover 툴팁(ERROR_TOOLTIP_MESSAGE, danger)과
 * 동일하게 고정되어 있다 — 열고 닫는 타이밍만 소비자가 제어한다. 대상 아이템을 지정하거나
 * content·type 을 커스터마이즈하는 기능은 필요해지면 추가한다(지금은 만들지 않음).
 */
export interface SStepperHandle {
    /** error 아이템 중 첫 번째에 툴팁을 연다. error 아이템이 없으면 아무 일도 일어나지 않는다. */
    showItemTooltip: () => void;
    /** 열려있는 커스텀 툴팁을 닫는다. 활성 단계(value prop)가 바뀌면 별도 호출 없이도 자동으로 닫힌다. */
    hideItemTooltip: () => void;
}
/** SStepper — sd-stepper 포팅. 단계 진행 상태 표시 전용. */
export declare const SStepper: import("react").ForwardRefExoticComponent<SStepperProps & import("react").RefAttributes<SStepperHandle>>;