from typing import Any, Dict, Optional

from draftjs_exporter.types import HTML, Element, Tag

Attr = Dict[str, str]


class DOMEngine:
    """
    Parent class of all DOM implementations.
    """

    @staticmethod
    def create_tag(type_: Tag, attr: Optional[Attr] = None) -> Any:
        """
        Creates and returns a tree node of the given type and attributes.
        """
        raise NotImplementedError

    @staticmethod
    def parse_html(markup: HTML) -> Element:
        """
        Creates nodes based on the input html.
        Note: this method is used in component implementations only, and
        is not required for the exporter to operate.
        """
        raise NotImplementedError

    @staticmethod
    def append_child(elt: Element, child: Element) -> Any:
        """
        Appends the given child node in the children of elt.
        """
        raise NotImplementedError

    @staticmethod
    def render(elt: Element) -> HTML:
        """
        Renders a given element to HTML.
        """
        raise NotImplementedError

    @staticmethod
    def render_debug(elt: Element) -> HTML:
        """
        Renders a given element to HTML.
        Note: this method is only used for draftjs_exporter's tests, and
        is not required for the exporter to operate.
        """
        raise NotImplementedError