tuffgal 0.2.0-alpha.3 → 0.2.0-alpha.4

package/dist/screenshots/diff.js

@@ -2,31 +2,34 @@ import pixelmatch from 'pixelmatch';
 import { PNG } from 'pngjs';
 import { ssim as computeSsim } from 'ssim.js';
 /**
- * Compares two PNG buffers. Computes SSIM (the perceptual gate) and a
- * pixelmatch overlay (the visualisation). Both are returned so the
- * runner can use SSIM for pass/changed decisions while the reporter
- * still has a red-highlight diff image to show the human.
+ * Diffing is split into two phases so the common case stays cheap:
  *
- * Dimension mismatch is a regression on its own — fail loudly.
+ *   1. {@link scoreDiff}: the gate. Computes SSIM (the pass/changed
+ *      decision) plus the pixel metrics reported on every outcome
+ *      (`diffPixels`, `diffRatio`). It runs pixelmatch in count-only mode
+ *      (no output buffer) and never encodes a diff image. It also returns the
+ *      {@link DecodedPair} it read, so the changed branch can render its
+ *      overlay without a second decode.
+ *   2. {@link renderDiffOverlay}: the visualisation. Takes that same decoded
+ *      pair, runs pixelmatch with an output buffer, and deflate-encodes the
+ *      red-highlight overlay PNG for the human-facing report.
+ *
+ * The overlay is only kept when a comparison FAILS; a passing comparison
+ * deletes it. Because passing is the common case in a healthy suite,
+ * encoding the overlay on every comparison was pure waste, so the caller
+ * runs {@link scoreDiff} unconditionally and reaches for
+ * {@link renderDiffOverlay} only on the changed branch, where the image is
+ * actually written. The decode is shared across both, so the changed branch
+ * pays for exactly one `PNG.sync.read` pair; the pass branch keeps its
+ * no-allocate, no-encode shape (the overlay is never filled on a pass).
  */
-export function diffPngs(baseline, actual, pixelThreshold) {
-    const baselinePng = PNG.sync.read(baseline);
-    const actualPng = PNG.sync.read(actual);
-    if (baselinePng.width !== actualPng.width ||
-        baselinePng.height !== actualPng.height) {
-        throw new ScreenshotSizeMismatchError({ width: baselinePng.width, height: baselinePng.height }, { width: actualPng.width, height: actualPng.height });
-    }
-    // SSIM and pixelmatch both assume tightly-packed RGBA (4 bytes/pixel). If a
-    // future pngjs option changed channel depth, the buffer view and the
-    // width/height would silently disagree and produce a garbage score rather
-    // than throwing. Fail loudly instead.
-    assertPackedRgba(baselinePng);
-    assertPackedRgba(actualPng);
-    const diffPng = new PNG({
-        width: baselinePng.width,
-        height: baselinePng.height,
-    });
-    const diffPixels = pixelmatch(baselinePng.data, actualPng.data, diffPng.data, baselinePng.width, baselinePng.height, { threshold: pixelThreshold });
+export function scoreDiff(baseline, actual, pixelThreshold) {
+    const decoded = decodePair(baseline, actual);
+    const { baselinePng, actualPng } = decoded;
+    // Count-only: passing `undefined` as the output buffer makes pixelmatch
+    // tally differing pixels without allocating or filling an overlay. The
+    // metric feeds `diffPixels`/`diffRatio` reporting, not a written image.
+    const diffPixels = pixelmatch(baselinePng.data, actualPng.data, undefined, baselinePng.width, baselinePng.height, { threshold: pixelThreshold });
     const totalPixels = baselinePng.width * baselinePng.height;
     const ssimResult = computeSsim({
         data: new Uint8ClampedArray(baselinePng.data.buffer, baselinePng.data.byteOffset, baselinePng.data.byteLength),
@@ -38,13 +41,60 @@ export function diffPngs(baseline, actual, pixelThreshold) {
         height: actualPng.height,
     }, { ssim: 'bezkrovny' });
     return {
-        diffPng: PNG.sync.write(diffPng),
-        diffPixels,
-        totalPixels,
-        diffRatio: diffPixels / totalPixels,
-        ssimScore: ssimResult.mssim,
+        score: {
+            diffPixels,
+            totalPixels,
+            diffRatio: diffPixels / totalPixels,
+            ssimScore: ssimResult.mssim,
+        },
+        decoded,
     };
 }
+/**
+ * Renders the red-highlight overlay PNG for the report from the already-decoded
+ * pair {@link scoreDiff} produced. This is the expensive half (pixelmatch
+ * fills an output buffer and `PNG.sync.write` deflate-encodes it) so it runs
+ * only on the changed/failed branch where the diff image is actually written to
+ * disk.
+ *
+ * Takes the {@link DecodedPair} rather than raw buffers so it reuses
+ * {@link scoreDiff}'s decode: the changed branch reads the image pair once, not
+ * twice. The dimensions/packing invariants were already enforced by
+ * {@link decodePair} when the pair was decoded, so no re-validation is needed
+ * here. pixelmatch's count is output-independent, so filling the overlay here
+ * cannot disturb the `diffPixels` {@link scoreDiff} already reported.
+ */
+export function renderDiffOverlay(decoded, pixelThreshold) {
+    const { baselinePng, actualPng } = decoded;
+    const diffPng = new PNG({
+        width: baselinePng.width,
+        height: baselinePng.height,
+    });
+    pixelmatch(baselinePng.data, actualPng.data, diffPng.data, baselinePng.width, baselinePng.height, { threshold: pixelThreshold });
+    return PNG.sync.write(diffPng);
+}
+/**
+ * Decodes both PNG buffers and enforces the invariants the diff phases
+ * share: dimensions must match and the pixel data must be tightly-packed
+ * RGBA. Dimension mismatch is a regression on its own. Fail loudly. Runs
+ * once per comparison inside {@link scoreDiff}; {@link renderDiffOverlay}
+ * reuses the result instead of decoding again.
+ */
+function decodePair(baseline, actual) {
+    const baselinePng = PNG.sync.read(baseline);
+    const actualPng = PNG.sync.read(actual);
+    if (baselinePng.width !== actualPng.width ||
+        baselinePng.height !== actualPng.height) {
+        throw new ScreenshotSizeMismatchError({ width: baselinePng.width, height: baselinePng.height }, { width: actualPng.width, height: actualPng.height });
+    }
+    // SSIM and pixelmatch both assume tightly-packed RGBA (4 bytes/pixel). If a
+    // future pngjs option changed channel depth, the buffer view and the
+    // width/height would silently disagree and produce a garbage score rather
+    // than throwing. Fail loudly instead.
+    assertPackedRgba(baselinePng);
+    assertPackedRgba(actualPng);
+    return { baselinePng, actualPng };
+}
 function assertPackedRgba(png) {
     const expected = png.width * png.height * 4;
     if (png.data.byteLength !== expected) {

package/dist/screenshots/diff.js.map

@@ -1 +1 @@
-{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/screenshots/diff.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/screenshots/diff.ts"],"names":[],"mappings":"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"}

package/dist/util.d.ts

@@ -9,8 +9,29 @@ export declare function parseHostPort(url: string): {
 };
 /**
  * Resolves `true` if a TCP connection to `host:port` opens within `timeoutMs`,
- * `false` on error or timeout. Used to gate dev-server readiness without an
- * HTTP round-trip, so self-signed certs and 404s don't block.
+ * `false` on error or timeout. This is a cheap up/down LIVENESS check, not a
+ * readiness gate: `supervise.ts`'s `probeAllHealthchecks` polls it against dev
+ * servers that were already proven to be serving routes at startup (via
+ * {@link probeHttp}), so once a server is HTTP-readiness-verified a bare TCP
+ * accept is sufficient to confirm the process is still up. The false-ready
+ * caveat that makes a TCP accept too weak for a cold-booting dev server (see
+ * {@link probeHttp}) does not apply here. The server is past boot. Staying on
+ * TCP also keeps the liveness poll agnostic to self-signed HTTPS certs and
+ * non-2xx routes, which `fetch` (and thus `probeHttp`) would reject.
  */
 export declare function probeTcp(host: string, port: number, timeoutMs: number): Promise<boolean>;
+/**
+ * Resolves `true` if an HTTP `GET` to `url` returns any non-5xx status within
+ * `timeoutMs`, `false` on a 5xx status, connection refusal, TLS/DNS failure, or
+ * timeout. Unlike {@link probeTcp}, this proves the server is actually *serving*
+ * routes, a dev server (Vite/Next/webpack) binds its socket well before the
+ * bundle finishes compiling, so a bare TCP accept can succeed while requests
+ * still 503 or hang. Any received response (2xx/3xx/4xx) means it is up.
+ *
+ * Redirects are not followed (`redirect: 'manual'`): a 3xx already proves the
+ * server is serving, and chasing `Location` risks an external host or a slow
+ * login page. Note this does *not* accept self-signed HTTPS certs (fetch
+ * rejects them). An http health-check URL is expected.
+ */
+export declare function probeHttp(url: string, timeoutMs: number): Promise<boolean>;
 //# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAGA,wCAAwC;AACxC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED,kEAAkE;AAClE,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQzE;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAalB"}
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAGA,wCAAwC;AACxC,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAI/C;AAED,kEAAkE;AAClE,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAQzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAalB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,OAAO,CAAC,CAiBlB"}

package/dist/util.js

@@ -28,8 +28,15 @@ export function parseHostPort(url) {
 }
 /**
  * Resolves `true` if a TCP connection to `host:port` opens within `timeoutMs`,
- * `false` on error or timeout. Used to gate dev-server readiness without an
- * HTTP round-trip, so self-signed certs and 404s don't block.
+ * `false` on error or timeout. This is a cheap up/down LIVENESS check, not a
+ * readiness gate: `supervise.ts`'s `probeAllHealthchecks` polls it against dev
+ * servers that were already proven to be serving routes at startup (via
+ * {@link probeHttp}), so once a server is HTTP-readiness-verified a bare TCP
+ * accept is sufficient to confirm the process is still up. The false-ready
+ * caveat that makes a TCP accept too weak for a cold-booting dev server (see
+ * {@link probeHttp}) does not apply here. The server is past boot. Staying on
+ * TCP also keeps the liveness poll agnostic to self-signed HTTPS certs and
+ * non-2xx routes, which `fetch` (and thus `probeHttp`) would reject.
  */
 export function probeTcp(host, port, timeoutMs) {
     return new Promise((resolveProbe) => {
@@ -45,4 +52,37 @@ export function probeTcp(host, port, timeoutMs) {
         socket.setTimeout(timeoutMs);
     });
 }
+/**
+ * Resolves `true` if an HTTP `GET` to `url` returns any non-5xx status within
+ * `timeoutMs`, `false` on a 5xx status, connection refusal, TLS/DNS failure, or
+ * timeout. Unlike {@link probeTcp}, this proves the server is actually *serving*
+ * routes, a dev server (Vite/Next/webpack) binds its socket well before the
+ * bundle finishes compiling, so a bare TCP accept can succeed while requests
+ * still 503 or hang. Any received response (2xx/3xx/4xx) means it is up.
+ *
+ * Redirects are not followed (`redirect: 'manual'`): a 3xx already proves the
+ * server is serving, and chasing `Location` risks an external host or a slow
+ * login page. Note this does *not* accept self-signed HTTPS certs (fetch
+ * rejects them). An http health-check URL is expected.
+ */
+export async function probeHttp(url, timeoutMs) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const response = await fetch(url, {
+            method: 'GET',
+            redirect: 'manual',
+            signal: controller.signal,
+        });
+        // Drain the body so the socket doesn't linger in undici's connection pool.
+        await response.body?.cancel();
+        return response.status < 500;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 //# sourceMappingURL=util.js.map

package/dist/util.js.map

@@ -1 +1 @@
-{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,wCAAwC;AACxC,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI;QACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAC5B,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,IAAY,EACZ,SAAiB;IAEjB,OAAO,IAAI,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,CAAC,MAAe,EAAQ,EAAE;YACxC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"util.js","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,wCAAwC;AACxC,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC1B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,kEAAkE;AAClE,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI;QACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ;YAC5B,CAAC,CAAC,GAAG;YACL,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,IAAY,EACZ,SAAiB;IAEjB,OAAO,IAAI,OAAO,CAAC,CAAC,YAAY,EAAE,EAAE;QAClC,MAAM,MAAM,GAAG,gBAAgB,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,MAAM,OAAO,GAAG,CAAC,MAAe,EAAQ,EAAE;YACxC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC5B,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,YAAY,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC,CAAC;QACF,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC3C,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,GAAW,EACX,SAAiB;IAEjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,QAAQ;YAClB,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;QACH,2EAA2E;QAC3E,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9B,OAAO,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tuffgal",
-  "version": "0.2.0-alpha.3",
+  "version": "0.2.0-alpha.4",
   "description": "JSON-driven visual regression for web apps.",
   "license": "MIT",
   "author": "Nick Schneble",
@@ -13,10 +13,11 @@
     "build": "rm -rf dist && tsc -p tsconfig.build.json && mkdir -p dist/reporter/assets && cp src/reporter/assets/report.css src/reporter/assets/report.js dist/reporter/assets/",
     "format": "prettier --write \"**/*.{ts,tsx,json,md}\"",
     "install:browsers": "playwright install chromium",
-    "lint": "eslint \"src/**/*.ts\" --max-warnings=0",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\" --max-warnings=0",
     "preview": "node --import tsx scripts/preview.ts",
-    "prepublishOnly": "npm run lint && npm run typecheck && npm run build",
+    "prepublishOnly": "npm run lint && npm run typecheck && npm test && npm run build",
     "test": "node --import tsx --test \"src/**/*.test.ts\"",
+    "test:dom": "node --import tsx --test \"test/dom/**/*.test.ts\"",
     "typecheck": "tsc --noEmit"
   },
   "bin": {
@@ -71,10 +72,5 @@
     "tsx": "^4.22.4",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.49.0"
-  },
-  "allowScripts": {
-    "esbuild@0.28.1": true,
-    "fsevents@2.3.2": true,
-    "fsevents@2.3.3": true
   }
 }