@vizzly-testing/honeydiff 0.14.0 → 0.15.0

package/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.15.0] - 2026-08-03
+
+### Changed
+
+- ✨ Improve diffs for single-block height shifts (#39)
+
+**Full Changelog**: https://github.com/vizzly-testing/honeydiff/compare/v0.14.0...v0.15.0
+
 ## [0.14.0] - 2026-07-24
 
 ### Added

package/README.md

@@ -154,6 +154,23 @@ console.log(result.perceptualScore);
 console.log(result.gmsdScore);
 ```
 
+### Align One Added Or Removed Block
+
+```js
+let result = await compare('baseline.png', 'current.png', {
+  alignHeightChanges: true,
+  maskPath: 'artifacts/mask.png',
+});
+```
+
+This opt-in handles one exact added or removed block of rows, such as a banner,
+while keeping separate changes below it visible. Ambiguous matches,
+bottom-only growth, and comparisons using `maxDiffs` use the normal comparison.
+It does not handle multiple blocks, partial-width movement, or fuzzy matching.
+An accepted comparison temporarily uses one additional RGBA frame. SSIM and
+GMSD compare the unaligned overlapping portions, and the side-by-side overlay
+uses the original images.
+
 ### Screenshot Contrast
 
 ```js
@@ -186,6 +203,7 @@ await saveColorBlindnessSimulation(
 | --- | --- | --- |
 | `threshold` | `2.0` | CIEDE2000 Delta E threshold. Use `0` for zero perceptual tolerance. |
 | `antialiasing` | `true` | Ignore likely anti-aliased pixels. |
+| `alignHeightChanges` | `false` | Align one conservatively detected added or removed block of rows. |
 | `maxDiffs` | unlimited | Stop after a maximum number of differing pixels. Capped results classify from the pixels observed before early exit, without cluster filtering. |
 | `includeDiffPixels` | `false` | Return individual differing pixel positions and intensities. |
 | `includeClusters` | `false` | Return connected regions of visual change. |

package/index.d.ts

@@ -219,6 +219,14 @@ export interface CompareOptions {
    */
   antialiasing?: boolean;
 
+  /**
+   * Align one conservatively detected added or removed block of rows.
+   * Falls back to the normal same-coordinate comparison when the match is
+   * ambiguous or maxDiffs is set.
+   * @default false
+   */
+  alignHeightChanges?: boolean;
+
   /**
    * Maximum number of differences to detect before stopping
    * Capped comparisons classify from observed pixel evidence because early

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizzly-testing/honeydiff",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "High-performance image diffing for Node.js - Native bindings to Honeydiff Rust library",
   "type": "module",
   "main": "index.js",