frontend-harness 0.6.5 → 0.7.4

package/dist/runtime/visual-compare.js

@@ -0,0 +1,271 @@
+import { createHash } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import zlib from "node:zlib";
+import { writeJson } from "../storage/json.js";
+import { resolveProjectOrHarnessRelativePath } from "./project-paths.js";
+const PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]);
+const VISUAL_COMPARE_LIMITATIONS = [
+    "Pixel-level PNG comparison intended for deterministic harness evidence, not perceptual production visual regression.",
+    "Stabilize browser rendering, viewport, fonts, data, animation, and dynamic regions before using scores as a release signal.",
+    "Use manual review or a dedicated visual regression service for masked regions, anti-alias tolerance, perceptual thresholds, and cross-platform rendering drift."
+];
+export function compareVisualArtifacts(projectRoot, input) {
+    const design = resolveRequiredFile(projectRoot, input.design, "visual compare design image");
+    const actual = resolveRequiredFile(projectRoot, input.actual, "visual compare actual image");
+    const diff = resolveOutputPath(projectRoot, input.diff, "visual compare diff image");
+    const report = input.report ? resolveOutputPath(projectRoot, input.report, "visual compare report") : null;
+    const threshold = input.threshold ?? 90;
+    if (threshold < 0 || threshold > 100 || !Number.isFinite(threshold)) {
+        throw new Error("visual compare --threshold must be a number between 0 and 100");
+    }
+    const designImage = decodePng(fs.readFileSync(design.fullPath), design.relativePath);
+    const actualImage = decodePng(fs.readFileSync(actual.fullPath), actual.relativePath);
+    const comparedWidth = Math.min(designImage.width, actualImage.width);
+    const comparedHeight = Math.min(designImage.height, actualImage.height);
+    const diffWidth = Math.max(designImage.width, actualImage.width);
+    const diffHeight = Math.max(designImage.height, actualImage.height);
+    if (comparedWidth <= 0 || comparedHeight <= 0) {
+        throw new Error("visual compare images must have non-empty overlapping dimensions");
+    }
+    const diffImage = new Uint8Array(diffWidth * diffHeight * 4);
+    let changedPixels = 0;
+    let totalDelta = 0;
+    let maxChannelDelta = 0;
+    for (let y = 0; y < diffHeight; y += 1) {
+        for (let x = 0; x < diffWidth; x += 1) {
+            const hasDesignPixel = x < designImage.width && y < designImage.height;
+            const hasActualPixel = x < actualImage.width && y < actualImage.height;
+            const designOffset = hasDesignPixel ? (y * designImage.width + x) * 4 : -1;
+            const actualOffset = hasActualPixel ? (y * actualImage.width + x) * 4 : -1;
+            const deltas = channelDeltas(designImage.rgba, designOffset, actualImage.rgba, actualOffset);
+            const pixelDelta = Math.max(...deltas);
+            if (pixelDelta > 0) {
+                changedPixels += 1;
+            }
+            maxChannelDelta = Math.max(maxChannelDelta, pixelDelta);
+            totalDelta += deltas.reduce((sum, delta) => sum + delta, 0);
+            const diffOffset = (y * diffWidth + x) * 4;
+            diffImage[diffOffset] = 255;
+            diffImage[diffOffset + 1] = 0;
+            diffImage[diffOffset + 2] = 0;
+            diffImage[diffOffset + 3] = Math.max(32, pixelDelta);
+        }
+    }
+    fs.mkdirSync(path.dirname(diff.fullPath), { recursive: true });
+    fs.writeFileSync(diff.fullPath, encodePngRgba(diffWidth, diffHeight, diffImage));
+    const comparedPixels = diffWidth * diffHeight;
+    const meanAbsoluteError = totalDelta / (comparedPixels * 4);
+    const score = roundScore(Math.max(0, 100 * (1 - meanAbsoluteError / 255)));
+    const result = {
+        status: score >= threshold ? "passed" : "failed",
+        score,
+        threshold,
+        width: designImage.width,
+        height: designImage.height,
+        actualWidth: actualImage.width,
+        actualHeight: actualImage.height,
+        comparedWidth,
+        comparedHeight,
+        diffWidth,
+        diffHeight,
+        changedPixels,
+        changedRatio: Number((changedPixels / comparedPixels).toFixed(6)),
+        meanAbsoluteError: Number(meanAbsoluteError.toFixed(4)),
+        maxChannelDelta,
+        diffPath: diff.relativePath,
+        reportPath: report?.relativePath ?? null,
+        artifactSha256: {
+            design: sha256File(design.fullPath),
+            actual: sha256File(actual.fullPath),
+            diff: sha256File(diff.fullPath)
+        },
+        comparisonTool: "frontend-harness visual compare",
+        comparisonCommand: `frontend-harness visual compare --design ${design.relativePath} --actual ${actual.relativePath} --diff ${diff.relativePath}`,
+        limitations: VISUAL_COMPARE_LIMITATIONS
+    };
+    if (report) {
+        writeJson(report.fullPath, result);
+    }
+    return result;
+}
+function channelDeltas(left, leftOffset, right, rightOffset) {
+    if (leftOffset < 0 || rightOffset < 0) {
+        return [255, 255, 255, 255];
+    }
+    return [
+        Math.abs(byteAt(left, leftOffset) - byteAt(right, rightOffset)),
+        Math.abs(byteAt(left, leftOffset + 1) - byteAt(right, rightOffset + 1)),
+        Math.abs(byteAt(left, leftOffset + 2) - byteAt(right, rightOffset + 2)),
+        Math.abs(byteAt(left, leftOffset + 3) - byteAt(right, rightOffset + 3))
+    ];
+}
+function resolveRequiredFile(projectRoot, value, label) {
+    if (!value) {
+        throw new Error(`${label} requires a project-relative path`);
+    }
+    const resolved = resolveProjectOrHarnessRelativePath(projectRoot, value, label);
+    if (!fs.existsSync(resolved.fullPath) || !fs.statSync(resolved.fullPath).isFile()) {
+        throw new Error(`${label} does not exist: ${resolved.relativePath}`);
+    }
+    return resolved;
+}
+function resolveOutputPath(projectRoot, value, label) {
+    if (!value) {
+        throw new Error(`${label} requires a project-relative path`);
+    }
+    return resolveProjectOrHarnessRelativePath(projectRoot, value, label);
+}
+function decodePng(buffer, label) {
+    if (buffer.length < 8 || !buffer.subarray(0, 8).equals(PNG_SIGNATURE)) {
+        throw new Error(`Unsupported PNG for ${label}: missing PNG signature`);
+    }
+    let offset = 8;
+    let width = 0;
+    let height = 0;
+    let colorType = -1;
+    let bitDepth = -1;
+    let interlace = -1;
+    const idat = [];
+    while (offset < buffer.length) {
+        const length = buffer.readUInt32BE(offset);
+        const type = buffer.subarray(offset + 4, offset + 8).toString("ascii");
+        const data = buffer.subarray(offset + 8, offset + 8 + length);
+        offset += 12 + length;
+        if (type === "IHDR") {
+            width = data.readUInt32BE(0);
+            height = data.readUInt32BE(4);
+            bitDepth = byteAt(data, 8);
+            colorType = byteAt(data, 9);
+            interlace = byteAt(data, 12);
+        }
+        else if (type === "IDAT") {
+            idat.push(data);
+        }
+        else if (type === "IEND") {
+            break;
+        }
+    }
+    if (bitDepth !== 8 || ![2, 6].includes(colorType) || interlace !== 0) {
+        throw new Error(`Unsupported PNG for ${label}: only 8-bit non-interlaced RGB/RGBA PNGs are supported`);
+    }
+    const channels = colorType === 6 ? 4 : 3;
+    const raw = zlib.inflateSync(Buffer.concat(idat));
+    const rowBytes = width * channels;
+    const rgba = new Uint8Array(width * height * 4);
+    let rawOffset = 0;
+    let previous = new Uint8Array(rowBytes);
+    for (let y = 0; y < height; y += 1) {
+        const filter = byteAt(raw, rawOffset);
+        rawOffset += 1;
+        const current = new Uint8Array(rowBytes);
+        current.set(raw.subarray(rawOffset, rawOffset + rowBytes));
+        rawOffset += rowBytes;
+        unfilterRow(current, previous, channels, filter);
+        for (let x = 0; x < width; x += 1) {
+            const source = x * channels;
+            const target = (y * width + x) * 4;
+            rgba[target] = byteAt(current, source);
+            rgba[target + 1] = byteAt(current, source + 1);
+            rgba[target + 2] = byteAt(current, source + 2);
+            rgba[target + 3] = channels === 4 ? byteAt(current, source + 3) : 255;
+        }
+        previous = current;
+    }
+    return { width, height, rgba };
+}
+function unfilterRow(row, previous, bytesPerPixel, filter) {
+    for (let index = 0; index < row.length; index += 1) {
+        const current = byteAt(row, index);
+        const left = index >= bytesPerPixel ? byteAt(row, index - bytesPerPixel) : 0;
+        const up = index < previous.length ? byteAt(previous, index) : 0;
+        const upLeft = index >= bytesPerPixel && index - bytesPerPixel < previous.length ? byteAt(previous, index - bytesPerPixel) : 0;
+        switch (filter) {
+            case 0:
+                break;
+            case 1:
+                row[index] = (current + left) & 0xff;
+                break;
+            case 2:
+                row[index] = (current + up) & 0xff;
+                break;
+            case 3:
+                row[index] = (current + Math.floor((left + up) / 2)) & 0xff;
+                break;
+            case 4:
+                row[index] = (current + paeth(left, up, upLeft)) & 0xff;
+                break;
+            default:
+                throw new Error(`Unsupported PNG filter type: ${filter}`);
+        }
+    }
+}
+function byteAt(buffer, index) {
+    const value = buffer[index];
+    if (value === undefined) {
+        throw new Error(`Unexpected out-of-range byte read at ${index}`);
+    }
+    return value;
+}
+function encodePngRgba(width, height, rgba) {
+    const rowBytes = width * 4;
+    const raw = Buffer.alloc((rowBytes + 1) * height);
+    for (let y = 0; y < height; y += 1) {
+        const rowStart = y * (rowBytes + 1);
+        raw[rowStart] = 0;
+        Buffer.from(rgba.buffer, rgba.byteOffset + y * rowBytes, rowBytes).copy(raw, rowStart + 1);
+    }
+    return Buffer.concat([
+        PNG_SIGNATURE,
+        pngChunk("IHDR", Buffer.from([
+            ...uint32(width),
+            ...uint32(height),
+            8,
+            6,
+            0,
+            0,
+            0
+        ])),
+        pngChunk("IDAT", zlib.deflateSync(raw)),
+        pngChunk("IEND", Buffer.alloc(0))
+    ]);
+}
+function pngChunk(type, data) {
+    const typeBuffer = Buffer.from(type, "ascii");
+    return Buffer.concat([
+        Buffer.from(uint32(data.length)),
+        typeBuffer,
+        data,
+        Buffer.from(uint32(crc32(Buffer.concat([typeBuffer, data]))))
+    ]);
+}
+function uint32(value) {
+    return [(value >>> 24) & 0xff, (value >>> 16) & 0xff, (value >>> 8) & 0xff, value & 0xff];
+}
+function paeth(left, up, upLeft) {
+    const estimate = left + up - upLeft;
+    const leftDistance = Math.abs(estimate - left);
+    const upDistance = Math.abs(estimate - up);
+    const upLeftDistance = Math.abs(estimate - upLeft);
+    if (leftDistance <= upDistance && leftDistance <= upLeftDistance) {
+        return left;
+    }
+    return upDistance <= upLeftDistance ? up : upLeft;
+}
+function crc32(buffer) {
+    let crc = 0xffffffff;
+    for (const byte of buffer) {
+        crc ^= byte;
+        for (let bit = 0; bit < 8; bit += 1) {
+            crc = (crc >>> 1) ^ (0xedb88320 & -(crc & 1));
+        }
+    }
+    return (crc ^ 0xffffffff) >>> 0;
+}
+function sha256File(filePath) {
+    return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+}
+function roundScore(value) {
+    return Number(value.toFixed(2));
+}
+//# sourceMappingURL=visual-compare.js.map

package/dist/runtime/visual-compare.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-harness",
-  "version": "0.6.5",
+  "version": "0.7.4",
   "type": "module",
   "files": [
     "dist",

package/templates/scaffold/vue/gitignore.tpl

@@ -9,7 +9,7 @@ test-results
 src/types/auto-imports.d.ts
 src/types/components.d.ts
 
-# frontend-harness generated runtime evidence
+# frontend-harness generated local state and evidence
 .frontend-harness/context/
 .frontend-harness/plans/
 .frontend-harness/execution-units/
@@ -17,7 +17,14 @@ src/types/components.d.ts
 .frontend-harness/guidance/
 .frontend-harness/state.json
 .frontend-harness/verification/
+.frontend-harness/design-sources/
+.frontend-harness/evidence/
+.frontend-harness/visual/
 .frontend-harness/logs/
 .frontend-harness/repair/
 .frontend-harness/repair-decision/
 .frontend-harness/state-explain/
+
+# Keep project-owned harness policy and knowledge tracked when useful:
+# .frontend-harness/knowledge/
+# .frontend-harness/skills/

package/templates/scaffold/vue/playwright.config.mjs

@@ -1,3 +1,4 @@
+/* global process */
 import { defineConfig, devices } from "@playwright/test";
 
 export default defineConfig({