agentic-qe 2.3.5 → 2.5.0

package/dist/mcp/tools/qe/accessibility/apg-patterns.d.ts

@@ -0,0 +1,103 @@
+/**
+ * ARIA Authoring Practices Guide (APG) Pattern Library
+ *
+ * Comprehensive database of accessible component patterns based on W3C APG
+ * Version: Based on APG 1.2 (2024)
+ *
+ * Purpose: Provide context-aware ARIA recommendations for accessible components
+ * Reference: https://www.w3.org/WAI/ARIA/apg/
+ */
+export interface KeyboardInteraction {
+    key: string;
+    action: string;
+    required: boolean;
+}
+export interface ARIAAttribute {
+    name: string;
+    required: boolean;
+    description: string;
+    possibleValues?: string[];
+    defaultValue?: string;
+}
+export interface APGPattern {
+    name: string;
+    description: string;
+    category: 'widget' | 'composite' | 'landmark' | 'live-region';
+    wcagCriteria: string[];
+    roles: {
+        primary: string;
+        related?: string[];
+    };
+    ariaAttributes: ARIAAttribute[];
+    keyboardInteractions: KeyboardInteraction[];
+    htmlExample: string;
+    javascriptExample?: string;
+    cssExample?: string;
+    commonMistakes: string[];
+    testingGuidelines: string[];
+    apgUrl: string;
+}
+export declare const APG_PATTERNS: Record<string, APGPattern>;
+/**
+ * Helper Functions
+ */
+/**
+ * Get APG pattern by name
+ */
+export declare function getAPGPattern(patternName: string): APGPattern | undefined;
+/**
+ * Find patterns by WCAG criterion
+ */
+export declare function getPatternsByWCAG(wcagCriterion: string): APGPattern[];
+/**
+ * Find patterns by role
+ */
+export declare function getPatternsByRole(role: string): APGPattern[];
+/**
+ * Get all patterns by category
+ */
+export declare function getPatternsByCategory(category: APGPattern['category']): APGPattern[];
+/**
+ * Suggest APG pattern based on element analysis
+ *
+ * @param elementContext - Context about the element (role, attributes, etc.)
+ * @returns Recommended APG pattern with confidence score
+ */
+export declare function suggestAPGPattern(elementContext: {
+    role?: string;
+    tagName?: string;
+    attributes?: Record<string, string>;
+    context?: string;
+}): {
+    pattern: APGPattern;
+    confidence: number;
+    reason: string;
+} | null;
+/**
+ * Generate code example for a specific pattern
+ */
+export declare function generatePatternCodeExample(patternName: string, options?: {
+    includeJavaScript?: boolean;
+    includeCSS?: boolean;
+    customLabel?: string;
+}): string;
+/**
+ * Get keyboard shortcuts reference for a pattern
+ */
+export declare function getKeyboardReference(patternName: string): string;
+/**
+ * Validate element against APG pattern requirements
+ */
+export declare function validateAgainstPattern(patternName: string, element: {
+    role?: string;
+    attributes: Record<string, string>;
+}): {
+    valid: boolean;
+    missingAttributes: string[];
+    incorrectValues: Array<{
+        attribute: string;
+        expected: string;
+        actual: string;
+    }>;
+};
+//# sourceMappingURL=apg-patterns.d.ts.map

package/dist/mcp/tools/qe/accessibility/apg-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apg-patterns.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/tools/qe/accessibility/apg-patterns.ts"],"names":[],"mappings":"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"}