Profile
Back to NewsBack
GitHub Trending 5 min
Reader Mode
colorjs/color-space: Open collection of color spaces

colorjs/color-space: Open collection of color spaces

10 hours ago

color-space test</a> npm</a> size</a>

the Ostwald hue circle at full color, shown continuously and in ten steps

Open collection of color spaces.

  • Verified formulas
  • Conventional ranges
  • JS / WASM / GLSL / LUT / ICC
Atlas →

Use

import space from 'color-space';

space.rgb.oklch(255, 128, 0); // → [0.732, 0.186, 53] — modern CSS space.slog3.rec2020(0.5, 0.5, 0.5); // camera log → UHD wide gamut space.rgb.xyz(300, -10, 0); // → [59.7, 30.6, 2.8] — out-of-range in, unclamped out

// batch space.rgb.oklch([255, 128, 0, 0, 255, 128]); // [0.732, 0.186, 53, 0.875, 0.234, 151]

// meta space.lab.range; // [[0, 100], [-125, 125], [-125, 125]]

Individual spaces:

import oklch from 'color-space/oklch.js';
oklch.rgb(0.65, 0.25, 180);          // matches CSS oklch(0.65 0.25 180)

Imports

  • color-space – All 168 interconnected spaces · 55 kB gzip
  • color-space/.js – One standalone space
  • color-space/lite – 27-space working set · 9 kB gzip
  • color-space/wasm – lite set as WASM · bare .wasm included
  • color-space/gl – GLSL/WGSL shader source
  • color-space/gl/hlsl · color-space/gl/msl – HLSL (DirectX, Unity, Unreal) and Metal, written by naga from the WGSL · await hlsl('rgb', 'oklch') · needs the optional peer naga-wasm (it declares Node ≥ 24.12; CI runs it on 22, where npm only warns)
  • color-space/lut – .cube LUTs for Resolve, Premiere, OBS, ffmpeg — verified vs ACES
  • color-space/icc – Matrix + TRC or CLUT profiles
  • color-space/data.json – Channels, ranges, provenance, references, graph, gamuts
  • npx color-space rgb oklch 255 128 0 – CLI, no install: convert (default) · cube · icc · space · spaces · mcp (MCP server for agents)
Upgrading from v2?

Agents

MCP tools – convert · gamut · css · space · spaces · cube – so agents call verified math instead of guessing it.

claude mcp add color-space -- npx -y color-space mcp                                      # Claude Code
code --add-mcp '{"name":"color-space","command":"npx","args":["-y","color-space","mcp"]}'  # VS Code

Claude Desktop claude_desktop_config.json, any project .mcp.json:

{ "mcpServers": { "color-space": { "command": "npx", "args": ["-y", "color-space", "mcp"] } } }

Spaces

Display & web
sRGB · Display P3 · Rec. 2020 · Linear-light sRGB · Rec. 709 · ProPhoto RGB · Adobe RGB (1998) · DCI-P3 · Linear Display P3 · Linear Rec. 2020 · Linear Adobe RGB (1998) · Linear ProPhoto RGB · scRGB · RIMM RGB · CIE RGB · NTSC RGB (1953) · PAL / SECAM RGB · Apple RGB · SMPTE-240M

RGB remixes
HSL · HSV / HSB · HWB · HSI · HCG · HCL · HSP · HCY · HSM

Perceptual
OKLCH · CIELAB · CAM16 · OKLab · HCT · Okhsl · Okhsv · Okhwb · OKLrAB · OKLrCH · SRLAB2 · proLab · sUCS · IgPgTg · Jzazbz · JzCzHz · IPT · Izazbz · hdr-IPT · CIELChab · CIELUV · HSLuv · CIELChuv · CIELAB D65 · CIELCh D65 · HPLuv · DIN99o Lab · DIN99o LCh · DIN99d · Hunter Lab · CIE 1960 UCS · CIE 1964 UVW · Adams–Nickerson Lab · hdr-CIELAB · CIECAM02 · CAM16-UCS · ZCAM · CAM02-UCS · CAM16-LCD · CAM16-SCD · CAM02-LCD · CAM02-SCD · Hellwig 2022 · RLAB · LLAB · Nayatani 95 · Hunt · ATD95

Colorimetry & research
CIE XYZ (D65) · CIE xyY · LMS · CIE XYZ (D50) · CIE 1976 u′v′ · CCT + Duv · Color temperature (Kelvin) · Maxwell triangle · Wavelength · Absolute XYZ D65 · MacLeod–Boynton · DKL · Grayscale · Dominant wavelength / DSH · rg chromaticity · Yrg (Kirk 2019) · XYB · OSA-UCS · TSL · YES · Ohta I₁I₂I₃ · lαβ

Video & broadcast
BT.709 Y′CbCr · ICtCp · BT.2020 Y′CbCr · BT.601 525-line Y′CbCr · BT.601 625-line Y′CbCr · YCbCr (parameterized) · YUV · YIQ · YPbPr · YCgCo · JPEG YCbCr · YDbDr · YcCbcCrc · xvYCC · SMPTE-C · PhotoYCC · Rec. 2100 PQ · Rec. 2100 HLG · Linear Rec. 2100 · ICaCb

Film & camera
ACEScg · ARRI LogC3 · ACEScc · Sony S-Log3 · Sony S-Gamut3.Cine · ACES2065-1 · ACEScct · ARRI LogC4 · Cineon · DaVinci Wide Gamut / Intermediate · Sony S-Log2 · Panasonic V-Log · RED Log3G10 · Canon Log · Canon Log 2 · Canon Log 3 · Fujifilm F-Log · Fujifilm F-Log2 · Fujifilm F-Log2 C · Nikon N-Log · Apple Log · Apple Log 2 · Blackmagic Film Gen 5 · DJI D-Log · FilmLight T-Log / E-Gamut · Kinefinity KineLOG3 · DCDM X′Y′Z′ · Sony S-Log · ACESproxy · ERIMM RGB · Leica L-Log · GoPro Protune · GoPro GP-Log2 · Insta360 I-Log · Xiaomi Mi-Log · OPPO O-Log · Samsung Log · REDLog · REDLogFilm · RED Log3G12 · Panalog · ViperLog · Filmic Pro 6

Print & paint
CMYK · Munsell · RYB · CMY · RAL Design · Coloroid · Ostwald

Motivation

A complete collection of color spaces: one minimal API, verified formulas. While alternatives focus on digital color spaces, this project takes broader perspective, covering historical and cross-disciplinary spaces as well. Side effects: corrected papers, color education, test cases for JS→WASM compilers (porffor, jz).

It is not a color toolbox — parsing, interpolation, ΔE, gamut mapping, contrast, palettes, alpha stay out. Pantone, NCS, RAL Classic, and similar licensed swatch catalogs aren't open and stay out as well.

Credits

Thanks to the researchers, theorists, specifiers, implementors and the libraries that helped this one happen.

| Library | Spaces | Ranges | Camera log · CAM · historic | Backends | Speed (M op/s)¹ | |---|---:|---|---|---|---:| | color-space | 168 | Conventional | ✅ | JS · WASM · GLSL/WGSL · LUT · ICC | 5.52 | | color-space/lite | 27 | Conventional | logs · HDR | JS · 9 kB gzip | 3.01 ² | | color-space/wasm | 27 | Conventional | logs · HDR | WASM | 1.38–4.78× JS batches ³ | | culori | 30 | 0–1 | ❌ | JS | 4.46 | | colorjs.io | ~40 | 0–1 | some | JS | 0.23 | | texel/color | ~16 | 0–1 | ❌ | JS | 3.49 ² | | chroma-js | ~12 | mixed | ❌ | JS | 1.19 ² | | d3-color | 6 | mixed | ❌ | JS | 9.35 ² |

¹ geometric mean, million scalar calls per second over the 7 shared npm run benchmark conversions (rgb ⇄ lab · hsl · oklab, rgb → p3), inputs rotating through a 256-color table; median of 3 runs on 2026-10-03 as the benchmark prints it, Node 22.22 / Intel Xeon 2.1 GHz (4 vCPU), culori 4.0.2 · colorjs.io 0.5.2 · @texel/color 1.1.11 · chroma-js 3.2.0 · d3-color 3.1.0. Absolute figures move with the machine; the ratios are the claim · ² measured on the subset it implements — color-space on the same subset: lite's 4 (lab, oklab) 3.09 · texel's 3 (oklab, p3) 2.76 · chroma-js's 6 6.45 · d3-color's 4 (lab, hsl) 9.28 · ³ WASM speedup over the JS batch API, rgb → each of its 26 targets over 1M pixels, per-target medians of 3 further runs the same day (lowest on Jzazbz and JzCzHz)

CC0 · ॐ

Chat with me