@revizly/sharp 0.35.0-revizly54 → 0.35.0-revizly56

package/dist/constructor.cjs

@@ -202,7 +202,7 @@ const queueListener = (queueLength) => {
  * @param {string} [options.text.wrap='word'] - word wrapping style when width is provided, one of: 'word', 'char', 'word-char' (prefer word, fallback to char) or 'none'.
  * @param {Object} [options.join] - describes how an array of input images should be joined.
  * @param {number} [options.join.across=1] - number of images to join horizontally.
- * @param {boolean} [options.join.animated=false] - set this to `true` to join the images as an animated image.
+ * @param {boolean} [options.join.animated=false] - set this to `true` to join the images as an animated image, cannot be used with `across` or `shim`.
  * @param {number} [options.join.shim=0] - number of pixels to insert between joined images.
  * @param {string|Object} [options.join.background] - parsed by the [color](https://www.npmjs.org/package/color) module to extract values for red, green, blue and alpha.
  * @param {string} [options.join.halign='left'] - horizontal alignment style for images joined horizontally (`'left'`, `'centre'`, `'center'`, `'right'`).

package/dist/constructor.mjs

@@ -202,7 +202,7 @@ const queueListener = (queueLength) => {
  * @param {string} [options.text.wrap='word'] - word wrapping style when width is provided, one of: 'word', 'char', 'word-char' (prefer word, fallback to char) or 'none'.
  * @param {Object} [options.join] - describes how an array of input images should be joined.
  * @param {number} [options.join.across=1] - number of images to join horizontally.
- * @param {boolean} [options.join.animated=false] - set this to `true` to join the images as an animated image.
+ * @param {boolean} [options.join.animated=false] - set this to `true` to join the images as an animated image, cannot be used with `across` or `shim`.
  * @param {number} [options.join.shim=0] - number of pixels to insert between joined images.
  * @param {string|Object} [options.join.background] - parsed by the [color](https://www.npmjs.org/package/color) module to extract values for red, green, blue and alpha.
  * @param {string} [options.join.halign='left'] - horizontal alignment style for images joined horizontally (`'left'`, `'centre'`, `'center'`, `'right'`).

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+/* cspell:disable */
 /**
  * Copyright 2017 François Nguyen and others.
  *
@@ -22,6 +23,7 @@
  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
+/* cspell:enable */
 
 // SPDX-License-Identifier: MIT
 
@@ -408,7 +410,7 @@ declare namespace sharp {
 
         /**
          * Alias for calling `rotate()` with no arguments, which orients the image based
-         * on EXIF orientsion.
+         * on EXIF orientation.
          *
          * This operation is aliased to emphasize its purpose, helping to remove any
          * confusion between rotation and orientation.
@@ -580,7 +582,7 @@ declare namespace sharp {
         convolve(kernel: Kernel): Sharp;
 
         /**
-         * Any pixel value greather than or equal to the threshold value will be set to 255, otherwise it will be set to 0.
+         * Any pixel value greater than or equal to the threshold value will be set to 255, otherwise it will be set to 0.
          * @param threshold a value in the range 0-255 representing the level at which the threshold will be applied. (optional, default 128)
          * @param options threshold options
          * @throws {Error} Invalid parameters
@@ -1462,8 +1464,8 @@ declare namespace sharp {
     interface HeifOptions extends OutputOptions {
         /** quality, integer 1-100 (optional, default 50) */
         quality?: number | undefined;
-        /** compression format: av1, hevc (optional, default 'av1') */
-        compression?: HeifCompression | undefined;
+        /** compression format: av1, hevc */
+        compression: HeifCompression;
         /** use lossless compression (optional, default false) */
         lossless?: boolean | undefined;
         /** Level of CPU effort to reduce file size, between 0 (fastest) and 9 (slowest) (optional, default 4) */
@@ -1472,7 +1474,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 'auto', 'iq', 'psnr' or 'ssim' (optional, default 'auto') */
+        /** Tune output for a quality metric, one of 'auto' (av1 default), 'iq' (av1 only), 'psnr' or 'ssim' (hevc default) */
         tune?: HeifTune | undefined;
         /** Which encoder libheif uses (must be compiled in) (optional, default 'auto') */
         encoder?: 'auto' | 'aom' | 'rav1e' | 'svt' | 'x265' | undefined;
@@ -1703,7 +1705,7 @@ declare namespace sharp {
         left?: number | undefined;
         /** set to true to repeat the overlay image across the entire image with the given  gravity. (optional, default false) */
         tile?: boolean | undefined;
-        /** Set to true to avoid premultipling the image below. Equivalent to the --premultiplied vips option. */
+        /** Set to true to avoid premultiplying the image below. Equivalent to the --premultiplied vips option. */
         premultiplied?: boolean | undefined;
         /** number representing the DPI for vector overlay image. (optional, default 72)*/
         density?: number | undefined;

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+/* cspell:disable */
 /**
  * Copyright 2017 François Nguyen and others.
  *
@@ -22,6 +23,7 @@
  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
+/* cspell:enable */
 
 // SPDX-License-Identifier: MIT
 
@@ -402,7 +404,7 @@ export interface Sharp extends Duplex {
 
     /**
      * Alias for calling `rotate()` with no arguments, which orients the image based
-     * on EXIF orientsion.
+     * on EXIF orientation.
      *
      * This operation is aliased to emphasize its purpose, helping to remove any
      * confusion between rotation and orientation.
@@ -574,7 +576,7 @@ export interface Sharp extends Duplex {
     convolve(kernel: Kernel): Sharp;
 
     /**
-     * Any pixel value greather than or equal to the threshold value will be set to 255, otherwise it will be set to 0.
+     * Any pixel value greater than or equal to the threshold value will be set to 255, otherwise it will be set to 0.
      * @param threshold a value in the range 0-255 representing the level at which the threshold will be applied. (optional, default 128)
      * @param options threshold options
      * @throws {Error} Invalid parameters
@@ -1456,8 +1458,8 @@ export interface AvifOptions extends OutputOptions {
 export interface HeifOptions extends OutputOptions {
     /** quality, integer 1-100 (optional, default 50) */
     quality?: number | undefined;
-    /** compression format: av1, hevc (optional, default 'av1') */
-    compression?: HeifCompression | undefined;
+    /** compression format: av1, hevc */
+    compression: HeifCompression;
     /** use lossless compression (optional, default false) */
     lossless?: boolean | undefined;
     /** Level of CPU effort to reduce file size, between 0 (fastest) and 9 (slowest) (optional, default 4) */
@@ -1466,7 +1468,7 @@ export interface HeifOptions extends OutputOptions {
     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 'auto', 'iq', 'psnr' or 'ssim' (optional, default 'auto') */
+    /** Tune output for a quality metric, one of 'auto' (av1 default), 'iq' (av1 only), 'psnr' or 'ssim' (hevc default) */
     tune?: HeifTune | undefined;
     /** Which encoder libheif uses (must be compiled in) (optional, default 'auto') */
     encoder?: 'auto' | 'aom' | 'rav1e' | 'svt' | 'x265' | undefined;
@@ -1697,7 +1699,7 @@ export interface OverlayOptions extends SharpOptions {
     left?: number | undefined;
     /** set to true to repeat the overlay image across the entire image with the given  gravity. (optional, default false) */
     tile?: boolean | undefined;
-    /** Set to true to avoid premultipling the image below. Equivalent to the --premultiplied vips option. */
+    /** Set to true to avoid premultiplying the image below. Equivalent to the --premultiplied vips option. */
     premultiplied?: boolean | undefined;
     /** number representing the DPI for vector overlay image. (optional, default 72)*/
     density?: number | undefined;

package/dist/input.cjs

@@ -511,6 +511,9 @@ function _createInputDescriptor (input, inputOptions, containerOptions) {
             throw is.invalidParameterError('join.valign', 'valid alignment', inputOptions.join.valign);
           }
         }
+        if (inputDescriptor.joinAnimated && (inputDescriptor.joinAcross > 1 || inputDescriptor.joinShim > 0)) {
+          throw new Error('Expected neither join.across nor join.shim when join.animated is set');
+        }
       } else {
         throw new Error('Expected input to be an array of images to join');
       }

package/dist/input.mjs

@@ -511,6 +511,9 @@ function _createInputDescriptor (input, inputOptions, containerOptions) {
             throw is.invalidParameterError('join.valign', 'valid alignment', inputOptions.join.valign);
           }
         }
+        if (inputDescriptor.joinAnimated && (inputDescriptor.joinAcross > 1 || inputDescriptor.joinShim > 0)) {
+          throw new Error('Expected neither join.across nor join.shim when join.animated is set');
+        }
       } else {
         throw new Error('Expected input to be an array of images to join');
       }

package/dist/is.cjs

@@ -13,7 +13,7 @@ const defined = (val) => typeof val !== 'undefined' && val !== null;
  * Is this value an object?
  * @private
  */
-const object = (val) => typeof val === 'object';
+const object = (val) => typeof val === 'object' && val !== null;
 
 /**
  * Is this value a plain object?

package/dist/is.mjs

@@ -13,7 +13,7 @@ const defined = (val) => typeof val !== 'undefined' && val !== null;
  * Is this value an object?
  * @private
  */
-const object = (val) => typeof val === 'object';
+const object = (val) => typeof val === 'object' && val !== null;
 
 /**
  * Is this value a plain object?

package/dist/operation.cjs

@@ -62,7 +62,7 @@ function rotate (angle, options) {
     this.options.rotationAngle = 0;
   }
   if (is.integer(angle) && !(angle % 90)) {
-    this.options.angle = angle;
+    this.options.angle = angle % 360;
   } else if (is.number(angle)) {
     this.options.rotationAngle = angle;
     if (is.object(options) && options.background) {

package/dist/operation.mjs

@@ -62,7 +62,7 @@ function rotate (angle, options) {
     this.options.rotationAngle = 0;
   }
   if (is.integer(angle) && !(angle % 90)) {
-    this.options.angle = angle;
+    this.options.angle = angle % 360;
   } else if (is.number(angle)) {
     this.options.rotationAngle = angle;
     if (is.object(options) && options.background) {

package/dist/output.cjs

@@ -205,15 +205,15 @@ function toUint8Array () {
  *   .withDensity(96)
  *   .toBuffer();
  *
- * @param {number} density Number of pixels per inch (DPI).
+ * @param {number} density Number of pixels per inch (DPI), between 1 and 100000.
  * @returns {Sharp}
  * @throws {Error} Invalid parameters
  */
 function withDensity (density) {
-  if (is.number(density) && density > 0) {
+  if (is.number(density) && is.inRange(density, 1, 100000)) {
     this.options.withMetadataDensity = density;
   } else {
-    throw is.invalidParameterError('density', 'positive number', density);
+    throw is.invalidParameterError('density', 'number between 1 and 100000', density);
   }
   return this.keepExif();
 }
@@ -520,7 +520,7 @@ function keepMetadata () {
  *
  * @param {Object} [options]
  * @param {number} [options.orientation] Used to update the EXIF `Orientation` tag, integer between 1 and 8.
- * @param {number} [options.density] Number of pixels per inch (DPI).
+ * @param {number} [options.density] Number of pixels per inch (DPI), between 1 and 100000.
  * @returns {Sharp}
  * @throws {Error} Invalid parameters
  */
@@ -536,10 +536,10 @@ function withMetadata (options) {
       }
     }
     if (is.defined(options.density)) {
-      if (is.number(options.density) && options.density > 0) {
+      if (is.number(options.density) && is.inRange(options.density, 1, 100000)) {
         this.options.withMetadataDensity = options.density;
       } else {
-        throw is.invalidParameterError('density', 'positive number', options.density);
+        throw is.invalidParameterError('density', 'number between 1 and 100000', options.density);
       }
     }
     if (is.defined(options.icc)) {
@@ -1250,7 +1250,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='auto'] - tune output for a quality metric, one of 'auto' (default), 'iq', 'psnr' or 'ssim'
+ * @param {string} [options.tune='auto'] - tune output for a quality metric, one of 'auto' (av1 default), 'iq' (av1 only), 'psnr' or 'ssim' (hevc default)
  * @returns {Sharp}
  * @throws {Error} Invalid options
  */
@@ -1258,6 +1258,9 @@ function heif (options) {
   if (is.object(options)) {
     if (is.string(options.compression) && is.inArray(options.compression, ['av1', 'hevc'])) {
       this.options.heifCompression = options.compression;
+      if (options.compression === 'hevc' && this.options.heifTune === 'auto') {
+        this.options.heifTune = 'ssim';
+      }
     } else {
       throw is.invalidParameterError('compression', 'one of: av1, hevc', options.compression);
     }
@@ -1297,14 +1300,24 @@ function heif (options) {
       }
     }
     if (is.defined(options.tune)) {
-      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 {
+      if (is.string(options.tune)) {
+        if (this.options.heifCompression === 'av1') {
+          if (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: auto, iq, psnr, ssim', options.tune);
+          }
+        } else if (is.inArray(options.tune, ['psnr', 'ssim'])) {
           this.options.heifTune = options.tune;
+        } else {
+          throw is.invalidParameterError('tune', 'one of: psnr, ssim', options.tune);
         }
       } else {
-        throw is.invalidParameterError('tune', 'one of: auto, iq, psnr, ssim', options.tune);
+        throw is.invalidParameterError('tune', 'string', options.tune);
       }
     }
     if (is.defined(options.encoder)) {
@@ -1511,7 +1524,7 @@ function tile (options) {
     // Angle of rotation,
     if (is.defined(options.angle)) {
       if (is.integer(options.angle) && !(options.angle % 90)) {
-        this.options.tileAngle = options.angle;
+        this.options.tileAngle = options.angle % 360;
       } else {
         throw is.invalidParameterError('angle', 'positive/negative multiple of 90', options.angle);
       }

package/dist/output.mjs

@@ -205,15 +205,15 @@ function toUint8Array () {
  *   .withDensity(96)
  *   .toBuffer();
  *
- * @param {number} density Number of pixels per inch (DPI).
+ * @param {number} density Number of pixels per inch (DPI), between 1 and 100000.
  * @returns {Sharp}
  * @throws {Error} Invalid parameters
  */
 function withDensity (density) {
-  if (is.number(density) && density > 0) {
+  if (is.number(density) && is.inRange(density, 1, 100000)) {
     this.options.withMetadataDensity = density;
   } else {
-    throw is.invalidParameterError('density', 'positive number', density);
+    throw is.invalidParameterError('density', 'number between 1 and 100000', density);
   }
   return this.keepExif();
 }
@@ -520,7 +520,7 @@ function keepMetadata () {
  *
  * @param {Object} [options]
  * @param {number} [options.orientation] Used to update the EXIF `Orientation` tag, integer between 1 and 8.
- * @param {number} [options.density] Number of pixels per inch (DPI).
+ * @param {number} [options.density] Number of pixels per inch (DPI), between 1 and 100000.
  * @returns {Sharp}
  * @throws {Error} Invalid parameters
  */
@@ -536,10 +536,10 @@ function withMetadata (options) {
       }
     }
     if (is.defined(options.density)) {
-      if (is.number(options.density) && options.density > 0) {
+      if (is.number(options.density) && is.inRange(options.density, 1, 100000)) {
         this.options.withMetadataDensity = options.density;
       } else {
-        throw is.invalidParameterError('density', 'positive number', options.density);
+        throw is.invalidParameterError('density', 'number between 1 and 100000', options.density);
       }
     }
     if (is.defined(options.icc)) {
@@ -1250,7 +1250,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='auto'] - tune output for a quality metric, one of 'auto' (default), 'iq', 'psnr' or 'ssim'
+ * @param {string} [options.tune='auto'] - tune output for a quality metric, one of 'auto' (av1 default), 'iq' (av1 only), 'psnr' or 'ssim' (hevc default)
  * @returns {Sharp}
  * @throws {Error} Invalid options
  */
@@ -1258,6 +1258,9 @@ function heif (options) {
   if (is.object(options)) {
     if (is.string(options.compression) && is.inArray(options.compression, ['av1', 'hevc'])) {
       this.options.heifCompression = options.compression;
+      if (options.compression === 'hevc' && this.options.heifTune === 'auto') {
+        this.options.heifTune = 'ssim';
+      }
     } else {
       throw is.invalidParameterError('compression', 'one of: av1, hevc', options.compression);
     }
@@ -1297,14 +1300,24 @@ function heif (options) {
       }
     }
     if (is.defined(options.tune)) {
-      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 {
+      if (is.string(options.tune)) {
+        if (this.options.heifCompression === 'av1') {
+          if (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: auto, iq, psnr, ssim', options.tune);
+          }
+        } else if (is.inArray(options.tune, ['psnr', 'ssim'])) {
           this.options.heifTune = options.tune;
+        } else {
+          throw is.invalidParameterError('tune', 'one of: psnr, ssim', options.tune);
         }
       } else {
-        throw is.invalidParameterError('tune', 'one of: auto, iq, psnr, ssim', options.tune);
+        throw is.invalidParameterError('tune', 'string', options.tune);
       }
     }
     if (is.defined(options.encoder)) {
@@ -1511,7 +1524,7 @@ function tile (options) {
     // Angle of rotation,
     if (is.defined(options.angle)) {
       if (is.integer(options.angle) && !(options.angle % 90)) {
-        this.options.tileAngle = options.angle;
+        this.options.tileAngle = options.angle % 360;
       } else {
         throw is.invalidParameterError('angle', 'positive/negative multiple of 90', options.angle);
       }

package/dist/resize.cjs

@@ -52,7 +52,7 @@ const extendWith = {
 };
 
 /**
- * Strategies for automagic cover behaviour.
+ * Strategies for cover behaviour.
  * @member
  * @private
  */

package/dist/resize.mjs

@@ -52,7 +52,7 @@ const extendWith = {
 };
 
 /**
- * Strategies for automagic cover behaviour.
+ * Strategies for cover behaviour.
  * @member
  * @private
  */

package/lib/index.d.ts

@@ -1,3 +1,4 @@
+/* cspell:disable */
 /**
  * Copyright 2017 François Nguyen and others.
  *
@@ -22,6 +23,7 @@
  * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  */
+/* cspell:enable */
 
 // SPDX-License-Identifier: MIT
 
@@ -408,7 +410,7 @@ declare namespace sharp {
 
         /**
          * Alias for calling `rotate()` with no arguments, which orients the image based
-         * on EXIF orientsion.
+         * on EXIF orientation.
          *
          * This operation is aliased to emphasize its purpose, helping to remove any
          * confusion between rotation and orientation.
@@ -580,7 +582,7 @@ declare namespace sharp {
         convolve(kernel: Kernel): Sharp;
 
         /**
-         * Any pixel value greather than or equal to the threshold value will be set to 255, otherwise it will be set to 0.
+         * Any pixel value greater than or equal to the threshold value will be set to 255, otherwise it will be set to 0.
          * @param threshold a value in the range 0-255 representing the level at which the threshold will be applied. (optional, default 128)
          * @param options threshold options
          * @throws {Error} Invalid parameters
@@ -1462,8 +1464,8 @@ declare namespace sharp {
     interface HeifOptions extends OutputOptions {
         /** quality, integer 1-100 (optional, default 50) */
         quality?: number | undefined;
-        /** compression format: av1, hevc (optional, default 'av1') */
-        compression?: HeifCompression | undefined;
+        /** compression format: av1, hevc */
+        compression: HeifCompression;
         /** use lossless compression (optional, default false) */
         lossless?: boolean | undefined;
         /** Level of CPU effort to reduce file size, between 0 (fastest) and 9 (slowest) (optional, default 4) */
@@ -1472,7 +1474,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 'auto', 'iq', 'psnr' or 'ssim' (optional, default 'auto') */
+        /** Tune output for a quality metric, one of 'auto' (av1 default), 'iq' (av1 only), 'psnr' or 'ssim' (hevc default) */
         tune?: HeifTune | undefined;
         /** Which encoder libheif uses (must be compiled in) (optional, default 'auto') */
         encoder?: 'auto' | 'aom' | 'rav1e' | 'svt' | 'x265' | undefined;
@@ -1703,7 +1705,7 @@ declare namespace sharp {
         left?: number | undefined;
         /** set to true to repeat the overlay image across the entire image with the given  gravity. (optional, default false) */
         tile?: boolean | undefined;
-        /** Set to true to avoid premultipling the image below. Equivalent to the --premultiplied vips option. */
+        /** Set to true to avoid premultiplying the image below. Equivalent to the --premultiplied vips option. */
         premultiplied?: boolean | undefined;
         /** number representing the DPI for vector overlay image. (optional, default 72)*/
         density?: number | 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-revizly54",
+  "version": "0.35.0-revizly56",
   "author": "Lovell Fuller <npm@lovell.info>",
   "homepage": "https://sharp.pixelplumbing.com",
   "contributors": [
@@ -98,10 +98,11 @@
     "build:dist": "node scripts/build.mjs",
     "clean": "rm -rf src/build/ test/fixtures/output.*",
     "test": "npm run lint && npm run test-unit",
-    "lint": "npm run lint-cpp && npm run lint-js && npm run lint-types && npm run lint-publish",
+    "lint": "npm run lint-cpp && npm run lint-js && npm run lint-types && npm run lint-spell && npm run lint-publish",
     "lint-cpp": "cpplint --quiet src/*.h src/*.cc",
     "lint-js": "biome lint",
     "lint-publish": "publint --strict",
+    "lint-spell": "cspell --config ./test/spell/cspell.jsonc --no-progress .",
     "lint-types": "tsd --files ./test/types/sharp.test-d.{cts,mts}",
     "test-leak": "./test/leak/leak.sh",
     "test-unit": "node --experimental-test-coverage test/unit.mjs",
@@ -163,10 +164,10 @@
     "semver": "^7.8.5"
   },
   "optionalDependencies": {
-    "@revizly/sharp-libvips-linux-arm64": "1.0.54",
-    "@revizly/sharp-libvips-linux-x64": "1.0.54",
-    "@revizly/sharp-linux-arm64": "0.35.0-revizly54",
-    "@revizly/sharp-linux-x64": "0.35.0-revizly54"
+    "@revizly/sharp-libvips-linux-arm64": "1.0.56",
+    "@revizly/sharp-libvips-linux-x64": "1.0.56",
+    "@revizly/sharp-linux-arm64": "0.35.0-revizly56",
+    "@revizly/sharp-linux-x64": "0.35.0-revizly56"
   },
   "peerDependenciesMeta": {
     "@types/node": {
@@ -174,17 +175,18 @@
     }
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.14",
+    "@biomejs/biome": "^2.5.15",
     "@cpplint/cli": "^0.1.0",
     "@emnapi/runtime": "^1.11.3",
-    "@revizly/sharp-libvips-dev": "1.0.54",
+    "@revizly/sharp-libvips-dev": "1.0.56",
     "@types/node": "*",
+    "cspell": "^10.4.0",
     "emnapi": "^1.11.3",
     "exif-reader": "^2.0.3",
     "icc": "^4.0.0",
     "node-addon-api": "^8.9.2",
     "node-gyp": "^12.4.0",
-    "publint": "^0.3.24",
+    "publint": "^0.3.25",
     "tar-fs": "^3.1.3",
     "tsd": "^0.33.0",
     "yauzl": "^3.4.0"

package/src/common.cc

@@ -198,7 +198,7 @@ namespace sharp {
     }
     descriptor->limitInputPixels = static_cast<uint64_t>(AttrAsInt64(input, "limitInputPixels"));
     descriptor->limitInputChannels = static_cast<uint64_t>(AttrAsInt64(input, "limitInputChannels"));
-    if (HasAttr(input, "access")) {
+    if (HasAttr(input, "sequentialRead")) {
       descriptor->access = AttrAsBool(input, "sequentialRead") ? VIPS_ACCESS_SEQUENTIAL : VIPS_ACCESS_RANDOM;
     }
     // Remove safety features and allow unlimited input

package/src/operations.cc

@@ -97,7 +97,7 @@ namespace sharp {
   }
 
   /*
-   * Contrast limiting adapative histogram equalization (CLAHE)
+   * Contrast limiting adaptive histogram equalization (CLAHE)
    */
   VImage Clahe(VImage image, int const width, int const height, int const maxSlope) {
     return image.hist_local(width, height, VImage::option()->set("max_slope", maxSlope));

package/src/operations.h

@@ -28,7 +28,7 @@ namespace sharp {
   VImage Normalise(VImage image, int const lower, int const upper);
 
   /*
-   * Contrast limiting adapative histogram equalization (CLAHE)
+   * Contrast limiting adaptive histogram equalization (CLAHE)
    */
   VImage Clahe(VImage image, int const width, int const height, int const maxSlope);
 

package/src/pipeline.cc

@@ -40,6 +40,7 @@ class PipelineWorker : public Napi::AsyncWorker {
     // Increment processing task counter
     sharp::counterProcess++;
 
+    std::pair<char*, size_t> inputProfile(nullptr, 0);
     try {
       // Open input
       vips::VImage image;
@@ -269,7 +270,12 @@ class PipelineWorker : public Napi::AsyncWorker {
         if (baton->input->buffer != nullptr) {
           // Reload JPEG buffer
           VipsBlob *blob = vips_blob_new(nullptr, baton->input->buffer, baton->input->bufferLength);
-          image = VImage::jpegload_buffer(blob, option);
+          try {
+            image = VImage::jpegload_buffer(blob, option);
+          } catch (...) {
+            vips_area_unref(reinterpret_cast<VipsArea*>(blob));
+            throw;
+          }
           vips_area_unref(reinterpret_cast<VipsArea*>(blob));
         } else {
           // Reload JPEG file
@@ -281,7 +287,12 @@ class PipelineWorker : public Napi::AsyncWorker {
           if (baton->input->buffer != nullptr) {
             // Reload WebP buffer
             VipsBlob *blob = vips_blob_new(nullptr, baton->input->buffer, baton->input->bufferLength);
-            image = VImage::webpload_buffer(blob, option);
+            try {
+              image = VImage::webpload_buffer(blob, option);
+            } catch (...) {
+              vips_area_unref(reinterpret_cast<VipsArea*>(blob));
+              throw;
+            }
             vips_area_unref(reinterpret_cast<VipsArea*>(blob));
           } else {
             // Reload WebP file
@@ -291,7 +302,12 @@ class PipelineWorker : public Napi::AsyncWorker {
           if (baton->input->buffer != nullptr) {
             // Reload SVG buffer
             VipsBlob *blob = vips_blob_new(nullptr, baton->input->buffer, baton->input->bufferLength);
-            image = VImage::svgload_buffer(blob, option);
+            try {
+              image = VImage::svgload_buffer(blob, option);
+            } catch (...) {
+              vips_area_unref(reinterpret_cast<VipsArea*>(blob));
+              throw;
+            }
             vips_area_unref(reinterpret_cast<VipsArea*>(blob));
           } else {
             // Reload SVG file
@@ -305,7 +321,12 @@ class PipelineWorker : public Napi::AsyncWorker {
           if (baton->input->buffer != nullptr) {
             // Reload PDF buffer
             VipsBlob *blob = vips_blob_new(nullptr, baton->input->buffer, baton->input->bufferLength);
-            image = VImage::pdfload_buffer(blob, option);
+            try {
+              image = VImage::pdfload_buffer(blob, option);
+            } catch (...) {
+              vips_area_unref(reinterpret_cast<VipsArea*>(blob));
+              throw;
+            }
             vips_area_unref(reinterpret_cast<VipsArea*>(blob));
           } else {
             // Reload PDF file
@@ -325,7 +346,7 @@ class PipelineWorker : public Napi::AsyncWorker {
       int gainMapScaleFactor = 1;
       if (sharp::HasGainMap(image)) {
         if (baton->keepGainMap) {
-          gainMap = image.gainmap();
+          gainMap = image.gainmap().copy_memory();
           if (image.get_typeof("gainmap-scale-factor") == G_TYPE_INT) {
             gainMapScaleFactor = image.get_int("gainmap-scale-factor");
           }
@@ -378,7 +399,6 @@ class PipelineWorker : public Napi::AsyncWorker {
       }
 
       // Ensure we're using a device-independent colour space
-      std::pair<char*, size_t> inputProfile(nullptr, 0);
       if ((baton->keepMetadata & VIPS_FOREIGN_KEEP_ICC) && baton->withIccProfile.empty()) {
         // Cache input profile for use with output
         inputProfile = sharp::GetProfile(image);
@@ -481,14 +501,14 @@ class PipelineWorker : public Napi::AsyncWorker {
         }
         image = image.rot(autoRotation);
         if (baton->keepGainMap) {
-          gainMap = sharp::StaySequential(gainMap).rot(autoRotation);
+          gainMap = gainMap.rot(autoRotation);
         }
       }
       // Mirror vertically (up-down) about the x-axis
       if (baton->flip) {
         image = image.flip(VIPS_DIRECTION_VERTICAL);
         if (baton->keepGainMap) {
-          gainMap = sharp::StaySequential(gainMap).flip(VIPS_DIRECTION_VERTICAL);
+          gainMap = gainMap.flip(VIPS_DIRECTION_VERTICAL);
         }
       }
       // Mirror horizontally (left-right) about the y-axis
@@ -505,7 +525,7 @@ class PipelineWorker : public Napi::AsyncWorker {
         }
         image = image.rot(rotation);
         if (baton->keepGainMap) {
-          gainMap = sharp::StaySequential(gainMap).rot(rotation);
+          gainMap = gainMap.rot(rotation);
         }
       }
 
@@ -931,11 +951,8 @@ class PipelineWorker : public Napi::AsyncWorker {
         image = image.colourspace(baton->colourspace, VImage::option()->set("source_space", image.interpretation()));
         if (inputProfile.first != nullptr && baton->withIccProfile.empty()) {
           image = sharp::SetProfile(image, inputProfile);
-        } else {
-          g_free(inputProfile.first);
+          inputProfile.first = nullptr;
         }
-      } else {
-        g_free(inputProfile.first);
       }
 
       // Extract channel
@@ -945,10 +962,9 @@ class PipelineWorker : public Napi::AsyncWorker {
           if (baton->extractChannel == 3 && image.has_alpha()) {
             baton->extractChannel = image.bands() - 1;
           } else {
-            (baton->err)
-              .append("Cannot extract channel ").append(std::to_string(baton->extractChannel))
-              .append(" from image with channels 0-").append(std::to_string(image.bands() - 1));
-            return Error();
+            throw std::runtime_error(
+              std::string("Cannot extract channel ").append(std::to_string(baton->extractChannel))
+              .append(" from image with channels 0-").append(std::to_string(image.bands() - 1)));
           }
         }
         VipsInterpretation colourspace = sharp::Is16Bit(image.interpretation())
@@ -1444,6 +1460,8 @@ class PipelineWorker : public Napi::AsyncWorker {
         }
       }
     }
+    g_free(inputProfile.first);
+
     // Clean up libvips' per-request data and threads
     vips_error_clear();
     vips_thread_shutdown();
@@ -1869,9 +1887,9 @@ Napi::Value pipeline(const Napi::CallbackInfo& info) {
     baton->convKernelOffset = sharp::AttrAsDouble(kernel, "offset");
     size_t const kernelSize = static_cast<size_t>(baton->convKernelWidth * baton->convKernelHeight);
     baton->convKernel.resize(kernelSize);
-    Napi::Array kdata = kernel.Get("kernel").As<Napi::Array>();
+    Napi::Array kernelData = kernel.Get("kernel").As<Napi::Array>();
     for (unsigned int i = 0; i < kernelSize; i++) {
-      baton->convKernel[i] = sharp::AttrAsDouble(kdata, i);
+      baton->convKernel[i] = sharp::AttrAsDouble(kernelData, i);
     }
   }
   if (options.Has("recombMatrix")) {

package/src/stats.cc

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