coreui / coreui-pro / 32967327440

93%

main: 94%

push

github

docs: document the token, size and variant map APIs; make variant maps merge (#927)

The Sass page taught the v5 surface — variables, theme-color maps, the
color functions — and said nothing about the machinery v6 customization
actually runs on: $root-tokens and the $<component>-tokens maps, the
$<component>-sizes lists, the $<component>-variants maps, defaults()
and the map helpers. The npm guide already tells readers to write
`with ($root-tokens: …)`; this page now explains it. New sections:
Token defaults (partial overrides, null removal, how the three levels
coexist), Size maps (removing is one null; adding also needs the tokens
the loop reads), Variant maps (slot-valued entries follow every theme
color), Defaults and Map helpers under Functions.

One code change rides along, because writing the variant section
exposed it: $alert-variants, $avatar-variants and $badge-variants were
plain !default, so a `with ()` override replaced the whole map and
silently dropped the built-in variants — while $button-variants merges
through defaults(). All three now merge the same way. The compiled CSS
is byte-for-byte identical; the documented examples were compiled
against the source to prove the semantics: an added "outline" alert
variant lands next to the kept "solid", and a null removes
.pagination-sm while .pagination-lg stays.

defaults() and map-slot() gain scss-docs captures so the new sections
quote the real source.

4619 of 5202 branches covered (88.79%)

Branch coverage included in aggregate %.

8831 of 9244 relevant lines covered (95.53%)

393.15 hits per line