uxinspect 0.2.0 → 0.11.0

package/dist/structured-data.js

@@ -0,0 +1,164 @@
+const REQUIRED_PROPS = {
+    Article: ['headline', 'author', 'datePublished'],
+    NewsArticle: ['headline', 'author', 'datePublished'],
+    BlogPosting: ['headline', 'author', 'datePublished'],
+    Product: ['name', 'image', 'offers'],
+    Organization: ['name', 'url'],
+    Event: ['name', 'startDate', 'location'],
+    Recipe: ['name', 'recipeIngredient', 'recipeInstructions'],
+    WebSite: ['name', 'url'],
+};
+const DUPLICATE_WARN_TYPES = new Set(['Product', 'Article', 'NewsArticle']);
+const HREFLANG_RE = /^(x-default|[a-z]{2}(-[A-Z]{2})?)$/;
+function processObject(obj, items, issues) {
+    if (!('@context' in obj)) {
+        issues.push({ level: 'error', type: 'missing-context', message: 'JSON-LD object missing @context' });
+    }
+    if (!('@type' in obj)) {
+        issues.push({ level: 'error', type: 'missing-type', message: 'JSON-LD object missing @type' });
+        items.push({ format: 'json-ld', type: 'Unknown', raw: obj });
+        return;
+    }
+    const type = String(obj['@type']);
+    items.push({ format: 'json-ld', type, raw: obj });
+    const required = REQUIRED_PROPS[type];
+    if (required) {
+        for (const prop of required) {
+            if (!(prop in obj) || obj[prop] === null || obj[prop] === undefined) {
+                issues.push({
+                    level: 'error',
+                    type: 'missing-required-property',
+                    message: `${type} missing required property: ${prop}`,
+                });
+            }
+        }
+    }
+    if (type === 'BreadcrumbList') {
+        const list = obj['itemListElement'];
+        if (!Array.isArray(list) || list.length === 0) {
+            issues.push({
+                level: 'error',
+                type: 'missing-required-property',
+                message: 'BreadcrumbList.itemListElement must be a non-empty array',
+            });
+        }
+    }
+}
+function processPayload(payload, items, issues) {
+    if (Array.isArray(payload)) {
+        for (const item of payload) {
+            if (item && typeof item === 'object') {
+                processObject(item, items, issues);
+            }
+        }
+        return;
+    }
+    if (payload && typeof payload === 'object') {
+        const obj = payload;
+        if (Array.isArray(obj['@graph'])) {
+            const ctx = obj['@context'];
+            for (const node of obj['@graph']) {
+                if (node && typeof node === 'object') {
+                    const nodeObj = node;
+                    const expanded = ctx && !('@context' in nodeObj)
+                        ? { '@context': ctx, ...nodeObj }
+                        : nodeObj;
+                    processObject(expanded, items, issues);
+                }
+            }
+        }
+        else {
+            processObject(obj, items, issues);
+        }
+    }
+}
+export async function checkStructuredData(page) {
+    const url = page.url();
+    const items = [];
+    const issues = [];
+    const scripts = await page.$$eval('script[type="application/ld+json"]', (els) => els.map((s) => s.textContent || ''));
+    for (const text of scripts) {
+        let payload;
+        try {
+            payload = JSON.parse(text);
+        }
+        catch {
+            issues.push({
+                level: 'error',
+                type: 'invalid-json',
+                message: 'Failed to parse JSON-LD script',
+                snippet: text.trim().slice(0, 120),
+            });
+            continue;
+        }
+        processPayload(payload, items, issues);
+    }
+    const microdataItems = await page.$$eval('[itemscope][itemtype]', (els) => els.map((e) => ({ itemtype: e.getAttribute('itemtype') || '' })));
+    for (const { itemtype } of microdataItems) {
+        const type = itemtype.split('/').pop() || itemtype;
+        items.push({ format: 'microdata', type, raw: {} });
+    }
+    const typeCounts = new Map();
+    for (const item of items) {
+        typeCounts.set(item.type, (typeCounts.get(item.type) ?? 0) + 1);
+    }
+    for (const [type, count] of typeCounts) {
+        if (count > 1 && DUPLICATE_WARN_TYPES.has(type)) {
+            issues.push({
+                level: 'warn',
+                type: 'duplicate-type',
+                message: `Duplicate structured data type: ${type} (${count} instances)`,
+            });
+        }
+    }
+    const rawTags = await page.$$eval('link[rel="alternate"][hreflang]', (els) => els.map((l) => ({
+        lang: l.getAttribute('hreflang') || '',
+        href: l.getAttribute('href') || '',
+    })));
+    const hreflangTags = [];
+    for (const tag of rawTags) {
+        const valid = HREFLANG_RE.test(tag.lang);
+        hreflangTags.push({ ...tag, valid });
+        if (!valid) {
+            issues.push({
+                level: 'error',
+                type: 'hreflang-invalid-code',
+                message: `Invalid hreflang code: "${tag.lang}"`,
+                snippet: tag.href,
+            });
+        }
+    }
+    if (hreflangTags.length > 0) {
+        let hasReturn = false;
+        try {
+            const currentUrl = new URL(url);
+            const currentCanonical = currentUrl.origin + currentUrl.pathname;
+            for (const tag of hreflangTags) {
+                try {
+                    const tagUrl = new URL(tag.href, url);
+                    if (tagUrl.href === url ||
+                        tagUrl.origin + tagUrl.pathname === currentCanonical) {
+                        hasReturn = true;
+                        break;
+                    }
+                }
+                catch {
+                    // malformed href — skip
+                }
+            }
+        }
+        catch {
+            // invalid page URL — skip return check
+        }
+        if (!hasReturn) {
+            issues.push({
+                level: 'warn',
+                type: 'hreflang-missing-return',
+                message: 'No hreflang tag points back to the current page URL',
+            });
+        }
+    }
+    const passed = !issues.some((i) => i.level === 'error');
+    return { page: url, items, hreflangTags, issues, passed };
+}
+//# sourceMappingURL=structured-data.js.map

package/dist/structured-data.js.map

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

package/dist/svg-audit.d.ts

@@ -0,0 +1,20 @@
+import type { Page } from 'playwright';
+export type SvgIssueType = 'missing-title' | 'missing-role' | 'decorative-without-aria-hidden' | 'title-not-first-child' | 'desc-without-title' | 'focusable-without-tabindex' | 'missing-xmlns' | 'inaccessible-icon' | 'currentcolor-not-inherited' | 'viewbox-missing';
+export interface SvgIssue {
+    type: SvgIssueType;
+    severity: 'info' | 'warn' | 'error';
+    selector: string;
+    detail: string;
+    snippet?: string;
+}
+export interface SvgAuditResult {
+    page: string;
+    svgCount: number;
+    decorativeCount: number;
+    accessibleCount: number;
+    inaccessibleCount: number;
+    issues: SvgIssue[];
+    passed: boolean;
+}
+export declare function auditSvgs(page: Page): Promise<SvgAuditResult>;
+//# sourceMappingURL=svg-audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"svg-audit.d.ts","sourceRoot":"","sources":["../src/svg-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,YAAY,GACpB,eAAe,GACf,cAAc,GACd,gCAAgC,GAChC,uBAAuB,GACvB,oBAAoB,GACpB,4BAA4B,GAC5B,eAAe,GACf,mBAAmB,GACnB,4BAA4B,GAC5B,iBAAiB,CAAC;AAEtB,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,YAAY,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,QAAQ,EAAE,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAUD,wBAAsB,SAAS,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC,CAsOnE"}

package/dist/svg-audit.js

@@ -0,0 +1,213 @@
+export async function auditSvgs(page) {
+    const url = page.url();
+    const data = await page.evaluate(() => {
+        function buildSelector(el) {
+            if (el.id)
+                return `#${CSS.escape(el.id)}`;
+            const testid = el.getAttribute('data-testid');
+            if (testid)
+                return `[data-testid="${testid}"]`;
+            const tag = el.tagName.toLowerCase();
+            const classes = Array.from(el.classList).slice(0, 3);
+            if (classes.length)
+                return `${tag}.${classes.map((c) => CSS.escape(c)).join('.')}`;
+            const parent = el.parentElement;
+            if (parent) {
+                const sibs = Array.from(parent.children).filter((s) => s.tagName === el.tagName);
+                if (sibs.length > 1)
+                    return `${tag}:nth-of-type(${sibs.indexOf(el) + 1})`;
+            }
+            return tag;
+        }
+        function snippetOf(el) {
+            const html = el.outerHTML || '';
+            return html.length > 120 ? `${html.slice(0, 117)}...` : html;
+        }
+        function trimText(el) {
+            return el ? (el.textContent || '').trim() : '';
+        }
+        function firstElChild(el) {
+            for (const c of Array.from(el.childNodes)) {
+                if (c.nodeType === 1)
+                    return c;
+                if (c.nodeType === 3 && (c.textContent || '').trim().length > 0)
+                    return null;
+            }
+            return null;
+        }
+        function directChild(el, name) {
+            for (const c of Array.from(el.children))
+                if (c.localName === name)
+                    return c;
+            return null;
+        }
+        function ancestorName(svg) {
+            let node = svg.parentElement;
+            while (node && node !== document.body) {
+                const tag = node.tagName.toLowerCase();
+                const role = node.getAttribute('role');
+                const clickable = tag === 'button' || tag === 'a' || role === 'button' || role === 'link' ||
+                    node.hasAttribute('onclick');
+                if (clickable) {
+                    const aria = (node.getAttribute('aria-label') || '').trim();
+                    if (aria)
+                        return aria;
+                    const lb = node.getAttribute('aria-labelledby');
+                    if (lb) {
+                        const t = trimText(document.getElementById(lb));
+                        if (t)
+                            return t;
+                    }
+                    const title = (node.getAttribute('title') || '').trim();
+                    if (title)
+                        return title;
+                    const clone = node.cloneNode(true);
+                    clone.querySelectorAll('svg').forEach((s) => s.remove());
+                    return (clone.textContent || '').trim();
+                }
+                node = node.parentElement;
+            }
+            return 'NOT_INTERACTIVE';
+        }
+        function inAncestorRoleImg(svg) {
+            let node = svg.parentElement;
+            while (node && node !== document.body) {
+                if (node.getAttribute('role') === 'img')
+                    return true;
+                node = node.parentElement;
+            }
+            return false;
+        }
+        function hasSize(svg) {
+            if (svg.getAttribute('width') && svg.getAttribute('height'))
+                return true;
+            const r = svg.getBoundingClientRect();
+            return r.width > 0 && r.height > 0;
+        }
+        function isHardcoded(v) {
+            if (!v)
+                return false;
+            const t = v.trim().toLowerCase();
+            if (t === 'currentcolor' || t === 'none' || t === 'inherit' || t === 'transparent')
+                return false;
+            return /^#[0-9a-f]{3,8}$/i.test(t) || t.startsWith('rgb') || t.startsWith('hsl');
+        }
+        const svgEls = Array.from(document.querySelectorAll('svg'));
+        const issues = [];
+        let decorativeCount = 0;
+        let accessibleCount = 0;
+        let inaccessibleCount = 0;
+        let colorIssues = 0;
+        for (const svg of svgEls) {
+            const selector = buildSelector(svg);
+            const snippet = snippetOf(svg);
+            const ariaHidden = svg.getAttribute('aria-hidden') === 'true';
+            const role = svg.getAttribute('role');
+            const presentational = role === 'presentation' || role === 'none';
+            const ariaLabel = (svg.getAttribute('aria-label') || '').trim();
+            const ariaLabelledby = (svg.getAttribute('aria-labelledby') || '').trim();
+            const titleEl = directChild(svg, 'title');
+            const descEl = directChild(svg, 'desc');
+            const titleText = trimText(titleEl);
+            const hasName = !!(ariaLabel || ariaLabelledby || titleText);
+            const isEmpty = svg.children.length === 0;
+            const decorative = ariaHidden || presentational || (isEmpty && !hasName);
+            const ancestorImg = inAncestorRoleImg(svg);
+            if (decorative)
+                decorativeCount++;
+            else if (hasName || ancestorImg)
+                accessibleCount++;
+            else
+                inaccessibleCount++;
+            if (!decorative && !hasName && !ancestorImg) {
+                issues.push({
+                    type: 'missing-title', severity: 'error', selector,
+                    detail: 'svg has no <title>, aria-label, or aria-labelledby', snippet,
+                });
+            }
+            if (!decorative && !ancestorImg && hasName && role !== 'img') {
+                issues.push({
+                    type: 'missing-role', severity: 'warn', selector,
+                    detail: `meaningful svg should have role="img" (current role: ${role || 'none'})`,
+                    snippet,
+                });
+            }
+            if (isEmpty && !hasName && !ariaHidden && !presentational) {
+                issues.push({
+                    type: 'decorative-without-aria-hidden', severity: 'warn', selector,
+                    detail: 'empty svg with no accessible name should have aria-hidden="true"', snippet,
+                });
+            }
+            if (titleEl && firstElChild(svg) !== titleEl) {
+                issues.push({
+                    type: 'title-not-first-child', severity: 'info', selector,
+                    detail: '<title> must be the first child of <svg> for SR support', snippet,
+                });
+            }
+            if (descEl && !titleEl) {
+                issues.push({
+                    type: 'desc-without-title', severity: 'warn', selector,
+                    detail: '<desc> present without a <title> sibling', snippet,
+                });
+            }
+            if (svg.getAttribute('focusable') === 'true' && !svg.hasAttribute('tabindex')) {
+                issues.push({
+                    type: 'focusable-without-tabindex', severity: 'info', selector,
+                    detail: 'focusable="true" without tabindex is inconsistent across browsers', snippet,
+                });
+            }
+            if (!svg.getAttribute('xmlns')) {
+                issues.push({
+                    type: 'missing-xmlns', severity: 'info', selector,
+                    detail: 'inline svg should declare xmlns="http://www.w3.org/2000/svg"', snippet,
+                });
+            }
+            if (colorIssues < 10) {
+                const fillAttr = svg.getAttribute('fill');
+                const strokeAttr = svg.getAttribute('stroke');
+                if (isHardcoded(fillAttr) || isHardcoded(strokeAttr)) {
+                    issues.push({
+                        type: 'currentcolor-not-inherited', severity: 'info', selector,
+                        detail: `root color hardcoded (fill="${fillAttr || ''}" stroke="${strokeAttr || ''}"); use currentColor to inherit`,
+                        snippet,
+                    });
+                    colorIssues++;
+                }
+            }
+            if (!svg.hasAttribute('viewBox') && hasSize(svg)) {
+                issues.push({
+                    type: 'viewbox-missing', severity: 'info', selector,
+                    detail: 'sized svg without viewBox does not scale responsively', snippet,
+                });
+            }
+            if (!decorative) {
+                const an = ancestorName(svg);
+                if (an !== 'NOT_INTERACTIVE' && an === '' && !hasName) {
+                    issues.push({
+                        type: 'inaccessible-icon', severity: 'error', selector,
+                        detail: 'svg used as icon inside clickable element with no accessible name',
+                        snippet,
+                    });
+                }
+            }
+        }
+        return {
+            svgCount: svgEls.length,
+            decorativeCount,
+            accessibleCount,
+            inaccessibleCount,
+            issues,
+        };
+    });
+    const passed = data.issues.every((i) => i.severity !== 'error');
+    return {
+        page: url,
+        svgCount: data.svgCount,
+        decorativeCount: data.decorativeCount,
+        accessibleCount: data.accessibleCount,
+        inaccessibleCount: data.inaccessibleCount,
+        issues: data.issues,
+        passed,
+    };
+}
+//# sourceMappingURL=svg-audit.js.map

package/dist/svg-audit.js.map

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

package/dist/table-audit.d.ts

@@ -0,0 +1,18 @@
+import type { Page } from 'playwright';
+export type TableIssueType = 'no-caption' | 'no-th' | 'th-without-scope' | 'empty-th' | 'layout-table-with-semantics' | 'nested-table' | 'merged-cells-complex' | 'missing-headers-attr' | 'duplicate-th-text' | 'table-role-overridden' | 'no-summary-for-complex' | 'colgroup-without-scope';
+export interface TableIssue {
+    type: TableIssueType;
+    severity: 'info' | 'warn' | 'error';
+    selector: string;
+    detail: string;
+}
+export interface TableAuditResult {
+    page: string;
+    tableCount: number;
+    dataTableCount: number;
+    layoutTableCount: number;
+    issues: TableIssue[];
+    passed: boolean;
+}
+export declare function auditTables(page: Page): Promise<TableAuditResult>;
+//# sourceMappingURL=table-audit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table-audit.d.ts","sourceRoot":"","sources":["../src/table-audit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,OAAO,GACP,kBAAkB,GAClB,UAAU,GACV,6BAA6B,GAC7B,cAAc,GACd,sBAAsB,GACtB,sBAAsB,GACtB,mBAAmB,GACnB,uBAAuB,GACvB,wBAAwB,GACxB,wBAAwB,CAAC;AAE7B,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACjB;AASD,wBAAsB,WAAW,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmQvE"}

package/dist/table-audit.js

@@ -0,0 +1,188 @@
+export async function auditTables(page) {
+    const url = page.url();
+    const data = await page.evaluate(() => {
+        const VALID_SCOPES = new Set(['row', 'col', 'rowgroup', 'colgroup']);
+        const buildSelector = (el) => {
+            const parts = [];
+            let cur = el;
+            for (let d = 0; cur && d < 4; d++) {
+                const tag = cur.tagName.toLowerCase();
+                const parent = cur.parentElement;
+                if (parent) {
+                    const sibs = Array.from(parent.children).filter((c) => c.tagName === cur.tagName);
+                    parts.unshift(sibs.length > 1 ? `${tag}:nth-of-type(${sibs.indexOf(cur) + 1})` : tag);
+                }
+                else
+                    parts.unshift(tag);
+                cur = parent;
+            }
+            return parts.join(' > ');
+        };
+        const norm = (s) => (s || '').replace(/\s+/g, ' ').trim().toLowerCase();
+        const spanGt1 = (el, attr) => {
+            const n = parseInt(el.getAttribute(attr) || '1', 10);
+            return Number.isFinite(n) && n > 1;
+        };
+        const isLayoutTable = (table) => {
+            const role = (table.getAttribute('role') || '').trim().toLowerCase();
+            if (role === 'presentation' || role === 'none')
+                return true;
+            const hasTh = table.querySelector('th') !== null;
+            const hasCaption = table.querySelector(':scope > caption') !== null;
+            const hasThead = table.querySelector(':scope > thead') !== null;
+            const rowCount = table.querySelectorAll('tr').length;
+            return !hasTh && !hasCaption && !hasThead && rowCount <= 2;
+        };
+        const issues = [];
+        const tables = Array.from(document.querySelectorAll('table'));
+        let dataTableCount = 0;
+        let layoutTableCount = 0;
+        const push = (type, severity, selector, detail) => void issues.push({ type, severity, selector, detail });
+        for (const table of tables) {
+            const sel = buildSelector(table);
+            const role = (table.getAttribute('role') || '').trim().toLowerCase();
+            const layout = isLayoutTable(table);
+            if (layout) {
+                layoutTableCount++;
+                if (table.querySelector('th') || table.querySelector(':scope > caption')) {
+                    push('layout-table-with-semantics', 'warn', sel, 'table marked as layout (role=presentation/none) but contains th or caption');
+                }
+                continue;
+            }
+            dataTableCount++;
+            if (role && role !== 'table' && role !== 'grid' && role !== 'treegrid') {
+                push('table-role-overridden', 'warn', sel, `table element has role="${role}" which overrides native table semantics`);
+            }
+            const captionEl = table.querySelector(':scope > caption');
+            if (!captionEl) {
+                push('no-caption', 'warn', sel, 'data table has no <caption> element');
+            }
+            else if (table.firstElementChild !== captionEl) {
+                push('no-caption', 'warn', sel, '<caption> must be the first child of <table>');
+            }
+            const ths = Array.from(table.querySelectorAll('th'));
+            if (ths.length === 0) {
+                push('no-th', 'error', sel, 'data table has no <th> header cells');
+            }
+            for (const th of ths) {
+                const thSel = buildSelector(th);
+                const scope = (th.getAttribute('scope') || '').trim().toLowerCase();
+                const text = (th.textContent || '').trim();
+                const hasLabel = (th.getAttribute('aria-label') || '').trim().length > 0 ||
+                    (th.getAttribute('aria-labelledby') || '').trim().length > 0;
+                if (!text && !hasLabel) {
+                    push('empty-th', 'error', thSel, '<th> has no text content or accessible label');
+                }
+                if (!scope) {
+                    push('th-without-scope', 'warn', thSel, '<th> missing scope attribute (row|col|rowgroup|colgroup)');
+                }
+                else if (!VALID_SCOPES.has(scope)) {
+                    push('th-without-scope', 'warn', thSel, `<th> has invalid scope="${scope}"`);
+                }
+            }
+            for (const cg of Array.from(table.querySelectorAll(':scope > colgroup'))) {
+                for (const th of Array.from(cg.querySelectorAll('th'))) {
+                    const sc = (th.getAttribute('scope') || '').trim().toLowerCase();
+                    if (sc !== 'colgroup' && sc !== 'col') {
+                        push('colgroup-without-scope', 'warn', buildSelector(th), '<th> in <colgroup> should have scope="colgroup" or scope="col"');
+                    }
+                }
+            }
+            const cells = Array.from(table.querySelectorAll('td, th'));
+            const hasComplexSpan = cells.some((c) => spanGt1(c, 'rowspan') || spanGt1(c, 'colspan'));
+            if (hasComplexSpan) {
+                const spannedTds = Array.from(table.querySelectorAll('td')).filter((td) => spanGt1(td, 'rowspan') || spanGt1(td, 'colspan'));
+                const headerIds = new Set();
+                for (const th of ths) {
+                    const id = th.getAttribute('id');
+                    if (id)
+                        headerIds.add(id);
+                }
+                let missing = 0;
+                for (const td of spannedTds) {
+                    const ha = (td.getAttribute('headers') || '').trim();
+                    if (!ha) {
+                        missing++;
+                        continue;
+                    }
+                    if (!ha.split(/\s+/).every((r) => headerIds.has(r)))
+                        missing++;
+                }
+                if (missing > 0) {
+                    push('missing-headers-attr', 'error', sel, `${missing} merged cell(s) missing valid headers attribute referencing th[id]`);
+                    push('merged-cells-complex', 'warn', sel, 'table uses rowspan/colspan but lacks headers attribute association');
+                }
+            }
+            const nested = table.querySelectorAll('td table, th table');
+            if (nested.length > 0) {
+                push('nested-table', 'warn', sel, `${nested.length} nested table(s) found inside this table`);
+            }
+            const rows = Array.from(table.querySelectorAll(':scope > thead > tr, :scope > tbody > tr, :scope > tr'));
+            const seenRowDup = new Set();
+            for (const row of rows) {
+                const counts = new Map();
+                for (const th of Array.from(row.querySelectorAll(':scope > th'))) {
+                    const t = norm(th.textContent);
+                    if (t)
+                        counts.set(t, (counts.get(t) || 0) + 1);
+                }
+                counts.forEach((count, text) => {
+                    const key = `r:${text}`;
+                    if (count > 1 && !seenRowDup.has(key)) {
+                        seenRowDup.add(key);
+                        push('duplicate-th-text', 'info', buildSelector(row), `header text "${text}" appears ${count} times in same row`);
+                    }
+                });
+            }
+            const colTexts = new Map();
+            for (const row of rows) {
+                let col = 0;
+                for (const cell of Array.from(row.children).filter((c) => c.tagName === 'TH' || c.tagName === 'TD')) {
+                    if (cell.tagName === 'TH') {
+                        const scope = (cell.getAttribute('scope') || '').trim().toLowerCase();
+                        if (scope === 'col' || scope === '') {
+                            const t = norm(cell.textContent);
+                            if (t) {
+                                const arr = colTexts.get(col) || [];
+                                arr.push(t);
+                                colTexts.set(col, arr);
+                            }
+                        }
+                    }
+                    const cs = parseInt(cell.getAttribute('colspan') || '1', 10);
+                    col += Number.isFinite(cs) && cs > 0 ? cs : 1;
+                }
+            }
+            const seenColDup = new Set();
+            colTexts.forEach((texts, idx) => {
+                const counts = new Map();
+                for (const t of texts)
+                    counts.set(t, (counts.get(t) || 0) + 1);
+                counts.forEach((count, text) => {
+                    const key = `c:${idx}:${text}`;
+                    if (count > 1 && !seenColDup.has(key)) {
+                        seenColDup.add(key);
+                        push('duplicate-th-text', 'info', sel, `header text "${text}" appears ${count} times in column ${idx + 1}`);
+                    }
+                });
+            });
+            if (rows.length > 20) {
+                const hasDesc = (table.getAttribute('aria-describedby') || '').trim().length > 0;
+                const hasAL = (table.getAttribute('aria-label') || '').trim().length > 0;
+                if (!captionEl && !hasDesc && !hasAL) {
+                    push('no-summary-for-complex', 'info', sel, `large table (${rows.length} rows) lacks <caption>, aria-label, or aria-describedby`);
+                }
+            }
+        }
+        return { tableCount: tables.length, dataTableCount, layoutTableCount, issues };
+    });
+    return {
+        page: url,
+        tableCount: data.tableCount,
+        dataTableCount: data.dataTableCount,
+        layoutTableCount: data.layoutTableCount,
+        issues: data.issues,
+        passed: data.issues.every((i) => i.severity !== 'error'),
+    };
+}
+//# sourceMappingURL=table-audit.js.map