/**
 * @license MIT
 * @module @whoj/utils-vue@2.4.0
 * @copyright (c) 2026 Jonson B.
 */

import { Arrayable, Func } from '@whoj/utils-types';
import { ComputedRefable } from './refOf.mjs';

interface InferEventTarget<Events> {
    addEventListener: (event: Events, fn?: any, options?: any) => any;
    removeEventListener: (event: Events, fn?: any, options?: any) => any;
}
interface BasicEventListener<E = Event> {
    (evt: E): void;
}
/**
 * Register using addEventListener on mounted, and removeEventListener automatically on unmounted.
 * @param event
 * @param listener
 * @param options
 *
 * @__NO_SIDE_EFFECTS__
 */
declare function listenEvent<E extends keyof WindowEventMap>(event: Arrayable<E>, listener: Arrayable<(this: Window, ev: WindowEventMap[E]) => any>, options?: boolean | AddEventListenerOptions): Func;
declare function listenEvent<E extends keyof WindowEventMap>(target: Window, event: Arrayable<E>, listener: Arrayable<(this: Window, ev: WindowEventMap[E]) => any>, options?: boolean | AddEventListenerOptions): Func;
declare function listenEvent<E extends keyof DocumentEventMap>(target: Document, event: Arrayable<E>, listener: Arrayable<(this: Document, ev: DocumentEventMap[E]) => any>, options?: boolean | AddEventListenerOptions): Func;
declare function listenEvent<Names extends string, EventType = Event>(target: InferEventTarget<Names>, event: Arrayable<Names>, listener: Arrayable<BasicEventListener<EventType>>, options?: boolean | AddEventListenerOptions): Func;
declare function listenEvent<EventType = Event>(target: ComputedRefable<null | undefined | EventTarget>, event: Arrayable<string>, listener: Arrayable<BasicEventListener<EventType>>, options?: boolean | AddEventListenerOptions): Func;

export { listenEvent };