feat: add full supported API details for variants and enhance tests

README.md

@@ -238,11 +238,15 @@ curl -OJ "http://127.0.0.1:8000/compat?format=md"      # → compat.md
 curl -OJ "http://127.0.0.1:8000/compat?format=json"    # → compat.json (grupy + warianty + diffy)
 ```
 
-W UI: przyciski **⬇ md** / **⬇ json** w panelu *Gry / wersje*. Markdown to macierz `biblioteka × gra`
-(`✓` = obecna; `A`/`B*`/… gdy nazwa ma kilka wariantów powierzchni) plus sekcja *Warianty*: dla
-każdego rozbieżnego wariantu overlap %, zbiorcze `types/methods/events/fields +N/-N/~N`, a pod tym
-**nazwany rozkład per klasa** — które metody/eventy/pola doszły (`+`), zniknęły (`−`) lub zmieniły
-się (`~`), np. `CMC_Animo: −PAUSE  ~FPS (type int→float)`. Pełne listy (bez cap-a) są w `vs_reference.detail` JSON-a.
+**JSON niesie pełny baseline.** Każdy wariant ma `api` = *co jest obsługiwane*: lista typów oraz
+`classes` (per klasa jej `methods`/`events`/`fields` z nazwami, id, typami). To punkt odniesienia,
+względem którego czyta się diff — masz i „co było", i „co się zmieniło". Diff rozbieżnego wariantu
+siedzi w `vs_reference` (overlap %, zbiorcze liczby + `detail` z nazwanym rozkładem per klasa, bez cap-a).
+
+W UI: przyciski **⬇ md** / **⬇ json** w panelu *Gry / wersje*. Markdown to tylko **podgląd**:
+macierz `biblioteka × gra` (`✓` = obecna; `A`/`B*`/… gdy nazwa ma kilka wariantów) plus sekcja
+*Warianty* — dla każdego wariantu liczba i nazwy klas, a dla rozbieżnych skrócony rozkład zmian
+(`CMC_Animo: −PAUSE  ~FPS (type int→float)`). Pełne listy metod bierz z JSON-a (`api` / `vs_reference.detail`).
 
 ## Front — Command Center