@dallask/a11y-mcp-srv 1.0.0

package/dist/core/normalize-audit-result.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Normalize audit result input so tools that accept "result or URL" can safely
+ * handle JSON strings, MCP response wrappers, and partial objects.
+ */
+import type { AuditResult } from '../types/index.js';
+/**
+ * Normalize audit result input from a client.
+ * - URL string: returns null (caller should run audit).
+ * - JSON string of single result: parses and normalizes.
+ * - MCP wrapper { content: [{ text: "..." }] }: extracts and normalizes.
+ * - Batch { results: [...] }: normalizes first element.
+ * - Plain object: fills missing fields with defaults.
+ *
+ * @param value - Raw value (string, or object from previous tool output).
+ * @returns Normalized AuditResult, or null when value is a URL (run audit) or parsing fails.
+ */
+export declare function normalizeAuditResult(value: unknown): AuditResult | null;
+//# sourceMappingURL=normalize-audit-result.d.ts.map

package/dist/core/normalize-audit-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-audit-result.d.ts","sourceRoot":"","sources":["../../src/core/normalize-audit-result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAgC,MAAM,mBAAmB,CAAA;AA4DlF;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,IAAI,CAsDvE"}

package/dist/core/normalize-audit-result.js

@@ -0,0 +1,118 @@
+/**
+ * Normalize audit result input so tools that accept "result or URL" can safely
+ * handle JSON strings, MCP response wrappers, and partial objects.
+ */
+const DEFAULT_SUMMARY = {
+    totalIssues: 0,
+    score: 0,
+    wcagCompliance: { A: 0, AA: 0, AAA: 0 },
+    byCategory: {},
+    byImpact: {},
+};
+function isUrlString(value) {
+    const t = value.trim();
+    return t.startsWith('http://') || t.startsWith('https://');
+}
+function isJsonLikeString(value) {
+    return value.trim().startsWith('{');
+}
+/**
+ * Normalize a raw object into a full AuditResult with guaranteed arrays and summary.
+ */
+function normalizeObject(obj) {
+    const prioritizedIssues = Array.isArray(obj.prioritizedIssues) ? obj.prioritizedIssues : [];
+    const quickWins = Array.isArray(obj.quickWins) ? obj.quickWins : [];
+    const criticalBlockers = Array.isArray(obj.criticalBlockers) ? obj.criticalBlockers : [];
+    let summary = DEFAULT_SUMMARY;
+    if (obj.summary != null && typeof obj.summary === 'object') {
+        const s = obj.summary;
+        const wcag = s.wcagCompliance != null && typeof s.wcagCompliance === 'object'
+            ? s.wcagCompliance
+            : { A: 0, AA: 0, AAA: 0 };
+        summary = {
+            totalIssues: typeof s.totalIssues === 'number' ? s.totalIssues : 0,
+            score: typeof s.score === 'number' ? s.score : 0,
+            wcagCompliance: wcag,
+            byCategory: s.byCategory != null && typeof s.byCategory === 'object' && !Array.isArray(s.byCategory)
+                ? s.byCategory
+                : {},
+            byImpact: s.byImpact != null && typeof s.byImpact === 'object' && !Array.isArray(s.byImpact)
+                ? s.byImpact
+                : {},
+        };
+    }
+    return {
+        summary,
+        prioritizedIssues,
+        quickWins,
+        criticalBlockers,
+        conversationalSummary: typeof obj.conversationalSummary === 'string' ? obj.conversationalSummary : '',
+        issuesTable: typeof obj.issuesTable === 'string' ? obj.issuesTable : '',
+        appliedFilters: obj.appliedFilters != null && typeof obj.appliedFilters === 'object' ? obj.appliedFilters : undefined,
+        metadata: obj.metadata != null && typeof obj.metadata === 'object' ? obj.metadata : undefined,
+        rawResults: obj.rawResults,
+        responseStatus: typeof obj.responseStatus === 'number' ? obj.responseStatus : undefined,
+    };
+}
+/**
+ * Normalize audit result input from a client.
+ * - URL string: returns null (caller should run audit).
+ * - JSON string of single result: parses and normalizes.
+ * - MCP wrapper { content: [{ text: "..." }] }: extracts and normalizes.
+ * - Batch { results: [...] }: normalizes first element.
+ * - Plain object: fills missing fields with defaults.
+ *
+ * @param value - Raw value (string, or object from previous tool output).
+ * @returns Normalized AuditResult, or null when value is a URL (run audit) or parsing fails.
+ */
+export function normalizeAuditResult(value) {
+    if (value == null) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        if (isUrlString(trimmed)) {
+            return null;
+        }
+        if (isJsonLikeString(trimmed)) {
+            try {
+                const parsed = JSON.parse(trimmed);
+                return normalizeAuditResult(parsed);
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    if (typeof value !== 'object') {
+        return null;
+    }
+    const obj = value;
+    // MCP response wrapper: { content: [ { type, text } ] }
+    const content = obj.content;
+    if (Array.isArray(content) && content.length > 0) {
+        const first = content[0];
+        if (first != null && typeof first === 'object' && 'text' in first && typeof first.text === 'string') {
+            try {
+                const parsed = JSON.parse(first.text);
+                return normalizeAuditResult(parsed);
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    // Batch result from audit_multiple_urls: { results: AuditResult[], ... }
+    const resultsArray = obj.results;
+    if (Array.isArray(resultsArray) && resultsArray.length > 0) {
+        return normalizeAuditResult(resultsArray[0]);
+    }
+    // Plain audit result (single): must look like one (has summary or prioritizedIssues)
+    if ('summary' in obj || 'prioritizedIssues' in obj) {
+        return normalizeObject(obj);
+    }
+    // Empty or unrecognized object: return minimal valid result so callers don't throw
+    return normalizeObject(obj);
+}
+//# sourceMappingURL=normalize-audit-result.js.map

package/dist/core/normalize-audit-result.js.map

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

package/dist/core/playwright-bootstrap.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Ensures Playwright browsers are installed when running in environments (e.g. CodeMie, CI)
+ * where they may not be pre-installed. On "Executable doesn't exist", runs
+ * `playwright install chromium` and retries the launch.
+ */
+import { chromium, type Browser } from 'playwright';
+/** Detect the "Executable doesn't exist" error from Playwright (missing browser install). */
+export declare function isMissingBrowserError(error: unknown): boolean;
+/** Detect "Failed to launch the browser process" (often missing system deps on Linux/Docker). */
+export declare function isLaunchFailureError(error: unknown): boolean;
+/** Run `playwright install chromium` so the current process's cache has the browser. */
+export declare function installPlaywrightChromium(): void;
+export type LaunchOptions = Parameters<typeof chromium.launch>[0];
+/**
+ * Launch Chromium, installing the browser if missing (e.g. first run in CodeMie).
+ * Retries launch once after install on "Executable doesn't exist".
+ * On "Failed to launch the browser process", tries `playwright install chromium --with-deps` and retries once.
+ * Uses robust launch args for CI/containers; caller args are merged in.
+ */
+export declare function launchChromium(options: LaunchOptions): Promise<Browser>;
+//# sourceMappingURL=playwright-bootstrap.d.ts.map

package/dist/core/playwright-bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-bootstrap.d.ts","sourceRoot":"","sources":["../../src/core/playwright-bootstrap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,QAAQ,EAAE,KAAK,OAAO,EAAE,MAAM,YAAY,CAAA;AAGnD,6FAA6F;AAC7F,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAM7D;AAED,iGAAiG;AACjG,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAG5D;AASD,wFAAwF;AACxF,wBAAgB,yBAAyB,IAAI,IAAI,CAgBhD;AA2BD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;AAiDjE;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAuB7E"}

package/dist/core/playwright-bootstrap.js

@@ -0,0 +1,144 @@
+/**
+ * Ensures Playwright browsers are installed when running in environments (e.g. CodeMie, CI)
+ * where they may not be pre-installed. On "Executable doesn't exist", runs
+ * `playwright install chromium` and retries the launch.
+ */
+import { createRequire } from 'node:module';
+import { execSync } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { chromium } from 'playwright';
+import { toErrorMessage } from './error-handler.js';
+/** Detect the "Executable doesn't exist" error from Playwright (missing browser install). */
+export function isMissingBrowserError(error) {
+    const msg = toErrorMessage(error).toLowerCase();
+    return ((msg.includes('executable doesn\'t exist') || msg.includes('executable does not exist')) &&
+        (msg.includes('ms-playwright') || msg.includes('chromium_headless_shell') || msg.includes('playwright')));
+}
+/** Detect "Failed to launch the browser process" (often missing system deps on Linux/Docker). */
+export function isLaunchFailureError(error) {
+    const msg = toErrorMessage(error).toLowerCase();
+    return msg.includes('failed to launch the browser process');
+}
+/** Resolve path to the Playwright CLI (same package as the one we import). */
+function getPlaywrightCliPath() {
+    const require = createRequire(import.meta.url);
+    const playwrightDir = dirname(require.resolve('playwright/package.json'));
+    return join(playwrightDir, 'cli.js');
+}
+/** Run `playwright install chromium` so the current process's cache has the browser. */
+export function installPlaywrightChromium() {
+    const cliPath = getPlaywrightCliPath();
+    const node = process.execPath;
+    console.error('[accessibility-mcp-server] Installing Playwright Chromium (one-time or after update)...');
+    try {
+        execSync(`"${node}" "${cliPath}" install chromium`, {
+            stdio: 'inherit',
+            env: process.env,
+            cwd: process.cwd(),
+        });
+        console.error('[accessibility-mcp-server] Playwright Chromium install completed.');
+    }
+    catch (err) {
+        const msg = toErrorMessage(err);
+        console.error(`[accessibility-mcp-server] Playwright install failed: ${msg}`);
+        throw new Error(`Playwright Chromium install failed: ${msg}`);
+    }
+}
+/**
+ * Run `playwright install chromium --with-deps` to install browser + system dependencies
+ * (e.g. libgbm, libnss3 on Linux). Use when the browser binary exists but fails to launch.
+ * May require root/sudo in some environments; best-effort only.
+ */
+function installPlaywrightChromiumWithDeps() {
+    const cliPath = getPlaywrightCliPath();
+    const node = process.execPath;
+    console.error('[accessibility-mcp-server] Installing Chromium with system dependencies (--with-deps)...');
+    try {
+        execSync(`"${node}" "${cliPath}" install chromium --with-deps`, {
+            stdio: 'inherit',
+            env: process.env,
+            cwd: process.cwd(),
+        });
+        console.error('[accessibility-mcp-server] Chromium + deps install completed.');
+    }
+    catch (err) {
+        const msg = toErrorMessage(err);
+        console.error(`[accessibility-mcp-server] install --with-deps failed: ${msg}`);
+        throw new Error(`Chromium system-deps install failed: ${msg}. You may need to run 'npx playwright install --with-deps' manually with appropriate permissions.`);
+    }
+}
+/**
+ * Chromium args that improve launch success in CI, containers, and restricted environments
+ * (e.g. CodeMie, Docker, headless Linux). Reduces GPU/sandbox/display issues.
+ */
+const ROBUST_LAUNCH_ARGS = [
+    '--disable-dev-shm-usage',
+    '--no-sandbox',
+    '--disable-setuid-sandbox',
+    '--disable-gpu',
+    '--disable-software-rasterizer',
+    '--disable-extensions',
+    '--disable-background-networking',
+    '--disable-default-apps',
+    '--disable-sync',
+    '--disable-translate',
+    '--metrics-recording-only',
+    '--mute-audio',
+    '--no-first-run',
+    '--safebrowsing-disable-auto-update',
+    '--disable-features=TranslateUI',
+    '--disable-ipc-flooding-protection',
+    '--disable-renderer-backgrounding',
+    '--disable-backgrounding-occluded-windows',
+    '--disable-hang-monitor',
+    '--disable-prompt-on-repost',
+    '--disable-client-side-phishing-detection',
+    '--run-all-compositor-stages-before-draw',
+];
+/**
+ * Merge caller args with robust defaults (caller args take precedence; no duplicates).
+ */
+function mergeLaunchArgs(callerArgs) {
+    const seen = new Set(ROBUST_LAUNCH_ARGS);
+    const out = [...ROBUST_LAUNCH_ARGS];
+    if (Array.isArray(callerArgs)) {
+        for (const a of callerArgs) {
+            const flag = a.split('=')[0];
+            if (!seen.has(flag)) {
+                seen.add(flag);
+                out.push(a);
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Launch Chromium, installing the browser if missing (e.g. first run in CodeMie).
+ * Retries launch once after install on "Executable doesn't exist".
+ * On "Failed to launch the browser process", tries `playwright install chromium --with-deps` and retries once.
+ * Uses robust launch args for CI/containers; caller args are merged in.
+ */
+export async function launchChromium(options) {
+    const args = mergeLaunchArgs(options?.args);
+    const launchOpts = {
+        ...options,
+        headless: options?.headless !== false,
+        args,
+    };
+    const tryLaunch = async () => chromium.launch(launchOpts);
+    try {
+        return await tryLaunch();
+    }
+    catch (error) {
+        if (isMissingBrowserError(error)) {
+            installPlaywrightChromium();
+            return await tryLaunch();
+        }
+        if (isLaunchFailureError(error)) {
+            installPlaywrightChromiumWithDeps();
+            return await tryLaunch();
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=playwright-bootstrap.js.map

package/dist/core/playwright-bootstrap.js.map

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

package/dist/core/progress-streamer.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Progress Streamer - Handles progress updates for long-running operations
+ * Provides utilities for tracking and reporting progress with time estimates
+ */
+import type { ProgressUpdate, BatchAuditProgress } from '../types/index.js';
+/**
+ * Progress callback type
+ */
+export type ProgressCallback = (progress: ProgressUpdate | BatchAuditProgress) => void;
+/**
+ * Progress tracker for long-running operations
+ */
+export declare class ProgressTracker {
+    private total;
+    private startTime;
+    private progressHistory;
+    private readonly historyWindow;
+    constructor(total: number);
+    /**
+     * Update progress and calculate time estimates
+     */
+    update(current: number, status: string, currentItem?: string, additionalData?: Partial<ProgressUpdate>): ProgressUpdate;
+    /**
+     * Get final progress update
+     */
+    finalize(status?: string): ProgressUpdate;
+    /**
+     * Reset the tracker
+     */
+    reset(newTotal?: number): void;
+}
+/**
+ * Format time remaining in human-readable format
+ */
+export declare function formatTimeRemaining(seconds: number): string;
+/**
+ * Create a progress callback that formats updates for MCP responses
+ */
+export declare function createProgressCallback(onProgress?: ProgressCallback): ProgressCallback;
+/**
+ * Create a batch audit progress callback
+ */
+export declare function createBatchProgressCallback(onProgress?: ProgressCallback): (progress: BatchAuditProgress) => void;
+//# sourceMappingURL=progress-streamer.d.ts.map

package/dist/core/progress-streamer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress-streamer.d.ts","sourceRoot":"","sources":["../../src/core/progress-streamer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,mBAAmB,CAAA;AAE1B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,KAAK,IAAI,CAAA;AAEtF;;GAEG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,KAAK;IAJzB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,eAAe,CAAsD;IAC7E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAI;gBAEd,KAAK,EAAE,MAAM;IAIjC;;OAEG;IACH,MAAM,CACJ,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,EACpB,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GACvC,cAAc;IAkEjB;;OAEG;IACH,QAAQ,CAAC,MAAM,GAAE,MAAmB,GAAG,cAAc;IAUrD;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI;CAO/B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,gBAAgB,CAiBlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,UAAU,CAAC,EAAE,gBAAgB,GAC5B,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,CAsBxC"}

package/dist/core/progress-streamer.js

@@ -0,0 +1,160 @@
+/**
+ * Progress Streamer - Handles progress updates for long-running operations
+ * Provides utilities for tracking and reporting progress with time estimates
+ */
+/**
+ * Progress tracker for long-running operations
+ */
+export class ProgressTracker {
+    constructor(total) {
+        this.total = total;
+        this.progressHistory = [];
+        this.historyWindow = 5; // Keep last 5 progress points for estimation
+        this.startTime = Date.now();
+    }
+    /**
+     * Update progress and calculate time estimates
+     */
+    update(current, status, currentItem, additionalData) {
+        const now = Date.now();
+        const elapsed = (now - this.startTime) / 1000; // seconds
+        const percentage = Math.round((current / this.total) * 100);
+        // Add to history
+        this.progressHistory.push({
+            timestamp: now,
+            completed: current,
+        });
+        // Keep only recent history
+        if (this.progressHistory.length > this.historyWindow) {
+            this.progressHistory.shift();
+        }
+        // Calculate estimated time remaining
+        let estimatedTimeRemaining;
+        if (current > 0 && this.progressHistory.length >= 2) {
+            // Use recent history to estimate remaining time
+            const recentHistory = this.progressHistory.slice(-3); // Use last 3 points
+            const timeDeltas = [];
+            const progressDeltas = [];
+            for (let i = 1; i < recentHistory.length; i++) {
+                const timeDelta = (recentHistory[i].timestamp - recentHistory[i - 1].timestamp) /
+                    1000;
+                const progressDelta = recentHistory[i].completed - recentHistory[i - 1].completed;
+                if (progressDelta > 0) {
+                    timeDeltas.push(timeDelta);
+                    progressDeltas.push(progressDelta);
+                }
+            }
+            if (timeDeltas.length > 0 && progressDeltas.length > 0) {
+                // Calculate average time per item
+                const totalTime = timeDeltas.reduce((a, b) => a + b, 0);
+                const totalProgress = progressDeltas.reduce((a, b) => a + b, 0);
+                const avgTimePerItem = totalTime / totalProgress;
+                // Estimate remaining time
+                const remaining = this.total - current;
+                estimatedTimeRemaining = Math.round(avgTimePerItem * remaining);
+            }
+        }
+        else if (current > 0) {
+            // Fallback: use overall average
+            const avgTimePerItem = elapsed / current;
+            const remaining = this.total - current;
+            estimatedTimeRemaining = Math.round(avgTimePerItem * remaining);
+        }
+        return {
+            current,
+            total: this.total,
+            percentage,
+            status,
+            estimatedTimeRemaining,
+            currentItem,
+            ...additionalData,
+        };
+    }
+    /**
+     * Get final progress update
+     */
+    finalize(status = 'Complete') {
+        return {
+            current: this.total,
+            total: this.total,
+            percentage: 100,
+            status,
+            estimatedTimeRemaining: 0,
+        };
+    }
+    /**
+     * Reset the tracker
+     */
+    reset(newTotal) {
+        this.startTime = Date.now();
+        this.progressHistory = [];
+        if (newTotal !== undefined) {
+            this.total = newTotal;
+        }
+    }
+}
+/**
+ * Format time remaining in human-readable format
+ */
+export function formatTimeRemaining(seconds) {
+    if (seconds < 60) {
+        return `${seconds} second${seconds !== 1 ? 's' : ''}`;
+    }
+    else if (seconds < 3600) {
+        const minutes = Math.floor(seconds / 60);
+        const remainingSeconds = seconds % 60;
+        if (remainingSeconds === 0) {
+            return `${minutes} minute${minutes !== 1 ? 's' : ''}`;
+        }
+        return `${minutes} minute${minutes !== 1 ? 's' : ''} ${remainingSeconds} second${remainingSeconds !== 1 ? 's' : ''}`;
+    }
+    else {
+        const hours = Math.floor(seconds / 3600);
+        const minutes = Math.floor((seconds % 3600) / 60);
+        if (minutes === 0) {
+            return `${hours} hour${hours !== 1 ? 's' : ''}`;
+        }
+        return `${hours} hour${hours !== 1 ? 's' : ''} ${minutes} minute${minutes !== 1 ? 's' : ''}`;
+    }
+}
+/**
+ * Create a progress callback that formats updates for MCP responses
+ */
+export function createProgressCallback(onProgress) {
+    return (progress) => {
+        // Format progress message
+        const timeRemainingText = progress.estimatedTimeRemaining
+            ? ` (estimated ${formatTimeRemaining(progress.estimatedTimeRemaining)} remaining)`
+            : '';
+        const progressMessage = `Progress: ${progress.current}/${progress.total} (${progress.percentage}%) - ${progress.status}${timeRemainingText}`;
+        // Log to console
+        console.log(progressMessage);
+        // Call user-provided callback if available
+        if (onProgress) {
+            onProgress(progress);
+        }
+    };
+}
+/**
+ * Create a batch audit progress callback
+ */
+export function createBatchProgressCallback(onProgress) {
+    return (progress) => {
+        const timeRemainingText = progress.estimatedTimeRemaining
+            ? ` (estimated ${formatTimeRemaining(progress.estimatedTimeRemaining)} remaining)`
+            : '';
+        const completedCount = progress.completedUrls?.length || 0;
+        const failedCount = progress.failedUrls?.length || 0;
+        const currentUrlText = progress.currentUrl
+            ? ` - Current: ${progress.currentUrl}`
+            : '';
+        const progressMessage = `Batch Progress: ${progress.current}/${progress.total} (${progress.percentage}%) - ${progress.status}${timeRemainingText} - Completed: ${completedCount}, Failed: ${failedCount}${currentUrlText}`;
+        // Log to console
+        console.log(progressMessage);
+        // Call user-provided callback if available
+        if (onProgress) {
+            onProgress(progress);
+        }
+    };
+}
+//# sourceMappingURL=progress-streamer.js.map

package/dist/core/progress-streamer.js.map

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

package/dist/core/result-processor.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Result Processor - Formats accessibility results into conversational, actionable format
+ * Converts raw accessibility results into structured, prioritized, and human-readable format
+ */
+import type { AccessibilityResults, AuditResult, AppliedFilters } from '../types/index.js';
+/** Options passed when processing audit results (e.g. WCAG label used for the audit) */
+export interface ProcessOptions {
+    /** WCAG version and level used for the audit (e.g. "WCAG 2.2 AA"). Used when rule tags are empty. */
+    auditWcagLabel?: string;
+}
+/**
+ * Derive full WCAG label from engine tags (e.g. wcag22aa -> "WCAG 2.2 AA").
+ * Used for display and for audit fallback.
+ */
+export declare function getWcagLabelFromTags(tags: string[]): string;
+/** True if wcagLevel string matches the given level (A, AA, AAA); supports full label e.g. "WCAG 2.2 AA". */
+export declare function wcagLevelMatches(level: string, target: 'A' | 'AA' | 'AAA'): boolean;
+/** Numeric order for sorting by WCAG level (A=3, AA=2, AAA=1). Supports full label e.g. "WCAG 2.2 AA". */
+export declare function wcagLevelOrder(level: string): number;
+/**
+ * ResultProcessor class - Formats and processes accessibility results
+ */
+export declare class ResultProcessor {
+    /**
+     * Get WCAG level for display (full label e.g. "WCAG 2.2 AA"). Uses tags when present, else audit fallback.
+     */
+    private getWCAGLevel;
+    /**
+     * Determine impact level from engine-reported impact (axe or ACE native levels).
+     */
+    private getImpactLevel;
+    /**
+     * Get impact rank for ordering (higher = worse). Uses IMPACT_ORDER.
+     */
+    private impactRank;
+    /**
+     * Calculate priority score for an issue (higher = more important)
+     */
+    private calculatePriority;
+    /**
+     * Generate fix suggestion for an issue
+     */
+    private generateFixSuggestion;
+    /**
+     * Generate user impact description from engine-native impact level.
+     */
+    private generateUserImpact;
+    /**
+     * Process accessibility violations into prioritized issues
+     */
+    private processViolations;
+    /**
+     * Calculate accessibility score (0-100)
+     */
+    private calculateScore;
+    /**
+     * Calculate WCAG compliance percentages
+     */
+    private calculateWCAGCompliance;
+    /**
+     * Generate summary statistics
+     */
+    private generateSummary;
+    /**
+     * Identify quick wins (easy fixes with high impact)
+     */
+    private identifyQuickWins;
+    /**
+     * Identify critical blockers (must fix before launch)
+     */
+    private identifyCriticalBlockers;
+    /**
+     * Generate conversational summary
+     */
+    private generateConversationalSummary;
+    /**
+     * Generate a markdown table summarising all prioritised issues.
+     * Columns: Severity | Rule ID | Description | WCAG | Element / XPath | Fix hint
+     */
+    private generateIssuesTable;
+    /**
+     * Process accessibility results into structured audit result
+     */
+    process(accessibilityResults: AccessibilityResults, appliedFilters?: AppliedFilters, options?: ProcessOptions): AuditResult;
+}
+//# sourceMappingURL=result-processor.d.ts.map

package/dist/core/result-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-processor.d.ts","sourceRoot":"","sources":["../../src/core/result-processor.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,oBAAoB,EAEpB,WAAW,EAOX,cAAc,EAEf,MAAM,mBAAmB,CAAA;AAG1B,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAW3D;AAED,6GAA6G;AAC7G,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,GAAG,KAAK,GAAG,OAAO,CAInF;AAED,0GAA0G;AAC1G,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpD;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwC7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiFzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAqBtB;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAmB/B;;OAEG;IACH,OAAO,CAAC,eAAe;IA0BvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAwChC;;OAEG;IACH,OAAO,CAAC,6BAA6B;IAsErC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAoC3B;;OAEG;IACH,OAAO,CACL,oBAAoB,EAAE,oBAAoB,EAC1C,cAAc,CAAC,EAAE,cAAc,EAC/B,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW;CAiDf"}