coreui / coreui-pro / 32491028491

93%

main: 94%

push

github

feat(Utilities API): validate the keys of a $utilities entry (#830)

An unknown key in a utility map is read by nothing and says nothing. That is
how `vars: true` sat on the four directional border-colour utilities since v5,
doing exactly nothing — found by writing the check, not by reading the file.
A misspelled `responsiv` costs you the responsive classes just as quietly.

`generate-utility()` now errors on a missing `property` or `values`, warns on
a key outside the supported set, and errors when a boolean option is given
something that is not a boolean. The error names the utility by its class,
because interpolating the map itself yields "isn't a valid CSS value".

`enabled: false` comes with it: it skips a utility without deleting its
definition, which reads better than replacing the entry with a non-map and
keeps the definition available to turn back on. Honoured by both loops and by
the `@property` registration.

The four dead `vars` keys are removed. Compiled CSS is unchanged.

4537 of 5095 branches covered (89.05%)

Branch coverage included in aggregate %.

8661 of 9055 relevant lines covered (95.65%)

400.01 hits per line