uxinspect 0.2.0 → 0.11.0

package/dist/aria-audit.js

@@ -0,0 +1,445 @@
+export async function auditAria(page) {
+    const url = page.url();
+    const data = await page.evaluate(() => {
+        const VALID_ROLES = new Set([
+            'alert',
+            'alertdialog',
+            'application',
+            'article',
+            'banner',
+            'button',
+            'cell',
+            'checkbox',
+            'columnheader',
+            'combobox',
+            'complementary',
+            'contentinfo',
+            'definition',
+            'dialog',
+            'directory',
+            'document',
+            'feed',
+            'figure',
+            'form',
+            'grid',
+            'gridcell',
+            'group',
+            'heading',
+            'img',
+            'link',
+            'list',
+            'listbox',
+            'listitem',
+            'log',
+            'main',
+            'marquee',
+            'math',
+            'menu',
+            'menubar',
+            'menuitem',
+            'menuitemcheckbox',
+            'menuitemradio',
+            'navigation',
+            'none',
+            'note',
+            'option',
+            'presentation',
+            'progressbar',
+            'radio',
+            'radiogroup',
+            'region',
+            'row',
+            'rowgroup',
+            'rowheader',
+            'scrollbar',
+            'search',
+            'searchbox',
+            'separator',
+            'slider',
+            'spinbutton',
+            'status',
+            'switch',
+            'tab',
+            'table',
+            'tablist',
+            'tabpanel',
+            'term',
+            'textbox',
+            'timer',
+            'toolbar',
+            'tooltip',
+            'tree',
+            'treegrid',
+            'treeitem',
+        ]);
+        const ABSTRACT_ROLES = new Set([
+            'command',
+            'composite',
+            'input',
+            'landmark',
+            'range',
+            'roletype',
+            'section',
+            'sectionhead',
+            'select',
+            'structure',
+            'widget',
+            'window',
+        ]);
+        const WIDGET_ROLES = new Set([
+            'button',
+            'checkbox',
+            'combobox',
+            'link',
+            'menuitem',
+            'menuitemcheckbox',
+            'menuitemradio',
+            'option',
+            'radio',
+            'slider',
+            'spinbutton',
+            'switch',
+            'tab',
+            'textbox',
+            'treeitem',
+        ]);
+        const LANDMARK_ROLES = new Set([
+            'banner',
+            'complementary',
+            'contentinfo',
+            'form',
+            'main',
+            'navigation',
+            'region',
+            'search',
+        ]);
+        const VALID_ARIA_ATTRS = new Set([
+            'aria-activedescendant',
+            'aria-atomic',
+            'aria-autocomplete',
+            'aria-busy',
+            'aria-checked',
+            'aria-colcount',
+            'aria-colindex',
+            'aria-colspan',
+            'aria-controls',
+            'aria-current',
+            'aria-describedby',
+            'aria-details',
+            'aria-disabled',
+            'aria-dropeffect',
+            'aria-errormessage',
+            'aria-expanded',
+            'aria-flowto',
+            'aria-grabbed',
+            'aria-haspopup',
+            'aria-hidden',
+            'aria-invalid',
+            'aria-keyshortcuts',
+            'aria-label',
+            'aria-labelledby',
+            'aria-level',
+            'aria-live',
+            'aria-modal',
+            'aria-multiline',
+            'aria-multiselectable',
+            'aria-orientation',
+            'aria-owns',
+            'aria-placeholder',
+            'aria-posinset',
+            'aria-pressed',
+            'aria-readonly',
+            'aria-relevant',
+            'aria-required',
+            'aria-roledescription',
+            'aria-rowcount',
+            'aria-rowindex',
+            'aria-rowspan',
+            'aria-selected',
+            'aria-setsize',
+            'aria-sort',
+            'aria-valuemax',
+            'aria-valuemin',
+            'aria-valuenow',
+            'aria-valuetext',
+        ]);
+        const shortSelector = (el) => {
+            let s = el.tagName.toLowerCase();
+            if (el.id)
+                s += `#${el.id}`;
+            const firstClass = el.classList?.[0];
+            if (firstClass)
+                s += `.${firstClass}`;
+            return s;
+        };
+        const isNaturallyFocusable = (el) => {
+            const tag = el.tagName.toLowerCase();
+            if (tag === 'a' && el.hasAttribute('href'))
+                return true;
+            if (tag === 'button')
+                return true;
+            if (tag === 'input') {
+                const type = (el.getAttribute('type') || '').toLowerCase();
+                return type !== 'hidden';
+            }
+            if (tag === 'select' || tag === 'textarea')
+                return true;
+            return false;
+        };
+        const hasFocusableTabindex = (el) => {
+            const ti = el.getAttribute('tabindex');
+            if (ti === null)
+                return false;
+            const n = parseInt(ti, 10);
+            return Number.isFinite(n) && n >= 0;
+        };
+        const getAccessibleName = (el) => {
+            const ariaLabel = el.getAttribute('aria-label');
+            if (ariaLabel && ariaLabel.trim())
+                return ariaLabel.trim();
+            const labelledby = el.getAttribute('aria-labelledby');
+            if (labelledby) {
+                const ids = labelledby.trim().split(/\s+/);
+                const parts = [];
+                for (const id of ids) {
+                    const ref = document.getElementById(id);
+                    if (ref) {
+                        const t = (ref.textContent || '').trim();
+                        if (t)
+                            parts.push(t);
+                    }
+                }
+                const joined = parts.join(' ').trim();
+                if (joined)
+                    return joined;
+            }
+            const title = el.getAttribute('title');
+            if (title && title.trim())
+                return title.trim();
+            const text = (el.textContent || '').trim();
+            if (text)
+                return text;
+            return '';
+        };
+        const issues = [];
+        const rolesUsed = {};
+        const landmarkCounts = {
+            banner: 0,
+            complementary: 0,
+            contentinfo: 0,
+            form: 0,
+            main: 0,
+            navigation: 0,
+            region: 0,
+            search: 0,
+        };
+        const all = document.querySelectorAll('*');
+        // 6. duplicate-id (once per id)
+        const idMap = new Map();
+        const reportedDuplicates = new Set();
+        all.forEach((el) => {
+            const id = el.getAttribute('id');
+            if (!id)
+                return;
+            idMap.set(id, (idMap.get(id) || 0) + 1);
+        });
+        idMap.forEach((count, id) => {
+            if (count > 1 && !reportedDuplicates.has(id)) {
+                reportedDuplicates.add(id);
+                const first = document.querySelector(`[id="${CSS.escape(id)}"]`);
+                issues.push({
+                    type: 'duplicate-id',
+                    target: first ? shortSelector(first) : `[id="${id}"]`,
+                    detail: `id "${id}" is used ${count} times`,
+                });
+            }
+        });
+        all.forEach((el) => {
+            const tag = el.tagName.toLowerCase();
+            const role = (el.getAttribute('role') || '').trim().toLowerCase();
+            // Track roles (explicit)
+            if (role) {
+                const firstToken = role.split(/\s+/)[0] || role;
+                rolesUsed[firstToken] = (rolesUsed[firstToken] || 0) + 1;
+                // 1. invalid-role
+                if (!VALID_ROLES.has(firstToken) && !ABSTRACT_ROLES.has(firstToken)) {
+                    issues.push({
+                        type: 'invalid-role',
+                        target: shortSelector(el),
+                        detail: `role="${firstToken}" is not a valid ARIA role`,
+                    });
+                }
+                // 2. abstract-role
+                if (ABSTRACT_ROLES.has(firstToken)) {
+                    issues.push({
+                        type: 'abstract-role',
+                        target: shortSelector(el),
+                        detail: `role="${firstToken}" is an abstract role and must not be used`,
+                    });
+                }
+            }
+            const effectiveRole = role.split(/\s+/)[0] || '';
+            // 3. aria-hidden on focusable
+            if (el.getAttribute('aria-hidden') === 'true') {
+                if (hasFocusableTabindex(el) || isNaturallyFocusable(el)) {
+                    issues.push({
+                        type: 'aria-hidden-on-focusable',
+                        target: shortSelector(el),
+                        detail: `aria-hidden="true" on focusable ${tag} element`,
+                    });
+                }
+            }
+            // 4. empty-button / empty-link
+            const isButton = tag === 'button' || effectiveRole === 'button';
+            const isLink = (tag === 'a' && el.hasAttribute('href')) || effectiveRole === 'link';
+            if (isButton || isLink) {
+                const text = (el.textContent || '').trim();
+                const hasLabel = !!(el.getAttribute('aria-label') && el.getAttribute('aria-label').trim()) ||
+                    !!el.getAttribute('aria-labelledby');
+                // also consider <input type="submit"/"button" value>
+                let valueText = '';
+                if (tag === 'input') {
+                    const itype = (el.getAttribute('type') || '').toLowerCase();
+                    if (itype === 'submit' || itype === 'button' || itype === 'reset') {
+                        valueText = (el.getAttribute('value') || '').trim();
+                    }
+                }
+                // also allow an inner <img alt> to count as a name for buttons/links
+                let imgAlt = '';
+                const innerImg = el.querySelector('img[alt]');
+                if (innerImg)
+                    imgAlt = (innerImg.getAttribute('alt') || '').trim();
+                if (!text && !hasLabel && !valueText && !imgAlt) {
+                    if (isButton) {
+                        issues.push({
+                            type: 'empty-button',
+                            target: shortSelector(el),
+                            detail: `button has no accessible text, aria-label, or aria-labelledby`,
+                        });
+                    }
+                    else if (isLink) {
+                        issues.push({
+                            type: 'empty-link',
+                            target: shortSelector(el),
+                            detail: `link has no accessible text, aria-label, or aria-labelledby`,
+                        });
+                    }
+                }
+            }
+            // 5. missing-name on widget role
+            if (effectiveRole && WIDGET_ROLES.has(effectiveRole)) {
+                const name = getAccessibleName(el);
+                if (!name) {
+                    // input fields may derive name from associated <label>
+                    let labelName = '';
+                    const id = el.getAttribute('id');
+                    if (id) {
+                        const lbl = document.querySelector(`label[for="${CSS.escape(id)}"]`);
+                        if (lbl)
+                            labelName = (lbl.textContent || '').trim();
+                    }
+                    if (!labelName) {
+                        const wrapLabel = el.closest('label');
+                        if (wrapLabel)
+                            labelName = (wrapLabel.textContent || '').trim();
+                    }
+                    if (!labelName) {
+                        issues.push({
+                            type: 'missing-name-on-widget',
+                            target: shortSelector(el),
+                            detail: `widget role="${effectiveRole}" has no accessible name`,
+                        });
+                    }
+                }
+            }
+            // 7. tabindex > 0
+            const tabindexAttr = el.getAttribute('tabindex');
+            if (tabindexAttr !== null) {
+                const n = parseInt(tabindexAttr, 10);
+                if (Number.isFinite(n) && n > 0) {
+                    issues.push({
+                        type: 'tabindex-gt-zero',
+                        target: shortSelector(el),
+                        detail: `tabindex="${tabindexAttr}" disrupts natural tab order`,
+                    });
+                }
+            }
+            // 8. presentational with content
+            if (effectiveRole === 'presentation' || effectiveRole === 'none') {
+                const text = (el.textContent || '').trim();
+                const hasInteractiveChild = !!el.querySelector('a[href], button, input, select, textarea, [tabindex], [role]');
+                if (text || hasInteractiveChild) {
+                    issues.push({
+                        type: 'presentational-with-content',
+                        target: shortSelector(el),
+                        detail: `role="${effectiveRole}" on element with content or interactive descendants`,
+                    });
+                }
+            }
+            // 9. invalid aria-* attributes
+            const attrs = el.attributes;
+            for (let i = 0; i < attrs.length; i++) {
+                const attr = attrs[i];
+                if (!attr)
+                    continue;
+                const name = attr.name.toLowerCase();
+                if (name.startsWith('aria-') && !VALID_ARIA_ATTRS.has(name)) {
+                    issues.push({
+                        type: 'invalid-aria-attr',
+                        target: shortSelector(el),
+                        detail: `unknown ARIA attribute "${name}"`,
+                    });
+                }
+            }
+            // Landmarks: explicit role
+            if (effectiveRole && LANDMARK_ROLES.has(effectiveRole)) {
+                landmarkCounts[effectiveRole] = (landmarkCounts[effectiveRole] || 0) + 1;
+            }
+            // Landmarks: implicit (only when no explicit role overrides)
+            if (!effectiveRole) {
+                if (tag === 'header') {
+                    // banner only when not inside article/section/main/aside/nav
+                    const inScoped = !!el.closest('article, section, main, aside, nav');
+                    if (!inScoped)
+                        landmarkCounts.banner = (landmarkCounts.banner || 0) + 1;
+                }
+                else if (tag === 'footer') {
+                    const inScoped = !!el.closest('article, section, main, aside, nav');
+                    if (!inScoped)
+                        landmarkCounts.contentinfo = (landmarkCounts.contentinfo || 0) + 1;
+                }
+                else if (tag === 'nav') {
+                    landmarkCounts.navigation = (landmarkCounts.navigation || 0) + 1;
+                }
+                else if (tag === 'main') {
+                    landmarkCounts.main = (landmarkCounts.main || 0) + 1;
+                }
+                else if (tag === 'aside') {
+                    landmarkCounts.complementary = (landmarkCounts.complementary || 0) + 1;
+                }
+                else if (tag === 'form') {
+                    if (el.hasAttribute('aria-label') || el.hasAttribute('aria-labelledby')) {
+                        landmarkCounts.form = (landmarkCounts.form || 0) + 1;
+                    }
+                }
+                else if (tag === 'section') {
+                    if (el.hasAttribute('aria-label') || el.hasAttribute('aria-labelledby')) {
+                        landmarkCounts.region = (landmarkCounts.region || 0) + 1;
+                    }
+                }
+            }
+        });
+        const landmarks = Object.keys(landmarkCounts)
+            .filter((k) => (landmarkCounts[k] || 0) > 0)
+            .map((role) => ({ role, count: landmarkCounts[role] || 0 }));
+        return { issues, landmarks, rolesUsed };
+    });
+    return {
+        page: url,
+        issues: data.issues,
+        landmarks: data.landmarks,
+        rolesUsed: data.rolesUsed,
+        passed: data.issues.length === 0,
+    };
+}
+//# sourceMappingURL=aria-audit.js.map

package/dist/aria-audit.js.map

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

package/dist/assertions.d.ts

@@ -0,0 +1,30 @@
+import type { InspectResult } from './types.js';
+export type AssertOp = '<' | '<=' | '>' | '>=' | '==' | '!=';
+export type AssertValue = string | number | boolean | null;
+export interface AssertionSpec {
+    [path: string]: string;
+}
+export interface AssertionViolation {
+    path: string;
+    expected: string;
+    actual: AssertValue | undefined;
+    op: AssertOp;
+    threshold: AssertValue;
+    unit?: string;
+}
+export interface AssertionResult {
+    passed: boolean;
+    violations: AssertionViolation[];
+}
+interface ParsedAssertion {
+    op: AssertOp;
+    threshold: AssertValue;
+    unit?: string;
+}
+export declare function listSupportedPaths(): readonly string[];
+export declare function parseAssertion(expr: string): ParsedAssertion;
+export declare function resolveMetric(result: InspectResult, path: string): AssertValue | undefined;
+export declare function evaluateAssertions(result: InspectResult, spec: AssertionSpec): AssertionResult;
+export declare function formatAssertionFailures(violations: AssertionViolation[]): string;
+export {};
+//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAoD,MAAM,YAAY,CAAC;AAElG,MAAM,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7D,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,WAAW,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,EAAE,kBAAkB,EAAE,CAAC;CAClC;AAED,UAAU,eAAe;IACvB,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,WAAW,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AA+BD,wBAAgB,kBAAkB,IAAI,SAAS,MAAM,EAAE,CAEtD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CA+B5D;AAmED,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAiE1F;AA4ED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAyB9F;AAiBD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAShF"}