@fusion.dev/helix-docs 0.207.2 → 0.208.1

package/content/browser-support.mdx

@@ -1,5 +1,5 @@
 ---
-description: The browser features Helix uses, and the browser we test in.
+description: The browser features Helix uses, and the browsers we test in.
 order: 5
 section: Getting started
 title: Browser support
@@ -13,12 +13,32 @@ support in older browsers. Your browser needs every feature Helix uses.
 
 ## What we test
 
-We test in Chromium, through Playwright. The DOM specs run in it, and the pixel
-baselines are captured in it, on Linux, with the network blocked.
+We test in Chromium and WebKit, through Playwright, on Linux, with the network
+blocked.
 
-We do not run the tests in Firefox or Safari. The rest of this page lists the
-browser features Helix uses. If you ship Helix to Firefox or Safari and find
-something broken, please report it. Our tests would not have caught it.
+- The DOM specs run in both.
+- The pixel baselines are captured in Chromium only.
+
+WebKit is the engine in Safari, and the system webview a Tauri app draws with on
+macOS and Linux. Playwright builds its own WebKit from the same source as
+Safari, so a difference that only Safari shows can still get past our tests.
+
+We do not run the tests in Firefox. The rest of this page lists the browser
+features Helix uses. If you ship Helix to Firefox or Safari and find something
+broken, please report it.
+
+### Known differences in WebKit
+
+A few specs still fail in WebKit. We keep each one on a list until it is fixed.
+
+- Checkbox Group, Radio Group, Option, Toast, and Tooltip name or describe their
+  host through `ElementInternals`, pointing into their own shadow root. WebKit
+  reads those references back as empty. We have not yet checked whether
+  VoiceOver still reads the name.
+- In Virtual List, End can leave the last row below the viewport after `gap`
+  changes on a list that is already drawn.
+- In the sandbox's source pane, in WebKit on macOS, one undo after an indent
+  also removes the text typed before it.
 
 ## Browser features Helix uses
 

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.