Skip to content

Replace Jimp#1152

Draft
wswebcreation wants to merge 4 commits into
ws/investigate-flakinessfrom
ws/replace-jimp
Draft

Replace Jimp#1152
wswebcreation wants to merge 4 commits into
ws/investigate-flakinessfrom
ws/replace-jimp

Conversation

@wswebcreation
Copy link
Copy Markdown
Member

Why

jimp is no longer actively maintained, t has seen no releases in over a year and shows minimal PR/issue activity. It was originally chosen to avoid the system-level install requirements of node-canvas (GTK, Cairo, etc.), but it now carries its own maintenance risk.

This PR replaces jimp with an approach that keeps the same guarantee, no binary dependencies, no OS-level installs, pure JavaScript, while using actively maintained libraries. The image codec is replaced by fast-png (v8.0.0, maintained by the image-js / Zakodium org), and all image manipulation operations are implemented as a small in-house utility module that operates directly on raw RGBA pixel buffers.

User impact

There are no intentional behaviour changes for end users. The visual comparison results, blockout regions, full-page screenshot assembly, and device rotation handling all operate identically. The compareEngine the is introduced in the branch we are going merge this in will be removed. We believe that we can merge this as a major release without too much impact for users.

Baseline compatibility

This PR is being validated against baselines that were originally generated with jimp to confirm that the pixel-level output of the new implementation is identical. Any regression there would indicate a bug in the pure-JS pixel operations (crop, composite, rotate, resize) that needs to be addressed before merging.

@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Jun 3, 2026

⚠️ No Changeset found

Latest commit: 069f8ea

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant