export interface IteratorOptions {
    loop?: boolean;
}
export interface IteratorState<T> {
    index: number;
    value: T | number;
    next(): void;
    prev(): void;
    set(index: number): void;
    hasNext: boolean;
    hasPrev: boolean;
}
/**
 * A hook that provides iteration over an array or numeric range.
 * When given a number n, iterates over range [0..n-1].
 *
 * @param items Array of items or number for range
 * @param opts Options for iteration behavior
 * @returns Object containing current state and control functions
 *
 * @example
 * // Array iteration
 * const { value, next, hasNext } = useIterator(['a', 'b', 'c']);
 *
 * @example
 * // Range iteration with loop
 * const { value, next } = useIterator(3, { loop: true });
 */
export declare function useIterator<T>(items: T[] | number, opts?: IteratorOptions): IteratorState<T>;