@triedotdev/mcp 1.0.38 → 1.0.39

package/dist/{chunk-HRNBSXN2.js → chunk-B3MBKB2U.js}

@@ -887,10 +887,72 @@ var ComprehensionAgent = class extends BaseAgent {
 };
 
 // src/agents/accessibility.ts
+var WCAG_CRITERIA = {
+  // Perceivable
+  "1.1.1": { name: "Non-text Content", level: "A", description: "All non-text content has text alternatives" },
+  "1.3.1": { name: "Info and Relationships", level: "A", description: "Information and relationships are programmatically determinable" },
+  "1.3.2": { name: "Meaningful Sequence", level: "A", description: "Reading order is correct and meaningful" },
+  "1.3.5": { name: "Identify Input Purpose", level: "AA", description: "Input purpose can be programmatically determined" },
+  "1.4.1": { name: "Use of Color", level: "A", description: "Color is not the only means of conveying information" },
+  "1.4.3": { name: "Contrast (Minimum)", level: "AA", description: "Text has 4.5:1 contrast ratio (3:1 for large text)" },
+  "1.4.4": { name: "Resize Text", level: "AA", description: "Text can be resized up to 200% without loss of functionality" },
+  "1.4.10": { name: "Reflow", level: "AA", description: "Content can reflow without horizontal scrolling at 320px width" },
+  "1.4.11": { name: "Non-text Contrast", level: "AA", description: "UI components have 3:1 contrast ratio" },
+  "1.4.12": { name: "Text Spacing", level: "AA", description: "No loss of content when text spacing is adjusted" },
+  "1.4.13": { name: "Content on Hover or Focus", level: "AA", description: "Hover/focus content is dismissible, hoverable, persistent" },
+  // Operable
+  "2.1.1": { name: "Keyboard", level: "A", description: "All functionality is available from keyboard" },
+  "2.1.2": { name: "No Keyboard Trap", level: "A", description: "Keyboard focus can be moved away using standard keys" },
+  "2.4.1": { name: "Bypass Blocks", level: "A", description: "Skip links or landmarks allow bypassing repeated content" },
+  "2.4.3": { name: "Focus Order", level: "A", description: "Focus order preserves meaning and operability" },
+  "2.4.4": { name: "Link Purpose (In Context)", level: "A", description: "Link purpose is clear from text or context" },
+  "2.4.6": { name: "Headings and Labels", level: "AA", description: "Headings and labels describe topic or purpose" },
+  "2.4.7": { name: "Focus Visible", level: "AA", description: "Keyboard focus indicator is visible" },
+  "2.5.5": { name: "Target Size", level: "AAA", description: "Touch targets are at least 44\xD744 CSS pixels" },
+  "2.5.8": { name: "Target Size (Minimum)", level: "AA", description: "Touch targets are at least 24\xD724 CSS pixels" },
+  // Understandable
+  "3.2.1": { name: "On Focus", level: "A", description: "Focus does not trigger unexpected context changes" },
+  "3.2.2": { name: "On Input", level: "A", description: "Input does not trigger unexpected context changes" },
+  "3.3.1": { name: "Error Identification", level: "A", description: "Errors are identified and described in text" },
+  "3.3.2": { name: "Labels or Instructions", level: "A", description: "Labels or instructions are provided for user input" },
+  // Robust
+  "4.1.1": { name: "Parsing", level: "A", description: "HTML is well-formed with unique IDs" },
+  "4.1.2": { name: "Name, Role, Value", level: "A", description: "UI components have accessible name, role, and state" },
+  "4.1.3": { name: "Status Messages", level: "AA", description: "Status messages are announced to assistive technology" }
+};
+var REQUIRED_ARIA_ATTRIBUTES = {
+  "checkbox": ["aria-checked"],
+  "combobox": ["aria-expanded", "aria-controls"],
+  "grid": ["aria-rowcount", "aria-colcount"],
+  "gridcell": [],
+  "heading": ["aria-level"],
+  "listbox": [],
+  "menu": [],
+  "menubar": [],
+  "menuitem": [],
+  "menuitemcheckbox": ["aria-checked"],
+  "menuitemradio": ["aria-checked"],
+  "option": ["aria-selected"],
+  "progressbar": ["aria-valuenow", "aria-valuemin", "aria-valuemax"],
+  "radio": ["aria-checked"],
+  "scrollbar": ["aria-controls", "aria-valuenow", "aria-valuemin", "aria-valuemax", "aria-orientation"],
+  "searchbox": [],
+  "separator": [],
+  "slider": ["aria-valuenow", "aria-valuemin", "aria-valuemax"],
+  "spinbutton": ["aria-valuenow", "aria-valuemin", "aria-valuemax"],
+  "switch": ["aria-checked"],
+  "tab": ["aria-selected"],
+  "tablist": [],
+  "tabpanel": [],
+  "textbox": [],
+  "tree": [],
+  "treegrid": [],
+  "treeitem": []
+};
 var AccessibilityAgent = class extends BaseAgent {
   name = "accessibility";
-  description = "WCAG 2.1 accessibility compliance, keyboard nav, screen readers, color contrast";
-  version = "1.0.0";
+  description = "WCAG 2.1 AA compliance: screen readers, keyboard nav, color contrast, touch targets, semantic HTML, ARIA patterns";
+  version = "2.0.0";
   shouldActivate(context) {
     return context.touchesUI;
   }
@@ -899,154 +961,934 @@ var AccessibilityAgent = class extends BaseAgent {
     for (const file of files) {
       try {
         const content = await this.readFile(file);
-        issues.push(...this.analyzeAccessibility(content, file));
-        issues.push(...this.analyzeUXPatterns(content, file));
+        if (this.isFrontendFile(file)) {
+          issues.push(...this.analyzeImages(content, file));
+          issues.push(...this.analyzeInteractiveElements(content, file));
+          issues.push(...this.analyzeFormAccessibility(content, file));
+          issues.push(...this.analyzeKeyboardNavigation(content, file));
+          issues.push(...this.analyzeSemanticStructure(content, file));
+          issues.push(...this.analyzeARIAUsage(content, file));
+          issues.push(...this.analyzeColorAccessibility(content, file));
+          issues.push(...this.analyzeTouchTargets(content, file));
+          issues.push(...this.analyzeMotionAccessibility(content, file));
+          issues.push(...this.analyzeLinks(content, file));
+        }
       } catch (error) {
         console.error(`Accessibility Agent: Error reading file ${file}:`, error);
       }
     }
+    const criticalCount = issues.filter((i) => i.severity === "critical").length;
+    const seriousCount = issues.filter((i) => i.severity === "serious").length;
+    if (criticalCount > 0 || seriousCount > 2) {
+      const score = this.calculateAccessibilityScore(issues);
+      issues.push(this.createIssue(
+        this.generateIssueId(),
+        criticalCount > 0 ? "critical" : "serious",
+        `Accessibility Score: ${score}/100 \u2014 ${criticalCount} critical, ${seriousCount} serious issues`,
+        `Review and fix accessibility issues starting with critical problems. Use axe-core or Lighthouse for additional validation.`,
+        files[0] || "project",
+        void 0,
+        0.95,
+        void 0,
+        false
+      ));
+    }
     return issues;
   }
-  analyzeAccessibility(content, file) {
+  isFrontendFile(file) {
+    return /\.(tsx|jsx|vue|svelte|astro|html|htm)$/.test(file);
+  }
+  /**
+   * Calculate accessibility score based on issues
+   */
+  calculateAccessibilityScore(issues) {
+    const criticalPenalty = issues.filter((i) => i.severity === "critical").length * 20;
+    const seriousPenalty = issues.filter((i) => i.severity === "serious").length * 10;
+    const moderatePenalty = issues.filter((i) => i.severity === "moderate").length * 5;
+    const lowPenalty = issues.filter((i) => i.severity === "low").length * 2;
+    return Math.max(0, 100 - criticalPenalty - seriousPenalty - moderatePenalty - lowPenalty);
+  }
+  /**
+   * Get WCAG criterion string
+   */
+  getWCAGRef(criterionId) {
+    const criterion = WCAG_CRITERIA[criterionId];
+    return `WCAG 2.1 ${criterion.level} - ${criterionId} ${criterion.name}`;
+  }
+  // ============================================================================
+  // IMAGE ACCESSIBILITY — WCAG 1.1.1
+  // ============================================================================
+  analyzeImages(content, file) {
     const issues = [];
     const lines = content.split("\n");
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i];
       const lineNumber = i + 1;
-      if (/<img[^>]*(?!alt=)[^>]*>/i.test(line) && !line.includes("alt=")) {
+      if (/<img\s/i.test(line)) {
+        if (!line.includes("alt=")) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "critical",
+            "Image missing alt attribute",
+            'Add alt="description" for informative images or alt="" for decorative images. Screen readers cannot describe this image.',
+            file,
+            lineNumber,
+            0.98,
+            this.getWCAGRef("1.1.1"),
+            true
+          ));
+        } else if (/alt=["']\s*["']/i.test(line)) {
+          const context = lines.slice(Math.max(0, i - 3), i + 3).join("\n");
+          if (/hero|logo|banner|product|avatar|icon/i.test(context) && !/decorative|spacer|divider/i.test(context)) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "moderate",
+              "Empty alt on potentially informative image",
+              "If this image conveys information, add descriptive alt text. Empty alt is only for purely decorative images.",
+              file,
+              lineNumber,
+              0.7,
+              this.getWCAGRef("1.1.1"),
+              true
+            ));
+          }
+        }
+      }
+      if (/background-image:\s*url\(/i.test(line) || /backgroundImage.*url\(/i.test(line)) {
+        const context = lines.slice(Math.max(0, i - 5), i + 5).join("\n");
+        if (/hero|banner|feature|card/i.test(context) && !/aria-label|sr-only|visually-hidden/i.test(context)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "Background image may need text alternative",
+            "If this background image conveys information, add a text alternative using aria-label or visually hidden text.",
+            file,
+            lineNumber,
+            0.65,
+            this.getWCAGRef("1.1.1"),
+            false
+          ));
+        }
+      }
+      if (/<svg\s/i.test(line)) {
+        const svgContext = this.getMultiLineElement(lines, i, "svg");
+        if (!/aria-label|aria-labelledby|<title>|role=["']img["']/i.test(svgContext) && !/aria-hidden=["']true["']/i.test(svgContext)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "serious",
+            "SVG missing accessible name",
+            'Add aria-label, aria-labelledby with <title>, or aria-hidden="true" if decorative.',
+            file,
+            lineNumber,
+            0.85,
+            this.getWCAGRef("1.1.1"),
+            true
+          ));
+        }
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // INTERACTIVE ELEMENTS — WCAG 4.1.2, 2.1.1
+  // ============================================================================
+  analyzeInteractiveElements(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      if (/<button/i.test(line) || /Button\s/i.test(line)) {
+        const buttonContext = this.getMultiLineElement(lines, i, "button") || this.getMultiLineElement(lines, i, "Button");
+        const hasIconOnly = />\s*<(Icon|svg|i\s|img)[^>]*>\s*<\/(button|Button)/i.test(buttonContext) || />\s*<[A-Z][a-zA-Z]*Icon[^>]*\s*\/>\s*<\/(button|Button)/i.test(buttonContext) || /<(Icon|svg)[^>]*\/>\s*<\/(button|Button)/i.test(buttonContext);
+        const hasAccessibleName = /aria-label|aria-labelledby|title=|sr-only|visually-hidden/i.test(buttonContext);
+        if (hasIconOnly && !hasAccessibleName) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "critical",
+            "Icon-only button missing accessible name",
+            'Add aria-label="Close" or include visually hidden text. Screen reader users cannot identify this button.',
+            file,
+            lineNumber,
+            0.95,
+            this.getWCAGRef("4.1.2"),
+            true
+          ));
+        }
+      }
+      if (/onClick|@click|v-on:click|\(click\)/i.test(line)) {
+        if (/<(div|span|li|td|tr|p|section|article)\s/i.test(line) && !/role=["'](button|link|menuitem|tab|option)/i.test(line)) {
+          const elementContext = lines.slice(Math.max(0, i - 2), i + 3).join("\n");
+          const hasKeyboardSupport = /onKeyDown|onKeyPress|onKeyUp|@keydown|@keypress|@keyup|\(keydown\)|\(keypress\)/i.test(elementContext);
+          const hasRole = /role=/i.test(elementContext);
+          const hasTabIndex = /tabIndex|tabindex/i.test(elementContext);
+          if (!hasKeyboardSupport) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "critical",
+              "Non-semantic element with click handler lacks keyboard support",
+              `Add role="button" tabIndex={0} onKeyDown={(e) => e.key === 'Enter' && handleClick()}. Or use a <button> element instead.`,
+              file,
+              lineNumber,
+              0.92,
+              this.getWCAGRef("2.1.1"),
+              true
+            ));
+          } else if (!hasRole || !hasTabIndex) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "serious",
+              "Clickable element missing role or tabIndex",
+              'Add role="button" and tabIndex={0} for proper keyboard accessibility.',
+              file,
+              lineNumber,
+              0.85,
+              this.getWCAGRef("4.1.2"),
+              true
+            ));
+          }
+        }
+      }
+      if (/<a\s/i.test(line) || /<Link\s/i.test(line)) {
+        const linkContext = this.getMultiLineElement(lines, i, "a") || this.getMultiLineElement(lines, i, "Link");
+        if (!/href=|to=/i.test(linkContext)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "serious",
+            "Link element without href",
+            "Add href attribute or use a <button> if this triggers an action. Links must have a destination.",
+            file,
+            lineNumber,
+            0.9,
+            this.getWCAGRef("2.4.4"),
+            true
+          ));
+        }
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // FORM ACCESSIBILITY — WCAG 1.3.1, 3.3.2, 1.3.5
+  // ============================================================================
+  analyzeFormAccessibility(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      if (/<input\s/i.test(line) || /<Input\s/i.test(line) || /<textarea/i.test(line) || /<select/i.test(line)) {
+        const inputContext = lines.slice(Math.max(0, i - 5), i + 5).join("\n");
+        const hasLabel = /<label/i.test(inputContext) && /htmlFor|for=/i.test(inputContext);
+        const hasAriaLabel = /aria-label=/i.test(line);
+        const hasAriaLabelledBy = /aria-labelledby=/i.test(line);
+        const hasPlaceholder = /placeholder=/i.test(line);
+        const hasTitle = /title=/i.test(line);
+        if (!hasLabel && !hasAriaLabel && !hasAriaLabelledBy) {
+          if (hasPlaceholder && !hasTitle) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "serious",
+              "Form input uses placeholder as only label",
+              "Placeholder text disappears when typing. Add a visible <label> or aria-label for persistent identification.",
+              file,
+              lineNumber,
+              0.88,
+              this.getWCAGRef("3.3.2"),
+              true
+            ));
+          } else if (!hasTitle) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "serious",
+              "Form input without accessible label",
+              'Add <label htmlFor="id"> associated with input, or use aria-label/aria-labelledby.',
+              file,
+              lineNumber,
+              0.85,
+              this.getWCAGRef("1.3.1"),
+              true
+            ));
+          }
+        }
+        if (/type=["'](email|tel|password|name|address|cc-|url)/i.test(line) && !/autoComplete|autocomplete/i.test(line)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "Input missing autocomplete attribute",
+            'Add autocomplete attribute (e.g., autocomplete="email") to help users fill forms.',
+            file,
+            lineNumber,
+            0.7,
+            this.getWCAGRef("1.3.5"),
+            true
+          ));
+        }
+      }
+      if (/required(?!=\{false\})/i.test(line) && !/aria-required|required.*\*/i.test(line)) {
+        const labelContext = lines.slice(Math.max(0, i - 5), i + 5).join("\n");
+        if (!/\*|required|Required/i.test(labelContext)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "Required field lacks visual indication",
+            'Add visual indicator (e.g., asterisk *) and aria-required="true" for clarity.',
+            file,
+            lineNumber,
+            0.75,
+            this.getWCAGRef("3.3.2"),
+            true
+          ));
+        }
+      }
+      if (/disabled(?!=\{false\})/i.test(line)) {
+        const elementContext = lines.slice(Math.max(0, i - 2), i + 2).join("\n");
+        if (!/title=|aria-describedby|tooltip|Tooltip/i.test(elementContext)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "low",
+            "Disabled element without explanation",
+            "Add tooltip or aria-describedby explaining why the action is unavailable.",
+            file,
+            lineNumber,
+            0.65,
+            void 0,
+            true
+          ));
+        }
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // KEYBOARD NAVIGATION — WCAG 2.1.1, 2.1.2, 2.4.3, 2.4.7
+  // ============================================================================
+  analyzeKeyboardNavigation(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      if (/outline:\s*none|outline:\s*0|outline-width:\s*0/i.test(line)) {
+        const styleContext = lines.slice(Math.max(0, i - 3), i + 3).join("\n");
+        const hasFocusReplacement = /focus-visible|ring-|box-shadow.*focus|border.*focus|outline.*focus-visible/i.test(styleContext);
+        if (!hasFocusReplacement) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "serious",
+            "Focus outline removed without replacement",
+            "Add focus-visible:ring-2 or custom focus indicator. Keyboard users cannot see where they are.",
+            file,
+            lineNumber,
+            0.92,
+            this.getWCAGRef("2.4.7"),
+            true
+          ));
+        }
+      }
+      if (/focus:outline-none|outline-none/i.test(line)) {
+        const styleContext = lines.slice(Math.max(0, i - 1), i + 2).join("\n");
+        if (!/focus-visible:ring|focus:ring|focus-visible:border|focus:border/i.test(styleContext)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "serious",
+            "Tailwind outline-none without focus replacement",
+            "Add focus-visible:ring-2 focus-visible:ring-offset-2 for visible focus indicator.",
+            file,
+            lineNumber,
+            0.9,
+            this.getWCAGRef("2.4.7"),
+            true
+          ));
+        }
+      }
+      if (/tabIndex=\{?["']?([1-9]\d*)["']?\}?|tabindex=["']([1-9]\d*)["']/i.test(line)) {
+        const match = line.match(/tabIndex=\{?["']?([1-9]\d*)["']?\}?|tabindex=["']([1-9]\d*)["']/i);
+        const value = match?.[1] || match?.[2];
         issues.push(this.createIssue(
           this.generateIssueId(),
           "serious",
-          "Image missing alt attribute",
-          'Add descriptive alt text for screen readers: alt="description"',
+          `Positive tabIndex value (${value}) disrupts natural tab order`,
+          "Use tabIndex={0} for focusable elements or tabIndex={-1} for programmatic focus. Positive values create confusing navigation.",
           file,
           lineNumber,
-          0.95,
-          "WCAG 2.1 - 1.1.1 Non-text Content",
+          0.88,
+          this.getWCAGRef("2.4.3"),
           true
         ));
       }
-      if (/onClick.*(?!onKeyDown|onKeyPress|onKeyUp)/i.test(line) && !/button|Button|<a /i.test(line)) {
+      if (/modal|dialog|drawer|overlay/i.test(line.toLowerCase())) {
+        const componentContext = lines.slice(i, Math.min(lines.length, i + 30)).join("\n");
+        if (/onClose|onDismiss|closeModal/i.test(componentContext)) {
+          if (!/onKeyDown.*Escape|useEscapeKey|handleEscape|key.*===.*Escape/i.test(componentContext)) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "serious",
+              "Modal/dialog may trap keyboard focus without Escape key support",
+              "Add Escape key handler to close modal and manage focus trap with focus-trap library.",
+              file,
+              lineNumber,
+              0.75,
+              this.getWCAGRef("2.1.2"),
+              false
+            ));
+          }
+        }
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // SEMANTIC STRUCTURE — WCAG 1.3.1, 2.4.6
+  // ============================================================================
+  analyzeSemanticStructure(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    const headingLevels = [];
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      const headingMatch = line.match(/<h([1-6])|role=["']heading["'].*aria-level=["'](\d)["']/i);
+      if (headingMatch) {
+        const level = parseInt(headingMatch[1] || headingMatch[2] || "0");
+        if (level > 0) {
+          headingLevels.push({ level, line: lineNumber });
+        }
+      }
+      if (/<div[^>]*class=["'][^"']*nav|navigation/i.test(line) && !/<nav/i.test(content)) {
         issues.push(this.createIssue(
           this.generateIssueId(),
           "moderate",
-          "Click handler without keyboard equivalent",
-          "Add onKeyDown handler for keyboard accessibility",
+          "Navigation using div instead of semantic <nav>",
+          "Use <nav> element for navigation sections. Screen readers announce this as navigation.",
           file,
           lineNumber,
           0.8,
-          "WCAG 2.1 - 2.1.1 Keyboard",
+          this.getWCAGRef("1.3.1"),
           true
         ));
       }
-      if (/<input[^>]*(?!aria-label|id.*label)/i.test(line) && !/<label/i.test(lines.slice(Math.max(0, i - 2), i + 2).join(""))) {
+      if (/<div[^>]*class=["'][^"']*header/i.test(line) && !/<header/i.test(content)) {
         issues.push(this.createIssue(
           this.generateIssueId(),
-          "moderate",
-          "Form input may be missing accessible label",
-          "Associate input with <label> element or use aria-label",
+          "low",
+          "Header content using div instead of semantic <header>",
+          "Use <header> element for page/section headers for better screen reader navigation.",
+          file,
+          lineNumber,
+          0.7,
+          this.getWCAGRef("1.3.1"),
+          true
+        ));
+      }
+      if (/<div[^>]*class=["'][^"']*footer/i.test(line) && !/<footer/i.test(content)) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "low",
+          "Footer content using div instead of semantic <footer>",
+          "Use <footer> element for page/section footers for better screen reader navigation.",
           file,
           lineNumber,
           0.7,
-          "WCAG 2.1 - 1.3.1 Info and Relationships",
+          this.getWCAGRef("1.3.1"),
+          true
+        ));
+      }
+      if (/<div[^>]*class=["'][^"']*main/i.test(line) && !/<main/i.test(content)) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "moderate",
+          "Main content using div instead of semantic <main>",
+          'Use <main> element for primary content. Allows "skip to main content" functionality.',
+          file,
+          lineNumber,
+          0.75,
+          this.getWCAGRef("2.4.1"),
           true
         ));
       }
-      if (/color:\s*['"]?#[0-9a-fA-F]{3,6}/i.test(line) || /color:\s*['"]?rgb\(/i.test(line)) {
-        if (/#fff|#FFF|white|#000|#333|gray/i.test(line)) {
+      if (/<div[^>]*class=["'][^"']*(list|items|menu)[^"']*["']/i.test(line)) {
+        const context = lines.slice(i, Math.min(lines.length, i + 10)).join("\n");
+        if (!/<ul|<ol|<menu|role=["']list/i.test(context)) {
           issues.push(this.createIssue(
             this.generateIssueId(),
             "low",
-            "Potential color contrast issue",
-            "Ensure color contrast ratio meets WCAG AA (4.5:1 for normal text)",
+            "List-like content without list semantics",
+            'Use <ul>/<ol> for lists or add role="list" with role="listitem" children.',
             file,
             lineNumber,
-            0.6,
-            "WCAG 2.1 - 1.4.3 Contrast",
+            0.65,
+            this.getWCAGRef("1.3.1"),
             false
           ));
         }
       }
-      if (/outline:\s*none|outline:\s*0/i.test(line)) {
+    }
+    for (let i = 1; i < headingLevels.length; i++) {
+      const current = headingLevels[i];
+      const previous = headingLevels[i - 1];
+      if (current.level > previous.level + 1) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "moderate",
+          `Skipped heading level: h${previous.level} to h${current.level}`,
+          `Heading levels should not skip. Go from h${previous.level} to h${previous.level + 1}. Screen reader users navigate by headings.`,
+          file,
+          current.line,
+          0.85,
+          this.getWCAGRef("2.4.6"),
+          true
+        ));
+      }
+    }
+    if (headingLevels.length > 0 && headingLevels[0].level !== 1) {
+      issues.push(this.createIssue(
+        this.generateIssueId(),
+        "moderate",
+        `First heading is h${headingLevels[0].level} instead of h1`,
+        "Each page should start with an h1 describing the page content.",
+        file,
+        headingLevels[0].line,
+        0.8,
+        this.getWCAGRef("2.4.6"),
+        true
+      ));
+    }
+    return issues;
+  }
+  // ============================================================================
+  // ARIA USAGE — WCAG 4.1.2
+  // ============================================================================
+  analyzeARIAUsage(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      const roleMatch = line.match(/role=["']([a-z]+)["']/i);
+      if (roleMatch) {
+        const role = roleMatch[1].toLowerCase();
+        const requiredAttrs = REQUIRED_ARIA_ATTRIBUTES[role];
+        if (requiredAttrs && requiredAttrs.length > 0) {
+          const elementContext = this.getMultiLineElement(lines, i, void 0) || line;
+          const missingAttrs = requiredAttrs.filter((attr) => !new RegExp(attr, "i").test(elementContext));
+          if (missingAttrs.length > 0) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "serious",
+              `Role "${role}" missing required ARIA attributes: ${missingAttrs.join(", ")}`,
+              `Add ${missingAttrs.map((a) => `${a}="value"`).join(" ")} for proper screen reader support.`,
+              file,
+              lineNumber,
+              0.88,
+              this.getWCAGRef("4.1.2"),
+              true
+            ));
+          }
+        }
+      }
+      if (/aria-hidden=["']true["']/i.test(line)) {
+        const elementContext = lines.slice(Math.max(0, i - 1), i + 5).join("\n");
+        if (/<(button|a|input|select|textarea)|tabIndex=\{?["']?0|tabindex=["']0/i.test(elementContext)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "serious",
+            "aria-hidden on element containing focusable content",
+            "Remove aria-hidden or add tabIndex={-1} to focusable children. Hidden content should not be focusable.",
+            file,
+            lineNumber,
+            0.85,
+            this.getWCAGRef("4.1.2"),
+            true
+          ));
+        }
+      }
+      if (/aria-expanded=["'](yes|no)["']/i.test(line)) {
         issues.push(this.createIssue(
           this.generateIssueId(),
           "serious",
-          "Focus outline removed - breaks keyboard navigation",
-          "Provide alternative focus indicator instead of removing outline",
+          'Invalid aria-expanded value (use "true"/"false" not "yes"/"no")',
+          'Use aria-expanded="true" or aria-expanded="false".',
           file,
           lineNumber,
-          0.9,
-          "WCAG 2.1 - 2.4.7 Focus Visible",
+          0.95,
+          this.getWCAGRef("4.1.2"),
           true
         ));
       }
+      if (/aria-label=/i.test(line)) {
+        if (/<(div|span|p|section)\s/i.test(line) && !/role=/i.test(line)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "aria-label on non-interactive element without role",
+            "Add an appropriate role or use aria-labelledby for non-interactive regions.",
+            file,
+            lineNumber,
+            0.7,
+            this.getWCAGRef("4.1.2"),
+            false
+          ));
+        }
+      }
+      if (/aria-live=/i.test(line)) {
+        if (!/aria-live=["'](polite|assertive|off)["']/i.test(line)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "Invalid aria-live value",
+            'Use aria-live="polite" for non-urgent updates or aria-live="assertive" for critical alerts.',
+            file,
+            lineNumber,
+            0.85,
+            this.getWCAGRef("4.1.3"),
+            true
+          ));
+        }
+      }
+      if (/toast|notification|alert|error.*message|success.*message/i.test(line)) {
+        const context = lines.slice(Math.max(0, i - 3), i + 5).join("\n");
+        if (!/aria-live|role=["']alert|role=["']status/i.test(context)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "Status message may not be announced to screen readers",
+            'Add role="status" aria-live="polite" for status messages or role="alert" for errors.',
+            file,
+            lineNumber,
+            0.75,
+            this.getWCAGRef("4.1.3"),
+            true
+          ));
+        }
+      }
     }
     return issues;
   }
-  analyzeUXPatterns(content, file) {
+  // ============================================================================
+  // COLOR ACCESSIBILITY — WCAG 1.4.1, 1.4.3, 1.4.11
+  // ============================================================================
+  analyzeColorAccessibility(content, file) {
     const issues = [];
     const lines = content.split("\n");
     for (let i = 0; i < lines.length; i++) {
       const line = lines[i];
       const lineNumber = i + 1;
-      if (/disabled(?!=\{false\})/i.test(line) && !/title=|aria-describedby/i.test(line)) {
+      if (/color:\s*(red|green|#f00|#0f0|#ff0000|#00ff00)/i.test(line)) {
+        const context = lines.slice(Math.max(0, i - 5), i + 5).join("\n");
+        if (/error|success|warning|valid|invalid/i.test(context)) {
+          if (!/icon|Icon|✓|✗|×|⚠|aria-label|sr-only|visually-hidden/i.test(context)) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "serious",
+              "Color may be the only indicator of status",
+              "Add icon, text, or other visual indicator besides color. Colorblind users cannot distinguish red/green.",
+              file,
+              lineNumber,
+              0.8,
+              this.getWCAGRef("1.4.1"),
+              true
+            ));
+          }
+        }
+      }
+      if (/color:\s*#([0-9a-f]{3,6})/i.test(line)) {
+        const hexMatch = line.match(/color:\s*#([0-9a-f]{3,6})/i);
+        if (hexMatch) {
+          const hex = hexMatch[1].toLowerCase();
+          const lightness = this.getRelativeLuminance(hex);
+          if (lightness > 0.3 && lightness < 0.5) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "moderate",
+              "Text color may have insufficient contrast",
+              "Verify 4.5:1 contrast ratio at webaim.org/resources/contrastchecker. Consider darker (#374151) or lighter (#d1d5db) alternatives.",
+              file,
+              lineNumber,
+              0.65,
+              this.getWCAGRef("1.4.3"),
+              false
+            ));
+          }
+        }
+      }
+      if (/focus.*border/i.test(line) && !/ring|outline|shadow/i.test(line)) {
         issues.push(this.createIssue(
           this.generateIssueId(),
           "low",
-          "Disabled element without explanation",
-          "Add tooltip or text explaining why the action is unavailable",
+          "Focus indicator uses only border - verify 3:1 contrast",
+          "Ensure focus border has 3:1 contrast against adjacent colors. Consider adding focus ring.",
           file,
           lineNumber,
-          0.7,
+          0.6,
+          this.getWCAGRef("1.4.11"),
+          false
+        ));
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // TOUCH TARGETS — WCAG 2.5.5, 2.5.8
+  // ============================================================================
+  analyzeTouchTargets(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      if (/<(button|a|input|select)|onClick|@click/i.test(line)) {
+        const sizeMatch = line.match(/(?:width|height|size):\s*(\d+)(?:px)?/i) || line.match(/(?:w-|h-)(\d+)/);
+        if (sizeMatch) {
+          const size = parseInt(sizeMatch[1]);
+          const pxSize = size <= 12 ? size * 4 : size;
+          if (pxSize < 24) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "moderate",
+              `Touch target size ${pxSize}px is below WCAG minimum (24px)`,
+              "Increase touch target to at least 24\xD724px (WCAG AA) or 44\xD744px (WCAG AAA) for mobile usability.",
+              file,
+              lineNumber,
+              0.75,
+              this.getWCAGRef("2.5.8"),
+              true
+            ));
+          } else if (pxSize < 44) {
+            issues.push(this.createIssue(
+              this.generateIssueId(),
+              "low",
+              `Touch target size ${pxSize}px is below recommended 44px`,
+              "Consider increasing to 44\xD744px for optimal mobile usability (WCAG AAA).",
+              file,
+              lineNumber,
+              0.6,
+              this.getWCAGRef("2.5.5"),
+              false
+            ));
+          }
+        }
+      }
+      if (/(Icon|icon).*size=["']?(sm|xs|small|12|14|16)/i.test(line)) {
+        const context = lines.slice(Math.max(0, i - 2), i + 2).join("\n");
+        if (/<button|onClick/i.test(context) && !/p-|padding/i.test(context)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "moderate",
+            "Small icon button may have insufficient touch target",
+            "Add padding (e.g., p-2 or p-3) to ensure 44\xD744px touch target around small icons.",
+            file,
+            lineNumber,
+            0.7,
+            this.getWCAGRef("2.5.8"),
+            true
+          ));
+        }
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // MOTION ACCESSIBILITY — WCAG 2.3.3
+  // ============================================================================
+  analyzeMotionAccessibility(content, file) {
+    const issues = [];
+    if (/animation:|@keyframes|animate-|transition:/i.test(content)) {
+      if (!/prefers-reduced-motion/i.test(content)) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "moderate",
+          "Animations without prefers-reduced-motion support",
+          "Add @media (prefers-reduced-motion: reduce) { animation: none; transition: none; } for motion-sensitive users.",
+          file,
           void 0,
+          0.8,
+          "WCAG 2.1 AA - 2.3.3 Animation from Interactions",
+          false
+        ));
+      }
+    }
+    if (/autoPlay|autoplay/i.test(content)) {
+      if (!/muted|controls/i.test(content)) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "serious",
+          "Autoplaying media without mute or controls",
+          "Add muted attribute or provide controls. Autoplay audio can disorient screen reader users.",
+          file,
+          void 0,
+          0.85,
+          "WCAG 2.1 A - 1.4.2 Audio Control",
+          true
+        ));
+      }
+    }
+    return issues;
+  }
+  // ============================================================================
+  // LINK ACCESSIBILITY — WCAG 2.4.4
+  // ============================================================================
+  analyzeLinks(content, file) {
+    const issues = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      const lineNumber = i + 1;
+      if (/<a[^>]*>\s*<\/a>/i.test(line)) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "critical",
+          "Empty link with no text content",
+          'Add meaningful link text or aria-label. Screen readers announce this as "link" with no destination.',
+          file,
+          lineNumber,
+          0.95,
+          this.getWCAGRef("2.4.4"),
           true
         ));
       }
-      if (/placeholder=/i.test(line) && !/<label|aria-label/i.test(lines.slice(Math.max(0, i - 2), i + 2).join(""))) {
+      if (/href=["']#["']\s*>/i.test(line) && !/onClick|@click/i.test(line)) {
         issues.push(this.createIssue(
           this.generateIssueId(),
           "moderate",
-          "Input uses placeholder as only label",
-          "Add visible label - placeholder disappears when user types",
+          'Link with placeholder href="#"',
+          "Add meaningful destination or use <button> for actions. Placeholder links confuse users.",
           file,
           lineNumber,
-          0.75,
-          void 0,
+          0.8,
+          this.getWCAGRef("2.4.4"),
           true
         ));
       }
-      if (/<a[^>]*>\s*<\/a>/i.test(line) || /href=['"]#['"]/i.test(line)) {
+      if (/>(?:click here|here|read more|learn more|more)<\/a>/i.test(line)) {
         issues.push(this.createIssue(
           this.generateIssueId(),
           "moderate",
-          "Empty or placeholder link",
-          "Add meaningful href and link text",
+          'Generic link text ("click here", "read more")',
+          "Use descriptive link text that makes sense out of context. Screen reader users navigate by link list.",
           file,
           lineNumber,
-          0.85,
-          "WCAG 2.1 - 2.4.4 Link Purpose",
+          0.75,
+          this.getWCAGRef("2.4.4"),
           true
         ));
       }
+      if (/target=["']_blank["']/i.test(line)) {
+        if (!/aria-label.*new window|aria-label.*new tab|external|External|↗|↪/i.test(line)) {
+          issues.push(this.createIssue(
+            this.generateIssueId(),
+            "low",
+            "Link opens in new window without warning",
+            'Add visual indicator (\u2197) and aria-label mentioning "opens in new window" for user awareness.',
+            file,
+            lineNumber,
+            0.65,
+            this.getWCAGRef("3.2.5"),
+            true
+          ));
+        }
+      }
+      if (/<a[^>]*href=["']([^"']+)["'][^>]*>.*<img/i.test(line)) {
+        issues.push(this.createIssue(
+          this.generateIssueId(),
+          "low",
+          "Image and text link may create duplicate links",
+          'Combine image and text in single link or add aria-hidden="true" to decorative image link.',
+          file,
+          lineNumber,
+          0.6,
+          this.getWCAGRef("2.4.4"),
+          false
+        ));
+      }
     }
     return issues;
   }
+  // ============================================================================
+  // UTILITY METHODS
+  // ============================================================================
+  /**
+   * Get multi-line element content starting at line index
+   */
+  getMultiLineElement(lines, startIndex, tagName) {
+    const startLine = lines[startIndex];
+    if (!startLine) return null;
+    const tag = tagName || startLine.match(/<([a-zA-Z][a-zA-Z0-9]*)/)?.[1];
+    if (!tag) return startLine;
+    if (new RegExp(`</${tag}|/>`, "i").test(startLine)) {
+      return startLine;
+    }
+    let content = startLine;
+    for (let j = startIndex + 1; j < Math.min(lines.length, startIndex + 20); j++) {
+      content += "\n" + lines[j];
+      if (new RegExp(`</${tag}>|/>`, "i").test(lines[j])) {
+        break;
+      }
+    }
+    return content;
+  }
+  /**
+   * Calculate relative luminance for contrast checking
+   */
+  getRelativeLuminance(hex) {
+    let normalized = hex.length === 3 ? hex.split("").map((c) => c + c).join("") : hex;
+    const r = parseInt(normalized.slice(0, 2), 16) / 255;
+    const g = parseInt(normalized.slice(2, 4), 16) / 255;
+    const b = parseInt(normalized.slice(4, 6), 16) / 255;
+    const [R, G, B] = [r, g, b].map(
+      (c) => c <= 0.03928 ? c / 12.92 : Math.pow((c + 0.055) / 1.055, 2.4)
+    );
+    return 0.2126 * R + 0.7152 * G + 0.0722 * B;
+  }
   /**
    * AI Enhancement for accessibility review
    */
   getAIEnhancementSystemPrompt() {
-    return `You are a WCAG 2.1 accessibility expert. Review code for inclusive design.
-
-Analyze detected issues and code for:
-1. Screen reader compatibility (ARIA labels, roles, live regions)
-2. Keyboard navigation (focus management, tab order, focus trapping)
-3. Color contrast (4.5:1 for text, 3:1 for large text)
-4. Form accessibility (labels, error messages, required fields)
-5. Dynamic content (loading states, announcements, focus management)
-6. Reduced motion support (prefers-reduced-motion)
-7. Touch target sizes (44x44px minimum)
-
-Output STRICT JSON:
+    return `You are a WCAG 2.1 AA accessibility expert and inclusive design advocate. 
+Review code for comprehensive accessibility compliance.
+
+## Analysis Categories
+
+### Critical (Blocks Access)
+- Images without alt text
+- Icon-only buttons missing aria-label
+- Non-semantic click handlers without keyboard support
+- Empty links
+- Missing form labels
+
+### Serious (Significantly Impairs)
+- Focus outline removed without replacement
+- Positive tabIndex values disrupting tab order
+- Role without required ARIA attributes
+- Color-only status indicators
+- Links without href
+
+### Moderate (Creates Barriers)
+- Skipped heading levels
+- Missing autocomplete on inputs
+- Touch targets under 44px
+- Generic link text
+- Missing prefers-reduced-motion
+
+### Low (Best Practices)
+- Semantic element opportunities
+- Status messages without aria-live
+- External links without warning
+
+## WCAG Success Criteria Reference
+- 1.1.1: Non-text Content (images, icons)
+- 1.3.1: Info and Relationships (semantic HTML)
+- 1.4.1: Use of Color (color-only info)
+- 1.4.3: Contrast (Minimum)
+- 2.1.1: Keyboard accessibility
+- 2.4.3: Focus Order
+- 2.4.4: Link Purpose
+- 2.4.6: Headings and Labels
+- 2.4.7: Focus Visible
+- 2.5.5: Target Size
+- 4.1.2: Name, Role, Value
+
+## Output Format
 {
   "validated": [{
     "original_issue": "...",
@@ -1054,10 +1896,11 @@ Output STRICT JSON:
     "confidence": 0-100,
     "file": "path",
     "line": 123,
-    "severity": "serious",
-    "wcag_criterion": "WCAG 2.1 - X.X.X Name",
+    "severity": "critical" | "serious" | "moderate" | "low",
+    "wcag_criterion": "WCAG 2.1 AA - X.X.X Name",
     "impact": "How this affects users with disabilities",
-    "fix": "Accessible code fix"
+    "code_snippet": "The problematic code",
+    "fix": "Accessible code fix with example"
   }],
   "additional": [{
     "issue": "Accessibility issue found",
@@ -1065,10 +1908,18 @@ Output STRICT JSON:
     "line": 123,
     "severity": "moderate",
     "wcag_criterion": "WCAG criterion",
-    "impact": "User impact",
-    "fix": "Accessible implementation"
+    "impact": "User impact description",
+    "code_snippet": "Problematic code",
+    "fix": "Accessible implementation with example"
   }],
-  "summary": "Overall accessibility assessment"
+  "score": {
+    "overall": 85,
+    "critical_count": 0,
+    "serious_count": 2,
+    "moderate_count": 5,
+    "low_count": 3
+  },
+  "summary": "Overall accessibility assessment with key recommendations"
 }`;
   }
 };
@@ -8007,4 +8858,4 @@ export {
   CustomAgent,
   getAgentRegistry
 };
-//# sourceMappingURL=chunk-HRNBSXN2.js.map
+//# sourceMappingURL=chunk-B3MBKB2U.js.map