uxinspect 0.2.0 → 0.11.0

package/dist/css-coverage.js

@@ -0,0 +1,91 @@
+const DEFAULT_THRESHOLD = 0.5;
+const TOP_N = 30;
+function emptyResult(pageUrl, passed) {
+    return {
+        page: pageUrl,
+        totalBytes: 0,
+        usedBytes: 0,
+        unusedBytes: 0,
+        unusedRatio: 0,
+        byFile: [],
+        passed,
+    };
+}
+export async function auditCssCoverage(page, opts) {
+    const pageUrl = page.url();
+    const threshold = opts?.threshold ?? DEFAULT_THRESHOLD;
+    const pageWithCoverage = page;
+    const coverage = pageWithCoverage.coverage;
+    if (!coverage || typeof coverage.startCSSCoverage !== 'function' || typeof coverage.stopCSSCoverage !== 'function') {
+        return emptyResult(pageUrl, true);
+    }
+    try {
+        await coverage.startCSSCoverage({ resetOnNavigation: false });
+    }
+    catch {
+        return emptyResult(pageUrl, true);
+    }
+    try {
+        await page.reload({ waitUntil: 'networkidle' });
+    }
+    catch {
+        try {
+            await coverage.stopCSSCoverage();
+        }
+        catch {
+            /* ignore */
+        }
+        return emptyResult(pageUrl, true);
+    }
+    let entries;
+    try {
+        entries = await coverage.stopCSSCoverage();
+    }
+    catch {
+        return emptyResult(pageUrl, true);
+    }
+    const merged = new Map();
+    for (const entry of entries) {
+        if (!entry.url || entry.url.startsWith('data:'))
+            continue;
+        const total = entry.text?.length ?? 0;
+        let used = 0;
+        for (const range of entry.ranges) {
+            const len = Math.max(0, range.end - range.start);
+            used += len;
+        }
+        if (total > 0 && used > total)
+            used = total;
+        const prev = merged.get(entry.url);
+        if (prev) {
+            merged.set(entry.url, { total: prev.total + total, used: prev.used + used });
+        }
+        else {
+            merged.set(entry.url, { total, used });
+        }
+    }
+    let totalBytes = 0;
+    let usedBytes = 0;
+    const files = [];
+    for (const [url, { total, used }] of merged) {
+        totalBytes += total;
+        usedBytes += used;
+        const unusedRatio = total > 0 ? Math.max(0, (total - used) / total) : 0;
+        files.push({ url, total, used, unusedRatio });
+    }
+    files.sort((a, b) => b.unusedRatio - a.unusedRatio);
+    const byFile = files.slice(0, TOP_N);
+    const unusedBytes = Math.max(0, totalBytes - usedBytes);
+    const unusedRatio = totalBytes > 0 ? unusedBytes / totalBytes : 0;
+    const passed = unusedRatio <= threshold;
+    return {
+        page: pageUrl,
+        totalBytes,
+        usedBytes,
+        unusedBytes,
+        unusedRatio,
+        byFile,
+        passed,
+    };
+}
+//# sourceMappingURL=css-coverage.js.map

package/dist/css-coverage.js.map

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

package/dist/csv-exporter.d.ts

@@ -0,0 +1,34 @@
+import type { InspectResult } from './types.js';
+export interface CsvOptions {
+    delimiter?: string;
+    lineEnding?: '\n' | '\r\n';
+    header?: boolean;
+}
+interface ResolvedCsvOptions {
+    delimiter: string;
+    lineEnding: '\n' | '\r\n';
+    header: boolean;
+}
+type CsvCell = string | number | boolean | null | undefined;
+declare function resolve(opts: CsvOptions | undefined): ResolvedCsvOptions;
+declare function escapeCell(value: CsvCell, delimiter: string): string;
+declare function toRow(cells: CsvCell[], delimiter: string): string;
+declare function avg(values: number[]): string;
+declare function stepLabel(step: unknown): string;
+export declare function flowsToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function a11yToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function perfToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function visualToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function linksToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function consoleErrorsToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function summaryToCsv(result: InspectResult, opts?: CsvOptions): string;
+export declare function writeAllCsvs(result: InspectResult, outDir: string, opts?: CsvOptions): Promise<string[]>;
+export declare const __internal: {
+    escapeCell: typeof escapeCell;
+    toRow: typeof toRow;
+    avg: typeof avg;
+    stepLabel: typeof stepLabel;
+    resolve: typeof resolve;
+};
+export {};
+//# sourceMappingURL=csv-exporter.d.ts.map

package/dist/csv-exporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv-exporter.d.ts","sourceRoot":"","sources":["../src/csv-exporter.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,UAAU,kBAAkB;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,KAAK,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AAE5D,iBAAS,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,SAAS,GAAG,kBAAkB,CAMjE;AAED,iBAAS,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAe7D;AAED,iBAAS,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE1D;AAaD,iBAAS,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAKrC;AAED,iBAAS,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAMxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAkB3E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAU1E;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CA8B1E;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAQ5E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,CAAC,EAAE,UAAU,GAAG,MAAM,CAc3E;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,UAAU,GAChB,MAAM,CAUR;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,aAAa,EACrB,IAAI,CAAC,EAAE,UAAU,GAChB,MAAM,CAkER;AAUD,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB;AAGD,eAAO,MAAM,UAAU;;;;;;CAAiD,CAAC"}

package/dist/csv-exporter.js

@@ -0,0 +1,241 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+function resolve(opts) {
+    return {
+        delimiter: opts?.delimiter ?? ',',
+        lineEnding: opts?.lineEnding ?? '\n',
+        header: opts?.header !== false,
+    };
+}
+function escapeCell(value, delimiter) {
+    if (value === null || value === undefined)
+        return '';
+    if (typeof value === 'number') {
+        if (!Number.isFinite(value))
+            return '';
+        return String(value);
+    }
+    if (typeof value === 'boolean')
+        return value ? 'true' : 'false';
+    const s = String(value);
+    const needsQuote = s.includes(delimiter) ||
+        s.includes('"') ||
+        s.includes('\n') ||
+        s.includes('\r');
+    if (!needsQuote)
+        return s;
+    return `"${s.replace(/"/g, '""')}"`;
+}
+function toRow(cells, delimiter) {
+    return cells.map((c) => escapeCell(c, delimiter)).join(delimiter);
+}
+function serialize(headerRow, rows, opts) {
+    const lines = [];
+    if (opts.header)
+        lines.push(toRow(headerRow, opts.delimiter));
+    for (const r of rows)
+        lines.push(toRow(r, opts.delimiter));
+    return lines.join(opts.lineEnding) + (lines.length > 0 ? opts.lineEnding : '');
+}
+function avg(values) {
+    const valid = values.filter((v) => typeof v === 'number' && Number.isFinite(v));
+    if (valid.length === 0)
+        return '';
+    const sum = valid.reduce((a, b) => a + b, 0);
+    return (sum / valid.length).toFixed(2);
+}
+function stepLabel(step) {
+    if (step && typeof step === 'object') {
+        const keys = Object.keys(step);
+        if (keys.length > 0)
+            return keys[0];
+    }
+    return 'step';
+}
+export function flowsToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = ['name', 'passed', 'steps', 'durationMs', 'error'];
+    const rows = [];
+    for (const f of result.flows ?? []) {
+        const durationMs = (f.steps ?? []).reduce((sum, s) => sum + (typeof s.durationMs === 'number' ? s.durationMs : 0), 0);
+        rows.push([
+            f.name,
+            f.passed,
+            (f.steps ?? []).length,
+            durationMs,
+            f.error ?? '',
+        ]);
+    }
+    return serialize(header, rows, o);
+}
+export function a11yToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = ['page', 'id', 'impact', 'description', 'helpUrl'];
+    const rows = [];
+    for (const r of result.a11y ?? []) {
+        for (const v of r.violations ?? []) {
+            rows.push([r.page, v.id, v.impact, v.description, v.helpUrl]);
+        }
+    }
+    return serialize(header, rows, o);
+}
+export function perfToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = [
+        'page',
+        'performance',
+        'accessibility',
+        'bestPractices',
+        'seo',
+        'lcp',
+        'fcp',
+        'cls',
+        'tbt',
+        'si',
+    ];
+    const rows = [];
+    for (const p of result.perf ?? []) {
+        rows.push([
+            p.page,
+            p.scores?.performance,
+            p.scores?.accessibility,
+            p.scores?.bestPractices,
+            p.scores?.seo,
+            p.metrics?.lcp,
+            p.metrics?.fcp,
+            p.metrics?.cls,
+            p.metrics?.tbt,
+            p.metrics?.si,
+        ]);
+    }
+    return serialize(header, rows, o);
+}
+export function visualToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = ['page', 'viewport', 'diffPixels', 'diffRatio', 'passed'];
+    const rows = [];
+    for (const v of result.visual ?? []) {
+        rows.push([v.page, v.viewport, v.diffPixels, v.diffRatio, v.passed]);
+    }
+    return serialize(header, rows, o);
+}
+export function linksToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = ['page', 'url', 'status', 'ok'];
+    const rows = [];
+    for (const link of result.links ?? []) {
+        for (const broken of link.broken ?? []) {
+            const ok = typeof broken.status === 'number' &&
+                broken.status >= 200 &&
+                broken.status < 400;
+            rows.push([link.page, broken.url, broken.status, ok]);
+        }
+    }
+    return serialize(header, rows, o);
+}
+export function consoleErrorsToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = ['page', 'type', 'message'];
+    const rows = [];
+    for (const c of result.consoleErrors ?? []) {
+        for (const issue of c.issues ?? []) {
+            rows.push([c.page, issue.type, issue.message]);
+        }
+    }
+    return serialize(header, rows, o);
+}
+export function summaryToCsv(result, opts) {
+    const o = resolve(opts);
+    const header = [
+        'url',
+        'startedAt',
+        'passed',
+        'durationMs',
+        'flowsTotal',
+        'flowsFailed',
+        'a11yCritical',
+        'a11ySerious',
+        'lcpAvg',
+        'clsAvg',
+        'visualDiffs',
+        'brokenLinks',
+        'consoleErrors',
+    ];
+    const flows = result.flows ?? [];
+    const flowsTotal = flows.length;
+    const flowsFailed = flows.filter((f) => !f.passed).length;
+    let a11yCritical = 0;
+    let a11ySerious = 0;
+    for (const r of result.a11y ?? []) {
+        for (const v of r.violations ?? []) {
+            if (v.impact === 'critical')
+                a11yCritical += 1;
+            else if (v.impact === 'serious')
+                a11ySerious += 1;
+        }
+    }
+    const perf = result.perf ?? [];
+    const lcpAvg = avg(perf.map((p) => p.metrics?.lcp ?? NaN));
+    const clsAvg = avg(perf.map((p) => p.metrics?.cls ?? NaN));
+    const visualDiffs = (result.visual ?? []).filter((v) => !v.passed || v.diffPixels > 0).length;
+    let brokenLinks = 0;
+    for (const link of result.links ?? []) {
+        brokenLinks += (link.broken ?? []).length;
+    }
+    let consoleErrorCount = 0;
+    for (const c of result.consoleErrors ?? []) {
+        consoleErrorCount += c.errorCount ?? 0;
+    }
+    const row = [
+        result.url,
+        result.startedAt,
+        result.passed,
+        result.durationMs,
+        flowsTotal,
+        flowsFailed,
+        a11yCritical,
+        a11ySerious,
+        lcpAvg,
+        clsAvg,
+        visualDiffs,
+        brokenLinks,
+        consoleErrorCount,
+    ];
+    return serialize(header, [row], o);
+}
+function hasBodyRows(csv, opts) {
+    if (!csv)
+        return false;
+    const parts = csv.split(opts.lineEnding).filter((l) => l.length > 0);
+    if (parts.length === 0)
+        return false;
+    if (opts.header)
+        return parts.length > 1;
+    return parts.length > 0;
+}
+export async function writeAllCsvs(result, outDir, opts) {
+    const o = resolve(opts);
+    await mkdir(outDir, { recursive: true });
+    const sections = [
+        { name: 'flows.csv', csv: flowsToCsv(result, opts) },
+        { name: 'a11y.csv', csv: a11yToCsv(result, opts) },
+        { name: 'perf.csv', csv: perfToCsv(result, opts) },
+        { name: 'visual.csv', csv: visualToCsv(result, opts) },
+        { name: 'links.csv', csv: linksToCsv(result, opts) },
+        { name: 'console-errors.csv', csv: consoleErrorsToCsv(result, opts) },
+        { name: 'summary.csv', csv: summaryToCsv(result, opts), always: true },
+    ];
+    const written = [];
+    for (const s of sections) {
+        const include = s.always === true || hasBodyRows(s.csv, o);
+        if (!include)
+            continue;
+        const path = join(outDir, s.name);
+        await writeFile(path, s.csv, 'utf8');
+        written.push(path);
+    }
+    return written;
+}
+// internal exports used by tests / adjacent tooling
+export const __internal = { escapeCell, toRow, avg, stepLabel, resolve };
+//# sourceMappingURL=csv-exporter.js.map

package/dist/csv-exporter.js.map

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

package/dist/dark-mode-audit.d.ts

@@ -0,0 +1,31 @@
+import type { Page, BrowserContext } from 'playwright';
+export interface DarkModeIssue {
+    type: 'no-color-scheme-meta' | 'no-media-query-support' | 'visually-identical' | 'contrast-regression' | 'hardcoded-color' | 'missing-theme-color-dark';
+    severity: 'warn' | 'error';
+    selector?: string;
+    detail: string;
+}
+export interface DarkModeResult {
+    page: string;
+    supportsColorScheme: boolean;
+    hasColorSchemeMeta: boolean;
+    hasThemeColorLight: boolean;
+    hasThemeColorDark: boolean;
+    lightScreenshot?: string;
+    darkScreenshot?: string;
+    pixelDiffRatio: number;
+    contrastRegressions: Array<{
+        selector: string;
+        lightRatio: number;
+        darkRatio: number;
+    }>;
+    issues: DarkModeIssue[];
+    passed: boolean;
+}
+export interface DarkModeAuditOptions {
+    screenshotDir?: string;
+    sampleSelectors?: string[];
+}
+export type DarkModeContext = BrowserContext;
+export declare function auditDarkMode(page: Page, opts?: DarkModeAuditOptions): Promise<DarkModeResult>;
+//# sourceMappingURL=dark-mode-audit.d.ts.map

package/dist/dark-mode-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dark-mode-audit.d.ts","sourceRoot":"","sources":["../src/dark-mode-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EACA,sBAAsB,GACtB,wBAAwB,GACxB,oBAAoB,GACpB,qBAAqB,GACrB,iBAAiB,GACjB,0BAA0B,CAAC;IAC/B,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxF,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAGD,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AA8J7C,wBAAsB,aAAa,CACjC,IAAI,EAAE,IAAI,EACV,IAAI,CAAC,EAAE,oBAAoB,GAC1B,OAAO,CAAC,cAAc,CAAC,CA2EzB"}

package/dist/dark-mode-audit.js

@@ -0,0 +1,236 @@
+import { promises as fs } from 'node:fs';
+import path from 'node:path';
+const DEFAULT_SELECTORS = ['body', 'main', 'h1', 'p', 'a', 'button'];
+const PIXEL_DIFF_THRESHOLD = 0.02;
+const WCAG_AA_NORMAL = 4.5;
+const HARDCODED_LIMIT = 20;
+function parseColor(input) {
+    const s = input.trim().toLowerCase();
+    if (!s || s === 'transparent' || s === 'currentcolor')
+        return null;
+    const rgb = s.match(/^rgba?\s*\(\s*([\d.]+)[ ,]+([\d.]+)[ ,]+([\d.]+)(?:[ ,/]+([\d.%]+))?\s*\)$/);
+    if (rgb) {
+        const a = rgb[4] === undefined ? 1 : rgb[4].endsWith('%') ? Number(rgb[4].slice(0, -1)) / 100 : Number(rgb[4]);
+        return [Number(rgb[1]), Number(rgb[2]), Number(rgb[3]), a];
+    }
+    const hex = s.match(/^#([0-9a-f]{3,8})$/);
+    if (!hex)
+        return null;
+    const h = hex[1];
+    const expand = (i, n) => parseInt(h.slice(i, i + n).padEnd(2, h.slice(i, i + n)), 16);
+    if (h.length === 3 || h.length === 4) {
+        const a = h.length === 4 ? parseInt(h[3] + h[3], 16) / 255 : 1;
+        return [expand(0, 1), expand(1, 1), expand(2, 1), a];
+    }
+    if (h.length === 6 || h.length === 8) {
+        const a = h.length === 8 ? parseInt(h.slice(6, 8), 16) / 255 : 1;
+        return [parseInt(h.slice(0, 2), 16), parseInt(h.slice(2, 4), 16), parseInt(h.slice(4, 6), 16), a];
+    }
+    return null;
+}
+function relLum(c) {
+    const v = c / 255;
+    return v <= 0.03928 ? v / 12.92 : Math.pow((v + 0.055) / 1.055, 2.4);
+}
+function luminance(rgb) {
+    return 0.2126 * relLum(rgb[0]) + 0.7152 * relLum(rgb[1]) + 0.0722 * relLum(rgb[2]);
+}
+function contrastRatio(fgStr, bgStr) {
+    const fg = parseColor(fgStr);
+    const bg = parseColor(bgStr);
+    if (!fg || !bg)
+        return null;
+    const a = fg[3];
+    const blended = a < 1
+        ? [fg[0] * a + bg[0] * (1 - a), fg[1] * a + bg[1] * (1 - a), fg[2] * a + bg[2] * (1 - a)]
+        : [fg[0], fg[1], fg[2]];
+    const l1 = luminance(blended);
+    const l2 = luminance([bg[0], bg[1], bg[2]]);
+    const hi = Math.max(l1, l2);
+    const lo = Math.min(l1, l2);
+    return (hi + 0.05) / (lo + 0.05);
+}
+function diffRatio(a, b) {
+    if (a.length === 0 || b.length === 0)
+        return 0;
+    const len = Math.min(a.length, b.length);
+    let sampled = 0;
+    let diff = 0;
+    for (let i = 0; i < len; i += 8) {
+        sampled += 1;
+        if (a[i] !== b[i])
+            diff += 1;
+    }
+    return sampled === 0 ? 0 : diff / sampled;
+}
+async function scanMeta(page) {
+    return await page.evaluate(() => {
+        const cs = document.querySelector('meta[name="color-scheme"]');
+        const themes = Array.from(document.querySelectorAll('meta[name="theme-color"]'));
+        let hasLight = false;
+        let hasDark = false;
+        for (const m of themes) {
+            const media = (m.getAttribute('media') ?? '').toLowerCase();
+            if (media.includes('prefers-color-scheme: dark'))
+                hasDark = true;
+            else
+                hasLight = true;
+        }
+        return { hasColorSchemeMeta: cs !== null, hasThemeColorLight: hasLight, hasThemeColorDark: hasDark };
+    });
+}
+async function scanStylesheets(page) {
+    return await page.evaluate((limit) => {
+        let supportsColorScheme = false;
+        const hardcoded = [];
+        const commonRx = /(^|[\s,>+~])(html|body|main|a|p|h[1-6])(\s*[,{:.#\[]|$)/i;
+        const literalRx = /#[0-9a-f]{3,8}\b|\brgba?\s*\(/i;
+        const varRx = /\bvar\s*\(\s*--/i;
+        function inspect(rule) {
+            if (hardcoded.length >= limit)
+                return;
+            const sel = rule.selectorText || '';
+            if (!commonRx.test(sel))
+                return;
+            const style = rule.style;
+            const candidates = [
+                style.getPropertyValue('color').trim(),
+                style.getPropertyValue('background-color').trim(),
+                style.getPropertyValue('background').trim(),
+            ].filter(v => v.length > 0);
+            for (const value of candidates) {
+                if (varRx.test(value))
+                    continue;
+                if (literalRx.test(value)) {
+                    hardcoded.push({ selector: sel, detail: `literal color in rule: ${value.slice(0, 80)}` });
+                    break;
+                }
+            }
+        }
+        function walk(rules) {
+            if (!rules)
+                return;
+            for (let i = 0; i < rules.length; i += 1) {
+                const rule = rules[i];
+                if (rule instanceof CSSMediaRule) {
+                    const text = (rule.conditionText || rule.media.mediaText || '').toLowerCase();
+                    if (text.includes('prefers-color-scheme: dark'))
+                        supportsColorScheme = true;
+                    walk(rule.cssRules);
+                    continue;
+                }
+                if (rule instanceof CSSStyleRule) {
+                    inspect(rule);
+                    continue;
+                }
+                const nested = rule;
+                if (nested.cssRules)
+                    walk(nested.cssRules);
+            }
+        }
+        for (const sheet of Array.from(document.styleSheets)) {
+            try {
+                walk(sheet.cssRules);
+            }
+            catch { /* cross-origin */ }
+        }
+        return { supportsColorScheme, hardcodedRules: hardcoded };
+    }, HARDCODED_LIMIT);
+}
+async function readSelectorColors(page, selectors) {
+    return await page.evaluate((sels) => {
+        function effectiveBg(el) {
+            let cur = el;
+            while (cur) {
+                const bg = window.getComputedStyle(cur).backgroundColor;
+                if (bg && bg !== 'rgba(0, 0, 0, 0)' && bg !== 'transparent')
+                    return bg;
+                cur = cur.parentElement;
+            }
+            return window.getComputedStyle(document.documentElement).backgroundColor || 'rgb(255, 255, 255)';
+        }
+        return sels.map(sel => {
+            try {
+                const el = document.querySelector(sel);
+                if (!el)
+                    return { selector: sel, found: false, fg: '', bg: '' };
+                const cs = window.getComputedStyle(el);
+                return { selector: sel, found: true, fg: cs.color, bg: effectiveBg(el) };
+            }
+            catch {
+                return { selector: sel, found: false, fg: '', bg: '' };
+            }
+        });
+    }, selectors);
+}
+export async function auditDarkMode(page, opts) {
+    const url = page.url();
+    const sampleSelectors = opts?.sampleSelectors ?? DEFAULT_SELECTORS;
+    const issues = [];
+    const meta = await scanMeta(page);
+    const styles = await scanStylesheets(page);
+    await page.emulateMedia({ colorScheme: 'light' });
+    const lightBytes = await page.screenshot({ type: 'png', fullPage: false });
+    const lightColors = await readSelectorColors(page, sampleSelectors);
+    await page.emulateMedia({ colorScheme: 'dark' });
+    const darkBytes = await page.screenshot({ type: 'png', fullPage: false });
+    const darkColors = await readSelectorColors(page, sampleSelectors);
+    let lightScreenshot;
+    let darkScreenshot;
+    if (opts?.screenshotDir) {
+        await fs.mkdir(opts.screenshotDir, { recursive: true });
+        lightScreenshot = path.join(opts.screenshotDir, 'dark-mode-light.png');
+        darkScreenshot = path.join(opts.screenshotDir, 'dark-mode-dark.png');
+        await fs.writeFile(lightScreenshot, lightBytes);
+        await fs.writeFile(darkScreenshot, darkBytes);
+    }
+    const pixelDiffRatio = diffRatio(lightBytes, darkBytes);
+    await page.emulateMedia({ colorScheme: null });
+    if (!meta.hasColorSchemeMeta) {
+        issues.push({ type: 'no-color-scheme-meta', severity: 'warn', detail: 'Missing <meta name="color-scheme">; browsers cannot pre-style scrollbars or form controls.' });
+    }
+    if (!styles.supportsColorScheme) {
+        issues.push({ type: 'no-media-query-support', severity: 'error', detail: 'No @media (prefers-color-scheme: dark) rules found in any same-origin stylesheet.' });
+    }
+    if (meta.hasThemeColorLight && !meta.hasThemeColorDark) {
+        issues.push({ type: 'missing-theme-color-dark', severity: 'warn', detail: 'theme-color defined for light only; add a media="(prefers-color-scheme: dark)" variant.' });
+    }
+    if (styles.supportsColorScheme && pixelDiffRatio < PIXEL_DIFF_THRESHOLD) {
+        issues.push({ type: 'visually-identical', severity: 'warn', detail: `Light vs dark differ by only ${(pixelDiffRatio * 100).toFixed(2)}%; dark mode rules may not actually apply.` });
+    }
+    for (const rule of styles.hardcodedRules) {
+        issues.push({ type: 'hardcoded-color', severity: 'warn', selector: rule.selector, detail: rule.detail });
+    }
+    const contrastRegressions = [];
+    for (let i = 0; i < sampleSelectors.length; i += 1) {
+        const sel = sampleSelectors[i];
+        const light = lightColors[i];
+        const dark = darkColors[i];
+        if (!light?.found || !dark?.found)
+            continue;
+        const lightRatio = contrastRatio(light.fg, light.bg);
+        const darkRatio = contrastRatio(dark.fg, dark.bg);
+        if (lightRatio === null || darkRatio === null)
+            continue;
+        if (darkRatio < lightRatio && darkRatio < WCAG_AA_NORMAL) {
+            const lr = Number(lightRatio.toFixed(2));
+            const dr = Number(darkRatio.toFixed(2));
+            contrastRegressions.push({ selector: sel, lightRatio: lr, darkRatio: dr });
+            issues.push({ type: 'contrast-regression', severity: 'error', selector: sel, detail: `Contrast drops from ${lr} (light) to ${dr} (dark); below WCAG AA 4.5:1.` });
+        }
+    }
+    return {
+        page: url,
+        supportsColorScheme: styles.supportsColorScheme,
+        hasColorSchemeMeta: meta.hasColorSchemeMeta,
+        hasThemeColorLight: meta.hasThemeColorLight,
+        hasThemeColorDark: meta.hasThemeColorDark,
+        lightScreenshot,
+        darkScreenshot,
+        pixelDiffRatio: Number(pixelDiffRatio.toFixed(4)),
+        contrastRegressions,
+        issues,
+        passed: issues.every(i => i.severity !== 'error'),
+    };
+}
+//# sourceMappingURL=dark-mode-audit.js.map