@dallask/a11y-mcp-srv 1.0.0

package/bin/server.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+
+// Wrapper script for npx execution
+// This file is executed when running: npx @dallask/a11y-mcp-srv
+import('../dist/server.js').catch((error) => {
+  console.error('Error starting server:', error);
+  process.exit(1);
+});

package/dist/core/accessibility-runner.d.ts

@@ -0,0 +1,123 @@
+/**
+ * AccessibilityRunner - Runs accessibility tests using axe-core or IBM Equal Access (ACE)
+ * Replaces previous WAVE-based implementation with axe-core and accessibility-checker.
+ */
+import { type Page } from 'playwright';
+import type { AccessibilityResults, AccessibilityTag, AccessibilityEngine, WaitStrategy } from '../types/index.js';
+/** Re-export for callers that use runner config */
+export type { AccessibilityEngine } from '../types/index.js';
+/**
+ * Configuration for running an accessibility test
+ */
+export interface AccessibilityRunnerConfig {
+    /** URL to test */
+    url: string;
+    /** Wait strategy for page loading */
+    waitForLoad?: WaitStrategy;
+    /** Timeout in milliseconds (default: 30000) */
+    timeout?: number;
+    /** Accessibility tags to pass to the engine as runOnly scope */
+    tags?: AccessibilityTag[];
+    /** Engine to use: axe-core (default) or IBM Equal Access */
+    engine?: AccessibilityEngine;
+    /** Whether to post-filter results by tags (default: false).
+     *  Set to true only when the user explicitly requested specific tags.
+     *  When false, tags are passed to the engine for scoping but all returned issues are shown. */
+    applyTagFilter?: boolean;
+}
+/**
+ * Result from running an accessibility test
+ */
+export interface AccessibilityRunnerResult {
+    /** Raw accessibility results */
+    accessibilityResults: AccessibilityResults;
+    /** Filtered results if tags were specified */
+    filteredResults?: AccessibilityResults;
+    /** Applied filters information */
+    appliedFilters?: {
+        tags?: AccessibilityTag[];
+        originalIssueCount?: number;
+    };
+    /** HTTP status code of the main document response (e.g. 200, 401). Undefined when no navigation. */
+    responseStatus?: number;
+}
+/**
+ * AccessibilityRunner class - Handles accessibility test execution with axe-core or ACE
+ */
+export declare class AccessibilityRunner {
+    private axePath;
+    constructor();
+    /**
+     * Navigate to URL and wait for page to be ready.
+     * @returns HTTP status code of the main document response (e.g. 200, 401), or undefined if unavailable.
+     */
+    private navigateAndWait;
+    /**
+     * Build axe run options (runOnly tags)
+     */
+    private buildAxeOptions;
+    /**
+     * Run axe-core analysis in the browser and return raw axe result
+     */
+    private runAxeAnalysis;
+    /**
+     * Convert axe-core results to our AccessibilityResults format
+     */
+    private axeToAccessibilityResults;
+    /**
+     * Map axe-style WCAG tags to IBM Equal Access policy IDs.
+     * ACE is scoped at scan time via setConfig({ policies }) — not post-filtered.
+     *   wcag22* → WCAG_2_2
+     *   wcag21* → WCAG_2_1
+     *   wcag2*  → WCAG_2_0
+     *   best-practice / (default) → IBM_Accessibility
+     */
+    private acePolicesFromTags;
+    /**
+     * Run IBM Equal Access (accessibility-checker) analysis on HTML content.
+     * ACE never fetches URLs; the caller loads the page in Playwright and passes the final HTML
+     * (including everything changed by JavaScript). This avoids ACE's internal Puppeteer launch.
+     * WCAG level/policy is configured via setConfig before the scan — tags are engine settings.
+     */
+    private runACEAnalysis;
+    /**
+     * Compare impact severity (higher = worse). Used to take the worst impact per rule.
+     * Uses IMPACT_ORDER for both axe and ACE native levels.
+     */
+    private impactRank;
+    /**
+     * Convert ACE report to our AccessibilityResults format.
+     * Uses ACE native levels (violation, potentialviolation, recommendation, etc.).
+     */
+    private aceToAccessibilityResults;
+    /**
+     * Run accessibility analysis (axe in browser, or ACE via getCompliance)
+     */
+    private runAccessibilityAnalysis;
+    /**
+     * Count total issues in violations
+     */
+    private countTotalIssues;
+    /**
+     * Get a mapping of common accessibility rule IDs to their accessibility tags.
+     * Includes both axe-core and ACE-style rule IDs; WCAG 2.2 tags ensure strict
+     * tag filters (e.g. wcag22aa only) still include these rules.
+     */
+    private getRuleTagMapping;
+    /**
+     * Check if a rule matches any of the specified tags.
+     * Only uses ruleData.tags when the array is non-empty; otherwise falls back to
+     * the static mapping and finally defaults to true (include the rule).
+     * This prevents rules with tags:[] from being silently dropped.
+     */
+    private ruleMatchesTags;
+    /**
+     * Filter accessibility results by tags
+     */
+    private filterByTags;
+    /**
+     * Run accessibility test on a URL
+     */
+    run(page: Page, config: AccessibilityRunnerConfig): Promise<AccessibilityRunnerResult>;
+}
+//# sourceMappingURL=accessibility-runner.d.ts.map

package/dist/core/accessibility-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-runner.d.ts","sourceRoot":"","sources":["../../src/core/accessibility-runner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAA;AAGtC,OAAO,KAAK,EACV,oBAAoB,EAIpB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACb,MAAM,mBAAmB,CAAA;AAW1B,mDAAmD;AACnD,YAAY,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAE5D;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,qCAAqC;IACrC,WAAW,CAAC,EAAE,YAAY,CAAA;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,gEAAgE;IAChE,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAA;IACzB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,mBAAmB,CAAA;IAC5B;;mGAE+F;IAC/F,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,gCAAgC;IAChC,oBAAoB,EAAE,oBAAoB,CAAA;IAC1C,8CAA8C;IAC9C,eAAe,CAAC,EAAE,oBAAoB,CAAA;IACtC,kCAAkC;IAClC,cAAc,CAAC,EAAE;QACf,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAA;QACzB,kBAAkB,CAAC,EAAE,MAAM,CAAA;KAC5B,CAAA;IACD,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AA+FD;;GAEG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAQ;;IASvB;;;OAGG;YACW,eAAe;IA+D7B;;OAEG;IACH,OAAO,CAAC,eAAe;IAMvB;;OAEG;YACW,cAAc;IA0B5B;;OAEG;IACH,OAAO,CAAC,yBAAyB;IAmEjC;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;;;;OAKG;YACW,cAAc;IAqB5B;;;OAGG;IACH,OAAO,CAAC,UAAU;IAKlB;;;OAGG;IACH,OAAO,CAAC,yBAAyB;IAoEjC;;OAEG;YACW,wBAAwB;IA4BtC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAmCzB;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAiCpB;;OAEG;IACG,GAAG,CACP,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,yBAAyB,CAAC;CA+DtC"}

package/dist/core/accessibility-runner.js

@@ -0,0 +1,465 @@
+/**
+ * AccessibilityRunner - Runs accessibility tests using axe-core or IBM Equal Access (ACE)
+ * Replaces previous WAVE-based implementation with axe-core and accessibility-checker.
+ */
+import * as path from 'path';
+import { fileURLToPath } from 'url';
+import { IMPACT_ORDER } from '../types/index.js';
+/**
+ * Debug logger that writes to stderr to avoid interfering with MCP protocol
+ */
+function debugLog(...args) {
+    console.error(...args);
+}
+/** Default axe-core tags for WCAG 2.1 AA */
+const DEFAULT_AXE_TAGS = [
+    'wcag2a',
+    'wcag2aa',
+    'wcag21a',
+    'wcag21aa',
+    'best-practice',
+];
+/**
+ * Parse tagName, className, and id from HTML snippet or path.dom string.
+ * Used to populate domInfo so Element and Class selector columns are accurate.
+ */
+function parseDomFromSnippet(snippet, pathDom) {
+    let tagName = '';
+    let className = null;
+    let id = null;
+    if (snippet) {
+        const tagMatch = snippet.match(/<\s*(\w+)[\s>]/);
+        if (tagMatch)
+            tagName = tagMatch[1].toLowerCase();
+        const classMatch = snippet.match(/class\s*=\s*["']([^"']*)["']/);
+        if (classMatch)
+            className = classMatch[1].trim() || null;
+        const idMatch = snippet.match(/\bid\s*=\s*["']([^"']*)["']/);
+        if (idMatch)
+            id = idMatch[1].trim() || null;
+    }
+    if (!tagName && pathDom) {
+        const segments = pathDom.split(/[/.]/);
+        const last = segments[segments.length - 1];
+        if (last) {
+            const tagPart = last.replace(/\[\d+\]$/, '').trim();
+            if (tagPart)
+                tagName = tagPart.toLowerCase();
+        }
+    }
+    if (!tagName)
+        tagName = 'element';
+    return { tagName, className, id };
+}
+/**
+ * AccessibilityRunner class - Handles accessibility test execution with axe-core or ACE
+ */
+export class AccessibilityRunner {
+    constructor() {
+        const currentFile = fileURLToPath(import.meta.url);
+        const currentDir = path.dirname(currentFile);
+        const serverDir = path.resolve(currentDir, '../../');
+        this.axePath = path.join(serverDir, 'node_modules', 'axe-core', 'axe.min.js');
+    }
+    /**
+     * Navigate to URL and wait for page to be ready.
+     * @returns HTTP status code of the main document response (e.g. 200, 401), or undefined if unavailable.
+     */
+    async navigateAndWait(page, url, waitStrategy = 'networkidle', timeout = 30000) {
+        debugLog(`Navigating to ${url}...`);
+        const startTime = Date.now();
+        const response = await page.goto(url, {
+            waitUntil: 'domcontentloaded',
+            timeout,
+        });
+        const status = response?.status();
+        if (status != null)
+            debugLog(`Page response status: ${status}`);
+        debugLog('Page navigation started');
+        const remainingTime = timeout - (Date.now() - startTime);
+        if (remainingTime > 0) {
+            try {
+                switch (waitStrategy) {
+                    case 'networkidle':
+                        await page.waitForLoadState('networkidle', {
+                            timeout: Math.min(remainingTime, 6000),
+                        });
+                        debugLog('Page reached networkidle state');
+                        break;
+                    case 'load':
+                        await page.waitForLoadState('load', {
+                            timeout: Math.min(remainingTime, 6000),
+                        });
+                        debugLog('Page reached load state');
+                        break;
+                    case 'domcontentloaded':
+                        debugLog('DOM content loaded');
+                        break;
+                }
+                const finalWaitTime = timeout - (Date.now() - startTime);
+                if (finalWaitTime > 1000) {
+                    try {
+                        await page.waitForFunction(() => (typeof document !== 'undefined' &&
+                            document.readyState === 'complete' &&
+                            document.body !== null), { timeout: Math.min(finalWaitTime, 2000) });
+                        debugLog('DOM is ready');
+                    }
+                    catch {
+                        debugLog('DOM readiness check timed out, proceeding anyway...');
+                    }
+                }
+            }
+            catch {
+                debugLog('Page still loading, but proceeding with analysis...');
+            }
+        }
+        debugLog(`Page loading completed in ${Date.now() - startTime}ms - proceeding with accessibility analysis`);
+        return status;
+    }
+    /**
+     * Build axe run options (runOnly tags)
+     */
+    buildAxeOptions(tags) {
+        const runOnly = tags && tags.length > 0 ? [...tags] : [...DEFAULT_AXE_TAGS];
+        return { runOnly };
+    }
+    /**
+     * Run axe-core analysis in the browser and return raw axe result
+     */
+    async runAxeAnalysis(page, tags) {
+        const axeOptions = this.buildAxeOptions(tags);
+        await page.addScriptTag({ path: this.axePath });
+        const rawResult = await page.evaluate((options) => {
+            return new Promise((resolve, reject) => {
+                if (typeof window.axe?.run !== 'function') {
+                    reject(new Error('axe.run is not available'));
+                    return;
+                }
+                ;
+                window
+                    .axe.run(options)
+                    .then(resolve)
+                    .catch(reject);
+            });
+        }, axeOptions);
+        return rawResult;
+    }
+    /**
+     * Convert axe-core results to our AccessibilityResults format
+     */
+    axeToAccessibilityResults(axeResult, url, testEnvironment) {
+        const violations = {};
+        const timestamp = new Date().toISOString();
+        axeResult.violations.forEach((v) => {
+            const categoryKey = v.id.toLowerCase().includes('color-contrast') ||
+                v.id.toLowerCase().includes('contrast')
+                ? 'contrast'
+                : 'error';
+            if (!violations[categoryKey]) {
+                violations[categoryKey] = { count: 0, items: {} };
+            }
+            const xpaths = (v.nodes || []).map((n) => (n.target && n.target[0]) || '');
+            const domInfo = (v.nodes || []).map((n) => {
+                const selector = n.target && n.target[0];
+                const { tagName, className, id } = parseDomFromSnippet(n.html ?? null, selector);
+                return {
+                    innerHTML: n.html ? n.html.substring(0, 200) : null,
+                    selector,
+                    tagName,
+                    className,
+                    id,
+                };
+            });
+            // Use axe-core native impact levels (critical, serious, moderate, minor)
+            const impact = v.impact?.toLowerCase() ?? 'moderate';
+            const ruleData = {
+                count: v.nodes?.length ?? 0,
+                xpaths,
+                description: v.description ?? v.help ?? v.id,
+                domInfo,
+                tags: v.tags ?? [],
+                impact,
+            };
+            violations[categoryKey].items[v.id] = ruleData;
+            violations[categoryKey].count += ruleData.count;
+        });
+        return {
+            url,
+            timestamp,
+            testEngine: { name: 'axe-core', version: '4.x' },
+            testRunner: { name: 'Standalone Accessibility Analyzer' },
+            testEnvironment,
+            violations,
+        };
+    }
+    /**
+     * Map axe-style WCAG tags to IBM Equal Access policy IDs.
+     * ACE is scoped at scan time via setConfig({ policies }) — not post-filtered.
+     *   wcag22* → WCAG_2_2
+     *   wcag21* → WCAG_2_1
+     *   wcag2*  → WCAG_2_0
+     *   best-practice / (default) → IBM_Accessibility
+     */
+    acePolicesFromTags(tags) {
+        if (!tags || tags.length === 0)
+            return ['IBM_Accessibility'];
+        if (tags.some((t) => t.startsWith('wcag22')))
+            return ['WCAG_2_2'];
+        if (tags.some((t) => t.startsWith('wcag21')))
+            return ['WCAG_2_1'];
+        if (tags.some((t) => t.startsWith('wcag2')))
+            return ['WCAG_2_0'];
+        return ['IBM_Accessibility'];
+    }
+    /**
+     * Run IBM Equal Access (accessibility-checker) analysis on HTML content.
+     * ACE never fetches URLs; the caller loads the page in Playwright and passes the final HTML
+     * (including everything changed by JavaScript). This avoids ACE's internal Puppeteer launch.
+     * WCAG level/policy is configured via setConfig before the scan — tags are engine settings.
+     */
+    async runACEAnalysis(htmlContent, url, tags) {
+        const aChecker = await import('accessibility-checker');
+        const label = `audit-${Date.now()}`;
+        const policies = this.acePolicesFromTags(tags);
+        debugLog(`ACE policies: ${policies.join(', ')}`);
+        try {
+            await aChecker.setConfig({ policies, ruleArchive: 'latest' });
+            const result = await aChecker.getCompliance(htmlContent, label);
+            const report = result.report;
+            return this.aceToAccessibilityResults(report, url);
+        }
+        finally {
+            await aChecker.close?.();
+        }
+    }
+    /**
+     * Compare impact severity (higher = worse). Used to take the worst impact per rule.
+     * Uses IMPACT_ORDER for both axe and ACE native levels.
+     */
+    impactRank(a) {
+        if (!a)
+            return 0;
+        return IMPACT_ORDER[a.toLowerCase()] ?? 2;
+    }
+    /**
+     * Convert ACE report to our AccessibilityResults format.
+     * Uses ACE native levels (violation, potentialviolation, recommendation, etc.).
+     */
+    aceToAccessibilityResults(report, url) {
+        const violations = { error: { count: 0, items: {} } };
+        const timestamp = new Date().toISOString();
+        const violationItems = report.results.filter((r) => r.level === 'violation' ||
+            r.level === 'potentialviolation' ||
+            r.level === 'recommendation' ||
+            r.level === 'potentialrecommendation' ||
+            r.level === 'manual');
+        violationItems.forEach((item) => {
+            const ruleId = item.ruleId;
+            // Use ACE native level (violation, potentialviolation, recommendation, etc.)
+            const itemImpact = item.level.toLowerCase();
+            if (!violations.error.items[ruleId]) {
+                violations.error.items[ruleId] = {
+                    count: 0,
+                    xpaths: [],
+                    description: item.message,
+                    domInfo: [],
+                    tags: [],
+                    impact: itemImpact,
+                };
+            }
+            const rule = violations.error.items[ruleId];
+            rule.count += 1;
+            rule.xpaths.push(item.path.dom || '');
+            const { tagName, className, id } = parseDomFromSnippet(item.snippet ?? null, item.path.dom);
+            rule.domInfo.push({
+                innerHTML: item.snippet ? item.snippet.substring(0, 200) : null,
+                selector: item.path.dom,
+                tagName,
+                className,
+                id,
+            });
+            if (itemImpact && this.impactRank(itemImpact) > this.impactRank(rule.impact)) {
+                rule.impact = itemImpact;
+            }
+        });
+        Object.values(violations.error.items).forEach((rule) => {
+            violations.error.count += rule.count;
+        });
+        return {
+            url,
+            timestamp,
+            testEngine: { name: 'IBM Equal Access', version: '4.x' },
+            testRunner: { name: 'accessibility-checker' },
+            testEnvironment: {
+                userAgent: 'accessibility-checker',
+                windowWidth: 1280,
+                windowHeight: 720,
+            },
+            violations,
+        };
+    }
+    /**
+     * Run accessibility analysis (axe in browser, or ACE via getCompliance)
+     */
+    async runAccessibilityAnalysis(page, url, engine, tags) {
+        if (engine === 'ace') {
+            const html = await page.content();
+            return this.runACEAnalysis(html, url, tags);
+        }
+        const axeResult = await this.runAxeAnalysis(page, tags);
+        const viewport = page.viewportSize();
+        const testEnvironment = {
+            userAgent: await page.evaluate(() => navigator.userAgent),
+            windowWidth: viewport?.width ?? 1280,
+            windowHeight: viewport?.height ?? 720,
+            orientationType: await page
+                .evaluate(() => screen.orientation?.type)
+                .catch(() => undefined),
+            orientationAngle: await page
+                .evaluate(() => screen.orientation?.angle)
+                .catch(() => undefined),
+        };
+        return this.axeToAccessibilityResults(axeResult, url, testEnvironment);
+    }
+    /**
+     * Count total issues in violations
+     */
+    countTotalIssues(violations) {
+        let total = 0;
+        Object.values(violations).forEach((category) => {
+            if (category && category.count) {
+                total += category.count;
+            }
+        });
+        return total;
+    }
+    /**
+     * Get a mapping of common accessibility rule IDs to their accessibility tags.
+     * Includes both axe-core and ACE-style rule IDs; WCAG 2.2 tags ensure strict
+     * tag filters (e.g. wcag22aa only) still include these rules.
+     */
+    getRuleTagMapping() {
+        const wcagA = [
+            'wcag2a',
+            'wcag21a',
+            'wcag22a',
+        ];
+        const wcagAA = [
+            'wcag2aa',
+            'wcag21aa',
+            'wcag22aa',
+        ];
+        return {
+            'color-contrast': ['wcag21aa', 'wcag2aa', 'wcag22aa'],
+            'image-alt': wcagA,
+            label: wcagA,
+            'heading-order': wcagA,
+            'html-has-lang': wcagA,
+            'link-name': wcagA,
+            'aria-valid-attr-value': wcagA,
+            tabindex: wcagA,
+            'button-name': wcagA,
+            'document-title': wcagA,
+            'heading_empty': wcagA,
+            'button_empty': wcagA,
+            'aria_reference_broken': wcagA,
+            contrast: ['wcag21aa', 'wcag2aa', 'wcag22aa'],
+            // ACE-style rule IDs (common patterns)
+            'RPT_Header_HasContent': wcagA,
+            'RPT_Button_AccessibleName': wcagA,
+            'RPT_Label_FormControls': wcagA,
+            'RPT_Elem_UniqueId': wcagA,
+            'IBMA_Color_Contrast_WCAG2AA': wcagAA,
+        };
+    }
+    /**
+     * Check if a rule matches any of the specified tags.
+     * Only uses ruleData.tags when the array is non-empty; otherwise falls back to
+     * the static mapping and finally defaults to true (include the rule).
+     * This prevents rules with tags:[] from being silently dropped.
+     */
+    ruleMatchesTags(ruleId, ruleData, tags) {
+        if (!tags || tags.length === 0)
+            return true;
+        if (ruleData.tags && Array.isArray(ruleData.tags) && ruleData.tags.length > 0) {
+            return ruleData.tags.some((tag) => tags.includes(tag));
+        }
+        const mapping = this.getRuleTagMapping();
+        const ruleTags = mapping[ruleId];
+        if (ruleTags?.length) {
+            return ruleTags.some((tag) => tags.includes(tag));
+        }
+        return true;
+    }
+    /**
+     * Filter accessibility results by tags
+     */
+    filterByTags(results, tags) {
+        if (!tags || tags.length === 0)
+            return results;
+        const filteredViolations = {};
+        Object.entries(results.violations).forEach(([categoryKey, category]) => {
+            if (!category?.items)
+                return;
+            const filteredItems = {};
+            Object.entries(category.items).forEach(([ruleId, ruleData]) => {
+                if (this.ruleMatchesTags(ruleId, ruleData, tags)) {
+                    filteredItems[ruleId] = ruleData;
+                }
+            });
+            if (Object.keys(filteredItems).length > 0) {
+                const categoryCount = Object.values(filteredItems).reduce((total, item) => total + (item.count || 0), 0);
+                filteredViolations[categoryKey] = {
+                    count: categoryCount,
+                    items: filteredItems,
+                };
+            }
+        });
+        return { ...results, violations: filteredViolations };
+    }
+    /**
+     * Run accessibility test on a URL
+     */
+    async run(page, config) {
+        const { url, waitForLoad = 'networkidle', timeout = 30000, tags, engine = 'axe', applyTagFilter = false, } = config;
+        try {
+            if (engine === 'ace') {
+                // Always load the page in Playwright and pass the final HTML to ACE (no separate ACE browser).
+                // This gives us JS-rendered content and supports Basic Auth; ACE only analyzes the HTML string.
+                const responseStatus = await this.navigateAndWait(page, url, waitForLoad, timeout);
+                const html = await page.content();
+                debugLog(`Running IBM Equal Access (ACE) analysis on page content (${url})...`);
+                const accessibilityResults = await this.runACEAnalysis(html, url, tags);
+                return {
+                    accessibilityResults,
+                    filteredResults: undefined,
+                    appliedFilters: tags && tags.length > 0 ? { tags } : undefined,
+                    responseStatus,
+                };
+            }
+            const responseStatus = await this.navigateAndWait(page, url, waitForLoad, timeout);
+            debugLog(`Running axe-core analysis on ${url}...`);
+            const accessibilityResults = await this.runAccessibilityAnalysis(page, url, 'axe', tags);
+            const originalIssueCount = this.countTotalIssues(accessibilityResults.violations);
+            let filteredResults;
+            let appliedFilters;
+            if (applyTagFilter && tags && tags.length > 0) {
+                filteredResults = this.filterByTags(accessibilityResults, tags);
+                appliedFilters = { tags, originalIssueCount };
+                debugLog(`Filtered results: ${originalIssueCount} -> ${this.countTotalIssues(filteredResults.violations)} issues (tags: ${tags.join(', ')})`);
+            }
+            return {
+                accessibilityResults,
+                filteredResults,
+                appliedFilters,
+                responseStatus,
+            };
+        }
+        catch (error) {
+            console.error('Error running accessibility test:', error);
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            throw new Error(`Accessibility test failed for ${url}: ${errorMessage}`);
+        }
+    }
+}
+//# sourceMappingURL=accessibility-runner.js.map

package/dist/core/accessibility-runner.js.map

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

package/dist/core/basic-auth.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Shared HTTP Basic Auth utilities for tools that use URLs.
+ * Use when auditing or fetching URLs that require Basic Authentication.
+ */
+export interface ParsedUrlCredentials {
+    urlWithoutAuth: string;
+    username?: string;
+    password?: string;
+}
+export interface BasicAuthParams {
+    basicAuthUsername?: string;
+    basicAuthPassword?: string;
+}
+/**
+ * Parse Basic Auth credentials from URL if present (e.g. https://user:password@host/path).
+ * Returns URL with credentials stripped and optional username/password.
+ */
+export declare function parseUrlCredentials(url: string): ParsedUrlCredentials;
+/**
+ * Build the Authorization header value for HTTP Basic Auth.
+ * Returns "Basic <base64(user:password)>" or null if either credential is missing.
+ */
+export declare function getBasicAuthHeader(username: string | undefined, password: string | undefined): string | null;
+/**
+ * Resolve URL and Basic Auth from a URL (possibly with user:password@host) and optional
+ * explicit username/password. Explicit params override credentials embedded in the URL.
+ * Returns normalized URL without auth and credentials suitable for passing to auditUrl etc.
+ */
+export declare function resolveBasicAuth(url: string, explicitUsername?: string, explicitPassword?: string): {
+    urlWithoutAuth: string;
+    basicAuthUsername: string | undefined;
+    basicAuthPassword: string | undefined;
+    basicAuthHeader: string | null;
+};
+//# sourceMappingURL=basic-auth.d.ts.map

package/dist/core/basic-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-auth.d.ts","sourceRoot":"","sources":["../../src/core/basic-auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,oBAAoB,CAcrE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,IAAI,CAIf;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,gBAAgB,CAAC,EAAE,MAAM,EACzB,gBAAgB,CAAC,EAAE,MAAM,GACxB;IACD,cAAc,EAAE,MAAM,CAAA;IACtB,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,iBAAiB,EAAE,MAAM,GAAG,SAAS,CAAA;IACrC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B,CAWA"}