Registry / devops / rollup-plugin-napi-image

rollup-plugin-napi-image

library0.6.1jsnpmunverified

Rollup and Vite plugin for optimizing images (JPEG, PNG, WebP, AVIF) using napi-rs/Image, a native Rust-based image processing library. Version 0.6.1 released in 2025. It supports both lossy (with configurable quality) and lossless modes, and allows conversion to modern formats (e.g., WebP to AVIF) via a custom function. Unlike imagemin-based plugins, it avoids node-gyp and provides faster performance via N-API. Compatible with Rollup and Vite, with TypeScript types included. Good for build-time image optimization in modern bundler setups.

devops

npm install rollup-plugin-napi-image

github ↗package ↗

INSTALL

IMPORT

SIG · ROLLUP-PLUGIN-NAPI

rollup-plugin-napi-image

devopsjavascriptv0.6.1

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–223 runs

build_error

glibc

node 18–223 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

napiImage

✓ import { napiImage } from 'rollup-plugin-napi-image'

✗ import napiImage from 'rollup-plugin-napi-image'

Named export; default import does not exist.

napiImage

✓ const { napiImage } = require('rollup-plugin-napi-image')

✗ const napiImage = require('rollup-plugin-napi-image')

CommonJS require must destructure the named export.

Mode

✓ import { Mode } from 'rollup-plugin-napi-image'

TypeScript type for mode option: 'lossy' | 'lossless'. Importing the type is optional but useful for typed config.

Rollup config with napiImage plugin: lossy compression at quality 75, excluding sprite.png, and converting WebP to AVIF.

// rollup.config.js import { defineConfig } from 'rollup'; import { napiImage } from 'rollup-plugin-napi-image'; export default defineConfig({ input: 'src/index.js', output: { dir: 'dist', format: 'esm' }, plugins: [ napiImage({ mode: 'lossy', quality: 75, include: ['**/*.{jpg,jpeg,png,webp,avif}'], exclude: ['**/sprite.png'], toModernExt: (ext) => ext === 'webp' ? 'avif' : ext, }), ], });

Debug

Known issues

deprecatedOption format may change in future versions (e.g., include/exclude patterns).

fix

Pin version if stable: "rollup-plugin-napi-image": "0.6.1"

affects: >=0.6.0

gotchaThe plugin only runs during bundle build; it does not optimize images in watch mode or dev server by default.

fix

Ensure production build runs image optimization separately or use manual rebuild.

affects: >=0.0.0

gotchatoModernExt function must return one of the supported extensions: 'jpg' | 'jpeg' | 'png' | 'webp' | 'avif'. Invalid return may cause build errors.

fix

Restrict return type to supported extensions.

affects: >=0.0.0

breakingPreviously named export was 'napiImagePlugin' in v0.5.x; renamed to 'napiImage' in v0.6.0.

fix

Update import to { napiImage } from 'rollup-plugin-napi-image'

affects: <0.6.0

gotchaWARNING: The plugin requires Node.js >= 16 because of napi-rs dependencies.

fix

Upgrade Node.js to version 16 or higher, or use an older version of the plugin that supports Node 14.

affects: >=0.0.0

deprecatedThe 'quality' option is currently only effective for lossy mode; setting it in lossless mode has no effect.

fix

Only set quality when mode is 'lossy'.

affects: >=0.0.0

gotchaUnsupported file types (e.g., SVG, GIF) are silently ignored; no error is thrown.

fix

Use include/exclude patterns to filter out unsupported types.

affects: >=0.0.0

Errors

Common errors & fixes

Error: Cannot find module 'rollup-plugin-napi-image'

Package not installed or not in node_modules.

fix

Run: npm install rollup-plugin-napi-image --save-dev

TypeError: napiImage is not a function

Default import used instead of named import.

fix

Use: import { napiImage } from 'rollup-plugin-napi-image'

Error: Unsupported image format: .svg

Input file has an unsupported extension.

fix

Remove SVG files from the rollup pipeline or set include to only supported extensions.

Plugin napiImage: The 'mode' option is required.

Missing mode in options.

fix

Add mode: 'lossy' or 'lossless' to plugin options.

Error: [plugin: napiImage] Could not optimize image. (code: ENOTDIR)

The input path for an image is a directory instead of a file.

fix

Ensure include patterns match only files, not directories.

Upgrade

Version history

0.6.1latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/cijiugechu/rollup-plugin-napi-image ↗

packagehttps://www.npmjs.com/package/rollup-plugin-napi-image ↗