import type { StateStore } from './state-store';
export type SliderEventData = {
    /**
     * The currently active slide index
     */
    currentIndex: number;
    /**
     * The index of the slide to be active next
     */
    nextIndex?: number;
    /**
     * The transition speed of the slide animation
     */
    speed: number;
};
export type ProgressEventData = {
    /**
     * The currently active slide index
     */
    currentIndex: number;
    /**
     * The index of the slide being transitioned to
     */
    nextIndex: number;
    /**
     * The progress of the transition as a percentage (0-100)
     */
    progress: number;
};
export interface SliderEventListenerMap {
    /**
     * Event triggered after slide transition completes
     */
    after: (data: SliderEventData) => void;
    /**
     * Event triggered before slide transition begins
     */
    before: (data: SliderEventData) => void;
    /**
     * Event triggered when a progressive transition is cancelled
     */
    cancel: (data: SliderEventData) => void;
    /**
     * Event triggered when slider is destroyed
     */
    destroy: () => void;
    /**
     * Event triggered when slider auto scrolling is stopped
     */
    pause: (data: SliderEventData) => void;
    /**
     * Event triggered when slider auto scrolling is started
     */
    play: (data: SliderEventData) => void;
    /**
     * Event triggered during a progressive transition with progress percentage
     */
    progress: (data: ProgressEventData) => void;
    /**
     * Event triggered when slider is reset
     */
    reset: () => void;
}
export type SliderEventType = keyof SliderEventListenerMap;
export type EventListenerMap = {
    [Property in SliderEventType]?: SliderEventListenerMap[Property][];
};
export interface BoxSliderOptions {
    /**
     * Automatically scroll through the slides
     */
    autoScroll: boolean;
    /**
     * Rotate from first to last slides when next and prev methods are called
     */
    loop: boolean;
    /**
     * Pause auto scrolling when the mouse hovers over the slider
     */
    pauseOnHover: boolean;
    /**
     * Speed of slide transition in milliseconds
     */
    speed: number;
    /**
     * Slide index to start from
     */
    startIndex: number;
    /**
     * Enable touch/swipe navigation
     */
    swipe: boolean;
    /**
     * Minimum distance in pixels required to start a drag gesture.
     * Once dragging starts, the transition commits based on drag progress
     * (>50%) or velocity, not this threshold.
     */
    swipeTolerance: number;
    /**
     * Number of milliseconds between each slide transition
     * when auto scrolling slides
     */
    timeout: number;
}
export interface TransitionSettings {
    /**
     * The slider element
     */
    el: HTMLElement;
    /**
     * The slide elements
     */
    slides: HTMLElement[];
    /**
     * The currently active slide index
     */
    currentIndex: number;
    /**
     * The next slide index to be shown
     */
    nextIndex: number;
    /**
     * `true` if the next slide index should be shown in a backward direction
     */
    isPrevious: boolean;
    /**
     * The transition speed for the slide animation
     */
    speed: number;
}
/**
 * State controller for progressive (drag-based) transitions
 */
export interface ProgressiveTransitionState {
    /**
     * Set the progress of the transition (0-1)
     */
    setProgress(progress: number): void;
    /**
     * Complete the transition from the current progress
     */
    complete(fromProgress: number): Promise<void>;
    /**
     * Cancel the transition and return to the start position
     */
    cancel(fromProgress: number): Promise<void>;
    /**
     * Immediately abort and reset to initial state
     */
    abort(): void;
}
export interface Effect {
    /**
     * The swipe direction for touch gestures. Defaults to 'horizontal' if not specified.
     */
    readonly swipeDirection?: 'horizontal' | 'vertical';
    /**
     * Destroy the effect to remove any timers, event listeners, etc.
     */
    destroy?: (el: HTMLElement, slides: HTMLElement[]) => void;
    /**
     * Set the initial state of the effect
     */
    initialize(
    /**
     * The slider element
     */
    el: HTMLElement, 
    /**
     * The slide elements
     */
    slides: HTMLElement[], 
    /**
     * The box slider options
     */
    options: BoxSliderOptions, 
    /**
     * State store to persist any attributes that need to be restored
     * when the slider is destroyed.
     */
    stateStore: StateStore): void;
    /**
     * Prepare a transition and return a state controller. Used for both
     * regular transitions (via complete(0)) and progressive drag transitions.
     */
    prepareTransition(settings: TransitionSettings): ProgressiveTransitionState | null;
}