Add to `clampChroma` option to clamp to P3 space

[ai]

P3 space is widely used (any modern Apple tech) and give a lot of new color.

We are using clampChroma to generate dynamic accent color. It would be nice to be able to clamp chroma not just to fit sRGB, but also to fit P3.

[danburzo]

Hi @ai, thanks for the suggestion and sorry for the late response. This feature is captured in the PR:

• Implement gamut mapping #165

It introduces more generic functions for clampChroma, clampRGB, and displayable.

[ai]

Cool! But this PR will break TypeScript PR.

Can we merge TS first? TS is very important for modern days DX.

[danburzo]

Although initially planned for #165, the PR does not include an implementation of toGamut(), which this feature request is concerned with.

Some references on the topic:

• [css-color-4] CSS gamut mapping algorithm clarifications w3c/csswg-drafts#7653
• [css-color-4] Disagreements over gamut mapping w3c/csswg-drafts#7610
• [css-color-4] Gamut Mapping with Oklch - Odd Results w3c/csswg-drafts#7071
• Implement CSS Color 4 gamut mapping color-js/color.js#154
• Gamut mapping: clarification of chroma reduction algorithm color-js/color.js#63
• [css-color-4] Gamut Mapping Algorithm and Color Banding w3c/csswg-drafts#7135