uxinspect 0.2.0 → 0.11.0

package/dist/assertions.js

@@ -0,0 +1,342 @@
+const SUPPORTED_OPS = ['<=', '>=', '==', '!=', '<', '>'];
+const SUPPORTED_PATHS = [
+    'perf.lcp',
+    'perf.cls',
+    'perf.tbt',
+    'perf.fcp',
+    'perf.si',
+    'perf.scores.performance',
+    'perf.scores.accessibility',
+    'perf.scores.bestPractices',
+    'perf.scores.seo',
+    'a11y.critical',
+    'a11y.serious',
+    'a11y.moderate',
+    'a11y.minor',
+    'a11y.total',
+    'visual.maxDiffRatio',
+    'visual.failed',
+    'flows.failed',
+    'flows.total',
+    'flows.passed',
+    'links.broken',
+    'consoleErrors.count',
+    'consoleErrors.errors',
+    'consoleErrors.warnings',
+    'passed',
+];
+export function listSupportedPaths() {
+    return SUPPORTED_PATHS;
+}
+export function parseAssertion(expr) {
+    if (typeof expr !== 'string')
+        throw new Error(`invalid assertion: ${String(expr)}`);
+    const raw = expr.trim();
+    if (!raw)
+        throw new Error(`invalid assertion: ${expr}`);
+    let op;
+    let rest = '';
+    for (const candidate of SUPPORTED_OPS) {
+        if (raw.startsWith(candidate)) {
+            op = candidate;
+            rest = raw.slice(candidate.length).trim();
+            break;
+        }
+    }
+    if (!op)
+        throw new Error(`invalid assertion: ${expr}`);
+    if (!rest)
+        throw new Error(`invalid assertion: ${expr}`);
+    const lower = rest.toLowerCase();
+    if (lower === 'true' || lower === 'false')
+        return { op, threshold: lower === 'true' };
+    if (lower === 'null')
+        return { op, threshold: null };
+    const unitMatch = rest.match(/^(-?\d+(?:\.\d+)?)(ms|s|%)?$/i);
+    if (unitMatch) {
+        const num = Number(unitMatch[1]);
+        if (!Number.isFinite(num))
+            throw new Error(`invalid assertion: ${expr}`);
+        const unit = unitMatch[2]?.toLowerCase();
+        if (unit === 's')
+            return { op, threshold: num * 1000, unit: 's' };
+        if (unit === '%')
+            return { op, threshold: num / 100, unit: '%' };
+        if (unit === 'ms')
+            return { op, threshold: num, unit: 'ms' };
+        return { op, threshold: num };
+    }
+    const stringMatch = rest.match(/^['"](.*)['"]$/);
+    if (stringMatch)
+        return { op, threshold: stringMatch[1] };
+    throw new Error(`invalid assertion: ${expr}`);
+}
+function mean(values) {
+    if (!values.length)
+        return undefined;
+    let sum = 0;
+    for (const v of values)
+        sum += v;
+    return sum / values.length;
+}
+function sum(values) {
+    let total = 0;
+    for (const v of values)
+        total += v;
+    return total;
+}
+function perfMetric(perf, key) {
+    if (!perf || !perf.length)
+        return undefined;
+    return mean(perf.map((p) => p.metrics[key]));
+}
+function perfScore(perf, key) {
+    if (!perf || !perf.length)
+        return undefined;
+    return mean(perf.map((p) => p.scores[key]));
+}
+function a11yCount(a11y, impact) {
+    if (!a11y)
+        return 0;
+    let count = 0;
+    for (const r of a11y) {
+        for (const v of r.violations) {
+            if (v.impact === impact)
+                count++;
+        }
+    }
+    return count;
+}
+function a11yTotal(a11y) {
+    if (!a11y)
+        return 0;
+    let count = 0;
+    for (const r of a11y)
+        count += r.violations.length;
+    return count;
+}
+function visualMaxDiff(visual) {
+    if (!visual || !visual.length)
+        return undefined;
+    let max = 0;
+    for (const v of visual) {
+        if (v.diffRatio > max)
+            max = v.diffRatio;
+    }
+    return max;
+}
+function visualFailed(visual) {
+    if (!visual)
+        return 0;
+    return visual.filter((v) => v.passed === false).length;
+}
+function flowsFailed(flows) {
+    if (!flows)
+        return 0;
+    return flows.filter((f) => f.passed === false).length;
+}
+function flowsPassed(flows) {
+    if (!flows)
+        return 0;
+    return flows.filter((f) => f.passed === true).length;
+}
+export function resolveMetric(result, path) {
+    switch (path) {
+        case 'perf.lcp':
+            return perfMetric(result.perf, 'lcp');
+        case 'perf.cls':
+            return perfMetric(result.perf, 'cls');
+        case 'perf.tbt':
+            return perfMetric(result.perf, 'tbt');
+        case 'perf.fcp':
+            return perfMetric(result.perf, 'fcp');
+        case 'perf.si':
+            return perfMetric(result.perf, 'si');
+        case 'perf.scores.performance':
+            return perfScore(result.perf, 'performance');
+        case 'perf.scores.accessibility':
+            return perfScore(result.perf, 'accessibility');
+        case 'perf.scores.bestPractices':
+            return perfScore(result.perf, 'bestPractices');
+        case 'perf.scores.seo':
+            return perfScore(result.perf, 'seo');
+        case 'a11y.critical':
+            return a11yCount(result.a11y, 'critical');
+        case 'a11y.serious':
+            return a11yCount(result.a11y, 'serious');
+        case 'a11y.moderate':
+            return a11yCount(result.a11y, 'moderate');
+        case 'a11y.minor':
+            return a11yCount(result.a11y, 'minor');
+        case 'a11y.total':
+            return a11yTotal(result.a11y);
+        case 'visual.maxDiffRatio':
+            return visualMaxDiff(result.visual);
+        case 'visual.failed':
+            return visualFailed(result.visual);
+        case 'flows.failed':
+            return flowsFailed(result.flows);
+        case 'flows.total':
+            return result.flows?.length ?? 0;
+        case 'flows.passed':
+            return flowsPassed(result.flows);
+        case 'links.broken': {
+            const links = result.links;
+            if (!links)
+                return 0;
+            return sum(links.map((l) => l.broken.length));
+        }
+        case 'consoleErrors.count': {
+            const ce = result.consoleErrors;
+            if (!ce)
+                return 0;
+            return sum(ce.map((c) => c.issues.length));
+        }
+        case 'consoleErrors.errors': {
+            const ce = result.consoleErrors;
+            if (!ce)
+                return 0;
+            return sum(ce.map((c) => c.errorCount));
+        }
+        case 'consoleErrors.warnings': {
+            const ce = result.consoleErrors;
+            if (!ce)
+                return 0;
+            return sum(ce.map((c) => c.warningCount));
+        }
+        case 'passed':
+            return result.passed;
+        default:
+            return undefined;
+    }
+}
+function compareNumbers(actual, op, threshold) {
+    switch (op) {
+        case '<': return actual < threshold;
+        case '<=': return actual <= threshold;
+        case '>': return actual > threshold;
+        case '>=': return actual >= threshold;
+        case '==': return actual === threshold;
+        case '!=': return actual !== threshold;
+    }
+}
+function compareBooleans(actual, op, threshold) {
+    if (op === '==')
+        return actual === threshold;
+    if (op === '!=')
+        return actual !== threshold;
+    throw new Error(`operator ${op} not allowed for boolean values`);
+}
+function compareStrings(actual, op, threshold) {
+    if (op === '==')
+        return actual === threshold;
+    if (op === '!=')
+        return actual !== threshold;
+    throw new Error(`operator ${op} not allowed for string values`);
+}
+function compareNulls(actual, op) {
+    if (op === '==')
+        return actual === null;
+    if (op === '!=')
+        return actual !== null;
+    throw new Error(`operator ${op} not allowed for null values`);
+}
+function evaluateOne(path, expr, actual, parsed) {
+    const { op, threshold, unit } = parsed;
+    if (threshold === null) {
+        const ok = compareNulls(actual, op);
+        if (ok)
+            return undefined;
+        return { path, expected: expr, actual, op, threshold, unit };
+    }
+    if (actual === undefined) {
+        return { path, expected: expr, actual: undefined, op, threshold, unit };
+    }
+    if (typeof threshold === 'boolean') {
+        if (typeof actual !== 'boolean') {
+            return { path, expected: expr, actual, op, threshold, unit };
+        }
+        if (compareBooleans(actual, op, threshold))
+            return undefined;
+        return { path, expected: expr, actual, op, threshold, unit };
+    }
+    if (typeof threshold === 'string') {
+        if (typeof actual !== 'string') {
+            return { path, expected: expr, actual, op, threshold, unit };
+        }
+        if (compareStrings(actual, op, threshold))
+            return undefined;
+        return { path, expected: expr, actual, op, threshold, unit };
+    }
+    if (typeof threshold === 'number') {
+        if (typeof actual !== 'number' || !Number.isFinite(actual)) {
+            return { path, expected: expr, actual, op, threshold, unit };
+        }
+        if (compareNumbers(actual, op, threshold))
+            return undefined;
+        return { path, expected: expr, actual, op, threshold, unit };
+    }
+    return { path, expected: expr, actual, op, threshold, unit };
+}
+export function evaluateAssertions(result, spec) {
+    const violations = [];
+    for (const path of Object.keys(spec)) {
+        const expr = spec[path];
+        if (typeof expr !== 'string') {
+            violations.push({ path, expected: String(expr), actual: undefined, op: '==', threshold: null });
+            continue;
+        }
+        let parsed;
+        try {
+            parsed = parseAssertion(expr);
+        }
+        catch {
+            violations.push({ path, expected: expr, actual: undefined, op: '==', threshold: null });
+            continue;
+        }
+        const actual = resolveMetric(result, path);
+        let violation;
+        try {
+            violation = evaluateOne(path, expr, actual, parsed);
+        }
+        catch {
+            violation = { path, expected: expr, actual, op: parsed.op, threshold: parsed.threshold, unit: parsed.unit };
+        }
+        if (violation)
+            violations.push(violation);
+    }
+    return { passed: violations.length === 0, violations };
+}
+function formatValue(v, unit) {
+    if (v === undefined)
+        return '<unavailable>';
+    if (v === null)
+        return 'null';
+    if (typeof v === 'boolean')
+        return v ? 'true' : 'false';
+    if (typeof v === 'string')
+        return JSON.stringify(v);
+    if (typeof v === 'number') {
+        const rounded = Number.isInteger(v) ? v.toString() : v.toFixed(3);
+        if (unit === 'ms')
+            return `${rounded}ms`;
+        if (unit === 's')
+            return `${rounded}ms`;
+        if (unit === '%')
+            return rounded;
+        return rounded;
+    }
+    return String(v);
+}
+export function formatAssertionFailures(violations) {
+    if (!violations.length)
+        return '';
+    const lines = [];
+    lines.push(`${violations.length} assertion${violations.length === 1 ? '' : 's'} failed:`);
+    for (const v of violations) {
+        const actualStr = formatValue(v.actual, v.unit);
+        lines.push(`  - ${v.path} expected ${v.expected}, got ${actualStr}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

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

package/dist/autofix.d.ts

@@ -0,0 +1,40 @@
+export type FixLang = 'html' | 'css' | 'jsx' | 'vue' | 'attr';
+export interface AutoFixPatch {
+    issueId: string;
+    category: 'a11y' | 'seo' | 'perf' | 'security' | 'forms' | 'images' | 'headings' | 'structured-data';
+    severity: 'info' | 'warn' | 'error';
+    selector?: string;
+    before?: string;
+    after?: string;
+    lang: FixLang;
+    rationale: string;
+    confidence: number;
+    docsRef?: string;
+}
+export interface A11yNode {
+    html: string;
+    target: string[];
+}
+export interface A11yViolation {
+    id: string;
+    impact: string;
+    nodes: A11yNode[];
+}
+export interface IssueRecord {
+    type: string;
+    selector?: string;
+    snippet?: string;
+}
+export interface PageIssues {
+    page: string;
+    issues: IssueRecord[];
+}
+export interface AutoFixInput {
+    a11y?: A11yViolation[];
+    headings?: PageIssues[];
+    forms?: PageIssues[];
+    images?: PageIssues[];
+}
+export declare function generateAutoFixes(input: AutoFixInput): AutoFixPatch[];
+export declare function autoFixesToMarkdown(patches: AutoFixPatch[]): string;
+//# sourceMappingURL=autofix.d.ts.map

package/dist/autofix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autofix.d.ts","sourceRoot":"","sources":["../src/autofix.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,iBAAiB,CAAC;IACrG,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;CAAE;AAC7D,MAAM,WAAW,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;CAAE;AACjF,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAAE;AACnF,MAAM,WAAW,UAAU;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,WAAW,EAAE,CAAC;CAAE;AAEpE,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,aAAa,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,UAAU,EAAE,CAAC;IACrB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAqQD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,CA+CrE;AAQD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CA4BnE"}

package/dist/autofix.js

@@ -0,0 +1,244 @@
+function ensureAttr(snippet, attr, value) {
+    const fallback = `<element ${attr}="${value}"></element>`;
+    if (!snippet)
+        return fallback;
+    const tagMatch = snippet.match(/^<([a-zA-Z][a-zA-Z0-9-]*)([^>]*)>/);
+    if (!tagMatch)
+        return snippet.replace(/<([a-zA-Z][a-zA-Z0-9-]*)/, `<$1 ${attr}="${value}"`);
+    const [full, tag, attrs] = tagMatch;
+    if (new RegExp(`\\b${attr}=`).test(attrs)) {
+        const replaced = attrs.replace(new RegExp(`${attr}="[^"]*"`), `${attr}="${value}"`);
+        return snippet.replace(full, `<${tag}${replaced}>`);
+    }
+    return snippet.replace(full, `<${tag}${attrs} ${attr}="${value}">`);
+}
+function wrapWithLabel(snippet, text) {
+    return `<label>${text} ${snippet ?? '<input type="text" name="field">'}</label>`;
+}
+function demoteHeading(snippet, from, to) {
+    if (!snippet)
+        return `<h${to}>Section title</h${to}>`;
+    return snippet
+        .replace(new RegExp(`<h${from}([^>]*)>`, 'g'), `<h${to}$1>`)
+        .replace(new RegExp(`</h${from}>`, 'g'), `</h${to}>`);
+}
+function severityFromImpact(impact) {
+    if (impact === 'critical' || impact === 'serious')
+        return 'error';
+    if (impact === 'moderate')
+        return 'warn';
+    return 'info';
+}
+function attrRule(category, severity, fallbackBefore, attr, value, rationale, confidence, docsRef, lang = 'html') {
+    return {
+        category, severity, lang, rationale, confidence, docsRef,
+        build: (snippet) => ({
+            before: snippet ?? fallbackBefore,
+            after: ensureAttr(snippet ?? fallbackBefore, attr, value),
+        }),
+    };
+}
+function staticRule(category, severity, before, after, rationale, confidence, docsRef, lang = 'html') {
+    return {
+        category, severity, lang, rationale, confidence, docsRef,
+        build: (snippet) => ({ before: snippet ?? before, after }),
+    };
+}
+const A11Y_RULES = {
+    'image-alt': attrRule('a11y', 'error', '<img src="foo.jpg">', 'alt', 'Description of image', 'WCAG 1.1.1 — images need text alternatives so screen readers can describe them.', 0.7, 'WCAG 1.1.1'),
+    'label': {
+        category: 'a11y', severity: 'error', lang: 'html', confidence: 0.7, docsRef: 'WCAG 1.3.1, 4.1.2',
+        rationale: 'Form controls need programmatically associated labels for assistive tech.',
+        build: (s) => ({ before: s ?? '<input type="text" name="q">', after: wrapWithLabel(s, 'Search') }),
+    },
+    'color-contrast': staticRule('a11y', 'error', '.text { color: #999; background: #fff; }', '.text { color: #595959; background: #fff; } /* contrast ratio >= 4.5:1 */', 'Increase foreground/background contrast to meet WCAG AA 4.5:1 for normal text.', 0.7, 'WCAG 1.4.3', 'css'),
+    'heading-order': staticRule('a11y', 'warn', '<h1>Title</h1><h3>Sub</h3>', '<h1>Title</h1><h2>Sub</h2>', 'Heading levels should not skip (h1 -> h3). Use sequential levels for outline clarity.', 0.95, 'WCAG 1.3.1'),
+    'link-name': attrRule('a11y', 'error', '<a href="/x"><i class="icon"></i></a>', 'aria-label', 'Descriptive link text', 'Links must have discernible text for screen reader users.', 0.95, 'WCAG 2.4.4, 4.1.2'),
+    'button-name': attrRule('a11y', 'error', '<button><i class="icon"></i></button>', 'aria-label', 'Button purpose', 'Buttons must have an accessible name describing their action.', 0.95, 'WCAG 4.1.2'),
+    'html-has-lang': staticRule('a11y', 'error', '<html>', '<html lang="en">', 'Root element needs lang attribute so assistive tech can pronounce content correctly.', 0.95, 'WCAG 3.1.1'),
+    'html-lang-valid': staticRule('a11y', 'error', '<html lang="english">', '<html lang="en">', 'lang attribute must use a valid BCP 47 language code.', 0.95, 'WCAG 3.1.1'),
+    'document-title': staticRule('a11y', 'error', '<head></head>', '<head><title>Page title — Site name</title></head>', 'Pages need a unique, descriptive title for orientation and tab labels.', 0.95, 'WCAG 2.4.2'),
+    'duplicate-id': staticRule('a11y', 'error', '<div id="x"></div>...<div id="x"></div>', '<div id="x-1"></div>...<div id="x-2"></div>', 'IDs must be unique within a document; duplicates break label/aria associations.', 0.95, 'WCAG 4.1.1'),
+    'aria-roles': attrRule('a11y', 'error', '<div role="buton">', 'role', 'button', 'role attribute must use a valid ARIA role from the spec.', 0.95, 'WCAG 4.1.2'),
+    'aria-required-attr': attrRule('a11y', 'error', '<div role="checkbox"></div>', 'aria-checked', 'false', 'Elements with ARIA roles need their required ARIA attributes set.', 0.95, 'WAI-ARIA 1.2'),
+    'aria-valid-attr-value': attrRule('a11y', 'error', '<div aria-expanded="yes">', 'aria-expanded', 'true', 'ARIA attributes must use valid values per the WAI-ARIA spec.', 0.95, 'WAI-ARIA 1.2'),
+    'frame-title': attrRule('a11y', 'error', '<iframe src="/x"></iframe>', 'title', 'Embedded content description', 'Frames need a title attribute so users know what they contain.', 0.95, 'WCAG 2.4.1, 4.1.2'),
+    'list': staticRule('a11y', 'warn', '<ul><div>item</div></ul>', '<ul><li>item</li></ul>', 'ul/ol must contain only li (or script/template) children.', 0.95, 'WCAG 1.3.1'),
+    'listitem': staticRule('a11y', 'warn', '<li>orphan</li>', '<ul><li>orphan</li></ul>', 'li elements must be wrapped in a ul or ol parent.', 0.95, 'WCAG 1.3.1'),
+    'meta-viewport': staticRule('a11y', 'error', '<meta name="viewport" content="user-scalable=no">', '<meta name="viewport" content="width=device-width, initial-scale=1">', 'Disabling user-scalable blocks pinch-zoom and harms low-vision users.', 0.95, 'WCAG 1.4.4'),
+    'tabindex': attrRule('a11y', 'warn', '<div tabindex="5">', 'tabindex', '0', 'Avoid tabindex > 0; it disrupts natural tab order.', 0.95, 'WCAG 2.4.3'),
+    'region': staticRule('a11y', 'warn', '<div>page content</div>', '<main>page content</main>', 'Wrap primary page content in a landmark element so assistive tech can navigate.', 0.7, 'WCAG 1.3.1, 2.4.1'),
+    'landmark-one-main': staticRule('a11y', 'warn', '<body><div>...</div></body>', '<body><main>...</main></body>', 'Each page should have exactly one main landmark.', 0.95, 'WCAG 1.3.1'),
+    'bypass': staticRule('a11y', 'warn', '<body><nav>...</nav><main>...</main></body>', '<body><a href="#main" class="skip-link">Skip to main content</a><nav>...</nav><main id="main">...</main></body>', 'Provide a skip link so keyboard users can bypass repeated navigation.', 0.95, 'WCAG 2.4.1'),
+};
+const FORM_RULES = {
+    'missing-label': {
+        category: 'forms', severity: 'error', lang: 'html', confidence: 0.7, docsRef: 'WCAG 1.3.1, 3.3.2',
+        rationale: 'Form controls need programmatically associated labels.',
+        build: (s) => ({ before: s ?? '<input type="email" name="email">', after: wrapWithLabel(s, 'Email address') }),
+    },
+    'missing-autocomplete': {
+        category: 'forms', severity: 'warn', lang: 'html', confidence: 0.95, docsRef: 'WCAG 1.3.5',
+        rationale: 'Autocomplete tokens help users (and password managers) fill known data.',
+        build: (s) => {
+            const snip = s ?? '<input type="email" name="email">';
+            const guess = /email/i.test(snip) ? 'email' : /tel|phone/i.test(snip) ? 'tel' : /name/i.test(snip) ? 'name' : 'on';
+            return { before: snip, after: ensureAttr(snip, 'autocomplete', guess) };
+        },
+    },
+    'missing-required-indicator': attrRule('forms', 'warn', '<input required>', 'aria-required', 'true', 'Required fields should be visually and programmatically indicated.', 0.95, 'WCAG 3.3.2'),
+    'missing-error-message': staticRule('forms', 'error', '<input aria-invalid="true">', '<input aria-invalid="true" aria-describedby="err-1"><span id="err-1" role="alert">Please enter a valid value.</span>', 'Invalid inputs should reference a visible error message via aria-describedby.', 0.95, 'WCAG 3.3.1, 3.3.3'),
+    'missing-fieldset': staticRule('forms', 'warn', '<input type="radio" name="r"><input type="radio" name="r">', '<fieldset><legend>Choose one</legend><input type="radio" name="r"><input type="radio" name="r"></fieldset>', 'Group related radio/checkbox controls in a fieldset with a legend.', 0.95, 'WCAG 1.3.1'),
+    'missing-input-mode': attrRule('forms', 'info', '<input type="text" name="otp">', 'inputmode', 'numeric', 'Set inputmode to surface the right virtual keyboard on mobile.', 0.7),
+    'submit-without-button': staticRule('forms', 'warn', '<form>...</form>', '<form>...<button type="submit">Submit</button></form>', 'Forms should have an explicit submit button for keyboard users.', 0.95, 'WCAG 2.1.1'),
+};
+const HEADING_RULES = {
+    'multiple-h1': {
+        category: 'headings', severity: 'warn', lang: 'html', confidence: 0.95, docsRef: 'WCAG 1.3.1, 2.4.6',
+        rationale: 'Each page should have a single h1 representing its main topic.',
+        build: (s) => ({
+            before: s ?? '<h1>Primary</h1>...<h1>Secondary</h1>',
+            after: demoteHeading(s ?? '<h1>Secondary</h1>', 1, 2),
+        }),
+    },
+    'missing-h1': staticRule('headings', 'error', '<body><h2>Welcome</h2></body>', '<body><h1>Welcome</h1></body>', 'Pages need a top-level h1 to anchor the document outline.', 0.95, 'WCAG 2.4.6'),
+    'skipped-level': staticRule('headings', 'warn', '<h1>Title</h1><h3>Sub</h3>', '<h1>Title</h1><h2>Sub</h2>', 'Heading levels should not skip; promote h3 to h2 to maintain hierarchy.', 0.95, 'WCAG 1.3.1'),
+    'empty-heading': staticRule('headings', 'error', '<h2></h2>', '<h2>Section title</h2>', 'Empty headings confuse screen reader navigation; remove or fill them.', 0.7, 'WCAG 1.3.1, 2.4.6'),
+};
+const IMAGE_RULES = {
+    'missing-alt': attrRule('images', 'error', '<img src="hero.jpg">', 'alt', 'Describe the image content', 'Add alt text for informative images, or alt="" for decorative ones.', 0.7, 'WCAG 1.1.1'),
+    'decorative-needs-empty-alt': attrRule('images', 'warn', '<img src="bg.svg">', 'alt', '', 'Decorative images should have alt="" so screen readers skip them.', 0.95, 'WCAG 1.1.1'),
+    'missing-dimensions': {
+        category: 'images', severity: 'warn', lang: 'html', confidence: 0.95, docsRef: 'web.dev/optimize-cls',
+        rationale: 'Width/height attributes prevent layout shift (CLS) while images load.',
+        build: (s) => {
+            const snip = s ?? '<img src="hero.jpg" alt="Hero">';
+            return { before: snip, after: ensureAttr(ensureAttr(snip, 'width', '1200'), 'height', '630') };
+        },
+    },
+    'missing-lazy': attrRule('images', 'info', '<img src="below-fold.jpg" alt="">', 'loading', 'lazy', 'Lazy-load below-the-fold images to defer network and decode work.', 0.95, 'web.dev/browser-level-image-lazy-loading'),
+    'wrong-format': staticRule('images', 'info', '<img src="hero.png" alt="Hero">', '<picture><source type="image/avif" srcset="hero.avif"><source type="image/webp" srcset="hero.webp"><img src="hero.png" alt="Hero" width="1200" height="630"></picture>', 'Serve modern formats (AVIF/WebP) with picture for smaller payloads.', 0.7, 'web.dev/serve-images-webp'),
+    'missing-srcset': {
+        category: 'images', severity: 'info', lang: 'html', confidence: 0.7, docsRef: 'web.dev/serve-responsive-images',
+        rationale: 'Provide srcset/sizes so the browser picks the best resolution per device.',
+        build: (s) => {
+            const snip = s ?? '<img src="hero.jpg" alt="Hero">';
+            const withSrcset = ensureAttr(snip, 'srcset', 'hero-800.jpg 800w, hero-1600.jpg 1600w');
+            return { before: snip, after: ensureAttr(withSrcset, 'sizes', '(max-width: 800px) 100vw, 800px') };
+        },
+    },
+    'missing-eager-lcp': {
+        category: 'images', severity: 'warn', lang: 'html', confidence: 0.95, docsRef: 'web.dev/optimize-lcp',
+        rationale: 'LCP image should load eagerly with high fetch priority to improve LCP.',
+        build: (s) => {
+            const snip = s ?? '<img src="hero.jpg" alt="Hero">';
+            return { before: snip, after: ensureAttr(ensureAttr(snip, 'fetchpriority', 'high'), 'loading', 'eager') };
+        },
+    },
+    'svg-missing-title': staticRule('images', 'warn', '<svg viewBox="0 0 24 24"><path d="..."/></svg>', '<svg viewBox="0 0 24 24" role="img" aria-labelledby="t1"><title id="t1">Icon description</title><path d="..."/></svg>', 'Inline SVGs need a title (and role="img") so screen readers announce them.', 0.95, 'WCAG 1.1.1'),
+};
+const STRUCTURED_DATA_TEMPLATE = `<script type="application/ld+json">
+{
+  "@context": "https://schema.org",
+  "@type": "WebSite",
+  "name": "Site name",
+  "url": "https://example.com"
+}
+</script>`;
+function makePatch(rule, issueId, selector, snippet) {
+    const built = rule.build(snippet);
+    return {
+        issueId,
+        category: rule.category,
+        severity: rule.severity,
+        selector,
+        before: built.before,
+        after: built.after,
+        lang: rule.lang,
+        rationale: rule.rationale,
+        confidence: rule.confidence,
+        docsRef: rule.docsRef,
+    };
+}
+export function generateAutoFixes(input) {
+    const patches = [];
+    if (input.a11y) {
+        input.a11y.forEach((violation, vIdx) => {
+            const rule = A11Y_RULES[violation.id];
+            if (!rule)
+                return;
+            violation.nodes.forEach((node, nIdx) => {
+                const selector = node.target.join(' ');
+                const patch = makePatch(rule, `a11y:${violation.id}:${vIdx}-${nIdx}`, selector, node.html);
+                patch.severity = severityFromImpact(violation.impact);
+                patches.push(patch);
+            });
+        });
+    }
+    const collect = (pages, rules, prefix) => {
+        if (!pages)
+            return;
+        pages.forEach((page) => {
+            page.issues.forEach((issue, idx) => {
+                const rule = rules[issue.type];
+                if (!rule)
+                    return;
+                const id = `${prefix}:${page.page}:${issue.type}:${idx}`;
+                patches.push(makePatch(rule, id, issue.selector, issue.snippet));
+            });
+        });
+    };
+    collect(input.headings, HEADING_RULES, 'headings');
+    collect(input.forms, FORM_RULES, 'forms');
+    collect(input.images, IMAGE_RULES, 'images');
+    if (!patches.some((p) => p.category === 'structured-data')) {
+        patches.push({
+            issueId: 'structured-data:missing-website:0',
+            category: 'structured-data',
+            severity: 'info',
+            lang: 'html',
+            before: '<head>...</head>',
+            after: `<head>...${STRUCTURED_DATA_TEMPLATE}</head>`,
+            rationale: 'Add WebSite JSON-LD so search engines understand the site identity.',
+            confidence: 0.7,
+            docsRef: 'schema.org/WebSite',
+        });
+    }
+    return patches;
+}
+function fence(lang, body) {
+    if (!body)
+        return '';
+    const tag = lang === 'attr' ? 'html' : lang;
+    return '```' + tag + '\n' + body + '\n```';
+}
+export function autoFixesToMarkdown(patches) {
+    return patches.map((patch) => {
+        const lines = [];
+        lines.push(`### ${patch.category}: ${patch.issueId}`);
+        lines.push('');
+        lines.push(`**${patch.severity}** | confidence ${patch.confidence}`);
+        lines.push('');
+        if (patch.selector) {
+            lines.push(`Selector: \`${patch.selector}\``);
+            lines.push('');
+        }
+        if (patch.before) {
+            lines.push('**Before:**');
+            lines.push(fence(patch.lang, patch.before));
+            lines.push('');
+        }
+        if (patch.after) {
+            lines.push('**After:**');
+            lines.push(fence(patch.lang, patch.after));
+            lines.push('');
+        }
+        lines.push(`**Why:** ${patch.rationale}`);
+        if (patch.docsRef) {
+            lines.push('');
+            lines.push(`Reference: ${patch.docsRef}`);
+        }
+        return lines.join('\n');
+    }).join('\n\n');
+}
+//# sourceMappingURL=autofix.js.map