"""Video title normalization — clean the noisy YouTube titles for display + storage.

Applied where a video's title is written (enrichment) and where a download's title comes from
yt-dlp, so the feed, search, channel pages, and the download center all show tidy titles. The
raw title is preserved in `Video.original_title` so this is reversible / re-derivable.

Rules (user-approved "option b"):
  1. Drop emoji / pictographs / symbols / control chars (keep accents — HU/DE/…).
  2. Strip trailing SEO hashtag clusters (word hashtags at the end); a numeric "#3" episode
     marker survives.
  3. De-shout ALL-CAPS words, context-aware:
       - If the title is *mostly shouting* (≥ half the multi-letter words are all-caps), every
         all-caps word is Title-cased (short shouted words like CAR/WAR/ÉN get fixed too), and
         the first letter is capitalized. Known acronyms (PS, AI, USA, PC…) and words with
         digits (PS5, 3D) are kept; function words (to/the/és/az…) are lowercased.
       - Otherwise only long all-caps words (≥4 letters) are Title-cased, so a lone acronym in
         an otherwise normal title is left alone.
  4. Collapse repeated punctuation (!!! → !) and whitespace.
"""
import re
import unicodedata

_DROP_CATEGORIES = {"So", "Sk", "Cc", "Cf", "Cs", "Co", "Cn"}
_LETTER_RUN = re.compile(r"[^\W\d_]+", re.UNICODE)
_TRAILING_HASHTAGS = re.compile(r"(?:\s+#[^\s#]*[^\W\d\s_][^\s#]*)+\s*$", re.UNICODE)
_REPEAT_PUNCT = re.compile(r"([!?.,\-])\1{1,}")

# Short function words → lowercased when the title is de-shouted (proper title-case style).
_SHORT_LOWER = {
    "to", "the", "and", "of", "a", "an", "in", "on", "at", "for", "or", "vs", "the",
    "és", "az", "egy", "meg", "nem", "hogy", "de", "ha", "der", "die", "das", "und", "von",
}
# Kept as-is even when everything else is de-shouted (common acronyms; compared lowercased).
_ACRONYMS = {
    "ps", "ai", "pc", "tv", "hd", "4k", "8k", "uk", "eu", "us", "usa", "gta", "rpg", "fps",
    "diy", "vr", "ar", "id", "ok", "faq", "nasa", "fbi", "cia", "ceo", "amd", "pdf", "usb",
    "gps", "api", "dj", "mc", "suv", "gpu", "cpu", "ssd", "hdmi", "led", "ufo", "dna", "nba",
    "nfl", "asmr", "pov", "diy", "wtf", "lol", "rtx", "gtx", "ios", "mmo", "vip", "hp",
}


def _titlecase(w: str) -> str:
    return w[0].upper() + w[1:].lower()


def normalize_title(raw: str | None) -> str | None:
    """Return the cleaned title, or the input unchanged for empty/whitespace."""
    if not raw or not raw.strip():
        return raw
    t = unicodedata.normalize("NFKC", raw)
    t = "".join(ch for ch in t if unicodedata.category(ch) not in _DROP_CATEGORIES)
    t = _TRAILING_HASHTAGS.sub("", t)

    multi = [r for r in _LETTER_RUN.findall(t) if len(r) >= 2]
    caps = [r for r in multi if r.isupper()]
    shouting = len(caps) >= 2 and len(caps) >= 0.5 * len(multi)

    def repl(m: re.Match) -> str:
        w = m.group(0)
        if len(w) < 2 or not w.isupper():
            return w
        low = w.lower()
        if low in _ACRONYMS:
            return w
        if low in _SHORT_LOWER:
            return low
        if shouting or len(w) >= 4:
            return _titlecase(w)
        return w  # short all-caps in a non-shouting title → likely an acronym, keep

    t = _LETTER_RUN.sub(repl, t)
    t = _REPEAT_PUNCT.sub(r"\1", t)
    t = re.sub(r"\s+", " ", t).strip()

    if shouting:  # ensure the first letter is capitalized (a leading function word got lowered)
        for i, ch in enumerate(t):
            if ch.isalpha():
                t = t[:i] + ch.upper() + t[i + 1:]
                break
    return t or raw