@testivai/witness 2.4.0 → 2.6.0

package/dist/report/thumbnail.d.ts

@@ -0,0 +1,76 @@
+/**
+ * TestivAI Report — the thumbnail of a changed snapshot (thumb.png)
+ *
+ * A full-page diff is too tall to show inline where space is short (a pull
+ * request comment scales it to the column's width, and the change becomes a
+ * thin band). The thumbnail crops the changed area instead and puts the
+ * baseline, the current capture and the diff of it side by side:
+ *
+ *   baseline | current | diff     (2 px apart, at most 800×400 px)
+ *
+ * The area is on the diff canvas, which is the larger of the two sizes when
+ * they differ (witness pads both, anchored at the top left), so it is the
+ * same place in all three images; rows or columns a capture does not have
+ * are drawn as padding. Each panel is the area downscaled by area average,
+ * never upscaled. Plain RGBA arithmetic: no dependency beyond pngjs, which
+ * the caller encodes with.
+ */
+/** The bounds of a thumbnail. docs/extension-api.md quotes them. */
+export declare const THUMBNAIL_LIMITS: {
+    /** The widest strip, the three panels and both separators together. */
+    readonly maxWidth: 800;
+    /** The tallest strip. */
+    readonly maxHeight: 400;
+    /** Pixels of context around the changed regions, on every side. */
+    readonly padding: 24;
+    /** How many of the largest regions (by area) the area covers. */
+    readonly regions: 3;
+    /** Rows in the band shown when the diff has no regions. */
+    readonly bandHeight: 400;
+    /** Pixels between two panels. */
+    readonly separator: 2;
+};
+/** What a panel shows where its capture has no pixel (the padded part of the canvas). */
+export declare const THUMBNAIL_PADDING_RGBA: readonly [number, number, number, number];
+export interface ThumbnailBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** Decoded RGBA pixels, 4 bytes a pixel, row by row. */
+export interface RgbaImage {
+    data: Uint8Array | Uint8ClampedArray;
+    width: number;
+    height: number;
+}
+/**
+ * The area of the diff canvas the thumbnail shows: the union of the up to
+ * three largest regions by area, padded and kept inside the canvas. Without
+ * a region (none detected, or none inside the canvas), a full-width band of
+ * 400 rows from the first row with a differing pixel, moved up when the
+ * canvas ends sooner so it keeps its height. Null when no pixel of the diff
+ * differs.
+ *
+ * @param regions The snapshot's `regions`, on the diff canvas.
+ * @param diff    The diff image (the canvas): differing pixels are heat
+ *                (yellow to red); the rest is a grey wash of the baseline,
+ *                and masked areas are grey hatching.
+ */
+export declare function thumbnailArea(regions: readonly ThumbnailBox[] | undefined, diff: RgbaImage): ThumbnailBox | null;
+/**
+ * The strip for `area`: baseline | current | diff, each panel the area
+ * downscaled by area average to fit the strip in 800×400 px (never
+ * upscaled), 2 px apart. `baseline` and `current` keep their own sizes:
+ * where the canvas is larger than a capture, its panel shows padding.
+ */
+export declare function renderThumbnail(images: {
+    baseline: RgbaImage;
+    current: RgbaImage;
+    diff: RgbaImage;
+}, area: ThumbnailBox): {
+    data: Uint8ClampedArray;
+    width: number;
+    height: number;
+};
+//# sourceMappingURL=thumbnail.d.ts.map

package/dist/report/thumbnail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thumbnail.d.ts","sourceRoot":"","sources":["../../src/report/thumbnail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oEAAoE;AACpE,eAAO,MAAM,gBAAgB;IAC3B,uEAAuE;;IAEvE,yBAAyB;;IAEzB,mEAAmE;;IAEnE,iEAAiE;;IAEjE,2DAA2D;;IAE3D,iCAAiC;;CAEzB,CAAC;AAEX,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAwB,CAAC;AAKtG,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wDAAwD;AACxD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,UAAU,GAAG,iBAAiB,CAAC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,EAAE,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,IAAI,CAgBhH;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,EACpE,IAAI,EAAE,YAAY,GACjB;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA2D5D"}

package/dist/report/thumbnail.js

@@ -0,0 +1,166 @@
+"use strict";
+/**
+ * TestivAI Report — the thumbnail of a changed snapshot (thumb.png)
+ *
+ * A full-page diff is too tall to show inline where space is short (a pull
+ * request comment scales it to the column's width, and the change becomes a
+ * thin band). The thumbnail crops the changed area instead and puts the
+ * baseline, the current capture and the diff of it side by side:
+ *
+ *   baseline | current | diff     (2 px apart, at most 800×400 px)
+ *
+ * The area is on the diff canvas, which is the larger of the two sizes when
+ * they differ (witness pads both, anchored at the top left), so it is the
+ * same place in all three images; rows or columns a capture does not have
+ * are drawn as padding. Each panel is the area downscaled by area average,
+ * never upscaled. Plain RGBA arithmetic: no dependency beyond pngjs, which
+ * the caller encodes with.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THUMBNAIL_PADDING_RGBA = exports.THUMBNAIL_LIMITS = void 0;
+exports.thumbnailArea = thumbnailArea;
+exports.renderThumbnail = renderThumbnail;
+/** The bounds of a thumbnail. docs/extension-api.md quotes them. */
+exports.THUMBNAIL_LIMITS = {
+    /** The widest strip, the three panels and both separators together. */
+    maxWidth: 800,
+    /** The tallest strip. */
+    maxHeight: 400,
+    /** Pixels of context around the changed regions, on every side. */
+    padding: 24,
+    /** How many of the largest regions (by area) the area covers. */
+    regions: 3,
+    /** Rows in the band shown when the diff has no regions. */
+    bandHeight: 400,
+    /** Pixels between two panels. */
+    separator: 2,
+};
+/** What a panel shows where its capture has no pixel (the padded part of the canvas). */
+exports.THUMBNAIL_PADDING_RGBA = [175, 184, 193, 255];
+/** The line between two panels. */
+const SEPARATOR_RGBA = [87, 96, 106, 255];
+/**
+ * The area of the diff canvas the thumbnail shows: the union of the up to
+ * three largest regions by area, padded and kept inside the canvas. Without
+ * a region (none detected, or none inside the canvas), a full-width band of
+ * 400 rows from the first row with a differing pixel, moved up when the
+ * canvas ends sooner so it keeps its height. Null when no pixel of the diff
+ * differs.
+ *
+ * @param regions The snapshot's `regions`, on the diff canvas.
+ * @param diff    The diff image (the canvas): differing pixels are heat
+ *                (yellow to red); the rest is a grey wash of the baseline,
+ *                and masked areas are grey hatching.
+ */
+function thumbnailArea(regions, diff) {
+    const canvas = { x: 0, y: 0, width: diff.width, height: diff.height };
+    const inside = (regions ?? [])
+        .map((r) => intersect(r, canvas))
+        .filter((r) => r !== null)
+        .sort((a, b) => b.width * b.height - a.width * a.height)
+        .slice(0, exports.THUMBNAIL_LIMITS.regions);
+    if (inside.length > 0) {
+        const p = exports.THUMBNAIL_LIMITS.padding;
+        const box = inside.reduce(union);
+        return intersect({ x: box.x - p, y: box.y - p, width: box.width + 2 * p, height: box.height + 2 * p }, canvas);
+    }
+    const first = firstDifferingRow(diff);
+    if (first === null)
+        return null;
+    const height = Math.min(exports.THUMBNAIL_LIMITS.bandHeight, diff.height);
+    return { x: 0, y: Math.min(first, diff.height - height), width: diff.width, height };
+}
+/**
+ * The strip for `area`: baseline | current | diff, each panel the area
+ * downscaled by area average to fit the strip in 800×400 px (never
+ * upscaled), 2 px apart. `baseline` and `current` keep their own sizes:
+ * where the canvas is larger than a capture, its panel shows padding.
+ */
+function renderThumbnail(images, area) {
+    const { maxWidth, maxHeight, separator } = exports.THUMBNAIL_LIMITS;
+    const scale = Math.min(1, (maxWidth - 2 * separator) / (3 * area.width), maxHeight / area.height);
+    const panelWidth = Math.max(1, Math.round(area.width * scale));
+    const panelHeight = Math.max(1, Math.round(area.height * scale));
+    const width = 3 * panelWidth + 2 * separator;
+    const out = new Uint8ClampedArray(width * panelHeight * 4);
+    // Output column (row) i averages source columns (rows) [start(i), start(i + 1)):
+    // a partition of the area, since a panel is never larger than the area.
+    const starts = (size, n) => Int32Array.from({ length: n + 1 }, (_, i) => Math.floor((i * size) / n));
+    const colStart = starts(area.width, panelWidth);
+    const rowStart = starts(area.height, panelHeight);
+    const columnOf = new Int32Array(area.width);
+    for (let c = 0; c < panelWidth; c++)
+        columnOf.fill(c, colStart[c], colStart[c + 1]);
+    const sums = new Float64Array(panelWidth * 4);
+    const pad = exports.THUMBNAIL_PADDING_RGBA;
+    [images.baseline, images.current, images.diff].forEach((image, panel) => {
+        const left = panel * (panelWidth + separator);
+        // Columns of the area this capture has; the rest is padding.
+        const inWidth = Math.max(0, Math.min(area.width, image.width - area.x));
+        for (let oy = 0; oy < panelHeight; oy++) {
+            sums.fill(0);
+            // One pass over the source rows, adding each pixel to its output column.
+            for (let y = area.y + rowStart[oy]; y < area.y + rowStart[oy + 1]; y++) {
+                const hasRow = y < image.height;
+                const rowOffset = (y * image.width + area.x) * 4;
+                for (let xi = 0; xi < area.width; xi++) {
+                    const s = columnOf[xi] * 4;
+                    if (hasRow && xi < inWidth) {
+                        const i = rowOffset + xi * 4;
+                        sums[s] += image.data[i];
+                        sums[s + 1] += image.data[i + 1];
+                        sums[s + 2] += image.data[i + 2];
+                        sums[s + 3] += image.data[i + 3];
+                    }
+                    else {
+                        sums[s] += pad[0];
+                        sums[s + 1] += pad[1];
+                        sums[s + 2] += pad[2];
+                        sums[s + 3] += pad[3];
+                    }
+                }
+            }
+            const rowsHere = rowStart[oy + 1] - rowStart[oy];
+            for (let ox = 0; ox < panelWidth; ox++) {
+                const n = rowsHere * (colStart[ox + 1] - colStart[ox]);
+                const o = (oy * width + left + ox) * 4;
+                for (let ch = 0; ch < 4; ch++)
+                    out[o + ch] = Math.round(sums[ox * 4 + ch] / n);
+            }
+        }
+    });
+    for (const left of [panelWidth, 2 * panelWidth + separator]) {
+        for (let y = 0; y < panelHeight; y++) {
+            for (let x = left; x < left + separator; x++)
+                out.set(SEPARATOR_RGBA, (y * width + x) * 4);
+        }
+    }
+    return { data: out, width, height: panelHeight };
+}
+/** The first row with a heat pixel: the diff paints unchanged pixels grey (r = g = b), changed ones yellow to red. */
+function firstDifferingRow(diff) {
+    const { data, width, height } = diff;
+    for (let y = 0; y < height; y++) {
+        for (let i = y * width * 4, end = i + width * 4; i < end; i += 4) {
+            if (data[i + 3] !== 0 && (data[i] !== data[i + 1] || data[i + 1] !== data[i + 2]))
+                return y;
+        }
+    }
+    return null;
+}
+/** The overlap of two boxes in whole pixels (a fractional edge takes the pixel it touches), or null when they share none. */
+function intersect(a, b) {
+    if (![a.x, a.y, a.width, a.height].every(Number.isFinite))
+        return null;
+    const x = Math.max(Math.floor(a.x), b.x);
+    const y = Math.max(Math.floor(a.y), b.y);
+    const right = Math.min(Math.ceil(a.x + a.width), b.x + b.width);
+    const bottom = Math.min(Math.ceil(a.y + a.height), b.y + b.height);
+    return right > x && bottom > y ? { x, y, width: right - x, height: bottom - y } : null;
+}
+function union(a, b) {
+    const x = Math.min(a.x, b.x);
+    const y = Math.min(a.y, b.y);
+    return { x, y, width: Math.max(a.x + a.width, b.x + b.width) - x, height: Math.max(a.y + a.height, b.y + b.height) - y };
+}
+//# sourceMappingURL=thumbnail.js.map

package/dist/report/thumbnail.js.map

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

package/dist/report/validate.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Read a results.json you did not produce.
+ *
+ * A published report is rebuilt from results.json, and that file can come
+ * from a CI run the reader does not control (a fork's pull request). The
+ * template escapes every string it shows; it does not check that numbers
+ * are numbers, that enums hold known values, or that the data has the
+ * expected shape. This does, for every field the report reads:
+ *
+ * - each field must have its type (a finite number, text, a known value),
+ *   within size limits, or the whole file is rejected with the field's path;
+ * - fields it does not know are dropped, at every level;
+ * - image paths (`baselinePath`, `currentPath`, `diffPath`, `thumbPath`) are
+ *   never taken from the file: the caller adds them for the images it
+ *   actually has. A `thumbPath` (schema 2.6.0) that is there must be text,
+ *   or the file is rejected like for any other field.
+ *
+ * Its own module with no Node dependencies, so the GitHub Action can bundle
+ * it without the rest of the report code.
+ */
+import type { ReportData } from './results';
+/** The results.json major version this reads: the major of RESULTS_SCHEMA_VERSION (generator.ts). */
+export declare const SUPPORTED_SCHEMA_MAJOR = 2;
+/** Size limits; a file over one is rejected. Far above what a real suite writes. */
+export declare const REPORT_DATA_LIMITS: {
+    readonly snapshots: 5000;
+    readonly nameLength: 300;
+    readonly textLength: 2000;
+    readonly regions: 1000;
+    readonly elementsPerRegion: 10;
+    readonly styleElements: 200;
+    readonly masks: 500;
+    readonly maskWarnings: 200;
+    readonly maskSpecKeys: 50;
+    readonly missingBaselines: 5000;
+    readonly environmentKeys: 20;
+    readonly environmentValueLength: 200;
+    readonly environmentFields: 100;
+    readonly healthLines: 100;
+};
+export type ParsedReportData = {
+    ok: true;
+    data: ReportData;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Check a parsed results.json and return only the typed data the report
+ * needs, or the reason it cannot be shown.
+ */
+export declare function parseReportData(json: unknown): ParsedReportData;
+//# sourceMappingURL=validate.d.ts.map

package/dist/report/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/report/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EACV,UAAU,EAOX,MAAM,WAAW,CAAC;AAEnB,qGAAqG;AACrG,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC,oFAAoF;AACpF,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;CAerB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE9F;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAO/D"}