"""Sicheres Markdown-Rendering für Prompt-Inhalte.

Nutzer geben rohes Markdown ein (**fett**, Listen, Codeblöcke ...), das in
der Karten-Vorschau als HTML dargestellt werden soll. Zwei Schutzschichten
gegen Stored-XSS:

1. Der Eingabetext wird vor der Konvertierung HTML-escaped. Echte
   Markdown-Syntax verwendet nur ASCII-Satzzeichen (*, #, -, `, [] ...),
   keine spitzen Klammern – jeder Versuch, rohes HTML/<script>
   einzuschleusen, landet dadurch als reiner Text statt als Markup.
2. Das von Markdown selbst erzeugte HTML (insbesondere <a href="...">
   aus [text](url)-Links) wird zusätzlich mit bleach bereinigt, da ein
   Link mit z.B. "javascript:"-Schema sonst trotz Schritt 1 möglich wäre.
"""

import bleach
import markdown as _markdown

_converter = _markdown.Markdown(
    extensions=["extra", "sane_lists", "nl2br"], output_format="html"
)


def _escape_tags(text: str) -> str:
    """Nur '&' und '<' escapen (nicht '>' – das braucht Markdown für Zitate).

    Eine HTML-Tag-Injection benötigt immer '<...>'; wird bereits '<' zu
    '&lt;', kann kein Tag mehr entstehen, unabhängig davon, ob ein
    einzelnes '>' im Text steht.
    """
    return text.replace("&", "&amp;").replace("<", "&lt;")

_ALLOWED_TAGS = [
    "p", "br", "hr", "strong", "em", "del", "code", "pre",
    "ul", "ol", "li", "blockquote",
    "h1", "h2", "h3", "h4", "h5", "h6",
    "a", "table", "thead", "tbody", "tr", "th", "td",
]
_ALLOWED_ATTRS = {"a": ["href", "title"]}
_ALLOWED_PROTOCOLS = ["http", "https", "mailto"]


def render(text: str) -> str:
    _converter.reset()
    escaped = _escape_tags(text or "")
    raw_html = _converter.convert(escaped)
    return bleach.clean(
        raw_html,
        tags=_ALLOWED_TAGS,
        attributes=_ALLOWED_ATTRS,
        protocols=_ALLOWED_PROTOCOLS,
        strip=True,
    )