css: consolidate core stylesheet entrypoint and add contract check

This commit is contained in:
2026-04-20 19:55:49 +02:00
parent da0abc824a
commit 5982e749d7
7 changed files with 163 additions and 35 deletions

View File

@@ -1,6 +1,6 @@
# Frontend CSS
Letzte Aktualisierung: 2026-03-19
Letzte Aktualisierung: 2026-04-20
## Ziel
@@ -8,8 +8,10 @@ Diese Seite beschreibt die kompakte Standardstruktur für CSS in diesem Projekt:
## Struktur
- `/web/css/core.css`
- zentraler Core-Entrypoint für die Default-Admin-Oberfläche.
- `/web/css/app-layers.css`
- zentraler Entrypoint für Layer-Reihenfolge.
- zentrale Layer-Reihenfolge + Vendor-Basis.
- `/web/css/base`
- Variablen, Reset, Typografie, globale Tokens.
- `/web/css/layout`
@@ -50,6 +52,11 @@ Kurzregel:
Asset-Gruppen werden in `/config/assets.php` registriert.
Seiten laden bei Bedarf Gruppen über `Buffer::set('style_groups', ...)`.
Default-Template:
- `base` lädt Layer-/Token-Basis.
- `core` lädt den konsolidierten Core-Stack über `/web/css/core.css`.
Beispiel (Action):
```php
@@ -76,6 +83,7 @@ Regel: Vendor-Overrides nur für Bibliotheks-Selektoren; projektspezifische UI-S
3. Wird die Gruppe auf der Zielseite wirklich geladen (`style_groups`)?
4. Gibt es ungewollte Seiteneffekte auf anderen Seiten?
5. Sind bestehende Variablen/Konventionen eingehalten?
6. Contract-Check lokal ausführen: `bin/css-contract-check.sh`
## Module-CSS Token-Regel