@taprootio/espalier 3.1.0 → 3.3.0

package/CHANGELOG.md

@@ -1,3 +1,56 @@
+# 3.3.0
+
+Theme QA: the fit report as a lint over every surface a themed site
+has, a CLI that makes fit tables reviewable, and swatch intake.
+
+- `themeFitReportSuite(lightPartial, darkPartial)`: root plus every
+  context, both schemes, compiled through the exact zone path a
+  `context` attribute uses (`resolveContextTheme`, now exported), with
+  cross-token lints — action/canvas separation and link/hover ordering.
+- `npx espalier theme check ./theme.json` — validate a pair, print the
+  suite, and gate CI on committed fit tables (`--expect`, non-zero on
+  drift; refresh deliberately with `--update-expect`).
+- The action-surface placement steps past stops indistinguishable from
+  the local canvas whenever a separated stop can carry the ink.
+- Context declarations accept `semanticMappings` to correct inherited
+  root-level pins; the fit report marks pins `declared` / `inherited`.
+- New data companions per surface: `--esp-color-series-N-wash` (the
+  documented 75% OKLab fill mix, baked against the local background)
+  and `--esp-color-series-N-ink` (text-tier contrast).
+- `themeFromSwatches` / `deriveLightnessRamp`: brand book in,
+  reviewable paired theme starter out (names normalized to anchor
+  slugs).
+- Fix: `linkHover` is enforced against `linkHoverBg`, the wash hovered
+  links actually paint on. Values move only where hover was under tier
+  on its rendered wash.
+
+# 3.2.0
+
+Website-tier layout: the pieces a real marketing page proved were
+missing (measured: a 297-line style block, 48% layout, none of it
+novel).
+
+- `esp-page kind="site"`: sections run edge to edge and the header,
+  footer, and every section well share one centered column via
+  `--esp-page-well-max-width` (default 72rem).
+- `esp-section`: the full-bleed band with a centered well — and the
+  natural `context` zone host, with no card identity to neutralize.
+  Rhythm defaults to the new fluid `--esp-size-section` step.
+- `esp-stack` and `esp-row`: column and wrapping-row flow with
+  space-scale gaps. Stacks stretch like block flow while slotted
+  buttons keep their natural width — the pairing a plain flex column
+  cannot express.
+- Layout tokens: `--esp-measure` / `--esp-measure-wide`,
+  `--esp-size-section`, `--esp-shadow-1..3` (elevation; level 1 is
+  exactly the shadow `esp-box` always painted, now overridable via
+  `--esp-box-shadow`), and `--esp-card-min` for the auto-fit card-grid
+  recipe.
+- `esp-root` accepts theme objects directly: `root.lightTheme = {...}`
+  / `root.darkTheme = {...}` encode through the same pipeline as the
+  `light-theme` / `dark-theme` attributes.
+- New export subpaths: `./section`, `./stack`, `./row`, and dedicated
+  entries for `./flyout`, `./progress`, `./toaster`, `./tooltip`.
+
 # Changelog
 
 All notable changes to the public `@taprootio/espalier` package are documented