FACET UI · DIE KOMPONENTENBIBLIOTHEK VON FACET
Zeig die Anforderungen. Zeig die Lücke.
48 (gemessen mit ls src/components/ui | wc -l) Komponenten, die Akzeptanzkriterien und Belege gemeinsam anzeigen. Testzuordnungen bleiben als solche erkennbar. Fehlendes bleibt sichtbar. Was niemand gemessen hat, bleibt ein Strich statt einer Null.
React ≥ 18 als Peer-Abhängigkeit · oder ohne React im Host als <facet-*>-Elemente
- Enter fügt die Aufgabe oben ein
- unit: 2 Tests
- property: kein Test
- integration: kein Test
- e2e: 1 Test
- Eine leere Zeile fügt nichts hinzu
- unit: 1 Test
- property: 1 Test
- integration: kein Test
- e2e: kein Test
- Rückgängig stellt die letzte Aufgabe wieder her
- unit: kein Test
- property: kein Test
- integration: kein Test
- e2e: kein Test
Umfang 412 Zeilen (Quelle: der Repository-Scan, nicht der Record)Abdeckung — nicht gemessenBeispiel
- <facet-text>Text
- <facet-stack>Stack
- <facet-hairline>Hairline
- <facet-surface>Surface
- <facet-mark>Mark
- <facet-dot>Dot
- <facet-bar>Bar
- <facet-segment-band>SegmentBand
- <facet-counter>Counter
- <facet-probe-number>ProbeNumber
- <facet-scan-value>ScanValue
- <facet-quiet-line>QuietLine
- <facet-kbd>Kbd
- <facet-skeleton>Skeleton
- <facet-button>Button
- <facet-stat-value>StatValue
- <facet-coverage-ring>CoverageRing
- <facet-field-row>FieldRow
- <facet-focus-row>FocusRow
- <facet-rest-cloud>RestCloud
- <facet-sheet>Sheet
- <facet-blind>Blind
- <facet-trail>Trail
- <facet-depth-ladder>DepthLadder
- <facet-empty-state>EmptyState
- <facet-error-state>ErrorState
- <facet-index-progress>IndexProgress
- <facet-gherkin-statement>GherkinStatement
- <facet-seal>Seal
- <facet-lifecycle-badge>LifecycleBadge
- <facet-proof-matrix>ProofMatrix
- <facet-anchor-map>AnchorMap
- <facet-scenario-ledger>ScenarioLedger
- <facet-test-pyramid>TestPyramid
- <facet-knowledge-slots>KnowledgeSlots
- <facet-clause-sheet>ClauseSheet
- <facet-field-sheet>FieldSheet
- <facet-evidence-ledger>EvidenceLedger
- <facet-signal-stack>SignalStack
- <facet-record-source>RecordSource
- <facet-record-picker>RecordPicker
- <facet-companion>Companion
- <facet-dependency-fan>DependencyFan
- <facet-entry-cards>EntryCards
- <facet-group-tiles>GroupTiles
- <facet-markdown>Markdown
- <facet-role-gate>RoleGate
- <facet-timeline>Timeline
DAS KRITERIUM UND SEINE BELEGE
Ein Akzeptanzkriterium. Vier ehrliche Antworten.
Eine Szenariozeile in ScenarioLedger sagt nicht einfach „fertig“. Sie zeigt, ob ein Testeintrag auf das Akzeptanzkriterium verweist und ob ein Implementierungsanker im Repository vorhanden ist. Wähle einen Zustand.
SCENARIOLEDGER · EINE ZEILE · VORSCHAU
Given eine Liste mit einer gerade hinzugefügten AufgabeWhen ich Rückgängig drückeThen ist die Aufgabe entfernt und die Liste wie zuvor
- unit: 1 Test
- property: kein Test
- integration: kein Test
- e2e: kein Test
EINGELÖST DURCH— kein Implementierungsanker für dieses Kriterium
Beispielzeile. Die Spalten zeigen die vier Testarten der Komponente: Unit, Property, Integration und End-to-End.
WAS DIE ZEILE SAGT
“Ein Testeintrag bezieht sich darauf, aber es fehlt ein Implementierungsanker.”
WAS SIE NICHT TUT
Die Lücke hinter Grün verstecken. Ein bestandener Test ohne zugeordneten Code bleibt eine Lücke, und das wird benannt.
Eine leere Zelle bleibt leer. ProofMatrix zeichnet einen feinen Rahmen, wenn kein Test existiert, keine 0.
GEZÄHLT, MIT DEM VERWENDETEN BEFEHL
Jede Zahl hier stammt aus einem Befehl.
- Komponenten
- 48
- Gezählt mit
ls src/components/ui | wc -l - Custom Elements
- 48
- Gezählt mit
FACET_ELEMENT_TAGS, src/elements/index.ts - Story-Exporte
- 182
- Gezählt mit
grep -c "^export const" *.stories.tsx, summed - Testsuiten
- 68
- Gezählt mit
pnpm test:coverage - Tests
- 990
- Gezählt mit
pnpm test:coverage - Zeilenabdeckung
- 97 %
- Gezählt mit
pnpm test:coverage - Konfigurierte Mindestabdeckung
- 90/80/90/90
- Gezählt mit
jest.config.ts:22
SECHS EBENEN · EINE FORMENSPRACHE
Von der Haarlinie zur Belegmatrix.
Sechs Ebenen, eine Formensprache: Papier statt Karten, Haarlinien statt Kästen, keine Rundungen und keine Schatten. Jede Komponente ist unter demselben Namen auch ein Custom Element.
48 (gemessen mit ls src/components/ui | wc -l) Komponenten · 48 (gemessen mit FACET_ELEMENT_TAGS, src/elements/index.ts) Elemente
FACET-ORGANISMEN
Das Vokabular der Belege: Siegel, Verzeichnisse, Matrizen und Anker.
- GherkinStatement
<facet-gherkin-statement>Given / When / Then, typografisch gesetzt. - Seal
<facet-seal>Sieben Streifen, einer pro Facette. Sie zählen, ohne zu bewerten. - LifecycleBadge
<facet-lifecycle-badge>active · planned · deprecated · draft, mit Alter. - ProofMatrix
<facet-proof-matrix>Szenarien × Testarten. Eine leere Zelle bleibt leer. - AnchorMap
<facet-anchor-map> - ScenarioLedger
<facet-scenario-ledger>Jedes Akzeptanzkriterium, seine zugeordneten Tests und der Implementierungsanker. - TestPyramid
<facet-test-pyramid> - KnowledgeSlots
<facet-knowledge-slots> - ClauseSheet
<facet-clause-sheet> - FieldSheet
<facet-field-sheet> - EvidenceLedger
<facet-evidence-ledger> - SignalStack
<facet-signal-stack> - RecordSource
<facet-record-source> - RecordPicker
<facet-record-picker>Suche in Records, Akzeptanzkriterien, Tests und Codepfaden.
VORSCHAU · BEISPIEL
Siegel
aktiv · 34 Tage · LifecycleBadge
Given eine offene ListeWhen ich eine Aufgabe eingebe und Enter drückeThen sie oben erscheint
GherkinStatement
INDEXPROGRESS
Ein Ladebalken der nicht rät.
Solange der Host nur zählt, siehst du die Anzahl und der Balken bleibt leer. Ein Prozentsatz erscheint erst, wenn die Gesamtzahl bekannt ist. Jede Phase beginnt ihre Zählung bei null, damit kein veraltetes „1 204 von 2 481“ unter dem falschen Schritt steht.
- fertigVerbinden
- fertigKonfiguration
- fertigRecords lesen
- jetztDateien zählen
- —Anker finden
- —Modell aufbauen
1 204kein Prozentsatz ohne Gesamtzahl
Dateien im Repository · bisher gezählt. Der Balken wartet auf die Gesamtzahl.
Beispiel: Laden in Phasen mit Beispielwerten
VIER REGELN IN JEDER KOMPONENTE
Ehrlichkeit ist kein Stil. Sie ist der Vertrag.
01
Jedes Wort stammt aus einem Feld.
Ein Text ist ein Feldwert, ein Enum, ein Datum, ein Pfad, eine ID oder eine Anzahl davon. Ohne Feld kein Satz. Er wird gestrichen, nicht erfunden.
- owner
- team-tasks
- pitfalls
- — nicht beantwortet
02
Farbe steht nie allein.
Auch Rang, Gewicht, Position oder Form tragen die Bedeutung. Rot ist einer Sache vorbehalten: einer überschrittenen Frist. Entferne die Farbe und lies es erneut.
- Enter fügt die Aufgabe oben hinzu
- unit: 2 Tests
- e2e: 1 Test
- Rückgängig stellt die letzte Aufgabe wieder her
- unit: kein Test
- e2e: kein Test
- Eine leere Zeile fügt nichts hinzu
- unit: 1 Test
- e2e: kein Test
- Enter fügt die Aufgabe oben hinzu
03
Die Herkunft bleibt sichtbar.
Das Record-Schema kennt weder Zeilenzahlen noch Commits. Deshalb wird ein Wert aus dem Repository-Scan gepunktet unterstrichen. Mit Maus oder Tastaturfokus siehst du seine Herkunft.
geändert in 6 commits (Quelle: aus dem Repository-Scan, nicht aus dem Record)status active · aus dem Record
04
Vier Zustände, alle benannt.
Bereit, Laden, Leer, Fehler. Beim Laden bleibt die spätere Geometrie erhalten. Leer benennt die fehlende Facette. Fehler nennt Datei und Zeile.
Enter fügt die Aufgabe oben hinzu
Eine leere Zeile fügt nichts hinzu
2 getestet
TOKENS
Jede Farbe sagt genau eine Sache.
Signal führt weiter. Getestet ist grün. Geplant ist ocker. Überfällig ist die einzige echte Warnung. Ein Stylesheet, facet-ui/tokens.css, bringt sie auf jede Seite.
Eine dunkle Palette aus der Atlas-Oberfläche.
- Papier
--facet-bg#111318 - Fläche
--facet-surface#1b1d21 - Linie
--facet-border#2c3038 - Schrift
--facet-ink#f2f3f0 - Schrift, zurückhaltend
--facet-ink-2#c9cbc6 - Signal · der nächste Schritt
--facet-signal#8fabff - Getestet
--ok#74c49e - Geplant
--plan#e2b45c - Überfällig
--frist#f08e73
DIESELBEN ZEILEN, ANDERE TOKENS · VORSCHAU
tasks/create/quick-addactive
6/7
- Enter fügt die Aufgabe oben hinzugetestet
- Rückgängig stellt die letzte Aufgabe wieder hergeplant
- Annahme bis 2026-09-30 prüfenüberfällig
- TYPOGRAFIE
- IBM Plex Sans und Plex Mono. Zehn Größen von 9,5 bis 34 px.
- aus
tokens.css, --text-* - RASTER
- Sieben Stufen: 4 · 8 · 12 · 16 · 20 · 28 · 40.
- aus
tokens.css, --space-* - BEWEGUNG
- 200 bis 300 ms. Bei reduzierter Bewegung ausgeschaltet.
- aus
tokens.css, --motion-*
BEWEGUNG
Bewegung zeigt, woher Dinge kommen.
Ein Register steigt von unten auf. Ein Detail gleitet von rechts herein. Das Markenzeichen öffnet sich einmal und kommt zur Ruhe. Es bewegt sich nur weiter, solange etwas noch fehlt.
MARKENZEICHEN · ÖFFNEN, EINMALIG
Block 44 × 78 · Abstand 12 · Versatz 22 · Feld 100 × 100
MARKENZEICHEN · LADEN, SCHLEIFE BEIM WARTEN
Fünf gleiche Balken, das zerlegte Markenzeichen. Es hat keinen Endzustand und bleibt deshalb eine Schleife.
HERKUNFTSRICHTUNG
- Register · quick-add
- Register · invite-link
- Register · discount-codes
SIEGEL · SIEBEN STREIFEN, EINER PRO FACETTE
Der Streifen bewertet nicht. Er zählt.
intent · contract · verification · observation · knowledge · lineage · anchors
BARRIEREFREIHEIT, MIT LINTER GEPRÜFT
Der erste Lauf fand echte Fehler.
Der Accessibility-Linter setzt eine bestehende Anforderung um. Schon im ersten Lauf fand er zwei Fehler. Beide wurden behoben.
GEFUNDEN
Das Suchfeld war eine Combobox ohne
aria-controlsoderaria-activedescendant. Screenreader kündigten den aktuell ausgewählten Treffer nicht an.GEFUNDEN
Die Tiefennavigation verarbeitete Pfeiltasten auf einem Element ohne Tastaturfokus. Jetzt übernehmen die fokussierbaren Tabs diese Tasten.
- 83
- aria- und role=-Vorkommen im Komponentencode
grep -rn --include='*.tsx' "aria-\|role=" src/components | grep -v "spec\|stories" | wc -l- —
- Manueller Screenreader-Audit · nicht dokumentiert
DEPTHLADDER · ECHTE TABLISTE · VORSCHAU
ANTWORT
6 von 7 Facetten ausgefüllt. Observation ist leer.
- → eine Ebene tiefer
- ← zurück
- Esc schließt Sheet oder Blind; beide verwalten die Taste selbst
Beispiel
DREI EINSTIEGE, EIN QUELLBAUM
React, ohne React oder ganz ohne Darstellung.
import { Seal, ProofMatrix, GherkinStatement } from "facet-ui";import "facet-ui/tokens.css"; <Seal present={{ intent: true, contract: true }} /><ProofMatrix scenarios={record.scenarios} /><GherkinStatement statement={scenario.statement} />
Record hinein. Belege heraus.
Jede Komponente trennt Logik und Darstellung. Nutze die Standardansicht oder verbinde withSealLogic mit deiner eigenen.
facet-uiReact-Komponenten, Tokens, Typografiefacet-ui/coreDatenebene ohne Reactfacet-ui/core/fixturesDemodaten für die Entwicklungfacet-ui/elementsDieselben Komponenten als <facet-*>facet-ui/elements/standaloneEin Bundle mit eingebettetem Reactfacet-ui/tokens.cssDie Tokens als Stylesheet
IN ATLAS VERWENDET
Atlas erstellt sein Modell mit dieser Bibliothek.
Atlas, der FACET-Reader im Browser, erstellt sein Modell mit facet-ui/core und bezieht seine Farben aus facet-ui/tokens.css. Darauf baut die eigene Oberfläche auf.
Atlas importiert derzeit keine React-Komponenten der Bibliothek. Die Zahlen zeigen die tatsächlich verwendeten Importe.
- Atlas-Dateien mit facet-ui-Importen
- 71
- Gezählt mit
grep -rl 'from "facet-ui' web/atlas/src | wc -l - Importe von facet-ui/core
- 72
- Gezählt mit
grep -rho 'from "facet-ui[^"]*"' web/atlas/src | sort | uniq -c - Import der Demodaten
- 1
- Gezählt mit
grep -rho 'from "facet-ui[^"]*"' web/atlas/src | sort | uniq -c - Stylesheet: facet-ui/tokens.css
- 1
- Gezählt mit
web/atlas/src/app/globals.css:1