@webority/theme 0.52.1 → 0.53.1

package/README.md

@@ -47,9 +47,16 @@ measures 3.75:1 on white. So the theme keeps two colours:
 All three derive from `$primary` at compile time, so setting `$primary` (or `wui-brand-primary`) is
 enough. A product can set `$wui-primary-ink` / `$wui-primary-text` before the theme's variables, or
 `--wui-primary-ink` / `--wui-primary-text` at runtime. A brand layer that re-points `--wui-primary` at
-runtime must set `--wui-primary-ink` and `--wui-primary-text` beside it. Dark mode uses the lifted
-`--wui-dark-primary` for the ink. `check-contrast` proves the derivation for an orange, an amber and a
-sky test brand and fails any theme rule that colours text with `--color-primary`.
+runtime must set `--wui-primary-ink` and `--wui-primary-text` beside it.
+
+Dark mode uses one colour, `--wui-dark-primary`, for primary text, rings, focus borders and the fill
+under its near-black label. It is `$primary` mixed with white in 2% steps until it clears 4.5:1 on
+every dark surface, on its own avatar tint, on the brand's soft tint and under that label, so
+`wui-brand-primary` carries the brand into dark mode (a royal blue `#2F50E4` lifts to about `#8FA1F0`). Never
+set it to the light brand fill: a runtime `--wui-dark-primary` must clear the same floors.
+
+`check-contrast` proves both derivations for an orange, an amber, a sky and a royal blue test brand
+and fails any theme rule that colours text with `--color-primary`.
 
 ### Country flags are opt-in