@keboola/validate-ui 0.6.0 → 0.6.1

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @keboola/validate-ui
 
+## 0.6.1
+
+### Patch Changes
+
+- Runtime health no longer fails a page because an error string such as "something went wrong" appears only inside an inline `<script>`, `<style>`, `<template>`, `<noscript>` or comment. Error-boundary copy is matched against the rendered text, and dev-server overlay names are matched against the DOM with those bodies removed.
+
+- Updated dependencies:
+  - @keboola/brand-registry@1.10.0
+
 ## 0.6.0
 
 ### Minor Changes

package/dist/cli.cjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-const require_runner = require("./runner-Dhb1FmeB.cjs");
+const require_runner = require("./runner-BwEjSueH.cjs");
 let node_fs_promises = require("node:fs/promises");
 let node_path = require("node:path");
 let node_process = require("node:process");

package/dist/cli.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { k as parseViewport, m as CompareConfig, o as validate, t as compareRoutes, w as serveStatic } from "./runner-D5dD5L7c.js";
+import { k as parseViewport, m as CompareConfig, o as validate, t as compareRoutes, w as serveStatic } from "./runner-DH04MitR.js";
 import { readFile } from "node:fs/promises";
 import { resolve } from "node:path";
 import process from "node:process";

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_runner = require("./runner-Dhb1FmeB.cjs");
+const require_runner = require("./runner-BwEjSueH.cjs");
 //#region src/types.ts
 const SEVERITIES = [
 	"critical",

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { Browser, Page } from 'playwright';\n\nimport type { CompareConfig, CompareSnapshot } from './compare/types';\n\n/** A named viewport the harness renders and captures at. */\nexport type Viewport = {\n  label: string;\n  width: number;\n  height: number;\n};\n\n/** A single console / page-error message emitted while the page loaded. */\nexport type ConsoleEntry = {\n  type: string;\n  text: string;\n  location?: string;\n};\n\n/** A network response or failed request observed during load. */\nexport type NetworkEntry = {\n  url: string;\n  method: string;\n  /** HTTP status, or 0 for a request that failed before a response. */\n  status: number;\n  failure?: string;\n};\n\n/**\n * Ground truth captured from a rendered page — the input every verdict axis\n * reasons over. Produced by {@link capture}; never contains live browser handles\n * so it is safe to serialize and pass to a VLM.\n */\nexport type CaptureArtifact = {\n  url: string;\n  viewport: Viewport;\n  /** Full-page PNG bytes. */\n  screenshot: Uint8Array;\n  /** Serialized outer HTML of the document after load. */\n  dom: string;\n  /**\n   * Trimmed `body.innerText` read from the live DOM when available. An empty\n   * string is a reliable white-screen signal — more robust than parsing\n   * {@link dom}. Absent only when an artifact is built without a live page.\n   */\n  renderedText?: string;\n  console: ConsoleEntry[];\n  network: NetworkEntry[];\n};\n\nexport const SEVERITIES = ['critical', 'serious', 'moderate', 'minor'] as const;\nexport type Severity = (typeof SEVERITIES)[number];\n\n/** One problem an axis found. */\nexport type Finding = {\n  message: string;\n  severity: Severity;\n  /** Optional extra context — a stack, a WCAG id, a selector, a diff ratio. */\n  detail?: string;\n  /** Optional pointer — WCAG ref, DOM selector, request URL, etc. */\n  ref?: string;\n};\n\n/** The result of running one axis against one page. */\nexport type Verdict = {\n  axis: string;\n  pass: boolean;\n  findings: Finding[];\n};\n\n/** The combined result of running every axis against one page. */\nexport type AggregateVerdict = {\n  url: string;\n  pass: boolean;\n  verdicts: Verdict[];\n};\n\n/**\n * Everything an axis may need. Different axes use different fields — a11y and\n * visual axes need the live {@link Page}; brief-conformance needs the brief;\n * the visual axis re-renders under an alternate brand via\n * {@link AxisContext.captureUnderBrand}. All optional fields may be absent, and\n * an axis must degrade to a clear finding rather than throw when its input is\n * missing.\n */\nexport type AxisContext = {\n  artifact: CaptureArtifact;\n  /** Live page for the primary capture, when the run keeps a browser open. */\n  page?: Page;\n  /** Shared browser, for axes that need to render additional pages. */\n  browser?: Browser;\n  /** The natural-language brief the UI was generated from. */\n  brief?: string;\n  /** A prior screenshot to diff the current one against. */\n  baseline?: Uint8Array;\n  /** Re-render the same route under a different brand id and capture it. */\n  captureUnderBrand?: (brand: string) => Promise<CaptureArtifact>;\n  /** The \"old\" UI reduced to regions — enables the compare axis when present. */\n  comparison?: CompareSnapshot;\n  /** Allowlist + state markers for the compare axis. */\n  compareConfig?: CompareConfig;\n};\n\n/**\n * A verdict axis. Each of the axes (runtime-health, accessibility,\n * visual-brand, brief-conformance, compare) implements this contract in its own\n * file so they can be built independently. `run` must resolve to a {@link Verdict} and\n * should not throw for expected-missing input — the aggregator converts a throw\n * into a failing verdict, but a clear finding is better.\n */\nexport type Axis = {\n  name: string;\n  run: (context: AxisContext) => Promise<Verdict>;\n};\n"],"mappings":";;;AAiDA,MAAa,aAAa;CAAC;CAAY;CAAW;CAAY;AAAO"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { Browser, Page } from 'playwright';\n\nimport type { CompareConfig, CompareSnapshot } from './compare/types';\n\nexport type Viewport = {\n  label: string;\n  width: number;\n  height: number;\n};\n\n/** A console or page-error message emitted while the page loaded. */\nexport type ConsoleEntry = {\n  type: string;\n  text: string;\n  location?: string;\n};\n\n/** A network response or failed request observed during load. */\nexport type NetworkEntry = {\n  url: string;\n  method: string;\n  /** HTTP status, or 0 for a request that failed before a response. */\n  status: number;\n  failure?: string;\n};\n\n/**\n * Ground truth every verdict axis reasons over, produced by {@link capture}.\n *\n * - Holds no live browser handles, so it is safe to serialize and pass to a VLM.\n */\nexport type CaptureArtifact = {\n  url: string;\n  viewport: Viewport;\n  /** Full-page PNG. */\n  screenshot: Uint8Array;\n  /** Outer HTML after load. */\n  dom: string;\n  /** Trimmed `body.innerText`; empty is a reliable white-screen signal. Absent without a live page. */\n  renderedText?: string;\n  console: ConsoleEntry[];\n  network: NetworkEntry[];\n};\n\nexport const SEVERITIES = ['critical', 'serious', 'moderate', 'minor'] as const;\nexport type Severity = (typeof SEVERITIES)[number];\n\n/** One problem an axis found. */\nexport type Finding = {\n  message: string;\n  severity: Severity;\n  /** Extra context — a stack, a WCAG id, a selector, a diff ratio. */\n  detail?: string;\n  /** Pointer — WCAG ref, DOM selector, request URL. */\n  ref?: string;\n};\n\n/** The result of running one axis against one page. */\nexport type Verdict = {\n  axis: string;\n  pass: boolean;\n  findings: Finding[];\n};\n\n/** The combined result of running every axis against one page. */\nexport type AggregateVerdict = {\n  url: string;\n  pass: boolean;\n  verdicts: Verdict[];\n};\n\n/**\n * Everything an axis may need.\n *\n * - Any optional field may be absent; an axis then reports a clear finding instead of throwing.\n */\nexport type AxisContext = {\n  artifact: CaptureArtifact;\n  /** Live page for the primary capture, when the run keeps a browser open. */\n  page?: Page;\n  /** Shared browser for rendering additional pages. */\n  browser?: Browser;\n  /** Natural-language brief the UI was generated from. */\n  brief?: string;\n  /** Prior screenshot to diff against. */\n  baseline?: Uint8Array;\n  /** Re-render and capture the same route under another brand id. */\n  captureUnderBrand?: (brand: string) => Promise<CaptureArtifact>;\n  /** The \"old\" UI reduced to regions — enables the compare axis when present. */\n  comparison?: CompareSnapshot;\n  compareConfig?: CompareConfig;\n};\n\n/**\n * A verdict axis.\n *\n * - `run` should not throw on missing input; the aggregator turns a throw into a failing verdict.\n */\nexport type Axis = {\n  name: string;\n  run: (context: AxisContext) => Promise<Verdict>;\n};\n"],"mappings":";;;AA4CA,MAAa,aAAa;CAAC;CAAY;CAAW;CAAY;AAAO"}

package/dist/index.d.cts

@@ -79,13 +79,12 @@ declare const CompareConfig: z.ZodObject<{
 type CompareConfig = z.infer<typeof CompareConfig>;
 //#endregion
 //#region src/types.d.ts
-/** A named viewport the harness renders and captures at. */
 type Viewport = {
   label: string;
   width: number;
   height: number;
 };
-/** A single console / page-error message emitted while the page loaded. */
+/** A console or page-error message emitted while the page loaded. */
 type ConsoleEntry = {
   type: string;
   text: string;
@@ -100,22 +99,18 @@ type NetworkEntry = {
   failure?: string;
 };
 /**
- * Ground truth captured from a rendered page — the input every verdict axis
- * reasons over. Produced by {@link capture}; never contains live browser handles
- * so it is safe to serialize and pass to a VLM.
+ * Ground truth every verdict axis reasons over, produced by {@link capture}.
+ *
+ * - Holds no live browser handles, so it is safe to serialize and pass to a VLM.
  */
 type CaptureArtifact = {
   url: string;
   viewport: Viewport;
-  /** Full-page PNG bytes. */
+  /** Full-page PNG. */
   screenshot: Uint8Array;
-  /** Serialized outer HTML of the document after load. */
+  /** Outer HTML after load. */
   dom: string;
-  /**
-   * Trimmed `body.innerText` read from the live DOM when available. An empty
-   * string is a reliable white-screen signal — more robust than parsing
-   * {@link dom}. Absent only when an artifact is built without a live page.
-   */
+  /** Trimmed `body.innerText`; empty is a reliable white-screen signal. Absent without a live page. */
   renderedText?: string;
   console: ConsoleEntry[];
   network: NetworkEntry[];
@@ -126,9 +121,9 @@ type Severity = (typeof SEVERITIES)[number];
 type Finding = {
   message: string;
   severity: Severity;
-  /** Optional extra context — a stack, a WCAG id, a selector, a diff ratio. */
+  /** Extra context — a stack, a WCAG id, a selector, a diff ratio. */
   detail?: string;
-  /** Optional pointer — WCAG ref, DOM selector, request URL, etc. */
+  /** Pointer — WCAG ref, DOM selector, request URL. */
   ref?: string;
 };
 /** The result of running one axis against one page. */
@@ -144,36 +139,30 @@ type AggregateVerdict = {
   verdicts: Verdict[];
 };
 /**
- * Everything an axis may need. Different axes use different fields — a11y and
- * visual axes need the live {@link Page}; brief-conformance needs the brief;
- * the visual axis re-renders under an alternate brand via
- * {@link AxisContext.captureUnderBrand}. All optional fields may be absent, and
- * an axis must degrade to a clear finding rather than throw when its input is
- * missing.
+ * Everything an axis may need.
+ *
+ * - Any optional field may be absent; an axis then reports a clear finding instead of throwing.
  */
 type AxisContext = {
   artifact: CaptureArtifact;
   /** Live page for the primary capture, when the run keeps a browser open. */
   page?: Page;
-  /** Shared browser, for axes that need to render additional pages. */
+  /** Shared browser for rendering additional pages. */
   browser?: Browser;
-  /** The natural-language brief the UI was generated from. */
+  /** Natural-language brief the UI was generated from. */
   brief?: string;
-  /** A prior screenshot to diff the current one against. */
+  /** Prior screenshot to diff against. */
   baseline?: Uint8Array;
-  /** Re-render the same route under a different brand id and capture it. */
+  /** Re-render and capture the same route under another brand id. */
   captureUnderBrand?: (brand: string) => Promise<CaptureArtifact>;
   /** The "old" UI reduced to regions — enables the compare axis when present. */
   comparison?: CompareSnapshot;
-  /** Allowlist + state markers for the compare axis. */
   compareConfig?: CompareConfig;
 };
 /**
- * A verdict axis. Each of the axes (runtime-health, accessibility,
- * visual-brand, brief-conformance, compare) implements this contract in its own
- * file so they can be built independently. `run` must resolve to a {@link Verdict} and
- * should not throw for expected-missing input — the aggregator converts a throw
- * into a failing verdict, but a clear finding is better.
+ * A verdict axis.
+ *
+ * - `run` should not throw on missing input; the aggregator turns a throw into a failing verdict.
  */
 type Axis = {
   name: string;
@@ -302,14 +291,10 @@ declare const briefConformanceAxis: Axis;
 //#endregion
 //#region src/axes/compare.d.ts
 /**
- * A5 · Semantic old-vs-new compare verdict — UT-4572.
+ * A5 · Semantic old-vs-new compare verdict.
  *
- * Activates only when `context.comparison` (an "old" {@link CompareSnapshot}) is
- * supplied; otherwise it degrades to a passing skip, so ordinary single-page runs
- * are unaffected. Extracts the "new" snapshot from the live `context.page`, then
- * runs the pure {@link diffSnapshots}: deltas are localized per region, declared
- * expected-absent deltas are suppressed (not dropped), and a region that degraded
- * to an empty/error state is reported informationally rather than as value loss.
+ * - Passing skip unless `context.comparison` (an "old" {@link CompareSnapshot}) is supplied.
+ * - Diffs it against a snapshot of the live `context.page` via {@link diffSnapshots}.
  */
 declare const compareAxis: Axis;
 //#endregion
@@ -325,15 +310,10 @@ declare const runtimeHealthAxis: Axis;
 //#endregion
 //#region src/axes/visual-brand.d.ts
 /**
- * A4 · Visual & brand-correctness verdict — UT-4495.
+ * A4 · Visual & brand-correctness verdict.
  *
- * Baseline diff of `context.artifact.screenshot` vs `context.baseline`
- * (pixelmatch + pngjs), plus the alt-brand fitness function via
- * `context.captureUnderBrand`: the chrome must visibly re-skin under an
- * alternate brand. Flags layout overflow, blocking at phone widths. Each check
- * degrades to no finding when its input is absent. (Asserting categorical colors
- * — Badge/Alert/ModalIcon — stay fixed pixel-wise is future work; see
- * `altBrandFinding`.)
+ * - Baseline pixel diff; alt brand must visibly re-skin the chrome; layout overflow.
+ * - Each check yields no finding when its input is absent.
  */
 declare const visualBrandAxis: Axis;
 //#endregion
@@ -381,14 +361,10 @@ declare const dedupeSharedChrome: (perRoute: RouteFindings[]) => DedupResult;
 //#endregion
 //#region src/compare/regions.d.ts
 /**
- * Reduce the live page to its diffable regions, in the browser. An explicit
- * `[data-region]` is an authoritative boundary (its subtree is one region);
- * elsewhere boundaries are the outermost-empty ("leaf") landmarks/sections, so
- * regions never overlap or double-count values. Each region's key is resolved by
- * precedence
- * (`data-region` → `data-testid` → role → `aria-label` → nearest heading), its
- * state from `data-state`/text markers, and its values as normalized numeric
- * tokens. Symmetric across old and new so the two sides diff cleanly.
+ * Reduce the live page to its diffable regions, in the browser.
+ *
+ * - Regions never overlap, so no value is counted twice.
+ * - Must stay symmetric across old and new so the two sides diff cleanly.
  */
 declare const extractRegions: (page: Page, config?: CompareConfig) => Promise<Region[]>;
 //#endregion

package/dist/index.d.ts

@@ -79,13 +79,12 @@ declare const CompareConfig: z.ZodObject<{
 type CompareConfig = z.infer<typeof CompareConfig>;
 //#endregion
 //#region src/types.d.ts
-/** A named viewport the harness renders and captures at. */
 type Viewport = {
   label: string;
   width: number;
   height: number;
 };
-/** A single console / page-error message emitted while the page loaded. */
+/** A console or page-error message emitted while the page loaded. */
 type ConsoleEntry = {
   type: string;
   text: string;
@@ -100,22 +99,18 @@ type NetworkEntry = {
   failure?: string;
 };
 /**
- * Ground truth captured from a rendered page — the input every verdict axis
- * reasons over. Produced by {@link capture}; never contains live browser handles
- * so it is safe to serialize and pass to a VLM.
+ * Ground truth every verdict axis reasons over, produced by {@link capture}.
+ *
+ * - Holds no live browser handles, so it is safe to serialize and pass to a VLM.
  */
 type CaptureArtifact = {
   url: string;
   viewport: Viewport;
-  /** Full-page PNG bytes. */
+  /** Full-page PNG. */
   screenshot: Uint8Array;
-  /** Serialized outer HTML of the document after load. */
+  /** Outer HTML after load. */
   dom: string;
-  /**
-   * Trimmed `body.innerText` read from the live DOM when available. An empty
-   * string is a reliable white-screen signal — more robust than parsing
-   * {@link dom}. Absent only when an artifact is built without a live page.
-   */
+  /** Trimmed `body.innerText`; empty is a reliable white-screen signal. Absent without a live page. */
   renderedText?: string;
   console: ConsoleEntry[];
   network: NetworkEntry[];
@@ -126,9 +121,9 @@ type Severity = (typeof SEVERITIES)[number];
 type Finding = {
   message: string;
   severity: Severity;
-  /** Optional extra context — a stack, a WCAG id, a selector, a diff ratio. */
+  /** Extra context — a stack, a WCAG id, a selector, a diff ratio. */
   detail?: string;
-  /** Optional pointer — WCAG ref, DOM selector, request URL, etc. */
+  /** Pointer — WCAG ref, DOM selector, request URL. */
   ref?: string;
 };
 /** The result of running one axis against one page. */
@@ -144,36 +139,30 @@ type AggregateVerdict = {
   verdicts: Verdict[];
 };
 /**
- * Everything an axis may need. Different axes use different fields — a11y and
- * visual axes need the live {@link Page}; brief-conformance needs the brief;
- * the visual axis re-renders under an alternate brand via
- * {@link AxisContext.captureUnderBrand}. All optional fields may be absent, and
- * an axis must degrade to a clear finding rather than throw when its input is
- * missing.
+ * Everything an axis may need.
+ *
+ * - Any optional field may be absent; an axis then reports a clear finding instead of throwing.
  */
 type AxisContext = {
   artifact: CaptureArtifact;
   /** Live page for the primary capture, when the run keeps a browser open. */
   page?: Page;
-  /** Shared browser, for axes that need to render additional pages. */
+  /** Shared browser for rendering additional pages. */
   browser?: Browser;
-  /** The natural-language brief the UI was generated from. */
+  /** Natural-language brief the UI was generated from. */
   brief?: string;
-  /** A prior screenshot to diff the current one against. */
+  /** Prior screenshot to diff against. */
   baseline?: Uint8Array;
-  /** Re-render the same route under a different brand id and capture it. */
+  /** Re-render and capture the same route under another brand id. */
   captureUnderBrand?: (brand: string) => Promise<CaptureArtifact>;
   /** The "old" UI reduced to regions — enables the compare axis when present. */
   comparison?: CompareSnapshot;
-  /** Allowlist + state markers for the compare axis. */
   compareConfig?: CompareConfig;
 };
 /**
- * A verdict axis. Each of the axes (runtime-health, accessibility,
- * visual-brand, brief-conformance, compare) implements this contract in its own
- * file so they can be built independently. `run` must resolve to a {@link Verdict} and
- * should not throw for expected-missing input — the aggregator converts a throw
- * into a failing verdict, but a clear finding is better.
+ * A verdict axis.
+ *
+ * - `run` should not throw on missing input; the aggregator turns a throw into a failing verdict.
  */
 type Axis = {
   name: string;
@@ -302,14 +291,10 @@ declare const briefConformanceAxis: Axis;
 //#endregion
 //#region src/axes/compare.d.ts
 /**
- * A5 · Semantic old-vs-new compare verdict — UT-4572.
+ * A5 · Semantic old-vs-new compare verdict.
  *
- * Activates only when `context.comparison` (an "old" {@link CompareSnapshot}) is
- * supplied; otherwise it degrades to a passing skip, so ordinary single-page runs
- * are unaffected. Extracts the "new" snapshot from the live `context.page`, then
- * runs the pure {@link diffSnapshots}: deltas are localized per region, declared
- * expected-absent deltas are suppressed (not dropped), and a region that degraded
- * to an empty/error state is reported informationally rather than as value loss.
+ * - Passing skip unless `context.comparison` (an "old" {@link CompareSnapshot}) is supplied.
+ * - Diffs it against a snapshot of the live `context.page` via {@link diffSnapshots}.
  */
 declare const compareAxis: Axis;
 //#endregion
@@ -325,15 +310,10 @@ declare const runtimeHealthAxis: Axis;
 //#endregion
 //#region src/axes/visual-brand.d.ts
 /**
- * A4 · Visual & brand-correctness verdict — UT-4495.
+ * A4 · Visual & brand-correctness verdict.
  *
- * Baseline diff of `context.artifact.screenshot` vs `context.baseline`
- * (pixelmatch + pngjs), plus the alt-brand fitness function via
- * `context.captureUnderBrand`: the chrome must visibly re-skin under an
- * alternate brand. Flags layout overflow, blocking at phone widths. Each check
- * degrades to no finding when its input is absent. (Asserting categorical colors
- * — Badge/Alert/ModalIcon — stay fixed pixel-wise is future work; see
- * `altBrandFinding`.)
+ * - Baseline pixel diff; alt brand must visibly re-skin the chrome; layout overflow.
+ * - Each check yields no finding when its input is absent.
  */
 declare const visualBrandAxis: Axis;
 //#endregion
@@ -381,14 +361,10 @@ declare const dedupeSharedChrome: (perRoute: RouteFindings[]) => DedupResult;
 //#endregion
 //#region src/compare/regions.d.ts
 /**
- * Reduce the live page to its diffable regions, in the browser. An explicit
- * `[data-region]` is an authoritative boundary (its subtree is one region);
- * elsewhere boundaries are the outermost-empty ("leaf") landmarks/sections, so
- * regions never overlap or double-count values. Each region's key is resolved by
- * precedence
- * (`data-region` → `data-testid` → role → `aria-label` → nearest heading), its
- * state from `data-state`/text markers, and its values as normalized numeric
- * tokens. Symmetric across old and new so the two sides diff cleanly.
+ * Reduce the live page to its diffable regions, in the browser.
+ *
+ * - Regions never overlap, so no value is counted twice.
+ * - Must stay symmetric across old and new so the two sides diff cleanly.
  */
 declare const extractRegions: (page: Page, config?: CompareConfig) => Promise<Region[]>;
 //#endregion

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as DEFAULT_VIEWPORTS, C as accessibilityAxis, D as VIEWPORT_PRESETS, E as PHONE_VIEWPORT, F as prepareForScreenshot, M as MOBILE_VIEWPORT, N as capture, O as isPhoneViewport, P as capturePage, S as briefConformanceAxis, T as PHONE_MAX_WIDTH, _ as REGION_STATES, a as runAxes, b as comparePass, c as visualBrandAxis, d as captureSnapshot, f as loadSnapshot, g as ExpectedAbsentRule, h as CompareSnapshot, i as aggregatePass, j as DESKTOP_VIEWPORT, k as parseViewport, l as runtimeHealthAxis, m as CompareConfig, n as routeSnapshotFile, o as validate, p as saveSnapshot, r as dedupeSharedChrome, s as ALL_AXES, t as compareRoutes, u as compareAxis, v as Region, w as serveStatic, x as diffSnapshots, y as extractRegions } from "./runner-D5dD5L7c.js";
+import { A as DEFAULT_VIEWPORTS, C as accessibilityAxis, D as VIEWPORT_PRESETS, E as PHONE_VIEWPORT, F as prepareForScreenshot, M as MOBILE_VIEWPORT, N as capture, O as isPhoneViewport, P as capturePage, S as briefConformanceAxis, T as PHONE_MAX_WIDTH, _ as REGION_STATES, a as runAxes, b as comparePass, c as visualBrandAxis, d as captureSnapshot, f as loadSnapshot, g as ExpectedAbsentRule, h as CompareSnapshot, i as aggregatePass, j as DESKTOP_VIEWPORT, k as parseViewport, l as runtimeHealthAxis, m as CompareConfig, n as routeSnapshotFile, o as validate, p as saveSnapshot, r as dedupeSharedChrome, s as ALL_AXES, t as compareRoutes, u as compareAxis, v as Region, w as serveStatic, x as diffSnapshots, y as extractRegions } from "./runner-DH04MitR.js";
 //#region src/types.ts
 const SEVERITIES = [
 	"critical",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { Browser, Page } from 'playwright';\n\nimport type { CompareConfig, CompareSnapshot } from './compare/types';\n\n/** A named viewport the harness renders and captures at. */\nexport type Viewport = {\n  label: string;\n  width: number;\n  height: number;\n};\n\n/** A single console / page-error message emitted while the page loaded. */\nexport type ConsoleEntry = {\n  type: string;\n  text: string;\n  location?: string;\n};\n\n/** A network response or failed request observed during load. */\nexport type NetworkEntry = {\n  url: string;\n  method: string;\n  /** HTTP status, or 0 for a request that failed before a response. */\n  status: number;\n  failure?: string;\n};\n\n/**\n * Ground truth captured from a rendered page — the input every verdict axis\n * reasons over. Produced by {@link capture}; never contains live browser handles\n * so it is safe to serialize and pass to a VLM.\n */\nexport type CaptureArtifact = {\n  url: string;\n  viewport: Viewport;\n  /** Full-page PNG bytes. */\n  screenshot: Uint8Array;\n  /** Serialized outer HTML of the document after load. */\n  dom: string;\n  /**\n   * Trimmed `body.innerText` read from the live DOM when available. An empty\n   * string is a reliable white-screen signal — more robust than parsing\n   * {@link dom}. Absent only when an artifact is built without a live page.\n   */\n  renderedText?: string;\n  console: ConsoleEntry[];\n  network: NetworkEntry[];\n};\n\nexport const SEVERITIES = ['critical', 'serious', 'moderate', 'minor'] as const;\nexport type Severity = (typeof SEVERITIES)[number];\n\n/** One problem an axis found. */\nexport type Finding = {\n  message: string;\n  severity: Severity;\n  /** Optional extra context — a stack, a WCAG id, a selector, a diff ratio. */\n  detail?: string;\n  /** Optional pointer — WCAG ref, DOM selector, request URL, etc. */\n  ref?: string;\n};\n\n/** The result of running one axis against one page. */\nexport type Verdict = {\n  axis: string;\n  pass: boolean;\n  findings: Finding[];\n};\n\n/** The combined result of running every axis against one page. */\nexport type AggregateVerdict = {\n  url: string;\n  pass: boolean;\n  verdicts: Verdict[];\n};\n\n/**\n * Everything an axis may need. Different axes use different fields — a11y and\n * visual axes need the live {@link Page}; brief-conformance needs the brief;\n * the visual axis re-renders under an alternate brand via\n * {@link AxisContext.captureUnderBrand}. All optional fields may be absent, and\n * an axis must degrade to a clear finding rather than throw when its input is\n * missing.\n */\nexport type AxisContext = {\n  artifact: CaptureArtifact;\n  /** Live page for the primary capture, when the run keeps a browser open. */\n  page?: Page;\n  /** Shared browser, for axes that need to render additional pages. */\n  browser?: Browser;\n  /** The natural-language brief the UI was generated from. */\n  brief?: string;\n  /** A prior screenshot to diff the current one against. */\n  baseline?: Uint8Array;\n  /** Re-render the same route under a different brand id and capture it. */\n  captureUnderBrand?: (brand: string) => Promise<CaptureArtifact>;\n  /** The \"old\" UI reduced to regions — enables the compare axis when present. */\n  comparison?: CompareSnapshot;\n  /** Allowlist + state markers for the compare axis. */\n  compareConfig?: CompareConfig;\n};\n\n/**\n * A verdict axis. Each of the axes (runtime-health, accessibility,\n * visual-brand, brief-conformance, compare) implements this contract in its own\n * file so they can be built independently. `run` must resolve to a {@link Verdict} and\n * should not throw for expected-missing input — the aggregator converts a throw\n * into a failing verdict, but a clear finding is better.\n */\nexport type Axis = {\n  name: string;\n  run: (context: AxisContext) => Promise<Verdict>;\n};\n"],"mappings":";;AAiDA,MAAa,aAAa;CAAC;CAAY;CAAW;CAAY;AAAO"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/types.ts"],"sourcesContent":["import type { Browser, Page } from 'playwright';\n\nimport type { CompareConfig, CompareSnapshot } from './compare/types';\n\nexport type Viewport = {\n  label: string;\n  width: number;\n  height: number;\n};\n\n/** A console or page-error message emitted while the page loaded. */\nexport type ConsoleEntry = {\n  type: string;\n  text: string;\n  location?: string;\n};\n\n/** A network response or failed request observed during load. */\nexport type NetworkEntry = {\n  url: string;\n  method: string;\n  /** HTTP status, or 0 for a request that failed before a response. */\n  status: number;\n  failure?: string;\n};\n\n/**\n * Ground truth every verdict axis reasons over, produced by {@link capture}.\n *\n * - Holds no live browser handles, so it is safe to serialize and pass to a VLM.\n */\nexport type CaptureArtifact = {\n  url: string;\n  viewport: Viewport;\n  /** Full-page PNG. */\n  screenshot: Uint8Array;\n  /** Outer HTML after load. */\n  dom: string;\n  /** Trimmed `body.innerText`; empty is a reliable white-screen signal. Absent without a live page. */\n  renderedText?: string;\n  console: ConsoleEntry[];\n  network: NetworkEntry[];\n};\n\nexport const SEVERITIES = ['critical', 'serious', 'moderate', 'minor'] as const;\nexport type Severity = (typeof SEVERITIES)[number];\n\n/** One problem an axis found. */\nexport type Finding = {\n  message: string;\n  severity: Severity;\n  /** Extra context — a stack, a WCAG id, a selector, a diff ratio. */\n  detail?: string;\n  /** Pointer — WCAG ref, DOM selector, request URL. */\n  ref?: string;\n};\n\n/** The result of running one axis against one page. */\nexport type Verdict = {\n  axis: string;\n  pass: boolean;\n  findings: Finding[];\n};\n\n/** The combined result of running every axis against one page. */\nexport type AggregateVerdict = {\n  url: string;\n  pass: boolean;\n  verdicts: Verdict[];\n};\n\n/**\n * Everything an axis may need.\n *\n * - Any optional field may be absent; an axis then reports a clear finding instead of throwing.\n */\nexport type AxisContext = {\n  artifact: CaptureArtifact;\n  /** Live page for the primary capture, when the run keeps a browser open. */\n  page?: Page;\n  /** Shared browser for rendering additional pages. */\n  browser?: Browser;\n  /** Natural-language brief the UI was generated from. */\n  brief?: string;\n  /** Prior screenshot to diff against. */\n  baseline?: Uint8Array;\n  /** Re-render and capture the same route under another brand id. */\n  captureUnderBrand?: (brand: string) => Promise<CaptureArtifact>;\n  /** The \"old\" UI reduced to regions — enables the compare axis when present. */\n  comparison?: CompareSnapshot;\n  compareConfig?: CompareConfig;\n};\n\n/**\n * A verdict axis.\n *\n * - `run` should not throw on missing input; the aggregator turns a throw into a failing verdict.\n */\nexport type Axis = {\n  name: string;\n  run: (context: AxisContext) => Promise<Verdict>;\n};\n"],"mappings":";;AA4CA,MAAa,aAAa;CAAC;CAAY;CAAW;CAAY;AAAO"}