(** HTML5 structural and document element specifications.

    This module defines element specifications for HTML5 document structure,
    sectioning, and grouping elements according to the WHATWG HTML specification.

    @see <https://html.spec.whatwg.org/multipage/> WHATWG HTML Specification *)

(** {1 Document structure elements} *)

val html : Element_spec.t
(** The [html] element represents the root of an HTML document. *)

val head : Element_spec.t
(** The [head] element represents a collection of metadata for the document. *)

val body : Element_spec.t
(** The [body] element represents the contents of the document. *)

val title : Element_spec.t
(** The [title] element represents the document's title or name. *)

val base : Element_spec.t
(** The [base] element specifies the document base URL and/or default browsing
    context for navigation. *)

val link : Element_spec.t
(** The [link] element specifies relationships between the current document and
    external resources. *)

val meta : Element_spec.t
(** The [meta] element represents various kinds of metadata that cannot be
    expressed using other metadata elements. *)

val style : Element_spec.t
(** The [style] element allows authors to embed CSS style sheets in their documents. *)

(** {1 Sectioning elements} *)

val article : Element_spec.t
(** The [article] element represents a complete, or self-contained, composition
    in a document, page, application, or site. *)

val section : Element_spec.t
(** The [section] element represents a generic section of a document or application. *)

val nav : Element_spec.t
(** The [nav] element represents a section of a page that links to other pages
    or to parts within the page. *)

val aside : Element_spec.t
(** The [aside] element represents a section of a page that consists of content
    that is tangentially related to the content around it. *)

val h1 : Element_spec.t
(** The [h1] element represents a heading at level 1. *)

val h2 : Element_spec.t
(** The [h2] element represents a heading at level 2. *)

val h3 : Element_spec.t
(** The [h3] element represents a heading at level 3. *)

val h4 : Element_spec.t
(** The [h4] element represents a heading at level 4. *)

val h5 : Element_spec.t
(** The [h5] element represents a heading at level 5. *)

val h6 : Element_spec.t
(** The [h6] element represents a heading at level 6. *)

val hgroup : Element_spec.t
(** The [hgroup] element represents a heading and related content, such as
    subheadings, an alternative title, or a tagline. *)

val header : Element_spec.t
(** The [header] element represents introductory content for its nearest ancestor
    sectioning content or sectioning root element. *)

val footer : Element_spec.t
(** The [footer] element represents a footer for its nearest ancestor sectioning
    content or sectioning root element. *)

val address : Element_spec.t
(** The [address] element represents contact information for its nearest [article]
    or [body] element ancestor. *)

val main : Element_spec.t
(** The [main] element represents the dominant contents of the document. *)

(** {1 Grouping elements} *)

val p : Element_spec.t
(** The [p] element represents a paragraph. *)

val hr : Element_spec.t
(** The [hr] element represents a thematic break between paragraph-level elements. *)

val pre : Element_spec.t
(** The [pre] element represents a block of preformatted text. *)

val blockquote : Element_spec.t
(** The [blockquote] element represents a section that is quoted from another source. *)

val ol : Element_spec.t
(** The [ol] element represents a list of items, where the items have been
    intentionally ordered. *)

val ul : Element_spec.t
(** The [ul] element represents a list of items, where the order of the items
    is not important. *)

val menu : Element_spec.t
(** The [menu] element represents a toolbar consisting of its contents, in the
    form of an unordered list of items. *)

val li : Element_spec.t
(** The [li] element represents a list item. *)

val dl : Element_spec.t
(** The [dl] element represents an association list consisting of zero or more
    name-value groups (a description list). *)

val dt : Element_spec.t
(** The [dt] element represents the term, or name, part of a term-description
    group in a description list. *)

val dd : Element_spec.t
(** The [dd] element represents the description, definition, or value, part of
    a term-description group in a description list. *)

val figure : Element_spec.t
(** The [figure] element represents some flow content, optionally with a caption,
    that is self-contained and is typically referenced as a single unit from
    the main flow of the document. *)

val figcaption : Element_spec.t
(** The [figcaption] element represents a caption or legend for the rest of the
    contents of the parent [figure] element. *)

val div : Element_spec.t
(** The [div] element has no special meaning at all. It represents its children. *)

(** {1 Element registry} *)

val all : Element_spec.t list
(** [all] contains all element specifications defined in this module. *)