Files
whynot-design/designbook/preview/comp-prototype-card.html
tegwick 0d688ca94a feat(designbook): technology-neutral IR + stack-adapter pipeline (WHYNOT-WP-0002 T01-T06)
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>
2026-06-24 12:36:24 +02:00

47 lines
3.3 KiB
HTML

<!doctype html>
<!-- @dsCard group="Components" name="Components · Prototype Card" subtitle="Default + hover (black left bar)" viewport="700x290" -->
<html><head>
<meta charset="utf-8"><title>Prototype Card</title>
<link rel="stylesheet" href="../colors_and_type.css">
<style>
body { padding: 24px 32px; background: var(--paper-2); }
.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: 1fr 1fr; gap: 14px; }
.card { background: var(--paper); border: 1px solid var(--border); border-radius: var(--r-2); padding: 20px 22px; display: flex; flex-direction: column; gap: 10px; position: relative; }
.card.hover::before { content:""; position: absolute; left: -1px; top: -1px; bottom: -1px; width: 2px; background: var(--ink); }
.head { display: flex; justify-content: space-between; align-items: baseline; }
.meta { font: 500 10px/1 var(--ff-mono); letter-spacing: 0.1em; text-transform: uppercase; color: var(--fg-3); }
.head .stage { font: 500 10px/1 var(--ff-mono); letter-spacing: 0.1em; text-transform: uppercase; color: var(--fg-2); display: inline-flex; align-items: center; gap: 6px; }
.head .stage .dot { width: 8px; height: 8px; border-radius: 999px; background: #5C5C5C; }
.pitch { font: 500 17px/1.35 var(--ff-sans); margin: 4px 0 8px; }
.qrow { display: flex; gap: 8px; font-size: 13px; color: var(--fg-2); }
.qrow .k { color: var(--fg-3); font-family: var(--ff-mono); font-size: 11px; letter-spacing: 0.06em; text-transform: uppercase; min-width: 96px; flex: none; padding-top: 2px; }
.qrow .v { color: var(--fg-1); }
.foot { display: flex; justify-content: space-between; padding-top: 12px; margin-top: 4px; border-top: 1px solid var(--border-soft); font-size: 12px; color: var(--fg-3); font-family: var(--ff-mono); }
</style></head>
<body>
<div class="row-label">Prototype card — default · hover</div>
<div class="grid">
<article class="card">
<div class="head">
<span class="meta">WNO-014 · Prototype</span>
<span class="stage"><span class="dot"></span>Experiment</span>
</div>
<h3 class="pitch">A pocket field-notebook for catching weird ideas before they evaporate.</h3>
<div class="qrow"><span class="k">Learning q.</span><span class="v">Do people return to capture more than once?</span></div>
<div class="qrow"><span class="k">Smallest test</span><span class="v">One-page landing + email capture, 14 days.</span></div>
<div class="foot"><span>→ Coulomb</span><span>S1 · weak</span></div>
</article>
<article class="card hover">
<div class="head">
<span class="meta" style="color: var(--fg-1)">WNO-017 · Prototype</span>
<span class="stage"><span class="dot" style="background:#0A0A0A"></span>Signal review</span>
</div>
<h3 class="pitch">A LEGO-brick mood board for engineers who don't think in mood boards.</h3>
<div class="qrow"><span class="k">Learning q.</span><span class="v">Will engineers attach metaphors to their tickets?</span></div>
<div class="qrow"><span class="k">Smallest test</span><span class="v">Slack bot, three teams, two weeks.</span></div>
<div class="foot"><span>→ Helix</span><span>S3 · strong</span></div>
</article>
</div>
</body></html>