CHANGELOG

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.1.2] 2026-02-24

• Fixed a typo (Chartesian --> Cartesian)
• Fixed a division bu zero in JzCzHz
• Improved a documentation comment

[0.1.1] 2026-02-22

Fixed

• Changed imports, to ensure correct bundling. This internal fix does not change the public interface.

[0.1.0] 2026-02-01

Added

• Core Architecture:

  • Base Color class with immutable operations and HDR/SDR support
  • ColorMeta singleton pattern for color space metadata and validation
  • ColorFactory for creating colors from strings, hex, CSS, and JSON
  • 28 color space implementations with XYZ as intermediate representation
  • Full TypeScript support with strict typing

• Color Spaces (28 total):

  • Standard Dynamic Range (SDR):
    • RGB (sRGB)
    • HSL (Hue-Saturation-Lightness)
    • HSV (Hue-Saturation-Value)
    • HWB (Hue-Whiteness-Blackness)
    • CMYK (Cyan-Magenta-Yellow-Black)
    • Lab (CIELAB)
    • Lch (CIELCH - polar Lab)
    • Luv (CIE)
    • LchUv (CIE Lch(uv))
    • OKLAB (modern perceptual)
    • OKLCH (polar OKLAB)
    • Rec.709 (BT.709)
    • P3 (Display P3)
  • High Dynamic Range (HDR):
    • Linear RGB (srgb-linear)
    • XYZ (D65)
    • XYZ D50
    • ICtCp (ITP / ITU-R BT.2100)
    • JzAzBz (HDR perceptual)
    • JzCzHz (polar JzAzBz)
    • Rec.2020 (BT.2020)
    • ProPhoto RGB (ROMM RGB)
    • ACEScg (ACES AP1)
    • Adobe RGB
  • Specialized:
    • LMS (V3 / Oklab)
    • Lms2006 (Stockman & Sharpe)
    • LmsCat02 (LMS CAT02 CIECAM02)
    • LmsHpe (LMS Hunt-Pointer-Estevez)
    • YCbCr (Rec.709)
    • YUV (PAL Analogue)
    • xyY (Chromaticity)

• Color Manipulation Functions:

  • AnalogFx: Simulates analog device color defects
    • chromaCrunch(), chromaShift(), signalGain(), tvTint()
  • Base: Base manipulation functions:
    • convert()
  • Brewer: ColorBrewer 2.0 palettes (diverging, qualitative, sequential)
    • diverging(), qualitative(), sequential()
  • ColorCorrection: Color space transformations and gamut management
    • balanceWhite(), balanceWhiteComponents()
    • isInsideGamut2D(), isInsideGamut3D()
    • mapGamut(), transform(), transformComponents()
  • ColorDifference: Delta E color difference metrics
    • deltaE76(), deltaE94(), deltaECmc(),deltaE2000(), deltaEITP()
    • deltaE76FromComponents(), deltaE94FromComponents(), deltaECmcFromComponents(), deltaE2000FromComponents(), deltaEITPFromComponents()
  • ColorScale: Mapping scales to colors:
    • diverging(), linear(), log(), power()
  • Css: CSS color string support
    • fromCssString(), isCssSupported(), toCssString()
  • Cvd: Color Vision Deficiency simulation
    • correct(), simulate(), simulateFrom()
    • Supports deuteranopia, protanopia, tritanopia, achromatopsia
  • DatViz: Data visualization color scales
    • sequential() with Viridis, Magma, Inferno, Turbo, Plasma
  • Extraction: Palette extraction from images
    • getVibrantTheme(), kMeansClustering(), medianCut()
  • Generator: Color generation utilities
    • cubehelix(), distinct(), gradient(), quantize(), scale(), spline()
  • Harmony: Color harmony generation
    • analogous(), complementary(), triadic(), splitComplementary(), tetradic()
  • Hex: RGB hex string support
    • fromRgbHexString(), toHex3String(), toHex4String(), toHex6String(), toHex8String()
    • toHex12String(), toHex16String(), isHexString()
  • Light: Lightness manipulation
    • balance(), lighten(), darken()
  • Palette: Tailwind CSS-style palette generation
    • build(), classic(), dynamic(), mix(), perceptual(), soft()
  • Saturation: Saturation manipulation
    • balance(), decrease(), increase(), toGrayscale()
  • Temperature: Color temperature
    • compute(), fromTemperature()
  • TintAndShade: Lightness manipulation
    • tint(), shade(), tone()
  • ToneMapper: HDR tone mapping
    • acesLuminance(), acesRgb(), agX(), map(), reinhard()
  • Wcag: Web Content Accessibility Guidelines
    • apcaContrast(), apcaFontRecommendations(), apcaRating()
    • contrast(), getBestContrastColor(), getMinFontSize(), isApcaReadable(), isDark(), isLight(),
    • isReadable(), relativeLuminance()

• Color Mappers:

  • AlphaMixer: Alpha blending operations
    • mix(), mixMultiple(), over()
  • Interpolation: Color interpolation
    • linear(), splineCatmullRom(), bezier(), gradient()
  • PorterDuffBlend: Porter-Duff compositing operations
    • sourceOver(), sourceAtop(), sourceIn(), sourceOut()
    • destinationOver(), destinationAtop(), destinationIn(), destinationOut()
    • xor(), clear()
  • W3cBlend: CSS blend modes
    • multiply(), screen(), overlay(), darken(), lighten()
    • colorDodge(), colorBurn(), hardLight(), softLight()
    • difference(), exclusion(), hue(), saturation(), color(), luminosity()

• Standard Color Collections:

  • CSS Colors: 140+ named CSS colors
  • X11 Colors: 500+ X11 color names
  • XKCD Colors: 954 colors from XKCD survey
  • Crayola Colors: 100+ Crayola crayon colors
  • RAL Colors: 200+ RAL industrial colors
  • NCS: Natural Color System (100+ colors)
  • ISCC-NBS: ISCC-NBS color system (200+ colors)
  • Resene: Resene paint colors (100+ colors)

• Utilities:

  • ColorMath: Mathematical operations
    • clip(), equals(), srgbToLinear(), linearToSrgb()
    • hslToRgb(), rgbToHsl(), degToRad(), radToDeg()
  • ColorMatrix3x3: 3x3 matrix operations
    • multiply(), inverse()
  • ColorMatrixConsts: Transformation matrices for color spaces
  • Constants: Mathematical and color constants
  • WhitePoints: CIE standard illuminants (D65, D50, A, C, D55, D75)
  • TypeAlias: Type definitions for color spaces and components
  • TypeUtils: Type utility functions

• Design Features:

  • Immutability: All operations return new instances
  • HDR Support: Full support for High Dynamic Range values
  • Tree-shakeable: Modular architecture for optimal bundle size
  • Dual Module Support: CommonJS and ES Modules
  • Cross-platform: Works in Node.js and browsers
  • Precision: Careful handling of floating-point math
  • Performance: Optimized conversions and minimal allocations

Changed

• Breaking Changes:
  • None (initial release)

Deprecated

• Deprecated APIs:
  • None

Removed

• Removed APIs:
  • None

Fixed

• Bug Fixes:
  • None (initial release)

Security

• Security Updates:
  • None