v2.0.0

2.0.0

This release replaces sharp with @napi-rs/image for all image work and adds AVIF as an output format. Some image options had no equivalent in the new library, so this is a major release. See Breaking changes and Migrating from 1.x below.

New

• AVIF output. convertImageBuffer, convertArchiveImages, and convertArchive accept 'avif' as a format. The new options.avif group supports:
  • quality (0 to 100, default 90; 100 is lossless)
  • alphaQuality (defaults to quality)
  • speed (1 to 10, default 4)
  • chromaSubsampling ('4:4:4' by default to keep colored line art sharp; '4:2:0' gives smaller files)
  • threads (encoder threads per image, default 0 for every core; pass 1 when converting several images at once with concurrency)
• AVIF pages are recognized as images. avif is now in IMAGE_EXTENSIONS, so AVIF pages work with image info, perceptual hashing, renaming, and later conversions.
• The benchmark includes AVIF. BENCHMARK_IMAGE_FORMATS is now webp, avif, png, jpg, so a default benchmarkArchive run produces 16 archives instead of 12. Use options.imageFormats (or --image-formats= in benchmark.js) to pick a subset.

Breaking changes

• sharp is no longer a dependency. Image decoding and encoding now use @napi-rs/image.
• setImageConcurrency has been removed. It set libvips threads per image, and the new library has no equivalent setting. Images still run on libuv's threadpool (4 threads by default), so raise UV_THREADPOOL_SIZE to convert more than 4 images at once.
• WebpOptions.effort and WebpOptions.smartSubsample have been removed. WebP encoding now takes only quality (default 92).
• Perceptual hashes have changed. computeImagePHash and computeArchiveImagePHash now resize and convert to grayscale with a different library, so their values will not exactly match hashes from 1.x. Recompute any stored hashes before comparing them against new ones.
• PNG compressionLevel maps to three levels. It still accepts 0 to 9, but 0 to 3 is fast, 4 to 6, and 7 to 9 is best. The default is 8.
• PNG palette quality works differently. With palette: true, quality is now the maximum quality for palette quantization (default 100). File sizes for the same setting will differ from 1.x.

Fixes

• pHash handles images with transparency. Pages with an alpha channel, 16-bit pages, and floating-point pages are now read correctly.

Migrating from 1.x

• Remove calls to setImageConcurrency. To run more than 4 images at once, set UV_THREADPOOL_SIZE before the process first uses the threadpool.
• Remove effort and smartSubsample from any webp options. TypeScript will flag them.
• If you store perceptual hashes, recompute them with 2.0.0.