unstale

npm / @napi-rs/image

@napi-rs/image

What changed in @napi-rs/image 1, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

1 breaking3 new APIs and options2 performance1 behavior and defaults4 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.1.1 on npm

@napi-rs/image 111 changes

Breaking changes 1

  • Replaced GPL imagequant with a clean-room MIT implementation of pngQuantize.

    1.13.0release notes

New APIs and options 3

  • Adds composite() with sharp blend modes, gravity, and tiling.

    1.15.0release notes

  • Adds native HEIC decoding and encoding on macOS through Apple ImageIO, without bundling an HEVC codec.

    1.14.0release notes

  • Adds opacity(factor) to scale the alpha channel for whole-image transparency adjustments.

    1.14.0release notes

Performance 2

  • The quantizer is about 1.5–2x faster and includes an Oklab/Ostromoukhov quality pass, with SIMD verified on x86/ARM.

    1.15.0release notes

  • Added runtime-dispatched 4-lane SIMD for pngQuantize's nearest-palette argmin.

    1.13.0release notes

Behavior and default changes 1

  • Adds native HEIC decoding and encoding on Windows through WIC; the backend is 8-bit, opaque-only, and exposes a Lossless mode.

    1.14.0release notes

Fixes and other changes 4

  • metadata() now reflects pending transforms.

    1.14.0release notes

  • SVG content now scales to fill the upscaled raster instead of leaving padding.

    1.14.0release notes

  • The SVG format now reports as "svg".

    1.14.0release notes

  • Fixed detect_gamma_from_png_info.

    1.13.0release notes