import { ComputedRef, MaybeRef } from 'vue';
import { Nullable } from '../../types';

/**
 * Shared event listener status enum used by all event listener composables
 */
export declare enum EventListenerStatus {
    NotAttached = "not-attached",
    Attached = "attached",
    Error = "error"
}
/**
 * Adapter functions for attaching/detaching events on different target types
 */
export interface EventListenerAdapter<TTarget> {
    attach: (target: TTarget, event: string, handler: (...args: any[]) => void) => void;
    detach: (target: TTarget, event: string, handler: (...args: any[]) => void) => void;
    /** Optional validation before attaching (e.g., hasLayer check) */
    validate?: (target: TTarget) => boolean;
}
export interface EventListenerConfig<TTarget> {
    target: MaybeRef<Nullable<TTarget>>;
    event: string;
    on: (...args: any[]) => void;
    debug?: boolean;
    once?: boolean;
    adapter: EventListenerAdapter<TTarget>;
    /** Additional reactive dependencies that trigger re-evaluation */
    extraDeps?: () => any[];
}
export interface EventListenerActions {
    removeListener: () => void;
    attachListener: () => void;
    isListenerAttached: ComputedRef<boolean>;
    listenerStatus: ComputedRef<EventListenerStatus>;
}
/**
 * Generic factory for creating event listener composables.
 * Handles: status tracking, watchEffect lifecycle, onUnmounted cleanup, idempotent removal.
 *
 * @param config - Event listener configuration
 * @returns Actions and state for the event listener
 */
export declare function createEventListenerComposable<TTarget>(config: EventListenerConfig<TTarget>): EventListenerActions;