@sarjallab09/figma-intelligence 1.1.0 → 1.2.1

package/figma-intelligence-layer/src/tools/phase1-vision/a11y-audit/wcag-criteria.ts

@@ -1,1160 +0,0 @@
-// ─────────────────────────────────────────────────────────────────────────────
-// WCAG 2.2 Success Criteria Registry
-// Pure data module – every SC with metadata for audit classification.
-// ─────────────────────────────────────────────────────────────────────────────
-
-export type WCAGLevel = "A" | "AA" | "AAA";
-
-export type CheckCapability =
-  | "automated" // Tool can fully check from Figma node data
-  | "heuristic" // Tool can partially check / flag likely issues
-  | "manual"; // Cannot be checked; provide guidance only
-
-export type ConformanceStatus =
-  | "Supports"
-  | "Partially Supports"
-  | "Does Not Support"
-  | "Not Applicable"
-  | "Not Evaluated";
-
-export type WCAGPrinciple =
-  | "Perceivable"
-  | "Operable"
-  | "Understandable"
-  | "Robust";
-
-export interface WCAGCriterionDef {
-  id: string;
-  name: string;
-  level: WCAGLevel;
-  principle: WCAGPrinciple;
-  guideline: string;
-  checkCapability: CheckCapability;
-  figmaRelevance: string;
-  manualGuidance: string;
-  checkerFnName?: string;
-}
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Full registry – WCAG 2.2 (4.1.1 Parsing removed per WCAG 2.2)
-// ─────────────────────────────────────────────────────────────────────────────
-
-export const WCAG_CRITERIA: WCAGCriterionDef[] = [
-  // ═══════════════════════════════════════════════════════════════════════════
-  // PRINCIPLE 1 – PERCEIVABLE
-  // ═══════════════════════════════════════════════════════════════════════════
-
-  // ── 1.1 Text Alternatives ──────────────────────────────────────────────────
-  {
-    id: "1.1.1",
-    name: "Non-text Content",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.1 Text Alternatives",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can detect IMAGE/VECTOR nodes without description property or nearby text label",
-    manualGuidance:
-      "Verify all non-text content (images, icons, charts) has text alternatives that serve the equivalent purpose. Decorative images should be marked as such.",
-    checkerFnName: "checkNonTextContent",
-  },
-
-  // ── 1.2 Time-based Media ──────────────────────────────────────────────────
-  {
-    id: "1.2.1",
-    name: "Audio-only and Video-only (Prerecorded)",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "If the final product includes prerecorded audio-only or video-only content, provide an alternative such as a transcript or audio description.",
-  },
-  {
-    id: "1.2.2",
-    name: "Captions (Prerecorded)",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "Ensure all prerecorded video with audio includes synchronised captions.",
-  },
-  {
-    id: "1.2.3",
-    name: "Audio Description or Media Alternative (Prerecorded)",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "Provide audio description or a full text alternative for prerecorded video content.",
-  },
-  {
-    id: "1.2.4",
-    name: "Captions (Live)",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain live media",
-    manualGuidance:
-      "Ensure live video with audio has real-time captions.",
-  },
-  {
-    id: "1.2.5",
-    name: "Audio Description (Prerecorded)",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "Provide audio description for all prerecorded video content.",
-  },
-  {
-    id: "1.2.6",
-    name: "Sign Language (Prerecorded)",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "Provide sign language interpretation for all prerecorded audio content.",
-  },
-  {
-    id: "1.2.7",
-    name: "Extended Audio Description (Prerecorded)",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "Where pauses in foreground audio are insufficient, provide extended audio description for prerecorded video.",
-  },
-  {
-    id: "1.2.8",
-    name: "Media Alternative (Prerecorded)",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain time-based media",
-    manualGuidance:
-      "Provide a full text alternative for all prerecorded synchronised media and video-only content.",
-  },
-  {
-    id: "1.2.9",
-    name: "Audio-only (Live)",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.2 Time-based Media",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static Figma designs do not contain live media",
-    manualGuidance:
-      "Provide a text alternative for live audio-only content.",
-  },
-
-  // ── 1.3 Adaptable ─────────────────────────────────────────────────────────
-  {
-    id: "1.3.1",
-    name: "Info and Relationships",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.3 Adaptable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can infer heading hierarchy from font size/weight and auto-layout grouping",
-    manualGuidance:
-      "Ensure information, structure, and relationships conveyed through presentation can be programmatically determined. Use proper heading levels, lists, and table markup.",
-    checkerFnName: "checkInfoAndRelationships",
-  },
-  {
-    id: "1.3.2",
-    name: "Meaningful Sequence",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.3 Adaptable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can compare Figma node tree order against visual layout position",
-    manualGuidance:
-      "Ensure the reading and navigation order is logical and intuitive. The DOM order should match the visual presentation order.",
-    checkerFnName: "checkMeaningfulSequence",
-  },
-  {
-    id: "1.3.3",
-    name: "Sensory Characteristics",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.3 Adaptable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Would require NLP on text content to detect shape/location-only references",
-    manualGuidance:
-      "Instructions must not rely solely on sensory characteristics like shape, colour, size, visual location, orientation, or sound. Provide text labels alongside visual cues.",
-  },
-  {
-    id: "1.3.4",
-    name: "Orientation",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.3 Adaptable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check if designs include both portrait and landscape variants",
-    manualGuidance:
-      "Content must not restrict its view and operation to a single display orientation unless essential.",
-    checkerFnName: "checkOrientation",
-  },
-  {
-    id: "1.3.5",
-    name: "Identify Input Purpose",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.3 Adaptable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check input component names for autocomplete-purpose hints (name, email, tel)",
-    manualGuidance:
-      "The purpose of each input field collecting user information can be programmatically determined using autocomplete attributes.",
-    checkerFnName: "checkIdentifyInputPurpose",
-  },
-  {
-    id: "1.3.6",
-    name: "Identify Purpose",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.3 Adaptable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Requires semantic role mapping beyond Figma's data model",
-    manualGuidance:
-      "The purpose of UI components, icons, and regions can be programmatically determined through ARIA landmarks and roles.",
-  },
-
-  // ── 1.4 Distinguishable ───────────────────────────────────────────────────
-  {
-    id: "1.4.1",
-    name: "Use of Color",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can detect component variants where the only difference is fill color (no icon/text/shape change)",
-    manualGuidance:
-      "Colour must not be the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element. Add icons, text, or patterns.",
-    checkerFnName: "checkUseOfColor",
-  },
-  {
-    id: "1.4.2",
-    name: "Audio Control",
-    level: "A",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static designs do not contain audio; not applicable in Figma context",
-    manualGuidance:
-      "If any audio plays automatically for more than 3 seconds, provide a mechanism to pause, stop, or control the volume.",
-  },
-  {
-    id: "1.4.3",
-    name: "Contrast (Minimum)",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Computes foreground/background contrast ratio for all text nodes",
-    manualGuidance:
-      "Text must have a contrast ratio of at least 4.5:1 (normal text) or 3:1 (large text, 18px+ or 14px bold+).",
-    checkerFnName: "checkTextContrast",
-  },
-  {
-    id: "1.4.4",
-    name: "Resize Text",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Detects frames with fixed height containing text children that may clip on resize",
-    manualGuidance:
-      "Text can be resized up to 200% without loss of content or functionality. Avoid fixed-height containers for text.",
-    checkerFnName: "checkFixedHeightTextContainer",
-  },
-  {
-    id: "1.4.5",
-    name: "Images of Text",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can detect rasterised text by finding IMAGE fills on nodes with text-like names",
-    manualGuidance:
-      "Use real text instead of images of text. If images of text are used, they should be customisable or essential.",
-    checkerFnName: "checkImagesOfText",
-  },
-  {
-    id: "1.4.6",
-    name: "Contrast (Enhanced)",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Same as 1.4.3 but with 7:1 normal / 4.5:1 large thresholds",
-    manualGuidance:
-      "Text must have a contrast ratio of at least 7:1 (normal text) or 4.5:1 (large text).",
-    checkerFnName: "checkTextContrast",
-  },
-  {
-    id: "1.4.7",
-    name: "Low or No Background Audio",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Static designs do not contain audio",
-    manualGuidance:
-      "Prerecorded audio-only content that primarily contains speech has no or very low background sounds.",
-  },
-  {
-    id: "1.4.8",
-    name: "Visual Presentation",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check text width, line spacing, and foreground/background colour selection",
-    manualGuidance:
-      "For blocks of text: foreground and background colours can be selected; width is no more than 80 characters; text is not justified; line spacing is at least 1.5x; paragraphs have at least 2x spacing.",
-    checkerFnName: "checkTextSpacing",
-  },
-  {
-    id: "1.4.9",
-    name: "Images of Text (No Exception)",
-    level: "AAA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Same heuristic as 1.4.5 but stricter (no exceptions)",
-    manualGuidance:
-      "Images of text are only used for pure decoration or where a particular presentation of text is essential.",
-    checkerFnName: "checkImagesOfText",
-  },
-  {
-    id: "1.4.10",
-    name: "Reflow",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check auto-layout usage and constraint-based responsiveness on frames",
-    manualGuidance:
-      "Content can be presented without loss of information or functionality, and without scrolling in two dimensions, at 320 CSS px wide (for vertical scrolling) or 256 CSS px tall (for horizontal).",
-    checkerFnName: "checkReflow",
-  },
-  {
-    id: "1.4.11",
-    name: "Non-text Contrast",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Can check stroke/border and icon fill contrast against background at 3:1 minimum",
-    manualGuidance:
-      "UI components and graphical objects must have a contrast ratio of at least 3:1 against adjacent colours.",
-    checkerFnName: "checkNonTextContrast",
-  },
-  {
-    id: "1.4.12",
-    name: "Text Spacing",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Can check lineHeight, letterSpacing, and paragraphSpacing on text nodes",
-    manualGuidance:
-      "No loss of content when: line height >= 1.5x font size; paragraph spacing >= 2x font size; letter spacing >= 0.12x font size; word spacing >= 0.16x font size.",
-    checkerFnName: "checkTextSpacing",
-  },
-  {
-    id: "1.4.13",
-    name: "Content on Hover or Focus",
-    level: "AA",
-    principle: "Perceivable",
-    guideline: "1.4 Distinguishable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can detect hover/tooltip variant patterns and check for dismissability cues",
-    manualGuidance:
-      "Additional content that appears on hover or focus must be dismissable, hoverable, and persistent.",
-    checkerFnName: "checkContentOnHover",
-  },
-
-  // ═══════════════════════════════════════════════════════════════════════════
-  // PRINCIPLE 2 – OPERABLE
-  // ═══════════════════════════════════════════════════════════════════════════
-
-  // ── 2.1 Keyboard Accessible ───────────────────────────────────────────────
-  {
-    id: "2.1.1",
-    name: "Keyboard",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.1 Keyboard Accessible",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Cannot determine keyboard operability from static design; requires runtime testing",
-    manualGuidance:
-      "All functionality must be operable through a keyboard interface without requiring specific timings for individual keystrokes.",
-  },
-  {
-    id: "2.1.2",
-    name: "No Keyboard Trap",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.1 Keyboard Accessible",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Cannot determine keyboard traps from static design; requires runtime testing",
-    manualGuidance:
-      "If keyboard focus can be moved to a component, focus can also be moved away using only a keyboard. If non-standard exit method is needed, the user is advised.",
-  },
-  {
-    id: "2.1.3",
-    name: "Keyboard (No Exception)",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.1 Keyboard Accessible",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Cannot determine keyboard operability from static design",
-    manualGuidance:
-      "All functionality is operable through a keyboard interface without exception.",
-  },
-  {
-    id: "2.1.4",
-    name: "Character Key Shortcuts",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.1 Keyboard Accessible",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Keyboard shortcuts are a runtime concern, not visible in Figma designs",
-    manualGuidance:
-      "If single character key shortcuts exist, provide a way to turn them off, remap them, or make them active only on focus.",
-  },
-
-  // ── 2.2 Enough Time ──────────────────────────────────────────────────────
-  {
-    id: "2.2.1",
-    name: "Timing Adjustable",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.2 Enough Time",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Time limits are a runtime behaviour, not detectable from static design",
-    manualGuidance:
-      "For each time limit, the user can turn off, adjust, or extend the time limit (with at least 10x the default).",
-  },
-  {
-    id: "2.2.2",
-    name: "Pause, Stop, Hide",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.2 Enough Time",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Animation/auto-updating behaviour is a runtime concern",
-    manualGuidance:
-      "For moving, blinking, scrolling, or auto-updating information, provide a mechanism to pause, stop, or hide it.",
-  },
-  {
-    id: "2.2.3",
-    name: "No Timing",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.2 Enough Time",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Timing is a runtime concern",
-    manualGuidance:
-      "Timing is not an essential part of the event or activity (except for synchronised media and real-time events).",
-  },
-  {
-    id: "2.2.4",
-    name: "Interruptions",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.2 Enough Time",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Interruption behaviour is a runtime concern",
-    manualGuidance:
-      "Interruptions can be postponed or suppressed by the user, except for emergencies.",
-  },
-  {
-    id: "2.2.5",
-    name: "Re-authenticating",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.2 Enough Time",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Authentication flows are a runtime concern",
-    manualGuidance:
-      "When an authenticated session expires, the user can continue without losing data after re-authenticating.",
-  },
-  {
-    id: "2.2.6",
-    name: "Timeouts",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.2 Enough Time",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Timeout behaviour is a runtime concern",
-    manualGuidance:
-      "Users are warned of the duration of any user inactivity that could cause data loss, unless data is preserved for more than 20 hours.",
-  },
-
-  // ── 2.3 Seizures and Physical Reactions ───────────────────────────────────
-  {
-    id: "2.3.1",
-    name: "Three Flashes or Below Threshold",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.3 Seizures and Physical Reactions",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Flashing content is a runtime/animation concern, not in static designs",
-    manualGuidance:
-      "Content must not flash more than three times per second, or the flash is below the general flash and red flash thresholds.",
-  },
-  {
-    id: "2.3.2",
-    name: "Three Flashes",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.3 Seizures and Physical Reactions",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Flashing is a runtime concern",
-    manualGuidance:
-      "Content must not flash more than three times per second.",
-  },
-  {
-    id: "2.3.3",
-    name: "Animation from Interactions",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.3 Seizures and Physical Reactions",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Interaction animations are a runtime concern",
-    manualGuidance:
-      "Motion animation triggered by interaction can be disabled, unless essential to the functionality.",
-  },
-
-  // ── 2.4 Navigable ────────────────────────────────────────────────────────
-  {
-    id: "2.4.1",
-    name: "Bypass Blocks",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Skip navigation links are an implementation detail, not visible in most Figma designs",
-    manualGuidance:
-      "A mechanism is available to bypass blocks of content that are repeated on multiple pages (e.g., skip navigation links).",
-  },
-  {
-    id: "2.4.2",
-    name: "Page Titled",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Page titles are HTML metadata; Figma page names may not reflect final titles",
-    manualGuidance:
-      "Pages have titles that describe topic or purpose.",
-  },
-  {
-    id: "2.4.3",
-    name: "Focus Order",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can compare node tree order with visual position to flag potential focus-order mismatches",
-    manualGuidance:
-      "If a page can be navigated sequentially, components receive focus in an order that preserves meaning and operability.",
-    checkerFnName: "checkFocusOrder",
-  },
-  {
-    id: "2.4.4",
-    name: "Link Purpose (In Context)",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can detect link-like elements with vague text like 'click here' or 'read more'",
-    manualGuidance:
-      "The purpose of each link can be determined from the link text alone, or from the link text together with its programmatically determined link context.",
-    checkerFnName: "checkLinkPurpose",
-  },
-  {
-    id: "2.4.5",
-    name: "Multiple Ways",
-    level: "AA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Navigation structure is an implementation concern spanning multiple pages",
-    manualGuidance:
-      "More than one way is available to locate a page within a set of pages (e.g., site map, search, table of contents).",
-  },
-  {
-    id: "2.4.6",
-    name: "Headings and Labels",
-    level: "AA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can detect sections/frames without heading text children",
-    manualGuidance:
-      "Headings and labels describe topic or purpose.",
-    checkerFnName: "checkHeadingsAndLabels",
-  },
-  {
-    id: "2.4.7",
-    name: "Focus Visible",
-    level: "AA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Can check component sets for a visible focus-state variant",
-    manualGuidance:
-      "Any keyboard-operable user interface has a mode of operation where the keyboard focus indicator is visible.",
-    checkerFnName: "checkFocusState",
-  },
-  {
-    id: "2.4.8",
-    name: "Location",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Breadcrumbs/location indicators require cross-page context",
-    manualGuidance:
-      "Information about the user's location within a set of pages is available (e.g., breadcrumbs).",
-  },
-  {
-    id: "2.4.9",
-    name: "Link Purpose (Link Only)",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Same as 2.4.4 but stricter — link text alone must convey purpose",
-    manualGuidance:
-      "The purpose of each link can be identified from the link text alone.",
-    checkerFnName: "checkLinkPurpose",
-  },
-  {
-    id: "2.4.10",
-    name: "Section Headings",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check that content sections have heading nodes",
-    manualGuidance:
-      "Section headings are used to organise content.",
-    checkerFnName: "checkHeadingsAndLabels",
-  },
-  {
-    id: "2.4.11",
-    name: "Focus Not Obscured (Minimum)",
-    level: "AA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check if focus-state variants have overlapping elements that obscure the focused component",
-    manualGuidance:
-      "When a user interface component receives keyboard focus, the component is not entirely hidden due to author-created content.",
-    checkerFnName: "checkFocusNotObscured",
-  },
-  {
-    id: "2.4.12",
-    name: "Focus Not Obscured (Enhanced)",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Same as 2.4.11 but no part of the focus indicator may be hidden",
-    manualGuidance:
-      "When a component receives keyboard focus, no part of the focus indicator is hidden by author-created content.",
-    checkerFnName: "checkFocusNotObscured",
-  },
-  {
-    id: "2.4.13",
-    name: "Focus Appearance",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.4 Navigable",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check focus ring size and contrast in focus-state variants",
-    manualGuidance:
-      "Focus indicators have sufficient size (at least 2px perimeter) and contrast (at least 3:1 against adjacent colours).",
-    checkerFnName: "checkFocusState",
-  },
-
-  // ── 2.5 Input Modalities ──────────────────────────────────────────────────
-  {
-    id: "2.5.1",
-    name: "Pointer Gestures",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Gesture requirements are runtime behaviour, not detectable from static design",
-    manualGuidance:
-      "All functionality that uses multipoint or path-based gestures can also be operated with a single pointer without a path-based gesture.",
-  },
-  {
-    id: "2.5.2",
-    name: "Pointer Cancellation",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Pointer event handling is a runtime concern",
-    manualGuidance:
-      "For single-pointer functionality: the down-event is not used to execute; or completion is on the up-event with ability to abort; or the up-event reverses the down-event outcome.",
-  },
-  {
-    id: "2.5.3",
-    name: "Label in Name",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check that interactive component visible text matches or is contained in the component name",
-    manualGuidance:
-      "For components with visible text labels, the accessible name contains the visible text.",
-    checkerFnName: "checkNameRoleValue",
-  },
-  {
-    id: "2.5.4",
-    name: "Motion Actuation",
-    level: "A",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Device motion is a runtime concern",
-    manualGuidance:
-      "Functionality triggered by device motion or user motion can also be operated through UI components, and motion triggering can be disabled.",
-  },
-  {
-    id: "2.5.5",
-    name: "Target Size (Enhanced)",
-    level: "AAA",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Checks interactive element bounding boxes against 44x44px minimum",
-    manualGuidance:
-      "The size of the target for pointer inputs is at least 44 by 44 CSS pixels.",
-    checkerFnName: "checkTouchTarget",
-  },
-  {
-    id: "2.5.7",
-    name: "Dragging Movements",
-    level: "AA",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Drag interactions are runtime behaviour",
-    manualGuidance:
-      "All functionality that uses a dragging movement can be achieved with a single pointer without dragging.",
-  },
-  {
-    id: "2.5.8",
-    name: "Target Size (Minimum)",
-    level: "AA",
-    principle: "Operable",
-    guideline: "2.5 Input Modalities",
-    checkCapability: "automated",
-    figmaRelevance:
-      "Checks interactive element bounding boxes against 24x24px minimum",
-    manualGuidance:
-      "The size of the target for pointer inputs is at least 24 by 24 CSS pixels (with allowed exceptions for inline, spacing, equivalent, or user-agent-determined targets).",
-    checkerFnName: "checkTargetSizeMinimum",
-  },
-
-  // ═══════════════════════════════════════════════════════════════════════════
-  // PRINCIPLE 3 – UNDERSTANDABLE
-  // ═══════════════════════════════════════════════════════════════════════════
-
-  // ── 3.1 Readable ──────────────────────────────────────────────────────────
-  {
-    id: "3.1.1",
-    name: "Language of Page",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.1 Readable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "HTML lang attribute is an implementation detail, not in Figma",
-    manualGuidance:
-      "The default human language of each page can be programmatically determined (e.g., lang attribute on <html>).",
-  },
-  {
-    id: "3.1.2",
-    name: "Language of Parts",
-    level: "AA",
-    principle: "Understandable",
-    guideline: "3.1 Readable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Language attributes are an implementation detail",
-    manualGuidance:
-      "The human language of each passage or phrase in the content can be programmatically determined.",
-  },
-  {
-    id: "3.1.3",
-    name: "Unusual Words",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.1 Readable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Requires content analysis beyond Figma's scope",
-    manualGuidance:
-      "A mechanism is available for identifying specific definitions of words or phrases used in an unusual or restricted way.",
-  },
-  {
-    id: "3.1.4",
-    name: "Abbreviations",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.1 Readable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Requires content analysis beyond Figma's scope",
-    manualGuidance:
-      "A mechanism for identifying the expanded form or meaning of abbreviations is available.",
-  },
-  {
-    id: "3.1.5",
-    name: "Reading Level",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.1 Readable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Requires readability scoring of content",
-    manualGuidance:
-      "When text requires more than a lower secondary education reading level, supplemental content or a simpler version is available.",
-  },
-  {
-    id: "3.1.6",
-    name: "Pronunciation",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.1 Readable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Pronunciation is a runtime/content concern",
-    manualGuidance:
-      "A mechanism is available for identifying the specific pronunciation of words where meaning is ambiguous without knowing the pronunciation.",
-  },
-
-  // ── 3.2 Predictable ──────────────────────────────────────────────────────
-  {
-    id: "3.2.1",
-    name: "On Focus",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.2 Predictable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Focus behaviour is a runtime concern",
-    manualGuidance:
-      "When any UI component receives focus, it does not initiate a change of context.",
-  },
-  {
-    id: "3.2.2",
-    name: "On Input",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.2 Predictable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Input behaviour is a runtime concern",
-    manualGuidance:
-      "Changing the setting of any UI component does not automatically cause a change of context unless the user has been advised beforehand.",
-  },
-  {
-    id: "3.2.3",
-    name: "Consistent Navigation",
-    level: "AA",
-    principle: "Understandable",
-    guideline: "3.2 Predictable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Navigation consistency requires cross-page comparison beyond single-node audit scope",
-    manualGuidance:
-      "Navigational mechanisms that are repeated on multiple pages occur in the same relative order each time.",
-  },
-  {
-    id: "3.2.4",
-    name: "Consistent Identification",
-    level: "AA",
-    principle: "Understandable",
-    guideline: "3.2 Predictable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Consistency requires cross-page comparison",
-    manualGuidance:
-      "Components with the same functionality are identified consistently across pages.",
-  },
-  {
-    id: "3.2.5",
-    name: "Change on Request",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.2 Predictable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Context changes are a runtime concern",
-    manualGuidance:
-      "Changes of context are initiated only by user request, or a mechanism is available to turn off such changes.",
-  },
-  {
-    id: "3.2.6",
-    name: "Consistent Help",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.2 Predictable",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Help mechanism consistency requires cross-page comparison",
-    manualGuidance:
-      "If a page contains help mechanisms (contact info, self-help options), they are in the same relative order on each page.",
-  },
-
-  // ── 3.3 Input Assistance ─────────────────────────────────────────────────
-  {
-    id: "3.3.1",
-    name: "Error Identification",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check error-state variants for descriptive text (not colour-only indicators)",
-    manualGuidance:
-      "If an input error is automatically detected, the error is identified and described to the user in text.",
-    checkerFnName: "checkErrorIdentification",
-  },
-  {
-    id: "3.3.2",
-    name: "Labels or Instructions",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check that input components have visible label text siblings",
-    manualGuidance:
-      "Labels or instructions are provided when content requires user input.",
-    checkerFnName: "checkLabelsOrInstructions",
-  },
-  {
-    id: "3.3.3",
-    name: "Error Suggestion",
-    level: "AA",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check error-state variants for suggestion/help text",
-    manualGuidance:
-      "If an input error is detected and suggestions for correction are known, the suggestions are provided to the user.",
-    checkerFnName: "checkErrorIdentification",
-  },
-  {
-    id: "3.3.4",
-    name: "Error Prevention (Legal, Financial, Data)",
-    level: "AA",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Error prevention mechanisms are implementation details",
-    manualGuidance:
-      "For pages involving legal commitments, financial transactions, or user data: submissions are reversible, data is checked and confirmed, or a review step is provided.",
-  },
-  {
-    id: "3.3.5",
-    name: "Help",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Contextual help is an implementation detail",
-    manualGuidance:
-      "Context-sensitive help is available.",
-  },
-  {
-    id: "3.3.6",
-    name: "Error Prevention (All)",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Error prevention mechanisms are implementation details",
-    manualGuidance:
-      "For all pages requiring user submissions: submissions are reversible, data is checked, or a review step is provided.",
-  },
-  {
-    id: "3.3.7",
-    name: "Redundant Entry",
-    level: "A",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Redundant entry detection requires cross-step flow analysis beyond single-node scope",
-    manualGuidance:
-      "Information previously entered by or provided to the user that is required to be entered again is either auto-populated or available for selection.",
-  },
-  {
-    id: "3.3.8",
-    name: "Accessible Authentication (Minimum)",
-    level: "AA",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Authentication mechanisms are implementation details",
-    manualGuidance:
-      "A cognitive function test is not required for any step in an authentication process unless the test provides an alternative or is assisted.",
-  },
-  {
-    id: "3.3.9",
-    name: "Accessible Authentication (Enhanced)",
-    level: "AAA",
-    principle: "Understandable",
-    guideline: "3.3 Input Assistance",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Authentication mechanisms are implementation details",
-    manualGuidance:
-      "A cognitive function test is not required for any step in an authentication process.",
-  },
-
-  // ═══════════════════════════════════════════════════════════════════════════
-  // PRINCIPLE 4 – ROBUST
-  // ═══════════════════════════════════════════════════════════════════════════
-
-  // ── 4.1 Compatible ────────────────────────────────────────────────────────
-  // Note: 4.1.1 Parsing was removed in WCAG 2.2
-  {
-    id: "4.1.2",
-    name: "Name, Role, Value",
-    level: "A",
-    principle: "Robust",
-    guideline: "4.1 Compatible",
-    checkCapability: "heuristic",
-    figmaRelevance:
-      "Can check interactive components for name/description properties and visible labels",
-    manualGuidance:
-      "For all UI components, the name and role can be programmatically determined; states, properties, and values can be programmatically set; and notification of changes is available to user agents.",
-    checkerFnName: "checkNameRoleValue",
-  },
-  {
-    id: "4.1.3",
-    name: "Status Messages",
-    level: "AA",
-    principle: "Robust",
-    guideline: "4.1 Compatible",
-    checkCapability: "manual",
-    figmaRelevance:
-      "Status messages and ARIA live regions are an implementation concern",
-    manualGuidance:
-      "Status messages can be programmatically determined through role or properties so they are presented to the user by assistive technologies without receiving focus.",
-  },
-];
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Helpers
-// ─────────────────────────────────────────────────────────────────────────────
-
-const LEVEL_HIERARCHY: Record<WCAGLevel, WCAGLevel[]> = {
-  A: ["A"],
-  AA: ["A", "AA"],
-  AAA: ["A", "AA", "AAA"],
-};
-
-/** Return all criteria at or below the given conformance level. */
-export function getCriteriaForLevel(level: WCAGLevel): WCAGCriterionDef[] {
-  const included = LEVEL_HIERARCHY[level];
-  return WCAG_CRITERIA.filter((c) => included.includes(c.level));
-}
-
-/** Return a single criterion definition by ID, or undefined. */
-export function getCriterionById(
-  id: string
-): WCAGCriterionDef | undefined {
-  return WCAG_CRITERIA.find((c) => c.id === id);
-}