Release v0.34.2

This also ensures we handle scRGB correctly, see:
e9c5a31552

docs/astro.config.mjs

@@ -70,10 +70,10 @@ export default defineConfig({
         { label: 'Performance', slug: 'performance' },
         { label: 'Changelog', slug: 'changelog' }
       ],
-      social: {
-        openCollective: 'https://opencollective.com/libvips',
-        github: 'https://github.com/lovell/sharp'
-      }
+      social: [
+        { icon: 'openCollective', label: 'Open Collective', href: 'https://opencollective.com/libvips' },
+        { icon: 'github', label: 'GitHub', href: 'https://github.com/lovell/sharp' }
+      ]
     })
   ]
 });

docs/package.json

@@ -11,7 +11,7 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.32.3",
-    "astro": "^5.5.3"
+    "@astrojs/starlight": "^0.34.3",
+    "astro": "^5.7.13"
   }
 }

docs/src/content/docs/api-output.md

@@ -626,6 +626,9 @@ Use these AVIF options for output image.
 AVIF image sequences are not supported.
 Prebuilt binaries support a bitdepth of 8 only.
 
+This feature is experimental on the Windows ARM64 platform
+and requires a CPU with ARM64v8.4 or later.
+
 
 **Throws**:
 

docs/src/content/docs/changelog.md

@@ -6,15 +6,16 @@ title: Changelog
 
 Requires libvips v8.16.1
 
-### v0.34.2 - TBD
+### v0.34.2 - 20th May 2025
 
 * Ensure animated GIF to WebP conversion retains loop (regression in 0.34.0).
   [#3394](https://github.com/lovell/sharp/issues/3394)
 
 * Ensure `pdfBackground` constructor property is used.
   [#4207](https://github.com/lovell/sharp/pull/4207)
+  [#4398](https://github.com/lovell/sharp/issues/4398)
 
-* Add support for prebuilt Windows ARM64 binaries.
+* Add experimental support for prebuilt Windows ARM64 binaries.
   [#4375](https://github.com/lovell/sharp/pull/4375)
   [@hans00](https://github.com/hans00)
 

docs/src/content/docs/install.md

@@ -21,7 +21,7 @@ pnpm add sharp
 ```
 
 When using `pnpm`, you may need to add `sharp` to
-[ignoredBuiltDependencies](https://pnpm.io/package_json#pnpmignoredbuiltdependencies)
+[ignoredBuiltDependencies](https://pnpm.io/settings#ignoredbuiltdependencies)
 to silence warnings.
 
 ```sh
@@ -53,7 +53,7 @@ Ready-compiled sharp and libvips binaries are provided for use on the most commo
 * Linux x64 (glibc >= 2.26, musl >= 1.2.2, CPU with SSE4.2)
 * Windows x64
 * Windows x86
-* Windows ARM64
+* Windows ARM64 (experimental, CPU with ARMv8.4 required for all features)
 
 This provides support for the
 JPEG, PNG, WebP, AVIF (limited to 8-bit depth), TIFF, GIF and SVG (input) image formats.
@@ -94,7 +94,7 @@ Use the [supportedArchitectures](https://yarnpkg.com/configuration/yarnrc#suppor
 
 ### pnpm v8+
 
-Use the [supportedArchitectures](https://pnpm.io/package_json#pnpmsupportedarchitectures) configuration.
+Use the [supportedArchitectures](https://pnpm.io/settings#supportedarchitectures) configuration.
 
 ## Custom libvips
 
@@ -134,7 +134,7 @@ npm install --save node-addon-api node-gyp
 ```
 
 When using `pnpm`, you may need to add `sharp` to
-[onlyBuiltDependencies](https://pnpm.io/package_json#pnpmonlybuiltdependencies)
+[onlyBuiltDependencies](https://pnpm.io/settings#onlybuiltdependencies)
 to ensure the installation script can be run.
 
 For cross-compiling, the `--platform`, `--arch` and `--libc` npm flags

lib/output.js

@@ -1019,6 +1019,9 @@ function tiff (options) {
  * AVIF image sequences are not supported.
  * Prebuilt binaries support a bitdepth of 8 only.
  *
+ * This feature is experimental on the Windows ARM64 platform
+ * and requires a CPU with ARM64v8.4 or later.
+ *
  * @example
  * const data = await sharp(input)
  *   .avif({ effort: 2 })

npm/darwin-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-darwin-arm64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with macOS 64-bit ARM",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/darwin-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-darwin-x64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with macOS x64",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linux-arm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linux-arm",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (glibc) ARM (32-bit)",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linux-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linux-arm64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (glibc) 64-bit ARM",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linux-ppc64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linux-ppc64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (glibc) ppc64",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linux-s390x/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linux-s390x",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (glibc) s390x",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linux-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linux-x64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (glibc) x64",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linuxmusl-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linuxmusl-arm64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (musl) 64-bit ARM",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/linuxmusl-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-linuxmusl-x64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Linux (musl) x64",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "private": "true",
   "workspaces": [
     "darwin-arm64",

npm/wasm32/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-wasm32",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with wasm32",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",
@@ -31,7 +31,7 @@
     "node": "^18.17.0 || ^20.3.0 || >=21.0.0"
   },
   "dependencies": {
-    "@emnapi/runtime": "^1.4.0"
+    "@emnapi/runtime": "^1.4.3"
   },
   "cpu": [
     "wasm32"

npm/win32-arm64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-win32-arm64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Windows 64-bit ARM",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/win32-ia32/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-win32-ia32",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Windows x86 (32-bit)",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

npm/win32-x64/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@img/sharp-win32-x64",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "description": "Prebuilt sharp for use with Windows x64",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",

package.json

@@ -1,7 +1,7 @@
 {
   "name": "sharp",
   "description": "High performance Node.js image processing, the fastest module to resize JPEG, PNG, WebP, GIF, AVIF and TIFF images",
-  "version": "0.34.1",
+  "version": "0.34.2",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",
   "contributors": [
@@ -138,12 +138,12 @@
   ],
   "dependencies": {
     "color": "^4.2.3",
-    "detect-libc": "^2.0.3",
-    "semver": "^7.7.1"
+    "detect-libc": "^2.0.4",
+    "semver": "^7.7.2"
   },
   "optionalDependencies": {
-    "@img/sharp-darwin-arm64": "0.34.1",
-    "@img/sharp-darwin-x64": "0.34.1",
+    "@img/sharp-darwin-arm64": "0.34.2",
+    "@img/sharp-darwin-x64": "0.34.2",
     "@img/sharp-libvips-darwin-arm64": "1.1.0",
     "@img/sharp-libvips-darwin-x64": "1.1.0",
     "@img/sharp-libvips-linux-arm": "1.1.0",
@@ -153,19 +153,19 @@
     "@img/sharp-libvips-linux-x64": "1.1.0",
     "@img/sharp-libvips-linuxmusl-arm64": "1.1.0",
     "@img/sharp-libvips-linuxmusl-x64": "1.1.0",
-    "@img/sharp-linux-arm": "0.34.1",
-    "@img/sharp-linux-arm64": "0.34.1",
-    "@img/sharp-linux-s390x": "0.34.1",
-    "@img/sharp-linux-x64": "0.34.1",
-    "@img/sharp-linuxmusl-arm64": "0.34.1",
-    "@img/sharp-linuxmusl-x64": "0.34.1",
-    "@img/sharp-wasm32": "0.34.1",
-    "@img/sharp-win32-arm64": "0.34.1",
-    "@img/sharp-win32-ia32": "0.34.1",
-    "@img/sharp-win32-x64": "0.34.1"
+    "@img/sharp-linux-arm": "0.34.2",
+    "@img/sharp-linux-arm64": "0.34.2",
+    "@img/sharp-linux-s390x": "0.34.2",
+    "@img/sharp-linux-x64": "0.34.2",
+    "@img/sharp-linuxmusl-arm64": "0.34.2",
+    "@img/sharp-linuxmusl-x64": "0.34.2",
+    "@img/sharp-wasm32": "0.34.2",
+    "@img/sharp-win32-arm64": "0.34.2",
+    "@img/sharp-win32-ia32": "0.34.2",
+    "@img/sharp-win32-x64": "0.34.2"
   },
   "devDependencies": {
-    "@emnapi/runtime": "^1.4.0",
+    "@emnapi/runtime": "^1.4.3",
     "@img/sharp-libvips-dev": "1.1.0",
     "@img/sharp-libvips-dev-wasm32": "1.1.0",
     "@img/sharp-libvips-win32-arm64": "1.1.0",
@@ -173,19 +173,19 @@
     "@img/sharp-libvips-win32-x64": "1.1.0",
     "@types/node": "*",
     "cc": "^3.0.1",
-    "emnapi": "^1.4.0",
+    "emnapi": "^1.4.3",
     "exif-reader": "^2.0.2",
     "extract-zip": "^2.0.1",
     "icc": "^3.0.0",
     "jsdoc-to-markdown": "^9.1.1",
     "license-checker": "^25.0.1",
-    "mocha": "^11.1.0",
+    "mocha": "^11.4.0",
     "node-addon-api": "^8.3.1",
     "nyc": "^17.1.0",
     "prebuild": "^13.0.1",
     "semistandard": "^17.0.0",
     "tar-fs": "^3.0.8",
-    "tsd": "^0.31.2"
+    "tsd": "^0.32.0"
   },
   "license": "Apache-2.0",
   "engines": {

src/common.cc

@@ -951,14 +951,6 @@ namespace sharp {
     return interpretation == VIPS_INTERPRETATION_RGB16 || interpretation == VIPS_INTERPRETATION_GREY16;
   }
 
-  /*
-    Return the image alpha maximum. Useful for combining alpha bands. scRGB
-    images are 0 - 1 for image data, but the alpha is 0 - 255.
-  */
-  double MaximumImageAlpha(VipsInterpretation const interpretation) {
-    return Is16Bit(interpretation) ? 65535.0 : 255.0;
-  }
-
   /*
     Convert RGBA value to another colourspace
   */
@@ -1003,16 +995,14 @@ namespace sharp {
     }
     // Add alpha channel(s) to alphaColour colour
     if (colour[3] < 255.0 || image.has_alpha()) {
-      do {
-        alphaColour.push_back(colour[3] * multiplier);
-      } while (alphaColour.size() < static_cast<size_t>(image.bands()));
+      int extraBands = image.bands() > 4 ? image.bands() - 3 : 1;
+      alphaColour.insert(alphaColour.end(), extraBands, colour[3] * multiplier);
     }
     // Ensure alphaColour colour uses correct colourspace
     alphaColour = sharp::GetRgbaAsColourspace(alphaColour, image.interpretation(), premultiply);
     // Add non-transparent alpha channel, if required
     if (colour[3] < 255.0 && !image.has_alpha()) {
-      image = image.bandjoin(
-        VImage::new_matrix(image.width(), image.height()).new_from_image(255 * multiplier).cast(image.format()));
+      image = image.bandjoin_const({ 255 * multiplier });
     }
     return std::make_tuple(image, alphaColour);
   }
@@ -1032,9 +1022,7 @@ namespace sharp {
   */
   VImage EnsureAlpha(VImage image, double const value) {
     if (!image.has_alpha()) {
-      std::vector<double> alpha;
-      alpha.push_back(value * sharp::MaximumImageAlpha(image.interpretation()));
-      image = image.bandjoin_const(alpha);
+      image = image.bandjoin_const({ value * vips_interpretation_max_alpha(image.interpretation()) });
     }
     return image;
   }

src/common.h

@@ -357,12 +357,6 @@ namespace sharp {
   */
   bool Is16Bit(VipsInterpretation const interpretation);
 
-  /*
-    Return the image alpha maximum. Useful for combining alpha bands. scRGB
-    images are 0 - 1 for image data, but the alpha is 0 - 255.
-  */
-  double MaximumImageAlpha(VipsInterpretation const interpretation);
-
   /*
     Convert RGBA value to another colourspace
   */

src/pipeline.cc

@@ -294,6 +294,7 @@ class PipelineWorker : public Napi::AsyncWorker {
           option->set("n", baton->input->pages);
           option->set("page", baton->input->page);
           option->set("dpi", baton->input->density);
+          option->set("background", baton->input->pdfBackground);
 
           if (baton->input->buffer != nullptr) {
             // Reload PDF buffer

src/stats.cc

@@ -60,7 +60,7 @@ class StatsWorker : public Napi::AsyncWorker {
         // Image is not opaque when alpha layer is present and contains a non-mamixa value
         if (image.has_alpha()) {
           double const minAlpha = static_cast<double>(stats.getpoint(STAT_MIN_INDEX, bands).front());
-          if (minAlpha != sharp::MaximumImageAlpha(image.interpretation())) {
+          if (minAlpha != vips_interpretation_max_alpha(image.interpretation())) {
             baton->isOpaque = false;
           }
         }

test/unit/util.js

@@ -10,18 +10,20 @@ const sharp = require('../../');
 describe('Utilities', function () {
   describe('Cache', function () {
     it('Can be disabled', function (done) {
-      queueMicrotask(() => {
-        sharp.cache(false);
+      const check = setInterval(() => {
         const cache = sharp.cache(false);
-        assert.strictEqual(cache.memory.current, 0);
-        assert.strictEqual(cache.memory.max, 0);
-        assert.strictEqual(typeof cache.memory.high, 'number');
-        assert.strictEqual(cache.files.current, 0);
-        assert.strictEqual(cache.files.max, 0);
-        assert.strictEqual(cache.items.current, 0);
-        assert.strictEqual(cache.items.max, 0);
-        done();
-      });
+        const empty =
+          cache.memory.current +
+          cache.memory.max +
+          cache.files.current +
+          cache.files.max +
+          cache.items.current +
+          cache.items.max === 0;
+        if (empty) {
+          clearInterval(check);
+          done();
+        }
+      }, 2000);
     });
     it('Can be enabled with defaults', function () {
       const cache = sharp.cache(true);