ghost-qa 1.3.1 → 2.0.0

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

@@ -3,6 +3,8 @@ import { type QAIssue, type ViewportName } from '../types.js';
 export interface ResourceSize {
     url: string;
     transferBytes: number;
+    /** Resource Timing initiatorType (img, script, link, fetch…). */
+    kind?: string;
 }
 export interface PerfMetrics {
     domContentLoadedMs: number;
@@ -16,17 +18,33 @@ export interface PerfMetrics {
     /** Long Tasks API (Chromium): tasks > 50ms that freeze the main thread. */
     longTaskCount: number;
     longTaskTotalMs: number;
+    /** Time to first byte (navigation responseStart). */
+    ttfbMs: number;
+    /** First Contentful Paint. */
+    fcpMs: number;
+    /** Largest Contentful Paint (observed, buffered). */
+    lcpMs: number;
+    /** Cumulative Layout Shift (layout-shift entries, buffered). */
+    cls: number;
+    /** Deepest DOM nesting level. */
+    maxDomDepth: number;
 }
 export declare const EMPTY_PERF_METRICS: PerfMetrics;
 export declare const PERF_THRESHOLDS: {
     readonly domContentLoadedMs: 3000;
     readonly loadMs: 5000;
     readonly singleResourceBytes: 1000000;
+    readonly unoptimizedResourceBytes: 500000;
     readonly totalTransferBytes: 3000000;
     readonly renderBlockingCount: 5;
     readonly domNodeCount: 1500;
+    readonly domDepth: 32;
     readonly longTaskCount: 5;
     readonly longTaskTotalMs: 500;
+    readonly ttfbMs: 800;
+    readonly fcpMs: 1800;
+    readonly lcpMs: 2500;
+    readonly cls: 0.1;
 };
 /**
  * Pure evaluator: Navigation/Resource Timing facts in, perf issues out.

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

@@ -1 +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"}
+{"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;IACtB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;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;IACxB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,kBAAkB,EAAE,WAehC,CAAC;AAEF,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;CAelB,CAAC;AAKX;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,GACrB,OAAO,EAAE,CAqMX;AA6HD,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"}

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

@@ -9,16 +9,27 @@ export const EMPTY_PERF_METRICS = {
     domNodeCount: 0,
     longTaskCount: 0,
     longTaskTotalMs: 0,
+    ttfbMs: 0,
+    fcpMs: 0,
+    lcpMs: 0,
+    cls: 0,
+    maxDomDepth: 0,
 };
 export const PERF_THRESHOLDS = {
     domContentLoadedMs: 3_000,
     loadMs: 5_000,
     singleResourceBytes: 1_000_000,
+    unoptimizedResourceBytes: 500_000,
     totalTransferBytes: 3_000_000,
     renderBlockingCount: 5,
     domNodeCount: 1_500,
+    domDepth: 32,
     longTaskCount: 5,
     longTaskTotalMs: 500,
+    ttfbMs: 800,
+    fcpMs: 1_800,
+    lcpMs: 2_500,
+    cls: 0.1,
 };
 const kb = (bytes) => `${Math.round(bytes / 1024)}KB`;
 const ms = (value) => `${Math.round(value)}ms`;
@@ -48,17 +59,85 @@ export function evaluatePerfMetrics(metrics, route, viewport) {
         }));
     }
     for (const resource of metrics.oversizedResources.slice(0, 5)) {
-        if (resource.transferBytes <= PERF_THRESHOLDS.singleResourceBytes)
-            continue;
+        if (resource.transferBytes > PERF_THRESHOLDS.singleResourceBytes) {
+            issues.push(makeIssue({
+                category: 'performance',
+                severity: 'major',
+                type: 'oversized-resource',
+                message: `Oversized resource (${kb(resource.transferBytes)}): ${resource.url}. Compress, resize, lazy-load or code-split it — a single asset should stay under ${kb(PERF_THRESHOLDS.singleResourceBytes)}.`,
+                route,
+                viewport,
+                url: resource.url,
+                details: { transferBytes: resource.transferBytes },
+            }));
+        }
+        else if (resource.transferBytes > PERF_THRESHOLDS.unoptimizedResourceBytes &&
+            (resource.kind === 'img' || resource.kind === 'script' || resource.kind === 'link')) {
+            issues.push(makeIssue({
+                category: 'performance',
+                severity: 'minor',
+                type: 'unoptimized-resource',
+                message: `Unoptimized payload (${kb(resource.transferBytes)}, ${resource.kind}): ${resource.url}. Images/scripts over ${kb(PERF_THRESHOLDS.unoptimizedResourceBytes)} should be compressed, resized to display size, modern-formatted (WebP/AVIF) or code-split.`,
+                route,
+                viewport,
+                url: resource.url,
+                details: { transferBytes: resource.transferBytes, kind: resource.kind },
+            }));
+        }
+    }
+    if (metrics.ttfbMs > PERF_THRESHOLDS.ttfbMs) {
         issues.push(makeIssue({
             category: 'performance',
-            severity: 'major',
-            type: 'oversized-resource',
-            message: `Oversized resource (${kb(resource.transferBytes)}): ${resource.url}. Compress, resize, lazy-load or code-split it — a single asset should stay under ${kb(PERF_THRESHOLDS.singleResourceBytes)}.`,
+            severity: metrics.ttfbMs > PERF_THRESHOLDS.ttfbMs * 2 ? 'major' : 'minor',
+            type: 'slow-ttfb',
+            message: `Slow time-to-first-byte: ${ms(metrics.ttfbMs)} (budget ${ms(PERF_THRESHOLDS.ttfbMs)}). Profile server rendering, middleware and database calls — no client optimisation can hide a slow first byte.`,
+            route,
+            viewport,
+            details: { ttfbMs: Math.round(metrics.ttfbMs) },
+        }));
+    }
+    if (metrics.fcpMs > PERF_THRESHOLDS.fcpMs) {
+        issues.push(makeIssue({
+            category: 'performance',
+            severity: metrics.fcpMs > PERF_THRESHOLDS.fcpMs * 1.7 ? 'major' : 'minor',
+            type: 'slow-fcp',
+            message: `Slow First Contentful Paint: ${ms(metrics.fcpMs)} (budget ${ms(PERF_THRESHOLDS.fcpMs)}). Reduce render-blocking CSS/JS and inline critical styles.`,
+            route,
+            viewport,
+            details: { fcpMs: Math.round(metrics.fcpMs) },
+        }));
+    }
+    if (metrics.lcpMs > PERF_THRESHOLDS.lcpMs) {
+        issues.push(makeIssue({
+            category: 'performance',
+            severity: metrics.lcpMs > 4_000 ? 'critical' : 'major',
+            type: 'slow-lcp',
+            message: `Slow Largest Contentful Paint: ${ms(metrics.lcpMs)} (budget ${ms(PERF_THRESHOLDS.lcpMs)}). Optimise the hero element: preload it, serve responsive image sizes, and remove render-blocking work ahead of it.`,
+            route,
+            viewport,
+            details: { lcpMs: Math.round(metrics.lcpMs) },
+        }));
+    }
+    if (metrics.cls > PERF_THRESHOLDS.cls) {
+        issues.push(makeIssue({
+            category: 'performance',
+            severity: metrics.cls > 0.25 ? 'critical' : 'major',
+            type: 'high-cls',
+            message: `High Cumulative Layout Shift: ${metrics.cls.toFixed(3)} (budget ${PERF_THRESHOLDS.cls}). Reserve space for images/ads/embeds with width/height or aspect-ratio so content stops jumping while it loads.`,
             route,
             viewport,
-            url: resource.url,
-            details: { transferBytes: resource.transferBytes },
+            details: { cls: Math.round(metrics.cls * 1000) / 1000 },
+        }));
+    }
+    if (metrics.maxDomDepth > PERF_THRESHOLDS.domDepth) {
+        issues.push(makeIssue({
+            category: 'performance',
+            severity: 'minor',
+            type: 'deep-dom',
+            message: `Deeply nested DOM: ${metrics.maxDomDepth} levels (budget ${PERF_THRESHOLDS.domDepth}). Flatten wrapper-div pyramids — deep trees slow style recalculation, layout and hydration.`,
+            route,
+            viewport,
+            details: { maxDomDepth: metrics.maxDomDepth },
         }));
     }
     if (metrics.totalTransferBytes > PERF_THRESHOLDS.totalTransferBytes) {
@@ -124,7 +203,11 @@ async function probePerf() {
         const bytes = resource.transferSize || resource.encodedBodySize || 0;
         totalTransferBytes += bytes;
         if (bytes > 250_000) {
-            oversizedResources.push({ url: resource.name.slice(0, 200), transferBytes: bytes });
+            oversizedResources.push({
+                url: resource.name.slice(0, 200),
+                transferBytes: bytes,
+                kind: resource.initiatorType || 'other',
+            });
         }
     }
     oversizedResources.sort((a, b) => b.transferBytes - a.transferBytes);
@@ -164,6 +247,58 @@ async function probePerf() {
     catch {
         /* Long Tasks API unsupported in this browser */
     }
+    // Core Web Vitals: paint timing is synchronous; LCP/CLS need buffered
+    // PerformanceObserver entries (same pattern as longtask above).
+    const paint = performance.getEntriesByType('paint');
+    const fcp = paint.find((entry) => entry.name === 'first-contentful-paint');
+    let lcpMs = 0;
+    let cls = 0;
+    try {
+        const vitals = await new Promise((resolvePromise) => {
+            let lcp = 0;
+            let shift = 0;
+            const observers = [];
+            try {
+                const lcpObserver = new PerformanceObserver((list) => {
+                    for (const entry of list.getEntries())
+                        lcp = Math.max(lcp, entry.startTime);
+                });
+                lcpObserver.observe({ type: 'largest-contentful-paint', buffered: true });
+                observers.push(lcpObserver);
+                const clsObserver = new PerformanceObserver((list) => {
+                    for (const entry of list.getEntries()) {
+                        const shiftEntry = entry;
+                        if (!shiftEntry.hadRecentInput)
+                            shift += shiftEntry.value ?? 0;
+                    }
+                });
+                clsObserver.observe({ type: 'layout-shift', buffered: true });
+                observers.push(clsObserver);
+                setTimeout(() => {
+                    observers.forEach((o) => o.disconnect());
+                    resolvePromise({ lcp, cls: shift });
+                }, 30);
+            }
+            catch {
+                resolvePromise({ lcp, cls: shift });
+            }
+        });
+        lcpMs = vitals.lcp;
+        cls = vitals.cls;
+    }
+    catch {
+        /* Web Vitals APIs unsupported in this browser */
+    }
+    let maxDomDepth = 0;
+    const walkDepth = (el, depth) => {
+        if (depth > maxDomDepth)
+            maxDomDepth = depth;
+        if (depth > 64)
+            return;
+        for (const child of Array.from(el.children))
+            walkDepth(child, depth + 1);
+    };
+    walkDepth(document.documentElement, 1);
     return {
         domContentLoadedMs: nav ? nav.domContentLoadedEventEnd : 0,
         loadMs: nav ? nav.loadEventEnd || nav.responseEnd : 0,
@@ -174,6 +309,11 @@ async function probePerf() {
         domNodeCount: document.querySelectorAll('*').length,
         longTaskCount,
         longTaskTotalMs,
+        ttfbMs: nav ? nav.responseStart : 0,
+        fcpMs: fcp ? fcp.startTime : 0,
+        lcpMs,
+        cls,
+        maxDomDepth,
     };
 }
 /** Runs the in-page perf probe against a live page and evaluates it. */

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

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

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

@@ -0,0 +1,30 @@
+import type { Page } from 'playwright';
+import { type QAIssue, type ViewportName } from '../types.js';
+/**
+ * Trap 7 — SEO, Metadata & Social Graph.
+ *
+ * What search engines and link unfurlers see, audited on the live DOM
+ * (post-hydration, exactly as a crawler rendering the page would).
+ */
+export interface SeoMetrics {
+    title: string;
+    hasDescription: boolean;
+    hasLang: boolean;
+    hasViewportMeta: boolean;
+    hasCanonical: boolean;
+    ogTitle: boolean;
+    ogDescription: boolean;
+    ogImage: boolean;
+    /** id attribute values used more than once. */
+    duplicateIds: string[];
+}
+export declare const EMPTY_SEO_METRICS: SeoMetrics;
+export declare const TITLE_MIN_LENGTH = 10;
+export declare const TITLE_MAX_LENGTH = 60;
+export declare function evaluateSeoMetrics(metrics: SeoMetrics, route: string, viewport: ViewportName): QAIssue[];
+export declare class SeoTrap {
+    private readonly viewport;
+    constructor(viewport: ViewportName);
+    collect(page: Page, route: string): Promise<QAIssue[]>;
+}
+//# sourceMappingURL=seo-trap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-trap.d.ts","sourceRoot":"","sources":["../../../src/traps/seo-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;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,eAAO,MAAM,iBAAiB,EAAE,UAU/B,CAAC;AAEF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,GACrB,OAAO,EAAE,CAoDX;AAsBD,qBAAa,OAAO;IAClB,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"}

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

@@ -0,0 +1,98 @@
+import { makeIssue } from '../types.js';
+export const EMPTY_SEO_METRICS = {
+    title: '',
+    hasDescription: false,
+    hasLang: false,
+    hasViewportMeta: false,
+    hasCanonical: false,
+    ogTitle: false,
+    ogDescription: false,
+    ogImage: false,
+    duplicateIds: [],
+};
+export const TITLE_MIN_LENGTH = 10;
+export const TITLE_MAX_LENGTH = 60;
+export function evaluateSeoMetrics(metrics, route, viewport) {
+    const issues = [];
+    const push = (severity, type, message) => issues.push(makeIssue({ category: 'seo', severity, type, message, route, viewport }));
+    const title = metrics.title.trim();
+    if (title.length === 0) {
+        push('major', 'missing-document-title', 'Missing <title>: search results, tabs and screen readers all start here. Add a unique descriptive title per route.');
+    }
+    else if (title.length < TITLE_MIN_LENGTH) {
+        push('minor', 'title-too-short', `<title> is only ${title.length} characters ("${title}"). Aim for ${TITLE_MIN_LENGTH}–${TITLE_MAX_LENGTH} descriptive characters.`);
+    }
+    else if (title.length > TITLE_MAX_LENGTH) {
+        push('minor', 'title-too-long', `<title> is ${title.length} characters — it will be truncated in search results (~${TITLE_MAX_LENGTH} shown). Shorten it and move detail into the description.`);
+    }
+    if (!metrics.hasDescription) {
+        push('minor', 'missing-meta-description', 'Missing <meta name="description">: search engines will improvise a snippet from page text. Add a 120–160 character summary.');
+    }
+    if (!metrics.hasLang) {
+        push('minor', 'missing-html-lang', 'Missing lang attribute on <html> (e.g. <html lang="en">) — hurts both SEO locale signals and screen-reader pronunciation.');
+    }
+    if (!metrics.hasViewportMeta) {
+        push('major', 'missing-viewport-meta', 'Missing <meta name="viewport">: mobile search ranking and rendering both depend on it. Add content="width=device-width, initial-scale=1".');
+    }
+    if (!metrics.hasCanonical) {
+        push('minor', 'missing-canonical', 'Missing <link rel="canonical">: duplicate URLs (query params, trailing slashes) can split ranking. Point canonical at the clean route URL.');
+    }
+    const missingOg = [
+        !metrics.ogTitle && 'og:title',
+        !metrics.ogDescription && 'og:description',
+        !metrics.ogImage && 'og:image',
+    ].filter(Boolean);
+    if (missingOg.length > 0) {
+        push('minor', 'missing-opengraph', `Missing OpenGraph tags: ${missingOg.join(', ')}. Links shared to Slack/X/LinkedIn will unfurl with no (or scraped) preview. Add the full og: set.`);
+    }
+    for (const id of metrics.duplicateIds.slice(0, 5)) {
+        issues.push(makeIssue({
+            category: 'seo',
+            severity: 'major',
+            type: 'duplicate-id',
+            message: `Duplicate id attribute in the live DOM: #${id} appears more than once. ids must be unique — anchors, aria-labelledby and getElementById all silently target the first match.`,
+            route,
+            viewport,
+            details: { id },
+            selector: `#${id}`,
+        }));
+    }
+    return issues;
+}
+/** In-page probe: metadata facts from the live (post-hydration) DOM. */
+function probeSeo() {
+    const meta = (selector) => Boolean(document.querySelector(selector));
+    const idCounts = new Map();
+    document.querySelectorAll('[id]').forEach((el) => {
+        if (el.id)
+            idCounts.set(el.id, (idCounts.get(el.id) ?? 0) + 1);
+    });
+    return {
+        title: document.title ?? '',
+        hasDescription: meta('meta[name="description"]'),
+        hasLang: (document.documentElement.getAttribute('lang') ?? '').trim().length > 0,
+        hasViewportMeta: meta('meta[name="viewport"]'),
+        hasCanonical: meta('link[rel="canonical"]'),
+        ogTitle: meta('meta[property="og:title"]'),
+        ogDescription: meta('meta[property="og:description"]'),
+        ogImage: meta('meta[property="og:image"]'),
+        duplicateIds: [...idCounts.entries()].filter(([, count]) => count > 1).map(([id]) => id),
+    };
+}
+export class SeoTrap {
+    viewport;
+    constructor(viewport) {
+        this.viewport = viewport;
+    }
+    async collect(page, route) {
+        let metrics;
+        try {
+            metrics = await page.evaluate(probeSeo);
+        }
+        catch {
+            return [];
+        }
+        return evaluateSeoMetrics(metrics, route, this.viewport);
+    }
+}
+//# sourceMappingURL=seo-trap.js.map

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

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

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

@@ -0,0 +1,32 @@
+import type { Page } from 'playwright';
+import { contrastRatio } from './a11y-trap.js';
+import { type ColorScheme, type QAIssue, type ViewportName } from '../types.js';
+/**
+ * Trap 8 — Dark / Light Theme Emulation.
+ *
+ * The page is rendered twice per viewport, once per emulated colour scheme
+ * (`colorScheme: 'light' | 'dark'` media emulation). Under each scheme the
+ * trap recomputes real foreground/background contrast on visible text: the
+ * classic invisible-dark-mode bug (near-black text on a near-black
+ * background when the OS flips to dark) shows up as a theme-contrast
+ * finding tagged with the failing scheme.
+ */
+export interface ThemeContrastFailure {
+    descriptor: string;
+    selector: string;
+    ratio: number;
+    required: number;
+}
+export interface ThemeMetrics {
+    failures: ThemeContrastFailure[];
+}
+export declare const EMPTY_THEME_METRICS: ThemeMetrics;
+export declare function evaluateThemeMetrics(metrics: ThemeMetrics, route: string, viewport: ViewportName, colorScheme: ColorScheme): QAIssue[];
+export declare class ThemeTrap {
+    private readonly viewport;
+    private readonly colorScheme;
+    constructor(viewport: ViewportName, colorScheme: ColorScheme);
+    collect(page: Page, route: string): Promise<QAIssue[]>;
+}
+export { contrastRatio };
+//# sourceMappingURL=theme-trap.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme-trap.d.ts","sourceRoot":"","sources":["../../../src/traps/theme-trap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAa,KAAK,WAAW,EAAE,KAAK,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3F;;;;;;;;;GASG;AACH,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,oBAAoB,EAAE,CAAC;CAClC;AAED,eAAO,MAAM,mBAAmB,EAAE,YAA+B,CAAC;AAElE,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EACrB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,YAAY,EACtB,WAAW,EAAE,WAAW,GACvB,OAAO,EAAE,CAgBX;AAwED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;gBAE9B,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW;IAKtD,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;CAS7D;AAED,OAAO,EAAE,aAAa,EAAE,CAAC"}

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

@@ -0,0 +1,109 @@
+import { contrastRatio } from './a11y-trap.js';
+import { makeIssue } from '../types.js';
+export const EMPTY_THEME_METRICS = { failures: [] };
+export function evaluateThemeMetrics(metrics, route, viewport, colorScheme) {
+    return metrics.failures.slice(0, 5).map((failure) => makeIssue({
+        category: 'theme',
+        severity: 'major',
+        type: 'theme-contrast',
+        message: `Invisible/low-contrast text in ${colorScheme} mode: ${failure.descriptor} has contrast ${failure.ratio}:1 (needs ${failure.required}:1) ` +
+            `when the OS colour scheme is ${colorScheme}. Use theme-aware tokens (CSS variables / dark: variants) instead of hard-coded colours.`,
+        route,
+        viewport,
+        colorScheme,
+        details: { element: failure.descriptor, ratio: failure.ratio, required: failure.required, colorScheme },
+        selector: failure.selector,
+    }));
+}
+/** In-page probe: computed-contrast failures under the emulated scheme. */
+function probeTheme() {
+    const describe = (el) => {
+        const tag = el.tagName.toLowerCase();
+        const id = el.id ? `#${el.id}` : '';
+        const text = (el.textContent ?? '').replace(/\s+/g, ' ').trim().slice(0, 40);
+        return `${tag}${id}${text ? ` "${text}"` : ''}`;
+    };
+    const visible = (el) => {
+        const style = window.getComputedStyle(el);
+        return style.display !== 'none' && style.visibility !== 'hidden';
+    };
+    const parseRgb = (value) => {
+        const match = value.match(/rgba?\(([^)]+)\)/);
+        if (!match)
+            return null;
+        const parts = match[1].split(',').map((p) => Number.parseFloat(p));
+        if (parts.length < 3 || parts.some((n) => Number.isNaN(n)))
+            return null;
+        return [parts[0], parts[1], parts[2], parts.length > 3 ? parts[3] : 1];
+    };
+    const luminance = (rgb) => {
+        const linear = (channel) => {
+            const s = channel / 255;
+            return s <= 0.03928 ? s / 12.92 : Math.pow((s + 0.055) / 1.055, 2.4);
+        };
+        return 0.2126 * linear(rgb[0]) + 0.7152 * linear(rgb[1]) + 0.0722 * linear(rgb[2]);
+    };
+    const effectiveBackground = (el) => {
+        let node = el;
+        while (node) {
+            const bg = parseRgb(window.getComputedStyle(node).backgroundColor);
+            if (bg && bg[3] > 0)
+                return [bg[0], bg[1], bg[2]];
+            node = node.parentElement;
+        }
+        // No painted background anywhere: browsers still paint the default
+        // white canvas (pages that never opt into dark styling render
+        // identically in both schemes). Real dark-mode bugs set a dark
+        // background via media query, which the walk above finds.
+        return [255, 255, 255];
+    };
+    const failures = [];
+    for (const el of Array.from(document.querySelectorAll('body *')).slice(0, 400)) {
+        if (failures.length >= 8)
+            break;
+        const html = el;
+        const ownText = Array.from(html.childNodes).some((n) => n.nodeType === Node.TEXT_NODE && (n.textContent ?? '').trim().length > 0);
+        if (!ownText || !visible(el))
+            continue;
+        const style = window.getComputedStyle(html);
+        const fg = parseRgb(style.color);
+        if (!fg)
+            continue;
+        const bg = effectiveBackground(el);
+        const l1 = luminance([fg[0], fg[1], fg[2]]);
+        const l2 = luminance(bg);
+        const ratio = (Math.max(l1, l2) + 0.05) / (Math.min(l1, l2) + 0.05);
+        const fontSize = Number.parseFloat(style.fontSize) || 16;
+        const bold = Number.parseInt(style.fontWeight, 10) >= 700 || style.fontWeight === 'bold';
+        const required = fontSize >= 24 || (fontSize >= 18.66 && bold) ? 3 : 4.5;
+        if (ratio < required) {
+            failures.push({
+                descriptor: describe(el),
+                selector: describe(el),
+                ratio: Math.round(ratio * 100) / 100,
+                required,
+            });
+        }
+    }
+    return { failures };
+}
+export class ThemeTrap {
+    viewport;
+    colorScheme;
+    constructor(viewport, colorScheme) {
+        this.viewport = viewport;
+        this.colorScheme = colorScheme;
+    }
+    async collect(page, route) {
+        let metrics;
+        try {
+            metrics = await page.evaluate(probeTheme);
+        }
+        catch {
+            return [];
+        }
+        return evaluateThemeMetrics(metrics, route, this.viewport, this.colorScheme);
+    }
+}
+export { contrastRatio };
+//# sourceMappingURL=theme-trap.js.map

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

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