"""List name translation helpers."""

from __future__ import annotations

# Mapping of Family Wall system list identifiers to German display names.
# Extend as new system names are discovered.
SYSTEM_NAMES: dict[str, str] = {
    "SYS-CAT-SHOPPINGLIST": "Einkaufsliste",
    "SYS-CAT-TODOS": "Aufgaben",
}


def translate_name(name: str) -> str:
    """Translate system list names to German display names.

    Unknown names are returned unchanged.

    Args:
        name: Raw list name from the Family Wall API.

    Returns:
        Human-readable German name, or the original name if no mapping exists.
    """
    return SYSTEM_NAMES.get(name, name)