Paper texture 2.0

[uuuulala]

Note

High Risk
Breaking public API and visual output for PaperTexture consumers; large shader change needs regression on image filter paths and presets. The unreferenced paper-texture---.ts scratch file should be confirmed intentional or removed before merge.

Overview
Paper Texture 2.0 replaces the previous paper effect with a new shader, public API, presets, and docs controls.

The color model moves from colorFront / colorBack + contrast to colorBack, colorPaper, and colorShadow, with image controls blending, distortion, and clip. Surface detail params change: crumpleCount (capped via exported paperTextureMeta.maxCrumpleCount), wrinkles / wrinkleSize, roughnessSize / roughnessRows, directional angle lighting, and per-axis folds foldSizeX/Y and foldOffsetX/Y. Removed uniforms include fade, crumpleSize, and foldCount.

The fragment shader is rewritten around relief lighting, new crumple/wrinkle/fold math, and updated image compositing (u_isImage). React PaperTexture maps the new props; deprecated aliases shrink to foldsNumber → crumpleCount (and fiberScale). Presets are now Default, Spread, Creased, and Flat (replacing Abstract, Cardboard, Details).

Docs Leva panel and paperTextureDef mirror the new parameter set.

^{Reviewed by Cursor Bugbot for commit 55a3ef1. Bugbot is set up for automated code reviews on this repo. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
shaders-docs	Ready	Preview	Sep 1, 2026 3:17pm UTC

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

There are 6 total unresolved issues (including 5 from previous reviews).

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 127f8e3. Configure here.}