import type { MatesRef } from "../Mutables/ref/ref";
type AnyEventName = keyof HTMLElementEventMap;
export type OnParentMap = {
    [K in AnyEventName]?: (event: HTMLElementEventMap[K]) => void;
};
/**
 * Attaches event listeners to a parent (or any ancestor) element via a
 * `MatesRef`, scoped to the lifetime of the element the directive is on.
 *
 * - Listeners are bound as soon as the ref's element becomes available.
 * - If the host element disconnects, all listeners are removed automatically.
 * - Handler identity changes are handled via ref-swap — no rebind overhead.
 *
 * @example
 * ```ts
 * import { ref, setRef, onParent } from "mates";
 *
 * const listRef = ref<HTMLUListElement>();
 *
 * html`
 *   <ul ${setRef(listRef)}>
 *     <li ${onParent(listRef, {
 *       click(e) { console.log("delegated click", e.target) },
 *       keydown(e) { if (e.key === "Enter") select(e.target) },
 *     })}>
 *       Item
 *     </li>
 *   </ul>
 * `;
 * ```
 */
export declare function onParent(target: MatesRef<HTMLElement>, events: OnParentMap): import("lit-html/directive").DirectiveResult<import("lit-html/directive").DirectiveClass>;
export {};
//# sourceMappingURL=onParentDirective.d.ts.map