Files
laraundfelix/app/Domain/Design/DesignScale.php
StommerandClaude Sonnet 5.5 67614158e4 Führe eine konfigurierbare Größenskala für Website und Vorschau ein
Zehn Basiswerte (Fließtext, Überschriften, Abstände, Kopfzeile, Inhaltsbreite, Bildhöhe) leiten in tokens.css alle Größen ab. Einstieg, Bild und Text, Premium-Karten, Karten, Kopf, Fuß und Schaltflächen verwenden nur noch diese Tokens. Die Werte sind unter Website, Design, Größen einstellbar und wirken ohne Deployment über ein Inline-Stylesheet in Website, Mitgliederbereich-Layout und CMS-Vorschau. Lesen fällt bei fehlender Tabelle oder beschädigten Daten auf die Standardwerte zurück. Die Migration ist rein ergänzend.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-11-22 14:54:14 +01:00

165 lines
8.3 KiB
PHP

<?php
namespace App\Domain\Design;
use Illuminate\Support\Facades\Validator;
/**
* Basiswerte der Größenskala des gemeinsamen Designsystems (ADR-44). Es sind bewusst nur zehn Werte; alles Weitere
* (Überschrift 3, Einleitung, kleine Schrift, Abschnitts- und Widget-Abstände, Kopfzeile kompakt, Mindesthöhen der
* Varianten …) leitet resources/css/tokens.css daraus ab. Die Ableitungsregeln stehen nur dort.
*
* Die Werte sind Pixel als ganze Zahl. Im Stylesheet werden sie in rem umgerechnet, damit die Textgröße des Browsers
* wirkt. Die Standardwerte stehen ebenfalls in tokens.css (Block „Basiswerte“); ein Test hält beide gleich.
* Trefferflächen (44 px) und die Untergrenze der Schrift auf Smartphones (16 px) sind nicht einstellbar.
*/
final class DesignScale
{
/**
* @var array<string, array{label: string, default: int, min: int, max: int, unit: string, group: string, hint: string, effect: string}>
*/
public const PARAMETERS = [
'body' => ['label' => 'Fließtext', 'default' => 17, 'min' => 16, 'max' => 20, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Schriftgröße auf Desktop; auf kleinen Bildschirmen etwa 1 px weniger, nie unter 16 px.',
'effect' => 'Auch Einleitung, Überschrift 3, kleine Schrift und Schaltflächen folgen daraus.'],
'h1' => ['label' => 'Überschrift 1', 'default' => 40, 'min' => 30, 'max' => 56, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Seitentitel auf Desktop; schrumpft auf Smartphones auf etwa 70 %.',
'effect' => 'Muss mindestens 4 px größer sein als Überschrift 2.'],
'h2' => ['label' => 'Überschrift 2', 'default' => 28, 'min' => 22, 'max' => 40, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Abschnittstitel auf Desktop; auch Titel in Bild und Text, Handlungsaufruf und breiten Karten.',
'effect' => 'Muss mindestens 6 px größer sein als der Fließtext. Überschrift 3 bleibt darunter.'],
'display' => ['label' => 'Display-Überschrift (Höchstwert)', 'default' => 52, 'min' => 36, 'max' => 80, 'unit' => 'px', 'group' => 'Schrift',
'hint' => 'Größter Titel (Einstieg). Wächst mit der Breite des Platzes bis zu diesem Wert.',
'effect' => 'Mindestens so groß wie Überschrift 1.'],
'space' => ['label' => 'Basisabstand', 'default' => 8, 'min' => 6, 'max' => 12, 'unit' => 'px', 'group' => 'Abstände',
'hint' => 'Grundmaß des Abstandsrasters (halber, einfacher, anderthalbfacher bis zwölffacher Wert).',
'effect' => 'Alle Abstandsstufen der Komponenten und die Abstände zwischen Plätzen im Raster.'],
'section' => ['label' => 'Abschnittsabstand (Desktop)', 'default' => 48, 'min' => 24, 'max' => 96, 'unit' => 'px', 'group' => 'Abstände',
'hint' => 'Stufe „Normal“ auf Desktop. „Kompakt“ ist zwei Drittel davon, „Großzügig“ das Anderthalbfache.',
'effect' => 'Auf Smartphones werden alle Stufen kleiner.'],
'card_pad' => ['label' => 'Karten-Innenabstand', 'default' => 20, 'min' => 12, 'max' => 32, 'unit' => 'px', 'group' => 'Abstände',
'hint' => 'Innenabstand von Karten auf Desktop.',
'effect' => 'Große Flächen (Einstieg, Bild und Text, Handlungsaufruf) verwenden das Ein- bis Zweifache.'],
'header' => ['label' => 'Höhe der Kopfzeile', 'default' => 80, 'min' => 56, 'max' => 112, 'unit' => 'px', 'group' => 'Rahmen',
'hint' => 'Kopfzeile im Ausgangszustand auf Desktop. Beim Scrollen und auf Smartphones gilt 80 % davon.',
'effect' => 'Die Anzeigegröße der Wortmarke folgt daraus; die Wortmarke selbst bleibt unverändert.'],
'width' => ['label' => 'Maximale Inhaltsbreite', 'default' => 1312, 'min' => 960, 'max' => 1600, 'unit' => 'px', 'group' => 'Rahmen',
'hint' => 'Breite des Standardrasters; Kopfzeile, Inhalt und Fußbereich fluchten hier. „Breit“ ist etwa 17 % mehr.',
'effect' => 'Der Lesebereich (44 rem) ist davon unabhängig.'],
'media' => ['label' => 'Bildhöhe in Bild und Text (Desktop)', 'default' => 320, 'min' => 200, 'max' => 480, 'unit' => 'px', 'group' => 'Medien',
'hint' => 'Höhe des Bildes neben dem Text in der Variante „Standard“. Kompakt: 75 %, Großzügig: 130 %.',
'effect' => 'Bestimmt zugleich die Mindesthöhe des Einstiegs (das 1,2-Fache; kompakt und großzügig wie bei Bild und Text).'],
];
/** Gruppen in fester Reihenfolge. */
public const GROUPS = ['Schrift', 'Abstände', 'Rahmen', 'Medien'];
/**
* @return array<string, int>
*/
public static function defaults(): array
{
return array_map(static fn (array $p): int => $p['default'], self::PARAMETERS);
}
/** Name der CSS-Variable, zum Beispiel card_pad → --ds-card-pad. */
public static function variable(string $key): string
{
return '--ds-'.str_replace('_', '-', $key);
}
/**
* Prüft vollständige Eingaben (Zeichenketten aus dem Formular oder Zahlen). Gibt Fehlermeldungen je Schlüssel zurück;
* leer, wenn alles zulässig ist.
*
* @param array<string, mixed> $input
* @return array<string, string>
*/
public static function errors(array $input): array
{
$rules = [];
$messages = [];
$names = [];
foreach (self::PARAMETERS as $key => $p) {
$rules[$key] = ['required', 'integer', 'min:'.$p['min'], 'max:'.$p['max']];
$names[$key] = $p['label'];
$messages["$key.required"] = $p['label'].': Bitte einen Wert eintragen.';
$messages["$key.integer"] = $p['label'].': Bitte eine ganze Zahl in Pixeln eintragen.';
$messages["$key.min"] = $p['label'].': Der Wert muss mindestens '.$p['min'].' px betragen.';
$messages["$key.max"] = $p['label'].': Der Wert darf höchstens '.$p['max'].' px betragen.';
}
$validator = Validator::make(array_intersect_key($input, self::PARAMETERS), $rules, $messages, $names);
$errors = [];
foreach ($validator->errors()->messages() as $key => $list) {
$errors[$key] = $list[0];
}
if ($errors !== []) {
return $errors;
}
$v = array_map('intval', array_intersect_key($input, self::PARAMETERS));
if ($v['h2'] < $v['body'] + 6) {
$errors['h2'] = 'Überschrift 2 muss mindestens 6 px größer sein als der Fließtext ('.($v['body'] + 6).' px).';
}
if ($v['h1'] < $v['h2'] + 4) {
$errors['h1'] = 'Überschrift 1 muss mindestens 4 px größer sein als Überschrift 2 ('.($v['h2'] + 4).' px).';
}
if ($v['display'] < $v['h1']) {
$errors['display'] = 'Die Display-Überschrift darf nicht kleiner sein als Überschrift 1 ('.$v['h1'].' px).';
}
return $errors;
}
/**
* Gespeicherte Werte lesen: nur bekannte Schlüssel, ganze Zahlen im zulässigen Bereich und stimmige Reihenfolge.
* Alles andere (fehlende Schlüssel, Fremdes, beschädigte Daten) ergibt die Standardwerte, nie einen Fehler.
*
* @return array<string, int>
*/
public static function read(mixed $stored): array
{
if (! is_array($stored)) {
return self::defaults();
}
$merged = self::defaults();
foreach (array_keys(self::PARAMETERS) as $key) {
if (array_key_exists($key, $stored) && (is_int($stored[$key]) || (is_string($stored[$key]) && ctype_digit($stored[$key])))) {
$merged[$key] = (int) $stored[$key];
}
}
return self::errors($merged) === [] ? $merged : self::defaults();
}
/**
* Inline-Stylesheet mit den abweichenden Basiswerten. Ausgegeben werden ausschließlich geprüfte ganze Zahlen zu
* bekannten Schlüsseln. Ohne Abweichung leer: dann gelten die Standardwerte aus tokens.css.
*
* @param array<string, int> $values
*/
public static function css(array $values): string
{
$declarations = '';
foreach (self::PARAMETERS as $key => $p) {
$value = $values[$key] ?? $p['default'];
if ($value !== $p['default'] && $value >= $p['min'] && $value <= $p['max']) {
$declarations .= sprintf('%s:%d;', self::variable($key), $value);
}
}
return $declarations === '' ? '' : ':root{'.$declarations.'}';
}
}