# hud/avatars — portraits de l'avatar (servis par le HUD)

Le HUD affiche le portrait du personnage et change d'image selon l'état :

| État HUD | Image attendue |
|---|---|
| `idle` / `listening` | `<set>-idle.png` |
| `thinking` | `<set>-think.png` |
| `speaking` | `<set>-speak.png` |

`<set>` est le jeu choisi dans **Réglages → Avatar** (`asa`, `mira`, `kai`…),
mémorisé côté navigateur (localStorage). Exemple pour le jeu `asa` :

```
avatars/
├── asa-idle.png
├── asa-think.png
└── asa-speak.png
```

## Format conseillé

- **Carré**, ~512×512 px (affiché en disque, recadrage `object-fit: cover`).
- PNG (transparence acceptée). Le HUD applique le masque circulaire lui-même.

## Repli sans image

Si une image manque (404), le HUD **dégrade proprement** : il affiche l'initiale
du personnage (« あ ») dans la couleur d'accent — aucune erreur, le HUD reste
pleinement fonctionnel. Dépose simplement tes portraits ici pour les activer
(pas de redémarrage : recharge la page).

> Ces fichiers sont livrés **dans le package** (`pyproject.toml` → package-data
> `hud/**/*`), donc inclus par `pipx install`. Garde-les légers.
