$ show lovell/sharp
Sharp is a high-performance Node.js native addon for image processing, built on libvips. It provides a fluent, chainable API for resizing, converting, and manipulating images in formats like JPEG, PNG, WebP, GIF, AVIF, HEIF, TIFF, SVG, and raw pixel data. The architecture cleanly separates a JavaScript API layer (in lib/*.mjs) from a C++ core (src/*.cc) that leverages libvips via N-API async workers, enabling non-blocking, multithreaded processing. The library supports streaming, buffer, and file-based I/O, and includes advanced capabilities such as ICC profile management, metadata preservation, animation handling, gain map support, and tiling for deep zoom formats. Sharp is distributed as prebuilt binaries for a wide range of platforms and architectures, with a build-from-source fallback. The codebase demonstrates strong engineering practices: a comprehensive unit test suite using node:test, a CI pipeline that tests on multiple OS/arch combinations, and meticulous handling of format-specific edge cases. It is actively maintained and keeps pace with libvips updates, with a low technical drift.
The LLM identified 1 files worth highlighting for reuse:
This module provides reusable helpers for asserting image similarity in tests. It implements two non-trivial comparison techniques: a perceptual dHash fingerprint for fast approximate equality checks, and CIEDE2000 color distance for perceptual color difference tolerance. These functions are self-contained and can be extracted into any image-processing testing project to validate generated images against expected outputs with configurable thresholds.