FacetUI
EnglishLoslegen

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.

Bald verfügbar

React ≥ 18 als Peer-Abhängigkeit · oder ohne React im Host als <facet-*>-Elemente

tasks/create/quick-addaktiv
SIEGELobservation — leer
  • Enter fügt die Aufgabe oben ein
    • unit: 2 Tests
    • property: kein Test
    • integration: kein Test
    • e2e: 1 Test
    getestet
  • Eine leere Zeile fügt nichts hinzu
    • unit: 1 Test
    • property: 1 Test
    • integration: kein Test
    • e2e: kein Test
    getestet
  • Rückgängig stellt die letzte Aufgabe wieder her
    • unit: kein Test
    • property: kein Test
    • integration: kein Test
    • e2e: kein Test
    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

quick-add.undoRückgängig stellt die letzte Aufgabe wieder hergetestet

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

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.

Repository wird gelesen~/work/taskflow
  1. fertigVerbinden
  2. fertigKonfiguration
  3. fertigRecords lesen
  4. jetztDateien zählen
  5. —Anker finden
  6. —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.

  1. 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
  2. 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
  3. 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

  4. 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
Register öffnen
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-controls oder aria-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.

BEISPIELApp.tsx
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, Typografie
  • facet-ui/coreDatenebene ohne React
  • facet-ui/core/fixturesDemodaten für die Entwicklung
  • facet-ui/elementsDieselben Komponenten als <facet-*>
  • facet-ui/elements/standaloneEin Bundle mit eingebettetem React
  • facet-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

Bring eine Anforderung auf den Bildschirm. Lücken eingeschlossen.

Version 0.1.0