agentic-qe 3.3.4 → 3.4.0

package/v3/dist/adapters/a2ui/accessibility/wcag-validator.d.ts

@@ -0,0 +1,186 @@
+/**
+ * A2UI WCAG 2.2 Compliance Validator
+ *
+ * Validates A2UI surfaces and components against WCAG 2.2 Level AA requirements.
+ * Provides detailed issue reporting with remediation guidance.
+ *
+ * Reference: https://www.w3.org/TR/WCAG22/
+ *
+ * @module adapters/a2ui/accessibility/wcag-validator
+ */
+import type { ComponentNode, SurfaceUpdateMessage } from '../renderer/message-types.js';
+/**
+ * WCAG conformance levels
+ */
+export type WCAGLevel = 'A' | 'AA' | 'AAA';
+/**
+ * WCAG principle categories
+ */
+export type WCAGPrinciple = 'perceivable' | 'operable' | 'understandable' | 'robust';
+/**
+ * Issue severity levels
+ */
+export type IssueSeverity = 'error' | 'warning' | 'notice';
+/**
+ * WCAG criterion definition
+ */
+export interface WCAGCriterion {
+    /** Criterion number (e.g., "1.1.1") */
+    readonly criterion: string;
+    /** Short name for the criterion */
+    readonly name: string;
+    /** Conformance level */
+    readonly level: WCAGLevel;
+    /** Principle category */
+    readonly principle: WCAGPrinciple;
+    /** Full description */
+    readonly description: string;
+    /** URL to WCAG documentation */
+    readonly url: string;
+}
+/**
+ * Accessibility issue found during validation
+ */
+export interface WCAGIssue {
+    /** WCAG criterion (e.g., "1.1.1") */
+    readonly criterion: string;
+    /** Conformance level */
+    readonly level: WCAGLevel;
+    /** Severity of the issue */
+    readonly severity: IssueSeverity;
+    /** Component ID where issue was found */
+    readonly componentId: string;
+    /** Component type */
+    readonly componentType: string;
+    /** Human-readable message */
+    readonly message: string;
+    /** Suggested fix */
+    readonly remediation: string;
+    /** Affected property or attribute */
+    readonly property?: string;
+    /** Actual value found */
+    readonly actual?: string;
+    /** Expected value or pattern */
+    readonly expected?: string;
+}
+/**
+ * Accessibility warning (non-critical)
+ */
+export interface WCAGWarning {
+    /** WCAG criterion (e.g., "1.3.1") */
+    readonly criterion: string;
+    /** Component ID */
+    readonly componentId: string;
+    /** Warning message */
+    readonly message: string;
+    /** Suggestion */
+    readonly suggestion: string;
+}
+/**
+ * Passed criterion for tracking
+ */
+export interface WCAGPassedCriterion {
+    /** WCAG criterion */
+    readonly criterion: string;
+    /** Short name */
+    readonly name: string;
+    /** Components that passed */
+    readonly componentCount: number;
+}
+/**
+ * Validation result for a surface
+ */
+export interface WCAGValidationResult {
+    /** Whether the surface passed validation at the specified level */
+    readonly valid: boolean;
+    /** Target conformance level */
+    readonly level: WCAGLevel;
+    /** Surface ID that was validated */
+    readonly surfaceId: string;
+    /** List of accessibility issues */
+    readonly issues: WCAGIssue[];
+    /** List of warnings */
+    readonly warnings: WCAGWarning[];
+    /** List of passed criteria */
+    readonly passed: WCAGPassedCriterion[];
+    /** Total components validated */
+    readonly componentCount: number;
+    /** Validation timestamp */
+    readonly timestamp: string;
+    /** Validation duration in ms */
+    readonly duration: number;
+}
+/**
+ * Component validation result
+ */
+export interface ComponentValidationResult {
+    /** Component ID */
+    readonly componentId: string;
+    /** Component type */
+    readonly componentType: string;
+    /** Issues found */
+    readonly issues: WCAGIssue[];
+    /** Warnings */
+    readonly warnings: WCAGWarning[];
+}
+/**
+ * Accessibility requirement for a component type
+ */
+export interface AccessibilityRequirement {
+    /** Component type */
+    readonly componentType: string;
+    /** Required properties */
+    readonly required: string[];
+    /** Required ARIA attributes */
+    readonly aria: string[];
+    /** Required keyboard interactions */
+    readonly keyboard: string[];
+    /** WCAG criteria that apply */
+    readonly criteria: string[];
+    /** Additional notes */
+    readonly notes?: string;
+}
+/**
+ * WCAG 2.2 Level A criteria
+ */
+export declare const WCAG_LEVEL_A_CRITERIA: Record<string, WCAGCriterion>;
+/**
+ * WCAG 2.2 Level AA criteria (in addition to Level A)
+ */
+export declare const WCAG_LEVEL_AA_CRITERIA: Record<string, WCAGCriterion>;
+/**
+ * Get all criteria for a conformance level
+ */
+export declare function getCriteriaForLevel(level: WCAGLevel): WCAGCriterion[];
+/**
+ * Get criterion by ID
+ */
+export declare function getCriterion(criterionId: string): WCAGCriterion | undefined;
+/**
+ * Accessibility requirements by component type
+ */
+export declare const COMPONENT_REQUIREMENTS: Record<string, AccessibilityRequirement>;
+/**
+ * Get accessibility requirements for component type
+ */
+export declare function getAccessibilityRequirements(componentType: string): AccessibilityRequirement | undefined;
+/**
+ * Validate a single component for WCAG compliance
+ */
+export declare function validateComponent(component: ComponentNode, level?: WCAGLevel): ComponentValidationResult;
+/**
+ * Validate a surface for WCAG compliance
+ */
+export declare function validateSurface(surface: SurfaceUpdateMessage, level?: WCAGLevel): WCAGValidationResult;
+/**
+ * Get a summary of accessibility issues by criterion
+ */
+export declare function getIssueSummary(issues: WCAGIssue[]): Record<string, {
+    count: number;
+    components: string[];
+}>;
+/**
+ * Get accessibility score (0-100)
+ */
+export declare function getAccessibilityScore(result: WCAGValidationResult): number;
+//# sourceMappingURL=wcag-validator.d.ts.map

package/v3/dist/adapters/a2ui/accessibility/wcag-validator.d.ts.map

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