"""Deutsche Ordinalzahlen 1.–31. (für Datums- und Aufzählungs-Aussprache).

Bewusst eine kleine handgepflegte Tabelle statt `num2words`: die deutsche
Ordinal-Flexion ist mit num2words nicht sauber abbildbar, und der Bereich 1–31
deckt Datumsangaben und Listenpositionen vollständig ab.
"""

from __future__ import annotations

# Stamm der Ordinalzahl (ohne Endung). attributiv = Stamm + "er" ("erster"),
# adverbial = Stamm + "ens" ("erstens").
_STEMS: dict[int, str] = {
    1: "erst", 2: "zweit", 3: "dritt", 4: "viert", 5: "fünft",
    6: "sechst", 7: "siebt", 8: "acht", 9: "neunt", 10: "zehnt",
    11: "elft", 12: "zwölft", 13: "dreizehnt", 14: "vierzehnt", 15: "fünfzehnt",
    16: "sechzehnt", 17: "siebzehnt", 18: "achtzehnt", 19: "neunzehnt", 20: "zwanzigst",
    21: "einundzwanzigst", 22: "zweiundzwanzigst", 23: "dreiundzwanzigst",
    24: "vierundzwanzigst", 25: "fünfundzwanzigst", 26: "sechsundzwanzigst",
    27: "siebenundzwanzigst", 28: "achtundzwanzigst", 29: "neunundzwanzigst",
    30: "dreißigst", 31: "einunddreißigst",
}

MIN, MAX = 1, 31


def has_ordinal(n: int) -> bool:
    return n in _STEMS


def ordinal_attributive(n: int) -> str:
    """'1' -> 'erster' (z. B. 'erster Mai')."""
    return _STEMS[n] + "er"


def ordinal_adverbial(n: int) -> str:
    """'1' -> 'erstens' (Aufzählungen)."""
    return _STEMS[n] + "ens"