Fix unloaded HTMLImageElement uniforms

[teeverc]

Summary

Wait for HTMLImageElement uniforms to finish decoding before passing them to the vanilla ShaderMount.

Fixes race condition: Uncaught (in promise) Error: Paper Shaders: image for uniform u_noiseTexture must be fully loaded for cache miss.

Problem

Some shaders create image uniforms internally, such as the embedded u_noiseTexture. processUniforms currently passes these images through immediately, even if they have not finished loading.

On a cold page load, WebGL can therefore receive an image with a zero naturalWidth and throw:

Paper Shaders: image for uniform u_noiseTexture must be fully loaded

Change

Use HTMLImageElement.decode() and add its promise to the existing imageLoadPromises collection. This uses the same waiting mechanism already used for string image uniforms.

This is a follow-up to #244 and #253.

Verification

• bun run build
• bun run --filter @paper-design/shaders-react type-check
• Verified against a GrainGradient cold-load failure in a React application

[vercel]

@teeverc is attempting to deploy a commit to the Paper Design Team on Vercel.

A member of the Team first needs to authorize it.

[vercel]

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

Project	Deployment	Actions	Updated (UTC)
shaders-docs	Ready	Preview, Comment	Jul 12, 2026 4:30am

[itsdouges]

thanks, looks good.