Dla AI

Draft

Ta strona jest lustrem design/AGENTS.md (korzeń pakietu /design) — w razie rozjazdu wygrywa plik w repo, nie ta strona. Trzymamy oba w synchronizacji ręcznie do czasu handbook:validate (poza zakresem /design).

Jedyny interfejs to warstwa semantyczna

Konsumuj WYŁĄCZNIE zmienne CSS z tokens/dist/css/tokens.css / tokens/dist/theme.css: --color-*, --spacing-*, --radius-*, --font-*, --shadow-*, --focus-ring. Nigdy nie odwołuj się do warstwy core (np. --color-gray-500) — to wewnętrzny plumbing pipeline’u, nie publiczny kontrakt.

Pełna lista tokenów + wartość w każdej z 10 kombinacji marka×tryb: tokens/dist/tokens.json (płaskie, maszynowe — czytaj to, nie zgaduj nazw). Ta sama mapa jest publikowana pod /tokens.json na tej stronie.

Theming przez atrybuty na <html>: data-brand (insurance/home/health/moto/ travel) × data-theme (light/dark). Brak atrybutów = insurance + light.

Zakazy (MUST NOT)

Zero hardcoded wartości — żadnych literałów hex, rgb(), pikseli spacingu, nazw fontów spoza font.family.*, w komponentach ani na stronach. Egzekwowane mechanicznie przez validators/static/no-hardcoded.mjs.
Nie twórz nowych stylów ilustracji ani nie generuj grafik marki bez wyraźnej decyzji Human.
Nie odmieniaj „Polisoteka®” — nazwa jest nieodmienna, zawsze z ®, w każdej treści (dokumentacja, komunikaty błędów w komponentach, przykłady).
Nie edytuj ręcznie tokens/dist/ ani ui/ z poziomu pracy nad docs/ — to artefakty innych pakietów; braki zgłoś w raporcie zamiast poprawiać na skróty.
Każdy element interaktywny: cursor: pointer + widoczny :focus-visible (token focus.ring) — bez wyjątków.

Status artefaktów

Frontmatter/pola status: draft → stable → deprecated. Nie podnoś statusu strony ani komponentu bez podstawy (realna treść, przegląd a11y) — status: stable to obietnica dla czytelnika, nie deklaracja intencji.

Mapa artefaktów maszynowych

Plik	Format	Do czego
`tokens/dist/tokens.json`	JSON płaski	Nazwa tokenu → `{value, type, path, cssVar, values}` (10 kombinacji)
`tokens/dist/css/tokens.css`	CSS custom properties	Runtime
`tokens/dist/theme.css`	Tailwind v4 `@theme`	Klasy narzędziowe
`ui/src/components//.docs.json`	JSON	Propsy 1:1 z interfejsem TS — źródło `PropsTable`

Komendy walidacji (uruchom przed każdą zmianą w danym pakiecie)

Zakres	Komenda
`tokens/`	`pnpm -F tokens build && pnpm -F tokens check`
`ui/`	`pnpm -F ui test && pnpm -F ui typecheck`
`docs/`	`pnpm -F docs build`
całość	`bash run.sh` (+ `AUDIT=1 bash run.sh` przed release)