designlang 12.0.0 → 12.2.0

package/.claude/launch.json

@@ -6,6 +6,12 @@
       "runtimeExecutable": "npm",
       "runtimeArgs": ["--prefix", "website", "run", "dev"],
       "port": 3000
+    },
+    {
+      "name": "grade-preview",
+      "runtimeExecutable": "npx",
+      "runtimeArgs": ["--yes", "http-server", "design-extract-output", "-p", "4173", "-c-1", "--silent"],
+      "port": 4173
     }
   ]
 }

package/CHANGELOG.md

@@ -1,5 +1,58 @@
 # Changelog
 
+## [12.2.0] — 2026-05-02
+
+**Battle cards + design score badges — distribution + virality on top of Grade.**
+
+### Added
+
+- **`designlang battle <urlA> <urlB>`** — head-to-head graded battle card.
+  Single shareable HTML pitting two sites against each other, dimension by
+  dimension, with a verdict line and a per-dimension bar table. Both sites
+  are extracted in parallel. Emits `*.battle.html`, `*.battle.md`, and
+  `*.battle.json`.
+- **`designlang grade --badge`** — also emit `*.grade.svg`, a shields.io-style
+  SVG badge (`design · B · 87`) coloured by letter grade. Drop into any
+  README.
+- **Live badge endpoint** at `https://designlang.app/badge/<host>.svg` (with
+  rewrites from `/badge/<host>` and `/api/badge/<host>`). Reuses the same
+  blob cache the `/api/extract` route writes to, so the first hit warms the
+  cache and every subsequent hit is served from edge cache in ~50ms. 6h
+  fresh / 24h stale-while-revalidate / 7d max — friendly to the GitHub image
+  proxy.
+- New formatters: `src/formatters/battle.js`, `src/formatters/badge.js`,
+  with exports `formatBattle`, `formatBattleMarkdown`, `compareScores`,
+  `formatBadge`, `formatScoreBadge`.
+- 13 new tests (battle markup, score comparison thresholds, SVG escaping,
+  grade-color mapping, missing-score handling).
+
+Why this exists: the v12.1 Grade card was the differentiator. Battle is the
+viral content layer ("Stripe vs Vercel — guess who lost"). The badge is the
+distribution layer — every README that adopts it is a permanent backlink to
+a public grade page.
+
+## [12.1.0] — 2026-04-29
+
+**Design Report Card — a shareable audit page, generated from any URL.**
+
+### Added
+
+- **`designlang grade <url>`** — produces a standalone, self-contained HTML
+  "Design Report Card" alongside JSON and Markdown variants. Letter grade
+  (A–F) hero, eight scored dimensions with arc gauges, evidence pulled from
+  the audited site itself (palette swatches, type specimen, spacing rhythm),
+  and a strengths / what-to-fix ledger. Editorial layout, paper/ink theme
+  with a dark toggle, print-ready, OG-meta for shareable links.
+- New formatter: **`src/formatters/grade.js`** with `formatGrade` (HTML) and
+  `formatGradeMarkdown` exports. Reuses the existing `scoreDesignSystem`
+  output — no scoring changes.
+- Flags: `--format html|md|json|all`, `--open` to launch the report in your
+  browser when it finishes.
+
+Why this exists: html.to.design, Locofy, Builder, Polypane all ship
+extraction or layout cloning. None of them grade the design system itself
+in a form you can post on Twitter or email to a client. This is that.
+
 ## [10.5.0] — 2026-04-22
 
 **The states LLMs always botch.**