@fusion.dev/helix-docs 0.207.2 → 0.208.0

package/content/color.mdx

@@ -35,7 +35,9 @@ choice people most often get wrong. See [Surfaces and
 separation](./surfaces-and-separation).
 
 A field is filled with `well`: 5% of `foreground` laid over whatever the field
-sits on, so its color depends on the surface under the field.
+sits on, so its color depends on the surface under the field. A row under the
+pointer or the keyboard, such as an option, is lit with `hover` the same way:
+8% of `foreground` in light and 12% in dark.
 
 ### Inks
 
@@ -124,6 +126,14 @@ solves them against the well over the page, a card, a raised surface, a dialog,
 and a sunken surface. The report names each of these grounds as the well over
 its surface, such as `color-well over color-surface`.
 
+Both inks are also written on a lit row and on a selected row. The engine solves
+them against these grounds as well:
+
+- `hover` over each of the same five surfaces, such as `color-hover over
+  color-surface`
+- `primary-subtle` and `accent-subtle`, the tints a selected row takes
+- the well over each tint, for a field on a selected row
+
 `foreground-subtle` is the one ink the engine does not solve. The range of
 readable grays has room for one quiet ink, and `foreground-muted` is that ink, so
 `foreground-subtle` stays a fixed step of the stylesheet's gray ramp and its

package/content/intent-reference.mdx

@@ -83,7 +83,7 @@ left out.
 | Field | What it controls |
 |---|---|
 | `contrastTarget` | Target contrast for body text. 4.5 is WCAG AA, and 7 is AAA |
-| `pairings` | The foreground and background pairs to measure, by token name. A background of `color-well over color-surface` is a field's well over that surface. The list replaces the pairs from the engine's surface model. The engine measures each pair and solves none of them, and a pair that names a token the engine does not emit is reported as `unverifiable` |
+| `pairings` | The foreground and background pairs to measure, by token name. A background of `color-well over color-surface` is a field's well over that surface, and `color-hover over color-surface` is a lit row over it. The list replaces the pairs from the engine's surface model. The engine measures each pair and solves none of them, and a pair that names a token the engine does not emit is reported as `unverifiable` |
 
 The default is 4.5, the WCAG 2.1 AA figure. The European Accessibility Act
 refers to WCAG 2.1 AA, so 4.5 is the figure with legal weight.