Liking cljdoc? Tell your friends :D

Change Log

All notable changes to this project will be documented in this file. This change log follows the conventions of keepachangelog.com.

Unreleased

Improved the Accessible Theme Generator demo layout for clearer token, contrast, and color scale previews
Expanded cljdoc documentation for accessible theme generation, CSS variable export, public API coverage, and workflow examples

Accessible Theme Generator: Generate production-ready UI color tokens from a single brand color
- accessible-theme - Builds light or dark theme tokens with WCAG-aware foreground colors, semantic roles, focus ring, border, and color scale
- theme->css-vars - Exports generated theme tokens as CSS custom properties for direct frontend use
Demo Theme Generator: Interactive demo panel for previewing generated accessible themes, contrast pairs, color scales, and CSS variable export
cljdoc support: Added explicit cljdoc article ordering, Clojure and ClojureScript language metadata, and a README badge

Replaced optional destructuring arities with explicit multi-arity definitions while preserving existing call behavior

Color Blending Modes: Professional blending operations for design workflows
- blend-multiply - Multiply blend mode (darkens)
- blend-screen - Screen blend mode (lightens)
- blend-overlay - Overlay blend mode (combines multiply and screen)
Tints, Shades, and Tones: Essential design system utilities
- tint - Mix color with white (lightens while preserving hue)
- shade - Mix color with black (darkens while preserving hue)
- tone - Mix color with gray (reduces saturation)
- tints, shades, tones - Generate series of variations
Alpha Blending and Compositing: Proper transparency support
- alpha-blend - Porter-Duff alpha compositing
- with-alpha - Set alpha channel of any color
Color Interpolation: Smooth color transitions
- interpolate - Interpolate between multiple colors in RGB, HSL, or HSV space
- gradient - Generate gradients with n steps between colors
- Supports hue wrapping for natural color transitions
Perceptual Color Difference: More accurate color comparison
- rgb->lab - Convert to CIE L*A*B* color space
- delta-e - Calculate perceptual difference using CIE76 Delta E formula
- perceptually-similar? - Check similarity using JND (Just Noticeable Difference)
Color Temperature (Kelvin): Physical light color representation
- kelvin->rgb, kelvin->hex, kelvin->color - Convert temperature to color
- rgb->kelvin - Approximate color temperature from RGB
- Supports 1000K-40000K range using Tanner Helland's algorithm

Better Color Science: Added LAB color space for perceptually uniform calculations
Enhanced Documentation: Comprehensive examples and usage patterns for new features
Test Coverage: Extensive tests for all new blending, interpolation, and temperature functions

CSS Color String Support: Full support for CSS rgb() and rgba() color strings
- valid-css-rgb? and valid-css-rgba? validation functions
- parse-css-rgb and parse-css-rgba parsing functions
- normalize-css-color-string for flexible formatting support
Flexible CSS Format Support: Accepts various CSS color string formats:
- Comma-separated: "rgb(255, 0, 0)", "rgba(255, 0, 0, 0.5)"
- Space-separated: "rgb(255 0 0)", "rgba(255 0 0 0.5)"
- Case-insensitive: "RGB(255, 0, 0)", "RGBA(255, 0, 0, 1)"
- Flexible whitespace: "rgb( 255 , 0 , 0 )", "rgba( 255 0 0 0.8 )"
- Decimal alpha values: "rgba(255, 0, 0, .5)"
Enhanced Color Input Handling: CSS color strings now work seamlessly with all library functions
- Color factory function: (color "rgb(255, 0, 0)")
- Universal conversion functions: (->rgb "rgba(255, 0, 0, 0.8)")
- Color manipulation: (lighten "rgb(255, 0, 0)" 0.2)
- All accessibility, analysis, and harmony functions
Enhanced Color Factory: color function now accepts any color input type, including existing Color records
Universal Color Name Function: New ->name function that finds closest color names from any color input type
Unified Color Input Handling: Internal normalize-color-input function provides consistent color type handling across all functions
Comprehensive Test Coverage: Extensive tests for all CSS color string formats and edge cases

Cross-platform Parsing: Added parse-float utility for consistent number parsing
Better Error Messages: Enhanced error reporting for invalid color string formats
Input Validation: Stricter validation of CSS color string formats with helpful error messages
Simplified API: All color manipulation functions now work seamlessly with any color input type
Code Consistency: Refactored internal implementations to use unified color handling
Better Type Safety: Enhanced validation and error handling for color inputs
Performance: Reduced conditional logic through unified color processing

Initial release of jon/color-tools library
Color Format Conversions: Support for HEX, RGB, RGBA, HSL, and HSV format conversions
- hex->rgb, rgb->hex, hex->rgba, rgba->hex
- rgb->hsl, hsl->rgb, hex->hsl, hsl->hex
- rgb->hsv, hsv->rgb
Color Validation: Validation functions for all supported color formats
- valid-hex?, valid-rgb?, valid-rgba?, valid-hsl?
Color Manipulation: Comprehensive color adjustment functions
- lighten, darken, saturate, desaturate
- adjust-hue, invert, grayscale
Color Mixing and Blending:
- mix - blend two colors with configurable ratio
Accessibility and Contrast:
- luminance, contrast-ratio, accessible?
- find-accessible-color - automatically find WCAG-compliant colors
Color Harmony and Palettes:
- complementary, triadic, tetradic, analogous
- monochromatic, split-complementary
- generate-palette with multiple strategies
Color Analysis:
- brightness, dark?, light?, vibrant?, muted?
- warm?, cool?, temperature
- color-distance, similar?
Color Names: Built-in color name dictionary with conversion utilities
- name->hex, hex->name
Cross-platform Support: Works in both Clojure (JVM) and ClojureScript
Comprehensive Test Suite: Extensive test coverage for all functionality

Can you improve this documentation?Edit on GitHub

cljdoc builds & hosts documentation for Clojure/Script libraries

Keyboard shortcuts