snap-ally 0.2.7-beta → 0.3.0

package/dist/core/A11yVisualReporter.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A11yVisualReporter = void 0;
+/**
+ * Manages visual feedback on the page during an accessibility scan.
+ * Handles element highlights, violation banners, and report attachments.
+ */
+class A11yVisualReporter {
+    constructor(page) {
+        this.page = page;
+        this.rootId = 'snap-ally-visual-root';
+    }
+    /**
+     * Shows a violation banner at the bottom of the page.
+     */
+    async showBanner(violation, color) {
+        await this.safeEvaluate(([v, rawColor, rootId, bannerId]) => {
+            const shadow = window.snapAllyGetRoot(rootId);
+            let container = shadow.getElementById(bannerId);
+            if (!container) {
+                const style = document.createElement('style');
+                style.textContent = `
+                        #${bannerId} {
+                            position: fixed;
+                            left: 50%;
+                            top: 24px;
+                            transform: translateX(-50%);
+                            width: calc(100% - 40px);
+                            max-width: 600px;
+                            padding: 12px 18px;
+                            border-radius: 12px;
+                            color: white;
+                            font-family: system-ui, -apple-system, sans-serif;
+                            font-size: 14px;
+                            display: flex;
+                            align-items: center;
+                            gap: 12px;
+                            box-shadow: 0 12px 40px rgba(0,0,0,0.3);
+                            backdrop-filter: blur(16px) saturate(180%);
+                            -webkit-backdrop-filter: blur(16px) saturate(180%);
+                            border: 1px solid rgba(255,255,255,0.15);
+                            z-index: 10000;
+                            transition: all 0.3s ease;
+                        }
+                        .badge {
+                            background: rgba(255,255,255,0.2);
+                            padding: 2px 8px;
+                            border-radius: 6px;
+                            font-size: 11px;
+                            font-weight: 700;
+                            text-transform: uppercase;
+                            border: 1px solid rgba(255,255,255,0.2);
+                        }
+                        .content { flex: 1; line-height: 1.4; font-weight: 500; }
+                    `;
+                shadow.appendChild(style);
+                container = document.createElement('div');
+                container.id = bannerId;
+                shadow.appendChild(container);
+            }
+            container.style.backgroundColor = window.snapAllyToAlpha(rawColor, 0.85);
+            container.innerHTML = `
+                    <div style="font-size: 20px;">⚠️</div>
+                    <div class="content">
+                        <div style="margin-bottom:4px; display:flex; align-items:center; gap:8px;">
+                            <span class="badge">${v.id}</span>
+                            <span style="opacity: 0.9;">${v.help}</span>
+                        </div>
+                    </div>
+                `;
+        }, [violation, color, this.rootId, A11yVisualReporter.BANNER_ID]);
+    }
+    /**
+     * Highlights an element on the page.
+     */
+    async highlightElement(selector, color) {
+        await this.safeEvaluate(([sel, rawColor, rootId, highlightId]) => {
+            const target = document.querySelector(sel);
+            if (!target)
+                return;
+            target.scrollIntoView({ behavior: 'auto', block: 'center' });
+            const shadow = window.snapAllyGetRoot(rootId);
+            let highlight = shadow.getElementById(highlightId);
+            if (!highlight) {
+                const style = document.createElement('style');
+                style.textContent = `
+                        #${highlightId} {
+                            position: absolute;
+                            pointer-events: none;
+                            border-radius: 8px;
+                            box-sizing: border-box;
+                            z-index: 9999;
+                            transition: all 0.2s ease;
+                            box-shadow: 0 0 0 4px var(--c-alpha), 0 0 20px var(--c-alpha);
+                        }
+                    `;
+                shadow.appendChild(style);
+                highlight = document.createElement('div');
+                highlight.id = highlightId;
+                shadow.appendChild(highlight);
+            }
+            const pad = 4;
+            const rect = target.getBoundingClientRect();
+            highlight.style.left = `${rect.left + window.scrollX - pad}px`;
+            highlight.style.top = `${rect.top + window.scrollY - pad}px`;
+            highlight.style.width = `${rect.width + pad * 2}px`;
+            highlight.style.height = `${rect.height + pad * 2}px`;
+            highlight.style.border = `3px solid ${rawColor}`;
+            highlight.style.setProperty('--c-alpha', window.snapAllyToAlpha(rawColor, 0.3));
+        }, [selector, color, this.rootId, A11yVisualReporter.HIGHLIGHT_ID]);
+    }
+    /**
+     * Removes all visual feedback from the page.
+     */
+    async clean() {
+        await this.safeEvaluate((id) => { var _a; return (_a = document.getElementById(id)) === null || _a === void 0 ? void 0 : _a.remove(); }, this.rootId);
+    }
+    /**
+     * Removes the element highlight.
+     */
+    async removeHighlight() {
+        await this.safeEvaluate(([rootId, hId]) => { var _a, _b, _c; return (_c = (_b = (_a = document.getElementById(rootId)) === null || _a === void 0 ? void 0 : _a.shadowRoot) === null || _b === void 0 ? void 0 : _b.getElementById(hId)) === null || _c === void 0 ? void 0 : _c.remove(); }, [this.rootId, A11yVisualReporter.HIGHLIGHT_ID]);
+    }
+    /**
+     * Attaches JSON data to the test report.
+     */
+    async attachData(testInfo, name, data) {
+        await testInfo.attach(name, {
+            contentType: 'application/json',
+            body: Buffer.from(data),
+        });
+    }
+    /**
+     * Captures and attaches a screenshot to the test report.
+     */
+    async captureScreenshot(name, testInfo) {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { test } = require('@playwright/test');
+        return await test.step('Capture A11y screenshot', async () => {
+            const screenshot = await this.page.screenshot({ fullPage: false });
+            await testInfo.attach(name, { contentType: 'image/png', body: screenshot });
+            return screenshot;
+        });
+    }
+    /**
+     * Injects helper functions into the page context.
+     */
+    async ensureHelpers() {
+        await this.page.evaluate(() => {
+            if (typeof window.snapAllyGetRoot === 'function')
+                return;
+            window.snapAllyGetRoot = (id) => {
+                let root = document.getElementById(id);
+                if (!root) {
+                    root = document.createElement('div');
+                    root.id = id;
+                    root.style.cssText = 'position:absolute;top:0;left:0;width:0;height:0;z-index:2147483647;';
+                    document.body.appendChild(root);
+                    root.attachShadow({ mode: 'open' });
+                }
+                return root.shadowRoot;
+            };
+            window.snapAllyToAlpha = (color, alpha) => {
+                if (color.startsWith('rgba'))
+                    return color.replace(/[\d.]+\)$/, `${alpha})`);
+                if (color.startsWith('rgb'))
+                    return color.replace('rgb', 'rgba').replace(')', `, ${alpha})`);
+                const hex = Math.round(alpha * 255).toString(16).padStart(2, '0');
+                return `${color}${hex}`;
+            };
+        });
+    }
+    async safeEvaluate(fn, arg) {
+        try {
+            await this.ensureHelpers();
+            await (arg !== undefined ? this.page.evaluate(fn, arg) : this.page.evaluate(fn));
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            if (msg.includes('closed') || msg.includes('destroyed') || msg.includes('ended'))
+                return;
+            throw e;
+        }
+    }
+}
+exports.A11yVisualReporter = A11yVisualReporter;
+A11yVisualReporter.BANNER_ID = 'snap-ally-banner';
+A11yVisualReporter.HIGHLIGHT_ID = 'snap-ally-highlight';

package/dist/core/HtmlRenderer.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Handles the rendering of HTML reports using static templates and JSON data injection.
+ */
+export declare class HtmlRenderer {
+    /**
+     * Renders a static HTML template by copying it and generating the accompanied data payload.
+     */
+    render(templateName: string, data: Record<string, unknown>, _outputFolder: string, // Kept for signature compatibility
+    outputFileName: string): Promise<void>;
+    /**
+     * Converts ANSI color codes to HTML spans for nicer error display.
+     */
+    ansiToHtml(text: string): string;
+}

package/dist/core/HtmlRenderer.js

@@ -0,0 +1,106 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HtmlRenderer = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Handles the rendering of HTML reports using static templates and JSON data injection.
+ */
+class HtmlRenderer {
+    /**
+     * Renders a static HTML template by copying it and generating the accompanied data payload.
+     */
+    async render(templateName, data, _outputFolder, // Kept for signature compatibility
+    outputFileName) {
+        // Resolve path relative to this file (dist/core/HtmlRenderer.js)
+        const templatesDir = path.join(__dirname, '..', 'templates');
+        const templatePath = path.join(templatesDir, templateName);
+        const cssPath = path.join(templatesDir, 'global-report-styles.css');
+        const jsPath = path.join(templatesDir, 'report-app.js');
+        if (!fs.existsSync(templatePath)) {
+            throw new Error(`[HtmlRenderer] Template not found: ${templatePath}`);
+        }
+        let html = fs.readFileSync(templatePath, 'utf8');
+        // Inline CSS
+        if (fs.existsSync(cssPath)) {
+            const css = fs.readFileSync(cssPath, 'utf8');
+            html = html.replace('</head>', `<style>\n${css}\n</style>\n</head>`);
+            // Remove the link tag if it exists
+            html = html.replace(/<link[^>]*global-report-styles\.css[^>]*>/, '');
+        }
+        // Inline Data
+        const jsData = `window.snapAllyData = ${JSON.stringify(data)};`;
+        html = html.replace('<script src="data.js"></script>', `<script>\n${jsData}\n</script>`);
+        // Inline main logic
+        if (fs.existsSync(jsPath)) {
+            const js = fs.readFileSync(jsPath, 'utf8');
+            html = html.replace('<script src="report-app.js"></script>', `<script>\n${js}\n</script>`);
+        }
+        // Final cleanup of any potential remaining dummy scripts
+        html = html.replace(/<script src="data-[^>]*\.js"><\/script>/, '');
+        // Ensure the output directory exists before writing
+        const outputDir = path.dirname(outputFileName);
+        if (!fs.existsSync(outputDir)) {
+            fs.mkdirSync(outputDir, { recursive: true });
+        }
+        fs.writeFileSync(outputFileName, html, 'utf8');
+    }
+    /**
+     * Converts ANSI color codes to HTML spans for nicer error display.
+     */
+    ansiToHtml(text) {
+        const map = {
+            '\u001b[30m': '<span style="color:black">',
+            '\u001b[31m': '<span style="color:red">',
+            '\u001b[32m': '<span style="color:green">',
+            '\u001b[33m': '<span style="color:yellow">',
+            '\u001b[34m': '<span style="color:blue">',
+            '\u001b[35m': '<span style="color:magenta">',
+            '\u001b[36m': '<span style="color:cyan">',
+            '\u001b[37m': '<span style="color:white">',
+            '\u001b[0m': '</span>',
+            '\u001b[2m': '<span style="opacity:0.5">',
+            '\u001b[22m': '</span>',
+            '\u001b[39m': '</span>',
+        };
+        let result = text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+        for (const [code, tag] of Object.entries(map)) {
+            result = result.split(code).join(tag);
+        }
+        return result;
+    }
+}
+exports.HtmlRenderer = HtmlRenderer;

package/dist/core/ReportAssets.d.ts

@@ -0,0 +1,29 @@
+import { TestResult } from '@playwright/test/reporter';
+/**
+ * Utilities for managing and copying report assets like videos and screenshots.
+ */
+export declare class ReportAssets {
+    /**
+     * Copies a file from source to a destination folder.
+     */
+    copyToFolder(destFolder: string, srcPath: string, fileName?: string): string;
+    /**
+     * Copies all video attachments to the report folder for portability.
+     */
+    copyVideos(result: TestResult, destFolder: string): string[];
+    /**
+     * Copies all screenshots found in the test attachments.
+     */
+    copyScreenshots(result: TestResult, destFolder: string): string[];
+    /**
+     * Copies all other attachments (traces, logs, etc.) to the report folder.
+     */
+    copyAllOtherAttachments(result: TestResult, destFolder: string): {
+        path: string;
+        name: string;
+    }[];
+    /**
+     * Persists an in-memory buffer to a file in the destination folder.
+     */
+    saveBuffer(destFolder: string, fileName: string, buffer: Buffer): string;
+}

package/dist/core/ReportAssets.js

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReportAssets = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Utilities for managing and copying report assets like videos and screenshots.
+ */
+class ReportAssets {
+    /**
+     * Copies a file from source to a destination folder.
+     */
+    copyToFolder(destFolder, srcPath, fileName) {
+        if (!srcPath || !fs.existsSync(srcPath)) {
+            return '';
+        }
+        const name = fileName || path.basename(srcPath);
+        const destFile = path.join(destFolder, name);
+        if (!fs.existsSync(destFolder)) {
+            fs.mkdirSync(destFolder, { recursive: true });
+        }
+        fs.copyFileSync(srcPath, destFile);
+        return name;
+    }
+    /**
+     * Copies all video attachments to the report folder for portability.
+     */
+    copyVideos(result, destFolder) {
+        return result.attachments
+            .filter((a) => (a.name === 'video' || (a.contentType || '').startsWith('video/')) && a.path)
+            .map((attachment) => this.copyToFolder(destFolder, attachment.path))
+            .filter((p) => !!p);
+    }
+    /**
+     * Copies all screenshots found in the test attachments.
+     */
+    copyScreenshots(result, destFolder) {
+        return result.attachments
+            .filter((a) => a.name === 'screenshot' ||
+            a.name.endsWith('.png') ||
+            (a.contentType || '').startsWith('image/'))
+            .map((a) => {
+            if (a.path) {
+                return this.copyToFolder(destFolder, a.path, a.name !== 'screenshot' ? a.name : undefined);
+            }
+            else if (a.body) {
+                const timestamp = Date.now();
+                const name = a.name === 'screenshot'
+                    ? `screenshot-${timestamp}.png`
+                    : a.name.endsWith('.png')
+                        ? a.name
+                        : `${a.name}.png`;
+                return this.saveBuffer(destFolder, name, a.body);
+            }
+            return '';
+        })
+            .filter((path) => path !== '');
+    }
+    /**
+     * Copies all other attachments (traces, logs, etc.) to the report folder.
+     */
+    copyAllOtherAttachments(result, destFolder) {
+        const excludedNames = ['screenshot', 'video', 'A11y'];
+        return result.attachments
+            .filter((a) => !excludedNames.includes(a.name) &&
+            !a.name.toLowerCase().endsWith('.png') &&
+            !(a.contentType || '').startsWith('image/') &&
+            !(a.contentType || '').startsWith('video/'))
+            .map((a) => {
+            let name = '';
+            if (a.path) {
+                name = this.copyToFolder(destFolder, a.path, a.name);
+            }
+            else if (a.body) {
+                name = this.saveBuffer(destFolder, a.name, a.body);
+            }
+            return name ? { path: name, name: a.name } : null;
+        })
+            .filter((item) => item !== null);
+    }
+    /**
+     * Persists an in-memory buffer to a file in the destination folder.
+     */
+    saveBuffer(destFolder, fileName, buffer) {
+        if (!fs.existsSync(destFolder)) {
+            fs.mkdirSync(destFolder, { recursive: true });
+        }
+        const destFile = path.join(destFolder, fileName);
+        fs.writeFileSync(destFile, buffer);
+        return fileName;
+    }
+}
+exports.ReportAssets = ReportAssets;

package/dist/core/Scanner.d.ts

@@ -0,0 +1,7 @@
+import type { Page, TestInfo } from '@playwright/test';
+import { ScannerOptions } from '../models';
+/**
+ * Performs an accessibility audit using Axe and Lighthouse.
+ */
+export declare function scanA11y(page: Page, testInfo: TestInfo, options?: ScannerOptions): Promise<void>;
+export declare const checkAccessibility: typeof scanA11y;

package/dist/core/Scanner.js

@@ -0,0 +1,162 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAccessibility = void 0;
+exports.scanA11y = scanA11y;
+const playwright_1 = __importDefault(require("@axe-core/playwright"));
+const test_1 = require("@playwright/test");
+const VisualReporter_1 = require("./VisualReporter");
+const models_1 = require("../models");
+const TimeUtils_1 = require("../utils/TimeUtils");
+/**
+ * Sanitizes a string to be safe for use in file paths and prevents path traversal attacks.
+ */
+function sanitizePageKey(input) {
+    return (input
+        .replace(/^https?:\/\//, '')
+        .replace(/[\/\\:*?"<>|]/g, '-')
+        .replace(/\.\./g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .toLowerCase()
+        .substring(0, 200));
+}
+/**
+ * Performs an accessibility audit using Axe and Lighthouse.
+ */
+async function scanA11y(page, testInfo, options = {}) {
+    var _a, _b, _c, _d, _e, _f;
+    const showTerminal = (_a = options.verbose) !== null && _a !== void 0 ? _a : true;
+    const showBrowser = (_b = options.consoleLog) !== null && _b !== void 0 ? _b : true;
+    const rawPageKey = options.pageKey || page.url();
+    const pageKey = sanitizePageKey(rawPageKey);
+    const overlay = new VisualReporter_1.VisualReporter(page);
+    let axeBuilder = new playwright_1.default({ page });
+    const target = options.include || options.box;
+    if (target) {
+        if (typeof target === 'string') {
+            axeBuilder = axeBuilder.include(target);
+        }
+        else {
+            axeBuilder = axeBuilder.include(target);
+        }
+    }
+    if (options.rules) {
+        axeBuilder = axeBuilder.options({ rules: options.rules });
+    }
+    if (options.tags) {
+        axeBuilder = axeBuilder.withTags(options.tags);
+    }
+    if (options.axeOptions) {
+        axeBuilder = axeBuilder.options(options.axeOptions);
+    }
+    let axeResults;
+    try {
+        axeResults = await axeBuilder.analyze();
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            (error.message.includes('Test ended') ||
+                error.message.includes('Target page, context or browser has been closed'))) {
+            console.warn(`[SnapAlly] Accessibility scan skipped: ${error.message}`);
+            return;
+        }
+        throw error;
+    }
+    const violationCount = axeResults.violations.length;
+    if ((showTerminal || showBrowser) && violationCount > 0) {
+        const mainMsg = `[A11yScanner] Violations found: ${violationCount}`;
+        const detailMessages = axeResults.violations.map(
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        (v, i) => `  ${i + 1}. ${v.id} [${v.impact}] - ${v.help}`);
+        if (showTerminal) {
+            console.log(`\n${mainMsg}`);
+            detailMessages.forEach((msg) => console.log(msg));
+        }
+        if (showBrowser) {
+            await page.evaluate(([mainMsg, details, color]) => {
+                console.log(`%c ${mainMsg}`, `color: ${color}; font-weight: bold; font-size: 12px;`);
+                details.forEach((msg) => console.log(msg));
+            }, [mainMsg, detailMessages, models_1.DEFAULT_COLORS.serious]);
+        }
+    }
+    test_1.expect
+        .soft(violationCount, `Accessibility audit failed with ${violationCount} violations.`)
+        .toBe(0);
+    const reporterConfig = testInfo.config.reporter.find((r) => Array.isArray(r) &&
+        (typeof r[0] === 'string' &&
+            (r[0].includes('SnapAllyReporter') || r[0].endsWith('src/SnapAllyReporter.ts'))));
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const customColors = reporterConfig && Array.isArray(reporterConfig) ? (_c = reporterConfig[1]) === null || _c === void 0 ? void 0 : _c.colors : undefined;
+    const errors = [];
+    for (const violation of axeResults.violations) {
+        let errorIdx = 0;
+        const targets = [];
+        const severityColor = (0, models_1.getSeverityColor)(violation.impact, customColors);
+        for (const node of violation.nodes) {
+            for (const selector of node.target) {
+                const elementSelector = selector.toString();
+                const locator = page.locator(elementSelector);
+                await overlay.showBanner({ id: violation.id, help: violation.help }, severityColor);
+                if (await locator.isVisible()) {
+                    await overlay.highlightElement(elementSelector, severityColor);
+                    // eslint-disable-next-line playwright/no-wait-for-timeout
+                    await page.waitForTimeout(100);
+                    const screenshotName = `a11y-${violation.id}-${errorIdx++}.png`;
+                    const buffer = await overlay.captureScreenshot(testInfo, screenshotName);
+                    const excluded = new Set([
+                        'Pre Condition',
+                        'Post Condition',
+                        'Description',
+                        'A11y',
+                    ]);
+                    const contextSteps = (testInfo.annotations || [])
+                        .filter((a) => !excluded.has(a.type))
+                        .map((a) => a.description || '');
+                    const nodeHtml = node.html || '';
+                    const friendlySnippet = elementSelector;
+                    targets.push({
+                        element: elementSelector,
+                        snippet: friendlySnippet,
+                        html: nodeHtml,
+                        screenshot: screenshotName,
+                        steps: contextSteps,
+                        stepsJson: JSON.stringify(contextSteps),
+                        screenshotBase64: buffer.toString('base64'),
+                    });
+                    await overlay.removeHighlight();
+                }
+            }
+        }
+        errors.push({
+            id: violation.id,
+            description: violation.description,
+            severity: violation.impact || 'unknown',
+            helpUrl: violation.helpUrl,
+            help: violation.help,
+            guideline: violation.tags[1] || 'N/A',
+            wcagRule: violation.tags.find((t) => t.startsWith('wcag')) || violation.tags[1] || 'N/A',
+            total: targets.length || violation.nodes.length,
+            target: targets,
+        });
+    }
+    const reportData = {
+        pageKey,
+        pageUrl: page.url(),
+        accessibilityScore: 0,
+        a11yErrors: errors,
+        criticalColor: (customColors === null || customColors === void 0 ? void 0 : customColors.critical) || models_1.DEFAULT_COLORS.critical,
+        seriousColor: (customColors === null || customColors === void 0 ? void 0 : customColors.serious) || models_1.DEFAULT_COLORS.serious,
+        moderateColor: (customColors === null || customColors === void 0 ? void 0 : customColors.moderate) || models_1.DEFAULT_COLORS.moderate,
+        minorColor: (customColors === null || customColors === void 0 ? void 0 : customColors.minor) || models_1.DEFAULT_COLORS.minor,
+        adoOrganization: ((_d = options.ado) === null || _d === void 0 ? void 0 : _d.organization) || process.env.ADO_ORGANIZATION || '',
+        adoProject: ((_e = options.ado) === null || _e === void 0 ? void 0 : _e.project) || process.env.ADO_PROJECT || '',
+        adoAreaPath: ((_f = options.ado) === null || _f === void 0 ? void 0 : _f.areaPath) || process.env.ADO_AREA_PATH || '',
+        timestamp: TimeUtils_1.TimeUtils.formatDate(new Date()),
+    };
+    await overlay.attachJsonData(testInfo, 'A11y', JSON.stringify(reportData));
+    await overlay.cleanupOverlay();
+}
+exports.checkAccessibility = scanA11y;