Files
whynot-design/designbook/preview/type-headings.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

21 lines
1.4 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<!-- @dsCard group="Type" name="Type · Headings" subtitle="H1H5 · PlexSans 500 · tight tracking" viewport="700x320" -->
<html><head>
<meta charset="utf-8"><title>Headings</title>
<link rel="stylesheet" href="../colors_and_type.css">
<style>
body { padding: 28px 32px; background: var(--paper); }
.row { display: grid; grid-template-columns: 64px 1fr auto; align-items: baseline; gap: 24px; padding: 10px 0; border-bottom: 1px solid var(--border-soft); }
.row:last-child { border: 0; }
.row .label { color: var(--fg-3); font-family: var(--ff-mono); font-size: 11px; letter-spacing: 0.08em; text-transform: uppercase; }
.row h1, .row h2, .row h3, .row h4, .row h5 { margin: 0; }
.row .spec { color: var(--fg-3); font-family: var(--ff-mono); font-size: 11px; letter-spacing: 0.04em; }
</style></head>
<body>
<div class="row"><span class="label">H1</span><h1>Prototype pipeline</h1><span class="spec">500 · 44 / 1.05</span></div>
<div class="row"><span class="label">H2</span><h2>Stage 2 — Prototype card</h2><span class="spec">500 · 32 / 1.25</span></div>
<div class="row"><span class="label">H3</span><h3>Learning question</h3><span class="spec">500 · 24 / 1.25</span></div>
<div class="row"><span class="label">H4</span><h4>Smallest useful test</h4><span class="spec">500 · 20 / 1.25</span></div>
<div class="row"><span class="label">H5</span><h5>Expected signal</h5><span class="spec">500 · 17 / 1.25</span></div>
</body></html>