import type { TourStepEffectArgs, WaitForStepEventOptions } from '../types';
/**
 * Step effect that pauses the tour until the user triggers a DOM event
 * on the target element, then calls `next()`.
 *
 * **Flow:**
 * 1. Show the tooltip popover.
 * 2. Guard focus so the focus trap doesn't steal it from the target.
 * 3. Wait one frame (popover mounted), then attach the event listener.
 * 4. Auto-focus the target after focus traps settle.
 * 5. On match → teardown → advance to next step.
 *
 * Returns a cleanup function for early teardown (e.g. dismiss / Back).
 */
export declare const waitForStepEvent: <T extends HTMLElement = HTMLElement>(event: keyof HTMLElementEventMap, args: Pick<TourStepEffectArgs, "show" | "next"> & {
    target?: (() => T | null) | undefined;
}, options?: WaitForStepEventOptions<T>) => VoidFunction;