coulomb/whynot-design
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(designbook): technology-neutral IR + stack-adapter pipeline (WHYNOT-WP-0002 T01-T06)

Browse Source 
Author the design language once in the canonical React designbook and project it
one-way onto each stack: React -> designbook/ -> ir/ -> adapters/<stack>/.

Phase 0 — contracts & governance (T01-T03):
- ir/SCHEMA.md + ir/schema/{component,tokens}.schema.json — neutral IR contract
  (W3C DTCG tokens; React prop -> HTML attribute mapping; non-portable props flagged).
- adapters/ADAPTER_CONTRACT.md — inputs, drift-report + parity-result shapes,
  idempotency rules, CI exit codes (0 ok / 2 usage / 3 drift / 4 parity / 5 internal).
- .claude/rules/designbook-propagation.md + DesignSystemIntroduction.md §5.1 —
  one-way directionality + drift-resolution workflow.

T04 — canonical React designbook + the missing pull tool:
- The bundled /design-sync skill only PUSHES repo->cloud; it cannot populate
  designbook/. Added scripts/designbook_pull.py + `make designbook-pull`, which drives
  the local claude binary headless (acceptEdits) so DesignSync fetch+write runs in a
  subprocess (contents never hit the orchestrator's context). Pulled 44 files;
  excludes the _whynot-design-seed/ self-copy. Corrected the docs that wrongly called
  /design-sync the pull.

T05 — IR extractor (scripts/ir-extract.mjs + `make ir`):
- ir/tokens.json (80 tokens, DTCG, var() -> {ref} alias resolution); ir/components/*.json
  (10 contracts parsed from .jsx signatures: enum/boolean/number inference, prop->attr
  map, style/callback marked non-portable); ir/exemplars/*.

T06 — Lit token adapter (adapters/lit/ + `make adapt-lit`):
- Full-gen tokens into src/styles/colors_and_type.css :root (marker-bounded, idempotent
  no-op on re-run; hand-authored type CSS preserved).

NOTE: token regen synced Lit to canonical React — fonts IBM Plex -> system stacks and 8
status tokens added. This is a VISUAL change: review and run `pnpm test:visual:update`
before merge. Remaining: T07 scaffold+drift, T08 parity, T09 runbook, T10 2nd-adapter.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Bernd Worsch
2026-06-24 12:36:24 +02:00
parent d149f965a3
commit 0d688ca94a
80 changed files with 6439 additions and 106 deletions
Download Patch File Download Diff File Expand all files Collapse all files

31
designbook/preview/colors-status-functional.html Normal file
View File

@@ -0,0 +1,31 @@
<!doctype html>
<!-- @dsCard group="Colors" name="Colors · Functional Status" subtitle="Error / warn / success / info — borders & dots only" viewport="700x280" -->
<html><head>
<meta charset="utf-8"><title>Functional Status Colours</title>
<link rel="stylesheet" href="../colors_and_type.css">
<style>
body { padding: 24px 32px; background: var(--paper); }
.row-label { font: 500 11px/1 var(--ff-mono); letter-spacing: 0.08em; text-transform: uppercase; color: var(--fg-3); margin-bottom: 14px; }
.grid { display: grid; grid-template-columns: repeat(4, 1fr); gap: 12px; margin-bottom: 18px; }
.sw { padding: 12px 12px 14px; min-height: 92px; display: flex; flex-direction: column; gap: 6px; background: var(--paper); border-left: 2px solid; position: relative; }
.sw .dot { width: 10px; height: 10px; border-radius: 999px; position: absolute; right: 12px; top: 12px; }
.sw .name { font: 500 13px var(--ff-sans); color: var(--fg-1); }
.sw .tok { font: 400 11px var(--ff-mono); color: var(--fg-3); }
.sw .hex { font: 400 11px var(--ff-mono); color: var(--fg-3); margin-top: auto; }
.e { border-color: var(--status-error); } .e .dot { background: var(--status-error); }
.w { border-color: var(--status-warn); background: var(--status-warn-bg); }
.w .dot { background: var(--status-warn); }
.s { border-color: var(--status-success); } .s .dot { background: var(--status-success); }
.i { border-color: var(--status-info); } .i .dot { background: var(--status-info); }
.caveat { font: 400 11px/1.45 var(--ff-mono); color: var(--fg-3); margin-top: 4px; max-width: 64ch; }
</style></head>
<body>
<div class="row-label">Functional status — borders + dots only, never fills</div>
<div class="grid">
<div class="sw e"><span class="dot"></span><span class="name">Error</span><span class="tok">--status-error</span><span class="hex">#B33A2E · brick red</span></div>
<div class="sw w"><span class="dot"></span><span class="name">Warning</span><span class="tok">--status-warn</span><span class="hex">#C28000 · deep mustard</span></div>
<div class="sw s"><span class="dot"></span><span class="name">Success</span><span class="tok">--status-success</span><span class="hex">#2F6B3A · muted forest</span></div>
<div class="sw i"><span class="dot"></span><span class="name">Info</span><span class="tok">--status-info</span><span class="hex">#2E5C8A · muted ink-blue</span></div>
</div>
<p class="caveat">Distinct from S0–S4 signal strength. Use sparingly: a 2px left-border on banners, a small dot next to status text, or as <code class="mono">currentColor</code> on an icon. If even this feels too colourful for a context, fall back to ink and the existing yellow accent — the system still parses without these.</p>
</body></html>