@testivai/witness 2.3.1 → 2.5.0

package/dist/capture/environment.js

@@ -0,0 +1,399 @@
+"use strict";
+/**
+ * Capture provenance — where a capture came from.
+ *
+ * When the same URL renders differently, the question a reviewer needs
+ * answered first is whether the PAGE changed or the MACHINE did: a new
+ * browser build, another OS or distro (another set of fonts), another device
+ * scale, another way of taking the screenshot. Every adapter records the
+ * same `environment` block in the capture's metadata.json; approving a
+ * capture freezes it into the baseline's metadata.json, and the compare
+ * reads the two side by side (report/environment.ts).
+ *
+ * The block is plain JSON, so non-JS adapters write the same shape
+ * (docs/extension-api.md). Every part an adapter cannot observe is left out,
+ * never guessed: an absent field reads as "not recorded", not as a change.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RENDER_PROBE_EXPRESSION = exports.ENVIRONMENT_POLICIES = exports.CAPTURE_METHODS = void 0;
+exports.distroFromOsRelease = distroFromOsRelease;
+exports.detectCi = detectCi;
+exports.collectHostEnvironment = collectHostEnvironment;
+exports.browserFromUserAgent = browserFromUserAgent;
+exports.browserFromCapabilities = browserFromCapabilities;
+exports.installedPackageVersion = installedPackageVersion;
+exports.parseRenderProbe = parseRenderProbe;
+exports.buildCaptureEnvironment = buildCaptureEnvironment;
+exports.webDriverEnvironment = webDriverEnvironment;
+exports.readEnvironment = readEnvironment;
+exports.applyEnvironmentPolicyToName = applyEnvironmentPolicyToName;
+exports.parseEnvironmentVariant = parseEnvironmentVariant;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+/**
+ * How the screenshot was taken, as `<extent>:<mechanism>`. The extent is what
+ * the image covers (the full page or the viewport); the mechanism is what
+ * took it. A change of method changes the image, and often its size.
+ */
+exports.CAPTURE_METHODS = {
+    /** CDP Page.captureScreenshot with captureBeyondViewport. */
+    CDP_FULL_PAGE: 'full-page:cdp',
+    /** Playwright page.screenshot({ fullPage: true }). */
+    PLAYWRIGHT_FULL_PAGE: 'full-page:playwright',
+    /** Viewport screenshots scrolled and stitched together. */
+    STITCHED_FULL_PAGE: 'full-page:stitched',
+    /** Firefox's own full-page screenshot (Selenium save_full_page_screenshot). */
+    FIREFOX_FULL_PAGE: 'full-page:firefox',
+    /** WebDriver takeScreenshot: the viewport only. */
+    WEBDRIVER_VIEWPORT: 'viewport:webdriver',
+};
+exports.ENVIRONMENT_POLICIES = ['warn', 'separate', 'strict'];
+// ── Host ────────────────────────────────────────────────────────────────────
+/**
+ * The distro from /etc/os-release, as `<ID> <VERSION_ID>` ("ubuntu 24.04",
+ * "debian 12"; "arch" for a rolling release). That pair decides the fonts and
+ * the FreeType build a Linux machine draws text with; the kernel does not.
+ */
+function distroFromOsRelease(text) {
+    const fields = {};
+    for (const line of text.split(/\r?\n/)) {
+        const m = /^([A-Z_]+)=(.*)$/.exec(line.trim());
+        if (m)
+            fields[m[1]] = m[2].replace(/^["']|["']$/g, '');
+    }
+    if (!fields.ID)
+        return undefined;
+    return fields.VERSION_ID ? `${fields.ID} ${fields.VERSION_ID}` : fields.ID;
+}
+/** The CI provider, and the runner image where the provider names one. */
+function detectCi(env) {
+    if (env.GITHUB_ACTIONS === 'true') {
+        const runnerImage = env.ImageOS && env.ImageVersion ? `${env.ImageOS}/${env.ImageVersion}` : undefined;
+        return runnerImage ? { provider: 'github-actions', runnerImage } : { provider: 'github-actions' };
+    }
+    if (env.GITLAB_CI)
+        return { provider: 'gitlab' };
+    if (env.CIRCLECI)
+        return { provider: 'circleci' };
+    if (env.BUILDKITE)
+        return { provider: 'buildkite' };
+    if (env.JENKINS_URL)
+        return { provider: 'jenkins' };
+    if (env.TF_BUILD)
+        return { provider: 'azure-pipelines' };
+    if (env.CI && env.CI !== 'false' && env.CI !== '0')
+        return { provider: 'ci' };
+    return undefined;
+}
+const safely = (fn, fallback) => {
+    try {
+        return fn();
+    }
+    catch {
+        return fallback;
+    }
+};
+/** The machine-level part of the block. Never throws. */
+function collectHostEnvironment(sources = {}) {
+    const env = sources.env ?? process.env;
+    const platform = sources.platform ?? process.platform;
+    const readFile = sources.readFile ?? ((p) => safely(() => fs.readFileSync(p, 'utf-8'), null));
+    const exists = sources.exists ?? ((p) => fs.existsSync(p));
+    const host = {
+        os: {
+            platform,
+            release: sources.release ?? safely(() => os.release(), ''),
+            arch: sources.arch ?? process.arch,
+        },
+    };
+    if (platform === 'linux') {
+        const text = safely(() => readFile('/etc/os-release'), null);
+        const distro = text ? distroFromOsRelease(text) : undefined;
+        if (distro)
+            host.os.distro = distro;
+    }
+    const ci = detectCi(env);
+    if (ci)
+        host.ci = ci;
+    if (safely(() => exists('/.dockerenv') || exists('/run/.containerenv'), false))
+        host.container = true;
+    const label = (env.TESTIVAI_ENV_LABEL ?? '').trim();
+    if (label)
+        host.label = label;
+    return host;
+}
+// ── Browser ─────────────────────────────────────────────────────────────────
+/**
+ * The engine and its version from a user agent: the fallback for an adapter
+ * whose driver does not say (a Playwright persistent context has no
+ * browser() to ask). Edge is reported as chromium with channel msedge, the
+ * way Playwright names it.
+ */
+function browserFromUserAgent(ua) {
+    if (!ua)
+        return null;
+    const edge = /\bEdg\/([\d.]+)/.exec(ua);
+    const chrome = /\b(HeadlessChrome|Chrome|Chromium)\/([\d.]+)/.exec(ua);
+    if (chrome) {
+        const browser = { name: 'chromium', version: chrome[2] };
+        if (chrome[1] === 'HeadlessChrome')
+            browser.headless = true;
+        if (edge)
+            browser.channel = 'msedge';
+        return browser;
+    }
+    const firefox = /\bFirefox\/([\d.]+)/.exec(ua);
+    if (firefox)
+        return { name: 'firefox', version: firefox[1] };
+    // Two linear matches, not /Version\/([\d.]+).*Safari\//: that pattern
+    // backtracks quadratically on a long run of dots.
+    const safari = /\bVersion\/([\d.]+)/.exec(ua);
+    if (safari && /\bSafari\//.test(ua.slice(safari.index + safari[0].length)))
+        return { name: 'webkit', version: safari[1] };
+    return null;
+}
+/** WebDriver browserName values, normalized to the engine family and its branded channel. */
+const WEBDRIVER_BROWSERS = {
+    chrome: { name: 'chromium', channel: 'chrome', driver: 'chromedriver' },
+    'chrome-headless-shell': { name: 'chromium', channel: 'chrome-headless-shell', driver: 'chromedriver' },
+    chromium: { name: 'chromium', driver: 'chromedriver' },
+    microsoftedge: { name: 'chromium', channel: 'msedge', driver: 'msedgedriver' },
+    msedge: { name: 'chromium', channel: 'msedge', driver: 'msedgedriver' },
+    firefox: { name: 'firefox', driver: 'geckodriver' },
+    safari: { name: 'webkit', channel: 'safari' },
+};
+/** The first token of a driver version string ("141.0.7390.37 (hash-refs/…)" → "141.0.7390.37"). */
+const firstToken = (v) => (typeof v === 'string' && v.trim() ? v.trim().split(/\s+/)[0] : undefined);
+/**
+ * The browser (and the WebDriver binary) from W3C capabilities, as
+ * WebdriverIO's `browser.capabilities` or selenium-webdriver's
+ * `getCapabilities()` returns them (a plain object, or an object with
+ * `get()`). Headless is read from the browser's own launch arguments, and
+ * only said when they are there to say it. Null without a browser name.
+ */
+function browserFromCapabilities(caps) {
+    if (!caps || typeof caps !== 'object')
+        return null;
+    const c = caps;
+    const get = (key) => (typeof c.get === 'function' ? c.get(key) : c[key]);
+    const rawName = get('browserName');
+    if (typeof rawName !== 'string' || rawName.length === 0)
+        return null;
+    const known = WEBDRIVER_BROWSERS[rawName.toLowerCase()];
+    const version = get('browserVersion') ?? get('version');
+    const browser = {
+        name: known?.name ?? rawName.toLowerCase(),
+        version: typeof version === 'string' && version.length > 0 ? version : null,
+    };
+    if (known?.channel)
+        browser.channel = known.channel;
+    const options = (get('goog:chromeOptions') ?? get('ms:edgeOptions') ?? get('moz:firefoxOptions'));
+    if (options && Array.isArray(options.args)) {
+        browser.headless = options.args.some((a) => typeof a === 'string' && /^-{1,2}headless(=|$)/.test(a));
+    }
+    let driverVersion;
+    if (known?.driver === 'chromedriver')
+        driverVersion = firstToken(get('chrome')?.chromedriverVersion);
+    if (known?.driver === 'msedgedriver')
+        driverVersion = firstToken(get('msedge')?.msedgedriverVersion);
+    if (known?.driver === 'geckodriver')
+        driverVersion = firstToken(get('moz:geckodriverVersion'));
+    return driverVersion && known?.driver ? { browser, driver: { name: known.driver, version: driverVersion } } : { browser };
+}
+/**
+ * The version of a package as the project at `root` resolves it (the user's
+ * own webdriverio or selenium-webdriver, not one bundled here), or null.
+ */
+function installedPackageVersion(name, root = process.cwd()) {
+    try {
+        const pkgPath = require.resolve(`${name}/package.json`, { paths: [root] });
+        const version = JSON.parse(fs.readFileSync(pkgPath, 'utf-8')).version;
+        return typeof version === 'string' ? version : null;
+    }
+    catch {
+        return null;
+    }
+}
+// ── Render probe ────────────────────────────────────────────────────────────
+/**
+ * One self-contained in-page expression (no imports, no closures) that
+ * measures what the page is actually rendered with. Measured, not taken from
+ * configuration: a config can say 1280×720 at scale 1 while the browser
+ * renders something else. Each field is read on its own, so one missing API
+ * never loses the rest.
+ */
+exports.RENDER_PROBE_EXPRESSION = `(function () {
+  var out = {};
+  try { out.viewport = { width: window.innerWidth, height: window.innerHeight }; } catch (e) {}
+  try { out.deviceScaleFactor = window.devicePixelRatio; } catch (e) {}
+  try { out.colorScheme = window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'; } catch (e) {}
+  try { out.reducedMotion = window.matchMedia('(prefers-reduced-motion: reduce)').matches ? 'reduce' : 'no-preference'; } catch (e) {}
+  try { out.locale = navigator.language; } catch (e) {}
+  try { out.timezone = Intl.DateTimeFormat().resolvedOptions().timeZone; } catch (e) {}
+  try { out.userAgent = navigator.userAgent; } catch (e) {}
+  return out;
+})()`;
+const isNumber = (v) => typeof v === 'number' && Number.isFinite(v);
+const isString = (v) => typeof v === 'string' && v.length > 0;
+/** Validate the probe's result. Mistyped fields are dropped, never trusted. */
+function parseRenderProbe(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const r = raw;
+    const render = {};
+    const vp = r.viewport;
+    if (vp && isNumber(vp.width) && isNumber(vp.height))
+        render.viewport = { width: vp.width, height: vp.height };
+    if (isNumber(r.deviceScaleFactor))
+        render.deviceScaleFactor = r.deviceScaleFactor;
+    if (r.colorScheme === 'light' || r.colorScheme === 'dark')
+        render.colorScheme = r.colorScheme;
+    if (r.reducedMotion === 'reduce' || r.reducedMotion === 'no-preference')
+        render.reducedMotion = r.reducedMotion;
+    if (isString(r.locale))
+        render.locale = r.locale;
+    if (isString(r.timezone))
+        render.timezone = r.timezone;
+    return isString(r.userAgent) ? { render, userAgent: r.userAgent } : { render };
+}
+// ── Assembly ────────────────────────────────────────────────────────────────
+/** Drop undefined members, so the block round-trips through JSON unchanged. */
+function compact(value) {
+    const out = {};
+    for (const [k, v] of Object.entries(value))
+        if (v !== undefined)
+            out[k] = v;
+    return out;
+}
+/** Assemble the block from what one adapter observed. */
+function buildCaptureEnvironment(parts) {
+    const { host } = parts;
+    // Built in the documented order (docs/extension-api.md), so metadata.json reads the same everywhere.
+    const env = {
+        os: compact({ ...host.os }),
+        browser: compact({ ...parts.browser }),
+    };
+    if (parts.framework)
+        env.framework = compact({ ...parts.framework });
+    env.adapter = { ...parts.adapter };
+    if (parts.driver)
+        env.driver = { ...parts.driver };
+    if (parts.render) {
+        const render = compact({ ...parts.render });
+        if (Object.keys(render).length > 0)
+            env.render = render;
+    }
+    if (host.ci)
+        env.ci = compact({ ...host.ci });
+    if (host.container)
+        env.container = true;
+    if (host.label)
+        env.label = host.label;
+    if (parts.project)
+        env.project = parts.project;
+    return env;
+}
+/**
+ * The block for a WebDriver adapter: the browser and driver from the
+ * capabilities (the user agent when they say nothing), the render settings
+ * from the probe. Null when neither names the browser: never guessed.
+ */
+function webDriverEnvironment(input) {
+    const probed = parseRenderProbe(input.probe);
+    const fromCaps = browserFromCapabilities(input.capabilities);
+    const browser = fromCaps?.browser ?? (probed?.userAgent ? browserFromUserAgent(probed.userAgent) : null);
+    if (!browser)
+        return null;
+    return buildCaptureEnvironment({
+        host: input.host ?? collectHostEnvironment(),
+        browser,
+        framework: { ...input.framework },
+        adapter: input.adapter,
+        driver: fromCaps?.driver,
+        render: probed?.render,
+    });
+}
+/**
+ * The block as recorded in a metadata.json, or null when there is none:
+ * captures from before provenance, or from an adapter that does not record
+ * it. Only the three parts every recorder writes are required.
+ */
+function readEnvironment(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const e = raw;
+    const obj = (v) => Boolean(v) && typeof v === 'object' && !Array.isArray(v);
+    if (!obj(e.os) || typeof e.os.platform !== 'string')
+        return null;
+    if (!obj(e.browser) || typeof e.browser.name !== 'string')
+        return null;
+    if (!obj(e.adapter) || typeof e.adapter.captureMethod !== 'string')
+        return null;
+    return e;
+}
+// ── separate policy ─────────────────────────────────────────────────────────
+const safeSegment = (s) => s.replace(/[^a-z0-9_-]+/gi, '_').toLowerCase();
+/** Node's process.platform values: a suffix ending in one of them is an environment variant. */
+const PLATFORMS = ['aix', 'android', 'darwin', 'freebsd', 'haiku', 'linux', 'openbsd', 'sunos', 'win32', 'cygwin', 'netbsd'];
+/**
+ * environmentPolicy "separate" keys each snapshot by environment:
+ * `<name>__<browser>__<platform>`, the same in-the-name mechanism as the
+ * Playwright multi-project variant, so the on-disk layout, results.json, the
+ * report, approvals and the approve action all work unchanged. A browser the
+ * name already ends with (a project named after it) is not repeated. Never
+ * keyed by version: a browser upgrade should be seen, not hidden behind a
+ * fresh baseline. Other policies return the name unchanged.
+ */
+function applyEnvironmentPolicyToName(name, env, policy) {
+    if (policy !== 'separate')
+        return name;
+    const browser = safeSegment(env.browser.name);
+    const platform = safeSegment(env.os.platform);
+    const segments = name.split('__');
+    const withBrowser = segments.length > 1 && segments[segments.length - 1] === browser ? name : `${name}__${browser}`;
+    return `${withBrowser}__${platform}`;
+}
+/** The variant a separate-policy name carries, or null for a name without one. */
+function parseEnvironmentVariant(name) {
+    const segments = name.split('__');
+    if (segments.length < 3)
+        return null;
+    const platform = segments[segments.length - 1];
+    if (!PLATFORMS.includes(platform))
+        return null;
+    return { base: segments.slice(0, -2).join('__'), browser: segments[segments.length - 2], platform };
+}
+//# sourceMappingURL=environment.js.map

package/dist/capture/environment.js.map

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

package/dist/capture/settle.d.ts

@@ -22,6 +22,13 @@
  * content that had not *loaded* yet — which is a load question, not a pixel
  * question.
  *
+ * One pixel question remains, and it is Chrome's, not the page's: a
+ * beyond-viewport capture can return a frame painted for the wrong viewport
+ * while the measured page is unchanged. That is guarded at capture time in
+ * capture/stable-capture.ts (fresh frame, then capture until two in a row
+ * match), which costs one extra screenshot on a stable page. This probe still
+ * decides when to start capturing.
+ *
  * WHAT THIS DOES
  * --------------
  * A cheap synchronous probe the adapter polls from the host language, exactly

package/dist/capture/settle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../src/capture/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,2FAA2F;IAC3F,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,EACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,IAAI,KAAK;QAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,EAC3H,OAAO,EAAE,MAAM,GACd,WAAW,CAoDb;AAED,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,wDAAwD;AACxD,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAErF;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,0SAMxB,CAAC"}
+{"version":3,"file":"settle.d.ts","sourceRoot":"","sources":["../../src/capture/settle.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,2FAA2F;IAC3F,aAAa,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,YAAY,EAAE,OAAO,CAAC;IACtB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,0BAA0B,CAAC;AAExD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,EAAE,SAAS,CAAC;QAAE,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACzC,KAAK,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B,EACD,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,EAAE,MAAM,IAAI,KAAK;QAAE,OAAO,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;KAAE,CAAA;CAAE,EAC3H,OAAO,EAAE,MAAM,GACd,WAAW,CAoDb;AAED,8FAA8F;AAC9F,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAE9C,wDAAwD;AACxD,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAErF;AAED;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,0SAMxB,CAAC"}

package/dist/capture/settle.js

@@ -23,6 +23,13 @@
  * content that had not *loaded* yet — which is a load question, not a pixel
  * question.
  *
+ * One pixel question remains, and it is Chrome's, not the page's: a
+ * beyond-viewport capture can return a frame painted for the wrong viewport
+ * while the measured page is unchanged. That is guarded at capture time in
+ * capture/stable-capture.ts (fresh frame, then capture until two in a row
+ * match), which costs one extra screenshot on a stable page. This probe still
+ * decides when to start capturing.
+ *
  * WHAT THIS DOES
  * --------------
  * A cheap synchronous probe the adapter polls from the host language, exactly

package/dist/capture/settle.js.map

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

package/dist/capture/stable-capture.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Stable full-page capture — shared by every adapter that screenshots through
+ * CDP `Page.captureScreenshot` with `captureBeyondViewport`.
+ *
+ * THE PROBLEM
+ * -----------
+ * Chrome can hand back a frame painted with styles resolved against the wrong
+ * viewport while it sets up a beyond-viewport capture: narrow-viewport media
+ * rules, a collapsed `min-height: 100vh` hero, or text sized from a
+ * `@media (max-width: 480px)` body font. The page measures correctly (DOM,
+ * element map and computed styles all match the baseline) but the pixels do
+ * not, so an unchanged page flips between two renders from run to run and is
+ * reported as changed. Measured on the standalone CLI (an e2e fixture failed
+ * on nearly every attempt) and on a Playwright suite in CI (testivai-site's
+ * home page: 4.13% "changed" on one run, the same commit passing on re-run).
+ *
+ * THE GUARD
+ * ---------
+ * 1. Wait for a fresh frame — two animation frames, so every style and layout
+ *    change made so far has been painted — before measuring and capturing.
+ *    A forced layout alone does not prevent a stale frame; a rendered one does.
+ * 2. Capture until two captures in a row are identical, at most
+ *    MAX_STABLE_CAPTURES. The capture after a wrong frame is almost always
+ *    right. A stable page costs one extra screenshot; a page that never stops
+ *    changing costs MAX_STABLE_CAPTURES, never an endless loop. The same wrong
+ *    frame twice in a row would still be kept: rare, as it takes two misses.
+ *
+ * The helpers are transport-agnostic: the adapter supplies how to evaluate the
+ * frame wait in its page and how to take one capture.
+ */
+/** How long the in-page frame wait waits for two frames before giving up. */
+export declare const FRESH_FRAME_TIMEOUT_MS = 1000;
+/**
+ * In-page expression an adapter awaits before capturing: resolves `true` once
+ * the page has rendered two animation frames (a frame produced after every
+ * style and layout change made so far has been painted), or `false` after
+ * FRESH_FRAME_TIMEOUT_MS for a page that renders no frames at all.
+ */
+export declare const FRESH_FRAME_EXPRESSION = "new Promise((resolve) => {\n  const timer = setTimeout(() => resolve(false), 1000);\n  requestAnimationFrame(() => requestAnimationFrame(() => {\n    clearTimeout(timer);\n    resolve(true);\n  }));\n})";
+/**
+ * The most captures of one page while waiting for two in a row to match.
+ * Every stale-capture pattern measured settles within four (stale, good,
+ * good / good, stale, good, good).
+ */
+export declare const MAX_STABLE_CAPTURES = 4;
+/** Where the helpers report what they did; adapters route it to their debug output. */
+export type CaptureLog = (message: string) => void;
+/**
+ * Wait for a fresh frame, retrying once when none arrived in time (a loaded
+ * machine can stall a frame past the in-page timeout). Best-effort, never
+ * blocking and never throwing: if neither attempt sees a frame, the capture
+ * proceeds and the log says it may be stale.
+ *
+ * @param waitOnce Evaluates FRESH_FRAME_EXPRESSION in the page and resolves
+ *   whether it saw two frames. A rejection (e.g. the page navigated away)
+ *   counts as no frame.
+ * @param log Optional debug sink.
+ */
+export declare function settleFreshFrame(waitOnce: () => Promise<boolean>, log?: CaptureLog): Promise<void>;
+/** Options for {@link captureUntilStable}. */
+export interface CaptureUntilStableOptions<T> {
+    /** Takes one capture of the page (e.g. base64 PNG data from CDP). */
+    capture: () => Promise<T>;
+    /** Runs before every recapture; typically `settleFreshFrame`. Not run before the first capture. */
+    settle: () => Promise<void>;
+    /** Whether two captures are the same pixels. Default: strict equality (right for base64 strings). */
+    same?: (a: T, b: T) => boolean;
+    /** Most captures to take. Default: MAX_STABLE_CAPTURES. */
+    maxCaptures?: number;
+    /** Optional debug sink. */
+    log?: CaptureLog;
+}
+/**
+ * Capture until two captures in a row match, at most `maxCaptures`, and return
+ * the matching capture (or the last one when none matched the one before it).
+ * The caller waits for a fresh frame before the first capture, usually before
+ * measuring the page; this settles again before every recapture.
+ */
+export declare function captureUntilStable<T>(options: CaptureUntilStableOptions<T>): Promise<T>;
+//# sourceMappingURL=stable-capture.d.ts.map

package/dist/capture/stable-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-capture.d.ts","sourceRoot":"","sources":["../../src/capture/stable-capture.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,OAAO,CAAC;AAE3C;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,+MAMhC,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAEnD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAYxG;AAED,8CAA8C;AAC9C,MAAM,WAAW,yBAAyB,CAAC,CAAC;IAC1C,qEAAqE;IACrE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,mGAAmG;IACnG,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,qGAAqG;IACrG,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,OAAO,CAAC;IAC/B,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,GAAG,CAAC,EAAE,UAAU,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,OAAO,EAAE,yBAAyB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAe7F"}