uxinspect 0.2.0 → 0.11.0

package/dist/har-waterfall.js

@@ -0,0 +1,376 @@
+import { readFile, writeFile } from 'node:fs/promises';
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function asNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+        return value;
+    }
+    return undefined;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+function pickTiming(value) {
+    const n = asNumber(value);
+    if (n === undefined)
+        return undefined;
+    return n < 0 ? undefined : n;
+}
+function parseHarFile(harContent) {
+    const parsed = JSON.parse(harContent);
+    if (!isRecord(parsed))
+        return {};
+    const log = parsed['log'];
+    if (!isRecord(log))
+        return {};
+    const entriesRaw = log['entries'];
+    if (!Array.isArray(entriesRaw))
+        return { log: {} };
+    const entries = entriesRaw.filter(isRecord).map((raw) => {
+        const request = isRecord(raw['request']) ? raw['request'] : {};
+        const response = isRecord(raw['response']) ? raw['response'] : {};
+        const timings = isRecord(raw['timings']) ? raw['timings'] : {};
+        const content = isRecord(response['content']) ? response['content'] : {};
+        return {
+            startedDateTime: asString(raw['startedDateTime']),
+            time: asNumber(raw['time']),
+            request: {
+                method: asString(request['method']),
+                url: asString(request['url']),
+            },
+            response: {
+                status: asNumber(response['status']),
+                bodySize: asNumber(response['bodySize']),
+                content: {
+                    size: asNumber(content['size']),
+                    mimeType: asString(content['mimeType']),
+                },
+            },
+            timings: {
+                blocked: pickTiming(timings['blocked']),
+                dns: pickTiming(timings['dns']),
+                connect: pickTiming(timings['connect']),
+                ssl: pickTiming(timings['ssl']),
+                send: pickTiming(timings['send']),
+                wait: pickTiming(timings['wait']),
+                receive: pickTiming(timings['receive']),
+            },
+        };
+    });
+    return { log: { entries } };
+}
+export function parseHar(harContent) {
+    const har = parseHarFile(harContent);
+    const rawEntries = har.log?.entries ?? [];
+    if (rawEntries.length === 0) {
+        return {
+            entries: [],
+            summary: {
+                totalRequests: 0,
+                totalBytes: 0,
+                firstRequestStart: 0,
+                lastRequestEnd: 0,
+                criticalPathMs: 0,
+            },
+        };
+    }
+    const epochs = rawEntries.map((e) => {
+        const t = Date.parse(e.startedDateTime ?? '');
+        return Number.isFinite(t) ? t : 0;
+    });
+    const earliest = Math.min(...epochs);
+    const entries = rawEntries.map((e, idx) => {
+        const startTimeMs = Math.max(0, (epochs[idx] ?? earliest) - earliest);
+        const durationMs = e.time ?? 0;
+        const contentSize = e.response?.content?.size ?? 0;
+        const bodySize = e.response?.bodySize ?? 0;
+        const sizeBytes = contentSize > 0 ? contentSize : Math.max(0, bodySize);
+        return {
+            url: e.request?.url ?? '',
+            method: (e.request?.method ?? 'GET').toUpperCase(),
+            status: e.response?.status ?? 0,
+            mimeType: e.response?.content?.mimeType ?? '',
+            sizeBytes,
+            startTimeMs,
+            durationMs,
+            timings: {
+                blocked: e.timings?.blocked,
+                dns: e.timings?.dns,
+                connect: e.timings?.connect,
+                ssl: e.timings?.ssl,
+                send: e.timings?.send,
+                wait: e.timings?.wait,
+                receive: e.timings?.receive,
+            },
+        };
+    });
+    const totalBytes = entries.reduce((acc, e) => acc + e.sizeBytes, 0);
+    const firstRequestStart = entries.reduce((min, e) => Math.min(min, e.startTimeMs), Number.POSITIVE_INFINITY);
+    const lastRequestEnd = entries.reduce((max, e) => Math.max(max, e.startTimeMs + e.durationMs), 0);
+    const criticalPathMs = lastRequestEnd - (Number.isFinite(firstRequestStart) ? firstRequestStart : 0);
+    return {
+        entries,
+        summary: {
+            totalRequests: entries.length,
+            totalBytes,
+            firstRequestStart: Number.isFinite(firstRequestStart) ? firstRequestStart : 0,
+            lastRequestEnd,
+            criticalPathMs: Math.max(0, criticalPathMs),
+        },
+    };
+}
+function escapeHtml(input) {
+    return input
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+function formatBytes(bytes) {
+    if (bytes <= 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB'];
+    let value = bytes;
+    let unitIdx = 0;
+    while (value >= 1024 && unitIdx < units.length - 1) {
+        value /= 1024;
+        unitIdx++;
+    }
+    const rounded = value >= 10 ? Math.round(value) : Math.round(value * 10) / 10;
+    return `${rounded} ${units[unitIdx]}`;
+}
+function formatMs(ms) {
+    if (ms < 1)
+        return `${Math.round(ms * 1000) / 1000} ms`;
+    if (ms < 1000)
+        return `${Math.round(ms)} ms`;
+    return `${(ms / 1000).toFixed(2)} s`;
+}
+function statusClass(status) {
+    if (status >= 400 || status === 0)
+        return 'status-err';
+    if (status >= 300)
+        return 'status-warn';
+    if (status >= 200)
+        return 'status-ok';
+    return 'status-info';
+}
+function shortUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const path = parsed.pathname + parsed.search;
+        const name = path.length > 1 ? path : parsed.host;
+        return name.length > 80 ? `${name.slice(0, 77)}...` : name;
+    }
+    catch {
+        return url.length > 80 ? `${url.slice(0, 77)}...` : url;
+    }
+}
+const SEGMENTS = [
+    { key: 'blocked', label: 'Blocked', color: '#94A3B8' },
+    { key: 'dns', label: 'DNS', color: '#8B5CF6' },
+    { key: 'connect', label: 'Connect', color: '#6366F1' },
+    { key: 'ssl', label: 'SSL', color: '#0EA5E9' },
+    { key: 'send', label: 'Send', color: '#10B981' },
+    { key: 'wait', label: 'Wait', color: '#F59E0B' },
+    { key: 'receive', label: 'Receive', color: '#3B82F6' },
+];
+function renderWaterfallBar(entry, totalMs) {
+    const safeTotal = totalMs > 0 ? totalMs : 1;
+    const startPct = (entry.startTimeMs / safeTotal) * 100;
+    const pieces = [];
+    let cursor = entry.startTimeMs;
+    for (const seg of SEGMENTS) {
+        const val = entry.timings[seg.key];
+        if (val === undefined || val <= 0)
+            continue;
+        const left = (cursor / safeTotal) * 100;
+        const width = (val / safeTotal) * 100;
+        pieces.push(`<span class="seg" title="${escapeHtml(seg.label)}: ${formatMs(val)}" style="left:${left.toFixed(3)}%;width:${width.toFixed(3)}%;background:${seg.color};"></span>`);
+        cursor += val;
+    }
+    if (pieces.length === 0) {
+        const width = (entry.durationMs / safeTotal) * 100;
+        pieces.push(`<span class="seg" title="Duration: ${formatMs(entry.durationMs)}" style="left:${startPct.toFixed(3)}%;width:${width.toFixed(3)}%;background:#3B82F6;"></span>`);
+    }
+    return `<div class="bar">${pieces.join('')}</div>`;
+}
+function renderSummaryCards(summary) {
+    const cards = [
+        { label: 'Requests', value: String(summary.totalRequests) },
+        { label: 'Total size', value: formatBytes(summary.totalBytes) },
+        { label: 'Total time', value: formatMs(summary.lastRequestEnd - summary.firstRequestStart) },
+        { label: 'Critical path', value: formatMs(summary.criticalPathMs) },
+    ];
+    return cards
+        .map((c) => `<div class="card"><div class="card-label">${escapeHtml(c.label)}</div><div class="card-value">${escapeHtml(c.value)}</div></div>`)
+        .join('');
+}
+function renderLegend() {
+    return SEGMENTS.map((s) => `<span class="legend-item"><span class="legend-dot" style="background:${s.color}"></span>${escapeHtml(s.label)}</span>`).join('');
+}
+function renderRows(entries, totalMs) {
+    return entries
+        .map((entry, idx) => {
+        const cls = statusClass(entry.status);
+        const urlDisplay = shortUrl(entry.url);
+        const methodCell = escapeHtml(entry.method);
+        const statusCell = entry.status === 0 ? 'ERR' : String(entry.status);
+        return `<tr data-idx="${idx}" data-url="${escapeHtml(entry.url)}" data-method="${methodCell}" data-status="${entry.status}" data-mime="${escapeHtml(entry.mimeType)}" data-size="${entry.sizeBytes}" data-start="${entry.startTimeMs}" data-duration="${entry.durationMs}">
+  <td class="col-idx">${idx + 1}</td>
+  <td class="col-method">${methodCell}</td>
+  <td class="col-status"><span class="status-pill ${cls}">${escapeHtml(statusCell)}</span></td>
+  <td class="col-url" title="${escapeHtml(entry.url)}">${escapeHtml(urlDisplay)}</td>
+  <td class="col-mime">${escapeHtml(entry.mimeType)}</td>
+  <td class="col-size">${escapeHtml(formatBytes(entry.sizeBytes))}</td>
+  <td class="col-duration">${escapeHtml(formatMs(entry.durationMs))}</td>
+  <td class="col-wf">${renderWaterfallBar(entry, totalMs)}</td>
+</tr>`;
+    })
+        .join('\n');
+}
+const STYLES = `
+:root { color-scheme: light; }
+* { box-sizing: border-box; }
+body { margin: 0; font-family: Inter, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, sans-serif; background: #FAFAFA; color: #1D1D1F; font-size: 13px; }
+.container { max-width: 1400px; margin: 0 auto; padding: 24px; }
+h1 { font-size: 20px; font-weight: 600; margin: 0 0 4px; letter-spacing: -0.01em; }
+.subtitle { color: #6B7280; font-size: 13px; margin-bottom: 24px; }
+.cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(180px, 1fr)); gap: 12px; margin-bottom: 20px; }
+.card { background: #FFFFFF; border: 1px solid #E5E7EB; border-radius: 8px; padding: 14px 16px; box-shadow: 0 1px 2px rgba(17,24,39,0.04); }
+.card-label { font-size: 11px; color: #6B7280; text-transform: uppercase; letter-spacing: 0.04em; margin-bottom: 6px; }
+.card-value { font-size: 20px; font-weight: 600; color: #1D1D1F; }
+.legend { display: flex; flex-wrap: wrap; gap: 14px; align-items: center; background: #FFFFFF; border: 1px solid #E5E7EB; border-radius: 8px; padding: 10px 14px; margin-bottom: 16px; }
+.legend-item { display: inline-flex; align-items: center; gap: 6px; font-size: 12px; color: #4B5563; }
+.legend-dot { width: 10px; height: 10px; border-radius: 2px; display: inline-block; }
+.table-wrap { background: #FFFFFF; border: 1px solid #E5E7EB; border-radius: 8px; overflow: hidden; box-shadow: 0 1px 2px rgba(17,24,39,0.04); }
+table { width: 100%; border-collapse: collapse; table-layout: fixed; }
+thead th { background: #F9FAFB; border-bottom: 1px solid #E5E7EB; text-align: left; font-size: 11px; text-transform: uppercase; letter-spacing: 0.04em; color: #6B7280; font-weight: 600; padding: 10px 12px; cursor: pointer; user-select: none; white-space: nowrap; }
+thead th.sortable:hover { background: #F3F4F6; color: #1D1D1F; }
+thead th .sort-ind { font-size: 10px; color: #9CA3AF; margin-left: 4px; }
+thead th[data-sorted="asc"] .sort-ind::before { content: "\\25B2"; color: #10B981; }
+thead th[data-sorted="desc"] .sort-ind::before { content: "\\25BC"; color: #10B981; }
+tbody td { padding: 9px 12px; border-bottom: 1px solid #F3F4F6; font-size: 12px; vertical-align: middle; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+tbody tr:last-child td { border-bottom: none; }
+tbody tr:hover { background: #FAFAFA; }
+.col-idx { width: 40px; color: #9CA3AF; }
+.col-method { width: 70px; font-family: ui-monospace, SFMono-Regular, Menlo, monospace; font-size: 11px; color: #4B5563; }
+.col-status { width: 72px; }
+.col-url { max-width: 0; }
+.col-mime { width: 140px; color: #6B7280; font-size: 11px; }
+.col-size { width: 80px; text-align: right; font-variant-numeric: tabular-nums; color: #4B5563; }
+.col-duration { width: 90px; text-align: right; font-variant-numeric: tabular-nums; color: #4B5563; }
+.col-wf { width: 40%; padding: 6px 12px; }
+.status-pill { display: inline-block; padding: 2px 8px; border-radius: 10px; font-size: 11px; font-weight: 600; font-variant-numeric: tabular-nums; }
+.status-ok { background: #ECFDF5; color: #047857; border: 1px solid #A7F3D0; }
+.status-warn { background: #FEF3C7; color: #92400E; border: 1px solid #FDE68A; }
+.status-err { background: #FEE2E2; color: #B91C1C; border: 1px solid #FECACA; }
+.status-info { background: #EFF6FF; color: #1D4ED8; border: 1px solid #BFDBFE; }
+.bar { position: relative; height: 14px; background: #F3F4F6; border-radius: 3px; overflow: hidden; }
+.seg { position: absolute; top: 0; bottom: 0; border-radius: 1px; }
+.empty { padding: 48px; text-align: center; color: #6B7280; }
+footer { margin-top: 16px; text-align: right; color: #9CA3AF; font-size: 11px; }
+`;
+const SCRIPT = `
+(function(){
+  var table = document.querySelector('table');
+  if (!table) return;
+  var headers = table.querySelectorAll('th.sortable');
+  var tbody = table.tBodies[0];
+  if (!tbody) return;
+  var originalRows = Array.prototype.slice.call(tbody.rows);
+  var activeKey = null;
+  var activeDir = 'asc';
+  function getVal(row, key, type) {
+    var v = row.getAttribute('data-' + key) || '';
+    if (type === 'num') { var n = parseFloat(v); return isNaN(n) ? 0 : n; }
+    return v.toLowerCase();
+  }
+  function clearIndicators() {
+    for (var i = 0; i < headers.length; i++) headers[i].removeAttribute('data-sorted');
+  }
+  function sortBy(key, type, dir) {
+    var rows = Array.prototype.slice.call(tbody.rows);
+    rows.sort(function(a, b) {
+      var av = getVal(a, key, type); var bv = getVal(b, key, type);
+      if (av < bv) return dir === 'asc' ? -1 : 1;
+      if (av > bv) return dir === 'asc' ? 1 : -1;
+      return 0;
+    });
+    for (var i = 0; i < rows.length; i++) tbody.appendChild(rows[i]);
+  }
+  function resetOrder() {
+    for (var i = 0; i < originalRows.length; i++) tbody.appendChild(originalRows[i]);
+  }
+  for (var i = 0; i < headers.length; i++) {
+    (function(h){
+      h.addEventListener('click', function(){
+        var key = h.getAttribute('data-key');
+        var type = h.getAttribute('data-type') || 'str';
+        if (!key) return;
+        if (activeKey === key) {
+          if (activeDir === 'asc') { activeDir = 'desc'; }
+          else { activeKey = null; activeDir = 'asc'; clearIndicators(); resetOrder(); return; }
+        } else {
+          activeKey = key; activeDir = 'asc';
+        }
+        clearIndicators();
+        h.setAttribute('data-sorted', activeDir);
+        sortBy(activeKey, type, activeDir);
+      });
+    })(headers[i]);
+  }
+})();
+`;
+export function renderWaterfallHtml(report, opts) {
+    const title = opts?.title ?? 'HAR waterfall';
+    const totalMs = Math.max(1, report.summary.lastRequestEnd);
+    const body = report.entries.length === 0
+        ? '<div class="empty">No requests found in HAR file.</div>'
+        : `<div class="table-wrap"><table>
+<colgroup>
+<col style="width:40px"><col style="width:70px"><col style="width:72px"><col><col style="width:140px"><col style="width:80px"><col style="width:90px"><col style="width:40%">
+</colgroup>
+<thead><tr>
+<th class="sortable" data-key="idx" data-type="num">#<span class="sort-ind"></span></th>
+<th class="sortable" data-key="method" data-type="str">Method<span class="sort-ind"></span></th>
+<th class="sortable" data-key="status" data-type="num">Status<span class="sort-ind"></span></th>
+<th class="sortable" data-key="url" data-type="str">URL<span class="sort-ind"></span></th>
+<th class="sortable" data-key="mime" data-type="str">Type<span class="sort-ind"></span></th>
+<th class="sortable" data-key="size" data-type="num">Size<span class="sort-ind"></span></th>
+<th class="sortable" data-key="duration" data-type="num">Time<span class="sort-ind"></span></th>
+<th class="sortable" data-key="start" data-type="num">Waterfall<span class="sort-ind"></span></th>
+</tr></thead>
+<tbody>
+${renderRows(report.entries, totalMs)}
+</tbody></table></div>`;
+    return `<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width,initial-scale=1">
+<title>${escapeHtml(title)}</title>
+<style>${STYLES}</style>
+</head>
+<body>
+<div class="container">
+<h1>${escapeHtml(title)}</h1>
+<div class="subtitle">${report.summary.totalRequests} requests - ${escapeHtml(formatBytes(report.summary.totalBytes))} - ${escapeHtml(formatMs(report.summary.criticalPathMs))} critical path</div>
+<div class="cards">${renderSummaryCards(report.summary)}</div>
+<div class="legend">${renderLegend()}</div>
+${body}
+<footer>Generated by uxinspect - har-waterfall</footer>
+</div>
+<script>${SCRIPT}</script>
+</body>
+</html>`;
+}
+export async function writeWaterfallHtml(harPath, outPath, opts) {
+    const content = await readFile(harPath, 'utf8');
+    const report = parseHar(content);
+    const html = renderWaterfallHtml(report, opts);
+    await writeFile(outPath, html, 'utf8');
+}
+//# sourceMappingURL=har-waterfall.js.map

package/dist/har-waterfall.js.map

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

package/dist/heading-hierarchy.d.ts

@@ -0,0 +1,20 @@
+import type { Page } from 'playwright';
+export interface HeadingInfo {
+    level: number;
+    text: string;
+    target: string;
+}
+export interface HeadingIssue {
+    type: 'no-h1' | 'multiple-h1' | 'skip-level' | 'empty-heading' | 'heading-out-of-order' | 'heading-inside-button';
+    detail: string;
+    target?: string;
+}
+export interface HeadingHierarchyResult {
+    page: string;
+    headings: HeadingInfo[];
+    h1Count: number;
+    issues: HeadingIssue[];
+    passed: boolean;
+}
+export declare function auditHeadings(page: Page): Promise<HeadingHierarchyResult>;
+//# sourceMappingURL=heading-hierarchy.d.ts.map

package/dist/heading-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heading-hierarchy.d.ts","sourceRoot":"","sources":["../src/heading-hierarchy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EACA,OAAO,GACP,aAAa,GACb,YAAY,GACZ,eAAe,GACf,sBAAsB,GACtB,uBAAuB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;CACjB;AAUD,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAiI/E"}

package/dist/heading-hierarchy.js

@@ -0,0 +1,112 @@
+export async function auditHeadings(page) {
+    const url = page.url();
+    const collected = await page.evaluate(() => {
+        const truncate = (s, max) => {
+            const trimmed = s.replace(/\s+/g, ' ').trim();
+            return trimmed.length > max ? trimmed.slice(0, max - 1) + '\u2026' : trimmed;
+        };
+        const shortSelector = (el) => {
+            const tag = el.tagName.toLowerCase();
+            if (el.id) {
+                const safeId = el.id.replace(/(["\\])/g, '\\$1');
+                return `${tag}#${safeId}`;
+            }
+            const cls = (el.getAttribute('class') || '').trim().split(/\s+/).filter(Boolean);
+            if (cls.length > 0) {
+                return `${tag}.${cls[0]}`;
+            }
+            const role = el.getAttribute('role');
+            if (role)
+                return `${tag}[role="${role}"]`;
+            const parent = el.parentElement;
+            if (!parent)
+                return tag;
+            const siblings = Array.from(parent.children).filter((c) => c.tagName === el.tagName);
+            if (siblings.length === 1)
+                return tag;
+            const idx = siblings.indexOf(el) + 1;
+            return `${tag}:nth-of-type(${idx})`;
+        };
+        const nodes = Array.from(document.querySelectorAll('h1, h2, h3, h4, h5, h6, [role="heading"][aria-level]'));
+        const results = [];
+        for (const el of nodes) {
+            const tag = el.tagName.toLowerCase();
+            let level = null;
+            const role = el.getAttribute('role');
+            if (role === 'heading') {
+                const ariaLevel = el.getAttribute('aria-level');
+                if (ariaLevel) {
+                    const parsed = parseInt(ariaLevel, 10);
+                    if (!Number.isNaN(parsed) && parsed >= 1 && parsed <= 6) {
+                        level = parsed;
+                    }
+                }
+            }
+            if (level === null && /^h[1-6]$/.test(tag)) {
+                level = parseInt(tag.slice(1), 10);
+            }
+            if (level === null)
+                continue;
+            const text = truncate(el.textContent || '', 120);
+            const target = shortSelector(el);
+            const hasAriaLabel = !!(el.getAttribute('aria-label') || '').trim();
+            let insideButton = false;
+            let cur = el;
+            while (cur) {
+                const ct = cur.tagName.toLowerCase();
+                const cr = cur.getAttribute('role');
+                if (ct === 'button' || cr === 'button') {
+                    insideButton = true;
+                    break;
+                }
+                cur = cur.parentElement;
+            }
+            results.push({ level, text, target, hasAriaLabel, insideButton });
+        }
+        return results;
+    });
+    const headings = collected.map((h) => ({
+        level: h.level,
+        text: h.text,
+        target: h.target,
+    }));
+    const issues = [];
+    const h1Count = collected.filter((h) => h.level === 1).length;
+    if (h1Count === 0) {
+        issues.push({ type: 'no-h1', detail: 'Page has no h1 heading.' });
+    }
+    else if (h1Count > 1) {
+        issues.push({
+            type: 'multiple-h1',
+            detail: `Page has ${h1Count} h1 headings; expected exactly one.`,
+        });
+    }
+    let prevLevel = null;
+    for (const h of collected) {
+        if (h.text.length === 0 && !h.hasAriaLabel) {
+            issues.push({
+                type: 'empty-heading',
+                detail: `Heading h${h.level} has no text content or aria-label.`,
+                target: h.target,
+            });
+        }
+        if (h.insideButton) {
+            issues.push({
+                type: 'heading-inside-button',
+                detail: `Heading h${h.level} is nested inside a button, which breaks semantic structure.`,
+                target: h.target,
+            });
+        }
+        if (prevLevel !== null && h.level > prevLevel + 1) {
+            issues.push({
+                type: 'skip-level',
+                detail: `Heading jumps from h${prevLevel} to h${h.level} (skipped ${h.level - prevLevel - 1} level(s)).`,
+                target: h.target,
+            });
+        }
+        prevLevel = h.level;
+    }
+    const passed = issues.length === 0;
+    return { page: url, headings, h1Count, issues, passed };
+}
+//# sourceMappingURL=heading-hierarchy.js.map

package/dist/heading-hierarchy.js.map

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

package/dist/headless-detect.d.ts

@@ -0,0 +1,22 @@
+import type { Page } from 'playwright';
+export type BotBlockType = 'captcha-present' | 'cloudflare-challenge' | 'perimeter-x' | 'datadome' | 'akamai-bot-manager' | 'ua-sniffing' | 'webdriver-check' | 'automation-flag-check';
+export interface BotBlockSignal {
+    type: BotBlockType;
+    evidence: string;
+}
+export type HeadlessIssueType = 'site-blocks-headless' | 'site-fingerprints';
+export interface HeadlessIssue {
+    type: HeadlessIssueType;
+    detail: string;
+}
+export interface HeadlessDetectResult {
+    page: string;
+    botBlockSignals: BotBlockSignal[];
+    fingerprintingApis: string[];
+    headlessUaInDocument: boolean;
+    challengePagesDetected: boolean;
+    issues: HeadlessIssue[];
+    passed: boolean;
+}
+export declare function auditHeadlessDetect(page: Page): Promise<HeadlessDetectResult>;
+//# sourceMappingURL=headless-detect.d.ts.map

package/dist/headless-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headless-detect.d.ts","sourceRoot":"","sources":["../src/headless-detect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,YAAY,GACpB,iBAAiB,GACjB,sBAAsB,GACtB,aAAa,GACb,UAAU,GACV,oBAAoB,GACpB,aAAa,GACb,iBAAiB,GACjB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sBAAsB,EAAE,OAAO,CAAC;IAChC,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;CACjB;AAaD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA6LnF"}