/**
 * This module provides classes and interfaces for working with HTML elements.
 * @module
 */
import type { ELEMENT_MAP } from "./elements.js";
import type { HTMLTag, VoidHTMLTag } from "./tags.js";
/**
 * Represents an HTML element.
 *
 * @template T - The HTML tag type.
 * @template A - The type of attributes for the HTML element.
 * @template C - The type of children for the HTML element.
 */
export interface HTMLElement<T extends HTMLTag, A, C> {
    readonly tag: T;
    readonly attributes: A;
    readonly children: Array<C>;
}
/**
 * A concrete implementation of the `HTMLElement` interface.
 */
export declare class BaseHTMLElement<T extends HTMLTag, A, C> implements HTMLElement<T, A, C> {
    readonly tag: T;
    readonly attributes: A;
    readonly children: Array<C>;
    /**
     * Represents an HTML element.
     * @template T - The type of the HTML tag.
     * @template A - The type of the HTML attributes.
     * @template C - The type of the HTML children.
     */
    constructor(tag: T, attributes: A, children: Array<C>);
}
/**
 * Creates a new instance of `BaseHTMLElement` with the specified tag, attributes, and children.
 *
 * @template T - The HTML tag type.
 * @template A - The type of the attributes object.
 * @template C - The type of the children array elements.
 * @param {T} tag - The HTML tag.
 * @param {string | A | C | Array<C>} attributes - The attributes of the HTML element.
 * @param {Array<C>} children - The children of the HTML element.
 * @returns {BaseHTMLElement<T, A, C>} - The created `BaseHTMLElement` instance.
 */
export declare const createHTMLElement: <T extends HTMLTag, A, C>(tag: T, attributes: string | A | C | Array<C>, children: Array<C>) => BaseHTMLElement<T, A, C>;
/**
 * Represents a void HTML element with a specific tag and attributes.
 *
 * @template T - The HTML tag type.
 * @template A - The attributes type.
 */
export interface VoidHTMLElement<T extends Extract<HTMLTag, VoidHTMLTag>, A> {
    readonly tag: T;
    readonly attributes: A;
}
/**
 * A concrete implementation of the `VoidHTMLElement` interface.
 */
export declare class VoidBaseHTMLElement<T extends Extract<HTMLTag, VoidHTMLTag>, A> implements VoidHTMLElement<T, A> {
    readonly tag: T;
    readonly attributes: A;
    /**
     * Represents an HTML element.
     * @template T - The type of the HTML tag.
     * @template A - The type of the HTML attributes.
     */
    constructor(tag: T, attributes: A);
}
/**
 * Represents a Doctype element in HTML.
 */
export declare class Doctype {
    readonly tag: "!DOCTYPE";
    readonly attributes: {
        html: true;
    };
}
/**
 * Represents an HTML document.
 */
export declare class HTMLDocument {
    readonly children: Array<Doctype | ELEMENT_MAP["html"]>;
    /**
     * Creates a new HTMLDocument instance.
     * @param doctype - The doctype of the HTML document.
     * @param children - The children elements of the HTML document.
     */
    constructor(doctype: Doctype, ...children: Array<ELEMENT_MAP["html"]>);
}