coulomb/whynot-design
2
0
Fork 0
Code Issues Pull Requests Actions 1 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

51
RecentChanges.md
View File

@@ -2,13 +2,9 @@
Snapshot of the last designbook integration. Regenerated by `make designbook-sync`.
- Generated: 2026-06-22T20:02:58Z
- Generated: 2026-06-23T19:25:28Z
- Compared: working tree (uncommitted)
- Last /design-sync: never recorded
> WARNING — no /design-sync has been recorded, so the local designbook/ may not
> reflect the Claude Design project. Run `/design-sync` in Claude Code, then
> `node scripts/designbook-sync.mjs --mark-synced`.
- Last /design-sync: 2026-06-23T19:25:28Z
> This file is overwritten on every run — a snapshot, not a log. Fold notable entries
> into `CHANGELOG.md` under `## [Unreleased]` before releasing; that is the file CI
@@ -17,4 +13,45 @@ Snapshot of the last designbook integration. Regenerated by `make designbook-syn
## Changed files
### Designbook
- `ADDED ` designbook/README.md (+70 / -0)
- `ADDED ` designbook/_ds_bundle.js (+1396 / -0)
- `ADDED ` designbook/_ds_manifest.json (+1 / -0)
- `ADDED ` designbook/.design-pull.json (+18 / -0)
- `ADDED ` designbook/colors_and_type.css (+293 / -0)
- `ADDED ` designbook/preview/brand-iconography.html (+36 / -0)
- `ADDED ` designbook/preview/brand-lockups.html (+26 / -0)
- `ADDED ` designbook/preview/brand-logo.html (+21 / -0)
- `ADDED ` designbook/preview/brand-wireframe-motif.html (+43 / -0)
- `ADDED ` designbook/preview/colors-accent.html (+33 / -0)
- `ADDED ` designbook/preview/colors-borders.html (+25 / -0)
- `ADDED ` designbook/preview/colors-neutrals.html (+36 / -0)
- `ADDED ` designbook/preview/colors-signal.html (+25 / -0)
- `ADDED ` designbook/preview/colors-status-functional.html (+31 / -0)
- `ADDED ` designbook/preview/comp-buttons.html (+40 / -0)
- `ADDED ` designbook/preview/comp-empty-placeholder.html (+38 / -0)
- `ADDED ` designbook/preview/comp-inputs.html (+30 / -0)
- `ADDED ` designbook/preview/comp-labels-tags.html (+44 / -0)
- `ADDED ` designbook/preview/comp-left-nav.html (+85 / -0)
- `ADDED ` designbook/preview/comp-pipeline.html (+30 / -0)
- `ADDED ` designbook/preview/comp-prototype-card.html (+46 / -0)
- `ADDED ` designbook/preview/comp-topnav.html (+37 / -0)
- `ADDED ` designbook/preview/page-beta-invitation.html (+104 / -0)
- `ADDED ` designbook/preview/page-landing-auth.html (+224 / -0)
- `ADDED ` designbook/preview/page-prototype-detail.html (+158 / -0)
- `ADDED ` designbook/preview/page-signals-dashboard.html (+135 / -0)
- `ADDED ` designbook/preview/spacing-elevation.html (+26 / -0)
- `ADDED ` designbook/preview/spacing-radii.html (+24 / -0)
- `ADDED ` designbook/preview/spacing-scale.html (+28 / -0)
- `ADDED ` designbook/preview/type-body.html (+23 / -0)
- `ADDED ` designbook/preview/type-display.html (+23 / -0)
- `ADDED ` designbook/preview/type-headings.html (+20 / -0)
- `ADDED ` designbook/preview/type-mono-eyebrows.html (+42 / -0)
- `ADDED ` designbook/preview/type-serif-quote.html (+17 / -0)
- `ADDED ` designbook/REACT_CANONICAL_DECISION.md (+60 / -0)
- `ADDED ` designbook/styles.css (+9 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/Atoms.jsx (+102 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/Chrome.jsx (+163 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/data.jsx (+71 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/DocView.jsx (+102 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/index.html (+77 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/README.md (+31 / -0)
- `ADDED ` designbook/ui_kits/whynot-control/Screens.jsx (+274 / -0)