jon.color-tools — com.github.jramosg/color-tools 1.3.0

->color clj/s

(->color r g b)

(->color r g b a)

Create a Color record from RGB values with optional alpha

->hex clj/s

(->hex color)

Convert Color to hex string

->hsl clj/s

(->hsl color)

Convert Color to HSL vector

->hsv clj/s

(->hsv color)

Convert Color to HSV vector

->name clj/s

(->name color)

Find closest color name for a color

->rgb clj/s

(->rgb color)

Convert a color to RGB vector

->rgba clj/s

(->rgba color)

Convert Color to RGBA vector

accessible-theme clj/s

(accessible-theme base-color)

(accessible-theme base-color options)

Generate WCAG-aware design tokens from a single brand color.

Options:

• :mode :light or :dark (default :light)
• :level :aa, :aa-large, or :aaa (default :aa)

Returns a map of hex color tokens for app UIs, including foreground tokens that meet the requested contrast level against their paired backgrounds.

accessible? clj/s

(accessible? color1 color2)

(accessible? color1 color2 level)

Check if two colors meet a WCAG contrast level. level is :aa (4.5, the default), :aa-large (3) or :aaa (7). Compares the unrounded contrast ratio, so a pair at 4.4999 fails :aa even though contrast-ratio displays 4.5.

adjust-hue clj/s

(adjust-hue color degrees)

Adjust the hue of a color by degrees

alpha-blend clj/s

(alpha-blend base-color overlay-color)

Blend two colors with alpha compositing (overlay on top of base)

analogous clj/s

(analogous color)

(analogous color count)

(analogous color count angle)

Generate analogous colors

blend-multiply clj/s

(blend-multiply base-color overlay-color)

Blend two colors using multiply mode (darkens)

blend-overlay clj/s

(blend-overlay base-color overlay-color)

Blend two colors using overlay mode (combines multiply and screen)

blend-screen clj/s

(blend-screen base-color overlay-color)

Blend two colors using screen mode (lightens)

brightness clj/s

(brightness color)

Calculate perceived brightness of a color (0-255)

clamp clj/s

(clamp value min-val max-val)

Clamp a value between min and max

clamp-rgb clj/s

(clamp-rgb rgb)

Clamp each channel of an RGB vector [r g b] to the 0 to 255 range and keep fractions. Use it on computed channels, such as oklab->rgb output, before passing them to ->hex or color, which reject values outside that range.

Clamping an out-of-gamut color changes its hue and lightness. It does not find the closest in-gamut color.

color clj/s

(color input)

(color r g b)

(color r g b a)

Create a Color record from various input formats.

Usage: (color 255 0 0) ; RGB values (color 255 0 0 0.8) ; RGBA values
(color "#ff0000") ; Hex string (color [255 0 0]) ; RGB vector (color [255 0 0 0.8]) ; RGBA vector (color (color 255 0 0)) ; From another Color record

color-distance clj/s

(color-distance color1 color2)

Calculate Euclidean distance between two colors in RGB space

color-from-hex clj/s

(color-from-hex hex-str)

Create a Color record from hex string

color-from-hsl clj/s

(color-from-hsl hsl-vec)

Create a Color record from HSL vector

color-from-hsv clj/s

(color-from-hsv hsv-vec)

Create a Color record from HSV vector

color-from-rgb clj/s

(color-from-rgb rgb-vec)

Create a Color record from RGB vector

color-from-rgba clj/s

(color-from-rgba rgba-vec)

Create a Color record from RGBA vector

color-names clj/s

color? clj/s

(color? x)

Check if value is a Color record

complementary clj/s

(complementary color)

Get the complementary color

contrast-ratio clj/s

(contrast-ratio color1 color2)

Calculate the WCAG contrast ratio between two colors, from 1 to 21. Rounds to 2 decimal places for display. accessible? and the other threshold checks compare the unrounded ratio.

cool? clj/s

(cool? color)

Check if a color is cool (blue/green/purple family)

dark? clj/s

(dark? color)

Check if a color is dark

darken clj/s

(darken color amount)

Darken a color by a percentage (0-1)

delta-e clj/s

(delta-e color1 color2)

Calculate perceptual color difference using CIE76 Delta E formula. Returns a value where < 1.0 is imperceptible, 1-2 is barely perceptible, 2-10 is noticeable, > 10 is very different

desaturate clj/s

(desaturate color amount)

Decrease saturation of a color by a percentage (0-1)

find-accessible-color clj/s

(find-accessible-color background target-color)

(find-accessible-color background target-color level)

Find an accessible color by adjusting lightness

generate-palette clj/s

(generate-palette strategy base-color)

(generate-palette strategy base-color options)

Generate a color palette using various strategies

get-contrast-text clj/s

(get-contrast-text background-color)

Get the best contrast text color (black or white) for a given background color. Uses luminance threshold of 0.35 following accessibility best practices, with fallback to ensure WCAG AA compliance:

• Light backgrounds (luminance > 0.35) get black text
• Dark backgrounds (luminance ≤ 0.35) get white text
• If the primary choice doesn't meet WCAG AA standards, tries the alternative
• If neither meets standards, returns the one with better contrast ratio Always returns a hex color string for consistency.

gradient clj/s

(gradient colors steps)

(gradient colors steps color-space)

Generate a gradient with n steps between colors

grayscale clj/s

(grayscale color)

Convert a color to grayscale

hex->hsl clj/s

(hex->hsl hex)

Convert hex to HSL

hex->name clj/s

(hex->name hex)

Find closest color name for a hex color (approximate)

hex->rgb clj/s

(hex->rgb hex)

Convert hex color to RGB vector

hex->rgba clj/s

(hex->rgba hex)

(hex->rgba hex alpha)

Convert hex color to RGBA vector with optional alpha

hsl->hex clj/s

(hsl->hex hsl)

Convert HSL to hex

hsl->rgb clj/s

(hsl->rgb hsl)

Convert HSL to RGB

hsv->rgb clj/s

(hsv->rgb hsv)

Convert HSV to RGB

in-gamut? clj/s

(in-gamut? oklab)

Check whether Oklab coordinates [l a b] fall inside the sRGB gamut, so that oklab->rgb returns every channel between 0 and 255. Allows a small tolerance for float error, so colors converted from valid RGB stay in gamut.

interpolate clj/s

(interpolate colors position)

(interpolate colors position color-space)

Interpolate between multiple colors at given position (0-1). Can use different color spaces: :rgb (default), :hsl, or :hsv

invert clj/s

(invert color)

Invert a color

kelvin->color clj/s

(kelvin->color kelvin)

Convert color temperature in Kelvin to Color record

kelvin->hex clj/s

(kelvin->hex kelvin)

Convert color temperature in Kelvin to hex color

kelvin->rgb clj/s

(kelvin->rgb kelvin)

Convert color temperature in Kelvin to RGB. Valid range: 1000K - 40000K. Based on Tanner Helland's algorithm.

light? clj/s

(light? color)

Check if a color is light

lighten clj/s

(lighten color amount)

Lighten a color by a percentage (0-1)

luminance clj/s

(luminance color)

Calculate relative luminance of a color

mix clj/s

(mix color1 color2)

(mix color1 color2 ratio)

Mix two colors with optional ratio (0-1, default 0.5)

monochromatic clj/s

(monochromatic color)

(monochromatic color count)

Generate monochromatic palette by varying lightness and saturation

muted? clj/s

(muted? color)

(muted? color threshold)

Check if a color is muted (low saturation)

name->hex clj/s

(name->hex color-name)

Convert color name to hex

normalize-css-color-string clj/s

(normalize-css-color-string css-str)

Normalize CSS color string by removing extra spaces and standardizing separators

normalize-hex clj/s

(normalize-hex hex)

Normalize hex color to 6 characters with #

oklab->hex clj/s

(oklab->hex oklab)

Convert Oklab coordinates [l a b] to a hex string. Clamps channels outside the sRGB gamut with clamp-rgb, then rounds each to 8 bits.

oklab->oklch clj/s

(oklab->oklch oklab)

Convert Oklab coordinates [l a b] to OKLCh [l c h], the polar form: l is unchanged, c is chroma (0 and up) and h is hue in degrees, from 0 up to 360. Colors with chroma below 1e-6 get hue 0; CSS calls that hue none. Returns unrounded values.

oklab->rgb clj/s

(oklab->rgb oklab)

Convert Oklab coordinates [l a b] to an sRGB vector [r g b] on the 0 to 255 scale. The inverse of rgb->oklab.

Returns unrounded floats and does not clamp. Colors outside the sRGB gamut produce channels below 0 or above 255; check with in-gamut?. ->hex and color round and clamp as usual.

The matrices are the exact inverses of the ones rgb->oklab uses, so (oklab->rgb (rgb->oklab rgb)) returns rgb to within float error. Checks the input shape with an assertion precondition.

oklch->hex clj/s

(oklch->hex oklch)

Convert OKLCh [l c h] to a hex string, clamping colors outside the sRGB gamut like oklab->hex.

oklch->oklab clj/s

(oklch->oklab oklch)

Convert OKLCh [l c h] to Oklab coordinates [l a b]. Hue is in degrees and wraps, so -30 and 330 give the same color. Chroma must not be negative.

oklch->rgb clj/s

(oklch->rgb oklch)

Convert OKLCh [l c h] to an sRGB vector on the 0 to 255 scale. Returns unrounded, unclamped channels, like oklab->rgb.

parse-css-color-components clj/s

(parse-css-color-components css-str)

Parse CSS rgb() or rgba() string into color component vector.

Takes a CSS color string and normalizes it internally before extracting the color components using regex matching. Handles various formatting variations including different spacing and case.

Args: css-str - A CSS color string in format: - 'rgb(r,g,b)' or 'rgb(r g b)' - 'rgba(r,g,b,a)' or 'rgba(r g b a)' - Case insensitive, flexible whitespace

Returns:

• For rgb(): [r g b] where r, g, b are integers 0-255
• For rgba(): [r g b a] where r, g, b are integers 0-255 and a is float 0.0-1.0
• nil if the string doesn't match expected format or values are out of range

Examples: (parse-css-color-components "rgb(255,0,0)") => [255 0 0] (parse-css-color-components "RGB( 255 , 0 , 0 )") => [255 0 0] (parse-css-color-components "rgba(255,0,0,0.5)") => [255 0 0 0.5] (parse-css-color-components "rgb(256,0,0)") => nil (out of range)

parse-css-rgb clj/s

(parse-css-rgb css-str)

Parse CSS rgb() string to RGB vector

parse-css-rgba clj/s

(parse-css-rgba css-str)

Parse CSS rgba() string to RGBA vector

parse-int clj/s

(parse-int s)

(parse-int s radix)

perceptually-similar? clj/s

(perceptually-similar? color1 color2)

(perceptually-similar? color1 color2 threshold)

Check if two colors are perceptually similar using Delta E. Default threshold of 2.3 is the JND (Just Noticeable Difference)

random-color clj/s

(random-color)

Generate a random color

rgb->hex clj/s

(rgb->hex rgb)

Convert RGB vector to hex string

rgb->hsl clj/s

(rgb->hsl rgb)

Convert RGB to HSL

rgb->hsv clj/s

(rgb->hsv rgb)

Convert RGB to HSV

rgb->kelvin clj/s

(rgb->kelvin rgb)

Approximate the correlated color temperature of an sRGB color in Kelvin.

Converts to CIE 1931 xy chromaticity and applies McCamy's formula, which is accurate to a few tens of kelvin from about 2000 K to 12500 K. Returns nil for black, for colors more than 0.05 from the black-body curve in CIE 1960 uv (Duv), and for results outside 1000 K to 40000 K. Saturated colors such as pure red have no meaningful temperature.

rgb->lab clj/s

(rgb->lab rgb)

Convert RGB to LAB color space (CIE Lab*)

rgb->oklab clj/s

(rgb->oklab rgb)

Convert an sRGB vector [r g b], with channels from 0 to 255, to Oklab. Returns [l a b] without rounding: l uses a 0-1 lightness scale; a runs from green (negative) to red (positive), and b from blue (negative) to yellow (positive). Linearizes sRGB before conversion. Checks valid-rgb? with an assertion precondition. Use ->rgb first for hex strings, CSS strings, or Color records. Formula taken from https://bottosson.github.io/posts/oklab/.

rgb->oklch clj/s

(rgb->oklch rgb)

Convert an sRGB vector [r g b], with channels from 0 to 255, to OKLCh [l c h]. See rgb->oklab and oklab->oklch.

rgba->hex clj/s

(rgba->hex rgba)

Convert RGBA vector to hex string (ignoring alpha)

round clj/s

(round n)

(round n decimals)

Round a number to specified decimal places. Returns an integer at 0 places and a double otherwise. Large values that have no fractional digit at the requested precision come back unchanged.

round-coords clj/s

(round-coords coords options)

Round each coordinate in coords for display and return a vector. Conversions such as rgb->oklab return full precision; round only the values you show or export.

options takes exactly one of:

• :decimal-places, an integer from 0 to 15
• :significant-digits, an integer from 1 to 17

Returns doubles, even at 0 decimal places; use round-int for integers. Ties round up, toward positive infinity, as Math/round does. Rounding works on the binary double, so 1.005 rounds to 1.0 at 2 places: the stored value is slightly below 1.005. Results match on the JVM and in JavaScript.

NaN and infinite values pass through unchanged. Throws ex-info for invalid options or non-numeric coordinates.

round-int clj/s

(round-int n)

saturate clj/s

(saturate color amount)

Increase saturation of a color by a percentage (0-1)

shade clj/s

(shade color amount)

Create a shade by mixing color with black (darkens while preserving hue)

shades clj/s

(shades color)

(shades color count)

Generate a series of shades (color mixed with black)

similar? clj/s

(similar? color1 color2)

(similar? color1 color2 threshold)

Check if two colors are similar within a threshold

split-complementary clj/s

(split-complementary color)

(split-complementary color angle)

Get split-complementary colors

temperature clj/s

(temperature color)

Get color temperature as a keyword

tetradic clj/s

(tetradic color)

Get tetradic colors (three colors that form a square on the color wheel)

theme->css-vars clj/s

(theme->css-vars theme)

(theme->css-vars theme options)

Convert an accessible-theme map to CSS custom properties.

By default variables use the --ct- prefix. Pass :prefix to override it.

tint clj/s

(tint color amount)

Create a tint by mixing color with white (lightens while preserving hue)

tints clj/s

(tints color)

(tints color count)

Generate a series of tints (color mixed with white)

tone clj/s

(tone color amount)

Create a tone by mixing color with gray (reduces saturation)

tones clj/s

(tones color)

(tones color count)

Generate a series of tones (color mixed with gray)

triadic clj/s

(triadic color)

Get triadic colors (two colors that form a triangle on the color wheel)

valid-css-rgb? clj/s

(valid-css-rgb? css-str)

Check if string is a valid CSS rgb() color

valid-css-rgba? clj/s

(valid-css-rgba? css-str)

Check if string is a valid CSS rgba() color

valid-hex? clj/s

(valid-hex? hex)

Check if string is a valid 3- or 6-digit hex color, with or without a leading #. Returns true or false.

valid-hsl? clj/s

(valid-hsl? hsl)

Check if vector is a valid HSL color

valid-hsv? clj/s

(valid-hsv? hsv)

Check if vector is a valid HSV color

valid-rgb? clj/s

(valid-rgb? rgb)

Check if vector is a valid RGB color

valid-rgba? clj/s

(valid-rgba? rgba)

Check if vector is a valid RGBA color

vibrant? clj/s

(vibrant? color)

(vibrant? color threshold)

Check if a color is vibrant (high saturation)

warm? clj/s

(warm? color)

Check if a color is warm (red/orange/yellow family)

with-alpha clj/s

(with-alpha color alpha)

Set alpha channel of a color