Parse a CSS color string and return hex, rgb, oklch, and gamut info.

Convert a CSS color string into a canonical hex, rgb, hsl, or oklch format string.

Compute the WCAG 2.1 contrast ratio between two fully opaque CSS color strings and return WCAG tier flags (AA/AAA normal/large text). Set apca:true to also get the signed APCA-W3 Lc for text a over background b.

Map any CSS color string into the sRGB gamut via perceptual OKLCH chroma reduction. Returns the nearest in-gamut hex, raw OKLCH components, and a clamped flag indicating whether the input was out-of-gamut.

Generate a tint-to-shade color ramp from a base CSS color. Returns an ordered list of swatches (light → dark) each with its in-gamut hex, display-rounded OKLCH components (l/c 5dp, h 2dp), WCAG contrast ratios (2dp) + tiers vs white and black, and an in-gamut flag. Optionally emits the ramp as design tokens via tokenFormat ("tailwind" JSON or a "css-variables" :root block).

Find a foreground color that meets one or more WCAG 2.1 contrast targets against a background. Binary-searches OKLCH lightness (holding hue/chroma fixed) and returns the nearest-compliant hex plus the achieved ratio. Pass target for one target or targets for several; prefer selects lighter/darker/either; hue/chroma pin the foreground chromaticity. If BOTH target and targets are provided, targets takes precedence. The response shape differs by mode: a single target returns { met, color, ratio } (with an optional nearMiss flag); targets returns { results: [{ met, color, ratio, nearMiss? }, ...] }. The output schema is an all-optional superset of both shapes (SDK 1.29 single-shape limitation). An unparseable background returns the PARSE_FAILED error; a translucent background (alpha < 1, e.g. rgba()/hsla()/#rgba/#rrggbbaa) returns ALPHA_UNSUPPORTED — composite it over its backdrop first.