Release v0.33.4

Prerelease v0.33.4-rc.0
Bump devDeps
2026-02-04 13:46:19 +01:00 · 2024-05-16 12:48:29 +01:00 · 2024-05-16 12:16:41 +01:00 · 2024-05-16 12:15:49 +01:00 · 2024-05-14 16:59:20 +01:00 · 2024-05-13 12:23:11 +01:00
64 changed files with 781 additions and 358 deletions
--- a/.circleci/config.yml
+++ b/.circleci/config.yml
@@ -24,7 +24,7 @@ jobs:
  linux-arm64-glibc-node-18:
    resource_class: arm.medium
    machine:
-      image: ubuntu-2004:current
+      image: ubuntu-2204:current
    steps:
      - checkout
      - run: |
@@ -46,7 +46,7 @@ jobs:
  linux-arm64-glibc-node-20:
    resource_class: arm.medium
    machine:
-      image: ubuntu-2004:current
+      image: ubuntu-2204:current
    steps:
      - checkout
      - run: |
@@ -69,7 +69,7 @@ jobs:
  linux-arm64-musl-node-18:
    resource_class: arm.medium
    machine:
-      image: ubuntu-2004:current
+      image: ubuntu-2204:current
    steps:
      - checkout
      - run: |
@@ -87,7 +87,7 @@ jobs:
  linux-arm64-musl-node-20:
    resource_class: arm.medium
    machine:
-      image: ubuntu-2004:current
+      image: ubuntu-2204:current
    steps:
      - checkout
      - run: |
--- a/.github/CONTRIBUTING.md
+++ b/.github/CONTRIBUTING.md
@@ -63,7 +63,7 @@ By way of example, the `background()` method present in v0.20.0 was deprecated i

 ## Documentation

-The public API is documented with [JSDoc](http://usejsdoc.org/) annotated comments.
+The public API is documented with [JSDoc](https://jsdoc.app/) annotated comments.

 These can be converted to Markdown by running:
 ```sh
--- a/.github/ISSUE_TEMPLATE/installation.md
+++ b/.github/ISSUE_TEMPLATE/installation.md
@@ -24,7 +24,8 @@ You must confirm both of these before continuing.

 If you cannot confirm this, please upgrade to the latest version and try again before opening an issue.

-If you are using another package which depends on a version of `sharp` that is not the latest, please open an issue against that package instead.
+If you are using another package which depends on a version of `sharp` that is not the latest,
+please open an issue against that package instead.

 ### Are you using a supported runtime?

@@ -43,15 +44,17 @@ and try again before opening an issue.
 <!-- Please place an [x] in the relevant box to confirm. -->

 - [ ] I am using npm >= 9.6.5 with `--include=optional`
- [ ] I am using yarn >= 3.2.0 and I am not using the "Plug'n'Play" linker
+- [ ] I am using yarn >= 3.2.0
 - [ ] I am using pnpm >= 7.1.0 with `--no-optional=false`
 - [ ] I am using Deno
 - [ ] I am using Bun

-If you cannot confirm any of these,
-please upgrade to the latest version of your chosen package manager
-and ensure you are allowing the installation of optional or multi-platform dependencies
-before opening an issue.
+If you cannot confirm any of these, please upgrade to the latest version of your chosen package manager
+and ensure you are allowing the installation of optional or multi-platform dependencies before opening an issue.
+
+### What is the complete error message, including the full stack trace?
+
+<!-- Please provide the error message and stack trace here. -->

 ### What is the complete output of running `npm install --verbose --foreground-scripts sharp` in an empty directory?

--- a/.github/ISSUE_TEMPLATE/possible-bug.md
+++ b/.github/ISSUE_TEMPLATE/possible-bug.md
@@ -32,6 +32,22 @@ If you are using another package which depends on a version of `sharp` that is n

 <!-- Please provide output of the above command here. -->

+### Does this problem relate to file caching?
+
+The default behaviour of libvips is to cache input files, which can lead to `EBUSY` or `EPERM` errors on Windows.
+Use [`sharp.cache(false)`](https://sharp.pixelplumbing.com/api-utility#cache) to switch this feature off.
+
+- [ ] Adding `sharp.cache(false)` does not fix this problem.
+
+### Does this problem relate to images appearing to have been rotated by 90 degrees?
+
+Images that contain EXIF Orientation metadata are not auto-oriented. By default, EXIF metadata is removed.
+
+- To auto-orient pixel values use the parameter-less [`rotate()`](https://sharp.pixelplumbing.com/api-operation#rotate) operation.
+- To retain EXIF Orientation use [`keepExif()`](https://sharp.pixelplumbing.com/api-output#keepexif).
+
+- [ ] Using `rotate()` or `keepExif()` does not fix this problem.
+
 ### What are the steps to reproduce?

 <!-- Please enter steps to reproduce here. -->
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -16,12 +16,14 @@ jobs:
        include:
          - os: ubuntu-22.04
            container: rockylinux:8
+            nodejs_arch: x64
            nodejs_version: "^18.17.0"
            nodejs_version_major: 18
            platform: linux-x64
            prebuild: true
          - os: ubuntu-22.04
            container: rockylinux:8
+            nodejs_arch: x64
            nodejs_version: "^20.3.0"
            nodejs_version_major: 20
            platform: linux-x64
@@ -45,9 +47,20 @@ jobs:
            nodejs_version: "^20.3.0"
            nodejs_version_major: 20
            platform: darwin-x64
+          - os: macos-14
+            nodejs_arch: arm64
+            nodejs_version: "^18.17.0"
+            nodejs_version_major: 18
+            platform: darwin-arm64
+            prebuild: true
+          - os: macos-14
+            nodejs_arch: arm64
+            nodejs_version: "^20.3.0"
+            nodejs_version_major: 20
+            platform: darwin-arm64
          - os: windows-2019
            nodejs_arch: x86
-            nodejs_version: "^18.17.0"
+            nodejs_version: "18.18.2" # pinned to avoid 18.19.0 and npm 10
            nodejs_version_major: 18
            platform: win32-ia32
            prebuild: true
@@ -68,19 +81,9 @@ jobs:
            nodejs_version_major: 20
            platform: win32-x64
    steps:
-      - name: Dependencies (Linux glibc)
-        if: contains(matrix.container, 'centos')
-        run: |
-          yum install -y https://rpm.nodesource.com/pub_${{ matrix.nodejs_version_major }}.x/nodistro/repo/nodesource-release-nodistro-1.noarch.rpm
-          yum install -y https://packages.endpointdev.com/rhel/7/os/x86_64/endpoint-repo.x86_64.rpm
-          yum install -y centos-release-scl
-          yum install -y devtoolset-11-gcc-c++ make git python3 nodejs fontconfig google-noto-sans-fonts
-          echo "/opt/rh/devtoolset-11/root/usr/bin" >> $GITHUB_PATH
      - name: Dependencies (Rocky Linux glibc)
        if: contains(matrix.container, 'rockylinux')
        run: |
-          dnf install -y https://rpm.nodesource.com/pub_${{ matrix.nodejs_version_major }}.x/nodistro/repo/nodesource-release-nodistro-1.noarch.rpm
-          dnf install -y --setopt=nodesource-nodejs.module_hotfixes=1 nodejs
          dnf install -y gcc-toolset-11-gcc-c++ make git python3 fontconfig google-noto-sans-fonts
          echo "/opt/rh/gcc-toolset-11/root/usr/bin" >> $GITHUB_PATH
      - name: Dependencies (Linux musl)
@@ -88,12 +91,12 @@ jobs:
        run: apk add build-base git python3 font-noto --update-cache
      - name: Dependencies (Python 3.11 - macOS, Windows)
        if: contains(matrix.os, 'macos') || contains(matrix.os, 'windows')
-        uses: actions/setup-python@v4
+        uses: actions/setup-python@v5
        with:
-          python-version: '3.11'
-      - name: Dependencies (Node.js - macOS, Windows)
-        if: contains(matrix.os, 'macos') || contains(matrix.os, 'windows')
-        uses: actions/setup-node@v3
+          python-version: "3.12"
+      - name: Dependencies (Node.js)
+        if: "!contains(matrix.platform, 'linuxmusl')"
+        uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.nodejs_version }}
          architecture: ${{ matrix.nodejs_arch }}
@@ -128,12 +131,14 @@ jobs:
      matrix:
        include:
          - platform: linux-arm
+            distro: buster
            run_on_arch: armv6
            nodejs_arch: armv6l
            nodejs_hostname: unofficial-builds.nodejs.org
            nodejs_version: "18.17.0"
            nodejs_version_major: 18
          - platform: linux-s390x
+            distro: bullseye
            run_on_arch: s390x
            nodejs_arch: s390x
            nodejs_hostname: nodejs.org
@@ -144,7 +149,7 @@ jobs:
      - uses: uraimo/run-on-arch-action@v2
        with:
          arch: ${{ matrix.run_on_arch }}
-          distro: buster
+          distro: ${{ matrix.distro }}
          env: |
            prebuild_upload: "${{ startsWith(github.ref, 'refs/tags/') && secrets.GITHUB_TOKEN || '' }}"
          run: |
@@ -166,18 +171,25 @@ jobs:
      contents: write
    name: wasm32 - prebuild
    runs-on: ubuntu-22.04
-    container: "emscripten/emsdk:3.1.48"
+    container: "emscripten/emsdk:3.1.56"
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Dependencies
        run: apt-get update && apt-get install -y pkg-config
      - name: Dependencies (Node.js)
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
        with:
          node-version: "20"
      - name: Install
        run: emmake npm install --build-from-source
+      - name: Verify emscripten versions match
+        run: |
+          EMSCRIPTEN_VERSION_LIBVIPS=$(node -p "require('@img/sharp-libvips-dev-wasm32/versions').emscripten")
+          EMSCRIPTEN_VERSION_SHARP=$(emcc -dumpversion)
+          echo "libvips built with emscripten $EMSCRIPTEN_VERSION_LIBVIPS"
+          echo "sharp built with emscripten $EMSCRIPTEN_VERSION_SHARP"
+          test "$EMSCRIPTEN_VERSION_LIBVIPS" = "$EMSCRIPTEN_VERSION_SHARP"
      - name: Test
        run: emmake npm test
      - name: Test packaging
@@ -194,48 +206,3 @@ jobs:
          npm_config_nodedir: emscripten
          prebuild_upload: ${{ secrets.GITHUB_TOKEN }}
        run: cd src && ln -s ../package.json && emmake npx prebuild --platform=emscripten --arch=wasm32 --strip=0
-  macstadium-runner:
-    permissions:
-      contents: write
-    name: ${{ matrix.platform }} - Node.js ${{ matrix.nodejs_version_major }} ${{ matrix.prebuild && '- prebuild' }}
-    runs-on: macos-m1
-    strategy:
-      fail-fast: false
-      matrix:
-        include:
-          - nodejs_arch: x64
-            nodejs_version: "^18.17.0"
-            nodejs_version_major: 18
-            platform: darwin-x64
-          - nodejs_arch: arm64
-            nodejs_version: "^18.17.0"
-            nodejs_version_major: 18
-            platform: darwin-arm64
-            prebuild: true
-    defaults:
-      run:
-        shell: /usr/bin/arch -arch arm64e /bin/bash -l {0}
-    steps:
-      - name: Dependencies (Node.js)
-        uses: actions/setup-node@v3
-        with:
-          node-version: ${{ matrix.nodejs_version }}
-          architecture: ${{ matrix.nodejs_arch }}
-      - name: Checkout
-        uses: actions/checkout@v4
-      - name: Install
-        run: npm install --build-from-source
-      - name: Test
-        run: npm test
-      - name: Test packaging
-        run: |
-          npm run package-from-local-build
-          npm pkg set "optionalDependencies.@img/sharp-${{ matrix.platform }}=file:./npm/${{ matrix.platform }}"
-          npm run clean
-          npm install --ignore-scripts
-          npm test
-      - name: Prebuild
-        if: matrix.prebuild && startsWith(github.ref, 'refs/tags/')
-        env:
-          prebuild_upload: ${{ secrets.GITHUB_TOKEN }}
-        run: cd src && ln -s ../package.json && npx prebuild
--- a/.github/workflows/npm.yml
+++ b/.github/workflows/npm.yml
@@ -27,6 +27,10 @@ jobs:
            runs-on: ubuntu-22.04
            runtime: node
            package-manager: yarn
+          - name: linux-x64-node-yarn-pnp
+            runs-on: ubuntu-22.04
+            runtime: node
+            package-manager: yarn-pnp
          - name: linux-x64-deno
            runs-on: ubuntu-22.04
            runtime: deno
@@ -46,6 +50,10 @@ jobs:
            runs-on: macos-11
            runtime: node
            package-manager: yarn
+          - name: darwin-x64-node-yarn-pnp
+            runs-on: macos-11
+            runtime: node
+            package-manager: yarn-pnp
          - name: darwin-x64-deno
            runs-on: macos-11
            runtime: deno
@@ -65,6 +73,10 @@ jobs:
            runs-on: windows-2019
            runtime: node
            package-manager: yarn
+          - name: win32-x64-node-yarn-pnp
+            runs-on: windows-2019
+            runtime: node
+            package-manager: yarn-pnp
          - name: win32-x64-deno
            runs-on: windows-2019
            runtime: deno
@@ -72,7 +84,7 @@ jobs:
    steps:
      - name: Install Node.js
        if: ${{ matrix.runtime == 'node' }}
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: Install pnpm
@@ -98,7 +110,7 @@ jobs:
          script: |
            core.setOutput('semver', context.ref.replace('refs/tags/v',''))
      - name: Create package.json
-        uses: DamianReeves/write-file-action@v1.2
+        uses: DamianReeves/write-file-action@v1.3
        with:
          path: package.json
          contents: |
@@ -109,41 +121,43 @@ jobs:
              "type": "module"
            }
      - name: Create release.mjs
-        uses: DamianReeves/write-file-action@v1.2
+        uses: DamianReeves/write-file-action@v1.3
        with:
          path: release.mjs
          contents: |
            import { deepStrictEqual } from 'node:assert';
            import sharp from 'sharp';
-            deepStrictEqual(['.jpg', '.jpeg', '.jpe'], sharp.format.jpeg.input.fileSuffix);
+            deepStrictEqual(['.jpg', '.jpeg', '.jpe', '.jfif'], sharp.format.jpeg.input.fileSuffix);

      - name: Run with Node.js + npm
-        if: ${{ matrix.runtime == 'node' && matrix.package-manager == 'npm' }}
+        if: ${{ matrix.package-manager == 'npm' }}
        run: |
          npm install --ignore-scripts
          node release.mjs

      - name: Run with Node.js + pnpm
-        if: ${{ matrix.runtime == 'node' && matrix.package-manager == 'pnpm' }}
+        if: ${{ matrix.package-manager == 'pnpm' }}
        run: |
          pnpm install --ignore-scripts
          node release.mjs

      - name: Run with Node.js + yarn
-        if: ${{ matrix.runtime == 'node' && matrix.package-manager == 'yarn' }}
+        if: ${{ matrix.package-manager == 'yarn' }}
        run: |
          corepack enable
          yarn set version stable
+          yarn config set enableImmutableInstalls false
          yarn config set enableScripts false
          yarn config set nodeLinker node-modules
          yarn install
          node release.mjs

      - name: Run with Node.js + yarn pnp
-        if: ${{ matrix.runtime == 'node' && matrix.package-manager == 'yarn' }}
+        if: ${{ matrix.package-manager == 'yarn-pnp' }}
        run: |
          corepack enable
          yarn set version stable
+          yarn config set enableImmutableInstalls false
          yarn config set enableScripts false
          yarn config set nodeLinker pnp
          yarn install
--- a/README.md
+++ b/README.md
@@ -8,7 +8,7 @@ smaller, web-friendly JPEG, PNG, WebP, GIF and AVIF images of varying dimensions

 It can be used with all JavaScript runtimes
 that provide support for Node-API v9, including
-Node.js >= 18.17.0, Deno and Bun.
+Node.js (^18.17.0 or >= 20.3.0), Deno and Bun.

 Resizing an image is typically 4x-5x faster than using the
 quickest ImageMagick and GraphicsMagick settings
--- a/docs/api-colour.md
+++ b/docs/api-colour.md
@@ -66,8 +66,6 @@ The input image will be converted to the provided colourspace at the start of th
 All operations will use this colourspace before converting to the output colourspace,
 as defined by [toColourspace](#tocolourspace).

-This feature is experimental and has not yet been fully-tested with all operations.
-

 **Throws**:

--- a/docs/api-constructor.md
+++ b/docs/api-constructor.md
@@ -66,7 +66,7 @@ where the overall height is the `pageHeight` multiplied by the number of `pages`
 | [options.text.dpi] | <code>number</code> | <code>72</code> | the resolution (size) at which to render the text. Does not take effect if `height` is specified. |
 | [options.text.rgba] | <code>boolean</code> | <code>false</code> | set this to true to enable RGBA output. This is useful for colour emoji rendering, or support for pango markup features like `<span foreground="red">Red!</span>`. |
 | [options.text.spacing] | <code>number</code> | <code>0</code> | text line height in points. Will use the font line height if none is specified. |
-| [options.text.wrap] | <code>string</code> | <code>&quot;&#x27;word&#x27;&quot;</code> | word wrapping style when width is provided, one of: 'word', 'char', 'charWord' (prefer char, fallback to word) or 'none'. |
+| [options.text.wrap] | <code>string</code> | <code>&quot;&#x27;word&#x27;&quot;</code> | word wrapping style when width is provided, one of: 'word', 'char', 'word-char' (prefer word, fallback to char) or 'none'. |

 **Example**  
 ```js
@@ -79,14 +79,16 @@ sharp('input.jpg')
 ```
 **Example**  
 ```js
-// Read image data from readableStream,
+// Read image data from remote URL,
 // resize to 300 pixels wide,
 // emit an 'info' event with calculated dimensions
 // and finally write image data to writableStream
-var transformer = sharp()
+const { body } = fetch('https://...');
+const readableStream = Readable.fromWeb(body);
+const transformer = sharp()
  .resize(300)
-  .on('info', function(info) {
-    console.log('Image height is ' + info.height);
+  .on('info', ({ height }) => {
+    console.log(`Image height is ${height}`);
  });
 readableStream.pipe(transformer).pipe(writableStream);
 ```
--- a/docs/api-operation.md
+++ b/docs/api-operation.md
@@ -18,6 +18,8 @@ The use of `rotate` without an angle will remove the EXIF `Orientation` tag, if
 Only one rotation can occur per pipeline.
 Previous calls to `rotate` in the same pipeline will be ignored.

+Multi-page images can only be rotated by 180 degrees.
+
 Method order is important when rotating, resizing and/or extracting regions,
 for example `.rotate(x).extract(y)` will produce a different result to `.extract(y).rotate(x)`.

--- a/docs/api-output.md
+++ b/docs/api-output.md
@@ -367,10 +367,14 @@ const data = await sharp(input)

 Use these PNG options for output image.

-By default, PNG output is full colour at 8 or 16 bits per pixel.
+By default, PNG output is full colour at 8 bits per pixel.
+
 Indexed PNG input at 1, 2 or 4 bits per pixel is converted to 8 bits per pixel.
 Set `palette` to `true` for slower, indexed PNG output.

+For 16 bits per pixel output, convert to `rgb16` via
+[toColourspace](/api-colour#tocolourspace).
+

 **Throws**:

@@ -405,6 +409,14 @@ const data = await sharp(input)
  .png({ palette: true })
  .toBuffer();
 ```
+**Example**  
+```js
+// Output 16 bits per pixel RGB(A)
+const data = await sharp(input)
+ .toColourspace('rgb16')
+ .png()
+ .toBuffer();
+```


 ## webp
@@ -605,6 +617,7 @@ sharp('input.svg')
 Use these AVIF options for output image.

 AVIF image sequences are not supported.
+Prebuilt binaries support a bitdepth of 8 only.


 **Throws**:
@@ -620,6 +633,7 @@ AVIF image sequences are not supported.
 | [options.lossless] | <code>boolean</code> | <code>false</code> | use lossless compression |
 | [options.effort] | <code>number</code> | <code>4</code> | CPU effort, between 0 (fastest) and 9 (slowest) |
 | [options.chromaSubsampling] | <code>string</code> | <code>&quot;&#x27;4:4:4&#x27;&quot;</code> | set to '4:2:0' to use chroma subsampling |
+| [options.bitdepth] | <code>number</code> | <code>8</code> | set bitdepth to 8, 10 or 12 bit |

 **Example**  
 ```js
@@ -658,6 +672,7 @@ globally-installed libvips compiled with support for libheif, libde265 and x265.
 | [options.lossless] | <code>boolean</code> | <code>false</code> | use lossless compression |
 | [options.effort] | <code>number</code> | <code>4</code> | CPU effort, between 0 (fastest) and 9 (slowest) |
 | [options.chromaSubsampling] | <code>string</code> | <code>&quot;&#x27;4:4:4&#x27;&quot;</code> | set to '4:2:0' to use chroma subsampling |
+| [options.bitdepth] | <code>number</code> | <code>8</code> | set bitdepth to 8, 10 or 12 bit |

 **Example**  
 ```js
@@ -763,7 +778,7 @@ The prebuilt binaries do not include this - see
 | [options.angle] | <code>number</code> | <code>0</code> | tile angle of rotation, must be a multiple of 90. |
 | [options.background] | <code>string</code> \| <code>Object</code> | <code>&quot;{r: 255, g: 255, b: 255, alpha: 1}&quot;</code> | background colour, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to white without transparency. |
 | [options.depth] | <code>string</code> |  | how deep to make the pyramid, possible values are `onepixel`, `onetile` or `one`, default based on layout. |
-| [options.skipBlanks] | <code>number</code> | <code>-1</code> | threshold to skip tile generation, a value 0 - 255 for 8-bit images or 0 - 65535 for 16-bit images |
+| [options.skipBlanks] | <code>number</code> | <code>-1</code> | Threshold to skip tile generation. Range is 0-255 for 8-bit images, 0-65535 for 16-bit images. Default is 5 for `google` layout, -1 (no skip) otherwise. |
 | [options.container] | <code>string</code> | <code>&quot;&#x27;fs&#x27;&quot;</code> | tile container, with value `fs` (filesystem) or `zip` (compressed file). |
 | [options.layout] | <code>string</code> | <code>&quot;&#x27;dz&#x27;&quot;</code> | filesystem layout, possible values are `dz`, `iiif`, `iiif3`, `zoomify` or `google`. |
 | [options.centre] | <code>boolean</code> | <code>false</code> | centre image in tile. |
--- a/docs/api-resize.md
+++ b/docs/api-resize.md
@@ -21,18 +21,22 @@ When using a **fit** of `cover` or `contain`, the default **position** is `centr

 Some of these values are based on the [object-position](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position) CSS property.

-The experimental strategy-based approach resizes so one dimension is at its target length
+The strategy-based approach initially resizes so one dimension is at its target length
 then repeatedly ranks edge regions, discarding the edge with the lowest score based on the selected strategy.
 - `entropy`: focus on the region with the highest [Shannon entropy](https://en.wikipedia.org/wiki/Entropy_%28information_theory%29).
 - `attention`: focus on the region with the highest luminance frequency, colour saturation and presence of skin tones.

-Possible interpolation kernels are:
+Possible downsizing kernels are:
 - `nearest`: Use [nearest neighbour interpolation](http://en.wikipedia.org/wiki/Nearest-neighbor_interpolation).
+- `linear`: Use a [triangle filter](https://en.wikipedia.org/wiki/Triangular_function).
 - `cubic`: Use a [Catmull-Rom spline](https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline).
 - `mitchell`: Use a [Mitchell-Netravali spline](https://www.cs.utexas.edu/~fussell/courses/cs384g-fall2013/lectures/mitchell/Mitchell.pdf).
 - `lanczos2`: Use a [Lanczos kernel](https://en.wikipedia.org/wiki/Lanczos_resampling#Lanczos_kernel) with `a=2`.
 - `lanczos3`: Use a Lanczos kernel with `a=3` (the default).

+When upsampling, these kernels map to `nearest`, `linear` and `cubic` interpolators.
+Downsampling kernels without a matching upsampling interpolator map to `cubic`.
+
 Only one resize can occur per pipeline.
 Previous calls to `resize` in the same pipeline will be ignored.

@@ -52,7 +56,7 @@ Previous calls to `resize` in the same pipeline will be ignored.
 | [options.fit] | <code>String</code> | <code>&#x27;cover&#x27;</code> | How the image should be resized/cropped to fit the target dimension(s), one of `cover`, `contain`, `fill`, `inside` or `outside`. |
 | [options.position] | <code>String</code> | <code>&#x27;centre&#x27;</code> | A position, gravity or strategy to use when `fit` is `cover` or `contain`. |
 | [options.background] | <code>String</code> \| <code>Object</code> | <code>{r: 0, g: 0, b: 0, alpha: 1}</code> | background colour when `fit` is `contain`, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to black without transparency. |
-| [options.kernel] | <code>String</code> | <code>&#x27;lanczos3&#x27;</code> | The kernel to use for image reduction. Use the `fastShrinkOnLoad` option to control kernel vs shrink-on-load. |
+| [options.kernel] | <code>String</code> | <code>&#x27;lanczos3&#x27;</code> | The kernel to use for image reduction and the inferred interpolator to use for upsampling. Use the `fastShrinkOnLoad` option to control kernel vs shrink-on-load. |
 | [options.withoutEnlargement] | <code>Boolean</code> | <code>false</code> | Do not scale up if the width *or* height are already less than the target dimensions, equivalent to GraphicsMagick's `>` geometry option. This may result in output dimensions smaller than the target dimensions. |
 | [options.withoutReduction] | <code>Boolean</code> | <code>false</code> | Do not scale down if the width *or* height are already greater than the target dimensions, equivalent to GraphicsMagick's `<` geometry option. This may still result in a crop to reach the target dimensions. |
 | [options.fastShrinkOnLoad] | <code>Boolean</code> | <code>true</code> | Take greater advantage of the JPEG and WebP shrink-on-load feature, which can lead to a slight moiré pattern or round-down of an auto-scaled dimension. |
--- a/docs/changelog.md
+++ b/docs/changelog.md
@@ -2,9 +2,72 @@

 ## v0.33 - *gauge*

-Requires libvips v8.15.0
+Requires libvips v8.15.2

-### v0.33.1 - TBD
+### v0.33.4 - 16th May 2024
+
+* Remove experimental status from `pipelineColourspace`.
+
+* Reduce default concurrency when musl thread over-subscription detected.
+
+* TypeScript: add missing definitions for `OverlayOptions`.
+  [#4048](https://github.com/lovell/sharp/pull/4048)
+  [@ike-gg](https://github.com/ike-gg)
+
+* Install: add advanced option to force use of a globally-installed libvips.
+  [#4060](https://github.com/lovell/sharp/issues/4060)
+
+* Expose `bilinear` resizing kernel (and interpolator).
+  [#4061](https://github.com/lovell/sharp/issues/4061)
+
+* Ensure `extend` operation stays sequential for multi-page TIFF (regression in 0.32.0).
+  [#4069](https://github.com/lovell/sharp/issues/4069)
+
+* Tighten validation of constructor `text` integer properties.
+  [#4071](https://github.com/lovell/sharp/issues/4071)
+
+* Simplify internal StaySequential logic.
+  [#4074](https://github.com/lovell/sharp/pull/4074)
+  [@kleisauke](https://github.com/kleisauke)
+
+* Ensure negate operation occurs after profile conversion.
+  [#4096](https://github.com/lovell/sharp/pull/4096)
+  [@adriaanmeuris](https://github.com/adriaanmeuris)
+
+### v0.33.3 - 23rd March 2024
+
+* Upgrade to libvips v8.15.2 for upstream bug fixes.
+
+* Ensure `keepIccProfile` retains P3 and CMYK input profiles.
+  [#3906](https://github.com/lovell/sharp/issues/3906)
+  [#4008](https://github.com/lovell/sharp/issues/4008)
+
+* Ensure `text.wrap` property can accept `word-char` as value.
+  [#4028](https://github.com/lovell/sharp/pull/4028)
+  [@yolopunk](https://github.com/yolopunk)
+
+* Ensure `clone` takes a deep copy of existing options.
+  [#4029](https://github.com/lovell/sharp/issues/4029)
+
+* Add `bitdepth` option to `heif` output (prebuilt binaries support 8-bit only).
+  [#4036](https://github.com/lovell/sharp/pull/4036)
+  [@mertalev](https://github.com/mertalev)
+
+### v0.33.2 - 12th January 2024
+
+* Upgrade to libvips v8.15.1 for upstream bug fixes.
+
+* TypeScript: add definition for `keepMetadata`.
+  [#3914](https://github.com/lovell/sharp/pull/3914)
+  [@abhi0498](https://github.com/abhi0498)
+
+* Ensure `extend` operation stays sequential when copying (regression in 0.32.0).
+  [#3928](https://github.com/lovell/sharp/issues/3928)
+
+* Improve error handling for unsupported multi-page rotation.
+  [#3940](https://github.com/lovell/sharp/issues/3940)
+
+### v0.33.1 - 17th December 2023

 * Add support for Yarn Plug'n'Play filesystem layout.
  [#3888](https://github.com/lovell/sharp/issues/3888)
@@ -18,7 +81,7 @@ Requires libvips v8.15.0

 ### v0.33.0 - 29th November 2023

-* Drop support for Node.js 14 and 16, now requires Node.js >= 18.17.0
+* Drop support for Node.js 14 and 16, now requires Node.js ^18.17.0 or >= 20.3.0

 * Prebuilt binaries distributed via npm registry and installed via package manager.

--- a/docs/humans.txt
+++ b/docs/humans.txt
@@ -284,3 +284,12 @@ GitHub: https://github.com/RReverser

 Name: Tamás András Horváth
 GitHub: https://github.com/icetee
+
+Name: Aaron Che
+GitHub: https://github.com/yolopunk
+
+Name: Mert Alev
+GitHub: https://github.com/mertalev
+
+Name: Adriaan Meuris
+GitHub: https://github.com/adriaanmeuris
--- a/docs/index.html
+++ b/docs/index.html
@@ -7,15 +7,13 @@
  <meta name="description" content="Resize large images in common formats to smaller, web-friendly JPEG, PNG, WebP, GIF and AVIF images of varying dimensions">
  <meta property="og:title" content="sharp - High performance Node.js image processing">
  <meta property="og:image" content="https://cdn.jsdelivr.net/gh/lovell/sharp@main/docs/image/sharp-logo-600.png">
-  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; object-src 'none'; style-src 'unsafe-inline';
-    img-src 'unsafe-inline' data: https://cdn.jsdelivr.net/gh/lovell/ https://www.google-analytics.com;
-    connect-src 'self' https://www.google-analytics.com;
-    script-src 'self' 'unsafe-inline' 'unsafe-eval'
-      https://www.google-analytics.com/analytics.js;">
+  <meta http-equiv="Content-Security-Policy" content="default-src 'self'; connect-src 'self'; object-src 'none';
+    style-src 'unsafe-inline';
+    img-src 'unsafe-inline' data: https://cdn.jsdelivr.net/gh/lovell/;
+    script-src 'self' 'unsafe-inline' 'unsafe-eval' https://static.cloudflareinsights.com/beacon.min.js;">
  <link rel="icon" type="image/svg+xml" href="https://cdn.jsdelivr.net/gh/lovell/sharp@main/docs/image/sharp-logo.svg">
  <link rel="icon" type="image/png" sizes="32x32" href="https://cdn.jsdelivr.net/gh/lovell/sharp@main/docs/image/sharp-logo-32.png">
  <link rel="author" href="/humans.txt" type="text/plain">
-  <link rel="dns-prefetch" href="https://www.google-analytics.com">
  <script type="application/ld+json">
  {
    "@context": "https://schema.org",
@@ -67,7 +65,6 @@
  <div id="docute"></div>
  <script src="docute.min.js"></script>
  <script>
-    /* docute-google-analytics@1/dist/index.min.js */ !function(e,n){"object"==typeof exports&&"undefined"!=typeof module?module.exports=n():"function"==typeof define&&define.amd?define(n):(e=e||self).docuteGoogleAnalytics=n()}(this,function(){"use strict";function e(e){var n;window.ga||((n=document.createElement("script")).async=!0,n.src="https://www.google-analytics.com/analytics.js",document.body.appendChild(n),window.ga=window.ga||function(){(ga.q=ga.q||[]).push(arguments)},ga.l=Number(new Date),ga("create",e,"auto"))}function n(n,t){e(t),ga("set","page",n),ga("send","pageview")}return function(e){return{name:"@google-analytics",extend:function(t){!function(e,t){"function"==typeof e?e(function(e){n(e,t)}):e.afterEach(function(e){n(e.fullPath,t)})}(t.router,e)}}}});
    const docuteApiTitlePlugin = {
      name: 'apiTitle',
      extend(api) {
@@ -126,7 +123,6 @@
      detectSystemDarkTheme: true,
      footer: '<a href="https://pixelplumbing.com/" target="_blank">pixelplumbing.com<a>',
      plugins: [
-        docuteGoogleAnalytics('UA-13034748-12'),
        docuteApiTitlePlugin,
        docuteApiSearchPlugin
      ],
--- a/docs/install.md
+++ b/docs/install.md
@@ -35,7 +35,7 @@ deno run --allow-ffi ...

 ## Prerequisites

-* Node-API v9 compatible runtime e.g. Node.js >= 18.17.0
+* Node-API v9 compatible runtime e.g. Node.js ^18.17.0 or >=20.3.0.

 ## Prebuilt binaries

@@ -45,7 +45,7 @@ Ready-compiled sharp and libvips binaries are provided for use on the most commo
 * macOS ARM64
 * Linux ARM (glibc >= 2.28)
 * Linux ARM64 (glibc >= 2.26, musl >= 1.2.2)
-* Linux s390x (glibc >= 2.28)
+* Linux s390x (glibc >= 2.31)
 * Linux x64 (glibc >= 2.26, musl >= 1.2.2, CPU with SSE4.2)
 * Windows x64
 * Windows x86
@@ -61,29 +61,31 @@ for the current OS platform and CPU architecture, where available.
 Some package managers support multiple platforms and architectures
 within the same installation tree and/or using the same lockfile.

-### npm
+### npm v10+

 > ⚠️ **npm `package-lock.json` files can cause installation problems due to [npm bug #4828](https://github.com/npm/cli/issues/4828)**

 Provides limited support via `--os`, `--cpu` and `--libc` flags.

-Example to support both Intel and ARM CPUs on macOS:
+To support macOS with Intel x64 and ARM64 CPUs:
 ```sh
 npm install --cpu=x64 --os=darwin sharp
 npm install --cpu=arm64 --os=darwin sharp
 ```

-Example to support both glibc and musl-based Linux:
+When the cross-target is Linux, the C standard library must be specified.
+
+To support glibc (e.g. Debian) and musl (e.g. Alpine) Linux with Intel x64 CPUs:
 ```sh
-npm install --cpu=x64 --os=linux sharp
+npm install --cpu=x64 --os=linux --libc=glibc sharp
 npm install --cpu=x64 --os=linux --libc=musl sharp
 ```

-### yarn
+### yarn v3+

 Use the [supportedArchitectures](https://yarnpkg.com/configuration/yarnrc#supportedArchitectures) configuration.

-### pnpm
+### pnpm v8+

 Use the [supportedArchitectures](https://pnpm.io/package_json#pnpmsupportedarchitectures) configuration.

@@ -103,14 +105,19 @@ and on macOS when running Node.js under Rosetta.

 This module will be compiled from source at `npm install` time when:

-* a globally-installed libvips is detected (set the `SHARP_IGNORE_GLOBAL_LIBVIPS` environment variable to skip this), or
+* a globally-installed libvips is detected, or
 * when the `npm install --build-from-source` flag is used.

+The logic to detect a globally-installed libvips can be skipped by setting the
+`SHARP_IGNORE_GLOBAL_LIBVIPS` (never try to use it) or
+`SHARP_FORCE_GLOBAL_LIBVIPS` (always try to use it, even when missing or outdated)
+environment variables.
+
 Building from source requires:

 * C++11 compiler
-* [node-addon-api](https://www.npmjs.com/package/node-addon-api)
-* [node-gyp](https://github.com/nodejs/node-gyp#installation) and its dependencies
+* [node-addon-api](https://www.npmjs.com/package/node-addon-api) version 7+
+* [node-gyp](https://github.com/nodejs/node-gyp#installation) version 9+ and its dependencies

 There is an install-time check for these dependencies.
 If `node-addon-api` or `node-gyp` cannot be found, try adding them via:
@@ -173,25 +180,11 @@ must include binaries for either the linux-x64 or linux-arm64 platforms
 depending on the chosen architecture.

 When building your deployment package on a machine that differs from the target architecture,
-you will need to install either `@img/sharp-linux-x64` or `@img/sharp-linux-arm64` package.
+see the [cross-platform](#cross-platform) section to help decide which package manager is appropriate
+and how to configure it.

-```sh
-npm install --os=linux --cpu=x64 sharp
-```
-
-```sh
-npm install --os=linux --cpu=arm64 sharp
-```
-
-When using npm 9 or earlier, this can be achieved using the following:
-
-```sh
-npm install --force @img/sharp-linux-x64
-```
-
-```sh
-npm install --force @img/sharp-linux-arm64
-```
+Some package managers use symbolic links
+but AWS Lambda does not support these within deployment packages.

 To get the best performance select the largest memory available.
 A 1536 MB function provides ~12x more CPU time than a 128 MB function.
@@ -245,6 +238,44 @@ custom:
        - npm install --os=linux --cpu=x64 sharp
 ```

+### electron
+
+Ensure `sharp` is unpacked from the ASAR archive file using the
+[asarUnpack](https://www.electron.build/configuration/configuration.html)
+option.
+
+```json
+{
+  "build": {
+    "asar": true,
+    "asarUnpack": [
+      "**/node_modules/sharp/**/*",
+      "**/node_modules/@img/**/*"
+    ]
+  }
+}
+```
+
+### vite
+
+Ensure `sharp` is excluded from bundling via the
+[build.rollupOptions](https://vitejs.dev/config/build-options.html)
+configuration.
+
+```js
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+  build: {
+    rollupOptions: {
+      external: [
+        "sharp"
+      ]
+    }
+  }
+});
+```
+
 ## TypeScript

 TypeScript definitions are published as part of
--- a/docs/search-index.json
+++ b/docs/search-index.json
--- a/docs/search-index/stop-words.js
+++ b/docs/search-index/stop-words.js
@@ -30,6 +30,7 @@ module.exports = [
  'current',
  'date',
  'default',
+  'deprecated',
  'does',
  'each',
  'either',
@@ -46,6 +47,7 @@ module.exports = [
  'given',
  'has',
  'have',
+  'helps',
  'how',
  'image',
  'implies',
@@ -58,6 +60,7 @@ module.exports = [
  'lots',
  'make',
  'may',
+  'meaning',
  'more',
  'most',
  'much',
@@ -79,6 +82,7 @@ module.exports = [
  'pre',
  'previously',
  'produce',
+  'proper',
  'provide',
  'provided',
  'ready',
@@ -116,6 +120,7 @@ module.exports = [
  'unless',
  'unmaintained',
  'unsuitable',
+  'unsupported',
  'until',
  'use',
  'used',
--- a/install/check.js
+++ b/install/check.js
@@ -10,8 +10,8 @@ try {
    log(msg);
    log('Attempting to build from source via node-gyp');
    try {
-      require('node-addon-api');
-      log('Found node-addon-api');
+      const addonApi = require('node-addon-api');
+      log(`Found node-addon-api ${addonApi.version || ''}`);
    } catch (err) {
      log('Please add node-addon-api to your dependencies');
      return;
--- a/lib/colour.js
+++ b/lib/colour.js
@@ -71,8 +71,6 @@ function grayscale (grayscale) {
 * All operations will use this colourspace before converting to the output colourspace,
 * as defined by {@link #tocolourspace|toColourspace}.
 *
- * This feature is experimental and has not yet been fully-tested with all operations.
- *
 * @since 0.29.0
 *
 * @example
@@ -90,7 +88,7 @@ function pipelineColourspace (colourspace) {
  if (!is.string(colourspace)) {
    throw is.invalidParameterError('colourspace', 'string', colourspace);
  }
-  this.options.colourspaceInput = colourspace;
+  this.options.colourspacePipeline = colourspace;
  return this;
 }

--- a/lib/constructor.js
+++ b/lib/constructor.js
@@ -40,14 +40,16 @@ const debuglog = util.debuglog('sharp');
 *   });
 *
 * @example
- * // Read image data from readableStream,
+ * // Read image data from remote URL,
 * // resize to 300 pixels wide,
 * // emit an 'info' event with calculated dimensions
 * // and finally write image data to writableStream
- * var transformer = sharp()
+ * const { body } = fetch('https://...');
+ * const readableStream = Readable.fromWeb(body);
+ * const transformer = sharp()
 *   .resize(300)
- *   .on('info', function(info) {
- *     console.log('Image height is ' + info.height);
+ *   .on('info', ({ height }) => {
+ *     console.log(`Image height is ${height}`);
 *   });
 * readableStream.pipe(transformer).pipe(writableStream);
 *
@@ -164,7 +166,7 @@ const debuglog = util.debuglog('sharp');
 * @param {number} [options.text.dpi=72] - the resolution (size) at which to render the text. Does not take effect if `height` is specified.
 * @param {boolean} [options.text.rgba=false] - set this to true to enable RGBA output. This is useful for colour emoji rendering, or support for pango markup features like `<span foreground="red">Red!</span>`.
 * @param {number} [options.text.spacing=0] - text line height in points. Will use the font line height if none is specified.
- * @param {string} [options.text.wrap='word'] - word wrapping style when width is provided, one of: 'word', 'char', 'charWord' (prefer char, fallback to word) or 'none'.
+ * @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'.
 * @returns {Sharp}
 * @throws {Error} Invalid parameters
 */
@@ -255,7 +257,7 @@ const Sharp = function (input, options) {
    removeAlpha: false,
    ensureAlpha: -1,
    colourspace: 'srgb',
-    colourspaceInput: 'last',
+    colourspacePipeline: 'last',
    composite: [],
    // output
    fileOut: '',
@@ -323,6 +325,7 @@ const Sharp = function (input, options) {
    heifCompression: 'av1',
    heifEffort: 4,
    heifChromaSubsampling: '4:4:4',
+    heifBitdepth: 8,
    jxlDistance: 1,
    jxlDecodingTier: 0,
    jxlEffort: 7,
@@ -423,13 +426,16 @@ Object.setPrototypeOf(Sharp, stream.Duplex);
 function clone () {
  // Clone existing options
  const clone = this.constructor.call();
-  clone.options = Object.assign({}, this.options);
+  const { debuglog, queueListener, ...options } = this.options;
+  clone.options = structuredClone(options);
+  clone.options.debuglog = debuglog;
+  clone.options.queueListener = queueListener;
  // Pass 'finish' event to clone for Stream-based input
  if (this._isStreamInput()) {
    this.on('finish', () => {
      // Clone inherits input data
      this._flattenBufferIn();
-      clone.options.bufferIn = this.options.bufferIn;
+      clone.options.input.buffer = this.options.input.buffer;
      clone.emit('finish');
    });
  }
--- a/lib/index.d.ts
+++ b/lib/index.d.ts
@@ -341,6 +341,12 @@ declare namespace sharp {
         */
        metadata(): Promise<Metadata>;

+        /**
+         * Keep all metadata (EXIF, ICC, XMP, IPTC) from the input image in the output image.
+         * @returns A sharp instance that can be used to chain operations
+         */
+        keepMetadata(): Sharp;
+
        /**
         * Access to pixel-derived image statistics for every channel in the image.
         * @returns A sharp instance that can be used to chain operations
@@ -1011,7 +1017,7 @@ declare namespace sharp {
        rgba?: boolean;
        /** Text line height in points. Will use the font line height if none is specified. (optional, default `0`) */
        spacing?: number;
-        /** Word wrapping style when width is provided, one of: 'word', 'char', 'charWord' (prefer char, fallback to word) or 'none' */
+        /** Word wrapping style when width is provided, one of: 'word', 'char', 'word-char' (prefer word, fallback to char) or 'none' */
        wrap?: TextWrap;
    }

@@ -1238,6 +1244,8 @@ declare namespace sharp {
        effort?: number | undefined;
        /** set to '4:2:0' to use chroma subsampling, requires libvips v8.11.0 (optional, default '4:4:4') */
        chromaSubsampling?: string | undefined;
+        /** Set bitdepth to 8, 10 or 12 bit (optional, default 8) */
+        bitdepth?: 8 | 10 | 12 | undefined;
    }

    interface HeifOptions extends OutputOptions {
@@ -1251,6 +1259,8 @@ declare namespace sharp {
        effort?: number | undefined;
        /** set to '4:2:0' to use chroma subsampling (optional, default '4:4:4') */
        chromaSubsampling?: string | undefined;
+        /** Set bitdepth to 8, 10 or 12 bit (optional, default 8) */
+        bitdepth?: 8 | 10 | 12 | undefined;
    }

    interface GifOptions extends OutputOptions, AnimationOptions {
@@ -1469,6 +1479,14 @@ declare namespace sharp {
        tile?: boolean | undefined;
        /** Set to true to avoid premultipling 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;
+        /** Set to true to read all frames/pages of an animated image. (optional, default false) */
+        animated?: boolean | undefined;
+        /** see sharp() constructor, (optional, default 'warning') */
+        failOn?: FailOnOptions | undefined;
+        /** see sharp() constructor, (optional, default 268402689) */
+        limitInputPixels?: number | boolean | undefined;
    }

    interface TileOptions {
@@ -1607,7 +1625,7 @@ declare namespace sharp {

    type TextAlign = 'left' | 'centre' | 'center' | 'right';

-    type TextWrap = 'word' | 'char' | 'charWord' | 'none';
+    type TextWrap = 'word' | 'char' | 'word-char' | 'none';

    type TileContainer = 'fs' | 'zip';

--- a/lib/input.js
+++ b/lib/input.js
@@ -296,17 +296,17 @@ function _createInputDescriptor (input, inputOptions, containerOptions) {
          }
        }
        if (is.defined(inputOptions.text.width)) {
-          if (is.number(inputOptions.text.width)) {
+          if (is.integer(inputOptions.text.width) && inputOptions.text.width > 0) {
            inputDescriptor.textWidth = inputOptions.text.width;
          } else {
-            throw is.invalidParameterError('text.textWidth', 'number', inputOptions.text.width);
+            throw is.invalidParameterError('text.width', 'positive integer', inputOptions.text.width);
          }
        }
        if (is.defined(inputOptions.text.height)) {
-          if (is.number(inputOptions.text.height)) {
+          if (is.integer(inputOptions.text.height) && inputOptions.text.height > 0) {
            inputDescriptor.textHeight = inputOptions.text.height;
          } else {
-            throw is.invalidParameterError('text.height', 'number', inputOptions.text.height);
+            throw is.invalidParameterError('text.height', 'positive integer', inputOptions.text.height);
          }
        }
        if (is.defined(inputOptions.text.align)) {
@@ -324,10 +324,10 @@ function _createInputDescriptor (input, inputOptions, containerOptions) {
          }
        }
        if (is.defined(inputOptions.text.dpi)) {
-          if (is.number(inputOptions.text.dpi) && is.inRange(inputOptions.text.dpi, 1, 100000)) {
+          if (is.integer(inputOptions.text.dpi) && is.inRange(inputOptions.text.dpi, 1, 1000000)) {
            inputDescriptor.textDpi = inputOptions.text.dpi;
          } else {
-            throw is.invalidParameterError('text.dpi', 'number between 1 and 100000', inputOptions.text.dpi);
+            throw is.invalidParameterError('text.dpi', 'integer between 1 and 1000000', inputOptions.text.dpi);
          }
        }
        if (is.defined(inputOptions.text.rgba)) {
@@ -338,17 +338,17 @@ function _createInputDescriptor (input, inputOptions, containerOptions) {
          }
        }
        if (is.defined(inputOptions.text.spacing)) {
-          if (is.number(inputOptions.text.spacing)) {
+          if (is.integer(inputOptions.text.spacing) && is.inRange(inputOptions.text.spacing, -1000000, 1000000)) {
            inputDescriptor.textSpacing = inputOptions.text.spacing;
          } else {
-            throw is.invalidParameterError('text.spacing', 'number', inputOptions.text.spacing);
+            throw is.invalidParameterError('text.spacing', 'integer between -1000000 and 1000000', inputOptions.text.spacing);
          }
        }
        if (is.defined(inputOptions.text.wrap)) {
-          if (is.string(inputOptions.text.wrap) && is.inArray(inputOptions.text.wrap, ['word', 'char', 'wordChar', 'none'])) {
+          if (is.string(inputOptions.text.wrap) && is.inArray(inputOptions.text.wrap, ['word', 'char', 'word-char', 'none'])) {
            inputDescriptor.textWrap = inputOptions.text.wrap;
          } else {
-            throw is.invalidParameterError('text.wrap', 'one of: word, char, wordChar, none', inputOptions.text.wrap);
+            throw is.invalidParameterError('text.wrap', 'one of: word, char, word-char, none', inputOptions.text.wrap);
          }
        }
        delete inputDescriptor.buffer;
--- a/lib/libvips.js
+++ b/lib/libvips.js
@@ -7,6 +7,7 @@ const { spawnSync } = require('node:child_process');
 const { createHash } = require('node:crypto');
 const semverCoerce = require('semver/functions/coerce');
 const semverGreaterThanOrEqualTo = require('semver/functions/gte');
+const semverSatisfies = require('semver/functions/satisfies');
 const detectLibc = require('detect-libc');

 const { engines, optionalDependencies } = require('../package.json');
@@ -83,6 +84,15 @@ const buildSharpLibvipsLibDir = () => {
  return '';
 };

+const isUnsupportedNodeRuntime = () => {
+  /* istanbul ignore next */
+  if (process.release?.name === 'node' && process.versions) {
+    if (!semverSatisfies(process.versions.node, engines.node)) {
+      return { found: process.versions.node, expected: engines.node };
+    }
+  }
+};
+
 /* istanbul ignore next */
 const isEmscripten = () => {
  const { CC } = process.env;
@@ -152,15 +162,21 @@ const pkgConfigPath = () => {
  }
 };

+const skipSearch = (status, reason) => {
+  log(`Detected ${reason}, skipping search for globally-installed libvips`);
+  return status;
+};
+
 const useGlobalLibvips = () => {
  if (Boolean(process.env.SHARP_IGNORE_GLOBAL_LIBVIPS) === true) {
-    log('Detected SHARP_IGNORE_GLOBAL_LIBVIPS, skipping search for globally-installed libvips');
-    return false;
+    return skipSearch(false, 'SHARP_IGNORE_GLOBAL_LIBVIPS');
+  }
+  if (Boolean(process.env.SHARP_FORCE_GLOBAL_LIBVIPS) === true) {
+    return skipSearch(true, 'SHARP_FORCE_GLOBAL_LIBVIPS');
  }
  /* istanbul ignore next */
  if (isRosetta()) {
-    log('Detected Rosetta, skipping search for globally-installed libvips');
-    return false;
+    return skipSearch(false, 'Rosetta');
  }
  const globalVipsVersion = globalLibvipsVersion();
  return !!globalVipsVersion && /* istanbul ignore next */
@@ -174,6 +190,7 @@ module.exports = {
  buildSharpLibvipsIncludeDir,
  buildSharpLibvipsCPlusPlusDir,
  buildSharpLibvipsLibDir,
+  isUnsupportedNodeRuntime,
  runtimePlatformArch,
  log,
  yarnLocator,
--- a/lib/operation.js
+++ b/lib/operation.js
@@ -24,6 +24,8 @@ const is = require('./is');
 * Only one rotation can occur per pipeline.
 * Previous calls to `rotate` in the same pipeline will be ignored.
 *
+ * Multi-page images can only be rotated by 180 degrees.
+ *
 * Method order is important when rotating, resizing and/or extracting regions,
 * for example `.rotate(x).extract(y)` will produce a different result to `.extract(y).rotate(x)`.
 *
--- a/lib/output.js
+++ b/lib/output.js
@@ -504,10 +504,14 @@ function jpeg (options) {
 /**
 * Use these PNG options for output image.
 *
- * By default, PNG output is full colour at 8 or 16 bits per pixel.
+ * By default, PNG output is full colour at 8 bits per pixel.
+ *
 * Indexed PNG input at 1, 2 or 4 bits per pixel is converted to 8 bits per pixel.
 * Set `palette` to `true` for slower, indexed PNG output.
 *
+ * For 16 bits per pixel output, convert to `rgb16` via
+ * {@link /api-colour#tocolourspace|toColourspace}.
+ *
 * @example
 * // Convert any input to full colour PNG output
 * const data = await sharp(input)
@@ -520,6 +524,13 @@ function jpeg (options) {
 *   .png({ palette: true })
 *   .toBuffer();
 *
+ * @example
+ * // Output 16 bits per pixel RGB(A)
+ * const data = await sharp(input)
+ *  .toColourspace('rgb16')
+ *  .png()
+ *  .toBuffer();
+ *
 * @param {Object} [options]
 * @param {boolean} [options.progressive=false] - use progressive (interlace) scan
 * @param {number} [options.compressionLevel=6] - zlib compression level, 0 (fastest, largest) to 9 (slowest, smallest)
@@ -1000,6 +1011,7 @@ function tiff (options) {
 * Use these AVIF options for output image.
 *
 * AVIF image sequences are not supported.
+ * Prebuilt binaries support a bitdepth of 8 only.
 *
 * @example
 * const data = await sharp(input)
@@ -1018,6 +1030,7 @@ function tiff (options) {
 * @param {boolean} [options.lossless=false] - use lossless compression
 * @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
 * @returns {Sharp}
 * @throws {Error} Invalid options
 */
@@ -1044,6 +1057,7 @@ function avif (options) {
 * @param {boolean} [options.lossless=false] - use lossless compression
 * @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
 * @returns {Sharp}
 * @throws {Error} Invalid options
 */
@@ -1082,6 +1096,16 @@ function heif (options) {
        throw is.invalidParameterError('chromaSubsampling', 'one of: 4:2:0, 4:4:4', options.chromaSubsampling);
      }
    }
+    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);
+      }
+    }
  } else {
    throw is.invalidParameterError('options', 'Object', options);
  }
@@ -1233,7 +1257,7 @@ function raw (options) {
 * @param {number} [options.angle=0] tile angle of rotation, must be a multiple of 90.
 * @param {string|Object} [options.background={r: 255, g: 255, b: 255, alpha: 1}] - background colour, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to white without transparency.
 * @param {string} [options.depth] how deep to make the pyramid, possible values are `onepixel`, `onetile` or `one`, default based on layout.
- * @param {number} [options.skipBlanks=-1] threshold to skip tile generation, a value 0 - 255 for 8-bit images or 0 - 65535 for 16-bit images
+ * @param {number} [options.skipBlanks=-1] Threshold to skip tile generation. Range is 0-255 for 8-bit images, 0-65535 for 16-bit images. Default is 5 for `google` layout, -1 (no skip) otherwise.
 * @param {string} [options.container='fs'] tile container, with value `fs` (filesystem) or `zip` (compressed file).
 * @param {string} [options.layout='dz'] filesystem layout, possible values are `dz`, `iiif`, `iiif3`, `zoomify` or `google`.
 * @param {boolean} [options.centre=false] centre image in tile.
--- a/lib/resize.js
+++ b/lib/resize.js
@@ -68,6 +68,7 @@ const strategy = {
 */
 const kernel = {
  nearest: 'nearest',
+  linear: 'linear',
  cubic: 'cubic',
  mitchell: 'mitchell',
  lanczos2: 'lanczos2',
@@ -135,18 +136,22 @@ function isResizeExpected (options) {
 *
 * Some of these values are based on the [object-position](https://developer.mozilla.org/en-US/docs/Web/CSS/object-position) CSS property.
 *
- * The experimental strategy-based approach resizes so one dimension is at its target length
+ * The strategy-based approach initially resizes so one dimension is at its target length
 * then repeatedly ranks edge regions, discarding the edge with the lowest score based on the selected strategy.
 * - `entropy`: focus on the region with the highest [Shannon entropy](https://en.wikipedia.org/wiki/Entropy_%28information_theory%29).
 * - `attention`: focus on the region with the highest luminance frequency, colour saturation and presence of skin tones.
 *
- * Possible interpolation kernels are:
+ * Possible downsizing kernels are:
 * - `nearest`: Use [nearest neighbour interpolation](http://en.wikipedia.org/wiki/Nearest-neighbor_interpolation).
+ * - `linear`: Use a [triangle filter](https://en.wikipedia.org/wiki/Triangular_function).
 * - `cubic`: Use a [Catmull-Rom spline](https://en.wikipedia.org/wiki/Centripetal_Catmull%E2%80%93Rom_spline).
 * - `mitchell`: Use a [Mitchell-Netravali spline](https://www.cs.utexas.edu/~fussell/courses/cs384g-fall2013/lectures/mitchell/Mitchell.pdf).
 * - `lanczos2`: Use a [Lanczos kernel](https://en.wikipedia.org/wiki/Lanczos_resampling#Lanczos_kernel) with `a=2`.
 * - `lanczos3`: Use a Lanczos kernel with `a=3` (the default).
 *
+ * When upsampling, these kernels map to `nearest`, `linear` and `cubic` interpolators.
+ * Downsampling kernels without a matching upsampling interpolator map to `cubic`.
+ *
 * Only one resize can occur per pipeline.
 * Previous calls to `resize` in the same pipeline will be ignored.
 *
@@ -239,7 +244,7 @@ function isResizeExpected (options) {
 * @param {String} [options.fit='cover'] - How the image should be resized/cropped to fit the target dimension(s), one of `cover`, `contain`, `fill`, `inside` or `outside`.
 * @param {String} [options.position='centre'] - A position, gravity or strategy to use when `fit` is `cover` or `contain`.
 * @param {String|Object} [options.background={r: 0, g: 0, b: 0, alpha: 1}] - background colour when `fit` is `contain`, parsed by the [color](https://www.npmjs.org/package/color) module, defaults to black without transparency.
- * @param {String} [options.kernel='lanczos3'] - The kernel to use for image reduction. Use the `fastShrinkOnLoad` option to control kernel vs shrink-on-load.
+ * @param {String} [options.kernel='lanczos3'] - The kernel to use for image reduction and the inferred interpolator to use for upsampling. Use the `fastShrinkOnLoad` option to control kernel vs shrink-on-load.
 * @param {Boolean} [options.withoutEnlargement=false] - Do not scale up if the width *or* height are already less than the target dimensions, equivalent to GraphicsMagick's `>` geometry option. This may result in output dimensions smaller than the target dimensions.
 * @param {Boolean} [options.withoutReduction=false] - Do not scale down if the width *or* height are already greater than the target dimensions, equivalent to GraphicsMagick's `<` geometry option. This may still result in a crop to reach the target dimensions.
 * @param {Boolean} [options.fastShrinkOnLoad=true] - Take greater advantage of the JPEG and WebP shrink-on-load feature, which can lead to a slight moiré pattern or round-down of an auto-scaled dimension.
--- a/lib/sharp.js
+++ b/lib/sharp.js
@@ -7,7 +7,7 @@

 const { familySync, versionSync } = require('detect-libc');

-const { runtimePlatformArch, prebuiltPlatforms, minimumLibvipsVersion } = require('./libvips');
+const { runtimePlatformArch, isUnsupportedNodeRuntime, prebuiltPlatforms, minimumLibvipsVersion } = require('./libvips');
 const runtimePlatform = runtimePlatformArch();

 const paths = [
@@ -44,8 +44,16 @@ if (sharp) {
  const messages = errors.map(err => err.message).join(' ');
  help.push('Possible solutions:');
  // Common error messages
-  if (prebuiltPlatforms.includes(runtimePlatform)) {
+  if (isUnsupportedNodeRuntime()) {
+    const { found, expected } = isUnsupportedNodeRuntime();
+    help.push(
+      '- Please upgrade Node.js:',
+      `    Found ${found}`,
+      `    Requires ${expected}`
+    );
+  } else if (prebuiltPlatforms.includes(runtimePlatform)) {
    const [os, cpu] = runtimePlatform.split('-');
+    const libc = os.endsWith('musl') ? ' --libc=musl' : '';
    help.push(
      '- Ensure optional dependencies can be installed:',
      '    npm install --include=optional sharp',
@@ -53,15 +61,14 @@ if (sharp) {
      '- Ensure your package manager supports multi-platform installation:',
      '    See https://sharp.pixelplumbing.com/install#cross-platform',
      '- Add platform-specific dependencies:',
-      `    npm install --os=${os} --cpu=${cpu} sharp`,
-      `    npm install --force @img/sharp-${runtimePlatform}`
+      `    npm install --os=${os.replace('musl', '')}${libc} --cpu=${cpu} sharp`
    );
  } else {
    help.push(
      `- Manually install libvips >= ${minimumLibvipsVersion}`,
      '- Add experimental WebAssembly-based dependencies:',
      '    npm install --cpu=wasm32 sharp',
-      '    npm install --force @img/sharp-wasm32'
+      '    npm install @img/sharp-wasm32'
    );
  }
  if (isLinux && /(symbol not found|CXXABI_)/i.test(messages)) {
--- a/lib/utility.js
+++ b/lib/utility.js
@@ -153,6 +153,9 @@ function concurrency (concurrency) {
 if (detectLibc.familySync() === detectLibc.GLIBC && !sharp._isUsingJemalloc()) {
  // Reduce default concurrency to 1 when using glibc memory allocator
  sharp.concurrency(1);
+} else if (detectLibc.familySync() === detectLibc.MUSL && sharp.concurrency() === 1024) {
+  // Reduce default concurrency when musl thread over-subscription detected
+  sharp.concurrency(require('node:os').availableParallelism());
 }

 /**
--- a/npm/darwin-arm64/package.json
+++ b/npm/darwin-arm64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-darwin-arm64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with macOS 64-bit ARM",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-darwin-arm64": "1.0.0"
+    "@img/sharp-libvips-darwin-arm64": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/darwin-x64/package.json
+++ b/npm/darwin-x64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-darwin-x64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with macOS x64",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-darwin-x64": "1.0.0"
+    "@img/sharp-libvips-darwin-x64": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/linux-arm/package.json
+++ b/npm/linux-arm/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-linux-arm",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Linux (glibc) ARM (32-bit)",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-linux-arm": "1.0.0"
+    "@img/sharp-libvips-linux-arm": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/linux-arm64/package.json
+++ b/npm/linux-arm64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-linux-arm64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Linux (glibc) 64-bit ARM",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-linux-arm64": "1.0.0"
+    "@img/sharp-libvips-linux-arm64": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/linux-s390x/package.json
+++ b/npm/linux-s390x/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-linux-s390x",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Linux (glibc) s390x",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-linux-s390x": "1.0.0"
+    "@img/sharp-libvips-linux-s390x": "1.0.2"
  },
  "files": [
    "lib"
@@ -33,7 +33,7 @@
    "npm": ">=9.6.5",
    "yarn": ">=3.2.0",
    "pnpm": ">=7.1.0",
-    "glibc": ">=2.28"
+    "glibc": ">=2.31"
  },
  "os": [
    "linux"
--- a/npm/linux-x64/package.json
+++ b/npm/linux-x64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-linux-x64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Linux (glibc) x64",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-linux-x64": "1.0.0"
+    "@img/sharp-libvips-linux-x64": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/linuxmusl-arm64/package.json
+++ b/npm/linuxmusl-arm64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-linuxmusl-arm64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Linux (musl) 64-bit ARM",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-linuxmusl-arm64": "1.0.0"
+    "@img/sharp-libvips-linuxmusl-arm64": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/linuxmusl-x64/package.json
+++ b/npm/linuxmusl-x64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-linuxmusl-x64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Linux (musl) x64",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -15,7 +15,7 @@
  },
  "preferUnplugged": true,
  "optionalDependencies": {
-    "@img/sharp-libvips-linuxmusl-x64": "1.0.0"
+    "@img/sharp-libvips-linuxmusl-x64": "1.0.2"
  },
  "files": [
    "lib"
--- a/npm/package.json
+++ b/npm/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "private": "true",
  "workspaces": [
    "darwin-arm64",
--- a/npm/wasm32/package.json
+++ b/npm/wasm32/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-wasm32",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with wasm32",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
@@ -34,7 +34,7 @@
    "pnpm": ">=7.1.0"
  },
  "dependencies": {
-    "@emnapi/runtime": "^0.44.0"
+    "@emnapi/runtime": "^1.1.1"
  },
  "cpu": [
    "wasm32"
--- a/npm/win32-ia32/package.json
+++ b/npm/win32-ia32/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-win32-ia32",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Windows x86 (32-bit)",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
--- a/npm/win32-x64/package.json
+++ b/npm/win32-x64/package.json
@@ -1,6 +1,6 @@
 {
  "name": "@img/sharp-win32-x64",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "description": "Prebuilt sharp for use with Windows x64",
  "author": "Lovell Fuller <npm@lovell.info>",
  "homepage": "https://sharp.pixelplumbing.com",
--- a/package.json
+++ b/package.json
@@ -1,9 +1,9 @@
 {
  "name": "sharp",
  "description": "High performance Node.js image processing, the fastest module to resize JPEG, PNG, WebP, GIF, AVIF and TIFF images",
-  "version": "0.33.1-rc.1",
+  "version": "0.33.4",
  "author": "Lovell Fuller <npm@lovell.info>",
-  "homepage": "https://github.com/lovell/sharp",
+  "homepage": "https://sharp.pixelplumbing.com",
  "contributors": [
    "Pierre Inglebert <pierre.inglebert@gmail.com>",
    "Jonathan Ong <jonathanrichardong@gmail.com>",
@@ -82,7 +82,7 @@
    "Joris Dugué <zaruike10@gmail.com>",
    "Chris Banks <christopher.bradley.banks@gmail.com>",
    "Ompal Singh <ompal.hitm09@gmail.com>",
-    "Brodan <christopher.hranj@gmail.com",
+    "Brodan <christopher.hranj@gmail.com>",
    "Ankur Parihar <ankur.github@gmail.com>",
    "Brahim Ait elhaj <brahima@gmail.com>",
    "Mart Jansink <m.jansink@gmail.com>",
@@ -137,57 +137,57 @@
  ],
  "dependencies": {
    "color": "^4.2.3",
-    "detect-libc": "^2.0.2",
-    "semver": "^7.5.4"
+    "detect-libc": "^2.0.3",
+    "semver": "^7.6.0"
  },
  "optionalDependencies": {
-    "@img/sharp-darwin-arm64": "0.33.1-rc.1",
-    "@img/sharp-darwin-x64": "0.33.1-rc.1",
-    "@img/sharp-libvips-darwin-arm64": "1.0.0",
-    "@img/sharp-libvips-darwin-x64": "1.0.0",
-    "@img/sharp-libvips-linux-arm": "1.0.0",
-    "@img/sharp-libvips-linux-arm64": "1.0.0",
-    "@img/sharp-libvips-linux-s390x": "1.0.0",
-    "@img/sharp-libvips-linux-x64": "1.0.0",
-    "@img/sharp-libvips-linuxmusl-arm64": "1.0.0",
-    "@img/sharp-libvips-linuxmusl-x64": "1.0.0",
-    "@img/sharp-linux-arm": "0.33.1-rc.1",
-    "@img/sharp-linux-arm64": "0.33.1-rc.1",
-    "@img/sharp-linux-s390x": "0.33.1-rc.1",
-    "@img/sharp-linux-x64": "0.33.1-rc.1",
-    "@img/sharp-linuxmusl-arm64": "0.33.1-rc.1",
-    "@img/sharp-linuxmusl-x64": "0.33.1-rc.1",
-    "@img/sharp-wasm32": "0.33.1-rc.1",
-    "@img/sharp-win32-ia32": "0.33.1-rc.1",
-    "@img/sharp-win32-x64": "0.33.1-rc.1"
+    "@img/sharp-darwin-arm64": "0.33.4",
+    "@img/sharp-darwin-x64": "0.33.4",
+    "@img/sharp-libvips-darwin-arm64": "1.0.2",
+    "@img/sharp-libvips-darwin-x64": "1.0.2",
+    "@img/sharp-libvips-linux-arm": "1.0.2",
+    "@img/sharp-libvips-linux-arm64": "1.0.2",
+    "@img/sharp-libvips-linux-s390x": "1.0.2",
+    "@img/sharp-libvips-linux-x64": "1.0.2",
+    "@img/sharp-libvips-linuxmusl-arm64": "1.0.2",
+    "@img/sharp-libvips-linuxmusl-x64": "1.0.2",
+    "@img/sharp-linux-arm": "0.33.4",
+    "@img/sharp-linux-arm64": "0.33.4",
+    "@img/sharp-linux-s390x": "0.33.4",
+    "@img/sharp-linux-x64": "0.33.4",
+    "@img/sharp-linuxmusl-arm64": "0.33.4",
+    "@img/sharp-linuxmusl-x64": "0.33.4",
+    "@img/sharp-wasm32": "0.33.4",
+    "@img/sharp-win32-ia32": "0.33.4",
+    "@img/sharp-win32-x64": "0.33.4"
  },
  "devDependencies": {
-    "@emnapi/runtime": "^0.44.0",
-    "@img/sharp-libvips-dev": "1.0.0",
-    "@img/sharp-libvips-dev-wasm32": "1.0.0",
-    "@img/sharp-libvips-win32-ia32": "1.0.0",
-    "@img/sharp-libvips-win32-x64": "1.0.0",
+    "@emnapi/runtime": "^1.1.1",
+    "@img/sharp-libvips-dev": "1.0.2",
+    "@img/sharp-libvips-dev-wasm32": "1.0.3",
+    "@img/sharp-libvips-win32-ia32": "1.0.2",
+    "@img/sharp-libvips-win32-x64": "1.0.2",
    "@types/node": "*",
    "async": "^3.2.5",
    "cc": "^3.0.1",
-    "emnapi": "^0.44.0",
-    "exif-reader": "^2.0.0",
+    "emnapi": "^1.1.1",
+    "exif-reader": "^2.0.1",
    "extract-zip": "^2.0.1",
    "icc": "^3.0.0",
-    "jsdoc-to-markdown": "^8.0.0",
+    "jsdoc-to-markdown": "^8.0.1",
    "license-checker": "^25.0.1",
-    "mocha": "^10.2.0",
-    "node-addon-api": "^7.0.0",
+    "mocha": "^10.4.0",
+    "node-addon-api": "^8.0.0",
    "nyc": "^15.1.0",
-    "prebuild": "^12.1.0",
+    "prebuild": "^13.0.1",
    "semistandard": "^17.0.0",
-    "tar-fs": "^3.0.4",
-    "tsd": "^0.29.0"
+    "tar-fs": "^3.0.6",
+    "tsd": "^0.31.0"
  },
  "license": "Apache-2.0",
  "engines": {
    "node": "^18.17.0 || ^20.3.0 || >=21.0.0",
-    "libvips": ">=8.15.0"
+    "libvips": ">=8.15.2"
  },
  "funding": {
    "url": "https://opencollective.com/libvips"
--- a/src/common.cc
+++ b/src/common.cc
@@ -75,7 +75,7 @@ namespace sharp {
      Napi::Buffer<char> buffer = input.Get("buffer").As<Napi::Buffer<char>>();
      descriptor->bufferLength = buffer.Length();
      descriptor->buffer = buffer.Data();
-      descriptor->isBuffer = TRUE;
+      descriptor->isBuffer = true;
    }
    descriptor->failOn = AttrAsEnum<VipsFailOn>(input, "failOn", VIPS_TYPE_FAIL_ON);
    // Density for vector-based input
@@ -384,7 +384,7 @@ namespace sharp {
              ->set("access", descriptor->access)
              ->set("fail_on", descriptor->failOn);
            if (descriptor->unlimited && ImageTypeSupportsUnlimited(imageType)) {
-              option->set("unlimited", TRUE);
+              option->set("unlimited", true);
            }
            if (imageType == ImageType::SVG || imageType == ImageType::PDF) {
              option->set("dpi", descriptor->density);
@@ -488,7 +488,7 @@ namespace sharp {
              ->set("access", descriptor->access)
              ->set("fail_on", descriptor->failOn);
            if (descriptor->unlimited && ImageTypeSupportsUnlimited(imageType)) {
-              option->set("unlimited", TRUE);
+              option->set("unlimited", true);
            }
            if (imageType == ImageType::SVG || imageType == ImageType::PDF) {
              option->set("dpi", descriptor->density);
@@ -768,7 +768,7 @@ namespace sharp {
        int *timeout = VIPS_NEW(im, int);
        *timeout = seconds;
        g_signal_connect(im, "eval", G_CALLBACK(VipsProgressCallBack), timeout);
-        vips_image_set_progress(im, TRUE);
+        vips_image_set_progress(im, true);
      }
    }
  }
@@ -778,7 +778,7 @@ namespace sharp {
  */
  void VipsProgressCallBack(VipsImage *im, VipsProgress *progress, int *timeout) {
    if (*timeout > 0 && progress->run >= *timeout) {
-      vips_image_set_kill(im, TRUE);
+      vips_image_set_kill(im, true);
      vips_error("timeout", "%d%% complete", progress->percent);
      *timeout = 0;
    }
@@ -1081,9 +1081,10 @@ namespace sharp {
  /*
    Ensure decoding remains sequential.
  */
-  VImage StaySequential(VImage image, VipsAccess access, bool condition) {
-    if (access == VIPS_ACCESS_SEQUENTIAL && condition) {
-      return image.copy_memory();
+  VImage StaySequential(VImage image, bool condition) {
+    if (vips_image_is_sequential(image.get_image()) && condition) {
+      image = image.copy_memory().copy();
+      image.remove(VIPS_META_SEQUENTIAL);
    }
    return image;
  }
--- a/src/common.h
+++ b/src/common.h
@@ -16,8 +16,8 @@

 #if (VIPS_MAJOR_VERSION < 8) || \
  (VIPS_MAJOR_VERSION == 8 && VIPS_MINOR_VERSION < 15) || \
-  (VIPS_MAJOR_VERSION == 8 && VIPS_MINOR_VERSION == 15 && VIPS_MICRO_VERSION < 0)
-#error "libvips version 8.15.0+ is required - please see https://sharp.pixelplumbing.com/install"
+  (VIPS_MAJOR_VERSION == 8 && VIPS_MINOR_VERSION == 15 && VIPS_MICRO_VERSION < 2)
+#error "libvips version 8.15.2+ is required - please see https://sharp.pixelplumbing.com/install"
 #endif

 #if ((!defined(__clang__)) && defined(__GNUC__) && (__GNUC__ < 4 || (__GNUC__ == 4 && __GNUC_MINOR__ < 6)))
@@ -79,12 +79,12 @@ namespace sharp {
      buffer(nullptr),
      failOn(VIPS_FAIL_ON_WARNING),
      limitInputPixels(0x3FFF * 0x3FFF),
-      unlimited(FALSE),
+      unlimited(false),
      access(VIPS_ACCESS_RANDOM),
      bufferLength(0),
-      isBuffer(FALSE),
+      isBuffer(false),
      density(72.0),
-      ignoreIcc(FALSE),
+      ignoreIcc(false),
      rawDepth(VIPS_FORMAT_UCHAR),
      rawChannels(0),
      rawWidth(0),
@@ -103,9 +103,9 @@ namespace sharp {
      textWidth(0),
      textHeight(0),
      textAlign(VIPS_ALIGN_LOW),
-      textJustify(FALSE),
+      textJustify(false),
      textDpi(72),
-      textRgba(FALSE),
+      textRgba(false),
      textSpacing(0),
      textWrap(VIPS_TEXT_WRAP_WORD),
      textAutofitDpi(0) {}
@@ -386,7 +386,7 @@ namespace sharp {
  /*
    Ensure decoding remains sequential.
  */
-  VImage StaySequential(VImage image, VipsAccess access, bool condition = TRUE);
+  VImage StaySequential(VImage image, bool condition = true);

 }  // namespace sharp

--- a/src/operations.cc
+++ b/src/operations.cc
@@ -155,7 +155,7 @@ namespace sharp {
      return image.conv(blur);
    } else {
      // Slower, accurate Gaussian blur
-      return StaySequential(image, VIPS_ACCESS_SEQUENTIAL).gaussblur(sigma);
+      return StaySequential(image).gaussblur(sigma);
    }
  }

@@ -386,7 +386,7 @@ namespace sharp {
      pages.reserve(nPages);

      // Split the image into cropped frames
-      image = StaySequential(image, VIPS_ACCESS_SEQUENTIAL);
+      image = StaySequential(image);
      for (int i = 0; i < nPages; i++) {
        pages.push_back(
          image.extract_area(left, *pageHeight * i + top, width, height));
--- a/src/pipeline.cc
+++ b/src/pipeline.cc
@@ -54,7 +54,7 @@ class PipelineWorker : public Napi::AsyncWorker {
      sharp::ImageType inputImageType;
      std::tie(image, inputImageType) = sharp::OpenInput(baton->input);
      VipsAccess access = baton->input->access;
-      image = sharp::EnsureColourspace(image, baton->colourspaceInput);
+      image = sharp::EnsureColourspace(image, baton->colourspacePipeline);

      int nPages = baton->input->pages;
      if (nPages == -1) {
@@ -70,8 +70,8 @@ class PipelineWorker : public Napi::AsyncWorker {
      // Calculate angle of rotation
      VipsAngle rotation = VIPS_ANGLE_D0;
      VipsAngle autoRotation = VIPS_ANGLE_D0;
-      bool autoFlip = FALSE;
-      bool autoFlop = FALSE;
+      bool autoFlip = false;
+      bool autoFlop = false;

      if (baton->useExifOrientation) {
        // Rotate and flip image according to Exif orientation
@@ -88,7 +88,7 @@ class PipelineWorker : public Napi::AsyncWorker {
          baton->rotationAngle != 0.0);

      if (shouldRotateBefore) {
-        image = sharp::StaySequential(image, access,
+        image = sharp::StaySequential(image,
          rotation != VIPS_ANGLE_D0 ||
          autoRotation != VIPS_ANGLE_D0 ||
          autoFlip ||
@@ -96,31 +96,37 @@ class PipelineWorker : public Napi::AsyncWorker {
          baton->rotationAngle != 0.0);

        if (autoRotation != VIPS_ANGLE_D0) {
+          if (autoRotation != VIPS_ANGLE_D180) {
+            MultiPageUnsupported(nPages, "Rotate");
+          }
          image = image.rot(autoRotation);
          autoRotation = VIPS_ANGLE_D0;
        }
        if (autoFlip) {
          image = image.flip(VIPS_DIRECTION_VERTICAL);
-          autoFlip = FALSE;
+          autoFlip = false;
        } else if (baton->flip) {
          image = image.flip(VIPS_DIRECTION_VERTICAL);
-          baton->flip = FALSE;
+          baton->flip = false;
        }
        if (autoFlop) {
          image = image.flip(VIPS_DIRECTION_HORIZONTAL);
-          autoFlop = FALSE;
+          autoFlop = false;
        } else if (baton->flop) {
          image = image.flip(VIPS_DIRECTION_HORIZONTAL);
-          baton->flop = FALSE;
+          baton->flop = false;
        }
        if (rotation != VIPS_ANGLE_D0) {
+          if (rotation != VIPS_ANGLE_D180) {
+            MultiPageUnsupported(nPages, "Rotate");
+          }
          image = image.rot(rotation);
          rotation = VIPS_ANGLE_D0;
        }
        if (baton->rotationAngle != 0.0) {
          MultiPageUnsupported(nPages, "Rotate");
          std::vector<double> background;
-          std::tie(image, background) = sharp::ApplyAlpha(image, baton->rotationBackground, FALSE);
+          std::tie(image, background) = sharp::ApplyAlpha(image, baton->rotationBackground, false);
          image = image.rotate(baton->rotationAngle, VImage::option()->set("background", background)).copy_memory();
        }
      }
@@ -128,7 +134,7 @@ class PipelineWorker : public Napi::AsyncWorker {
      // Trim
      if (baton->trimThreshold >= 0.0) {
        MultiPageUnsupported(nPages, "Trim");
-        image = sharp::StaySequential(image, access);
+        image = sharp::StaySequential(image);
        image = sharp::Trim(image, baton->trimBackground, baton->trimThreshold, baton->trimLineArt);
        baton->trimOffsetLeft = image.xoffset();
        baton->trimOffsetTop = image.yoffset();
@@ -183,7 +189,7 @@ class PipelineWorker : public Napi::AsyncWorker {
      //  - input colourspace is not specified;
      bool const shouldPreShrink = (targetResizeWidth > 0 || targetResizeHeight > 0) &&
        baton->gamma == 0 && baton->topOffsetPre == -1 && baton->trimThreshold < 0.0 &&
-        baton->colourspaceInput == VIPS_INTERPRETATION_LAST && !shouldRotateBefore;
+        baton->colourspacePipeline == VIPS_INTERPRETATION_LAST && !shouldRotateBefore;

      if (shouldPreShrink) {
        // The common part of the shrink: the bit by which both axes must be shrunk
@@ -325,12 +331,13 @@ class PipelineWorker : public Napi::AsyncWorker {
        sharp::HasProfile(image) &&
        image.interpretation() != VIPS_INTERPRETATION_LABS &&
        image.interpretation() != VIPS_INTERPRETATION_GREY16 &&
+        baton->colourspacePipeline != VIPS_INTERPRETATION_CMYK &&
        !baton->input->ignoreIcc
      ) {
        // Convert to sRGB/P3 using embedded profile
        try {
          image = image.icc_transform(processingProfile, VImage::option()
-            ->set("embedded", TRUE)
+            ->set("embedded", true)
            ->set("depth", sharp::Is16Bit(image.interpretation()) ? 16 : 8)
            ->set("intent", VIPS_INTENT_PERCEPTUAL));
        } catch(...) {
@@ -338,7 +345,7 @@ class PipelineWorker : public Napi::AsyncWorker {
        }
      } else if (
        image.interpretation() == VIPS_INTERPRETATION_CMYK &&
-        baton->colourspaceInput != VIPS_INTERPRETATION_CMYK
+        baton->colourspacePipeline != VIPS_INTERPRETATION_CMYK
      ) {
        image = image.icc_transform(processingProfile, VImage::option()
          ->set("input_profile", "cmyk")
@@ -350,11 +357,6 @@ class PipelineWorker : public Napi::AsyncWorker {
        image = sharp::Flatten(image, baton->flattenBackground);
      }

-      // Negate the colours in the image
-      if (baton->negate) {
-        image = sharp::Negate(image, baton->negateAlpha);
-      }
-
      // Gamma encoding (darken)
      if (baton->gamma >= 1 && baton->gamma <= 3) {
        image = sharp::Gamma(image, 1.0 / baton->gamma);
@@ -390,13 +392,16 @@ class PipelineWorker : public Napi::AsyncWorker {
          ->set("kernel", baton->kernel));
      }

-      image = sharp::StaySequential(image, access,
+      image = sharp::StaySequential(image,
        autoRotation != VIPS_ANGLE_D0 ||
        baton->flip ||
        autoFlip ||
        rotation != VIPS_ANGLE_D0);
      // Auto-rotate post-extract
      if (autoRotation != VIPS_ANGLE_D0) {
+        if (autoRotation != VIPS_ANGLE_D180) {
+          MultiPageUnsupported(nPages, "Rotate");
+        }
        image = image.rot(autoRotation);
      }
      // Mirror vertically (up-down) about the x-axis
@@ -409,6 +414,9 @@ class PipelineWorker : public Napi::AsyncWorker {
      }
      // Rotate post-extract 90-angle
      if (rotation != VIPS_ANGLE_D0) {
+        if (rotation != VIPS_ANGLE_D180) {
+          MultiPageUnsupported(nPages, "Rotate");
+        }
        image = image.rot(rotation);
      }

@@ -420,7 +428,7 @@ class PipelineWorker : public Napi::AsyncWorker {
        for (unsigned int i = 0; i < baton->joinChannelIn.size(); i++) {
          baton->joinChannelIn[i]->access = access;
          std::tie(joinImage, joinImageType) = sharp::OpenInput(baton->joinChannelIn[i]);
-          joinImage = sharp::EnsureColourspace(joinImage, baton->colourspaceInput);
+          joinImage = sharp::EnsureColourspace(joinImage, baton->colourspacePipeline);
          image = image.bandjoin(joinImage);
        }
        image = image.copy(VImage::option()->set("interpretation", baton->colourspace));
@@ -487,7 +495,7 @@ class PipelineWorker : public Napi::AsyncWorker {

            // Attention-based or Entropy-based crop
            MultiPageUnsupported(nPages, "Resize strategy");
-            image = sharp::StaySequential(image, access);
+            image = sharp::StaySequential(image);
            image = image.smartcrop(baton->width, baton->height, VImage::option()
              ->set("interesting", baton->position == 16 ? VIPS_INTERESTING_ENTROPY : VIPS_INTERESTING_ATTENTION)
              ->set("premultiplied", shouldPremultiplyAlpha)
@@ -506,7 +514,7 @@ class PipelineWorker : public Napi::AsyncWorker {
      // Rotate post-extract non-90 angle
      if (!baton->rotateBeforePreExtract && baton->rotationAngle != 0.0) {
        MultiPageUnsupported(nPages, "Rotate");
-        image = sharp::StaySequential(image, access);
+        image = sharp::StaySequential(image);
        std::vector<double> background;
        std::tie(image, background) = sharp::ApplyAlpha(image, baton->rotationBackground, shouldPremultiplyAlpha);
        image = image.rotate(baton->rotationAngle, VImage::option()->set("background", background));
@@ -530,7 +538,7 @@ class PipelineWorker : public Napi::AsyncWorker {
      // Affine transform
      if (!baton->affineMatrix.empty()) {
        MultiPageUnsupported(nPages, "Affine");
-        image = sharp::StaySequential(image, access);
+        image = sharp::StaySequential(image);
        std::vector<double> background;
        std::tie(image, background) = sharp::ApplyAlpha(image, baton->affineBackground, shouldPremultiplyAlpha);
        vips::VInterpolate interp = vips::VInterpolate::new_from_name(
@@ -553,6 +561,7 @@ class PipelineWorker : public Napi::AsyncWorker {
          std::vector<double> background;
          std::tie(image, background) = sharp::ApplyAlpha(image, baton->extendBackground, shouldPremultiplyAlpha);

+          image = sharp::StaySequential(image, nPages > 1);
          image = nPages > 1
            ? sharp::EmbedMultiPage(image,
                baton->extendLeft, baton->extendTop, baton->width, baton->height,
@@ -561,6 +570,7 @@ class PipelineWorker : public Napi::AsyncWorker {
                VImage::option()->set("extend", baton->extendWith)->set("background", background));
        } else {
          std::vector<double> ignoredBackground(1);
+          image = sharp::StaySequential(image);
          image = nPages > 1
            ? sharp::EmbedMultiPage(image,
                baton->extendLeft, baton->extendTop, baton->width, baton->height,
@@ -629,7 +639,7 @@ class PipelineWorker : public Napi::AsyncWorker {
          sharp::ImageType compositeImageType = sharp::ImageType::UNKNOWN;
          composite->input->access = access;
          std::tie(compositeImage, compositeImageType) = sharp::OpenInput(composite->input);
-          compositeImage = sharp::EnsureColourspace(compositeImage, baton->colourspaceInput);
+          compositeImage = sharp::EnsureColourspace(compositeImage, baton->colourspacePipeline);
          // Verify within current dimensions
          if (compositeImage.width() > image.width() || compositeImage.height() > image.height()) {
            throw vips::VError("Image to composite must have same dimensions or smaller");
@@ -656,7 +666,7 @@ class PipelineWorker : public Napi::AsyncWorker {
            if (across != 0 || down != 0) {
              int left;
              int top;
-              compositeImage = sharp::StaySequential(compositeImage, access).replicate(across, down);
+              compositeImage = sharp::StaySequential(compositeImage).replicate(across, down);
              if (composite->hasOffset) {
                std::tie(left, top) = sharp::CalculateCrop(
                  compositeImage.width(), compositeImage.height(), image.width(), image.height(),
@@ -714,13 +724,13 @@ class PipelineWorker : public Napi::AsyncWorker {

      // Apply normalisation - stretch luminance to cover full dynamic range
      if (baton->normalise) {
-        image = sharp::StaySequential(image, access);
+        image = sharp::StaySequential(image);
        image = sharp::Normalise(image, baton->normaliseLower, baton->normaliseUpper);
      }

      // Apply contrast limiting adaptive histogram equalization (CLAHE)
      if (baton->claheWidth != 0 && baton->claheHeight != 0) {
-        image = sharp::StaySequential(image, access);
+        image = sharp::StaySequential(image);
        image = sharp::Clahe(image, baton->claheWidth, baton->claheHeight, baton->claheMaxSlope);
      }

@@ -730,7 +740,7 @@ class PipelineWorker : public Napi::AsyncWorker {
        sharp::ImageType booleanImageType = sharp::ImageType::UNKNOWN;
        baton->boolean->access = access;
        std::tie(booleanImage, booleanImageType) = sharp::OpenInput(baton->boolean);
-        booleanImage = sharp::EnsureColourspace(booleanImage, baton->colourspaceInput);
+        booleanImage = sharp::EnsureColourspace(booleanImage, baton->colourspacePipeline);
        image = sharp::Boolean(image, booleanImage, baton->booleanOp);
        image = sharp::RemoveGifPalette(image);
      }
@@ -763,10 +773,10 @@ class PipelineWorker : public Napi::AsyncWorker {
        // Convert colourspace, pass the current known interpretation so libvips doesn't have to guess
        image = image.colourspace(baton->colourspace, VImage::option()->set("source_space", image.interpretation()));
        // Transform colours from embedded profile to output profile
-        if ((baton->keepMetadata & VIPS_FOREIGN_KEEP_ICC) &&
+        if ((baton->keepMetadata & VIPS_FOREIGN_KEEP_ICC) && baton->colourspacePipeline != VIPS_INTERPRETATION_CMYK &&
          baton->withIccProfile.empty() && sharp::HasProfile(image)) {
-          image = image.icc_transform("srgb", VImage::option()
-            ->set("embedded", TRUE)
+          image = image.icc_transform(processingProfile, VImage::option()
+            ->set("embedded", true)
            ->set("depth", sharp::Is16Bit(image.interpretation()) ? 16 : 8)
            ->set("intent", VIPS_INTENT_PERCEPTUAL));
        }
@@ -797,7 +807,7 @@ class PipelineWorker : public Napi::AsyncWorker {
        try {
          image = image.icc_transform(const_cast<char*>(baton->withIccProfile.data()), VImage::option()
            ->set("input_profile", processingProfile)
-            ->set("embedded", TRUE)
+            ->set("embedded", true)
            ->set("depth", sharp::Is16Bit(image.interpretation()) ? 16 : 8)
            ->set("intent", VIPS_INTENT_PERCEPTUAL));
        } catch(...) {
@@ -806,6 +816,12 @@ class PipelineWorker : public Napi::AsyncWorker {
      } else if (baton->keepMetadata & VIPS_FOREIGN_KEEP_ICC) {
        image = sharp::SetProfile(image, inputProfile);
      }
+
+      // Negate the colours in the image
+      if (baton->negate) {
+        image = sharp::Negate(image, baton->negateAlpha);
+      }
+
      // Override EXIF Orientation tag
      if (baton->withMetadataOrientation != -1) {
        image = sharp::SetExifOrientation(image, baton->withMetadataOrientation);
@@ -975,7 +991,7 @@ class PipelineWorker : public Napi::AsyncWorker {
            ->set("Q", baton->heifQuality)
            ->set("compression", baton->heifCompression)
            ->set("effort", baton->heifEffort)
-            ->set("bitdepth", 8)
+            ->set("bitdepth", baton->heifBitdepth)
            ->set("subsample_mode", baton->heifChromaSubsampling == "4:4:4"
              ? VIPS_FOREIGN_SUBSAMPLE_OFF : VIPS_FOREIGN_SUBSAMPLE_ON)
            ->set("lossless", baton->heifLossless)));
@@ -990,7 +1006,7 @@ class PipelineWorker : public Napi::AsyncWorker {
          if (!sharp::HasAlpha(image)) {
            baton->tileBackground.pop_back();
          }
-          image = sharp::StaySequential(image, access, baton->tileAngle != 0);
+          image = sharp::StaySequential(image, baton->tileAngle != 0);
          vips::VOption *options = BuildOptionsDZ(baton);
          VipsArea *area = reinterpret_cast<VipsArea*>(image.dzsave_buffer(options));
          baton->bufferOut = static_cast<char*>(area->data);
@@ -1168,7 +1184,7 @@ class PipelineWorker : public Napi::AsyncWorker {
            ->set("Q", baton->heifQuality)
            ->set("compression", baton->heifCompression)
            ->set("effort", baton->heifEffort)
-            ->set("bitdepth", 8)
+            ->set("bitdepth", baton->heifBitdepth)
            ->set("subsample_mode", baton->heifChromaSubsampling == "4:4:4"
              ? VIPS_FOREIGN_SUBSAMPLE_OFF : VIPS_FOREIGN_SUBSAMPLE_ON)
            ->set("lossless", baton->heifLossless));
@@ -1192,7 +1208,7 @@ class PipelineWorker : public Napi::AsyncWorker {
          if (!sharp::HasAlpha(image)) {
            baton->tileBackground.pop_back();
          }
-          image = sharp::StaySequential(image, access, baton->tileAngle != 0);
+          image = sharp::StaySequential(image, baton->tileAngle != 0);
          vips::VOption *options = BuildOptionsDZ(baton);
          image.dzsave(const_cast<char*>(baton->fileOut.data()), options);
          baton->formatOut = "dz";
@@ -1324,16 +1340,16 @@ class PipelineWorker : public Napi::AsyncWorker {
  std::tuple<VipsAngle, bool, bool>
  CalculateExifRotationAndFlip(int const exifOrientation) {
    VipsAngle rotate = VIPS_ANGLE_D0;
-    bool flip = FALSE;
-    bool flop = FALSE;
+    bool flip = false;
+    bool flop = false;
    switch (exifOrientation) {
      case 6: rotate = VIPS_ANGLE_D90; break;
      case 3: rotate = VIPS_ANGLE_D180; break;
      case 8: rotate = VIPS_ANGLE_D270; break;
-      case 2: flop = TRUE; break;  // flop 1
-      case 7: flip = TRUE; rotate = VIPS_ANGLE_D90; break;  // flip 6
-      case 4: flop = TRUE; rotate = VIPS_ANGLE_D180; break;  // flop 3
-      case 5: flip = TRUE; rotate = VIPS_ANGLE_D270; break;  // flip 8
+      case 2: flop = true; break;  // flop 1
+      case 7: flip = true; rotate = VIPS_ANGLE_D90; break;  // flip 6
+      case 4: flop = true; rotate = VIPS_ANGLE_D180; break;  // flop 3
+      case 5: flip = true; rotate = VIPS_ANGLE_D270; break;  // flip 8
    }
    return std::make_tuple(rotate, flip, flop);
  }
@@ -1381,7 +1397,7 @@ class PipelineWorker : public Napi::AsyncWorker {
    std::string suffix;
    if (baton->tileFormat == "png") {
      std::vector<std::pair<std::string, std::string>> options {
-        {"interlace", baton->pngProgressive ? "TRUE" : "FALSE"},
+        {"interlace", baton->pngProgressive ? "true" : "false"},
        {"compression", std::to_string(baton->pngCompressionLevel)},
        {"filter", baton->pngAdaptiveFiltering ? "all" : "none"}
      };
@@ -1390,25 +1406,25 @@ class PipelineWorker : public Napi::AsyncWorker {
      std::vector<std::pair<std::string, std::string>> options {
        {"Q", std::to_string(baton->webpQuality)},
        {"alpha_q", std::to_string(baton->webpAlphaQuality)},
-        {"lossless", baton->webpLossless ? "TRUE" : "FALSE"},
-        {"near_lossless", baton->webpNearLossless ? "TRUE" : "FALSE"},
-        {"smart_subsample", baton->webpSmartSubsample ? "TRUE" : "FALSE"},
+        {"lossless", baton->webpLossless ? "true" : "false"},
+        {"near_lossless", baton->webpNearLossless ? "true" : "false"},
+        {"smart_subsample", baton->webpSmartSubsample ? "true" : "false"},
        {"preset", vips_enum_nick(VIPS_TYPE_FOREIGN_WEBP_PRESET, baton->webpPreset)},
-        {"min_size", baton->webpMinSize ? "TRUE" : "FALSE"},
-        {"mixed", baton->webpMixed ? "TRUE" : "FALSE"},
+        {"min_size", baton->webpMinSize ? "true" : "false"},
+        {"mixed", baton->webpMixed ? "true" : "false"},
        {"effort", std::to_string(baton->webpEffort)}
      };
      suffix = AssembleSuffixString(".webp", options);
    } else {
      std::vector<std::pair<std::string, std::string>> options {
        {"Q", std::to_string(baton->jpegQuality)},
-        {"interlace", baton->jpegProgressive ? "TRUE" : "FALSE"},
+        {"interlace", baton->jpegProgressive ? "true" : "false"},
        {"subsample_mode", baton->jpegChromaSubsampling == "4:4:4" ? "off" : "on"},
-        {"trellis_quant", baton->jpegTrellisQuantisation ? "TRUE" : "FALSE"},
+        {"trellis_quant", baton->jpegTrellisQuantisation ? "true" : "false"},
        {"quant_table", std::to_string(baton->jpegQuantisationTable)},
-        {"overshoot_deringing", baton->jpegOvershootDeringing ? "TRUE": "FALSE"},
-        {"optimize_scans", baton->jpegOptimiseScans ? "TRUE": "FALSE"},
-        {"optimize_coding", baton->jpegOptimiseCoding ? "TRUE": "FALSE"}
+        {"overshoot_deringing", baton->jpegOvershootDeringing ? "true": "false"},
+        {"optimize_scans", baton->jpegOptimiseScans ? "true": "false"},
+        {"optimize_coding", baton->jpegOptimiseCoding ? "true": "false"}
      };
      std::string extname = baton->tileLayout == VIPS_FOREIGN_DZ_LAYOUT_DZ ? ".jpeg" : ".jpg";
      suffix = AssembleSuffixString(extname, options);
@@ -1594,10 +1610,10 @@ Napi::Value pipeline(const Napi::CallbackInfo& info) {
       baton->recombMatrix[i] = sharp::AttrAsDouble(recombMatrix, i);
    }
  }
-  baton->colourspaceInput = sharp::AttrAsEnum<VipsInterpretation>(
-    options, "colourspaceInput", VIPS_TYPE_INTERPRETATION);
-  if (baton->colourspaceInput == VIPS_INTERPRETATION_ERROR) {
-    baton->colourspaceInput = VIPS_INTERPRETATION_LAST;
+  baton->colourspacePipeline = sharp::AttrAsEnum<VipsInterpretation>(
+    options, "colourspacePipeline", VIPS_TYPE_INTERPRETATION);
+  if (baton->colourspacePipeline == VIPS_INTERPRETATION_ERROR) {
+    baton->colourspacePipeline = VIPS_INTERPRETATION_LAST;
  }
  baton->colourspace = sharp::AttrAsEnum<VipsInterpretation>(options, "colourspace", VIPS_TYPE_INTERPRETATION);
  if (baton->colourspace == VIPS_INTERPRETATION_ERROR) {
@@ -1682,6 +1698,7 @@ Napi::Value pipeline(const Napi::CallbackInfo& info) {
    options, "heifCompression", VIPS_TYPE_FOREIGN_HEIF_COMPRESSION);
  baton->heifEffort = sharp::AttrAsUint32(options, "heifEffort");
  baton->heifChromaSubsampling = sharp::AttrAsStr(options, "heifChromaSubsampling");
+  baton->heifBitdepth = sharp::AttrAsUint32(options, "heifBitdepth");
  baton->jxlDistance = sharp::AttrAsDouble(options, "jxlDistance");
  baton->jxlDecodingTier = sharp::AttrAsUint32(options, "jxlDecodingTier");
  baton->jxlEffort = sharp::AttrAsUint32(options, "jxlEffort");
--- a/src/pipeline.h
+++ b/src/pipeline.h
@@ -181,6 +181,7 @@ struct PipelineBaton {
  int heifEffort;
  std::string heifChromaSubsampling;
  bool heifLossless;
+  int heifBitdepth;
  double jxlDistance;
  int jxlDecodingTier;
  int jxlEffort;
@@ -205,7 +206,7 @@ struct PipelineBaton {
  int extractChannel;
  bool removeAlpha;
  double ensureAlpha;
-  VipsInterpretation colourspaceInput;
+  VipsInterpretation colourspacePipeline;
  VipsInterpretation colourspace;
  std::vector<int> delay;
  int loop;
@@ -349,6 +350,7 @@ struct PipelineBaton {
    heifEffort(4),
    heifChromaSubsampling("4:4:4"),
    heifLossless(false),
+    heifBitdepth(8),
    jxlDistance(1.0),
    jxlDecodingTier(0),
    jxlEffort(7),
@@ -369,7 +371,7 @@ struct PipelineBaton {
    extractChannel(-1),
    removeAlpha(false),
    ensureAlpha(-1.0),
-    colourspaceInput(VIPS_INTERPRETATION_LAST),
+    colourspacePipeline(VIPS_INTERPRETATION_LAST),
    colourspace(VIPS_INTERPRETATION_LAST),
    loop(-1),
    tileSize(256),
--- a/test/fixtures/XCMYK
+++ b/test/fixtures/XCMYK
--- a/test/fixtures/expected/colourspace.cmyk-to-cmyk-negated.tif
+++ b/test/fixtures/expected/colourspace.cmyk-to-cmyk-negated.tif
--- a/test/fixtures/expected/negate-trans.png
+++ b/test/fixtures/expected/negate-trans.png
--- a/test/fixtures/fogra-0-100-100-0.tif
+++ b/test/fixtures/fogra-0-100-100-0.tif
--- a/test/fixtures/index.js
+++ b/test/fixtures/index.js
@@ -114,6 +114,7 @@ module.exports = {
  inputTiffUncompressed: getPath('uncompressed_tiff.tiff'), // https://code.google.com/archive/p/imagetestsuite/wikis/TIFFTestSuite.wiki file: 0c84d07e1b22b76f24cccc70d8788e4a.tif
  inputTiff8BitDepth: getPath('8bit_depth.tiff'),
  inputTifftagPhotoshop: getPath('tifftag-photoshop.tiff'), // https://github.com/lovell/sharp/issues/1600
+  inputTiffFogra: getPath('fogra-0-100-100-0.tif'), // https://github.com/lovell/sharp/issues/4045

  inputJp2: getPath('relax.jp2'), // https://www.fnordware.com/j2k/relax.jp2
  inputGif: getPath('Crash_test.gif'), // http://upload.wikimedia.org/wikipedia/commons/e/e3/Crash_test.gif
--- a/test/types/sharp.test-d.ts
+++ b/test/types/sharp.test-d.ts
@@ -44,6 +44,12 @@ sharp('input.png')
    // sharpened, with metadata, 90% quality WebP image data. Phew!
  });

+sharp('input.png')
+  .keepMetadata()
+  .toFile('output.png', (err, info) => {
+    // output.png is an image containing input.png along with all metadata(EXIF, ICC, XMP, IPTC) from input.png
+  })
+
 sharp('input.jpg')
  .resize(300, 200)
  .toFile('output.jpg', (err: Error) => {
@@ -404,7 +410,7 @@ sharp({

 // Taken from API documentation at
 // https://sharp.pixelplumbing.com/api-operation#clahe
-// introducted
+// introduced
 sharp('input.jpg').clahe({ width: 10, height: 10 }).toFile('output.jpg');

 sharp('input.jpg').clahe({ width: 10, height: 10, maxSlope: 5 }).toFile('outfile.jpg');
@@ -589,7 +595,7 @@ sharp({
    rgba: true,
    justify: true,
    spacing: 10,
-    wrap: 'charWord',
+    wrap: 'word-char',
  },
 })
  .png()
@@ -674,3 +680,24 @@ sharp(input)
  .keepIccProfile()
  .withIccProfile('filename')
  .withIccProfile('filename', { attach: false });
+
+// Added missing types for OverlayOptions
+// https://github.com/lovell/sharp/pull/4048
+sharp(input).composite([
+  {
+    input: 'image.gif', 
+    animated: true, 
+    limitInputPixels: 536805378, 
+    density: 144, 
+    failOn: "warning"
+  }
+])
+sharp(input).composite([
+  {
+    input: 'image.png',  
+    animated: false,
+    limitInputPixels: 178935126, 
+    density: 72, 
+    failOn: "truncated"
+  }
+])
--- a/test/unit/avif.js
+++ b/test/unit/avif.js
@@ -144,4 +144,10 @@ describe('AVIF', () => {
      /Processed image is too large for the HEIF format/
    )
  );
+
+  it('Invalid bitdepth value throws error', async () => {
+    assert.rejects(
+      () => sharp().avif({ bitdepth: 11 }),
+      /Error: Expected 8, 10 or 12 for bitdepth but received 11 of type number/);
+  });
 });
--- a/test/unit/clone.js
+++ b/test/unit/clone.js
@@ -77,4 +77,26 @@ describe('Clone', function () {
    assert.strictEqual(0, original.listenerCount('finish'));
    assert.strictEqual(0, clone.listenerCount('finish'));
  });
+
+  it('Ensure deep clone of properties, including arrays', async () => {
+    const alpha = await sharp({
+      create: { width: 320, height: 240, channels: 3, background: 'red' }
+    }).toColourspace('b-w').png().toBuffer();
+
+    const original = sharp();
+    const joiner = original.clone().joinChannel(alpha);
+    const negater = original.clone().negate();
+
+    fs.createReadStream(fixtures.inputJpg320x240).pipe(original);
+    const joined = await joiner.png({ effort: 1 }).toBuffer();
+    const negated = await negater.png({ effort: 1 }).toBuffer();
+
+    const joinedMetadata = await sharp(joined).metadata();
+    assert.strictEqual(joinedMetadata.channels, 4);
+    assert.strictEqual(joinedMetadata.hasAlpha, true);
+
+    const negatedMetadata = await sharp(negated).metadata();
+    assert.strictEqual(negatedMetadata.channels, 3);
+    assert.strictEqual(negatedMetadata.hasAlpha, false);
+  });
 });
--- a/test/unit/colourspace.js
+++ b/test/unit/colourspace.js
@@ -106,6 +106,43 @@ describe('Colour space conversion', function () {
    );
  });

+  it('CMYK profile to CMYK profile conversion using perceptual intent', async () => {
+    const data = await sharp(fixtures.inputTiffFogra)
+      .resize(320, 240)
+      .toColourspace('cmyk')
+      .pipelineColourspace('cmyk')
+      .withIccProfile(fixtures.path('XCMYK 2017.icc'))
+      .raw()
+      .toBuffer();
+
+    const [c, m, y, k] = data;
+    assert.deepStrictEqual(
+      { c, m, y, k },
+      { c: 1, m: 239, y: 227, k: 5 }
+    );
+  });
+
+  it('CMYK profile to CMYK profile with negate', (done) => {
+    sharp(fixtures.inputTiffFogra)
+      .resize(320, 240)
+      .toColourspace('cmyk')
+      .pipelineColourspace('cmyk')
+      .withIccProfile(fixtures.path('XCMYK 2017.icc'))
+      .negate()
+      .toBuffer(function (err, data, info) {
+        if (err) throw err;
+        assert.strictEqual('tiff', info.format);
+        assert.strictEqual(320, info.width);
+        assert.strictEqual(240, info.height);
+        fixtures.assertSimilar(
+          fixtures.expected('colourspace.cmyk-to-cmyk-negated.tif'),
+          data,
+          { threshold: 0 },
+          done
+        );
+      });
+  });
+
  it('From sRGB with RGB16 pipeline, resize with gamma, to sRGB', function (done) {
    sharp(fixtures.inputPngGradients)
      .pipelineColourspace('rgb16')
--- a/test/unit/composite.js
+++ b/test/unit/composite.js
@@ -451,7 +451,7 @@ describe('composite', () => {
    assert.strictEqual(info.height, 40);
  });

-  it('Ensure implict unpremultiply after resize but before composite', async () => {
+  it('Ensure implicit unpremultiply after resize but before composite', async () => {
    const [r, g, b, a] = await sharp({
      create: {
        width: 1, height: 1, channels: 4, background: 'saddlebrown'
--- a/test/unit/extend.js
+++ b/test/unit/extend.js
@@ -113,6 +113,39 @@ describe('Extend', function () {
    });
  });

+  it('extend top with mirroring uses ordered read', async () => {
+    const data = await sharp(fixtures.inputJpg)
+      .extend({
+        extendWith: 'mirror',
+        top: 1
+      })
+      .png({ compressionLevel: 0 })
+      .toBuffer();
+
+    const { width, height } = await sharp(data).metadata();
+    assert.strictEqual(2725, width);
+    assert.strictEqual(2226, height);
+  });
+
+  it('multi-page extend uses ordered read', async () => {
+    const multiPageTiff = await sharp(fixtures.inputGifAnimated, { animated: true })
+      .resize({ width: 8, height: 48 })
+      .tiff()
+      .toBuffer();
+
+    const data = await sharp(multiPageTiff, { pages: -1 })
+      .extend({
+        background: 'red',
+        top: 1
+      })
+      .png({ compressionLevel: 0 })
+      .toBuffer();
+
+    const { width, height } = await sharp(data).metadata();
+    assert.strictEqual(8, width);
+    assert.strictEqual(1470, height);
+  });
+
  it('missing parameter fails', function () {
    assert.throws(function () {
      sharp().extend();
--- a/test/unit/heif.js
+++ b/test/unit/heif.js
@@ -78,4 +78,21 @@ describe('HEIF', () => {
      sharp().heif({ compression: 'av1', chromaSubsampling: '4:4:4' });
    });
  });
+  it('valid bitdepth value does not throw an error', () => {
+    const { heif } = sharp.versions;
+    delete sharp.versions.heif;
+    assert.doesNotThrow(() => {
+      sharp().heif({ compression: 'av1', bitdepth: 12 });
+    });
+    sharp.versions.heif = '1.2.3';
+    assert.throws(() => {
+      sharp().heif({ compression: 'av1', bitdepth: 10 });
+    }, /Error: Expected 8 for bitdepth when using prebuilt binaries but received 10 of type number/);
+    sharp.versions.heif = heif;
+  });
+  it('invalid bitdepth value should throw an error', () => {
+    assert.throws(() => {
+      sharp().heif({ compression: 'av1', bitdepth: 11 });
+    }, /Error: Expected 8, 10 or 12 for bitdepth but received 11 of type number/);
+  });
 });
--- a/test/unit/libvips.js
+++ b/test/unit/libvips.js
@@ -66,6 +66,14 @@ describe('libvips binaries', function () {

      delete process.env.SHARP_IGNORE_GLOBAL_LIBVIPS;
    });
+    it('useGlobalLibvips can be forced via an env var', function () {
+      process.env.SHARP_FORCE_GLOBAL_LIBVIPS = 1;
+
+      const useGlobalLibvips = libvips.useGlobalLibvips();
+      assert.strictEqual(true, useGlobalLibvips);
+
+      delete process.env.SHARP_FORCE_GLOBAL_LIBVIPS;
+    });
  });

  describe('Build time platform detection', () => {
@@ -123,6 +131,9 @@ describe('libvips binaries', function () {
      const [, arch] = libvips.runtimePlatformArch().split('-');
      assert.strict(['arm', 'arm64', 'ia32', 'x64'].includes(arch));
    });
+    it('isUnsupportedNodeRuntime', () => {
+      assert.strictEqual(libvips.isUnsupportedNodeRuntime(), undefined);
+    });
  });

  describe('logger', function () {
@@ -159,7 +170,7 @@ describe('libvips binaries', function () {
      process.env.npm_config_arch = 's390x';
      process.env.npm_config_libc = '';
      const locatorHash = libvips.yarnLocator();
-      assert.strictEqual(locatorHash, '86cc8ee6e4');
+      assert.strictEqual(locatorHash, '45978c229d');
      delete process.env.npm_config_platform;
      delete process.env.npm_config_arch;
      delete process.env.npm_config_libc;
--- a/test/unit/metadata.js
+++ b/test/unit/metadata.js
@@ -576,6 +576,19 @@ describe('Image metadata', function () {
    assert.strictEqual(description, 'Generic RGB Profile');
  });

+  it('keep existing CMYK ICC profile', async () => {
+    const data = await sharp(fixtures.inputJpgWithCmykProfile)
+      .pipelineColourspace('cmyk')
+      .toColourspace('cmyk')
+      .keepIccProfile()
+      .toBuffer();
+
+    const metadata = await sharp(data).metadata();
+    assert.strictEqual(metadata.channels, 4);
+    const { description } = icc.parse(metadata.icc);
+    assert.strictEqual(description, 'U.S. Web Coated (SWOP) v2');
+  });
+
  it('transform to ICC profile and attach', async () => {
    const data = await sharp({ create })
      .png()
--- a/test/unit/rotate.js
+++ b/test/unit/rotate.js
@@ -353,6 +353,21 @@ describe('Rotation', function () {
    )
  );

+  it('Animated image rotate 180', () =>
+    assert.doesNotReject(() => sharp(fixtures.inputGifAnimated, { animated: true })
+      .rotate(180)
+      .toBuffer()
+    )
+  );
+
+  it('Animated image rotate non-180 rejects', () =>
+    assert.rejects(() => sharp(fixtures.inputGifAnimated, { animated: true })
+      .rotate(90)
+      .toBuffer(),
+    /Rotate is not supported for multi-page images/
+    )
+  );
+
  it('Multiple rotate emits warning', () => {
    let warningMessage = '';
    const s = sharp();
--- a/test/unit/text.js
+++ b/test/unit/text.js
@@ -228,26 +228,34 @@ describe('Text to image', function () {
    });
  });

-  it('bad width input', function () {
-    assert.throws(function () {
-      sharp({
-        text: {
-          text: 'text',
-          width: 'bad'
-        }
-      });
-    });
+  it('invalid width', () => {
+    assert.throws(
+      () => sharp({ text: { text: 'text', width: 'bad' } }),
+      /Expected positive integer for text\.width but received bad of type string/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', width: 0.1 } }),
+      /Expected positive integer for text\.width but received 0.1 of type number/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', width: -1 } }),
+      /Expected positive integer for text\.width but received -1 of type number/
+    );
  });

-  it('bad height input', function () {
-    assert.throws(function () {
-      sharp({
-        text: {
-          text: 'text',
-          height: 'bad'
-        }
-      });
-    });
+  it('invalid height', () => {
+    assert.throws(
+      () => sharp({ text: { text: 'text', height: 'bad' } }),
+      /Expected positive integer for text\.height but received bad of type string/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', height: 0.1 } }),
+      /Expected positive integer for text\.height but received 0.1 of type number/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', height: -1 } }),
+      /Expected positive integer for text\.height but received -1 of type number/
+    );
  });

  it('bad align input', function () {
@@ -272,15 +280,19 @@ describe('Text to image', function () {
    });
  });

-  it('bad dpi input', function () {
-    assert.throws(function () {
-      sharp({
-        text: {
-          text: 'text',
-          dpi: -10
-        }
-      });
-    });
+  it('invalid dpi', () => {
+    assert.throws(
+      () => sharp({ text: { text: 'text', dpi: 'bad' } }),
+      /Expected integer between 1 and 1000000 for text\.dpi but received bad of type string/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', dpi: 0.1 } }),
+      /Expected integer between 1 and 1000000 for text\.dpi but received 0.1 of type number/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', dpi: -1 } }),
+      /Expected integer between 1 and 1000000 for text\.dpi but received -1 of type number/
+    );
  });

  it('bad rgba input', function () {
@@ -294,15 +306,19 @@ describe('Text to image', function () {
    });
  });

-  it('bad spacing input', function () {
-    assert.throws(function () {
-      sharp({
-        text: {
-          text: 'text',
-          spacing: 'number expected'
-        }
-      });
-    });
+  it('invalid spacing', () => {
+    assert.throws(
+      () => sharp({ text: { text: 'text', spacing: 'bad' } }),
+      /Expected integer between -1000000 and 1000000 for text\.spacing but received bad of type string/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', spacing: 0.1 } }),
+      /Expected integer between -1000000 and 1000000 for text\.spacing but received 0.1 of type number/
+    );
+    assert.throws(
+      () => sharp({ text: { text: 'text', spacing: -1000001 } }),
+      /Expected integer between -1000000 and 1000000 for text\.spacing but received -1000001 of type number/
+    );
  });

  it('only height or dpi not both', function () {
@@ -319,21 +335,21 @@ describe('Text to image', function () {

  it('valid wrap throws', () => {
    assert.doesNotThrow(() => sharp({ text: { text: 'text', wrap: 'none' } }));
-    assert.doesNotThrow(() => sharp({ text: { text: 'text', wrap: 'wordChar' } }));
+    assert.doesNotThrow(() => sharp({ text: { text: 'text', wrap: 'word-char' } }));
  });

  it('invalid wrap throws', () => {
    assert.throws(
      () => sharp({ text: { text: 'text', wrap: 1 } }),
-      /Expected one of: word, char, wordChar, none for text\.wrap but received 1 of type number/
+      /Expected one of: word, char, word-char, none for text\.wrap but received 1 of type number/
    );
    assert.throws(
      () => sharp({ text: { text: 'text', wrap: false } }),
-      /Expected one of: word, char, wordChar, none for text\.wrap but received false of type boolean/
+      /Expected one of: word, char, word-char, none for text\.wrap but received false of type boolean/
    );
    assert.throws(
      () => sharp({ text: { text: 'text', wrap: 'invalid' } }),
-      /Expected one of: word, char, wordChar, none for text\.wrap but received invalid of type string/
+      /Expected one of: word, char, word-char, none for text\.wrap but received invalid of type string/
    );
  });
 });
--- a/test/unit/util.js
+++ b/test/unit/util.js
@@ -134,7 +134,7 @@ describe('Utilities', function () {
      });
    });
    it('input fileSuffix', function () {
-      assert.deepStrictEqual(['.jpg', '.jpeg', '.jpe'], sharp.format.jpeg.input.fileSuffix);
+      assert.deepStrictEqual(['.jpg', '.jpeg', '.jpe', '.jfif'], sharp.format.jpeg.input.fileSuffix);
    });
    it('output alias', function () {
      assert.deepStrictEqual(['jpe', 'jpg'], sharp.format.jpeg.output.alias);
Author	SHA1	Message	Date
Lovell Fuller	19d0e272e6	Release v0.33.4	2024-05-16 12:48:29 +01:00
Lovell Fuller	16b764f1c1	Prerelease v0.33.4-rc.0	2024-05-16 12:16:41 +01:00
Lovell Fuller	1593ee3838	Bump devDeps	2024-05-16 12:15:49 +01:00
Lovell Fuller	668b5ba8bc	Docs: changelog and credit for #4096	2024-05-14 16:59:20 +01:00
Adriaan Meuris	29336f4cc7	Ensure negate op occurs after profile conversion (#4096 ) - Adds CMYK to CMYK profile conversion tests - Fixes existing greyscale plus alpha test expectation	2024-05-13 12:23:11 +01:00
Lovell Fuller	b5fddd7c5e	Install: log node-addon-api version if available	2024-05-10 10:43:15 +01:00
Lovell Fuller	da655a1859	Reduce default concurrency for musl thread over-subscription https://github.com/lovell/sharp-libvips/issues/229	2024-04-30 19:23:44 +01:00
Lovell Fuller	93c615d39f	Bump devDeps	2024-04-30 19:23:36 +01:00
Lovell Fuller	f325dc3ec9	Refactor to use C++ boolean literals rather than macros	2024-04-30 19:23:31 +01:00
Skyf0l	0fde71c783	Ensure all contributor email addresses are valid (#4088 )	2024-04-28 18:17:44 +01:00
Lovell Fuller	9c8fbaa1cc	Issue template: fix markdown links from `a9e662e`	2024-04-25 11:31:45 +01:00
Lovell Fuller	a9e662e612	Issue template: add a couple of the most commonly-reported problems This should allow more people to help themselves and prevent extraneous issues from being opened.	2024-04-25 11:25:14 +01:00
Lovell Fuller	ba843002be	Docs: use libc flag for npm Linux cross-installs	2024-04-24 08:30:50 +01:00
Lovell Fuller	7f3d452bc5	Docs: changelog and credit for #4074	2024-04-19 15:21:21 +01:00
Kleis Auke Wolthuizen	aa8bc19362	Simplify StaySequential operation (#4074 )	2024-04-19 14:47:49 +01:00
Lovell Fuller	36e60bf040	CI: Upgrade linux-s390x to Debian 11 Debian LTS does not include s390x and Debian 10 is EOL so this platform will now require a minimum version of glibc 2.31.	2024-04-19 13:13:48 +01:00
Lovell Fuller	a1309aa3b8	Tighten constructor text property validation #4071	2024-04-19 12:48:47 +01:00
Lovell Fuller	3e8a0fc522	Ensure only one StaySequential operation per pipeline This should reduce memory consumption for more complex pipelines that combine multiple operations without sequential access support e.g. flip and Gaussian blur.	2024-04-19 11:27:54 +01:00
Lovell Fuller	397ee492d9	Ensure extend op is sequential for multi-page TIFF #4069	2024-04-18 11:05:04 +01:00
Lovell Fuller	52b9dc0f63	Docs: add a few more stop-words	2024-04-11 10:31:38 +01:00
Lovell Fuller	a715c73fc2	Docs: remove GA, allow for possible use of CF	2024-04-11 10:23:27 +01:00
Lovell Fuller	579cf93030	Install: advanced option to force global libvips #4060	2024-04-10 09:25:53 +01:00
Lovell Fuller	f67228e5ea	Remove experimental status from pipelineColourspace	2024-04-09 22:32:17 +01:00
Lovell Fuller	6257994746	Expose bilinear resize kernel and improve docs #4061	2024-04-09 22:21:52 +01:00
Lovell Fuller	7950fc0ea3	Docs: changelog entry for #4048	2024-04-02 19:23:11 +01:00
Lovell Fuller	fc93ab3b82	Bump devDeps	2024-04-02 19:22:42 +01:00
ike	0981b24f60	TypeScript: add missing definitions for OverlayOptions (#4048 )	2024-04-02 14:42:10 +01:00
Lovell Fuller	02fd565476	CI: bump write-file-action	2024-03-29 13:01:51 +00:00
Lovell Fuller	e55bb93b10	Bump devDeps	2024-03-29 13:01:32 +00:00
Lovell Fuller	55466f122c	Release v0.33.3	2024-03-23 11:58:44 +00:00
Lovell Fuller	ede8217ab3	Prerelease v0.33.3-rc.0	2024-03-22 12:41:51 +00:00
Lovell Fuller	2689fb4e65	Bump deps	2024-03-22 11:19:08 +00:00
Lovell Fuller	eaf31a59e5	Docs: changelog and credit for #4036	2024-03-21 18:34:35 +00:00
Lovell Fuller	aa1bbcb5c1	Guard heif bitdepth property for prebuilt binaries	2024-03-21 18:33:57 +00:00
Mert	3c26080c39	Add bitdepth option to heif output (#4036 ) Prebuilt binaries support only AVIF with a bitdepth of 8	2024-03-21 14:36:17 +00:00
Lovell Fuller	dc07fd4e9c	Upgrade to libvips v8.15.2	2024-03-18 15:55:01 +00:00
Lovell Fuller	7bc74feb11	Ensure clone takes deep copy of options #4029	2024-03-17 09:42:21 +00:00
Lovell Fuller	c5f318ed4d	Docs: add changelog and credit for #4028	2024-03-17 09:10:42 +00:00
Aaron Che	8fbb1cd154	Ensure text.wrap property can accept word-char as value (#4028 )	2024-03-17 08:15:03 +00:00
Lovell Fuller	88aee8a887	Bump devDeps	2024-03-06 21:00:44 +00:00
Lovell Fuller	0f77b18078	Rename internal property name to better reflect use This property is used for the processing pipeline colourspace rather than the input colourspace, so the name was confusing.	2024-03-06 20:49:47 +00:00
Lovell Fuller	3eeaee71c0	Ensure pipelineColourspace handles CMYK profiles #3906	2024-03-06 20:20:04 +00:00
Lovell Fuller	045d54e2e6	Docs: include use of fetch() in Stream-based example	2024-02-28 13:15:47 +00:00
Lovell Fuller	75fedf1b75	Ensure keepIccProfile retains P3 input profiles #4008	2024-02-26 15:23:50 +00:00
Lovell Fuller	debdacb726	Bump deps	2024-02-23 09:11:35 +00:00
Lovell Fuller	1c8ae67ed2	CI: Upgrade OS on Linux ARM64 runners	2024-02-23 09:08:11 +00:00
Lovell Fuller	0eb57698ec	Docs: clarify how to achieve 16-bit PNG output	2024-02-14 10:03:18 +00:00
Lovell Fuller	bc95531f2d	Docs: clarify skipBlanks default for tile-based output	2024-02-13 22:40:10 +00:00
Lovell Fuller	60f4048d6c	CI: Upgrade to Python 3.12	2024-02-11 20:45:16 +00:00
Lovell Fuller	fb70fbb09f	Ensure keepIccProfile retains CMYK input profiles #3906	2024-02-11 20:10:18 +00:00
idchlife	fc439bedf1	Docs: add section to help those bundling via Vite	2024-02-08 09:31:28 +00:00
Lovell Fuller	26d0b7147d	Bump devDeps	2024-02-03 21:22:35 +00:00
Lovell Fuller	af6aa8a690	CI: Add macOS 14 (ARM64) Replaces runner previously and very kindly donated by MacStadium	2024-02-01 13:21:43 +00:00
hugo-syn	bd4f1abba2	TypeScript: Fix typo s/introducted/introduced/ (#3962 )	2024-01-19 11:07:41 +00:00
hugo-syn	d2656a3679	Tests: fix typo s/implict/implicit (#3961 )	2024-01-19 10:30:04 +00:00
Niels de Vos	a3b45ceccc	Docs: update link to new JSDoc site (#3950 )	2024-01-16 08:20:45 +00:00
Lovell Fuller	0dcc7d50a8	Docs: add note about libvips 8.15.1 upgrade	2024-01-12 11:25:13 +00:00
Lovell Fuller	bcb22af034	Release v0.33.2	2024-01-12 10:58:45 +00:00
Lovell Fuller	d04dc62666	Prerelease v0.33.2-rc.1	2024-01-12 09:04:00 +00:00
Lovell Fuller	c30d355f97	CI: Fix npm smoke test expectation libvips v8.15.1 added jfif to suffixes	2024-01-11 18:47:24 +00:00
Lovell Fuller	49cb148b38	Prerelease v0.33.2-rc.0	2024-01-11 16:43:59 +00:00
Lovell Fuller	3bc31a8b20	CI: Verify emscripten versions match	2024-01-11 16:23:12 +00:00
Kleis Auke Wolthuizen	c28523e70e	CI: Update Emscripten Docker image to 3.1.51 (#3907 )	2024-01-11 16:21:53 +00:00
Lovell Fuller	278f393f74	Upgrade to libvips v8.15.1	2024-01-11 15:44:57 +00:00
Lovell Fuller	cbf68c1395	Improve error for unsupported multi-page rotation #3940	2024-01-11 11:59:01 +00:00
Lovell Fuller	45e8071599	Add runtime check for outdated Node.js version	2024-01-10 13:50:20 +00:00
Lovell Fuller	b96389d975	Docs: refresh index	2024-01-10 13:50:09 +00:00
Erika	a77ac6ae25	Docs: correct semver for supported Node.js versions (#3937 )	2024-01-10 09:06:40 +00:00
Lovell Fuller	9bcf399b4c	Ensure extend op stays sequential when copying px #3928	2024-01-04 09:24:41 +00:00
Lovell Fuller	4aacee8055	Docs: include img-scoped packages in electron asarUnpack	2024-01-04 08:57:26 +00:00
Lovell Fuller	0b18aeff62	CI: Remove use of nodesource repos	2024-01-03 11:40:42 +00:00
Lovell Fuller	bed1c2ac18	Bump deps	2024-01-03 10:01:29 +00:00
Lovell Fuller	8cd832656b	Docs: add electron to bundlers section If you're using asar, you'll also need to configure asarUnpack.	2024-01-03 09:40:21 +00:00
Lovell Fuller	0499f59e71	Docs: add minimum dep versions to build from source	2023-12-29 10:01:56 +00:00
Lovell Fuller	1fa59bf9b3	Remove any suggestion to --force install This is probably a bad idea in the long run as versions can get out of sync and other genuine warnings might be ignored.	2023-12-28 11:24:46 +00:00
Lovell Fuller	db40ee6912	Docs: add note about Lambda lacking symlink support Some package managers use symlinks. If you need to deploy to AWS, please do not use symlinks.	2023-12-28 11:23:26 +00:00
Lovell Fuller	02b98b8e1b	Issue template: ask for complete error message The error messages generated by sharp are designed to provide people with as much information about the situation as possible. If someone is asked to copy/paste the error, it's more likely they might actually read it, which might then allow them to help themselves without the need to open a new issue.	2023-12-27 09:23:21 +00:00
Lovell Fuller	31fef216e4	Docs: changelog entry for #3914	2023-12-27 09:21:23 +00:00
Abhishek V	77ab5d7a51	TypeScript: add definition for keepMetadata (#3914 )	2023-12-24 10:24:54 +00:00
Lovell Fuller	cd5cf7ce2d	Docs: direct cross-platform Lambda users to relevant section This should reduce repetition in the docs, ensuring any users wishing to support multi or cross platform installs have one place to look.	2023-12-19 16:43:21 +00:00
Lovell Fuller	39cb9d9a6c	Issue template: yarn pnp is now supported	2023-12-17 20:47:23 +00:00
Lovell Fuller	4919bc5134	Release v0.33.1	2023-12-17 20:10:30 +00:00
Lovell Fuller	a4e64eb01f	Prerelease v0.33.1-rc.3	2023-12-17 19:32:36 +00:00
Lovell Fuller	328b18df88	CI: Split yarn pnp package tests into separate jobs	2023-12-17 19:00:14 +00:00
Lovell Fuller	5e7bf32e5e	Docs: refresh index and homepage link	2023-12-17 18:51:49 +00:00
Lovell Fuller	04403f4e5f	Prerelease v0.33.1-rc.2	2023-12-17 17:13:34 +00:00
Lovell Fuller	420e0822b4	CI: Pin Node.js 18 to avoid npm 10 on 32-bit Windows npm 10 seems to be opening thousands of network connections, leading to resource starvation in Node.js 18. This does not appear to impact Node.js 20.	2023-12-17 16:53:12 +00:00