sebnitu / vrembem / 24643949616

90%

main: 100%

push

github

Migrate from using HSL to OKLCH color space (#2771)

This PR's primary purpose is to migrate from using the HSL to the OKLCH color space. The reason for this migration is to help improve the use of palettes within the Vrembem library, incorporate better contrast and vibrancy control, and to generate better design tokens for applying both primitive and semantic palette values.

As part of this update, color based design tokens have been refactored, new primitive palette tokens are generated and mapped to more idiomatic semantic palette tokens. Semantic palette tokens are setup as proper "themed" tokens so that their value can be adjusted based on the current theme.

Palette tokens are generated using the `palette` config options map where color seeds are defined and `palette-variants` config options map where all the lightness/chroma steps are defined.

### New and Updated Tokens

- `background`: Same as before. This is used as the background for the main content area and should create the highest contrast in both light and dark themes.
- `background-alt`: Replaces the use of `background-dark`. Used as an alternate color background from the main content.
- `background-shift`: Replaces the use of `background-darker`. Used for containers that are outside the context of the main content. Typically sidebars or headers etc.
- `foreground`: Replaces the use of `foreground-light` and is also the default color of the main content foreground. This is the medium contrast between strong and subtle.
- `foreground-strong`: Replaces what was previously the default `foreground` value. This is now the foreground for content that requires the highest contrast. Currently applied to headings in the main content.
- `foreground-subtle`: Replaces the use of `foreground-lighter`.
- `foreground-accent`: A new token used as an accent foreground for the main content area. Typically used on links and icons.
- `foreground-accent-alt`: A new token used as an alternate accent foreg... (continued)

565 of 647 branches covered (87.33%)

Branch coverage included in aggregate %.

882 of 948 relevant lines covered (93.04%)

32.09 hits per line