import type { Ref } from '@stacksjs/stx';
/**
 * Step-by-step navigation composable.
 * Provides reactive state and controls for stepping through an ordered list.
 *
 * @param steps - Array of step values
 * @param initialStep - Optional initial step (defaults to first step)
 */
export declare function useStepper<T>(steps: T[], initialStep?: T): UseStepperReturn<T>;
export declare interface UseStepperReturn<T> {
  steps: Ref<T[]>
  current: Ref<T>
  index: Ref<number>
  isFirst: Ref<boolean>
  isLast: Ref<boolean>
  next: () => void
  previous: () => void
  goTo: (step: T) => void
  goToIndex: (index: number) => void
  isBefore: (step: T) => boolean
  isAfter: (step: T) => boolean
  isCurrent: (step: T) => boolean
}