image-guard 5.2.0 → 5.2.1

package/CHANGELOG.md

@@ -4,6 +4,14 @@ Starting with version 5.2.0, all notable changes to Image Guard are documented i
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and the project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [5.2.1] - 2026-02-17
+
+### Changed
+
+* HEIC-to-AVIF conversion now uses lossy encoding (quality 80) instead of lossless, producing files smaller than the HEIC originals
+* Removed redundant lossless compression pass after HEIC conversion
+* Documented Display P3 to sRGB color space mapping during HEIC conversion
+
 ## [5.2.0] - 2026-02-17
 
 ### Added

package/README.md

@@ -111,7 +111,7 @@ npm pkg set scripts.postprepare="grep -qxF 'npx image-guard --staged' .husky/pre
 
 * `--staged` (recommended with automated use) triggers a mode that watches PNG, JPG, GIF, WebP, and AVIF files (and HEIC/HEIF, when `--heic-to-avif` is used) in `git diff` and only processes those files—that approach makes Image Guard more efficient in operation.
 
-* `--heic-to-avif` converts HEIC/HEIF files to lossless AVIF. The conversion decodes HEIC/HEIF pixel data and re-encodes it as lossless AVIF, then runs the result through Image Guard’s compression pipeline. Original HEIC/HEIF files are deleted after conversion by default.
+* `--heic-to-avif` converts HEIC/HEIF files to AVIF. Because HEIC sources are already lossy-compressed (HEVC), the conversion uses lossy AVIF encoding (quality 80) to produce files smaller than the originals at near-identical visual quality. Original HEIC/HEIF files are deleted after conversion by default. (Note: The conversion maps Display P3 colors—common on iPhones—to sRGB, which may result in slightly less vivid colors.)
 
   - `--keep-heic` (used with `--heic-to-avif`) preserves the original HEIC/HEIF files instead of deleting them after conversion.
 
@@ -148,7 +148,7 @@ Tip: Use `--quiet` to suppress these per‑file lines and keep only the final su
 
 Image Guard is a Node script that uses [sharp](https://www.npmjs.com/package/sharp) under the hood.
 
-Automated compression works by monitoring whether a given [change list](https://webglossary.info/terms/change-list/) includes any PNGs, JPGs, GIFs, WebPs, or AVIFs (and HEIC/HEIF when opted in). It’s initiated by a Git hook. Only those images are compressed where there is an improvement. HEIC conversion uses [heic-decode](https://www.npmjs.com/package/heic-decode) for patent-free decoding and sharp for AVIF encoding. The processed images can then be committed to the underlying repository.
+Automated compression works by monitoring whether a given [change list](https://webglossary.info/terms/change-list/) includes any PNGs, JPGs, GIFs, WebPs, or AVIFs (and HEIC/HEIF when opted in). It’s initiated by a Git hook. Only those images are compressed where there is an improvement. HEIC conversion uses [heic-decode](https://www.npmjs.com/package/heic-decode) for patent-free decoding and sharp for lossy AVIF encoding (quality 80). The processed images can then be committed to the underlying repository.
 
 Through this approach, though glossed over here, Image Guard makes up for what’s missing or complicated in other packages, namely easy, near-riskless, automatable, resource-friendly in-repo optimization.
 

package/bin/image-guard.test.js

@@ -415,7 +415,12 @@ describe('Image Guard', () => {
 
     // AVIF should be created by the conversion
     assert.strictEqual(fs.existsSync(avifFile), true, 'AVIF file should be created')
-    assert.ok(fs.statSync(avifFile).size > 0, 'AVIF file should not be empty')
+    const avifSize = fs.statSync(avifFile).size
+    assert.ok(avifSize > 0, 'AVIF file should not be empty')
+
+    // Lossy AVIF should not be larger than the HEIC source
+    const heicSize = fs.statSync(path.join(testFolder, 'test.heic')).size
+    assert.ok(avifSize <= heicSize, `AVIF (${avifSize}) should not be larger than HEIC (${heicSize})`)
 
     // Original HEIC should be deleted
     assert.strictEqual(fs.existsSync(heicFile), false, 'Original HEIC should be deleted')

package/package.json

@@ -46,5 +46,5 @@
     "test": "node --test bin/image-guard.test.js"
   },
   "type": "module",
-  "version": "5.2.0"
+  "version": "5.2.1"
 }

package/src/utils.js

@@ -232,25 +232,22 @@ const conversion = async (filename, dry, keepOriginal, quiet = false) => {
       return 0
     }
 
-    // Encode as lossless AVIF (pass the decoded view directly to avoid extra-byte issues)
+    // Encode as lossy AVIF—HEIC sources are already lossy (HEVC), so lossless
+    // re-encoding would inflate file sizes without any quality benefit
     await sharp(data, { raw: { width, height, channels: 4 } })
-      .toFormat('avif', { effort: 5, lossless: true })
+      .toFormat('avif', { quality: 80, effort: 5 })
       .toFile(avifPath)
 
     const fileSizeAfter = await size(avifPath)
 
     logMessage(`Converted ${filename} → ${path.basename(avifPath)} (${sizeReadable(fileSizeBefore)} → ${sizeReadable(fileSizeAfter)})`, dry, 'cyan', quiet)
 
-    // Compress the resulting AVIF through the standard compression pipeline
-    const saved = await compression(avifPath, dry, quiet)
-
-    // Delete original HEIC/HEIF file unless --keep-heic is set (deferred until after compression succeeds)
+    // Delete original HEIC/HEIF file unless `--keep-heic` is set
     if (!keepOriginal) {
       await retryFileOperation(() => fs.promises.unlink(filename))
     }
 
-    // Return compression savings only (conversion size change is informational)
-    return saved
+    return fileSizeAfter < fileSizeBefore ? fileSizeBefore - fileSizeAfter : 0
 
   } catch (err) {
     // Clean up partial AVIF if it was created