import type { EventEmitter } from "../classes";
import type { EventMap, Listener, ListenerOptions, Register, Unregister } from "../types";
/**
 * Listens for `event` on `target`, calling `listener(event)` at the first occuring `event`. The `listener` is then unregistered upon the first occurence. The provided `options` are identical to those provided to `addEventListener`.
 * Returns a function that removes the `listener` from the `target` for the specified `event`.
 *
 * @param target The target on which to listen for the event.
 * @param event The event name to listen for.
 * @param listener The listener callback.
 * @param options Options to pass to the listener.
 * @returns A function that removes the `listener`.
 */
declare function once<K extends keyof HTMLElementEventMap>(target: HTMLElement, eventName: K, listener: Listener<HTMLElementEventMap[K]>, options?: ListenerOptions): Unregister;
declare function once<K extends keyof DocumentEventMap>(target: Document, eventName: K, listener: Listener<DocumentEventMap[K]>, options?: ListenerOptions): Unregister;
declare function once<K extends keyof WorkerEventMap>(target: Worker, eventName: K, listener: Listener<WorkerEventMap[K]>, options?: ListenerOptions): Unregister;
declare function once<E extends EventMap, K extends keyof E>(target: EventEmitter<E>, eventName: K, listener: Listener<E[K]>): Unregister;
declare function once<E>(target: EventTarget, eventName: string, listener: Listener<E>, options?: ListenerOptions): Unregister;
/**
 * Returns a function that registers a `listener` with optional `options` for a given `event` on the provided `target`. The `listener` is then unregistered upon the first occurence of the `event`.
 *
 * @example
 * ```typescript
 * const register = on(element, "click");
 * // Start listening
 * const off = register(callback);
 * // Stop listening
 * off();
 * ```
 *
 * @param target The target on which to listen for the event.
 * @param event The event name to listen for.
 * @returns Function that registers a `listener` with optional `options`.
 */
declare function once<K extends keyof HTMLElementEventMap>(target: HTMLElement, eventName: K): Register<Listener<HTMLElementEventMap[K]>, ListenerOptions>;
declare function once<K extends keyof DocumentEventMap>(target: Document, eventName: K): Register<Listener<DocumentEventMap[K]>, ListenerOptions>;
declare function once<K extends keyof WorkerEventMap>(target: Worker, eventName: K): Register<Listener<WorkerEventMap[K]>, ListenerOptions>;
declare function once<E extends EventMap, K extends keyof E>(target: EventEmitter<E>, eventName: K): Register<Listener<E[K]>, never>;
declare function once<E>(target: EventTarget, eventName: string): Register<Listener<E>, ListenerOptions>;
export { once };