# What changed in colorjs.io

> 29 changes in colorjs.io 0.6 to 0.7 from its official release notes, upgrade guides and advisories: 2 breaking, 16 new APIs and options. Each one cited. Sources checked 2026-10-19. HTML: https://unstale.sh/npm/colorjs.io/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## colorjs.io 0.7

### Breaking changes

- Pre-built ESM bundles are removed; ESM exports point directly to files in src/. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Minified files are removed from the package, making minification a consumer concern. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)

### New APIs and options

- Adds an opt-in displaySpaces override for controlling display fallback. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds hueId so code can look up a polar space's hue coordinate from its definition. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds hueIndex so code can look up a polar space's hue coordinate from its definition. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Exposes transformation matrices through ColorSpace.M and allows matrices for RGB spaces to be supplied via the generic M option. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds a deltaE method based on the Helmlab model. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds the DisplayOptions interface. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds a general class for generating gamut-relative color spaces for a gamut and color space. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds the experimental Helmlab family of perceptual color spaces. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds HSL syntax for a wider-gamut space. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds matrix inversion to the math utilities. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds gamut-relative LCH spaces, where c = 1 is the most colorful in-gamut color at a given lightness and hue. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds gamut-relative OKLCH spaces, where c = 1 is the most colorful in-gamut color at a given lightness and hue. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- 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. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds a collapse option to serialize() and Color.toString() to disable collapsing hex colors. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds a matrix-solving utility. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- The supports() API is now parameterizable. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)

### Behavior and default changes

- When a color is unsupported by the browser, display now chooses the closest supported ancestor space, preserving the color's gamut. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Updates the gamut surface threshold guidance: 1e-12 for better 64-bit resolution and 1e-6 for 32-bit values. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Avoids implied color space dependencies for procedural usage, so consumers no longer need to manage them manually. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)

### Fixes and other changes

- Fixed a regression that broke space accessors in bundlers. (0.7.1) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.1)
- Fixed `steps` using `deltaEMethod` inconsistently. (0.7.1) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.1)
- Preserves a subclass's own fromBase method when options omit it, instead of overwriting the prototype method with undefined. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Serializes helmgenlch as color(--helmgenlch …), correcting its invalid prior serialization. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Adds the types field back to package.json. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Corrects premultiplied interpolation in polar spaces: hue is not premultiplied, zero alpha is not divided, and missing alpha is carried forward correctly. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)
- Preserves a subclass's own toBase method when options omit it, instead of overwriting the prototype method with undefined. (0.7.0) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.7.0)

## colorjs.io 0.6

### Fixes and other changes

- Moves DOM lib inclusion to the types definition file to fix a TypeScript issue. (0.6.1) — [release notes](https://github.com/color-js/color.js/releases/tag/v0.6.1)