@testivai/witness 2.4.0 → 2.5.0

package/dist/report/environment.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * TestivAI Report — what changed in the capture environment
+ *
+ * The compare reads the environment the baseline was captured in next to the
+ * current capture's (capture/environment.ts) and lists every field that
+ * differs. Only some of those can change how a page renders. A new browser
+ * build, another OS, distro or architecture, another device scale, viewport,
+ * color scheme, locale or time zone, another capture method, a container or a
+ * relabelled environment can; a newer test framework, adapter or driver, a
+ * new CI runner image or another project name cannot on its own (a browser
+ * that came with a framework upgrade shows up as the browser change).
+ *
+ * When pixels differ, the DOM and the computed styles are identical and the
+ * rendering environment changed, the diff is RENDERING DRIFT: the machine
+ * changed, not the page. The report, @testivai/mcp and the GitHub Action
+ * word it that way instead of "likely render noise", and say it once at the
+ * top when several snapshots share the same change.
+ *
+ * Read from results.json fields only, so every surface agrees.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.diffEnvironments = diffEnvironments;
+exports.describeCaptureMethod = describeCaptureMethod;
+exports.describeEnvironmentChange = describeEnvironmentChange;
+exports.isRenderingDrift = isRenderingDrift;
+exports.snapshotEnvironmentChange = snapshotEnvironmentChange;
+exports.commonEnvironment = commonEnvironment;
+exports.environmentChangeGroups = environmentChangeGroups;
+exports.environmentChangeLine = environmentChangeLine;
+const diff_shape_1 = require("./diff-shape");
+/** Fields whose absence means "no": the collector always decides them. */
+const PRESENCE_DEFAULTS = { container: 'false', label: '', 'ci.provider': 'none' };
+/** Fields that can change rendering on any platform. */
+const RENDERING_FIELDS = new Set([
+    'browser.name',
+    'browser.version',
+    'browser.channel',
+    'browser.headless',
+    'os.platform',
+    'os.arch',
+    'os.distro',
+    'render.viewport',
+    'render.deviceScaleFactor',
+    'render.colorScheme',
+    'render.reducedMotion',
+    'render.locale',
+    'render.timezone',
+    'adapter.captureMethod',
+    'container',
+    'label',
+]);
+/** Platforms whose os.release is the OS version (and so the text renderer). */
+const RELEASE_IS_OS_VERSION = new Set(['darwin', 'win32']);
+function flatten(env) {
+    const flat = new Map();
+    const put = (key, value) => {
+        if (value === undefined || value === null)
+            return;
+        flat.set(key, String(value));
+    };
+    for (const [section, value] of Object.entries(env)) {
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            for (const [field, inner] of Object.entries(value)) {
+                if (section === 'render' && field === 'viewport' && inner && typeof inner === 'object') {
+                    const vp = inner;
+                    put('render.viewport', `${vp.width}x${vp.height}`);
+                }
+                else if (inner === null || typeof inner !== 'object') {
+                    put(`${section}.${field}`, inner);
+                }
+            }
+        }
+        else {
+            put(section, value);
+        }
+    }
+    return flat;
+}
+/** Whether one differing field can change how the page renders. */
+function isRenderingField(field, baseline, candidate) {
+    if (field.startsWith('render.'))
+        return true;
+    if (field === 'os.release') {
+        return baseline.os.platform === candidate.os.platform && RELEASE_IS_OS_VERSION.has(candidate.os.platform);
+    }
+    return RENDERING_FIELDS.has(field);
+}
+/**
+ * Every field that differs between two recorded environments, and the subset
+ * that can change rendering, both sorted. A field recorded on one side only
+ * is unknown (an older adapter did not record it), not a change; the
+ * container, the label and the CI provider are always decided by the
+ * collector, so their absence means "no".
+ */
+function diffEnvironments(baseline, candidate) {
+    const a = flatten(baseline);
+    const b = flatten(candidate);
+    const keys = new Set([...a.keys(), ...b.keys(), ...Object.keys(PRESENCE_DEFAULTS)]);
+    const delta = [];
+    for (const key of keys) {
+        const fallback = PRESENCE_DEFAULTS[key];
+        const left = a.get(key) ?? fallback;
+        const right = b.get(key) ?? fallback;
+        if (left === undefined || right === undefined)
+            continue;
+        if (left !== right)
+            delta.push(key);
+    }
+    delta.sort();
+    return { delta, renderingDelta: delta.filter((f) => isRenderingField(f, baseline, candidate)) };
+}
+const MECHANISMS = {
+    cdp: 'CDP',
+    playwright: 'Playwright',
+    stitched: 'scroll and stitch',
+    firefox: 'Firefox',
+    webdriver: 'WebDriver',
+};
+/** "full-page:cdp" → "full page (CDP)"; an unknown method passes through. */
+function describeCaptureMethod(method) {
+    const m = /^(full-page|viewport):([a-z0-9-]+)$/.exec(method);
+    if (!m)
+        return method;
+    return `${m[1] === 'full-page' ? 'full page' : 'viewport'} (${MECHANISMS[m[2]] ?? m[2]})`;
+}
+/** The order changes are listed in: what renders first, context last. */
+const ORDER = [
+    'browser',
+    'browser.channel',
+    'browser.headless',
+    'os.platform',
+    'os.distro',
+    'os.release',
+    'os.arch',
+    'render.viewport',
+    'render.deviceScaleFactor',
+    'render.colorScheme',
+    'render.reducedMotion',
+    'render.locale',
+    'render.timezone',
+    'adapter.captureMethod',
+    'container',
+    'label',
+];
+const LABELS = {
+    'browser.channel': 'channel',
+    'browser.headless': 'headless',
+    'os.platform': 'OS',
+    'os.release': 'OS release',
+    'os.arch': 'arch',
+    'render.viewport': 'viewport',
+    'render.deviceScaleFactor': 'device scale',
+    'render.colorScheme': 'color scheme',
+    'render.reducedMotion': 'reduced motion',
+    'render.locale': 'locale',
+    'render.timezone': 'time zone',
+    'ci.provider': 'CI',
+    'ci.runnerImage': 'runner image',
+    project: 'project',
+};
+const yesNo = (v) => (v === 'true' ? 'yes' : 'no');
+/**
+ * The listed fields as one readable clause, each with its values, in a fixed
+ * order: "chromium 130.0.6723.58 → 141.0.7390.37, ubuntu 22.04 → ubuntu
+ * 24.04, capture method full page (CDP) → viewport (WebDriver)".
+ */
+function describeEnvironmentChange(baseline, candidate, fields) {
+    const a = flatten(baseline);
+    const b = flatten(candidate);
+    const set = new Set(fields);
+    const parts = [];
+    const rank = (key) => {
+        const i = ORDER.indexOf(key);
+        return i === -1 ? ORDER.length : i;
+    };
+    if (set.has('browser.name') || set.has('browser.version')) {
+        const side = (f, withName) => [withName ? f.get('browser.name') : undefined, f.get('browser.version')].filter(Boolean).join(' ');
+        const sameName = a.get('browser.name') === b.get('browser.name');
+        parts.push({ rank: rank('browser'), text: `${side(a, true)} → ${side(b, !sameName)}` });
+    }
+    for (const field of set) {
+        if (field === 'browser.name' || field === 'browser.version')
+            continue;
+        const left = a.get(field);
+        const right = b.get(field);
+        let text;
+        if (field === 'browser.headless' || field === 'container') {
+            text = `${field === 'container' ? 'container' : 'headless'} ${yesNo(left)} → ${yesNo(right)}`;
+        }
+        else if (field === 'label') {
+            text = `environment label ${left || 'none'} → ${right || 'none'}`;
+        }
+        else if (field === 'os.distro') {
+            text = `${left ?? 'unknown'} → ${right ?? 'unknown'}`;
+        }
+        else if (field === 'adapter.captureMethod') {
+            text = `capture method ${describeCaptureMethod(left ?? '?')} → ${describeCaptureMethod(right ?? '?')}`;
+        }
+        else if (/^(framework|adapter|driver)\.version$/.test(field)) {
+            const owner = field.split('.')[0];
+            text = `${b.get(`${owner}.name`) ?? owner} ${left ?? '?'} → ${right ?? '?'}`;
+        }
+        else {
+            text = `${LABELS[field] ?? field} ${left ?? 'none'} → ${right ?? 'none'}`;
+        }
+        parts.push({ rank: rank(field), text });
+    }
+    return parts
+        .sort((x, y) => x.rank - y.rank)
+        .map((p) => p.text)
+        .join(', ');
+}
+/** Rendering fields that also explain a size change. */
+const SIZE_FIELDS = ['render.viewport', 'render.deviceScaleFactor', 'adapter.captureMethod'];
+/**
+ * Rendering drift: pixels differ (the snapshot is changed, or was auto-passed
+ * by a tolerance), the DOM is identical, the computed styles were compared and
+ * match, and the rendering environment changed since the baseline. Never for
+ * a diff concentrated in one area (a new browser or OS redraws text
+ * everywhere; one area is a bad capture or a change the style check does not
+ * cover). A size change counts only when the environment explains it (the
+ * viewport, the device scale or the capture method changed).
+ */
+function isRenderingDrift(snapshot) {
+    if (snapshot.status !== 'changed' && !(snapshot.status === 'passed' && snapshot.autoPassed))
+        return false;
+    const rendering = snapshot.environment?.renderingDelta ?? [];
+    if (rendering.length === 0)
+        return false;
+    const dom = snapshot.dom;
+    if (!dom || dom.changed || dom.styleCheck !== 'match')
+        return false;
+    if (snapshot.sizeMismatch)
+        return rendering.some((f) => SIZE_FIELDS.includes(f));
+    return (0, diff_shape_1.diffShape)(snapshot).kind !== 'concentrated';
+}
+/** The rendering change of one snapshot, worded, or null when there is none. */
+function snapshotEnvironmentChange(snapshot) {
+    const e = snapshot.environment;
+    if (!e || e.renderingDelta.length === 0 || !e.baseline || !e.candidate)
+        return null;
+    return describeEnvironmentChange(e.baseline, e.candidate, e.renderingDelta);
+}
+const SECTIONS_ORDER = [
+    'os',
+    'browser',
+    'framework',
+    'adapter',
+    'driver',
+    'render',
+    'ci',
+    'container',
+    'label',
+    'project',
+];
+/**
+ * The fields every listed environment agrees on: the run-level block in
+ * results.json. One environment is its own; none is null.
+ */
+function commonEnvironment(envs) {
+    if (envs.length === 0)
+        return null;
+    const same = (values) => values.every((v) => JSON.stringify(v) === JSON.stringify(values[0]));
+    const out = {};
+    for (const section of SECTIONS_ORDER) {
+        const values = envs.map((e) => e[section]);
+        if (values.every((v) => v === undefined))
+            continue;
+        const first = values[0];
+        if (first && typeof first === 'object' && !Array.isArray(first)) {
+            if (values.some((v) => !v || typeof v !== 'object'))
+                continue;
+            const shared = {};
+            for (const key of Object.keys(first)) {
+                const inner = values.map((v) => v[key]);
+                if (same(inner))
+                    shared[key] = inner[0];
+            }
+            if (Object.keys(shared).length > 0)
+                out[section] = shared;
+        }
+        else if (same(values)) {
+            out[section] = first;
+        }
+    }
+    return out;
+}
+/**
+ * Changed (and auto-passed) snapshots grouped by the same rendering
+ * environment change, largest group first. A passed snapshot with no pixel
+ * diff is not counted: nothing to explain.
+ */
+function environmentChangeGroups(snapshots) {
+    const groups = new Map();
+    for (const s of snapshots) {
+        if (s.status !== 'changed' && !(s.status === 'passed' && s.autoPassed))
+            continue;
+        const change = snapshotEnvironmentChange(s);
+        if (!change)
+            continue;
+        const group = groups.get(change) ?? { change, snapshots: [], drift: [] };
+        group.snapshots.push(s.name);
+        if (isRenderingDrift(s))
+            group.drift.push(s.name);
+        groups.set(change, group);
+    }
+    return [...groups.values()].sort((x, y) => y.snapshots.length - x.snapshots.length);
+}
+const plural = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+/**
+ * The line said once at the top of the report, the PR comment and
+ * get_visual_results for a group of two or more snapshots, with an honest
+ * count of how many are drift alone.
+ */
+function environmentChangeLine(group) {
+    const n = group.snapshots.length;
+    const d = group.drift.length;
+    const head = `Environment changed since the baselines (${group.change})`;
+    if (d === n) {
+        return (`${head}: ${plural(n, 'diff is', 'diffs are')} rendering drift (DOM and computed styles identical), not page changes; ` +
+            `re-baseline ${n === 1 ? 'it' : 'them'} once the images are confirmed.`);
+    }
+    if (d === 0) {
+        return `${head} for ${plural(n, 'snapshot', 'snapshots')}; each also has a change the environment does not explain, so review ${n === 1 ? 'it' : 'them'} on ${n === 1 ? 'its' : 'their'} own.`;
+    }
+    const rest = n - d;
+    return (`${head} for ${plural(n, 'snapshot', 'snapshots')}: ${d} ${d === 1 ? 'is' : 'are'} rendering drift (DOM and computed styles identical); ` +
+        `${rest} also ${rest === 1 ? 'has' : 'have'} a change the environment does not explain, review ${rest === 1 ? 'it' : 'them'} on ${rest === 1 ? 'its' : 'their'} own.`);
+}
+//# sourceMappingURL=environment.js.map

package/dist/report/environment.js.map

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

package/dist/report/generator.d.ts

@@ -36,7 +36,12 @@ export interface GenerateReportOptions {
  * @returns The report data
  */
 /**
- * results.json schema version. 2.4.0 adds per-snapshot `sizeMismatch`
+ * results.json schema version. 2.5.0 adds capture provenance: per-snapshot
+ * `environment` (what changed between the environment the baseline was
+ * captured in and the current capture's: `delta`, `renderingDelta`, both
+ * blocks when they differ, and `policy: "strict"` when that policy made the
+ * snapshot changed) and the run-level `environment` (the fields every capture
+ * of the run agrees on). 2.4.0 added per-snapshot `sizeMismatch`
  * (the baseline's and the candidate's dimensions when they differ; the diff
  * is then on a canvas of max width × max height with every padded pixel
  * counted as changed). 2.3.0 added top-level `missingBaselines[]`
@@ -45,7 +50,7 @@ export interface GenerateReportOptions {
  * diff bounding boxes), `masks[]` (applied masks with their source — the
  * audit trail), and `maskWarnings[]`. All additive.
  */
-export declare const RESULTS_SCHEMA_VERSION = "2.4.0";
+export declare const RESULTS_SCHEMA_VERSION = "2.5.0";
 /**
  * Write results.json for an already-computed set of snapshot results.
  * Exposed for callers that manage comparison and rendering separately.

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

@@ -1 +1 @@
-{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/report/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAiB,cAAc,EAAC,MAAM,WAAW,CAAC;AAK1E,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAA+B,GACvC,IAAI,CAGN;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CA+DzE;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAoB3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzF"}
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/report/generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAmC,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,KAAK,EAAE,UAAU,EAAiB,cAAc,EAAC,MAAM,WAAW,CAAC;AAO1E,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED;;;;;;;;;;GAUG;AACH;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAE9C;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,cAAc,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAA+B,GACvC,IAAI,CAGN;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CAqFzE;AA0BD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAoB3D;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOzF"}

package/dist/report/generator.js

@@ -51,6 +51,8 @@ const compare_1 = require("./compare");
 const template_1 = require("./template");
 const local_config_1 = require("../config/local-config");
 const store_1 = require("../baselines/store");
+const environment_1 = require("../capture/environment");
+const environment_2 = require("./environment");
 /**
  * Generate a complete visual regression report.
  *
@@ -63,7 +65,12 @@ const store_1 = require("../baselines/store");
  * @returns The report data
  */
 /**
- * results.json schema version. 2.4.0 adds per-snapshot `sizeMismatch`
+ * results.json schema version. 2.5.0 adds capture provenance: per-snapshot
+ * `environment` (what changed between the environment the baseline was
+ * captured in and the current capture's: `delta`, `renderingDelta`, both
+ * blocks when they differ, and `policy: "strict"` when that policy made the
+ * snapshot changed) and the run-level `environment` (the fields every capture
+ * of the run agrees on). 2.4.0 added per-snapshot `sizeMismatch`
  * (the baseline's and the candidate's dimensions when they differ; the diff
  * is then on a canvas of max width × max height with every padded pixel
  * counted as changed). 2.3.0 added top-level `missingBaselines[]`
@@ -72,7 +79,7 @@ const store_1 = require("../baselines/store");
  * diff bounding boxes), `masks[]` (applied masks with their source — the
  * audit trail), and `maskWarnings[]`. All additive.
  */
-exports.RESULTS_SCHEMA_VERSION = '2.4.0';
+exports.RESULTS_SCHEMA_VERSION = '2.5.0';
 /**
  * Write results.json for an already-computed set of snapshot results.
  * Exposed for callers that manage comparison and rendering separately.
@@ -106,17 +113,36 @@ function generateReport(options) {
         mask: localConfig.mask,
         diffRegions: localConfig.diffRegions,
         volatileAttributes: localConfig.volatileAttributes,
+        environmentPolicy: localConfig.environmentPolicy,
     };
     const snapshots = (0, compare_1.compareAll)(compareOptions);
     // 1.5. Coverage-loss signal: baselines that received no capture this run
     // (a deleted/renamed test silently stops guarding its page). Reported
     // always; gated only via `--fail-on-missing` / config `failOnMissing`,
     // because filtered runs (`--grep`) legitimately skip most baselines.
+    // Under environmentPolicy "separate", a baseline keyed for another
+    // environment (another browser or platform) is not this run's to capture,
+    // so only baselines of an environment this run captured can be missing.
     const store = new store_1.BaselineStore(projectRoot);
-    const capturedNames = new Set(store.listTemp());
-    const missingBaselines = store.list().filter((n) => !capturedNames.has(n));
+    const capturedNames = store.listTemp();
+    const captured = new Set(capturedNames);
+    const variantKey = (v) => `${v.browser}__${v.platform}`;
+    const capturedVariants = new Set(capturedNames.map(environment_1.parseEnvironmentVariant).filter((v) => v !== null).map(variantKey));
+    const missingBaselines = store.list().filter((n) => {
+        if (captured.has(n))
+            return false;
+        if (localConfig.environmentPolicy !== 'separate')
+            return true;
+        const variant = (0, environment_1.parseEnvironmentVariant)(n);
+        return variant === null || capturedVariants.has(variantKey(variant));
+    });
+    // 1.6. Run-level capture provenance: the fields every capture of this run
+    // that recorded an environment agrees on.
+    const environment = (0, environment_2.commonEnvironment)(capturedNames
+        .map((n) => (0, environment_1.readEnvironment)(store.readTempMetadata(n)?.environment))
+        .filter((e) => e !== null));
     // 2-3. Build summary + report data
-    const reportData = buildReportData(snapshots, version, missingBaselines);
+    const reportData = buildReportData(snapshots, version, missingBaselines, environment);
     // 4. Write results.json
     const resultsPath = path.join(reportDir, 'results.json');
     fs.writeFileSync(resultsPath, JSON.stringify(reportData, null, 2));
@@ -131,7 +157,7 @@ function generateReport(options) {
     return reportData;
 }
 /** Assemble the ReportData envelope for a set of snapshot results. */
-function buildReportData(snapshots, version, missingBaselines = []) {
+function buildReportData(snapshots, version, missingBaselines = [], environment = null) {
     const summary = {
         total: snapshots.length,
         passed: snapshots.filter((s) => s.status === 'passed').length,
@@ -145,6 +171,7 @@ function buildReportData(snapshots, version, missingBaselines = []) {
         summary,
         snapshots,
         missingBaselines,
+        ...(environment ? { environment } : {}),
     };
 }
 /**

package/dist/report/generator.js.map

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

package/dist/report/index.d.ts

@@ -5,10 +5,13 @@ export { generateReport } from './generator';
 export type { GenerateReportOptions } from './generator';
 export { compareAll } from './compare';
 export type { CompareOptions, PassCriteria } from './compare';
-export { renderHtml } from './template';
+export { renderHtml, snapshotAnchorId } from './template';
 export { diffShape, describeRegions, NOISE_MAX_DIFF_PERCENT, CONCENTRATED_MAX_PAGE_SHARE, STYLE_CHECK_DOES_NOT_COVER, } from './diff-shape';
 export type { DiffShape, DiffShapeBox, DiffShapeInput } from './diff-shape';
 export { describeSizeChange, explainHeightChange, formatSizeMismatch, formatSizes, sizeMismatchKind } from './size-mismatch';
 export type { Dimensions, HeightChangeContext, SizeMismatchInfo } from './size-mismatch';
-export type { ReportData, ReportSummary, SnapshotResult, SnapshotStatus, SnapshotDomSignal, } from './results';
+export { commonEnvironment, describeCaptureMethod, describeEnvironmentChange, diffEnvironments, environmentChangeGroups, environmentChangeLine, isRenderingDrift, snapshotEnvironmentChange, } from './environment';
+export type { EnvironmentChangeGroup, EnvironmentSnapshotInput } from './environment';
+export type { CaptureEnvironment, RenderEnvironment } from '../capture/environment';
+export type { ReportData, ReportSummary, SnapshotResult, SnapshotStatus, SnapshotDomSignal, SnapshotEnvironment, } from './results';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EACL,SAAS,EACT,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7H,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzF,YAAY,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,GAClB,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,SAAS,EACT,eAAe,EACf,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7H,YAAY,EAAE,UAAU,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,yBAAyB,EACzB,gBAAgB,EAChB,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACtF,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AACpF,YAAY,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,WAAW,CAAC"}

package/dist/report/index.js

@@ -3,13 +3,14 @@
  * TestivAI Report Generator
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sizeMismatchKind = exports.formatSizes = exports.formatSizeMismatch = exports.explainHeightChange = exports.describeSizeChange = exports.STYLE_CHECK_DOES_NOT_COVER = exports.CONCENTRATED_MAX_PAGE_SHARE = exports.NOISE_MAX_DIFF_PERCENT = exports.describeRegions = exports.diffShape = exports.renderHtml = exports.compareAll = exports.generateReport = void 0;
+exports.snapshotEnvironmentChange = exports.isRenderingDrift = exports.environmentChangeLine = exports.environmentChangeGroups = exports.diffEnvironments = exports.describeEnvironmentChange = exports.describeCaptureMethod = exports.commonEnvironment = exports.sizeMismatchKind = exports.formatSizes = exports.formatSizeMismatch = exports.explainHeightChange = exports.describeSizeChange = exports.STYLE_CHECK_DOES_NOT_COVER = exports.CONCENTRATED_MAX_PAGE_SHARE = exports.NOISE_MAX_DIFF_PERCENT = exports.describeRegions = exports.diffShape = exports.snapshotAnchorId = exports.renderHtml = exports.compareAll = exports.generateReport = void 0;
 var generator_1 = require("./generator");
 Object.defineProperty(exports, "generateReport", { enumerable: true, get: function () { return generator_1.generateReport; } });
 var compare_1 = require("./compare");
 Object.defineProperty(exports, "compareAll", { enumerable: true, get: function () { return compare_1.compareAll; } });
 var template_1 = require("./template");
 Object.defineProperty(exports, "renderHtml", { enumerable: true, get: function () { return template_1.renderHtml; } });
+Object.defineProperty(exports, "snapshotAnchorId", { enumerable: true, get: function () { return template_1.snapshotAnchorId; } });
 var diff_shape_1 = require("./diff-shape");
 Object.defineProperty(exports, "diffShape", { enumerable: true, get: function () { return diff_shape_1.diffShape; } });
 Object.defineProperty(exports, "describeRegions", { enumerable: true, get: function () { return diff_shape_1.describeRegions; } });
@@ -22,4 +23,13 @@ Object.defineProperty(exports, "explainHeightChange", { enumerable: true, get: f
 Object.defineProperty(exports, "formatSizeMismatch", { enumerable: true, get: function () { return size_mismatch_1.formatSizeMismatch; } });
 Object.defineProperty(exports, "formatSizes", { enumerable: true, get: function () { return size_mismatch_1.formatSizes; } });
 Object.defineProperty(exports, "sizeMismatchKind", { enumerable: true, get: function () { return size_mismatch_1.sizeMismatchKind; } });
+var environment_1 = require("./environment");
+Object.defineProperty(exports, "commonEnvironment", { enumerable: true, get: function () { return environment_1.commonEnvironment; } });
+Object.defineProperty(exports, "describeCaptureMethod", { enumerable: true, get: function () { return environment_1.describeCaptureMethod; } });
+Object.defineProperty(exports, "describeEnvironmentChange", { enumerable: true, get: function () { return environment_1.describeEnvironmentChange; } });
+Object.defineProperty(exports, "diffEnvironments", { enumerable: true, get: function () { return environment_1.diffEnvironments; } });
+Object.defineProperty(exports, "environmentChangeGroups", { enumerable: true, get: function () { return environment_1.environmentChangeGroups; } });
+Object.defineProperty(exports, "environmentChangeLine", { enumerable: true, get: function () { return environment_1.environmentChangeLine; } });
+Object.defineProperty(exports, "isRenderingDrift", { enumerable: true, get: function () { return environment_1.isRenderingDrift; } });
+Object.defineProperty(exports, "snapshotEnvironmentChange", { enumerable: true, get: function () { return environment_1.snapshotEnvironmentChange; } });
 //# sourceMappingURL=index.js.map

package/dist/report/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAEnB,uCAAwC;AAA/B,sGAAA,UAAU,OAAA;AACnB,2CAMsB;AALpB,uGAAA,SAAS,OAAA;AACT,6GAAA,eAAe,OAAA;AACf,oHAAA,sBAAsB,OAAA;AACtB,yHAAA,2BAA2B,OAAA;AAC3B,wHAAA,0BAA0B,OAAA;AAG5B,iDAA6H;AAApH,mHAAA,kBAAkB,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,4GAAA,WAAW,OAAA;AAAE,iHAAA,gBAAgB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/report/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yCAA6C;AAApC,2GAAA,cAAc,OAAA;AAEvB,qCAAuC;AAA9B,qGAAA,UAAU,OAAA;AAEnB,uCAA0D;AAAjD,sGAAA,UAAU,OAAA;AAAE,4GAAA,gBAAgB,OAAA;AACrC,2CAMsB;AALpB,uGAAA,SAAS,OAAA;AACT,6GAAA,eAAe,OAAA;AACf,oHAAA,sBAAsB,OAAA;AACtB,yHAAA,2BAA2B,OAAA;AAC3B,wHAAA,0BAA0B,OAAA;AAG5B,iDAA6H;AAApH,mHAAA,kBAAkB,OAAA;AAAE,oHAAA,mBAAmB,OAAA;AAAE,mHAAA,kBAAkB,OAAA;AAAE,4GAAA,WAAW,OAAA;AAAE,iHAAA,gBAAgB,OAAA;AAEnG,6CASuB;AARrB,gHAAA,iBAAiB,OAAA;AACjB,oHAAA,qBAAqB,OAAA;AACrB,wHAAA,yBAAyB,OAAA;AACzB,+GAAA,gBAAgB,OAAA;AAChB,sHAAA,uBAAuB,OAAA;AACvB,oHAAA,qBAAqB,OAAA;AACrB,+GAAA,gBAAgB,OAAA;AAChB,wHAAA,yBAAyB,OAAA"}

package/dist/report/results.d.ts

@@ -121,6 +121,34 @@ export interface SnapshotResult {
             height: number;
         };
     };
+    /**
+     * Capture provenance (schema 2.5.0): present when the baseline and the
+     * current capture both recorded the environment they were captured in
+     * (metadata.json `environment`). See report/environment.ts.
+     */
+    environment?: SnapshotEnvironment;
+}
+/** How the environment of the current capture differs from the baseline's. */
+export interface SnapshotEnvironment {
+    /** Every field that differs, as dotted paths ("browser.version"), sorted. Empty when nothing differs. */
+    delta: string[];
+    /**
+     * The subset of `delta` that can change how the page renders: the
+     * browser, the OS platform, distro and architecture (the OS release on
+     * macOS and Windows), the render settings, the capture method, a
+     * container and the environment label. Framework, adapter and driver
+     * versions, the CI runner image and the project are context only.
+     */
+    renderingDelta: string[];
+    /** The baseline's recorded environment. Present when `delta` is non-empty. */
+    baseline?: import('../capture/environment').CaptureEnvironment;
+    /** The current capture's recorded environment. Present when `delta` is non-empty. */
+    candidate?: import('../capture/environment').CaptureEnvironment;
+    /**
+     * 'strict' when environmentPolicy "strict" made this snapshot changed
+     * because its rendering environment changed, whatever its pixels say.
+     */
+    policy?: 'strict';
 }
 export interface ReportSummary {
     total: number;
@@ -141,5 +169,10 @@ export interface ReportData {
     snapshots: SnapshotResult[];
     /** Names of baselines with no capture this run (schema 2.3.0+). */
     missingBaselines?: string[];
+    /**
+     * The environment of this run's captures (schema 2.5.0): the fields every
+     * capture that recorded one agrees on. Absent when none recorded one.
+     */
+    environment?: Partial<import('../capture/environment').CaptureEnvironment>;
 }
 //# sourceMappingURL=results.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/report/results.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG;;;;;;;;;;;OAWG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;IAClD,wEAAwE;IACxE,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,gBAAgB,EAAE,CAAC;IAC3D;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC1C,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,qBAAqB,EAAE,SAAS,CAAC;IACpD;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE;QAAE,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;CAC9G;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B"}
+{"version":3,"file":"results.d.ts","sourceRoot":"","sources":["../../src/report/results.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,KAAK,CAAC;AAE1D,MAAM,WAAW,iBAAiB;IAChC,2EAA2E;IAC3E,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG;;;;;;;;;;;OAWG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,aAAa,CAAC;IAClD,wEAAwE;IACxE,YAAY,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CACtD;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,iDAAiD;IACjD,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,4BAA4B;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,qBAAqB,EAAE,gBAAgB,EAAE,CAAC;IAC3D;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,cAAc,EAAE,QAAQ,EAAE,CAAC;IAC1C,sFAAsF;IACtF,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,qBAAqB,EAAE,SAAS,CAAC;IACpD;;;;;;;;;;OAUG;IACH,UAAU,CAAC,EAAE,WAAW,GAAG,OAAO,GAAG,OAAO,CAAC;IAC7C;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE;QAAE,QAAQ,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,SAAS,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAC7G;;;;OAIG;IACH,WAAW,CAAC,EAAE,mBAAmB,CAAC;CACnC;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,yGAAyG;IACzG,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB;;;;;;OAMG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,wBAAwB,EAAE,kBAAkB,CAAC;IAC/D,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,wBAAwB,EAAE,kBAAkB,CAAC;IAChE;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC,OAAO,wBAAwB,EAAE,kBAAkB,CAAC,CAAC;CAC5E"}