npm / colorjs.io
colorjs.io
What changed in colorjs.io 0.6 to 0.7, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-19.
2 breaking16 new APIs and options3 behavior and defaults8 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli initcolorjs.io 0.728 changes
Breaking changes 2
Pre-built ESM bundles are removed; ESM exports point directly to files in src/.
Minified files are removed from the package, making minification a consumer concern.
New APIs and options 16
Adds an opt-in displaySpaces override for controlling display fallback.
Adds hueId so code can look up a polar space's hue coordinate from its definition.
Adds hueIndex so code can look up a polar space's hue coordinate from its definition.
Exposes transformation matrices through ColorSpace.M and allows matrices for RGB spaces to be supplied via the generic M option.
Adds a deltaE method based on the Helmlab model.
Adds the DisplayOptions interface.
Adds a general class for generating gamut-relative color spaces for a gamut and color space.
Adds the experimental Helmlab family of perceptual color spaces.
Adds HSL syntax for a wider-gamut space.
Adds matrix inversion to the math utilities.
Adds gamut-relative LCH spaces, where c = 1 is the most colorful in-gamut color at a given lightness and hue.
Adds gamut-relative OKLCH spaces, where c = 1 is the most colorful in-gamut color at a given lightness and hue.
Adds a gamut mapping method that traces a ray to the gamut boundary and determines the RGB gamut and linear space from the space object.
Adds a collapse option to serialize() and Color.toString() to disable collapsing hex colors.
Adds a matrix-solving utility.
The supports() API is now parameterizable.
Behavior and default changes 3
When a color is unsupported by the browser, display now chooses the closest supported ancestor space, preserving the color's gamut.
Updates the gamut surface threshold guidance: 1e-12 for better 64-bit resolution and 1e-6 for 32-bit values.
Avoids implied color space dependencies for procedural usage, so consumers no longer need to manage them manually.
Fixes and other changes 7
Fixed a regression that broke space accessors in bundlers.
Fixed
stepsusingdeltaEMethodinconsistently.Preserves a subclass's own fromBase method when options omit it, instead of overwriting the prototype method with undefined.
Serializes helmgenlch as color(--helmgenlch …), correcting its invalid prior serialization.
Adds the types field back to package.json.
Corrects premultiplied interpolation in polar spaces: hue is not premultiplied, zero alpha is not divided, and missing alpha is carried forward correctly.
Preserves a subclass's own toBase method when options omit it, instead of overwriting the prototype method with undefined.
colorjs.io 0.61 changes
Fixes and other changes 1
Moves DOM lib inclusion to the types definition file to fix a TypeScript issue.