//! Content sectioning elements allow you to organize the document content into
//! logical pieces. Use the sectioning elements to create a broad outline for
//! your page content, including header and footer navigation, and heading
//! elements to identify sections of content.

html_element! {
    /// The [HTML `<address>` element][mdn] indicates that the enclosed HTML provides contact
    /// information for a person or people, or for an organization.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/address
    <address>

    categories {
        Flow, Palpable
    }

    children {
        categories {
            Flow // no nested address, no headings, no sectioning, no header/footer elems
        }
    }
}

html_element! {
    /// The [HTML `<article>` element][mdn] represents a self-contained composition in a document,
    /// page, application, or site, which is intended to be independently distributable or reusable
    /// (e.g., in syndication).
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/article
    <article>

    categories {
        Flow, Sectioning, Palpable
    }

    children {
        categories {
            Flow
        }
    }
}

html_element! {
    /// The [HTML `<aside>` element][mdn] represents a portion of a document whose content is only
    /// indirectly related to the document's main content.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/aside
    <aside>

    categories {
        Flow, Sectioning, Palpable
    }

    children {
        categories {
            Flow
        }
    }
}

html_element! {
    /// The [HTML `<footer>` element][mdn] represents a footer for its nearest [sectioning content]
    /// or [sectioning root] element. A footer typically contains information about the author of
    /// the section, copyright data or links to related documents.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/footer
    /// [sectioning content]: https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Content_categories#Sectioning_content
    /// [sectioning root]: https://developer.mozilla.org/en-US/docs/Web/Guide/HTML/Sections_and_Outlines_of_an_HTML5_document#Sectioning_roots
    <footer>

    categories {
        Flow, Palpable
    }

    children {
        categories {
            Flow // no footer or header descendants
        }
    }
}

html_element! {
    /// The [HTML `<header>` element][mdn] represents introductory content, typically a group of
    /// introductory or navigational aids. It may contain some heading elements but also a logo, a
    /// search form, an author name, and other elements.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/header
    <header>

    categories {
        Flow, Palpable
    }

    children {
        categories {
            Flow // no footer or header descendants
        }
    }
}

html_element! {
    /// The [HTML `<h1>`–`<h6>` elements][mdn] represent six levels of section headings. `<h1>` is
    /// the highest section level and `<h6>` is the lowest.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/h1
    <h1>

    categories {
        Flow, Heading, Palpable
    }

    children {
        categories {
            Phrasing
        }
    }
}

html_element! {
    /// The [HTML `<h1>`–`<h6>` elements][mdn] represent six levels of section headings. `<h1>` is
    /// the highest section level and `<h6>` is the lowest.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/h2
    <h2>

    categories {
        Flow, Heading, Palpable
    }

    children {
        categories {
            Phrasing
        }
    }
}

html_element! {
    /// The [HTML `<h1>`–`<h6>` elements][mdn] represent six levels of section headings. `<h1>` is
    /// the highest section level and `<h6>` is the lowest.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/h3
    <h3>

    categories {
        Flow, Heading, Palpable
    }

    children {
        categories {
            Phrasing
        }
    }
}

html_element! {
    /// The [HTML `<h1>`–`<h6>` elements][mdn] represent six levels of section headings. `<h1>` is
    /// the highest section level and `<h6>` is the lowest.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/h4
    <h4>

    categories {
        Flow, Heading, Palpable
    }

    children {
        categories {
            Phrasing
        }
    }
}

html_element! {
    /// The [HTML `<h1>`–`<h6>` elements][mdn] represent six levels of section headings. `<h1>` is
    /// the highest section level and `<h6>` is the lowest.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/h5
    <h5>

    categories {
        Flow, Heading, Palpable
    }

    children {
        categories {
            Phrasing
        }
    }
}

html_element! {
    /// The [HTML `<h1>`–`<h6>` elements][mdn] represent six levels of section headings. `<h1>` is
    /// the highest section level and `<h6>` is the lowest.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/h6
    <h6>

    categories {
        Flow, Heading, Palpable
    }

    children {
        categories {
            Phrasing
        }
    }
}

html_element! {
    /// The [HTML `<hgroup>` element][mdn] represents a multi-level heading for a section of a
    /// document. It groups a set of [`<h1>–<h6>`][heading] elements.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/hgroup
    /// [heading]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/Heading_Elements
    <hgroup>

    categories {
        Flow, Heading, Palpable
    }

    children {
        tags {
            <h1>, <h2>, <h3>, <h4>, <h5>, <h6>
        }
    }
}

html_element! {
    /// The [HTML `<main>` element][mdn] represents the dominant content of the [`<body>`][body] of
    /// a document. The main content area consists of content that is directly related to or expands
    /// upon the central topic of a document, or the central functionality of an application.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/main
    /// [body]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/body
    <main>

    categories {
        Flow, Palpable
    }

    children {
        categories {
            Flow
        }
    }
}

html_element! {
    /// The [HTML `<nav>` element][mdn] represents a section of a page whose purpose is to provide
    /// navigation links, either within the current document or to other documents. Common examples
    /// of navigation sections are menus, tables of contents, and indexes.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/nav
    <nav>

    categories {
        Flow, Sectioning, Palpable
    }

    children {
        categories {
            Flow
        }
    }
}

html_element! {
    /// The [HTML `<section>` element][mdn] represents a standalone section — which doesn't have a
    /// more specific semantic element to represent it — contained within an HTML document.
    ///
    /// [mdn]: https://developer.mozilla.org/en-US/docs/Web/HTML/Element/section
    <section>

    categories {
        Flow, Sectioning, Palpable
    }

    children {
        categories {
            Flow
        }
    }
}