npm / @paper-design/shaders
@paper-design/shaders
What changed in @paper-design/shaders 0.0, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-21.
7 breaking7 new APIs and options7 performance3 behavior and defaults1 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@paper-design/shaders 0.025 changes
Breaking changes 7
The old colorFront parameter is replaced by the three-color scheme using colorShadow, colorPaper, and colorBack.
The Paper Texture color scheme now uses colorShadow, colorPaper, and colorBack instead of colorFront and colorBack.
The contrast parameter is removed; a similar effect can be achieved with the new color scheme and blending.
The former folds pattern is now named crumples, with foldCount renamed crumpleCount.
The fade parameter is removed; a similar effect can be achieved with angle.
The former crumples pattern is now named wrinkles, with crumpleSize renamed wrinkleSize.
The Lens Distortion noiseOffset parameter is now normalized and accepts values from 0 to 1.
New APIs and options 7
Adds control over the direction the surface is lit from.
Adds an amount of image-to-paper blending.
Adds an option to cut the paper sheet to the image frame.
Adds control over how much the image bends with the paper surface.
A new pattern adds straight vertical and horizontal fold lines, controlled by foldSizeX, foldSizeY, foldOffsetX, and foldOffsetY.
Adds an option to line the grain up into laid-paper stripes.
Adds control over the scale of the roughness grain.
Performance 7
Animated shaders no longer render twice per frame.
WebGL context attributes were cleaned up as part of performance optimizations in ShaderMount.
Rebuilt to assure better performance.
Rebuilt to assure better performance.
Performance improves for all shaders with a grain layer.
Rebuilt to assure better performance.
Rebuilt to assure better performance.
Behavior and default changes 3
The alpha value of colorHighlight is now applied to highlights in Water.
fiberSize has a new mapping.
wrinkleSize has a new mapping.
Fixes and other changes 1
The WebGL context is released when a shader is disposed.