import type { Constructor, Container } from '../Container.js';
import type { EventSubscriber } from './EventSubscriber.js';
export type ListenerFn = (event: object) => Promise<void> | void;
type WildcardListenerFn = (eventName: string, event: object) => Promise<void> | void;
/**
 * Central event dispatcher.
 */
export declare class EventDispatcher {
    private readonly container;
    private readonly listeners;
    private readonly wildcard;
    private readonly pushed;
    private readonly macros;
    constructor(container: Container);
    /**
     * Register a listener class or function for an event.
     */
    listen<TEvent extends object>(eventClass: Constructor<TEvent>, listener: Constructor<object> | ((event: TEvent) => Promise<void> | void)): this;
    listenMany(map: Record<string, Constructor<object>[]>): this;
    subscribe(subscriber: Constructor<object> | EventSubscriber): this;
    forget(eventClass: Constructor<object>): this;
    forgetListener(eventClass: Constructor<object>, listener: Constructor<object> | ListenerFn): this;
    hasListeners(eventClass: Constructor<object>): boolean;
    getListeners(eventClass: Constructor<object>): (Constructor<object> | ListenerFn)[];
    getRawListeners(): Map<Constructor<object>, (Constructor<object> | ListenerFn)[]>;
    /**
     * Register wildcard listener for event name patterns (`user.*`).
     */
    listenWildcard(pattern: string, listener: WildcardListenerFn): this;
    /**
     * Dispatch an event.
     */
    dispatch(event: object): Promise<void>;
    /**
     * Dispatch synchronously (inline listeners, immediate broadcasting).
     */
    dispatchSync(event: object): void;
    /**
     * Alias for dispatch() that bypasses afterCommit checks (currently no-op).
     */
    dispatchNow(event: object): Promise<void>;
    /**
     * Dispatch and halt if any listener returns `false`.
     */
    until(event: object): Promise<boolean>;
    /**
     * Best-effort defer until after response; falls back to immediate dispatch.
     */
    dispatchAfterResponse(event: object): void;
    /**
     * Push events for deferred batch dispatch.
     */
    push<TEvent extends object>(eventClass: Constructor<TEvent>, payload: unknown[]): this;
    flush<TEvent extends object>(eventClass: Constructor<TEvent>): Promise<void>;
    forgetPushed(): this;
    /**
     * Extend dispatcher at runtime.
     */
    macro(name: string, fn: Function): void;
    private resolveEventClass;
    private getWildcardListenersFor;
    private dispatchInternal;
    private invokeListener;
    private tryBroadcast;
}
export {};
//# sourceMappingURL=EventDispatcher.d.ts.map