Sharp Changelog

Overview

This is the complete changelog for the Sharp image processing library, documenting all important changes from v0.10 to the latest version, including new features, bug fixes, performance improvements, and breaking changes.

v0.34 - hat

需要 libvips v8.17.1

v0.34.3 - July 10, 2025

• 升级到 libvips v8.17.1 以修复上游错误。
• Add "Magic Kernel Sharp" (unrelated) to resize kernels.
• Deprecate top-level, format-specific constructor parameters, such as subifd becoming tiff.subifd.
• Expose stylesheet and highBitdepth SVG input parameters.
• Expose keepDuplicateFrames GIF output parameters.
• Add support for RAW digital camera image input. Requires libvips to support libraw.
• Provide XMP metadata as strings and Buffers where possible.
• Add pageHeight option to create and raw input for animated images.
• Expose JPEG 2000 oneshot decoder option.
• Support composite operations for non-sRGB pipeline color spaces.
• Add keepXmp and withXmp for controlling output XMP metadata.

v0.34.2 - May 20, 2025

• Ensure animation GIF to WebP conversion preserves loop (regression in 0.34.0).
• Ensure pdfBackground constructor property is used.
• Add experimental support for pre-built Windows ARM64 binaries.
• Ensure fit resize with contain supports multiple alpha channels.
• TypeScript: Ensure metadata response is closer to reality.
• TypeScript: Ensure smartDeblock property is included in WebP definition.
• Ensure support for wide character file names on Windows (regression in 0.34.0).

v0.34.1 - April 7, 2025

• TypeScript: Ensure new autoOrient property is optional.

v0.34.0 - April 4, 2025

• Breaking change: Support input image arrays to be connected or animated.
• Breaking change: Ensure removeAlpha removes all alpha channels.
• Breaking change: Non-animated GIF output defaults to no loop instead of permanent loop.
• Breaking change: Support info.size on wide character systems by upgrading to C++17.
• Breaking change: Ensure background metadata can be parsed by color package.
• Add isPalette and bitsPerSample to metadata, deprecate paletteBitDepth.
• Expose WebP smartDeblock output option.
• Prevent use of linux-x64 binaries with v1 microarchitecture.
• Add autoOrient operation and constructor options.
• TypeScript：确保通道计数使用正确的范围。
• Improve support for ppc64le architecture.
• Add pdfBackground constructor property.
• Expose erode and dilate operations.
• Add support for RGBE images. Requires libvips to support radiance.
• Allow output of wide color gamut HEIF at higher bit depths.

v0.33 - gauge

Requires libvips v8.15.3

v0.33.5 - August 16, 2024

• Upgrade to libvips v8.15.3 to fix upstream errors.
• Add pageHeight and pages to multi-page output response.
• Ensure options for globally installed libvips work correctly.
• Minimize use of engines property to improve yarn v1 support.
• Ensure sharp.format.heif only includes AVIF when using pre-built binaries.
• Add support for 4x4 matrix in recomb operation.
• Expose PNG text blocks as comments metadata.
• Expose optional precision and minAmplitude parameters for blur operation.
• Ensure keepIccProfile avoids color conversion where possible.
• TypeScript: chromaSubsampling metadata is optional.

v0.33.4 - May 16, 2024

• Remove experimental status of pipelineColourspace.
• Reduce default concurrency when musl thread oversubscription is detected.
• TypeScript: Add missing OverlayOptions definition.
• Installation: Add advanced option to force use of globally installed libvips.
• Expose bilinear resize kernel (and interpolator).
• Ensure extend operation maintains order for multi-page TIFF (regression in 0.32.0).
• Tighten validation of integer properties in constructor text.
• Simplify internal StaySequential logic.
• Ensure negation operation occurs after configuration file conversion.

v0.33.3 - March 23, 2024

• Upgrade to libvips v8.15.2 to fix upstream errors.
• Ensure keepIccProfile preserves P3 and CMK input profiles.
• Ensure text.wrap property accepts word-char as a value.
• Ensure clone performs deep copy of existing options.
• Add bitdepth option for heif output (pre-built binaries only support 8-bit).

v0.33.2 - January 12, 2024

• Upgrade to libvips v8.15.1 to fix upstream errors.
• TypeScript: Add keepMetadata definition.
• Ensure extend operation maintains order when copying (regression in 0.32.0).
• Improve error handling for unsupported multi-page rotation.

v0.33.1 - 2023年12月17日

• Add support for Yarn Plug'n'Play file system layout.
• Warn when attempting to use invalid ICC configuration files.
• Ensure respect for VIPS_NOVECTOR environment variable.

v0.33.0 - 2023年11月29日

• Drop support for Node.js 14 and 16, now requires Node.js ^18.17.0 or >= 20.3.0
• Pre-built binaries distributed through npm registry and installable via package manager.
• From source code build requires node-addon-api.
• Remove sharp.vendor.
• Partially deprecate withMetadata(), use withExif() and withIccProfile().
• Add experimental support for WebAssembly runtime.
• Make trim operation's options must be an object, add new lineArt option.
• Use weighted functions to improve brightness of tint operation.
• Ensure all Error objects contain stack property.
• Make compression option for heif required to help reduce HEIF vs HEIC confusion.
• Ensure correct interpretation of 16-bit raw input.
• Add support for miniswhite when using TIFF output.
• TypeScript: Add missing withMetadata boolean definition.
• Add more fine-grained control over output metadata.
• Ensure multi-page extraction maintains order.

v0.32 - flow

Requires libvips v8.14.5

v0.32.6 - September 18, 2023

• Upgrade to libvips v8.14.5 to fix upstream errors.
• Ensure tiled compositing images are fully decoded (regression in 0.32.0).
• Ensure withMetadata can add ICC configuration files to RGB16 output.
• Ensure withMetadata does not reduce 16-bit images to 8-bit (regression in 0.32.5).
• TypeScript: Add definitions for block and unblock.

v0.32.5 - August 15, 2023

• Upgrade to libvips v8.14.4 to fix upstream errors.
• TypeScript: Add missing WebpPresetEnum definition.
• Ensure compilation using musl v1.2.4.
• Ensure fit resize respects 90/270 degree rotation when using inside.
• TypeScript: Ensure WebpOptions's minSize property is a boolean.
• Ensure withMetadata adds default sRGB configuration file.

v0.32.4 - July 21, 2023

• Upgrade to libvips v8.14.3 to fix upstream errors.
• Expose ability to block low-level libvips operations by name.
• Pre-built binaries: restore support for tiled output.

早期版本

v0.31 - eagle

Requires libvips v8.13.3

v0.30 - dresser

Requires libvips v8.12.2

v0.29 - circle

Requires libvips v8.11.4

v0.28 - bijou

Requires libvips v8.10.6

v0.27 - avif

Requires libvips v8.9.2

v0.26 - zoom

Requires libvips v8.8.3

v0.25 - yield

Requires libvips v8.7.4

v0.24 - "wit"

Requires libvips v8.6.3

v0.23 - "vision"

Requires libvips v8.5.2

v0.22 - "uptake"

Requires libvips v8.4.5

v0.21 - "teeth"

Requires libvips v8.3.3

v0.20 - "prebuild"

Requires libvips v8.2.2

v0.19 - "suit"

Requires libvips v8.1.2

v0.18 - "ridge"

Requires libvips v8.0.2

v0.17 - "quill"

Requires libvips v7.1.0

v0.16 - "pencil"

Requires libvips v7.0.0

v0.15 - "outfit"

Requires libvips v6.1.0

v0.14 - "needle"

Requires libvips v6.0.0

v0.13 - "mind"

Requires libvips v5.0.0

v0.12 - "look"

Requires libvips v4.0.0

v0.11 - "knife"

Requires libvips v3.0.0

v0.10 - "judgment"

Requires libvips v2.0.0

---

This changelog records all important changes from Sharp library from v0.10 to the latest version, including new features, bug fixes, performance improvements, and breaking changes.