docs: describe weather visual states

README.md

@@ -74,6 +74,37 @@ Pole `suma_opadu` z endpointu synoptycznego jest prezentowane jako akumulowana s
 
 Czas aktualizacji parametrów hydrologicznych może się różnić. Interfejs pokazuje czas pomiaru, aby starsze odczyty nie wyglądały na bieżące.
 
+## Stany pogody i efekty wizualne
+
+Prognoza godzinowa i dzienna rozpoznaje następujące stany warunków pogodowych:
+
+| Stan | Opis w interfejsie |
+| --- | --- |
+| `clear` | Bezchmurnie |
+| `partlyCloudy` | Częściowe zachmurzenie |
+| `cloudy` | Pochmurno |
+| `fog` | Mgła |
+| `drizzle` | Mżawka |
+| `rain` | Opady deszczu |
+| `snow` | Opady śniegu |
+| `thunderstorm` | Burza |
+| `unknown` | Brak opisu |
+
+Bieżąca analiza IMGW Hybrid rozpoznaje bezpośrednio opad deszczu, śnieg i burzę. Gdy żadne z tych zjawisk nie występuje, hero może pokazać pomocniczy opis: `Silny wiatr`, `Wilgotne warunki` albo `Spokojne warunki`.
+
+Gradient hero i część animacji korzystają z uproszczonego nastroju wizualnego:
+
+| Mood | Obecna reguła |
+| --- | --- |
+| `night` | godzina przed `06:00` lub od `21:00` |
+| `wind` | wiatr od `8 m/s` |
+| `cold` | temperatura do `3°C` |
+| `cloudy` | wilgotność od `80%` |
+| `warm` | temperatura od `20°C` |
+| `mild` | pozostałe przypadki |
+
+Warstwa efektów wizualnych dodaje miękkie chmury dla `cloudy`, poświatę dla `warm`, gwiazdy nocą, smugi przy silnym wietrze, krople przy lokalnym opadzie, błyski przy burzy oraz chłodną poświatę dla `cold`. Mood hero jest obecnie heurystyką opartą o porę dnia, temperaturę, wilgotność i wiatr. Nie jest jeszcze pełną klasyfikacją sterowaną kodem warunków IMGW Hybrid.
+
 ## Struktura projektu
 
 ```text