snap-ally 0.2.7-beta → 0.3.0

package/dist/SnapAllyReporter.js

@@ -33,45 +33,23 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-const models_1 = require("./models");
-const A11yReportAssets_1 = require("./A11yReportAssets");
-const A11yHtmlRenderer_1 = require("./A11yHtmlRenderer");
-const A11yTimeUtils_1 = require("./A11yTimeUtils");
-const path = __importStar(require("path"));
 const fs = __importStar(require("fs"));
-/** Default severity colors used when the user doesn't override them. */
-const DEFAULT_COLORS = {
-    critical: '#c92a2a',
-    serious: '#e67700',
-    moderate: '#ca8a04',
-    minor: '#0891b2',
-};
-// ────────────────────────────────────────────────────────────────────────────
-//  Reporter
-// ────────────────────────────────────────────────────────────────────────────
+const path = __importStar(require("path"));
+const HtmlRenderer_1 = require("./core/HtmlRenderer");
+const ReportAssets_1 = require("./core/ReportAssets");
+const TimeUtils_1 = require("./utils/TimeUtils");
+const models_1 = require("./models");
 /**
  * Playwright reporter for accessibility audits and test steps.
- *
- * Generates:
- * - A per-test execution report (steps, video, screenshots, errors)
- * - A per-scan accessibility report (violations, evidence, ADO integration)
- * - A global execution summary with per-browser breakdowns
  */
 class SnapAllyReporter {
     constructor(options = {}) {
         var _a, _b, _c, _d;
-        this.assetsManager = new A11yReportAssets_1.A11yReportAssets();
-        this.renderer = new A11yHtmlRenderer_1.A11yHtmlRenderer();
+        this.assetsManager = new ReportAssets_1.ReportAssets();
+        this.renderer = new HtmlRenderer_1.HtmlRenderer();
         this.projectRoot = 'tests';
-        /**
-         * Monotonically increasing test counter.
-         * Incremented synchronously in {@link onTestEnd} to avoid race conditions
-         * when multiple async {@link processTestResult} calls run concurrently.
-         */
         this.testIndex = 0;
-        /** Async tasks queued by `onTestEnd`; drained in `onEnd`. */
         this.tasks = [];
-        /** Aggregated data for the final summary report. */
         this.executionSummary = {
             duration: '',
             status: '',
@@ -86,341 +64,196 @@ class SnapAllyReporter {
             totalA11yErrorCount: 0,
             browserSummaries: {},
             date: '',
+            colors: {},
         };
+        this.testRuleCounts = {};
+        this.testGlobalCounts = {};
         this.options = options;
         this.outputFolder = path.resolve(process.cwd(), options.outputFolder || 'steps-report');
+        this.validateOutputFolder(this.outputFolder);
         this.colors = {
-            critical: ((_a = options.colors) === null || _a === void 0 ? void 0 : _a.critical) || DEFAULT_COLORS.critical,
-            serious: ((_b = options.colors) === null || _b === void 0 ? void 0 : _b.serious) || DEFAULT_COLORS.serious,
-            moderate: ((_c = options.colors) === null || _c === void 0 ? void 0 : _c.moderate) || DEFAULT_COLORS.moderate,
-            minor: ((_d = options.colors) === null || _d === void 0 ? void 0 : _d.minor) || DEFAULT_COLORS.minor,
+            critical: ((_a = options.colors) === null || _a === void 0 ? void 0 : _a.critical) || models_1.DEFAULT_COLORS.critical,
+            serious: ((_b = options.colors) === null || _b === void 0 ? void 0 : _b.serious) || models_1.DEFAULT_COLORS.serious,
+            moderate: ((_c = options.colors) === null || _c === void 0 ? void 0 : _c.moderate) || models_1.DEFAULT_COLORS.moderate,
+            minor: ((_d = options.colors) === null || _d === void 0 ? void 0 : _d.minor) || models_1.DEFAULT_COLORS.minor,
         };
+        this.executionSummary.colors = this.colors;
     }
     printsToStdio() {
-        return false;
+        return true;
+    }
+    /**
+     * Validates that the output folder is safe to delete.
+     * Prevents accidental deletion of critical directories like repo root, parent dirs, or system paths.
+     */
+    validateOutputFolder(resolvedPath) {
+        const cwd = process.cwd();
+        const normalizedPath = path.normalize(resolvedPath);
+        const normalizedCwd = path.normalize(cwd);
+        // Prevent deletion of current working directory
+        if (normalizedPath === normalizedCwd) {
+            throw new Error(`[SnapAlly] Invalid outputFolder: Cannot delete the current working directory. ` +
+                `Resolved path: "${resolvedPath}"`);
+        }
+        // Prevent deletion of parent directories
+        if (normalizedCwd.startsWith(normalizedPath + path.sep) || normalizedCwd.startsWith(normalizedPath + '/')) {
+            throw new Error(`[SnapAlly] Invalid outputFolder: Cannot delete a parent directory of the current working directory. ` +
+                `Resolved path: "${resolvedPath}"`);
+        }
+        // Prevent deletion of root or near-root directories
+        const pathSegments = normalizedPath.split(path.sep).filter(s => s.length > 0);
+        if (pathSegments.length <= 1) {
+            throw new Error(`[SnapAlly] Invalid outputFolder: Path is too close to root directory. ` +
+                `Resolved path: "${resolvedPath}"`);
+        }
+        // Ensure the path is within the current working directory (safest approach)
+        if (!normalizedPath.startsWith(normalizedCwd + path.sep) && !normalizedPath.startsWith(normalizedCwd + '/')) {
+            throw new Error(`[SnapAlly] Invalid outputFolder: Path must be within the current working directory. ` +
+                `Resolved path: "${resolvedPath}", CWD: "${cwd}"`);
+        }
     }
     onBegin(config) {
-        this.projectRoot = config.rootDir || 'tests';
+        this.projectRoot = config.rootDir;
+        if (fs.existsSync(this.outputFolder)) {
+            fs.rmSync(this.outputFolder, { recursive: true, force: true });
+        }
     }
     onTestEnd(test, result) {
-        // Increment index synchronously so concurrent tasks never share an index.
         const index = ++this.testIndex;
         this.tasks.push(this.processTestResult(test, result, index));
     }
     async onEnd(result) {
         await Promise.all(this.tasks);
-        this.executionSummary.duration = A11yTimeUtils_1.A11yTimeUtils.formatDuration(result.duration);
+        const summaryPath = path.join(this.outputFolder, 'summary.html');
         this.executionSummary.status = result.status;
         this.executionSummary.statusIcon =
-            models_1.TestStatusIcon[result.status] || 'help';
-        this.executionSummary.date = A11yTimeUtils_1.A11yTimeUtils.formatDate(new Date());
-        const summaryFile = path.join(this.outputFolder, 'summary.html');
-        await this.renderer.render('execution-summary.html', { ...this.executionSummary, colors: this.colors }, this.outputFolder, summaryFile);
-        console.log(`\n[SnapAlly] Reports generated in: ${path.resolve(this.outputFolder)}`);
+            result.status === 'passed' ? models_1.TestStatusIcon.passed : models_1.TestStatusIcon.failed;
+        this.executionSummary.date = TimeUtils_1.TimeUtils.formatDate(new Date());
+        this.executionSummary.duration = TimeUtils_1.TimeUtils.formatDuration(result.duration);
+        await this.renderer.render('execution-summary.html', this.executionSummary, this.outputFolder, summaryPath);
+        console.log(`\n[SnapAlly] Report generated: ${summaryPath}`);
     }
-    // ────────────────────────────────────────────────────────────────────────
-    //  Core per-test processing
-    // ────────────────────────────────────────────────────────────────────────
     async processTestResult(test, result, index) {
-        const sanitizedTitle = test.title.replace(/[^a-z0-9]+/gi, '-').toLowerCase();
-        const testFolderName = `${index}-${sanitizedTitle}`;
-        const testResultsFolder = path.join(this.outputFolder, testFolderName);
-        const fileGroup = path.relative(this.projectRoot, test.location.file);
-        this.ensureGroupExists(fileGroup);
-        const browser = this.resolveBrowser(test);
-        const testMeta = this.extractTestMetadata(test, result);
-        // Copy assets
-        const video = await this.assetsManager.copyTestVideo(result, testResultsFolder);
-        const screenshots = this.assetsManager.copyScreenshots(result, testResultsFolder);
-        const allAttachments = [
-            ...this.assetsManager.copyPngAttachments(result, testResultsFolder),
-            ...this.assetsManager.copyAllOtherAttachments(result, testResultsFolder),
-        ];
-        const errorLogs = this.extractErrorLogs(result);
-        // Accessibility processing
-        const a11yResult = await this.processAccessibilityData(test, result, sanitizedTitle, testResultsFolder, testMeta.steps, video, browser, errorLogs);
-        // Update browser & global summary counts
-        this.updateBrowserSummary(browser, result.status);
-        this.updateGlobalSummary(test, result);
-        // Build the test stats object
-        const executionReportName = `execution-${sanitizedTitle}.html`;
-        const testStats = {
+        var _a, _b, _c, _d;
+        const testFolderName = `test-${index}`;
+        const testFolder = path.join(this.outputFolder, testFolderName);
+        const videoPath = this.assetsManager.copyVideos(result, testFolder);
+        const screenshotPaths = this.assetsManager.copyScreenshots(result, testFolder);
+        const attachments = this.assetsManager.copyAllOtherAttachments(result, testFolder);
+        const a11yAttachment = result.attachments.find((a) => a.name === 'A11y');
+        if (a11yAttachment) {
+            console.log(`[SnapAlly] Found A11y attachment for project: ${test._projectId}`);
+        }
+        else {
+            console.warn(`[SnapAlly] A11y attachment missing for test: ${test.title}. Available: ${result.attachments.map(a => a.name).join(', ')}`);
+        }
+        let a11yData = null;
+        if (a11yAttachment && a11yAttachment.body) {
+            try {
+                a11yData = JSON.parse(a11yAttachment.body.toString());
+            }
+            catch (err) {
+                console.error(`[SnapAlly] Failed to parse A11y attachment: ${err}. Body was: ${a11yAttachment.body.toString().substring(0, 100)}`);
+            }
+        }
+        // Handle cases where a11yData might be the direct ReportData or wrapped in a data property
+        const actualData = (a11yData === null || a11yData === void 0 ? void 0 : a11yData.data) || a11yData;
+        const violations = (actualData === null || actualData === void 0 ? void 0 : actualData.a11yErrors) || (actualData === null || actualData === void 0 ? void 0 : actualData.violations) || [];
+        const a11yErrorCount = violations.reduce((acc, curr) => { var _a, _b; return acc + (curr.total || ((_a = curr.target) === null || _a === void 0 ? void 0 : _a.length) || ((_b = curr.nodes) === null || _b === void 0 ? void 0 : _b.length) || 0); }, 0);
+        const filteredSteps = (() => {
+            const sRaw = result.steps.map(s => s.title);
+            const blocklist = ['Evaluate', 'Create page', 'Close page', 'Before Hooks', 'After Hooks', 'Worker Teardown', 'Worker Cleanup', 'Attach', 'Wait for timeout', 'Capture A11y screenshot'];
+            const filtered = result.steps
+                .filter((s) => !blocklist.some(b => s.title.includes(b)))
+                .map((s) => s.title);
+            console.log(`[SnapAlly] Steps for ${test.title}: Raw=${sRaw.length}, Filtered=${filtered.length}`);
+            return filtered;
+        })();
+        const testResults = {
             num: index,
             folderName: testFolderName,
-            executionReportPath: `${testFolderName}/${executionReportName}`,
             title: test.title,
-            fileName: fileGroup,
+            fileName: path.relative(this.projectRoot, test.location.file),
+            duration: TimeUtils_1.TimeUtils.formatDuration(result.duration),
             timeDuration: result.duration,
-            duration: A11yTimeUtils_1.A11yTimeUtils.formatDuration(result.duration),
-            description: testMeta.description,
+            description: '', // Could extract from annotations if needed
             status: result.status,
-            browser,
-            tags: testMeta.tags,
-            preConditions: testMeta.preConditions,
-            steps: testMeta.steps,
-            postConditions: testMeta.postConditions,
-            statusIcon: testMeta.statusIcon,
-            pageUrl: a11yResult.pageUrl,
-            videoPath: video,
-            screenshotPaths: screenshots,
-            attachments: allAttachments,
-            errors: errorLogs,
-            a11yReportPath: a11yResult.reportPath,
-            a11yErrorCount: a11yResult.errorCount,
-            a11yErrors: a11yResult.errors,
-            colors: this.options.colors,
+            statusIcon: this.getStatusIcon(result.status),
+            browser: (() => {
+                var _a, _b;
+                if (test.outcome() === 'skipped')
+                    return 'n/a';
+                const bName = test._projectId ||
+                    ((_b = (_a = test.parent) === null || _a === void 0 ? void 0 : _a.project()) === null || _b === void 0 ? void 0 : _b.name) ||
+                    test.projectName ||
+                    'chromium';
+                return bName;
+            })(),
+            adoOrganization: ((_a = this.options.ado) === null || _a === void 0 ? void 0 : _a.organization) || (actualData === null || actualData === void 0 ? void 0 : actualData.adoOrganization),
+            adoProject: ((_b = this.options.ado) === null || _b === void 0 ? void 0 : _b.project) || (actualData === null || actualData === void 0 ? void 0 : actualData.adoProject),
+            adoAreaPath: ((_c = this.options.ado) === null || _c === void 0 ? void 0 : _c.areaPath) || (actualData === null || actualData === void 0 ? void 0 : actualData.adoAreaPath),
+            timestamp: new Date().toLocaleString(),
+            pageUrl: (actualData === null || actualData === void 0 ? void 0 : actualData.pageUrl) || (actualData === null || actualData === void 0 ? void 0 : actualData.pageKey) || 'Resource',
+            tags: [], // Extract from test tags if available
+            preConditions: [],
+            steps: filteredSteps,
+            postConditions: [],
+            videoPath: videoPath.length > 0 ? videoPath : null,
+            screenshotPaths,
+            attachments,
+            errors: result.errors.map((e) => this.renderer.ansiToHtml(e.message || '')),
+            a11yErrors: violations.map((v) => ({
+                ...v,
+                target: (v.target || []).map((t) => ({
+                    ...t,
+                    steps: (t.steps && t.steps.length > 0) ? t.steps : filteredSteps
+                }))
+            })),
+            a11yErrorCount: a11yErrorCount,
+            colors: this.colors,
         };
-        this.executionSummary.groupedResults[fileGroup].push(testStats);
-        // Render the per-test execution report
-        const indexFile = path.join(testResultsFolder, executionReportName);
-        await this.renderer.render('test-execution-report.html', { ...testStats, colors: this.colors }, testResultsFolder, indexFile);
-    }
-    // ────────────────────────────────────────────────────────────────────────
-    //  Metadata extraction
-    // ────────────────────────────────────────────────────────────────────────
-    /** Extracts structured metadata from test annotations and result steps. */
-    extractTestMetadata(test, result) {
-        const tags = test.tags.map((t) => t.replace('@', ''));
-        const statusIcon = models_1.TestStatusIcon[result.status] || 'help';
-        const descAnnotation = test.annotations.find((a) => a.type === 'Description');
-        const description = (descAnnotation === null || descAnnotation === void 0 ? void 0 : descAnnotation.description) || 'No Description';
-        const steps = result.steps
-            .filter((s) => s.category === 'test.step')
-            .map((s) => s.title);
-        const preConditions = test.annotations
-            .filter((a) => a.type === 'Pre Condition')
-            .map((a) => a.description || '');
-        const postConditions = test.annotations
-            .filter((a) => a.type === 'Post Condition')
-            .map((a) => a.description || '');
-        return { tags, statusIcon, description, steps, preConditions, postConditions };
-    }
-    /** Determines the browser name for the current test. */
-    resolveBrowser(test) {
-        const project = test.parent.project();
-        // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const projectUse = (project === null || project === void 0 ? void 0 : project.use) || {};
-        return ((project === null || project === void 0 ? void 0 : project.name) ||
-            projectUse.browserName ||
-            projectUse.defaultBrowserType ||
-            'chromium');
-    }
-    /** Converts Playwright error objects into HTML-safe strings. */
-    extractErrorLogs(result) {
-        return (result.errors || []).map((err) => {
-            const fullMsg = err.stack
-                ? `${err.message}\n${err.stack}`
-                : err.message || 'Error occurred';
-            return this.renderer.ansiToHtml(fullMsg);
-        });
-    }
-    // ────────────────────────────────────────────────────────────────────────
-    //  Accessibility data processing
-    // ────────────────────────────────────────────────────────────────────────
-    /** Return value for {@link processAccessibilityData}. */
-    async processAccessibilityData(test, result, sanitizedTitle, testResultsFolder, steps, video, browser, errorLogs) {
-        var _a;
-        const sources = this.collectA11yDataSources(test, result);
-        if (sources.length === 0) {
-            return { errorCount: 0, errors: [] };
-        }
-        let reportPath;
-        let errorCount = 0;
-        const aggregatedErrors = [];
-        let pageUrl;
-        for (const [index, source] of sources.entries()) {
-            const reportData = this.parseA11ySource(source, errorLogs);
-            if (!reportData)
-                continue;
-            const reportName = this.buildA11yReportName(sanitizedTitle, reportData.pageKey, index, sources.length);
-            reportPath = reportName;
-            this.applyReportConfig(reportData, video);
-            this.backfillSteps(reportData, steps);
-            const auditFile = path.join(testResultsFolder, reportName);
-            await this.renderer.render('accessibility-report.html', { data: reportData, folderTest: testResultsFolder }, testResultsFolder, auditFile);
-            if (reportData.pageUrl && !pageUrl) {
-                pageUrl = reportData.pageUrl;
-            }
-            // Aggregate a11y errors into browser & global summaries
-            if ((_a = reportData.a11yErrors) === null || _a === void 0 ? void 0 : _a.length) {
-                const scanCount = this.aggregateA11yErrors(reportData.a11yErrors, browser);
-                errorCount += scanCount;
-                aggregatedErrors.push(...reportData.a11yErrors);
-            }
-        }
-        return { reportPath, errorCount, errors: aggregatedErrors, pageUrl };
-    }
-    /** Collects all A11y data sources (attachments + annotations) for a test. */
-    collectA11yDataSources(test, result) {
-        const attachments = (result.attachments || [])
-            .filter((a) => a.name === 'A11y')
-            .map((a) => ({ type: 'attachment', data: a }));
-        const annotations = (test.annotations || [])
-            .filter((a) => a.type === 'A11y')
-            .map((a) => ({ type: 'annotation', data: a }));
-        return [...attachments, ...annotations];
-    }
-    /** Attempts to parse a single A11y data source into a ReportData object. */
-    parseA11ySource(source, errorLogs) {
-        try {
-            if (source.type === 'attachment') {
-                const attach = source.data;
-                if (attach.body) {
-                    return JSON.parse(attach.body.toString());
-                }
-                if (attach.path && fs.existsSync(attach.path)) {
-                    return JSON.parse(fs.readFileSync(attach.path, 'utf-8'));
-                }
-                return null;
-            }
-            // annotation
-            const annot = source.data;
-            return JSON.parse(annot.description || '{}');
-        }
-        catch (e) {
-            console.error(`[SnapAlly] Failed to parse A11y ${source.type}: ${e}`);
-            errorLogs.push(this.renderer.ansiToHtml(`[SnapAlly] Internal error parsing accessibility data from ${source.type}: ${e}`));
-            return null;
-        }
-    }
-    /** Generates a sanitized HTML filename for an accessibility report. */
-    buildA11yReportName(sanitizedTitle, pageKey, index, totalScans) {
-        const hasMultiple = totalScans > 1;
-        const suffix = hasMultiple ? `-${index + 1}` : '';
-        if (pageKey) {
-            const sanitizedKey = pageKey
-                .replace(/https?:\/\//, '')
-                .replace(/[^a-z0-9]+/gi, '-')
-                .replace(/^-+|-+$/g, '')
-                .toLowerCase();
-            if (sanitizedKey) {
-                return `${sanitizedKey}${suffix}.html`;
-            }
+        const reportFileName = 'report.html';
+        const a11yReportFileName = 'accessibility-report.html';
+        testResults.executionReportPath = `${testFolderName}/${reportFileName}`;
+        // Generate separate accessibility report if there are a11y errors
+        if (violations.length > 0) {
+            testResults.a11yReportPath = `${testFolderName}/${a11yReportFileName}`;
+            const a11yReportPath = path.join(testFolder, a11yReportFileName);
+            console.log(`[SnapAlly] Generating A11y report for ${test.title} (Browser: ${testResults.browser})`);
+            await this.renderer.render('accessibility-report.html', testResults, testFolder, a11yReportPath);
         }
-        return `accessibility-${sanitizedTitle}${suffix}.html`;
+        console.log(`[SnapAlly] Data state for "${test.title}": browser=${testResults.browser}, a11yErrors=${((_d = testResults.a11yErrors) === null || _d === void 0 ? void 0 : _d.length) || 0}`);
+        const reportPath = path.join(testFolder, reportFileName);
+        await this.renderer.render('test-execution-report.html', testResults, testFolder, reportPath);
+        this.updateSummary(test, testResults);
     }
-    /** Applies reporter-level configuration (colors, ADO, video) to a ReportData object. */
-    applyReportConfig(reportData, video) {
-        reportData.criticalColor = this.colors.critical;
-        reportData.seriousColor = this.colors.serious;
-        reportData.moderateColor = this.colors.moderate;
-        reportData.minorColor = this.colors.minor;
-        if (this.options.ado) {
-            reportData.adoOrganization =
-                this.options.ado.organization || reportData.adoOrganization;
-            reportData.adoProject = this.options.ado.project || reportData.adoProject;
-            if (this.options.ado.areaPath) {
-                reportData.adoAreaPath = this.options.ado.areaPath;
-            }
-        }
-        if (video) {
-            reportData.video = video;
-        }
-    }
-    /**
-     * Backfills reproduction steps from `test.step` calls into a11y targets
-     * that have no steps recorded (e.g. violations found via static scan).
-     */
-    backfillSteps(reportData, steps) {
-        const filteredSteps = steps.filter((s) => !s.includes('Capture A11y screenshot'));
-        if (filteredSteps.length === 0)
-            return;
-        for (const err of reportData.a11yErrors) {
-            for (const target of err.target) {
-                if (!target.steps || target.steps.length === 0) {
-                    target.steps = filteredSteps;
-                    target.stepsJson = JSON.stringify(filteredSteps);
-                }
-            }
-        }
-    }
-    // ──────────────────────────────���─────────────────────────────────────────
-    //  Summary aggregation
-    // ────────────────────────────────────────────────────────────────────────
-    /**
-     * Aggregates a11y error counts into both the browser-specific and global
-     * summaries. Returns the total error count for this scan.
-     */
-    aggregateA11yErrors(errors, browser) {
-        const bSummary = this.getOrCreateBrowserSummary(browser);
-        let scanErrorCount = 0;
-        for (const err of errors) {
-            const count = err.total || 0;
-            scanErrorCount += count;
-            // Browser-level aggregation
-            if (!bSummary.wcagErrors[err.id]) {
-                bSummary.wcagErrors[err.id] = {
-                    count: 0,
-                    severity: err.severity,
-                    helpUrl: err.helpUrl,
-                    description: err.description,
-                };
-            }
-            bSummary.wcagErrors[err.id].count += count;
-            // Global aggregation
-            if (!this.executionSummary.wcagErrors[err.id]) {
-                this.executionSummary.wcagErrors[err.id] = {
-                    count: 0,
-                    severity: err.severity,
-                    helpUrl: err.helpUrl,
-                    description: err.description,
-                };
-            }
-            this.executionSummary.wcagErrors[err.id].count += count;
-        }
-        bSummary.totalA11yErrorCount += scanErrorCount;
-        this.executionSummary.totalA11yErrorCount += scanErrorCount;
-        return scanErrorCount;
-    }
-    /** Updates the browser-specific test counts (passed/failed/skipped). */
-    updateBrowserSummary(browser, status) {
-        const bSummary = this.getOrCreateBrowserSummary(browser);
-        bSummary.total++;
+    getStatusIcon(status) {
         switch (status) {
             case 'passed':
-                bSummary.totalPassed++;
-                break;
+                return models_1.TestStatusIcon.passed;
             case 'failed':
-                bSummary.totalFailed++;
-                break;
+            case 'timedOut':
+                return models_1.TestStatusIcon.failed;
             case 'skipped':
-                bSummary.totalSkipped++;
-                break;
+                return models_1.TestStatusIcon.skipped;
+            default:
+                return 'help';
         }
     }
-    /** Updates the global execution summary counts. */
-    updateGlobalSummary(test, result) {
-        const isFlaky = test.results.length > 1 && result.status === 'passed';
-        if (isFlaky)
-            this.executionSummary.totalFlaky++;
-        switch (result.status) {
-            case 'passed':
-                this.executionSummary.totalPassed++;
-                break;
-            case 'failed':
-                this.executionSummary.totalFailed++;
-                break;
-            case 'skipped':
-                this.executionSummary.totalSkipped++;
-                break;
+    updateSummary(test, result) {
+        var _a, _b;
+        const browser = result.browser;
+        if (!this.executionSummary.groupedResults[browser]) {
+            this.executionSummary.groupedResults[browser] = [];
         }
-        this.executionSummary.total++;
-    }
-    // ────────────────────────────────────────────────────────────────────────
-    //  Helpers
-    // ────────────────────────────────────────────────────────────────────────
-    /** Ensures a file group key exists in the grouped results map. */
-    ensureGroupExists(fileGroup) {
-        if (!this.executionSummary.groupedResults[fileGroup]) {
-            this.executionSummary.groupedResults[fileGroup] = [];
+        this.executionSummary.groupedResults[browser].push(result);
+        // Initialize browser summary if needed
+        if (!this.executionSummary.browserSummaries) {
+            this.executionSummary.browserSummaries = {};
         }
-    }
-    /** Lazily initialises and returns the browser summary for the given browser name. */
-    getOrCreateBrowserSummary(browser) {
-        const summaries = this.executionSummary.browserSummaries;
-        if (!summaries[browser]) {
-            summaries[browser] = {
-                duration: '0s',
+        if (!this.executionSummary.browserSummaries[browser]) {
+            this.executionSummary.browserSummaries[browser] = {
+                duration: '',
                 status: '',
                 statusIcon: '',
                 total: 0,
@@ -433,7 +266,63 @@ class SnapAllyReporter {
                 totalA11yErrorCount: 0,
             };
         }
-        return summaries[browser];
+        const bSummary = this.executionSummary.browserSummaries[browser];
+        this.executionSummary.total++;
+        bSummary.total++;
+        if (result.status === 'passed') {
+            this.executionSummary.totalPassed++;
+            bSummary.totalPassed++;
+        }
+        else if (result.status === 'failed' || result.status === 'timedOut') {
+            this.executionSummary.totalFailed++;
+            bSummary.totalFailed++;
+        }
+        else if (result.status === 'skipped') {
+            this.executionSummary.totalSkipped++;
+            bSummary.totalSkipped++;
+        }
+        const testKey = test.titlePath().join(' > ');
+        const violations = result.a11yErrors || result.violations;
+        if (violations && violations.length > 0) {
+            const count = result.a11yErrorCount || violations.reduce((acc, curr) => { var _a, _b; return acc + (curr.total || ((_a = curr.target) === null || _a === void 0 ? void 0 : _a.length) || ((_b = curr.nodes) === null || _b === void 0 ? void 0 : _b.length) || 0); }, 0);
+            // De-duplicate global count across browsers for same test case
+            const prevTestGlobalCount = this.testGlobalCounts[testKey] || 0;
+            if (count > prevTestGlobalCount) {
+                this.executionSummary.totalA11yErrorCount += (count - prevTestGlobalCount);
+                this.testGlobalCounts[testKey] = count;
+            }
+            bSummary.totalA11yErrorCount += count;
+            for (const err of violations) {
+                const ruleId = err.id;
+                const occCount = (err.total || ((_a = err.target) === null || _a === void 0 ? void 0 : _a.length) || ((_b = err.nodes) === null || _b === void 0 ? void 0 : _b.length) || 0);
+                // Update global wcagErrors (de-duplicated)
+                if (!this.executionSummary.wcagErrors[ruleId]) {
+                    this.executionSummary.wcagErrors[ruleId] = {
+                        count: 0,
+                        severity: err.severity || err.impact,
+                        helpUrl: err.helpUrl,
+                        description: err.description,
+                    };
+                }
+                if (!this.testRuleCounts[testKey])
+                    this.testRuleCounts[testKey] = {};
+                const prevRuleOccCount = this.testRuleCounts[testKey][ruleId] || 0;
+                if (occCount > prevRuleOccCount) {
+                    this.executionSummary.wcagErrors[ruleId].count += (occCount - prevRuleOccCount);
+                    this.testRuleCounts[testKey][ruleId] = occCount;
+                }
+                // Update browser-specific wcagErrors (per browser, usually naturally unique)
+                if (!bSummary.wcagErrors[ruleId]) {
+                    bSummary.wcagErrors[ruleId] = {
+                        count: 0,
+                        severity: err.severity || err.impact,
+                        helpUrl: err.helpUrl,
+                        description: err.description,
+                    };
+                }
+                bSummary.wcagErrors[ruleId].count += occCount;
+            }
+        }
     }
 }
 exports.default = SnapAllyReporter;

package/dist/core/A11yHtmlRenderer.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Handles the rendering of HTML reports using static templates and JSON data injection.
+ */
+export declare class A11yHtmlRenderer {
+    /**
+     * Renders a static HTML template by copying it and generating the accompanied data payload.
+     * @param templateName The template file name in the templates folder.
+     * @param data The data object to pass to the client-side JS app.
+     * @param outputFolder The folder where the rendered file will be saved.
+     * @param outputFileName The full path of the output file.
+     */
+    render(templateName: string, data: Record<string, unknown>, outputFolder: string, outputFileName: string): Promise<void>;
+    /**
+     * Converts ANSI color codes to HTML spans for nicer error display.
+     */
+    ansiToHtml(text: string): string;
+}