ghost-qa 0.0.0-stage → 1.3.0

package/dist/src/traps/console-trap.js

@@ -0,0 +1,151 @@
+import { makeIssue } from '../types.js';
+const HYDRATION_PATTERNS = [
+    /hydration/i,
+    /did not match/i,
+    /server rendered (html|markup)/i,
+    /text content does not match/i,
+    /a tree hydrated but some attributes/i,
+    /prop `[^`]+` did not match/i,
+];
+const REJECTION_PATTERNS = [
+    /unhandled ?(promise ?)?rejection/i,
+    /unhandledrejection/i,
+    /promise rejection/i,
+    /uncaught \(in promise\)/i,
+];
+/** Noise that ships in almost every dev server and tells the agent nothing. */
+const BENIGN_PATTERNS = [
+    /download the react devtools/i,
+    /\[vite\]/i,
+    /\[hmr\]/i,
+    /hot module replacement/i,
+    /favicon/i,
+    /devtools/i,
+    // Chromium's generic resource-load console line duplicates the Network
+    // Trap's precise per-request issue (status + URL), so it adds only noise.
+    /failed to load resource: the server responded with a status of/i,
+];
+export function isHydrationError(text) {
+    return HYDRATION_PATTERNS.some((p) => p.test(text));
+}
+export function isUnhandledRejection(text) {
+    return REJECTION_PATTERNS.some((p) => p.test(text));
+}
+export function isBenignConsoleNoise(text) {
+    return BENIGN_PATTERNS.some((p) => p.test(text));
+}
+/**
+ * Pure classifier — maps a raw console/page-error string to a trap verdict.
+ * Kept side-effect free so it is fully unit-testable without a browser.
+ */
+export function classifyConsoleText(text, source = 'console-error') {
+    if (isBenignConsoleNoise(text))
+        return 'benign';
+    if (isHydrationError(text))
+        return 'hydration-mismatch';
+    if (isUnhandledRejection(text))
+        return 'unhandled-rejection';
+    if (source === 'pageerror')
+        return 'page-error';
+    if (source === 'console-warning')
+        return 'console-warning';
+    return 'console-error';
+}
+export function consoleIssueFromText(text, route, viewport, source = 'console-error', stack) {
+    const kind = classifyConsoleText(text, source);
+    if (kind === 'benign')
+        return null;
+    const clean = text.replace(/\s+/g, ' ').trim().slice(0, 500);
+    switch (kind) {
+        case 'hydration-mismatch':
+            return makeIssue({
+                category: 'console',
+                severity: 'critical',
+                type: 'hydration-mismatch',
+                message: `React hydration mismatch: ${clean}`,
+                route,
+                viewport,
+                ...(stack ? { stack: stack.slice(0, 2000) } : {}),
+            });
+        case 'unhandled-rejection':
+            return makeIssue({
+                category: 'console',
+                severity: 'critical',
+                type: 'unhandled-rejection',
+                message: `Unhandled promise rejection: ${clean}`,
+                route,
+                viewport,
+                ...(stack ? { stack: stack.slice(0, 2000) } : {}),
+            });
+        case 'page-error':
+            return makeIssue({
+                category: 'console',
+                severity: 'critical',
+                type: 'page-error',
+                message: `Uncaught page error: ${clean}`,
+                route,
+                viewport,
+                ...(stack ? { stack: stack.slice(0, 2000) } : {}),
+            });
+        case 'console-warning':
+            return makeIssue({
+                category: 'console',
+                severity: 'minor',
+                type: 'console-warning',
+                message: `Console warning: ${clean}`,
+                route,
+                viewport,
+            });
+        default:
+            return makeIssue({
+                category: 'console',
+                severity: 'major',
+                type: 'console-error',
+                message: `Console error: ${clean}`,
+                route,
+                viewport,
+                ...(stack ? { stack: stack.slice(0, 2000) } : {}),
+            });
+    }
+}
+/**
+ * Attaches `pageerror` + `console` listeners to a Playwright page and
+ * accumulates structured issues. One trap instance per page.
+ */
+export class ConsoleTrap {
+    issues = [];
+    route = '/';
+    viewport;
+    detached = false;
+    constructor(viewport) {
+        this.viewport = viewport;
+    }
+    /** Tell the trap which route subsequent events belong to. */
+    setRoute(route) {
+        this.route = route;
+    }
+    attach(page) {
+        page.on('pageerror', (error) => {
+            if (this.detached)
+                return;
+            const issue = consoleIssueFromText(error.message || String(error), this.route, this.viewport, 'pageerror', error.stack);
+            if (issue)
+                this.issues.push(issue);
+        });
+        page.on('console', (message) => {
+            if (this.detached)
+                return;
+            const type = message.type();
+            if (type !== 'error' && type !== 'warning')
+                return;
+            const text = message.text();
+            const issue = consoleIssueFromText(text, this.route, this.viewport, type === 'error' ? 'console-error' : 'console-warning');
+            if (issue)
+                this.issues.push(issue);
+        });
+    }
+    detach() {
+        this.detached = true;
+    }
+}
+//# sourceMappingURL=console-trap.js.map

package/dist/src/traps/console-trap.js.map

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

package/dist/src/traps/layout-trap.d.ts

@@ -0,0 +1,31 @@
+import type { Page } from 'playwright';
+import { type QAIssue, type ViewportName } from '../types.js';
+export interface OffendingElement {
+    descriptor: string;
+    right: number;
+    width: number;
+}
+export interface LayoutMetrics {
+    innerWidth: number;
+    scrollWidth: number;
+    hasViewportMeta: boolean;
+    /** Interactive elements rendered at 0×0 (or effectively invisible). */
+    zeroSizeInteractives: string[];
+    /** Images that finished loading but decoded to nothing. */
+    brokenImages: string[];
+    /** Elements extending past the right edge of the viewport. */
+    overflowingElements: OffendingElement[];
+}
+export declare const EMPTY_METRICS: LayoutMetrics;
+/**
+ * Pure evaluator: DOM geometry in, structured layout issues out.
+ * This is the heart of the Layout Trap and is fully unit-testable.
+ */
+export declare function evaluateLayoutMetrics(metrics: LayoutMetrics, route: string, viewport: ViewportName): QAIssue[];
+/** Runs the in-page probe against a live Playwright page and evaluates it. */
+export declare class LayoutTrap {
+    private readonly viewport;
+    constructor(viewport: ViewportName);
+    collect(page: Page, route: string): Promise<QAIssue[]>;
+}
+//# sourceMappingURL=layout-trap.d.ts.map

package/dist/src/traps/layout-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-trap.d.ts","sourceRoot":"","sources":["../../../src/traps/layout-trap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,OAAO,EAAa,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8DAA8D;IAC9D,mBAAmB,EAAE,gBAAgB,EAAE,CAAC;CACzC;AAED,eAAO,MAAM,aAAa,EAAE,aAO3B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,aAAa,EACtB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,GACrB,OAAO,EAAE,CA0EX;AA2DD,8EAA8E;AAC9E,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,QAAQ,EAAE,YAAY;IAI5B,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAiB7D"}

package/dist/src/traps/layout-trap.js

@@ -0,0 +1,150 @@
+import { VIEWPORT_PROFILES } from '../engine/browser-session.js';
+import { makeIssue } from '../types.js';
+export const EMPTY_METRICS = {
+    innerWidth: 0,
+    scrollWidth: 0,
+    hasViewportMeta: false,
+    zeroSizeInteractives: [],
+    brokenImages: [],
+    overflowingElements: [],
+};
+/**
+ * Pure evaluator: DOM geometry in, structured layout issues out.
+ * This is the heart of the Layout Trap and is fully unit-testable.
+ */
+export function evaluateLayoutMetrics(metrics, route, viewport) {
+    const issues = [];
+    const tolerancePx = 1;
+    if (metrics.innerWidth > 0 && metrics.scrollWidth > metrics.innerWidth + tolerancePx) {
+        const overflowPx = metrics.scrollWidth - metrics.innerWidth;
+        const offenders = metrics.overflowingElements
+            .slice(0, 3)
+            .map((el) => el.descriptor)
+            .join(', ');
+        issues.push(makeIssue({
+            category: 'layout',
+            severity: viewport === 'mobile' ? 'critical' : 'major',
+            type: 'horizontal-overflow',
+            message: `Horizontal overflow on ${viewport}: page scrolls sideways by ${overflowPx}px ` +
+                `(scrollWidth ${metrics.scrollWidth} > viewport ${metrics.innerWidth}).` +
+                (offenders ? ` Likely culprits: ${offenders}.` : '') +
+                ' Common causes: 100vw widths, fixed-width children, negative margins, unshrunk flex/grid items.',
+            route,
+            viewport,
+            details: {
+                scrollWidth: metrics.scrollWidth,
+                innerWidth: metrics.innerWidth,
+                overflowPx,
+            },
+        }));
+    }
+    for (const descriptor of metrics.zeroSizeInteractives.slice(0, 5)) {
+        issues.push(makeIssue({
+            category: 'layout',
+            severity: 'major',
+            type: 'zero-size-interactive',
+            message: `Interactive element has zero size and cannot be tapped/clicked: ${descriptor}. Check for display/width/height CSS collapsing it or content that never rendered.`,
+            route,
+            viewport,
+            details: { element: descriptor },
+        }));
+    }
+    for (const src of metrics.brokenImages.slice(0, 5)) {
+        issues.push(makeIssue({
+            category: 'layout',
+            severity: 'major',
+            type: 'broken-image',
+            message: `Broken image (naturalWidth === 0): ${src}. Verify the asset path exists and is served with a 200.`,
+            route,
+            viewport,
+            details: { src },
+        }));
+    }
+    if (viewport === 'mobile' && !metrics.hasViewportMeta) {
+        issues.push(makeIssue({
+            category: 'layout',
+            severity: 'major',
+            type: 'missing-viewport-meta',
+            message: 'Missing <meta name="viewport"> — mobile browsers will render at a desktop width and scale down. Add <meta name="viewport" content="width=device-width, initial-scale=1">.',
+            route,
+            viewport,
+        }));
+    }
+    return issues;
+}
+/** In-page probe: measures live DOM geometry. Executed inside Chromium. */
+function probeLayout() {
+    const describe = (el) => {
+        const tag = el.tagName.toLowerCase();
+        const id = el.id ? `#${el.id}` : '';
+        const cls = typeof el.className === 'string' && el.className.trim()
+            ? `.${el.className.trim().split(/\s+/).slice(0, 2).join('.')}`
+            : '';
+        const text = (el.textContent ?? '').replace(/\s+/g, ' ').trim().slice(0, 40);
+        return `${tag}${id}${cls}${text ? ` "${text}"` : ''}`;
+    };
+    const interactiveSelector = 'a[href], button, input, select, textarea, [role="button"], [role="tab"], [tabindex]';
+    const zeroSizeInteractives = [];
+    document.querySelectorAll(interactiveSelector).forEach((el) => {
+        const rect = el.getBoundingClientRect();
+        const style = window.getComputedStyle(el);
+        const intentionallyHidden = style.display === 'none' || style.visibility === 'hidden' || style.opacity === '0';
+        if (!intentionallyHidden && (rect.width === 0 || rect.height === 0)) {
+            zeroSizeInteractives.push(describe(el));
+        }
+    });
+    const brokenImages = [];
+    document.querySelectorAll('img').forEach((img) => {
+        if (img.complete && img.naturalWidth === 0) {
+            brokenImages.push(img.currentSrc || img.src || img.alt || '(image without src)');
+        }
+    });
+    const overflowingElements = [];
+    const innerWidth = window.innerWidth;
+    document.querySelectorAll('body *').forEach((el) => {
+        if (overflowingElements.length >= 10)
+            return;
+        const rect = el.getBoundingClientRect();
+        if (rect.width > 0 && rect.right > innerWidth + 1) {
+            overflowingElements.push({
+                descriptor: describe(el),
+                right: Math.round(rect.right),
+                width: Math.round(rect.width),
+            });
+        }
+    });
+    return {
+        innerWidth,
+        scrollWidth: document.documentElement.scrollWidth,
+        hasViewportMeta: Boolean(document.querySelector('meta[name="viewport"]')),
+        zeroSizeInteractives,
+        brokenImages,
+        overflowingElements,
+    };
+}
+/** Runs the in-page probe against a live Playwright page and evaluates it. */
+export class LayoutTrap {
+    viewport;
+    constructor(viewport) {
+        this.viewport = viewport;
+    }
+    async collect(page, route) {
+        let metrics;
+        try {
+            metrics = await page.evaluate(probeLayout);
+        }
+        catch {
+            return [];
+        }
+        // Judge overflow against the intended profile width, not just the live
+        // innerWidth: mobile emulation (and some headless builds) can let the
+        // layout viewport grow with wide content, which would mask exactly the
+        // overflow this trap exists to catch.
+        const expectedWidth = VIEWPORT_PROFILES[this.viewport].width;
+        if (metrics.innerWidth > expectedWidth) {
+            metrics = { ...metrics, innerWidth: expectedWidth };
+        }
+        return evaluateLayoutMetrics(metrics, route, this.viewport);
+    }
+}
+//# sourceMappingURL=layout-trap.js.map

package/dist/src/traps/layout-trap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout-trap.js","sourceRoot":"","sources":["../../../src/traps/layout-trap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,SAAS,EAAmC,MAAM,aAAa,CAAC;AAoBzE,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,CAAC;IACd,eAAe,EAAE,KAAK;IACtB,oBAAoB,EAAE,EAAE;IACxB,YAAY,EAAE,EAAE;IAChB,mBAAmB,EAAE,EAAE;CACxB,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAsB,EACtB,KAAa,EACb,QAAsB;IAEtB,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,MAAM,WAAW,GAAG,CAAC,CAAC;IAEtB,IAAI,OAAO,CAAC,UAAU,GAAG,CAAC,IAAI,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,WAAW,EAAE,CAAC;QACrF,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;QAC5D,MAAM,SAAS,GAAG,OAAO,CAAC,mBAAmB;aAC1C,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;aACX,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC;aAC1B,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CACT,SAAS,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO;YACtD,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EACL,0BAA0B,QAAQ,8BAA8B,UAAU,KAAK;gBAC/E,gBAAgB,OAAO,CAAC,WAAW,eAAe,OAAO,CAAC,UAAU,IAAI;gBACxE,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,SAAS,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpD,iGAAiG;YACnG,KAAK;YACL,QAAQ;YACR,OAAO,EAAE;gBACP,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,UAAU;aACX;SACF,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,UAAU,IAAI,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAClE,MAAM,CAAC,IAAI,CACT,SAAS,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,mEAAmE,UAAU,oFAAoF;YAC1K,KAAK;YACL,QAAQ;YACR,OAAO,EAAE,EAAE,OAAO,EAAE,UAAU,EAAE;SACjC,CAAC,CACH,CAAC;IACJ,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CACT,SAAS,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,sCAAsC,GAAG,0DAA0D;YAC5G,KAAK;YACL,QAAQ;YACR,OAAO,EAAE,EAAE,GAAG,EAAE;SACjB,CAAC,CACH,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QACtD,MAAM,CAAC,IAAI,CACT,SAAS,CAAC;YACR,QAAQ,EAAE,QAAQ;YAClB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EACL,2KAA2K;YAC7K,KAAK;YACL,QAAQ;SACT,CAAC,CACH,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,2EAA2E;AAC3E,SAAS,WAAW;IAClB,MAAM,QAAQ,GAAG,CAAC,EAAW,EAAU,EAAE;QACvC,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpC,MAAM,GAAG,GACP,OAAO,EAAE,CAAC,SAAS,KAAK,QAAQ,IAAI,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE;YACrD,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;YAC9D,CAAC,CAAC,EAAE,CAAC;QACT,MAAM,IAAI,GAAG,CAAC,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7E,OAAO,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxD,CAAC,CAAC;IAEF,MAAM,mBAAmB,GACvB,qFAAqF,CAAC;IACxF,MAAM,oBAAoB,GAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,mBAAmB,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QAC5D,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,MAAM,CAAC,gBAAgB,CAAC,EAAiB,CAAC,CAAC;QACzD,MAAM,mBAAmB,GACvB,KAAK,CAAC,OAAO,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,KAAK,GAAG,CAAC;QACrF,IAAI,CAAC,mBAAmB,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;YACpE,oBAAoB,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,YAAY,GAAa,EAAE,CAAC;IAClC,QAAQ,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/C,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY,KAAK,CAAC,EAAE,CAAC;YAC3C,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,IAAI,qBAAqB,CAAC,CAAC;QACnF,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,MAAM,mBAAmB,GAAuB,EAAE,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE;QACjD,IAAI,mBAAmB,CAAC,MAAM,IAAI,EAAE;YAAE,OAAO;QAC7C,MAAM,IAAI,GAAG,EAAE,CAAC,qBAAqB,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;YAClD,mBAAmB,CAAC,IAAI,CAAC;gBACvB,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC;gBACxB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC7B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;aAC9B,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,UAAU;QACV,WAAW,EAAE,QAAQ,CAAC,eAAe,CAAC,WAAW;QACjD,eAAe,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,uBAAuB,CAAC,CAAC;QACzE,oBAAoB;QACpB,YAAY;QACZ,mBAAmB;KACpB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,MAAM,OAAO,UAAU;IACJ,QAAQ,CAAe;IAExC,YAAY,QAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAU,EAAE,KAAa;QACrC,IAAI,OAAsB,CAAC;QAC3B,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,uEAAuE;QACvE,sEAAsE;QACtE,uEAAuE;QACvE,sCAAsC;QACtC,MAAM,aAAa,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC;QAC7D,IAAI,OAAO,CAAC,UAAU,GAAG,aAAa,EAAE,CAAC;YACvC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC;QACtD,CAAC;QACD,OAAO,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/src/traps/network-trap.d.ts

@@ -0,0 +1,24 @@
+import type { Page } from 'playwright';
+import { type QAIssue, type ViewportName } from '../types.js';
+export declare function isAssetUrl(url: string): boolean;
+export declare function isCorsFailure(errorText: string): boolean;
+/**
+ * Pure evaluator for an HTTP response. Returns an issue for status >= 400,
+ * or `null` for healthy responses. Unit-testable without a browser.
+ */
+export declare function evaluateHttpResponse(status: number, url: string, route: string, viewport: ViewportName, resourceType?: string): QAIssue | null;
+/** Pure evaluator for a request that never completed (DNS, CORS, abort…). */
+export declare function evaluateRequestFailure(errorText: string, url: string, route: string, viewport: ViewportName, resourceType?: string): QAIssue | null;
+export declare function shortUrl(url: string): string;
+/** Attaches `response` + `requestfailed` listeners to a page. */
+export declare class NetworkTrap {
+    readonly issues: QAIssue[];
+    private route;
+    private readonly viewport;
+    private detached;
+    constructor(viewport: ViewportName);
+    setRoute(route: string): void;
+    attach(page: Page): void;
+    detach(): void;
+}
+//# sourceMappingURL=network-trap.d.ts.map

package/dist/src/traps/network-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-trap.d.ts","sourceRoot":"","sources":["../../../src/traps/network-trap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAa,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzE,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAExD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EACtB,YAAY,SAAa,GACxB,OAAO,GAAG,IAAI,CA0ChB;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EACtB,YAAY,SAAQ,GACnB,OAAO,GAAG,IAAI,CA0BhB;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQ5C;AAED,iEAAiE;AACjE,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,CAAM;IAChC,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,YAAY;IAIlC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI7B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAgCxB,MAAM,IAAI,IAAI;CAGf"}

package/dist/src/traps/network-trap.js

@@ -0,0 +1,132 @@
+import { makeIssue } from '../types.js';
+const ASSET_EXTENSIONS = /\.(?:js|mjs|css|png|jpe?g|gif|svg|webp|avif|ico|woff2?|ttf|otf|map|json|wasm)(?:\?|$)/i;
+export function isAssetUrl(url) {
+    return ASSET_EXTENSIONS.test(url);
+}
+export function isCorsFailure(errorText) {
+    return /cors|cross-origin|access-control|ERR_FAILED|net::ERR_BLOCKED_BY/i.test(errorText);
+}
+/**
+ * Pure evaluator for an HTTP response. Returns an issue for status >= 400,
+ * or `null` for healthy responses. Unit-testable without a browser.
+ */
+export function evaluateHttpResponse(status, url, route, viewport, resourceType = 'document') {
+    if (status < 400)
+        return null;
+    const isFavicon = /favicon[^/]*$/i.test(url);
+    if (isFavicon) {
+        return makeIssue({
+            category: 'network',
+            severity: 'minor',
+            type: 'broken-asset',
+            message: `Missing favicon (HTTP ${status}): ${url}`,
+            route,
+            viewport,
+            url,
+            details: { status, resourceType },
+        });
+    }
+    const asset = isAssetUrl(url) || ['script', 'stylesheet', 'image', 'font'].includes(resourceType);
+    if (status >= 500) {
+        return makeIssue({
+            category: 'network',
+            severity: 'critical',
+            type: 'http-error',
+            message: `Server error HTTP ${status} for ${shortUrl(url)} — backend/API is crashing on this route.`,
+            route,
+            viewport,
+            url,
+            details: { status, resourceType },
+        });
+    }
+    return makeIssue({
+        category: 'network',
+        severity: asset ? 'major' : 'major',
+        type: asset ? 'broken-asset' : 'http-error',
+        message: asset
+            ? `Broken asset HTTP ${status}: ${shortUrl(url)} (resource failed to load)`
+            : `HTTP ${status} response for ${shortUrl(url)}`,
+        route,
+        viewport,
+        url,
+        details: { status, resourceType },
+    });
+}
+/** Pure evaluator for a request that never completed (DNS, CORS, abort…). */
+export function evaluateRequestFailure(errorText, url, route, viewport, resourceType = 'xhr') {
+    // Aborted requests are usually the crawler navigating away — not a bug.
+    if (/ERR_ABORTED/i.test(errorText))
+        return null;
+    if (isCorsFailure(errorText)) {
+        return makeIssue({
+            category: 'network',
+            severity: 'critical',
+            type: 'cors-error',
+            message: `CORS / blocked request failed: ${shortUrl(url)} (${errorText}). Check API CORS headers and the fetch origin.`,
+            route,
+            viewport,
+            url,
+            details: { errorText, resourceType },
+        });
+    }
+    return makeIssue({
+        category: 'network',
+        severity: isAssetUrl(url) ? 'major' : 'critical',
+        type: 'request-failed',
+        message: `Request failed (${resourceType}): ${shortUrl(url)} — ${errorText}`,
+        route,
+        viewport,
+        url,
+        details: { errorText, resourceType },
+    });
+}
+export function shortUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname + parsed.search;
+        return path.length > 120 ? `${path.slice(0, 117)}…` : path || '/';
+    }
+    catch {
+        return url.slice(0, 120);
+    }
+}
+/** Attaches `response` + `requestfailed` listeners to a page. */
+export class NetworkTrap {
+    issues = [];
+    route = '/';
+    viewport;
+    detached = false;
+    constructor(viewport) {
+        this.viewport = viewport;
+    }
+    setRoute(route) {
+        this.route = route;
+    }
+    attach(page) {
+        page.on('response', (response) => {
+            if (this.detached)
+                return;
+            try {
+                const request = response.request();
+                const issue = evaluateHttpResponse(response.status(), response.url(), this.route, this.viewport, request.resourceType());
+                if (issue)
+                    this.issues.push(issue);
+            }
+            catch {
+                /* response already disposed — nothing actionable */
+            }
+        });
+        page.on('requestfailed', (request) => {
+            if (this.detached)
+                return;
+            const failure = request.failure();
+            const issue = evaluateRequestFailure(failure?.errorText ?? 'unknown network failure', request.url(), this.route, this.viewport, request.resourceType());
+            if (issue)
+                this.issues.push(issue);
+        });
+    }
+    detach() {
+        this.detached = true;
+    }
+}
+//# sourceMappingURL=network-trap.js.map

package/dist/src/traps/network-trap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-trap.js","sourceRoot":"","sources":["../../../src/traps/network-trap.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAmC,MAAM,aAAa,CAAC;AAEzE,MAAM,gBAAgB,GAAG,wFAAwF,CAAC;AAElH,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,OAAO,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,OAAO,kEAAkE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAC5F,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,GAAW,EACX,KAAa,EACb,QAAsB,EACtB,YAAY,GAAG,UAAU;IAEzB,IAAI,MAAM,GAAG,GAAG;QAAE,OAAO,IAAI,CAAC;IAE9B,MAAM,SAAS,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7C,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,SAAS,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,OAAO;YACjB,IAAI,EAAE,cAAc;YACpB,OAAO,EAAE,yBAAyB,MAAM,MAAM,GAAG,EAAE;YACnD,KAAK;YACL,QAAQ;YACR,GAAG;YACH,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;IAClG,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,qBAAqB,MAAM,QAAQ,QAAQ,CAAC,GAAG,CAAC,2CAA2C;YACpG,KAAK;YACL,QAAQ;YACR,GAAG;YACH,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;QACf,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QACnC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,YAAY;QAC3C,OAAO,EAAE,KAAK;YACZ,CAAC,CAAC,qBAAqB,MAAM,KAAK,QAAQ,CAAC,GAAG,CAAC,4BAA4B;YAC3E,CAAC,CAAC,QAAQ,MAAM,iBAAiB,QAAQ,CAAC,GAAG,CAAC,EAAE;QAClD,KAAK;QACL,QAAQ;QACR,GAAG;QACH,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;KAClC,CAAC,CAAC;AACL,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,sBAAsB,CACpC,SAAiB,EACjB,GAAW,EACX,KAAa,EACb,QAAsB,EACtB,YAAY,GAAG,KAAK;IAEpB,wEAAwE;IACxE,IAAI,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,IAAI,aAAa,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,SAAS,CAAC;YACf,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,UAAU;YACpB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,kCAAkC,QAAQ,CAAC,GAAG,CAAC,KAAK,SAAS,iDAAiD;YACvH,KAAK;YACL,QAAQ;YACR,GAAG;YACH,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;SACrC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAC;QACf,QAAQ,EAAE,SAAS;QACnB,QAAQ,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU;QAChD,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,mBAAmB,YAAY,MAAM,QAAQ,CAAC,GAAG,CAAC,MAAM,SAAS,EAAE;QAC5E,KAAK;QACL,QAAQ;QACR,GAAG;QACH,OAAO,EAAE,EAAE,SAAS,EAAE,YAAY,EAAE;KACrC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC;QAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,iEAAiE;AACjE,MAAM,OAAO,WAAW;IACb,MAAM,GAAc,EAAE,CAAC;IACxB,KAAK,GAAG,GAAG,CAAC;IACH,QAAQ,CAAe;IAChC,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,QAAsB;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,QAAQ,CAAC,KAAa;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAU;QACf,IAAI,CAAC,EAAE,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,EAAE;YAC/B,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC1B,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;gBACnC,MAAM,KAAK,GAAG,oBAAoB,CAChC,QAAQ,CAAC,MAAM,EAAE,EACjB,QAAQ,CAAC,GAAG,EAAE,EACd,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,QAAQ,EACb,OAAO,CAAC,YAAY,EAAE,CACvB,CAAC;gBACF,IAAI,KAAK;oBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,OAAO,EAAE,EAAE;YACnC,IAAI,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,sBAAsB,CAClC,OAAO,EAAE,SAAS,IAAI,yBAAyB,EAC/C,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,KAAK,EACV,IAAI,CAAC,QAAQ,EACb,OAAO,CAAC,YAAY,EAAE,CACvB,CAAC;YACF,IAAI,KAAK;gBAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM;QACJ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;CACF"}

package/dist/src/traps/perf-trap.d.ts

@@ -0,0 +1,42 @@
+import type { Page } from 'playwright';
+import { type QAIssue, type ViewportName } from '../types.js';
+export interface ResourceSize {
+    url: string;
+    transferBytes: number;
+}
+export interface PerfMetrics {
+    domContentLoadedMs: number;
+    loadMs: number;
+    resourceCount: number;
+    totalTransferBytes: number;
+    oversizedResources: ResourceSize[];
+    /** Scripts/stylesheets that block first paint (head, no async/defer/media tricks). */
+    renderBlockingCount: number;
+    domNodeCount: number;
+    /** Long Tasks API (Chromium): tasks > 50ms that freeze the main thread. */
+    longTaskCount: number;
+    longTaskTotalMs: number;
+}
+export declare const EMPTY_PERF_METRICS: PerfMetrics;
+export declare const PERF_THRESHOLDS: {
+    readonly domContentLoadedMs: 3000;
+    readonly loadMs: 5000;
+    readonly singleResourceBytes: 1000000;
+    readonly totalTransferBytes: 3000000;
+    readonly renderBlockingCount: 5;
+    readonly domNodeCount: 1500;
+    readonly longTaskCount: 5;
+    readonly longTaskTotalMs: 500;
+};
+/**
+ * Pure evaluator: Navigation/Resource Timing facts in, perf issues out.
+ * Fully unit-testable without a browser.
+ */
+export declare function evaluatePerfMetrics(metrics: PerfMetrics, route: string, viewport: ViewportName): QAIssue[];
+/** Runs the in-page perf probe against a live page and evaluates it. */
+export declare class PerfTrap {
+    private readonly viewport;
+    constructor(viewport: ViewportName);
+    collect(page: Page, route: string): Promise<QAIssue[]>;
+}
+//# sourceMappingURL=perf-trap.d.ts.map

package/dist/src/traps/perf-trap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"perf-trap.d.ts","sourceRoot":"","sources":["../../../src/traps/perf-trap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAa,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,YAAY,EAAE,CAAC;IACnC,sFAAsF;IACtF,mBAAmB,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,2EAA2E;IAC3E,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAUhC,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;CASlB,CAAC;AAKX;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,GACrB,OAAO,EAAE,CA8GX;AAqED,wEAAwE;AACxE,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;gBAE5B,QAAQ,EAAE,YAAY;IAI5B,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAS7D"}