coreui / coreui-pro / 33980141449

94%

main: 94%

push

github

feat(utilities)!: name the colour families like upstream, fold opacity into them (#1178)

* feat(utilities)!: name the colour families like upstream, fold opacity into them

Text, background and border colour utilities take upstream's spelling and
mechanism. `.fg-{color}`, `.fg-emphasis-{color}`, `.fg-contrast-{color}` and
`.fg-reset` join the `.fg-body` / `.fg-1` … `.fg-4` ladder; the light surfaces
are `.bg-subtle-{color}` and `.bg-muted-{color}`, the light border
`.border-subtle-{color}`. Each class writes its colour into one token
(`--cui-fg`, `--cui-bg`, `--cui-border`, `--cui-underline`) and reads it back,
so opacity is a companion step of the same family: `.fg-{n}`, `.bg-{n}`,
`.border-{n}`, `.link-{n}(-hover)` and `.underline-{n}(-hover)` run 10 to 100
in tens and mix that token with `transparent` through `color-mix()`.
`.lh-md` names the body line height; `.shadow-opacity-*` counts the same
ten steps.

Every v5 spelling stays as a deprecated alias rendering the same output
(`.text-*`, `.bg-{color}-subtle/-muted`, `.border-{color}-subtle`, the
`*-opacity-*` families, `.lh-base`, `.shadow-opacity-25/-75`), so no class
is lost; the shared docs engine and the framework editions keep working
until the aliases go in v7. The `--cui-text`, `--cui-*-opacity` and
`--cui-link-opacity` tokens are gone: reboot's `a` reads
`var(--cui-theme-fg, var(--cui-link-color))` instead of mixing every link
through `color-mix()` + `calc()`, and `.text-bg-*` paints the colour
directly.

`$util-opacity` and `theme-opacity-values()` live in `_theme.scss` as
upstream has them. Docs: colors, background, border-color, link,
line-height, shadows and the utilities API page rewritten for the new
families; every example across the docs uses the new spellings.

BREAKING CHANGE: the six opacity tokens are removed; inline
`--cui-bg-opacity` overrides stop working. Class names are additive.

* chore: raise the CSS ceilings for the deprecated colour utility aliases

The v5 spellings... (continued)

4837 of 5435 branches covered (89.0%)

Branch coverage included in aggregate %.

9268 of 9667 relevant lines covered (95.87%)

401.4 hits per line