@monoes/monobrowse 1.0.12 → 1.0.13

package/dist/src/report/render.js

@@ -0,0 +1,286 @@
+/**
+ * Renders a Report as ONE self-contained HTML file: CSS inline, screenshots
+ * as `data:` URIs, no fonts, no CDN, no network access of any kind at view
+ * time. That is not a stylistic preference — it is what lets monomind's
+ * document pipeline ingest the file as an ordinary document, so test history
+ * becomes searchable, and what lets the report be mailed or archived and
+ * still render years later.
+ *
+ * Reading order matches how you triage: verdict, errors, failed requests,
+ * vitals, accessibility, screenshots.
+ */
+import { budgetLabel } from './budget.js';
+import { EVIDENCE_STYLES, renderEvidence, renderFlake } from './render-evidence.js';
+import { renderDiff, renderTrend, TREND_STYLES } from './render-trend.js';
+import { escapeHtml } from './util.js';
+export { escapeHtml };
+function ms(value) {
+    return value === undefined || !Number.isFinite(value) ? 'not measured' : `${Math.round(value)}ms`;
+}
+function vitalRating(metric, v) {
+    if (v === undefined || !Number.isFinite(v))
+        return 'none';
+    const scale = {
+        lcp: [2500, 4000],
+        fcp: [1800, 3000],
+        cls: [0.1, 0.25],
+        inp: [200, 500],
+        ttfb: [800, 1800],
+    };
+    const bounds = scale[metric];
+    if (!bounds)
+        return 'none';
+    return v <= bounds[0] ? 'good' : v <= bounds[1] ? 'mixed' : 'poor';
+}
+const STYLES = `
+:root{
+  --bg:#fbfbfd; --panel:#fff; --ink:#15171c; --muted:#5d6470; --line:#e3e6ec;
+  --pass:#0f7b4f; --pass-bg:#e7f6ee; --fail:#b3261e; --fail-bg:#fdeceb;
+  --warn:#8a5a00; --warn-bg:#fff5e0; --code:#f3f4f7;
+}
+@media (prefers-color-scheme: dark){
+  :root{
+    --bg:#101317; --panel:#171b21; --ink:#e7eaf0; --muted:#98a1b0; --line:#262c35;
+    --pass:#57d69c; --pass-bg:#11291f; --fail:#ff9a92; --fail-bg:#2c1614;
+    --warn:#f0c168; --warn-bg:#2b2113; --code:#1d222a;
+  }
+}
+*{box-sizing:border-box}
+body{margin:0;padding:32px 16px 72px;background:var(--bg);color:var(--ink);
+  font:15px/1.55 -apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,Helvetica,Arial,sans-serif;}
+main{max-width:940px;margin:0 auto}
+h1{font-size:22px;margin:0 0 4px;letter-spacing:-.01em}
+h2{font-size:15px;text-transform:uppercase;letter-spacing:.08em;color:var(--muted);
+  margin:36px 0 12px;font-weight:600}
+a{color:inherit}
+.sub{color:var(--muted);font-size:13px;margin:0 0 24px;word-break:break-all}
+.verdict{border-radius:12px;padding:18px 20px;margin-bottom:8px;border:1px solid transparent}
+.verdict.pass{background:var(--pass-bg);border-color:var(--pass);color:var(--pass)}
+.verdict.fail{background:var(--fail-bg);border-color:var(--fail);color:var(--fail)}
+.verdict .tag{font-size:26px;font-weight:700;letter-spacing:.02em}
+.verdict .line{color:var(--ink);margin-top:6px;font-size:14px}
+.stats{display:flex;flex-wrap:wrap;gap:8px;margin:16px 0 0;padding:0;list-style:none}
+.stats li{background:var(--panel);border:1px solid var(--line);border-radius:8px;
+  padding:8px 12px;font-size:13px;color:var(--muted)}
+.stats li b{display:block;font-size:18px;color:var(--ink)}
+.stats li.bad b{color:var(--fail)}
+table{width:100%;border-collapse:collapse;background:var(--panel);
+  border:1px solid var(--line);border-radius:10px;overflow:hidden;font-size:13px}
+th,td{text-align:left;padding:9px 12px;border-bottom:1px solid var(--line);vertical-align:top}
+th{color:var(--muted);font-weight:600;white-space:nowrap}
+tr:last-child td{border-bottom:none}
+td.num{text-align:right;white-space:nowrap;font-variant-numeric:tabular-nums}
+.wrap{word-break:break-all}
+code,.mono{font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace;font-size:12px}
+code{background:var(--code);padding:1px 5px;border-radius:4px}
+.pill{display:inline-block;padding:1px 7px;border-radius:999px;font-size:11px;
+  font-weight:600;text-transform:uppercase;letter-spacing:.04em}
+.pill.error{background:var(--fail-bg);color:var(--fail)}
+.pill.warning{background:var(--warn-bg);color:var(--warn)}
+.pill.good{background:var(--pass-bg);color:var(--pass)}
+.pill.mixed{background:var(--warn-bg);color:var(--warn)}
+.pill.poor{background:var(--fail-bg);color:var(--fail)}
+.pill.none{background:var(--code);color:var(--muted)}
+.empty{color:var(--muted);font-size:13px;background:var(--panel);border:1px solid var(--line);
+  border-radius:10px;padding:12px}
+.note{color:var(--muted);font-size:12px;margin-top:8px}
+figure{margin:0 0 20px}
+figcaption{color:var(--muted);font-size:12px;margin-bottom:6px}
+img{max-width:100%;height:auto;display:block;border:1px solid var(--line);border-radius:10px}
+footer{margin-top:40px;color:var(--muted);font-size:12px;border-top:1px solid var(--line);
+  padding-top:12px}
+@media (max-width:640px){body{padding:20px 12px 48px}th,td{padding:8px}}
+`.trim();
+function emptyBlock(text) {
+    return `<p class="empty">${escapeHtml(text)}</p>`;
+}
+function renderVerdict(report) {
+    const pass = report.verdict === 'pass';
+    const headline = pass
+        ? 'All budgets met.'
+        : `${report.failures.length} budget ${report.failures.length === 1 ? 'failure' : 'failures'}.`;
+    const rows = report.failures
+        .map((f) => `<tr>
+        <td>${escapeHtml(budgetLabel(f.budget))}</td>
+        <td class="num mono">${escapeHtml(f.expected)}</td>
+        <td class="num mono">${escapeHtml(f.actual)}</td>
+        <td class="wrap">${escapeHtml(f.detail ?? '')}</td>
+      </tr>`)
+        .join('');
+    const table = report.failures.length
+        ? `<table><thead><tr><th>Budget</th><th>Expected</th><th>Actual</th><th>Evidence</th></tr></thead>
+       <tbody>${rows}</tbody></table>`
+        : '';
+    const unmeasured = report.unmeasured.length
+        ? `<p class="note">Not measured on this run: ${escapeHtml(report.unmeasured.join(', '))} — the page never reported the metric, so its budget was neither met nor breached.</p>`
+        : '';
+    return `<section class="verdict ${pass ? 'pass' : 'fail'}">
+    <div class="tag">${pass ? 'PASS' : 'FAIL'}</div>
+    <div class="line">${escapeHtml(headline)}</div>
+  </section>
+  ${table}
+  ${unmeasured}`;
+}
+function renderStats(report) {
+    const c = report.counts;
+    const item = (label, value, bad) => `<li class="${bad ? 'bad' : ''}"><b>${value}</b>${escapeHtml(label)}</li>`;
+    return `<ul class="stats">
+    ${item('console errors', c.consoleErrors, c.consoleErrors > 0)}
+    ${item('page errors', c.pageErrors, c.pageErrors > 0)}
+    ${item('failed requests', c.failedRequests, c.failedRequests > 0)}
+    ${item('requests', c.requests, false)}
+    ${item('a11y errors', c.a11yErrors, c.a11yErrors > 0)}
+    ${item('a11y warnings', c.a11yWarnings, false)}
+  </ul>`;
+}
+function renderErrors(report) {
+    const rows = [];
+    for (const e of report.pageErrors) {
+        const where = e.url ? `${e.url}${e.lineNumber !== undefined ? `:${e.lineNumber}` : ''}` : '';
+        rows.push(`<tr>
+      <td><span class="pill error">uncaught</span></td>
+      <td class="wrap">${escapeHtml(e.text)}</td>
+      <td class="wrap mono">${escapeHtml(where)}</td>
+    </tr>`);
+    }
+    for (const m of report.console) {
+        if (m.type !== 'error' && m.type !== 'warn' && m.type !== 'warning')
+            continue;
+        const pill = m.type === 'error' ? 'error' : 'warning';
+        const where = m.url ? `${m.url}${m.lineNumber !== undefined ? `:${m.lineNumber}` : ''}` : '';
+        rows.push(`<tr>
+      <td><span class="pill ${pill}">console.${escapeHtml(m.type)}</span></td>
+      <td class="wrap">${escapeHtml(m.text)}</td>
+      <td class="wrap mono">${escapeHtml(where)}</td>
+    </tr>`);
+    }
+    if (!rows.length)
+        return emptyBlock('No console errors, warnings or uncaught exceptions.');
+    return `<table><thead><tr><th>Kind</th><th>Message</th><th>Source</th></tr></thead>
+    <tbody>${rows.join('')}</tbody></table>`;
+}
+function renderRequests(requests) {
+    const failed = requests.filter((r) => r.failed);
+    if (!failed.length)
+        return emptyBlock('Every request returned a successful response.');
+    const rows = failed
+        .map((r) => `<tr>
+      <td class="mono">${escapeHtml(r.status ?? '—')}</td>
+      <td class="mono">${escapeHtml(r.method)}</td>
+      <td class="wrap mono">${escapeHtml(r.url)}</td>
+      <td class="wrap">${escapeHtml(r.errorText ?? '')}</td>
+    </tr>`)
+        .join('');
+    return `<table><thead><tr><th>Status</th><th>Method</th><th>URL</th><th>Error</th></tr></thead>
+    <tbody>${rows}</tbody></table>`;
+}
+function renderVitals(report) {
+    const v = report.vitals;
+    const defs = [
+        ['lcp', 'LCP', 'Largest Contentful Paint'],
+        ['fcp', 'FCP', 'First Contentful Paint'],
+        ['cls', 'CLS', 'Cumulative Layout Shift'],
+        ['inp', 'INP', 'Interaction to Next Paint'],
+        ['ttfb', 'TTFB', 'Time to First Byte'],
+    ];
+    const rows = defs
+        .map(([key, short, long]) => {
+        const raw = v[key];
+        const rating = vitalRating(key, raw);
+        const shown = key === 'cls' ? (raw === undefined ? 'not measured' : raw.toFixed(3)) : ms(raw);
+        return `<tr>
+        <td><b>${short}</b> <span style="color:var(--muted)">${escapeHtml(long)}</span></td>
+        <td class="num mono">${escapeHtml(shown)}</td>
+        <td><span class="pill ${rating}">${rating === 'none' ? 'n/a' : rating}</span></td>
+      </tr>`;
+    })
+        .join('');
+    const load = `<tr><td>Load event</td><td class="num mono">${escapeHtml(ms(v.loadTime))}</td><td></td></tr>
+    <tr><td>DOM interactive</td><td class="num mono">${escapeHtml(ms(v.domInteractive))}</td><td></td></tr>
+    <tr><td>Resources</td><td class="num mono">${escapeHtml(v.resources ?? '—')}</td><td></td></tr>`;
+    return `<table><thead><tr><th>Metric</th><th>Value</th><th>Rating</th></tr></thead>
+    <tbody>${rows}${load}</tbody></table>`;
+}
+function renderA11y(findings) {
+    const disclaimer = '<p class="note">Colour contrast is not evaluated: it cannot be derived from the accessibility tree, and guessing it would be worse than omitting it.</p>';
+    if (!findings.length) {
+        return `${emptyBlock('No accessibility findings from the AX tree.')}${disclaimer}`;
+    }
+    const order = { error: 0, warning: 1 };
+    const rows = [...findings]
+        .sort((a, b) => order[a.impact] - order[b.impact])
+        .map((f) => `<tr>
+      <td><span class="pill ${f.impact}">${escapeHtml(f.impact)}</span></td>
+      <td class="mono">${escapeHtml(f.rule)}</td>
+      <td>${escapeHtml(f.role)}</td>
+      <td>${f.name ? escapeHtml(f.name) : '<span style="color:var(--muted)">(no accessible name)</span>'}</td>
+      <td class="wrap mono">${escapeHtml(f.locator)}</td>
+      <td class="wrap">${escapeHtml(f.detail)}</td>
+    </tr>`)
+        .join('');
+    return `<table><thead><tr><th>Impact</th><th>Rule</th><th>Role</th><th>Name</th><th>Locator</th><th>Detail</th></tr></thead>
+    <tbody>${rows}</tbody></table>${disclaimer}`;
+}
+function renderScreenshots(shots) {
+    if (!shots.length)
+        return emptyBlock('No screenshot was captured.');
+    return shots
+        .map((s) => `<figure>
+      <figcaption>${escapeHtml(s.label)} — ${s.width}×${s.height}</figcaption>
+      <img alt="${escapeHtml(`${s.label} screenshot`)}" src="${escapeHtml(s.dataUrl)}">
+    </figure>`)
+        .join('');
+}
+export function renderHtml(report, options = {}) {
+    const title = report.title || report.finalUrl || report.url;
+    const notes = report.notes.length
+        ? `<h2>Run notes</h2><ul class="empty">${report.notes.map((n) => `<li>${escapeHtml(n)}</li>`).join('')}</ul>`
+        : '';
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<title>${escapeHtml(`Page report — ${title}`)}</title>
+<style>${STYLES}
+${TREND_STYLES}
+${EVIDENCE_STYLES}</style>
+</head>
+<body>
+<main>
+<h1>${escapeHtml(title)}</h1>
+<p class="sub">${escapeHtml(report.finalUrl || report.url)} · captured ${escapeHtml(report.capturedAt)} · ${Math.round(report.durationMs)}ms</p>
+
+${renderVerdict(report)}
+${renderFlake(options.flake)}
+${renderStats(report)}
+
+${renderTrend(report.trend)}
+${renderDiff(report.diff)}
+
+<h2>Errors</h2>
+${renderErrors(report)}
+
+${renderEvidence(report.evidence)}
+
+<h2>Failed requests</h2>
+${renderRequests(report.requests)}
+
+<h2>Web vitals</h2>
+${renderVitals(report)}
+
+<h2>Accessibility</h2>
+${renderA11y(report.a11y)}
+
+<h2>Screenshots</h2>
+${renderScreenshots(report.screenshots)}
+
+${notes}
+<footer>Generated by monobrowse report — self-contained, no external resources.</footer>
+</main>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=render.js.map

package/dist/src/report/render.js.map

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

package/dist/src/report/run-diff.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Assembles the run-to-run diff (RIG-10) from what the previous run left in
+ * the history directory: its structural signature (in the JSON record) and
+ * its screenshot (the sibling PNG).
+ *
+ * Every missing piece degrades into a note rather than an absent section, so
+ * a reader can tell "nothing changed" apart from "we could not check".
+ */
+import { type HistoryRun } from './history.js';
+import { type PixelDiffOptions } from './pixel-diff.js';
+import type { Report, RunDiff } from './types.js';
+export interface BuildRunDiffOptions {
+    pixels?: PixelDiffOptions;
+    /** Set false to skip the pixel half entirely. */
+    comparePixels?: boolean;
+}
+export declare function buildRunDiff(dir: string, previous: HistoryRun | undefined, current: Report, options?: BuildRunDiffOptions): Promise<RunDiff | undefined>;
+//# sourceMappingURL=run-diff.d.ts.map

package/dist/src/report/run-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-diff.d.ts","sourceRoot":"","sources":["../../../src/report/run-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,UAAU,EAAqB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,iBAAiB,CAAC;AAGnE,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,iDAAiD;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,UAAU,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAoC9B"}

package/dist/src/report/run-diff.js

@@ -0,0 +1,51 @@
+/**
+ * Assembles the run-to-run diff (RIG-10) from what the previous run left in
+ * the history directory: its structural signature (in the JSON record) and
+ * its screenshot (the sibling PNG).
+ *
+ * Every missing piece degrades into a note rather than an absent section, so
+ * a reader can tell "nothing changed" apart from "we could not check".
+ */
+import { loadRunScreenshot } from './history.js';
+import { pixelDiff } from './pixel-diff.js';
+import { pngFromDataUrl } from './png.js';
+import { diffStructure } from './structure.js';
+export async function buildRunDiff(dir, previous, current, options = {}) {
+    if (!previous)
+        return undefined;
+    const notes = [];
+    const diff = {
+        previousRunId: previous.id,
+        previousCapturedAt: previous.capturedAt,
+        notes,
+    };
+    if (previous.structure?.length && current.structure?.length) {
+        diff.structure = diffStructure(previous.structure, current.structure);
+    }
+    else if (!current.structure?.length) {
+        notes.push('No accessibility tree this run — structural diff skipped.');
+    }
+    else {
+        notes.push('The previous run stored no structural signature — nothing to diff against.');
+    }
+    if (options.comparePixels !== false) {
+        const currentShot = current.screenshots.find((s) => s.label === 'page') ?? current.screenshots[0];
+        const previousPng = await loadRunScreenshot(dir, previous);
+        if (!previousPng) {
+            notes.push('The previous run archived no screenshot — pixel diff skipped.');
+        }
+        else if (!currentShot?.dataUrl) {
+            notes.push('No screenshot this run — pixel diff skipped.');
+        }
+        else {
+            try {
+                diff.pixels = pixelDiff(previousPng, pngFromDataUrl(currentShot.dataUrl), options.pixels);
+            }
+            catch (err) {
+                notes.push(`Pixel diff failed: ${err.message}`);
+            }
+        }
+    }
+    return diff;
+}
+//# sourceMappingURL=run-diff.js.map

package/dist/src/report/run-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-diff.js","sourceRoot":"","sources":["../../../src/report/run-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAmB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAClE,OAAO,EAAyB,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAS/C,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,QAAgC,EAChC,OAAe,EACf,OAAO,GAAwB,EAAE;IAEjC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEhC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAY;QACpB,aAAa,EAAE,QAAQ,CAAC,EAAE;QAC1B,kBAAkB,EAAE,QAAQ,CAAC,UAAU;QACvC,KAAK;KACN,CAAC;IAEF,IAAI,QAAQ,CAAC,SAAS,EAAE,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAC5D,IAAI,CAAC,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACxE,CAAC;SAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CAAC,4EAA4E,CAAC,CAAC;IAC3F,CAAC;IAED,IAAI,OAAO,CAAC,aAAa,KAAK,KAAK,EAAE,CAAC;QACpC,MAAM,WAAW,GACf,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,WAAW,GAAG,MAAM,iBAAiB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC3D,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;QAC9E,CAAC;aAAM,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACN,IAAI,CAAC;gBACH,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC,WAAW,EAAE,cAAc,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;YAC5F,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,KAAK,CAAC,IAAI,CAAC,sBAAuB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7D,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/report/structure.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Structural signature of a page, and the diff between two of them (RIG-10).
+ *
+ * The signature is derived from the accessibility tree we already fetch for
+ * the a11y rules, so this costs no extra CDP round-trip. It is deliberately
+ * the AX tree and not the DOM: the AX tree is what the page *means* — a
+ * className churned by a CSS-in-JS build is invisible to it, while a button
+ * losing its label, a heading changing text, or a form field disappearing
+ * all show up. That is the signal a "did this deploy change anything real?"
+ * diff wants.
+ *
+ * Everything here is pure, so the tests feed hand-written trees.
+ */
+import type { AxNode, StructureDiff, StructureNode } from './types.js';
+/** Bound on signature size: a 40k-node AX tree must not become a 40k-row diff. */
+export declare const MAX_STRUCTURE_NODES = 1500;
+/**
+ * Walk the AX tree into a flat, path-addressed signature.
+ *
+ * Path segments are `role[n]`, n counting siblings of the same role after
+ * transparent wrappers are spliced away. Two runs of an unchanged page
+ * therefore produce identical paths; an inserted element shifts only its own
+ * role's numbering, which the diff's second pass then recovers from.
+ */
+export declare function buildStructure(nodes: AxNode[]): StructureNode[];
+/**
+ * Diff two signatures.
+ *
+ * Two passes, because path alone is too brittle to use on its own: inserting
+ * one list item renumbers every later sibling, which a naive path diff would
+ * report as "everything below here was replaced".
+ *
+ *  1. Exact path match — same slot. Same name means unchanged, a different
+ *     name means renamed (the useful case: a label that silently changed).
+ *  2. Whatever is left is matched on role+name, which recovers elements that
+ *     merely moved. Only what survives both passes is genuinely gained/lost.
+ */
+export declare function diffStructure(previous: StructureNode[], current: StructureNode[]): StructureDiff;
+/** One line for a CI log: "3 gained, 1 lost, 2 renamed". */
+export declare function summarizeStructureDiff(diff: StructureDiff): string;
+//# sourceMappingURL=structure.d.ts.map

package/dist/src/report/structure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.d.ts","sourceRoot":"","sources":["../../../src/report/structure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAWvE,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAexC;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE,CAkE/D;AAcD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,aAAa,CA4DhG;AAED,4DAA4D;AAC5D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAOlE"}

package/dist/src/report/structure.js

@@ -0,0 +1,210 @@
+/**
+ * Structural signature of a page, and the diff between two of them (RIG-10).
+ *
+ * The signature is derived from the accessibility tree we already fetch for
+ * the a11y rules, so this costs no extra CDP round-trip. It is deliberately
+ * the AX tree and not the DOM: the AX tree is what the page *means* — a
+ * className churned by a CSS-in-JS build is invisible to it, while a button
+ * losing its label, a heading changing text, or a form field disappearing
+ * all show up. That is the signal a "did this deploy change anything real?"
+ * diff wants.
+ *
+ * Everything here is pure, so the tests feed hand-written trees.
+ */
+/** Roles that exist only to hold other nodes — spliced out, children kept. */
+const TRANSPARENT_ROLES = new Set([
+    'none',
+    'generic',
+    'presentation',
+    'inlinetextbox',
+    'genericcontainer',
+]);
+/** Bound on signature size: a 40k-node AX tree must not become a 40k-row diff. */
+export const MAX_STRUCTURE_NODES = 1500;
+const MAX_DEPTH = 25;
+/** Accessible names are compared verbatim, so trim the essays. */
+const MAX_NAME_LENGTH = 160;
+function strValue(v) {
+    return typeof v === 'string' ? v : v == null ? '' : String(v);
+}
+function normalizeName(raw) {
+    const flat = raw.replace(/\s+/g, ' ').trim();
+    if (!flat)
+        return null;
+    return flat.length > MAX_NAME_LENGTH ? `${flat.slice(0, MAX_NAME_LENGTH - 1)}…` : flat;
+}
+/**
+ * Walk the AX tree into a flat, path-addressed signature.
+ *
+ * Path segments are `role[n]`, n counting siblings of the same role after
+ * transparent wrappers are spliced away. Two runs of an unchanged page
+ * therefore produce identical paths; an inserted element shifts only its own
+ * role's numbering, which the diff's second pass then recovers from.
+ */
+export function buildStructure(nodes) {
+    const byId = new Map();
+    for (const node of nodes)
+        byId.set(String(node.nodeId), node);
+    const childIds = (node) => (node.childIds ?? []).map(String);
+    /** Visible children, with transparent wrappers replaced by their children. */
+    const effectiveChildren = (node, depth) => {
+        const out = [];
+        const queue = [...childIds(node)];
+        let guard = 0;
+        while (queue.length && guard++ < 4000) {
+            const child = byId.get(queue.shift());
+            if (!child)
+                continue;
+            const role = strValue(child.role?.value).toLowerCase();
+            if (child.ignored || TRANSPARENT_ROLES.has(role)) {
+                if (depth < MAX_DEPTH)
+                    queue.unshift(...childIds(child));
+                continue;
+            }
+            out.push(child);
+        }
+        return out;
+    };
+    const referenced = new Set();
+    for (const node of nodes)
+        for (const id of childIds(node))
+            referenced.add(id);
+    const roots = nodes.filter((n) => !referenced.has(String(n.nodeId)));
+    // In a cycle every node has a parent, so there is no unreferenced root and
+    // the walk below would visit nothing. Start somewhere rather than silently
+    // returning an empty signature that the diff would read as "page is gone".
+    if (!roots.length && nodes.length)
+        roots.push(nodes[0]);
+    const out = [];
+    const visited = new Set();
+    const counters = new Map();
+    const walk = (node, parentPath, depth) => {
+        if (out.length >= MAX_STRUCTURE_NODES || depth > MAX_DEPTH)
+            return;
+        const id = String(node.nodeId);
+        if (visited.has(id))
+            return; // a malformed tree must not loop us forever
+        visited.add(id);
+        const role = strValue(node.role?.value).toLowerCase() || 'unknown';
+        let siblingsSeen = counters.get(parentPath);
+        if (!siblingsSeen) {
+            siblingsSeen = new Map();
+            counters.set(parentPath, siblingsSeen);
+        }
+        const n = (siblingsSeen.get(role) ?? 0) + 1;
+        siblingsSeen.set(role, n);
+        const path = `${parentPath}/${role}[${n}]`;
+        out.push({ path, role, name: normalizeName(strValue(node.name?.value)), depth });
+        for (const child of effectiveChildren(node, depth))
+            walk(child, path, depth + 1);
+    };
+    for (const root of roots) {
+        const role = strValue(root.role?.value).toLowerCase();
+        if (root.ignored || TRANSPARENT_ROLES.has(role)) {
+            for (const child of effectiveChildren(root, 0))
+                walk(child, '', 0);
+        }
+        else {
+            walk(root, '', 0);
+        }
+    }
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Diff
+// ---------------------------------------------------------------------------
+/**
+ * Identity for the second matching pass. Names are whitespace-collapsed to a
+ * single line by normalizeName, so a newline is a separator no value carries.
+ */
+function identityKey(node) {
+    return `${node.role}\n${node.name ?? ''}`;
+}
+/**
+ * Diff two signatures.
+ *
+ * Two passes, because path alone is too brittle to use on its own: inserting
+ * one list item renumbers every later sibling, which a naive path diff would
+ * report as "everything below here was replaced".
+ *
+ *  1. Exact path match — same slot. Same name means unchanged, a different
+ *     name means renamed (the useful case: a label that silently changed).
+ *  2. Whatever is left is matched on role+name, which recovers elements that
+ *     merely moved. Only what survives both passes is genuinely gained/lost.
+ */
+export function diffStructure(previous, current) {
+    const prevByPath = new Map(previous.map((n) => [n.path, n]));
+    const currByPath = new Map(current.map((n) => [n.path, n]));
+    const renamed = [];
+    const unmatchedPrev = [];
+    const unmatchedCurr = [];
+    let unchanged = 0;
+    for (const node of current) {
+        const before = prevByPath.get(node.path);
+        if (!before) {
+            unmatchedCurr.push(node);
+            continue;
+        }
+        if (before.role === node.role && before.name === node.name) {
+            unchanged++;
+        }
+        else if (before.role === node.role) {
+            renamed.push({ path: node.path, role: node.role, from: before.name, to: node.name });
+        }
+        else {
+            // Same slot, different role — that is a replacement, not a rename.
+            unmatchedCurr.push(node);
+            unmatchedPrev.push(before);
+        }
+    }
+    for (const node of previous) {
+        if (!currByPath.has(node.path))
+            unmatchedPrev.push(node);
+    }
+    // Pass two: role+name identity, which is what "the same element, elsewhere"
+    // actually means to a reader.
+    const pool = new Map();
+    for (const node of unmatchedPrev) {
+        const key = identityKey(node);
+        const bucket = pool.get(key);
+        if (bucket)
+            bucket.push(node);
+        else
+            pool.set(key, [node]);
+    }
+    const moved = [];
+    const gained = [];
+    for (const node of unmatchedCurr) {
+        const bucket = pool.get(identityKey(node));
+        const match = bucket?.shift();
+        if (match) {
+            moved.push({ role: node.role, name: node.name, from: match.path, to: node.path });
+        }
+        else {
+            gained.push(node);
+        }
+    }
+    const lost = [...pool.values()].flat();
+    return {
+        gained,
+        lost,
+        renamed,
+        moved,
+        unchanged,
+        changed: gained.length + lost.length + renamed.length,
+    };
+}
+/** One line for a CI log: "3 gained, 1 lost, 2 renamed". */
+export function summarizeStructureDiff(diff) {
+    const parts = [];
+    if (diff.gained.length)
+        parts.push(`${diff.gained.length} gained`);
+    if (diff.lost.length)
+        parts.push(`${diff.lost.length} lost`);
+    if (diff.renamed.length)
+        parts.push(`${diff.renamed.length} renamed`);
+    if (diff.moved.length)
+        parts.push(`${diff.moved.length} moved`);
+    return parts.length ? parts.join(', ') : 'structurally identical';
+}
+//# sourceMappingURL=structure.js.map

package/dist/src/report/structure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structure.js","sourceRoot":"","sources":["../../../src/report/structure.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,8EAA8E;AAC9E,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IAChC,MAAM;IACN,SAAS;IACT,cAAc;IACd,eAAe;IACf,kBAAkB;CACnB,CAAC,CAAC;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AACxC,MAAM,SAAS,GAAG,EAAE,CAAC;AACrB,kEAAkE;AAClE,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,aAAa,CAAC,GAAW;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,OAAO,IAAI,CAAC,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC;IAE9D,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAY,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAE/E,8EAA8E;IAC9E,MAAM,iBAAiB,GAAG,CAAC,IAAY,EAAE,KAAa,EAAY,EAAE;QAClE,MAAM,GAAG,GAAa,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,CAAC,MAAM,IAAI,KAAK,EAAE,GAAG,IAAI,EAAE,CAAC;YACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAY,CAAC,CAAC;YAChD,IAAI,CAAC,KAAK;gBAAE,SAAS;YACrB,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;YACvD,IAAI,KAAK,CAAC,OAAO,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACjD,IAAI,KAAK,GAAG,SAAS;oBAAE,KAAK,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBACzD,SAAS;YACX,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,KAAK;QAAE,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC;YAAE,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,2EAA2E;IAC3E,2EAA2E;IAC3E,2EAA2E;IAC3E,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,MAAM,GAAG,GAAoB,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAExD,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,UAAkB,EAAE,KAAa,EAAQ,EAAE;QACrE,IAAI,GAAG,CAAC,MAAM,IAAI,mBAAmB,IAAI,KAAK,GAAG,SAAS;YAAE,OAAO;QACnE,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC/B,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,OAAO,CAAC,4CAA4C;QACzE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,IAAI,SAAS,CAAC;QACnE,IAAI,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;YACzC,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;QACzC,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;QAC5C,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAE1B,MAAM,IAAI,GAAG,GAAG,UAAU,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC;QAC3C,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAEjF,KAAK,MAAM,KAAK,IAAI,iBAAiB,CAAC,IAAI,EAAE,KAAK,CAAC;YAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;QACtD,IAAI,IAAI,CAAC,OAAO,IAAI,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,KAAK,MAAM,KAAK,IAAI,iBAAiB,CAAC,IAAI,EAAE,CAAC,CAAC;gBAAE,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;GAGG;AACH,SAAS,WAAW,CAAC,IAAmB;IACtC,OAAO,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,QAAyB,EAAE,OAAwB;IAC/E,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,MAAM,OAAO,GAA6B,EAAE,CAAC;IAC7C,MAAM,aAAa,GAAoB,EAAE,CAAC;IAC1C,MAAM,aAAa,GAAoB,EAAE,CAAC;IAC1C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YAC3D,SAAS,EAAE,CAAC;QACd,CAAC;aAAM,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,mEAAmE;YACnE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED,4EAA4E;IAC5E,8BAA8B;IAC9B,MAAM,IAAI,GAAG,IAAI,GAAG,EAA2B,CAAC;IAChD,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM;YAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;;YACzB,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,aAAa,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC;QAC9B,IAAI,KAAK,EAAE,CAAC;YACV,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACpF,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAEvC,OAAO;QACL,MAAM;QACN,IAAI;QACJ,OAAO;QACP,KAAK;QACL,SAAS;QACT,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM;KACtD,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,sBAAsB,CAAC,IAAmB;IACxD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,SAAS,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,OAAO,CAAC,CAAC;IAC7D,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,UAAU,CAAC,CAAC;IACtE,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,CAAC;IAChE,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC;AACpE,CAAC"}