import type { SignalOptions, EvType, EvListener, EventOptions } from './types.ts';
/**
 * Wraps an array of DOM elements and provides chainable methods
 * for CSS, attributes, classes, data, aria, events, and animation.
 *
 * Each method delegates to the standalone functions from the dom package,
 * so DomCollection is a thin orchestration layer rather than a reimplementation.
 *
 * @example
 *     const btns = new DomCollection<HTMLButtonElement>(elements, { signal });
 *     btns.css({ color: 'red' }).class.add('active').on('click', handler);
 */
export declare class DomCollection<T extends HTMLElement> {
    constructor(elements: T[], opts?: SignalOptions);
    get elements(): T[];
    get length(): number;
    get first(): T | undefined;
    at(index: number): T | undefined;
    each(fn: (el: T, index: number) => void): this;
    map<U>(fn: (el: T, index: number) => U): U[];
    filter(fn: (el: T, index: number) => boolean): DomCollection<T>;
    [Symbol.iterator](): Iterator<T>;
    get css(): any;
    get attr(): any;
    get class(): any;
    get data(): any;
    get aria(): any;
    on(event: EvType, handler: EvListener, opts?: EventOptions): this;
    once(event: EvType, handler: EvListener, opts?: EventOptions): this;
    off(event: EvType, handler: EventListener): this;
    emit(event: string, detail?: unknown): this;
    into(container: Element): this;
    get animate(): any;
}