# What changed in @paper-design/shaders

> 25 changes in @paper-design/shaders 0.0 from its official release notes, upgrade guides and advisories: 7 breaking, 7 new APIs and options. Each one cited. Sources checked 2026-10-21. HTML: https://unstale.sh/npm/@paper-design/shaders/

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

## @paper-design/shaders 0.0

### Breaking changes

- The old colorFront parameter is replaced by the three-color scheme using colorShadow, colorPaper, and colorBack. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- The Paper Texture color scheme now uses colorShadow, colorPaper, and colorBack instead of colorFront and colorBack. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- The contrast parameter is removed; a similar effect can be achieved with the new color scheme and blending. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- The former folds pattern is now named crumples, with foldCount renamed crumpleCount. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- The fade parameter is removed; a similar effect can be achieved with angle. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- The former crumples pattern is now named wrinkles, with crumpleSize renamed wrinkleSize. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- The Lens Distortion noiseOffset parameter is now normalized and accepts values from 0 to 1. (0.0.80) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0080)

### New APIs and options

- Adds control over the direction the surface is lit from. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Adds an amount of image-to-paper blending. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Adds an option to cut the paper sheet to the image frame. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Adds control over how much the image bends with the paper surface. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- A new pattern adds straight vertical and horizontal fold lines, controlled by foldSizeX, foldSizeY, foldOffsetX, and foldOffsetY. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Adds an option to line the grain up into laid-paper stripes. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Adds control over the scale of the roughness grain. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)

### Performance

- Animated shaders no longer render twice per frame. (0.0.82) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0082)
- WebGL context attributes were cleaned up as part of performance optimizations in ShaderMount. (0.0.82) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0082)
- Rebuilt to assure better performance. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Rebuilt to assure better performance. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Performance improves for all shaders with a grain layer. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Rebuilt to assure better performance. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- Rebuilt to assure better performance. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)

### Behavior and default changes

- The alpha value of colorHighlight is now applied to highlights in Water. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- fiberSize has a new mapping. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)
- wrinkleSize has a new mapping. (0.0.81) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0081)

### Fixes and other changes

- The WebGL context is released when a shader is disposed. (0.0.82) — [release notes](https://github.com/paper-design/shaders/blob/71be01576e8402c62ac76386bb4a7c59092e24c7/CHANGELOG.md#version-0082)