@agentic-qe/v3 3.0.0-alpha.10

package/dist/domains/visual-accessibility/plugin.js

@@ -0,0 +1,343 @@
+/**
+ * Agentic QE v3 - Visual & Accessibility Domain Plugin
+ * Integrates the visual & accessibility testing domain into the kernel
+ */
+import { BaseDomainPlugin } from '../domain-interface.js';
+import { VisualAccessibilityCoordinator, } from './coordinator.js';
+import { VisualTesterService, } from './services/visual-tester.js';
+import { AccessibilityTesterService, } from './services/accessibility-tester.js';
+import { ResponsiveTesterService, } from './services/responsive-tester.js';
+/**
+ * Visual & Accessibility Domain Plugin
+ * Provides visual regression, accessibility auditing, and responsive testing
+ */
+export class VisualAccessibilityPlugin extends BaseDomainPlugin {
+    agentCoordinator;
+    coordinator = null;
+    visualTester = null;
+    accessibilityTester = null;
+    responsiveTester = null;
+    pluginConfig;
+    constructor(eventBus, memory, agentCoordinator, config = {}) {
+        super(eventBus, memory);
+        this.agentCoordinator = agentCoordinator;
+        this.pluginConfig = config;
+    }
+    // ============================================================================
+    // DomainPlugin Interface Implementation
+    // ============================================================================
+    get name() {
+        return 'visual-accessibility';
+    }
+    get version() {
+        return '1.0.0';
+    }
+    get dependencies() {
+        // Visual accessibility testing is independent but can use code intelligence
+        return [];
+    }
+    /**
+     * Get the domain's public API
+     */
+    getAPI() {
+        const api = {
+            // Coordinator methods
+            runVisualTests: this.runVisualTests.bind(this),
+            runAccessibilityAudit: this.runAccessibilityAudit.bind(this),
+            approveVisualChanges: this.approveVisualChanges.bind(this),
+            generateRemediationPlan: this.generateRemediationPlan.bind(this),
+            getVisualTestingStatus: this.getVisualTestingStatus.bind(this),
+            // Visual testing service methods
+            captureScreenshot: this.captureScreenshot.bind(this),
+            captureElement: this.captureElement.bind(this),
+            // Accessibility service methods
+            auditAccessibility: this.auditAccessibility.bind(this),
+            checkContrast: this.checkContrast.bind(this),
+            validateWCAGLevel: this.validateWCAGLevel.bind(this),
+            checkKeyboardNavigation: this.checkKeyboardNavigation.bind(this),
+            // Responsive testing service methods
+            testResponsiveness: this.testResponsiveness.bind(this),
+            analyzeBreakpoints: this.analyzeBreakpoints.bind(this),
+            // Internal access methods
+            getCoordinator: () => this.coordinator,
+            getVisualTester: () => this.visualTester,
+            getAccessibilityTester: () => this.accessibilityTester,
+            getResponsiveTester: () => this.responsiveTester,
+        };
+        return api;
+    }
+    // ============================================================================
+    // Lifecycle Methods
+    // ============================================================================
+    async onInitialize() {
+        // Create services
+        this.visualTester = new VisualTesterService(this.memory, this.pluginConfig.visualTester);
+        this.accessibilityTester = new AccessibilityTesterService(this.memory, this.pluginConfig.accessibilityTester);
+        this.responsiveTester = new ResponsiveTesterService(this.memory, this.pluginConfig.responsiveTester);
+        // Create coordinator
+        this.coordinator = new VisualAccessibilityCoordinator(this.eventBus, this.memory, this.agentCoordinator, this.pluginConfig.coordinator, this.pluginConfig.visualTester, this.pluginConfig.accessibilityTester, this.pluginConfig.responsiveTester);
+        // Initialize coordinator
+        await this.coordinator.initialize();
+        // Update health status
+        this.updateHealth({
+            status: 'healthy',
+            agents: { total: 0, active: 0, idle: 0, failed: 0 },
+            lastActivity: new Date(),
+            errors: [],
+        });
+    }
+    async onDispose() {
+        if (this.coordinator) {
+            await this.coordinator.dispose();
+        }
+        this.coordinator = null;
+        this.visualTester = null;
+        this.accessibilityTester = null;
+        this.responsiveTester = null;
+    }
+    subscribeToEvents() {
+        // Subscribe to deployment events for automated testing
+        this.eventBus.subscribe('ci-cd.DeploymentCompleted', this.handleDeploymentCompleted.bind(this));
+        // Subscribe to code changes for affected component testing
+        this.eventBus.subscribe('code-intelligence.FileChanged', this.handleFileChanged.bind(this));
+        // Subscribe to quality gate events
+        this.eventBus.subscribe('quality-assessment.QualityGateTriggered', this.handleQualityGateTriggered.bind(this));
+    }
+    async onEvent(event) {
+        // Track activity
+        this.updateHealth({
+            lastActivity: new Date(),
+        });
+        // Route to appropriate handler based on event type
+        switch (event.type) {
+            case 'ci-cd.DeploymentCompleted':
+                await this.handleDeploymentCompleted(event);
+                break;
+            case 'code-intelligence.FileChanged':
+                await this.handleFileChanged(event);
+                break;
+            default:
+                // No specific handling needed
+                break;
+        }
+    }
+    // ============================================================================
+    // API Implementation - Coordinator Methods
+    // ============================================================================
+    async runVisualTests(urls, viewports) {
+        this.ensureInitialized();
+        try {
+            const result = await this.coordinator.runVisualTests(urls, viewports);
+            if (result.success) {
+                this.trackSuccessfulTest('visual', result.value.totalTests);
+            }
+            else {
+                this.trackFailedTest(result.error);
+            }
+            return result;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async runAccessibilityAudit(urls, level) {
+        this.ensureInitialized();
+        try {
+            const result = await this.coordinator.runAccessibilityAudit(urls, level);
+            if (result.success) {
+                this.trackSuccessfulTest('accessibility', result.value.totalUrls);
+            }
+            else {
+                this.trackFailedTest(result.error);
+            }
+            return result;
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async approveVisualChanges(diffIds, reason) {
+        this.ensureInitialized();
+        try {
+            return await this.coordinator.approveVisualChanges(diffIds, reason);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async generateRemediationPlan(violations) {
+        this.ensureInitialized();
+        try {
+            return await this.coordinator.generateRemediationPlan(violations);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async getVisualTestingStatus() {
+        this.ensureInitialized();
+        try {
+            return await this.coordinator.getVisualTestingStatus();
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    // ============================================================================
+    // API Implementation - Visual Tester Methods
+    // ============================================================================
+    async captureScreenshot(url, options) {
+        this.ensureInitialized();
+        try {
+            return await this.visualTester.captureScreenshot(url, options);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async captureElement(url, selector, options) {
+        this.ensureInitialized();
+        try {
+            return await this.visualTester.captureElement(url, selector, options);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    // ============================================================================
+    // API Implementation - Accessibility Tester Methods
+    // ============================================================================
+    async auditAccessibility(url, options) {
+        this.ensureInitialized();
+        try {
+            return await this.accessibilityTester.audit(url, options);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async checkContrast(url) {
+        this.ensureInitialized();
+        try {
+            return await this.accessibilityTester.checkContrast(url);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async validateWCAGLevel(url, level) {
+        this.ensureInitialized();
+        try {
+            return await this.accessibilityTester.validateWCAGLevel(url, level);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async checkKeyboardNavigation(url) {
+        this.ensureInitialized();
+        try {
+            return await this.accessibilityTester.checkKeyboardNavigation(url);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    // ============================================================================
+    // API Implementation - Responsive Tester Methods
+    // ============================================================================
+    async testResponsiveness(url, options) {
+        this.ensureInitialized();
+        try {
+            return await this.responsiveTester.testResponsiveness(url, options);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    async analyzeBreakpoints(url) {
+        this.ensureInitialized();
+        try {
+            return await this.responsiveTester.analyzeBreakpoints(url);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    // ============================================================================
+    // Event Handlers
+    // ============================================================================
+    async handleDeploymentCompleted(event) {
+        // Deployment completed - could trigger visual and accessibility tests
+        const payload = event.payload;
+        // Store deployment info for potential testing
+        await this.memory.set(`visual-accessibility:deployment:${Date.now()}`, payload, { namespace: 'visual-accessibility', ttl: 3600 });
+    }
+    async handleFileChanged(event) {
+        // File changed - could trigger affected component tests
+        const payload = event.payload;
+        // Store for potential component-level testing
+        if (payload.file.endsWith('.css') || payload.file.endsWith('.scss')) {
+            await this.memory.set(`visual-accessibility:style-change:${Date.now()}`, payload, { namespace: 'visual-accessibility', ttl: 3600 });
+        }
+    }
+    async handleQualityGateTriggered(event) {
+        // Quality gate triggered - could include accessibility in quality checks
+        const payload = event.payload;
+        if (payload.checks.includes('accessibility')) {
+            await this.memory.set(`visual-accessibility:quality-gate:${payload.gateId}`, { pending: true, timestamp: Date.now() }, { namespace: 'visual-accessibility', ttl: 3600 });
+        }
+    }
+    // ============================================================================
+    // Helper Methods
+    // ============================================================================
+    ensureInitialized() {
+        if (!this._initialized) {
+            throw new Error('VisualAccessibilityPlugin is not initialized');
+        }
+        if (!this.coordinator ||
+            !this.visualTester ||
+            !this.accessibilityTester ||
+            !this.responsiveTester) {
+            throw new Error('VisualAccessibilityPlugin services are not available');
+        }
+    }
+    handleError(error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        // Track error
+        const currentHealth = this.getHealth();
+        this.updateHealth({
+            errors: [...currentHealth.errors.slice(-9), err.message],
+            status: currentHealth.errors.length >= 5 ? 'degraded' : currentHealth.status,
+        });
+        return { success: false, error: err };
+    }
+    trackSuccessfulTest(_type, _count) {
+        const health = this.getHealth();
+        this.updateHealth({
+            agents: {
+                ...health.agents,
+                total: health.agents.total + 1,
+                idle: health.agents.idle + 1,
+            },
+            lastActivity: new Date(),
+        });
+    }
+    trackFailedTest(error) {
+        const health = this.getHealth();
+        this.updateHealth({
+            agents: {
+                ...health.agents,
+                failed: health.agents.failed + 1,
+            },
+            errors: [...health.errors.slice(-9), error.message],
+        });
+    }
+}
+/**
+ * Factory function to create a VisualAccessibilityPlugin
+ */
+export function createVisualAccessibilityPlugin(eventBus, memory, agentCoordinator, config) {
+    return new VisualAccessibilityPlugin(eventBus, memory, agentCoordinator, config);
+}
+//# sourceMappingURL=plugin.js.map

package/dist/domains/visual-accessibility/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../../src/domains/visual-accessibility/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAgB1D,OAAO,EACL,8BAA8B,GAG/B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,mBAAmB,GAEpB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,0BAA0B,GAE3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,uBAAuB,GAIxB,MAAM,iCAAiC,CAAC;AA4CzC;;;GAGG;AACH,MAAM,OAAO,yBAA0B,SAAQ,gBAAgB;IAU1C;IATX,WAAW,GAAmD,IAAI,CAAC;IACnE,YAAY,GAA+B,IAAI,CAAC;IAChD,mBAAmB,GAAsC,IAAI,CAAC;IAC9D,gBAAgB,GAAmC,IAAI,CAAC;IAC/C,YAAY,CAAkC;IAE/D,YACE,QAAkB,EAClB,MAAqB,EACJ,gBAAkC,EACnD,SAA0C,EAAE;QAE5C,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAHP,qBAAgB,GAAhB,gBAAgB,CAAkB;QAInD,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC;IAC7B,CAAC;IAED,+EAA+E;IAC/E,wCAAwC;IACxC,+EAA+E;IAE/E,IAAI,IAAI;QACN,OAAO,sBAAsB,CAAC;IAChC,CAAC;IAED,IAAI,OAAO;QACT,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,YAAY;QACd,4EAA4E;QAC5E,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,MAAM,GAAG,GAA2B;YAClC,sBAAsB;YACtB,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YAC9C,qBAAqB,EAAE,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5D,oBAAoB,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1D,uBAAuB,EAAE,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;YAChE,sBAAsB,EAAE,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,IAAI,CAAC;YAE9D,iCAAiC;YACjC,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;YACpD,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;YAE9C,gCAAgC;YAChC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;YACtD,aAAa,EAAE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5C,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC;YACpD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;YAEhE,qCAAqC;YACrC,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;YACtD,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;YAEtD,0BAA0B;YAC1B,cAAc,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,WAAY;YACvC,eAAe,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,YAAa;YACzC,sBAAsB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,mBAAoB;YACvD,mBAAmB,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAiB;SAClD,CAAC;QAEF,OAAO,GAAQ,CAAC;IAClB,CAAC;IAED,+EAA+E;IAC/E,oBAAoB;IACpB,+EAA+E;IAErE,KAAK,CAAC,YAAY;QAC1B,kBAAkB;QAClB,IAAI,CAAC,YAAY,GAAG,IAAI,mBAAmB,CACzC,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,CAAC,YAAY,CAC/B,CAAC;QAEF,IAAI,CAAC,mBAAmB,GAAG,IAAI,0BAA0B,CACvD,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,CAAC,mBAAmB,CACtC,CAAC;QAEF,IAAI,CAAC,gBAAgB,GAAG,IAAI,uBAAuB,CACjD,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,YAAY,CAAC,gBAAgB,CACnC,CAAC;QAEF,qBAAqB;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,8BAA8B,CACnD,IAAI,CAAC,QAAQ,EACb,IAAI,CAAC,MAAM,EACX,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,YAAY,CAAC,WAAW,EAC7B,IAAI,CAAC,YAAY,CAAC,YAAY,EAC9B,IAAI,CAAC,YAAY,CAAC,mBAAmB,EACrC,IAAI,CAAC,YAAY,CAAC,gBAAgB,CACnC,CAAC;QAEF,yBAAyB;QACzB,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAEpC,uBAAuB;QACvB,IAAI,CAAC,YAAY,CAAC;YAChB,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE;YACnD,YAAY,EAAE,IAAI,IAAI,EAAE;YACxB,MAAM,EAAE,EAAE;SACX,CAAC,CAAC;IACL,CAAC;IAES,KAAK,CAAC,SAAS;QACvB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACnC,CAAC;QAED,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QACzB,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAC;QAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAC/B,CAAC;IAES,iBAAiB;QACzB,uDAAuD;QACvD,IAAI,CAAC,QAAQ,CAAC,SAAS,CACrB,2BAA2B,EAC3B,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,CAC1C,CAAC;QAEF,2DAA2D;QAC3D,IAAI,CAAC,QAAQ,CAAC,SAAS,CACrB,+BAA+B,EAC/B,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAClC,CAAC;QAEF,mCAAmC;QACnC,IAAI,CAAC,QAAQ,CAAC,SAAS,CACrB,yCAAyC,EACzC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,IAAI,CAAC,CAC3C,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,OAAO,CAAC,KAAkB;QACxC,iBAAiB;QACjB,IAAI,CAAC,YAAY,CAAC;YAChB,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC,CAAC;QAEH,mDAAmD;QACnD,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;YACnB,KAAK,2BAA2B;gBAC9B,MAAM,IAAI,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC;gBAC5C,MAAM;YACR,KAAK,+BAA+B;gBAClC,MAAM,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;gBACpC,MAAM;YACR;gBACE,8BAA8B;gBAC9B,MAAM;QACV,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,2CAA2C;IAC3C,+EAA+E;IAEvE,KAAK,CAAC,cAAc,CAC1B,IAAc,EACd,SAAqB;QAErB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAY,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAEvE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC,mBAAmB,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;YAC9D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,qBAAqB,CACjC,IAAc,EACd,KAAyB;QAEzB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAY,CAAC,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAE1E,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,IAAI,CAAC,mBAAmB,CAAC,eAAe,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACrC,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,oBAAoB,CAChC,OAAiB,EACjB,MAAc;QAEd,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,WAAY,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,UAAoC;QAEpC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,WAAY,CAAC,uBAAuB,CAAC,UAAU,CAAC,CAAC;QACrE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAClC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,WAAY,CAAC,sBAAsB,EAAE,CAAC;QAC1D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,6CAA6C;IAC7C,+EAA+E;IAEvE,KAAK,CAAC,iBAAiB,CAC7B,GAAW,EACX,OAAwB;QAExB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAa,CAAC,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAClE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAC1B,GAAW,EACX,QAAgB,EAChB,OAAwB;QAExB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,YAAa,CAAC,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACzE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,oDAAoD;IACpD,+EAA+E;IAEvE,KAAK,CAAC,kBAAkB,CAC9B,GAAW,EACX,OAAsB;QAEtB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,mBAAoB,CAAC,KAAK,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC7D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,aAAa,CAAC,GAAW;QACrC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,mBAAoB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,GAAW,EACX,KAAyB;QAEzB,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,mBAAoB,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,uBAAuB,CACnC,GAAW;QAEX,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,mBAAoB,CAAC,uBAAuB,CAAC,GAAG,CAAC,CAAC;QACtE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,iDAAiD;IACjD,+EAA+E;IAEvE,KAAK,CAAC,kBAAkB,CAC9B,GAAW,EACX,OAAuC;QAEvC,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,gBAAiB,CAAC,kBAAkB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,GAAW;QAC1C,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAEzB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,gBAAiB,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,iBAAiB;IACjB,+EAA+E;IAEvE,KAAK,CAAC,yBAAyB,CAAC,KAAkB;QACxD,sEAAsE;QACtE,MAAM,OAAO,GAAG,KAAK,CAAC,OAGrB,CAAC;QAEF,8CAA8C;QAC9C,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACnB,mCAAmC,IAAI,CAAC,GAAG,EAAE,EAAE,EAC/C,OAAO,EACP,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,CACjD,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,KAAkB;QAChD,wDAAwD;QACxD,MAAM,OAAO,GAAG,KAAK,CAAC,OAGrB,CAAC;QAEF,8CAA8C;QAC9C,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACnB,qCAAqC,IAAI,CAAC,GAAG,EAAE,EAAE,EACjD,OAAO,EACP,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,0BAA0B,CAAC,KAAkB;QACzD,yEAAyE;QACzE,MAAM,OAAO,GAAG,KAAK,CAAC,OAGrB,CAAC;QAEF,IAAI,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CACnB,qCAAqC,OAAO,CAAC,MAAM,EAAE,EACrD,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,EACxC,EAAE,SAAS,EAAE,sBAAsB,EAAE,GAAG,EAAE,IAAI,EAAE,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,iBAAiB;IACjB,+EAA+E;IAEvE,iBAAiB;QACvB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,IACE,CAAC,IAAI,CAAC,WAAW;YACjB,CAAC,IAAI,CAAC,YAAY;YAClB,CAAC,IAAI,CAAC,mBAAmB;YACzB,CAAC,IAAI,CAAC,gBAAgB,EACtB,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IAEO,WAAW,CAAI,KAAc;QACnC,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QAEtE,cAAc;QACd,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACvC,IAAI,CAAC,YAAY,CAAC;YAChB,MAAM,EAAE,CAAC,GAAG,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;YACxD,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM;SAC7E,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACxC,CAAC;IAEO,mBAAmB,CAAC,KAAa,EAAE,MAAc;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC;YAChB,MAAM,EAAE;gBACN,GAAG,MAAM,CAAC,MAAM;gBAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,GAAG,CAAC;gBAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC;aAC7B;YACD,YAAY,EAAE,IAAI,IAAI,EAAE;SACzB,CAAC,CAAC;IACL,CAAC;IAEO,eAAe,CAAC,KAAY;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAChC,IAAI,CAAC,YAAY,CAAC;YAChB,MAAM,EAAE;gBACN,GAAG,MAAM,CAAC,MAAM;gBAChB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;aACjC;YACD,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC;SACpD,CAAC,CAAC;IACL,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAC7C,QAAkB,EAClB,MAAqB,EACrB,gBAAkC,EAClC,MAAwC;IAExC,OAAO,IAAI,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,CAAC,CAAC;AACnF,CAAC"}

package/dist/domains/visual-accessibility/services/accessibility-tester.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Agentic QE v3 - Accessibility Testing Service
+ * Implements WCAG 2.2 compliance auditing
+ */
+import { Result } from '../../../shared/types/index.js';
+import { MemoryBackend } from '../../../kernel/interfaces.js';
+import { IAccessibilityAuditingService, AccessibilityReport, WCAGValidationResult, ContrastAnalysis, KeyboardNavigationReport, AuditOptions } from '../interfaces.js';
+/**
+ * Configuration for the accessibility tester
+ */
+export interface AccessibilityTesterConfig {
+    defaultWCAGLevel: 'A' | 'AA' | 'AAA';
+    includeWarnings: boolean;
+    auditTimeout: number;
+    enableColorContrastCheck: boolean;
+    enableKeyboardCheck: boolean;
+    /**
+     * Enable simulation mode for testing purposes only.
+     * When true, returns deterministic stub data.
+     * When false (default), delegates to real axe-core or returns empty results.
+     */
+    simulationMode: boolean;
+}
+/**
+ * Accessibility Auditing Service Implementation
+ * Provides WCAG 2.2 compliance checking
+ */
+export declare class AccessibilityTesterService implements IAccessibilityAuditingService {
+    private readonly memory;
+    private readonly config;
+    private readonly rules;
+    constructor(memory: MemoryBackend, config?: Partial<AccessibilityTesterConfig>);
+    /**
+     * Run full accessibility audit
+     */
+    audit(url: string, options?: AuditOptions): Promise<Result<AccessibilityReport, Error>>;
+    /**
+     * Audit specific element
+     */
+    auditElement(url: string, _selector: string): Promise<Result<AccessibilityReport, Error>>;
+    /**
+     * Check color contrast
+     * Analyzes common page elements for WCAG 2.2 contrast compliance
+     */
+    checkContrast(url: string): Promise<Result<ContrastAnalysis[], Error>>;
+    /**
+     * Validate against specific WCAG level
+     * Evaluates page compliance with WCAG 2.2 success criteria
+     */
+    validateWCAGLevel(url: string, level: 'A' | 'AA' | 'AAA'): Promise<Result<WCAGValidationResult, Error>>;
+    /**
+     * Validate a specific WCAG criterion
+     */
+    private validateCriterion;
+    /**
+     * Check keyboard navigation
+     * Analyzes focusable elements, tab order, and potential focus traps
+     */
+    checkKeyboardNavigation(url: string): Promise<Result<KeyboardNavigationReport, Error>>;
+    private initializeRules;
+    private filterRulesByLevel;
+    private runRule;
+    /**
+     * Heuristic-based WCAG rule checking for production mode.
+     * Analyzes URL patterns and common accessibility issues without browser automation.
+     * This provides baseline checks; full auditing requires browser-based tools like axe-core.
+     */
+    private checkRuleWithHeuristics;
+    private isLikelyImageHeavyPage;
+    private isLikelyInteractivePage;
+    private isLikelyMissingLang;
+    private hasNavigationPatterns;
+    private isLikelySPA;
+    private hasSkipLinkPattern;
+    private isFormPage;
+    private hasModalPatterns;
+    private hasComplexLayoutPatterns;
+    private generateImageAltWarnings;
+    private generateButtonNameWarnings;
+    private generateContrastWarnings;
+    private generateLinkNameWarnings;
+    private generateFocusVisibleWarnings;
+    private generateFormLabelWarnings;
+    private generateKeyboardTrapWarnings;
+    private generateFocusOrderWarnings;
+    /**
+     * Deterministic rule check for simulation mode only.
+     * Uses URL hash to produce consistent results without Math.random().
+     */
+    private checkRuleDeterministic;
+    /**
+     * Generate a deterministic selector based on rule ID and index
+     */
+    private generateDeterministicSelector;
+    /**
+     * Estimate the number of elements checked based on rule category
+     */
+    private estimateCheckedNodes;
+    /**
+     * Analyze contrast for common UI elements
+     */
+    private analyzeContrastForElements;
+    /**
+     * Generate tab order based on URL structure
+     */
+    private generateTabOrder;
+    private detectKeyboardIssues;
+    /**
+     * Detect focus traps based on URL patterns
+     */
+    private detectFocusTraps;
+    private storeReport;
+    private hashUrl;
+}
+//# sourceMappingURL=accessibility-tester.d.ts.map

package/dist/domains/visual-accessibility/services/accessibility-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accessibility-tester.d.ts","sourceRoot":"","sources":["../../../../src/domains/visual-accessibility/services/accessibility-tester.ts"],"names":[],"mappings":"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"}