coreui / coreui-pro / 32766210832

93%

main: 94%

push

github

docs(helpers): describe the focus ring and hover lift we actually ship (#874)

Two pages had drifted from the code, found by reading them next to upstream's.

The focus ring page opened by saying the helper "removes the default outline on
`:focus`, replacing it with a box-shadow". It is an `outline` on
`:focus-visible` — the same page says so further down, so it contradicted
itself. The example then told the reader to click the link, which is exactly
what does not show a `:focus-visible` ring.

It also missed a variant we ship. The rule resolves
`var(--cui-theme-focus-ring, var(--cui-focus-ring-color))` and every `.theme-*`
class sets that token, so `.focus-ring.theme-primary` recolours the ring with no
extra class. That is a different knob from the `.focus-ring-*` utilities the
page already covered — theme follows the element, the utility only touches the
ring — and the page now says which to reach for.

The hover lift page carried variables and no explanation, its two headings sat
at H2 instead of under `## Customizing`, and its example was a `<div>`: the
helper styles `:hover` and `:focus-visible`, and a div cannot take keyboard
focus, so half of what it documents was undemonstrable. The example is an `<a>`,
and the page now explains the composition and the reduced-motion behaviour, and
shows the tokens being overridden rather than only listing them.

4532 of 5097 branches covered (88.92%)

Branch coverage included in aggregate %.

8653 of 9054 relevant lines covered (95.57%)

400.26 hits per line