@taprootio/espalier 3.4.0 → 3.6.0

package/CHANGELOG.md

@@ -1,3 +1,49 @@
+# 3.6.0
+
+Named type roles without a generic text wrapper.
+
+- Overline, label, lead, and caption each have a complete
+  `--esp-type-<role>-*` recipe for size, weight, tracking, color, and — for
+  overline — uppercase transform. Apply the recipes to native paragraphs,
+  labels, captions, and inline elements so their semantics stay intact.
+- Each role has its own semantic ink. Overline and caption clear APCA Lc 90;
+  label and lead clear Lc 75. Theme `ink.color` or an existing raw `text`
+  mapping supplies unbound and unpinned roles without weakening a distinct
+  role family, and a context re-emits only the color aliases against its
+  locally enforced colors so inherited recipe overrides survive.
+- `esp-form-item` consumes the label recipe while retaining its component-level
+  label-color override.
+- Theme QA now recommends retuning the one-consumer `linkHoverBg` wash before
+  changing the widely shared `linkHover` ink.
+- Identical type-role APCA inputs share one background-aware enforcement
+  derivation per surface while retaining every token's fit-report record.
+
+### Migration note
+
+`esp-form-item` labels now take their size and weight from the label role instead
+of inheriting `--esp-form-item-font-size` and using literal `bold`. Themes with
+normal-weight headings therefore render normal-weight form labels; compact
+regions can override `--esp-type-label-font-size` or
+`--esp-type-label-font-weight` on their wrapper.
+
+# 3.5.0
+
+No unthemed flash when the theme mounts from script.
+
+- `<esp-root theme-pending>` holds the subtree's paint until the theme
+  for the active scheme applies — no frame on the default palette, no
+  layout shift on reveal. The hold ends on its own (and warns) if no
+  theme arrives, so a broken mount shows the wrong colors, never a
+  blank page, and the deadline survives a reattach.
+- The hold runs from upgrade onward. To close the window before your
+  scripts run, add the documented one-liner to your page:
+  `esp-root[theme-pending]:not([data-theme-ready]) { visibility: hidden }`.
+- Readiness is public: `themeSettled`, `whenThemeSettled()`, and a
+  `data-theme-ready` attribute page CSS can gate on.
+- The "context is not defined" warning now judges the settled theme, so
+  a zone whose context the theme goes on to define stays quiet while a
+  genuinely missing one still warns.
+
 # 3.4.0
 
 An offline story for icons: a fully self-contained page renders