Files
audi-app/design-system
tobias 1a6c8d4740 Audi Type Wide Normal fuer die grossen Zahlen, Audit-Durchgang
- Audi Type Wide gab es hier nur als Light (300). Der Eigentuemer hat den
  vollen Satz aus Audis Styleguide geliefert; Wide Normal (400) ist jetzt
  eingebunden (App und Panel), Wide Bold liegt vor und bleibt bewusst
  ungenutzt. Lizenz wie bei allen Audi-Assets: nur diese eine private
  Installation, deshalb nichts davon in design-system.
- Dabei gefunden: die Aenderung im Design-System allein war wirkungslos.
  audi-schrift.css bringt fuer .ads-fig eine eigene, spaetere Regel mit und
  gewinnt. Im gebauten Stylesheet standen beide - nur die Reihenfolge
  entschied, und sichtbar wurde es erst am gerenderten getComputedStyle.
- Vollstaendiger Durchgang (AGENTS.md Abschnitt DC): Statik, struktureller
  Paritaetstest ueber Routen, Dienste, Sensorrollen, Wortlaut und
  Statusfelder, dazu ein Funktionstest an beiden laufenden Oberflaechen.
  Ein echter Befund: standort_genauigkeit_m ist totes Schema im Panel.
  Drei Meldungen des Eigentuemers waren keine Fehler - das breite Layout,
  der Beschriftungs-Schalter ohne Reiterleiste, und eine Testfahrt von mir.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-05 17:47:50 +02:00
..

@audi-dash/ui

Generisches React-Komponenten-Set, das die visuelle Sprache des Audi-Dashboards (Kacheln, Formularzeilen, Toggle, Segmented Control, Popups, Statusanzeigen, Fortschrittsanzeigen …) nachbildet. Enthält keine Audi-Marken-Assets (Font "Audi Type", Ringe, Typenschild) - diese sind laut Lizenzvereinbarung ausschließlich für die private Home-Assistant-Installation freigegeben. Diese Bibliothek nutzt einen neutralen Fallback-Font-Stack (Helvetica, Arial, sans-serif).

Verwendung

Konsumierende Apps legen die .ads-root-Klasse um den Baum, der die Bibliothek nutzt, und setzen data-theme="nacht" (Standard) oder data-theme="tag":

import { Tile, Feld, Switch } from "@audi-dash/ui";
import "@audi-dash/ui/styles.css";

function App() {
  return (
    <div className="ads-root" data-theme="nacht">
      <Tile>
        <Feld label="Beispiel">
          <Switch checked={true} onChange={() => {}} />
        </Feld>
      </Tile>
    </div>
  );
}

Design-Tokens

Alle Farben/Radien/Abstände liegen als CSS-Custom-Properties in src/tokens/tokens.css vor - Komponenten referenzieren ausschließlich var(--token), nie Literal-Hex-Werte. Siehe die Datei für die vollständige Liste (--red, --canvas, --tile, --fg/--fg2/--fg3, --ok/--warn/ --bad, --r-tile/--r-pill/--r-func, --sp-1--sp-5).

Typografie-Utility-Klassen

Reine Textstil-Hooks ohne eigene Komponentenstruktur (in tokens.css definiert) - direkt als className anwenden:

Klasse Verwendung
.ads-eyebrow Kleine Überschrift über einem Seitentitel (10px, uppercase, --fg3)
.ads-title Seitentitel (23px, einzeilig, ellipsis)
.ads-label Feld-/Kachel-Label (10px, uppercase, --fg3)
.ads-sport Kursiver Akzenttext

Die einzige Ausnahme mit echter interner Struktur ist die Fig-Komponente (großer Zahlenwert + Einheit) - sie wird intern auch von ProgressRing und StatGrid genutzt.

Komponenten

Pill, IconButton, Fig, StatusRow, ActionButton, Switch, Seg, RowList, LeafRow, Tile, Feld, ProgressRing, ProgressBar, StatGrid, Accordion, SwipeRow, TabBar, Popup (+PopupMenuItem), ImagePlaceholder. Props-Referenz: .d.ts-Dateien im Build bzw. die jeweilige <Name>.tsx.

Build

npm install
npm run typecheck
npm run build