1"""
 2Módulo pokemon.py
 3===================
 4
 5[PT-BR] Define a estrutura de dados imutável para representar um Pokémon.
 6Utiliza ``@dataclass`` com ``frozen=True`` para garantir imutabilidade.
 7
 8[EN] Defines an immutable data structure to represent a Pokémon.
 9Uses ``@dataclass`` with ``frozen=True`` to ensure immutability.
10
11A classe oferece um método ``to_dict()`` que transforma a instância
12em um dicionário formatado para exportação em CSV ou exibição.
13
14The class provides a ``to_dict()`` method that converts the instance
15into a dictionary formatted for CSV export or display.
16
17Uso / Usage:
18    p = Pokemon(number="025", name="Pikachu", types=["Electric"], image="...", extra_attributes={})
19    d = p.to_dict()
20"""
21from dataclasses import dataclass, field
22from typing import List, Optional, Dict
23
24@dataclass(frozen=True)
25class Pokemon:
26    """
27    [PT-BR] Representa um Pokémon com atributos fixos e extras. Imutável.
28    [EN] Represents a Pokémon with fixed and extra attributes. Immutable.
29    """
30    number: str
31    name: str
32    types: List[str]
33    image: Optional[str] = None
34    extra_attributes: Dict[str, str] = field(default_factory=dict)
35
36    def to_dict(self, type_sep: str = "/") -> dict[str, str]:
37        """
38        [PT-BR] Converte o Pokémon em dicionário para exportação.
39        [EN] Converts the Pokémon into a dictionary for export.
40
41        Parâmetros:
42            type_sep (str): Separador dos tipos no campo "Tipo".
43
44        Retorna:
45            dict[str, str]: Dicionário formatado.
46        """
47        data: dict[str, str] = {
48            "Nº": self.number,
49            "Nome": self.name,
50            "Tipo": type_sep.join(self.types),
51            "Imagem": self.image or ""
52        }
53        data.update(self.extra_attributes)
54        return data
55
56    def __str__(self) -> str:
57        """
58        [PT-BR] Representação legível do objeto.
59        [EN] Human-readable object representation.
60        """
61        tipo = "/".join(self.types)
62        return f"Pokemon[{self.number}] {self.name} ({tipo})"