jon.color-tools — com.github.jramosg/color-tools 1.2.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 WCAG AA accessibility standards

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

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 contrast ratio between two colors

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

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 #

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 color temperature in Kelvin from RGB. This is an approximation and works best for colors close to the Planckian locus. Returns nil if the color is too far from the black body curve.

rgb->lab clj/s

(rgb->lab rgb)

Convert RGB to LAB color space (CIE Lab*)

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

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 hex color

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