# Vendoo 1.35.0 – Design-System- und Theme-Vertrag

## Quelle der Wahrheit

Die editierbare Tokenquelle liegt unter:

`public/design-system/tokens/source.json`

Aus ihr erzeugt `tools/generate-design-tokens.mjs` deterministisch:

- `public/design-system/tokens.css`
- `public/design-system/theme-contract.json`

Direkte Änderungen an `tokens.css` sind nicht zulässig.

## Ebenen

- Primitive/semantische Farb-, Radius-, Schatten-, Dichte-, Layout- und Bewegungswerte
- CSS-Variablen mit Präfix `--vd-*`
- Kompatibilitätsbrücke für bestehende Variablen wie `--bg`, `--accent` und `--radius`

## Themes

1. `light`
2. `dark`
3. `contrast`
4. Browserpräferenz `system` über die Theme Runtime

## Sicherheit

Der zukünftige Theme Manager darf ausschließlich Tokens mit `customizable: true` verändern. Freies CSS, HTML, URLs, JavaScript, Schattenausdrücke und beliebige Variablennamen sind nicht erlaubt. Farben und Dimensionen werden typ- und bereichsgeprüft. Ein Theme wird nie ungeprüft als Stylesheet gespeichert.

## Nächster Ausbau

- persistente Themes pro Benutzer und systemweit
- Live-Vorschau in isoliertem Vorschaucontainer
- automatische Kontrastprüfung
- Import/Export eines versionierten Theme-JSON
- Versionsverlauf und Zurücksetzen
