Skip to content

All packages ​

Every package is separately installable under the @dusrel/ scope, ESM-only, and versioned in lockstep. No codec WASM is ever bundled into the core.

bash
npm install @dusrel/image   # the flagship — engine + pipeline + batch
npm install @dusrel/image-avif @dusrel/image-crop   # or just the pieces you need

Not sure which package a task needs? The cookbook maps common jobs to packages, and core concepts explains how they compose.

Core ​

PackageWhat it does
@dusrel/imageOne-call processing, fluent pipeline, plugins, fallback policies, batch
@dusrel/image-coreThe zero-dependency Canvas engine underneath

Codecs (WASM, lazily loaded) ​

PackageEngine
@dusrel/image-jpegMozJPEG — progressive JPEG encode/decode
@dusrel/image-webplibwebp — lossy + lossless WebP
@dusrel/image-aviflibaom + libavif — AVIF encode/decode
@dusrel/image-pngRust png crate — PNG encode/decode
@dusrel/image-oxipngOxiPNG — lossless PNG optimisation
@dusrel/image-resizeRust resize crate — high-quality resampling, 7 filters
@dusrel/image-quantizequantizr — palette quantisation for PNG-8 style savings
@dusrel/image-qoiRust qoi crate — lossless QOI encode/decode (Phase 5, experimental)
@dusrel/image-jxllibjxl — JPEG XL encode/decode (Phase 5, experimental)
@dusrel/image-heiclibheif + libde265 — HEIC/HEIF decode only, native-first on Safari (Phase 5; engine LGPL-3.0, wrapper MIT — ADR-0008)

Features ​

PackageWhat it does
@dusrel/image-cropCrop geometry core + the accessible <dusrel-crop> Web Component
@dusrel/image-transformFlip, rotate, perspective warp
@dusrel/image-adjustBrightness/contrast/exposure/gamma/hue/saturation, blur, sharpen
@dusrel/image-metadataEXIF read (incl. GPS), metadata strip (all or GPS-only)
@dusrel/image-watermarkImage + text watermarks, 9 placements and tiling
@dusrel/image-batchWorker-pool batch engine — retries, timeouts, pause/resume, memory caps
@dusrel/image-gifAnimated GIF encode/decode/optimise — Rust gif crate (Phase 5)
@dusrel/image-svgSVG optimisation — SVGO browser build, multipass + ID preservation (Phase 5)
@dusrel/image-placeholderThumbHash + BlurHash placeholders — pure TypeScript, aspect + alpha aware (Phase 5)

Frameworks ​

PackageWhat it does
@dusrel/image-reactuseProcessImage / useProcessBatch hooks + <DusrelCrop>
@dusrel/image-vueComposables + <DusrelCrop> with v-model
@dusrel/image-svelteStore factories + DusrelCrop.svelte with bind:crop