@revizly/sharp 0.35.0-revizly32 → 0.35.0-revizly34

package/dist/constructor.cjs

@@ -48,7 +48,7 @@ const queueListener = (queueLength) => {
  * // resize to 300 pixels wide,
  * // emit an 'info' event with calculated dimensions
  * // and finally write image data to writableStream
- * const { body } = fetch('https://...');
+ * const { body } = await fetch('https://...');
  * const readableStream = Readable.fromWeb(body);
  * const transformer = sharp()
  *   .resize(300)
@@ -58,6 +58,17 @@ const queueListener = (queueLength) => {
  * readableStream.pipe(transformer).pipe(writableStream);
  *
  * @example
+ * // Web Streams API, requires Node.js >= 24.15.0
+ * const { Duplex } = require('node:stream');
+ *
+ * const { body } = await fetch('https://...');
+ * const transformer = Duplex.toWeb(
+ *   sharp().resize(300),
+ *   { readableType: 'bytes' }
+ * );
+ * body.pipeThrough(transformer).pipeTo(writable);
+ *
+ * @example
  * // Create a blank 300x200 PNG image of semi-translucent red pixels
  * sharp({
  *   create: {
@@ -382,7 +393,7 @@ const Sharp = function (input, options) {
     heifEffort: 4,
     heifChromaSubsampling: '4:4:4',
     heifBitdepth: 8,
-    heifTune: 'ssim',
+    heifTune: 'auto',
     heifEncoder: 'auto',
     jxlDistance: 1,
     jxlDecodingTier: 0,

package/dist/constructor.mjs

@@ -48,7 +48,7 @@ const queueListener = (queueLength) => {
  * // resize to 300 pixels wide,
  * // emit an 'info' event with calculated dimensions
  * // and finally write image data to writableStream
- * const { body } = fetch('https://...');
+ * const { body } = await fetch('https://...');
  * const readableStream = Readable.fromWeb(body);
  * const transformer = sharp()
  *   .resize(300)
@@ -58,6 +58,17 @@ const queueListener = (queueLength) => {
  * readableStream.pipe(transformer).pipe(writableStream);
  *
  * @example
+ * // Web Streams API, requires Node.js >= 24.15.0
+ * import { Duplex } from 'node:stream';
+ *
+ * const { body } = await fetch('https://...');
+ * const transformer = Duplex.toWeb(
+ *   sharp().resize(300),
+ *   { readableType: 'bytes' }
+ * );
+ * body.pipeThrough(transformer).pipeTo(writable);
+ *
+ * @example
  * // Create a blank 300x200 PNG image of semi-translucent red pixels
  * sharp({
  *   create: {
@@ -382,7 +393,7 @@ const Sharp = function (input, options) {
     heifEffort: 4,
     heifChromaSubsampling: '4:4:4',
     heifBitdepth: 8,
-    heifTune: 'ssim',
+    heifTune: 'auto',
     heifEncoder: 'auto',
     jxlDistance: 1,
     jxlDecodingTier: 0,

package/dist/output.cjs

@@ -1206,7 +1206,6 @@ function tiff (options) {
  * Use these AVIF options for output image.
  *
  * AVIF image sequences are not supported.
- * Prebuilt binaries support a bitdepth of 8 only.
  *
  * When using Windows ARM64, this feature requires a CPU with ARM64v8.4 or later.
  *
@@ -1228,13 +1227,12 @@ function tiff (options) {
  * @param {number} [options.effort=4] - CPU effort, between 0 (fastest) and 9 (slowest)
  * @param {string} [options.chromaSubsampling='4:4:4'] - set to '4:2:0' to use chroma subsampling
  * @param {number} [options.bitdepth=8] - set bitdepth to 8, 10 or 12 bit
- * @param {string} [options.tune='iq'] - tune output for a quality metric, one of 'iq' (default), 'ssim' (default when lossless) or 'psnr'
+ * @param {string} [options.tune='auto'] - tune output for a quality metric, one of 'auto' (default), 'iq', 'psnr' or 'ssim'
  * @returns {Sharp}
  * @throws {Error} Invalid options
  */
 function avif (options) {
-  const tune = is.object(options) && is.defined(options.tune) ? options.tune : 'iq';
-  return this.heif({ ...options, compression: 'av1', tune });
+  return this.heif({ ...options, compression: 'av1' });
 }
 
 /**
@@ -1257,7 +1255,7 @@ function avif (options) {
  * @param {number} [options.effort=4] - CPU effort, between 0 (fastest) and 9 (slowest)
  * @param {string} [options.chromaSubsampling='4:4:4'] - set to '4:2:0' to use chroma subsampling
  * @param {number} [options.bitdepth=8] - set bitdepth to 8, 10 or 12 bit
- * @param {string} [options.tune='ssim'] - tune output for a quality metric, one of 'ssim' (default), 'psnr' or 'iq'
+ * @param {string} [options.tune='auto'] - tune output for a quality metric, one of 'auto' (default), 'iq', 'psnr' or 'ssim'
  * @returns {Sharp}
  * @throws {Error} Invalid options
  */
@@ -1298,23 +1296,20 @@ function heif (options) {
     }
     if (is.defined(options.bitdepth)) {
       if (is.integer(options.bitdepth) && is.inArray(options.bitdepth, [8, 10, 12])) {
-        if (options.bitdepth !== 8 && this.constructor.versions.heif) {
-          throw is.invalidParameterError('bitdepth when using prebuilt binaries', 8, options.bitdepth);
-        }
         this.options.heifBitdepth = options.bitdepth;
       } else {
         throw is.invalidParameterError('bitdepth', '8, 10 or 12', options.bitdepth);
       }
     }
     if (is.defined(options.tune)) {
-      if (is.string(options.tune) && is.inArray(options.tune, ['iq', 'ssim', 'psnr'])) {
+      if (is.string(options.tune) && is.inArray(options.tune, ['auto', 'iq', 'psnr', 'ssim'])) {
         if (this.options.heifLossless && options.tune === 'iq') {
           this.options.heifTune = 'ssim';
         } else {
           this.options.heifTune = options.tune;
         }
       } else {
-        throw is.invalidParameterError('tune', 'one of: psnr, ssim, iq', options.tune);
+        throw is.invalidParameterError('tune', 'one of: auto, iq, psnr, ssim', options.tune);
       }
     }
     if (is.defined(options.encoder)) {

package/dist/output.mjs

@@ -1206,7 +1206,6 @@ function tiff (options) {
  * Use these AVIF options for output image.
  *
  * AVIF image sequences are not supported.
- * Prebuilt binaries support a bitdepth of 8 only.
  *
  * When using Windows ARM64, this feature requires a CPU with ARM64v8.4 or later.
  *
@@ -1228,13 +1227,12 @@ function tiff (options) {
  * @param {number} [options.effort=4] - CPU effort, between 0 (fastest) and 9 (slowest)
  * @param {string} [options.chromaSubsampling='4:4:4'] - set to '4:2:0' to use chroma subsampling
  * @param {number} [options.bitdepth=8] - set bitdepth to 8, 10 or 12 bit
- * @param {string} [options.tune='iq'] - tune output for a quality metric, one of 'iq' (default), 'ssim' (default when lossless) or 'psnr'
+ * @param {string} [options.tune='auto'] - tune output for a quality metric, one of 'auto' (default), 'iq', 'psnr' or 'ssim'
  * @returns {Sharp}
  * @throws {Error} Invalid options
  */
 function avif (options) {
-  const tune = is.object(options) && is.defined(options.tune) ? options.tune : 'iq';
-  return this.heif({ ...options, compression: 'av1', tune });
+  return this.heif({ ...options, compression: 'av1' });
 }
 
 /**
@@ -1257,7 +1255,7 @@ function avif (options) {
  * @param {number} [options.effort=4] - CPU effort, between 0 (fastest) and 9 (slowest)
  * @param {string} [options.chromaSubsampling='4:4:4'] - set to '4:2:0' to use chroma subsampling
  * @param {number} [options.bitdepth=8] - set bitdepth to 8, 10 or 12 bit
- * @param {string} [options.tune='ssim'] - tune output for a quality metric, one of 'ssim' (default), 'psnr' or 'iq'
+ * @param {string} [options.tune='auto'] - tune output for a quality metric, one of 'auto' (default), 'iq', 'psnr' or 'ssim'
  * @returns {Sharp}
  * @throws {Error} Invalid options
  */
@@ -1298,23 +1296,20 @@ function heif (options) {
     }
     if (is.defined(options.bitdepth)) {
       if (is.integer(options.bitdepth) && is.inArray(options.bitdepth, [8, 10, 12])) {
-        if (options.bitdepth !== 8 && this.constructor.versions.heif) {
-          throw is.invalidParameterError('bitdepth when using prebuilt binaries', 8, options.bitdepth);
-        }
         this.options.heifBitdepth = options.bitdepth;
       } else {
         throw is.invalidParameterError('bitdepth', '8, 10 or 12', options.bitdepth);
       }
     }
     if (is.defined(options.tune)) {
-      if (is.string(options.tune) && is.inArray(options.tune, ['iq', 'ssim', 'psnr'])) {
+      if (is.string(options.tune) && is.inArray(options.tune, ['auto', 'iq', 'psnr', 'ssim'])) {
         if (this.options.heifLossless && options.tune === 'iq') {
           this.options.heifTune = 'ssim';
         } else {
           this.options.heifTune = options.tune;
         }
       } else {
-        throw is.invalidParameterError('tune', 'one of: psnr, ssim, iq', options.tune);
+        throw is.invalidParameterError('tune', 'one of: auto, iq, psnr, ssim', options.tune);
       }
     }
     if (is.defined(options.encoder)) {

package/dist/resize.cjs

@@ -506,6 +506,8 @@ function extract (options) {
  *
  * If the result of this operation would trim an image to nothing then no change is made.
  *
+ * Use the `lineArt` and `threshold` options for control over sensitivity.
+ *
  * The `info` response Object will contain `trimOffsetLeft` and `trimOffsetTop` properties.
  *
  * @example

package/dist/resize.mjs

@@ -506,6 +506,8 @@ function extract (options) {
  *
  * If the result of this operation would trim an image to nothing then no change is made.
  *
+ * Use the `lineArt` and `threshold` options for control over sensitivity.
+ *
  * The `info` response Object will contain `trimOffsetLeft` and `trimOffsetTop` properties.
  *
  * @example

package/dist/sharp.cjs

@@ -5,11 +5,13 @@
 
 // Inspects the runtime environment and exports the relevant sharp.node binary
 
+
 const { familySync, versionSync } = require("detect-libc");
 
 const libvips = require("./libvips.cjs");
 const pkg = require('../package.json');
 
+
 const { version } = pkg;
 
 const { runtimePlatformArch, isUnsupportedNodeRuntime, prebuiltPlatforms, minimumLibvipsVersion } = libvips;

package/dist/utility.cjs

@@ -4,6 +4,7 @@
 */
 
 const events = require('node:events');
+
 const { availableParallelism } = require("node:os");
 const detectLibc = require('detect-libc');
 
@@ -12,6 +13,7 @@ const libvips = require('./libvips.cjs');
 const sharp = require('./sharp.cjs');
 const pkg = require("../package.json");
 
+
 const runtimePlatform = libvips.runtimePlatformArch();
 const libvipsVersion = sharp.libvipsVersion();
 

package/lib/index.d.ts

@@ -1183,7 +1183,7 @@ declare namespace sharp {
 
     type HeifCompression = 'av1' | 'hevc';
 
-    type HeifTune = 'iq' | 'ssim' | 'psnr';
+    type HeifTune = 'auto' | 'iq' | 'psnr' | 'ssim';
 
     type Unit = 'inch' | 'cm';
 
@@ -1432,7 +1432,7 @@ declare namespace sharp {
         chromaSubsampling?: string | undefined;
         /** Set bitdepth to 8, 10 or 12 bit (optional, default 8) */
         bitdepth?: 8 | 10 | 12 | undefined;
-        /** Tune output for a quality metric, one of 'iq', 'ssim' or 'psnr' (optional, default 'iq') */
+        /** Tune output for a quality metric, one of 'auto', 'iq', 'psnr' or 'ssim' (optional, default 'auto') */
         tune?: HeifTune | undefined;
         /** Which encoder libheif uses (must be compiled in) (optional, default 'auto') */
         encoder?: 'auto' | 'aom' | 'rav1e' | 'svt' | 'x265' | undefined;
@@ -1451,7 +1451,7 @@ declare namespace sharp {
         chromaSubsampling?: string | undefined;
         /** Set bitdepth to 8, 10 or 12 bit (optional, default 8) */
         bitdepth?: 8 | 10 | 12 | undefined;
-        /** Tune output for a quality metric, one of 'ssim', 'psnr' or 'iq' (optional, default 'ssim') */
+        /** Tune output for a quality metric, one of 'auto', 'iq', 'psnr' or 'ssim' (optional, default 'auto') */
         tune?: HeifTune | undefined;
         /** Which encoder libheif uses (must be compiled in) (optional, default 'auto') */
         encoder?: 'auto' | 'aom' | 'rav1e' | 'svt' | 'x265' | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@revizly/sharp",
   "description": "High performance Node.js image processing, the fastest module to resize JPEG, PNG, WebP, GIF, AVIF and TIFF images",
-  "version": "0.35.0-revizly32",
+  "version": "0.35.0-revizly34",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",
   "contributors": [
@@ -152,26 +152,26 @@
   "dependencies": {
     "@img/colour": "^1.1.0",
     "detect-libc": "^2.1.2",
-    "semver": "^7.7.4"
+    "semver": "^7.8.2"
   },
   "optionalDependencies": {
-    "@revizly/sharp-libvips-linux-arm64": "1.0.35",
-    "@revizly/sharp-libvips-linux-x64": "1.0.35",
-    "@revizly/sharp-linux-arm64": "0.35.0-revizly32",
-    "@revizly/sharp-linux-x64": "0.35.0-revizly32"
+    "@revizly/sharp-libvips-linux-arm64": "1.0.37",
+    "@revizly/sharp-libvips-linux-x64": "1.0.37",
+    "@revizly/sharp-linux-arm64": "0.35.0-revizly34",
+    "@revizly/sharp-linux-x64": "0.35.0-revizly34"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.4.13",
+    "@biomejs/biome": "^2.4.16",
     "@cpplint/cli": "^0.1.0",
     "@emnapi/runtime": "^1.10.0",
-    "@revizly/sharp-libvips-dev": "1.0.35",
+    "@revizly/sharp-libvips-dev": "1.0.37",
     "@types/node": "*",
     "emnapi": "^1.10.0",
     "exif-reader": "^2.0.3",
     "extract-zip": "^2.0.1",
     "icc": "^4.0.0",
-    "node-addon-api": "^8.7.0",
-    "node-gyp": "^12.3.0",
+    "node-addon-api": "^8.8.0",
+    "node-gyp": "^12.4.0",
     "tar-fs": "^3.1.2",
     "tsd": "^0.33.0"
   },
@@ -180,7 +180,7 @@
     "node": ">=20.9.0"
   },
   "config": {
-    "libvips": ">=8.18.2"
+    "libvips": ">=8.18.3"
   },
   "funding": {
     "url": "https://opencollective.com/libvips"

package/src/common.h

@@ -19,8 +19,8 @@
 
 #if (VIPS_MAJOR_VERSION < 8) || \
   (VIPS_MAJOR_VERSION == 8 && VIPS_MINOR_VERSION < 18) || \
-  (VIPS_MAJOR_VERSION == 8 && VIPS_MINOR_VERSION == 18 && VIPS_MICRO_VERSION < 2)
-#error "libvips version 8.18.2+ is required - please see https://sharp.pixelplumbing.com/install"
+  (VIPS_MAJOR_VERSION == 8 && VIPS_MINOR_VERSION == 18 && VIPS_MICRO_VERSION < 3)
+#error "libvips version 8.18.3+ is required - please see https://sharp.pixelplumbing.com/install"
 #endif
 
 #if defined(__has_include)

package/src/pipeline.h

@@ -381,7 +381,7 @@ struct PipelineBaton {
     heifChromaSubsampling("4:4:4"),
     heifLossless(false),
     heifBitdepth(8),
-    heifTune("ssim"),
+    heifTune("auto"),
     jxlDistance(1.0),
     jxlDecodingTier(0),
     jxlEffort(7),