@vizzly-testing/honeydiff 0.15.0 → 0.17.0

package/index.js

@@ -37,12 +37,14 @@ if (existsSync(platformLoaderPath)) {
 
 // Core comparison API
 export const compare = addon.compare;
-export const quickCompare = addon.quickCompare;
 export const compareSync = addon.compareSync;
-export const quickCompareSync = addon.quickCompareSync;
+export const imagesDiffer = addon.imagesDiffer;
+export const imagesDifferSync = addon.imagesDifferSync;
+export const analyze = addon.analyze;
+export const analyzeSync = addon.analyzeSync;
+export const configureThreads = addon.configureThreads;
 export const getDimensions = addon.getDimensions;
 export const getDimensionsSync = addon.getDimensionsSync;
-export const maskSemanticsVersion = addon.maskSemanticsVersion;
 export const version = packageMetadata.version;
 
 // Image Metadata API
@@ -70,7 +72,89 @@ export const analyzeWcagAllCvd = addon.analyzeWcagAllCvd;
 export const analyzeWcagAllCvdSync = addon.analyzeWcagAllCvdSync;
 export const getColorBlindnessTypes = addon.getColorBlindnessTypes;
 
-// Diff Fingerprint API
-export const computeFingerprintSync = addon.computeFingerprintSync;
-export const fingerprintSimilaritySync = addon.fingerprintSimilaritySync;
-export const fingerprintHashSync = addon.fingerprintHashSync;
+// Diff fingerprints are pure derivatives of the returned analysis.
+export function computeFingerprintSync(analysis) {
+  let regions = analysis.difference.regions;
+  if (regions.length === 0) return null;
+
+  let width = analysis.images.canvas.width;
+  let height = analysis.images.canvas.height;
+  let canvasArea = width * height;
+  let regionPositions = regions.map(({ spatial }) => [
+    spatial.centroid.x / width,
+    spatial.centroid.y / height,
+  ]);
+  let regionSizes = regions.map(
+    ({ spatial }) => (spatial.bounds.width * spatial.bounds.height) / canvasArea
+  );
+  let averageDensity =
+    regions.reduce((total, region) => total + region.spatial.density, 0) / regions.length;
+  let zoneMask = regions.reduce((mask, region) => {
+    let zoneX = Math.min(3, Math.floor((region.spatial.centroid.x / width) * 4));
+    let zoneY = Math.min(3, Math.floor((region.spatial.centroid.y / height) * 4));
+    return mask | (1 << (zoneY * 4 + zoneX));
+  }, 0);
+  let fraction = analysis.difference.fraction;
+  let diffMagnitude =
+    fraction < 0.001
+      ? 'tiny'
+      : fraction < 0.01
+        ? 'small'
+        : fraction < 0.05
+          ? 'medium'
+          : fraction < 0.2
+            ? 'large'
+            : 'massive';
+  let fingerprint = {
+    regionCount: regions.length,
+    regionPositions,
+    regionSizes,
+    meanDeltaE: analysis.difference.appearance?.mean ?? null,
+    averageDensity,
+    zoneMask,
+    diffMagnitude,
+    hash: '',
+  };
+  fingerprint.hash = fingerprintHashSync(fingerprint);
+  return fingerprint;
+}
+
+export function fingerprintSimilaritySync(left, right) {
+  let intersection = left.zoneMask & right.zoneMask;
+  let union = left.zoneMask | right.zoneMask;
+  let bitCount = (value) => {
+    let count = 0;
+    for (let remaining = value; remaining !== 0; remaining >>>= 1) count += remaining & 1;
+    return count;
+  };
+  let weighted = (bitCount(intersection) / Math.max(1, bitCount(union))) * 40;
+  let weights = 40;
+  weighted += (1 / (1 + Math.abs(left.regionCount - right.regionCount) * 0.5)) * 20;
+  weights += 20;
+  weighted += (left.diffMagnitude === right.diffMagnitude ? 1 : 0) * 15;
+  weights += 15;
+  weighted += (1 / (1 + Math.abs(left.averageDensity - right.averageDensity) * 5)) * 15;
+  weights += 15;
+  if (left.meanDeltaE !== null && right.meanDeltaE !== null) {
+    weighted += (1 / (1 + Math.abs(left.meanDeltaE - right.meanDeltaE) / 10)) * 10;
+    weights += 10;
+  }
+  return weighted / weights;
+}
+
+export function fingerprintHashSync(fingerprint) {
+  let magnitude = ['tiny', 'small', 'medium', 'large', 'massive'].indexOf(
+    fingerprint.diffMagnitude
+  );
+  if (magnitude === -1) throw new TypeError('Invalid diffMagnitude');
+  let countBucket =
+    fingerprint.regionCount === 1
+      ? 0
+      : fingerprint.regionCount <= 3
+        ? 1
+        : fingerprint.regionCount <= 10
+          ? 2
+          : 3;
+  let value = fingerprint.zoneMask * 32 + magnitude * 4 + countBucket;
+  return value.toString(16).padStart(16, '0');
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vizzly-testing/honeydiff",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "description": "High-performance image diffing for Node.js - Native bindings to Honeydiff Rust library",
   "type": "module",
   "main": "index.js",
@@ -18,7 +18,7 @@
     "build-debug": "cargo build",
     "test": "node --test --experimental-strip-types tests/*.test.ts",
     "test:types": "tsc --noEmit",
-    "test:examples": "node examples/basic.js",
+    "test:examples": "node examples/basic.js ../../tests/fixtures/screenshots/vizzly-baseline.png ../../tests/fixtures/screenshots/vizzly-with-diff.png",
     "check": "biome check .",
     "check:fix": "biome check --write .",
     "lint": "biome lint .",
@@ -51,7 +51,8 @@
     "assets/",
     "examples/",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=22.0.0"