"""Pure defensive/goalkeeping micro-mechanics vocabulary for Match Engine v3.6.

This module intentionally contains no Django imports.  The causal match engine
emits these event types into the authoritative analytics ledger and the ORM
projection stores the same vocabulary verbatim.
"""

DEFENSIVE_EVENT_TYPES = (
    "INTERCEPTION",
    "TACKLE",
    "GROUND_DUEL",
    "AERIAL_DUEL",
    "CLEARANCE",
    "BLOCK",
    "DEFENSIVE_ERROR",
    "KEEPER_CLAIM",
    "KEEPER_PUNCH",
    "KEEPER_SAVE",
    "KEEPER_PARRY",
    "ONE_ON_ONE_SAVE",
    "SWEEPER_ACTION",
    "SWEEPER_CLEARANCE",
    "SWEEPER_MISJUDGEMENT",
)

GOALKEEPER_ACTION_TYPES = (
    "CATCH",
    "CLAIM",
    "PUNCH",
    "REFLEX_SAVE",
    "DIVING_SAVE",
    "PARRY",
    "TIP_OVER",
    "ONE_ON_ONE_SAVE",
    "SWEEPER_CLEARANCE",
    "SWEEPER_MISJUDGEMENT",
)

DUEL_OUTCOMES = (
    "WON",
    "LOST",
    "FOUL",
    "HELD",
    "PARRIED_SAFE",
    "PARRIED_DANGER",
    "PUNCHED_CLEAR",
    "PUNCHED_CONTESTED",
    "MISJUDGED",
)


def validate_defensive_event_type(value: str) -> str:
    value = str(value or "").strip().upper()
    if value not in DEFENSIVE_EVENT_TYPES:
        raise ValueError(f"Unsupported defensive event type: {value!r}")
    return value
