uxinspect 0.2.0 → 0.11.0

package/dist/pr-comment.js

@@ -0,0 +1,316 @@
+const DEFAULT_MAX_FAILURES = 10;
+const TOOL_NAME = 'uxinspect';
+const COLOR_PASS = '#10B981';
+const COLOR_FAIL = '#EF4444';
+const COLLAPSE_THRESHOLD = 5;
+function countA11yByImpact(a11y, impact) {
+    if (!a11y)
+        return 0;
+    let total = 0;
+    for (const page of a11y) {
+        for (const v of page.violations) {
+            if (v.impact === impact)
+                total += 1;
+        }
+    }
+    return total;
+}
+function average(values) {
+    if (values.length === 0)
+        return null;
+    let sum = 0;
+    for (const v of values)
+        sum += v;
+    return sum / values.length;
+}
+function perfAverage(result, pick) {
+    const perf = result.perf;
+    if (!perf || perf.length === 0)
+        return null;
+    const vals = [];
+    for (const p of perf) {
+        const v = pick(p.metrics);
+        if (typeof v === 'number' && Number.isFinite(v))
+            vals.push(v);
+    }
+    return average(vals);
+}
+function brokenLinkCount(result) {
+    if (!Array.isArray(result.links))
+        return 0;
+    let count = 0;
+    for (const item of result.links) {
+        count += Array.isArray(item.broken) ? item.broken.length : 0;
+    }
+    return count;
+}
+function consoleErrorCount(result) {
+    if (!Array.isArray(result.consoleErrors))
+        return 0;
+    let count = 0;
+    for (const entry of result.consoleErrors) {
+        count += typeof entry.errorCount === 'number' ? entry.errorCount : 0;
+    }
+    return count;
+}
+function computeMetrics(result) {
+    const flowsTotal = result.flows.length;
+    const flowsPassed = result.flows.filter((f) => f.passed).length;
+    return {
+        flowsTotal,
+        flowsPassed,
+        flowsFailed: flowsTotal - flowsPassed,
+        a11yCritical: countA11yByImpact(result.a11y, 'critical'),
+        a11ySerious: countA11yByImpact(result.a11y, 'serious'),
+        visualDiffs: (result.visual ?? []).filter((v) => !v.passed).length,
+        lcpAvg: perfAverage(result, (m) => m.lcp),
+        clsAvg: perfAverage(result, (m) => m.cls),
+        brokenLinks: brokenLinkCount(result),
+        consoleErrors: consoleErrorCount(result),
+    };
+}
+function truncate(s, n) {
+    if (s.length <= n)
+        return s;
+    return s.slice(0, Math.max(0, n - 3)) + '...';
+}
+function oneLine(s) {
+    return s.replace(/\s+/g, ' ').trim();
+}
+function collectFailures(result, max) {
+    const out = [];
+    if (max <= 0)
+        return out;
+    const push = (entry) => {
+        out.push(entry);
+        return out.length >= max;
+    };
+    for (const f of result.flows) {
+        if (f.passed)
+            continue;
+        const reason = f.error ? ` - ${oneLine(f.error)}` : '';
+        if (push({ category: 'flow', line: `Flow failed: ${f.name}${reason}` }))
+            return out;
+    }
+    for (const page of result.a11y ?? []) {
+        if (page.passed)
+            continue;
+        for (const v of page.violations) {
+            if (v.impact !== 'critical')
+                continue;
+            if (push({
+                category: 'a11y',
+                line: `a11y critical: ${v.id} - ${oneLine(v.help)} (${page.page})`,
+            }))
+                return out;
+        }
+    }
+    for (const v of result.visual ?? []) {
+        if (v.passed)
+            continue;
+        const pct = (v.diffRatio * 100).toFixed(2);
+        if (push({
+            category: 'visual',
+            line: `Visual diff: ${v.page} @ ${v.viewport} - diffRatio ${pct}% (${v.diffPixels}px)`,
+        }))
+            return out;
+    }
+    for (const entry of result.links ?? []) {
+        for (const link of entry.broken ?? []) {
+            if (push({
+                category: 'link',
+                line: `Broken link: ${link.url} -> ${link.status} (${entry.page})`,
+            }))
+                return out;
+        }
+    }
+    return out;
+}
+function formatLcp(ms) {
+    return ms === null ? 'n/a' : `${Math.round(ms)}ms`;
+}
+function formatCls(v) {
+    return v === null ? 'n/a' : v.toFixed(3);
+}
+function signedInt(n) {
+    if (n === 0)
+        return '0';
+    return n > 0 ? `+${n}` : `${n}`;
+}
+function signedMs(n) {
+    const r = Math.round(n);
+    if (r === 0)
+        return '0ms';
+    return r > 0 ? `+${r}ms` : `${r}ms`;
+}
+function signedCls(n) {
+    if (Math.abs(n) < 0.001)
+        return '0';
+    return n > 0 ? `+${n.toFixed(3)}` : n.toFixed(3);
+}
+function diffDeltas(current, previous) {
+    const a = computeMetrics(current);
+    const b = computeMetrics(previous);
+    const lines = [];
+    if (a.lcpAvg !== null && b.lcpAvg !== null) {
+        const d = a.lcpAvg - b.lcpAvg;
+        if (Math.round(d) !== 0)
+            lines.push(`LCP ${signedMs(d)}`);
+    }
+    if (a.clsAvg !== null && b.clsAvg !== null) {
+        const d = a.clsAvg - b.clsAvg;
+        if (Math.abs(d) >= 0.001)
+            lines.push(`CLS ${signedCls(d)}`);
+    }
+    if (a.a11yCritical !== b.a11yCritical) {
+        lines.push(`a11y criticals ${signedInt(a.a11yCritical - b.a11yCritical)}`);
+    }
+    if (a.a11ySerious !== b.a11ySerious) {
+        lines.push(`a11y serious ${signedInt(a.a11ySerious - b.a11ySerious)}`);
+    }
+    if (a.visualDiffs !== b.visualDiffs) {
+        lines.push(`visual diffs ${signedInt(a.visualDiffs - b.visualDiffs)}`);
+    }
+    if (a.flowsFailed !== b.flowsFailed) {
+        lines.push(`flow failures ${signedInt(a.flowsFailed - b.flowsFailed)}`);
+    }
+    if (a.brokenLinks !== b.brokenLinks) {
+        lines.push(`broken links ${signedInt(a.brokenLinks - b.brokenLinks)}`);
+    }
+    if (a.consoleErrors !== b.consoleErrors) {
+        lines.push(`console errors ${signedInt(a.consoleErrors - b.consoleErrors)}`);
+    }
+    return lines;
+}
+function statusWord(passed) {
+    return passed ? 'PASS' : 'FAIL';
+}
+function summaryRows(m) {
+    return [
+        ['Flows', `${m.flowsPassed}/${m.flowsTotal} passed`],
+        ['a11y criticals', `${m.a11yCritical}`],
+        ['a11y serious', `${m.a11ySerious}`],
+        ['Visual diffs', `${m.visualDiffs}`],
+        ['LCP avg', formatLcp(m.lcpAvg)],
+        ['CLS avg', formatCls(m.clsAvg)],
+        ['Broken links', `${m.brokenLinks}`],
+        ['Console errors', `${m.consoleErrors}`],
+    ];
+}
+function buildBody(result, opts, spec) {
+    const max = opts.maxFailures ?? DEFAULT_MAX_FAILURES;
+    const includeSummary = opts.includeSummary !== false;
+    const metrics = computeMetrics(result);
+    const pass = result.passed;
+    const word = statusWord(pass);
+    const lines = [];
+    lines.push(...spec.header(pass, word));
+    lines.push('');
+    if (includeSummary) {
+        lines.push(...spec.summary(metrics));
+        lines.push('');
+    }
+    if (opts.compareTo) {
+        const deltas = diffDeltas(result, opts.compareTo);
+        if (deltas.length > 0) {
+            lines.push('### Regression deltas');
+            lines.push('');
+            for (const d of deltas)
+                lines.push(`- ${d}`);
+            lines.push('');
+        }
+    }
+    const failures = collectFailures(result, max);
+    if (failures.length > 0) {
+        lines.push(...spec.failures(failures));
+        lines.push('');
+    }
+    if (opts.reportUrl) {
+        lines.push(`View full report: ${opts.reportUrl}`);
+    }
+    return lines.join('\n').replace(/\n{3,}/g, '\n\n').trimEnd() + '\n';
+}
+function tableSummary(m) {
+    const out = ['| Metric | Value |', '| --- | --- |'];
+    for (const [k, v] of summaryRows(m))
+        out.push(`| ${k} | ${v} |`);
+    return out;
+}
+function bulletSummary(m) {
+    const out = ['**Summary**', ''];
+    for (const [k, v] of summaryRows(m))
+        out.push(`- **${k}:** ${v}`);
+    return out;
+}
+function plainFailureList(items) {
+    const out = [`### Top failures (${items.length})`, ''];
+    for (const f of items)
+        out.push(`- ${truncate(f.line, 400)}`);
+    return out;
+}
+function bulletFailureList(items) {
+    const out = [`**Top failures (${items.length})**`, ''];
+    for (const f of items)
+        out.push(`- ${truncate(f.line, 400)}`);
+    return out;
+}
+export function renderGithubComment(result, opts = {}) {
+    return buildBody(result, opts, {
+        header: (pass, word) => {
+            const color = pass ? COLOR_PASS : COLOR_FAIL;
+            return [
+                `## ${TOOL_NAME} &mdash; <span style="color:${color}">${word}</span>`,
+            ];
+        },
+        summary: tableSummary,
+        failures: (items) => {
+            if (items.length <= COLLAPSE_THRESHOLD)
+                return plainFailureList(items);
+            const out = [`### Top failures (${items.length})`, ''];
+            out.push('<details><summary>Show failures</summary>');
+            out.push('');
+            for (const f of items)
+                out.push(`- ${truncate(f.line, 400)}`);
+            out.push('');
+            out.push('</details>');
+            return out;
+        },
+    });
+}
+export function renderGitlabComment(result, opts = {}) {
+    return buildBody(result, opts, {
+        header: (_pass, word) => [
+            `## ${TOOL_NAME} -- ${word}`,
+            '',
+            `> Status: ${word}`,
+        ],
+        summary: tableSummary,
+        failures: plainFailureList,
+    });
+}
+export function renderBitbucketComment(result, opts = {}) {
+    return buildBody(result, opts, {
+        header: (_pass, word) => [
+            `## ${TOOL_NAME} -- ${word}`,
+            '',
+            `**Status:** ${word}`,
+        ],
+        summary: bulletSummary,
+        failures: bulletFailureList,
+    });
+}
+export function toPrComment(result, flavor, opts) {
+    switch (flavor) {
+        case 'github':
+            return renderGithubComment(result, opts);
+        case 'gitlab':
+            return renderGitlabComment(result, opts);
+        case 'bitbucket':
+            return renderBitbucketComment(result, opts);
+        default: {
+            const exhaustive = flavor;
+            throw new Error(`Unknown flavor: ${String(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=pr-comment.js.map

package/dist/pr-comment.js.map

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

package/dist/precommit.d.ts

@@ -0,0 +1,24 @@
+export interface PrecommitInstallOptions {
+    repoRoot?: string;
+    url?: string;
+    configPath?: string;
+    checks?: string[];
+    blocking?: boolean;
+    onlyIfPathsMatch?: string[];
+    timeoutMs?: number;
+    force?: boolean;
+}
+export interface PrecommitInstallResult {
+    installed: boolean;
+    hookPath: string;
+    backupPath?: string;
+    alreadyManaged: boolean;
+    error?: string;
+}
+export declare function generateHookScript(opts?: PrecommitInstallOptions): Promise<string>;
+export declare function installPrecommit(opts?: PrecommitInstallOptions): Promise<PrecommitInstallResult>;
+export declare function uninstallPrecommit(repoRoot?: string): Promise<{
+    removed: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=precommit.d.ts.map

package/dist/precommit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precommit.d.ts","sourceRoot":"","sources":["../src/precommit.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4GD,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,uBAA4B,GAAG,OAAO,CAAC,MAAM,CAAC,CA2B5F;AAoBD,wBAAsB,gBAAgB,CACpC,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,sBAAsB,CAAC,CAsDjC;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiC/C"}

package/dist/precommit.js

@@ -0,0 +1,239 @@
+import { access, chmod, constants, mkdir, readdir, readFile, rename, stat, unlink, writeFile } from 'node:fs/promises';
+import { dirname, join, resolve } from 'node:path';
+import { execFile } from 'node:child_process';
+const MARKER = '# uxinspect-managed pre-commit hook (do not edit this marker line)';
+const BACKUP_PREFIX = 'pre-commit.uxinspect-backup-';
+async function pathExists(p) {
+    try {
+        await access(p, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findGitDir(start) {
+    let current = resolve(start);
+    while (true) {
+        const candidate = join(current, '.git');
+        if (await pathExists(candidate)) {
+            const st = await stat(candidate);
+            if (st.isDirectory())
+                return candidate;
+            if (st.isFile()) {
+                const txt = await readFile(candidate, 'utf8');
+                const m = txt.match(/^gitdir:\s*(.+)\s*$/m);
+                if (m) {
+                    const gd = m[1];
+                    const resolved = gd.startsWith('/') ? gd : resolve(current, gd);
+                    if (await pathExists(resolved))
+                        return resolved;
+                }
+            }
+        }
+        const parent = dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+}
+function runGit(args, cwd, timeoutMs) {
+    return new Promise((resolvePromise) => {
+        execFile('git', args, { cwd, timeout: timeoutMs, windowsHide: true }, (err, stdout) => {
+            if (err) {
+                resolvePromise('');
+                return;
+            }
+            resolvePromise(stdout.toString().trim());
+        });
+    });
+}
+async function resolveHooksDir(repoRoot, gitDir) {
+    const custom = await runGit(['config', '--get', 'core.hooksPath'], repoRoot, 5000);
+    if (custom) {
+        return custom.startsWith('/') ? custom : resolve(repoRoot, custom);
+    }
+    return join(gitDir, 'hooks');
+}
+function regexEscape(literal) {
+    return literal.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+}
+function globToRegex(glob) {
+    let out = '';
+    let i = 0;
+    while (i < glob.length) {
+        const ch = glob[i];
+        if (ch === '*') {
+            if (glob[i + 1] === '*') {
+                out += '.*';
+                i += 2;
+                if (glob[i] === '/')
+                    i += 1;
+                continue;
+            }
+            out += '[^/]*';
+            i += 1;
+            continue;
+        }
+        if (ch === '?') {
+            out += '[^/]';
+            i += 1;
+            continue;
+        }
+        if (ch === '/') {
+            out += '/';
+            i += 1;
+            continue;
+        }
+        out += regexEscape(ch);
+        i += 1;
+    }
+    return out;
+}
+function buildCliArgs(opts) {
+    const parts = [];
+    if (opts.url)
+        parts.push(shellQuote(opts.url));
+    if (opts.configPath)
+        parts.push('--config', shellQuote(opts.configPath));
+    if (opts.checks && opts.checks.length > 0) {
+        parts.push('--checks', shellQuote(opts.checks.join(',')));
+    }
+    return parts.join(' ');
+}
+function shellQuote(value) {
+    if (/^[A-Za-z0-9_./:=@-]+$/.test(value))
+        return value;
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+export async function generateHookScript(opts = {}) {
+    const timeoutMs = opts.timeoutMs ?? 60_000;
+    const timeoutS = Math.max(1, Math.floor(timeoutMs / 1000));
+    const patterns = opts.onlyIfPathsMatch ?? [];
+    const patternsJoined = patterns.join('|');
+    const regex = patterns.length > 0 ? patterns.map(globToRegex).join('|') : '';
+    const cliArgs = buildCliArgs(opts);
+    const blocking = opts.blocking !== false;
+    const blockingExit = blocking ? 'exit $EXIT' : 'echo "warning only"';
+    const lines = [];
+    lines.push('#!/usr/bin/env bash');
+    lines.push(MARKER);
+    lines.push('set -e');
+    lines.push('# only run if staged files match patterns');
+    lines.push(`if [ -n "${patternsJoined}" ]; then`);
+    lines.push(`  matched=$(git diff --cached --name-only | grep -E ${shellQuote(regex)} || true)`);
+    lines.push('  [ -z "$matched" ] && exit 0');
+    lines.push('fi');
+    lines.push(`timeout ${timeoutS} npx uxinspect ${cliArgs} || EXIT=$?`);
+    lines.push('if [ "${EXIT:-0}" != "0" ]; then');
+    lines.push('  echo "uxinspect pre-commit check failed (exit $EXIT)"');
+    lines.push(`  ${blockingExit}`);
+    lines.push('fi');
+    lines.push('exit 0');
+    lines.push('');
+    return lines.join('\n');
+}
+async function readHookIfExists(hookPath) {
+    try {
+        return await readFile(hookPath, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function isManaged(contents) {
+    return contents.includes(MARKER);
+}
+function timestampTag() {
+    const d = new Date();
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}-${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}`;
+}
+export async function installPrecommit(opts = {}) {
+    const repoRoot = resolve(opts.repoRoot ?? process.cwd());
+    const gitDir = await findGitDir(repoRoot);
+    if (!gitDir) {
+        return {
+            installed: false,
+            hookPath: '',
+            alreadyManaged: false,
+            error: 'no .git directory found walking up from repoRoot',
+        };
+    }
+    const hooksDir = await resolveHooksDir(repoRoot, gitDir);
+    const hookPath = join(hooksDir, 'pre-commit');
+    try {
+        await mkdir(hooksDir, { recursive: true });
+        const existing = await readHookIfExists(hookPath);
+        let backupPath;
+        let alreadyManaged = false;
+        if (existing !== undefined) {
+            if (isManaged(existing)) {
+                alreadyManaged = true;
+            }
+            else if (!opts.force) {
+                return {
+                    installed: false,
+                    hookPath,
+                    alreadyManaged: false,
+                    error: 'existing hook present; use force',
+                };
+            }
+            else {
+                backupPath = join(hooksDir, `${BACKUP_PREFIX}${timestampTag()}`);
+                await rename(hookPath, backupPath);
+            }
+        }
+        const script = await generateHookScript(opts);
+        await writeFile(hookPath, script, 'utf8');
+        await chmod(hookPath, 0o755);
+        return {
+            installed: true,
+            hookPath,
+            backupPath,
+            alreadyManaged,
+        };
+    }
+    catch (err) {
+        return {
+            installed: false,
+            hookPath,
+            alreadyManaged: false,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+export async function uninstallPrecommit(repoRoot) {
+    const root = resolve(repoRoot ?? process.cwd());
+    const gitDir = await findGitDir(root);
+    if (!gitDir) {
+        return { removed: false, error: 'no .git directory found walking up from repoRoot' };
+    }
+    try {
+        const hooksDir = await resolveHooksDir(root, gitDir);
+        const hookPath = join(hooksDir, 'pre-commit');
+        const existing = await readHookIfExists(hookPath);
+        let removed = false;
+        if (existing !== undefined && isManaged(existing)) {
+            await unlink(hookPath);
+            removed = true;
+        }
+        const entries = await readdir(hooksDir).catch(() => []);
+        const backups = entries
+            .filter((e) => e.startsWith(BACKUP_PREFIX))
+            .sort()
+            .reverse();
+        if (backups.length > 0) {
+            const latest = join(hooksDir, backups[0]);
+            if (!(await pathExists(hookPath))) {
+                await rename(latest, hookPath);
+                removed = true;
+            }
+        }
+        return { removed };
+    }
+    catch (err) {
+        return { removed: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+//# sourceMappingURL=precommit.js.map

package/dist/precommit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precommit.js","sourceRoot":"","sources":["../src/precommit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAqB9C,MAAM,MAAM,GAAG,oEAAoE,CAAC;AACpF,MAAM,aAAa,GAAG,8BAA8B,CAAC;AAErD,KAAK,UAAU,UAAU,CAAC,CAAS;IACjC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,KAAa;IACrC,IAAI,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAChC,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,EAAE,CAAC,WAAW,EAAE;gBAAE,OAAO,SAAS,CAAC;YACvC,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC;gBAChB,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9C,MAAM,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;gBAC5C,IAAI,CAAC,EAAE,CAAC;oBACN,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBAChB,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;oBAChE,IAAI,MAAM,UAAU,CAAC,QAAQ,CAAC;wBAAE,OAAO,QAAQ,CAAC;gBAClD,CAAC;YACH,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,MAAM,KAAK,OAAO;YAAE,OAAO,SAAS,CAAC;QACzC,OAAO,GAAG,MAAM,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,IAAc,EAAE,GAAW,EAAE,SAAiB;IAC5D,OAAO,IAAI,OAAO,CAAC,CAAC,cAAc,EAAE,EAAE;QACpC,QAAQ,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;YACpF,IAAI,GAAG,EAAE,CAAC;gBACR,cAAc,CAAC,EAAE,CAAC,CAAC;gBACnB,OAAO;YACT,CAAC;YACD,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,MAAc;IAC7D,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,gBAAgB,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnF,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAAC,OAAe;IAClC,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;gBACxB,GAAG,IAAI,IAAI,CAAC;gBACZ,CAAC,IAAI,CAAC,CAAC;gBACP,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG;oBAAE,CAAC,IAAI,CAAC,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,GAAG,IAAI,OAAO,CAAC;YACf,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,GAAG,IAAI,MAAM,CAAC;YACd,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,IAAI,EAAE,KAAK,GAAG,EAAE,CAAC;YACf,GAAG,IAAI,GAAG,CAAC;YACX,CAAC,IAAI,CAAC,CAAC;YACP,SAAS;QACX,CAAC;QACD,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;QACvB,CAAC,IAAI,CAAC,CAAC;IACT,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,IAA6B;IACjD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,CAAC,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,IAAI,IAAI,CAAC,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACzE,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,IAAI,uBAAuB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACtD,OAAO,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAAgC,EAAE;IACzE,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,MAAM,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,gBAAgB,IAAI,EAAE,CAAC;IAC7C,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7E,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC;IACzC,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAErE,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IAClC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACnB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACxD,KAAK,CAAC,IAAI,CAAC,YAAY,cAAc,WAAW,CAAC,CAAC;IAClD,KAAK,CAAC,IAAI,CAAC,uDAAuD,UAAU,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAChG,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;IAC5C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,kBAAkB,OAAO,aAAa,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IACtE,KAAK,CAAC,IAAI,CAAC,KAAK,YAAY,EAAE,CAAC,CAAC;IAChC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjB,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS,CAAC,QAAgB;IACjC,OAAO,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC;IACrB,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,CAAC,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC,EAAE,CAAC;AAC5J,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgC,EAAE;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ,EAAE,EAAE;YACZ,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE,kDAAkD;SAC1D,CAAC;IACJ,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,UAA8B,CAAC;QACnC,IAAI,cAAc,GAAG,KAAK,CAAC;QAE3B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC3B,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACxB,cAAc,GAAG,IAAI,CAAC;YACxB,CAAC;iBAAM,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACvB,OAAO;oBACL,SAAS,EAAE,KAAK;oBAChB,QAAQ;oBACR,cAAc,EAAE,KAAK;oBACrB,KAAK,EAAE,kCAAkC;iBAC1C,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,aAAa,GAAG,YAAY,EAAE,EAAE,CAAC,CAAC;gBACjE,MAAM,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC,IAAI,CAAC,CAAC;QAC9C,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE7B,OAAO;YACL,SAAS,EAAE,IAAI;YACf,QAAQ;YACR,UAAU;YACV,cAAc;SACf,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,SAAS,EAAE,KAAK;YAChB,QAAQ;YACR,cAAc,EAAE,KAAK;YACrB,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACxD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAiB;IAEjB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;IACvF,CAAC;IACD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAClD,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,IAAI,QAAQ,KAAK,SAAS,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClD,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAc,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,OAAO;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;aAC1C,IAAI,EAAE;aACN,OAAO,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;YAC1C,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;gBAClC,MAAM,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;gBAC/B,OAAO,GAAG,IAAI,CAAC;YACjB,CAAC;QACH,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;IACrF,CAAC;AACH,CAAC"}

package/dist/prerender-audit.d.ts

@@ -0,0 +1,22 @@
+import type { Page } from 'playwright';
+export type PrerenderIssueType = 'csr-only' | 'empty-noscript-shell' | 'hydration-mismatch-risk' | 'missing-h1-in-raw' | 'missing-main-in-raw';
+export interface PrerenderIssue {
+    type: PrerenderIssueType;
+    detail: string;
+}
+export interface PrerenderAuditResult {
+    page: string;
+    rawHtmlSize: number;
+    hydratedHtmlSize: number;
+    textVisibleInRaw: number;
+    textVisibleAfterHydration: number;
+    textRatio: number;
+    framework?: string;
+    isSPA: boolean;
+    rawHasH1: boolean;
+    rawHasMain: boolean;
+    issues: PrerenderIssue[];
+    passed: boolean;
+}
+export declare function auditPrerender(page: Page): Promise<PrerenderAuditResult>;
+//# sourceMappingURL=prerender-audit.d.ts.map

package/dist/prerender-audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prerender-audit.d.ts","sourceRoot":"","sources":["../src/prerender-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,kBAAkB,GAC1B,UAAU,GACV,sBAAsB,GACtB,yBAAyB,GACzB,mBAAmB,GACnB,qBAAqB,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,yBAAyB,EAAE,MAAM,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,cAAc,EAAE,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;CACjB;AA6GD,wBAAsB,cAAc,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAuF9E"}