import { type MaybeRef } from './_shared';
/**
 * Auto-cleanup event listener.
 * Registers an event listener on the target and automatically removes it on unmount.
 * Supports reactive targets via MaybeRef.
 *
 * @param target - The event target (Window, Document, HTMLElement, or a Ref to one)
 * @param event - The event name
 * @param handler - The event handler
 * @param options - AddEventListenerOptions
 * @returns A cleanup function to manually remove the listener
 */
export declare function useEventListener(target: MaybeRef<EventTarget | null | undefined> | EventTarget, event: string, handler: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): () => void;
declare type EventTarget = Window | Document | HTMLElement | Element;