image-guard 5.2.1 → 5.2.2

package/CHANGELOG.md

@@ -4,6 +4,12 @@ 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.2] - 2026-02-17
+
+### Fixed
+
+* Updated HEIC dry run to report actual file sizes instead of omitting size data
+
 ## [5.2.1] - 2026-02-17
 
 ### Changed

package/README.md

@@ -4,7 +4,7 @@
 
 (This project was based on [sum.cumo’s imagemin-merlin](https://github.com/sumcumo/imagemin-merlin). [Changes are documented](https://github.com/sumcumo/imagemin-merlin/compare/master...j9t:master), and include this README. Image Guard supports additional file formats—WebP, AVIF, and HEIC/HEIF—, comes with improved code and documentation, and is being maintained. For this reason, it’s [not based on any Imagemin packages](https://meiert.com/blog/image-guard-4/) anymore.)
 
-Image Guard takes care of near-lossless compression of your images, to help you avoid bloat in your repositories. It makes it convenient and as safe as possible to automatically compress PNG, JPG, GIF, WebP, and AVIF images. It can also convert HEIC/HEIF files to AVIF (opt-in via `--heic-to-avif`).
+Image Guard takes care of near-lossless compression of your images, to help you avoid bloat in your repositories. It makes it convenient and as safe as possible to automatically compress PNG, JPG, GIF, WebP, and AVIF images. It can also convert HEIC/HEIF files to AVIF.
 
 It’s convenient because setup is simple. Run it right away—done. Or install, run, add hook—done.
 
@@ -140,7 +140,7 @@ Roughly like this:
 * Green: The image file has been compressed.
 * Cyan: The image file has been converted (HEIC/HEIF to AVIF).
 * White (light gray): The image file has not been changed.
-* Blue: The image file had already been compressed more aggressively than the new result, and was therefore skipped, too.
+* Blue: The image file had already been compressed more effectively than the new result, and was therefore skipped, too.
 
 Tip: Use `--quiet` to suppress these per‑file lines and keep only the final summary.
 

package/bin/image-guard.test.js

@@ -451,19 +451,26 @@ describe('Image Guard', () => {
     fs.rmSync(tempDir, { recursive: true, force: true })
   })
 
-  test('Dry run does not convert HEIC files', () => {
+  test('Dry run does not convert HEIC files but reports sizes', () => {
     const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'image-guard-heic-dry-'))
     const tempTestFolder = path.join(tempDir, 'test')
     copyFiles(testFolder, tempTestFolder)
 
+    // Remove pre-existing AVIF so the conversion path is exercised
+    const avifFile = path.join(tempTestFolder, 'test.avif')
+    if (fs.existsSync(avifFile)) {
+      fs.unlinkSync(avifFile)
+    }
+
     const heicFile = path.join(tempTestFolder, 'test.heic')
     const heicBefore = fs.statSync(heicFile)
     const filesBefore = fs.readdirSync(tempTestFolder).sort()
 
     const originalCwd = process.cwd()
+    let output = ''
     try {
       process.chdir(tempDir)
-      execSync(`node "${imageGuardScript}" --heic-to-avif --dry`, { stdio: 'pipe' })
+      output = execSync(`node "${imageGuardScript}" --heic-to-avif --dry`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] })
     } finally {
       process.chdir(originalCwd)
     }
@@ -477,6 +484,9 @@ describe('Image Guard', () => {
     const filesAfter = fs.readdirSync(tempTestFolder).sort()
     assert.deepStrictEqual(filesAfter, filesBefore)
 
+    // Dry run should report size data for HEIC conversion
+    assert.match(output, /Converted.*test\.heic.*KB.*→.*KB/i, 'Dry run should report HEIC conversion sizes')
+
     fs.rmSync(tempDir, { recursive: true, force: true })
   })
 

package/package.json

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

package/src/utils.js

@@ -133,7 +133,7 @@ const compression = async (filename, dry, quiet = false) => {
     } else if (fileSizeAfter > fileSizeBefore) {
       color = 'blue'
       status = 'Skipped'
-      details = 'already compressed more aggressively'
+      details = 'already compressed more effectively'
     }
 
     logMessage(`${status} ${filename} (${details})`, dry, color, quiet)
@@ -227,11 +227,6 @@ const conversion = async (filename, dry, keepOriginal, quiet = false) => {
     const inputBuffer = await fs.promises.readFile(filename)
     const { width, height, data } = await decode({ buffer: inputBuffer })
 
-    if (dry) {
-      logMessage(`Converted ${filename} → ${path.basename(avifPath)}`, dry, 'cyan', quiet)
-      return 0
-    }
-
     // 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 } })
@@ -242,6 +237,11 @@ const conversion = async (filename, dry, keepOriginal, quiet = false) => {
 
     logMessage(`Converted ${filename} → ${path.basename(avifPath)} (${sizeReadable(fileSizeBefore)} → ${sizeReadable(fileSizeAfter)})`, dry, 'cyan', quiet)
 
+    if (dry) {
+      await retryFileOperation(() => fs.promises.unlink(avifPath))
+      return 0
+    }
+
     // Delete original HEIC/HEIF file unless `--keep-heic` is set
     if (!keepOriginal) {
       await retryFileOperation(() => fs.promises.unlink(filename))