uxinspect 0.2.0 → 0.11.0

package/dist/visual-ssim.js

@@ -0,0 +1,153 @@
+import { readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import path from 'node:path';
+import { PNG } from 'pngjs';
+const K1 = 0.01;
+const K2 = 0.03;
+const L = 255;
+const C1 = (K1 * L) * (K1 * L);
+const C2 = (K2 * L) * (K2 * L);
+const REGION_THRESHOLD = 0.9;
+function toGrayscale(img) {
+    const { width, height, data } = img;
+    const out = new Float64Array(width * height);
+    for (let i = 0, p = 0; p < width * height; p += 1, i += 4) {
+        const r = data[i] ?? 0;
+        const g = data[i + 1] ?? 0;
+        const b = data[i + 2] ?? 0;
+        out[p] = 0.299 * r + 0.587 * g + 0.114 * b;
+    }
+    return out;
+}
+function computeWindow(a, b, width, x0, y0, w, h) {
+    const n = w * h;
+    let sumA = 0, sumB = 0;
+    for (let y = 0; y < h; y += 1) {
+        const row = (y0 + y) * width + x0;
+        for (let x = 0; x < w; x += 1) {
+            sumA += a[row + x] ?? 0;
+            sumB += b[row + x] ?? 0;
+        }
+    }
+    const mA = sumA / n;
+    const mB = sumB / n;
+    let varA = 0, varB = 0, cov = 0;
+    for (let y = 0; y < h; y += 1) {
+        const row = (y0 + y) * width + x0;
+        for (let x = 0; x < w; x += 1) {
+            const va = (a[row + x] ?? 0) - mA;
+            const vb = (b[row + x] ?? 0) - mB;
+            varA += va * va;
+            varB += vb * vb;
+            cov += va * vb;
+        }
+    }
+    varA /= n;
+    varB /= n;
+    cov /= n;
+    const num = (2 * mA * mB + C1) * (2 * cov + C2);
+    const den = (mA * mA + mB * mB + C1) * (varA + varB + C2);
+    return den === 0 ? 1 : num / den;
+}
+function ssimWindows(a, b, width, height, windowSize) {
+    const stats = [];
+    for (let y = 0; y + windowSize <= height; y += windowSize) {
+        for (let x = 0; x + windowSize <= width; x += windowSize) {
+            stats.push({ ssim: computeWindow(a, b, width, x, y, windowSize, windowSize), x, y, w: windowSize, h: windowSize });
+        }
+    }
+    return stats;
+}
+function summarize(stats) {
+    if (stats.length === 0)
+        return { mssim: 1, changedRegions: 0 };
+    let total = 0, changed = 0;
+    for (const s of stats) {
+        total += s.ssim;
+        if (s.ssim < REGION_THRESHOLD)
+            changed += 1;
+    }
+    return { mssim: total / stats.length, changedRegions: changed };
+}
+function writeOverlay(current, stats, outPath) {
+    const { width, height, data } = current;
+    const overlay = new PNG({ width, height });
+    overlay.data = Buffer.from(data);
+    for (const s of stats) {
+        if (s.ssim >= REGION_THRESHOLD)
+            continue;
+        for (let y = s.y; y < s.y + s.h && y < height; y += 1) {
+            for (let x = s.x; x < s.x + s.w && x < width; x += 1) {
+                const idx = (y * width + x) * 4;
+                const alpha = 120 / 255;
+                overlay.data[idx] = Math.round((overlay.data[idx] ?? 0) * (1 - alpha) + 255 * alpha);
+                overlay.data[idx + 1] = Math.round((overlay.data[idx + 1] ?? 0) * (1 - alpha));
+                overlay.data[idx + 2] = Math.round((overlay.data[idx + 2] ?? 0) * (1 - alpha));
+                overlay.data[idx + 3] = 255;
+            }
+        }
+    }
+    mkdirSync(path.dirname(outPath), { recursive: true });
+    writeFileSync(outPath, PNG.sync.write(overlay));
+}
+export async function compareSsim(opts) {
+    const threshold = opts.threshold ?? 0.95;
+    const windowSize = opts.windowSize ?? 11;
+    const base = {
+        page: '',
+        viewport: '',
+        baseline: opts.baselinePath,
+        current: opts.currentPath,
+        diff: opts.diffPath,
+        ssim: 0,
+        mssim: 0,
+        changedRegions: 0,
+        passed: false,
+    };
+    try {
+        const baselineImg = PNG.sync.read(readFileSync(opts.baselinePath));
+        const currentImg = PNG.sync.read(readFileSync(opts.currentPath));
+        if (baselineImg.width !== currentImg.width || baselineImg.height !== currentImg.height) {
+            return {
+                ...base,
+                page: `dimension mismatch ${baselineImg.width}x${baselineImg.height} vs ${currentImg.width}x${currentImg.height}`,
+            };
+        }
+        const grayA = toGrayscale(baselineImg);
+        const grayB = toGrayscale(currentImg);
+        const stats = ssimWindows(grayA, grayB, baselineImg.width, baselineImg.height, windowSize);
+        const { mssim, changedRegions } = summarize(stats);
+        if (opts.diffPath) {
+            writeOverlay(currentImg, stats, opts.diffPath);
+        }
+        return {
+            ...base,
+            ssim: mssim,
+            mssim,
+            changedRegions,
+            passed: mssim >= threshold,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : 'unreadable image';
+        return { ...base, page: `error: ${msg}` };
+    }
+}
+export async function ssimFromBuffers(a, b, opts) {
+    const windowSize = opts?.windowSize ?? 11;
+    try {
+        const imgA = PNG.sync.read(a);
+        const imgB = PNG.sync.read(b);
+        if (imgA.width !== imgB.width || imgA.height !== imgB.height) {
+            return { ssim: 0, mssim: 0, changedRegions: 0 };
+        }
+        const grayA = toGrayscale(imgA);
+        const grayB = toGrayscale(imgB);
+        const stats = ssimWindows(grayA, grayB, imgA.width, imgA.height, windowSize);
+        const { mssim, changedRegions } = summarize(stats);
+        return { ssim: mssim, mssim, changedRegions };
+    }
+    catch {
+        return { ssim: 0, mssim: 0, changedRegions: 0 };
+    }
+}
+//# sourceMappingURL=visual-ssim.js.map

package/dist/visual-ssim.js.map

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

package/dist/watch-mode.d.ts

@@ -0,0 +1,10 @@
+import type { InspectConfig, InspectResult } from './types.js';
+export interface WatchModeOptions {
+    config: InspectConfig;
+    paths: string[];
+    debounceMs?: number;
+    onResult?: (result: InspectResult) => void;
+    onError?: (err: Error) => void;
+}
+export declare function runWatchMode(opts: WatchModeOptions): Promise<() => Promise<void>>;
+//# sourceMappingURL=watch-mode.d.ts.map

package/dist/watch-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-mode.d.ts","sourceRoot":"","sources":["../src/watch-mode.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AA+BD,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAuHvF"}

package/dist/watch-mode.js

@@ -0,0 +1,156 @@
+import { watch } from 'node:fs';
+const IGNORE_SUBSTRINGS = [
+    '/node_modules/',
+    '/.git/',
+    '/dist/',
+    '/uxinspect-report/',
+    '/uxinspect-baselines/',
+    '/uxinspect-smoke-report/',
+];
+const IGNORE_EXTENSIONS = ['.log', '.tmp'];
+function shouldIgnore(filename) {
+    if (!filename)
+        return false;
+    const normalized = filename.replace(/\\/g, '/');
+    const prefixed = normalized.startsWith('/') ? normalized : `/${normalized}`;
+    for (const sub of IGNORE_SUBSTRINGS) {
+        if (prefixed.includes(sub))
+            return true;
+    }
+    for (const ext of IGNORE_EXTENSIONS) {
+        if (normalized.endsWith(ext))
+            return true;
+    }
+    return false;
+}
+function toError(err) {
+    if (err instanceof Error)
+        return err;
+    return new Error(typeof err === 'string' ? err : JSON.stringify(err));
+}
+export async function runWatchMode(opts) {
+    const { config, paths, debounceMs = 500, onResult, onError } = opts;
+    const watchers = [];
+    let debounceTimer = null;
+    let isRunning = false;
+    let queuedRun = false;
+    let stopped = false;
+    let currentRun = null;
+    const handleError = (err) => {
+        const error = toError(err);
+        if (onError) {
+            try {
+                onError(error);
+            }
+            catch {
+                // swallow handler error
+            }
+        }
+        else {
+            process.stdout.write(`[uxinspect:watch] error: ${error.message}\n`);
+        }
+    };
+    const executeRun = async () => {
+        if (stopped)
+            return;
+        isRunning = true;
+        try {
+            process.stdout.write('[uxinspect:watch] change detected, running...\n');
+            const started = Date.now();
+            const { inspect } = await import('./index.js');
+            const result = await inspect(config);
+            const elapsed = Date.now() - started;
+            if (onResult) {
+                try {
+                    onResult(result);
+                }
+                catch (cbErr) {
+                    handleError(cbErr);
+                }
+            }
+            else {
+                process.stdout.write(`[uxinspect:watch] done in ${elapsed}ms — passed=${result.passed}\n`);
+            }
+        }
+        catch (err) {
+            handleError(err);
+        }
+        finally {
+            isRunning = false;
+            if (queuedRun && !stopped) {
+                queuedRun = false;
+                currentRun = executeRun();
+            }
+            else {
+                currentRun = null;
+            }
+        }
+    };
+    const triggerRun = () => {
+        if (stopped)
+            return;
+        if (isRunning) {
+            queuedRun = true;
+            return;
+        }
+        currentRun = executeRun();
+    };
+    const scheduleRun = () => {
+        if (stopped)
+            return;
+        if (debounceTimer)
+            clearTimeout(debounceTimer);
+        debounceTimer = setTimeout(() => {
+            debounceTimer = null;
+            triggerRun();
+        }, debounceMs);
+    };
+    // Initial run before watching.
+    currentRun = executeRun();
+    // Set up watchers.
+    for (const p of paths) {
+        try {
+            const watcher = watch(p, { recursive: true }, (_event, filename) => {
+                if (stopped)
+                    return;
+                if (shouldIgnore(filename))
+                    return;
+                scheduleRun();
+            });
+            watcher.on('error', (err) => {
+                handleError(err);
+            });
+            watchers.push(watcher);
+        }
+        catch (err) {
+            handleError(err);
+        }
+    }
+    const stop = async () => {
+        if (stopped) {
+            if (currentRun)
+                await currentRun.catch(() => undefined);
+            return;
+        }
+        stopped = true;
+        if (debounceTimer) {
+            clearTimeout(debounceTimer);
+            debounceTimer = null;
+        }
+        for (const w of watchers) {
+            try {
+                w.close();
+            }
+            catch {
+                // ignore close errors
+            }
+        }
+        watchers.length = 0;
+        queuedRun = false;
+        if (currentRun) {
+            await currentRun.catch(() => undefined);
+        }
+    };
+    return stop;
+}
+//# sourceMappingURL=watch-mode.js.map

package/dist/watch-mode.js.map

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

package/dist/web-worker-audit.d.ts

@@ -0,0 +1,27 @@
+import type { Page } from 'playwright';
+export interface WebWorkerEntry {
+    url: string;
+    kind: 'worker' | 'shared-worker' | 'service-worker';
+    scope?: string;
+    active: boolean;
+    sizeBytes?: number;
+    messageCount: number;
+    errorCount: number;
+}
+export interface WebWorkerIssue {
+    kind: 'worker-error' | 'long-running-worker' | 'worker-blocking-main' | 'worker-fetch-failed' | 'too-many-workers' | 'no-module-worker';
+    worker: string;
+    message: string;
+}
+export interface WebWorkerAuditResult {
+    page: string;
+    workers: WebWorkerEntry[];
+    issues: WebWorkerIssue[];
+    passed: boolean;
+}
+export interface WebWorkerAuditOptions {
+    durationMs?: number;
+    maxWorkers?: number;
+}
+export declare function auditWebWorkers(page: Page, opts?: WebWorkerAuditOptions): Promise<WebWorkerAuditResult>;
+//# sourceMappingURL=web-worker-audit.d.ts.map

package/dist/web-worker-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-worker-audit.d.ts","sourceRoot":"","sources":["../src/web-worker-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAA8C,MAAM,YAAY,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,GAAG,eAAe,GAAG,gBAAgB,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EACA,cAAc,GACd,qBAAqB,GACrB,sBAAsB,GACtB,qBAAqB,GACrB,kBAAkB,GAClB,kBAAkB,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA0CD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,oBAAoB,CAAC,CAiU/B"}