@electriccitizen/bolt 0.1.0

package/dist/config.js

@@ -0,0 +1,187 @@
+/**
+ * .bolt.yml config loader and validator.
+ */
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { parse as parseYaml } from 'yaml';
+const DEFAULT_REFRESH = {
+    base_branch: 'main',
+    db: {
+        source: 'pantheon',
+    },
+};
+const DEFAULT_PR = {
+    base_branch: 'main',
+    default_reviewers: [],
+    draft: false,
+    remote: 'origin',
+};
+const DEFAULT_UPDATE = {
+    ignore: [],
+    priority: [],
+};
+const DEFAULT_CONFIG = {
+    adapter: 'ddev',
+    plugins: {
+        skip: [],
+        config: {},
+    },
+    custom_routes: [],
+    refresh: { ...DEFAULT_REFRESH },
+    update: { ...DEFAULT_UPDATE },
+    pr: { ...DEFAULT_PR },
+};
+/**
+ * Find and load .bolt.yml from the current directory.
+ * Returns default config if no file exists.
+ */
+export function loadConfig(dir) {
+    const configPath = join(dir ?? process.cwd(), '.bolt.yml');
+    if (!existsSync(configPath)) {
+        return { ...DEFAULT_CONFIG };
+    }
+    const raw = readFileSync(configPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = parseYaml(raw);
+    }
+    catch {
+        // Malformed YAML — fall back to defaults.
+        return { ...DEFAULT_CONFIG };
+    }
+    if (!parsed || typeof parsed !== 'object') {
+        return { ...DEFAULT_CONFIG };
+    }
+    return {
+        adapter: typeof parsed.adapter === 'string' ? parsed.adapter : 'ddev',
+        plugins: mergePluginsConfig(parsed.plugins),
+        custom_routes: Array.isArray(parsed.custom_routes) ? parsed.custom_routes : [],
+        refresh: mergeRefreshConfig(parsed.refresh),
+        update: mergeUpdateConfig(parsed.update),
+        pr: mergePrConfig(parsed.pr),
+    };
+}
+function mergePluginsConfig(raw) {
+    const defaults = { skip: [], config: {} };
+    if (!raw || typeof raw !== 'object')
+        return defaults;
+    const obj = raw;
+    return {
+        skip: Array.isArray(obj.skip) ? obj.skip.filter((s) => typeof s === 'string') : [],
+        config: obj.config && typeof obj.config === 'object'
+            ? obj.config
+            : {},
+    };
+}
+function mergeRefreshConfig(raw) {
+    if (!raw || typeof raw !== 'object')
+        return { ...DEFAULT_REFRESH };
+    const obj = raw;
+    const baseBranch = typeof obj.base_branch === 'string' ? obj.base_branch : 'main';
+    let db = { source: 'pantheon' };
+    if (obj.db && typeof obj.db === 'object') {
+        const dbObj = obj.db;
+        db = {
+            source: typeof dbObj.source === 'string' ? dbObj.source : 'pantheon',
+            pantheon_site: typeof dbObj.pantheon_site === 'string' ? dbObj.pantheon_site : undefined,
+            pantheon_env: typeof dbObj.pantheon_env === 'string' ? dbObj.pantheon_env : undefined,
+            file_path: typeof dbObj.file_path === 'string' ? dbObj.file_path : undefined,
+        };
+    }
+    return { base_branch: baseBranch, db };
+}
+function mergeUpdateConfig(raw) {
+    if (!raw || typeof raw !== 'object')
+        return { ...DEFAULT_UPDATE };
+    const obj = raw;
+    return {
+        ignore: Array.isArray(obj.ignore)
+            ? obj.ignore.filter((s) => typeof s === 'string')
+            : [],
+        priority: Array.isArray(obj.priority)
+            ? obj.priority.filter((s) => typeof s === 'string')
+            : [],
+    };
+}
+function mergePrConfig(raw) {
+    if (!raw || typeof raw !== 'object')
+        return { ...DEFAULT_PR };
+    const obj = raw;
+    return {
+        base_branch: typeof obj.base_branch === 'string' ? obj.base_branch : 'main',
+        default_reviewers: Array.isArray(obj.default_reviewers)
+            ? obj.default_reviewers.filter((s) => typeof s === 'string')
+            : [],
+        draft: typeof obj.draft === 'boolean' ? obj.draft : false,
+        remote: typeof obj.remote === 'string' ? obj.remote : 'origin',
+    };
+}
+/**
+ * Validate config and return any issues found.
+ */
+export function validateConfig(config) {
+    const issues = [];
+    const validAdapters = ['ddev', 'pantheon', 'acquia', 'ssh'];
+    if (!validAdapters.includes(config.adapter)) {
+        issues.push(`Unknown adapter "${config.adapter}". Valid: ${validAdapters.join(', ')}`);
+    }
+    if (!Array.isArray(config.plugins.skip)) {
+        issues.push('plugins.skip must be an array');
+    }
+    return issues;
+}
+/**
+ * Generate a .bolt.yml template string.
+ */
+export function generateConfigTemplate() {
+    return `# Bolt configuration
+# See: https://github.com/electriccitizen/bolt
+
+# Hosting adapter (ddev is the only supported adapter for now)
+adapter: ddev
+
+# Test plugin configuration
+plugins:
+  # Plugins to skip (by name)
+  skip: []
+  #  - visual-regression
+
+  # Per-plugin configuration
+  config: {}
+  #  browser-smoke:
+  #    viewport: [1920, 1080]
+  #    exclude_urls:
+  #      - /hidden-test-page
+
+# Additional URLs to include in testing (beyond auto-discovered ones)
+custom_routes: []
+#  - /products
+#  - /about
+
+# Environment refresh settings (bolt refresh)
+# refresh:
+#   base_branch: main
+#   db:
+#     source: pantheon        # pantheon | file (or any ddev pull provider)
+#     pantheon_site: mysite   # Terminus site name
+#     pantheon_env: live      # Environment to pull from
+#     # source: file
+#     # file_path: /path/to/dump.sql.gz
+
+# Update pipeline settings (bolt update)
+# update:
+#   ignore:
+#     - drupal/core-*        # Update core manually
+#   priority:
+#     - drupal/core-recommended
+
+# PR creation settings (bolt pr)
+# pr:
+#   base_branch: main
+#   default_reviewers:
+#     - broeker
+#   draft: false
+#   remote: origin
+`;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/formatters/index.d.ts

@@ -0,0 +1,2 @@
+export { formatText } from './text.js';
+export { formatJson } from './json.js';

package/dist/formatters/index.js

@@ -0,0 +1,3 @@
+export { formatText } from './text.js';
+export { formatJson } from './json.js';
+//# sourceMappingURL=index.js.map

package/dist/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/formatters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC"}

package/dist/formatters/json.d.ts

@@ -0,0 +1,5 @@
+/**
+ * JSON formatter — structured output for CI/CD and automation.
+ */
+import type { TestReport } from '../types.js';
+export declare function formatJson(report: TestReport): string;

package/dist/formatters/json.js

@@ -0,0 +1,7 @@
+/**
+ * JSON formatter — structured output for CI/CD and automation.
+ */
+export function formatJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/formatters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/formatters/json.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,UAAU,CAAC,MAAkB;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/formatters/markdown.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Markdown formatter — structured report for PRs, tickets, and documentation.
+ */
+import type { Severity, TestReport } from '../types.js';
+export declare function formatMarkdown(report: TestReport, failOn?: Severity): string;

package/dist/formatters/markdown.js

@@ -0,0 +1,144 @@
+/**
+ * Markdown formatter — structured report for PRs, tickets, and documentation.
+ */
+const severityRank = {
+    critical: 3,
+    major: 2,
+    minor: 1,
+    info: 0,
+};
+const severityEmoji = {
+    critical: '🔴',
+    major: '🟠',
+    minor: '🟡',
+    info: 'ℹ️',
+};
+export function formatMarkdown(report, failOn = 'major') {
+    const lines = [];
+    // Header.
+    lines.push(`# Bolt Test Report`);
+    lines.push('');
+    lines.push(`**Site:** ${report.site}`);
+    lines.push(`**Date:** ${new Date(report.timestamp).toLocaleString()}`);
+    lines.push(`**Mode:** ${report.mode}`);
+    lines.push(`**Duration:** ${formatDuration(report.duration)}`);
+    lines.push('');
+    // Summary.
+    lines.push('## Summary');
+    lines.push('');
+    lines.push(`| Metric | Count |`);
+    lines.push(`|--------|-------|`);
+    lines.push(`| Plugins ran | ${report.summary.pluginsRan} |`);
+    lines.push(`| Plugins skipped | ${report.summary.pluginsSkipped} |`);
+    lines.push(`| Tests passed | ${report.summary.passed} |`);
+    lines.push(`| Tests failed | ${report.summary.failed} |`);
+    lines.push(`| Tests skipped | ${report.summary.skipped} |`);
+    lines.push(`| Tests suppressed | ${report.summary.suppressed} |`);
+    lines.push(`| Warnings | ${report.summary.warned} |`);
+    if (report.summary.worstSeverity) {
+        lines.push(`| Worst severity | ${report.summary.worstSeverity} |`);
+    }
+    lines.push('');
+    // Plugin details.
+    lines.push('## Plugins');
+    lines.push('');
+    lines.push(`| Plugin | Status | Passed | Failed | Duration |`);
+    lines.push(`|--------|--------|--------|--------|----------|`);
+    for (const plugin of report.plugins) {
+        if (plugin.status === 'ran') {
+            const icon = plugin.failed > 0 ? '❌' : '✅';
+            lines.push(`| ${icon} ${plugin.name} | ran | ${plugin.passed} | ${plugin.failed} | ${formatDuration(plugin.duration)} |`);
+        }
+        else {
+            lines.push(`| ⏭️ ${plugin.name} | skipped | — | — | ${plugin.reason ?? ''} |`);
+        }
+    }
+    lines.push('');
+    // Failures.
+    const failures = report.results.filter((r) => r.status === 'fail');
+    if (failures.length > 0) {
+        lines.push('## Failures');
+        lines.push('');
+        for (const f of failures) {
+            const emoji = severityEmoji[f.severity] ?? '';
+            lines.push(`### ${emoji} ${f.plugin} › ${f.test}`);
+            lines.push('');
+            lines.push(`- **Severity:** ${f.severity}`);
+            if (f.message) {
+                const urlMatch = f.message.match(/^(https?:\/\/\S+)\s*—\s*(.*)/s);
+                if (urlMatch) {
+                    lines.push(`- **URL:** ${urlMatch[1]}`);
+                    lines.push(`- **Detail:** ${urlMatch[2]}`);
+                }
+                else {
+                    lines.push(`- **Detail:** ${f.message}`);
+                }
+            }
+            if (f.screenshot) {
+                lines.push(`- **Screenshot:** \`${f.screenshot}\``);
+            }
+            lines.push('');
+        }
+    }
+    // Suppressed.
+    const suppressed = report.results.filter((r) => r.status === 'suppressed');
+    if (suppressed.length > 0) {
+        lines.push('## Suppressed');
+        lines.push('');
+        lines.push('> These known issues are suppressed via `.boltrc.yml` and do not affect the pass/fail result.');
+        lines.push('');
+        for (const s of suppressed) {
+            const reasonMatch = s.message?.match(/\[suppressed: (.+)\]$/);
+            const reason = reasonMatch ? reasonMatch[1] : 'suppressed';
+            lines.push(`- ⊘ **${s.plugin} › ${s.test}** — ${reason}`);
+        }
+        lines.push('');
+    }
+    // Warnings.
+    const warnings = report.results.filter((r) => r.status === 'warn');
+    if (warnings.length > 0) {
+        lines.push('## Warnings');
+        lines.push('');
+        for (const w of warnings) {
+            lines.push(`- **${w.plugin} › ${w.test}:** ${w.message ?? ''}`);
+        }
+        lines.push('');
+    }
+    // All test results table.
+    lines.push('## All Test Results');
+    lines.push('');
+    lines.push(`| Plugin | Test | Status | Severity | Duration |`);
+    lines.push(`|--------|------|--------|----------|----------|`);
+    for (const r of report.results) {
+        const statusIcon = r.status === 'pass' ? '✅' : r.status === 'fail' ? '❌' : r.status === 'warn' ? '⚠️' : r.status === 'suppressed' ? '⊘' : '⏭️';
+        lines.push(`| ${r.plugin} | ${r.test} | ${statusIcon} ${r.status} | ${r.severity} | ${formatDuration(r.duration)} |`);
+    }
+    lines.push('');
+    // Result line.
+    if (failures.length > 0) {
+        const threshold = severityRank[failOn];
+        const qualifying = failures.filter((f) => severityRank[f.severity] >= threshold);
+        if (qualifying.length > 0) {
+            lines.push(`> **Result:** ${qualifying.length} failure(s) at or above \`${failOn}\` severity threshold.`);
+        }
+        else {
+            lines.push(`> **Result:** ${failures.length} failure(s) below \`${failOn}\` severity threshold — non-blocking.`);
+        }
+    }
+    else if (report.summary.passed === 0 && report.summary.skipped > 0) {
+        lines.push(`> **Result:** ${report.summary.skipped} baseline(s) captured. Re-run to compare.`);
+    }
+    else {
+        lines.push(`> **Result:** All ${report.summary.passed} tests passed.`);
+    }
+    lines.push('');
+    lines.push('---');
+    lines.push('*Generated by [bolt](https://github.com/electriccitizen/bolt)*');
+    return lines.join('\n');
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/formatters/markdown.js.map

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

package/dist/formatters/text.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Text formatter — terminal output for developers.
+ */
+import type { Severity, TestReport } from '../types.js';
+export declare function formatText(report: TestReport, failOn?: Severity): string;

package/dist/formatters/text.js

@@ -0,0 +1,123 @@
+/**
+ * Text formatter — terminal output for developers.
+ */
+const severityRank = {
+    critical: 3,
+    major: 2,
+    minor: 1,
+    info: 0,
+};
+export function formatText(report, failOn = 'major') {
+    const lines = [];
+    lines.push(`bolt test — ${report.site}`);
+    lines.push('━'.repeat(50));
+    lines.push('');
+    // Plugin summary.
+    const suppressedNote = report.summary.suppressed > 0
+        ? `, ${report.summary.suppressed} suppressed`
+        : '';
+    lines.push(`Plugins: ${report.summary.pluginsRan} ran, ${report.summary.pluginsSkipped} skipped`);
+    lines.push(`Duration: ${formatDuration(report.duration)}`);
+    lines.push('');
+    for (const plugin of report.plugins) {
+        if (plugin.status === 'ran') {
+            const icon = plugin.failed > 0 ? '✗' : '✓';
+            const detail = plugin.failed > 0
+                ? `${plugin.failed} failed`
+                : plugin.skipped > 0 && plugin.passed === 0
+                    ? `${plugin.skipped} baseline(s) captured`
+                    : `${plugin.tests} tests passed`;
+            lines.push(`  ${icon} ${padRight(plugin.name, 22)} ${padRight(detail, 30)} (${formatDuration(plugin.duration)})`);
+        }
+        else {
+            lines.push(`  ⊘ ${padRight(plugin.name, 22)} skipped (${plugin.reason})`);
+        }
+    }
+    // Failures.
+    const failures = report.results.filter((r) => r.status === 'fail');
+    if (failures.length > 0) {
+        lines.push('');
+        lines.push('Failures:');
+        for (const f of failures) {
+            lines.push(`  ${f.plugin} > ${f.test}`);
+            lines.push(`    Severity: ${f.severity}`);
+            if (f.message) {
+                // Parse structured failure messages for readable output.
+                // Format: "URL — issue details"
+                const urlMatch = f.message.match(/^(https?:\/\/\S+)\s*—\s*(.*)/s);
+                if (urlMatch) {
+                    lines.push(`    URL: ${urlMatch[1]}`);
+                    lines.push(`    ${urlMatch[2]}`);
+                }
+                else {
+                    lines.push(`    ${f.message}`);
+                }
+            }
+            if (f.screenshot)
+                lines.push(`    Screenshot: ${f.screenshot}`);
+            lines.push('');
+        }
+    }
+    // Suppressed.
+    const suppressed = report.results.filter((r) => r.status === 'suppressed');
+    if (suppressed.length > 0) {
+        lines.push('');
+        lines.push('Suppressed:');
+        for (const s of suppressed) {
+            lines.push(`  ⊘ ${s.plugin} > ${s.test}`);
+            if (s.message) {
+                // Extract suppression reason from the bracketed suffix.
+                const reasonMatch = s.message.match(/\[suppressed: (.+)\]$/);
+                if (reasonMatch) {
+                    lines.push(`    Reason: ${reasonMatch[1]}`);
+                }
+            }
+        }
+    }
+    // Warnings.
+    const warnings = report.results.filter((r) => r.status === 'warn');
+    if (warnings.length > 0) {
+        lines.push('');
+        lines.push('Warnings:');
+        for (const w of warnings) {
+            lines.push(`  ${w.plugin} > ${w.test}: ${w.message ?? ''}`);
+        }
+    }
+    // Summary line.
+    lines.push('');
+    if (failures.length > 0) {
+        const severities = failures.map((f) => f.severity);
+        const worst = severities.includes('critical')
+            ? 'critical'
+            : severities.includes('major')
+                ? 'major'
+                : 'minor';
+        const threshold = severityRank[failOn];
+        const qualifying = failures.filter((f) => severityRank[f.severity] >= threshold);
+        if (qualifying.length > 0) {
+            lines.push(`Result: ${qualifying.length} failure(s) at or above ${failOn} — ${report.summary.passed} passed, ${report.summary.skipped} skipped${suppressedNote}`);
+        }
+        else {
+            lines.push(`Result: ${failures.length} failure(s) (${worst}, below ${failOn} threshold) — ${report.summary.passed} passed, ${report.summary.skipped} skipped${suppressedNote}`);
+        }
+    }
+    else if (report.summary.totalTests === 0) {
+        lines.push('Result: No tests ran.');
+    }
+    else if (report.summary.passed === 0 && report.summary.skipped > 0) {
+        lines.push(`Result: ${report.summary.skipped} baseline(s) captured. Re-run to compare.`);
+    }
+    else {
+        lines.push(`Result: All ${report.summary.passed} tests passed.${suppressedNote}`);
+    }
+    return lines.join('\n');
+}
+function formatDuration(ms) {
+    if (ms < 1000)
+        return `${ms}ms`;
+    return `${(ms / 1000).toFixed(1)}s`;
+}
+function padRight(str, len) {
+    return str.length >= len ? str : str + ' '.repeat(len - str.length);
+}
+//# sourceMappingURL=text.js.map

package/dist/formatters/text.js.map

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

package/dist/plugins/accessibility.d.ts

@@ -0,0 +1,5 @@
+/**
+ * accessibility plugin — runs axe-core scans on representative URLs.
+ */
+import type { TestPlugin } from '../types.js';
+export declare const accessibilityPlugin: TestPlugin;

package/dist/plugins/accessibility.js

@@ -0,0 +1,116 @@
+/**
+ * accessibility plugin — runs axe-core scans on representative URLs.
+ */
+import { mkdirSync } from 'fs';
+import { join } from 'path';
+import { AxeBuilder } from '@axe-core/playwright';
+/** Map axe impact levels to bolt severity levels. */
+function mapSeverity(impact) {
+    switch (impact) {
+        case 'critical': return 'critical';
+        case 'serious': return 'major';
+        case 'moderate': return 'minor';
+        case 'minor': return 'info';
+        default: return 'minor';
+    }
+}
+export const accessibilityPlugin = {
+    name: 'accessibility',
+    description: 'Run axe-core accessibility scans on representative URLs',
+    readOnly: true,
+    needsGeneratedContent: false,
+    canRun(profile) {
+        return profile.representativeUrls.length > 0;
+    },
+    async run(ctx) {
+        const results = [];
+        const { siteUrl, browserContext, profile, options } = ctx;
+        // Read per-plugin config from .bolt.yml.
+        const pluginConfig = options.boltConfig?.plugins?.config?.['accessibility'];
+        const rulesToSkip = pluginConfig?.rules_to_skip ?? [];
+        const tags = pluginConfig?.tags ?? ['wcag2a', 'wcag2aa'];
+        for (const rep of profile.representativeUrls) {
+            const start = Date.now();
+            const fullUrl = rep.url.startsWith('http') ? rep.url : siteUrl + rep.url;
+            let page;
+            try {
+                page = await browserContext.newPage();
+                await page.goto(fullUrl, { waitUntil: 'networkidle', timeout: 30_000 });
+                // Build axe scan.
+                let axe = new AxeBuilder({ page }).withTags(tags);
+                for (const rule of rulesToSkip) {
+                    axe = axe.disableRules(rule);
+                }
+                const axeResults = await axe.analyze();
+                const duration = Date.now() - start;
+                if (axeResults.violations.length === 0) {
+                    results.push({
+                        plugin: 'accessibility',
+                        test: `a11y:${rep.label}`,
+                        status: 'pass',
+                        severity: 'info',
+                        message: `${rep.label} — ${axeResults.passes.length} rules passed`,
+                        duration,
+                    });
+                }
+                else {
+                    // Group violations by severity and report per-page.
+                    const violationDetails = axeResults.violations.map((v) => {
+                        const nodes = v.nodes.length;
+                        const target = v.nodes[0]?.target?.[0] ?? '';
+                        return `[${v.impact ?? 'minor'}] ${v.id}: ${v.help} (${nodes} element${nodes > 1 ? 's' : ''}${target ? ', e.g. ' + String(target) : ''})`;
+                    });
+                    // Use worst violation severity for the overall result.
+                    const order = ['minor', 'moderate', 'serious', 'critical'];
+                    let worstImpact = 'minor';
+                    for (const v of axeResults.violations) {
+                        const impact = v.impact ?? 'minor';
+                        if (order.indexOf(impact) > order.indexOf(worstImpact)) {
+                            worstImpact = impact;
+                        }
+                    }
+                    // Capture screenshot on failure.
+                    let screenshot;
+                    if (options.screenshots) {
+                        mkdirSync(options.screenshots, { recursive: true });
+                        const filename = `a11y-${slugify(rep.label)}-${Date.now()}.png`;
+                        screenshot = join(options.screenshots, filename);
+                        await page.screenshot({ path: screenshot, fullPage: true });
+                    }
+                    results.push({
+                        plugin: 'accessibility',
+                        test: `a11y:${rep.label}`,
+                        status: 'fail',
+                        severity: mapSeverity(worstImpact),
+                        message: `${fullUrl} — ${axeResults.violations.length} violation(s):\n${violationDetails.join('\n')}`,
+                        screenshot,
+                        duration,
+                    });
+                }
+            }
+            catch (err) {
+                const duration = Date.now() - start;
+                results.push({
+                    plugin: 'accessibility',
+                    test: `a11y:${rep.label}`,
+                    status: 'fail',
+                    severity: 'critical',
+                    message: `Scan failed for ${rep.label}: ${err instanceof Error ? err.message : String(err)}`,
+                    duration,
+                });
+            }
+            finally {
+                if (page)
+                    await page.close();
+            }
+        }
+        return results;
+    },
+};
+function slugify(str) {
+    return str
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+//# sourceMappingURL=accessibility.js.map